rtld_db(3EXT) Extended Library Functions rtld_db(3EXT)NAME
rtld_db, rd_delete, rd_errstr, rd_event_addr, rd_event_enable,
rd_event_getmsg, rd_init, rd_loadobj_iter, rd_log, rd_new, rd_obj‐
pad_enable, rd_plt_resolution, rd_reset - runtime linker debugging
functions
SYNOPSIS
cc [ flag ... ] file ... -lrtld_db [ library ... ]
#include <proc_service.h>
#include <rtld_db.h>
void rd_delete(struct rd_agent *rdap);
char *rd_errstr(rd_err_e rderr);
rd_err_e rd_event_addr(rd_agent *rdap, rd_notify_t *notify);
rd_err_e rd_event_enable(struct rd_agent *rdap, int onoff);
rd_err_e rd_event_getmsg(struct rd_agent *rdap,
rd_event_msg_t *msg);
rd_err_e rd_init(int version);
typedef int rl_iter_f(const rd_loadobj_t *, void *);
rd_err_e rd_loadobj_iter(rd_agent_t *rap, rl_iter_f *cb,
void *clnt_data);
void rd_log(const int onoff);
rd_agent_t *rd_new(struct ps_prochandle *php);
rd_err_e rd_objpad_enable(struct rd_agent *rdap, size_t padsize);
rd_err_e rd_plt_resolution(rd_agent *rdap, paddr_t pc,
lwpid_t lwpid, paddr_t plt_base, rd_plt_info_t *rpi);
rd_err_e rd_reset(struct rd_agent *rdap);
DESCRIPTION
The librtld_db library provides support for monitoring and manipulating
runtime linking aspects of a program. There are at least two processes
involved, the controlling process and one or more target processes.
The controlling process is the librtld_db client that links with
librtld_db and uses librtld_db to inspect or modify runtime linking
aspects of one or more target processes. See the for a full descrip‐
tion of the runtime linker debugger interface mechanism.
USAGE
To use librtld_db, applications need to implement the interfaces docu‐
mented in ps_pread(3PROC) and proc_service(3PROC).
ATTRIBUTES
See attributes(5) for description of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOld.so.1(1), libc_db(3LIB), librtld_db(3LIB), proc_service(3PROC),
ps_pread(3PROC), attributes(5)SunOS 5.10 12 Oct 2007 rtld_db(3EXT)