d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
8b72a3f693
freebsd-nq/share/man/man4/smp.4

110 lines
3.5 KiB
Groff
Raw Normal View History

Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
.\" Copyright (c) 1997
.\" Steve Passe <fsmp@FreeBSD.ORG>. All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. The name of the developer may NOT be used to endorse or promote products
.\" derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
$FreeBSD$ tags moved to bottom of license aggmt.
1999-10-30 16:05:26 +00:00
.\" SUCH DAMAGE.
Add $Id$, to make it simpler for members of the translation teams to track. The $Id$ line is normally at the bottom of the main comment block in the man page, separated from the rest of the manpage by an empty comment, like so; .\" $Id$ .\" If the immediately preceding comment is a @(#) format ID marker than the the $Id$ will line up underneath it with no intervening blank lines. Otherwise, an additional blank line is inserted. Approved by: bde
1999-07-12 21:02:10 +00:00
.\"
$Id$ -> $FreeBSD$
1999-08-28 00:22:10 +00:00
.\" $FreeBSD$
Add $Id$, to make it simpler for members of the translation teams to track. The $Id$ line is normally at the bottom of the main comment block in the man page, separated from the rest of the manpage by an empty comment, like so; .\" $Id$ .\" If the immediately preceding comment is a @(#) format ID marker than the the $Id$ will line up underneath it with no intervening blank lines. Otherwise, an additional blank line is inserted. Approved by: bde
1999-07-12 21:02:10 +00:00
.\"
Document "machdep.hlt_cpus". Reviewed by: ru
2004-12-18 01:13:37 +00:00
.Dd December 17, 2004
Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
.Dt SMP 4
mdoc(7) police: removed HISTORY info from the .Os call.
2001-07-10 15:31:11 +00:00
.Os
Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
.Sh NAME
.Nm SMP
Document "machdep.hlt_cpus". Reviewed by: ru
2004-12-18 01:13:37 +00:00
.Nd description of the FreeBSD Symmetric Multi-Processor kernel
Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
.Sh SYNOPSIS
Provide enhanced information on configuring SMP support in a kernel. Approved by: re
2002-12-07 01:50:06 +00:00
.Cd options SMP
Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
.Sh DESCRIPTION
The
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days
2001-07-14 19:41:16 +00:00
.Nm
Document "machdep.hlt_cpus". Reviewed by: ru
2004-12-18 01:13:37 +00:00
kernel implements symmetric multi-processor support.
Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
.Sh COMPATIBILITY
- Don't highlight options APIC_IO at the top since it only applies to i386 and this manpage is somewhat machine independent. - Don't redundantly say that SMP support is present for all supported architectures. Instead, say that it is present for all Tier-1 architectures. - Note that an SMP kernel not booting on a UP machine is an i386-only exception. - Add a paragraph about hyperthreading support including some docco on the machdep.hlt_logical_cpus sysctl ps@ recently added. - Note that SMP support for alpha, ia64, and sparc64 debuted in 5.0.
2003-04-21 20:05:33 +00:00
Support for multi-processor systems is present for all Tier-1
mdoc(7) police: markup nits. Approved by: re (blanket)
2002-12-09 12:28:33 +00:00
architectures on
.Fx .
Add amd64 to the list of supported platforms. PR: docs/74529 Submitted by: Jason Bacon <bacon at smithers dot neuro dot mcw dot edu>
2004-11-29 19:51:50 +00:00
Currently, this includes alpha, amd64, i386, ia64, and sparc64.
Provide enhanced information on configuring SMP support in a kernel. Approved by: re
2002-12-07 01:50:06 +00:00
Support is enabled using
.Cd options SMP .
- Update for the new interrupt code on i386 meaning that SMP kernels can now run on UP machines, options APIC_IO is now spelled device apic, and HT CPUs are now enabled by default. - Add a 'I386 NOTES' section header to the i386-specific paragraphs. Someone with more mdoc fu can suggest a better name if needed. Requested by: kris (1)
2004-03-24 17:51:54 +00:00
It is permissible to use the SMP kernel configuration on non-SMP equipped
motherboards.
.Sh I386 NOTES
Take a pass at updating this man page a bit to at least mention SMPng, that we do MP on more than just i386, and add some cross-references. This is far from a perfect update, but at least it's a start. More will no doubt follow. Reviewed by: jhb Approved by: re
2002-12-07 01:37:12 +00:00
For i386 systems, the
Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
.Nm
kernel supports motherboards that follow the Intel MP specification,
version 1.4.
Provide enhanced information on configuring SMP support in a kernel. Approved by: re
2002-12-07 01:50:06 +00:00
In addition to
.Cd options SMP ,
i386 also requires
- Update for the new interrupt code on i386 meaning that SMP kernels can now run on UP machines, options APIC_IO is now spelled device apic, and HT CPUs are now enabled by default. - Add a 'I386 NOTES' section header to the i386-specific paragraphs. Someone with more mdoc fu can suggest a better name if needed. Requested by: kris (1)
2004-03-24 17:51:54 +00:00
.Cd device apic .
Provide enhanced information on configuring SMP support in a kernel. Approved by: re
2002-12-07 01:50:06 +00:00
The
Take a pass at updating this man page a bit to at least mention SMPng, that we do MP on more than just i386, and add some cross-references. This is far from a perfect update, but at least it's a start. More will no doubt follow. Reviewed by: jhb Approved by: re
2002-12-07 01:37:12 +00:00
.Xr mptable 1
command may be used to view the status of multi-processor support.
- Don't highlight options APIC_IO at the top since it only applies to i386 and this manpage is somewhat machine independent. - Don't redundantly say that SMP support is present for all supported architectures. Instead, say that it is present for all Tier-1 architectures. - Note that an SMP kernel not booting on a UP machine is an i386-only exception. - Add a paragraph about hyperthreading support including some docco on the machdep.hlt_logical_cpus sysctl ps@ recently added. - Note that SMP support for alpha, ia64, and sparc64 debuted in 5.0.
2003-04-21 20:05:33 +00:00
.Pp
Document "machdep.hlt_cpus". Reviewed by: ru
2004-12-18 01:13:37 +00:00
The number of CPUs detected by the system is available in
the read-only sysctl variable
.Va hw.ncpu .
.Pp
.Fx
allows specific CPUs on a multi-processor system to be disabled.
The sysctl variable
.Va machdep.hlt_cpus
is an integer bitmask denoting CPUs to halt, counting from 0.
Setting a bit to 1 will result in the corresponding CPU being
disabled.
.Pp
- Don't highlight options APIC_IO at the top since it only applies to i386 and this manpage is somewhat machine independent. - Don't redundantly say that SMP support is present for all supported architectures. Instead, say that it is present for all Tier-1 architectures. - Note that an SMP kernel not booting on a UP machine is an i386-only exception. - Add a paragraph about hyperthreading support including some docco on the machdep.hlt_logical_cpus sysctl ps@ recently added. - Note that SMP support for alpha, ia64, and sparc64 debuted in 5.0.
2003-04-21 20:05:33 +00:00
.Fx
supports hyperthreading on Intel CPU's on the i386 platform.
- Update for the new interrupt code on i386 meaning that SMP kernels can now run on UP machines, options APIC_IO is now spelled device apic, and HT CPUs are now enabled by default. - Add a 'I386 NOTES' section header to the i386-specific paragraphs. Someone with more mdoc fu can suggest a better name if needed. Requested by: kris (1)
2004-03-24 17:51:54 +00:00
Since using logical CPUs can cause performance penalties under certain loads,
Assorted markup, spelling, and grammar fixes.
2004-06-16 08:33:57 +00:00
the logical CPUs can be disabled by setting the
- Don't highlight options APIC_IO at the top since it only applies to i386 and this manpage is somewhat machine independent. - Don't redundantly say that SMP support is present for all supported architectures. Instead, say that it is present for all Tier-1 architectures. - Note that an SMP kernel not booting on a UP machine is an i386-only exception. - Add a paragraph about hyperthreading support including some docco on the machdep.hlt_logical_cpus sysctl ps@ recently added. - Note that SMP support for alpha, ia64, and sparc64 debuted in 5.0.
2003-04-21 20:05:33 +00:00
.Va machdep.hlt_logical_cpus
- Update for the new interrupt code on i386 meaning that SMP kernels can now run on UP machines, options APIC_IO is now spelled device apic, and HT CPUs are now enabled by default. - Add a 'I386 NOTES' section header to the i386-specific paragraphs. Someone with more mdoc fu can suggest a better name if needed. Requested by: kris (1)
2004-03-24 17:51:54 +00:00
sysctl to one.
Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
.Sh SEE ALSO
Sort cross refereces in section SEE ALSO.
1997-09-29 10:11:02 +00:00
.Xr mptable 1 ,
Document "machdep.hlt_cpus". Reviewed by: ru
2004-12-18 01:13:37 +00:00
.Xr sysctl 8 ,
Take a pass at updating this man page a bit to at least mention SMPng, that we do MP on more than just i386, and add some cross-references. This is far from a perfect update, but at least it's a start. More will no doubt follow. Reviewed by: jhb Approved by: re
2002-12-07 01:37:12 +00:00
.Xr condvar 9 ,
.Xr msleep 9 ,
.Xr mtx_pool 9 ,
.Xr mutex 9 ,
.Xr sema 9 ,
.Xr sx 9
Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
.Sh HISTORY
The
.Nm
Hiten's patchset for section four manpages, slightly edited by me.
2003-06-28 23:53:39 +00:00
kernel's early history is not (properly) recorded.
It was developed
Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
in a separate CVS branch until April 26, 1997, at which point it was
Hiten's patchset for section four manpages, slightly edited by me.
2003-06-28 23:53:39 +00:00
merged into 3.0-current.
By this date 3.0-current had already been
Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
merged with Lite2 kernel code.
Take a pass at updating this man page a bit to at least mention SMPng, that we do MP on more than just i386, and add some cross-references. This is far from a perfect update, but at least it's a start. More will no doubt follow. Reviewed by: jhb Approved by: re
2002-12-07 01:37:12 +00:00
.Pp
.Fx 5.0
introduced support for a host of new synchronization primitives, and
a move towards fine-grained kernel locking rather than reliance on
a Giant kernel lock.
The SMPng Project relied heavily on the support of BSDi, who provided
reference source code from the fine-grained SMP implementation found
mdoc(7) police: markup nits. Approved by: re (blanket)
2002-12-09 12:28:33 +00:00
in
.Bsx .
- Don't highlight options APIC_IO at the top since it only applies to i386 and this manpage is somewhat machine independent. - Don't redundantly say that SMP support is present for all supported architectures. Instead, say that it is present for all Tier-1 architectures. - Note that an SMP kernel not booting on a UP machine is an i386-only exception. - Add a paragraph about hyperthreading support including some docco on the machdep.hlt_logical_cpus sysctl ps@ recently added. - Note that SMP support for alpha, ia64, and sparc64 debuted in 5.0.
2003-04-21 20:05:33 +00:00
.Pp
.Fx 5.0
also introduced support for SMP on the alpha, ia64, and sparc64 architectures.
Added missing SMP kernel manpage. Mostly a stub at this point, needs alot of work. Noticed by: Steve Roome steve@visint.co.uk
1997-08-04 21:02:11 +00:00
.Sh AUTHORS
.Sh AUTHOR -> .Sh AUTHORS according to mdoc specs. Use .An/.Aq.
1998-03-12 07:31:21 +00:00
.An Steve Passe Aq fsmp@FreeBSD.org
Reference in New Issue Copy Permalink