_rtld.h revision 8af2c5b9bdbf69a55f079d7ad9483d38fae9f023
/*
* 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
* 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 (c) 1988 AT&T
* All Rights Reserved
*
*
* Copyright 2007 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef __RTLD_H
#define __RTLD_H
#pragma ident "%Z%%M% %I% %E% SMI"
/*
* Common header for run-time linker.
*/
#include <stdarg.h>
#include <synch.h>
#include <signal.h>
#include <errno.h>
#include <unistd.h>
#include <link.h>
#include <rtld.h>
#include <sgs.h>
#include <machdep.h>
#include <rtc.h>
#include <debug.h>
#include <msg.h>
#include <libc_int.h>
#ifdef __cplusplus
extern "C" {
#endif
/*
* Dependency search rule order.
*/
/*
* Data structure for file class specific functions and data.
*/
typedef struct fct {
int); /* map in a shared object */
/* determine needed objects */
/* initialize symbol lookup */
/* search */
/* search (set[ug]id) */
/* transpose name */
char *(*fct_get_so)(const char *, const char *);
/* get shared object */
/* get symbolic address */
/* process dlsym request */
/* verify versioning (ELF) */
int (*fct_set_prot)(Rt_map *, int);
/* set protection */
} Fct;
/*
* Return codes for util::anon_map().
*/
typedef enum {
AM_OK, /* mmap(MAP_ANON) succeeded */
AM_NOSUP, /* mmap(MAP_ANON) not supported (old OS) */
AM_ERROR /* mmap(MAP_ANON) failed */
} Am_ret;
/*
* Macros for getting to the file class table.
*/
/*
* Define Alist initialization sizes.
*/
/* count */
/*
* Size of buffer for building error messages.
*/
/*
* Configuration file information.
*/
typedef struct config {
const char *c_name;
const char *c_strtbl;
} Config;
/*
* Register symbol list.
*/
typedef struct reglist {
} Reglist;
/*
* Data structure to hold interpreter information.
*/
typedef struct interp {
char *i_name; /* interpreter name */
} Interp;
/*
* Data structure used to keep track of copy relocations. These relocations
* are collected during initial relocation processing and maintained on the
* COPY(lmp) list of the defining object. Each copy list is also added to the
* COPY(lmp) of the head object (normally the application dynamic executable)
* from which they will be processed after all relocations are done.
*
* The use of RTLD_GROUP will also reference individual objects COPY(lmp) lists
* in case a bound symbol must be assigned to it actual copy relocation.
*/
typedef struct {
const char *r_name; /* symbol name */
void *r_radd; /* copy to address */
const void *r_dadd; /* copy from address */
} Rel_copy;
/*
* Data structure to hold initial file mapping information. Used to
* communicate during initial object mapping and provide for error recovery.
*/
typedef struct {
char *fm_maddr; /* address of initial mapping */
int fm_mflags; /* mapping flags */
} Fmap;
/* big enough to capture standard */
/* filters */
/*
* Define a file descriptor, which maintains information regarding a pathname
* that has been opened and minimally inspected.
*/
typedef struct {
const char *fd_oname; /* original file name */
const char *fd_odir; /* original directory name */
const char *fd_nname; /* new file (expanded) name */
const char *fd_pname; /* new path (resolved) name */
int fd_fd; /* open file descriptor */
} Fdesc;
/*
* File descriptor availability flag.
*/
#define FD_UNAVAIL -1
/*
* Disabled filter flag. Filter objects are referenced using their .dynamic
* index (DT_FILTER or DT_AUXILIARY). This index is saved and used to lookup
* the required filter. Note that 0 is a valid .dynamic index. The caller's
* OBJFLTRNDX() element is initialized using the following flag, and should
* the filter's initialization fail, is reset to this value to indicate the
* filter is disabled. UINT_MAX provides a convenient invalid .dynamic index.
*/
#define FLTR_DISABLED UINT_MAX
/*
* Status flags for rtld_flags
*/
#ifdef SIEBEL_DISABLE
#endif
/* set by crle(1). */
/* cache required */
/*
* Status flags for rtld_flags2
*/
/*
* Information flags for env_info.
*/
/* originates from configuration */
/* file */
/* from configuration file */
/*
* RTLDINFO descriptor.
*/
typedef struct {
} Rti_desc;
/*
* Binding flags for the bindguard routines.
*/
#define ROUND(x, a) (((int)(x) + ((int)(a) - 1)) & \
~((int)(a) - 1))
/*
* Print buffer.
*/
typedef struct {
char *pr_buf; /* pointer to beginning of buffer */
char *pr_cur; /* pointer to next free char in buffer */
int pr_fd; /* output fd */
} Prfbuf;
/*
* dlopen() handle list size.
*/
/*
* Define expansion path information. Search paths, i.e., LD_LIBRARY_PATH,
* RPATHS, etc. are defined using la_objsearch() information (see LA_SER flags
* in link.h). Definitions here extend the path information to other uses of
* pathname expansion, and are or'd together with any LA_SER_* flags.
*/
/* (preload, audit etc.) */
/*
* Define reserved path tokens. These are used to prevent various expansions
* from occurring, and record those expansions that do. Note that any expansion
* information is also recorded in the p_orig field of a Pnode, and thus is
* or'd together with any LA_SER_* flags.
*/
/*
* Define alist descriptor addition return values (see hdl_add()).
*/
/*
* Define _caller flags.
*/
#define CL_NONE 0
/* if the caller can't be determined */
/*
* Binding information. Note, this is or'ed in with the DBG_BINFO flags to
* convey information regarding symbol bindings.
*/
/*
* Data declarations.
*/
extern char **environ; /* environ pointer */
extern int dyn_plt_ent_size; /* Size of dynamic plt's */
extern const char *procname; /* file name of executing process */
extern char *lasterr; /* string describing last error */
extern const char *rtldname; /* name of the dynamic linker */
extern char *platform; /* platform name */
/* data */
#endif
extern const char *locale; /* locale environment setting */
extern const char *locale; /* locale environment setting */
extern const char *rpl_audit; /* replaceable LD_AUDIT string */
extern const char *rpl_debug; /* replaceable LD_DEBUG string */
extern const char *rpl_ldflags; /* replaceable LD_FLAGS string */
extern const char *rpl_libpath; /* replaceable LD_LIBRARY string */
extern const char *rpl_preload; /* replaceable LD_PRELOAD string */
extern const char *prm_audit; /* permanent LD_AUDIT string */
extern const char *prm_debug; /* permanent LD_DEBUG string */
extern const char *prm_ldflags; /* permanent LD_FLAGS string */
extern const char *prm_libpath; /* permanent LD_LIBRARY string */
extern const char *prm_preload; /* permanent LD_PRELOAD string */
/* variables */
extern int killsig; /* signal sent on fatal exit */
extern char **_environ;
extern const char *dbg_file; /* debugging directed to a file */
extern const Msg ldd_reject[];
extern const char *profile_name; /* object being profiled */
extern const char *profile_out; /* profile output file */
extern const char *profile_lib; /* audit library to perform profile */
/* auxv information */
extern const char *err_strs[]; /* diagnostic error string headers */
extern const char *nosym_str; /* MSG_GEN_NOSYM message cache */
/*
* Function declarations.
*/
extern int append_alias(Rt_map *, const char *, int *);
const char *);
extern void atexit_fini(void);
extern const char *demangle(const char *);
uint_t *);
extern void dz_init(int);
extern int elf_config(Rt_map *, int);
ulong_t);
ulong_t, long);
extern int enter(void);
Rt_map *);
extern void fpavl_remove(Rt_map *);
extern void fmap_setup();
extern void ldso_plt_init(Rt_map *);
extern void list_delete(List *, void *);
Lm_cntl *);
extern void load_completion(Rt_map *);
const char *);
extern void remove_lists(Rt_map *, int);
extern void remove_lml(Lm_list *);
extern void remove_pnode(Pnode *);
extern void remove_rej(Rej_desc *);
extern int rt_cond_broadcast(Rt_cond *);
extern Rt_cond *rt_cond_create(void);
extern int rt_bind_guard(int);
extern int rt_bind_clear(int);
extern int rt_mutex_lock(Rt_lock *);
extern int rt_mutex_unlock(Rt_lock *);
extern void rt_thr_init(Lm_list *);
extern thread_t rt_thr_self(void);
extern void rtld_db_dlactivity(Lm_list *);
extern void rtld_db_preinit(Lm_list *);
extern void rtld_db_postinit(Lm_list *);
Word *, int);
extern void set_environ(Lm_list *);
int, uint_t);
extern int update_mode(Rt_map *, int, int);
#if defined(__sparc)
/*
* SPARC Register symbol support.
*/
extern int elf_regsyms(Rt_map *);
extern void set_sparc_g1(ulong_t);
extern void set_sparc_g2(ulong_t);
extern void set_sparc_g3(ulong_t);
extern void set_sparc_g4(ulong_t);
extern void set_sparc_g5(ulong_t);
extern void set_sparc_g6(ulong_t);
extern void set_sparc_g7(ulong_t);
#endif
extern long _sysconfig(int);
#ifdef __cplusplus
}
#endif
#endif /* __RTLD_H */