dlfcn.h revision f441771b0ce9f9d6122d318ff8290cb1a2848f9d
/*
* 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 (c) 1989, 2010, Oracle and/or its affiliates. All rights reserved.
*
* Copyright (c) 1989 AT&T
* All Rights Reserved
*
*/
#ifndef _DLFCN_H
#define _DLFCN_H
#include <sys/feature_tests.h>
#include <sys/types.h>
#if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
#include <sys/auxv.h>
#include <sys/mman.h>
#endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
#ifdef __cplusplus
extern "C" {
#endif
/*
* Information structures for various dlinfo() requests.
*/
#if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
#ifdef __STDC__
typedef struct dl_info {
const char *dli_fname; /* file containing address range */
void *dli_fbase; /* base address of file image */
const char *dli_sname; /* symbol name */
void *dli_saddr; /* symbol address */
} Dl_info;
#else
typedef struct dl_info {
char *dli_fname;
void *dli_fbase;
char *dli_sname;
void *dli_saddr;
} Dl_info;
#endif /* __STDC__ */
typedef Dl_info Dl_info_t;
typedef struct dl_serpath {
char *dls_name; /* library search path name */
uint_t dls_flags; /* path information */
} Dl_serpath;
typedef Dl_serpath Dl_serpath_t;
typedef struct dl_serinfo {
size_t dls_size; /* total buffer size */
uint_t dls_cnt; /* number of path entries */
Dl_serpath dls_serpath[1]; /* there may be more than one */
} Dl_serinfo;
typedef Dl_serinfo Dl_serinfo_t;
typedef struct dl_argsinfo {
long dla_argc; /* process argument count */
char **dla_argv; /* process arguments */
char **dla_envp; /* process environment variables */
auxv_t *dla_auxv; /* process auxv vectors */
} Dl_argsinfo;
typedef Dl_argsinfo Dl_argsinfo_t;
typedef struct {
mmapobj_result_t *dlm_maps; /* mapping information */
uint_t dlm_acnt; /* number of dlm_maps mappings */
uint_t dlm_rcnt; /* number of returned mappings */
} Dl_mapinfo_t;
typedef struct {
uint_t dlui_version; /* version # */
uint_t dlui_flags; /* flags */
char *dlui_objname; /* path to object */
void *dlui_unwindstart; /* star of unwind hdr */
void *dlui_unwindend; /* end of unwind hdr */
void *dlui_segstart; /* start of segment described */
/* by unwind block */
void *dlui_segend; /* end of segment described */
/* by unwind block */
} Dl_amd64_unwindinfo;
typedef Dl_amd64_unwindinfo Dl_amd64_unwindinfo_t;
typedef struct {
const char *dld_refname; /* reference name */
const char *dld_depname; /* new dependency name */
} Dl_definfo_t;
#endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
typedef ulong_t Lmid_t;
/*
* Declarations used for dynamic linking support routines.
*/
#ifdef __STDC__
extern void *dlopen(const char *, int);
extern void *dlsym(void *_RESTRICT_KYWD, const char *_RESTRICT_KYWD);
extern int dlclose(void *);
extern char *dlerror(void);
#if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
extern void *dlmopen(Lmid_t, const char *, int);
extern int dladdr(void *, Dl_info *);
extern int dladdr1(void *, Dl_info *, void **, int);
extern int dldump(const char *, const char *, int);
extern int dlinfo(void *, int, void *);
extern Dl_amd64_unwindinfo *dlamd64getunwind(void *, Dl_amd64_unwindinfo *);
#endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
#else
extern void *dlopen();
extern void *dlsym();
extern int dlclose();
extern char *dlerror();
#if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
extern void *dlmopen();
extern int dladdr();
extern int dladdr1();
extern int dldump();
extern int dlinfo();
extern Dl_amd64_unwindinfo *dlamd64getunwind();
#endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
#endif /* __STDC__ */
#pragma unknown_control_flow(dlopen, dlsym, dlclose, dlerror)
#if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
#pragma unknown_control_flow(dlmopen, dladdr, dladdr1, dldump, dlinfo)
#endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
/*
* Valid values for handle argument to dlsym(3x).
*/
#define RTLD_NEXT (void *)-1 /* look in `next' dependency */
#define RTLD_DEFAULT (void *)-2 /* look up symbol from scope */
/* of current object */
#define RTLD_SELF (void *)-3 /* look in `ourself' */
#define RTLD_PROBE (void *)-4 /* look up symbol from scope */
/* of current object, */
/* using currently */
/* loaded objects only. */
/*
* Valid values for mode argument to dlopen.
*/
#define RTLD_LAZY 0x00001 /* deferred function binding */
#define RTLD_NOW 0x00002 /* immediate function binding */
#define RTLD_NOLOAD 0x00004 /* don't load object */
#define RTLD_GLOBAL 0x00100 /* export symbols to others */
#define RTLD_LOCAL 0x00000 /* symbols are only available */
/* to group members */
#define RTLD_PARENT 0x00200 /* add parent (caller) to */
/* a group dependencies */
#define RTLD_GROUP 0x00400 /* resolve symbols within */
/* members of the group */
#define RTLD_WORLD 0x00800 /* resolve symbols within */
/* global objects */
#define RTLD_NODELETE 0x01000 /* do not remove members */
#define RTLD_FIRST 0x02000 /* only first object is */
/* available for dlsym */
#define RTLD_CONFGEN 0x10000 /* crle(1) config generation */
/* internal use only */
/*
* Valid values for flag argument to dldump.
*/
#define RTLD_REL_RELATIVE 0x00001 /* apply relative relocs */
#define RTLD_REL_EXEC 0x00002 /* apply symbolic relocs that */
/* bind to main */
#define RTLD_REL_DEPENDS 0x00004 /* apply symbolic relocs that */
/* bind to dependencies */
#define RTLD_REL_PRELOAD 0x00008 /* apply symbolic relocs that */
/* bind to preload objs */
#define RTLD_REL_SELF 0x00010 /* apply symbolic relocs that */
/* bind to ourself */
#define RTLD_REL_WEAK 0x00020 /* apply symbolic weak relocs */
/* even if unresolved */
#define RTLD_REL_ALL 0x00fff /* apply all relocs */
#define RTLD_MEMORY 0x01000 /* use memory sections */
#define RTLD_STRIP 0x02000 /* retain allocable sections */
/* only */
#define RTLD_NOHEAP 0x04000 /* do no save any heap */
#define RTLD_CONFSET 0x10000 /* crle(1) config generation */
/* internal use only */
/*
* Valid values for dladdr1() flags.
*/
#define RTLD_DL_SYMENT 1 /* return symbol table entry */
#define RTLD_DL_LINKMAP 2 /* return public link-map */
#define RTLD_DL_MASK 0xffff
/*
* Arguments for dlinfo()
*/
#define RTLD_DI_LMID 1 /* obtain link-map id */
#define RTLD_DI_LINKMAP 2 /* obtain link-map */
#define RTLD_DI_CONFIGADDR 3 /* obtain config addr */
#define RTLD_DI_SERINFO 4 /* obtain search path info or */
#define RTLD_DI_SERINFOSIZE 5 /* associated info size */
#define RTLD_DI_ORIGIN 6 /* obtain objects origin */
#define RTLD_DI_PROFILENAME 7 /* obtain profile object name */
/* internal use only */
#define RTLD_DI_PROFILEOUT 8 /* obtain profile output name */
/* internal use only */
#define RTLD_DI_GETSIGNAL 9 /* get termination signal */
#define RTLD_DI_SETSIGNAL 10 /* set termination signal */
#define RTLD_DI_ARGSINFO 11 /* get process arguments */
/* environment and auxv */
#define RTLD_DI_MMAPS 12 /* obtain objects mappings or */
#define RTLD_DI_MMAPCNT 13 /* mapping count */
#define RTLD_DI_DEFERRED 14 /* assign new dependency to a */
/* deferred dependency */
#define RTLD_DI_DEFERRED_SYM 15 /* assign new dependency to a */
/* deferred dependency */
/* using a symbol name */
#define RTLD_DI_MAX 15
#if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
/*
* Version information for Dl_amd64_unwindinfo.dlui_version
*/
#define DLUI_VERS_1 1
#define DLUI_VERS_CURRENT DLUI_VERS_1
/*
* Valid flags for Dl_amd64_unwindinfo.dlfi_flags
*/
#define DLUI_FLG_NOUNWIND 0x0001 /* object has no Unwind info */
#define DLUI_FLG_NOOBJ 0x0002 /* no object was found */
/* matching the pc provided */
#endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
#ifdef __cplusplus
}
#endif
#endif /* _DLFCN_H */