getdev(1m) - osol9

1getdev(1M)              System Administration Commands              getdev(1M)
2
3
4

NAME

6       getdev - lists devices based on criteria
7

SYNOPSIS

9       getdev [-ae] [criteria]... [device]...
10
11

DESCRIPTION

13       getdev  generates  a  list  of devices that match certain criteria. The
14       criteria includes a list of attributes (given  in  expressions)  and  a
15       list of devices. If no  criteria are given, all devices are included in
16       the list.
17
18
19       Devices must satisfy at least one of the criteria in  the  list  unless
20       the  -a option is used. Then, only those devices which match all of the
21       criteria in a list will be included.
22
23
24       Devices which are defined on the command line and which match the  cri‐
25       teria  are included in the generated list. However, if the -e option is
26       used, the list becomes a set of devices to be excluded from  the  list.
27       See  OPTIONS and  OPERANDS.
28

OPTIONS

30       The following options are supported:
31
32       -a    Specifies that a device must match all criteria to be included in
33             the list generated by this command. The option has no  effect  if
34             no criteria are defined.
35
36
37       -e    Specifies  that  the list of devices which follows on the command
38             line should be excluded from the list generated by this  command.
39             Without  the  -e  the named devices are included in the generated
40             list. The flag has no effect if no devices are defined.
41
42

OPERANDS

44       The following operands are supported:
45
46       criteria    Defines the  criteria  that  a  device  must  match  to  be
47                   included  in  the  generated list. criteria is specified by
48                   expressions.
49
50                   There are four possible expression types which the criteria
51                   specified in the  criteria argument may follow:
52
53                   attribute=value     Selects  all  devices  whose  attribute
54                                       attribute is defined and  is  equal  to
55                                       value.
56
57
58                   attribute!=value    Selects  all  devices  whose  attribute
59                                       attribute is defined and does not equal
60                                       value.
61
62
63                   attribute:*         Selects  all  devices  which  have  the
64                                       attribute attribute defined.
65
66
67                   attribute!:*        Selects all devices which do  not  have
68                                       the attribute attribute defined.
69
70                   See  the  putdev(1M) manual page for a complete listing and
71                   description of available attributes.
72
73
74       device      Defines the devices which should be included in the  gener‐
75                   ated  list.  This  can be the pathname of the device or the
76                   device alias.
77
78

EXIT STATUS

80       The  following  exit values are returned:
81
82       0    Successful completion.
83
84
85       1    Command syntax was incorrect,  invalid  option  was  used,  or  an
86            internal error occurred.
87
88
89       2    Device table could not be opened for reading.
90
91

FILES

93       /etc/device.tab
94
95

ATTRIBUTES

97       See attributes(5) for descriptions of the following attributes:
98
99
100
101
102       ┌─────────────────────────────┬─────────────────────────────┐
103       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
104       ├─────────────────────────────┼─────────────────────────────┤
105       │Availability                 │SUNWcsu                      │
106       └─────────────────────────────┴─────────────────────────────┘
107