usr/src/man/man1/deallocate.1

   1 '\" te
   2 .\" Copyright 2008 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 DEALLOCATE 1 "Mar 6, 2017"
   7 .SH NAME
   8 deallocate \- device deallocation
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBdeallocate\fR [\fB-s\fR] [\fB-w\fR] [\fB-F\fR] [\fB-z\fR \fIzonename\fR]
  13      [\fB-c\fR \fIdev-class\fR | \fB-g\fR \fIdev-type\fR | \fIdevice\fR]
  14 .fi
  15
  16 .LP
  17 .nf
  18 \fBdeallocate\fR [\fB-s\fR] [\fB-w\fR] [\fB-F\fR] [\fB-z\fR \fIzonename\fR] \fB-I\fR
  19 .fi
  20
  21 .SH DESCRIPTION
  22 .LP
  23 The \fBdeallocate\fR command frees an allocated device. It resets the ownership
  24 and permissions on all device special files associated with the device,
  25 disabling access to that device. \fBdeallocate\fR runs the device cleaning
  26 program for that device as specified in \fBdevice_allocate\fR(4).
  27 .sp
  28 .LP
  29 The default \fBdeallocate\fR operation deallocates devices allocated to the
  30 user.
  31 .SH OPTIONS
  32 .LP
  33 The following options are supported:
  34 .sp
  35 .ne 2
  36 .na
  37 \fB\fB-c\fR \fIdev-class\fR\fR
  38 .ad
  39 .RS 16n
  40 Deallocates all devices of the specified device class.
  41 .RE
  42
  43 .sp
  44 .ne 2
  45 .na
  46 \fB\fB-F\fR \fIdevice\fR\fR
  47 .ad
  48 .RS 16n
  49 Forces deallocation of the device associated with the file specified by
  50 \fIdevice\fR. Only a user with the \fBsolaris.device.revoke\fR authorization is
  51 permitted to use this option.
  52 .RE
  53
  54 .sp
  55 .ne 2
  56 .na
  57 \fB\fB-I\fR\fR
  58 .ad
  59 .RS 16n
  60 Forces deallocation of all allocatable devices. Only a user with the
  61 \fBsolaris.device.revoke\fR authorization is permitted to use this option. This
  62 option should only be used at system initialization.
  63 .RE
  64
  65 .sp
  66 .ne 2
  67 .na
  68 \fB\fB-s\fR\fR
  69 .ad
  70 .RS 16n
  71 Silent. Suppresses any diagnostic output.
  72 .RE
  73
  74 .sp
  75 .LP
  76 The following options are supported when the system is configured with Trusted
  77 Extensions:
  78 .sp
  79 .ne 2
  80 .na
  81 \fB\fB-g\fR \fIdev-type\fR\fR
  82 .ad
  83 .RS 15n
  84 Deallocates a device of device type matching \fIdev-type\fR.
  85 .RE
  86
  87 .sp
  88 .ne 2
  89 .na
  90 \fB\fB-w\fR\fR
  91 .ad
  92 .RS 15n
  93 Runs the device cleaning program in a windowing environment. If a windowing
  94 version of the program exists, it is used. Otherwise, the standard version is
  95 run in a terminal window.
  96 .RE
  97
  98 .sp
  99 .ne 2
 100 .na
 101 \fB\fB-z\fR \fIzonename\fR\fR
 102 .ad
 103 .RS 15n
 104 Deallocates device from the zone specified by \fIzonename\fR.
 105 .RE
 106
 107 .SH OPERANDS
 108 .LP
 109 The following operands are supported:
 110 .sp
 111 .ne 2
 112 .na
 113 \fB\fIdevice\fR\fR
 114 .ad
 115 .RS 10n
 116 Deallocates the specified \fIdevice\fR.
 117 .RE
 118
 119 .SH EXIT STATUS
 120 .LP
 121 The following exit values are returned:
 122 .sp
 123 .ne 2
 124 .na
 125 \fB\fB0\fR\fR
 126 .ad
 127 .RS 15n
 128 Successful completion.
 129 .RE
 130
 131 .sp
 132 .ne 2
 133 .na
 134 \fB\fB20\fR\fR
 135 .ad
 136 .RS 15n
 137 No entry for the specified device.
 138 .RE
 139
 140 .sp
 141 .ne 2
 142 .na
 143 \fB\fIother value\fR\fR
 144 .ad
 145 .RS 15n
 146 An error occurred.
 147 .RE
 148
 149 .SH FILES
 150 .LP
 151 \fB/etc/security/device_allocate\fR
 152 .sp
 153 .LP
 154 \fB/etc/security/device_maps\fR
 155 .sp
 156 .LP
 157 \fB/etc/security/dev/*\fR
 158 .sp
 159 .LP
 160 \fB/etc/security/lib/*\fR
 161 .SH ATTRIBUTES
 162 .LP
 163 See \fBattributes\fR(5) for descriptions of the following attributes:
 164 .sp
 165
 166 .sp
 167 .TS
 168 box;
 169 c | c
 170 l | l .
 171 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 172 _
 173 Interface Stability     See below.
 174 .TE
 175
 176 .sp
 177 .LP
 178 The invocation is Uncommitted. The options are Uncommitted. The output is
 179 Not-an-Interface.
 180 .SH SEE ALSO
 181 .LP
 182 \fBallocate\fR(1), \fBlist_devices\fR(1), \fBdminfo\fR(1M),
 183 \fBmkdevalloc\fR(1M), \fBmkdevmaps\fR(1M), \fBdevice_allocate\fR(4),
 184 \fBdevice_maps\fR(4), \fBattributes\fR(5)
 185 .SH NOTES
 186 .LP
 187 On systems configured with Trusted Extensions, the functionality is enabled by
 188 default.
 189 .sp
 190 .LP
 191 \fB/etc/security/dev\fR, \fBmkdevalloc\fR(1M), and \fBmkdevmaps\fR(1M) might
 192 not be supported in a future release of the Solaris Operating Environment.