freebsd-skq/usr.sbin/mptable/mptable.1

.\" Copyright (c) 1996
.\"	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
.\" SUCH DAMAGE.
.\"
.\" $FreeBSD$
.\"
.Dd April 28, 1997
.Dt MPTABLE 1
.Os
.Sh NAME
.Nm mptable
.Nd display MP configuration table
.Sh SYNOPSIS
.Nm
.Op Fl dmesg
.Op Fl verbose
.Op Fl grope
.Op Fl help
.Sh DESCRIPTION
The
.Nm
command finds and analyzes the MP configuration table on
an Intel(tm) MP spec capable motherboard.
It is useful for debugging an SMP kernel that will not boot, as well
as examining the configuration of a system.
It can be run with a UniProcessor kernel.
.Pp
It must be run with gid kmem privileges.
.Pp
The following options are available:
.Bl -tag -width indent
.It Fl dmesg
Include a dmesg dump.
.It Fl grope
Look in areas it should not NEED to, use ONLY as a last resort.
.It Fl help
Print a usage message and exits.
.It Fl verbose
Print extra info.
.El
.Sh SEE ALSO
.Xr smp 4 ,
.Xr dmesg 8
.Sh HISTORY
The
.Nm
command first appeared in
.Fx 3.0 .
.Sh AUTHORS
.An Steve Passe Aq fsmp@FreeBSD.org
add a userland program for SMP support mptable examines and displays the MP table of an SMP motherboard. 1997-04-29 03:06:35 +00:00			`.\" Copyright (c) 1996`
mdoc: consistently spell our email addresses <foo@FreeBSD.org> Reviewed by: ru 2010-05-19 08:57:53 +00:00			`.\" Steve Passe <fsmp@FreeBSD.org>. All rights reserved.`
add a userland program for SMP support mptable examines and displays the MP table of an SMP motherboard. 1997-04-29 03:06:35 +00:00			`.\"`
			`.\" 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 20:12:29 +00:00			`.\"`
$Id$ -> $FreeBSD$ 1999-08-28 01:35:59 +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 20:12:29 +00:00			`.\"`
add a userland program for SMP support mptable examines and displays the MP table of an SMP motherboard. 1997-04-29 03:06:35 +00:00			`.Dd April 28, 1997`
			`.Dt MPTABLE 1`
			`.Os`
			`.Sh NAME`
			`.Nm mptable`
Use err(3). Add missing parameter for printf() (reviewed by steve). 1997-09-25 06:47:33 +00:00			`.Nd display MP configuration table`
add a userland program for SMP support mptable examines and displays the MP table of an SMP motherboard. 1997-04-29 03:06:35 +00:00			`.Sh SYNOPSIS`
mdoc(7) police: use the new features of the Nm macro. 2000-11-20 20:10:44 +00:00			`.Nm`
Use err(3). Add missing parameter for printf() (reviewed by steve). 1997-09-25 06:47:33 +00:00			`.Op Fl dmesg`
			`.Op Fl verbose`
			`.Op Fl grope`
			`.Op Fl help`
add a userland program for SMP support mptable examines and displays the MP table of an SMP motherboard. 1997-04-29 03:06:35 +00:00			`.Sh DESCRIPTION`
			`The`
			`.Nm`
			`command finds and analyzes the MP configuration table on`
			`an Intel(tm) MP spec capable motherboard.`
Update the mptable manpage to remove mention of kernel options (which there aren't going to be shortly). 2000-09-22 21:10:41 +00:00			`It is useful for debugging an SMP kernel that will not boot, as well`
			`as examining the configuration of a system.`
			`It can be run with a UniProcessor kernel.`
add a userland program for SMP support mptable examines and displays the MP table of an SMP motherboard. 1997-04-29 03:06:35 +00:00			`.Pp`
o Remove BINMODE=0550 -- no need to restrict execution rights as the authorization check is on /dev/{,k}mem. o Update man page to reflect requirement that gid kmem privileges must be held, not root. (submitted by: peter) 2001-03-22 04:27:46 +00:00			`It must be run with gid kmem privileges.`
add a userland program for SMP support mptable examines and displays the MP table of an SMP motherboard. 1997-04-29 03:06:35 +00:00			`.Pp`
Use err(3). Add missing parameter for printf() (reviewed by steve). 1997-09-25 06:47:33 +00:00			`The following options are available:`
			`.Bl -tag -width indent`
			`.It Fl dmesg`
			`Include a dmesg dump.`
			`.It Fl grope`
Expand *n't contractions. 2005-02-13 22:25:33 +00:00			`Look in areas it should not NEED to, use ONLY as a last resort.`
Use err(3). Add missing parameter for printf() (reviewed by steve). 1997-09-25 06:47:33 +00:00			`.It Fl help`
			`Print a usage message and exits.`
			`.It Fl verbose`
			`Print extra info.`
			`.El`
add a userland program for SMP support mptable examines and displays the MP table of an SMP motherboard. 1997-04-29 03:06:35 +00:00			`.Sh SEE ALSO`
			`.Xr smp 4 ,`
			`.Xr dmesg 8`
			`.Sh HISTORY`
			`The`
			`.Nm`
			`command first appeared in`
			`.Fx 3.0 .`
			`.Sh AUTHORS`
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq. 1998-03-23 08:31:20 +00:00			`.An Steve Passe Aq fsmp@FreeBSD.org`