Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Sort sections. 

Remove dot at end of Nd
Sort SEE ALSO.
Punctuation fixes.
Bump date to import date.
Comment out a partial sentence.
This commit is contained in:
wiz 2012-05-27 12:03:02 +00:00
parent f2a0d89379
commit 32778414ba
1 changed files with 20 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
lib/libexecinfo/backtrace.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: backtrace.3,v 1.1 2012/05/26 22:02:29 christos Exp $
.\" $NetBSD: backtrace.3,v 1.2 2012/05/27 12:03:02 wiz Exp $
.\"
.\" Copyright (c) 2012 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -27,12 +27,12 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd January 24, 2012
.Dd May 26, 2012
.Dt BACKTRACE 3
.Os
.Sh NAME
.Nm backtrace
.Nd fill in the backtrace of the currently executing thread.
.Nd fill in the backtrace of the currently executing thread
.Sh LIBRARY
.Lb libexecinfo
.Sh SYNOPSIS
@ -61,7 +61,7 @@ is returned.
.Pp
The
.Fn backtrace_symbols_fmt
function, takes an array of previously filled addresses from
function takes an array of previously filled addresses from
.Fn backtrace
in
.Fa addrlist
@ -126,8 +126,17 @@ return a string array on success, and
on failure, setting
.Va errno .
.\" XXX
Diagnostic output may also be produced, by the ELF symbol lookup functions.
function returns a pointer to a string that is the parent directory of
Diagnostic output may also be produced by the ELF symbol lookup functions.
.\" XXX: what's this?
.\" function returns a pointer to a string that is the parent directory of
.Sh SEE ALSO
.Xr dladdr 3 ,
.Xr elf 3
.Sh HISTORY
The
.Fn backtrace
library of functions first appeared in
.Nx 6 .
.Sh BUGS
.Bl -enum
.It
@ -135,10 +144,10 @@ Errors should not be printed but communicated to the caller differently.
.It
Because these functions use
.Xr elf 3
this is a separate library instead of be part of libc/libutil so that library
dependencies are not introduced.
this is a separate library instead of being part of libc/libutil
so that no library dependencies are introduced.
.It
The linux versions of the functions (there are no _fmt variants), use
The Linux versions of the functions (there are no _fmt variants) use
.Ft int
instead of
.Ft size_t
@ -148,14 +157,6 @@ Since
.Xr dladdr 3
only deals with dynamic symbols, we need to find the symbols from the main
portion of the program.
For that we need to locate the executable, and we use procfs for to find it
which is not portable.
For that we need to locate the executable, and we use procfs for
finding it, which is not portable.
.El
.Sh SEE ALSO
.Xr elf 3
.Xr dladdr 3
.Sh HISTORY
The
.Fn backtrace
library of functions first appeared in
.Nx 6 .