From 66f5808b81b1df84bc57c4f7b9d487201bc162fb Mon Sep 17 00:00:00 2001
From: forsyth <forsyth@vitanuova.com>
Date: Mon, 2 Aug 2010 14:49:50 +0100
Subject: 20100802-1449

---
 man/1/stack | 50 +++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 49 insertions(+), 1 deletion(-)

(limited to 'man/1')

diff --git a/man/1/stack b/man/1/stack
index c4764535..503af96e 100644
--- a/man/1/stack
+++ b/man/1/stack
@@ -1,6 +1,6 @@
 .TH STACK 1
 .SH NAME
-stack \- examine call stack
+stack, stackv \- examine call stack
 .SH SYNOPSIS
 .B "bind '#p' /prog"
 .br
@@ -14,6 +14,15 @@ stack \- examine call stack
 .I sblpath
 ]...
 .I pid
+.br
+.B stackv
+[
+.B -Tlm
+] [
+.B -r
+.I maxdepth
+] [
+.I pid\fR[\f5.\fIsym\fR] ...] ...
 .SH DESCRIPTION
 .I Stack
 writes to the standard output a stack trace for process
@@ -59,6 +68,43 @@ The
 .B -p
 options take precedence over
 .BR $sblpath .
+.PP
+.I Stackv
+recursively traverses the symbols it finds, printing
+values as it goes. Repeated identical structure is not
+shown \- only the pointer value is printed, followed by
+.BR (qv) .
+Each argument gives a starting point
+for the traversal, rooted by a process id,
+.IR pid .
+If an unadorned process id is given, all values in all
+stack frames in the process will be printed; adding names
+specifies the starting point. For instance,
+.B 123.init.ctxt.display
+might specify the
+.B display
+field inside the
+.B ctxt
+adt inside the
+.B init
+function inside the process
+.BR 123 .
+.I Stackv
+understands the following options:
+.TP 10
+.B -l
+Show source line information with each item.
+.TP
+.B -m
+Show module variables accessible from each stack frame.
+.TP
+.B -T
+Do not show the Limbo types of value encountered.
+.TP
+.BI -r \ maxdepth
+Restrict the maximum traversal depth to
+.I maxdepth
+levels.
 .SH EXAMPLE
 Run
 .I stack
@@ -111,6 +157,8 @@ $
 .BI /prog/ pid /status
 .SH SOURCE
 .B /appl/cmd/stack.b
+.br
+.B /appl/cmd/stackv.b
 .SH "SEE ALSO"
 .IR deb (1),
 .IR ps (1),
-- 
cgit v1.2.3