1.\" $NetBSD: fdformat.1,v 1.16 2006/07/22 08:36:14 wiz 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 July 22, 2006 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. 88.Pp 89The 90.Nm 91utility does not create a filesystem of any kind. 92Use tools like 93.Xr newfs 8 , 94.Xr newfs_msdos 8 , 95or 96.Xr mformat 1 97(part of the pkgsrc/sysutils/mtools package) depending on what filesystem 98type you want to use on the floppy disk to do so. 99.Pp 100Available command-line flags are: 101.Bl -tag -width indent -compact 102.It Fl f Ar device 103Format the floppy using 104.Ar device 105instead of the default 106.Pa /dev/rfd0a . 107.It Fl t Ar type 108Format the floppy using parameters for the diskette named 109.Ar type 110in 111.Pa /etc/floppytab 112instead of the device default parameters. 113.It Fl n 114Do not verify each track as it is read. 115.It Fl B Ar nbps 116Set the number of bytes per sector for the formatted diskette. 117.It Fl S Ar nspt 118Set the number of sectors per track for the formatted diskette. 119.It Fl T Ar ntrk 120Set the number of tracks (heads) per cylinder for the formatted diskette. 121.It Fl C Ar ncyl 122Set the number of cylinders for the formatted diskette. 123.It Fl P Ar stepspercyl 124Set the number of motor steps per cylinder for the formatted diskette. 125.It Fl G Ar gaplen 126Set the sector gap length for the formatted diskette. 127.It Fl F Ar fillbyte 128Set the fill byte for the formatted diskette. 129.It Fl X Ar xfer_rate 130Set the bit transfer rate for the formatted diskette. 131.It Fl I Ar interleave 132Set the interleave factor for the formatted diskette. 133.El 134.Sh SEE ALSO 135.Xr fdc 4 136(amiga, i386 and sparc ports) 137.Sh HISTORY 138The 139.Nm 140utility appeared in 141.Nx 1.3 . 142.Sh BUGS 143Some floppy drive units have physical 144diskette format sensors which automatically select a diskette 145density for reading. 146Such drives can format at alternate densities, but 147they cannot successfully verify the formatted diskette except at the 148diskette's normal density. 149