man/man1m/remove_allocatable.1m

         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 1M "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(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), add_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.