SYSCALLS.TXT revision b4f7616fd618875768b8fffc122b58bdb84a9969
1# This file is used to automatically generate bionic's the system calls stubs.
2#
3# Each non comment line has the following format:
4#
5# return_type    func_name[:syscall_name[:call_id]]([parameter_list])  (1|-1|"stub")
6#
7# Note that:
8#      - syscall_name corresponds to the name of the syscall, which may differ from
9#        the exported function name (example: the exit syscall is implemented by the _exit()
10#        function, which is not the same as the standard C exit() function which calls it)
11#        The call_id parameter, given that func_name and syscall_name have
12#        been provided, allows the user to specify dispatch style syscalls.
13#        For example, socket() syscall on i386 actually becomes:
14#          socketcall(__NR_socket, 1, *(rest of args on stack)).
15#
16#      - each parameter type is assumed to be stored on 32 bits, there is no plan to support
17#        64-bit architectures at the moment
18#
19#      - the final field can be "1", meaning: generate a stub for each architecture,
20#        taking the constants from the kernel header files.
21#
22#      - the final field can be "stub" meaning: do not generate any stubs ---
23#        in this case, a hand-written custom stub must be provided.
24#        TODO: replace this with something like "custom" or "none", or remove
25#        it entirely.
26#
27#      - the final field can be a three-element list of 1s and -1 meaning:
28#        this system call is only available on some of the architectures (1),
29#        and no stub should be generated for those architectures marked with -1.
30#        the order is arm,x86,mips.
31#        TODO: replace this with something more readable like "-arm,-mips" (meaning x86 only).
32#
33# This file is processed by a python script named gensyscalls.py.
34#
35
36# process management
37void    _exit:exit_group (int)      1
38void    _exit_thread:exit (int)     1
39pid_t   __fork:fork (void)           1
40pid_t   _waitpid:waitpid (pid_t, int*, int, struct rusage*)   -1,1,1
41int     __waitid:waitid(int, pid_t, struct siginfo_t*, int,void*)          1
42pid_t   wait4(pid_t pid, int *status, int options, struct rusage *rusage)   1
43
44# NOTE: this system call is never called directly, but we list it there
45#       to have __NR_clone properly defined.
46#
47pid_t   __sys_clone:clone (int, void*, int*, void*, int*) 1
48
49int     execve (const char*, char* const*, char* const*)  1
50
51int     __setuid:setuid32 (uid_t)    1,1,-1
52int     __setuid:setuid (uid_t)   -1,-1,1
53uid_t   getuid:getuid32 ()         1,1,-1
54uid_t   getuid:getuid ()           -1,-1,1
55gid_t   getgid:getgid32 ()         1,1,-1
56gid_t   getgid:getgid ()           -1,-1,1
57uid_t   geteuid:geteuid32 ()       1,1,-1
58uid_t   geteuid:geteuid ()         -1,-1,1
59gid_t   getegid:getegid32 ()       1,1,-1
60gid_t   getegid:getegid ()         -1,-1,1
61uid_t   getresuid:getresuid32 (uid_t *ruid, uid_t *euid, uid_t *suid)   1,1,-1
62uid_t   getresuid:getresuid (uid_t *ruid, uid_t *euid, uid_t *suid)     -1,-1,1
63gid_t   getresgid:getresgid32 (gid_t *rgid, gid_t *egid, gid_t *sgid)   1,1,-1
64gid_t   getresgid:getresgid (gid_t *rgid, gid_t *egid, gid_t *sgid)     -1,-1,1
65pid_t   gettid()                   1
66ssize_t readahead(int, off64_t, size_t)     1
67int     getgroups:getgroups32(int, gid_t *)    1,1,-1
68int     getgroups:getgroups(int, gid_t *)      -1,-1,1
69pid_t   getpgid(pid_t)             1
70pid_t   getppid()                  1
71pid_t   getsid(pid_t)              1
72pid_t   setsid()                   1
73int     setgid:setgid32(gid_t)     1,1,-1
74int     setgid:setgid(gid_t)       -1,-1,1
75int     seteuid:seteuid32(uid_t)   stub
76int     __setreuid:setreuid32(uid_t, uid_t)   1,1,-1
77int     __setreuid:setreuid(uid_t, uid_t)     -1,-1,1
78int     __setresuid:setresuid32(uid_t, uid_t, uid_t)   1,1,-1
79int     __setresuid:setresuid(uid_t, uid_t, uid_t)     -1,-1,1
80int     setresgid:setresgid32(gid_t, gid_t, gid_t)   1,1,-1
81int     setresgid:setresgid(gid_t, gid_t, gid_t)     -1,-1,1
82void*   __brk:brk(void*)           1
83# see comments in arch-arm/bionic/kill.S to understand why we don't generate an ARM stub for kill/tkill
84int     kill(pid_t, int)           -1,1,1
85int     tkill(pid_t tid, int sig)  -1,1,1
86int     tgkill(pid_t tgid, pid_t tid, int sig)  -1,1,1
87int     __ptrace:ptrace(int request, int pid, void* addr, void* data)  1
88int     __set_thread_area:set_thread_area(void*  user_desc)  -1,1,1
89int     __getpriority:getpriority(int, int)  1
90int     setpriority(int, int, int)   1
91int     setrlimit(int resource, const struct rlimit *rlp)  1
92int     getrlimit:ugetrlimit(int resource, struct rlimit *rlp)  1,1,-1
93int     getrlimit:getrlimit(int resource, struct rlimit *rlp)  -1,-1,1
94int     getrusage(int who, struct rusage*  r_usage)  1
95int     setgroups:setgroups32(int, const gid_t *)   1,1,-1
96int     setgroups:setgroups(int, const gid_t *)     -1,-1,1
97pid_t   getpgrp(void)  stub
98int     setpgid(pid_t, pid_t)  1
99pid_t   vfork(void)  1,-1,-1
100int     setregid:setregid32(gid_t, gid_t)  1,1,-1
101int     setregid:setregid(gid_t, gid_t)    -1,-1,1
102int     chroot(const char *)  1
103# IMPORTANT: Even though <sys/prctl.h> declares prctl(int,...), the syscall stub must take 6 arguments
104#            to match the kernel implementation.
105int     prctl(int option, unsigned int arg2, unsigned int arg3, unsigned int arg4, unsigned int arg5) 1
106int     capget(cap_user_header_t header, cap_user_data_t data) 1
107int     capset(cap_user_header_t header, const cap_user_data_t data) 1
108int     sigaltstack(const stack_t*, stack_t*) 1
109int     acct(const char*  filepath)  1
110
111# file descriptors
112ssize_t     read (int, void*, size_t)        1
113ssize_t     write (int, const void*, size_t)       1
114ssize_t     pread64 (int, void *, size_t, off64_t) 1
115ssize_t     pwrite64 (int, void *, size_t, off64_t) 1
116int         __open:open (const char*, int, mode_t)  1
117int         __openat:openat (int, const char*, int, mode_t) 1
118int         close (int)                      1
119int         creat(const char*, mode_t)       stub
120off_t       lseek(int, off_t, int)           1
121int         __llseek:_llseek (int, unsigned long, unsigned long, off64_t*, int)  1
122pid_t       getpid ()    1
123void *      mmap(void *, size_t, int, int, int, long)  stub
124void *      __mmap2:mmap2(void*, size_t, int, int, int, long)   1
125int         munmap(void *, size_t)  1
126void *      mremap(void *, size_t, size_t, unsigned long)  1
127int         msync(const void *, size_t, int)    1
128int         mprotect(const void *, size_t, int)  1
129int         madvise(const void *, size_t, int)  1
130int         mlock(const void *addr, size_t len)    1
131int         munlock(const void *addr, size_t len)   1
132int         mlockall(int flags)   1
133int         munlockall()   1
134int         mincore(void*  start, size_t  length, unsigned char*  vec)   1
135int         __ioctl:ioctl(int, int, void *)  1
136int         readv(int, const struct iovec *, int)   1
137int         writev(int, const struct iovec *, int)  1
138int         __fcntl:fcntl(int, int, void*)  1
139int         flock(int, int)   1
140int         fchmod(int, mode_t)  1
141int         dup(int)  1
142int         pipe(int *)  1,1,-1
143int         pipe2(int *, int) 1
144int         dup2(int, int)   1
145int         select:_newselect(int, struct fd_set *, struct fd_set *, struct fd_set *, struct timeval *)  1
146int         ftruncate(int, off_t)  1
147int         ftruncate64(int, off64_t) 1
148int         getdents:getdents64(unsigned int, struct dirent *, unsigned int)   1
149int         fsync(int)  1
150int         fdatasync(int) 1
151int         fchown:fchown32(int, uid_t, gid_t)  1,1,-1
152int         fchown:fchown(int, uid_t, gid_t)    -1,-1,1
153void        sync(void)  1
154int         __fcntl64:fcntl64(int, int, void *)  1
155int         __fstatfs64:fstatfs64(int, size_t, struct statfs *)  1
156ssize_t     sendfile(int out_fd, int in_fd, off_t* offset, size_t count)  1
157ssize_t     sendfile64(int out_fd, int in_fd, off64_t* offset, size_t count)  1
158int         fstatat:fstatat64(int dirfd, const char *path, struct stat *buf, int flags)   1
159int         mkdirat(int dirfd, const char *pathname, mode_t mode)  1
160int         fchownat(int dirfd, const char *path, uid_t owner, gid_t group, int flags)  1
161int         fchmodat(int dirfd, const char *path, mode_t mode, int flags)  1
162int         renameat(int olddirfd, const char *oldpath, int newdirfd, const char *newpath)  1
163int         fsetxattr(int, const char *, const void *, size_t, int) 1
164ssize_t     fgetxattr(int, const char *, void *, size_t) 1
165ssize_t     flistxattr(int, char *, size_t) 1
166int         fremovexattr(int, const char *) 1
167
168# file system
169int     link (const char*, const char*)  1
170int     unlink (const char*)             1
171int     unlinkat (int, const char *, int)   1
172int     chdir (const char*)              1
173int     mknod (const char*, mode_t, dev_t)  1
174int     chmod (const char*,mode_t)          1
175int     chown:chown32(const char *, uid_t, gid_t)  1,1,-1
176int     chown:chown(const char *, uid_t, gid_t)    -1,-1,1
177int     lchown:lchown32 (const char*, uid_t, gid_t)  1,1,-1
178int     lchown:lchown (const char*, uid_t, gid_t)  -1,-1,1
179int     mount (const char*, const char*, const char*, unsigned long, const void*)  1
180int     umount(const char*)  stub
181int     umount2 (const char*, int)  1
182int     fstat:fstat64(int, struct stat*)    1
183int     stat:stat64(const char *, struct stat *)  1
184int     lstat:lstat64(const char *, struct stat *)  1
185int     mkdir(const char *, mode_t) 1
186int     readlink(const char *, char *, size_t)  1
187int     rmdir(const char *)  1
188int     rename(const char *, const char *)  1
189int     __getcwd:getcwd(char * buf, size_t size)  1
190int     access(const char *, int)  1
191int     faccessat(int, const char *, int, int)  1
192int     symlink(const char *, const char *)  1
193int     fchdir(int)    1
194int     truncate(const char*, off_t)    1
195int     truncate64(const char*, off64_t)    1
196int     setxattr(const char *, const char *, const void *, size_t, int) 1
197int     lsetxattr(const char *, const char *, const void *, size_t, int) 1
198ssize_t getxattr(const char *, const char *, void *, size_t) 1
199ssize_t lgetxattr(const char *, const char *, void *, size_t) 1
200ssize_t listxattr(const char *, char *, size_t) 1
201ssize_t llistxattr(const char *, char *, size_t) 1
202int     removexattr(const char *, const char *) 1
203int     lremovexattr(const char *, const char *) 1
204int     __statfs64:statfs64(const char *, size_t, struct statfs *)  1
205long    unshare(unsigned long)  1
206int     swapon(const char *, int) 1
207int     swapoff(const char *) 1
208
209# time
210int           pause ()                       1
211int           gettimeofday(struct timeval*, struct timezone*)       1
212int           settimeofday(const struct timeval*, const struct timezone*)   1
213clock_t       times(struct tms *)       1
214int           nanosleep(const struct timespec *, struct timespec *)   1
215int           clock_gettime(clockid_t clk_id, struct timespec *tp)    1
216int           clock_settime(clockid_t clk_id, const struct timespec *tp)  1
217int           clock_getres(clockid_t clk_id, struct timespec *res)   1
218int           clock_nanosleep(clockid_t clock_id, int flags, const struct timespec *req, struct timespec *rem)  1
219int           getitimer(int, const struct itimerval *)   1
220int           setitimer(int, const struct itimerval *, struct itimerval *)  1
221int           __timer_create:timer_create(clockid_t clockid, struct sigevent *evp, timer_t *timerid)    1
222int           __timer_settime:timer_settime(timer_t, int, const struct itimerspec*, struct itimerspec*) 1
223int           __timer_gettime:timer_gettime(timer_t, struct itimerspec*)                                1
224int           __timer_getoverrun:timer_getoverrun(timer_t)                                              1
225int           __timer_delete:timer_delete(timer_t)                                                      1
226int           utimes(const char*, const struct timeval tvp[2])                          1
227int           utimensat(int, const char *, const struct timespec times[2], int)         1
228int           timerfd_create(clockid_t, int)   1
229int           timerfd_settime(int, int, const struct itimerspec *, struct itimerspec *)   1
230int           timerfd_gettime(int, struct itimerspec *)   1
231
232# signals
233int     sigaction(int, const struct sigaction *, struct sigaction *)  1
234int     sigprocmask(int, const sigset_t *, sigset_t *)  1
235int     __sigsuspend:sigsuspend(int unused1, int unused2, unsigned mask)  1,1,-1
236int     __sigsuspend:sigsuspend(const sigset_t *mask)  -1,-1,1
237int     __rt_sigaction:rt_sigaction (int sig, const struct sigaction *act, struct sigaction *oact, size_t sigsetsize)  1
238int     __rt_sigprocmask:rt_sigprocmask (int  how, const sigset_t *set, sigset_t *oset, size_t sigsetsize)  1
239int     __rt_sigtimedwait:rt_sigtimedwait(const sigset_t *set, struct siginfo_t  *info, struct timespec_t  *timeout, size_t  sigset_size)  1
240int     sigpending(sigset_t *)  1
241int     signalfd4(int fd, const sigset_t *mask, size_t sizemask, int flags)  1
242
243# sockets
244int           socket(int, int, int)              1,-1,1
245int           socketpair(int, int, int, int*)    1,-1,1
246int           bind(int, struct sockaddr *, int)  1,-1,1
247int           connect(int, struct sockaddr *, socklen_t)   1,-1,1
248int           listen(int, int)                   1,-1,1
249int           accept(int, struct sockaddr *, socklen_t *)  1,-1,1
250int           getsockname(int, struct sockaddr *, socklen_t *)  1,-1,1
251int           getpeername(int, struct sockaddr *, socklen_t *)  1,-1,1
252int           sendto(int, const void *, size_t, int, const struct sockaddr *, socklen_t)  1,-1,1
253int           recvfrom(int, void *, size_t, unsigned int, struct sockaddr *, socklen_t *)  1,-1,1
254int           shutdown(int, int)  1,-1,1
255int           setsockopt(int, int, int, const void *, socklen_t)  1,-1,1
256int           getsockopt(int, int, int, void *, socklen_t *)    1,-1,1
257int           sendmsg(int, const struct msghdr *, unsigned int)  1,-1,1
258int           recvmsg(int, struct msghdr *, unsigned int)   1,-1,1
259
260# sockets for x86. These are done as an "indexed" call to socketcall syscall.
261int           socket:socketcall:1 (int, int, int) -1,1,-1
262int           bind:socketcall:2 (int, struct sockaddr *, int)  -1,1,-1
263int           connect:socketcall:3(int, struct sockaddr *, socklen_t)   -1,1,-1
264int           listen:socketcall:4(int, int)                   -1,1,-1
265int           accept:socketcall:5(int, struct sockaddr *, socklen_t *)  -1,1,-1
266int           getsockname:socketcall:6(int, struct sockaddr *, socklen_t *)  -1,1,-1
267int           getpeername:socketcall:7(int, struct sockaddr *, socklen_t *)  -1,1,-1
268int           socketpair:socketcall:8(int, int, int, int*)    -1,1,-1
269int           sendto:socketcall:11(int, const void *, size_t, int, const struct sockaddr *, socklen_t)  -1,1,-1
270int           recvfrom:socketcall:12(int, void *, size_t, unsigned int, struct sockaddr *, socklen_t *)  -1,1,-1
271int           shutdown:socketcall:13(int, int)  -1,1,-1
272int           setsockopt:socketcall:14(int, int, int, const void *, socklen_t)  -1,1,-1
273int           getsockopt:socketcall:15(int, int, int, void *, socklen_t *)    -1,1,-1
274int           sendmsg:socketcall:16(int, const struct msghdr *, unsigned int)  -1,1,-1
275int           recvmsg:socketcall:17(int, struct msghdr *, unsigned int)   -1,1,-1
276
277# scheduler & real-time
278int sched_setscheduler(pid_t pid, int policy, const struct sched_param *param)  1
279int sched_getscheduler(pid_t pid)  1
280int sched_yield(void)  1
281int sched_setparam(pid_t pid, const struct sched_param *param)  1
282int sched_getparam(pid_t pid, struct sched_param *param)  1
283int sched_get_priority_max(int policy)  1
284int sched_get_priority_min(int policy)  1
285int sched_rr_get_interval(pid_t pid, struct timespec *interval)  1
286int sched_setaffinity(pid_t pid, size_t setsize, const cpu_set_t* set) 1
287int __sched_getaffinity:sched_getaffinity(pid_t pid, size_t setsize, cpu_set_t* set)  1
288int __getcpu:getcpu(unsigned *cpu, unsigned *node, void *unused) 1
289
290# io priorities
291int ioprio_set(int which, int who, int ioprio) 1
292int ioprio_get(int which, int who) 1
293
294# other
295int     uname(struct utsname *)  1
296mode_t  umask(mode_t)  1
297int      __reboot:reboot(int, int, int, void *)  1
298int     __syslog:syslog(int, char *, int)  1
299int     init_module(void *, unsigned long, const char *)  1
300int     delete_module(const char*, unsigned int)   1
301int     klogctl:syslog(int, char *, int)   1
302int     sysinfo(struct sysinfo *)  1
303int     personality(unsigned long)  1
304long    perf_event_open(struct perf_event_attr *attr_uptr, pid_t pid, int cpu, int group_fd, unsigned long flags) 1
305
306# futex
307int	futex(void *, int, int, void *, void *, int) 1
308
309# epoll
310int     epoll_create(int size)     1
311int     epoll_ctl(int epfd, int op, int fd, struct epoll_event *event)    1
312int     epoll_wait(int epfd, struct epoll_event *events, int max, int timeout)   1
313
314int     inotify_init(void)      1
315int     inotify_add_watch(int, const char *, unsigned int)  1
316int     inotify_rm_watch(int, unsigned int)  1
317
318int     poll(struct pollfd *, unsigned int, long)  1
319
320int     eventfd:eventfd2(unsigned int, int)  1
321
322# ARM-specific ARM_NR_BASE == 0x0f0000 == 983040
323int     __set_tls:__ARM_NR_set_tls(void*)                                 1,-1,-1
324int     cacheflush:__ARM_NR_cacheflush(long start, long end, long flags)  1,-1,-1
325
326# MIPS-specific
327int     _flush_cache:cacheflush(char *addr, const int nbytes, const int op) -1,-1,1
328int     syscall(int number,...) -1,-1,1
329