xref: /titanic_44/usr/src/man/man1m/add_allocatable.1m (revision 56b2bdd1f04d465cfe4a95b88ae5cba5884154e4)
te
Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
ADD_ALLOCATABLE 1M "Jul 20, 2007"
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(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 Ray\u\s-2TM\s+2\d 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(5) 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), 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.