summaryrefslogtreecommitdiff
path: root/dl/dl_gnu.go
blob: c7c409b054b9120dd8cc45433a2da3e1805c9b0f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
package dl

import "unsafe"

//#define _GNU_SOURCE
//#include <stdlib.h>
//#include <stdint.h>
//#include <dlfcn.h>
//const uintptr_t rtld_next = (uintptr_t)RTLD_NEXT;
//const uintptr_t rtld_default = (uintptr_t)RTLD_DEFAULT;
import "C"

const (
	RTLD_NOLOAD   Flag = C.RTLD_NOLOAD
	RTLD_NODELETE Flag = C.RTLD_NODELETE
	RTLD_DEEPBIND Flag = C.RTLD_DEEPBIND
)

// These are kinda weird in that they aren't required by the standard,
// but they are reserved by the standard (see the documentation for
// `dlsym(3)`).  On glibc, it takes _GNU_SOURCE to get them.
//
//        There are two special pseudo-handles that may be specified
//        in handle:
var (
	RTLD_DEFAULT Handle = Handle{unsafe.Pointer(uintptr(C.rtld_default))}
           // Find the first occurrence of the desired symbol using
           // the default shared object search order.  The search will
           // include global symbols in the executable and its
           // dependencies, as well as symbols in shared objects that
           // were dynamically loaded with the RTLD_GLOBAL flag.
	RTLD_NEXT    Handle = Handle{unsafe.Pointer(uintptr(C.rtld_next))}
           // Find the next occurrence of the desired symbol in the
           // search order after the current object.  This allows one
           // to provide a wrapper around a function in another shared
           // object, so that, for example, the definition of a
           // function in a preloaded shared object (see LD_PRELOAD in
           // ld.so(8)) can find and invoke the "real" function
           // provided in another shared object (or for that matter,
           // the "next" definition of the function in cases where
           // there are multiple layers of preloading).
)

// TODO: dlmopen
// TODO: dlvsym
// TODO: dladdr
//     - dladdr1
// TODO: dlinfo
//     - RTLD_DI_LMID
//     - RTLD_DI_LINKMAP
//     - RTLD_DI_ORIGIN
//     - RTLD_DI_SERINFO
//     - RTLD_DI_SERINFOSIZE
//     - RTLD_DI_MODID
//     - RTLD_DI_DATA
// TODO: dl_iterate_phdr
// TODO: rtld-audit(7)