1/* $NetBSD: dlfcn.h,v 1.26 2024/11/02 20:53:58 nia Exp $ */
2
3/*-
4 * Copyright (c) 1998 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Paul Kranenburg.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 * POSSIBILITY OF SUCH DAMAGE.
30 */
31
32#ifndef _DLFCN_H_
33#define _DLFCN_H_
34
35#include <sys/featuretest.h>
36#include <sys/cdefs.h>
37#include <machine/ansi.h>
38
39#ifdef _BSD_SSIZE_T_
40typedef _BSD_SSIZE_T_ ssize_t;
41#undef _BSD_SSIZE_T_
42#endif
43
44#if defined(_NETBSD_SOURCE)
45typedef struct _dl_info {
46 const char *dli_fname; /* File defining the symbol */
47 void *dli_fbase; /* Base address */
48 const char *dli_sname; /* Symbol name */
49 const void *dli_saddr; /* Symbol address */
50} Dl_info;
51#endif /* defined(_NETBSD_SOURCE) */
52
53/*
54 * User interface to the run-time linker.
55 */
56__BEGIN_DECLS
57void *_dlauxinfo(void) __pure;
58
59void *dlopen(const char *, int);
60int dlclose(void *);
61void *dlsym(void * __restrict, const char * __restrict);
62#if (_POSIX_C_SOURCE - 0 >= 202405L) || defined(_NETBSD_SOURCE)
63int dladdr(const void * __restrict, Dl_info * __restrict);
64#endif
65#if defined(_NETBSD_SOURCE)
66int dlctl(void *, int, void *);
67int dlinfo(void *, int, void *);
68void *dlvsym(void * __restrict, const char * __restrict,
69 const char * __restrict);
70void __dl_cxa_refcount(void *, ssize_t);
71#endif
72__aconst char *dlerror(void);
73__END_DECLS
74
75/* Values for dlopen `mode'. */
76#define RTLD_LAZY 1
77#define RTLD_NOW 2
78#define RTLD_GLOBAL 0x100 /* Allow global searches in object */
79#define RTLD_LOCAL 0x200
80#define RTLD_NODELETE 0x01000 /* Do not remove members. */
81#define RTLD_NOLOAD 0x02000 /* Do not load if not already loaded. */
82#if defined(_NETBSD_SOURCE)
83#define DL_LAZY RTLD_LAZY /* Compat */
84#endif
85
86/*
87 * Special handle arguments for dlsym().
88 */
89#define RTLD_NEXT ((void *) -1) /* Search subsequent objects. */
90#define RTLD_DEFAULT ((void *) -2) /* Use default search algorithm. */
91#define RTLD_SELF ((void *) -3) /* Search the caller itself. */
92
93/*
94 * dlctl() commands
95 */
96#if defined(_NETBSD_SOURCE)
97#define DL_GETERRNO 1
98#define DL_GETSYMBOL 2
99#if 0
100#define DL_SETSRCHPATH x
101#define DL_GETLIST x
102#define DL_GETREFCNT x
103#define DL_GETLOADADDR x
104#endif /* 0 */
105#endif /* defined(_NETBSD_SOURCE) */
106
107/*
108 * dlinfo() commands
109 *
110 * From Solaris: http://docs.sun.com/app/docs/doc/816-5168/dlinfo-3c?a=view
111 */
112#if defined(_NETBSD_SOURCE)
113#define RTLD_DI_LINKMAP 3
114#if 0
115#define RTLD_DI_ARGSINFO 1
116#define RTLD_DI_CONFIGADDR 2
117#define RTLD_DI_LMID 4
118#define RTLD_DI_SERINFO 5
119#define RTLD_DI_SERINFOSIZE 6
120#define RTLD_DI_ORIGIN 7
121#define RTLD_DI_GETSIGNAL 8
122#define RTLD_DI_SETSIGNAL 9
123#endif
124#endif /* _NETBSD_SOURCE */
125
126#endif /* !defined(_DLFCN_H_) */