add_allocatable(1M) System Administration Commands add_allocatable(1M)NAMEadd_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]
DESCRIPTIONadd_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 speci‐
fied 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 associ‐
ated 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 speci‐
fied, 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 logi‐
cal grouping. The class keyword has no
default value.
xdpy Specifies the display name of the X
session. This keyword is used to iden‐
tify devices that are associated with
the X session. The xdpy keyword has no
default value.
EXIT STATUS
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 ALSOallocate(1), deallocate(1), list_devices(1), remove_allocatable(1M),
attributes(5), device_clean(5)NOTES
The functionality described on this manual page is available only if
the system is configured with Trusted Extensions.
SunOS 5.10 20 Jul 2007 add_allocatable(1M)