list_devices(1)

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

     The list_devices utility 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

     The following options are supported:

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

     -n [device]
           Lists 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, lists only the files associated with
           that device.

     -s    Silent. Suppresses any diagnostic output.

     -u [device]
           Lists 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
           Uses 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.

EXIT STATUS

     The following exit values are returned:

     non-zero
           An error occurred.

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(1),   deallocate(1),    bsmconv(1M),    dminfo(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.

     /etc/security/dev, mkdevalloc(1M), and mkdevmaps(1M) may not
     be  supported  in  a future release of the Solaris operating
     environment.