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

NAME

6       add_allocatable - add entries to allocation databases
7

SYNOPSIS

9       /usr/sbin/add_allocatable [-f] [-s] [-d] -n name -t type -l device-list
10           [-a authorization] [-c clean] [-o key=value]
11
12

DESCRIPTION

14       add_allocatable  creates  new entries for user allocatable devices that
15       are to be managed by the device allocation  mechanism.  add_allocatable
16       can also be used to update existing entries of such devices.
17
18
19       add_allocatable  can also create and update entries for non-allocatable
20       devices, such as printers, whose label range is managed by  the  device
21       allocation mechanism.
22
23
24       add_allocatable  can  be  used  in  shell scripts, such as installation
25       scripts for driver packages, to automate  the  administrative  work  of
26       setting up a new device.
27
28
29       Use  list_devices(1) to see the names and types of allocatable devices,
30       their attributes, and device paths.
31

OPTIONS

33       -f                  Force an update of an already-existing  entry  with
34                           the  specified  information.  add_allocatable exits
35                           with an error if this option is not specified  when
36                           an  entry  with  the  specified device name already
37                           exists.
38
39
40       -s                  Turn on silent mode. add_allocatable does not print
41                           any error or warning messages.
42
43
44       -d                  If  this option is present, add_allocatable updates
45                           the  system-supplied  default  attributes  of   the
46                           device type specified with -t.
47
48
49       -n name             Adds  or updates an entry for device that is speci‐
50                           fied by name.
51
52
53       -t type             Adds or updates device entries that are of  a  type
54                           that are specified by type.
55
56
57       -l device-list      Adds  or updates device paths to the device that is
58                           specified with -n. Multiple  paths  in  device-list
59                           must be separated by white spaces and the list must
60                           be quoted.
61
62
63       -a authorization    Adds or updates the authorization that  is  associ‐
64                           ated  with either the device that is specified with
65                           -n or with devices of the type  that  is  specified
66                           with -t. When more than one authorization is speci‐
67                           fied, the list must be separated by commas and must
68                           be  quoted.  When  the  device  is not allocatable,
69                           authorization is specified with an asterisk (*) and
70                           must  be  quoted. When the device is allocatable by
71                           any user, authorization is specified  with  the  at
72                           sign  (@) and must be quoted. Default authorization
73                           is '@'.
74
75
76       -c clean            Specifies the device_clean(5) program clean  to  be
77                           used  with  the device that is specified with -n or
78                           with devices of the type that is specified with -t.
79                           The default clean program is /bin/true.
80
81
82       -o key=value        Accepts a string of colon-separated key=value pairs
83                           for a device that is  specified  with  -n  or  with
84                           devices  of the type that is specified with -t. The
85                           following keys are  currently  interpreted  by  the
86                           system:
87
88                           minlabel    The  minimum  label at which the device
89                                       can be used.
90
91
92                           maxlabel    The maximum label at which  the  device
93                                       can be used.
94
95
96                           class       Specifies   a   logical    grouping  of
97                                       devices. For  example,  all  Sun  RayTM
98                                       devices  of all device types is a logi‐
99                                       cal grouping. The class keyword has  no
100                                       default value.
101
102
103                           xdpy        Specifies  the  display  name  of the X
104                                       session. This keyword is used to  iden‐
105                                       tify  devices  that are associated with
106                                       the X session. The xdpy keyword has  no
107                                       default value.
108
109
110

EXIT STATUS

112       When  successful,  add_allocate  returns  an  exit  status of 0 (true).
113       add_allocate returns a nonzero exit status in the event  of  an  error.
114       The exit codes are as follows:
115
116       1    Invocation syntax error
117
118
119       2    Unknown system error
120
121
122       3    An  entry  already  exists  for  the  specified device. This error
123            occurs only when the -f option is not specified.
124
125
126       4    Permission denied. User does not have DAC  or  MAC  access  record
127            updates.
128
129

ATTRIBUTES

131       See attributes(5) for descriptions of the following attributes:
132
133
134
135
136       ┌──────────────────────────────┬────────────────────────────┐
137       │       ATTRIBUTE TYPE         │      ATTRIBUTE VALUE       │
138       ├──────────────────────────────┼────────────────────────────┤
139       │Availability                  │SUNWtsu                     │
140       ├──────────────────────────────┼────────────────────────────┤
141       │Interface Stability           │See below.                  │
142       └──────────────────────────────┴────────────────────────────┘
143
144
145       The  invocation is Uncommitted. The options are Uncommitted. The output
146       is Not-an-Interface.
147

SEE ALSO

149       allocate(1),  deallocate(1),  list_devices(1),  remove_allocatable(1M),
150       attributes(5), device_clean(5)
151

NOTES

153       The  functionality  described  on this manual page is available only if
154       the system is configured with Trusted Extensions.
155
156
157
158SunOS 5.11                        20 Jul 2007              add_allocatable(1M)
Impressum