]>
Commit | Line | Data |
---|---|---|
696d846a MO |
1 | //===-- sanitizer_posix.h -------------------------------------------------===// |
2 | // | |
b667dd70 ML |
3 | // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. |
4 | // See https://llvm.org/LICENSE.txt for license information. | |
5 | // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception | |
696d846a MO |
6 | // |
7 | //===----------------------------------------------------------------------===// | |
8 | // | |
9 | // This file is shared between AddressSanitizer and ThreadSanitizer | |
10 | // run-time libraries and declares some useful POSIX-specific functions. | |
11 | //===----------------------------------------------------------------------===// | |
12 | #ifndef SANITIZER_POSIX_H | |
13 | #define SANITIZER_POSIX_H | |
14 | ||
15 | // ----------- ATTENTION ------------- | |
16 | // This header should NOT include any other headers from sanitizer runtime. | |
17 | #include "sanitizer_internal_defs.h" | |
b667dd70 | 18 | #include "sanitizer_platform_limits_freebsd.h" |
5d3805fc | 19 | #include "sanitizer_platform_limits_netbsd.h" |
eac97531 | 20 | #include "sanitizer_platform_limits_openbsd.h" |
10189819 | 21 | #include "sanitizer_platform_limits_posix.h" |
eac97531 | 22 | #include "sanitizer_platform_limits_solaris.h" |
696d846a MO |
23 | |
24 | #if !SANITIZER_POSIX | |
25 | // Make it hard to accidentally use any of functions declared in this file: | |
26 | #error This file should only be included on POSIX | |
27 | #endif | |
28 | ||
29 | namespace __sanitizer { | |
30 | ||
31 | // I/O | |
32 | // Don't use directly, use __sanitizer::OpenFile() instead. | |
33 | uptr internal_open(const char *filename, int flags); | |
34 | uptr internal_open(const char *filename, int flags, u32 mode); | |
35 | uptr internal_close(fd_t fd); | |
36 | ||
37 | uptr internal_read(fd_t fd, void *buf, uptr count); | |
38 | uptr internal_write(fd_t fd, const void *buf, uptr count); | |
39 | ||
40 | // Memory | |
41 | uptr internal_mmap(void *addr, uptr length, int prot, int flags, | |
3c6331c2 | 42 | int fd, u64 offset); |
696d846a MO |
43 | uptr internal_munmap(void *addr, uptr length); |
44 | int internal_mprotect(void *addr, uptr length, int prot); | |
45 | ||
46 | // OS | |
47 | uptr internal_filesize(fd_t fd); // -1 on error. | |
48 | uptr internal_stat(const char *path, void *buf); | |
49 | uptr internal_lstat(const char *path, void *buf); | |
50 | uptr internal_fstat(fd_t fd, void *buf); | |
b667dd70 | 51 | uptr internal_dup(int oldfd); |
696d846a MO |
52 | uptr internal_dup2(int oldfd, int newfd); |
53 | uptr internal_readlink(const char *path, char *buf, uptr bufsize); | |
54 | uptr internal_unlink(const char *path); | |
55 | uptr internal_rename(const char *oldpath, const char *newpath); | |
56 | uptr internal_lseek(fd_t fd, OFF_T offset, int whence); | |
57 | ||
b667dd70 ML |
58 | #if SANITIZER_NETBSD |
59 | uptr internal_ptrace(int request, int pid, void *addr, int data); | |
60 | #else | |
696d846a | 61 | uptr internal_ptrace(int request, int pid, void *addr, void *data); |
b667dd70 | 62 | #endif |
696d846a MO |
63 | uptr internal_waitpid(int pid, int *status, int options); |
64 | ||
65 | int internal_fork(); | |
3c6331c2 | 66 | fd_t internal_spawn(const char *argv[], const char *envp[], pid_t *pid); |
696d846a | 67 | |
eac97531 ML |
68 | int internal_sysctl(const int *name, unsigned int namelen, void *oldp, |
69 | uptr *oldlenp, const void *newp, uptr newlen); | |
70 | int internal_sysctlbyname(const char *sname, void *oldp, uptr *oldlenp, | |
71 | const void *newp, uptr newlen); | |
72 | ||
696d846a MO |
73 | // These functions call appropriate pthread_ functions directly, bypassing |
74 | // the interceptor. They are weak and may not be present in some tools. | |
75 | SANITIZER_WEAK_ATTRIBUTE | |
76 | int real_pthread_create(void *th, void *attr, void *(*callback)(void *), | |
77 | void *param); | |
78 | SANITIZER_WEAK_ATTRIBUTE | |
79 | int real_pthread_join(void *th, void **ret); | |
80 | ||
81 | #define DEFINE_REAL_PTHREAD_FUNCTIONS \ | |
82 | namespace __sanitizer { \ | |
83 | int real_pthread_create(void *th, void *attr, void *(*callback)(void *), \ | |
84 | void *param) { \ | |
85 | return REAL(pthread_create)(th, attr, callback, param); \ | |
86 | } \ | |
87 | int real_pthread_join(void *th, void **ret) { \ | |
88 | return REAL(pthread_join(th, ret)); \ | |
89 | } \ | |
90 | } // namespace __sanitizer | |
91 | ||
55aea9f5 MO |
92 | int my_pthread_attr_getstack(void *attr, void **addr, uptr *size); |
93 | ||
10189819 MO |
94 | // A routine named real_sigaction() must be implemented by each sanitizer in |
95 | // order for internal_sigaction() to bypass interceptors. | |
696d846a | 96 | int internal_sigaction(int signum, const void *act, void *oldact); |
10189819 MO |
97 | void internal_sigfillset(__sanitizer_sigset_t *set); |
98 | void internal_sigemptyset(__sanitizer_sigset_t *set); | |
99 | bool internal_sigismember(__sanitizer_sigset_t *set, int signum); | |
696d846a | 100 | |
10189819 MO |
101 | uptr internal_execve(const char *filename, char *const argv[], |
102 | char *const envp[]); | |
5d3805fc JJ |
103 | |
104 | bool IsStateDetached(int state); | |
105 | ||
b667dd70 ML |
106 | // Move the fd out of {0, 1, 2} range. |
107 | fd_t ReserveStandardFds(fd_t fd); | |
108 | ||
109 | bool ShouldMockFailureToOpen(const char *path); | |
110 | ||
111 | // Create a non-file mapping with a given /proc/self/maps name. | |
112 | uptr MmapNamed(void *addr, uptr length, int prot, int flags, const char *name); | |
113 | ||
114 | // Platforms should implement at most one of these. | |
115 | // 1. Provide a pre-decorated file descriptor to use instead of an anonymous | |
116 | // mapping. | |
117 | int GetNamedMappingFd(const char *name, uptr size, int *flags); | |
118 | // 2. Add name to an existing anonymous mapping. The caller must keep *name | |
119 | // alive at least as long as the mapping exists. | |
120 | void DecorateMapping(uptr addr, uptr size, const char *name); | |
121 | ||
122 | ||
696d846a MO |
123 | } // namespace __sanitizer |
124 | ||
125 | #endif // SANITIZER_POSIX_H |