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
               associated 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 asso-
               ciated 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.  Suppresses any diagnostic output.

     -u [device]
               List the  pathname(s)  of  device  special  files,
               associated  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.admin authorization can              |*
               use this option.

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

FILES
     /etc/security/device_allocate

SunOS 5.7            Last change: 6 May 1993                    1

Maintenance Commands                             list_devices(1M)

     /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.7            Last change: 6 May 1993