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)