share/man/man4/man4.i386/wfd.4

   1 .\" Copyright (c) 1997 Junichi Satoh
   2 .\"   All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. Neither the name of the author nor the names of any co-contributors
  13 .\"    may be used to endorse or promote products derived from this software
  14 .\"    without specific prior written permission.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY FreeBSD, Inc. AND CONTRIBUTORS ``AS IS''
  17 .\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL FreeBSD, Inc.  OR CONTRIBUTORS BE
  20 .\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  21 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  22 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  23 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  24 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  25 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  26 .\" POSSIBILITY OF SUCH DAMAGE.
  27 .\"
  28 .\" $FreeBSD: src/share/man/man4/man4.i386/wfd.4,v 1.12.2.3 2001/12/21 10:07:09 ru Exp $
  29 .\" $DragonFly: src/share/man/man4/man4.i386/Attic/wfd.4,v 1.2 2003/06/17 04:37:00 dillon Exp $
  30 .\"
  31 .Dd January 16, 1998
  32 .Dt WFD 4 i386
  33 .Os
  34 .Sh NAME
  35 .Nm wfd
  36 .Nd ATAPI floppy driver (LS-120 floppy driver)
  37 .Sh SYNOPSIS
  38 .Cd options ATAPI
  39 .Cd options ATAPI_STATIC
  40 .Cd device wfd
  41 .Pp
  42 .Sh DESCRIPTION
  43 The
  44 .Nm
  45 driver provides support for
  46 .Em ATAPI
  47 floppy disks, typically LS-120 style 120mb/1.4mb floppy drives.
  48 In general the interfaces are similar to those described by
  49 .Xr wd 4 .
  50 .Pp
  51 As the IDE controllers are probed during boot, the
  52 .Em IDE
  53 buses are scanned for devices.
  54 Any devices found which answered as
  55 .Sq Em Floppy
  56 and
  57 .Sq Em removable
  58 type device will be attached to the
  59 .Nm
  60 driver.
  61 The first device found will be attached as
  62 .Em wfd0
  63 and the next,
  64 .Em wfd1 ,
  65 and so on.
  66 .Pp
  67 When used with a LS-120 drive, this driver will read/write the following
  68 types of floppy disk:
  69 .Bl -tag -width 1.25MB -compact
  70 .It 120mb
  71 .It 1.44mb
  72 .It 1.25mb (PC-9801 series format)
  73 .It 1.2mb
  74 .It 720kb
  75 .El
  76 .Sh PARTITIONING
  77 The
  78 .Nm
  79 driver allows the disk to have two levels of partitioning.
  80 One layer, called the
  81 .Dq slice layer ,
  82 is used to separate the
  83 .Fx
  84 areas of the disk from areas used by other operating systems.
  85 The second layer is the native
  86 .Bx 4.4
  87 partitioning scheme,
  88 .Xr disklabel 5 ,
  89 which is used to subdivide the
  90 .Fx
  91 slices into areas for individual filesystems.
  92 For more information, see
  93 .Xr fdisk 8
  94 and
  95 .Xr disklabel 8 ,
  96 respectively.
  97 .Pp
  98 If an uninitialized disk is opened, the slice table will be
  99 initialized with a fictitious
 100 .Fx
 101 slice spanning the entire disk.  Similarly, if an uninitialized
 102 (or
 103 .No non- Ns Fx )
 104 slice is opened, its disklabel will be initialized with parameters
 105 returned by the drive and a single
 106 .Sq Li c
 107 partition encompassing the entire slice.
 108 .Sh EXAMPLES
 109 Making LS-120/ZIP disks can be a bit more complicated than usual depending
 110 upon whether or not you chose to use the slice code or not.
 111 LS-120 floppies are typically considered floppy devices and do not carry
 112 a slice table.  On the other hand, Zip disks, which use the same driver,
 113 are considered hard disks by the vendor, so for compatibility, you should
 114 use a slice table.
 115 .Pp
 116 The driver will handle either type of disk with or without a slice
 117 table,  but for compatibility, you should generally create disks
 118 that follow the vendor's behavior.
 119 .Pp
 120 To create a UFS LS-120 disk (no slice table),
 121 First, make sure there is no slice table on the disk):
 122 .Dl # dd if=/dev/zero of=/dev/wfd0 count=16
 123 .Pp
 124 Next, disklabel the disk:
 125 .Dl # disklabel -rw wfd0 fd120m
 126 .Pp
 127 Then newfs as usual:
 128 .Dl # newfs /dev/rwfd0a
 129 .Pp
 130 To create a standard 1.44mb floppy in a LS-120 drive, do the same
 131 procedure, but use
 132 .Ar fd1440
 133 as the disk layout when using the
 134 .Nm disklabel
 135 command.
 136 .Sh KERNEL CONFIGURATION
 137 Only one
 138 .Nm
 139 device is necessary in the config file; data structures are dynamically
 140 allocated as disks are found on the
 141 .Tn IDE
 142 buses.
 143 .Sh NOTES
 144 This driver is attached to the
 145 .Xr wdc 4
 146 IDE/ATAPI disk controller driver.  It will not work unless
 147 IDE controllers have been configured and enabled in the kernel.
 148 .Sh BUGS
 149 Floppy formatting is not yet supported.
 150 .Pp
 151 This driver is still a beta version.
 152 If you have problems, please report them to
 153 .Aq bugs@FreeBSD.org
 154 and the author.
 155 .Sh FILES
 156 .Bl -tag -width /dev/rwfdXXXXX -compact
 157 .It Pa /dev/rwfd Ns Ar u
 158 raw mode
 159 .Tn ATAPI
 160 floppy
 161 .Ar u ,
 162 accessed as an unpartitioned device
 163 .Sm off
 164 .It Pa /dev/wfd Ar u Pa s Ar n
 165 .Sm on
 166 block mode
 167 .Tn ATAPI
 168 floppy disk unit
 169 .Ar u ,
 170 slice
 171 .Ar n ,
 172 accessed as an unpartitioned device
 173 .Sm off
 174 .It Pa /dev/rwfd Ar u Pa s Ar n
 175 .Sm on
 176 raw mode
 177 .Tn ATAPI
 178 floppy disk unit
 179 .Ar u ,
 180 slice
 181 .Ar n ,
 182 accessed as an unpartitioned device
 183 .It Pa /dev/wfd Ns Ar u Ns Ar p
 184 block mode
 185 .Tn ATAPI
 186 floppy disk unit
 187 .Ar u ,
 188 first
 189 .Fx
 190 slice, partition
 191 .Ar p
 192 .It Pa /dev/rwfd Ns Ar u Ns Ar p
 193 raw mode
 194 .Tn ATAPI
 195 floppy disk unit
 196 .Ar u ,
 197 first
 198 .Fx
 199 slice, partition
 200 .Ar p
 201 .Sm off
 202 .It Pa /dev/wfd Ar u Pa s Ar n Ar p
 203 .Sm on
 204 block mode
 205 .Tn ATAPI
 206 floppy disk unit
 207 .Ar u ,
 208 .Ar n Ns th
 209 slice, partition
 210 .Ar p
 211 .Sm off
 212 .It Pa /dev/rwfd Ar u Pa s Ar n Ar p
 213 .Sm on
 214 raw mode
 215 .Tn ATAPI
 216 floppy disk unit
 217 .Ar u ,
 218 .Ar n Ns th
 219 slice, partition
 220 .Ar p
 221 .El
 222 .Sh SEE ALSO
 223 .Xr wcd 4 ,
 224 .Xr wd 4 ,
 225 .Xr disklabel 5 ,
 226 .Xr disklabel 8 ,
 227 .Xr fdisk 8
 228 .Sh AUTHORS
 229 .An "Junichi Satoh" Aq junichi@jp.FreeBSD.org
 230 .Sh HISTORY
 231 The
 232 .Nm
 233 driver first appeared in
 234 .Fx 2.2.6 .