User Commands                                       deallocate(1)



NAME
     deallocate - device deallocation

SYNOPSIS
     deallocate [-s] [-w] [-F] [-z zonename]
          [-c dev-class  -g dev-type  device]


     deallocate [-s] [-w] [-F] [-z zonename] -I


DESCRIPTION
     The deallocate command frees an allocated device. It  resets
     the  ownership  and  permissions on all device special files
     associated with the device, disabling access to that device.
     deallocate  runs the device cleaning program for that device
     as specified in deviceallocate(4).


     The default deallocate operation deallocates  devices  allo-
     cated to the user.

OPTIONS
     The following options are supported:

     -c dev-class    Deallocates all  devices  of  the  specified
                     device class.


     -F device       Forces deallocation of the device associated
                     with  the  file  specified by device. Only a
                     user with the solaris.device.revoke authori-
                     zation is permitted to use this option.


     -I              Forces deallocation of all allocatable  dev-
                     ices.     Only     a     user    with    the
                     solaris.device.revoke authorization is  per-
                     mitted  to  use  this  option.  This  option
                     should only be used  at  system  initializa-
                     tion.


     -s              Silent. Suppresses any diagnostic output.



     The following options are supported when the system is  con-
     figured with Trusted Extensions:

     -g dev-type    Deallocates a device of device type  matching
                    dev-type.



SunOS 5.11          Last change: 30 Apr 2008                    1






User Commands                                       deallocate(1)



     -w             Runs the device cleaning program in a window-
                    ing  environment.  If  a windowing version of
                    the program exists, it  is  used.  Otherwise,
                    the  standard  version  is  run in a terminal
                    window.


     -z zonename    Deallocates device from the zone specified by
                    zonename.


OPERANDS
     The following operands are supported:

     device    Deallocates the specified device.


EXIT STATUS
     The following exit values are returned:

     0              Successful completion.


     20             No entry for the specified device.


     other value    An error occurred.


FILES
     /etc/security/deviceallocate


     /etc/security/devicemaps


     /etc/security/dev/*


     /etc/security/lib/*

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











SunOS 5.11          Last change: 30 Apr 2008                    2






User Commands                                       deallocate(1)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    
     Interface Stability          See below.                  
    



     The invocation is Uncommitted. The options are  Uncommitted.
     The output is Not-an-Interface.

SEE ALSO
     allocate(1),   listdevices(1),   bsmconv(1M),   dminfo(1M),
     mkdevalloc(1M),      mkdevmaps(1M),      deviceallocate(4),
     devicemaps(4), attributes(5)


     Controlling Access to Devices

NOTES
     The functionality described in this man  page  is  available
     only  if  Solaris Auditing has been enabled. See bsmconv(1M)
     for more information.


     On systems configured with  Trusted  Extensions,  the  func-
     tionality is enabled by default.


     /etc/security/dev, mkdevalloc(1M), and  mkdevmaps(1M)  might
     not  be supported in a future release of the Solaris Operat-
     ing Environment.





















SunOS 5.11          Last change: 30 Apr 2008                    3