src/dynlib.h

   1 /* Portable API for dynamic loading.
   2
   3 Copyright 2015-2017 Free Software Foundation, Inc.
   4
   5 This file is part of GNU Emacs.
   6
   7 GNU Emacs is free software: you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation, either version 3 of the License, or (at
  10 your option) any later version.
  11
  12 GNU Emacs is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.  */
  19
  20 #ifndef DYNLIB_H
  21 #define DYNLIB_H
  22
  23 #include <stdbool.h>
  24
  25 typedef void *dynlib_handle_ptr;
  26 dynlib_handle_ptr dynlib_open (const char *path);
  27 int dynlib_close (dynlib_handle_ptr h);
  28 const char *dynlib_error (void);
  29
  30 ATTRIBUTE_MAY_ALIAS void *dynlib_sym (dynlib_handle_ptr h, const char *sym);
  31
  32 typedef struct dynlib_function_ptr_nonce *(ATTRIBUTE_MAY_ALIAS *dynlib_function_ptr) (void);
  33 dynlib_function_ptr dynlib_func (dynlib_handle_ptr h, const char *sym);
  34
  35 /* Sets *FILE to the file name from which PTR was loaded, and *SYM to
  36    its symbol name.  If the file or symbol name could not be
  37    determined, set the corresponding argument to NULL.  */
  38 void dynlib_addr (void *ptr, const char **file, const char **sym);
  39
  40 #endif /* DYNLIB_H */