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/man1/rmformat.1
+++ new/usr/src/man/man1/rmformat.1
1 1 '\" te
2 2 .\" Copyright (c) 2009, 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 RMFORMAT 1 "Feb 19, 2009"
7 +.TH RMFORMAT 1 "May 2, 2014"
7 8 .SH NAME
8 9 rmformat \- removable rewritable media format utility
9 10 .SH SYNOPSIS
10 11 .LP
11 12 .nf
12 13 \fBrmformat\fR [\fB-DeHUv\fR] [\fB-b\fR \fIlabel\fR] [\fB-c\fR \fIblockno\fR]
13 14 [\fB-F\fRquick | long | force ] [\fB-s\fR \fIfilename\fR] [\fIdevname\fR]
14 15 .fi
15 16
16 17 .LP
17 18 .nf
18 19 \fBrmformat\fR \fB-V\fR read | write \fIdevname\fR
19 20 .fi
20 21
21 22 .LP
22 23 .nf
23 24 \fBrmformat\fR \fB-l\fR [\fIdevname\fR]
24 25 .fi
25 26
26 27 .SH DESCRIPTION
27 28 .sp
28 29 .LP
29 30 The \fBrmformat\fR utility is used to format, label, partition, and perform
30 31 other miscellaneous functions on removable, rewritable media that include
31 32 floppy drives, and the \fBPCMCIA\fR memory and \fBata\fR cards. The
32 33 \fBrmformat\fR utility should also be used with all USB mass storage devices,
33 34 including USB hard drives. This utility can also be used for the verification
34 35 and surface analysis and for repair of the bad sectors found during
35 36 verification if the drive or the driver supports bad block management.
36 37 .sp
37 38 .LP
38 39 After formatting, \fBrmformat\fR writes the label, which covers the full
39 40 capacity of the media as one slice on floppy and \fBPCMCIA\fR memory cards to
40 41 maintain compatibility with the behavior of \fBfdformat\fR. The partition
41 42 information can be changed with the help of other options provided by
42 43 \fBrmformat\fR.
43 44 .SH OPTIONS
44 45 .sp
45 46 .LP
46 47 The following options are supported:
47 48 .sp
48 49 .ne 2
49 50 .na
50 51 \fB\fB-b\fR \fIlabel\fR\fR
51 52 .ad
52 53 .sp .6
53 54 .RS 4n
54 55 Labels the media with a SUNOS label. A SUNOS volume label name is restricted to
55 56 8 characters. For media size greater than 1 TB, an EFI label is created. For
56 57 writing a \fBDOS\fR Volume label, the user should use \fBmkfs_pcfs\fR(1M).
57 58 .RE
58 59
59 60 .sp
60 61 .ne 2
61 62 .na
62 63 \fB\fB-c\fR \fIblockno\fR\fR
63 64 .ad
64 65 .sp .6
65 66 .RS 4n
66 67 Corrects and repairs the given block. This correct and repair option may not be
67 68 applicable to all devices supported by \fBrmformat\fR, as some devices may have
68 69 a drive with bad block management capability and others may have this option
69 70 implemented in the driver. If the drive or driver supports bad block
70 71 management, a best effort is made to rectify the bad block. If the bad block
71 72 still cannot be rectified, a message is displayed to indicate the failure to
72 73 repair. The block number can be provided in decimal, octal, or hexadecimal
73 74 format.
74 75 .sp
75 76 The normal floppy and \fBPCMCIA\fR memory and ata cards do not support bad
76 77 block management.
77 78 .RE
78 79
79 80 .sp
80 81 .ne 2
81 82 .na
82 83 \fB\fB-D\fR\fR
83 84 .ad
84 85 .sp .6
85 86 .RS 4n
86 87 Formats a 720KB (3.5 inch) double density diskette. This is the default for
87 88 double density type drives. This option is needed if the drive is a high or
88 89 extended-density type.
89 90 .RE
90 91
91 92 .sp
92 93 .ne 2
93 94 .na
94 95 \fB\fB-e\fR\fR
95 96 .ad
96 97 .sp .6
97 98 .RS 4n
98 99 Ejects the media upon completion. This feature may not be available if the
99 100 drive does not support motorized eject.
100 101 .RE
101 102
102 103 .sp
103 104 .ne 2
104 105 .na
105 106 \fB\fB-F\fR quick | long | force\fR
106 107 .ad
107 108 .sp .6
108 109 .RS 4n
109 110 Formats the media.
110 111 .sp
111 112 The \fBquick\fR option starts a format without certification or format with
112 113 limited certification of certain tracks on the media.
113 114 .sp
114 115 The \fBlong\fR option starts a complete format. For some devices this might
115 116 include the certification of the whole media by the drive itself.
116 117 .sp
117 118 The \fBforce\fR option to format is provided to start a long format without
118 119 user confirmation before the format is started.
119 120 .sp
120 121 In legacy media such as floppy drives, all options start a long format
121 122 depending on the mode (Extended Density mode, High Density mode, or Double
122 123 Density mode) with which the floppy drive operates by default. On \fBPCMCIA\fR
123 124 memory cards, all options start a long format.
124 125 .RE
125 126
126 127 .sp
127 128 .ne 2
128 129 .na
129 130 \fB\fB-H\fR\fR
130 131 .ad
131 132 .sp .6
132 133 .RS 4n
133 134 Formats a 1.44 MB (3.5 inch) high density diskette. This is the default for
134 135 high density type drives. It is needed if the drive is the Extended Density
135 136 type.
136 137 .RE
137 138
138 139 .sp
139 140 .ne 2
140 141 .na
141 142 \fB\fB-l\fR\fR
142 143 .ad
143 144 .sp .6
144 145 .RS 4n
145 146 Lists all removable devices. By default, without any options, \fBrmformat\fR
146 147 also lists all removable devices. If the \fBdev_name\fR is given,
147 148 \fBrmformat\fR lists the device associated with the \fBdev_name\fR. The output
148 149 shows the device pathname, vendor information, and the device type.
149 150 .RE
150 151
151 152 .sp
152 153 .ne 2
153 154 .na
154 155 \fB\fB-s\fR \fIfilename\fR\fR
155 156 .ad
156 157 .sp .6
157 158 .RS 4n
158 159 Enables the user to lay out the partition information in the SUNOS label.
159 160 .sp
160 161 The user should provide a file as input with information about each slice in a
161 162 format providing byte offset, size required, tags, and flags, as follows:
162 163 .sp
163 164 .in +2
164 165 .nf
165 166 slices: \fIn\fR = \fIoffset\fR, \fIsize\fR [, \fIflags\fR, \fItags\fR]
166 167 .fi
167 168 .in -2
168 169 .sp
169 170
170 171 where \fIn\fR is the slice number, \fIoffset\fR is the byte offset at which the
171 172 slice \fIn\fR starts, and \fIsize\fR is the required size for slice \fIn\fR.
172 173 Both \fIoffset\fR and \fIsize\fR must be a multiple of 512 bytes. These numbers
173 174 can be represented as decimal, hexadecimal, or octal numbers. No floating point
174 175 numbers are accepted. Details about maximum number of slices can be obtained
175 176 from the \fISystem Administration Guide: Basic Administration\fR.
176 177 .sp
177 178 To specify the \fIsize\fR or \fIoffset\fR in kilobytes, megabytes, or
178 179 gigabytes, add \fBKB\fR, \fBMB\fR, \fBGB\fR, respectively. A number without a
179 180 suffix is assumed to be a byte offset. The flags are represented as follows:
180 181 .sp
181 182 .in +2
182 183 .nf
183 184 \fBwm\fR = read-write, mountable
184 185 \fBwu\fR = read-write, unmountable
185 186 \fBru\fR = read-only, unmountable
186 187 .fi
187 188 .in -2
188 189 .sp
189 190
190 191 The tags are represented as follows: \fBunassigned\fR, \fBboot\fR, \fBroot\fR,
191 192 \fBswap\fR, \fBusr\fR, \fBbackup\fR, \fBstand\fR, \fBvar\fR, \fBhome\fR,
192 193 \fBalternates\fR.
193 194 .sp
194 195 The tags and flags can be omitted from the four tuple when finer control on
195 196 those values is not required. It is required to omit both or include both. If
196 197 the tags and flags are omitted from the four tuple for a particular slice, a
197 198 default value for each is assumed. The default value for flags is \fBwm\fR and
198 199 for tags is \fBunassigned\fR.
199 200 .sp
200 201 Either full tag names can be provided or an abbreviation for the tags can be
201 202 used. The abbreviations can be the first two or more letters from the standard
202 203 tag names. \fBrmformat\fR is case insensitive in handling the defined tags &
203 204 flags.
204 205 .sp
205 206 Slice specifications are separated by :
206 207 .sp
207 208 For example:
208 209 .sp
209 210 .in +2
210 211 .nf
211 212 slices: 0 = 0, 30MB, "wm", "home" :
212 213 1 = 30MB, 51MB :
213 214 2 = 0, 100MB, "wm", "backup" :
214 215 6 = 81MB, 19MB
215 216 .fi
216 217 .in -2
217 218 .sp
218 219
219 220 \fBrmformat\fR does the necessary checking to detect any overlapping partitions
220 221 or illegal requests to addresses beyond the capacity of the media under
221 222 consideration. There can be only one slice information entry for each slice
222 223 \fIn\fR. If multiple slice information entries for the same slice \fIn\fR are
223 224 provided, an appropriate error message is displayed. The slice \fB2\fR is the
224 225 backup slice covering the whole disk capacity. The pound sign character,
225 226 \fB#\fR, can be used to describe a line of comments in the input file. If the
226 227 line starts with \fB#\fR, then \fBrmformat\fR ignores all the characters
227 228 following \fB#\fR until the end of the line.
228 229 .sp
229 230 Partitioning some of the media with very small capacity is permitted, but be
230 231 cautious in using this option on such devices.
231 232 .RE
232 233
233 234 .sp
234 235 .ne 2
235 236 .na
236 237 \fB\fB-U\fR\fR
237 238 .ad
238 239 .sp .6
239 240 .RS 4n
240 241 Performs \fBumount\fR on any file systems and then formats. See
241 242 \fBmount\fR(1M). This option unmounts all the mounted slices and issues a long
242 243 format on the device requested.
243 244 .RE
244 245
245 246 .sp
246 247 .ne 2
247 248 .na
248 249 \fB\fB-V\fR read | write\fR
249 250 .ad
250 251 .sp .6
251 252 .RS 4n
252 253 Verifies each block of media after format. The write verification is a
253 254 destructive mechanism. The user is queried for confirmation before the
254 255 verification is started. The output of this option is a list of block numbers,
255 256 which are identified as bad.
256 257 .sp
257 258 The read verification only verifies the blocks and report the blocks which are
258 259 prone to errors.
259 260 .sp
260 261 The list of block numbers displayed can be used with the \fB-c\fR option for
261 262 repairing.
262 263 .RE
263 264
264 265 .SH OPERANDS
265 266 .sp
266 267 .LP
267 268 The following operand is supported:
268 269 .sp
269 270 .ne 2
270 271 .na
271 272 \fB\fIdevname\fR\fR
272 273 .ad
273 274 .sp .6
274 275 .RS 4n
275 276 \fIdevname\fR can be provided as absolute device pathname or relative pathname
276 277 for the device from the current working directory or the nickname, such as
277 278 \fBcdrom\fR or \fBrmdisk\fR.
278 279 .sp
279 280 For floppy devices, to access the first drive use \fB/dev/rdiskette0\fR (for
280 281 systems without volume management) or \fBfloppy0\fR (for systems with volume
281 282 management). Specify \fB/dev/rdiskette1\fR (for systems without volume
282 283 management) or \fBfloppy1\fR (for systems with volume management) to use the
283 284 second drive.
284 285 .sp
285 286 For systems without volume management running, the user can also provide the
286 287 absolute device pathname as \fB/dev/rdsk/c\fI?\fRt\fI?\fRd\fI?\fRs\fI?\fR\fR or
287 288 the appropriate relative device pathname from the current working directory.
288 289 .RE
289 290
290 291 .SH EXAMPLES
291 292 .LP
292 293 \fBExample 1 \fRFormatting a Diskette
293 294 .sp
294 295 .in +2
295 296 .nf
296 297 example$ \fBrmformat -F quick /dev/rdiskette\fR
297 298 Formatting will erase all the data on disk.
298 299 Do you want to continue? (y/n)\fBy\fR
299 300 .fi
300 301 .in -2
301 302 .sp
302 303
303 304 .LP
304 305 \fBExample 2 \fRFormatting a Diskette for a UFS File System
305 306 .sp
306 307 .LP
307 308 The following example formats a diskette and creates a UFS file system:
308 309
309 310 .sp
310 311 .in +2
311 312 .nf
312 313 example$ \fBrmformat -F quick /dev/aliases/floppy0\fR
313 314 Formatting will erase all the data on disk.
314 315 Do you want to continue? (y/n)\fBy\fR
315 316 example$ \fBsu\fR
316 317 # \fB/usr/sbin/newfs /dev/aliases/floppy0\fR
317 318 newfs: construct a new file system /dev/rdiskette: (y/n)? \fBy\fR
318 319 /dev/rdiskette: 2880 sectors in 80 cylinders of 2 tracks, 18 sectors
319 320 1.4MB in 5 cyl groups (16 c/g, 0.28MB/g, 128 i/g)
320 321 super-block backups (for fsck -F ufs -o b=#) at:
321 322 32, 640, 1184, 1792, 2336,
322 323 #
323 324 .fi
324 325 .in -2
325 326 .sp
326 327
327 328 .LP
328 329 \fBExample 3 \fRFormatting Removable Media for a PCFS File System
329 330 .sp
330 331 .LP
331 332 The following example shows how to create an alternate \fBfdisk\fR partition:
332 333
333 334 .sp
334 335 .in +2
335 336 .nf
336 337 example$ \fBrmformat -F quick /dev/rdsk/c0t4d0s2:c\fR
337 338 Formatting will erase all the data on disk.
338 339 Do you want to continue? (y/n)\fBy\fR
339 340 example$ \fBsu\fR
340 341 # \fBfdisk /dev/rdsk/c0t4d0s2:c\fR
341 342 # \fBmkfs -F pcfs /dev/rdsk/c0t4d0s2:c\fR
342 343 Construct a new FAT file system on /dev/rdsk/c0t4d0s2:c: (y/n)? \fBy\fR
343 344 #
344 345 .fi
345 346 .in -2
346 347 .sp
347 348
348 349 .sp
349 350 .LP
350 351 The following example describes how to create a \fBPCFS\fR file system
351 352 \fBwithout\fR an \fBfdisk\fR partition:
352 353
353 354 .sp
354 355 .in +2
355 356 .nf
356 357 example$ \fBrmformat -F quick /dev/rdiskette\fR
357 358 Formatting will erase all the data on disk.
358 359 Do you want to continue? (y/n)\fBy\fR
359 360 example$ \fBsu\fR
360 361 # \fBmkfs -F pcfs -o nofdisk,size=2 /dev/rdiskette\fR
361 362 Construct a new FAT file system on /dev/rdiskette: (y/n)? \fBy\fR
362 363 #
363 364 .fi
364 365 .in -2
365 366 .sp
366 367
367 368 .LP
368 369 \fBExample 4 \fRListing All Removable Devices
369 370 .sp
370 371 .LP
371 372 The following example shows how to list removable devices. This output shows a
372 373 long listing of such devices.
373 374
374 375 .sp
375 376 .in +2
376 377 .nf
377 378 example$ rmformat -l
378 379 Looking for devices...
379 380 Logical Node: /dev/rdsk/c5t0d0s2
380 381 Physical Node: /pci@1e,600000/usb@b/hub@2/storage@4/disk@0,0
381 382 Connected Device: TEAC FD-05PUB 1026
382 383 Device Type: Floppy drive
383 384 Bus: USB
384 385 Size: 1.4 MB
385 386 Label: floppy
386 387 Access permissions: Medium is not write protected.
387 388 .fi
388 389 .in -2
389 390 .sp
390 391
391 392 .SH FILES
392 393 .sp
393 394 .ne 2
394 395 .na
395 396 \fB\fB/dev/diskette0\fR\fR
396 397 .ad
397 398 .sp .6
398 399 .RS 4n
399 400 Directory providing block device access for the media in floppy drive 0.
400 401 .RE
401 402
402 403 .sp
403 404 .ne 2
404 405 .na
405 406 \fB\fB/dev/rdiskette0\fR\fR
406 407 .ad
407 408 .sp .6
408 409 .RS 4n
409 410 Directory providing character device access for the media in floppy drive 0.
410 411 .RE
411 412
412 413 .sp
413 414 .ne 2
414 415 .na
415 416 \fB\fB/dev/aliases\fR\fR
416 417 .ad
417 418 .sp .6
418 419 .RS 4n
419 420 Directory providing symbolic links to the character devices for the different
420 421 media under the control of volume management using appropriate alias.
421 422 .RE
422 423
423 424 .sp
424 425 .ne 2
425 426 .na
426 427 \fB\fB/dev/aliases/floppy0\fR\fR
427 428 .ad
428 429 .sp .6
429 430 .RS 4n
430 431 Symbolic link to the character device for the media in floppy drive 0.
431 432 .RE
432 433
433 434 .sp
434 435 .ne 2
435 436 .na
436 437 \fB\fB/dev/rdiskette\fR\fR
437 438 .ad
438 439 .sp .6
439 440 .RS 4n
440 441 Symbolic link providing character device access for the media in the primary
441 442 floppy drive, usually drive 0.
442 443 .RE
443 444
444 445 .sp
445 446 .ne 2
446 447 .na
447 448 \fB\fB/dev/dsk\fR\fR
448 449 .ad
449 450 .sp .6
450 451 .RS 4n
451 452 Directory providing block device access for the \fBPCMCIA\fR memory and ata
452 453 cards and removable media devices.
453 454 .RE
454 455
455 456 .sp
456 457 .ne 2
457 458 .na
458 459 \fB\fB/dev/rdsk\fR\fR
459 460 .ad
460 461 .sp .6
461 462 .RS 4n
462 463 Directory providing character device access for the \fBPCMCIA\fR memory and ata
463 464 cards and removable media devices.
464 465 .RE
465 466
466 467 .sp
467 468 .ne 2
468 469 .na
469 470 \fB\fB/dev/aliases/pcmemS\fR\fR
470 471 .ad
471 472 .sp .6
472 473 .RS 4n
473 474 Symbolic link to the character device for the \fBPCMCIA\fR memory card in
474 475 socket S, where S represents a \fBPCMCIA\fR socket number.
475 476 .RE
476 477
477 478 .sp
478 479 .ne 2
479 480 .na
480 481 \fB\fB/dev/aliases/rmdisk0\fR\fR
481 482 .ad
482 483 .sp .6
483 484 .RS 4n
484 485 Symbolic link to the generic removable media device that is not a \fBCD-ROM\fR,
485 486 floppy, \fBDVD-ROM\fR, \fBPCMCIA\fR memory card, and so forth.
486 487 .RE
487 488
488 489 .sp
489 490 .ne 2
490 491 .na
491 492 \fB\fB/dev/rdsk\fR\fR
492 493 .ad
493 494 .sp .6
494 495 .RS 4n
495 496 Directory providing character device access for the \fBPCMCIA\fR memory and ata
496 497 cards and other removable devices.
497 498 .RE
498 499
499 500 .sp
500 501 .ne 2
501 502 .na
502 503 \fB\fB/dev/dsk\fR\fR
503 504 .ad
|
↓ open down ↓ |
487 lines elided |
↑ open up ↑ |
504 505 .sp .6
505 506 .RS 4n
506 507 Directory providing block device access for the \fBPCMCIA\fR memory and ata
507 508 cards and other removable media devices.
508 509 .RE
509 510
510 511 .SH SEE ALSO
511 512 .sp
512 513 .LP
513 514 \fBcpio\fR(1), \fBeject\fR(1), \fBfdformat\fR(1), \fBtar\fR(1),
514 -\fBvolcheck\fR(1), \fBvolrmmount\fR(1), \fBformat\fR(1M), \fBmkfs_pcfs\fR(1M),
515 -\fBmount\fR(1M), \fBnewfs\fR(1M), \fBprtvtoc\fR(1M), \fBrmmount\fR(1M),
516 -\fBrpc.smserverd\fR(1M), \fBattributes\fR(5), \fBscsa2usb\fR(7D), \fBsd\fR(7D),
517 -\fBpcfs\fR(7FS), \fBudfs\fR(7FS)
515 +\fBvolcheck\fR(1), \fBformat\fR(1M), \fBmkfs_pcfs\fR(1M), \fBmount\fR(1M),
516 +\fBnewfs\fR(1M), \fBprtvtoc\fR(1M), \fBrmmount\fR(1M), \fBrpc.smserverd\fR(1M),
517 +\fBattributes\fR(5), \fBscsa2usb\fR(7D), \fBsd\fR(7D), \fBpcfs\fR(7FS),
518 +\fBudfs\fR(7FS)
518 519 .sp
519 520 .LP
520 521 \fISystem Administration Guide: Basic Administration\fR
521 522 .SH NOTES
522 523 .sp
523 524 .LP
524 525 A rewritable media or \fBPCMCIA\fR memory card or \fBPCMCIA\fR ata card
525 526 containing a \fBufs\fR file system created on a SPARC-based system (using
526 527 \fBnewfs\fR(1M)) is not identical to a rewritable media or \fBPCMCIA\fR memory
527 528 card containing a \fBufs\fR file system created on an x86 based system. Do not
528 529 interchange any removable media containing \fBufs\fR between these platforms;
529 530 use \fBcpio\fR(1) or \fBtar\fR(1) to transfer files on diskettes or memory
530 531 cards between them. For interchangeable filesystems refer to \fBpcfs\fR(7FS)
531 532 and \fBudfs\fR(7FS).
532 533 .sp
533 534 .LP
534 535 \fBrmformat\fR might not list all removable devices in virtualization
535 536 environments.
536 537 .SH BUGS
537 538 .sp
538 539 .LP
539 540 Currently, bad sector mapping is not supported on floppy diskettes or
540 541 \fBPCMCIA\fR memory cards. Therefore, a diskette or memory card is unusable if
541 542 \fBrmformat\fR finds an error (\fBbad sector\fR).
|
↓ open down ↓ |
14 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX