From bbb456e33ce36c963c32a95dfe5035dbe48d2e05 Mon Sep 17 00:00:00 2001 From: Theo de Raadt Date: Sat, 27 Jul 1996 10:50:10 +0000 Subject: +ahc, +strip --- share/man/man4/Makefile | 12 +-- share/man/man4/ahc.4 | 177 ++++++++++++++++++++++++++++++++++++++ share/man/man4/man4.sparc/le.4 | 15 ++-- share/man/man4/strip.4 | 190 +++++++++++++++++++++++++++++++++++++++++ 4 files changed, 381 insertions(+), 13 deletions(-) create mode 100644 share/man/man4/ahc.4 create mode 100644 share/man/man4/strip.4 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. -- cgit v1.2.3