update_drv(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | SEE ALSO | NOTES

NAME

update_drv– modify device driver attributes

SYNOPSIS

update_drv [-v] device_driver
update_drv [-b basedir] [-v] -a -i 'identify-name' device_driver
update_drv [-b basedir] [-v] -a -m 'permission' device_driver
update_drv [-b basedir] [-v] -a -i 'identify-name' -m 'permission' device_driver
update_drv [-b basedir] [-v] -d -i 'identify-name' device_driver
update_drv [-b basedir] [-v] -d -m 'permission' device_driver
update_drv [-b basedir] [-v] -d -i 'identify-name' -m 'permission' device_driver

DESCRIPTION

The update_drv command informs the system about attribute changes to an installed device driver. It can be used to re-read the driver.conf(4) file, or to add, modify, or delete a driver's minor node permissions or aliases.

Without options, update_drv reloads the driver.conf file.

Upon successfully updating the aliases, the driver binding takes effect upon reconfig boot or hotplug of the device.

Upon successfully updating the permissions, only the new driver minor nodes get created with the modified set of file permissions. Existing driver minor nodes do not get modified.

OPTIONS

The following options are supported:

-a

Add a permission or an aliases entry.

With the -a option specified, a permission entry (using the -m option), or a driver's aliases entry (using the -i option) can be added or updated. If a matching minor node permissions entry is encountered (having the same driver name and the minor node), it is replaced. If a matching aliases entry is encountered (having a different driver name and the same alias), an error is reported.

The -a and -d options are mutually exclusive.

-b basedir

Installs or modifies the driver on the system with a root directory of basedir rather than installing on the system executing update_drv.

-d

Deletes a permission or an aliases entry.

Either the -m permission or -i identify-name option needs to be specified with the -d option.The -d and -a options are mutually exclusive.

If the entry doesn't exist update_drv returns an error.

-i 'identify-name'

A white-space separated list of aliases for the driver. If -a or -d option is not specified then this option is ignored. The identify-name string is mandatory. If all aliases need to be removed, rem_drv(1M) is recommended.

-m 'permission'

Specify a white-space separated list of file system permissions for the device node of the device driver. If -a or -d option is not specified then, this option is ignored. The permission string is mandatory.

EXAMPLES

---

Example 1 Adding or Modifying an Existing Minor Permissions Entry




The following command adds or modifies the exisitng minor permissions entry of the clone driver:

example# update_drv -a -m 'llc1 777 joe staff' clone

---

---

Example 2 Removing All Minor Permissions Entries




The following command removes all minor permission entries of the usbprn driver, the USB printer driver:

example# update_drv -d -m '* 0666 root sys' usbprn

---

---

Example 3 Adding a Driver Aliases Entry




The following command adds a driver aliases entry of the ugen driver with the identity string of usb459,20:

example# update_drv -a -i '"usb459,20"' ugen

---

---

Example 4 Re-reading the driver.conf File For the ohci Driver




The following command re-reads the driver.conf(4) file.

example# update_drv ohci

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu

SEE ALSO

add_drv(1M), modunload(1M), rem_drv(1M), driver.conf(4), attributes(5)

NOTES

If -b option is specified, update_drv does not re-read the driver.conf file.

It is possible to add an alias , which changes the driver binding of a device already being managed by a different driver.

SunOS 5.8  Last Revised 04 Feb 2003

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | SEE ALSO | NOTES