[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    drvconfig(1M) manual page Table of Contents

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(1M) ) 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_name permissions 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.

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(1M) and rem_drv(1M) , and may not be supported in future versions of 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(1M) . 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

  1. Successful completion.
    non-zero
    An error occurred.

    Files

    /devices
    device nodes directory
    /etc/minor_perm
    minor mode permissions
    /etc/name_to_major
    major number binding
    /etc/driver_classes
    driver class binding file

    See Also

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

    Notes

    This document does not constitute an API. /etc/minor_perm, /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.


    Table of Contents