routine returns the same
kind of auxiliary information about a procedure as
except that the info is looked up by
instruction-pointer (IP) instead of a cursor. This is more flexible
because it is possible to look up the info for an arbitrary procedure,
even if it is not part of the current call-chain. However, since it
is more flexible, it also tends to run slower (and often much slower)
The routine expects the followins arguments: as
address-space in which the instruction-pointer should be looked up.
For a look-up in the local address-space,
can be passed for this argument.
is the instruction-pointer for which the procedure
info should be looked up and pip
is a pointer to a structure of
which is used to return the info.
is the address-space argument that should be used
when accessing the address-space. It has the same purpose as the
argument of the same name for unw_init_remote().
accessing the local address-space (first argument is
must be passed for this
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
members. If a single function/routine is split into multiple,
discontiguous pieces, libunwind
will treat each piece as a