docs: Added All NetBSD Manuals

1 files changed, 147 insertions, 0 deletions

diff --git a/static/netbsd/man4/rf.4 b/static/netbsd/man4/rf.4
new file mode 100644
index 00000000..5919dd78
--- /dev/null
+++ b/static/netbsd/man4/rf.4
@@ -0,0 +1,147 @@
+.\"	$NetBSD: rf.4,v 1.7 2017/08/01 11:11:17 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 February 17, 2017
+.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:
+.Bl -column Slice -offset indent
+.It Sy Slice	Description
+.It a	Single density only mode.
+.It b	Double density only mode.
+.It c	Density autodetect.
+.El
+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:
+.Bl -column Otherx -offset indent
+.It Single density
+.It d/p/w 20001E78 9
+.It d/p/w 20001E7A 92
+.El
+.Bl -column Otherx -offset indent
+.It Double density
+.It d/p/w 20001E78 109
+.It 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 vax/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 vax/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.