1WAFFLE_DL(3)                     Waffle Manual                    WAFFLE_DL(3)
2
3
4

NAME

6       waffle_dl, waffle_dl_can_open, waffle_dl_sym - platform-independent
7       interface to dynamic libraries
8

SYNOPSIS

10       #include <waffle.h>
11
12       bool waffle_dl_can_open(int32_t dl);
13
14       void* waffle_dl_sym(int32_t dl, const char* symbol);
15

DESCRIPTION

17       The waffle_dl functions provide a platform-independent interface for
18       dynamic OpenGL libraries. For each function, the parameter dl must be
19       one of:
20           WAFFLE_DL_OPENGL
21           WAFFLE_DL_OPENGL_ES1
22           WAFFLE_DL_OPENGL_ES2
23           WAFFLE_DL_OPENGL_ES3
24
25       For example, on Linux, the WAFFLE_DL_* enums map to libGL.so.1,
26       libGLESv1_CM.so.1, libGLESv2.so.2, and libGLESv2.so.2, respectively.
27
28       waffle_dl_can_open()
29           Test if a dynamic library can be opened.
30
31       waffle_dl_sym()
32           Get a symbol from a dynamic library.
33

RETURN VALUE

35       Functions whose return type is bool return true on success and false on
36       failure. Functions whose return type is a pointer return NULL on
37       failure. Use waffle_error_get_info(3) to get information about any
38       errors.
39

ERRORS

41       If waffle fails to find the requested library on the system, then
42       WAFFLE_ERROR_UNSUPPORTED_ON_PLATFORM is emitted.
43
44       See waffle_error(3) for the complete list of waffle's error codes.
45

ISSUES

47       Please report bugs or and feature requests to
48       https://gitlab.freedesktop.org/mesa/waffle/issues.
49

SEE ALSO

51       waffle(7), waffle_get_proc_address(3)
52

AUTHOR

54       Chad Versace <chad.versace@linux.intel.com>
55           Maintainer
56
58       Copyright © 2013 Intel
59
60       This manual page is licensed under the Creative Commons
61       Attribution-ShareAlike 3.0 United States License (CC BY-SA 3.0). To
62       view a copy of this license, visit
63       http://creativecommons.org.license/by-sa/3.0/us.
64
65
66
67
68waffle                            04/01/2020                      WAFFLE_DL(3)
Impressum