freebsd-skq/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 withough 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 FreeBSD
.Sh NAME
.Nm fdc
.Nd
PC architecture floppy disk controller driver
.Sh SYNOPSIS
.Cd "device fdc0 at isa? port IO_FD1 flags 0x1 irq 6 drq 2"
.Cd device fd0 at fdc0 drive 0
.Cd device fd1 at fdc0 drive 1
.Sh DESCRIPTION
This driver provides access to floppy disk drives and QIC40/80 tapedrives.
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
The flags value
.Ql 0x2
is reserved for PCMCIA floppy use, and should never be set in a
configuration file directly.  It is internally handled in the driver
if the compilation option
.Dv FDC_YE
is set, and defers device probing.
.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 /dev/fd*
floppy disk device nodes
.It /dev/fd*.<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`
			`.\" derived from this software withough 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$ -> $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`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`.Os FreeBSD`
			`.Sh NAME`
			`.Nm fdc`
			`.Nd`
			`PC architecture floppy disk controller driver`
			`.Sh SYNOPSIS`
Fix usage of /& in conjunction with the .Cd macro. 2000-01-17 14:50:59 +00:00			`.Cd "device fdc0 at isa? port IO_FD1 flags 0x1 irq 6 drq 2"`
			`.Cd device fd0 at fdc0 drive 0`
			`.Cd device fd1 at fdc0 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`
			`This driver provides access to floppy disk drives and QIC40/80 tapedrives.`
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`
			`The flags value`
			`.Ql 0x2`
			`is reserved for PCMCIA floppy use, and should never be set in a`
			`configuration file directly. It is internally handled in the driver`
			`if the compilation option`
			`.Dv FDC_YE`
			`is set, and defers device probing.`
			`.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`
			`.It /dev/fd*`
			`floppy disk device nodes`
			`.It /dev/fd*.<size in kB>`
			`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`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +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`
Add new files from Wilko (and in their proper place). Submitted by: Wilko Bulte 1994-09-29 13:54:36 +00:00			`floppy driver source`
			`.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`