getdgrp(1M)						  System Administration Commands					       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 expres-
       sions.

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.  Without
		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 specified 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 "logi-
		       cal and" operation  should be performed. Then, only those groups containing devices which match all of the  criteria  in  a
		       list will be included.

		       There are four possible expressions types which the criteria 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  crite-
		       ria 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 reading.

FILES

       /etc/device.tab

       /etc/dgroup.tab

ATTRIBUTES

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

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

SEE ALSO

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

SunOS 5.10							    5 Jul 1990							       getdgrp(1M)