getdgrp(1M) MISC. REFERENCE MANUAL PAGES 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 dev-
ices 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 cri-
teria 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 cri-
teria 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 cri-
teria 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 gen-
erated 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 attri-
bute defined.
See the putdev(1M) manual page for a com-
plete listing and description of available
attributes.
Options and Arguments
The options and arguments for this command are:
Last change: Essential Utilities 1
getdgrp(1M) MISC. REFERENCE MANUAL PAGES getdgrp(1M)
-a Specifies that a device must match all
criteria before a device group to which it
belongs can be included in the list gen-
erated by this command. The flag 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 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 inter-
nal 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).
Last change: Essential Utilities 2