| 1 | /* | 
 
 
 
 
 | 2 | * dlfcn.h | 
 
 
 
 
 | 3 | * | 
 
 
 
 
 | 4 | * Public interface declarations for (approximately) POSIX conforming | 
 
 
 
 
 | 5 | * dlopen(), dlsym(), dlclose(), and dlerror() API functions. | 
 
 
 
 
 | 6 | * | 
 
 
 
 
 | 7 | * $Id: dlfcn.h,v 82d2db93e4de 2014/11/11 18:13:14 keithmarshall $ | 
 
 
 
 
 | 8 | * | 
 
 
 
 
 | 9 | * Written by Keith Marshall <keithmarshall@users.sourceforge.net> | 
 
 
 
 
 | 10 | * Copyright (C) 2014, MinGW.org Project | 
 
 
 
 
 | 11 | * | 
 
 
 
 
 | 12 | * | 
 
 
 
 
 | 13 | * Permission is hereby granted, free of charge, to any person obtaining a | 
 
 
 
 
 | 14 | * copy of this software and associated documentation files (the "Software"), | 
 
 
 
 
 | 15 | * to deal in the Software without restriction, including without limitation | 
 
 
 
 
 | 16 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, | 
 
 
 
 
 | 17 | * and/or sell copies of the Software, and to permit persons to whom the | 
 
 
 
 
 | 18 | * Software is furnished to do so, subject to the following conditions: | 
 
 
 
 
 | 19 | * | 
 
 
 
 
 | 20 | * The above copyright notice, this permission notice, and the following | 
 
 
 
 
 | 21 | * disclaimer shall be included in all copies or substantial portions of | 
 
 
 
 
 | 22 | * the Software. | 
 
 
 
 
 | 23 | * | 
 
 
 
 
 | 24 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS | 
 
 
 
 
 | 25 | * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | 
 
 
 
 
 | 26 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL | 
 
 
 
 
 | 27 | * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | 
 
 
 
 
 | 28 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING | 
 
 
 
 
 | 29 | * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OF OR OTHER | 
 
 
 
 
 | 30 | * DEALINGS IN THE SOFTWARE. | 
 
 
 
 
 | 31 | * | 
 
 
 
 
 | 32 | */ | 
 
 
 
 
 | 33 | #ifndef _DLFCN_H | 
 
 
 
 
 | 34 | #define _DLFCN_H  1 | 
 
 
 
 
 | 35 | #pragma GCC system_header | 
 
 
 
 
 | 36 |  | 
 
 
 
 
 | 37 | #include <_mingw.h> | 
 
 
 
 
 | 38 |  | 
 
 
 
 
 | 39 | /* POSIX requires the following four definitions.  Our implementation | 
 
 
 
 
 | 40 | * (currently) does not support the behaviour associated with RTLD_LAZY; | 
 
 
 
 
 | 41 | * if specified, it is simply ignored; RTLD_NOW behaviour will prevail. | 
 
 
 
 
 | 42 | */ | 
 
 
 
 
 | 43 | #define RTLD_NOW        0 | 
 
 
 
 
 | 44 | #define RTLD_LAZY       1 | 
 
 
 
 
 | 45 | #define RTLD_GLOBAL     2 | 
 
 
 
 
 | 46 | #define RTLD_LOCAL      4 | 
 
 
 
 
 | 47 |  | 
 
 
 
 
 | 48 | /* POSIX does not yet require the following pair, but reserves them for | 
 
 
 
 
 | 49 | * future capabilities; they will be used in contexts where a DLL module | 
 
 
 
 
 | 50 | * handle is expected, so we reserve values of suitable type, which are | 
 
 
 
 
 | 51 | * unlikely to ever occur as real module handles in practice. | 
 
 
 
 
 | 52 | */ | 
 
 
 
 
 | 53 | #define RTLD_DEFAULT    (void *)(-1) | 
 
 
 
 
 | 54 | #define RTLD_NEXT       (void *)(-3) | 
 
 
 
 
 | 55 |  | 
 
 
 
 
 | 56 | /* The four dlfcn API functions, dlopen(), dlsym(), dlerror(), and dlclose(), | 
 
 
 
 
 | 57 | * are each defined privately, and made publicly accessible via corresponding | 
 
 
 
 
 | 58 | * function pointers, within the following publicly visible structure. | 
 
 
 
 
 | 59 | */ | 
 
 
 
 
 | 60 | _EXTERN_C struct __dlfcn__ | 
 
 
 
 
 | 61 | { void *(*dlopen)( const char *, int ); | 
 
 
 
 
 | 62 | void *(*dlsym)( void *__restrict__, const char *__restrict__ ); | 
 
 
 
 
 | 63 | char *(*dlerror)( void ); | 
 
 
 
 
 | 64 | int (*dlclose)( void * ); | 
 
 
 
 
 | 65 | } __mingw_dlfcn; | 
 
 
 
 
 | 66 |  | 
 
 
 
 
 | 67 | /* Declare the public API for each of these functions... | 
 
 
 
 
 | 68 | */ | 
 
 
 
 
 | 69 | _BEGIN_C_DECLS | 
 
 
 
 
 | 70 |  | 
 
 
 
 
 | 71 | /* In any event, we always declare prototypes for all four functions. | 
 
 
 
 
 | 72 | */ | 
 
 
 
 
 | 73 | void * dlopen( const char *, int ); | 
 
 
 
 
 | 74 | void * dlsym( void *__restrict__, const char *__restrict__ ); | 
 
 
 
 
 | 75 | int    dlclose( void * ); | 
 
 
 
 
 | 76 | char * dlerror( void ); | 
 
 
 
 
 | 77 |  | 
 
 
 
 
 | 78 | __CRT_ALIAS __LIBIMPL__(( FUNCTION = dlopen )) | 
 
 
 
 
 | 79 | void *dlopen( const char *__name, int __mode ) | 
 
 
 
 
 | 80 | { return __mingw_dlfcn.dlopen( __name, __mode ); } | 
 
 
 
 
 | 81 |  | 
 
 
 
 
 | 82 | __CRT_ALIAS __LIBIMPL__(( FUNCTION = dlsym )) | 
 
 
 
 
 | 83 | void *dlsym( void *__restrict__ __module, const char *__restrict__ __name ) | 
 
 
 
 
 | 84 | { return __mingw_dlfcn.dlsym( __module, __name ); } | 
 
 
 
 
 | 85 |  | 
 
 
 
 
 | 86 | __CRT_ALIAS __LIBIMPL__(( FUNCTION = dlclose )) | 
 
 
 
 
 | 87 | int dlclose( void *__module ){ return __mingw_dlfcn.dlclose( __module ); } | 
 
 
 
 
 | 88 |  | 
 
 
 
 
 | 89 | __CRT_ALIAS __LIBIMPL__(( FUNCTION = dlerror )) | 
 
 
 
 
 | 90 | char *dlerror( void ){ return __mingw_dlfcn.dlerror(); } | 
 
 
 
 
 | 91 |  | 
 
 
 
 
 | 92 | _END_C_DECLS | 
 
 
 
 
 | 93 |  | 
 
 
 
 
 | 94 | #endif /* _DLFCN_H: $RCSfile: dlfcn.h,v $: end of file */ |