getdgrp(1M)
getdgrp --
lists device groups that 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
are given in the form of expressions.
Command options
getdgrp takes the following
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 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 are 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.
There are four possible criteria expression 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.
Files
/etc/device.tab
/etc/dgroup.tab
Return values
getdgrp returns 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.
Usage
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 you do not provide a
criteria, 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.
References
devattr(1M),
getdev(1M),
putdev(1M),
putdgrp(1M)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004