[apple/dyld.git] / include / dlfcn.h

/*
 * Copyright (c) 2004-2008 Apple Inc. All rights reserved.
 *
 * @APPLE_LICENSE_HEADER_START@
 * 
 * This file contains Original Code and/or Modifications of Original Code
 * as defined in and that are subject to the Apple Public Source License
 * Version 2.0 (the 'License'). You may not use this file except in
 * compliance with the License. Please obtain a copy of the License at
 * http://www.opensource.apple.com/apsl/ and read it before using this
 * file.
 * 
 * The Original Code and all software distributed under the License are
 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
 * Please see the License for the specific language governing rights and
 * limitations under the License.
 * 
 * @APPLE_LICENSE_HEADER_END@
 */

/*
  Based on the dlcompat work done by:
		Jorge Acereda  <jacereda@users.sourceforge.net> &
		Peter O'Gorman <ogorman@users.sourceforge.net>
*/

#ifndef _DLFCN_H_
#define _DLFCN_H_

#ifdef __cplusplus
extern "C" {
#endif

#include <sys/cdefs.h>

#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
#include <stdbool.h>
#include <Availability.h>

#ifdef __DRIVERKIT_19_0
 #define __DYLDDL_DRIVERKIT_UNAVAILABLE __API_UNAVAILABLE(driverkit)
#else
 #define __DYLDDL_DRIVERKIT_UNAVAILABLE
#endif

/*
 * Structure filled in by dladdr().
 */
typedef struct dl_info {
        const char      *dli_fname;     /* Pathname of shared object */
        void            *dli_fbase;     /* Base address of shared object */
        const char      *dli_sname;     /* Name of nearest symbol */
        void            *dli_saddr;     /* Address of nearest symbol */
} Dl_info;

extern int dladdr(const void *, Dl_info *);
#else
 #define __DYLDDL_DRIVERKIT_UNAVAILABLE
#endif /* not POSIX */

extern int dlclose(void * __handle) __DYLDDL_DRIVERKIT_UNAVAILABLE;
extern char * dlerror(void) __DYLDDL_DRIVERKIT_UNAVAILABLE;
extern void * dlopen(const char * __path, int __mode) __DYLDDL_DRIVERKIT_UNAVAILABLE;
extern void * dlsym(void * __handle, const char * __symbol) __DYLDDL_DRIVERKIT_UNAVAILABLE;

#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
extern bool dlopen_preflight(const char* __path) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0) __DYLDDL_DRIVERKIT_UNAVAILABLE;
#endif /* not POSIX */


#define RTLD_LAZY	0x1
#define RTLD_NOW	0x2
#define RTLD_LOCAL	0x4
#define RTLD_GLOBAL	0x8

#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
#define RTLD_NOLOAD	0x10
#define RTLD_NODELETE	0x80
#define RTLD_FIRST	0x100	/* Mac OS X 10.5 and later */

/*
 * Special handle arguments for dlsym().
 */
#define	RTLD_NEXT	((void *) -1)	/* Search subsequent objects. */
#define	RTLD_DEFAULT	((void *) -2)	/* Use default search algorithm. */
#define	RTLD_SELF	((void *) -3)	/* Search this and subsequent objects (Mac OS X 10.5 and later) */
#define	RTLD_MAIN_ONLY	((void *) -5)	/* Search main executable only (Mac OS X 10.5 and later) */
#endif /* not POSIX */

#ifdef __cplusplus
}
#endif

#endif /* _DLFCN_H_ */
Commit	Line	Data
0959b6d4	1	/*
39a8cd10	2	* Copyright (c) 2004-2008 Apple Inc. All rights reserved.
0959b6d4 A	3	*
	4	* @APPLE_LICENSE_HEADER_START@
	5	*
	6	* This file contains Original Code and/or Modifications of Original Code
	7	* as defined in and that are subject to the Apple Public Source License
	8	* Version 2.0 (the 'License'). You may not use this file except in
	9	* compliance with the License. Please obtain a copy of the License at
	10	* http://www.opensource.apple.com/apsl/ and read it before using this
	11	* file.
	12	*
	13	* The Original Code and all software distributed under the License are
	14	* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
	15	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
	16	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
	17	* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
	18	* Please see the License for the specific language governing rights and
	19	* limitations under the License.
	20	*
	21	* @APPLE_LICENSE_HEADER_END@
	22	*/
	23
	24	/*
	25	Based on the dlcompat work done by:
	26	Jorge Acereda <jacereda@users.sourceforge.net> &
	27	Peter O'Gorman <ogorman@users.sourceforge.net>
	28	*/
	29
	30	#ifndef _DLFCN_H_
	31	#define _DLFCN_H_
	32
	33	#ifdef __cplusplus
	34	extern "C" {
	35	#endif
	36
	37	#include <sys/cdefs.h>
	38
bac542e6 A	39	#if !defined(_POSIX_C_SOURCE) \|\| defined(_DARWIN_C_SOURCE)
bac542e6 A	40	#include <stdbool.h>
2fd3f4e8	41	#include <Availability.h>
cf998323 A	42
	43	#ifdef __DRIVERKIT_19_0
	44	#define __DYLDDL_DRIVERKIT_UNAVAILABLE __API_UNAVAILABLE(driverkit)
	45	#else
	46	#define __DYLDDL_DRIVERKIT_UNAVAILABLE
	47	#endif
	48
0959b6d4 A	49	/*
	50	* Structure filled in by dladdr().
	51	*/
	52	typedef struct dl_info {
	53	const char dli_fname; / Pathname of shared object */
	54	void dli_fbase; / Base address of shared object */
	55	const char dli_sname; / Name of nearest symbol */
	56	void dli_saddr; / Address of nearest symbol */
	57	} Dl_info;
	58
	59	extern int dladdr(const void , Dl_info );
cf998323 A	60	#else
cf998323 A	61	#define __DYLDDL_DRIVERKIT_UNAVAILABLE
0959b6d4 A	62	#endif /* not POSIX */
0959b6d4 A	63
cf998323 A	64	extern int dlclose(void * __handle) __DYLDDL_DRIVERKIT_UNAVAILABLE;
	65	extern char * dlerror(void) __DYLDDL_DRIVERKIT_UNAVAILABLE;
	66	extern void * dlopen(const char * __path, int __mode) __DYLDDL_DRIVERKIT_UNAVAILABLE;
	67	extern void * dlsym(void * __handle, const char * __symbol) __DYLDDL_DRIVERKIT_UNAVAILABLE;
0959b6d4	68
bac542e6	69	#if !defined(_POSIX_C_SOURCE) \|\| defined(_DARWIN_C_SOURCE)
cf998323	70	extern bool dlopen_preflight(const char* __path) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0) __DYLDDL_DRIVERKIT_UNAVAILABLE;
bac542e6 A	71	#endif /* not POSIX */
	72
	73
0959b6d4 A	74	#define RTLD_LAZY 0x1
	75	#define RTLD_NOW 0x2
	76	#define RTLD_LOCAL 0x4
	77	#define RTLD_GLOBAL 0x8
	78
bac542e6	79	#if !defined(_POSIX_C_SOURCE) \|\| defined(_DARWIN_C_SOURCE)
0959b6d4 A	80	#define RTLD_NOLOAD 0x10
0959b6d4 A	81	#define RTLD_NODELETE 0x80
bac542e6	82	#define RTLD_FIRST 0x100 /* Mac OS X 10.5 and later */
0959b6d4 A	83
	84	/*
	85	* Special handle arguments for dlsym().
	86	*/
39a8cd10	87	#define RTLD_NEXT ((void ) -1) / Search subsequent objects. */
0959b6d4	88	#define RTLD_DEFAULT ((void ) -2) / Use default search algorithm. */
39a8cd10 A	89	#define RTLD_SELF ((void ) -3) / Search this and subsequent objects (Mac OS X 10.5 and later) */
39a8cd10 A	90	#define RTLD_MAIN_ONLY ((void ) -5) / Search main executable only (Mac OS X 10.5 and later) */
0959b6d4 A	91	#endif /* not POSIX */
	92
	93	#ifdef __cplusplus
	94	}
	95	#endif
	96
	97	#endif /* _DLFCN_H_ */