NAME

drvconfig - configure the /devices directory

SYNOPSIS

drvconfig [ -bn ] [ -a alias_name ] [ -c class_name ] [ -i drivername ] [ -m major_num ] [ -r rootdir ]

AVAILABILITY

SUNWcsu

DESCRIPTION

The default operation of drvconfig is to create the /devices directory tree that describes, in the filesystem namespace, the hardware layout of a particular machine. Hardware devices present on the machine and powered on as well as pseudo-drivers are represented under /devices. Normally this command is run automatically after a new driver has been installed (with add_drv(1MTSOL)) and the system has been rebooted.

/etc/minor_perm file

drvconfig reads the /etc/minor_perm file to obtain permission information and applies the permissions only to nodes that it has just created. It does not change permissions on already existing nodes. The format of the /etc/minor_perm file is as follows:

name: minor_namepermissions owner group

minor_name may be the actual name of the minor node, or contain shell metacharacters to represent several minor nodes (see sh(1)).

For example:

sd:* 0640 root sys
zs:[a-z],cu 0600 uucp uucp
mm:kmem 0640 root bin

The first line sets all devices exported by the sd node to 0640 permissions, owned by root, with group sys. In the second line, devices such as a,cu and z,cu exported by the zs driver are set to 0600 permission, owned by uucp, with group uucp. In the third line the kmem device exported by the mm driver is set to 0640 permission, owned by root, with group bin.

/etc/security/tsol/ minor_perm.adjunct

drvconfig reads the /etc/security/tsol/minor_perm.adjunc file to obtain label information and applies the labels to nodes that it has just created. drvconfig does not change labels on already existing nodes. The format of the file is:

file

name: minor_nameIL[SL]

minor_name is the name of the minor node; shell metacharacters may be used to represent several minor nodes (see sh(1)). Labels can be represented in hex format which add_drv(1MTSOL) converts when an entry is added to the file. For readability in the example shown below the first three lines would be entered as a single line, as would the last three lines.

SD:* 0x0x000000000000000000000000000000000000000000000000000000000000 \
000000000000000000000000000000000000000000000000000000000000000000000000 \
[0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff]
mm:kmem 0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff \
ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff[0x7ffffffffffffff \

fffffffffffffffffffffffffffffffffffffffffffffffffffff]

The above example sets all devices exported by the sd node to have an information label of ADMIN_LOW and a sensitivity label of ADMIN_HIGH. The kmem device exported by the mm driver is set to have an information label of ADMIN_HIGH and a sensitivity label of ADMIN_HIGH.

OPTIONS

The following options may be of use to system administrators and driver developers:

-i drivername

Only configure the devices for the named driver.

The following options are used by the implementation of add_drv(1MTSOL) and rem_drv(1MTSOL), and may not be supported in future versions of Solaris and Trusted Solaris.

-b

Add a new major number to name binding into the kernel's internal name_to_major tables. This option is not normally used directly, but is used by other utilities such as add_drv(1MTSOL). Use of the -b option requires that -i and -m be used also. No /devices entries are created.

-n

Do not try to load and attach any drivers, or if the -i option is given, do not try to attach the driver named drivername.

-a alias_name

Add the name alias_name to the list of aliases that this driver is known by. This option, if used, must be used with the -m major_num, the -b and the -i drivername options.

-c class_name

The driver being added to the system exports the class class_name. This option is not normally used directly, but is used by other utilities. It is only effective when used with the -b option.

-m major_num

Specify the major number major_num for this driver to add to the kernel's name_to_major binding tables.

-r rootdir

Build the device tree under the directory specified by rootdir instead of the default /devices directory.

EXIT STATUS

0

Successful completion.

non-zero

An error occurred.

SUMMARY OF TRUSTED

The /etc/security/tsol/minor_perm.adjunct file is used to record the sensitivity label and information label of devices.

SOLARIS CHANGES

FILES

/devices

device nodes directory

/etc/minor_perm

minor mode permissions

/etc/security/tsol/minor_perm.adjunct

default sensitivity label and information label

/etc/name_to_major

major number binding

/etc/driver_classes

driver class binding file

SEE ALSO

sh(1), add_drv(1MTSOL), devlinks(1M), disks(1M), modinfo(1M), modload(1MTSOL), modunload(1MTSOL), ports(1M), rem_drv(1MTSOL), tapes(1M), path_to_inst(4)

NOTES

This document does not constitute an API. /etc/minor_perm, /etc/security/tsol/minor_perm.adjunct, /etc/name_to_major, /etc/driver_classes, and /devices may not exist or may have different contents or interpretations in a future release. The existence of this notice does not imply that any other documentation that lacks this notice constitutes an API.