Manual Pages for UNIX Operating System command usage for man rem_drv

System Administration Commands                        rem_drv(1M)



NAME
     rem_drv - remove a device driver from the system

SYNOPSIS
     rem_drv [-b basedir] [-C] [-n] 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 dam-
           age 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 customizations 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 customiza-
         tions might not be desired.


     -n

         Do not try to  detach  and  unload  device_driver,  just
         modify the system configuration files for that driver.



SunOS 5.11           Last change: 4 Oct 2010                    1






System Administration Commands                        rem_drv(1M)



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 disk-
     less 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  descrip-
     tion of that option, above.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       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           Last change: 4 Oct 2010                    2