1.\" $NetBSD: fdformat.1,v 1.5 1997/06/16 02:13:46 jtk Exp $ 2.\" 3.\" Copyright (c) 1996 John T. Kohl 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. The name of the author may not be used to endorse or promote products 15.\" derived from this software without specific prior written permission. 16.\" 17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR `AS IS'' AND ANY EXPRESS OR 18.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 19.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 20.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, 21.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 22.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 23.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 25.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 26.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" POSSIBILITY OF SUCH DAMAGE. 28.\" 29.\" 30.Dd November 28, 1996 31.Dt fdformat 1 32.Os NetBSD 33.Sh NAME 34.Nm fdformat 35.Nd format a floppy diskette 36.Sh SYNOPSIS 37.Nm 38.Op Fl f Ar device 39.Op Fl t Ar type 40.Op Fl n 41.Op Fl B Ar nbps 42.Op Fl S Ar nspt 43.Op Fl T Ar ntrk 44.Op Fl C Ar ncyl 45.Op Fl P Ar stepspercyl 46.Op Fl G Ar gaplen 47.Op Fl F Ar fillbyte 48.Op Fl X Ar xfer_rate 49.Op Fl I Ar interleave 50.Sh DESCRIPTION 51The 52.Nm 53utility formats a floppy diskette. 54With no arguments, it formats the default floppy device with the default 55density parameters (as provided by the floppy diskette device driver). 56.Pp 57As the each track of the floppy diskette is formatted, it is read to 58verify the format was successful. A status is printed for each track. 59.Em F 60indicates a track was formatted. 61.Em V 62indicates the track was successfully verified. 63.Em E 64indicates an error in formatting or verifying a track. 65.Pp 66Available command-line flags are: 67.Bl -tag -width indent -compact 68.It Fl f Ar device 69Format the floppy using 70.Ar device 71instead of the default 72.Pa /dev/rfd0a . 73.It Fl t Ar type 74Format the floppy using parameters for the diskette named 75.Ar type 76in 77.Pa /etc/floppytab 78instead of the device default parameters. 79.It Fl n 80Do not verify each track as it is read. 81.It Fl B Ar nbps 82Set the number of bytes per sector for the formatted diskette. 83.It Fl S Ar nspt 84Set the number of sectors per track for the formatted diskette. 85.It Fl T Ar ntrk 86Set the number of tracks (heads) per cylinder for the formatted diskette. 87.It Fl C Ar ncyl 88Set the number of cylinders for the formatted diskette. 89.It Fl P Ar stepspercyl 90Set the number of motor steps per cylinder for the formatted diskette. 91.It Fl G Ar gaplen 92Set the sector gap length for the formatted diskette. 93.It Fl F Ar fillbyte 94Set the fill byte for the formatted diskette. 95.It Fl X Ar xfer_rate 96Set the bit transfer rate for the formatted diskette. 97.It Fl I Ar interleave 98Set the interleave factor for the formatted diskette. 99.El 100.Sh BUGS 101Some floppy drive units have physical 102diskette format sensors which automatically select a diskette 103density for reading. Such drives can format at alternate densities, but 104they cannot successfully verify the formatted diskette except at the 105diskette's normal density. 106.Sh SEE ALSO 107.Xr fdc 4 108(i386 port). 109.Sh HISTORY 110The 111.Nm 112utility appeared in NetBSD-1.3. 113