1.\" $NetBSD: fdformat.1,v 1.17 2008/04/30 13:11:00 martin 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.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.Dd July 22, 2006 31.Dt FDFORMAT 1 32.Os 33.Sh NAME 34.Nm fdformat 35.Nd format a floppy diskette 36.Sh SYNOPSIS 37.Nm 38.Bk -words 39.Op Fl f Ar device 40.Ek 41.Bk -words 42.Op Fl t Ar type 43.Ek 44.Op Fl n 45.Bk -words 46.Op Fl B Ar nbps 47.Ek 48.Bk -words 49.Op Fl S Ar nspt 50.Ek 51.Bk -words 52.Op Fl T Ar ntrk 53.Ek 54.Bk -words 55.Op Fl C Ar ncyl 56.Ek 57.Bk -words 58.Op Fl P Ar stepspercyl 59.Ek 60.Bk -words 61.Op Fl G Ar gaplen 62.Ek 63.Bk -words 64.Op Fl F Ar fillbyte 65.Ek 66.Bk -words 67.Op Fl X Ar xfer_rate 68.Ek 69.Bk -words 70.Op Fl I Ar interleave 71.Ek 72.Sh DESCRIPTION 73The 74.Nm 75utility formats a floppy diskette. 76With no arguments, it formats the default floppy device with the default 77density parameters (as provided by the floppy diskette device driver). 78.Pp 79As the each track of the floppy diskette is formatted, it is read to 80verify the format was successful. 81.Pp 82The 83.Nm 84utility does not create a filesystem of any kind. 85Use tools like 86.Xr newfs 8 , 87.Xr newfs_msdos 8 , 88or 89.Xr mformat 1 90(part of the pkgsrc/sysutils/mtools package) depending on what filesystem 91type you want to use on the floppy disk to do so. 92.Pp 93Available command-line flags are: 94.Bl -tag -width indent -compact 95.It Fl f Ar device 96Format the floppy using 97.Ar device 98instead of the default 99.Pa /dev/rfd0a . 100.It Fl t Ar type 101Format the floppy using parameters for the diskette named 102.Ar type 103in 104.Pa /etc/floppytab 105instead of the device default parameters. 106.It Fl n 107Do not verify each track as it is read. 108.It Fl B Ar nbps 109Set the number of bytes per sector for the formatted diskette. 110.It Fl S Ar nspt 111Set the number of sectors per track for the formatted diskette. 112.It Fl T Ar ntrk 113Set the number of tracks (heads) per cylinder for the formatted diskette. 114.It Fl C Ar ncyl 115Set the number of cylinders for the formatted diskette. 116.It Fl P Ar stepspercyl 117Set the number of motor steps per cylinder for the formatted diskette. 118.It Fl G Ar gaplen 119Set the sector gap length for the formatted diskette. 120.It Fl F Ar fillbyte 121Set the fill byte for the formatted diskette. 122.It Fl X Ar xfer_rate 123Set the bit transfer rate for the formatted diskette. 124.It Fl I Ar interleave 125Set the interleave factor for the formatted diskette. 126.El 127.Sh SEE ALSO 128.Xr fdc 4 129(amiga, i386 and sparc ports) 130.Sh HISTORY 131The 132.Nm 133utility appeared in 134.Nx 1.3 . 135.Sh BUGS 136Some floppy drive units have physical 137diskette format sensors which automatically select a diskette 138density for reading. 139Such drives can format at alternate densities, but 140they cannot successfully verify the formatted diskette except at the 141diskette's normal density. 142