From nick@netability.ie  Tue Jul 30 11:21:24 2002
Return-Path: <nick@netability.ie>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 462D637B409
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 30 Jul 2002 11:21:17 -0700 (PDT)
Received: from flapjack.homeip.net (r96-68.bas1.srl.dublin.eircom.net [159.134.96.68])
	by mx1.FreeBSD.org (Postfix) with ESMTP id B2DE543E31
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 30 Jul 2002 11:21:14 -0700 (PDT)
	(envelope-from nick@netability.ie)
Received: from flapjack.netability.ie (localhost [127.0.0.1])
	by flapjack.homeip.net (8.12.3/8.12.3) with ESMTP id g6UE52Dm021353
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 30 Jul 2002 15:05:02 +0100 (IST)
	(envelope-from nick@flapjack.netability.ie)
Received: (from nick@localhost)
	by flapjack.netability.ie (8.12.3/8.12.3/Submit) id g6UE51Ys025498;
	Tue, 30 Jul 2002 15:05:01 +0100 (IST)
Message-Id: <200207301405.g6UE51Ys025498@flapjack.netability.ie>
Date: Tue, 30 Jul 2002 15:05:01 +0100 (IST)
From: Nick Hilliard <nick-lists@netability.ie>
Reply-To: Nick Hilliard <nick-lists@netability.ie>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: man page for smp(4) is short on details
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         41166
>Category:       docs
>Synopsis:       man page for smp(4) is short on details
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jul 30 11:30:01 PDT 2002
>Closed-Date:    Mon Dec 23 15:45:39 PST 2002
>Last-Modified:  Mon Dec 23 15:45:39 PST 2002
>Originator:     Nick Hilliard
>Release:        FreeBSD 4.6-RELEASE-p2 i386
>Organization:
Network Ability Ltd.
>Environment:
System: FreeBSD flapjack.netability.ie 4.6-RELEASE-p2 FreeBSD 4.6-RELEASE-p2 #1: Sat Jul 13 22:31:25 IST 2002 nick@flapjack.netability.ie:/usr/src/sys/compile/FLAPJACK i386


>Description:

The man page for smp(4) is a little lacking in detail about FreeBSD's SMP
implementation.  The patch included below just gives some details on how to
enable SMP, and points the user at the handbook.

>How-To-Repeat:

>Fix:

--- smp.4.orig	Fri Aug 17 14:08:39 2001
+++ smp.4	Tue Jul 30 15:00:57 2002
@@ -34,23 +34,40 @@
 .Sh DESCRIPTION
 The
 .Nm
-kernel implements symmetric multiprocessor support.
+kernel implements symmetric multiprocessor support.  This functionality can
+be enabled in FreeBSD by compiling a kernel with the the following options
+enabled:
+.Bd -literal -offset indent
+options         SMP
+options         APIC_IO
+.Ed
+.Pp
+Further information on compiling custom kernels can be found in the FreeBSD
+Handbook.
 .Sh COMPATIBILITY
 The
 .Nm
 kernel supports motherboards that follow the Intel MP specification,
 version 1.4.
 .Sh BUGS
-That would be a good guess...
+Certain features of APM (Advanced Power Management) are known to interact
+badly with
+.Nm .
+APM shutdown is generally safe, but other APM features should be avoided.
+This is not a FreeBSD-specific problem, but is due to the fact that APM
+was not designed with
+.Nm
+in mind.
 .Sh SEE ALSO
 .Xr mptable 1 ,
-.Xr dmesg 8
+.Xr dmesg 8 ,
+.Xr config 8 .
 .Sh HISTORY
 The
 .Nm
 kernel's early history is not (properly) recorded.  It was developed
 in a separate CVS branch until April 26, 1997, at which point it was
-merged into 3.0-current.  By this date 3.0-current had already been
-merged with Lite2 kernel code.
+merged into 3.0-current.  FreeBSD 3.0 was the first major release to support
+.Nm .
 .Sh AUTHORS
 .An Steve Passe Aq fsmp@FreeBSD.org


>Release-Note:
>Audit-Trail:

From: Chris Pepper <pepper@reppep.com>
To: Nick Hilliard <nick-lists@netability.ie>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/41166: man page for smp(4) is short on details
Date: Tue, 30 Jul 2002 15:32:18 -0400

 	Double 'the'
 
 >+be enabled in FreeBSD by compiling a kernel with the the following options
 >+enabled:
 
 
 						Chris Pepper
 
 At 3:05 PM +0100 2002/07/30, Nick Hilliard wrote:
 >  >Number:         41166
 >>Category:       docs
 >>Synopsis:       man page for smp(4) is short on details
 >>Confidential:   no
 >>Severity:       non-critical
 >>Priority:       low
 >>Responsible:    freebsd-doc
 >>State:          open
 >>Quarter:       
 >>Keywords:      
 >>Date-Required:
 >>Class:          update
 >>Submitter-Id:   current-users
 >>Arrival-Date:   Tue Jul 30 11:30:01 PDT 2002
 >>Closed-Date:
 >>Last-Modified:
 >>Originator:     Nick Hilliard
 >>Release:        FreeBSD 4.6-RELEASE-p2 i386
 >>Organization:
 >Network Ability Ltd.
 >>Environment:
 >System: FreeBSD flapjack.netability.ie 4.6-RELEASE-p2 FreeBSD 
 >4.6-RELEASE-p2 #1: Sat Jul 13 22:31:25 IST 2002 
 >nick@flapjack.netability.ie:/usr/src/sys/compile/FLAPJACK i386
 >
 >
 >>Description:
 >
 >The man page for smp(4) is a little lacking in detail about FreeBSD's SMP
 >implementation.  The patch included below just gives some details on how to
 >enable SMP, and points the user at the handbook.
 >
 >>How-To-Repeat:
 >
 >>Fix:
 >
 >--- smp.4.orig	Fri Aug 17 14:08:39 2001
 >+++ smp.4	Tue Jul 30 15:00:57 2002
 >@@ -34,23 +34,40 @@
 >  .Sh DESCRIPTION
 >  The
 >  .Nm
 >-kernel implements symmetric multiprocessor support.
 >+kernel implements symmetric multiprocessor support.  This functionality can
 >+be enabled in FreeBSD by compiling a kernel with the the following options
 >+enabled:
 
 -- 
 Chris Pepper:               <http://www.reppep.com/~pepper/>
 Rockefeller University:     <http://www.rockefeller.edu/>
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Mon Dec 23 15:44:52 PST 2002 
State-Changed-Why:  
Alot better patch was committed to the smp(4) manual page recently.  A few 
things you have listed here were added at that time.  Thanks for the 
submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=41166 
>Unformatted:
