getdev

 

---

 
 
 
 Maintenance Commands                                   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.
 
 
 
 
 SunOS 5.8            Last change: 5 Jul 1990                    1
 
 
 
 
 
 
 Maintenance Commands                                   getdev(1M)
 
 
 
            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)
 
 
 
 
 
 
 
 
 SunOS 5.8            Last change: 5 Jul 1990                    2
 
 
 

---