getdev(1M)

NAME

     getdev - lists devices based on criteria

SYNOPSIS

     getdev [-ae] [criteria...] [device...]

DESCRIPTION

     getdev generates a list of devices that match  certain  cri-
     teria.  The criteria includes a list of attributes (given in
     expressions) and a list of  devices.  If  no   criteria  are
     given, all devices are included in the list.

     Devices must satisfy at least one of  the  criteria  in  the
     list unless the  -a option is used. Then, only those devices
     which match all of the criteria in a list will be included.

     Devices which are defined on  the  command  line  and  which
     match  the criteria are included in the generated list. How-
     ever, if the -e option is used, the list becomes  a  set  of
     devices  to  be  excluded  from  the  list. See  OPTIONS and
     OPERANDS.

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 devices  which  follows  on
           the command line should be excluded from the list gen-
           erated by this command. Without the -e the named  dev-
           ices  are included in the generated list. The flag has
           no effect if no devices are defined.

OPERANDS

     The following operands are supported:

     criteria
           Defines the criteria that a device must  match  to  be
           included  in the generated list. criteria is specified
           by expressions.

           There are four possible  expression  types  which  the
           criteria  specified in the  criteria argument may fol-
           low:

           attribute=value
                 Selects all devices whose attribute attribute is
                 defined and is equal to value.

           attribute!=value
                 Selects all devices whose attribute attribute is
                 defined and does not equal value.

           attribute:*
                 Selects all devices  which  have  the  attribute
                 attribute defined.

           attribute!:*
                 Selects all devices which do not have the attri-
                 bute attribute defined.

           See the putdev(1M) manual page for a complete  listing
           and description of available attributes.

     device
           Defines the devices which should be  included  in  the
           generated list. This can be the pathname of the device
           or the device alias.

EXIT STATUS

     The  following  exit values are returned:

     0     Successful completion.

     1     Command syntax was incorrect, invalid option was used,
           or an internal error occurred.

     2     Device table could not be opened for reading.

FILES

     /etc/device.tab

ATTRIBUTES

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO

     devattr(1M), getdgrp(1M),  putdev(1M),  putdgrp(1M),  attri-
     butes(5)