1. Remove a rather strangely gratuitous bit of profanity

[unix-history] / contrib / FAQ / FreeBSD.FAQ

diff --git a/contrib/FAQ/FreeBSD.FAQ b/contrib/FAQ/FreeBSD.FAQ
index 59b7a79..21c8741 100644 (file)
--- a/contrib/FAQ/FreeBSD.FAQ
+++ b/contrib/FAQ/FreeBSD.FAQ
@@ -2,13 +2,14 @@
                                FreeBSD
                       Frequently Asked Questions
                       For Version 1.1 and above
                                FreeBSD
                       Frequently Asked Questions
                       For Version 1.1 and above

+

 Please mail all suggestions and additions to <FreeBSD-FAQ@freefall.cdrom.com>
 
 
 Please mail all suggestions and additions to <FreeBSD-FAQ@freefall.cdrom.com>
 
 

-Revision: $Id: FreeBSD.FAQ,v 1.23 1994/05/07 11:54:38 gclarkii Exp $
+Revision: $Id: FreeBSD.FAQ,v 1.34 1994/06/13 05:38:52 gclarkii Exp $

 
 All entries marked <CURRENT> are for FreeBSD-current.  All other entries
 
 All entries marked <CURRENT> are for FreeBSD-current.  All other entries

-are for both.
+are for both version 1.1 and current.

 
 
 Table of Contents
 
 
 Table of Contents


@@ -84,8 +85,7 @@ 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
 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 the next
-release of FreeBSD (we haven't decided whether to call it 1.2 or 2.0).
+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 
 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 


@@ -203,11 +203,11 @@ OK, UNLESS it's a Buslogic Bt445S with a revision less than `D' (BIOS
 3.36 or earlier).
 
 <CURRENT>
 3.36 or earlier).
 
 <CURRENT>

-FreeBSD-current (and the upcoming FreeBSD 1.2) have bounce-buffer
+FreeBSD-current (and the upcoming FreeBSD 1.1.5) have 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-current
 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-current

-or FreeBSD 1.2 (when it comes out) so that you can put it back.
+or FreeBSD 1.1.5 (when it comes out) so that you can put it back.

 
 
 1.6:  Do I need to install the complete sources?
 
 
 1.6:  Do I need to install the complete sources?


@@ -304,16 +304,13 @@ Buslogic             BT-445 Series <VLB> (but see section 1.5)
                      BT-545 Series <ISA>
                      BT-742 Series <EISA>
                      BT-747 Series <EISA>
                      BT-545 Series <ISA>
                      BT-742 Series <EISA>
                      BT-747 Series <EISA>

+Future Domain        TMC-8XX/950 Series <ISA> (CURRENT ONLY)
+Seagate              ST-01/02 Series <ISA> (CURRENT ONLY)

 UltraStor            UH-14f Series <ISA>
                      UH-34f Series <EISA/VLB>
 
 There is supposed to be a UltraStor 24f driver floating around, but
 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?).  Note
-that we do NOT support `Future Domain' or `IN2000' SCSI controllers,
-typically the little $50 specials you get with some CDROM drives.  You
-will have to buy a more mainstream (and capable) SCSI controller.  The
-Buslogic controllers are currently the easiest to get.
-
+we're not sure where (could someone please point us at it?).   

 
 2.3:  What CD-ROM drives are supported by FreeBSD?
 
 
 2.3:  What CD-ROM drives are supported by FreeBSD?
 


@@ -420,6 +417,15 @@ 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.
 
 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.
+

 
 \f
 3 Commercial Applications
 
 \f
 3 Commercial Applications


@@ -524,6 +530,13 @@ in the packages directory provides more details on the care and
 feeding of the package software, so no explicit details will be given
 here.
 
 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.
+

 
 \f
 5 Miscellaneous Questions
 
 \f
 5 Miscellaneous Questions


@@ -584,13 +597,49 @@ 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.
 
 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.  Is there any other way
-      besides downloading the whole tree?
+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.
 
 
 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.

 
 \f
 6 Kernel Configuration
 
 \f
 6 Kernel Configuration


@@ -626,6 +675,13 @@ disk            fd1     at fdc0 drive 1
 #tape           ft0     at fdc0 drive 2
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 #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?
 
 
 6.3:  Does FreeBSD support IPC primitives like those in System V?
 


@@ -672,6 +728,35 @@ 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>.
 
 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.
+

 
 \f
 7 System Administration
 
 \f
 7 System Administration


@@ -747,6 +832,8 @@ and follow the instructions.
 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).
 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?
 
 
 8.4:  How do I set up NTP?
 


@@ -780,6 +867,46 @@ 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.
 
 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 Serial Communications
 -----------------------