|
|
Trouble with Backslashes
|
|
add_allocatable(1M) System Administration Commands add_allocatable(1M) 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 set- ting 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 logi- cal 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(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
allocate(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.11 20 Jul 2007 add_allocatable(1M)
