Manual Pages for UNIX Operating System command usage for man getdgrp

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


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|


SEE ALSO
     devattr(1M),  getdev(1M),  putdev(1M),  putdgrp(1M),  attri-
     butes(5)
























SunOS 5.11           Last change: 5 Jul 1990                    3