From owner-freebsd-doc@FreeBSD.ORG Sat Apr 16 11:03:13 2005 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B239316A4CE for ; Sat, 16 Apr 2005 11:03:13 +0000 (GMT) Received: from av9-2-sn3.vrr.skanova.net (av9-2-sn3.vrr.skanova.net [81.228.9.186]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6E3D343D1D for ; Sat, 16 Apr 2005 11:03:12 +0000 (GMT) (envelope-from joel@automatvapen.se) Received: by av9-2-sn3.vrr.skanova.net (Postfix, from userid 502) id 092EC37EA4; Sat, 16 Apr 2005 13:03:11 +0200 (CEST) Received: from smtp3-2-sn3.vrr.skanova.net (smtp3-2-sn3.vrr.skanova.net [81.228.9.102]) by av9-2-sn3.vrr.skanova.net (Postfix) with ESMTP id EDE5C37E93 for ; Sat, 16 Apr 2005 13:03:10 +0200 (CEST) Received: from t6o955p75.telia.com (t6o955p75.telia.com [212.181.189.195]) by smtp3-2-sn3.vrr.skanova.net (Postfix) with ESMTP id 8E96937E43 for ; Sat, 16 Apr 2005 13:03:08 +0200 (CEST) From: Joel Dahl To: freebsd-doc@freebsd.org Content-Type: multipart/mixed; boundary="=-/qS15RQrPQWjx3YxCJIi" Date: Sat, 16 Apr 2005 13:02:25 +0200 Message-Id: <1113649345.509.26.camel@dude.automatvapen.se> Mime-Version: 1.0 X-Mailer: Evolution 2.2.0 FreeBSD GNOME Team Port Subject: [patch] Update section 8.4 in the handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 16 Apr 2005 11:03:13 -0000 --=-/qS15RQrPQWjx3YxCJIi Content-Type: text/plain Content-Transfer-Encoding: 7bit Hi All, The attached patch contains some corrections to section 8.4 (the configuration file) in our handbook: o Move "device npx" and "device loop" o Remove "maxusers n" and "#makeoptions DEBUG=-g" o Update/Remove some comments etc. My personal opinion is that with this patch, the whole section becomes much more pleasant to read, since all options are sorted as they appear in GENERIC in 5.4. Any objections? :-) -- Joel --=-/qS15RQrPQWjx3YxCJIi Content-Disposition: attachment; filename=kernelconfig2.diff Content-Type: text/x-patch; name=kernelconfig2.diff; charset=us-ascii Content-Transfer-Encoding: 7bit Index: chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml,v retrieving revision 1.156 diff -u -r1.156 chapter.sgml --- chapter.sgml 14 Apr 2005 18:40:33 -0000 1.156 +++ chapter.sgml 16 Apr 2005 10:03:31 -0000 @@ -447,11 +447,9 @@ 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 - ignored. The following sections describe each keyword, generally in - the order they are listed in GENERIC, although - some related keywords have been grouped together in a single section - (such as Networking) even though they are actually scattered - throughout the GENERIC file. GENERIC. + For an exhaustive list of architecture dependent options and devices, see the NOTES file in the same directory as GENERIC. For @@ -496,28 +494,6 @@ /usr/src/sys/i386/conf/GENERIC fairly closely. - # -# GENERIC -- Generic kernel configuration file for &os;/i386 -# -# For more information on this file, please read the handbook section on -# Kernel Configuration Files: -# -# http://www.&os;.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-config.html -# -# The handbook is also available locally in /usr/share/doc/handbook -# if you've installed the doc distribution, otherwise always see the -# &os; World Wide Web server (http://www.FreeBSD.org/) for the -# latest information. -# -# An exhaustive list of options and more detailed explanations of the -# device lines is also present in the ../../conf/NOTES and NOTES files. -# If you are in doubt as to the purpose or necessity of a line, check first -# in NOTES. -# -# $FreeBSD: /repoman/r/ncvs/src/sys/i386/conf/GENERIC,v 1.413 2004/08/11 01:34:18 rwatson Exp $ - - The following are the mandatory keywords required in - every kernel you build: kernel options machine @@ -595,80 +571,6 @@ kernel, so it is useful to give the new kernel a different name if you want to keep it separate from your usual kernel (e.g., you want to build an experimental kernel). - - kernel options - maxusers - - - maxusers n - - 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. - - Starting with &os; 4.5, the system will auto-tune this setting - for you if you explicitly set it to 0 - The auto-tuning algorithm sets maxusers equal - to the amount of memory in the system, with a minimum of 32, and a - maximum of 384.. - In &os; 5.X and above, maxusers will default to - 0 if not specified. If you are using an - version of &os; earlier than 4.5, or you want to manage it - 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 - 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 - full error when trying to start another program, or are - running a server with a large number of simultaneous users (like - ftp.FreeBSD.org), you can always - increase the number and rebuild. - - - maxusers does not - limit the number of users which can log into your machine. It - simply sets various table sizes to reasonable values considering - 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 - remote logins and X terminal windows is pseudo-device pty - 16. With &os; 5.X, you do not have to - worry about this number since the &man.pty.4; driver is - auto-cloning; you simply use the line - device pty in your configuration file. - - - # Floating point support - do not disable. -device npx - - npx is the interface to the floating point - math unit in &os;, which is either the hardware co-processor or - the software math emulator. This is not - optional. - - # Pseudo devices -device loop # Network loopback - - This is the generic loopback device for TCP/IP. If you telnet - or FTP to localhost (a.k.a. 127.0.0.1) it will come back at you through - this device. This is mandatory. Under - &os; 4.X you have to use the line pseudo-device - loop. - - Everything that follows is more or less optional. See the notes - underneath or next to each option for more information. #To statically compile in device wiring instead of /boot/device.hints #hints "GENERIC.hints" # Default places to look for devices. @@ -685,21 +587,6 @@ - #makeoptions DEBUG=-g # Build kernel with gdb(1) debug symbols - - The normal build process of &os; does not include - debugging information when building the kernel and strips most - symbols after the resulting kernel is linked, to save some space - at the install location. If you are going to do tests of kernels - in the -CURRENT branch or develop changes of your own for the &os; - kernel, you might want to uncomment this line. It will enable the - use of the option which enables debugging - information when passed to &man.gcc.1;. The same can be - accomplished by the &man.config.8; option, if - you are using the traditional way for building your - kernels (see - for more information). - options SCHED_4BSD # 4BSD scheduler The traditional scheduler for &os;. Depending on your system's @@ -1114,6 +1001,14 @@ will enable support for AGP, and AGP GART for boards which have these features. + # Floating point support - do not disable. +device npx + + npx is the interface to the floating point + math unit in &os;, which is either the hardware co-processor or + the software math emulator. This is not + optional. + APM @@ -1282,6 +1177,16 @@ Support for various wireless cards. + # Pseudo devices +device loop # Network loopback + + This is the generic loopback device for TCP/IP. If you telnet + or FTP to localhost (a.k.a. 127.0.0.1) it will come back at you through + this device. This is mandatory. Under + &os; 4.X you have to use the line pseudo-device + loop. + device mem # Memory and kernel memory devices The system memory devices. --=-/qS15RQrPQWjx3YxCJIi--