Maintenance Commands                               deallocate(1M)

NAME
     deallocate - device deallocation

SYNOPSIS
     deallocate [ -s ]  device

     deallocate [ -s ]  [ -F ]  device

     deallocate [ -s ]  -I

DESCRIPTION
     deallocate deallocates a device  allocated  to  the  evoking
     user.  device can be a device defined in  device_allocate(4)
     or one of the device special files associated with the  dev-
     ice.  It resets the ownership and the permission on all dev-
     ice special files  associated  with  device,  disabling  the
     user's  access to that device. This option can be used by an
     authorized user to remove access to the  device  by  another
     user. The required authorization is solaris.device.allocate.

     When deallocation or forced deallocation is  performed,  the
     appropriate  device  cleaning  program is executed, based on
     the  contents of  device_allocate(4).  These  cleaning  pro-
     grams are normally stored in /etc/security/lib.

OPTIONS
     device
           Deallocate the device associated with the device  spe-
           cial file specified by device.

     -s    Silent.  Suppress any diagnostic output.

     -F device
           Force deallocation of the device associated  with  the
           file  specified  by  device.  Only  a  user  with  the
           solaris.devices.revoke authorization is  permitted  to
           use this option.

     -I    Force deallocation of all allocatable devices.  Only a
           user  with the solaris.devices.revoke authorization is
           permitted to use this option. This option should  only
           be used at system initialization.

DIAGNOSTICS
     deallocate returns a non zero exit status in the event of an
     error.

FILES
     /etc/security/device_allocate

     /etc/security/device_maps

SunOS 5.8           Last change: 21 Oct 1999                    1

Maintenance Commands                               deallocate(1M)

     /etc/security/dev/*

     /etc/security/lib/*

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO
     allocate(1M),        bsmconv(1M),        device_allocate(4),
     device_maps(4), attributes(5)

NOTES
     The functionality described in this man  page  is  available
     only  if  the  Basic Security Module (BSM) has been enabled.
     See  bsmconv(1M) for more information.

SunOS 5.8           Last change: 21 Oct 1999                    2