>Number:         622
>Category:       port-i386
>Synopsis:       There isn't a a man page for the i386 floppy drives
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    gnats-admin (GNATS administrator)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Dec  8 22:20:04 1994
>Originator:     Ken Hornstein
>Organization:
"	"
>Release:        1.0
>Environment:
	
System: NetBSD excalibur 1.0 NetBSD 1.0 (EXCALIBUR) #11: Tue Nov 29 00:54:11 EST 1994 kenh@excalibur:/usr/src/sys/arch/i386/compile/EXCALIBUR i386


>Description:
There isn't a man page for the floppy drives on the i386.  This is really
unfortunate, as the different "partitions" tend to confuse people who try to
use them as such.
	
>How-To-Repeat:
Say "man 4 fd"
	
>Fix:
	
Here's a quick man page I wrote.  Enjoy.

.\"
.\" Copyright (c) 1994 Ken Hornstein
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"      This product includes software developed by Ken Hornstein
.\" 3. The name of the author may not be used to endorse or promote products
.\"    derived from this software without specific prior written permission
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\"	$Id$
.\"
.Dd December 9, 1994
.Dt fd 4
.Os
.Sh NAME
.Nm fd
.Nd Floppy disk drive and controller
.Sh SYNOPSIS
.Cd "controller fdc0 at isa? port" \&"IO_FD1\&" irq 6 drq 2
.Cd "disk fd0 at fdc0 drive ?"
.Cd "disk fd1 at fdc0 drive ?"
.Sh DESCRIPTION
The
.Nm fd
device driver provides an interface to the standard floppy disk drives
found on the IBM PC.  Up to four drives may exist on one controller, but
in practice only two are used.  The floppy devices get their "default"
density from the value set in the PC BIOS.
.Pp
Although the floppy devices have the same lettering scheme as hard disk
partitions, the drive letters refer to different media densities as opposed
to partitions.  The mapping of device names to media densities is as follows:
.Bl -tag -width xxxxxxxxxxxx
.It /dev/[r]fdXa
The "default" density as determined at probe time.
.It /dev/[r]fdXb
1.44MB diskette in 1.44MB (3.5") drive
.It /dev/[r]fdXc
1.2MB diskette in 1.2MB (5.25") drive
.It /dev/[r]fdXd
360kB diskette in 1.2MB (5.25") drive
.It /dev/[r]fdXe
360kB PC diskette
.It /dev/[r]fdXf
720kB diskette in 3.5" drive
.It /dev/[r]fdXg
720kB diskette in 1.2MB (5.25") drive
.It /dev/[r]fdXh
360kB diskette in a 720kB drive
.El
.Pp
.Sh NOTES
There doesn't seem to be a good way to determine media type without simply
trying different densities in rotation.
.Pp
The mode bits returned from the error messages aren't very useful unless you
know how floppy drives work.
.Pp
.Sh DIAGNOSTICS
fdX: soft error: ...
.in +4
The drive has encountered a non-fatal error
.in -4
fdX: hard error: ...
.in +4
The drive has encountered a fatal error
.in -4
.Sh BUGS
There should be a way to do a low-level format from NetBSD.
.Sh SEE ALSO
.Xr disklabel 8 ,
.Xr newfs 8 ,
.Xr mount_msdos 8
>Audit-Trail:
>Unformatted: