summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
Diffstat
-rw-r--r--share/FAQ/FreeBSD.FAQ991
-rw-r--r--share/FAQ/NFS.FAQ77
-rw-r--r--share/FAQ/Systems.FAQ266
-rw-r--r--share/FAQ/current-policy.FAQ162
-rw-r--r--share/FAQ/kernel-debug.FAQ33
-rw-r--r--share/FAQ/mailing-list.FAQ76
-rw-r--r--share/FAQ/ports-supfile7
-rw-r--r--share/FAQ/slip-dialup190
-rw-r--r--share/FAQ/standard-supfile14
-rw-r--r--share/FAQ/sup.FAQ94
10 files changed, 1910 insertions, 0 deletions
diff --git a/share/FAQ/FreeBSD.FAQ b/share/FAQ/FreeBSD.FAQ
new file mode 100644
index 0000000..30097fd
--- /dev/null
+++ b/share/FAQ/FreeBSD.FAQ
@@ -0,0 +1,991 @@
+
+ FreeBSD
+ Frequently Asked Questions
+ For Versions 1.1 and above
+
+Please mail all suggestions and additions to <FreeBSD-FAQ@freefall.cdrom.com>
+
+
+Revision: $Id: FreeBSD.FAQ,v 1.36 1994/06/28 15:33:58 jkh Exp $
+
+All entries are assumed to be relevant to both FreeBSD 1.1 and FreeBSD 1.1.5,
+unless otherwise noted.
+
+
+Table of Contents
+-----------------
+
+0 Preface
+1 Installation
+2 Hardware Compatibility
+3 Commercial applications
+4 User Applications
+5 Miscellaneous Questions
+6 Kernel Configuration
+7 System Administration
+8 Networking
+9 Serial Communications
+
+
+
+0 Preface
+---------
+
+Welcome to the FreeBSD 1.1 FAQ! This document tries to answer some of
+the most frequently asked questions about FreeBSD 1.1 (or later,
+unless specifically indicated). If there's something you're having
+trouble with and you just don't see it here, then please send mail to:
+
+ <FreeBSD-questions@freefall.cdrom.com>
+
+
+Some of the instructions here will also refer to auxiliary utilities
+in the /usr/src/contrib/FAQ directory. CDROM purchasers and net folks
+who've grabbed the FreeBSD 1.1 `srcdist' will have these files. If
+you don't have the source distribution, then you can either grab the
+whole thing from:
+
+ FreeBSD.cdrom.com:pub/FreeBSD/FreeBSD-1.1
+
+Or you can grab only those files you're interested in straight out of
+the FreeBSD-current distribution in:
+
+ FreeBSD.cdrom.com:pub/FreeBSD/FreeBSD-current/src
+
+0.1: What is FreeBSD?
+
+FreeBSD is a UN*X type operating system based on William Jolitz's port
+of U.C. Berkeley's Networking Release 2 to the i386, 386BSD. It is no
+longer correct to say that FreeBSD is only 386BSD with the patchkit
+applied! There have been many additions and bug fixes made throughout
+the entire system, some of the highlights of which are:
+
+ More robust and extensive PC device support
+ System V-style IPC, messaging and semaphores
+ Shared Libraries
+ Much improved virtual memory code
+ Better console driver support
+ Network booting (diskless) support
+ /proc filesystem
+ Yellow Pages support
+ `LDT' support for WINE (primitive but developing Windows emulation)
+ Too many additional utilities and applications to mention
+
+
+0.2: My friends told me that FreeBSD was illegal and I shouldn't use it.
+ Is this really true?
+
+FreeBSD versions up to and including 1.1 have included code from
+Berkeley's Net/2 distribution. UNIX Systems Laboratories (now Novell)
+sued Berkeley claiming that Net/2 included some code that belonged to
+USL. In February of 1994, USL and Berkeley announced a settlement in
+which neither side admitted to doing anything wrong, but UCB agreed to
+stop distributing the disputed software.
+
+Since Berkeley will no longer defend this code, we have been requested
+to stop distributing it, and will be integrating all the improvements
+we have made in the VM system and i386-specific code into Berkeley's
+4.4-Lite distribution; the result will form the basis of FreeBSD 2.0.
+We expect the integration to take place over a period of three to six
+months, during which time we will have to stop work on 1.1 and
+concentrate all our efforts on the merge, and we expect to make more
+information available on the status of the merge effort as the situation
+progresses.
+
+However, to answer the question, "No. FreeBSD is not illegal." We
+have been allowed by USL to distribute 1.1 as the last Net/2 derived
+version, after which we have committed to move to 4.4 as previously
+stated.
+
+We expect to make more information available on the status of the
+merge effort as the situation progresses.
+
+0.3: What are the FreeBSD mailing lists, and how can I get on them?
+
+The following mailing lists are provided for FreeBSD users and
+developers. For more information, send to
+<majordomo@freefall.cdrom.com> and include a single line saying
+``help'' in the body of your message.
+
+FreeBSD-announce: For announcements about or on FreeBSD.
+FreeBSD-hackers: Useful for persons wishing to work on the internals.
+FreeBSD-questions: General questions on FreeBSD.
+FreeBSD-bugs: Where bugs should be sent.
+FreeBSD-commit: This list carries the commit messages for freefall. Useful
+ for tracking ongoing work.
+FreeBSD-SCSI: Mailing list for SCSI developers.
+FreeBSD-current: This list is for persons wishing to run FreeBSD-current
+ and carries announcements and discussions on current.
+
+Please see also the FreeBSD mailing list FAQ in:
+
+ /usr/src/contrib/FAQ/OTHER-FAQS/FreeBSD.mailing-list.FAQ
+
+0.4: What are the various FreeBSD news groups?
+
+While there are no groups currently dedicated to FreeBSD, you may find
+the following groups useful.
+
+comp.os.386bsd.announce: For announcements
+comp.os.386bsd.apps: For applications
+comp.os.386bsd.questions: For questions
+comp.os.386bsd.development: For working on the internals
+comp.os.386bsd.bugs: About bugs
+comp.os.386bsd.misc: For items that don't fit anywhere else
+
+NOTE: These groups cover all the *BSDs (FreeBSD, NetBSD, 386BSD).
+
+
+
+1 Installation
+--------------
+
+1.1: I just installed my system and rebooted. Now I can't find the
+ extract or configure programs, where did they go?
+
+These two commands are just shell functions defined in /.profile. To
+get these back, boot FreeBSD with a `-s' at the boot prompt.
+
+
+1.2: I want to install FreeBSD onto a SCSI disk that has more than
+ 1024 cylinders. How do I do it?
+
+This depends. If you don't have DOS (or another operating system) on
+the system, you can just keep the drive in native mode and simply make
+sure that your root partition is below 1024 so the BIOS can boot the
+kernel from it. It you also have DOS/some other OS on the drive then
+your best bet is to find out what parameters that it thinks you have
+before installing FreeBSD. When FreeBSD's installation procedure
+prompts you for these values, you should then enter them rather than
+simply going with the defaults.
+
+There is a freely available utility distributed with FreeBSD called
+`pfdisk' (located in the tools/ subdirectory) which can be used for
+this purpose.
+
+
+1.3: When I boot FreeBSD it says ``Missing Operating System''.
+
+See question 1.2. This is classically a case of FreeBSD and DOS or
+some other OS conflicting over their ideas of disk geometry. You will
+have to reinstall FreeBSD, but obeying the instructions given above
+will almost always get you going.
+
+
+1.4: I have an IDE drive with lots of bad blocks on it and FreeBSD doesn't
+ seem to install properly.
+
+FreeBSD's bad block (bad144) handling is still not 100% (to put it
+charitably) and it must unfortunately be said that if you've got an
+IDE or ESDI drive with lots of bad blocks, then FreeBSD is probably
+not for you! That said, it does work on thousands of IDE based
+systems, so you'd do well to try it first before simply giving up.
+
+IDE drives are *supposed* to come with built-in bad-block remapping;
+if you have documentation for your drive, you may want to see if this
+feature has been disabled on your drive. However, ESDI, RLL, and
+ST-506 drives normally do not do this.
+
+<1.1.5>
+FreeBSD-current has better bad block handling due to improvments made
+to the wd driver.
+
+1.5: I have 32MB of memory, should I expect any special problems?
+
+If you have an IDE controller, no. Likewise, if you have a full EISA
+system with EISA disk controller or a working local bus controller
+(read further) you'll have no problems. If you have an ISA system, or
+an EISA system with an ISA disk controller then you will most
+certainly have problems with the upper 16MB of memory due to the ISA
+24 bit DMA limitation (which ISA cards in EISA systems will also
+exhibit). If you have a local bus disk controller, then you should be
+OK, UNLESS it's a Buslogic Bt445S with a revision less than `D' (BIOS
+3.36 or earlier).
+
+<1.1.5>
+1.1.5 has bounce-buffer support that make all of the above scenarios work
+with a full 32MB of memory or more. You are therefore advised to simply pull
+16MB of memory out, install, and then see about upgrading to FreeBSD 1.1.5
+so that you can put it back.
+
+
+1.6: Do I need to install the complete sources?
+
+In general, no. However, we would strongly recommend that you
+install, at a minimum, the `base' source kit, which includes several
+of the files mentioned here, and the `sys' (kernel) source kit, which
+includes sources for the kernel. There is nothing in the system which
+requires the presence of the sources to operate, however, except for
+the kernel-configuration program config(8). With the exception of the
+kernel sources, our build structure is set up so that you can
+read-only mount the sources from elsewhere via NFS and still be able
+to make new binaries. (Because of the kernel-source restriction, we
+recommend that you not mount this on /usr/src directly, but rather in
+some other location with appropriate symbolic links to duplicate the
+top-level structure of the source tree.)
+
+Having the sources on-line and knowing how to build a system with them
+will make it much easier for you to upgrade to future releases of
+FreeBSD.
+
+1.7: DES encryption software can not be exported from the United
+ States. If I live outside the US, how can I encrypt passwords?
+
+Since the DES encryption algorithm, which is used by passwd(1) and
+friends to encrypt passwords cannot legally be exported from the US,
+non-US users should not download this software from US FTP sites.
+
+There is however a replacement libcrypt available, based on sources
+written in Australia by David Burren. This code is now available on
+some non-US FreeBSD mirror sites. Sources for the unencumbered
+libcrypt, and binaries of the programs which use it, can be obtained
+from the following FTP sites:
+
+ South Africa: braae.ru.ac.za:/pub/FreeBSD/securedist/
+ owl.und.ac.za (currently uncertain)
+ Iceland: ftp.veda.is:/pub/crypt/FreeBSD/
+
+The non-US securedist can be used as a direct replacement for the
+encumbered US securedist. This securedist package is installed the
+same way as the US package (see installation notes for details). If
+you are going to install DES encryption, you should do so as soon as
+possible, before installing other software.
+
+Non-US users should please not download any encryption software from
+the USA. This can get the maintainers of the sites from which the
+software is downloaded into severe legal difficulties.
+
+A non-US distribution of Kerberos is also being developed, and current
+versions can generally be obtained by anonymous FTP from
+braae.ru.ac.za.
+
+There is also a mailing list for the discussion of non-US encryption
+software. For more information, send an email message with a single
+line saying ``help'' in the body of your message to
+<majordomo@braae.ru.ac.za>.
+
+1.8 HELP! My keyboard locked up during the install!
+
+Some keyboard controllers are not a friend to FreeBSD. Among these are
+those on certain models of Gateway, IBM and AST machines. The most frequent
+symptom encountered in such cases is that the keyboard refuses to respond
+to input when at the `kcopy>' prompt in the second phase of bootstrapping
+FreeBSD. Fortunately, there is a work-around that may get you all the
+way home. Reset the machine and boot the kcopy floppy again, but this
+time, as the kernel is booting, tap periodically on the num-lock key
+until the kcopy prompt appears. Your keyboard should respond properly.
+
+Once your system is on the hard disk the problem generally goes away.
+Some folks for whom the problem persists even after this stage find
+relief in switching to the SYSCONS console driver (see /sys/i386/conf/SYSCONS),
+which is in any case far more featureful than pccons and a recommended
+upgrade.
+
+
+
+2 Hardware compatibility
+------------------------
+
+2.1: What kind of hard drives does FreeBSD run on?
+
+FreeBSD supports ST-506 (sometimes called ``MFM''), RLL, and ESDI
+drives, which are usually connected to WD-1002, WD-1003, or WD-1006
+controllers (although clones should also work). FreeBSD also supports
+IDE and SCSI hard drives.
+
+2.2: What SCSI controllers are supported?
+
+FreeBSD supports the following SCSI controllers:
+
+Adaptec AH-1542 Series <ISA>
+ AH-1742 Series <EISA>
+Buslogic BT-445 Series <VLB> (but see section 1.5)
+ BT-545 Series <ISA>
+ BT-742 Series <EISA>
+ BT-747 Series <EISA>
+Future Domain TMC-8XX/950 Series <ISA> (1.1.5 ONLY)
+Seagate ST-01/02 Series <ISA> (1.1.5 ONLY)
+UltraStor UH-14f Series <ISA>
+ UH-34f Series <EISA/VLB>
+
+There is supposed to be a UltraStor 24f driver floating around, but
+we're not sure where (could someone please point us at it?).
+
+2.3: What CD-ROM drives are supported by FreeBSD?
+
+Any SCSI drive connected to a supported controller. Mitsumi
+LU002(8bit), LU005(16bit) and FX001D(16bit 2x Speed).
+
+FreeBSD does NOT support drives connected to a Sound Blaster or
+non-SCSI SONY or Panasonic drives. A general rule of thumb when
+selecting a CDROM drive for FreeBSD use is to buy a very standard SCSI
+model; they cost more, but deliver very solid performance in return.
+Do not be fooled by very cheap drives that, in turn, deliver VERY LOW
+performance! As always, you get what you pay for.
+
+The Mitsumi driver is known to be extremely slow compared to SCSI
+drives.
+
+
+2.4: What multi-port serial cards are supported by FreeBSD?
+
+AST/4 and BOCA 4/8/16 port cards. Some unnamed clone cards have also
+been known to work, especially those that claim to be AST compatible.
+Check the sio(4) man page to get more information on configuring such
+cards.
+
+
+2.5: Does FreeBSD support the AHA-2742 SCSI adapter from Adaptec?
+
+No, FreeBSD does not. This is due to Adaptec's unwillingness to
+supply programming information under other than non-disclosure. This
+is unfortunate, but there's nothing we can do about it.
+
+
+2.6: I have a Mumbleco bus mouse. Is it supported and if so, how do I set
+ it up for XFree86?
+
+FreeBSD supports the Logitech and ATI Inport bus mice. You need to
+add the following line to the kernel config file and recompile for the
+Logitech and ATI mice:
+
+ device mse0 at isa? port 0x23c tty irq6 vector mseintr
+
+
+2.7: I have a PS/2 mouse (`keyboard' mouse) [Alternatively: I have a
+ laptop with a track-ball mouse]. How do I use it?
+
+<1.1>: For the PS/2 mouse you need to look in
+/usr/src/contrib/FAQ/programs/psm, which is John Solhed's port of the
+Linux PS/2 mouse driver.
+
+Follow the directions in the package. You will also need to change
+your Xconfig file to point to the mouse.
+
+<1.1.5>: The PS/2 mouse is part of the system. See the psm0 driver
+description in /sys/doc/options.doc.
+
+
+2.8: What types of tape drives are supported under FreeBSD?
+
+FreeBSD supports SCSI, QIC-02 and QIC-40/80 (Floppy based) tape
+drives. This includes 8-mm (aka Exabyte) and DAT drives.
+
+
+2.9: What sound cards are supported by FreeBSD?
+
+FreeBSD supports the SoundBlaster, SoundBlaster Pro, Pro Audio
+Spectrum 16, AdLib and Gravis UltraSound sound cards. There is also
+limited support for MPU-401 and compatible MIDI cards. The
+SoundBlaster 16 and SoundBlaster 16 ASP cards are not yet supported.
+NOTE: This is only for sound! This driver does not support CD-ROMs,
+SCSI or joysticks on these cards.
+
+
+2.10: What network cards does FreeBSD support?
+
+There is support for the following cards:
+
+`ed' driver:
+ NE2000 and 1000
+ WD/SMC 8003, 8013 and Elite Ultra (8216)
+ 3Com 3c503
+ And clones of the above
+
+`ie' driver:
+ AT&T EN100/StarLAN 10
+
+`is' driver:
+ Isolan AT 4141-0
+ Isolink 4110
+
+`ep' driver:
+ 3com 3c509 (*)
+
+
+(*)The `ep' driver is known to have some problems; see the
+/usr/src/KNOWNBUGS file for more details.
+
+
+2.11: I have a 386/486sx/486SLC machine without a math co-processor.
+ Will this cause me any problems?
+
+Generally no, but there are circumstances where you will take a hit,
+either in performance or accuracy of the math emulation code (see
+section 4.1). In particular, drawing arcs in X will be VERY slow. It
+is highly recommended that you lay out the $50 or so for a math
+co-processor; it's well worth it. NOTE: Some math co-processors are
+better than others. It pains us to say it, but nobody ever got fired
+for buying Intel. Unless you're sure it works with FreeBSD, beware of
+clones.
+
+2.12: I am about to buy a new machine to run FreeBSD on and
+ want an idea of what other people are running. Is there list
+ of other systems anywhere?
+
+Yes. Please look at the file FAQ/OTHER-FAQS/Systems.FAQ. This file
+is a listing of hardware that people are running in their machines.
+Please note, this is a raw listing of equipment that other users
+have sent in.
+
+
+
+3 Commercial Applications
+-------------------------
+
+Note: This section is still very sparse, though we're hoping, of
+course, that companies will add to it! :) The FreeBSD group has no
+financial interest in any of the companies listed here but simply
+lists them as a public service (and feels that commercial interest in
+FreeBSD can have very positive effects on FreeBSD's long-term
+viability). We encourage commercial software vendors to send their
+entries here for inclusion.
+
+
+3.1: Where can I get Motif for FreeBSD?
+
+Sequoia International provides commercial quality Motif 1.2.3
+development kits for FreeBSD 1.1 (with full shared library support)
+under the product name of `SWiM'. Due to licensing restrictions from
+the OSF, and the fact that Sequoia needs to make a living, these are
+NOT FREE, but nonetheless quite reasonably priced in comparison to
+many other commercial Motif distributions. Send electronic mail to
+<info@seq.com> for further information.
+
+3.2: What about other commercial quality development systems for FreeBSD?
+
+ParcPlace Systems, Inc., who currently provides their excellent
+`Object Interface & Object Builder' GUI development environment free
+of charge to Linux users, is considering the the FreeBSD platform and
+will make their intentions known fairly shortly.
+
+
+
+4 User Applications
+-------------------
+
+4.1: I want to run X, how do I go about it?
+
+First, get the XFree86 distribution of X11R5 from XFree86.cdrom.com.
+The version you want for FreeBSD 1.1 and later is XFree86 2.1. Follow
+the instructions for installation carefully. You may then wish to read
+the documentation for the ConfigXF86 tool, which assists you in
+configuring XFree86 for your particular graphics card/mouse/etc.
+
+
+4.1: I've been trying to run ghostscript on a 386 (or 486sx) with no
+ math co-processor and I keep getting errors. What's up?
+
+<1.1>: The problem here is due to the current FreeBSD math-emulator. You
+need to pick up the sources to an alternate emulation package, which
+you may find in:
+
+ /usr/src/contrib/FAQ/programs/fpu-emu
+
+Follow the instructions supplied.
+
+This is a port of an older Linux math-emulator. At some point,
+FreeBSD's default math emulator will be good enough that you can
+forget about having to do this.
+
+<1.1.5>: For 1.1.5 you may add the following to your kernel config file and
+it will be compiled in.
+options GPL_MATH_EMULATE
+
+NOTE: You will need to remove the MATH_EMULATE option when you do this.
+
+
+4.2: If I want something like seyon, term, Kermit, emacs or any one of
+ hundreds of popular freeware utilities, is there a good place to
+ search through first?
+
+Yes, the FreeBSD `ports collection' was put together for just that
+purpose. It contains some of the most often requested languages,
+editors, mail and news reading programs, network software and many
+many megabytes of other types of useful goodies. CDROM people will
+probably have the ports collection already in /usr/ports, other folks
+can get at the latest snapshot of the entire collection in:
+
+ FreeBSD.cdrom.com:pub/FreeBSD/FreeBSD-current/ports
+
+Note that this FTP server permits getting entire directories as one
+(optionally gzipped or compressed) tar file. Read the FTP welcome
+banner carefully for details.
+
+
+4.3: I want all this neat software, but I haven't got the space or
+ CPU power to compile it all myself. Is there any way of getting
+ binaries?
+
+Yes. We support the concept of a `package', which is essentially a
+gzipped binary distribution with a little extra intelligence embedded
+in it for doing any custom installation work required. Packages can
+also be installed or deinstalled again easily without having to know
+the gory details. CDROM people will have a packages/ directory on
+their CD, others can get the currently available packages from:
+
+ FreeBSD.cdrom.com:pub/FreeBSD/packages-1.1
+
+Note that all ports may not be available as packages, and that new
+packages are constantly being added. It is always a good idea to
+check periodically to see which packages are available. A README file
+in the packages directory provides more details on the care and
+feeding of the package software, so no explicit details will be given
+here.
+
+4.4: I'm trying to get Perl to work properly, but I keep getting
+ errors about dbm failures when I test it. How can I fix this?
+
+The problem here is that the tests are written for an older version of
+the dbm code. There is nothing wrong with perl and the errors can
+be ignored.
+
+
+
+5 Miscellaneous Questions
+----------------
+
+5.1: I've heard of something called FreeBSD-current. How do I run it, and
+ where can I get more information?
+
+Read the file /usr/src/contrib/FAQ/OTHER-FAQS/FreeBSD.current.policy,
+it will tell you all you need to know.
+
+
+5.2: What is this thing called `sup', and how do I use it?
+
+SUP stands for Software Update Protocol, and was developed by CMU for
+keeping their development trees in sync. We use it to keep remote
+sites in sync with our central development sources.
+
+To use it, you need to have direct internet connectivity (not just
+mail or news). First, pick up the sup_bin.tgz package from:
+
+ FreeBSD.cdrom.com:pub/FreeBSD/packages
+
+Second, read the file /usr/src/contrib/FAQ/OTHER-FAQS/FreeBSD.sup.faq.
+
+This file describes how to setup sup on your machine. You may also
+want to look at /usr/src/contrib/FAQ/OTHER-FAQS/FreeBSD.*.supfile,
+which are a set of supfiles for supping from freefall.cdrom.com
+
+
+5.3: How do I create customized installation disks that I can give
+ out to other people at my site?
+
+The entire process of creating installation disks and source and
+binary archives is automated by various targets in
+/usr/src/etc/Makefile. The information there should be enough to get
+you started.
+
+5.4: How do I re-build my system without clobbering the existing
+ installed binaries?
+
+If you define the environment variable DESTDIR while running `make
+world' or `make install', the newly-created binaries will be deposited
+in a directory tree identical to the installed one, rooted at
+${DESTDIR}. Some random combination of shared libraries modifications
+and program rebuilds can cause this to fail in `make world', however.
+
+
+5.5: When my system booted, it told me that ``(bus speed defaulted)''.
+ What does that mean?
+
+The Adaptec 1542 SCSI host adapters allow the user to configure their
+bus access speed in software. Previous versions of the 1542 driver tried
+to determine the fastest usable speed and set the adapter to that. We
+found that this breaks some users' systems, so you now have to define
+the ``TUNE_1542''' kernel configuration option in order to have this
+take place. Using it on those systems where it works may make your
+disks run faster, but on those systems where it doesn't, your data could
+be corrupted.
+
+5.6: I would like to track changes to current and do not have net access.
+ Is there any way besides downloading the whole tree?
+
+Yes, Poul-Henning has set up a source tracking list. Please email
+majordomo@ref.tfs.com with a body of "get ctm-src-cur README" for
+futher information.
+
+5.7: How do I split up large binary files into smaller 240k files
+ like the distribution does?
+
+Newer BSD based systems have a "-b" option to split that allows them to
+split files on arbitary byte bondaries.
+
+Here is an example from /usr/src/Makefile.
+bin-tarball:
+ (cd ${DISTDIR}; \
+ tar cf - . \
+ gzip --no-name -9 -c | \
+ split -b 240640 - \
+ ${RELEASEDIR}/tarballs/bindist/bin_tgz.)
+
+5.8: I'm running Syscons and every morning my console locks up. What
+ is going on here?
+
+This sounds like the "kill -1 syslogd" problem. Make sure that the
+following is correct on your system.
+1. The attributes of the following nodes are correct.
+/dev/console
+crw------- 1 root 0, 0 May 23 15:32 /dev/console
+/dev/ttyv0
+crw------- 1 root 12, 0 May 23 15:32 /dev/ttyv0
+The part you are concerned with are the major and minor device numbers.
+
+2. Make sure that getty is running on ttyv0 and NOT console.
+
+3. If /dev/vga exists that it is a symlink to /dev/ttyv0.
+
+5.9: I've had a couple of system panics and would like to be able
+ browse the system dumps. The normal kernel is stripped and
+ I don't want to run a bloated kernel. What can I do?
+
+Please retrieve the file FAQ/OTHER-FAQS/FreeBSD.kdebug.FAQ. This
+file covers the instructions for looking at system dumps.
+
+
+6 Kernel Configuration
+----------------------
+
+6.1: When I compile a kernel with multi-port serial code, it tells me
+ that only the first port is probed and the rest skipped due to
+ interrupt conflicts. How do I fix this?
+
+The problem here is that FreeBSD has code built-in to keep the kernel
+from getting trashed due to hardware or software conflicts. The way
+to fix this is to leave out the IRQ settings on other ports besides
+the first. Here is a example:
+
+#
+# Multiport high-speed serial line - 16550 UARTS
+#
+device sio2 at isa? port 0x2a0 tty irq 5 flags 0x501 vector siointr
+device sio3 at isa? port 0x2a8 tty flags 0x501 vector siointr
+device sio4 at isa? port 0x2b0 tty flags 0x501 vector siointr
+device sio5 at isa? port 0x2b8 tty flags 0x501 vector siointr
+
+
+6.2: FreeBSD is supposed to come with support for QIC-40/80 drives but
+ when I look, I can't find it.
+
+You need to uncomment the following line in the generic config file
+(or add it to your config file) and recompile.
+
+controller fdc0 at isa? port "IO_FD1" bio irq 6 drq 2 vector fdintr
+disk fd0 at fdc0 drive 0
+disk fd1 at fdc0 drive 1
+#tape ft0 at fdc0 drive 2
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You will have a device called /dev/ft0, which you can write to through
+a special program to manage it called `ft' - see the man page on ft for
+further details. Versions previous to -current also had some trouble dealing
+wiht bad tape media; if you have trouble where ft seems to go back and forth
+over the same spot, try grabbing the latest version of ft from /usr/src/sbin/ft
+in current and try that.
+
+
+6.3: Does FreeBSD support IPC primitives like those in System V?
+
+Yes, FreeBSD supports System V-style IPC. This includes shared
+memory, messages and semaphores. You need to add the following lines
+to your kernel config to enable them.
+
+options SYSVSHM
+options "SHMMAXPGS=64" # 256Kb of sharable memory
+options SYSVSEM # enable for semaphores
+options SYSVMSG # enable for messaging
+
+Recompile and install.
+
+
+6.4: Are there any utilities that make configuring a kernel easier?
+
+Well, yes and no. Look in /sys/i386/doc/options.doc (/sys/doc on post
+1.1 systems) for a list of kernel options you can set, and what they
+do. For a friendlier front-end to the process, see
+/usr/src/contrib/configit
+
+
+6.5: Will FreeBSD ever support other architectures?
+
+Several different groups have expressed interest in working on
+multi-architecture support for FreeBSD. If you are interested in
+doing so, please contact the developers at
+<FreeBSD-hackers@freefall.cdrom.com> for more information on our
+strategy for porting.
+
+
+6.6: I just wrote a device driver for a Foobar Systems, Inc.
+ Integrated Adaptive Gronkulator card. How do I get the
+ appropriate major numbers assigned?
+
+This depends on whether or not you plan on making the driver publicly
+available. If you do, then please send us a copy of the driver source
+code, plus the appropriate modifications to files.i386, a sample
+configuration file entry, and the appropriate MAKEDEV code to create
+any special files your device uses. If you do not, or are unable to
+because of licensing restrictions, then character major number 32 and
+block major number 8 have been reserved specifically for this purpose;
+please use them. In any case, we'd appreciate hearing about your
+driver on <FreeBSD-hackers@freefall.cdrom.com>.
+
+6.7: I'm wanting to switch console drivers to Syscons. I changed my
+ kernel config file to run Syscons, but when I reboot the system
+ locks up! How do I fix it?
+
+There are four things that need to be done to properly install syscons
+on a system.
+1. Add the following line to your kernel config file while deleting the
+ line for pccons.
+device sc0 at isa? port "IO_KBD" tty irq 1 vector scintr
+(Note the changed vector 'scintr'. It is a common error to change the
+device name but NOT the vector.
+
+2. Add the following option to your config file.
+options "NCONS=6" # Change to reflect the number of consoles
+
+3. Modify /etc/ttys to enable gettys on ttyv0 - ttyv??. Here is an
+example line.
+ttyv0 "/usr/libexec/getty Pc" Pc3 on secure
+Please make sure that you have disabled the getty on /dev/console.
+
+4. Create the device nodes in /dev. This is done useing the MAKEDEV
+script located in that directory. Here is a command line that will create
+6 virtual consoles.
+MAKEDEV vty6
+If /dev/vga exists, it should now be a symlink to /dev/ttyv0.
+
+NOTE: If you are going to be running X, you will need an unused vty that
+ has no getty running on it.
+
+
+
+7 System Administration
+-----------------------
+
+7.1: How do I add a user easily? I read the man page and am more confused
+ than ever! [Alternatively: I didn't read the man page, I never read
+ man pages! :-) ]
+
+Look at Gary Clark's Perl package ``AddIt'', which may be found in
+/usr/src/contrib/adduser. This is a first attempt at solving the
+problem and may be replaced with a more complex but capable solution
+later.
+
+
+7.2: I'm trying to use my printer and keep running into problems. I tried
+ looking at /etc/printcap, but it's close to useless. Any ideas?
+
+Yes, you can pick up Andreas Klemm's apsfilter package from:
+
+ftp.germany.eu.net:pub/comp/i386/Linux/Local.EUnet/People/akl/apsfilter-1.11.gz
+
+This is a complete package for printing text, PS and DVI files. It
+requires ghostscript and dvips.
+
+If you are looking for a simple printcap just for PS and text files,
+try picking up the printcap01 sources in:
+
+ /usr/src/contrib/FAQ/code/printcap01
+
+NOTE: We're looking for printcap entries for all printers. If you
+have one, or a filter for one, please send it or mail us a pointer to
+<FreeBSD-FAQ@freefall.cdrom.com>. Thanks!
+
+7.3: Help! I've lost my root password! How do I log in now?
+ Alternatively: I botched something bad in my root partition
+ that keeps me from booting, how do I fix it!?
+
+Follow these steps:
+
+1. First off, you need to boot the system single-user: Do this by rebooting
+or resetting the machine, and when you come to the very first boot prompt
+(the one you probably generally just hit `return' at or wait for it to
+time-out) type:
+
+ 386bsd -s
+
+This will send the `-s' flag to init(1) telling it to not bring you up all
+the way into multi-user mode. The system should come up single-user and
+present you with a simple `#' prompt.
+
+2. Now is probably a good time to type `fsck' and make sure your filesystems
+are alright. If problems on your root filesystem are found and fixed, I would
+recommend hitting the reset switch again and going back to step 1. Your
+filesystems should all check fine the second time.
+
+3. At this point, your root filesystem is mounted *read only* for safety.
+If the problems you must fix are not on the root fs then I recommend that
+you simply leave it this way and fix the other problems. If you need to
+write to the root fs (fixing passwords requires this, for one thing) and
+you're using SCSI for your root fs then type:
+
+ mount -u /dev/sd0a /
+
+If you're using IDE/ESDI for your rootfs, then instead type:
+
+ mount -u /dev/wd0a /
+
+This will remount your root filesystem read/write and allow you to make
+your changes. Once you have done so, I recommend another reboot. -Jordan
+
+
+8 Networking
+------------
+
+8.1: Where can I get information booting FreeBSD `diskless', that is
+ booting and running a FreeBSD box from a server rather than having
+ a local disk?
+
+Please read /sys/i386/netboot/netboot.doc.
+
+
+8.2: I've heard that you can use a FreeBSD box as a dedicated network
+ router - is there any easy support for this?
+
+Internet standards and good engineering practice prohibit us from
+providing packet forwarding by default in FreeBSD. You can enable
+this support by adding `options GATEWAY' to your kernel configuration
+file and recompiling. In most cases, you will also need to run a
+routing process to tell other systems on your network about your
+router; FreeBSD comes with the standard BSD routing daemon routed(8),
+or for more complex situations you may want to try GateD (available by
+FTP from gated.Cornell.edu).
+
+It is our duty to warn you that, even when FreeBSD is configured in
+this way, it does not completely comply with the Internet standard
+requirements for routers; however, it comes close enough for ordinary
+usage.
+
+There is a standard `router floppy' that you can boot on a FreeBSD
+machine to configure it as a network router. Please look in:
+
+ freefall.cdrom.com:pub/incoming/freertr
+
+and follow the instructions.
+
+
+8.3: Does FreeBSD support SLIP and PPP?
+
+Yes. See the man pages for slattach(8) and/or pppd(8) if you're using
+FreeBSD to connect to another site. If you're using FreeBSD as a
+server for other machines, look at the man page for sliplogin(8).
+You may also want to take a look at the slip FAQ in:
+ FAQ/OTHER-FAQS/FreeBSD.slip.dialup.faq
+
+8.4: How do I set up NTP?
+
+NTP configuration is so complex and widely variable from site to site
+that it would be impossible to make a blanket statement here. Your
+best bet is to ask whoever's in charge of NTP at your site or network
+provider; chances are that they are running a similar version of NTP
+to the one that we provide, and they can probably provide you with the
+right configuration files to get things going.
+
+If you can't find anyone in charge, you should examine the files in
+/usr/src/contrib/xntpd/doc and see if they help any. If not, you
+could ask on the comp.protocols.time.ntp newsgroup, or the
+<ntp@ni.umd.edu> mailing-list.
+
+8.5: How do I get my network set up? I don't see how to make my
+ /dev/ed0 device!
+
+In the Berkeley networking framework, network interfaces are only
+directly accessible by kernel code. Please see the /etc/netstart file
+and the manual pages for the various network programs mentioned there
+for more information. If this leaves you totally confused, then you
+should pick up a book describing network administration on another
+BSD-related operating system; with few significant exceptions,
+administering networking on FreeBSD is basically the same as on SunOS
+4.0 or Ultrix.
+
+8.6: How do I get my 3C503 to use the other network port?
+
+Use `ifconfig ed0' to see whether the ALTPHYS flag is set, and then
+use either `ifconfig ed0 altphys' if it was off, or `ifconfig ed0
+-altphys' if it was on.
+
+8.7: I'm having problems with NFS to/from FreeBSD and my Wuffotronics
+ Workstation / generic NFS appliance, where should I look first?
+
+Certain PC network cards are better than others (to put it mildly) and
+can sometimes cause problems with network intensive applications like
+NFS. See /usr/src/contrib/FAQ/OTHER-FAQS/NFS for more information on this
+topic.
+
+8.8: I want to enable IP multicast support on my FreeBSD box, how do I do it?
+ [Alternatively: What the heck IS multicasting and what applications
+ make use of it?]
+
+First off, to you'll need to rebuild a kernel with multicast support in it.
+This requires that you have the sources to at least the kernel and the config
+utility. See /usr/src/sys/i386/conf/LINT for its comments on multicast; you'll
+need to set the MROUTING and MULTICAST options as shown there.
+
+Further reading/exploration for those interested in multicast:
+
+Product Description Where
+--------------- ----------------------- ---------------------------------------
+faq.txt Mbone FAQ ftp.isi.edu:/mbone/faq.txt
+imm/immserv IMage Multicast ftp.hawaii.edu:/paccom/imm.src.tar.Z
+ for jpg/gif images.
+nv Network Video. ftp.parc.xerox.com:
+ /pub/net-reseach/exp/nv3.3alpha.tar.Z
+vat LBL Visual Audio Tool. ftp.ee.lbl.gov:
+ /conferencing/vat/i386-vat.tar.Z
+wb LBL White Board. ftp.ee.lbl.gov:
+ /conferencing/wb/i386-wb.tar.Z
+mmcc MultiMedia Conference ftp.isi.edu:
+ Control program /confctrl/mmcc/mmcc-intel.tar.Z
+rtpqual Tools for testing the ftp.psc.edu:/pub/net_tools/rtpqual.c
+ quality of RTP packets.
+vat_nv_record Recording tools for vat ftp.sics.se:archive/vat_nv_record.tar.Z
+ and nv.
+
+[Many thanks to Jim Lowe for providing multicast support for FreeBSD, and this
+information]
+
+
+9 Serial Communications
+-----------------------
+
+9.1: When I do a set line in Kermit it locks up, what's the problem?
+
+The problem here is that FreeBSD thinks it's talking to a incoming
+modem connection, and is waiting for carrier to come up on it before
+completing the open. To disable modem control, do an:
+
+ stty -f /dev/ttyXX clocal
+
+(Where `ttyXX' is the tty port you're using). If you use a given port
+only for outgoing connections, you may wish to put this command in
+your /etc/rc.local to avoid having to do it every time you reboot your
+system.
+
+
+NOTE: Anyone wishing to submit a FAQ entry on how to get tip and cu working
+ would have it much appreciated! We all use Kermit over here! :-)
+
+-----------------------------------------------------------------------------
+If you see a problem with this FAQ, or wish to submit an entry, please
+mail us at <FreeBSD-FAQ@freefall.cdrom.com>. We appreciate your
+feedback, and cannot make this a better FAQ without your help!
+
+
+ FreeBSD Core Team
+
+-----------------------------------------------------------------------------
+
+ACKNOWLEDGMENTS:
+
+Gary Clark II - Our head FreeBSD FAQ maintenance man
+Jordan Hubbard - Janitorial services (I don't do windows)
+Garrett Wollman - Networking and formatting
+Robert Oliver, Jr. - Ideas and dumb questions (That made me think)
+Ollivier Robert - Invaluable feedback and contributions
+The FreeBSD Team - Kvetching, moaning, submitting data
+
+And to any others we've forgotten, apologies and heartfelt thanks!
+
diff --git a/share/FAQ/NFS.FAQ b/share/FAQ/NFS.FAQ
new file mode 100644
index 0000000..e6f7af8
--- /dev/null
+++ b/share/FAQ/NFS.FAQ
@@ -0,0 +1,77 @@
+FreeBSD and NFS [for a FAQ]
+
+Certain Ethernet adapters for ISA PC systems have limitations which
+can lead to serious network problems, particularly with NFS. This
+difficulty is not specific to FreeBSD, but FreeBSD systems are affected
+by it.
+
+The problem nearly always occurs when (FreeBSD) PC systems are networked
+with high-performance workstations, such as those made by Silicon Graphics,
+Inc., and Sun Microsystems, Inc. The NFS mount will work fine, and some
+operations may succeed, but suddenly the server will seem to become
+unresponsive to the client, even though requests to and from other systems
+continue to be processed. This happens to the client system, whether the
+client is the FreeBSD system or the workstation. On many systems, there is
+no way to shut down the client gracefully once this problem has manifested
+itself. The only solution is often to reset the client, because the NFS
+situation cannot be resolved.
+
+Though the "correct" solution is to get a higher performance and capacity
+Ethernet adapter for the FreeBSD system, there is a simple workaround that
+will allow satisfactory operation. If the FreeBSD system is the SERVER,
+include the option "wsize=1024" on the mount from the client. If the
+FreeBSD system is the CLIENT, then mount the NFS file system with the
+option "rsize=1024". These options may be specified using the fourth
+field of the fstab entry on the client for automatic mounts, or by using
+the "-o" parameter of the mount command for manual mounts.
+
+In the following examples, "fastws" is the host (interface) name of a
+high-performance workstation, and "freebox" is the host (interface) name of
+a FreeBSD system with a lower-performance Ethernet adapter. Also,
+"/sharedfs" will be the exported NFS filesystem (see "man exports"), and
+"/project" will be the mount point on the client for the exported file
+system. In all cases, note that additional options, such as "hard" or
+"soft" and "bg" may be desireable in your application.
+
+Examples for the FreeBSD system ("freebox") as the client:
+ in /etc/fstab on freebox:
+fastws:/sharedfs /project nfs rw,rsize=1024 0 0
+ as a manual mount command on freebox:
+mount -t nfs -o rsize=1024 fastws:/sharedfs /project
+
+Examples for the FreeBSD system as the server:
+ in /etc/fstab on fastws:
+freebox:/sharedfs /project nfs rw,wsize=1024 0 0
+ as a manual mount command on fastws:
+mount -t nfs -o wsize=1024 freebox:/sharedfs /project
+
+Nearly any 16-bit Ethernet adapter will allow operation without the above
+restrictions on the read or write size.
+
+For anyone who cares, here is what happens when the failure occurs, which
+also explains why it is unrecoverable. NFS typically works with a "block"
+size of 8k (though it may do fragments of smaller sizes). Since the maximum
+Ethernet packet is around 1500 bytes, the NFS "block" gets split into
+multiple Ethernet packets, even though it is still a single unit to the
+upper-level code, and must be received, assembled, and ACKNOWLEDGED as a
+unit. The high-performance workstations can pump out the packets which
+comprise the NFS unit one right after the other, just as close together as
+the standard allows. On the smaller, lower capacity cards, the later
+packets overrun the earlier packets of the same unit before they can be
+transferred to the host and the unit as a whole cannot be reconstructed or
+acknowledged. As a result, the workstation will time out and try again,
+but it will try again with the entire 8K unit, and the process will be
+repeated, ad infinitum.
+
+By keeping the unit size below the Ethernet packet size limitation, we
+ensure that any complete Ethernet packet received can be acknowledged
+individually, avoiding the deadlock situation.
+
+Overruns may still occur when a high-performance workstations is slamming
+data out to a PC system, but with the better cards, such overruns are
+not guarranteed on NFS "units". When an overrun occurs, the units affected
+will be retransmitted, and there will be a fair chance that they will be
+received, assembled, and acknowledged.
+--
+ John Lind, Starfire Consulting Services
+E-mail: john@starfire.MN.ORG USnail: PO Box 17247, Mpls MN 55417
diff --git a/share/FAQ/Systems.FAQ b/share/FAQ/Systems.FAQ
new file mode 100644
index 0000000..c2e3e2e
--- /dev/null
+++ b/share/FAQ/Systems.FAQ
@@ -0,0 +1,266 @@
+ Systems FAQ
+ For FreeBSD
+ Last Modified: $Id: Systems.FAQ,v 1.1 1994/06/11 17:59:19 gclarkii Exp $
+
+This FAQ is a list of systems that people have sent to the FAQ maintnance
+person for inclusion. If you have a system you would like to be included
+please send it to FreeBSD-FAQ@freefall.cdrom.com.
+
+Disclaimer: This document is composed of systems that people have sent to
+the FAQ maintnance person. It is the not to be taken as an endorsement
+for any system or manufacture.
+
+
+1.
+
+386DX/20 real AMI, ISA
+Oak SVGA (no X)
+8MB
+Adaptec 1542B, WD1007V ESDI
+Wren VI and Miniscribe 660MB 20Mbit/sec ESDI
+WD 8013EBT
+
+2.
+
+486DX/25 clone, AMI BIOS, ISA
+Orchid PCIII gas plasma (yes, VGA16)
+8MB
+Adaptec 1542B
+Micropolis 1684 SCSI
+SMC 8013EEWC
+
+3.
+
+ ??? OPTI chipset AMI BIOS 486/50 ISA
+ISA ET4000 w/ X11 (not so slow)
+16 Mb - 48 Mb swap
+ISA aha1542 B
+ISA no-name IDE w/ floppies
+FUJITSU M2623S-512 405MB set to SCSI2
+SEAGATE ST3283N 237MB SCSI2
+SANYO CRD-400I SCSI2 cdromcdrom
+
+4.
+
+Lipizzan LDO-1 486DX-33 motherboard
+Orchid ProIIs (1M) video
+8 MB memory
+Generic 2S/1P/2FD/IDE controller:
+Maxtor 7213 AT
+WDC AC2420H
+PAS-16 + Sony CDU31A CD drive (Fusion 16 package).
+ *** The CD drive does not currently work with FreeBSD.
+
+5.
+
+Asus VL/ISA-486SV2 (ISA-VLB as you can see)
+Orchid Fahrenheit 1280+ VLB (yes)
+20MB
+Some no-name IDE VLB controller
+Conner CP30504 (I think....the 540MB IDE one)
+Zoltrix 14.4/14.4 Fax/Modem on tty01
+Intel 486DX2/66 CPU + fan
+Conner CP30104 (120MB....for DOS)
+
+6.
+
+AIR 486El (running with AMD486/40)
+ATI Graphics Ultra Pro running XFree862.1
+16M
+Adaptec 1742
+Micropolis 2217
+Wangtec 6130FS DAT drive (Some problems)
+
+7.
+
+Compudyne 486 DX2/66
+ATI Local Bus GUP w/ 2megs
+16 Megs Memory
+504 IDE Hard Drive
+Colorado 250 meg QIC-80 tape drive
+
+8.
+
+American Megatrends Enterprise III, 486DX2-66
+ATI VLB Mach 32 (with X)
+16 meg
+Adaptec 1742 EISA SCSI with floppy
+Toshiba 5030 SCSI-II
+Toshiba 5157 SCSI-II
+SMC Elite16T ISA Ethernet (ISA)
+
+9.
+
+American Megatrends Enterprise III, 486DX
+ATI VLB Mach 32 (with X)
+32 meg
+Adaptec 1742 EISA SCSI with floppy
+Maxtor P0-12S SCSI
+Digital DSP5200S SCSI-II
+Pro Audio Spectrum 16
+Wonder Board, 4 serial (16550), 3 parallel, each on a different interrupt
+
+10.
+
+NoName 486DX/33, Intel Chipset, EISA-Bus
+ATI Graphics Ultra Pro EISA,
+17" Nanao (Eizo) F550-i Monitor
+Running the Mach32 X-Server XFree86-2.1.1 with fonts created from source.
+16 MB RAM (planning to add another 8 MB).
+AHA1742A
+Conner CP3100
+Fujitsu 520 MB
+Archive 525MB streamer tape.
+Gravis UltraSound - works for mod-files.
+
+11.
+
+ASUS SP3 PCI Board with i486 DX/2 66 MHz
+ISA ET4000 (I already tested a S3 805 PCI card successfully)
+Adaptec 1542B
+Toshiba XM3301TA CD-Rom
+CDC Harddisk, 572 MB (I don't know the exact specs)
+
+12.
+
+Mylex MAE486/33 EISA Motherboard
+16MB memory
+Actix GE32+ S3 801 gfx
+Adaptec 1742A controller
+Seagate ST3160 drive
+Seagate ST5120 drive
+Archive Viper 150MB tape
+Roland SCC-1 sound card
+Gravis Ultrasound card
+Longshine SMC/Novell compatable ethernet card
+
+13.
+
+Model: DECpc LPv 466d2
+Config: Local (Motherboard) S3 801 gfx, IDE controller, PS/2 mouse, 12MB memory
+
+14.
+
+
+??? 486/DX266 EISA/VLB Motherboard
+16MB memory
+#9 GXE L12 VLB 3MB graphics card
+Bt445S VLB disk controller
+DEC DSP3105S drive
+MAXSTOR P-17S drive
+Tandberg 525MB tape drive
+Toshiba XM3301 CDROM
+Soundblaster 2.0
+Longshine SMC/Novell compatable ethernet card
+
+15.
+
+M407 PC chips with 33Mhz 486.
+Had to disable external cache due to DMA problems. Board uses write-through
+cache unless a second chip is added to allow write-back.write-back.
+Orchid ProDesigner II (yes)
+16Mb
+IDE
+Maxtor 7213 AT and Maxtor 7120 AT
+2 BICC Isolans (Lance based cards)
+
+16.
+
+Gigabyte EISA/VLB motherboard with SIS chipset, AMI bios, 32 MB ram
+Adaptec 1742 SCSI 2 controller with floppy controller enabled
+Spea/V7 Mirage - S3/805 based localbus graphics card with 1 MB d-ram
+no name wd8013 compatible ethernet card
+Gravis Ultrasound card with 1 MB ram
+2 Fujitsu 400 MB and 1 Seagate 500 MB SCSI 2 harddisks
+5 1/4 + 3 1/2 inch floppy drives
+Tandberg TDC3600 60 MB + Tandberg TDC3800 525 MB Streamer (these don't work
+quite properly yet)
+
+17.
+
+i486DX33, 16 Mb RAM, 256 Kb external cache, VLB board
+no-name IDE/floppy controller
+Western Digital Caviar 2340 (325 Mb)
+Kalok KL-343 (40 Mb)
+Chips & Technologies 451 SuperVGA card (800x600, 16 colours, 256Kb)
+
+18.
+
+no name EISA i486DX/33 board, 16 MB RAM
+Adaptec AHA-1540*A* (not knowing if the current -current might cause
+ problems, my kernel is from end of march)
+Maxtor MXT-1240S, 1.2Gig very fast SCSI disk
+Seagate ST-1144A, just to boot off the beast (also has a messdos partition yet)
+Archive Viper 150 tape; has a firmware braindeadness when appending files,
+ works very well otherwise
+ELSA Winner 1000 ISA/EISA, 1MB VRAM, S3 86C928 (unfortunately, D-step chip)
+Nokia 447-B 17in monitor, running ~ 1100x800 resolution, very nice
+true `Mouse Systems' optical mouse, fine thing!
+sometimes a Toshiba XM-3301 CDROM, rather old, but solid & reliable
+
+19.
+
+older south-east Asia made notebook, i386SX/16, 5 MB RAM (where the 384 k hole
+ can be re-mapped, so all the 5 MB are useable)
+Seagate ST-9145AG, 120 MB 2.5in IDE disk, very low power consumption, but
+ rather slow transfer rate, only about 350 K/s, so paging is a mess
+640x480 LCD, ~ 16 gray tones distinguishable, Cirrus Logic CL-GD610/620
+ chipset; runs generic VGA-Mono and VGA-16 XFree86[tm] servers; needs
+ some hacks in rc.local to give full contrast when running with the
+ pcvt display driver (due to their different default attribute handling)
+
+
+20.
+
+Data General Dasher 386sx/16, 8 MB RAM
+Adaptec AHA-1542B
+Seagate ST-3655N, 525 MB SCSI disk
+Conner CP-3044, 40 MB IDE disk
+has been working with a Western Digital WD-1007V ESDI controller (on
+ secondary wdc address), and a Micropolis 1664-7 330 MB ESDI disk -
+ but this beast was terribly slow, loud (& unreliable) and therefore
+ had to go
+ET-3000 based 512 K VGA, slow (wrt. XFree86), but reliable
+3Com 3C503 Ethernet adaptor, suffers from the `do not nfs mount with
+ too large packets' problem, but works well otherwise
+`Mouse Systems' optical mouse
+Toshiba XM-3301 CDROM
+already ran with a Micropolis 1664-3 330 MB SCSI disk (same drive as
+ above, but different interface)
+already ran with an IBM 2Gig SCSI disk (don't remember the type)
+
+
+21.
+
+Mylex MNA 486/33 EISA Motherboard
+16Mb of Memory
+1.2 GB Toshiba 538 SCSI disk
+400Mb IBM SCSI disk
+150/250Mb Tandberg SCSI tape drive
+Toshiba 3401 SCSI CD-ROM
+Tseng 4000 Video Controller
+Logitech Bus Mouse
+Mediavision Pro Audio Stereo Sound Card
+Adaptech 1742A SCSI controller
+WD8013EBT Ethernet Card
+
+22.
+
+386DX-40 w/Cyrix math co-processor
+ET-4000 running X
+16MB
+IDE
+540MB Western Digital
+WD8003EP
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/share/FAQ/current-policy.FAQ b/share/FAQ/current-policy.FAQ
new file mode 100644
index 0000000..cdebbc7
--- /dev/null
+++ b/share/FAQ/current-policy.FAQ
@@ -0,0 +1,162 @@
+ THE FREEBSD CURRENT POLICY
+
+Last updated: $Date: 1994/05/07 11:39:26 $
+
+This document attempts to explain the rationale behind FreeBSD-current,
+what you should expect should you decide to run it, and states some
+prerequisites for making sure the process goes as smoothly as possible.
+
+
+1. What is FreeBSD-current?
+
+FreeBSD-current is, quite literally, nothing more than a daily snapshot of
+the working sources for FreeBSD. These include work in progress, experimental
+changes, and transitional mechanisms that may or may not be present in
+the next official release of the software. While many of us compile
+almost daily from FreeBSD-current sources, there are periods of time when
+the sources are literally uncompilable. These problems are generally resolved
+as expeditiously as possible, but whether or not FreeBSD-current sources bring
+disaster or greatly desired functionality can literally be a matter of which
+part of any given 24 hour period you grabbed them in! Please read on..
+
+Under certain circumstances we will sometimes make binaries for parts of
+FreeBSD-current available, but only because we're interested in getting
+something tested, not because we're in the business of providing binary
+releases of current. If we don't offer, please don't ask! It takes far
+too much time to do this as a general task.
+
+
+2. Who needs FreeBSD-current?
+
+FreeBSD-current is made generally available for 3 primary interest groups:
+
+ 1. Members of the FreeBSD group who are actively working on one
+ part or another of the source tree and for whom keeping `current'
+ is an absolute requirement.
+
+ 2. Members of the FreeBSD group who are active ALPHA/BETA testers
+ and willing to spend time working through problems in order to
+ ensure that FreeBSD-current remains as sane as possible. These
+ are also people who wish to make topical suggestions on changes
+ and the general direction of FreeBSD.
+
+ 3. Peripheral members of the FreeBSD (or some other) group who merely
+ wish to keep an eye on things and use the current sources for
+ reference purposes (e.g. for *reading*, not running). These
+ people also make the occasional comment or contribute code.
+
+
+3. What is FreeBSD-current _NOT_?
+
+ 1. A fast-track to getting pre-release bits because there's something
+ you heard was pretty cool in there and you want to be the first on
+ your block to have it.
+
+ 2. A quick way of getting bug fixes.
+
+ 3. In any way "officially supported" by us.
+
+ We do our best to help people genuinely in one of the 3
+ "legitimate" FreeBSD-current catagories, but we simply DO NOT
+ HAVE THE TIME to help every person who jumps into FreeBSD-current
+ with more enthusiasm than knowledge of how to deal with
+ experimental system software. This is not because we're mean and
+ nasty people who don't like helping people out (we wouldn't even be
+ doing FreeBSD if we were), it's literally because we can't answer
+ 400 messages a day AND actually work on FreeBSD! I'm sure if
+ given the choice between having us answer lots of questions or
+ continue to improve FreeBSD, most of you would vote for us
+ improving it (and so would we! :-).
+
+
+4. Ok. I still think I "qualify" for FreeBSD-current, so what do I do?
+
+ 1. Join the freebsd-hackers and freebsd-commit mailing lists.
+ This is not just a good idea, it's ESSENTIAL. If you aren't on
+ freebsd-hackers, you won't read the comments that people are
+ making about the current state of the system and thus will end
+ up stumbling over a lot of problems that others have already
+ found and solved. Even more importantly, you will miss out on
+ potentially critical information (e.g. "Yo, Everybody! Before you
+ rebuild /usr/src, you MUST rebuild the kernel or your system
+ will crash horribly!").
+
+ The freebsd-commit list will allow you to see the commit log
+ entry for each change as its made. This can also contain
+ important information, and will let you know what parts of the
+ system are being actively changed.
+
+ To join these lists, send mail to `majordomo@freefall.cdrom.com'
+ and say:
+
+ subscribe freebsd-hackers
+ subscribe freebsd-commit
+
+ In the body of your message. Optionally, you can also say `help'
+ and MajorDomo will send you full help on how to subscribe and
+ unsubscribe to the various other mailing lists we support.
+
+ 2. Grab the sources from freebsd.cdrom.com. You can do this in
+ two ways:
+
+ 1. Use the CMU `sup' program (Software Update Protocol).
+ This is the most recommended method, since it allows you
+ to grab the entire collection once and then only what's
+ changed from then on. Many people run sup from cron
+ and keep their sources up-to-date automatically.
+
+ To get a binary of the sup program for FreeBSD, as well
+ as the documentation and some sample configuration files,
+ look in:
+
+ freefall.cdrom.com:~ftp/pub/sup
+
+ 2. Use ftp. The source tree for FreeBSD-current is always
+ "exported" on:
+
+ freebsd.cdrom.com:~ftp/pub/FreeBSD/FreeBSD-current
+
+ We use `wu-ftpd' which allows compressed/tar'd grabbing
+ of whole trees. e.g. you see:
+
+ usr.bin/lex
+
+ You can do:
+
+ ftp> cd usr.bin
+ ftp> get lex.tar.Z
+
+ And it will get the whole directory for you as a compressed
+ tar file.
+
+ 3. If you're grabbing the sources to run, and not just look at,
+ then grab ALL of current, not just selected portions. The
+ reason for this is that various parts of the source depend on
+ updates elsewhere and trying to compile just a subset is almost
+ guaranteed to get you into trouble.
+
+ 4. Before compiling current, read the Makefile in /usr/src
+ carefully. You'll see one-time targets like `bootstrapld'
+ which *MUST* be run as part of the upgrading process. Reading
+ freebsd-hackers will keep you up-to-date on other bootstrapping
+ procedures that sometimes become necessary as we move towards
+ the next release.
+
+ 5. Be active! If you're running FreeBSD-current, we want to know
+ what you have to say about it, especially if you have suggestions
+ for enhancements or bug fixes. Suggestions with accompanying code
+ are received most enthusiastically! :-)
+
+
+Thank you for taking the time to read this all the way through. We're
+always very keen to remain "open" and share the fruits of our labor
+with the widest possible audience, but sharing development sources has
+always had certain pitfalls associated with it (which is why most
+commercial organizations won't even consider it) and I want to make
+sure that people at least come into this with their eyes open, and
+don't make the leap unless they're good at working without a net!
+
+ Jordan
+
+
+
diff --git a/share/FAQ/kernel-debug.FAQ b/share/FAQ/kernel-debug.FAQ
new file mode 100644
index 0000000..150fb8a
--- /dev/null
+++ b/share/FAQ/kernel-debug.FAQ
@@ -0,0 +1,33 @@
+ Kernel debugging FAQ
+ FreeBSD
+
+Last modified: $Id: FreeBSD.kdebug.FAQ,v 1.1 1994/06/12 15:12:21 gclarkii Exp $
+
+Here are some instructions for getting kernel debugging working on
+a crash dump, it assumes that you have enough swap space for a crash
+dump.
+
+*** Start ***
+
+Config you're kernel using config -g
+
+Remove ${STRIP} -x $@; from the Makefile for the kernel so it doesn't
+get stripped.
+
+When the kernel's been built make a copy of it, say 386BSD.debug, and
+then run strip -x on the original. Install the original as normal.
+
+Now, after a crash dump, go to /sys/compile/WHATEVER and run kgdb. From kgdb
+do:
+
+symbol-file 386BSD.debug
+exec-file /var/crash/system.0
+core-file /var/crash/ram.0
+
+and viola, you can debug the crash dump using the kernel sources just like
+you can for any other program.
+
+
+
+ Paul Richards, FreeBSD core team member.
+
diff --git a/share/FAQ/mailing-list.FAQ b/share/FAQ/mailing-list.FAQ
new file mode 100644
index 0000000..2c3a48c
--- /dev/null
+++ b/share/FAQ/mailing-list.FAQ
@@ -0,0 +1,76 @@
+ THE FREEBSD MAILING LIST FAQ
+
+Last updated: $Date: 1994/05/07 11:42:03 $
+
+Though many of the FreeBSD development members read USENET, we cannot
+always guarantee that we'll get to your questions in a timely fashion
+(or at all) if you post them only to one of the comp.os.386bsd.*
+groups. By addressing your questions to the appropriate mailing list
+you will reach both us and a concentrated FreeBSD audience, invariably
+assuring a better (or at least faster) response.
+
+The following is a summary of the mailing lists:
+
+List Purpose
+-----------------------------------------------------------------------------
+freebsd-admim Administrative issues (limited)
+freebsd-arch Architecture and design discussions (limited)
+freebsd-bugs Bug reports
+freebsd-hackers Technical discussions and suggestions
+freebsd-questions User questions
+freebsd-announce Important events / milestones
+freebsd-current Discussions about the use of FreeBSD-current
+freebsd-commit Commit messages to source repository
+freebsd-core FreeBSD core team (limited)
+-----------------------------------------------------------------------------
+
+Of all the lists, freebsd-arch, freebsd-admin and freebsd-core have closed
+memberships limited to a small subset of core team members and developers,
+though anyone is free to send suggestions and commentary to them. The other
+lists may be freely joined by the general public.
+
+All mailing lists live on `freefall.cdrom.com', so to post to a list you
+simply mail to `<listname>@freefall.cdrom.com'. It will then be redistributed
+to mailing list members throughout the world.
+
+To subscribe to a list, send mail to:
+
+ majordomo@freefall.cdrom.com
+
+And include the keyword
+
+ subscribe <listname> [<optional address>]
+
+In the body of your message. For example, to subscribe yourself to
+freebsd-hackers, you'd do:
+
+ % mail majordomo@freefall.cdrom.com
+ subscribe freebsd-hackers
+ ^D
+
+If you want to subscribe yourself under a different name, or submit a
+subscription request for a local mailing list (note: this is more efficient
+if you have several interested parties at one site, and highly appreciated by
+us!), you would do something like:
+
+ % mail majordomo@freefall.cdrom.com
+ subscribe freebsd-hackers local-hackers@somesite.com
+ ^D
+
+Finally, it is also possible to unsubscribe yourself from a list, get a
+list of other list members or see the list of mailing lists again by
+sending other types of control messages to majordomo. For a complete
+list of available commands, do this:
+
+ % mail majordomo@freefall.cdrom.com
+ help
+ ^D
+
+Finally, it is suggested that you only join the freebsd-hackers or
+freebsd-questions mailing lists if you're also willing to see upwards
+of 100 messages a day (peak)! If you're only interested in the "high points",
+then it's suggested that you join freebsd-announce, which will contain
+only infrequent traffic.
+
+ Thank you!
+
diff --git a/share/FAQ/ports-supfile b/share/FAQ/ports-supfile
new file mode 100644
index 0000000..f29a143
--- /dev/null
+++ b/share/FAQ/ports-supfile
@@ -0,0 +1,7 @@
+ports-editors release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/ports delete old
+ports-lang release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/ports delete old
+ports-mail release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/ports delete old
+ports-net release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/ports delete old
+ports-shells release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/ports delete old
+ports-utils release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/ports delete old
+ports-x11 release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/ports delete old
diff --git a/share/FAQ/slip-dialup b/share/FAQ/slip-dialup
new file mode 100644
index 0000000..66a6646
--- /dev/null
+++ b/share/FAQ/slip-dialup
@@ -0,0 +1,190 @@
+***********************************************************************
+*** How to Set Up SLIP on FreeBSD ***
+***********************************************************************
+
+Updated for 1.1.5(.1) support by Satoshi Asami, 8/6/94.
+
+The following is I (asami) set up my FreeBSD machine for SLIP on a
+static host network. For dynamic hostname assignments (i.e., your
+address changes each time you dial up), you probably need to do
+something much fancier.
+
+This is just "what I did, and it worked for me". I'm sharing this
+just for your reference, I'm no expert in SLIP nor networking so your
+mileage may vary.
+
+Note: for 1.1 systems (not 1.1.5), you need to use /dev/tty01 instead
+of /dev/cua01. substitute all the occurences of "cua" in this document
+with "tty".
+
+Note: the default 1.1.5(.1) system only comes with cua/ttyd pairs for
+the last two ports (2 and 3), so if your modem is at sio0/sio1
+(COM1/COM2), you need to make the devices. Try "cd /dev; sh MAKEDEV
+cua01" to make the new special files for sio1 (ditto for sio0). This
+will delete tty01, but you shouldn't need it anymore...or you can make
+a symbolic link /dev/tty01 -> ttyd1 if you don't want to hunt down all
+occurences of tty01 in your setup files.
+
+I actually have a symbolic link /dev/modem -> cua01 (and /dev/mouse ->
+ttyd0). I use only the modem/mouse names in my configuration files.
+This helped a lot when I switched from 1.1 to 1.1.5.1 (tty01 => cua01)
+and when I had to move my modem temporarily to sio2 to enable the
+RS-232C port on the serial card. It can become quite cumbersome when
+you need to fix a bunch of files in /etc and .kermrc's all over the
+system!
+
+First, make sure you have
+
+pseudo-device sl 2
+
+in your kernel's config file. It is included in the GENERICAH and
+GENERICBT kernels, so this won't be a problem unless you deleted it.
+
+Things you have to do only once:
+
+(1) Add your home machine, the gateway and nameservers to your
+ /etc/hosts file. Mine looks like this:
+
+127.0.0.1 localhost loghost
+136.152.64.181 silvia.HIP.Berkeley.EDU silvia.HIP silvia
+
+136.152.64.1 inr-3.Berkeley.EDU inr-3 slip-gateway
+128.32.136.9 ns1.Berkeley.edu ns1
+128.32.136.12 ns2.Berkeley.edu ns2
+
+ By the way, silvia is the name of the car that I had when I was
+ back in Japan (it's called 2?0SX here in U.S.).
+
+(2) Make sure you have "hosts" before "bind" in your /etc/host.conf.
+ Otherwise, funny things may happen.
+
+(3) Edit the /etc/netstart and add this to the end of the file:
+
+# set up slip
+gateway=slip-gateway
+ifconfig sl0 inet $hostname $gateway netmask 0xffffff00
+route add default $gateway
+
+ Note that because of the "slip-gateway" entry in /etc/hosts, there
+ is no local dependency in the netstart file. Also, you might want
+ to un-comment the "route add $hostname localhost" line.
+
+(3') Make a file /etc/resolv.conf which contains:
+
+domain HIP.Berkeley.EDU
+nameserver 128.32.136.9
+nameserver 128.32.136.12
+
+ As you can see, these set up the nameserver hosts. Of course, the
+ actual addresses depend on your environment.
+
+(4) Set the password for root and toor (and any other accounts that
+ doesn't have a password). Use passwd, don't edit the passwd or
+ passwd.master files!
+
+(5) Edit /etc/myname and reboot the machine.
+
+How to set up the connection:
+
+(6) Dial up, type "slip" at the prompt, enter your machine name and
+ password. The things you need to enter depends on your
+ environment. I use kermit, with a script like this:
+
+# kermit setup
+set modem hayes
+set line /dev/cua01
+set speed 57600
+set parity none
+set flow rts/cts
+set terminal bytesize 8
+set file type binary
+# The next macro will dial up and login
+define slip dial 643-9600, input 10 =>, if failure stop, -
+output slip\x0d, input 10 Username:, if failure stop, -
+output silvia\x0d, input 10 Password:, if failure stop, -
+output ***\x0d, echo \x0aCONNECTED\x0a
+
+ (of course, you have to change the hostname and password to fit
+ yours). Then you can just type "slip" from the kermit prompt to
+ get connected.
+
+ Note: leaving your password in plain text anywhere in the
+ filesystem is generally a BAD idea. Do it at your own risk. I'm
+ just too lazy.
+
+ Note: If you have an 1.1 machine, and kermit doesn't give you a
+ prompt, try "stty -f /dev/tty01 clocal". I put this in
+ /etc/rc.local so that it works the first time I boot the machine.
+ This doesn't apply to 1.1.5(.1) systems, as cua0? are already
+ configured for dialouts.
+
+(7) Leave the kermit there (you can suspend it by "z") and as root,
+ type
+
+slattach -h -c -s 57600 /dev/cua01
+
+ if you are able to "ping" hosts on campus, you are connected!
+
+ If it doesn't work, you might want to try "-a" instead of "-c".
+
+(8) Happy slipping!
+
+How to shutdown the connection:
+
+(9) Type "ps gx" (as root) to find out the PID of slattach, and use
+ "kill -INT" to kill it.
+
+ Then go back to kermit ("fg" if you suspended it) and exit from it
+ ("q").
+
+ The slattach man page says you have to use "ifconfig sl0 down" to
+ mark the interface down, but this doesn't seem to make any
+ difference for me. ("ifconfig sl0" reports the same thing.)
+
+ Some times, your modem might refuse to drop the carrier (mine
+ often does). In that case, simply start kermit and quit it again.
+ It usually goes out on the second try.
+
+ When you want to connect again, go back to (6). You may have to
+ watch out for clocal mode. If "stty -f /dev/tty01" doesn't tell
+ you it's clocal, you need to re-set it before kermitting. Again,
+ this is only for 1.1 machines.
+
+TROUBLESHOOTING:
+
+If it doesn't work, feel free to ask me. The things that people
+tripped over so far:
+
+* Not using "-c" or "-a" in slattach (I have no idea why this can be
+ fatal, but adding this flag solved the problem for at least one
+ person)
+
+* Using "s10" instead of "sl0" (might be hard to see the difference on
+ some fonts :)
+
+Try "ifconfig sl0" to see your interface status. I get:
+
+silvia# ifconfig sl0
+sl0: flags=10<POINTOPOINT>
+ inet 136.152.64.181 --> 136.152.64.1 netmask ffffff00
+
+Also, "netstat -r" will give the routing table, in case you get the
+"no route to host" messages from ping. Mine looks like:
+
+silvia# netstat -r
+Routing tables
+Destination Gateway Flags Refs Use IfaceMTU Rtt
+Netmasks:
+(root node)
+(root node)
+
+Route Tree for Protocol Family inet:
+(root node) =>
+default inr-3.Berkeley.EDU UG 8 224515 sl0 - -
+localhost.Berkel localhost.Berkeley UH 5 42127 lo0 - 0.438
+inr-3.Berkeley.E silvia.HIP.Berkele UH 1 0 sl0 - -
+silvia.HIP.Berke localhost.Berkeley UGH 34 47641234 lo0 - 0.438
+(root node)
+
+(this is after transferring a bunch of files, your numbers should be
+smaller).
diff --git a/share/FAQ/standard-supfile b/share/FAQ/standard-supfile
new file mode 100644
index 0000000..3fce038
--- /dev/null
+++ b/share/FAQ/standard-supfile
@@ -0,0 +1,14 @@
+base release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+bin release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+etc release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+games release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+gnu release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+include release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+sys release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+lib release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+libexec release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+sbin release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+#secure release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+share release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+usrbin release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
+usrsbin release=current host=freefall.cdrom.com hostbase=/home base=/usr prefix=/usr/src delete old
diff --git a/share/FAQ/sup.FAQ b/share/FAQ/sup.FAQ
new file mode 100644
index 0000000..039d6a3
--- /dev/null
+++ b/share/FAQ/sup.FAQ
@@ -0,0 +1,94 @@
+ FreeBSD
+ Sup FAQ
+
+Last updated: $Date: 1994/05/11 22:40:48 $
+
+ SUP is a network based software update tool developed at CMU. The
+purpose of this document is get the beginner up and running with sup.
+
+ First off you will need to pick up the sup binaries. The easiest
+way of doing this is to grab the sup_bin.tgz package from:
+
+ freebsd.cdrom.com:~ftp/pub/FreeBSD/packages
+ (FreeBSD 1.1 or later)
+ freebsd.cdrom.com:~ftp/pub/FreeBSD/packages-1.0
+ (FreeBSD 1.0.2 or earlier)
+
+If you only wish to set up a sup client, you may also simply grab the sup
+binary you see in this directory. This is generally enough for 99.9% of
+those using sup.
+
+Install the sup package using pkg_add (or the binary) and add the following
+line to your /etc/services file:
+
+ sup 871/tcp #sup
+
+SUP gets the information it needs to run from a configuration file
+called a supfile. This file tells sup what collections it will be updating
+and/or installing and where they go. The supfile in this directory will
+sup both the source and ports collection - look for the blank line seperating
+the two collections; if you don't want ports, you can simply delete all the
+ports entries. If you're inside the United States, you may also uncomment
+the `secure' collection line to grab the DES code. If you're outside the
+U.S., you should NOT sup this code from freefall.cdrom.com as this will
+violate U.S. export restrictions. Simply sup everything *but* the secure
+collection and then go look on "braae.ru.ac.za", where it's available for
+anonymous ftp for those outside the U.S.
+
+Any other distributions you do not wish to receive can be commented out
+with a # at the begining of the distribution line.
+
+Once this is setup, you're ready to go. To start sup type:
+
+ sup supfile
+
+If you wish to see what sup is doing "verbosely", give it the -v option,
+like so:
+
+ sup -v supfile
+
+Thats all there is to it! Remember that if you're running current,
+which is what you will have if you sup, please join the freebsd-current
+mailing list. You should also be sure to read:
+
+freebsd.cdrom.com:~ftp/pub/FreeBSD/FAQ/OTHER-FAQS/FreeBSD.current.policy
+
+For important information on just what we can and cannot do for you as
+a -current user.
+
+Gary Clark II / Jordan Hubbard
+FreeBSD maintainance persons.
+
+----
+
+Description of FreeBSD SUP distributions:
+
+base: /usr/src/... misc files at the top of /usr/src
+bin: /usr/src/bin system binaries
+secure: /usr/src/secure DES Sources. U.S./Canada only!
+etc: /usr/src/etc system files
+games: /usr/src/games games
+gnu: /usr/src/gnu sources under the GNU Public License
+include: /usr/src/include include files
+sys: /usr/src/sys kernel sources
+lib: /usr/src/lib libraries
+libexec: /usr/src/libexec more system binaries
+share: /usr/src/share various shared resources
+sbin: /usr/src/sbin even more system binaries
+usrbin: /usr/src/usr.bin user binaries
+usrsbin: /usr/src/usr.sbin that's it for the system binaries
+
+Ports:
+
+ports-base: /usr/ports/... misc files at the top of /usr/ports
+ports-editors: /usr/ports/editors text editors
+ports-game: /usr/ports/games games
+ports-lang: /usr/ports/lang programming languages
+ports-mail: /usr/ports/mail mail software
+ports-math: /usr/ports/math math software
+ports-net: /usr/ports/net networking software
+ports-news: /usr/ports/news USENET news software
+ports-print: /usr/ports/print printing software
+ports-shells: /usr/ports/shells various UN*X shells
+ports-utils: /usr/ports/utils miscellaneous utilities
+ports-x11: /usr/ports/x11 X11 software
OpenPOWER on IntegriCloud