 以 PDF 格式下载本书 (937 KB)
add_allocatable(1M)
NAME
| Synopsis
| Description
| Options
| Errors
| Attributes
| See Also
NAME
add_allocatable – add entries to allocation databases
Synopsis
/usr/sbin/add_allocatable [-f] [-s] [-d] -n name -t type -l device-list
[-a authorization] [-c clean] [-o key=value]
Description
add_allocatable creates new entries for user allocatable
devices that are to be managed by the device allocation mechanism. add_allocatable can also be used to update existing entries of such devices.
add_allocatable can also create and update entries
for non-allocatable devices, such as printers, whose label range is managed
by the device allocation mechanism.
add_allocatable can be used in shell scripts, such
as installation scripts for driver packages, to automate the administrative
work of setting up a new device.
Use list_devices(1) to see the names and types of allocatable devices,
their attributes, and device paths.
Options
-
-f
-
Force an update of an already-existing entry with the specified
information. add_allocatable exits with an error if this
option is not specified when an entry with the specified device name already
exists.
-
-s
-
Turn on silent mode. add_allocatable does
not print any error or warning messages.
-
-d
-
If this option is present, add_allocatable updates
the system-supplied default attributes of the device type specified with -t.
-
-n name
-
Adds or updates an entry for device that is specified by name.
-
-t type
-
Adds or updates device entries that are of a type that are
specified by type.
-
-l device-list
-
Adds or updates device paths to the device that is specified
with -n. Multiple paths in device-list must
be separated by white spaces and the list must be quoted.
-
-a authorization
-
Adds or updates the authorization that is associated with
either the device that is specified with -n or with devices
of the type that is specified with -t. When more than one
authorization is specified, the list must be separated by commas and must
be quoted. When the device is not allocatable, authorization is
specified with an asterisk (*) and must be quoted. When the device is allocatable
by any user, authorization is specified with the
at sign (@) and must be quoted. Default authorization is '@'.
-
-c clean
-
Specifies the device_clean(5) program clean to
be used with the device that is specified with -n or with
devices of the type that is specified with -t. The default
clean program is /bin/true.
-
-o key=value
-
Accepts a string of colon-separated key=value pairs for a device that is specified with -n or with devices of the type that is specified with -t.
The following keys are currently interpreted by the system:
-
minlabel
-
The minimum label at which the device can be used.
-
maxlabel
-
The maximum label at which the device can be used.
-
class
-
Specifies a logical grouping of devices. For example, all Sun RayTM devices of all device types is a logical grouping. The class keyword has no default value.
-
xdpy
-
Specifies the display name of the X session. This keyword
is used to identify devices that are associated with the X session. The xdpy keyword has no default value.
Errors
When successful, add_allocate returns an exit status
of 0 (true). add_allocate returns
a nonzero exit status in the event of an error. The exit codes are as follows:
-
1
-
Invocation syntax error
-
2
-
Unknown system error
-
3
-
An entry already exists for the specified device. This error
occurs only when the -f option is not specified.
-
4
-
Permission denied. User does not have DAC or MAC access record
updates.
Attributes
See attributes(5) for
descriptions of the following attributes:
|
ATTRIBUTE TYPE
|
ATTRIBUTE VALUE
|
|
Availability
|
SUNWtsu
|
|
Interface Stability
|
See below.
|
The invocation is Uncommitted. The options are Uncommitted. The output
is Not-an-interface.
See Also
SunOS 5.10 Last Revised 15 June 2007
NAME
| Synopsis
| Description
| Options
| Errors
| Attributes
| See Also
|
