Mostly reformating of minor stuff in prep to send to 386bsd-announce.

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

diff --git a/contrib/FAQ/FreeBSD.FAQ b/contrib/FAQ/FreeBSD.FAQ
index c73cd80..7d9ebbe 100644 (file)
--- a/contrib/FAQ/FreeBSD.FAQ
+++ b/contrib/FAQ/FreeBSD.FAQ
@@ -5,7 +5,10 @@
 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.14 1994/04/20 20:38:36 wollman Exp $
+Revision: $Id: FreeBSD.FAQ,v 1.22 1994/05/04 08:28:16 gclarkii Exp $
+
+All entries marked <CURRENT> are for FreeBSD-current.  All other entries
+are for both.

 
 
 Table of Contents
 
 
 Table of Contents


@@ -85,7 +88,14 @@ we have made in the VM system and i386-specific code into Berkeley's
 release of FreeBSD (we haven't decided whether to call it 1.2 or 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
 release of FreeBSD (we haven't decided whether to call it 1.2 or 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.
+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.
 
 We expect to make more information available on the status of the
 merge effort as the situation progresses.


@@ -97,6 +107,7 @@ developers.  For more information, send to
 <majordomo@freefall.cdrom.com> and include a single line saying
 ``help'' in the body of your message.
 
 <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-hackers:   Useful for persons wishing to work on the internals. 
 FreeBSD-questions: General questions on FreeBSD. 
 FreeBSD-bugs:      Where bugs should be sent.


@@ -116,6 +127,7 @@ While there are no groups currently dedicated to FreeBSD, you may find
 the following groups useful.
 
 comp.os.386bsd.announce:     For announcements
 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.questions:    For questions
 comp.os.386bsd.development:  For working on the internals
 comp.os.386bsd.bugs:         About bugs


@@ -174,6 +186,9 @@ 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.
 
 feature has been disabled on your drive.  However, ESDI, RLL, and
 ST-506 drives normally do not do this.
 

+<CURRENT>
+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?
 
 
 1.5:  I have 32MB of memory, should I expect any special problems?
 


@@ -185,7 +200,9 @@ 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
 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).  Never fear, however, as all is not lost.
+3.36 or earlier).
+
+<CURRENT>

 FreeBSD-current (and the upcoming FreeBSD 1.2) 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
 FreeBSD-current (and the upcoming FreeBSD 1.2) 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


@@ -248,6 +265,23 @@ 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>.
 
 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.
+

 
 \f
 2 Hardware compatibility
 
 \f
 2 Hardware compatibility


@@ -269,6 +303,7 @@ Adaptec              AH-1542 Series <ISA>
 Buslogic             BT-445 Series <VLB> (but see section 1.5)
                      BT-545 Series <ISA>
                      BT-742 Series <EISA>
 Buslogic             BT-445 Series <VLB> (but see section 1.5)
                      BT-545 Series <ISA>
                      BT-742 Series <EISA>

+                     BT-747 Series <EISA>

 UltraStor            UH-14f Series <ISA>
                      UH-34f Series <EISA/VLB>
 
 UltraStor            UH-14f Series <ISA>
                      UH-34f Series <EISA/VLB>
 


@@ -298,7 +333,7 @@ drives.
 
 2.4:  What multi-port serial cards are supported by FreeBSD?
 
 
 2.4:  What multi-port serial cards are supported by FreeBSD?
 

-AST/4 and BOCA 4/8 port cards.  Some unnamed clone cards have also
+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.
 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.


@@ -354,7 +389,7 @@ There is support for the following cards:
 
 `ed' driver:
         NE2000 and 1000
 
 `ed' driver:
         NE2000 and 1000

-        WD/SMC 8003,8013 and Elite Ultra (8216)
+        WD/SMC 8003, 8013 and Elite Ultra (8216)

         3Com 3c503 
         And clones of the above
 
         3Com 3c503 
         And clones of the above
 


@@ -445,6 +480,11 @@ 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.
 
 FreeBSD's default math emulator will be good enough that you can
 forget about having to do this.
 

+<CURRENT>  
+For current 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
 
 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


@@ -486,7 +526,7 @@ here.
 
 
 \f
 
 
 \f

-5 Misc Questions
+5 Miscellaneous Questions

 ----------------
 
 5.1:  I've heard of something called FreeBSD-current.  How do I run it, and
 ----------------
 
 5.1:  I've heard of something called FreeBSD-current.  How do I run it, and


@@ -532,6 +572,18 @@ ${DESTDIR}.  Some random combination of shared libraries modifications
 and program rebuilds can cause this to fail in `make world', however.
 
 
 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.
+

 \f
 6 Kernel Configuration
 ----------------------
 \f
 6 Kernel Configuration
 ----------------------


@@ -553,9 +605,6 @@ 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
 
 device    sio4    at isa? port 0x2b0 tty flags 0x501 vector siointr
 device    sio5    at isa? port 0x2b8 tty flags 0x501 vector siointr
 

-You may also want to look at the multi-port serial FAQ in
-/usr/src/contrib/FAQ/OTHER-FAQS/multi-port.serial.FAQ.
-

 
 6.2:  FreeBSD is supposed to come with support for QIC-40/80 drives but
       when I look, I can't find it.
 
 6.2:  FreeBSD is supposed to come with support for QIC-40/80 drives but
       when I look, I can't find it.


@@ -759,7 +808,8 @@ ACKNOWLEDGMENTS:
 Gary Clark II           - Our head FreeBSD FAQ maintenance man
 Jordan Hubbard          - Janitorial services (I don't do windows)
 Garrett Wollman         - Networking and formatting
 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.      - Invaluable feedback and contributions
+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!
 The FreeBSD Team        - Kvetching, moaning, submitting data
 
 And to any others we've forgotten, apologies and heartfelt thanks!