Home | History | Annotate | Line # | Download | only in include
dlfcn.h revision 1.26 
      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_
     40 typedef	_BSD_SSIZE_T_	ssize_t;
     41 #undef	_BSD_SSIZE_T_
     42 #endif
     43 
     44 #if defined(_NETBSD_SOURCE)
     45 typedef 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
     57 void *_dlauxinfo(void) __pure;
     58 
     59 void	*dlopen(const char *, int);
     60 int	dlclose(void *);
     61 void	*dlsym(void * __restrict, const char * __restrict);
     62 #if (_POSIX_C_SOURCE - 0 >= 202405L) || defined(_NETBSD_SOURCE)
     63 int	dladdr(const void * __restrict, Dl_info * __restrict);
     64 #endif
     65 #if defined(_NETBSD_SOURCE)
     66 int	dlctl(void *, int, void *);
     67 int	dlinfo(void *, int, void *);
     68 void	*dlvsym(void * __restrict, const char * __restrict,
     69 	    const char * __restrict);
     70 void	__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_) */
    127