getdgrp(1M) System Administration Commands getdgrp(1M)NAMEgetdgrp - lists device groups which contain devices that match criteria
SYNOPSIS
/usr/sbin/getdgrp [-ael] [criteria...] [dgroup...]
DESCRIPTIONgetdgrp 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.
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 getd‐
grp. 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 per‐
formed. 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 fol‐
low:
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
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 ALSOdevattr(1M), getdev(1M), putdev(1M), putdgrp(1M), attributes(5)SunOS 5.10 5 Jul 1990 getdgrp(1M)