freebsd-dev/share/man/man4/fdc.4

.\"
.\" Copyright (c) 1994 Wilko Bulte
.\" 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. 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.
.\"
.\" $FreeBSD$
.\"
.Dd August 31, 1994
.Dt FDC 4
.Os
.Sh NAME
.Nm fdc
.Nd PC architecture floppy disk controller driver
.Sh SYNOPSIS
.Cd device fdc
.Cd device fd
.Pp
In
.Pa /boot/device.hints :
.Cd hint.fdc.0.at="isa"
.Cd hint.fdc.0.port="0x3F0"
.Cd hint.fdc.0.irq="6"
.Cd hint.fdc.0.drq="2"
.Cd hint.fd.0.at="fdc0"
.Cd hint.fd.0.drive="0"
.Cd hint.fd.1.at="fdc0"
.Cd hint.fd.1.drive="1"
.Sh DESCRIPTION
This driver provides access to floppy disk drives.
In /dev for each floppy device a number of minor devices are present.
The
/dev/fd* devices with trailing alphabetic characters are used to indicate
.Sq partitions
on the floppy disk.
The /dev/fd*.<number> are devices that
indicate the size of the floppy disk (so: 720kB, 1440kB etc). The latter
are used for formatting disks using fdformat or for accessing different
density disks in multidensity drive.
Example: 720kB disk in a 1.44Mb drive.
.Pp
Normally, the driver will ask the system's CMOS memory to obtain the
floppy drive configuration.  Some machines do not store any form of a
configuration value in their CMOS.  Use the flags value
.Ql 0x1
to pretend a 1.44 MB floppy drive as the first unit, without asking the
CMOS for it.
.Pp
Normally, the device driver detects FDC chipsets that have an internal
FIFO, and enables the FIFO on them.  There is a slight chance that this
feature is actually misdetected (seen on an IBM Thinkpad 755c), so it
can be turned off using flags
.Ql 0x4 .
.Sh FILES
.Bl -tag -width Pa -compact
.It Pa /dev/fd*
floppy disk device nodes
.It Pa /dev/fd*. Ns Ar "<size in kB>"
floppy disk device nodes where the trailing number indicates the floppy
capacity
.It Pa /sys/i386/conf/GENERIC
sample generic kernel config file
.It Pa /sys/isa/fd.c
floppy driver source
.El
.Sh SEE ALSO
.Xr fdformat 1 ,
.Xr disktab 5
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.\"`
			`.\" Copyright (c) 1994 Wilko Bulte`
			`.\" 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. The name of the author may not be used to endorse or promote products`
Spelling police: withough -> without Submitted by: Joseph Mallett <jmallett@xMach.org> 2001-08-23 21:36:18 +00:00			`.\" derived from this software without specific prior written permission`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.\"`
			.\" 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$ -> $FreeBSD$ 1999-08-28 00:22:10 +00:00			`.\" $FreeBSD$`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.\"`
			`.Dd August 31, 1994`
* remove i386 specific mark * some style and syntax fixes * some duplicated $FreeBSD$ tags removed 1999-11-15 23:14:32 +00:00			`.Dt FDC 4`
mdoc(7) police: removed HISTORY info from the .Os call. 2001-07-10 15:31:11 +00:00			`.Os`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.Sh NAME`
			`.Nm fdc`
mdoc(7) police: normalize .Nd. 2001-04-18 15:54:10 +00:00			`.Nd PC architecture floppy disk controller driver`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.Sh SYNOPSIS`
Update man pages in the section 4 to match the reality in -CURRENT. - Change lines referring to kernel configuration file: device foo0 at isa port xxx irq yyy... to device foo Describe resource "hints" in /boot/device.hints. - Try to describe resource allocation and probe/attach behavior in the newbus framework. 2001-10-13 09:08:37 +00:00			`.Cd device fdc`
			`.Cd device fd`
			`.Pp`
			`In`
			`.Pa /boot/device.hints :`
			`.Cd hint.fdc.0.at="isa"`
			`.Cd hint.fdc.0.port="0x3F0"`
			`.Cd hint.fdc.0.irq="6"`
			`.Cd hint.fdc.0.drq="2"`
			`.Cd hint.fd.0.at="fdc0"`
			`.Cd hint.fd.0.drive="0"`
			`.Cd hint.fd.1.at="fdc0"`
			`.Cd hint.fd.1.drive="1"`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.Sh DESCRIPTION`
fdc doesn't support talking to QIC40/QIC80 tape drives, and hasn't since ft was removed from the tree prior to branching releng_3! 2001-06-10 00:27:18 +00:00			`This driver provides access to floppy disk drives.`
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc. 2000-03-01 14:50:24 +00:00			`In /dev for each floppy device a number of minor devices are present.`
			`The`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`/dev/fd* devices with trailing alphabetic characters are used to indicate`
Fix a disappearing section due to use of (') in the text. Use the .Sq macro instead. PR: docs/13153 Submitted by: Kazuo Horikawa <horikawa@jp.FreeBSD.org> 1999-11-02 19:58:39 +00:00			`.Sq partitions`
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc. 2000-03-01 14:50:24 +00:00			`on the floppy disk.`
			`The /dev/fd*.<number> are devices that`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`indicate the size of the floppy disk (so: 720kB, 1440kB etc). The latter`
			`are used for formatting disks using fdformat or for accessing different`
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc. 2000-03-01 14:50:24 +00:00			`density disks in multidensity drive.`
			`Example: 720kB disk in a 1.44Mb drive.`
Document the new fdc(4) flags. 1997-10-19 13:12:35 +00:00			`.Pp`
			`Normally, the driver will ask the system's CMOS memory to obtain the`
			`floppy drive configuration. Some machines do not store any form of a`
			`configuration value in their CMOS. Use the flags value`
			`.Ql 0x1`
			`to pretend a 1.44 MB floppy drive as the first unit, without asking the`
			`CMOS for it.`
Add a flag to disable FIFO probing. The code seems to have a chance of misdetecting FIFO capabilities, at least on my girlfriend's Thinkpad 755, the driver doesn't work using the FIFO. While i was at it, i (partially) fixed option FCC_YE since it would no longer have compiled at all under -current. I've also made an attempt to document the device driver flags value (ab-)used internally by this option. RELENG_3 candidate, but with a slightly different patch there (will go to jkh in email). 1999-12-21 08:33:03 +00:00			`.Pp`
			`Normally, the device driver detects FDC chipsets that have an internal`
			`FIFO, and enables the FIFO on them. There is a slight chance that this`
			`feature is actually misdetected (seen on an IBM Thinkpad 755c), so it`
			`can be turned off using flags`
			`.Ql 0x4 .`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.Sh FILES`
			`.Bl -tag -width Pa -compact`
mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:38:02 +00:00			`.It Pa /dev/fd*`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`floppy disk device nodes`
mdoc(7) police: split punctuation characters + misc fixes. 2001-02-01 16:38:02 +00:00			`.It Pa /dev/fd*. Ns Ar "<size in kB>"`
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f\|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days 2001-07-14 19:41:16 +00:00			`floppy disk device nodes where the trailing number indicates the floppy`
			`capacity`
Changed all occurences of GENERICAH/GENERICBT to a simple GENERIC in the man pages. 1994-10-31 09:52:23 +00:00			`.It Pa /sys/i386/conf/GENERIC`
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f\|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days 2001-07-14 19:41:16 +00:00			`sample generic kernel config file`
Fix driver source location path (/sys/i386/isa/fd.c -> /sys/isa/fd.c) 2000-05-12 08:36:36 +00:00			`.It Pa /sys/isa/fd.c`
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f\|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days 2001-07-14 19:41:16 +00:00			`floppy driver source`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.El`
			`.Sh SEE ALSO`
add missing comma(s) in .Xr macros 1996-09-23 22:24:39 +00:00			`.Xr fdformat 1 ,`
Various man page cleanup: - Sort xrefs - FreeBSD.ORG -> FreeBSD.org - Be consistent with section names as outlined in mdoc(7). - Other misc mdoc cleanup. PR: doc/13144 Submitted by: Alexey M. Zelkin <phantom@cris.net> 1999-08-15 10:48:36 +00:00			`.Xr disktab 5`