System Administration Commands                        remdrv(1M)



NAME
     remdrv - remove a device driver from the system

SYNOPSIS
     remdrv [-b basedir] devicedriver


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


     If remdrv 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 remdrv 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  confi-
         guration  or  use  to  another where past administrative
         customizations might not be desired.


EXAMPLES
     Example 1 Removing the sd Driver





SunOS 5.11          Last change: 13 Aug 2007                    1






System Administration Commands                        remdrv(1M)



     The following example removes the sd driver from use:


       example% remdrv 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% remdrv -b /export/root/sun1 sd




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


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    


SEE ALSO
     adddrv(1M),  kernel(1M),   updatedrv(1M),   attributes(5),
     zones(5), devfs(7FS)















SunOS 5.11          Last change: 13 Aug 2007                    2