System Administration Commands addallocatable(1M)
NAME
addallocatable - add entries to allocation databases
SYNOPSIS
/usr/sbin/addallocatable [-f] [-s] [-d] -n name -t type -l device-list
[-a authorization] [-c clean] [-o key=value]
DESCRIPTION
addallocatable creates new entries for user allocatable
devices that are to be managed by the device allocation
mechanism. addallocatable can also be used to update exist-
ing entries of such devices.
addallocatable can also create and update entries for non-
allocatable devices, such as printers, whose label range is
managed by the device allocation mechanism.
addallocatable can be used in shell scripts, such as ins-
tallation scripts for driver packages, to automate the
administrative work of setting up a new device.
Use listdevices(1) to see the names and types of allocat-
able devices, their attributes, and device paths.
OPTIONS
-f Force an update of an already-existing
entry with the specified information.
addallocatable 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. addallocatable
does not print any error or warning mes-
sages.
-d If this option is present,
addallocatable updates the system-
supplied default attributes of the dev-
ice type specified with -t.
-n name Adds or updates an entry for device that
is specified by name.
SunOS 5.11 Last change: 20 Jul 2007 1
System Administration Commands addallocatable(1M)
-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 dev-
ice 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 dev-
ices 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 dev-
ice is not allocatable, authorization is
specified with an asterisk (*) and must
be quoted. When the device is allocat-
able by any user, authorization is
specified with the at sign (@) and must
be quoted. Default authorization is '@'.
-c clean Specifies the deviceclean(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 fol-
lowing 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 group-
ing of devices. For example,
all Sun RayTM devices of all
device types is a logical
SunOS 5.11 Last change: 20 Jul 2007 2
System Administration Commands addallocatable(1M)
grouping. The class keyword
has no default value.
xdpy Specifies the display name
of the X session. This key-
word is used to identify
devices that are associated
with the X session. The xdpy
keyword has no default
value.
EXIT STATUS
When successful, addallocate returns an exit status of 0
(true). addallocate 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.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWtsu
Interface Stability See below.
The invocation is Uncommitted. The options are Uncommitted.
The output is Not-an-Interface.
SunOS 5.11 Last change: 20 Jul 2007 3
System Administration Commands addallocatable(1M)
SEE ALSO
allocate(1), deallocate(1), listdevices(1),
removeallocatable(1M), attributes(5), deviceclean(5)
NOTES
The functionality described on this manual page is available
only if the system is configured with Trusted Extensions.
SunOS 5.11 Last change: 20 Jul 2007 4
|
