usr/src/head/dlfcn.h

   1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License (the "License").
   6  * You may not use this file except in compliance with the License.
   7  *
   8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9  * or http://www.opensolaris.org/os/licensing.
  10  * See the License for the specific language governing permissions
  11  * and limitations under the License.
  12  *
  13  * When distributing Covered Code, include this CDDL HEADER in each
  14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15  * If applicable, add the following below this CDDL HEADER, with the
  16  * fields enclosed by brackets "[]" replaced with your own identifying
  17  * information: Portions Copyright [yyyy] [name of copyright owner]
  18  *
  19  * CDDL HEADER END
  20  */
  21 /*
  22  * Copyright 2014 Garrett D'Amore <garrett@damore.org>
  23  * Copyright (c) 1989, 2010, Oracle and/or its affiliates. All rights reserved.
  24  *
  25  *      Copyright (c) 1989 AT&T
  26  *        All Rights Reserved
  27  *
  28  */
  29
  30 #ifndef _DLFCN_H
  31 #define _DLFCN_H
  32
  33 #include <sys/feature_tests.h>
  34 #include <sys/types.h>
  35 #if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
  36 #include <sys/auxv.h>
  37 #include <sys/mman.h>
  38 #endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
  39
  40 #ifdef  __cplusplus
  41 extern "C" {
  42 #endif
  43
  44 /*
  45  * Information structures for various dlinfo() requests.
  46  */
  47 #if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
  48 typedef struct  dl_info {
  49         const char      *dli_fname;     /* file containing address range */
  50         void            *dli_fbase;     /* base address of file image */
  51         const char      *dli_sname;     /* symbol name */
  52         void            *dli_saddr;     /* symbol address */
  53 } Dl_info;
  54 typedef Dl_info         Dl_info_t;
  55
  56 typedef struct  dl_serpath {
  57         char            *dls_name;      /* library search path name */
  58         uint_t          dls_flags;      /* path information */
  59 } Dl_serpath;
  60 typedef Dl_serpath      Dl_serpath_t;
  61
  62 typedef struct  dl_serinfo {
  63         size_t          dls_size;       /* total buffer size */
  64         uint_t          dls_cnt;        /* number of path entries */
  65         Dl_serpath      dls_serpath[1]; /* there may be more than one */
  66 } Dl_serinfo;
  67 typedef Dl_serinfo      Dl_serinfo_t;
  68
  69 typedef struct  dl_argsinfo {
  70         long            dla_argc;       /* process argument count */
  71         char            **dla_argv;     /* process arguments */
  72         char            **dla_envp;     /* process environment variables */
  73         auxv_t          *dla_auxv;      /* process auxv vectors */
  74 } Dl_argsinfo;
  75 typedef Dl_argsinfo     Dl_argsinfo_t;
  76
  77 typedef struct {
  78         mmapobj_result_t *dlm_maps;     /* mapping information */
  79         uint_t          dlm_acnt;       /* number of dlm_maps mappings */
  80         uint_t          dlm_rcnt;       /* number of returned mappings */
  81 } Dl_mapinfo_t;
  82
  83 typedef struct {
  84         uint_t          dlui_version;   /* version # */
  85         uint_t          dlui_flags;     /* flags */
  86         char            *dlui_objname;  /* path to object */
  87         void            *dlui_unwindstart; /* star of unwind hdr */
  88         void            *dlui_unwindend; /* end of unwind hdr */
  89         void            *dlui_segstart; /* start of segment described */
  90                                         /*  by unwind block */
  91         void            *dlui_segend;   /* end of segment described */
  92                                         /*  by unwind block */
  93 } Dl_amd64_unwindinfo;
  94 typedef Dl_amd64_unwindinfo     Dl_amd64_unwindinfo_t;
  95
  96 typedef struct {
  97         const char      *dld_refname;   /* reference name */
  98         const char      *dld_depname;   /* new dependency name */
  99 } Dl_definfo_t;
 100
 101 #endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
 102
 103
 104 typedef ulong_t         Lmid_t;
 105
 106 /*
 107  * Declarations used for dynamic linking support routines.
 108  */
 109 extern void     *dlopen(const char *, int);
 110 extern void     *dlsym(void *_RESTRICT_KYWD, const char *_RESTRICT_KYWD);
 111 extern int      dlclose(void *);
 112 extern char     *dlerror(void);
 113 #if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
 114 extern void     *dlmopen(Lmid_t, const char *, int);
 115 extern int      dladdr(void *, Dl_info *);
 116 extern int      dladdr1(void *, Dl_info *, void **, int);
 117 extern int      dldump(const char *, const char *, int);
 118 extern int      dlinfo(void *, int, void *);
 119 extern Dl_amd64_unwindinfo  *dlamd64getunwind(void *, Dl_amd64_unwindinfo *);
 120 #endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
 121
 122 #pragma unknown_control_flow(dlopen, dlsym, dlclose, dlerror)
 123 #if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
 124 #pragma unknown_control_flow(dlmopen, dladdr, dladdr1, dldump, dlinfo)
 125 #endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
 126
 127 /*
 128  * Valid values for handle argument to dlsym(3x).
 129  */
 130 #define RTLD_NEXT               (void *)-1      /* look in `next' dependency */
 131 #define RTLD_DEFAULT            (void *)-2      /* look up symbol from scope */
 132                                                 /*      of current object */
 133 #define RTLD_SELF               (void *)-3      /* look in `ourself' */
 134 #define RTLD_PROBE              (void *)-4      /* look up symbol from scope */
 135                                                 /*      of current object, */
 136                                                 /*      using currently */
 137                                                 /*      loaded objects only. */
 138 /*
 139  * Valid values for mode argument to dlopen.
 140  */
 141 #define RTLD_LAZY               0x00001         /* deferred function binding */
 142 #define RTLD_NOW                0x00002         /* immediate function binding */
 143 #define RTLD_NOLOAD             0x00004         /* don't load object */
 144
 145 #define RTLD_GLOBAL             0x00100         /* export symbols to others */
 146 #define RTLD_LOCAL              0x00000         /* symbols are only available */
 147                                                 /*      to group members */
 148 #define RTLD_PARENT             0x00200         /* add parent (caller) to */
 149                                                 /*      a group dependencies */
 150 #define RTLD_GROUP              0x00400         /* resolve symbols within */
 151                                                 /*      members of the group */
 152 #define RTLD_WORLD              0x00800         /* resolve symbols within */
 153                                                 /*      global objects */
 154 #define RTLD_NODELETE           0x01000         /* do not remove members */
 155 #define RTLD_FIRST              0x02000         /* only first object is */
 156                                                 /*      available for dlsym */
 157 #define RTLD_CONFGEN            0x10000         /* crle(1) config generation */
 158                                                 /*      internal use only */
 159
 160 /*
 161  * Valid values for flag argument to dldump.
 162  */
 163 #define RTLD_REL_RELATIVE       0x00001         /* apply relative relocs */
 164 #define RTLD_REL_EXEC           0x00002         /* apply symbolic relocs that */
 165                                                 /*      bind to main */
 166 #define RTLD_REL_DEPENDS        0x00004         /* apply symbolic relocs that */
 167                                                 /*      bind to dependencies */
 168 #define RTLD_REL_PRELOAD        0x00008         /* apply symbolic relocs that */
 169                                                 /*      bind to preload objs */
 170 #define RTLD_REL_SELF           0x00010         /* apply symbolic relocs that */
 171                                                 /*      bind to ourself */
 172 #define RTLD_REL_WEAK           0x00020         /* apply symbolic weak relocs */
 173                                                 /*      even if unresolved */
 174 #define RTLD_REL_ALL            0x00fff         /* apply all relocs */
 175
 176 #define RTLD_MEMORY             0x01000         /* use memory sections */
 177 #define RTLD_STRIP              0x02000         /* retain allocable sections */
 178                                                 /*      only */
 179 #define RTLD_NOHEAP             0x04000         /* do no save any heap */
 180 #define RTLD_CONFSET            0x10000         /* crle(1) config generation */
 181                                                 /*      internal use only */
 182
 183 /*
 184  * Valid values for dladdr1() flags.
 185  */
 186 #define RTLD_DL_SYMENT          1               /* return symbol table entry */
 187 #define RTLD_DL_LINKMAP         2               /* return public link-map */
 188 #define RTLD_DL_MASK            0xffff
 189
 190
 191 /*
 192  * Arguments for dlinfo()
 193  */
 194 #define RTLD_DI_LMID            1               /* obtain link-map id */
 195 #define RTLD_DI_LINKMAP         2               /* obtain link-map */
 196 #define RTLD_DI_CONFIGADDR      3               /* obtain config addr */
 197 #define RTLD_DI_SERINFO         4               /* obtain search path info or */
 198 #define RTLD_DI_SERINFOSIZE     5               /*    associated info size */
 199 #define RTLD_DI_ORIGIN          6               /* obtain objects origin */
 200 #define RTLD_DI_PROFILENAME     7               /* obtain profile object name */
 201                                                 /*    internal use only */
 202 #define RTLD_DI_PROFILEOUT      8               /* obtain profile output name */
 203                                                 /*    internal use only */
 204 #define RTLD_DI_GETSIGNAL       9               /* get termination signal */
 205 #define RTLD_DI_SETSIGNAL       10              /* set termination signal */
 206 #define RTLD_DI_ARGSINFO        11              /* get process arguments */
 207                                                 /*    environment and auxv */
 208 #define RTLD_DI_MMAPS           12              /* obtain objects mappings or */
 209 #define RTLD_DI_MMAPCNT         13              /*    mapping count */
 210 #define RTLD_DI_DEFERRED        14              /* assign new dependency to a */
 211                                                 /*    deferred dependency */
 212 #define RTLD_DI_DEFERRED_SYM    15              /* assign new dependency to a */
 213                                                 /*    deferred dependency */
 214                                                 /*    using a symbol name */
 215 #define RTLD_DI_MAX             15
 216
 217 #if !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
 218 /*
 219  * Version information for Dl_amd64_unwindinfo.dlui_version
 220  */
 221 #define DLUI_VERS_1             1
 222 #define DLUI_VERS_CURRENT       DLUI_VERS_1
 223
 224 /*
 225  * Valid flags for Dl_amd64_unwindinfo.dlfi_flags
 226  */
 227 #define DLUI_FLG_NOUNWIND       0x0001          /* object has no Unwind info */
 228 #define DLUI_FLG_NOOBJ          0x0002          /* no object was found */
 229                                                 /*  matching the pc provided */
 230 #endif /* !defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__) */
 231
 232 #ifdef  __cplusplus
 233 }
 234 #endif
 235
 236 #endif  /* _DLFCN_H */