1 .\" Copyright (c) 1997 Junichi Satoh
2 .\" All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
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.
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.
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 $
36 .Nd ATAPI floppy driver (LS-120 floppy driver)
39 .Cd options ATAPI_STATIC
45 driver provides support for
47 floppy disks, typically LS-120 style 120mb/1.4mb floppy drives.
48 In general the interfaces are similar to those described by
51 As the IDE controllers are probed during boot, the
53 buses are scanned for devices.
54 Any devices found which answered as
58 type device will be attached to the
61 The first device found will be attached as
67 When used with a LS-120 drive, this driver will read/write the following
69 .Bl -tag -width 1.25MB -compact
72 .It 1.25mb (PC-9801 series format)
79 driver allows the disk to have two levels of partitioning.
82 is used to separate the
84 areas of the disk from areas used by other operating systems.
85 The second layer is the native
89 which is used to subdivide the
91 slices into areas for individual filesystems.
92 For more information, see
98 If an uninitialized disk is opened, the slice table will be
99 initialized with a fictitious
101 slice spanning the entire disk. Similarly, if an uninitialized
104 slice is opened, its disklabel will be initialized with parameters
105 returned by the drive and a single
107 partition encompassing the entire slice.
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
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.
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
124 Next, disklabel the disk:
125 .Dl # disklabel -rw wfd0 fd120m
128 .Dl # newfs /dev/rwfd0a
130 To create a standard 1.44mb floppy in a LS-120 drive, do the same
133 as the disk layout when using the
136 .Sh KERNEL CONFIGURATION
139 device is necessary in the config file; data structures are dynamically
140 allocated as disks are found on the
144 This driver is attached to the
146 IDE/ATAPI disk controller driver. It will not work unless
147 IDE controllers have been configured and enabled in the kernel.
149 Floppy formatting is not yet supported.
151 This driver is still a beta version.
152 If you have problems, please report them to
156 .Bl -tag -width /dev/rwfdXXXXX -compact
157 .It Pa /dev/rwfd Ns Ar u
162 accessed as an unpartitioned device
164 .It Pa /dev/wfd Ar u Pa s Ar n
172 accessed as an unpartitioned device
174 .It Pa /dev/rwfd Ar u Pa s Ar n
182 accessed as an unpartitioned device
183 .It Pa /dev/wfd Ns Ar u Ns Ar p
192 .It Pa /dev/rwfd Ns Ar u Ns Ar p
202 .It Pa /dev/wfd Ar u Pa s Ar n Ar p
212 .It Pa /dev/rwfd Ar u Pa s Ar n Ar p
229 .An "Junichi Satoh" Aq junichi@jp.FreeBSD.org
233 driver first appeared in