mirror of
https://github.com/tobast/libunwind-eh_elf.git
synced 2024-12-23 03:53:43 +01:00
Initial revision
This commit is contained in:
parent
38ec048c0d
commit
0dd785f10b
12 changed files with 0 additions and 1176 deletions
|
@ -1,97 +0,0 @@
|
|||
'\" t
|
||||
.\" Manual page created with latex2man on Wed Mar 12 14:44:22 PST 2003
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
||||
.de Vb
|
||||
.ft CW
|
||||
.nf
|
||||
..
|
||||
.de Ve
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
.TH "UNW\\_FLUSH\\_CACHE" "3" "12 March 2003" "Programming Library " "Programming Library "
|
||||
.SH NAME
|
||||
|
||||
.PP
|
||||
unw_flush_cache \-\- flush cached info
|
||||
.PP
|
||||
.SH SYNOPSIS
|
||||
|
||||
.PP
|
||||
#include <libunwind.h>
|
||||
.br
|
||||
.PP
|
||||
void
|
||||
unw_flush_cache(unw_addr_space_t
|
||||
as,
|
||||
unw_word_t
|
||||
lo,
|
||||
unw_word_t
|
||||
hi);
|
||||
.br
|
||||
.PP
|
||||
.SH DESCRIPTION
|
||||
|
||||
.PP
|
||||
The unw_flush_cache()
|
||||
routine flushes all cached info as it
|
||||
relates to address\-range lo
|
||||
to hi
|
||||
(non\-inclusive) in the
|
||||
target address\-space as\&.
|
||||
In addition, all info cached for
|
||||
address\-space as
|
||||
that is not tied to a particular code\-range is
|
||||
also flushed. For example, the address of the dynamic registration
|
||||
list is not tied to a code\-range and its cached value (if any) is
|
||||
flushed by a call to this routine. The address range specified by
|
||||
lo
|
||||
and hi
|
||||
should be understood as a hint:
|
||||
unw_flush_cache()
|
||||
may flush more information than requested,
|
||||
but \fInever\fP
|
||||
less. In other words, unw_flush_cache()
|
||||
may
|
||||
overflush, but not underflush.
|
||||
.PP
|
||||
As a special case, if arguments lo
|
||||
and hi
|
||||
are both 0, all
|
||||
information cached on behalf of address space as
|
||||
is flushed.
|
||||
.PP
|
||||
.SH RETURN VALUE
|
||||
|
||||
.PP
|
||||
The unw_flush_cache()
|
||||
routine cannot fail and does not
|
||||
return a value.
|
||||
.PP
|
||||
.SH THREAD AND SIGNAL SAFETY
|
||||
|
||||
.PP
|
||||
The unw_flush_cache()
|
||||
routine is thread\-safe as well as safe to
|
||||
use from a signal handler.
|
||||
.PP
|
||||
.SH SEE ALSO
|
||||
|
||||
.PP
|
||||
libunwind(3),
|
||||
unw_set_caching_policy(3)
|
||||
.PP
|
||||
.SH AUTHOR
|
||||
|
||||
.PP
|
||||
David Mosberger\-Tang
|
||||
.br
|
||||
Hewlett\-Packard Labs
|
||||
.br
|
||||
Palo\-Alto, CA 94304
|
||||
.br
|
||||
Email: \fBdavidm@hpl.hp.com\fP
|
||||
.br
|
||||
WWW: \fBhttp://www.hpl.hp.com/research/linux/libunwind/\fP\&.
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
|
@ -1,61 +0,0 @@
|
|||
\documentclass{article}
|
||||
\usepackage[fancyhdr,pdf]{latex2man}
|
||||
|
||||
\input{common.tex}
|
||||
|
||||
\begin{document}
|
||||
|
||||
\begin{Name}{3}{unw\_flush\_cache}{David Mosberger-Tang}{Programming Library}{unw\_flush\_cache}
|
||||
|
||||
unw\_flush\_cache -- flush cached info
|
||||
\end{Name}
|
||||
|
||||
\section{Synopsis}
|
||||
|
||||
\File{\#include $<$libunwind.h$>$}\\
|
||||
|
||||
\Type{void} \Func{unw\_flush\_cache}(\Type{unw\_addr\_space\_t} \Var{as}, \Type{unw\_word\_t} \Var{lo}, \Type{unw\_word\_t} \Var{hi});\\
|
||||
|
||||
\section{Description}
|
||||
|
||||
The \Func{unw\_flush\_cache}() routine flushes all cached info as it
|
||||
relates to address-range \Var{lo} to \Var{hi} (non-inclusive) in the
|
||||
target address-space \Var{as}. In addition, all info cached for
|
||||
address-space \Var{as} that is not tied to a particular code-range is
|
||||
also flushed. For example, the address of the dynamic registration
|
||||
list is not tied to a code-range and its cached value (if any) is
|
||||
flushed by a call to this routine. The address range specified by
|
||||
\Var{lo} and \Var{hi} should be understood as a hint:
|
||||
\Func{unw\_flush\_cache}() may flush more information than requested,
|
||||
but \emph{never} less. In other words, \Func{unw\_flush\_cache}() may
|
||||
overflush, but not underflush.
|
||||
|
||||
As a special case, if arguments \Var{lo} and \Var{hi} are both 0, all
|
||||
information cached on behalf of address space \Var{as} is flushed.
|
||||
|
||||
\section{Return Value}
|
||||
|
||||
The \Func{unw\_flush\_cache}() routine cannot fail and does not
|
||||
return a value.
|
||||
|
||||
\section{Thread and Signal Safety}
|
||||
|
||||
The \Func{unw\_flush\_cache}() routine is thread-safe as well as safe to
|
||||
use from a signal handler.
|
||||
|
||||
\section{See Also}
|
||||
|
||||
\SeeAlso{libunwind(3)},
|
||||
\SeeAlso{unw\_set\_caching\_policy(3)}
|
||||
|
||||
\section{Author}
|
||||
|
||||
\noindent
|
||||
David Mosberger-Tang\\
|
||||
Hewlett-Packard Labs\\
|
||||
Palo-Alto, CA 94304\\
|
||||
Email: \Email{davidm@hpl.hp.com}\\
|
||||
WWW: \URL{http://www.hpl.hp.com/research/linux/libunwind/}.
|
||||
\LatexManEnd
|
||||
|
||||
\end{document}
|
|
@ -1,84 +0,0 @@
|
|||
'\" t
|
||||
.\" Manual page created with latex2man on Wed Mar 12 14:20:21 PST 2003
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
||||
.de Vb
|
||||
.ft CW
|
||||
.nf
|
||||
..
|
||||
.de Ve
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
.TH "UNW\\_GET\\_ACCESSORS" "3" "12 March 2003" "Programming Library " "Programming Library "
|
||||
.SH NAME
|
||||
|
||||
.PP
|
||||
unw_get_accessors \-\- get pointer to accessor call\-backs
|
||||
.PP
|
||||
.SH SYNOPSIS
|
||||
|
||||
.PP
|
||||
#include <libunwind.h>
|
||||
.br
|
||||
.PP
|
||||
unw_accessors_t *unw_get_accessors(unw_addr_space_t as);
|
||||
.br
|
||||
.PP
|
||||
.SH DESCRIPTION
|
||||
|
||||
.PP
|
||||
The unw_get_accessors()
|
||||
routine returns a pointer to a
|
||||
unw_accessors_t
|
||||
structure, which contains the call\-back
|
||||
routines that were specified when address space as
|
||||
was created
|
||||
(see unw_create_addr_space(3)).
|
||||
The returned pointer is
|
||||
guaranteed to remain valid until address space as
|
||||
is destroyed
|
||||
by a call to unw_destroy_addr_space(3).
|
||||
.PP
|
||||
Note that unw_get_accessors()
|
||||
can be used to retrieve the
|
||||
call\-back routines for the local address space
|
||||
unw_local_addr_space\&.
|
||||
.PP
|
||||
.SH RETURN VALUE
|
||||
|
||||
.PP
|
||||
The unw_get_accessors()
|
||||
routine cannot fail and always
|
||||
returns a valid (non\-NULL)
|
||||
pointer to an
|
||||
unw_accessors_t
|
||||
structure.
|
||||
.PP
|
||||
.SH THREAD AND SIGNAL SAFETY
|
||||
|
||||
.PP
|
||||
The unw_get_accessors()
|
||||
routine is thread\-safe as well as
|
||||
safe to use from a signal handler.
|
||||
.PP
|
||||
.SH SEE ALSO
|
||||
|
||||
.PP
|
||||
libunwind(3),
|
||||
unw_create_addr_space(3),
|
||||
unw_destroy_addr_space(3)
|
||||
.PP
|
||||
.SH AUTHOR
|
||||
|
||||
.PP
|
||||
David Mosberger\-Tang
|
||||
.br
|
||||
Hewlett\-Packard Labs
|
||||
.br
|
||||
Palo\-Alto, CA 94304
|
||||
.br
|
||||
Email: \fBdavidm@hpl.hp.com\fP
|
||||
.br
|
||||
WWW: \fBhttp://www.hpl.hp.com/research/linux/libunwind/\fP\&.
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
|
@ -1,59 +0,0 @@
|
|||
\documentclass{article}
|
||||
\usepackage[fancyhdr,pdf]{latex2man}
|
||||
|
||||
\input{common.tex}
|
||||
|
||||
\begin{document}
|
||||
|
||||
\begin{Name}{3}{unw\_get\_accessors}{David Mosberger-Tang}{Programming Library}{unw\_get\_accessors}
|
||||
|
||||
unw\_get\_accessors -- get pointer to accessor call-backs
|
||||
\end{Name}
|
||||
|
||||
\section{Synopsis}
|
||||
|
||||
\File{\#include $<$libunwind.h$>$}\\
|
||||
|
||||
\Type{unw\_accessors\_t~*}\Func{unw\_get\_accessors}(\Type{unw\_addr\_space\_t~}\Var{as});\\
|
||||
|
||||
\section{Description}
|
||||
|
||||
The \Func{unw\_get\_accessors}() routine returns a pointer to a
|
||||
\Type{unw\_accessors\_t} structure, which contains the call-back
|
||||
routines that were specified when address space \Var{as} was created
|
||||
(see \Func{unw\_create\_addr\_space}(3)). The returned pointer is
|
||||
guaranteed to remain valid until address space \Var{as} is destroyed
|
||||
by a call to \Func{unw\_destroy\_addr\_space}(3).
|
||||
|
||||
Note that \Func{unw\_get\_accessors}() can be used to retrieve the
|
||||
call-back routines for the local address space
|
||||
\Var{unw\_local\_addr\_space}.
|
||||
|
||||
\section{Return Value}
|
||||
|
||||
The \Func{unw\_get\_accessors}() routine cannot fail and always
|
||||
returns a valid (non-\Const{NULL}) pointer to an
|
||||
\Type{unw\_accessors\_t} structure.
|
||||
|
||||
\section{Thread and Signal Safety}
|
||||
|
||||
The \Func{unw\_get\_accessors}() routine is thread-safe as well as
|
||||
safe to use from a signal handler.
|
||||
|
||||
\section{See Also}
|
||||
|
||||
\SeeAlso{libunwind(3)},
|
||||
\SeeAlso{unw\_create\_addr\_space(3)},
|
||||
\SeeAlso{unw\_destroy\_addr\_space(3)}
|
||||
|
||||
\section{Author}
|
||||
|
||||
\noindent
|
||||
David Mosberger-Tang\\
|
||||
Hewlett-Packard Labs\\
|
||||
Palo-Alto, CA 94304\\
|
||||
Email: \Email{davidm@hpl.hp.com}\\
|
||||
WWW: \URL{http://www.hpl.hp.com/research/linux/libunwind/}.
|
||||
\LatexManEnd
|
||||
|
||||
\end{document}
|
|
@ -1,206 +0,0 @@
|
|||
'\" t
|
||||
.\" Manual page created with latex2man on Wed Mar 12 12:27:22 PST 2003
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
||||
.de Vb
|
||||
.ft CW
|
||||
.nf
|
||||
..
|
||||
.de Ve
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
.TH "UNW\\_GET\\_PROC\\_INFO" "3" "12 March 2003" "Programming Library " "Programming Library "
|
||||
.SH NAME
|
||||
|
||||
.PP
|
||||
unw_get_proc_info \-\- get info on current procedure
|
||||
.PP
|
||||
.SH SYNOPSIS
|
||||
|
||||
.PP
|
||||
#include <libunwind.h>
|
||||
.br
|
||||
.PP
|
||||
int
|
||||
unw_get_proc_info(unw_cursor_t *cp,
|
||||
unw_proc_info_t *pip);
|
||||
.br
|
||||
.PP
|
||||
.SH DESCRIPTION
|
||||
|
||||
.PP
|
||||
The unw_get_proc_info()
|
||||
routine returns auxiliary
|
||||
information about the procedure that created the stack frame
|
||||
identified by argument cp\&.
|
||||
The pip
|
||||
argument is a pointer
|
||||
to a structure of type unw_proc_info_t
|
||||
which is used to
|
||||
return the information. The unw_proc_info_t
|
||||
has the
|
||||
following members:
|
||||
.TP
|
||||
unw_word_t start_ip
|
||||
The address of the first
|
||||
instruction of the procedure. If this address cannot be determined
|
||||
(e.g., due to lack of unwind information), the start_ip
|
||||
member is cleared to 0.
|
||||
.br
|
||||
.TP
|
||||
unw_word_t end_ip
|
||||
The address of the first
|
||||
instruction \fIbeyond\fP
|
||||
the end of the procedure. If this address
|
||||
cannot be determined (e.g., due to lack of unwind information),
|
||||
the end_ip
|
||||
member is cleared to 0.
|
||||
.br
|
||||
.TP
|
||||
unw_word_t lsda
|
||||
The address of the
|
||||
language\-specific data\-area (LSDA). This area normally contains
|
||||
language\-specific information needed during exception handling. If
|
||||
the procedure has no such area, this member is cleared to 0.
|
||||
.br
|
||||
.TP
|
||||
unw_word_t handler
|
||||
The address of the exception
|
||||
handler routine. This is sometimes called the \fIpersonality\fP
|
||||
routine. If the procedure does not define
|
||||
a personality routine, the handler
|
||||
member is cleared to 0.
|
||||
.br
|
||||
.TP
|
||||
unw_word_t gp
|
||||
The global\-pointer of the
|
||||
procedure. On platforms that do not use a global pointer, this
|
||||
member may contain an undefined value. On all other platforms, it
|
||||
must be set either to the correct global\-pointer value of the
|
||||
procedure or to 0 if the proper global\-pointer cannot be
|
||||
obtained for some reason.
|
||||
.br
|
||||
.TP
|
||||
unw_word_t flags
|
||||
A set of flags. There are
|
||||
currently no target\-independent flags. For the IA\-64 target, the
|
||||
flag UNW_PI_FLAG_IA64_RBS_SWITCH
|
||||
is set if the
|
||||
procedure may switch the register\-backing store.
|
||||
.br
|
||||
.TP
|
||||
int format
|
||||
The format of the unwind\-info for this
|
||||
procedure. If the unwind\-info consists of dynamic procedure info,
|
||||
format
|
||||
is equal to UNW_INFO_FORMAT_DYNAMIC\&.
|
||||
If the
|
||||
unwind\-info consists of a (target\-specific) unwind table, it is
|
||||
equal to to UNW_INFO_FORMAT_TABLE\&.
|
||||
All other values are
|
||||
reserved for future use by libunwind\&.
|
||||
This member exists
|
||||
for use by the find_proc_info()
|
||||
call\-back (see
|
||||
unw_create_addr_space(3)).
|
||||
The
|
||||
unw_get_proc_info()
|
||||
routine
|
||||
may return an undefined value in this member.
|
||||
.br
|
||||
.TP
|
||||
int unwind_info_size
|
||||
The size of the unwind\-info
|
||||
in bytes. This member exists for use by the
|
||||
find_proc_info()
|
||||
call\-back (see
|
||||
unw_create_addr_space(3)).
|
||||
The
|
||||
unw_get_proc_info()
|
||||
routine
|
||||
may return an undefined value in this member.
|
||||
.br
|
||||
.TP
|
||||
void *unwind_info
|
||||
The pointer to the unwind\-info.
|
||||
If no unwind info is available, this member must be set to
|
||||
NULL\&.
|
||||
This member exists for use by the
|
||||
find_proc_info()
|
||||
call\-back (see
|
||||
unw_create_addr_space(3)).
|
||||
The
|
||||
unw_get_proc_info()
|
||||
routine
|
||||
may return an undefined value in this member.
|
||||
.br
|
||||
.PP
|
||||
Note that for the purposes of libunwind,
|
||||
the code of a
|
||||
procedure is assumed to occupy a single, contiguous range of
|
||||
addresses. For this reason, it is alwas possible to describe the
|
||||
extent of a procedure with the start_ip
|
||||
and end_ip
|
||||
members. If a single function/routine is split into multiple,
|
||||
discontiguous pieces, libunwind
|
||||
will treat each piece as a
|
||||
separate procedure.
|
||||
.PP
|
||||
.SH RETURN VALUE
|
||||
|
||||
.PP
|
||||
On successful completion, unw_get_proc_info()
|
||||
returns 0.
|
||||
Otherwise the negative value of one of the error\-codes below is
|
||||
returned.
|
||||
.PP
|
||||
.SH THREAD AND SIGNAL SAFETY
|
||||
|
||||
.PP
|
||||
unw_get_proc_info()
|
||||
is thread\-safe as well as safe to use
|
||||
from a signal handler.
|
||||
.PP
|
||||
.SH ERRORS
|
||||
|
||||
.PP
|
||||
.TP
|
||||
UNW_EUNSPEC
|
||||
An unspecified error occurred.
|
||||
.TP
|
||||
UNW_ENOINFO
|
||||
Libunwind
|
||||
was unable to locate
|
||||
unwind\-info for the procedure.
|
||||
.TP
|
||||
UNW_EBADVERSION
|
||||
The unwind\-info for the procedure has
|
||||
version or format that is not understood by libunwind\&.
|
||||
.PP
|
||||
In addition, unw_get_proc_info()
|
||||
may return any error
|
||||
returned by the access_mem()
|
||||
call\-back (see
|
||||
unw_create_addr_space(3)).
|
||||
.PP
|
||||
.SH SEE ALSO
|
||||
|
||||
.PP
|
||||
libunwind(3),
|
||||
unw_create_addr_space(3),
|
||||
unw_get_proc_name(3)
|
||||
.PP
|
||||
.SH AUTHOR
|
||||
|
||||
.PP
|
||||
David Mosberger\-Tang
|
||||
.br
|
||||
Hewlett\-Packard Labs
|
||||
.br
|
||||
Palo\-Alto, CA 94304
|
||||
.br
|
||||
Email: \fBdavidm@hpl.hp.com\fP
|
||||
.br
|
||||
WWW: \fBhttp://www.hpl.hp.com/research/linux/libunwind/\fP\&.
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
|
@ -1,126 +0,0 @@
|
|||
\documentclass{article}
|
||||
\usepackage[fancyhdr,pdf]{latex2man}
|
||||
|
||||
\input{common.tex}
|
||||
|
||||
\begin{document}
|
||||
|
||||
\begin{Name}{3}{unw\_get\_proc\_info}{David Mosberger-Tang}{Programming Library}{unw\_get\_proc\_info}
|
||||
|
||||
unw\_get\_proc\_info -- get info on current procedure
|
||||
\end{Name}
|
||||
|
||||
\section{Synopsis}
|
||||
|
||||
\File{\#include $<$libunwind.h$>$}\\
|
||||
|
||||
\Type{int} \Func{unw\_get\_proc\_info}(\Type{unw\_cursor\_t~*}\Var{cp}, \Type{unw\_proc\_info\_t~*}\Var{pip});\\
|
||||
|
||||
\section{Description}
|
||||
|
||||
The \Func{unw\_get\_proc\_info}() routine returns auxiliary
|
||||
information about the procedure that created the stack frame
|
||||
identified by argument \Var{cp}. The \Var{pip} argument is a pointer
|
||||
to a structure of type \Type{unw\_proc\_info\_t} which is used to
|
||||
return the information. The \Type{unw\_proc\_info\_t} has the
|
||||
following members:
|
||||
\begin{description}
|
||||
\item[\Type{unw\_word\_t} \Var{start\_ip}] The address of the first
|
||||
instruction of the procedure. If this address cannot be determined
|
||||
(e.g., due to lack of unwind information), the \Var{start\_ip}
|
||||
member is cleared to 0. \\
|
||||
\item[\Type{unw\_word\_t} \Var{end\_ip}] The address of the first
|
||||
instruction \emph{beyond} the end of the procedure. If this address
|
||||
cannot be determined (e.g., due to lack of unwind information),
|
||||
the \Var{end\_ip} member is cleared to 0. \\
|
||||
\item[\Type{unw\_word\_t} \Var{lsda}] The address of the
|
||||
language-specific data-area (LSDA). This area normally contains
|
||||
language-specific information needed during exception handling. If
|
||||
the procedure has no such area, this member is cleared to 0. \\
|
||||
\item[\Type{unw\_word\_t} \Var{handler}] The address of the exception
|
||||
handler routine. This is sometimes called the \emph{personality}
|
||||
routine. If the procedure does not define
|
||||
a personality routine, the \Var{handler} member is cleared to 0. \\
|
||||
\item[\Type{unw\_word\_t} \Var{gp}] The global-pointer of the
|
||||
procedure. On platforms that do not use a global pointer, this
|
||||
member may contain an undefined value. On all other platforms, it
|
||||
must be set either to the correct global-pointer value of the
|
||||
procedure or to 0 if the proper global-pointer cannot be
|
||||
obtained for some reason. \\
|
||||
\item[\Type{unw\_word\_t} \Var{flags}] A set of flags. There are
|
||||
currently no target-independent flags. For the IA-64 target, the
|
||||
flag \Const{UNW_PI_FLAG_IA64_RBS_SWITCH} is set if the
|
||||
procedure may switch the register-backing store.\\
|
||||
\item[\Type{int} \Var{format}] The format of the unwind-info for this
|
||||
procedure. If the unwind-info consists of dynamic procedure info,
|
||||
\Var{format} is equal to \Const{UNW\_INFO\_FORMAT\_DYNAMIC}. If the
|
||||
unwind-info consists of a (target-specific) unwind table, it is
|
||||
equal to to \Const{UNW\_INFO\_FORMAT\_TABLE}. All other values are
|
||||
reserved for future use by \Prog{libunwind}. This member exists
|
||||
for use by the \Func{find\_proc\_info}() call-back (see
|
||||
\Func{unw\_create\_addr\_space}(3)). The
|
||||
\Func{unw\_get\_proc\_info}() routine
|
||||
may return an undefined value in this member. \\
|
||||
\item[\Type{int} \Var{unwind\_info\_size}] The size of the unwind-info
|
||||
in bytes. This member exists for use by the
|
||||
\Func{find\_proc\_info}() call-back (see
|
||||
\Func{unw\_create\_addr\_space}(3)). The
|
||||
\Func{unw\_get\_proc\_info}() routine
|
||||
may return an undefined value in this member.\\
|
||||
\item[\Type{void~*}\Var{unwind\_info}] The pointer to the unwind-info.
|
||||
If no unwind info is available, this member must be set to
|
||||
\Const{NULL}. This member exists for use by the
|
||||
\Func{find\_proc\_info}() call-back (see
|
||||
\Func{unw\_create\_addr\_space}(3)). The
|
||||
\Func{unw\_get\_proc\_info}() routine
|
||||
may return an undefined value in this member.\\
|
||||
\end{description}
|
||||
Note that for the purposes of \Prog{libunwind}, the code of a
|
||||
procedure is assumed to occupy a single, contiguous range of
|
||||
addresses. For this reason, it is alwas possible to describe the
|
||||
extent of a procedure with the \Var{start\_ip} and \Var{end\_ip}
|
||||
members. If a single function/routine is split into multiple,
|
||||
discontiguous pieces, \Prog{libunwind} will treat each piece as a
|
||||
separate procedure.
|
||||
|
||||
\section{Return Value}
|
||||
|
||||
On successful completion, \Func{unw\_get\_proc\_info}() returns 0.
|
||||
Otherwise the negative value of one of the error-codes below is
|
||||
returned.
|
||||
|
||||
\section{Thread and Signal Safety}
|
||||
|
||||
\Func{unw\_get\_proc\_info}() is thread-safe as well as safe to use
|
||||
from a signal handler.
|
||||
|
||||
\section{Errors}
|
||||
|
||||
\begin{Description}
|
||||
\item[\Const{UNW\_EUNSPEC}] An unspecified error occurred.
|
||||
\item[\Const{UNW\_ENOINFO}] \Prog{Libunwind} was unable to locate
|
||||
unwind-info for the procedure.
|
||||
\item[\Const{UNW\_EBADVERSION}] The unwind-info for the procedure has
|
||||
version or format that is not understood by \Prog{libunwind}.
|
||||
\end{Description}
|
||||
In addition, \Func{unw\_get\_proc\_info}() may return any error
|
||||
returned by the \Func{access\_mem}() call-back (see
|
||||
\Func{unw\_create\_addr\_space}(3)).
|
||||
|
||||
\section{See Also}
|
||||
|
||||
\SeeAlso{libunwind(3)},
|
||||
\SeeAlso{unw\_create\_addr\_space(3)},
|
||||
\SeeAlso{unw\_get\_proc\_name(3)}
|
||||
|
||||
\section{Author}
|
||||
|
||||
\noindent
|
||||
David Mosberger-Tang\\
|
||||
Hewlett-Packard Labs\\
|
||||
Palo-Alto, CA 94304\\
|
||||
Email: \Email{davidm@hpl.hp.com}\\
|
||||
WWW: \URL{http://www.hpl.hp.com/research/linux/libunwind/}.
|
||||
\LatexManEnd
|
||||
|
||||
\end{document}
|
|
@ -1,127 +0,0 @@
|
|||
'\" t
|
||||
.\" Manual page created with latex2man on Wed Mar 12 12:55:19 PST 2003
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
||||
.de Vb
|
||||
.ft CW
|
||||
.nf
|
||||
..
|
||||
.de Ve
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
.TH "UNW\\_GET\\_PROC\\_NAME" "3" "12 March 2003" "Programming Library " "Programming Library "
|
||||
.SH NAME
|
||||
|
||||
.PP
|
||||
unw_get_proc_name \-\- get name of current procedure
|
||||
.PP
|
||||
.SH SYNOPSIS
|
||||
|
||||
.PP
|
||||
#include <libunwind.h>
|
||||
.br
|
||||
.PP
|
||||
int
|
||||
unw_get_proc_name(unw_cursor_t *cp,
|
||||
char *bufp,
|
||||
size_t
|
||||
len,
|
||||
unw_word_t *offp);
|
||||
.br
|
||||
.PP
|
||||
.SH DESCRIPTION
|
||||
|
||||
.PP
|
||||
The unw_get_proc_name()
|
||||
routine returns the name of the
|
||||
procedure that created the stack frame identified by argument
|
||||
cp\&.
|
||||
The bufp
|
||||
argument is a pointer to a character buffer
|
||||
that is at least len
|
||||
bytes long. This buffer is used to return
|
||||
the name of the procedure. The offp
|
||||
argument is a pointer to a
|
||||
word that is used to return the byte\-offset of the instruction\-pointer
|
||||
saved in the stack frame identified by cp,
|
||||
relative to the start
|
||||
of the procedure. For example, if procedure foo()
|
||||
starts at
|
||||
address 0x40003000, then invoking unw_get_proc_name()
|
||||
on a
|
||||
stack frame with an instruction\-pointer value of 0x40003080 would
|
||||
return a value of 0x80 in the word pointed to by offp
|
||||
(assuming
|
||||
the procedure is at least 0x80 bytes long).
|
||||
.PP
|
||||
Note that on some platforms there is no reliable way to distinguish
|
||||
between procedure names and ordinary labels. Furthermore, if symbol
|
||||
information has been stripped from a program, procedure names may be
|
||||
completely unavailable or may be limited to those exported via a
|
||||
dynamic symbol table. In such cases, unw_get_proc_name()
|
||||
may return the name of a label or a preceeding (nearby) procedure.
|
||||
However, the offset returned through offp
|
||||
is always relative to
|
||||
the returned name, which ensures that the value (address) of the
|
||||
returned name plus the returned offset will always be equal to the
|
||||
instruction\-pointer of the stack frame identified by cp\&.
|
||||
.PP
|
||||
.SH RETURN VALUE
|
||||
|
||||
.PP
|
||||
On successful completion, unw_get_proc_name()
|
||||
returns 0.
|
||||
Otherwise the negative value of one of the error\-codes below is
|
||||
returned.
|
||||
.PP
|
||||
.SH THREAD AND SIGNAL SAFETY
|
||||
|
||||
.PP
|
||||
unw_get_proc_name()
|
||||
is thread\-safe but \fInot\fP
|
||||
safe to
|
||||
use from a signal handler.
|
||||
.PP
|
||||
.SH ERRORS
|
||||
|
||||
.PP
|
||||
.TP
|
||||
UNW_EUNSPEC
|
||||
An unspecified error occurred.
|
||||
.TP
|
||||
UNW_ENOINFO
|
||||
Libunwind
|
||||
was unable to determine
|
||||
the name of the procedure.
|
||||
.TP
|
||||
UNW_ENOMME
|
||||
The procedure name is too long to fit
|
||||
in the buffer provided. A truncated version of the name has been
|
||||
returned.
|
||||
.PP
|
||||
In addition, unw_get_proc_name()
|
||||
may return any error
|
||||
returned by the access_mem()
|
||||
call\-back (see
|
||||
unw_create_addr_space(3)).
|
||||
.PP
|
||||
.SH SEE ALSO
|
||||
|
||||
.PP
|
||||
libunwind(3),
|
||||
unw_get_proc_info(3)
|
||||
.PP
|
||||
.SH AUTHOR
|
||||
|
||||
.PP
|
||||
David Mosberger\-Tang
|
||||
.br
|
||||
Hewlett\-Packard Labs
|
||||
.br
|
||||
Palo\-Alto, CA 94304
|
||||
.br
|
||||
Email: \fBdavidm@hpl.hp.com\fP
|
||||
.br
|
||||
WWW: \fBhttp://www.hpl.hp.com/research/linux/libunwind/\fP\&.
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
|
@ -1,85 +0,0 @@
|
|||
\documentclass{article}
|
||||
\usepackage[fancyhdr,pdf]{latex2man}
|
||||
|
||||
\input{common.tex}
|
||||
|
||||
\begin{document}
|
||||
|
||||
\begin{Name}{3}{unw\_get\_proc\_name}{David Mosberger-Tang}{Programming Library}{unw\_get\_proc\_name}
|
||||
|
||||
unw\_get\_proc\_name -- get name of current procedure
|
||||
\end{Name}
|
||||
|
||||
\section{Synopsis}
|
||||
|
||||
\File{\#include $<$libunwind.h$>$}\\
|
||||
|
||||
\Type{int} \Func{unw\_get\_proc\_name}(\Type{unw\_cursor\_t~*}\Var{cp}, \Type{char~*}\Var{bufp}, \Type{size\_t} \Var{len}, \Type{unw\_word\_t~*}\Var{offp});\\
|
||||
|
||||
\section{Description}
|
||||
|
||||
The \Func{unw\_get\_proc\_name}() routine returns the name of the
|
||||
procedure that created the stack frame identified by argument
|
||||
\Var{cp}. The \Var{bufp} argument is a pointer to a character buffer
|
||||
that is at least \Var{len} bytes long. This buffer is used to return
|
||||
the name of the procedure. The \Var{offp} argument is a pointer to a
|
||||
word that is used to return the byte-offset of the instruction-pointer
|
||||
saved in the stack frame identified by \Var{cp}, relative to the start
|
||||
of the procedure. For example, if procedure \Func{foo}() starts at
|
||||
address 0x40003000, then invoking \Func{unw\_get\_proc\_name}() on a
|
||||
stack frame with an instruction-pointer value of 0x40003080 would
|
||||
return a value of 0x80 in the word pointed to by \Var{offp} (assuming
|
||||
the procedure is at least 0x80 bytes long).
|
||||
|
||||
Note that on some platforms there is no reliable way to distinguish
|
||||
between procedure names and ordinary labels. Furthermore, if symbol
|
||||
information has been stripped from a program, procedure names may be
|
||||
completely unavailable or may be limited to those exported via a
|
||||
dynamic symbol table. In such cases, \Func{unw\_get\_proc\_name}()
|
||||
may return the name of a label or a preceeding (nearby) procedure.
|
||||
However, the offset returned through \Var{offp} is always relative to
|
||||
the returned name, which ensures that the value (address) of the
|
||||
returned name plus the returned offset will always be equal to the
|
||||
instruction-pointer of the stack frame identified by \Var{cp}.
|
||||
|
||||
\section{Return Value}
|
||||
|
||||
On successful completion, \Func{unw\_get\_proc\_name}() returns 0.
|
||||
Otherwise the negative value of one of the error-codes below is
|
||||
returned.
|
||||
|
||||
\section{Thread and Signal Safety}
|
||||
|
||||
\Func{unw\_get\_proc\_name}() is thread-safe but \emph{not} safe to
|
||||
use from a signal handler.
|
||||
|
||||
\section{Errors}
|
||||
|
||||
\begin{Description}
|
||||
\item[\Const{UNW\_EUNSPEC}] An unspecified error occurred.
|
||||
\item[\Const{UNW\_ENOINFO}] \Prog{Libunwind} was unable to determine
|
||||
the name of the procedure.
|
||||
\item[\Const{UNW\_ENOMME}] The procedure name is too long to fit
|
||||
in the buffer provided. A truncated version of the name has been
|
||||
returned.
|
||||
\end{Description}
|
||||
In addition, \Func{unw\_get\_proc\_name}() may return any error
|
||||
returned by the \Func{access\_mem}() call-back (see
|
||||
\Func{unw\_create\_addr\_space}(3)).
|
||||
|
||||
\section{See Also}
|
||||
|
||||
\SeeAlso{libunwind(3)},
|
||||
\SeeAlso{unw\_get\_proc\_info(3)}
|
||||
|
||||
\section{Author}
|
||||
|
||||
\noindent
|
||||
David Mosberger-Tang\\
|
||||
Hewlett-Packard Labs\\
|
||||
Palo-Alto, CA 94304\\
|
||||
Email: \Email{davidm@hpl.hp.com}\\
|
||||
WWW: \URL{http://www.hpl.hp.com/research/linux/libunwind/}.
|
||||
\LatexManEnd
|
||||
|
||||
\end{document}
|
|
@ -1,73 +0,0 @@
|
|||
'\" t
|
||||
.\" Manual page created with latex2man on Wed Mar 12 14:22:15 PST 2003
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
||||
.de Vb
|
||||
.ft CW
|
||||
.nf
|
||||
..
|
||||
.de Ve
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
.TH "UNW\\_REGNAME" "3" "12 March 2003" "Programming Library " "Programming Library "
|
||||
.SH NAME
|
||||
|
||||
.PP
|
||||
unw_regname \-\- get register name
|
||||
.PP
|
||||
.SH SYNOPSIS
|
||||
|
||||
.PP
|
||||
#include <libunwind.h>
|
||||
.br
|
||||
.PP
|
||||
const char *unw_regname(unw_regnum_t
|
||||
regnum);
|
||||
.br
|
||||
.PP
|
||||
.SH DESCRIPTION
|
||||
|
||||
.PP
|
||||
The unw_regname()
|
||||
routine returns a printable name for
|
||||
register regnum\&.
|
||||
If regnum
|
||||
is an invalid or otherwise
|
||||
unrecognized register number, a string consisting of three question
|
||||
marks is returned. The returned string is statically allocated and
|
||||
therefore guaranteed to remain valid until the application terminates.
|
||||
.PP
|
||||
.SH RETURN VALUE
|
||||
|
||||
.PP
|
||||
The unw_regname()
|
||||
routine cannot fail and always returns a
|
||||
valid (non\-NULL)
|
||||
string.
|
||||
.PP
|
||||
.SH THREAD AND SIGNAL SAFETY
|
||||
|
||||
.PP
|
||||
The unw_regname()
|
||||
routine is thread\-safe as well as safe to
|
||||
use from a signal handler.
|
||||
.PP
|
||||
.SH SEE ALSO
|
||||
|
||||
.PP
|
||||
libunwind(3)
|
||||
.PP
|
||||
.SH AUTHOR
|
||||
|
||||
.PP
|
||||
David Mosberger\-Tang
|
||||
.br
|
||||
Hewlett\-Packard Labs
|
||||
.br
|
||||
Palo\-Alto, CA 94304
|
||||
.br
|
||||
Email: \fBdavidm@hpl.hp.com\fP
|
||||
.br
|
||||
WWW: \fBhttp://www.hpl.hp.com/research/linux/libunwind/\fP\&.
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
|
@ -1,51 +0,0 @@
|
|||
\documentclass{article}
|
||||
\usepackage[fancyhdr,pdf]{latex2man}
|
||||
|
||||
\input{common.tex}
|
||||
|
||||
\begin{document}
|
||||
|
||||
\begin{Name}{3}{unw\_regname}{David Mosberger-Tang}{Programming Library}{unw\_regname}
|
||||
|
||||
unw\_regname -- get register name
|
||||
\end{Name}
|
||||
|
||||
\section{Synopsis}
|
||||
|
||||
\File{\#include $<$libunwind.h$>$}\\
|
||||
|
||||
\Type{const char~*}\Func{unw\_regname}(\Type{unw\_regnum\_t} \Var{regnum});\\
|
||||
|
||||
\section{Description}
|
||||
|
||||
The \Func{unw\_regname}() routine returns a printable name for
|
||||
register \Var{regnum}. If \Var{regnum} is an invalid or otherwise
|
||||
unrecognized register number, a string consisting of three question
|
||||
marks is returned. The returned string is statically allocated and
|
||||
therefore guaranteed to remain valid until the application terminates.
|
||||
|
||||
\section{Return Value}
|
||||
|
||||
The \Func{unw\_regname}() routine cannot fail and always returns a
|
||||
valid (non-\Const{NULL}) string.
|
||||
|
||||
\section{Thread and Signal Safety}
|
||||
|
||||
The \Func{unw\_regname}() routine is thread-safe as well as safe to
|
||||
use from a signal handler.
|
||||
|
||||
\section{See Also}
|
||||
|
||||
\SeeAlso{libunwind(3)}
|
||||
|
||||
\section{Author}
|
||||
|
||||
\noindent
|
||||
David Mosberger-Tang\\
|
||||
Hewlett-Packard Labs\\
|
||||
Palo-Alto, CA 94304\\
|
||||
Email: \Email{davidm@hpl.hp.com}\\
|
||||
WWW: \URL{http://www.hpl.hp.com/research/linux/libunwind/}.
|
||||
\LatexManEnd
|
||||
|
||||
\end{document}
|
|
@ -1,123 +0,0 @@
|
|||
'\" t
|
||||
.\" Manual page created with latex2man on Wed Mar 12 18:06:37 PST 2003
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
||||
.de Vb
|
||||
.ft CW
|
||||
.nf
|
||||
..
|
||||
.de Ve
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
.TH "UNW\\_SET\\_CACHING\\_POLICY" "3" "12 March 2003" "Programming Library " "Programming Library "
|
||||
.SH NAME
|
||||
|
||||
.PP
|
||||
unw_set_caching_policy \-\- set unwind caching policy
|
||||
.PP
|
||||
.SH SYNOPSIS
|
||||
|
||||
.PP
|
||||
#include <libunwind.h>
|
||||
.br
|
||||
.PP
|
||||
int
|
||||
unw_set_caching_policy(unw_addr_space_t
|
||||
as,
|
||||
unw_caching_policy_t
|
||||
policy);
|
||||
.br
|
||||
.PP
|
||||
.SH DESCRIPTION
|
||||
|
||||
.PP
|
||||
The unw_set_caching_policy()
|
||||
routine sets the caching policy
|
||||
of address space as
|
||||
to the policy specified by argument
|
||||
policy\&.
|
||||
The policy
|
||||
argument can take one of three
|
||||
possible values:
|
||||
.TP
|
||||
UNW_CACHE_NONE
|
||||
Turns off caching completely. This
|
||||
also implicitly flushes the contents of all caches as if
|
||||
unw_flush_cache()
|
||||
had been called.
|
||||
.TP
|
||||
UNW_CACHE_GLOBAL
|
||||
Enables caching using a global cache
|
||||
that is shared by all threads. If global caching is unavailable or
|
||||
unsupported, libunwind
|
||||
may fall back on using a per\-thread
|
||||
cache, as if UNW_CACHE_PER_THREAD
|
||||
had been specified.
|
||||
.TP
|
||||
UNW_CACHE_PER_THREAD
|
||||
Enables caching using
|
||||
thread\-local caches. If a thread\-local caching are unavailable or
|
||||
unsupported, libunwind
|
||||
may fall back on using a global cache,
|
||||
as if UNW_CACHE_GLOBAL
|
||||
had been specified.
|
||||
.PP
|
||||
If caching is enabled, an application must be prepared to make
|
||||
appropriate calls to unw_flush_cache()
|
||||
whenever the target
|
||||
changes in a way that could affect the validity of cached information.
|
||||
For example, after unloading (removing) a shared library,
|
||||
unw_flush_cache()
|
||||
would have to be called (at least) for the
|
||||
address\-range that was covered by the shared library.
|
||||
.PP
|
||||
For address spaces created via unw_create_addr_space(3),
|
||||
caching is turned off by default. For the local address space
|
||||
unw_local_addr_space,
|
||||
caching is turned on by default.
|
||||
.PP
|
||||
.SH RETURN VALUE
|
||||
|
||||
.PP
|
||||
On successful completion, unw_set_caching_policy()
|
||||
returns 0.
|
||||
Otherwise the negative value of one of the error\-codes below is
|
||||
returned.
|
||||
.PP
|
||||
.SH THREAD AND SIGNAL SAFETY
|
||||
|
||||
.PP
|
||||
unw_set_caching_policy()
|
||||
is thread\-safe but \fInot\fP
|
||||
safe
|
||||
to use from a signal handler.
|
||||
.PP
|
||||
.SH ERRORS
|
||||
|
||||
.PP
|
||||
.TP
|
||||
UNW_ENOMEM
|
||||
The desired caching policy could not be
|
||||
established because the application is out of memory.
|
||||
.PP
|
||||
.SH SEE ALSO
|
||||
|
||||
.PP
|
||||
libunwind(3),
|
||||
unw_create_addr_space(3),
|
||||
unw_flush_cache(3)
|
||||
.PP
|
||||
.SH AUTHOR
|
||||
|
||||
.PP
|
||||
David Mosberger\-Tang
|
||||
.br
|
||||
Hewlett\-Packard Labs
|
||||
.br
|
||||
Palo\-Alto, CA 94304
|
||||
.br
|
||||
Email: \fBdavidm@hpl.hp.com\fP
|
||||
.br
|
||||
WWW: \fBhttp://www.hpl.hp.com/research/linux/libunwind/\fP\&.
|
||||
.\" NOTE: This file is generated, DO NOT EDIT.
|
|
@ -1,84 +0,0 @@
|
|||
\documentclass{article}
|
||||
\usepackage[fancyhdr,pdf]{latex2man}
|
||||
|
||||
\input{common.tex}
|
||||
|
||||
\begin{document}
|
||||
|
||||
\begin{Name}{3}{unw\_set\_caching\_policy}{David Mosberger-Tang}{Programming Library}{unw\_set\_caching\_policy}
|
||||
|
||||
unw\_set\_caching\_policy -- set unwind caching policy
|
||||
\end{Name}
|
||||
|
||||
\section{Synopsis}
|
||||
|
||||
\File{\#include $<$libunwind.h$>$}\\
|
||||
|
||||
\Type{int} \Func{unw\_set\_caching\_policy}(\Type{unw\_addr\_space\_t} \Var{as}, \Type{unw\_caching_policy\_t} \Var{policy});\\
|
||||
|
||||
\section{Description}
|
||||
|
||||
The \Func{unw\_set\_caching\_policy}() routine sets the caching policy
|
||||
of address space \Var{as} to the policy specified by argument
|
||||
\Var{policy}. The \Var{policy} argument can take one of three
|
||||
possible values:
|
||||
\begin{description}
|
||||
\item[\Const{UNW\_CACHE\_NONE}] Turns off caching completely. This
|
||||
also implicitly flushes the contents of all caches as if
|
||||
\Func{unw\_flush\_cache}() had been called.
|
||||
\item[\Const{UNW\_CACHE\_GLOBAL}] Enables caching using a global cache
|
||||
that is shared by all threads. If global caching is unavailable or
|
||||
unsupported, \Prog{libunwind} may fall back on using a per-thread
|
||||
cache, as if \Const{UNW\_CACHE\_PER\_THREAD} had been specified.
|
||||
\item[\Const{UNW\_CACHE\_PER\_THREAD}] Enables caching using
|
||||
thread-local caches. If a thread-local caching are unavailable or
|
||||
unsupported, \Prog{libunwind} may fall back on using a global cache,
|
||||
as if \Const{UNW\_CACHE\_GLOBAL} had been specified.
|
||||
\end{description}
|
||||
|
||||
If caching is enabled, an application must be prepared to make
|
||||
appropriate calls to \Func{unw\_flush\_cache}() whenever the target
|
||||
changes in a way that could affect the validity of cached information.
|
||||
For example, after unloading (removing) a shared library,
|
||||
\Func{unw\_flush\_cache}() would have to be called (at least) for the
|
||||
address-range that was covered by the shared library.
|
||||
|
||||
For address spaces created via \Func{unw\_create\_addr\_space}(3),
|
||||
caching is turned off by default. For the local address space
|
||||
\Func{unw\_local\_addr\_space}, caching is turned on by default.
|
||||
|
||||
\section{Return Value}
|
||||
|
||||
On successful completion, \Func{unw\_set\_caching\_policy}() returns 0.
|
||||
Otherwise the negative value of one of the error-codes below is
|
||||
returned.
|
||||
|
||||
\section{Thread and Signal Safety}
|
||||
|
||||
\Func{unw\_set\_caching\_policy}() is thread-safe but \emph{not} safe
|
||||
to use from a signal handler.
|
||||
|
||||
\section{Errors}
|
||||
|
||||
\begin{Description}
|
||||
\item[\Const{UNW\_ENOMEM}] The desired caching policy could not be
|
||||
established because the application is out of memory.
|
||||
\end{Description}
|
||||
|
||||
\section{See Also}
|
||||
|
||||
\SeeAlso{libunwind(3)},
|
||||
\SeeAlso{unw\_create\_addr\_space(3)},
|
||||
\SeeAlso{unw\_flush\_cache(3)}
|
||||
|
||||
\section{Author}
|
||||
|
||||
\noindent
|
||||
David Mosberger-Tang\\
|
||||
Hewlett-Packard Labs\\
|
||||
Palo-Alto, CA 94304\\
|
||||
Email: \Email{davidm@hpl.hp.com}\\
|
||||
WWW: \URL{http://www.hpl.hp.com/research/linux/libunwind/}.
|
||||
\LatexManEnd
|
||||
|
||||
\end{document}
|
Loading…
Reference in a new issue