NAME

mksf − make a special file

SYNOPSIS

/etc/mksf [-N cnode] [-d driver | -C class] [-H hw_path] [-l lu] [driver_options...] [special_file]

/etc/mksf [-N cnode] [-d driver | -C class] [-H hw_path] [-r] -m minor special_file

DESCRIPTION

mksf makes a special file for an existing device; that is, a device that has already been assigned a logical unit number by insf (see insf(1M)). The device is specified by supplying some combination of the -d, -C, -H, and -l options.  If the options specified match a unique device in the system, mksf creates a special file for that device; otherwise, mksf prints an error message and exits. 

For most drivers, mksf has a set of built-in driver options and special-file naming conventions.  By supplying some subset of the driver options, as in the first form above, the user can create a special file with a particular set of characteristics.  If a special-file name is specified, mksf creates the special file with that special file name; otherwise, the default naming convention for the driver is used. 

In the second form, the minor number and special-file name are explicitly specified.  This form is used to make a special file for a driver without using the built-in driver options in mksf.  The -r option specifies that mksf should make a character (raw) device file instead of the default block device file for drivers that support both. 

The -N option specifies that the special files are to be created with the associated cnode ID; the format of cnode is the same as that given in mknod(1M). If -N is not specified, insf uses the cnode ID of the machine on which it is executing. 

Options

mksf recognizes the following options:

-C class Match a device that belongs to the specified device class.  Device classes are defined in file /etc/master. 

-H hw_path Match a device at the specified hw_path. hw_path specifies the address of the hardware components leading to a device.  It consists of a string of numbers each suffixed by slash (/), followed by an arbitrary-length string of numbers separated by periods, (.).  Hardware components suffixed by slashes indicate bus converters and may not be necessary on your machine.  Hardware components suffixed by (.) indicate the addresses of the remaining hardware components on the path to a device. 

-N cnode Make a special file with the specified cnode ID; the format of cnode is the same as that given in mknod(1M).

-d driver Match a device controlled by the specified driver. 

-l lu Match a device with the specified logical unit number. 

-m minor Create the special with the following minor number; the format of the minor number is the same as that given in mknod(1M).

-r Create a character (raw) special file instead of a block special file. 

Driver-specific options and default special file names are listed below. 

autox0/autoch

-z cartridge The cartridge number (start with 1). 

-r Raw; create character, not block, special file. 

-s section The section number. 

special_file The default special file name depends on the whether the -r option is used. 

-r	Special File Name
yes	rac/cfPlussectiondcartridgea and
	rac/cfPlussectiondcartridgeb
no	ac/cfPlussectiondcartridgea  and
	ac/cfPlussectiondcartridgeb

disc1

-c This option must be present if the unit is a cartridge tape. 

-t Transparent mode (normally used by diagnostics). 

-u unit The CS/80 unit number (for example, unit 0: disk, unit 1: tape). 

-r Raw; create character, not block, special file. 

-s section The section number. 

special_file The default special file name depends on whether the -r and -c options are used:

-r	-c	Special File Name
yes	yes	rct/cf2ludunitssection
yes	no	rdsk/cf2ludunitssection
no	yes	ct/cf2ludunitssection
no	no	dsk/cf2ludunitssection

disc2

-t Transparent mode (normally used by diagnostics). 

-u unit The cs80 unit number (typically 0). 

-r Raw; create character, not block, special file. 

-s section The section number. 

special_file The default special file name depends on whether the -r option is used:

-r	Special File Name
yes	rdsk/cfPludunitssection
no	dsk/cfPludunitssection

disc3

-r Raw; create character, not block, special file. 

-s section The section number. 

special_file The default special file name depends on whether the -r option is used:

-r	Special File Name
yes	rdsk/cfPlud0unitssection
no	dsk/cfPlud0unitssection

display0

-D device Specifies the device type.  Possible values for device are framebuf, hil, hilkbd, and ite. 

-a address The link address (1-7). 

-t Transparent mode (normally used by diagnostics). 

special_file The default special file name depends on the arguments -D and -t:

−D arg	-t	Special File Name
-D framebuf	no	crtf2lu
-D framebuf	yes	diag/crtf2lu
-D hil	no	hil_f2lu.address
-D hil	yes	diag/hilf2lu
-D hilkbd	no	hilkbdf2lu
-D ite	no	ttyif2lu

gpio0

-t Transparent mode (normally used by diagnostics). 

special_file The default special file name is gpiolu. 

gpio1

-t Transparent mode (normally used by diagnostics). 

special_file The default special file name is gpiolu. 

instr0

-a address The HP-IB instrument address (0-30). 

-r Raw; the special file has no associated HP-IB instrument address. 

-t Transparent mode (normally used by diagnostics). 

special_file The default special file name is hpib/luaaddress or hpib/lu (if -r). 

lpr0/lpr1/lpr2

-c Capital letters.  Convert all output to uppercase. 

-n No form-feed. 

-r Raw. 

-o Old paper-out behavior (abort job). 

-e Eject page after paper-out recovery. 

-t Transparent mode (normally used by diagnostics). 

special_file The default special file name is lplu or rlplu (if -r). 

mux0/mux0_16

-c CCITT. 

-h Hardwired (direct connect). 

-i Callin. 

-o Callout. 

-p port Multiplexer port number (0-5 for mux0; 0-15 for mux0_16). 

-t Transparent mode (normally used by diagnostics). 

special_file The default special file name is ttylupport or muxlu (if -t). 

cn/devconfig/diag0/dmem/meas_drivr/mm/pty0/pty1/sw/sy/clone/dlpidrv

-m minor The minor number. 

special_file No default.  Path must be specified. 

tape1/tape2

-a AT&T style rewind/close. 

-b bpi Bits per inch.  Recognized values for bpi are: 800, 1600, 6250. 

-c RTE compatible close. 

-n No rewind on close. 

-r Raw; create character, not block, special file. 

-t Transparent mode (normally used by diagnostics). 

-u UC Berkeley style rewind/close. 

-w Wait (disable immediate reporting). 

-C Enable data compression. 

special_file The default special file name is mt/lul.  The -r option changes mt to rmt.  The l means low density (800 bpi).  For 1600 and 6250 bpi, l is replaced by m (medium) and h (high), respectively.  An n is appended to the name if the -n (no rewind) option is given.  A c is appended to the name if the -C (compression) option is given. 

RETURN VALUE

mksf returns 0 upon normal completion and 1 if an error occurred. 

DIAGNOSTICS

Most of the diagnostic messages from mksf are self explanatory.  Listed below are some messages deserving further clarification.  Errors cause mksf to abort immediately. 

Errors

Ambiguous device specification
Matched more than one device in the system. Use some combination of the -d, -C, -H, and -l options to specify a unique device. 

No such device in the system
No device in the system matched the options specified. Use ioscan to list the devices in the system (see ioscan(1M)).

Device driver name is not in the kernel

Device class name is not in the kernel
The indicated device driver or device class is not present in the kernel. Add the appropriate device driver and/or device class to the uxgen input file and generate a new kernel (see uxgen(1M)).

Device has no logical unit number
The specified device has not been assigned a logical unit (lu) number. Use insf to assign an lu to the device. 

EXAMPLES

Make a special file named /dev/printer and map it to the line printer device associated with logical unit number 2. 

mksf -C printer -l 2 /dev/printer

Make a special file, using the default naming convention, for the tape device at hardware path 8.4.1.  The driver-specific options specify raw mode, 1600 bits per inch, and no rewind on close. 

mksf -C tape -H 8.4.1 -r -b 1600 -n

AUTHOR

mksf was developed by HP. 

FILES

/dev/config
/etc/master

SEE ALSO

insf(1M), ioscan(1M), lssf(1M), mknod(1M), rmsf(1M), uxgen(1M), ioconfig(4). 

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992