manual/fdutils/original/man4/fd.4

   1 '\" t
   2 .\"{{{}}}
   3 .\"{{{  Notes
   4 .\" Copyright (c) 1993 Michael Haardt (michael@cantor.informatik.rwth-aachen.de)
   5 .\" and 1994,1995, 1997 Alain Knaff (alain@linux.lu)
   6 .\"
   7 .\" This is free documentation; you can redistribute it and/or
   8 .\" modify it under the terms of the GNU General Public License as
   9 .\" published by the Free Software Foundation; either version 2 of
  10 .\" the License, or (at your option) any later version.
  11 .\"
  12 .\" The GNU General Public License's references to "object code"
  13 .\" and "executables" are to be interpreted as the output of any
  14 .\" document formatting or typesetting system, including
  15 .\" intermediate and printed output.
  16 .\"
  17 .\" This manual is distributed in the hope that it will be useful,
  18 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 .\" GNU General Public License for more details.
  21 .\"
  22 .\" You should have received a copy of the GNU General Public
  23 .\" License along with this manual; if not, write to the Free
  24 .\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
  25 .\" USA.
  26 .\"}}}
  27 .\"{{{  Title
  28 .TH FD 4 "Jul 3, 1999" "Linux" "Special files"
  29 .\"}}}
  30 .\"{{{  Name
  31 .SH NAME
  32 fd \- floppy disk device
  33 .\"}}}
  34 .\"{{{  Configuration
  35 .SH CONFIGURATION
  36 Floppy drives are block devices with major number 2.  Typically they
  37 are owned by root.floppy and have either mode 0660 (access checking via
  38 group membership) or mode 0666 (everybody has access).  For the
  39 following devices, \fIn\fP is the drive number.  It is 0 for the first
  40 drive, 1 for the second etc.  To get a minor number for a specific
  41 drive connected to the first controller, add \fIn\fP to the minor base
  42 number.  If it is connected to the second controller, add \fIn\fP+128 to
  43 the minor base number.  \fBWarning: If you use formats with more tracks
  44 than supported by your drive, you may damage it mechanically.\fP  Trying
  45 once if more tracks than the usual 40/80 are supported should not
  46 damage it, but no warranty is given for that.  Don't create device
  47 entries for those formats to prevent their usage if you are not sure.
  48 .PP
  49 .\"{{{  drive independent
  50 Drive independent device files which automatically detect the media
  51 format and capacity:
  52 .PP
  53 .TS
  54 l l.
  55 Name    Base minor #
  56 _
  57 \fBfd\fP\fIn\fP 0
  58 .TE
  59 .\"}}}
  60 .PP
  61 .\"{{{  5.25 DD
  62 5.25 inch double density device files:
  63 .PP
  64 .TS
  65 lw(1i) l l l l l.
  66 Name    Capac.  Cyl.    Sect.   Heads   Base minor #
  67 _
  68 \fBfd\fP\fIn\fP\fBd360\fP       360K    40      9       2       4
  69 .TE
  70 .\"}}}
  71 .PP
  72 .\"{{{  5.25 HD
  73 5.25 inch high density device files:
  74 .PP
  75 .TS
  76 lw(1i) l l l l l.
  77 Name    Capac.  Cyl.    Sect.   Heads   Base minor #
  78 _
  79 \fBfd\fP\fIn\fP\fBh360\fP       360K    40      9       2       20
  80 \fBfd\fP\fIn\fP\fBh410\fP       410K    41      10      2       48
  81 \fBfd\fP\fIn\fP\fBh420\fP       420K    42      10      2       64
  82 \fBfd\fP\fIn\fP\fBh720\fP       720K    80      9       2       24
  83 \fBfd\fP\fIn\fP\fBh880\fP       880K    80      11      2       80
  84 \fBfd\fP\fIn\fP\fBh1200\fP      1200K   80      15      2       8
  85 \fBfd\fP\fIn\fP\fBh1440\fP      1440K   80      18      2       40
  86 \fBfd\fP\fIn\fP\fBh1476\fP      1476K   82      18      2       56
  87 \fBfd\fP\fIn\fP\fBh1494\fP      1494K   83      18      2       72
  88 \fBfd\fP\fIn\fP\fBh1600\fP      1600K   80      20      2       92
  89 .TE
  90 .\"}}}
  91 .PP
  92 .\"{{{  3.5 DD
  93 3.5 inch double density device files:
  94 .PP
  95 .TS
  96 lw(1i) l l l l l.
  97 Name    Capac.  Cyl.    Sect.   Heads   Base minor #
  98 _
  99 \fBfd\fP\fIn\fP\fBu360\fP       360K    80      9       1       12
 100 \fBfd\fP\fIn\fP\fBu720\fP       720K    80      9       2       16
 101 \fBfd\fP\fIn\fP\fBu800\fP       800K    80      10      2       120
 102 \fBfd\fP\fIn\fP\fBu1040\fP      1040K   80      13      2       84
 103 \fBfd\fP\fIn\fP\fBu1120\fP      1120K   80      14      2       88
 104 .TE
 105 .\"}}}
 106 .PP
 107 .\"{{{  3.5 HD
 108 3.5 inch high density device files:
 109 .PP
 110 .TS
 111 lw(1i) l l l l l.
 112 Name    Capac.  Cyl.    Sect.   Heads   Base minor #
 113 _
 114 \fBfd\fP\fIn\fP\fBu360\fP       360K    40      9       2       12
 115 \fBfd\fP\fIn\fP\fBu720\fP       720K    80      9       2       16
 116 \fBfd\fP\fIn\fP\fBu820\fP       820K    82      10      2       52
 117 \fBfd\fP\fIn\fP\fBu830\fP       830K    83      10      2       68
 118 \fBfd\fP\fIn\fP\fBu1440\fP      1440K   80      18      2       28
 119 \fBfd\fP\fIn\fP\fBu1600\fP      1600K   80      20      2       124
 120 \fBfd\fP\fIn\fP\fBu1680\fP      1680K   80      21      2       44
 121 \fBfd\fP\fIn\fP\fBu1722\fP      1722K   82      21      2       60
 122 \fBfd\fP\fIn\fP\fBu1743\fP      1743K   83      21      2       76
 123 \fBfd\fP\fIn\fP\fBu1760\fP      1760K   80      22      2       96
 124 \fBfd\fP\fIn\fP\fBu1840\fP      1840K   80      23      2       116
 125 \fBfd\fP\fIn\fP\fBu1920\fP      1920K   80      24      2       100
 126 .TE
 127 .\"}}}
 128 .PP
 129 .\"{{{  3.5 ED
 130 3.5 inch extra density device files:
 131 .PP
 132 .TS
 133 lw(1i) l l l l l.
 134 Name    Capac.  Cyl.    Sect.   Heads   Base minor #
 135 _
 136 \fBfd\fP\fIn\fP\fBu2880\fP      2880K   80      36      2       32
 137 \fBfd\fP\fIn\fP\fBu3200\fP      3200K   80      40      2       104
 138 \fBfd\fP\fIn\fP\fBu3520\fP      3520K   80      44      2       108
 139 \fBfd\fP\fIn\fP\fBu3840\fP      3840K   80      48      2       112
 140 .TE
 141 .\"}}}
 142 .\"}}}
 143 .\"{{{  Description
 144 .SH DESCRIPTION
 145 \fBfd\fP special files access the floppy disk drives in raw mode.
 146 The following
 147 .IR ioctl (2)
 148 calls are supported by \fBfd\fP devices:
 149 .\"{{{  FDCLRPRM
 150 .IP \fBFDCLRPRM\fP
 151 clears the media information of a drive (geometry of disk in drive).
 152 .\"}}}
 153 .\"{{{  FDCLRPRM
 154 .IP \fBFDSETPRM\fP
 155 sets the media information of a drive. The media information will be
 156 lost when the media is changed.
 157 .\"}}}
 158 .IP \fBFDDEFPRM\fP
 159 sets the media information of a drive (geometry of disk in drive). The
 160 media information will not be lost when the media is changed. This
 161 will disable autodetection. In order to re-enable autodetection, you
 162 have to issue an \fBFDCLRPRM\fP .
 163 .\"}}}
 164 .\"{{{  FDGETDRVTYP
 165 .IP \fBFDGETDRVTYP\fP
 166 returns the type of a drive (name parameter).  For formats which work
 167 in several drive types, \fBFDGETDRVTYP\fP returns a name which is
 168 appropriate for the oldest drive type which supports this format.
 169 .\"}}}
 170 .\"{{{  FDFLUSH
 171 .IP \fBFDFLUSH\fP
 172 invalidates the buffer cache for the given drive.
 173 .\"}}}
 174 .\"{{{  FDSETMAXERRS
 175 .IP \fBFDSETMAXERRS\fP
 176 sets the error thresholds for reporting errors, aborting the operation,
 177 recalibrating, resetting, and reading sector by sector.
 178 .\"}}}
 179 .\"{{{  FDGETMAXERRS
 180 .IP \fBFDSETMAXERRS\fP
 181 gets the current error thresholds.
 182 .\"}}}
 183 .\"{{{  FDGETDRVTYP
 184 .IP \fBFDGETDRVTYP\fP
 185 gets the internal name of the drive.
 186 .\"}}}
 187 .\"{{{  FDWERRORCLR
 188 .IP \fBFDWERRORCLR\fP
 189 clears the write error statistics.
 190 .\"}}}
 191 .\"{{{  FDWERRORGET
 192 .IP \fBFDWERRORGET\fP
 193 reads the write error statistics. These include the total number of
 194 write errors, the location and disk of the first write error, and the
 195 location and disk of the last write error. Disks are identified by a
 196 generation number which is incremented at (almost) each disk change.
 197 .\"}}}
 198 .\"{{{  FDTWADDLE
 199 .IP \fBFDTWADDLE\fP
 200 Switch the drive motor off for a few microseconds. This might be
 201 needed in order to access a disk whose sectors are too close together.
 202 .\"}}}
 203 .\"{{{  FDSETDRVPRM
 204 .IP \fBFDSETDRVPRM\fP
 205 sets various drive parameters.
 206 .\"}}}
 207 .\"{{{  FDGETDRVPRM
 208 .IP \fBFDGETDRVPRM\fP
 209 reads these parameters back.
 210 .\"}}}
 211 .\"{{{  FDGETDRVSTAT
 212 .IP \fBFDGETDRVSTAT\fP
 213 gets the cached drive state (disk changed, write protected et al.)
 214 .\"}}}
 215 .\"{{{  FDPOLLDRVSTAT
 216 .IP \fBFDPOLLDRVSTAT\fP
 217 polls the drive and return its state.
 218 .\"}}}
 219 .\"{{{  FDGETFDCSTAT
 220 .IP \fBFDGETFDCSTAT\fP
 221 gets the floppy controller state.
 222 .\"}}}
 223 .\"{{{  FDRESET
 224 .IP \fBFDRESET\fP
 225 resets the floppy controller under certain conditions.
 226 .\"}}}
 227 .\"{{{  FDRAWCMD
 228 .IP \fBFDRAWCMD\fP
 229 sends a raw command to the floppy controller.
 230 .\"}}}
 231 .PP
 232 For more precise information, consult also the <linux/fd.h> and
 233 <linux/fdreg.h> include files, as well as the manual page for
 234 floppycontrol.
 235 .\"}}}
 236 .\"{{{  Notes
 237 .SH NOTES
 238 The various formats allow to read and write many types of disks.
 239 However, if a floppy is formatted with a too small inter sector gap,
 240 performance may drop, up to needing a few seconds to access an entire
 241 track. To prevent this, use interleaved formats. It is not possible to
 242 read floppies which are formatted using GCR (group code recording),
 243 which is used by Apple II and Macintosh computers (800k disks).
 244 Reading floppies which are hard sectored (one hole per sector, with
 245 the index hole being a little skewed) is not supported.  This used to
 246 be common with older 8 inch floppies.
 247 .\"}}}
 248 .\"{{{  Files
 249 .SH FILES
 250 /dev/fd*
 251 .\"}}}
 252 .\"{{{  Authors
 253 .SH AUTHORS
 254 Alain Knaff (Alain@linux.lu), David Niemi
 255 (niemidc@tux.org), Bill Broadhurst (bbroad@netcom.com).
 256 .\"}}}
 257 .\"{{{  See also
 258 .SH "SEE ALSO"
 259 .BR floppycontrol (1),
 260 .BR mknod (1),
 261 .BR chown (1),
 262 .BR getfdprm (1),
 263 .BR superformat (1),
 264 .BR mount (8),
 265 .BR setfdprm (1)
 266 .\"}}}