Maintenance Commands                             list_devices(1M)

NAME
     list_devices - list allocatable devices

SYNOPSIS
     list_devices [ -s ]  [  -U  uid  ]  -l  [ device ]

     list_devices [ -s ]  [  -U  uid  ]  -n  [ device ]

     list_devices [ -s ]  [  -U  uid  ]  -u  [ device ]

DESCRIPTION
     list_devices lists the allocatable  devices  in  the  system
     according to specified qualifications.

     The device and all device special files associated with  the
     device are listed. The device argument is optional and if it
     is not present, all relevant devices are listed.

OPTIONS
     -l [device]
           List the pathname(s) of the device special files asso-
           ciated  with  the  device  that are allocatable to the
           current process. If device is  given,  list  only  the
           files associated with the specified device.

     -n [device]
           List the pathname(s) of device special  files  associ-
           ated  with  the  device  that  are  allocatable to the
           current process but are not  currently  allocated.  If
           device  is  given, list only the files associated with
           that device.

     -s    Silent. Suppress any diagnostic output.

     -u [device]
           List the pathname(s) of device special files,  associ-
           ated  with  the device that are allocated to the owner
           of the current process. If device is given, list  only
           the files associated with that device.

     -U uid
           Use the user ID uid instead of the real user ID of the
           current   process  when  performing  the  list_devices
           operation.      Only     a     user      with      the
           solaris.devices.revoke   authorization  can  use  this
           option.

DIAGNOSTICS
     list_devices returns an nonzero exit status in the event  of
     an error.

SunOS 5.8           Last change: 18 Aug 1999                    1

Maintenance Commands                             list_devices(1M)

FILES
     /etc/security/device_allocate

     /etc/security/device_maps

     /etc/security/dev/*

     /usr/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),          deallocate(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: 18 Aug 1999                    2