From owner-freebsd-doc Mon Jun 24 20:50:47 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id EAD0F37B403 for ; Mon, 24 Jun 2002 20:50:01 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g5P3o1H81639; Mon, 24 Jun 2002 20:50:01 -0700 (PDT) (envelope-from gnats) Received: from guest.reppep.com (guest.reppep.com [64.81.19.110]) by hub.freebsd.org (Postfix) with ESMTP id 5A53437B400 for ; Mon, 24 Jun 2002 20:45:29 -0700 (PDT) Received: by guest.reppep.com (Postfix, from userid 501) id 7BF6DA827; Mon, 24 Jun 2002 23:45:37 -0400 (EDT) Message-Id: <20020625034537.7BF6DA827@guest.reppep.com> Date: Mon, 24 Jun 2002 23:45:37 -0400 (EDT) From: Chris Pepper Reply-To: Chris Pepper To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/39824: Various tweaks for doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml; corresponding comment clarification for GENERIC Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 39824 >Category: docs >Synopsis: Various tweaks for doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml; corresponding comment clarification for GENERIC >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Jun 24 20:50:01 PDT 2002 >Closed-Date: >Last-Modified: >Originator: Chris Pepper >Release: FreeBSD 4.6-STABLE i386 >Organization: >Environment: System: FreeBSD guest.reppep.com 4.6-STABLE FreeBSD 4.6-STABLE #0: Tue Jun 18 21:27:59 EDT 2002 pepper@guest.reppep.com:/usr/obj/usr/src/sys/GENERIC i386 >Description: Misc linguistic tweaks. Clarify description of /usr/src/UPDATING Change traditional adjective for kernel builds to old; change new to new. Change "The Configuration File" to "The Kernel Configuration File" (it's not the only config file!). procfs is a real filesystem, that doesn't hold actual on-disk data files. Mention that ptys are used for ssh. The vpo option's comment in GENERIC should mention it's for Zip drives; this patch includes both a patch to the quoted line for chapter.sgml, and a patch for GENERIC as well. >How-To-Repeat: Read doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml & /usr/src/sys/i386/conf/GENERIC. >Fix: Two patches follow. --- chapter.sgml.diff begins here --- Index: chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml,v retrieving revision 1.76 diff -u -r1.76 chapter.sgml --- chapter.sgml 2002/05/04 14:22:35 1.76 +++ chapter.sgml 2002/06/25 03:34:16 @@ -77,7 +77,7 @@ Traditionally, FreeBSD has had what is called a monolithic kernel. This means that the kernel was one - large program, supported a fixed list of devices, and if you wanted to + large program, which supported a fixed list of devices, and if you wanted to change the kernel's behavior then you had to compile a new kernel, and then reboot your computer with the new kernel. @@ -120,7 +120,7 @@ Additional hardware support. A custom kernel allows you to - add in support for devices such as sound cards, which are not + add in support for devices such as sound cards which are not present in the GENERIC kernel. @@ -231,15 +231,11 @@ section slowly and carefully. - Be sure to always check the file - /usr/src/UPDATING, before you perform any update - steps, in the case you sync your source-tree with the - latest sources of the FreeBSD project. - In this file all important issues with updating FreeBSD - are written down. /usr/src/UPDATING always fits - to your version of the FreeBSD source, and is therefore more accurate - for those information than the handbook. + If you update your FreeBSD source, be sure to check the file + /usr/src/UPDATING. + This file mentions important issues you should be aware of when working with updated FreeBSD source code. /usr/src/UPDATING always tracks + your version of the FreeBSD source, and is therefore more up to date + for your system than the handbook. You must now compile the source code for the kernel. There are two @@ -274,7 +270,7 @@ - Procedure 1. Building a kernel the <quote>traditional</quote> way + Procedure 1. Building a kernel the old way Run &man.config.8; to generate the kernel source code. @@ -303,7 +299,7 @@ - Procedure 2. Building a kernel the <quote>new</quote> + <title>Procedure 2. Building a kernel the new way @@ -343,7 +339,7 @@ If you have not upgraded your source - tree in any way (you have not run CVSup, + tree in any way (you have not run CVSup or CTM, or used anoncvs), then you should use the config, make depend, @@ -373,7 +369,7 @@ - The Configuration File + The Kernel Configuration File kernel LINT @@ -384,7 +380,7 @@ config file - The general format of a configuration file is quite simple. + The general format of a kernel configuration file is quite simple. Each line contains a keyword and one or more arguments. For simplicity, most lines only contain one argument. Anything following a # is considered a comment and @@ -516,10 +512,10 @@ Starting with FreeBSD 4.5, the system will auto-tune this setting for you if you explicitly set it to 0 The auto-tuning algorithm sets maxuser equal - to the amount of memory in the system, with a minimum of 32, and a + to the number of megabytes of memory in the system, with a minimum of 32, and a maximum of 384.. If you are using an earlier version of FreeBSD, or you want to manage it - yourself you will want to set + yourself, you will want to set maxusers to at least 4, especially if you are using the X Window System or compiling software. The reason is that the most important table set by maxusers is the @@ -540,8 +536,8 @@ maxusers does not - limit the number of users which can log into your machine. It - simply sets various table sizes to reasonable values considering + limit the number of users who can log into your machine. It + simply sets various table sizes to reasonable values based on the maximum number of users you will likely have on your system and how many processes each of them will be running. One keyword which does limit the number of simultaneous @@ -607,7 +603,7 @@ options UFS_DIRHASH #Improve performance on big directories This option includes some code to speed up disk operations on large - directories, at the expense of using a some additional memory. You + directories, at the expense of using some additional memory. You would normally keep this for a large server, or interactive workstation, and remove it if you are using FreeBSD on a smaller system where memory is at a premium and disk access speed is less important, such as a @@ -615,11 +611,11 @@ options SOFTUPDATES #Enable FFS soft updates support - This option enables soft updates in the kernel, this will help speed + This option enables soft updates in the kernel; this will help speed up write access on the disks. They are enabled by default in the 4.X branch but may not be turned on. Review the output from &man.mount.8; to see if you have them enabled. If you do not see the soft-updates option then - you will need to activate it using the &man.tunefs.8; or &man.newfs.8; + you may activate it using &man.tunefs.8; or &man.newfs.8; for new filesystems. options MFS #Memory Filesystem @@ -680,7 +676,7 @@ options PROCFS #Process filesystem - The process filesystem. This is a pretend + The process filesystem. This is a special filesystem mounted on /proc which allows programs like &man.ps.1; to give you more information on what processes are running. @@ -688,7 +684,7 @@ options COMPAT_43 #Compatible with BSD 4.3 [KEEP THIS!] Compatibility with 4.3BSD. Leave this in; some programs will - act strangely if you comment this out. + behave strangely if you comment this out. options SCSI_DELAY=15000 #Delay (in ms) before probing SCSI @@ -697,14 +693,14 @@ you can ignore this, otherwise you will probably want to lower this number, perhaps to 5 seconds, to speed up booting. Of course, if you do this, and FreeBSD has trouble recognizing your SCSI devices, - you will have to raise it back up. + you will have to raise it again. options UCONSOLE #Allow users to grab the console Allow users to grab the console, which is useful for X users. For example, you can create a console xterm by typing xterm -C, which will display any write, - talk, and any other messages you receive, as well + talk, and other messages you receive, as well as any console messages sent by the kernel. options USERCONFIG #boot -c editor @@ -748,7 +744,7 @@ options P1003_1B #Posix P1003_1B real-time extensions options _KPOSIX_PRIORITY_SCHEDULING - Real-time extensions added in the 1993 POSIX. Certain + Real-time extensions added in the 1993 POSIX specification. Certain applications in the ports collection use these (such as StarOffice). @@ -763,7 +759,7 @@ 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. + ICMP denial of service attacks. kernel options @@ -777,9 +773,9 @@ device isa - All PCs supported by FreeBSD have one of these. If you have an + All PCs supported by FreeBSD have ISA. If you have an IBM PS/2 (Micro Channel Architecture), you cannot run FreeBSD at - this time (support is being worked on). + this time (support is in development). device eisa @@ -790,7 +786,7 @@ device pci Include this if you have a PCI motherboard. This enables - auto-detection of PCI cards and gatewaying from the PCI to ISA + auto-detection of PCI cards and gatewaying from the PCI to the ISA bus. # Floppy drives @@ -832,8 +828,8 @@ options ATA_STATIC_ID #Static device numbering - This makes the controller number static (like the old driver) or - else the device numbers are dynamically allocated. + This makes the ATA controller number static (like the old driver); + otherwise the device numbers are dynamically allocated. # ATA and ATAPI devices device ata0 at isa? port IO_WD1 irq 14 @@ -890,7 +886,7 @@ device atkbd0 at atkbdc? irq 1 - The atkbd driver, together with + The atkbd driver, together with the atkbdc controller, provides access to the AT 84 keyboard or the AT enhanced keyboard which is connected to the AT keyboard controller. @@ -965,14 +961,14 @@ If you have an internal modem on COM4 and a serial port at COM2, you will have to change the IRQ of the modem to 2 (for - obscure technical reasons, IRQ2 = IRQ 9) in order to access it + obscure technical reasons, IRQ 2 = IRQ 9) in order to access it from FreeBSD. If you have a multiport serial card, check the manual page for &man.sio.4; for more information on the proper values for these lines. Some video cards (notably those based on - S3 chips) use IO addresses in the form of + S3 chipsets) use IO addresses in the form of 0x*2e8, and since many cheap serial cards do not fully decode the 16-bit IO address space, they clash with - these cards making the COM4 port practically unavailable. + these cards, making the COM4 port effectively unavailable. Each serial port is required to have a unique IRQ (unless you are using one of the multiport cards where shared interrupts are @@ -983,7 +979,7 @@ # Parallel port device ppc0 at isa? irq 7 - This is the ISA-bus parallel port interface. + This is the ISA bus parallel port interface. device ppbus # Parallel port bus (required) @@ -1007,7 +1003,7 @@ The general-purpose I/O (geek port) + IEEE1284 I/O. - #device vpo # Requires scbus and da + #device vpo # Zip support; requires scbus and da zip drive This is for an Iomega Zip drive. It requires @@ -1109,7 +1105,7 @@ pseudo-device pty # Pseudo-ttys (telnet etc) This is a pseudo-terminal or simulated login port. - It is used by incoming telnet and + It is used by incoming ssh, telnet, and rlogin sessions, xterm, and some other applications such as emacs. A @@ -1148,14 +1144,14 @@ This is the Berkeley Packet Filter. This pseudo-device allows network interfaces to be placed in promiscuous mode, capturing every packet on a broadcast network (e.g., an Ethernet). These packets - can be captured to disk and or examined with the &man.tcpdump.1; + can be captured to disk and/or examined with the &man.tcpdump.1; program. The bpf pseudo-device is also used by &man.dhclient.8; to obtain the IP address of the default router (gateway) and so on. If you use DHCP, leave this - uncommented. + enabled. # USB support --- chapter.sgml.diff ends here --- --- GENERIC Mon Jun 24 23:32:58 2002 +++ GENERIC.fixed Mon Jun 24 23:33:24 2002 @@ -169,7 +169,7 @@ device lpt # Printer device plip # TCP/IP over parallel device ppi # Parallel port interface device -#device vpo # Requires scbus and da +#device vpo # Iomega Zip drive: requires scbus and da # PCI Ethernet NICs. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message