From owner-freebsd-doc@FreeBSD.ORG Wed Nov 3 09:50:31 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 D0AFD16A4CF for ; Wed, 3 Nov 2004 09:50:31 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id B96B343D55 for ; Wed, 3 Nov 2004 09:50:31 +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 iA39oVoI072345 for ; Wed, 3 Nov 2004 09:50:31 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id iA39oV1f072344; Wed, 3 Nov 2004 09:50:31 GMT (envelope-from gnats) Date: Wed, 3 Nov 2004 09:50:31 GMT Message-Id: <200411030950.iA39oV1f072344@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Joel Dahl Subject: Re: 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: Wed, 03 Nov 2004 09:50:32 -0000 The following reply was made to PR docs/73429; it has been noted by GNATS. From: Joel Dahl To: John Baldwin Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/73429: [patch] Update Handbook, Chapter 8, kernel configuration Date: Wed, 03 Nov 2004 10:46:49 +0100 --=-Z3klKU7JEj0sIP/n7gJo Content-Type: text/plain Content-Transfer-Encoding: 7bit On Tue, 2004-11-02 at 22:02, John Baldwin wrote: > Only note I have (patch looks great!) is that instead of removing SMP, you > probably want to say that 'options SMP' should be added to include support > for multiple processors. Note that SMP is present in GENERIC on other > architectures such as Alpha and sparc64. There is also an 'SMP' kernel > config for i386 and amd64. I've attached an updated patch that includes your suggestion, and I've improved the description of ADAPTIVE_GIANT. Thanks. --=-Z3klKU7JEj0sIP/n7gJo Content-Disposition: attachment; filename=kernconf2.diff Content-Type: text/x-patch; name=kernconf2.diff; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit --- chapter.sgml Sun Oct 31 09:06:48 2004 +++ new.chapter.sgml Wed Nov 3 10:26:04 2004 @@ -893,19 +893,28 @@ 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. If you are not sure, + leave this in. 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. Add options SMP to + include support for multiple processors. device isa @@ -1026,6 +1035,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 --=-Z3klKU7JEj0sIP/n7gJo--