list_devices(1)                                                                                                                    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]

       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.

       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 associated 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, 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          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.device.revoke authorization can use this option.

       The following exit values are returned:

       non--zero       An error occurred.

       /etc/security/device_allocate

       /etc/security/device_maps

       /etc/security/dev/*

       /usr/security/lib/*

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Availability                 |SUNWcsu                      |
       +-----------------------------+-----------------------------+

       allocate(1), deallocate(1), bsmconv(1M), dminfo(1M), mkdevalloc(1M), mkdevmaps(1M), device_allocate(4), device_maps(4), attributes(5)

       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) might not be supported in a future release of the Solaris Operating Environment.

                                                                    28 Mar 2005                                                    list_devices(1)