getdgrp(1M)                    DG/UX R4.11MU05                   getdgrp(1M)


NAME
       getdgrp - lists device groups which contain devices that match
       criteria

SYNOPSIS
       getdgrp [-ael] [criteria [...]] [dgroup [...]]

   where:
       criteria
              Criteria that a device must match before a device group to
              which it belongs can be included in the generated list
       dgroup Device groups which should be included in or excluded from the
              generated list.

DESCRIPTION
       Getdgrp generates a list of device groups that contain devices
       matching the given criteria.  The criteria is given in the form of
       expressions.

       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 no criteria is given, 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.

   Criteria Expression Types
       There are four possible expressions 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.

   Options
       The options for this command are:

       -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
              is specified on the command line.

FILES
       /etc/device.tab
       /etc/dgroup.tab

DIAGNOSTICS
       The command will exit 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.

SEE ALSO
       devattr(1M), getdev(1M), listdgrp(1M), putdev(1M), putdgrp(1M).


Licensed material--property of copyright holder(s)