[src/trunk]: src/share/man/man4 Mention the ACPICA debugger and the way to en...

[jruoho <jruoho%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/a5f27d618d88
branches:  trunk
changeset: 754276:a5f27d618d88
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Sun Apr 25 17:50:13 2010 +0000

description:
Mention the ACPICA debugger and the way to enter to it from ddb(4).

diffstat:

 share/man/man4/acpi.4 |  27 +++++++++++++++++++++++----
 1 files changed, 23 insertions(+), 4 deletions(-)

diffs (62 lines):

diff -r 7486470ec9a7 -r a5f27d618d88 share/man/man4/acpi.4
--- a/share/man/man4/acpi.4     Sun Apr 25 17:06:23 2010 +0000
+++ b/share/man/man4/acpi.4     Sun Apr 25 17:50:13 2010 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: acpi.4,v 1.49 2010/04/12 12:41:36 wiz Exp $
+.\" $NetBSD: acpi.4,v 1.50 2010/04/25 17:50:13 jruoho Exp $
 .\"
 .\" Copyright (c) 2002, 2004, 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd April 12, 2010
+.Dd April 25, 2010
 .Dt ACPI 4
 .Os
 .Sh NAME
@@ -238,6 +238,8 @@
 IBM/Lenovo ThinkPad laptop device driver.
 .It ug
 Abit uGuru Hardware monitor.
+.It vald
+Toshiba Libretto device.
 .It wb
 Winbond W83L518D Integrated Media Reader.
 .It wss
@@ -255,8 +257,6 @@
 Sony Miscellaneous Controller
 .It spic
 Sony programmable I/O controller.
-.It vald
-Toshiba Libretto device.
 .El
 .Sh DEBUGGING
 Although the situation has become better over the years,
@@ -335,6 +335,25 @@
 .Tn ACPI_DSDT_OVERRIDE
 in the kernel configuration file and rebuild.
 .El
+.Ss DEBUGGER
+The
+.Tn ACPICA
+interpreter provides its own debugger for low-level debugging.
+It can be used to display internal data structures and namespace objects,
+and to debug the execution of control methods.
+Single step and breakpoint functionality are available.
+In
+.Nx
+this is integrated to the in-kernel
+.Xr ddb 4 .
+In order to enter the
+.Tn ACPICA
+debugger from
+.Xr ddb 4 ,
+use the command
+.Ic call
+with the argument
+.Ic acpi_osd_debugger .
 .Ss DEBUG OUTPUT
 .Nx
 provides two