From e6917a777e3e4cc5f7b60d6c14dacafc0e882b4f Mon Sep 17 00:00:00 2001 From: Murray Stokely Date: Tue, 26 Jun 2001 20:10:25 +0000 Subject: [PATCH] Properly wrap indexterm entries that exceed 80 characters. Also move tags outside of s since this can add extra whitespace characters to the output (for print stylesheets). Pointed out by: Chris Costello --- .../handbook/advanced-networking/chapter.sgml | 158 ++++++++++++---- .../books/handbook/backups/chapter.sgml | 58 ++++-- .../books/handbook/disks/chapter.sgml | 8 +- .../books/handbook/introduction/chapter.sgml | 172 +++++++++++------- .../books/handbook/kernelconfig/chapter.sgml | 84 +++++++-- 5 files changed, 344 insertions(+), 136 deletions(-) diff --git a/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml b/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml index 640d4f2fc8..1d1b221468 100644 --- a/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml @@ -1,7 +1,7 @@ @@ -69,7 +69,10 @@ host2.foobar.com link#1 UC 0 0 sending it out over the LAN, since it will only end up back where it started anyway. - EthernetMAC address + + Ethernet + MAC address + The next thing that stands out are the 0:e0:... addresses. These are ethernet hardware addresses. FreeBSD will automatically identify any hosts @@ -427,7 +430,10 @@ Local1 (10.20.30.1, 10.9.9.30) --> T1-GW (10.9.9.1) Kernel configuration changes kernel configuration - kernel configurationoptions BRIDGE + + kernel configuration + options BRIDGE + To enable kernel support for bridging, add the @@ -551,7 +557,10 @@ Local1 (10.20.30.1, 10.9.9.30) --> T1-GW (10.9.9.1) processes have to be configured and running properly. The server has to be running the following daemons: - NFSserver + + NFS + server + portmap mountd nfsd @@ -575,7 +584,10 @@ Local1 (10.20.30.1, 10.9.9.30) --> T1-GW (10.9.9.1) The client side only needs to run a single daemon: - NFSclient + + NFS + client + nfsiod @@ -587,7 +599,10 @@ Local1 (10.20.30.1, 10.9.9.30) --> T1-GW (10.9.9.1) Configuring NFS - NFSconfiguration + + NFS + configuration + Luckily for us, on a FreeBSD system this setup is a snap. The processes that need to be running can all be run at boot time with @@ -627,7 +642,10 @@ nfs_client_flags="-n 4" Here are a few example /etc/exports entries: - NFSexporting filesystems + + NFS + exporting filesystems + The following line exports /cdrom to three silly machines that have the same domain name as the server (hence the lack of a domain name for each) or have entries in your @@ -688,7 +706,10 @@ nfs_client_flags="-n 4" temporarily mount a remote file system or just want to test out your config you can run a command like this as root on the client: - NFSmounting filesystems + + NFS + mounting filesystems + &prompt.root; mount server:/home /mnt This will mount /home on the server on @@ -711,7 +732,10 @@ nfs_client_flags="-n 4" There are many very cool uses for NFS. Some of the more common ones are listed below. - NFSuses + + NFS + uses + Have several machines on a network and share a CD-ROM or @@ -1026,7 +1050,10 @@ hostname myclient.mydomain - NFSswapping over + + NFS + swapping over + If you are swapping over NFS (completely diskless configuration) create a swap file for your client using dd. If your swapfs command @@ -1136,7 +1163,10 @@ hostname myclient.mydomain Contributed by &a.hm;. - ISDNcards + + ISDN + cards + This section is really only relevant to ISDN users in countries where the DSS1/Q.931 ISDN standard is supported. @@ -1257,7 +1287,10 @@ hostname myclient.mydomain Stand-alone ISDN Bridges/Routers - ISDNstand-alone bridges/routers + + ISDN + stand-alone bridges/routers + ISDN bridges or routers are not at all specific to FreeBSD or any other operating system. For a more complete description of routing and bridging technology, please refer @@ -1409,7 +1442,10 @@ ISDN BRI line NIS was formerly known as Yellow Pages (or yp), but due to copyright violations, Sun was forced to change the name. - NISdomains + + NIS + domains + It is a RPC-based client/server system that allows a group of machines within an NIS domain to share a common set of configuration files. This permits a system administrator to set @@ -1504,7 +1540,10 @@ ISDN BRI line Machine types - NISmaster server + + NIS + master server + A NIS master server. This server, analogous to a Windows @@ -1518,7 +1557,10 @@ ISDN BRI line not be covered in this introduction, which assumes a relatively small-scale NIS environment. - NISslave server + + NIS + slave server + NIS slave servers. Similar to NT's backup domain @@ -1529,7 +1571,10 @@ ISDN BRI line attach to the NIS server whose response they get first, and this includes slave-server-replies. - NISclient + + NIS + client + NIS clients. NIS clients, like most NT workstations, authenticate against the NIS server (or the NT @@ -1616,7 +1661,10 @@ ISDN BRI line Choosing a NIS Domain Name - NISdomainname + + NIS + domainname + This might not be the domainname that you are used to. It is more accurately called the NIS domainname. When a client broadcasts its @@ -1687,7 +1735,10 @@ ISDN BRI line Setting up a NIS master server - NISserver configuration + + NIS + server configuration + Setting up a master NIS server can be relatively straight forward, depending on your needs. FreeBSD comes with support for NIS out-of-the-box. All you need is to add the following @@ -1808,8 +1859,10 @@ ellington&prompt.root; vi /var/yp/Makefile Setting up a NIS slave server - NISconfiguring a - slave server + + NIS + configuring a slave server + Setting up an NIS slave server is even more simple than setting up the master. Log on to the slave server and edit the file /etc/rc.conf as you did before. @@ -1930,7 +1983,10 @@ Don't forget to update map ypservers on ellington. Setting up an NIS client - NISclient configuration + + NIS + client configuration + Setting up a FreeBSD machine to be a NIS client is fairly straightforward. @@ -2591,7 +2647,10 @@ TWO (,hotel,test-domain) libscrypt v.s. libdescrypt - NIScrypto library + + NIS + crypto library + One of the most common issues that people run into when trying to implement NIS is crypt library compatibility. If your NIS server is using the DES crypt libraries, it will only support @@ -2640,8 +2699,12 @@ lrwxr-xr-x 1 root wheel 14 Nov 8 14:27 /usr/lib/libscrypt.so@ -> libscryp What is DHCP? - Dynamic Host Configuration Protocol (DHCP) - Internet Software Consortium (ISC) + + Dynamic Host Configuration Protocol (DHCP) + + + Internet Software Consortium (ISC) + DHCP, the Dynamic Host Configuration Protocol, describes the means by which a system can connect to a network and obtain the @@ -2699,7 +2762,10 @@ lrwxr-xr-x 1 root wheel 14 Nov 8 14:27 /usr/lib/libscrypt.so@ -> libscryp There are two things you must do to have your system use DHCP upon startup: - DHCPrequirements + + DHCP + requirements + Make sure that the bpf @@ -2748,7 +2814,10 @@ dhcp_flags="" - DHCPserver + + DHCP + server + The DHCP server, dhcpd, is included as part of the isc-dhcp2 port in the ports collection. This port contains the full ISC DHCP distribution, @@ -2758,7 +2827,10 @@ dhcp_flags="" Files - DHCPconfiguration files + + DHCP + configuration files + /etc/dhclient.conf dhclient requires a configuration file, @@ -3002,7 +3074,10 @@ dhcp_flags="" Starting BIND - BINDstarting + + BIND + starting + Since bind is installed by default, configuring it all is relatively simple. @@ -3018,7 +3093,10 @@ dhcp_flags="" Configuration files - BINDconfiguration files + + BIND + configuration files + make-localhost Be sure to @@ -3034,7 +3112,7 @@ dhcp_flags="" <filename>/etc/namedb/named.conf</filename> - // $FreeBSD: doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml,v 1.48 2001/06/24 03:22:48 murray Exp $ + // $FreeBSD: doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml,v 1.49 2001/06/26 00:09:52 murray Exp $ // // Refer to the named(8) man page for details. If you are ever going // to setup a primary server, make sure you've understood the hairy @@ -3245,7 +3323,10 @@ www IN CNAME @ recordname IN recordtype value - DNSrecords + + DNS + records + The most commonly used DNS records: @@ -3370,7 +3451,10 @@ www IN CNAME @ Caching Name Server - BINDcaching name server + + BIND + caching name server + A caching nameserver is simply a nameserver that is not authoritative for any zones. It simply asks queries of its own, @@ -3381,7 +3465,10 @@ www IN CNAME @ Running named in a Sandbox - BINDrunning in a sandbox + + BIND + running in a sandbox + Contributed by Mike Makonnen mike_makonnen@yahoo.com, May 1, 2001 @@ -3611,7 +3698,10 @@ www IN CNAME @ - kernelconfiguration + + kernel + configuration + Configuration The following options must be in the kernel configuration file: diff --git a/en_US.ISO8859-1/books/handbook/backups/chapter.sgml b/en_US.ISO8859-1/books/handbook/backups/chapter.sgml index 29588db867..64ca668398 100644 --- a/en_US.ISO8859-1/books/handbook/backups/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/backups/chapter.sgml @@ -1,7 +1,7 @@ @@ -25,8 +25,14 @@ 4mm (DDS: Digital Data Storage) - tape mediaDDS (4mm) tapes - tape mediaQIC tapes + + tape media + DDS (4mm) tapes + + + tape media + QIC tapes + 4mm tapes are replacing QIC as the workstation backup media of choice. This trend accelerated greatly when Conner purchased Archive, a leading manufacturer of QIC drives, and then stopped production of @@ -55,8 +61,10 @@ 8mm (Exabyte) - tape mediaExabyte (8mm) - tapes + + tape media + Exabyte (8mm) tapes + 8mm tapes are the most common SCSI tape drives; they are the best choice of exchanging tapes. Nearly every site has an exabyte 2 GB 8mm @@ -86,7 +94,10 @@ QIC - tape mediaQIC-150 + + tape media + QIC-150 + QIC-150 tapes and drives are, perhaps, the most common tape drive and media around. QIC tape drives are the least expensive "serious" @@ -133,7 +144,10 @@ DLT - tape mediaDLT + + tape media + DLT + DLT has the fastest data transfer rate of all the drive types listed here. The 1/2" (12.5mm) tape is contained in a single spool @@ -165,7 +179,10 @@ AIT - tape mediaAIT + + tape media + AIT + AIT is a new format from Sony, and can hold up to 50GB (with compression) per tape. The tapes contain memory chips which retain an @@ -225,7 +242,10 @@ sa0(ncr1:4:0): Logical unit is in process of becoming ready Dump and Restore - backup softwaredump / restore + + backup software + dump / restore + dump restore @@ -261,7 +281,10 @@ sa0(ncr1:4:0): Logical unit is in process of becoming ready Tar - backup softwaretar + + backup software + tar + &man.tar.1; also dates back to Version 6 of ATT Unix (circa 1975). &man.tar.1; operates in cooperation with the filesystem; &man.tar.1; @@ -288,7 +311,10 @@ sa0(ncr1:4:0): Logical unit is in process of becoming ready Cpio - backup softwarecpio + + backup software + cpio + &man.cpio.1; is the original Unix file interchange tape program for magnetic media. &man.cpio.1; has options (among many others) to @@ -318,7 +344,10 @@ sa0(ncr1:4:0): Logical unit is in process of becoming ready Pax - backup softwarepax + + backup software + pax + pax POSIX IEEE @@ -334,7 +363,10 @@ sa0(ncr1:4:0): Logical unit is in process of becoming ready Amanda - backup softwareamanda + + backup software + amanda + amanda Amanda diff --git a/en_US.ISO8859-1/books/handbook/disks/chapter.sgml b/en_US.ISO8859-1/books/handbook/disks/chapter.sgml index fb196d3b0b..9d8d4adbd1 100644 --- a/en_US.ISO8859-1/books/handbook/disks/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/disks/chapter.sgml @@ -1,7 +1,7 @@ @@ -246,8 +246,10 @@ The fstab File - filesystemsmounted with - fstab + + filesystems + mounted with fstab + During the boot process, filesystems listed in /etc/fstab are diff --git a/en_US.ISO8859-1/books/handbook/introduction/chapter.sgml b/en_US.ISO8859-1/books/handbook/introduction/chapter.sgml index 4769369620..7e318a99b1 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 @@ @@ -107,17 +107,17 @@ are: + preemptive multitasking Preemptive multitasking with - preemptive multitasking dynamic priority adjustment to ensure smooth and fair sharing of the computer between applications and users, even under the heaviest of loads. - + + multi-user facilities Multi-user facilities which allow many - multi-user facilities people to use a FreeBSD system simultaneously for a variety of things. This means, for example, that system peripherals such as printers and tape drives are properly shared between @@ -126,9 +126,9 @@ protecting critical system resources from over-use. + TCP/IP networking Strong TCP/IP networking with - TCP/IP networking support for industry standards such as SLIP, PPP, NFS, DHCP, and NIS. This means that your FreeBSD machine can inter-operate easily with other systems as well as act as an @@ -137,10 +137,10 @@ organization on the Internet with WWW, FTP, routing and firewall (security) services. - + + memory protection Memory protection ensures that - memory protection applications (or users) cannot interfere with each other. One application crashing will not affect others in any way. @@ -150,27 +150,37 @@ system (64-bit on the Alpha) and was designed as such from the ground up. - + + X-Windows The industry standard X Window System - X-Windows (X11R6) provides a graphical user interface (GUI) for the cost of a common VGA card and monitor and comes with full sources. + + binary compatibility + Linux + + + binary compatibility + SCO + + + binary compatibility + SVR4 + + + binary compatibility + BSD/OS + + + binary compatibility + NetBSD + Binary compatibility with many - binary compatibility - Linux - binary compatibility - SCO - binary compatibility - SVR4 - binary compatibility - BSD/OS - binary compatibility - NetBSD programs built for Linux, SCO, SVR4, BSDI and NetBSD. @@ -190,38 +200,46 @@ require few, if any, changes to compile. + virtual memory Demand paged virtual memory and - virtual memory merged VM/buffer cache design efficiently satisfies applications with large appetites for memory while still maintaining interactive response to other users. + + Symetric Multi-Processing (SMP) + SMP support for machines with - Symetric Multi-Processing (SMP) multiple CPUs (Intel only). + + compilers + C + + + compilers + C++ + + + compilers + Fortran + A full complement of C, - compilers - C - compilers - C++ - compilers - Fortran C++, Fortran, and Perl development tools. Many additional languages for advanced research and development are also available in the ports and packages collection. - + + source code Source code for the entire system - source code means you have the greatest degree of control over your environment. Why be locked into a proprietary solution at the mercy of your vendor when you can have a truly Open @@ -238,11 +256,12 @@ - FreeBSD is based on the 4.4BSD-Lite release from Computer 4.4BSD-Lite - Computer Systems Resarch Group - (CSRG) + + 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 systems development. In addition to the fine work provided by @@ -278,33 +297,32 @@ variety of Internet services such as: + FTP servers - FTP servers - FTP servers + FTP servers + web servers World Wide Web servers (standard or secure - [SSL]) - web servers + [SSL]) - + + firewalls + IP masquerading Firewalls and NAT (IP masquerading) - gateways. - firewalls - IP masquerading + gateways. + electronic mail - Electronic Mail servers - electronic mail - + Electronic Mail servers + USENET - USENET News or Bulletin Board Systems - USENET + USENET News or Bulletin Board Systems @@ -341,22 +359,26 @@ in open forums. + router + DNS Server Networking: Need a new router? A - router - DNS Server name server (DNS)? A firewall to keep people out of your internal network? FreeBSD can easily turn that unused 386 or 486 PC sitting in the corner into an advanced router with sophisticated packet-filtering capabilities. + + X-Windows + XFree86 + + + X-Windows + Accellerated-X + X Window workstation: FreeBSD is a - X-Windows - XFree86 - X-Windows - Accellerated-X fine choice for an inexpensive X terminal solution, either using the freely available XFree86 server or one of the excellent commercial servers provided by X Inside. Unlike an @@ -367,9 +389,9 @@ administer. + GNU Compiler Collection Software Development: The basic - GNU Compiler Collection FreeBSD system comes with a full complement of development tools including the renowned GNU C/C++ compiler and debugger. @@ -398,8 +420,10 @@ Hubbard, Jordan Williams, Nate Grimes, Rod - FreeBSD Project - History + + 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 @@ -457,7 +481,7 @@ Novell U.C. Berkeley Net/2 - AT&T + AT&amp;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 @@ -533,8 +557,10 @@ Contributed by &a.jkh;. - FreeBSD Project - Goals + + 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 @@ -547,9 +573,12 @@ goals of Free Software and one that we enthusiastically support. - GNU General Public License (GPL) - GNU Lesser General Public License - (LGPL) + + 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 @@ -566,8 +595,10 @@ Contributed by &a.asami;. - FreeBSD Project - Development Model + + 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 @@ -587,10 +618,12 @@ The CVS repository + CVS Repository + + Concurrent Version System (see CVS repository) + The central source tree for FreeBSD is maintained by - CVS Repository - Concurrent Version System (see CVS repository) CVS (Concurrent Version System), a freely available source code control tool that comes bundled with FreeBSD. The primary @@ -611,9 +644,9 @@ The committers list + committers The committers - committers are the people who have write access to the CVS tree, and are thus authorized to make modifications to the FreeBSD source (the term committer @@ -630,9 +663,9 @@ The FreeBSD core team + core team The FreeBSD core team - core team would be equivalent to the board of directors if the FreeBSD Project were a company. The primary task of the core team is to make sure the project, as a whole, is in good shape @@ -666,9 +699,9 @@ Outside contributors + contributors Last, but definitely not least, the largest group of - contributors developers are the users themselves who provide feedback and bug fixes to us on an almost constant basis. The primary way of keeping in touch with FreeBSD's more non-centralized @@ -713,8 +746,9 @@ 386BSD Free Software Foundation U.C. Berkeley - Computer Systems Resarch Group - (CSRG) + + 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 diff --git a/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml b/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml index 03936f1e67..f0580e87e8 100644 --- a/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml @@ -1,7 +1,7 @@ @@ -13,7 +13,11 @@ Updated and restructured by &a.jim;, March 2000. Originally contributed by &a.jehamby;, 6 October 1995. - kernelbuilding a custom kernel + + kernel + building a custom kernel + + The following chapter of the handbook covers everything you will need to know in order to build a custom kernel. If you are wondering what the benefits of a custom kernel are, or would like to @@ -57,7 +61,11 @@ Building and Installing a Custom Kernel - kernelbuilding / installing + + kernel + building / installing + + First, let us take a quick tour of the kernel build directory. All directories mentioned will be relative to the main /usr/src/sys directory, which is also @@ -117,8 +125,8 @@ comment lines at the top to reflect your configuration or the changes you have made to differentiate it from GENERIC. - SunOS + If you have built a kernel under SunOS or some other BSD operating system, much of this file will be very familiar to you. If you are coming from some other operating system such as DOS, on @@ -180,8 +188,12 @@ CVSup anoncvs - CVSanonymous CTM + + CVS + anonymous + + If you have not upgraded your source tree in any way (you have not run CVSup, CTM, or used @@ -200,6 +212,7 @@ sources! kernel.old + The new kernel will be copied to the root directory as /kernel and the old kernel will be moved to /kernel.old. Now, shutdown the system and @@ -219,9 +232,13 @@ The Configuration File - kernelconfig file kernelLINT LINT + + kernel + config file + + The general format of a configuration file is quite simple. Each line contains a keyword and one or more arguments. For simplicity, most lines only contain one argument. Anything @@ -252,8 +269,11 @@ /usr/src/sys/i386/conf/GENERIC files on your system for examples. + + kernel + example config + - kernelexample config The following is an example GENERIC kernel configuration file with various additional comments where needed for clarity. This example should match your copy in @@ -282,15 +302,21 @@ The following are the mandatory keywords required in every kernel you build: + + kernel options + machine + - kernel optionsmachine machine i386 This is the machine architecture. It must be either i386, alpha, or pc98. - kernel optionscpu + + kernel options + cpu + cpu I386_CPU cpu I486_CPU cpu I586_CPU @@ -303,8 +329,11 @@ cpu I686_CPU best to specify only the CPU you have. If you are unsure which type your CPU use, you can use the dmesg command to view your boot up messages. + + kernel options + cpu type + - kernel optionscpu type The Alpha architecture has different values for cpu_type. They include: @@ -313,8 +342,11 @@ cpu EV5 If you are using an Alpha machine, you should be using one of the above CPU types. + + kernel options + ident + - kernel optionsident ident GENERIC This is the identification of the kernel. You should change @@ -324,8 +356,11 @@ cpu EV5 kernel, so it is useful to give a kernel a different name if you want to keep it separate from your usual kernel (i.e., you want to build an experimental kernel). + + kernel options + maxusers + - kernel optionsmaxusers maxusers 32 The maxusers option sets the size of a number @@ -418,8 +453,14 @@ options MD_ROOT #MD is a potential root device Now you simply need to either reboot, or run the command mount /tmp. - kernel optionsNFS - kernel optionsNFS_ROOT + + kernel options + NFS + + + kernel options + NFS_ROOT + options NFS #Network Filesystem options NFS_ROOT #NFS usable as root device, NFS required @@ -427,7 +468,10 @@ options NFS_ROOT #NFS usable as root device, NFS required - kernel optionsMSDOSFS + + kernel options + MSDOSFS + options MSDOSFS #MSDOS Filesystem The MS-DOS filesystem. Unless you plan to mount a DOS formatted @@ -521,14 +565,20 @@ options _KPOSIX_PRIORITY_SCHEDULING applications in the ports collection use these (such as Star Office). - kernel optionsICMP_BANDLIM + + kernel options + ICMP_BANDLIM + options ICMP_BANDLIM #Rate limit bad replies This option enables ICMP error response bandwidth limiting. You typically want this option as it will help protect the machine from denial of service packet attacks. - kernel optionsSMP + + kernel options + SMP + # To make an SMP kernel, the next two are needed #options SMP # Symmetric MultiProcessor Kernel #options APIC_IO # Symmetric (APIC) I/O