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 $
35 .Nd ATAPI floppy driver (LS-120 floppy driver)
38 .Cd options ATAPI_STATIC
44 driver provides support for
46 floppy disks, typically LS-120 style 120mb/1.4mb floppy drives.
47 In general the interfaces are similar to those described by
50 As the IDE controllers are probed during boot, the
52 buses are scanned for devices.
53 Any devices found which answered as
57 type device will be attached to the
60 The first device found will be attached as
66 When used with a LS-120 drive, this driver will read/write the following
68 .Bl -tag -width 1.25MB -compact
71 .It 1.25mb (PC-9801 series format)
78 driver allows the disk to have two levels of partitioning.
81 is used to separate the
83 areas of the disk from areas used by other operating systems.
84 The second layer is the native
88 which is used to subdivide the
90 slices into areas for individual filesystems.
91 For more information, see
97 If an uninitialized disk is opened, the slice table will be
98 initialized with a fictitious
100 slice spanning the entire disk. Similarly, if an uninitialized
103 slice is opened, its disklabel will be initialized with parameters
104 returned by the drive and a single
106 partition encompassing the entire slice.
108 Making LS-120/ZIP disks can be a bit more complicated than usual depending
109 upon whether or not you chose to use the slice code or not.
110 LS-120 floppies are typically considered floppy devices and do not carry
111 a slice table. On the other hand, Zip disks, which use the same driver,
112 are considered hard disks by the vendor, so for compatibility, you should
115 The driver will handle either type of disk with or without a slice
116 table, but for compatibility, you should generally create disks
117 that follow the vendor's behavior.
119 To create a UFS LS-120 disk (no slice table),
120 First, make sure there is no slice table on the disk):
121 .Dl # dd if=/dev/zero of=/dev/wfd0 count=16
123 Next, disklabel the disk:
124 .Dl # disklabel -rw wfd0 fd120m
127 .Dl # newfs /dev/rwfd0a
129 To create a standard 1.44mb floppy in a LS-120 drive, do the same
132 as the disk layout when using the
135 .Sh KERNEL CONFIGURATION
138 device is necessary in the config file; data structures are dynamically
139 allocated as disks are found on the
143 This driver is attached to the
145 IDE/ATAPI disk controller driver. It will not work unless
146 IDE controllers have been configured and enabled in the kernel.
148 Floppy formatting is not yet supported.
150 This driver is still a beta version.
151 If you have problems, please report them to
155 .Bl -tag -width /dev/rwfdXXXXX -compact
156 .It Pa /dev/rwfd Ns Ar u
161 accessed as an unpartitioned device
163 .It Pa /dev/wfd Ar u Pa s Ar n
171 accessed as an unpartitioned device
173 .It Pa /dev/rwfd Ar u Pa s Ar n
181 accessed as an unpartitioned device
182 .It Pa /dev/wfd Ns Ar u Ns Ar p
191 .It Pa /dev/rwfd Ns Ar u Ns Ar p
201 .It Pa /dev/wfd Ar u Pa s Ar n Ar p
211 .It Pa /dev/rwfd Ar u Pa s Ar n Ar p
228 .An "Junichi Satoh" Aq junichi@jp.FreeBSD.org
232 driver first appeared in