1.\" $NetBSD: fdformat.1,v 1.18 2012/04/08 22:00:38 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.\" 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.Op Fl n 39.Op Fl B Ar nbps 40.Op Fl C Ar ncyl 41.Op Fl F Ar fillbyte 42.Op Fl f Ar device 43.Op Fl G Ar gaplen 44.Op Fl I Ar interleave 45.Op Fl P Ar stepspercyl 46.Op Fl S Ar nspt 47.Op Fl T Ar ntrk 48.Op Fl t Ar type 49.Op Fl X Ar xfer_rate 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. 59.Pp 60The 61.Nm 62utility does not create a filesystem of any kind. 63Use tools like 64.Xr newfs 8 , 65.Xr newfs_msdos 8 , 66or 67.Xr mformat 1 68(part of the pkgsrc/sysutils/mtools package) depending on what filesystem 69type you want to use on the floppy disk to do so. 70.Pp 71Available command-line flags are: 72.Bl -tag -width indent -compact 73.It Fl f Ar device 74Format the floppy using 75.Ar device 76instead of the default 77.Pa /dev/rfd0a . 78.It Fl t Ar type 79Format the floppy using parameters for the diskette named 80.Ar type 81in 82.Pa /etc/floppytab 83instead of the device default parameters. 84.It Fl n 85Do not verify each track as it is read. 86.It Fl B Ar nbps 87Set the number of bytes per sector for the formatted diskette. 88.It Fl S Ar nspt 89Set the number of sectors per track for the formatted diskette. 90.It Fl T Ar ntrk 91Set the number of tracks (heads) per cylinder for the formatted diskette. 92.It Fl C Ar ncyl 93Set the number of cylinders for the formatted diskette. 94.It Fl P Ar stepspercyl 95Set the number of motor steps per cylinder for the formatted diskette. 96.It Fl G Ar gaplen 97Set the sector gap length for the formatted diskette. 98.It Fl F Ar fillbyte 99Set the fill byte for the formatted diskette. 100.It Fl X Ar xfer_rate 101Set the bit transfer rate for the formatted diskette. 102.It Fl I Ar interleave 103Set the interleave factor for the formatted diskette. 104.El 105.Sh SEE ALSO 106.Xr fdc 4 107(amiga, i386 and sparc ports) 108.Sh HISTORY 109The 110.Nm 111utility appeared in 112.Nx 1.3 . 113.Sh BUGS 114Some floppy drive units have physical 115diskette format sensors which automatically select a diskette 116density for reading. 117Such drives can format at alternate densities, but 118they cannot successfully verify the formatted diskette except at the 119diskette's normal density. 120