2 .\" Manual page created with latex2man on Thu Aug 16 09:44:45 MDT 2007
3 .\" NOTE: This file is generated, DO NOT EDIT.
13 .TH "UNW\\_INIT\\_REMOTE" "3" "16 August 2007" "Programming Library " "Programming Library "
16 \-\- initialize cursor for remote unwinding
21 #include <libunwind.h>
25 unw_init_remote(unw_cursor_t *c,
34 routine initializes the unwind cursor
36 for unwinding in the address space identified by
39 argument can either be set to
41 (local address space) or to an arbitrary
42 address space created with unw_create_addr_space().
45 void\-pointer tells the address space exactly what entity
46 should be unwound. For example, if unw_local_addr_space
50 needs to be a pointer to a context
51 structure containing the machine\-state of the initial stack frame.
52 However, other address\-spaces may instead expect a process\-id, a
53 thread\-id, or a pointer to an arbitrary structure which identifies the
54 stack\-frame chain to be unwound. In other words, the interpretation
56 is entirely dependent on the address\-space in use;
58 never interprets the argument in any way on its own.
60 Note that unw_init_remote()
61 can be used to initiate unwinding
63 process, including the local process in which the
64 unwinder itself is running. However, for local unwinding, it is
65 generally preferable to use unw_init_local()
67 it is easier to use and because it may perform better.
72 On successful completion, unw_init_remote()
74 Otherwise the negative value of one of the error\-codes below is
77 .SH THREAD AND SIGNAL SAFETY
81 is thread\-safe. If the local address\-space
82 is passed in argument as,
83 this routine is also safe to use from
94 which supports local unwinding only
95 (this normally happens when defining UNW_LOCAL_ONLY
97 including <libunwind.h>
102 An unspecified error occurred.
105 A register needed by unw_init_remote()
112 unw_create_addr_space(3),
118 David Mosberger\-Tang
120 Email: \fBdmosberger@gmail.com\fP
122 WWW: \fBhttp://www.nongnu.org/libunwind/\fP\&.
123 .\" NOTE: This file is generated, DO NOT EDIT.