Subject: port-sparc/4390: sparc floppy driver could use a manpage
To: None <>
From: Eric Fischer <>
List: netbsd-bugs
Date: 10/29/1997 14:18:47
>Number:         4390
>Category:       port-sparc
>Synopsis:       sparc floppy undocumented and has confusing uses for partition names
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    gnats-admin (GNATS administrator)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Oct 29 12:35:03 1997
>Originator:     Eric Fischer
	The University of Chicago
>Release:        1.2
System: NetBSD fudge 1.2 NetBSD 1.2 (FUDGE) #7: Sun Jan 19 16:26:56 CST 1997 eric@fudge:/usr/people/eric/usrsrc/sys/arch/sparc/compile/FUDGE sparc

	The sparc floppy disk driver uses the partition letters to
	refer to disk capacities, not to partitions, but this isn't
	documented anywhere other than the source code.
	newfs /dev/fd0c
	wonder why you only get 1.2mb
	curse at the lack of a manpage to tell you why
	Include a manpage for fd(4).  This isn't a very good one,
	but crummy documentation is better than none at all, I think.

.TH FD 4
fd \- floppy disk devices
fd* at fdc? drive ?
.B fd
device provides access to the Sparc floppy disk drive.
The block devices are named 
.B /dev/fd?[a-h]
and the raw
.BR /dev/fd?[a-h] ,
but unlike the similarly named
.B sd
disk devices, the letter here refers not to a partition but
to the disk capacity.
The capacities supported are:
l l l l .
``partition''	sectors	cylinders	capacity
b	36	80	1.4MB
c	30	80	1.2MB
d	18	40	360K (in 1.2MB drive)
e	18	40	360K
f	18	80	720K
g	18	80	720K (in 1.2MB drive)
h	18	40	360K (in 720K drive)
.B a
is supposed to be the automatically detected capacity, but
in practice it is the same as
.BR b .
.B fd
driver recognizes the following ioctls, declared in <sys/dkio.h>:
returns the disk label as a
.B struct disklabel
does nothing, unless the disk is unwriteable, in which case it is an error
sets the disk label to the
.B struct disklabel
always succeeds
ejects the floppy disk