From b6e49089bc1f69a3cf15beadd2c79ecac859948a Mon Sep 17 00:00:00 2001 From: Murray Stokely Date: Sun, 24 Jun 2001 11:30:31 +0000 Subject: [PATCH] Add ~110 index entries to the Handbook. --- .../books/handbook/install/chapter.sgml | 53 +++++++- .../books/handbook/introduction/chapter.sgml | 113 ++++++++++++++++-- 2 files changed, 153 insertions(+), 13 deletions(-) diff --git a/en_US.ISO8859-1/books/handbook/install/chapter.sgml b/en_US.ISO8859-1/books/handbook/install/chapter.sgml index 00ee4f9ceb..ae2987a846 100644 --- a/en_US.ISO8859-1/books/handbook/install/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/install/chapter.sgml @@ -1,7 +1,7 @@ @@ -13,6 +13,7 @@ Synopsis + installation The following chapter will attempt to guide you through the installation of FreeBSD on your system. It can be installed through a variety of methods, including anonymous FTP (assuming you have @@ -29,6 +30,9 @@ can also provide clues early-on in the process to potential problems you may come across later. + installation + network + anonymous FTP If you plan to install FreeBSD via anonymous FTP, the only things you will need are the installation floppies. The @@ -68,6 +72,10 @@ Creating the Installation Floppies + installation + boot floppies + installation + CDROM You may need to prepare some floppy disks. These disks will be used to boot your computer in to the FreeBSD install process. This step is not necessary if you are @@ -143,6 +151,7 @@ files. Instead, you must use specific tools to write the images directly to the disk. + DOS If you are creating the floppies on a computer running DOS then we provide a tool to do this called fdimage. @@ -202,6 +211,7 @@ CD of the set into the drive and reboot your system. You will be put into the installation menu directly from the CD. + DOS If you are installing from an MS-DOS partition and have the proper drivers to access your CD, run the install.bat script provided on the CDROM. @@ -217,6 +227,7 @@ view. This will bring up a DOS menu utility that leads you through all of the available options. + UNIX If you are creating the boot floppies from a UNIX machine, see the Creating the Boot Floppies section of this guide for examples. @@ -247,6 +258,7 @@ or not you actually use it as the installation media). + installationnetworkFTP Finally, if you would like people to be able to FTP install FreeBSD directly from the CDROM in your machine, you will find it quite easy. After the machine is fully installed, you simply @@ -270,6 +282,7 @@ Before installing from Floppies + installationfloppies If you must install from floppy disk (which we suggest you do NOT do), either due to unsupported hardware or simply because you insist on doing things the hard @@ -328,6 +341,7 @@ Before Installing from MS-DOS + installationfrom MS-DOS To prepare for an installation from an MS-DOS partition, copy the files from the distribution into a directory named, for example, c:\FreeBSD. The directory @@ -363,6 +377,8 @@ Before Installing from QIC/SCSI Tape + installationfrom + QIC/SCSI Tape Installing from tape is probably the easiest method, short of an online FTP install or CDROM install. The installation program expects the files to be simply tarred onto the tape, so @@ -392,6 +408,10 @@ Before Installing over a Network + installationnetworkserial + (SLIP or PPP) + installationnetworkparallel (PLIP) + installationnetworkEthernet There are three types of network installations you can do. Serial port (SLIP or PPP), Parallel port (PLIP (laplink cable)), or Ethernet (a standard ethernet controller (includes some @@ -460,6 +480,7 @@ Before Installing via NFS + installationnetworkNFS The NFS installation is fairly straight-forward. Simply copy the FreeBSD distribution files you want onto a server somewhere and then point the NFS media selection at it. @@ -493,6 +514,7 @@ Before Installing via FTP + installationnetworkFTP FTP installation may be done from any FreeBSD mirror site containing a reasonably up-to-date version of FreeBSD. A full list of FTP mirrors located all over the world is provided @@ -529,6 +551,7 @@ FTP Passive + FTPPassive mode This option instructs FreeBSD to use Passive mode for all FTP operations. This allows the user to pass through firewalls @@ -541,6 +564,8 @@ FTP via a HTTP proxy + FTPvia a HTTP + proxy This option instructs FreeBSD to use the HTTP protocol (like a web browser) to connect to a proxy for all FTP operations. The proxy will translate @@ -609,6 +634,7 @@ the Hardware Guide for a list of possible solutions. + sysinstall The FreeBSD boot floppies contain all of the online documentation you should need to be able to navigate through an installation. If it does not, please let us know what you found @@ -648,6 +674,9 @@ you may have. + installationstandard + installationexpress + installationcustom Select a Standard, Express, or Custom install, depending on whether or not you would like the installation to help you @@ -676,6 +705,7 @@ Supported Hardware + hardware FreeBSD currently runs on a wide variety of ISA, VLB, EISA, and PCI bus based PCs, ranging from the 386SX to Pentium class machines (though the 386SX is not recommended). Support for generic IDE or @@ -694,7 +724,7 @@ Disk Controllers - + disk controllers WD1003 (any generic MFM/RLL) @@ -904,6 +934,7 @@ + network cards Adaptec Duralink PCI fast ethernet adapters based on the Adaptec AIC-6195 fast ethernet controller chip, including the following: @@ -1153,6 +1184,7 @@ USB Peripherals + USB Peripherals A wide range of USB peripherals are supported. Owing to the generic nature of most USB devices, with some exceptions any device of a given class will be supported even if not explicitly @@ -1310,6 +1342,7 @@ ISDN (European DSS1 [Q.921/Q.931] protocol) + ISDN Asuscom I-IN100-ST-DV (experimental, may work) @@ -1433,6 +1466,7 @@ The following soundcards or codecs are supported (devices marked 'experimental' are only supported in FreeBSD-CURRENT and might work only unstably): + sound cards @@ -1655,6 +1689,7 @@ Troubleshooting + installationtroubleshooting The following section covers basic installation troubleshooting, such as common problems people have reported. There are also a few questions and answers for people wishing to dual-boot FreeBSD with @@ -1725,6 +1760,7 @@ MS-DOS User's Questions and Answers + DOS Many users wish to install FreeBSD on PCs inhabited by MS-DOS. Here are some commonly asked questions about installing FreeBSD on such systems. @@ -1744,6 +1780,7 @@ CDROM or various FreeBSD FTP sites to be quite useful. + FIPS FIPS allows you to split an existing MS-DOS partition into two pieces, preserving the original partition and allowing you to install onto the second free piece. You @@ -1757,7 +1794,8 @@ for an estimate of how much free space you will need for the kind of installation you want. - There is also a very useful + Partition Magic + There is also a very useful product from PowerQuest called Partition Magic. This @@ -1796,6 +1834,8 @@ + partitions + slices Yes. DOS extended partitions are mapped in at the end of the other slices in FreeBSD, e.g., your D: drive might be @@ -1830,6 +1870,9 @@ Installing FreeBSD on a system without a monitor or keyboard + installationheadless + (serial console) + serial console This type of installation is called a "headless install", because the machine that you are trying to install FreeBSD on either doesnt have a monitor attached to it, or doesnt even @@ -1871,6 +1914,7 @@ files. Instead, you must use specific tools to write the images directly to the disk. + fdimage If you are creating the floppies on a computer running DOS then we provide a tool to do this called fdimage. @@ -1915,6 +1959,7 @@ Do not try to mount the floppy if it is write-protected + mount If you were to boot into the floppies that you just made, FreeBSD would boot into its normal install mode. We want FreeBSD to boot into a serial console for our @@ -1951,6 +1996,7 @@ Connecting your null modem cable + null modem cable You now need to connect a null modem cable between the two machines. Just connect the cable to the serial ports of the 2 machines. A normal serial cable @@ -1970,6 +2016,7 @@ Connecting to your headless machine + cu Now you have to connect to that machine with &man.cu.1;: diff --git a/en_US.ISO8859-1/books/handbook/introduction/chapter.sgml b/en_US.ISO8859-1/books/handbook/introduction/chapter.sgml index aa3e999542..0c2a2e6826 100644 --- a/en_US.ISO8859-1/books/handbook/introduction/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/introduction/chapter.sgml @@ -1,7 +1,7 @@ @@ -17,6 +17,8 @@ covers various items about the FreeBSD Project, such as its history, goals, development model, and so on. + 4.4BSD-Lite + FreeBSD is a 4.4BSD-Lite based operating system for the Intel architecture (x86) and DEC Alpha based systems. Ports to other architectures are also underway. For a brief overview of FreeBSD, @@ -38,6 +40,9 @@ What is FreeBSD? + Intel architecture (x86) + DEC Alpha architecture + In general, FreeBSD is a state-of-the-art operating system based on 4.4BSD-Lite. It runs on computer systems based on the Intel architecture (x86), and also the DEC Alpha @@ -48,37 +53,45 @@ + Yahoo! Yahoo! + Hotmail Hotmail + Apache Apache + Be, Inc. Be, Inc. + Blue Mountain Arts Blue Mountain Arts + Pair Networks Pair Networks + Whistle Communications Whistle Communications + BSDi BSDi @@ -94,6 +107,7 @@ + preemptive multitasking Preemptive multitasking with dynamic priority adjustment to ensure smooth and fair sharing of the computer between applications and users, even @@ -101,6 +115,7 @@ + multi-user facilities Multi-user facilities which allow many people to use a FreeBSD system simultaneously for a variety of things. This means, for example, that system peripherals @@ -111,6 +126,7 @@ + TCP/IP networking Strong TCP/IP networking with support for industry standards such as SLIP, PPP, NFS, DHCP, and NIS. This means that your FreeBSD machine can @@ -122,6 +138,7 @@ + memory protection Memory protection ensures that applications (or users) cannot interfere with each other. One application crashing will not affect others in any way. @@ -134,6 +151,7 @@ + X-Windows The industry standard X Window System (X11R6) provides a graphical user interface (GUI) for the cost of a common VGA card and monitor and comes with full @@ -141,6 +159,16 @@ + binary compatibility + Linux + binary compatibility + SCO + binary compatibility + SVR4 + binary compatibility + BSD/OS + binary compatibility + NetBSD Binary compatibility with many programs built for Linux, SCO, SVR4, BSDI and NetBSD. @@ -162,6 +190,7 @@ + virtual memory Demand paged virtual memory and merged VM/buffer cache design efficiently satisfies applications with large appetites for memory while @@ -169,11 +198,18 @@ + Symetric Multi-Processing (SMP) SMP support for machines with multiple CPUs (Intel only). + compilers + C + compilers + C++ + compilers + Fortran A full complement of C, C++, Fortran, and Perl development tools. @@ -183,6 +219,7 @@ + source code Source code for the entire system means you have the greatest degree of control over your environment. Why be locked into a proprietary solution @@ -200,6 +237,10 @@ + 4.4BSD-Lite + Computer Systems Resarch Group + (CSRG) + U.C. Berkeley FreeBSD is based on the 4.4BSD-Lite release from Computer Systems Research Group (CSRG) at the University of California at Berkeley, and carries on the distinguished tradition of BSD @@ -237,24 +278,30 @@ + FTP servers FTP servers + web servers World Wide Web servers (standard or secure [SSL]) + firewalls + IP masquerading Firewalls and NAT (IP masquerading) gateways. + electronic mail Electronic Mail servers + USENET USENET News or Bulletin Board Systems @@ -293,6 +340,8 @@ + router + DNS Server Networking: Need a new router? A name server (DNS)? A firewall to keep people out of your internal network? FreeBSD can easily turn that unused 386 or @@ -301,6 +350,10 @@ + X-Windows + XFree86 + X-Windows + Accellerated-X X Window workstation: FreeBSD is a fine choice for an inexpensive X terminal solution, either using the freely available XFree86 server or one of the @@ -313,6 +366,7 @@ + GNU Compiler Collection Software Development: The basic FreeBSD system comes with a full complement of development tools including the renowned GNU C/C++ compiler and @@ -337,12 +391,19 @@ A Brief History of FreeBSD Contributed by &a.jkh;. - + + 386BSD Patchkit + Hubbard, Jordan + Williams, Nate + Grimes, Rod + FreeBSD Project + History The FreeBSD project had its genesis in the early part of 1993, partially as an outgrowth of the Unofficial 386BSD Patchkit by the patchkit's last 3 coordinators: Nate Williams, Rod Grimes and myself. + 386BSD Our original goal was to produce an intermediate snapshot of 386BSD in order to fix a number of problems with it that the patchkit mechanism just was not capable of solving. Some of you @@ -350,6 +411,7 @@ 386BSD 0.5 or 386BSD Interim in reference to that fact. + Jolitz, Bill 386BSD was Bill Jolitz's operating system, which had been up to that point suffering rather severely from almost a year's worth of neglect. As the patchkit swelled ever more uncomfortably with @@ -360,6 +422,8 @@ sanction from the project without any clear indication of what would be done instead. + Greenman, David + Walnut Creek CDROM It did not take us long to decide that the goal remained worthwhile, even without Bill's support, and so we adopted the name FreeBSD, coined by David Greenman. Our initial @@ -375,6 +439,11 @@ the time, a completely unknown project, it is quite unlikely that FreeBSD would have gotten as far, as fast, as it has today. + 4.3BSD-Lite + Net/2 + U.C. Berkeley + 386BSD + Free Software Foundation The first CDROM (and general net-wide) distribution was FreeBSD 1.0, released in December of 1993. This was based on the 4.3BSD-Lite (Net/2) tape from U.C. Berkeley, with @@ -383,6 +452,10 @@ offering, and we followed it with the highly successful FreeBSD 1.1 release in May of 1994. + Novell + U.C. Berkeley + Net/2 + AT&T Around this time, some rather unexpected storm clouds formed on the horizon as Novell and U.C. Berkeley settled their long-running lawsuit over the legal status of the Berkeley Net/2 @@ -458,6 +531,8 @@ Contributed by &a.jkh;. + FreeBSD Project + Goals The goals of the FreeBSD Project are to provide software that may be used for any purpose and without strings attached. Many of us have a significant investment in the code (and project) and @@ -470,14 +545,18 @@ goals of Free Software and one that we enthusiastically support. - That code in our source tree which falls under the GNU General - Public License (GPL) or Library General Public License (LGPL) - comes with slightly more strings attached, though at least on the - side of enforced access rather than the usual opposite. Due to - the additional complexities that can evolve in the commercial use - of GPL software we do, however, prefer software submitted under - the more relaxed BSD copyright when it's a reasonable option to - do so. + GNU General Public License (GPL) + GNU Lesser General Public License + (LGPL) + BSD Copyright + That code in our source tree which falls under the GNU + General Public License (GPL) or Library General Public License + (LGPL) comes with slightly more strings attached, though at + least on the side of enforced access rather than the usual + opposite. Due to the additional complexities that can evolve + in the commercial use of GPL software we do, however, prefer + software submitted under the more relaxed BSD copyright when + it's a reasonable option to do so. @@ -485,6 +564,8 @@ Contributed by &a.asami;. + FreeBSD Project + Development Model The development of FreeBSD is a very open and flexible process, FreeBSD being literally built from the contributions of hundreds of people around the world, as can be seen from our @@ -505,6 +586,8 @@ id="development-cvs-repository"> + CVS Repository + Concurrent Version System (see CVS repository) The central source tree for FreeBSD is maintained by CVS (Concurrent Version System), a freely available source code @@ -527,6 +610,7 @@ id="development-committers"> + committers The committers are the people who have write access to the CVS tree, and are thus authorized to make modifications @@ -545,6 +629,7 @@ The FreeBSD core team + core team The FreeBSD core team would be equivalent to the board of directors if the FreeBSD Project were a company. The primary task of the core team @@ -580,6 +665,7 @@ Outside contributors + contributors Last, but definitely not least, the largest group of developers are the users themselves who provide feedback and bug fixes to us on an almost constant basis. The primary @@ -620,6 +706,13 @@ The Current FreeBSD Release + NetBSD + OpenBSD + 386BSD + Free Software Foundation + U.C. Berkeley + Computer Systems Resarch Group + (CSRG) FreeBSD is a freely available, full source 4.4BSD-Lite based release for Intel i386, i486, Pentium, Pentium Pro, Celeron, Pentium II, Pentium III (or compatible) and DEC Alpha based computer