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 dev-
ices 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 com-
mand line should be excluded from the list generated
by this command. Without the -e option the named dev-
ice 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 cri-
teria are given, all device groups are included
in the list.
Devices must satisfy at least one of the cri-
teria in the list. However, the -a option can
be used to define that a "logical and" operation
should be performed. Then, only those groups
containing devices which match all of the
SunOS 5.11 Last change: 5 Jul 1990 1
System Administration Commands getdgrp(1M)
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 attri-
bute attribute is defined
and is equal to value.
attribute!=value Selects all device groups
with a member whose attri-
bute 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.
SunOS 5.11 Last change: 5 Jul 1990 2
System Administration Commands getdgrp(1M)
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
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWcsu
SEE ALSO
devattr(1M), getdev(1M), putdev(1M), putdgrp(1M), attri-
butes(5)
SunOS 5.11 Last change: 5 Jul 1990 3
|
