4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/*
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * CDDL HEADER START
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * The contents of this file are subject to the terms of the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Common Development and Distribution License (the "License").
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * You may not use this file except in compliance with the License.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * or http://www.opensolaris.org/os/licensing.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * See the License for the specific language governing permissions
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * and limitations under the License.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * When distributing Covered Code, include this CDDL HEADER in each
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * If applicable, add the following below this CDDL HEADER, with the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * fields enclosed by brackets "[]" replaced with your own identifying
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * information: Portions Copyright [yyyy] [name of copyright owner]
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * CDDL HEADER END
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/*
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Copyright 2014 Garrett D'Amore <garrett@damore.org>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Use is subject to license terms.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#ifndef _RTLD_DB_H
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#define _RTLD_DB_H
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#ifdef __cplusplus
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncextern "C" {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#endif
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <sys/types.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <sys/lwp.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <sys/elf.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <link.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#include <proc_service.h>
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/*
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * librtld_db interface versions
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#define RD_VERSION1 1
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#define RD_VERSION2 2
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#define RD_VERSION3 3
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#define RD_VERSION4 4
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync#define RD_VERSION RD_VERSION4
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsynctypedef enum {
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RD_ERR, /* generic */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RD_OK, /* generic "call" succeeded */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RD_NOCAPAB, /* capability not available */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RD_DBERR, /* import service failed */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RD_NOBASE, /* 5.x: aux tag AT_BASE not found */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RD_NODYNAM, /* symbol 'DYNAMIC' not found */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync RD_NOMAPS /* link-maps are not yet available */
} rd_err_e;
/*
* ways that the event notification can take place:
*/
typedef enum {
RD_NOTIFY_BPT, /* set break-point at address */
RD_NOTIFY_AUTOBPT, /* 4.x compat. not used in 5.x */
RD_NOTIFY_SYSCALL /* watch for syscall */
} rd_notify_e;
/*
* information on ways that the event notification can take place:
*/
typedef struct rd_notify {
rd_notify_e type;
union {
psaddr_t bptaddr; /* break point address */
long syscallno; /* system call id */
} u;
} rd_notify_t;
/*
* information about event instance:
*/
typedef enum {
RD_NOSTATE = 0, /* no state information */
RD_CONSISTENT, /* link-maps are stable */
RD_ADD, /* currently adding object to link-maps */
RD_DELETE /* currently deleteing object from link-maps */
} rd_state_e;
typedef struct rd_event_msg {
rd_event_e type;
union {
rd_state_e state; /* for DLACTIVITY */
} u;
} rd_event_msg_t;
/*
* iteration over load objects
*/
typedef struct rd_loadobj {
psaddr_t rl_nameaddr; /* address of the name in user space */
unsigned rl_flags;
psaddr_t rl_base; /* base of address of code */
psaddr_t rl_data_base; /* base of address of data */
Lmid_t rl_lmident; /* ident of link map */
psaddr_t rl_refnameaddr; /* reference name of filter in user */
/* space. If non null object is a */
/* filter. */
psaddr_t rl_plt_base; /* These fields are present for 4.x */
unsigned rl_plt_size; /* compatibility and are not */
/* currently used in SunOS5.x */
psaddr_t rl_bend; /* end of image (text+data+bss) */
psaddr_t rl_padstart; /* start of padding */
psaddr_t rl_padend; /* end of image after padding */
psaddr_t rl_dynamic; /* points to the DYNAMIC section */
/* in the target process */
unsigned long rl_tlsmodid; /* module ID for TLS references */
} rd_loadobj_t;
/*
* Values for rl_flags
*/
#define RD_FLG_MEM_OBJECT 0x0001 /* Identifies this object as */
/* originating from a relocatable */
/* module which was dynamically */
/* loaded */
/*
* Commands for rd_ctl()
*/
#define RD_CTL_SET_HELPPATH 0x01 /* Set the path used to find helpers */
typedef struct rd_agent rd_agent_t;
typedef int rl_iter_f(const rd_loadobj_t *, void *);
/*
* PLT skipping
*/
typedef enum {
RD_RESOLVE_NONE, /* don't do anything special */
RD_RESOLVE_STEP, /* step 'pi_nstep' instructions */
RD_RESOLVE_TARGET, /* resolved target is in 'pi_target' */
RD_RESOLVE_TARGET_STEP /* put a bpt on target, then step nstep times */
} rd_skip_e;
typedef struct rd_plt_info {
rd_skip_e pi_skip_method;
long pi_nstep;
psaddr_t pi_target;
psaddr_t pi_baddr;
unsigned int pi_flags;
} rd_plt_info_t;
/*
* Values for pi_flags
*/
#define RD_FLG_PI_PLTBOUND 0x0001 /* Indicates that the PLT */
/* has been bound - and that */
/* pi_baddr will contain its */
/* destination address */
struct ps_prochandle;
/*
* librtld_db.so entry points
*/
extern void rd_delete(rd_agent_t *);
extern char *rd_errstr(rd_err_e rderr);
extern rd_err_e rd_event_addr(rd_agent_t *, rd_event_e, rd_notify_t *);
extern rd_err_e rd_event_enable(rd_agent_t *, int);
extern rd_err_e rd_event_getmsg(rd_agent_t *, rd_event_msg_t *);
extern rd_err_e rd_init(int);
extern rd_err_e rd_ctl(int, void *);
extern rd_err_e rd_loadobj_iter(rd_agent_t *, rl_iter_f *,
void *);
extern void rd_log(const int);
extern rd_agent_t *rd_new(struct ps_prochandle *);
extern rd_err_e rd_objpad_enable(struct rd_agent *, size_t);
extern rd_err_e rd_plt_resolution(rd_agent_t *, psaddr_t, lwpid_t,
psaddr_t, rd_plt_info_t *);
extern rd_err_e rd_get_dyns(rd_agent_t *, psaddr_t, void **, size_t *);
extern rd_err_e rd_reset(struct rd_agent *);
#ifdef __cplusplus
}
#endif
#endif /* _RTLD_DB_H */