add_allocatable - add entries to allocation databases
/usr/sbin/add_allocatable [-f] [-s] [-d] -n name -t type -l device-list
[-a authorization] [-c clean] [-o key=value]
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
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.
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
Turn on silent mode. add_allocatable does not
print any error or warning messages.
If this option is present, add_allocatable updates
the system-supplied default attributes of the device type specified with
Adds or updates an entry for device that is specified by
Adds or updates device entries that are of a type that
are specified by type.
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.
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 '@'.
Specifies the device_clean(5)
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
Accepts a string of colon-separated
pairs for a device that is specified with
or with devices of the type that is specified with -t
following keys are currently interpreted by the system:
The minimum label at which the device can be used.
The maximum label at which the device can be used.
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.
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.
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:
Invocation syntax error
Unknown system error
An entry already exists for the specified device. This
error occurs only when the -f option is not specified.
Permission denied. User does not have DAC or MAC access
See attributes(5) for descriptions of the following
The invocation is Uncommitted. The options are Uncommitted. The
output is Not-an-Interface.
The functionality described on this manual page is available only
if the system is configured with Trusted Extensions.