usr/src/man/man4/pseudo.4

   1 '\" te
   2 .\" Copyright (c) 1993, Sun Microsystems, Inc.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH PSEUDO 4 "Jun 15, 1993"
   7 .SH NAME
   8 pseudo \- configuration files for pseudo device drivers
   9 .SH DESCRIPTION
  10 .sp
  11 .LP
  12 Pseudo devices are devices that are implemented entirely in software. Drivers
  13 for pseudo devices must provide driver configuration files to inform the system
  14 of each pseudo device that should be created.
  15 .sp
  16 .LP
  17 Configuration files for pseudo device drivers must identify the parent driver
  18 explicitly as \fIpseudo,\fR and must create an integer property called
  19 \fIinstance\fR which is unique to this entry in the configuration file.
  20 .sp
  21 .LP
  22 Each entry in the configuration file creates a prototype devinfo node. Each
  23 node is assigned an instance number which is determined by the value of the
  24 \fIinstance\fR property. This property is only applicable to children of the
  25 \fIpseudo\fR parent, and is required since pseudo devices have no hardware
  26 address from which to determine the instance number. See \fBdriver.conf\fR(4)
  27 for further details of configuration file syntax.
  28 .SH EXAMPLES
  29 .LP
  30 \fBExample 1 \fRA sample configuration file.
  31 .sp
  32 .LP
  33 Here is a configuration file called \fBramdisk.conf\fR for a pseudo device
  34 driver that implements a RAM disk. This file creates two nodes called
  35 "ramdisk". The first entry creates ramdisk node instance 0, and the second
  36 creates ramdisk node, instance 1, with the additional \fBdisk-size\fR property
  37 set to \fB512.\fR
  38
  39 .sp
  40 .in +2
  41 .nf
  42 \fB#
  43 # Copyright (c) 1993, by Sun Microsystems, Inc.
  44 #
  45 #ident  "@(#)ramdisk.conf       1.3     93/06/04 SMI"
  46 name="ramdisk" parent="pseudo" instance=0;
  47 name="ramdisk" parent="pseudo" instance=1 disk-size=512;\fR
  48 .fi
  49 .in -2
  50 .sp
  51
  52 .SH SEE ALSO
  53 .sp
  54 .LP
  55 \fBdriver.conf\fR(4), \fBddi_prop_op\fR(9F)
  56 .sp
  57 .LP
  58 \fIWriting Device Drivers\fR