HP-UX Reference (11i v2 04/09) - 1M System Administration Commands A-M (vol 3)

m
mksf(1M) mksf(1M)
NAME
mksf - make a special (device) file
SYNOPSIS
/sbin/mksf [-C class  -d
driver][-D directory ][-H hw-path][-I
instance ][-q-v]
[driver-options][special-file]
/sbin/mksf [-C class  -d
driver][-D directory ][-H hw-path] -m minor [
-q-v][-r]
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. The device is specified by sup-
plying some combination of the
-C,
-d, -H, and -I options. If the options specified match a unique dev-
ice in the system,
mksf creates a special file 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 defined for the resulting special file.
For most drivers,
mksf has a set of built-in driver options, driver-options , and special-file naming con-
ventions. 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.
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)). They are defined in the files in
the directory /usr/conf/master.d
. 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 specified device driver, driver.Device
drivers can be listed with the
lsdev command (see lsdev (1M)). They are defined
in the files in the directory /usr/conf/master.d
. This option cannot be used
with
-C.
-D directory Override the default device installation directory /dev and install the special files
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 specifies 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 specified 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.
-m minor Create the special file with the specified minor number minor. The format of minor
is the same as that given in mknod(1M) and mknod(5).
-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 file instead of a block special file.
-v Verbose option. In addition to the normal processing message, display the name of
each special file as it is created. See the -q option.
Section 1M−−446 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: September 2004