From owner-freebsd-doc Fri Jan 18 7:30:21 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 9BE7A37B404 for ; Fri, 18 Jan 2002 07:30:00 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g0IFU0R41272; Fri, 18 Jan 2002 07:30:00 -0800 (PST) (envelope-from gnats) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by hub.freebsd.org (Postfix) with ESMTP id 0ED1037B405 for ; Fri, 18 Jan 2002 07:25:25 -0800 (PST) Received: (from darklogik@localhost) by pittgoth.com (8.11.6/8.11.6) id g0IFQWu67068; Fri, 18 Jan 2002 10:26:32 -0500 (EST) (envelope-from darklogik) Message-Id: <200201181526.g0IFQWu67068@pittgoth.com> Date: Fri, 18 Jan 2002 10:26:32 -0500 (EST) From: Tom Rhodes Reply-To: Tom Rhodes To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: docs/34036: [PATCH] Kernel Config Chapter, not 4.5 ready 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: 34036 >Category: docs >Synopsis: [PATCH] Kernel Config Chapter, not 4.5 ready >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Fri Jan 18 07:30:00 PST 2002 >Closed-Date: >Last-Modified: >Originator: >Release: FreeBSD 5.0-CURRENT i386 >Organization: >Environment: System: FreeBSD localhost 5.0-CURRENT >Description: As talked about with a few project members, and mainly under the direction of RWatson, I have added some of the new features of the 4.5 GENERIC kernel to the handbook. This is not all of the options, but it will add the options SOFTUPDATES and the kern.maxusers information. It will also reword a previous sentence that I thought difficult to understand :) >How-To-Repeat: Look at both, 4.5 GENERIC and the handbook kernel config chapter >Fix: Apply this diff, I will provide more to the chapter later on :) *** chapter.sgml.old Thu Jan 17 21:16:28 2002 --- chapter.sgml Thu Jan 17 23:48:53 2002 *************** *** 503,524 **** maxusers ! maxusers 32 ! The maxusers option sets the size of a number ! of important system tables. This number is supposed to be roughly equal to the number of simultaneous users you expect to have on your ! machine. However, under normal circumstances, 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 ! maximum number of processes, which is set to 20 + 16 * ! maxusers, so if you set maxusers to 1, ! then you can only have 36 simultaneous processes, including the 18 ! or so that the system starts up at boot time, and the 15 or so you ! will probably create when you start the X Window System. Even a ! simple task like reading a manual page will start up nine processes to ! filter, decompress, and view it. Setting maxusers to 64 will allow you to have up to 1044 simultaneous processes, which should be enough for nearly all uses. If, however, you see the dreaded proc table --- 503,533 ---- maxusers ! maxusers 0 ! The maxusers option will set the size for many ! important system tables. This number is supposed to be roughly equal to the number of simultaneous users you expect to have on your ! machine. Since 4.5-RELEASE, however, the maxusers ! option is auto-tuning, and set at 0 by default in the configuration. ! Using a value of 0 will let the system automatically select the ! appropriate value based on physical system memory. ! This value can be obtained after booting, by looking at ! kern.maxusers, and modified at boot-time by changing the ! kernel configuration, or just by updating ! kern.maxusers in the /boot/loader.conf ! file. Using a value other than 0, will cause the kernel ! to use the old style maxusers, and it is ! recommended you set this value no less than 4 if you wish to manually ! enter it, specially if you will be using the X Window System or compiling ! software. The reason for this is that the most important table set by ! maxusers is the maximum number of processes, ! which is set to 20 + 16 * maxusers, so if you set ! maxusers to 1, then you can only have 36 simultaneous ! processes, including the 18 or so that the system starts up at boot ! time, and the 15 or so you will probably create when you start the X ! Window System. Even a simple task like reading a manual page will start ! up nine processes to filter, decompress, and view it. Setting maxusers to 64 will allow you to have up to 1044 simultaneous processes, which should be enough for nearly all uses. If, however, you see the dreaded proc table *************** *** 677,682 **** --- 686,705 ---- -C, which will display any write, talk, and any other messages you receive, as well as any console messages sent by the kernel. + + options SOFTUPDATES #Softupdates + + This options allows for faster dist writing. + + + are already enabled in the + GENERIC kernel, but they are not turned on + by default. You need to set this option yourself using the + &man.tunefs.8; command, and specifying the + option. Please read over the + /usr/src/sys/ufs/ffs/README.softupdates file before + setting this option + options USERCONFIG #boot -c editor >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message