getdev(1M)                                                       getdev(1M)


   NAME
         getdev - lists devices based on criteria

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

   DESCRIPTION
         getdev generates a list of devices that match certain criteria.  The
         criteria includes a list of attributes (given in expressions) and a
         list of devices.  If no criteria is 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.  However, if the -e flag
         is used, the list becomes a set of devices to be excluded from the
         list.

      Criteria Expression Types
         There are four possible expression types which the criteria specified
         in the criteria argument may follow:

         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 attribute
                           attribute defined.

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

      Options and Arguments
         The options and arguments for this command are:

         -a                Specifies that a device must match all criteria to
                           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 devices which follows on
                           the command line should be excluded from the list
                           generated by this command.  (Without the -e the
                           named devices are included in the generated list.)


   7/91                                                                 Page 1

   getdev(1M)                                                       getdev(1M)


                           The flag has no effect if no devices are defined.

         criteria          Defines criteria that a device must match to be
                           included in the generated list.  Should be given in
                           expressions.

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

   ERRORS
         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 could not be opened for reading.

   FILES
         /etc/device.tab

   SEE ALSO
         devattr(1), getdgrp(1), putdev(1), putdgrp(1), getdev(3X).

























   Page 2                                                                 7/91