Initial import
[external/libunwind.git] / doc / _U_dyn_register.tex
1 \documentclass{article}
2 \usepackage[fancyhdr,pdf]{latex2man}
3
4 \input{common.tex}
5
6 \begin{document}
7
8 \begin{Name}{3}{\_U\_dyn\_register}{David Mosberger-Tang}{Programming Library}{\_U\_dyn\_register}\_U\_dyn\_register -- register unwind-info for dynamically generated code
9 \end{Name}
10
11 \section{Synopsis}
12
13 \File{\#include $<$libunwind.h$>$}\\
14
15 \Type{void} \Func{\_U\_dyn\_register}(\Type{unw\_dyn\_info\_t~*}\Var{di});\\
16
17 \section{Description}
18
19 The \Func{\_U\_dyn\_register}() routine registers unwind-info for a
20 dynamically generated procedure.  The procedure's unwind-info is
21 described by a structure of type \Type{unw\_dyn\_info\_t} (see
22 \SeeAlso{libunwind-dynamic(3)}).  A pointer to this structure is
23 passed in argument \Var{di}.
24
25 The \Func{\_U\_dyn\_register}() routine is guaranteed to execute in
26 constant time (in the absence of contention from concurrent calls to
27 \Func{\_U\_dyn\_register}() or \Func{\_U\_dyn\_cancel}()).
28
29
30 \section{Thread and Signal Safety}
31
32 \Func{\_U\_dyn\_register}() is thread-safe but \emph{not} safe to use
33 from a signal handler.
34
35 \section{See Also}
36
37 \SeeAlso{libunwind-dynamic(3)}, \SeeAlso{\_U\_dyn\_cancel(3)}
38
39 \section{Author}
40
41 \noindent
42 David Mosberger-Tang\\
43 Email: \Email{dmosberger@gmail.com}\\
44 WWW: \URL{http://www.nongnu.org/libunwind/}.
45 \LatexManEnd
46
47 \end{document}