xref: /netbsd-src/share/man/man4/man4.sparc/fd.4 (revision 5e4c038a45edbc7d63b7c2daa76e29f88b64a4e3)
1.\"	$NetBSD: fd.4,v 1.8 2002/01/15 01:59:42 wiz Exp $
2.\"
3.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Paul Kranenburg.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\" 3. All advertising materials mentioning features or use of this software
18.\"    must display the following acknowledgement:
19.\"        This product includes software developed by the NetBSD
20.\"        Foundation, Inc. and its contributors.
21.\" 4. Neither the name of The NetBSD Foundation nor the names of its
22.\"    contributors may be used to endorse or promote products derived
23.\"    from this software without specific prior written permission.
24.\"
25.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
26.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35.\" POSSIBILITY OF SUCH DAMAGE.
36.\"
37.Dd June 23, 1996
38.Dt FD 4 sparc
39.Os
40.Sh NAME
41.Nm fd ,
42.Nm fdc
43.Nd Sun SPARCstation i82072 or i82077 floppy disk controller driver
44.Sh SYNOPSIS
45.Cd "fdc0 at mainbus0" Pq sun4c
46.Cd "fdc0 at obio0" Pq sun4m
47.Cd "fd* at fdc0"
48.Sh DESCRIPTION
49This is the driver for the built-in floppy disk drive run by the
50.Tn Intel
51i82072 or i82077 controller chip found on the SPARCstation desktop
52systems, and other
53.Tn SPARC
54systems.
55.Pp
56Bits
57.Bq 0-3
58of the minor device number of the special files referring to this
59device encode the floppy density as follows:
60.Bl -tag -width indent -offset indent
61.It 0
623.5'' 1.44MB floppy diskettes.
63.It 1
643.5'' 720KB floppy diskettes.
65.It 2
663.5'' 360KB floppy diskettes.
67.It 3
683.5'' 1.2MB/NEC Japanese format floppy diskettes.
69.El
70.Sh FORMATTING
71The driver supports floppy disk formatting using the interfaces in
72.Pa Aq sys/fdio.h :
73.Pp
74.Bl -tag -width FDIOCFORMAT_TRACK -compact
75.It Dv FDIOCGETFORMAT Fa struct fdformat_parms
76Fetch current formatting parameters.
77This gets the default parameters
78for the open device if no parameters have been set during the session.
79.Pp
80.It Dv FDIOCSETFORMAT Fa struct fdformat_parms
81Set formatting parameters.
82The driver saves this state and it persists while the device is open.
83.Pp
84.It Dv FDIOCFORMAT_TRACK Fa struct fdformat_cmd
85Format a track on the medium.
86If this call returns
87.Er EINVAL ,
88the track formatting parameters were out of range for the medium.
89If it returns
90.Er EIO ,
91there was a medium error while formatting the track.
92.Pp
93.It Dv FDIOCSETOPTS Fa int
94Set driver options which persist until the device is closed.
95The
96options should be the logical OR of the desired values below:
97.Pp
98.Bl -tag -width FDOPT_NORETRY -compact
99.It Dv FDOPT_NORETRY
100Do not retry operations on failure
101.It Dv FDOPT_SILENT
102Do not print error messages to the console
103.El
104.Pp
105.It Dv FDIOCGETOPTS Fa int
106Fetch drive options.
107.El
108.Pp
109A typical use of the formatting facilities would be to open the device,
110call
111.Dv FDIOCGETFORMAT
112to fetch the current format parameters, perhaps
113change a parameter or two, display the formatting details to the user,
114and then call
115.Dv FDIOCSETFORMAT
116followed by a series of calls to
117.Dv FDIOCFORMAT_TRACK .
118.Sh SEE ALSO
119.Xr eject 1 ,
120.Xr fdformat 1
121.Sh HISTORY
122The
123.Nm
124formatting support appeared in
125.Nx 1.3 .
126.Sh BUGS
127Formatting appears to not work reliably on all machines.
128