Print this page
4833 Remove volrmmount
4845 rm(u)mount don't always print mount/unmount errors
4846 HAL partition names don't match real parition names
Reviewed by: Dan McDonald <danmcd@omniti.com>
Reviewed by: Josef 'Jeff' Sipek <jeffpc@josefsipek.net>
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/rmmount.1m
+++ new/usr/src/man/man1m/rmmount.1m
1 1 '\" te
2 2 .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved
3 +.\" Copyright 2014 Andrew Stormont.
3 4 .\" 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 5 .\" 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 6 .\" 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 RMMOUNT 1M "Mar 1, 2007"
7 +.TH RMMOUNT 1M "May 2, 2014"
7 8 .SH NAME
8 9 rmmount \- removable media mounter for CD-ROM, floppy, Jaz drive, and others
9 10 .SH SYNOPSIS
10 11 .LP
11 12 .nf
12 13 \fB/usr/sbin/rmmount\fR [\fB-D\fR]
13 14 .fi
14 15
15 16 .SH DESCRIPTION
16 17 .sp
17 18 .LP
18 19 The \fBrmmount\fR utility is a removable media mounter that is executed by
19 20 volume management whenever a removable medium, such as a \fBCD-ROM\fR or a
20 21 floppy, is inserted. Removable media is managed by an application or a volume
21 -manager. \fBrmmount\fR can also be called by using \fBvolrmmount\fR(1).
22 +manager.
22 23 .sp
23 24 .LP
24 25 Upon insertion of a medium and following invocation of the \fBvolcheck\fR(1)
25 26 command, \fBrmmount\fR determines what type of file system (if any) is on that
26 27 medium. If a file system is present, \fBrmmount\fR mounts the file system in
27 28 one of the locations listed below.
28 29 .sp
29 30 .LP
30 31 For a diskette (floppy):
31 32 .sp
32 33 .ne 2
33 34 .na
34 35 \fB\fB/floppy/floppy0\fR\fR
35 36 .ad
36 37 .RS 26n
37 38 symbolic link to mounted floppy in local floppy drive
38 39 .RE
39 40
40 41 .sp
41 42 .ne 2
42 43 .na
43 44 \fB\fB/floppy/floppy_name\fR\fR
44 45 .ad
45 46 .RS 26n
46 47 mounted named floppy
47 48 .RE
48 49
49 50 .sp
50 51 .ne 2
51 52 .na
52 53 \fB\fB/floppy/unnamed_floppy\fR\fR
53 54 .ad
54 55 .RS 26n
55 56 mounted unnamed floppy
56 57 .RE
57 58
58 59 .sp
59 60 .LP
60 61 For a CD-ROM or a DVD-ROM:
61 62 .sp
62 63 .ne 2
63 64 .na
64 65 \fB\fB/cdrom/cdrom0\fR\fR
65 66 .ad
66 67 .sp .6
67 68 .RS 4n
68 69 symbolic link to mounted \fBCD-ROM\fR in local \fBCD-ROM\fR drive
69 70 .RE
70 71
71 72 .sp
72 73 .ne 2
73 74 .na
74 75 \fB\fB/cdrom/CD-ROM_name\fR\fR
75 76 .ad
76 77 .sp .6
77 78 .RS 4n
78 79 mounted named \fBCD-ROM\fR
79 80 .RE
80 81
81 82 .sp
82 83 .ne 2
83 84 .na
84 85 \fB\fB/cdrom/CD-ROM_name/partition\fR\fR
85 86 .ad
86 87 .sp .6
87 88 .RS 4n
88 89 mounted named \fBCD-ROM\fR with partitioned file system
89 90 .RE
90 91
91 92 .sp
92 93 .ne 2
93 94 .na
94 95 \fB\fB/cdrom/unnamed_cdrom\fR\fR
95 96 .ad
96 97 .sp .6
97 98 .RS 4n
98 99 mounted unnamed \fBCD-ROM\fR
99 100 .RE
100 101
101 102 .sp
102 103 .LP
103 104 For a Zip drive:
104 105 .sp
105 106 .ne 2
106 107 .na
107 108 \fB\fB/rmdisk/zip0\fR\fR
108 109 .ad
109 110 .RS 30n
110 111 symbolic link to mounted Zip medium in local Zip drive
111 112 .RE
112 113
113 114 .sp
114 115 .ne 2
115 116 .na
116 117 \fB\fB/rmdisk/\fIZip_name\fR\fR\fR
117 118 .ad
118 119 .RS 30n
119 120 mounted named Zip medium
120 121 .RE
121 122
122 123 .sp
123 124 .ne 2
124 125 .na
125 126 \fB\fB/rmdisk/\fIZip_name\fR/partition\fR\fR
126 127 .ad
127 128 .RS 30n
128 129 mounted named Zip medium with partitioned file system
129 130 .RE
130 131
131 132 .sp
132 133 .ne 2
133 134 .na
134 135 \fB\fB/rmdisk/unnamed_zip\fR\fR
135 136 .ad
136 137 .RS 30n
137 138 mounted unnamed Zip medium
138 139 .RE
139 140
140 141 .sp
141 142 .LP
142 143 For a Jaz drive:
143 144 .sp
144 145 .ne 2
145 146 .na
146 147 \fB\fB/rmdisk/jaz0\fR\fR
147 148 .ad
148 149 .RS 30n
149 150 symbolic link to mounted Jaz medium in local Jaz drive
150 151 .RE
151 152
152 153 .sp
153 154 .ne 2
154 155 .na
155 156 \fB\fB/rmdisk/\fIJaz_name\fR\fR\fR
156 157 .ad
157 158 .RS 30n
158 159 mounted named Jaz medium
159 160 .RE
160 161
161 162 .sp
162 163 .ne 2
163 164 .na
164 165 \fB\fB/rmdisk/\fIJaz_name\fR/partition\fR\fR
165 166 .ad
166 167 .RS 30n
167 168 mounted named Jaz medium with partitioned file system
168 169 .RE
169 170
170 171 .sp
171 172 .ne 2
172 173 .na
173 174 \fB\fB/rmdisk/unnamed_Jaz\fR\fR
174 175 .ad
175 176 .RS 30n
176 177 mounted unnamed Jaz medium
177 178 .RE
178 179
179 180 .sp
180 181 .LP
181 182 For a generic "rmdisk" drive:
182 183 .sp
183 184 .ne 2
184 185 .na
185 186 \fB\fB/rmdisk/rmdisk0\fR\fR
186 187 .ad
187 188 .sp .6
188 189 .RS 4n
189 190 symbolic link to mounted removable medium in local removable medium drive
190 191 .RE
191 192
192 193 .sp
193 194 .ne 2
194 195 .na
195 196 \fB\fB/rmdisk/\fIrmdisk_name\fR\fR\fR
196 197 .ad
197 198 .sp .6
198 199 .RS 4n
199 200 mounted named removable medium
200 201 .RE
201 202
202 203 .sp
203 204 .ne 2
204 205 .na
205 206 \fB\fB/rmdisk/\fIrmdisk_name\fR/partition\fR\fR
206 207 .ad
207 208 .sp .6
208 209 .RS 4n
209 210 mounted named removable medium with partitioned file system
210 211 .RE
211 212
212 213 .sp
213 214 .ne 2
214 215 .na
215 216 \fB\fB/rmdisk/unnamed_rmdisk\fR\fR
216 217 .ad
217 218 .sp .6
218 219 .RS 4n
219 220 mounted unnamed removable medium
220 221 .RE
221 222
222 223 .sp
223 224 .LP
224 225 If the media is read-only (for example, a \fBCD-ROM\fR or a floppy with
225 226 write-protect tab set), the file system is mounted read-only.
226 227 .sp
227 228 .LP
228 229 If a file system is not identified, \fBrmmount\fR does not mount a file system.
229 230 See the \fI\fR for more information on the location of \fBCD-ROM\fR, floppy,
230 231 and other media without file systems.
231 232 .sp
232 233 .LP
233 234 If a file system type has been determined, it is then checked to see that it is
234 235 "clean." If the file system is "dirty," \fBfsck\fR \fB-p\fR (see
235 236 \fBfsck\fR(1M)) is run in an attempt to clean it. If \fBfsck\fR fails, the file
236 237 system is mounted read-only.
237 238 .sp
238 239 .LP
239 240 After the mount is complete, "actions" associated with the media type are
240 241 executed. These actions allow for the notification to other programs that new
241 242 media are available.
242 243 .sp
243 244 .LP
244 245 Actions are executed in the order in which they appear in the configuration
245 246 file. The action function can return either \fB1\fR or \fB0\fR. If it returns
246 247 \fB0\fR, no further actions will be executed. This allows the function to
247 248 control which applications are executed.
248 249 .sp
249 250 .LP
250 251 In order to execute an action, \fBrmmount\fR performs a \fBdlopen\fR(3C) on the
251 252 shared object and calls the action function defined within it. The definition
252 253 of the interface to actions can be found in \fB/usr/include/rmmount.h\fR.
253 254 .sp
254 255 .LP
255 256 File systems mounted by \fBrmmount\fR are always mounted with the \fBnosuid\fR
256 257 flag set, thereby disabling setuid programs and access to block or character
257 258 devices in that file system. Upon ejection, \fBrmmount\fR unmounts mounted file
258 259 systems and executes actions associated with the media type. If a file system
259 260 is "busy" (that is, it contains the current working directory of a live
260 261 process), the ejection will fail.
261 262 .SH OPTIONS
262 263 .sp
263 264 .ne 2
264 265 .na
265 266 \fB\fB-D\fR\fR
266 267 .ad
267 268 .RS 6n
268 269 Turn on the debugging output from the \fBrmmount\fR \fBdprintf\fR calls.
269 270 .RE
270 271
271 272 .SH FILES
272 273 .sp
273 274 .ne 2
|
↓ open down ↓ |
242 lines elided |
↑ open up ↑ |
274 275 .na
275 276 \fB\fB/usr/lib/rmmount/*.so.1\fR\fR
276 277 .ad
277 278 .RS 27n
278 279 shared objects used by \fBrmmount\fR.
279 280 .RE
280 281
281 282 .SH SEE ALSO
282 283 .sp
283 284 .LP
284 -\fBvolcheck\fR(1), \fBvolrmmount\fR(1), \fBfsck\fR(1M), \fBdlopen\fR(3C),
285 +\fBvolcheck\fR(1), \fBfsck\fR(1M), \fBdlopen\fR(3C),
285 286 \fBattributes\fR(5)
286 287 .sp
287 288 .LP
288 289 \fI\fR
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX