getdgrp(1M) UNIX System V(Essential Utilities) getdgrp(1M)
NAME
getdgrp - lists device groups which contain devices that match criteria
SYNOPSIS
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.
criteria can be one 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 is given, all device groups are included in the list.
Devices must satisfy at least one of the criteria in the list. However,
the -a flag can be used to define that a "logical and" operation should
be performed. Then, only those groups containing devices which match all
of the criteria in a list will be included.
dgroup defines a set of device groups to be included in the list. Device
groups that are defined and which contain devices matching the criteria
are included. However, if the -e flag 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.
Criteria Expression Types
There are four possible expressions types:
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 the putdev(1M) manual page for a complete listing
and description of available attributes.
Options and Arguments
The options and arguments for this command are:
-a Specifies that a device must match all criteria before
a device group to which it belongs can be included in
the list generated by this command. The flag has no
effect if no criteria are defined.
10/89 Page 1
getdgrp(1M) UNIX System V(Essential Utilities) getdgrp(1M)
-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 the named device groups are
the only ones which can be included in the generated
list.) The flag has no effect if no device groups 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.
criteria Defines criteria that a device must match before a
device group to which it belongs can be included in the
generated list.
dgroup Defines device groups which should be included in or
excluded from the generated list.
ERRORS
The command will exit with one of the following values:
0 = successful completion of the task.
1 = command syntax incorrect, invalid option used, or internal error
occurred.
2 = device table or device group table could not be opened for reading.
FILES
/etc/device.tab
/etc/dgroup.tab
SEE ALSO
devattr(1), getdev(1), putdev(1), putdgrp(1), getdgrp(3X)
Page 2 10/89