blob: 7b2645a3bc7400b247011091f4ed4295ddbd843f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
<table class="head">
<tr>
<td class="head-ltitle">FD(4)</td>
<td class="head-vol">Device Drivers Manual (sun3)</td>
<td class="head-rtitle">FD(4)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">fd</code> — <span class="Nd">Sun 3/80
i82027 floppy disk drive controller driver</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><code class="Cd">fdc0 at obio0</code> (sun3x)
<br/>
<code class="Cd">fd* at fdc0</code></p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">fd</code> driver is for the built-in floppy
diskette drive run by the Intel i82027 controller found on the Sun 3/80.</p>
<p class="Pp">Bits [0-3] of the minor device number of the special files
referring to this device encode the floppy density as follows:</p>
<div class="Bd-indent">
<dl class="Bl-tag">
<dt>0</dt>
<dd>3.5'' 1.44MB floppy diskettes.</dd>
<dt>1</dt>
<dd>3.5'' 720KB floppy diskettes.</dd>
<dt>2</dt>
<dd>3.5'' 360KB floppy diskettes.</dd>
<dt>3</dt>
<dd>3.5'' 1.2MB/NEC Japanese format floppy diskettes.</dd>
</dl>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="FORMATTING"><a class="permalink" href="#FORMATTING">FORMATTING</a></h1>
<p class="Pp">The driver supports floppy disk formatting using the interfaces in
<code class="In"><<a class="In">sys/fdio.h</a>></code>:</p>
<p class="Pp"></p>
<dl class="Bl-tag Bl-compact">
<dt id="FDIOCGETFORMAT"><a class="permalink" href="#FDIOCGETFORMAT"><code class="Dv">FDIOCGETFORMAT</code></a>
<var class="Fa">struct fdformat_parms</var></dt>
<dd>Fetch current formatting parameters. This gets the default parameters for
the open device if no parameters have been set during the session.
<p class="Pp"></p>
</dd>
<dt id="FDIOCSETFORMAT"><a class="permalink" href="#FDIOCSETFORMAT"><code class="Dv">FDIOCSETFORMAT</code></a>
<var class="Fa">struct fdformat_parms</var></dt>
<dd>Set formatting parameters. The driver saves this state and it persists
while the device is open.
<p class="Pp"></p>
</dd>
<dt id="FDIOCFORMAT_TRACK"><a class="permalink" href="#FDIOCFORMAT_TRACK"><code class="Dv">FDIOCFORMAT_TRACK</code></a>
<var class="Fa">struct fdformat_cmd</var></dt>
<dd>Format a track on the medium. If this call returns
<code class="Er">EINVAL</code>, the track formatting parameters were out
of range for the medium. If it returns <code class="Er">EIO</code>, there
was a medium error while formatting the track.
<p class="Pp"></p>
</dd>
<dt id="FDIOCSETOPTS"><a class="permalink" href="#FDIOCSETOPTS"><code class="Dv">FDIOCSETOPTS</code></a>
<var class="Fa">int</var></dt>
<dd>Set driver options which persist until the device is closed. The options
should be the logical OR of the desired values below:
<p class="Pp"></p>
<dl class="Bl-tag Bl-compact">
<dt id="FDOPT_NORETRY"><a class="permalink" href="#FDOPT_NORETRY"><code class="Dv">FDOPT_NORETRY</code></a></dt>
<dd>Do not retry operations on failure</dd>
<dt id="FDOPT_SILENT"><a class="permalink" href="#FDOPT_SILENT"><code class="Dv">FDOPT_SILENT</code></a></dt>
<dd>Do not print error messages to the console</dd>
</dl>
<p class="Pp"></p>
</dd>
<dt id="FDIOCGETOPTS"><a class="permalink" href="#FDIOCGETOPTS"><code class="Dv">FDIOCGETOPTS</code></a>
<var class="Fa">int</var></dt>
<dd>Fetch drive options.</dd>
</dl>
<p class="Pp">A typical use of the formatting facilities would be to open the
device, call <code class="Dv">FDIOCGETFORMAT</code> to fetch the current
format parameters, perhaps change a parameter or two, display the formatting
details to the user, and then call <code class="Dv">FDIOCSETFORMAT</code>
followed by a series of calls to
<code class="Dv">FDIOCFORMAT_TRACK</code>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr">eject(1)</a>, <a class="Xr">fdformat(1)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">fd</code> formatting support appeared in
<span class="Ux">NetBSD 1.3</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp">Formatting appears to not work reliably on all machines.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">June 23, 1996</td>
<td class="foot-os">NetBSD 10.1</td>
</tr>
</table>
|
