aboutsummaryrefslogtreecommitdiff
path: root/share/man/man9/stack.9
diff options
context:
space:
mode:
Diffstat (limited to 'share/man/man9/stack.9')
-rw-r--r--share/man/man9/stack.914
1 files changed, 11 insertions, 3 deletions
diff --git a/share/man/man9/stack.9 b/share/man/man9/stack.9
index 8d03dd7bc069..65676417c0d5 100644
--- a/share/man/man9/stack.9
+++ b/share/man/man9/stack.9
@@ -1,5 +1,5 @@
.\"
-.\" Copyright (c) 2007 Robert N. M. Watson
+.\" Copyright (c) 2007-2009 Robert N. M. Watson
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
@@ -27,7 +27,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd February 27, 2007
+.Dd June 24, 2009
.Dt STACK 9
.Os
.Sh NAME
@@ -54,6 +54,10 @@ In the kernel configuration file:
.Ft void
.Fn stack_print_ddb "struct stack *st"
.Ft void
+.Fn stack_print_short "struct stack *st"
+.Ft void
+.Fn stack_print_short_ddb "struct stack *st"
+.Ft void
.Fn stack_sbuf_print "struct sbuf sb*" "struct stack *st"
.Ft void
.Fn stack_sbuf_print_ddb "struct sbuf sb*" "struct stack *st"
@@ -84,6 +88,8 @@ A trace of the current kernel thread's call stack may be captured using
.Fn stack_save .
.Pp
.Fn stack_print
+and
+.Fn stack_print_short
may be used to print a stack trace using the kernel
.Xr printf 9 ,
and may sleep as a result of acquiring
@@ -91,7 +97,9 @@ and may sleep as a result of acquiring
locks in the kernel linker while looking up symbol names.
In locking-sensitive environments, the unsynchronized
.Fn stack_print_ddb
-variant may be invoked.
+and
+.Fn stack_print_short_ddb
+variants may be invoked.
This function bypasses kernel linker locking, making it usable in
.Xr ddb 4 ,
but not in a live system where linker data structures may change.