getdgrp(1M) getdgrp(1M)
NAME
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.
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.
Copyright 1994 Novell, Inc. Page 1
getdgrp(1M) getdgrp(1M)
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
Copyright 1994 Novell, Inc. Page 2
getdgrp(1M) getdgrp(1M)
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)
Copyright 1994 Novell, Inc. Page 3