3 files changed, 263 insertions, 0 deletions

diff --git a/share/man/man4/man4.i386/sb.4 b/share/man/man4/man4.i386/sb.4
new file mode 100644
index 000000000000..e6cda477118f
--- /dev/null
+++ b/share/man/man4/man4.i386/sb.4
@@ -0,0 +1,73 @@
+.\" Man page for the SoundBlaster driver
+.\"
+.\" Copyright (c) 1997, Alex Zepeda.
+.\"
+.\" This documentation is public domain, and is provided without warranty.
+.\" Alex Zepeda, the "author" of this page is not resposible for any
+.\" consequences of any sort of manipulation of this document.
+.\" 
+.\" SoundBlaster and any phrases including it's name are copyright
+.\" Creative Labs, not me.
+.\" 
+.\" alex!@bigfoot.com
+.\"
+.Dd August 9, 1997
+.Dt SB 4 i386
+.Os FreeBSD
+.Sh NAME
+.Nm sb
+.Nd Creative Labs Sound Blaster and compatable device driver
+.Sh SYNOPSIS
+For all sound cards supported with the sb driver this is needed:
+.Cd controller snd0
+.Pp
+For the SoundBlaster, SB Pro, SoundBlaster16, or the Pro Audio Spectrum
+  (emulating SB):
+.Cd "device sb0 at isa? port 0x220 irq 7 drq 1 vector sbintr"
+.Pp
+For specific SB16 support:
+.Cd "device sbxvi0 at isa? drq 5"
+.Pp
+For SoundBlaster 16 16 bit MIDI support:
+.Cd "device sbmidi0 at isa? port 0x300"
+.Pp
+To add Jazz16 suport:
+.Cd "options JAZZ16"
+.Pp
+To add support for the Logitech SoundMan Games:
+.Cd "options SM_GAMES"
+.Pp
+To add SG NX Pro mixer support:
+.Cd "options __SGNXPRO__"
+.Pp
+The OPL-2/3 is used in the SoundBlaster, SoundBlaster Pro, SB 16, and the
+Pro Audio Spectrum. For Yamaha OPL-2/OPL-3 FM support:
+.Cd "device opl0  at isa? port 0x388"
+.Sh DESCRIPTION
+This driver covers the SoundBlaster family of cards including the
+SoundBlaster 1.0 to the SoundBlaster 16/SoundBlaster 32.  The awe driver
+provides AWE32/64 functionality.  This driver is provied in FreeBSD
+versions 2.0-current through 3.0-current.  You can also configure more
+then one card on a single DMA using the conflicts keyword in your
+configuration file.  This is useful for boards with more then one type of
+emulation.
+.Sh BUGS
+Since the SB16 uses the same IRQ and addresses for
+the different drivers, some of the snd drivers will not be probed because
+the kernel thinks there is a conflict.  This can be worked-around by
+using the "conflicts" keyword on the sb16's device line.
+.Pp
+Current version doesn't support mode changes without closing and reopening
+the device. Support for this feature may be implemented in a future
+version of this driver.
+.Sh SEE ALSO
+cdcontrol(1),  cdplay(1),  mixer(8)
+.Sh AUTHORS
+The original SoundBlaster DSP and SoundBlaster 16 MIDI, and Yamaha OPL-3  
+drivers were written by Hannu Savolainen.  The SoundBlaster 16 DSP code
+was written by J. Schuber (jsb@sth.ruhr-uni-bochum.de).  Improvments to
+the OPL-3 drivers were made by Rob Hooft (hooft@chem.ruu.nl)
+.Sh HISTORY
+Sound Galaxy NX Pro support added by Hunyue Yau (Jan 6 1994).  MV
+ProSonic/Jazz 16 16bit support added by JRA Gibson (April 1995).  Audio
+Excel DSP 16 support added by Riccardo Facchetti (March 24 1995).
diff --git a/share/man/man4/man4.i386/wl.4 b/share/man/man4/man4.i386/wl.4
new file mode 100644
index 000000000000..114ef0f588f7
--- /dev/null
+++ b/share/man/man4/man4.i386/wl.4
@@ -0,0 +1,147 @@
+.\"
+.\" Copyright (c) 1997, Jim Binkley
+.\" 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. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"	This product includes software developed by Jim Binkley
+.\" 4. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``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 OR CONTRIBUTORS 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.
+.\"
+.\" $Id$
+.Dd July 7, 1997
+.Dt WL 4 i386
+.Os FreeBSD
+.Sh NAME
+.Nm wl
+.Nd T1 speed ISA/radio lan card
+.Sh SYNOPSIS
+.Cd "device wl0 at isa? port 0x300 net irq 5 vector wlintr"
+.Sh DESCRIPTION
+The
+.Nm wl
+driver controls a radio lan card system made originally by
+NCR, then ATT, now Lucent.  The system is spread-spectrum radio
+at around 915 mhz (or 2.4 ghz).  With the supplied omni-directional antennae,
+about 400 feet (indoors, more outdoors) can be covered in circumference.
+This card can talk to the companion (wlp0) pccard.  Speeds vary
+from 1 megabit to theoretically 2 megabits (roughly T1 in speed).
+.Pp
+The card has 3 fundmental hardware 
+units, a so-called PSA or programmable storage area, a radio modem,
+and a ethernet lan controller.  The latter component is the 
+ancient (and not very honorable) Intel 82586 ethernet chip.
+Fundamentally it appears to the operating system as an ethernet system,
+and speaks IEEE MAC addresses.  The radio modem simply translates
+ethernet packets to/from radio packets, that are either at 2.4 Ghz
+or 915 mhz depending on the radio modem.  It supports a collision
+avoidance scheme.  The lan controller
+supports promiscuous mode, broadcast, and multicasting 
+(although there is a glitch
+in the latter).  "It thinks it is ethernet".  
+.Pp 
+How it is used
+depends on the kind of antennae deployed with it.  Point to point
+applications are possible as are ethernet-like lan use.  The vendor
+ships an omni-directional antennae that works in the 
+vicinity of 400 feet (indoors).
+Point to point antennae can be purchased that will go miles.
+.Sh SETUP
+The card can either be initialized with the vendor supplied DOS setup software.
+Typically minimally an IRQ, port, and Network ID must be supplied.
+Michael Smith's 
+.Nm wlconfig(8) 
+utility can now be used to do this work from
+the UNIX side.  The card is "not" plug and play.
+The network id controls whether one set of cards can hear another.
+If different, cards will read physical packets, but they will be discarded
+by the radio modem.
+.Sh CONTROL
+In addition to the config utility, there are several sysctl
+switches that can be used to modify runtime parameters.
+The 
+.Nm sysctl(8) 
+variables are as follows:
+.Bl -diag
+.It "machdep.wl_xmit_delay <useconds>"
+This variable will cause the driver to insert a delay on transmit.
+250 is the default.  The delay should probably be a bit longer
+on faster cpus and less on slower cpus.  It exists because the 82586
+was not designed to work with pentium-speed cpu systems and if overdriven
+will have copious xmit side errors.
+.It machdep.wl_ignore_nwid <0 | 1>
+This switch defaults to 0; i.e., the nwid is not ignored.  It can
+be set to 1 to cause the nwid to not be used.  This may be useful
+when the device is in promiscuous mode as one can watch for all
+packets and ignore nwid differences.
+.It machdep.wl_xmit_watch <milliseconds> 
+This switch is not currently useful.
+.It machdep.wl_gather_snr <milliseconds> 
+This switch is not currently useful.
+.Pp
+There is also a signal strength cache in the driver.  It may be interrogated
+with
+.Nm wlconfig(8) .
+Incoming packets
+are checked for certain hardware radio-modem values including signal
+strength, silence, and quality, which range fro 0..63, 0..63, and 0..15
+respectively.  Thus one can read out signal strenth values to see 
+how close/far peer nodes are.  The signal strength cache is indexed by 
+sender MAC address.
+There are two sysctls that change how it filters packets.  Both are on
+by default.
+.It machdep.wl_wlcache_mcastonly <0 | 1> 
+By default this switch is on. It forces the cache to filter out
+unicast packets.  Only broadcast or multicast packets are accepted.
+.It machdep.wl_wlcache_iponly <0 | 1>
+By default this switch is on.  It forces the driver to discard non-IP
+packets and also stores the IP src address.  ARP packets are ignored,
+as are any other network protocol barring IPv4 packets.
+.El
+.Sh CAVEATS
+The 82586 has numerous defects.  It may experience transmit-side
+errors when modern faster cpus send packets at it faster than it can handle.
+The driver (and probably the chip) does not support an all multicast mode.
+As a result, it can be used with applications like mrouted(8), but
+it must go into promiscuous mode for that to work.  The driver
+is slow to change modes from "normal" to promiscuous mode, presumably
+due to delays in the configuration code.
+.Sh SEE ALSO
+.Xr wlconfig 8 ,
+.Xr sysctl 8 ,
+.Xr http://www.wavelan.com
+.Sh HISTORY
+The
+.Nm wl
+driver was written by Anders Klemets (thousands of years ago?) and
+appears to be based on an even older Intel 82586 driver.  The 82586
+controller was one of the first (if not the first?) integrated lan
+controller on the block.  That does not mean it was the best either.
+Anders ported and or created a driver for the ISA wavelan and PCCARD
+wavelan system too (wlp).  Robert T. Morris, Jr. ported the Mach
+drivers to BSDI.  Jim Binkley ported them to FreeBSD 2.1.  Michael
+Smith ported the wl driver only to 2.2.2.  Jim and Michael have been
+maintaining them.  The current state of the driver is NOT ANYONE'S
+FAULT.  Thanks to Bernie Doehner and Robert Buaas for contributions.
+.Sh AUTHOR
+Too numerous to mention.  See above.
diff --git a/share/skel/dot.shrc b/share/skel/dot.shrc
new file mode 100644
index 000000000000..57103fe49a2e
--- /dev/null
+++ b/share/skel/dot.shrc
@@ -0,0 +1,43 @@
+#	$Id: dot.profile,v 1.12 1997/07/15 09:37:02 charnier Exp $
+#
+# .shrc - bourne shell startup file 
+#
+# This file will be used if the shell is invoked for interactive use and
+# the environment variable ENV is set to this file.
+#
+# see also sh(1), environ(7).
+#
+
+
+# file permissions: rwxr-xr-x
+#
+# umask	022
+
+# Uncomment next line to enable the builtin emacs(1) command line editor
+# in sh(1), e.g. C-a -> beginning-of-line.
+# set -o emacs
+
+
+# some useful aliases
+alias h='fc -l'
+alias j=jobs
+alias m=$PAGER
+alias ll='ls -laFo'
+alias l='ls -l'
+alias g='egrep -i'
+ 
+# # be paranoid
+# alias cp='cp -ip'
+# alias mv='mv -i'
+# alias rm='rm -i'
+
+
+# # set prompt: ``username@hostname$ '' 
+# PS1="`whoami`@`hostname | sed 's/\..*//'`"
+# case `id -u` in
+# 	0) PS1="${PS1}# ";;
+# 	*) PS1="${PS1}$ ";;
+# esac
+
+# search path for cd(1)
+# CDPATH=.:$HOME