rem_drv(1M)						  System Administration Commands					       rem_drv(1M)

NAME

       rem_drv - remove a device driver from the system

SYNOPSIS

       rem_drv [-b basedir] device_driver

DESCRIPTION

       The  rem_drv command informs the system that the device driver device_driver is no longer valid. If possible, rem_drv unloads device_driver
       from memory. rem_drv also updates the system driver configuration files.

       If rem_drv has been executed, the next time the system is rebooted it automatically performs a reconfiguration boot (see kernel(1M)).

OPTIONS

       The following options are supported:

       -b basedir

	   Sets the path to the root directory of the diskless client. Used on the server to execute rem_drv for a client. The client machine must
	   be rebooted to unload the driver.

	   Note -

	     The  root file system of any non-global zones must not be referenced with the -b option. Doing so might damage the global zone's file
	     system, might compromise the security of the global zone, and might damage the non-global zone's file system. See zones(5).

       -C

	   Remove dangling device attribute nodes bound to the driver being removed. This causes any device ownership  or  permissions	customiza-
	   tions  made	to  any  node not to  be preserved if the driver is added back. Recommended for use when reprovisioning a machine from one
	   configuration or use to another where past administrative customizations might not be desired.

EXAMPLES

       Example 1 Removing the sd Driver

       The following example removes the sd driver from use:

	 example% rem_drv sd

       Example 2 Removing a Diskless Client

       The following example removes the driver from the sun1 diskless client. The driver is not uninstalled or unloaded until the client  machine
       is rebooted.

	 example% rem_drv -b /export/root/sun1 sd

       Note the caveat on the use of the -b option in the description of that option, above.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       add_drv(1M), kernel(1M), update_drv(1M), attributes(5), zones(5), devfs(7FS)

SunOS 5.11							    13 Aug 2007 						       rem_drv(1M)