👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

OpenSolaris 2009.06 - man page for list_devices (opensolaris section 1)

list_devices(1) 			  User Commands 			  list_devices(1)

NAME
       list_devices - list allocatable devices

SYNOPSIS
       list_devices [-s] [-U uid] [-z zonename] [-a [-w]]
	    -l | -n | -u [device] | [-l | -n | -u] -c dev-class

       list_devices [-s] -d dev-type

DESCRIPTION
       The  list_devices  utility lists the allocatable devices in the system according to speci-
       fied 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. If dev-
       class is present, devices belonging to the specified dev-class are  listed.  There  is  no
       default dev-class.

OPTIONS
       The following options are supported:

       -l [-c dev-class | device]    Lists  the  pathnames of the device special files associated
				     with the device that are allocatable to the current process.

				     If dev-class is specified, lists only the	files  associated
				     with all devices of the specified device class.

				     If device is specified, lists only the files associated with
				     the specified device.

       -n [-c dev-class | device]    Lists the pathnames of the device special	files  associated
				     with  the device that are allocatable to the current process
				     but are not currently allocated.

				     If dev-class is specified, lists only the	files  associated
				     with all devices of the specified device class.

				     If device is specified, lists only the files associated with
				     the specified device.

       -s			     Silent. Suppresses any diagnostic output.

       -u [-c dev-class | device]    Lists the pathnames of device special files associated  with
				     the  device  that	are allocated to the owner of the current
				     process.

				     If dev-class is specified, lists only the	files  associated
				     with all devices of the specified device class.

				     If device is specified, lists only the files associated with
				     the specified device.

       -U uid			     Uses the user ID uid instead of the real user ID of the cur-
				     rent  process  when  performing  the list_devices operation.
				     Only a user with the solaris.device.revoke authorization can
				     use this option.

       The following options are supported when the system is configured with Trusted Extensions:

       -a	      Lists  attributes like authorizations, cleaning programs and labels associ-
		      ated with a device.

		      The list is a single line of semicolon (;) separated  key=value  pairs  for
		      each device in the format:

			device=device-name;type=device-type;\
			auths=auths;clean=device-exec;\
			device-attributes;\
			files=device-list

		      where   device-attributes  is  the  contents  of	the  reserved1	field  of
		      device_allocate(4). The field is colon (:) separated.)

		      See device_allocate(4) for a description of these attributes and their for-
		      mat.

		      The -a output has the following keys:

		      auths	Specifies  the	list  of  authorizations.  The	value is auths is
				described in device_allocate(4).

		      clean	Specifies the device cleaning script. The value is device-exec as
				described in device_allocate(4).

		      device	Specifies  the device name. The value is device-name as described
				in device_allocate(4).

		      files	Specifies the device file paths.  The  value  is  device-list  as
				described in device_maps(4).

		      type	Specifies  the device type. The value is device-type as described
				in device_allocate(4).

       -d	      Displays the system-supplied default attributes for the device  types  man-
		      aged  by	device allocation. If dev-type is specified, it lists the default
		      attributes for only that device type.

       -w	      This option can be used with -a to list the current owner of the device  as
		      the  key	value  pair owner=value. value is the uid of the current owner of
		      the device. If the device is unallocated, value is /FREE. If the device  is
		      in error state, value is /ERROR. This option also suppresses any diagnostic
		      output.

       -z zonename    When specified with the -l option, lists only those  non-allocated  devices
		      whose  label range includes the label of the zonename, and of the allocated
		      devices, only those that are allocated at the same label as that	of  zone-
		      name.

		      When  specified  with the -n option, lists only those non-allocated devices
		      whose label range includes the label of the zonename.

		      When specified with the -u option, lists only those devices that are  allo-
		      cated at the same label as that of zonename.

EXAMPLES
       Example 1 Listing All Devices

       The following example lists all devices available to the caller for allocation:

	 % list_devices -l
	 device: audio type: audio \
	 files: /dev/audio /dev/audioctl /dev/sound/0 /dev/sound/0ctl

       Example 2 Listing Attributes of All Devices

       On  a system configured with Trusted Extensions, the following example lists attributes of
       all devices available to the caller for allocation:

	 % list_devices -al
	 device=audio1;type=audio;\
	 auths=solaris.device.allocate;\
	 clean=/etc/security/lib/audio_clean;\
	 minlabel=admin_low:maxlabel=admin_high;\
	 files=/dev/audio1 /dev/audio1ctl /dev/sound/1 /dev/sound/1ctl

       Example 3 Listing Attributes Including the Device Owner

       On a system configured with Trusted Extensions, the  following  example	lists  attributes
       including the device owner of all devices allocated to the user:

	 % list_devices -auw
	 device=audio2;type=audio;auths=solaris.device.allocate;\
	 clean=/etc/security/lib/audio_clean;\
	 minlabel=admin_low:maxlabel=admin_high:zone=public;\
	 owner=1234;\
	 files=/dev/audio2 /dev/audio2ctl /dev/sound/2 /dev/sound/2ctl

EXIT STATUS
       The following exit values are returned:

       0	      Successful completion.

       20	      No entry for the specified device.

       other value    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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |See below.		   |
       +-----------------------------+-----------------------------+

       The  invocation is Uncommitted. The options are Uncommitted. The output from the -a and -w
       options is Uncommitted. All other output is Not-an-Interface.

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

       Controlling Access to Devices

NOTES
       The  functionality  described  in this man page is available only if  Solaris Auditing has
       been enabled. See bsmconv(1M) for more information.

       On systems configured with Trusted Extensions, the functionality is enabled by default.

       /etc/security/dev, mkdevalloc(1M), and mkdevmaps(1M) might not be supported  in	a  future
       release of the Solaris Operating Environment.

SunOS 5.11				   30 Apr 2008				  list_devices(1)


All times are GMT -4. The time now is 06:54 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password





Not a Forum Member?
Forgot Password?