PADDR_TO_MAP(3PROC) Process Control Library Functions PADDR_TO_MAP(3PROC)
Paddr_to_map, Paddr_to_text_map, Plmid_to_map, Pname_to_map - lookup
memory map information
Process Control Library (libproc, -lproc)
#include <libproc.h>
const prmap_t *
Paddr_to_map(struct ps_prochandle *P, uintptr_t addr);
const prmap_t *
Paddr_to_text_map(struct ps_prochandle *P, uintptr_t addr);
const prmap_t *
Plmid_to_map(struct ps_prochandle *P, Lmid_t lmid, const char *name);
const prmap_t *
Pname_to_map(struct ps_prochandle *P, const char *name);
The Paddr_to_map(), Paddr_to_text_map(), Plmid_to_map(), and
Pname_to_map() functions lookup memory map information in the process
handle P. The prmap_t structure provides information such as the size,
offset, and object of the mapping and is defined in proc(5).
The pointer to the data returned by the library will only be valid for
as long as the handle P is valid. Any calls to Prelease(3PROC) will
invalidate the data.
The Paddr_to_map() function attempts to find the mapping information
corresponding to the address addr.
The Paddr_to_text_map() function is similar to the Paddr_to_map()
function; however, it only returns successfully if the specified
address corresponds to a text mapping as identified by the run-time
link-editor. One use of this is to ensure that a mapping is actually a
text-mapping before inserting a breakpoint in it.
The Pname_to_map() function looks up the object named name and returns
the corresponding mapping information. Two special values may be used
for name. The macro PR_OBJ_EXEC refers to the executable object itself
and the macro PR_OBJ_LDSO refers to the object ld.so.1.
The Plmid_to_map() function is similar to Pname_to_map(). It allows
passing a link-map identifier, lmid, which constricts the search of the
object named with name to that link-map. The special value of
PR_LMID_EVERY may be passed to indicate that every link-map should be
searched, which is equivalent in behavior to the Pname_to_map()
function.
Upon successful completion, the Paddr_to_map(), Paddr_to_text_map(),
Plmid_to_map(), and Pname_to_map() functions return a pointer to the
corresponding mapping information. If none exists then NULL is
returned.
Uncommitted
MT-LEVEL
See LOCKING in libproc(3LIB).
libproc(3LIB), Prelease(3PROC), proc(5)
illumos May 11, 2016 illumos
NAME
Paddr_to_map, Paddr_to_text_map, Plmid_to_map, Pname_to_map - lookup
memory map information
LIBRARY
Process Control Library (libproc, -lproc)
SYNOPSIS
#include <libproc.h>
const prmap_t *
Paddr_to_map(struct ps_prochandle *P, uintptr_t addr);
const prmap_t *
Paddr_to_text_map(struct ps_prochandle *P, uintptr_t addr);
const prmap_t *
Plmid_to_map(struct ps_prochandle *P, Lmid_t lmid, const char *name);
const prmap_t *
Pname_to_map(struct ps_prochandle *P, const char *name);
DESCRIPTION
The Paddr_to_map(), Paddr_to_text_map(), Plmid_to_map(), and
Pname_to_map() functions lookup memory map information in the process
handle P. The prmap_t structure provides information such as the size,
offset, and object of the mapping and is defined in proc(5).
The pointer to the data returned by the library will only be valid for
as long as the handle P is valid. Any calls to Prelease(3PROC) will
invalidate the data.
The Paddr_to_map() function attempts to find the mapping information
corresponding to the address addr.
The Paddr_to_text_map() function is similar to the Paddr_to_map()
function; however, it only returns successfully if the specified
address corresponds to a text mapping as identified by the run-time
link-editor. One use of this is to ensure that a mapping is actually a
text-mapping before inserting a breakpoint in it.
The Pname_to_map() function looks up the object named name and returns
the corresponding mapping information. Two special values may be used
for name. The macro PR_OBJ_EXEC refers to the executable object itself
and the macro PR_OBJ_LDSO refers to the object ld.so.1.
The Plmid_to_map() function is similar to Pname_to_map(). It allows
passing a link-map identifier, lmid, which constricts the search of the
object named with name to that link-map. The special value of
PR_LMID_EVERY may be passed to indicate that every link-map should be
searched, which is equivalent in behavior to the Pname_to_map()
function.
RETURN VALUES
Upon successful completion, the Paddr_to_map(), Paddr_to_text_map(),
Plmid_to_map(), and Pname_to_map() functions return a pointer to the
corresponding mapping information. If none exists then NULL is
returned.
INTERFACE STABILITY
Uncommitted
MT-LEVEL
See LOCKING in libproc(3LIB).
SEE ALSO
libproc(3LIB), Prelease(3PROC), proc(5)
illumos May 11, 2016 illumos