Reported by Erik van der Kouwe <vdkouwe at cs.vu.nl>:
[minix.git] / man / man1 / format.1
blob7cfbd91e26d09b894c88873cdcc3241107b2a84f
1 .TH FORMAT 1
2 .SH NAME
3 format \- format a PC floppy diskette
4 .SH SYNOPSIS
5 .B format
6 .RB [ \-v ]
7 .I device
8 .RI [ media-size
9 .RI [ drive-size ]]
10 .SH DESCRIPTION
11 .de SP
12 .if t .sp 0.4
13 .if n .sp
15 .B Format
16 allows a user with read-write permission to
17 .I device
18 to format a floppy.  Either one of the special floppy devices must be used,
19 see
20 .BR fd (4),
21 or an automatic device may be used with the size of the floppy specified on
22 the command line.  Two sizes must be given when formatting a low density
23 diskette in a high density drive.  For example:
24 .PP
25 .RS
26 .ft B
27 .nf
28 format /dev/at1
29 format /dev/fd1 1200
30 format /dev/fd1 360 1200
31 .fi
32 .ft P
33 .RE
34 .PP
35 The first two commands format a 1.2M diskette, the last formats a 360k
36 diskette in a 1.2M drive.  A 1.44M drive knows when it's dealing with a low
37 density floppy, so all these commands format a 720k diskette:
38 .PP
39 .RS
40 .ft B
41 .nf
42 format /dev/fd0 720
43 format /dev/fd0 720 1440
44 format /dev/ps0
45 .fi
46 .ft P
47 .RE
48 .PP
49 No sizes may be specified when using a special floppy device, a size must be
50 specified when using an automatic device.
51 .SH OPTIONS
52 .TP
53 .B \-v
54 Verify the process by reading each track after formatting it.  Formatting is
55 normally blind, the controller has no idea whether it succeeds or not.  Use
56 .B \-v
57 on a new box of cheap diskettes, or on a diskette that may have gone bad.
58 Verifying will increase formatting time by 50%.
59 .SH "SEE ALSO"
60 .BR mkfs (1),
61 .BR fd (4).
62 .SH DIAGNOSTICS
63 Numbers will be printed on standard output to show that it is busy.  The
64 locations of bad sectors are printed on standard error when verifying.  The
65 exit code is zero unless there are too many bad spots.
66 .SH AUTHOR
67 Kees J. Bot (kjb@cs.vu.nl)