getdgrp(1M) getdgrp(1M)
NAME
getdgrp - lists device groups which contain devices that match cri-
teria
SYNOPSIS
getdgrp [-ael] [criteria [...]] [dgroup [...]]
DESCRIPTION
getdgrp generates a list of device groups that contain devices match-
ing the given criteria. The criteria are given in the form of expres-
sions.
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 are given, all device groups are included in
the list.
Devices must satisfy at least one of the criteria in the list. How-
ever, 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.
Page 1 Reliant UNIX 5.44 Printed 11/98
getdgrp(1M) getdgrp(1M)
OPTIONS
-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 cri-
teria 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 cri-
teria 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.
DIAGNOSTICS
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 read-
ing.
FILES
/etc/device.tab
/etc/dgroup.tab
SEE ALSO
devattr(1M), getdev(1M), putdev(1M), putdgrp(1M).
Page 2 Reliant UNIX 5.44 Printed 11/98