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.devices.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:

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