getdgrp man page on SmartOS

Printed from http://www.polarhome.com/service/man/?qf=getdgrp&af=0&tf=2&of=SmartOS

GETDGRP(1M)							   GETDGRP(1M)

NAME
       getdgrp - lists device groups which contain devices that match criteria

SYNOPSIS
       /usr/sbin/getdgrp [-ael] [criteria]... [dgroup]...

DESCRIPTION
       getdgrp generates a list of device groups that contain devices matching
       the given criteria. The criteria is given in the form of expressions.

OPTIONS
       The following options are supported:

       -a
	     Specifies that a device must match all criteria to be included in
	     the  list	generated by this command. The option has no effect if
	     no criteria are defined.

       -e
	     Specifies that the list of device	groups	on  the	 command  line
	     should be excluded from the list generated by this command. With‐
	     out the  -e option the named device groups are  included in   the
	     generated list. The flag has no effect if no devices are defined.

       -l
	     Specifies	that  all device groups (subject to the	 -e option and
	     the dgroup list) should be listed even if they contain  no	 valid
	     device  members. This option has no affect if  criteria is speci‐
	     fied on the command line.

OPERANDS
       The following operands are supported:

       criteria
		   Defines criteria that a device must match before  a	device
		   group  to which it belongs can be included in the generated
		   list. Specify criteria  as  an  expression  or  a  list  of
		   expressions	which  a  device must meet for its group to be
		   included in the list	 generated by  getdgrp. If no criteria
		   are given, all device groups are included in the list.

		   Devices  must  satisfy  at least one of the criteria in the
		   list. However,  the -a option can be used to define that  a
		   "logical  and"  operation   should be performed. Then, only
		   those groups containing devices which match all of the cri‐
		   teria in a list will be included.

		   There  are four possible expressions types which the crite‐
		   ria specified in the criteria argument may follow:

		   attribute=value
				       Selects all device groups with a member
				       whose  attribute	  attribute is defined
				       and is equal to	value.

		   attribute!=value
				       Selects all device groups with a member
				       whose  attribute	  attribute is defined
				       and does not equal  value.

		   attribute:*
				       Selects all device groups with a member
				       which   has  the	  attribute  attribute
				       defined.

		   attribute!:*
				       Selects all device groups with a member
				       which   does  not  have	the  attribute
				       attribute defined.

		   See putdev(1M) for a complete listing  and  description  of
		   available attributes.

       dgroup
		   Defines  a set of device groups which should be included in
		   or excluded from the generated list. Device groups that are
		   defined  and	 which	contain devices matching  the criteria
		   are included.

		   If the  -e option is used,  this  list  defines  a  set  of
		   device  groups  to be excluded. When the  -e option is used
		   and	criteria is also  defined,  the	 generated  list  will
		   include  device  groups  containing devices which match the
		   criteria and are not in the command line list.

EXIT STATUS
       The following exit values are returned:

       0
	    Successful completion of the task.

       1
	    Command syntax was incorrect,  invalid  option  was	 used,	or  an
	    internal error occurred.

       2
	    Device  table  or device group table could not be opened for read‐
	    ing.

FILES
       /etc/device.tab

       /etc/dgroup.tab

SEE ALSO
       devattr(1M), getdev(1M), putdev(1M), putdgrp(1M), attributes(5)

				  Jul 5, 1990			   GETDGRP(1M)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net