xref: /illumos-gate/usr/src/man/man8/remove_allocatable.8 (revision 1e56f352c1c208679012bca47d552e127f5b1072)
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]
REMOVE_ALLOCATABLE 8 "Jul 20, 2007"
NAME
remove_allocatable - remove entries from allocation databases
SYNOPSIS

/usr/sbin/remove_allocatable [-f] -n name

/usr/sbin/remove_allocatable [-f] [-d] -t dev-type
DESCRIPTION

remove_allocatable removes entries of user allocatable devices from the device allocation mechanism. remove_allocatable also removes entries of some non-allocatable devices, such as printers, whose label range is managed by the mechanism.

OPTIONS

The following options are supported: -d

Removes system-supplied default attributes of the device type that is specified with -t.

-f

Force the removal of an entry. remove_allocatable exits with an error if this option is not specified when an entry with the specified device name no longer exists.

-n name

Removes the entry for the device name.

-t dev-type

Removes devices of type dev-type.

EXIT STATUS

When successful, remove_allocatable returns an exit status of 0 (true). remove_allocatable 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

Device name or dev-type not found. This error occurs only when the -f option is not specified.

4

Permission denied. User does not have DAC or MAC access to database.

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), attributes (7), device_clean (7), add_allocatable (8)

NOTES

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