From owner-freebsd-doc@FreeBSD.ORG Tue Nov 2 18:40:29 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A53E016A4CE for ; Tue, 2 Nov 2004 18:40:29 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 84DA543D46 for ; Tue, 2 Nov 2004 18:40:29 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id iA2IeTfZ044469 for ; Tue, 2 Nov 2004 18:40:29 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id iA2IeTlr044467; Tue, 2 Nov 2004 18:40:29 GMT (envelope-from gnats) Resent-Date: Tue, 2 Nov 2004 18:40:29 GMT Resent-Message-Id: <200411021840.iA2IeTlr044467@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Joel Dahl Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E414E16A4CE for ; Tue, 2 Nov 2004 18:32:24 +0000 (GMT) Received: from av12-1-sn2.hy.skanova.net (av12-1-sn2.hy.skanova.net [81.228.8.185]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0F5B443D49 for ; Tue, 2 Nov 2004 18:32:24 +0000 (GMT) (envelope-from joel@automatvapen.se) Received: by av12-1-sn2.hy.skanova.net (Postfix, from userid 502) id A5AD938512; Tue, 2 Nov 2004 19:32:22 +0100 (CET) Received: from smtp4-2-sn2.hy.skanova.net (smtp4-2-sn2.hy.skanova.net [81.228.8.93]) by av12-1-sn2.hy.skanova.net (Postfix) with ESMTP id 902D938517 for ; Tue, 2 Nov 2004 19:32:22 +0100 (CET) Received: from dude.automatvapen.se (t9o955p20.telia.com [213.66.33.20]) by smtp4-2-sn2.hy.skanova.net (Postfix) with SMTP id 53DCE37E7B for ; Tue, 2 Nov 2004 19:32:20 +0100 (CET) Received: by dude.automatvapen.se (sSMTP sendmail emulation); Tue, 2 Nov 2004 19:32:47 +0100 Message-Id: <20041102183220.53DCE37E7B@smtp4-2-sn2.hy.skanova.net> Date: Tue, 2 Nov 2004 19:32:47 +0100 From: "Joel Dahl" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/73429: [patch] Update Handbook, Chapter 8, kernel configuration X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Joel Dahl List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 02 Nov 2004 18:40:29 -0000 >Number: 73429 >Category: docs >Synopsis: [patch] Update Handbook, Chapter 8, kernel configuration >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: Tue Nov 02 18:40:29 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Joel Dahl >Release: FreeBSD 5.2.1-RELEASE-p9 i386 >Organization: >Environment: System: FreeBSD dude.automatvapen.se 5.2.1-RELEASE-p9 FreeBSD 5.2.1-RELEASE-p9 #2: Sat Oct 30 14:56:56 CEST 2004 joel@dude.automatvapen.se:/usr/obj/usr/src/sys/WORKSTATION i386 >Description: [1] Update the weak description of ADAPTIVE_GIANT. [2] Option SMP was removed from GENERIC in RELENG_5 and RELENG_5_3, so it should probably be removed here as well. [3] Update description for apic since SMP is gone. [4] Device hptmv now ships with RELENG_5 and RELENG_5_3, but it's missing in here, so let's add it. See attached patch for suggested corrections. >How-To-Repeat: >Fix: --- kernconf.diff begins here --- --- chapter.sgml Sun Oct 31 09:06:48 2004 +++ new.chapter.sgml Tue Nov 2 19:04:34 2004 @@ -893,19 +893,26 @@ options ADAPTIVE_GIANT # Giant mutex is adaptive. - This option causes Giant to be included in the set of mutexes - adaptively spun on. + Giant is the name of a mutual exclusion mechanism (a sleep mutex) + that protects a large set of kernel resources. Today, this is an + unacceptable performance bottleneck which is actively beeing replaced + with locks that protect individual resources. The ADAPTIVE_GIANT + option causes Giant to be included in the set of mutexes adaptively + spun on. That is, when a thread wants to lock the Giant mutex, but it + is already locked by a thread on another CPU, the first thread will + keep running and wait for the lock to be released. Normally, the + thread would instead go back to sleep and wait for its next chance to + run. kernel options SMP - # To make an SMP kernel, the next two are needed -options SMP # Symmetric MultiProcessor Kernel -device apic # I/O APIC + device apic # I/O APIC - The above are both required for SMP support, and can also be - safely enabled on uniprocessor systems. + The apic device enables the use of I/O APIC for interrupt + delivery. The apic device can be used in both UP and SMP kernels, but + is required for SMP kernels. device isa @@ -1026,6 +1033,7 @@ device asr # DPT SmartRAID V, VI and Adaptec SCSI RAID device ciss # Compaq Smart RAID 5* device dpt # DPT Smartcache III, IV - See NOTES for options +device hptmv # Highpoint RocketRAID 182x device iir # Intel Integrated RAID device ips # IBM (Adaptec) ServeRAID device mly # Mylex AcceleRAID/eXtremeRAID --- kernconf.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: