/* * CDDL HEADER START * * The contents of this file are subject to the terms of the * Common Development and Distribution License (the "License"). * You may not use this file except in compliance with the License. * * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE * or http://www.opensolaris.org/os/licensing. * See the License for the specific language governing permissions * and limitations under the License. * * When distributing Covered Code, include this CDDL HEADER in each * file and include the License file at usr/src/OPENSOLARIS.LICENSE. * If applicable, add the following below this CDDL HEADER, with the * fields enclosed by brackets "[]" replaced with your own identifying * information: Portions Copyright [yyyy] [name of copyright owner] * * CDDL HEADER END */ /* * Copyright 2008 Sun Microsystems, Inc. All rights reserved. * Use is subject to license terms. */ #ifndef __RTLD_DB_H #define __RTLD_DB_H #pragma ident "%Z%%M% %I% %E% SMI" #include #include #include #include #include #ifdef __cplusplus extern "C" { #endif /* * Brand helper libraries must name their ops vector using this macro. */ #ifdef _LP64 #ifdef _ELF64 #define RTLD_DB_BRAND_OPS rtld_db_brand_ops64 #else /* !_ELF64 */ #define RTLD_DB_BRAND_OPS rtld_db_brand_ops32 #endif /* !_ELF64 */ #else /* !_LP64 */ #define RTLD_DB_BRAND_OPS rtld_db_brand_ops32 #endif /* !_LP64 */ /* * State kept for brand helper libraries * * All librtld_db brand plugin libraries need to specify a Lmid_t value * that controls how link map ids are assigned to native solaris objects * (as pointed to by the processes aux vectors) which are enumerated by * librtld_db. In most cases this value will either be LM_ID_NONE or * LM_ID_BRAND. * * If LM_ID_NONE is specified in the structure below, then when native solaris * objects are enumerated by librtld_db, their link map id values will match * the link map ids assigned to those objects by the solaris linker within * the target process. * * If LM_ID_BRAND is specified in the structure below, then when native solaris * objects are enumerated by librtld_db, their link map id value will be * explicity set to LM_ID_BRAND, regardless of the link map ids assigned to * those objects by the solaris linker within the target process. * * In all cases the librtld_db brand plugin library can report any link * map id value that it wants for objects that it enumerates via it's * rho_loadobj_iter() entry point. */ typedef struct __rd_helper_data *rd_helper_data_t; typedef struct rd_helper_ops { Lmid_t rho_lmid; rd_helper_data_t (*rho_init)(rd_agent_t *, struct ps_prochandle *); void (*rho_fini)(rd_helper_data_t); int (*rho_loadobj_iter)(rd_helper_data_t, rl_iter_f *, void *); rd_err_e (*rho_get_dyns)(rd_helper_data_t, psaddr_t, void **, size_t *); } rd_helper_ops_t; typedef struct rd_helper { void *rh_dlhandle; rd_helper_ops_t *rh_ops; rd_helper_data_t rh_data; } rd_helper_t; struct rd_agent { mutex_t rd_mutex; struct ps_prochandle *rd_psp; /* prochandle pointer */ psaddr_t rd_rdebug; /* rtld r_debug */ psaddr_t rd_preinit; /* rtld_db_preinit */ psaddr_t rd_postinit; /* rtld_db_postinit */ psaddr_t rd_dlact; /* rtld_db_dlact */ psaddr_t rd_tbinder; /* tail of binder */ psaddr_t rd_rtlddbpriv; /* rtld rtld_db_priv */ ulong_t rd_flags; /* flags */ ulong_t rd_rdebugvers; /* rtld_db_priv.vers */ int rd_dmodel; /* data model */ rd_helper_t rd_helper; /* private to helper */ }; /* * Values for rd_flags */ #define RDF_FL_COREFILE 0x0001 /* client is core file image */ #define RDAGLOCK(x) (void) mutex_lock(&(x->rd_mutex)); #define RDAGUNLOCK(x) (void) mutex_unlock(&(x->rd_mutex)); #define LOG(func) { \ (void) mutex_lock(&glob_mutex); \ if (rtld_db_logging) \ func; \ (void) mutex_unlock(&glob_mutex); \ } extern mutex_t glob_mutex; extern int rtld_db_version; extern int rtld_db_logging; extern rd_err_e rd_binder_exit_addr(struct rd_agent *, const char *, psaddr_t *); extern rd_err_e _rd_event_enable32(rd_agent_t *, int); extern rd_err_e _rd_event_getmsg32(rd_agent_t *, rd_event_msg_t *); extern rd_err_e _rd_get_dyns32(struct rd_agent *, psaddr_t, Dyn **, size_t *); extern rd_err_e _rd_get_ehdr32(struct rd_agent *, psaddr_t, Ehdr *, uint_t *); extern rd_err_e _rd_objpad_enable32(struct rd_agent *, size_t); extern rd_err_e _rd_loadobj_iter32(rd_agent_t *, rl_iter_f *, void *); extern rd_err_e _rd_reset32(struct rd_agent *); extern rd_err_e find_dynamic_ent32(struct rd_agent *, psaddr_t, Xword, Dyn *); extern rd_err_e plt32_resolution(rd_agent_t *, psaddr_t, lwpid_t, psaddr_t, rd_plt_info_t *); extern rd_err_e validate_rdebug32(struct rd_agent *rap); #ifdef _LP64 extern rd_err_e _rd_event_enable64(rd_agent_t *, int); extern rd_err_e _rd_event_getmsg64(rd_agent_t *, rd_event_msg_t *); extern rd_err_e _rd_get_dyns64(struct rd_agent *, psaddr_t, Elf64_Dyn **, size_t *); extern rd_err_e _rd_get_ehdr64(struct rd_agent *, psaddr_t, Elf64_Ehdr *, uint_t *); extern rd_err_e _rd_objpad_enable64(struct rd_agent *, size_t); extern rd_err_e _rd_loadobj_iter64(rd_agent_t *, rl_iter_f *, void *); extern rd_err_e _rd_reset64(struct rd_agent *); extern rd_err_e find_dynamic_ent64(struct rd_agent *, psaddr_t, Xword, Elf64_Dyn *); extern rd_err_e plt64_resolution(rd_agent_t *, psaddr_t, lwpid_t, psaddr_t, rd_plt_info_t *); extern rd_err_e validate_rdebug64(struct rd_agent *rap); #endif #ifdef __cplusplus } #endif #endif /* __RTLD_DB_H */