xref: /aosp_15_r20/external/mesa3d/src/util/u_dl.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1*61046927SAndroid Build Coastguard Worker /**************************************************************************
2*61046927SAndroid Build Coastguard Worker  *
3*61046927SAndroid Build Coastguard Worker  * Copyright 2009 VMware, Inc.
4*61046927SAndroid Build Coastguard Worker  * All Rights Reserved.
5*61046927SAndroid Build Coastguard Worker  *
6*61046927SAndroid Build Coastguard Worker  * Permission is hereby granted, free of charge, to any person obtaining a
7*61046927SAndroid Build Coastguard Worker  * copy of this software and associated documentation files (the
8*61046927SAndroid Build Coastguard Worker  * "Software"), to deal in the Software without restriction, including
9*61046927SAndroid Build Coastguard Worker  * without limitation the rights to use, copy, modify, merge, publish,
10*61046927SAndroid Build Coastguard Worker  * distribute, sub license, and/or sell copies of the Software, and to
11*61046927SAndroid Build Coastguard Worker  * permit persons to whom the Software is furnished to do so, subject to
12*61046927SAndroid Build Coastguard Worker  * the following conditions:
13*61046927SAndroid Build Coastguard Worker  *
14*61046927SAndroid Build Coastguard Worker  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15*61046927SAndroid Build Coastguard Worker  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16*61046927SAndroid Build Coastguard Worker  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
17*61046927SAndroid Build Coastguard Worker  * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
18*61046927SAndroid Build Coastguard Worker  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
19*61046927SAndroid Build Coastguard Worker  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
20*61046927SAndroid Build Coastguard Worker  * USE OR OTHER DEALINGS IN THE SOFTWARE.
21*61046927SAndroid Build Coastguard Worker  *
22*61046927SAndroid Build Coastguard Worker  * The above copyright notice and this permission notice (including the
23*61046927SAndroid Build Coastguard Worker  * next paragraph) shall be included in all copies or substantial portions
24*61046927SAndroid Build Coastguard Worker  * of the Software.
25*61046927SAndroid Build Coastguard Worker  *
26*61046927SAndroid Build Coastguard Worker  **************************************************************************/
27*61046927SAndroid Build Coastguard Worker 
28*61046927SAndroid Build Coastguard Worker 
29*61046927SAndroid Build Coastguard Worker #ifndef U_DL_H_
30*61046927SAndroid Build Coastguard Worker #define U_DL_H_
31*61046927SAndroid Build Coastguard Worker 
32*61046927SAndroid Build Coastguard Worker 
33*61046927SAndroid Build Coastguard Worker #include "detect_os.h"
34*61046927SAndroid Build Coastguard Worker 
35*61046927SAndroid Build Coastguard Worker #ifdef __cplusplus
36*61046927SAndroid Build Coastguard Worker extern "C" {
37*61046927SAndroid Build Coastguard Worker #endif
38*61046927SAndroid Build Coastguard Worker 
39*61046927SAndroid Build Coastguard Worker #if DETECT_OS_WINDOWS
40*61046927SAndroid Build Coastguard Worker #  define UTIL_DL_EXT ".dll"
41*61046927SAndroid Build Coastguard Worker #  define UTIL_DL_PREFIX ""
42*61046927SAndroid Build Coastguard Worker #elif DETECT_OS_APPLE
43*61046927SAndroid Build Coastguard Worker #  define UTIL_DL_EXT ".dylib"
44*61046927SAndroid Build Coastguard Worker #  define UTIL_DL_PREFIX "lib"
45*61046927SAndroid Build Coastguard Worker #else
46*61046927SAndroid Build Coastguard Worker #  define UTIL_DL_EXT ".so"
47*61046927SAndroid Build Coastguard Worker #  define UTIL_DL_PREFIX "lib"
48*61046927SAndroid Build Coastguard Worker #endif
49*61046927SAndroid Build Coastguard Worker 
50*61046927SAndroid Build Coastguard Worker 
51*61046927SAndroid Build Coastguard Worker struct util_dl_library;
52*61046927SAndroid Build Coastguard Worker 
53*61046927SAndroid Build Coastguard Worker 
54*61046927SAndroid Build Coastguard Worker typedef void (*util_dl_proc)(void);
55*61046927SAndroid Build Coastguard Worker 
56*61046927SAndroid Build Coastguard Worker 
57*61046927SAndroid Build Coastguard Worker /**
58*61046927SAndroid Build Coastguard Worker  * Open a library dynamically.
59*61046927SAndroid Build Coastguard Worker  */
60*61046927SAndroid Build Coastguard Worker struct util_dl_library *
61*61046927SAndroid Build Coastguard Worker util_dl_open(const char *filename);
62*61046927SAndroid Build Coastguard Worker 
63*61046927SAndroid Build Coastguard Worker 
64*61046927SAndroid Build Coastguard Worker /**
65*61046927SAndroid Build Coastguard Worker  * Lookup a function in a library.
66*61046927SAndroid Build Coastguard Worker  */
67*61046927SAndroid Build Coastguard Worker util_dl_proc
68*61046927SAndroid Build Coastguard Worker util_dl_get_proc_address(struct util_dl_library *library,
69*61046927SAndroid Build Coastguard Worker                          const char *procname);
70*61046927SAndroid Build Coastguard Worker 
71*61046927SAndroid Build Coastguard Worker 
72*61046927SAndroid Build Coastguard Worker /**
73*61046927SAndroid Build Coastguard Worker  * Close a library.
74*61046927SAndroid Build Coastguard Worker  */
75*61046927SAndroid Build Coastguard Worker void
76*61046927SAndroid Build Coastguard Worker util_dl_close(struct util_dl_library *library);
77*61046927SAndroid Build Coastguard Worker 
78*61046927SAndroid Build Coastguard Worker 
79*61046927SAndroid Build Coastguard Worker /**
80*61046927SAndroid Build Coastguard Worker  * Return most recent error message.
81*61046927SAndroid Build Coastguard Worker  */
82*61046927SAndroid Build Coastguard Worker const char *
83*61046927SAndroid Build Coastguard Worker util_dl_error(void);
84*61046927SAndroid Build Coastguard Worker 
85*61046927SAndroid Build Coastguard Worker #ifdef __cplusplus
86*61046927SAndroid Build Coastguard Worker }
87*61046927SAndroid Build Coastguard Worker #endif
88*61046927SAndroid Build Coastguard Worker 
89*61046927SAndroid Build Coastguard Worker #endif /* U_DL_H_ */
90