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\\_GET\\_PROC\\_INFO\\_BY\\_IP" "3" "16 August 2007" "Programming Library " "Programming Library "
15 unw_get_proc_info_by_ip
16 \-\- get procedure info by IP
21 #include <libunwind.h>
25 unw_get_proc_info_by_ip(unw_addr_space_t as,
34 The unw_get_proc_info_by_ip()
35 routine returns the same
36 kind of auxiliary information about a procedure as
38 except that the info is looked up by
39 instruction\-pointer (IP) instead of a cursor. This is more flexible
40 because it is possible to look up the info for an arbitrary procedure,
41 even if it is not part of the current call\-chain. However, since it
42 is more flexible, it also tends to run slower (and often much slower)
43 than unw_get_proc_info().
45 The routine expects the followins arguments: as
47 address\-space in which the instruction\-pointer should be looked up.
48 For a look\-up in the local address\-space,
50 can be passed for this argument.
52 is the instruction\-pointer for which the procedure
53 info should be looked up and pip
54 is a pointer to a structure of
56 which is used to return the info.
58 is the address\-space argument that should be used
59 when accessing the address\-space. It has the same purpose as the
60 argument of the same name for unw_init_remote().
62 accessing the local address\-space (first argument is
63 unw_local_addr_space),
65 must be passed for this
68 Note that for the purposes of libunwind,
70 procedure is assumed to occupy a single, contiguous range of
71 addresses. For this reason, it is alwas possible to describe the
72 extent of a procedure with the start_ip
74 members. If a single function/routine is split into multiple,
75 discontiguous pieces, libunwind
76 will treat each piece as a
82 On successful completion, unw_get_proc_info_by_ip()
83 returns 0. Otherwise the negative value of one of the error\-codes
86 .SH THREAD AND SIGNAL SAFETY
90 is thread\-safe. If the local
91 address\-space is passed in argument as,
93 safe to use from a signal handler.
100 An unspecified error occurred.
105 unwind\-info for the procedure.
108 The unwind\-info for the procedure has
109 version or format that is not understood by libunwind\&.
111 In addition, unw_get_proc_info()
113 returned by the access_mem()
115 unw_create_addr_space(3)).
121 unw_create_addr_space(3),
122 unw_get_proc_name(3),
123 unw_get_proc_info(3),
129 David Mosberger\-Tang
131 Email: \fBdmosberger@gmail.com\fP
133 WWW: \fBhttp://www.nongnu.org/libunwind/\fP\&.
134 .\" NOTE: This file is generated, DO NOT EDIT.