mksf.1m (2012 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

mksf(1M) mksf(1M)

NAME

mksf - make a special (device) ﬁle

SYNOPSIS

/sbin/mksf {(-C class  -d

driver )  -I instance  -H hw_path }[-D directory ][

-q-v]

[driver-options ][special-ﬁle]

/sbin/mksf {(-C class  -d

driver )  -I instance  -H hw_path }[-D directory ][

-q-v][-r]

-m minor special-ﬁle

DESCRIPTION

The mksf command makes a special ﬁle in the devices directory, normally

/dev, for an existing device, a

device that has already been assigned an instance number by the system. The device is speciﬁed by sup-

plying some combination of the

-C

, -d, -H and -I options. If the options speciﬁed match a unique device

in the system,

mksf creates a special ﬁle for that device; otherwise,

mksf prints an error message and

exits. If required,

mksf creates any subdirectories relative to the device installation directory that are

deﬁned for the resulting special ﬁle.

For most drivers,

mksf has a set of built-in driver options, driver-options , and special ﬁle naming con-

ventions. By supplying some subset of the driver options, as in the ﬁrst form above, the user can create a

special ﬁle with a particular set of characteristics. If a special-ﬁle name is speciﬁed,

mksf creates the

special ﬁle with that special ﬁle name; otherwise, the default naming convention for the driver is used.

In the second form, the minor number and special-ﬁle name are explicitly speciﬁed. When

-D is not

used, the special ﬁle must be speciﬁed with the absolute path. In this case, if any other path other than

the absolute path is speciﬁed, the path is treated relative to the default devices directory. This form is

used to make a special ﬁle for a driver without using the built-in driver options in

mksf. The -r option

speciﬁes that

mksf should make a character (raw) device ﬁle instead of the default block device ﬁle for

drivers that support both.

Options

mksf recognizes the following options:

-C class Match a device that belongs to a given device class, class . Device classes can be

listed with the lsdev command (see lsdev (1M)). This option is not valid for pseudo

devices. This option cannot be used with -d.

-d driver Match a device that is controlled by the speciﬁed device driver, driver .Device

drivers can be listed with the

lsdev command (see lsdev (1M)). This option cannot

be used with -C.

-D directory Override the default device installation directory /dev and install the special ﬁles

in directory instead. directory must exist; otherwise, mksf displays an error mes-

sage and exits. See WARNINGS .

-H hw_path Match a device at a given hardware path, hw-path . Hardware paths can be listed

with the ioscan command (see ioscan (1M)). A hardware path speciﬁes the

addresses of the hardware components leading to a device. It consists of a string of

numbers separated by periods (.), such as 52 (a card), 52.3 (a target address),

and 52.3.0 (a device). If a hardware component is a bus converter, the following

period, if any, is replaced by a slash (/)asin2, 2/3, and 2/3.0. This option is

not valid for pseudo devices.

-I instance Match a device with the speciﬁed instance number. Instances can be listed with the

-f option of the ioscan command (see ioscan (1M)). This option is not valid for

pseudo devices. This option must be used with the -d or -C option.

-m minor Create the special ﬁle with the speciﬁed minor number minor . The format of minor

is the same as that given in mknod(1M) and mknod(5). This option cannot be used

to create persistent special ﬁles.

-q Quiet option. Normally, mksf displays a message as each driver is processed. This

option suppresses the driver message, but not error messages. See the -v option.

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

-v Verbose option. In addition to the normal processing message, display the name of

each special ﬁle as it is created. See the -q option.

HP-UX 11i Version 3: March 2012 − 1 − Hewlett-Packard Company 1

Summary of content (10 pages)

PAGE 1
mksf(1M) mksf(1M) NAME mksf - make a special (device) file SYNOPSIS /sbin/mksf {(-C class  -d driver )  -I instance  -H hw_path } [-D directory ] [-q-v] [driver-options ] [special-file ] /sbin/mksf {(-C class  -d driver )  -I instance  -H hw_path } [-D directory ] [-q-v] [-r] -m minor special-file DESCRIPTION The mksf command makes a special file in the devices directory, normally /dev, for an existing device, a device that has already been assigned an instance number by the system.
PAGE 2
mksf(1M) mksf(1M) Naming Conventions Some persistent special files follow a classinstance naming convention, where class is the driver class, and instance is the instance number assigned by the operating system to the device (see ioscan (1M)). Some legacy special files are named using the ccard ttarget ddevice naming convention. These variables have the following meaning wherever they are used. card The unique interface card identification number from ioscan (see ioscan (1M)).
PAGE 3
mksf(1M) mksf(1M) access-mode — 2 1 0 0 -i no no no yes no -l yes no no no no Special File Name ccardp0_lp ttydcardp0 culcardp0 cuacardp0 ttycardp0 audio -f format Audio format (0-3). The format meanings are: format 0 1 2 3 Audio Format No change in audio format 8-bit Mu-law 8-bit A-law 16-bit linear File Name Modifier format-mod U A L -o output-dest Output destination (0-4). The output-dest should have a value between 0 and 4.
PAGE 4
mksf(1M) mksf(1M) fifo-trigger 0 1 2 3 -t Receive FIFO Trigger Level 1 4 8 14 Transparent mode (normally used by diagnostics). -x xmit-limit xmit-limit should have a value between 0 and 3. The following table shows the corresponding transmit limit for a given xmit-limit value. xmit-limit 0 1 2 3 special-file Transmit Limit 1 4 8 12 The default special file name is as follows: Special File Name ttycardp0 disc3 A -f Floppy. -r Raw; create character, not block, special file.
PAGE 5
mksf(1M) mksf(1M) -r yes yes no no -s no yes no yes Special File Name rdisk/disk instance rdisk/disk instance_psection disk/disk instance disk/disk instance_psection The default pass through special file name for disk is pt/pt_diskinstance. estape All the stape driver specific options can be used with this driver also. -P Create a pass through special file. special-file Put all tape special files in the /dev/rtape directory. This is required for proper maintenance of the Tape Property Table.
PAGE 6
mksf(1M) mksf(1M) -e no yes Special File Name lanttycard diag/lantty card lpr2 lpr3 -c Capital letters. Convert all output to uppercase. -e Eject page after paper-out recovery. -n No form-feed. -o Old paper-out behavior (abort job). -r Raw. -t Transparent mode (normally used by diagnostics). -w No wait. Don’t retry errors on open.
PAGE 7
mksf(1M) mksf(1M) special-file The default special file name depends on the -a, and -p options: Option -a 0 -a 1 -p Special File Name ps2mouse ps2kbd ps2_port Note the underscore (_) before port . SAS console ports SCentIf See asio0. See CentIf. scc1 -a access-mode Port access mode (0−2). The default access mode is 0. The access-mode meanings are: access-mode 0 1 2 Port Operation Direct connect Dial out modem Dial in modem -b Port B. -c CCITT. -i Modem dialer. Cannot be used with -l.
PAGE 8
mksf(1M) mksf(1M) -r yes yes no no -s no yes no yes Special File Name rdsk/ccardttargetddevice rdsk/ccardttargetddevicessection dsk/ccardttargetddevice dsk/ccardttargetddevicessection stape -a -b bpi AT&T-style rewind/close. Bits per inch or tape density.
PAGE 9
mksf(1M) mksf(1M) -t Transparent mode, normally used by diagnostics. -u UC Berkeley-style rewind/close. -w Wait (disable immediate reporting). -x index Use the index value to access the tape device driver property table entry. The recognized values for index are decimal values in the range 0 to 30. -z RTE compatible close. special-file Put all tape special files in the /dev/rmt directory. This is required for proper maintenance of the Tape Property Table (see mt(7)).
PAGE 10
mksf(1M) mksf(1M) EXAMPLES Make a special file named /dev/printer for the line printer device associated with instance number 2. mksf -C printer -I 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 1600 bits per inch and no rewind on close. mksf -C tape -H 8.4.1 -b D1600 -n Make a persistent special file, using the default naming convention, for the disk device with instance number 7.