getdev(1M)						  System Administration 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 criteria. 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. However, 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 generated by this command.
	     Without the -e the named devices 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 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.

       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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       devattr(1M), getdgrp(1M), putdev(1M), putdgrp(1M), attributes(5)

SunOS 5.11							    5 Jul 1990								getdev(1M)