ADD_ALLOCATABLE(8) Maintenance Procedures ADD_ALLOCATABLE(8)

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(7) 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.

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(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | See below. |
+--------------------+-----------------+


The invocation is Uncommitted. The options are Uncommitted. The output is
Not-an-Interface.

SEE ALSO

allocate(1), deallocate(1), list_devices(1), attributes(7),
device_clean(7), remove_allocatable(8)

NOTES

The functionality described on this manual page is available only if the
system is configured with Trusted Extensions.


July 20, 2007 ADD_ALLOCATABLE(8)