+ahc, +strip

4 files changed, 381 insertions, 13 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index cacc87448f0..56847da3714 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,11 +1,11 @@
-#	$OpenBSD: Makefile,v 1.8 1996/05/10 21:39:29 dm Exp $
-#	$NetBSD: Makefile,v 1.22 1996/03/28 21:32:58 mark Exp $
+#	$OpenBSD: Makefile,v 1.9 1996/07/27 10:50:07 deraadt Exp $
+#	$NetBSD: Makefile,v 1.22.4.2 1996/07/18 00:51:10 jtc Exp $
 #	@(#)Makefile	8.1 (Berkeley) 6/18/93
 
-MAN=	audio.4 bpf.4 ccd.4 clnp.4 cltp.4 ddb.4 drum.4 esis.4 fd.4 icmp.4 \
-	idp.4 imp.4 inet.4 ip.4 iso.4 lkm.4 lo.4 netintro.4 ns.4 nsip.4 \
-	null.4 pty.4 rnd.4 route.4 spp.4 tb.4 tcp.4 termios.4 tty.4 tp.4 udp.4 \
-	unix.4 vnd.4 ipl.4
+MAN=	audio.4 ahc.4 bpf.4 ccd.4 clnp.4 cltp.4 ddb.4 drum.4 esis.4 fd.4 \
+	icmp.4 idp.4 imp.4 inet.4 ip.4 ipl.4 iso.4 lkm.4 lo.4 netintro.4 \
+	ns.4 nsip.4 null.4 pty.4 rnd.4 route.4 spp.4 tb.4 tcp.4 termios.4 \
+	tty.4 tp.4 udp.4 unix.4 vnd.4
 MLINKS+=fd.4 stderr.4 fd.4 stdin.4 fd.4 stdout.4
 MLINKS+=netintro.4 networking.4
 MLINKS+=rnd.4 srnd.4 rnd.4 urnd.4 rnd.4 prnd.4
diff --git a/share/man/man4/ahc.4 b/share/man/man4/ahc.4
new file mode 100644
index 00000000000..3731302bcf0
--- /dev/null
+++ b/share/man/man4/ahc.4
@@ -0,0 +1,177 @@
+.\"	$NetBSD: ahc.4,v 1.1 1996/07/10 22:58:35 explorer Exp $
+.\"
+.\" Copyright (c) 1995, 1996 
+.\" 	Justin T. Gibbs.  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 the author may not be used to endorse or promote products
+.\"    derived from this software withough specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 THE AUTHOR 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 April 20, 1996
+.Dt AHC 4 i386
+.Os FreeBSD
+.Sh NAME
+.Nm ahc
+.Nd Adaptec VL/EISA/PCI SCSI host adapter driver
+.Sh SYNOPSIS
+.ie 0 \{
+For one or more VL/EISA cards:
+.Cd controller eisa0
+.Cd controller ahc0
+\}
+\{For VL cards:
+.Cd ahc*	at eisa? slot ?
+.Cd options	AHA284X_HACK
+.Pp
+For EISA cards:
+.Cd ahc*	at eisa? slot ?\}
+.Pp
+.ie 0 \{
+For one or more PCI cards:
+.Cd controller pci0
+.Cd controller ahc0
+\}
+\{For PCI cards:
+.Cd ahc*	at pci? dev ? function ?\}
+.Pp
+To enable tagged queueing:
+.Cd options AHC_TAGENABLE
+.Pp
+To enable SCB paging:
+.Cd options AHC_SCBPAGING_ENABLE
+.Pp
+.ie 0 \{
+For one or more SCSI busses:
+.Cd controller scbus0 at ahc0
+\}
+\{For SCSI busses:
+.Cd scsibus* at ahc?\}
+.Sh DESCRIPTION
+This driver provides access to the
+.Tn SCSI
+bus connected to an Adaptec 
+274x, 284x, 2940, 3940, or controllers based on the
+.Tn AIC7770,
+.Tn AIC7850,
+.Tn AIC7860,
+.Tn AIC7870,
+or
+.Tn AIC7880
+host adapter chips.
+Features include support for twin and wide busses,
+ultra
+.Tn SCSI,
+two active commands at a time per non-tagged queueing target,
+tagged queuing,
+and SCB paging which allows up to 255 active commands on all adapters
+except those using 
+.Tn AIC7770
+chips prior to revision E.
+Tagged queueing is enabled with the
+.Dq Dv AHC_TAGENABLE
+configuration option.
+SCB paging is enabled with the
+.Dq Dv AHC_SCBPAGING_ENABLE
+configuration option.
+.Pp
+Per target configuration performed in the 
+.Tn SCSI-Select
+menu, accesible at boot
+in 
+.No non- Ns Tn EISA
+models or through an 
+.Tn EISA
+configuration utility for 
+.Tn EISA
+models,
+is honored by this driver with the stipulation that the 
+.Tn BIOS
+must be enabled for 
+.Tn EISA
+adaptors.  This includes synchronous/asynchronous transfers,
+maximum synchronous negotiation rate,
+disconnection,
+and the host adapter's SCSI ID.
+.Pp
+Note that I/O addresses are determined automatically by the probe routines,
+but care should be taken when using a 284x
+.Pq Tn VESA No local bus controller
+in an
+.Tn EISA 
+system.  Ensure that the jumpers setting the I/O area for the 284x match the 
+.Tn EISA
+slot into which the card is inserted to prevent conflicts with other
+.Tn EISA
+cards.
+.Sh BUGS
+Some Quantum drives (at least the Empire 2100 and 1080s) will not run on an
+.Tn AIC7870
+Rev B in synchronous mode at 10MHz.  Controllers with this problem have a
+42 MHz clock crystal on them and run slightly above 10MHz, causing the
+drive much confusion.  Setting a maximum synchronous negotiation rate of 8MHz
+in the 
+.Tn SCSI-Select
+utility
+will allow normal function.
+.Sh SEE ALSO
+.Xr aha 4 ,
+.Xr ahb 4
+.if 0 \{
+.Xr cd 4 ,
+.Xr scsi 4 ,
+.Xr sd 4 ,
+.Xr st 4
+\}
+.Sh AUTHOR
+The
+.Nm
+driver was written by Justin Gibbs.  The
+.Tn AIC7xxx
+sequencer-code assembler was
+written by John Aycock.
+.if 1 \{NetBSD porting is done by Stefan Grefen, Charles M. Hannum,
+Michael Graff, Pete Bentley and Noriyuki Soda.
+.Sh BUGS
+There are four problems known in NetBSD version of this driver.
+All of these problems relate to NetBSD MI SCSI system.
+.Pp
+Cannot handle SCSI ID greater than 7 with WIDE SCSI adapter.
+.Pp
+It is dangerous to use SCSI devices more than half of SCBs.
+For example, AHA-274x and AHA-284x have only 4 SCBs, so that using 3 SCSI
+devices is dangerous, using 2 devices is OK.
+.Pp
+There is possibility of causing "Can't malloc SCB" error.
+.Pp
+SCSI residual handling is not complete.
+\}
+.Sh HISTORY
+The
+.Nm
+driver appeared in
+.Tn FreeBSD
+2.1
+.if 1 \{and 
+.Tn NetBSD
+1.1.
+\}
+
diff --git a/share/man/man4/man4.sparc/le.4 b/share/man/man4/man4.sparc/le.4
index 78aa51f7327..00825315c15 100644
--- a/share/man/man4/man4.sparc/le.4
+++ b/share/man/man4/man4.sparc/le.4
@@ -35,7 +35,7 @@
 .\"
 .\"	from: Header: le.4,v 1.2 92/10/13 05:31:33 leres Exp
 .\"	from: @(#)le.4	8.1 (Berkeley) 6/9/93
-.\"	$Id: le.4,v 1.2 1996/05/02 01:24:31 deraadt Exp $
+.\"	$Id: le.4,v 1.3 1996/07/27 10:50:09 deraadt Exp $
 .\"
 .Dd June 9, 1993
 .Dt LE 4 sparc
@@ -74,18 +74,19 @@ Standard 15 pin connector
 UTP, also known as twisted pair
 .El
 .Pp
-The default port to use is selected at boot time; if there is link on the UTP
-port, then the UTP interface is selected, otherwise the active connector
-defaults to AUI. To choose an alternate port,
-use the following flag
+The system will not automatically select the correct port unless the kernel
+was loaded via the network. Thus one of the following flags should be used
+with
 .Xr ifconfig 8
-or in your /etc/hostname.le? file.
+or in your /etc/hostname.le? file:
 .Pp
 .Bl -tag -width xxxxxxxxxxxxxxxxxxxx
 .It link0
 Use the UTP port.
-.It -link0
+.It link1
 Use the AUI port.
+.It -link0 -link1
+Use the existing port selection (useful only for network booting).
 .El
 .Pp
 .Sh SEE ALSO
diff --git a/share/man/man4/strip.4 b/share/man/man4/strip.4
new file mode 100644
index 00000000000..b4b267ceb45
--- /dev/null
+++ b/share/man/man4/strip.4
@@ -0,0 +1,190 @@
+.\" Copyright 1996 The Board of Trustees of The Leland Stanford
+.\" Junior University. All Rights Reserved.
+.\"
+.\" Author: Jonathan Stone
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice and the above authorship notice appear in all copies.
+.\" Stanford University makes no representations about the suitability
+.\" of this software for any purpose.  It is provided "as is" without
+.\" express or implied warranty.
+.Dd March 10, 1996
+.Dt STRIP 4
+.Os NetBSD 1.1
+.Sh NAME
+.Nm strip
+.\" Why doesn't this work right?  mdoc(7) nor mdoc.samples(7) lists
+.\" .Nd, except for a passing reference in the latter.
+.Nd packet-mode network device driver for the Metricom Ricochet radio
+.Sh SYNOPSIS
+.\" want to write
+.\" .Sy pseudo-device
+.\" .Nm tun
+.\" .Op Ar count
+.\" so that .Nm is just "tun", but if we do that we get a line break
+.\" after "pseudo-device", ick.
+.Nm pseudo-device strip
+.Op Ar count
+.Sh DESCRIPTION
+Configures
+.Ar count
+.Nm strip
+interfaces,   named
+.Sy st Ns Ar 0 ,
+.Sy st Ns Ar 1 ,
+etc, into a kernel built from a config file containing the
+given entry.
+.Pp
+Each
+.Nm strip
+interface is a pseudo-device driver for the Metricom Ricochet radio,
+operating in peer-to-peer packet mode.
+.Pp
+The STRIP  driver takes outbound network packets, encapsulates them using the
+Metricom "starmode" framing, and sends the packets out an RS-232
+interface to a Metricom
+.Em Ricochet
+radio.   Packets arriving from the radio
+via the serial link are decapsulated and then passed up to the local
+host's networking stack.
+.Pp
+.Nm STRIP
+is an acronym for
+.Sy St Ns armode
+.Sy  R  Ns adio
+.Sy IP.
+.Pp
+In many ways,
+the
+.Nm strip
+driver is very much like the
+.Nm sl
+SLIP pseudo-device driver.  A
+.Nm strip
+device is attached to a tty line with
+.Xr slattach 8 .
+Once attached, the interface is configured via
+.Xr ifconfig 8 .
+The major difference between the
+.Xr sl 4
+SLIP pseudo-device driver and the
+.Nm strip
+driver is that SLIP works only between two hosts over
+a dedicated point-to-point connection. In contrast,
+.Nm strip
+sends
+packets to a frequency-hopping radio, which  can address packets to
+any peer Metricom radio. rather than just to a single host at the
+other end of a point-to-point line.  Thus,  one
+.Nm strip
+pseudo-device is usually sufficient for any kernel.
+.Pp
+In other respects, a
+.Nm strip
+interface is rather like an Ethernet interface.
+Packets are  individually  addressed, and subsequent packets can
+be sent independently to different MAC addresses.  However,
+the "Star-mode" framing and MAC addressing are not in any way
+compatible with Ethernet.  Broadcast or multicast to more than one radio is not
+possible, due to the independent frequency-hopping operation of the radios.
+The interface flags 
+.Dv IFF_POINTOPOINT
+and
+.Dv IFF_BROADCAST
+are not supported on
+.Nm strip
+interface.
+.Pp
+In other words,
+.Nm strip
+implements a multiple-access, non-broadcast device, accessed via
+an RS-232 serial line, using a proprietary packet framing scheme. 
+.Pp
+This version
+.Nm strip
+driver maps IP addresses to Metricom radio addresses using
+statically configured entries in the normal routing table. These entries
+map IP addresses of peer radios to the MAC-level addresses.
+The exact syntax of this mapping and an example are discussed below.
+The Internet Assigned Numbers Authority (IANA) has allocated an ARP
+type code for use with STRIP. A future version of this driver will
+support 
+.Xr arp 4
+to obtain the IP address of reachable peer radios dynamically.
+.Pp
+.Sh Address configuration.
+This version of the STRIP driver requires static pre-configuration of
+the mapping from IP addresses to radio MAC addresses.
+The 
+.Xr route 8
+command should be used to bind a peer STRIP host's radio IP address
+to the peer's  link-level radio address.   Radio addresses are encoded
+using the hex equivalent of the radio's decimal ASCII address.
+For example, the following route command will
+configure a routing entry to a radio with a MAC address of 1234-5678,
+and an IP address 10.11.12.13:
+.Pp
+.br
+.in 10
+route add -host 10.11.12.13 -link 1:2:3:4:5:6:7:8
+.br
+.in 5
+.Pp
+Generalising from this example to other IP addresses and to other 8-digit MAC addreses
+should be clear.
+.Pp
+.Sh Radio configuration.
+The Metricom radios can auto-baud at speeds up to 38.4k baud.
+At higher speeds -- 57600 or 115200 -- the radio cannot autobaud.
+When running at  high speeds, the radio's serial port should be
+manually configured to permanently run at the desired speed.
+Use a terminal emulator and the Hayes command
+.Em ATS304=115200
+to set the serial baudrate to the specified number (or 0 for autobaud).  The command
+.Em AT&w
+will then save the current radio  state in non-volatile memory.
+.Pp
+Metricom radios can operate in either "modem-emulation" mode
+or in packet mode (Starmode). The
+.Nm strip
+driver automatically detects if the radio has fallen out of starmode,
+and resets it back into starmode, if the baud rate was set correctly
+by
+.Xr slattach 8 .
+.Pp
+.\" Why isn't .Ss documented in mdoc(7) and mdoc.samples(7)?
+.\" .Sh DIAGNOSTICS
+.Pp
+.Sh SEE ALSO
+.Xr inet 4 ,
+.Xr arp 4 ,
+.Xr route 8 .
+.Xr slip 4 ,
+.Xr slattach 8 ,
+.Sh BUGS
+Currently is IP-only.  Encapsulations for AppleTalk and ARP have been defined,
+but are not yet implemented in this driver.
+.Pp
+.Nm Strip
+has not been widely tested on a variety of lower-level tty drivers.
+.P
+The detection and resetting of radios that crash out of Starmode does
+not always work in this version of the driver.  One workaround
+is to kill the 
+.Xr slattach
+process, ifconfig the
+.Nm strip
+interface down, and then starti a new slattach and rerun ifconfig.
+.Sh HISTORY
+.Nm Strip
+was originally developed  for the Linux kernel by Stuart
+Cheshire of  Stanford's Operating Systems and Networking group,
+as part of Mary Baker's  MosquitoNet 
+.Sy http://mosquitonet.stanford.edu/mosquitonet.html
+project.
+This
+.Nm strip
+driver was ported to BSD by Jonathan Stone at Stanford's Distributed
+Systems Group and first distributed with NetBSD 1.2.