mdoc(7) police: formatting fixes.

This commit is contained in:
Ruslan Ermilov 2001-07-06 08:10:59 +00:00
parent 53e6653d10
commit 87b6284a2d
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=79352

View File

@ -48,7 +48,9 @@ from Intel.
.Sh ENVIRONMENT
This support is still experimental, and thus there are many debugging
and tuning options which are managed via the kernel environment
space, and set in the loader before booting the kernel.
space, and set in the
.Xr loader 8
before booting the kernel.
.Pp
Debugging is separated between layers and levels, where a layer is
a portion of the ACPI subsystem, and a level is a particular kind
@ -60,122 +62,125 @@ tokens, with layers listed in
and levels in
.Va debug.acpi.level .
The supported layers are:
.Bl -bullet -offset indent -compact
.Pp
.Bl -item -offset indent -compact
.It
ACPI_UTILITIES
.Li ACPI_UTILITIES
.It
ACPI_HARDWARE
.Li ACPI_HARDWARE
.It
ACPI_EVENTS
.Li ACPI_EVENTS
.It
ACPI_TABLES
.Li ACPI_TABLES
.It
ACPI_NAMESPACE
.Li ACPI_NAMESPACE
.It
ACPI_PARSER
.Li ACPI_PARSER
.It
ACPI_DISPATCHER
.Li ACPI_DISPATCHER
.It
ACPI_EXECUTER
.Li ACPI_EXECUTER
.It
ACPI_RESOURCES
.Li ACPI_RESOURCES
.It
ACPI_POWER
.Li ACPI_POWER
.It
ACPI_BUS
.Li ACPI_BUS
.It
ACPI_POWER
.Li ACPI_POWER
.It
ACPI_EC
.Li ACPI_EC
.It
ACPI_PROCESSOR
.Li ACPI_PROCESSOR
.It
ACPI_AC_ADAPTER
.Li ACPI_AC_ADAPTER
.It
ACPI_BATTERY
.Li ACPI_BATTERY
.It
ACPI_BUTTON
.Li ACPI_BUTTON
.It
ACPI_SYSTEM
.Li ACPI_SYSTEM
.It
ACPI_THERMAL
.Li ACPI_THERMAL
.It
ACPI_DEBUGGER
.Li ACPI_DEBUGGER
.It
ACPI_OS_SERVICES
.Li ACPI_OS_SERVICES
.It
ACPI_ALL_COMPONENTS
.Li ACPI_ALL_COMPONENTS
.El
.Pp
The supported levels are:
.Bl -bullet -offset indent -compact
.Pp
.Bl -item -offset indent -compact
.It
ACPI_OK
.Li ACPI_OK
.It
ACPI_INFO
.Li ACPI_INFO
.It
ACPI_WARN
.Li ACPI_WARN
.It
ACPI_ERROR
.Li ACPI_ERROR
.It
ACPI_FATAL
.Li ACPI_FATAL
.It
ACPI_DEBUG_OBJECT
.Li ACPI_DEBUG_OBJECT
.It
ACPI_ALL
.Li ACPI_ALL
.It
TRACE_THREADS
.Li TRACE_THREADS
.It
TRACE_PARSE
.Li TRACE_PARSE
.It
TRACE_DISPATCH
.Li TRACE_DISPATCH
.It
TRACE_LOAD
.Li TRACE_LOAD
.It
TRACE_EXEC
.Li TRACE_EXEC
.It
TRACE_NAMES
.Li TRACE_NAMES
.It
TRACE_OPREGION
.Li TRACE_OPREGION
.It
TRACE_BFIELD
.Li TRACE_BFIELD
.It
TRACE_TRASH
.Li TRACE_TRASH
.It
TRACE_TABLES
.Li TRACE_TABLES
.It
TRACE_FUNCTIONS
.Li TRACE_FUNCTIONS
.It
TRACE_VALUES
.Li TRACE_VALUES
.It
TRACE_OBJECTS
.Li TRACE_OBJECTS
.It
TRACE_ALLOCATIONS
.Li TRACE_ALLOCATIONS
.It
TRACE_RESOURCES
.Li TRACE_RESOURCES
.It
TRACE_IO
.Li TRACE_IO
.It
TRACE_INTERRUPTS
.Li TRACE_INTERRUPTS
.It
TRACE_USER_REQUESTS
.Li TRACE_USER_REQUESTS
.It
TRACE_PACKAGE
.Li TRACE_PACKAGE
.It
TRACE_MUTEX
.Li TRACE_MUTEX
.It
TRACE_INIT
.Li TRACE_INIT
.It
TRACE_ALL
.Li TRACE_ALL
.It
VERBOSE_AML_DISASSEMBLE
.Li VERBOSE_AML_DISASSEMBLE
.It
VERBOSE_INFO
.Li VERBOSE_INFO
.It
VERBOSE_TABLES
.Li VERBOSE_TABLES
.It
VERBOSE_EVENTS
.Li VERBOSE_EVENTS
.It
VERBOSE_ALL
.Li VERBOSE_ALL
.El
.Pp
Selection of the appropriate layer and level values is important
@ -184,7 +189,9 @@ Check the code to see which you need.
.Pp
Debugging output by the ACPI CA subsystem is prefixed with the
module name in lowercase, followed by a source line number.
Output from the FreeBSD-local code follows the same format, but
Output from the
.Fx Ns -local
code follows the same format, but
the module name is uppercased.
.Pp
The
@ -197,43 +204,43 @@ environment variable
.Pp
ACPI sub-devices and features that can be disabled:
.Bl -tag -width processor
.It bus
.It Li bus
.Pq Vt feature
Probes and attaches subdevices.
Disabling will avoid scanning the ACPI namespace entirely.
.It children
.It Li children
.Pq Vt feature
Attaches standard ACPI sub-drivers and devices enumerated in the
ACPI namespace.
Disabling this has a similar effect to disabling
.Dq bus ,
.Dq Li bus ,
except that the
ACPI namespace will still be scanned.
.It button
.It Li button
.Pq Vt device
Supports ACPI button devices (typically power and sleep buttons).
.It ec
.It Li ec
.Pq Vt device
Supports the ACPI Embedded Controller interface, used to
communicate with embedded platform controllers.
.It isa
.It Li isa
.Pq Vt device
Supports an ISA bus bridge defined in the ACPI namespace,
typically as a child of a PCI bus.
.It lid
.It Li lid
.Pq Vt device
Supports an ACPI laptop lid switch, which typically puts a
system to sleep.
.It pci
.It Li pci
.Pq Vt device
Supports Host to PCI bridges.
.It processor
.It Li processor
.Pq Vt device
Supports CPU power-saving and speed-setting functions.
.It thermal
.It Li thermal
.Pq Vt device
Supports system cooling and heat management.
.It timer
.It Li timer
.Pq Vt device
Implements a timecounter using the ACPI fixed-frequency timer.
.El
@ -243,41 +250,36 @@ may be causing problems, by listing the full path of the root of
the region to be avoided in the kernel environment variable
.Va debug.acpi.avoid .
The object and all of its children will be ignored during the
bus/children scan of the namespace. The ACPI CA code will still
bus/children scan of the namespace.
The ACPI CA code will still
know about the avoided region.
.Sh COMPATIBILITY
ACPI is only found/supported on Intel platforms (i386/IA32 and IA64).
.Sh SEE ALSO
.Xr config 8 ,
.Xr acpi 9
.Sh AUTHOR
.Sh AUTHORS
.An -nosplit
The ACPI CA subsystem is developed and maintained by
Intel Architecture Labs.
.Pp
The following people made notable contributions to the ACPI subsystem
in
.Fx :
.Bl -bullet -offset indent -compact
.It
.An Michael Smith Aq msmith@freebsd.org ,
.It
.An Takanori Watanabe Aq takawata@jp.freebsd.org ,
.It
.An Mitsuru IWASAKI Aq iwasaki@jp.freebsd.org ,
.It
.An Michael Smith Aq msmith@FreeBSD.org ,
.An Takanori Watanabe Aq takawata@jp.FreeBSD.org ,
.An Mitsuru IWASAKI Aq iwasaki@jp.FreeBSD.org ,
.An Munehiro Matsuda ,
.It
the ACPI-jp mailing list at
.Aq acpi-jp@jp.freebsd.org ,
.It
.Aq acpi-jp@jp.FreeBSD.org ,
and many other contributors.
.El
.Pp
This manual page was written by
.An Michael Smith Aq msmith@freebsd.org .
.An Michael Smith Aq msmith@FreeBSD.org .
.Sh BUGS
The kernel device is
.Cd device acpica
for historical reasons. It will change to
for historical reasons.
It will change to
.Cd device acpi
at some time in the future.