1add_allocatable(1M) System Administration Commands add_allocatable(1M)
2
3
4
6 add_allocatable - add entries to allocation databases
7
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
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
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
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
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
149 allocate(1), deallocate(1), list_devices(1), remove_allocatable(1M),
150 attributes(5), device_clean(5)
151
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)