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 ]

AVAILABILITY

SUNWcsu

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 associated 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 per-

forming the list_devices operation. This option requires proc_setid privilege to be asserted.

DIAGNOSTICS

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

FILES

/etc/security/device_allocate

/etc/security/device_maps
/etc/security/dev/*
/usr/security/lib/*

SEE ALSO

allocate(1MTSOL), deallocate(1MTSOL), device_allocate(4TSOL), device_maps(4TSOL)