1.\" $NetBSD: fdformat.1,v 1.14 2002/09/30 11:08:59 grant Exp $ 2.\" 3.\" Copyright (c) 1996, 1997 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by John Kohl. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 3. All advertising materials mentioning features or use of this software 18.\" must display the following acknowledgement: 19.\" This product includes software developed by the NetBSD 20.\" Foundation, Inc. and its contributors. 21.\" 4. Neither the name of The NetBSD Foundation nor the names of its 22.\" contributors may be used to endorse or promote products derived 23.\" from this software without specific prior written permission. 24.\" 25.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 26.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 27.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 28.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 35.\" POSSIBILITY OF SUCH DAMAGE. 36.\" 37.Dd November 28, 1996 38.Dt FDFORMAT 1 39.Os 40.Sh NAME 41.Nm fdformat 42.Nd format a floppy diskette 43.Sh SYNOPSIS 44.Nm 45.Bk -words 46.Op Fl f Ar device 47.Ek 48.Bk -words 49.Op Fl t Ar type 50.Ek 51.Op Fl n 52.Bk -words 53.Op Fl B Ar nbps 54.Ek 55.Bk -words 56.Op Fl S Ar nspt 57.Ek 58.Bk -words 59.Op Fl T Ar ntrk 60.Ek 61.Bk -words 62.Op Fl C Ar ncyl 63.Ek 64.Bk -words 65.Op Fl P Ar stepspercyl 66.Ek 67.Bk -words 68.Op Fl G Ar gaplen 69.Ek 70.Bk -words 71.Op Fl F Ar fillbyte 72.Ek 73.Bk -words 74.Op Fl X Ar xfer_rate 75.Ek 76.Bk -words 77.Op Fl I Ar interleave 78.Ek 79.Sh DESCRIPTION 80The 81.Nm 82utility formats a floppy diskette. 83With no arguments, it formats the default floppy device with the default 84density parameters (as provided by the floppy diskette device driver). 85.Pp 86As the each track of the floppy diskette is formatted, it is read to 87verify the format was successful. 88A status is printed for each track. 89.Em F 90indicates a track was formatted. 91.Em V 92indicates the track was successfully verified. 93.Em E 94indicates an error in formatting or verifying a track. 95.Pp 96The 97.Nm 98utility does not create a filesystem of any kind. 99Use tools like 100.Xr newfs 8 , 101.Xr newfs_msdos 8 , 102or 103.Xr mformat 1 104(part of the pkgsrc/sysutils/mtools package) depending on what filesystem 105type you want to use on the floppy disk to do so. 106.Pp 107Available command-line flags are: 108.Bl -tag -width indent -compact 109.It Fl f Ar device 110Format the floppy using 111.Ar device 112instead of the default 113.Pa /dev/rfd0a . 114.It Fl t Ar type 115Format the floppy using parameters for the diskette named 116.Ar type 117in 118.Pa /etc/floppytab 119instead of the device default parameters. 120.It Fl n 121Do not verify each track as it is read. 122.It Fl B Ar nbps 123Set the number of bytes per sector for the formatted diskette. 124.It Fl S Ar nspt 125Set the number of sectors per track for the formatted diskette. 126.It Fl T Ar ntrk 127Set the number of tracks (heads) per cylinder for the formatted diskette. 128.It Fl C Ar ncyl 129Set the number of cylinders for the formatted diskette. 130.It Fl P Ar stepspercyl 131Set the number of motor steps per cylinder for the formatted diskette. 132.It Fl G Ar gaplen 133Set the sector gap length for the formatted diskette. 134.It Fl F Ar fillbyte 135Set the fill byte for the formatted diskette. 136.It Fl X Ar xfer_rate 137Set the bit transfer rate for the formatted diskette. 138.It Fl I Ar interleave 139Set the interleave factor for the formatted diskette. 140.El 141.Sh SEE ALSO 142.Xr fdc 4 143(amiga, i386 and sparc ports) 144.Sh HISTORY 145The 146.Nm 147utility appeared in 148.Nx 1.3 . 149.Sh BUGS 150Some floppy drive units have physical 151diskette format sensors which automatically select a diskette 152density for reading. 153Such drives can format at alternate densities, but 154they cannot successfully verify the formatted diskette except at the 155diskette's normal density. 156