152 lines
4.6 KiB
Groff
152 lines
4.6 KiB
Groff
.\" $NetBSD: rf.4,v 1.2 2003/03/24 14:18:55 wiz Exp $
|
|
.\" Copyright (c) 2002 Jochen Kunz.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. The name of Jochen Kunz may not be used to endorse or promote
|
|
.\" products derived from this software without specific prior
|
|
.\" written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY JOCHEN KUNZ
|
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JOCHEN KUNZ
|
|
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
|
.Dd March 23, 2003
|
|
.Dt RF 4 vax
|
|
.Os
|
|
.Sh NAME
|
|
.Nm rf
|
|
.Nd
|
|
.Tn DEC RX01 / RX02
|
|
floppy disk interface
|
|
.Sh SYNOPSIS
|
|
.Cd "rfc0 at uba? csr 0177170 # RX01/RX02 controller
|
|
.Cd "rf* at rfc? drive? # RX01/RX02 floppy disk drive
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm rf
|
|
device provides access to
|
|
.Tn DEC
|
|
.Tn RX01
|
|
and
|
|
.Tn RX02
|
|
floppy disk drives and clones thereof.
|
|
These drives use preformatted 8" single sided, soft sectored media.
|
|
The
|
|
.Tn RX01
|
|
and
|
|
.Tn RX02
|
|
drives use a geometry of 77 cylinders, one head and 26 sectors.
|
|
Each sector contains 128 bytes in case of single density (
|
|
.Tn RX01
|
|
and
|
|
.Tn RX02
|
|
in
|
|
.Tn RX01
|
|
mode) or 256 bytes in double density mode.
|
|
As
|
|
.Nx
|
|
is not able to handle non-512 byte media the driver translates this
|
|
to a geometry of 50 cylinders, one head and 10 sectors in single
|
|
density and 77 cylinders, one head and 13 sectors in double density
|
|
mode.
|
|
While the later matches the total number of sectors, the fake
|
|
geometry in single density does not cover the last two physical
|
|
sectors exact, but it is possible to access this sectors at 512
|
|
byte LBN 501.
|
|
When a 512 byte block is written to LBN 501 the last 256 bytes are ignored.
|
|
When this 512 byte block is read the last 256 bytes contain undefined data.
|
|
.Pp
|
|
This driver supports three minor devices corresponding to the slices:
|
|
.Pp
|
|
.Bl -column Otherx -offset indent
|
|
.Sy Slice Description
|
|
a Single density only mode.
|
|
b Double density only mode.
|
|
c Density autodetect.
|
|
.El
|
|
.Pp
|
|
As the
|
|
.Tn RX01
|
|
and
|
|
.Tn RX02
|
|
hardware is not able to support formatting a blank disk, this driver has
|
|
no support for according IOCTLs.
|
|
But there are clones from third party vendors that support formatting.
|
|
Formatting a blank disk may be initiated
|
|
by the following commands on the VAX chevron prompt:
|
|
.Pp
|
|
.Bl -column Otherx -offset indent
|
|
Single density
|
|
d/p/w 20001E78 9
|
|
d/p/w 20001E7A 92
|
|
.El
|
|
.Pp
|
|
.Bl -column Otherx -offset indent
|
|
Double density
|
|
d/p/w 20001E78 109
|
|
d/p/w 20001E7A 92
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width /dev/rx?xx -compact
|
|
.It Pa /dev/rf?[abc]
|
|
.It Pa /dev/rrf?[abc]
|
|
.El
|
|
.Sh DIAGNOSTICS
|
|
.Bl -diag
|
|
.It "rfc_attach: Error creating bus dma map: %d"
|
|
.It "did not respond to INIT CMD"
|
|
Possible errors during
|
|
.Xr autoconf 4 .
|
|
%d is the return code of
|
|
.Xr bus_dmamap_create 9 .
|
|
.It "%s: did not respond to CMD %x"
|
|
An error occurred while the driver tried to send command %x to drive %s.
|
|
.It "rfc_intr: Error while reading sector: %x"
|
|
.It "rfc_intr: Error while writing sector: %x"
|
|
.It "rfc_intr: Error while DMA: %x"
|
|
%x is status code from the controller error and status register.
|
|
.It "rfc_intr: Error while loading bus dma map: %d"
|
|
%d is return code of
|
|
.Xr bus_dmamap_load 9 .
|
|
.It "%s: density error."
|
|
A single density disk was opened in double density only mode or vice
|
|
versa or the medium in the drive attached as %s was not readable at all.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr dd 1 ,
|
|
.Xr tar 1 ,
|
|
.Xr intro 4 ,
|
|
.Xr disklabel 5 ,
|
|
.Xr disklabel 8 ,
|
|
.Xr mknod 8 ,
|
|
.Xr mount 8 ,
|
|
.Xr newfs 8
|
|
.Sh HISTORY
|
|
The rf driver appeared in
|
|
.Nx 2.0 .
|
|
It is a complete rewrite, not related to the old 4.2BSD
|
|
.Nm rx
|
|
driver.
|
|
.Sh AUTHORS
|
|
.An Jochen Kunz
|
|
.Sh BUGS
|
|
Writing of a
|
|
.Xr disklabel 5
|
|
is not supported.
|
|
The driver return always the internally fake disklabel.
|