summaryrefslogtreecommitdiff
path: root/doc/unw_regname.tex
blob: 94b6434194d6f2d1e151d7d3e2714729de501e40 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
\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\\
Email: \Email{dmosberger@gmail.com}\\
WWW: \URL{http://www.nongnu.org/libunwind/}.
\LatexManEnd

\end{document}