>Number:         2261
>Category:       port-i386
>Synopsis:       floppy driver has no documentation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gnats-admin (GNATS administrator)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Mar 25 11:50:01 1996
>Last-Modified:
>Originator:     Andrew Wheadon
>Organization:
The cost of living hasn't affected it's popularity. (unknown)
current	release=doc host=wipux2.wifo.uni-mannheim.de \ "NetBSD-current mirror"
hostbase=/mit/ftp/pub/NetBSD base=/usr prefix=/usr backup delete use-rel-suffix
>Release:        March.25
>Environment:
	
System: NetBSD wipux2 1.1A NetBSD 1.1A (WIPOOL) #0: Sat Mar 16 01:46:23 MET 1996 andrew@wipux2:/src/src/sys/arch/i386/compile/WIPOOL i386


>Description:
	The floppy driver has no documentation thus idiots like
	me find it hard to disklabel it, since fd0d doesn't have
	the expected meaning.
	I would like to say 'man fd' but 'fd.4' already exists
	so I'm calling it 'fdc.4' for the moment. Also I'm not sure
	what to call the controller (i've called it NEC765 compatible ;-)
	Many thanks to Phil Knaack for pointing out the differences
	in the last letter.
>How-To-Repeat:
	man fd ; man fdc 
	(produces no documentation for the floppy driver.)
>Fix:
--- cut fdc.4 ---
.\"	$NetBSD: fdc.4,v 1.6 1996/03/22 01:55:14 andrew Exp $
.\"
.\" Copyright (c) 1996 Andrew C. Wheadon
.\" Copyright (c) 1983, 1991, 1993
.\"	The Regents of the University of California.  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 the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``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 REGENTS OR CONTRIBUTORS 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.
.\"
.\"     @(#)fdc.4	8.1 (Berkeley) 3/22/96
.\"
.Dd March 25, 1996
.Dt FDC 4
.Os NetBSD
.Sh NAME
.Nm fdc
.Nd NEC765 compatible floppy disk driver
.Sh SYNOPSIS
.Cd "fdc0 at isa? port 0x3f0 irq 6 drq 2"
.Cd "fd* at fdc? drive ?"
.Sh DESCRIPTION
The
.Nm fdc
driver supports the standard AT floppy 
disk controllers. These include standard IDE, MFM, RLL,
EIDE, ESDI and SCSI controllers with floppy attachment.
.Pp
When using the
.Nm fdc
driver with
.Nm disklabel
the last letter is used to indicate the floppy size:
.Bl -tag -width indent
.It a: default (probed) geometry of drive, max supported.
.It b: 1.44MB
.It c: 1.2MB
.It d: 360KB/AT (360KB disk in a 1.2 MB drive)
.It e: 360KB/PC (360KB drive)
.It f: 720KB
.It g: 720KB/x (720KB in a 1.2 MB drive)
.It h: 360KB/x (360KB in a 720KB drive)
.Sh BUGS
The
.Nm fdc 
driver can interfere with other controllers namely some WD/SMC
network controllers fail to work when the probing mechanism
in the 
.Nm fdc 
driver probes for a missing second floppy drive.
In this case you should try recompiling the kernel with
the replacing the relevant line with
.Cd "fd0 at fdc? drive ?".
.Sh SEE ALSO
.Xr intro 4 ,
.Xr dmesg 8 .
--- end of fdc.4 ---
>Audit-Trail:
>Unformatted: