xref: /original-bsd/old/rxformat/rxformat.8 (revision 6f815012)
1.\" Copyright (c) 1983, 1991 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)rxformat.8	6.6 (Berkeley) 03/16/91
7.\"
8.Dd
9.Dt RXFORMAT 8
10.Os BSD 4.2
11.Sh NAME
12.Nm rxformat
13.Nd format floppy disks
14.Sh SYNOPSIS
15.Nm rxformat
16.Op Fl d
17.Ar special
18.Sh DESCRIPTION
19The
20.Nm rxformat
21program formats a diskette in the specified drive
22associated with the special device
23.Ar special .
24.Pf ( Ar Special
25is normally
26.Pa /dev/rx0 ,
27for drive 0, or
28.Pa /dev/rx1 ,
29for drive 1.)
30.Pp
31Available option:
32.Bl -tag -width Ds
33.It Fl d
34Force double density formatting.
35By default, the diskette is formatted single density;
36Single density is compatible
37with the
38.Tn IBM
393740 standard (128 bytes/sector).
40In double density, each sector
41contains 256 bytes of data.
42.El
43.Pp
44Before formatting a diskette
45.Nm rxformat
46prompts for verification if standard input is a tty
47(this allows a user to cleanly
48abort the operation; note that
49formatting a diskette will destroy any existing data).
50Formatting is done by the hardware.
51All sectors are zero-filled.
52.Sh DIAGNOSTICS
53.Bl -tag -width Ds
54.It Sy \&No such device
55means that the drive is not ready,
56usually because no disk is in the drive or the drive door is open.
57Other error messages are selfexplanatory.
58.El
59.Sh FILES
60.Bl -tag -width /dev/rx? -compact
61.It Pa /dev/rx?
62.El
63.Sh SEE ALSO
64.Xr rx 4
65.Sh AUTHOR
66Helge Skrivervik
67.Sh BUGS
68A floppy may not be formatted if the
69header info on sector 1, track 0 has been damaged.  Hence, it is not
70possible to format a completely degaussed disk.
71(This is actually a problem in the DEC hardware.)
72.Sh HISTORY
73The
74.Nm
75command appeared in
76.Bx 4.2 .
77