1/*	$OpenBSD: dlfcn.h,v 1.16 2022/08/20 17:39:22 tb Exp $	*/
2/*	$NetBSD: dlfcn.h,v 1.2 1995/06/05 19:38:00 pk Exp $	*/
3
4/*
5 * Copyright (c) 1995 Paul Kranenburg
6 * All rights reserved.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
11 * 1. Redistributions of source code must retain the above copyright
12 *    notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 *    notice, this list of conditions and the following disclaimer in the
15 *    documentation and/or other materials provided with the distribution.
16 * 3. All advertising materials mentioning features or use of this software
17 *    must display the following acknowledgement:
18 *      This product includes software developed by Paul Kranenburg.
19 * 4. The name of the author may not be used to endorse or promote products
20 *    derived from this software without specific prior written permission
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
23 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
25 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
26 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
27 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
31 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32 */
33
34#ifndef _DLFCN_H_
35#define _DLFCN_H_
36
37#include <sys/cdefs.h>
38
39/* Values for dlopen `mode'. */
40#define RTLD_LAZY	1
41#define RTLD_NOW	2
42#define RTLD_GLOBAL	0x100
43#define RTLD_LOCAL	0x000
44#define RTLD_TRACE	0x200
45#define RTLD_NODELETE	0x400
46#define RTLD_NOLOAD	0x800
47
48/*
49 * Special handle arguments for dlsym().
50 */
51#define	RTLD_NEXT	((void *) -1)	/* Search subsequent objects. */
52#define	RTLD_DEFAULT	((void *) -2)	/* Use default search algorithm. */
53#define	RTLD_SELF	((void *) -3)	/* Search the caller itself. */
54
55#if __BSD_VISIBLE
56
57/*
58 * Structure filled in by dladdr().
59 */
60typedef	struct dl_info {
61	const char	*dli_fname;	/* Pathname of shared object. */
62	void		*dli_fbase;	/* Base address of shared object. */
63	const char	*dli_sname;	/* Name of nearest symbol. */
64	void		*dli_saddr;	/* Address of nearest symbol. */
65} Dl_info;
66
67/*
68 * dlctl() commands
69 */
70#define DL_GETERRNO	1
71#define DL_SETSRCHPATH	x
72#define DL_GETLIST	x
73#define DL_GETREFCNT	x
74#define DL_GETLOADADDR	x
75#define DL_SETTHREADLCK	2
76#define DL_SETBINDLCK	3
77#define DL_REFERENCE	4
78
79#define	DL_LAZY		RTLD_LAZY	/* Compat */
80
81#endif /* __BSD_VISIBLE */
82
83
84/*
85 * User interface to the run-time linker.
86 */
87__BEGIN_DECLS
88void	*dlopen(const char *, int);
89int	dlclose(void *);
90void	*dlsym(void *__restrict, const char *__restrict);
91char	*dlerror(void);
92
93#if __BSD_VISIBLE
94int	dladdr(const void *, Dl_info *);
95int	dlctl(void *, int, void *);
96#endif /* __BSD_VISIBLE */
97
98__END_DECLS
99
100#endif /* _DLFCN_H_ */
101