usr/src/man/man1m/remove_allocatable.1m

   1 '\" te
   2 .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH REMOVE_ALLOCATABLE 1M "Jul 20, 2007"
   7 .SH NAME
   8 remove_allocatable \- remove entries from allocation databases
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/sbin/remove_allocatable\fR  [\fB-f\fR] \fB-n\fR \fIname\fR
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fB/usr/sbin/remove_allocatable\fR  [\fB-f\fR] [\fB-d\fR] \fB-t\fR \fIdev-type\fR
  18 .fi
  19
  20 .SH DESCRIPTION
  21 .sp
  22 .LP
  23 \fBremove_allocatable\fR removes entries of user allocatable devices from the
  24 device allocation mechanism. \fBremove_allocatable\fR also removes entries of
  25 some non-allocatable devices, such as printers, whose label range is managed by
  26 the mechanism.
  27 .SH OPTIONS
  28 .sp
  29 .LP
  30 The following options are supported:
  31 .sp
  32 .ne 2
  33 .na
  34 \fB\fB-d\fR\fR
  35 .ad
  36 .RS 15n
  37 Removes  system-supplied  default attributes of the device type that is
  38 specified with \fB-t\fR.
  39 .RE
  40
  41 .sp
  42 .ne 2
  43 .na
  44 \fB\fB-f\fR\fR
  45 .ad
  46 .RS 15n
  47 Force the removal of an entry. \fBremove_allocatable\fR exits with an error if
  48 this option is not specified when an entry with the specified device name no
  49 longer exists.
  50 .RE
  51
  52 .sp
  53 .ne 2
  54 .na
  55 \fB\fB-n\fR \fIname\fR\fR
  56 .ad
  57 .RS 15n
  58 Removes the entry for the device \fIname\fR.
  59 .RE
  60
  61 .sp
  62 .ne 2
  63 .na
  64 \fB\fB-t\fR \fIdev-type\fR\fR
  65 .ad
  66 .RS 15n
  67 Removes devices of type \fIdev-type\fR.
  68 .RE
  69
  70 .SH EXIT STATUS
  71 .sp
  72 .LP
  73 When successful, \fBremove_allocatable\fR returns an exit status of \fB0\fR
  74 (true). \fBremove_allocatable\fR returns a nonzero exit status in the event of
  75 an error. The exit codes are as follows:
  76 .sp
  77 .ne 2
  78 .na
  79 \fB\fB1\fR\fR
  80 .ad
  81 .RS 5n
  82 Invocation syntax error
  83 .RE
  84
  85 .sp
  86 .ne 2
  87 .na
  88 \fB\fB2\fR\fR
  89 .ad
  90 .RS 5n
  91 Unknown system error
  92 .RE
  93
  94 .sp
  95 .ne 2
  96 .na
  97 \fB\fB3\fR\fR
  98 .ad
  99 .RS 5n
 100 Device \fIname\fR or \fIdev-type\fR not found. This error occurs only when the
 101 \fB-f\fR option is not specified.
 102 .RE
 103
 104 .sp
 105 .ne 2
 106 .na
 107 \fB\fB4\fR\fR
 108 .ad
 109 .RS 5n
 110 Permission denied. User does not have DAC or MAC access to database.
 111 .RE
 112
 113 .SH ATTRIBUTES
 114 .sp
 115 .LP
 116 See \fBattributes\fR(5) for descriptions of the following attributes:
 117 .sp
 118
 119 .sp
 120 .TS
 121 box;
 122 c | c
 123 l | l .
 124 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 125 _
 126 Interface Stability     See below.
 127 .TE
 128
 129 .sp
 130 .LP
 131 The invocation is Uncommitted. The options are Uncommitted. The output is
 132 Not-an-Interface.
 133 .SH SEE ALSO
 134 .sp
 135 .LP
 136 \fBallocate\fR(1), \fBdeallocate\fR(1), \fBadd_allocatable\fR(1M),
 137 \fBattributes\fR(5), \fBdevice_clean\fR(5)
 138 .SH NOTES
 139 .sp
 140 .LP
 141 The functionality described on this manual page is available only if the system
 142 is configured with Trusted Extensions.