libc/SYSCALLS.TXT

# This file is used to automatically generate bionic's system call stubs.
#
# Each non-blank, non-comment line has the following format:
#
# return_type func_name[|alias_list][:syscall_name[:socketcall_id]]([parameter_list]) arch_list
#
# where:
#       arch_list ::= "all" | "custom" | arch+
#       arch      ::= "arm" | "mips" | "x86" | "x86_64"
#
# Note:
#      - syscall_name corresponds to the name of the syscall, which may differ from
#        the exported function name (example: the exit syscall is implemented by the _exit()
#        function, which is not the same as the standard C exit() function which calls it)
#
#      - alias_list is optional comma separated list of function aliases.
#
#      - The call_id parameter, given that func_name and syscall_name have
#        been provided, allows the user to specify dispatch style syscalls.
#        For example, socket() syscall on i386 actually becomes:
#          socketcall(__NR_socket, 1, *(rest of args on stack)).
#
#      - Each parameter type is assumed to be stored in 32 bits.
#
#      - The arch list can be the word "custom" meaning "do not generate any stubs".
#        In this case, a hand-written custom stub must be provided.
#
# This file is processed by a python script named gensyscalls.py.

# process management
void    _exit:exit_group(int)      all
void    _exit_thread:exit(int)     all
pid_t   __fork:fork(void)           all
pid_t   _waitpid:waitpid(pid_t, int*, int, struct rusage*)   mips,x86
int     __waitid:waitid(int, pid_t, struct siginfo_t*, int, void*)          all
pid_t   wait4(pid_t pid, int* status, int options, struct rusage* rusage)   all

# NOTE: this system call is never called directly, but we list it there
#       to have __NR_clone properly defined.
pid_t   __sys_clone:clone(int, void*, int*, void*, int*) all

int     execve(const char*, char* const*, char* const*)  all

uid_t   getuid:getuid32()         arm,x86
uid_t   getuid:getuid()           mips,x86_64
gid_t   getgid:getgid32()         arm,x86
gid_t   getgid:getgid()           mips,x86_64
uid_t   geteuid:geteuid32()       arm,x86
uid_t   geteuid:geteuid()         mips,x86_64
gid_t   getegid:getegid32()       arm,x86
gid_t   getegid:getegid()         mips,x86_64
uid_t   getresuid:getresuid32(uid_t* ruid, uid_t* euid, uid_t* suid)   arm,x86
uid_t   getresuid:getresuid(uid_t* ruid, uid_t* euid, uid_t* suid)     mips,x86_64
gid_t   getresgid:getresgid32(gid_t* rgid, gid_t* egid, gid_t* sgid)   arm,x86
gid_t   getresgid:getresgid(gid_t* rgid, gid_t* egid, gid_t* sgid)     mips,x86_64
pid_t   gettid()                   all
ssize_t readahead(int, off64_t, size_t)     all
int     getgroups:getgroups32(int, gid_t*)    arm,x86
int     getgroups:getgroups(int, gid_t*)      mips,x86_64
pid_t   getpgid(pid_t)             all
pid_t   getppid()                  all
pid_t   getsid(pid_t)              all
pid_t   setsid()                   all
int     setgid:setgid32(gid_t)     arm,x86
int     setgid:setgid(gid_t)       mips,x86_64
int     setuid:setuid32(uid_t)    arm,x86
int     setuid:setuid(uid_t)      mips,x86_64
int     seteuid:seteuid32(uid_t)   custom
int     setreuid:setreuid32(uid_t, uid_t)   arm,x86
int     setreuid:setreuid(uid_t, uid_t)     mips,x86_64
int     setresuid:setresuid32(uid_t, uid_t, uid_t)   arm,x86
int     setresuid:setresuid(uid_t, uid_t, uid_t)     mips,x86_64
int     setresgid:setresgid32(gid_t, gid_t, gid_t)   arm,x86
int     setresgid:setresgid(gid_t, gid_t, gid_t)     mips,x86_64
void*   __brk:brk(void*)           all
# See comments in kill.S to understand why we don't generate ARM stubs for kill/tkill/tgkill.
int     kill(pid_t, int)           mips,x86,x86_64
int     tkill(pid_t tid, int sig)  mips,x86,x86_64
int     tgkill(pid_t tgid, pid_t tid, int sig)  mips,x86,x86_64
int     __ptrace:ptrace(int request, int pid, void* addr, void* data)  all
int     __set_thread_area:set_thread_area(void*  user_desc)  mips,x86
int     __getpriority:getpriority(int, int)  all
int     setpriority(int, int, int)   all
int     setrlimit(int resource, const struct rlimit* rlp)  all
int     getrlimit:ugetrlimit(int resource, struct rlimit* rlp)  arm,x86
int     getrlimit:getrlimit(int resource, struct rlimit* rlp)  mips,x86_64
int     getrusage(int who, struct rusage*  r_usage)  all
int     setgroups:setgroups32(int, const gid_t*)   arm,x86
int     setgroups:setgroups(int, const gid_t*)     mips,x86_64
pid_t   getpgrp(void)  custom
int     setpgid(pid_t, pid_t)  all
pid_t   vfork(void)  arm,x86_64
int     setregid:setregid32(gid_t, gid_t)  arm,x86
int     setregid:setregid(gid_t, gid_t)    mips,x86_64
int     chroot(const char*)  all
# IMPORTANT: Even though <sys/prctl.h> declares prctl(int, ...), the syscall stub must take 6 arguments
#            to match the kernel implementation.
int     prctl(int option, unsigned int arg2, unsigned int arg3, unsigned int arg4, unsigned int arg5) all
long    __arch_prctl:arch_prctl(int, unsigned long) x86_64
int     capget(cap_user_header_t header, cap_user_data_t data) all
int     capset(cap_user_header_t header, const cap_user_data_t data) all
int     sigaltstack(const stack_t*, stack_t*) all
int     acct(const char*  filepath)  all

# file descriptors
ssize_t     read(int, void*, size_t)        all
ssize_t     write(int, const void*, size_t)       all
ssize_t     pread64(int, void*, size_t, off64_t) all
ssize_t     pwrite64(int, void*, size_t, off64_t) all
int         __open:open(const char*, int, mode_t)  all
int         __openat:openat(int, const char*, int, mode_t) all
int         close(int)                      all
int         creat(const char*, mode_t)       custom
off_t       lseek(int, off_t, int)           arm,x86,mips
off_t       lseek|lseek64(int, off_t, int)   x86_64
int         __llseek:_llseek(int, unsigned long, unsigned long, off64_t*, int)  arm,x86,mips
pid_t       getpid()    all
void*       mmap(void*, size_t, int, int, int, long)  x86_64
void*       __mmap2:mmap2(void*, size_t, int, int, int, long)   arm,x86,mips
int         munmap(void*, size_t)  all
void*       mremap(void*, size_t, size_t, unsigned long)  all
int         msync(const void*, size_t, int)    all
int         mprotect(const void*, size_t, int)  all
int         madvise(const void*, size_t, int)  all
int         mlock(const void* addr, size_t len)    all
int         munlock(const void* addr, size_t len)   all
int         mlockall(int flags)   all
int         munlockall()   all
int         mincore(void*  start, size_t  length, unsigned char*  vec)   all
int         __ioctl:ioctl(int, int, void*)  all
int         readv(int, const struct iovec*, int)   all
int         writev(int, const struct iovec*, int)  all
int         __fcntl:fcntl(int, int, void*)  arm,x86,mips
int         fcntl(int, void*)  x86_64
int         flock(int, int)   all
int         fchmod(int, mode_t)  all
int         dup(int)  all
int         pipe(int*)  arm,x86,x86_64
int         pipe2(int*, int) all
int         dup2(int, int)   all
int         select:_newselect(int, struct fd_set*, struct fd_set*, struct fd_set*, struct timeval*)  arm,x86,mips
int         select(int, struct fd_set*, struct fd_set*, struct fd_set*, struct timeval*)  x86_64
int         ftruncate(int, off_t)  all
int         ftruncate64(int, off64_t) arm,x86,mips
int         getdents:getdents64(unsigned int, struct dirent*, unsigned int)   all
int         fsync(int)  all
int         fdatasync(int) all
int         fchown:fchown32(int, uid_t, gid_t)  arm,x86
int         fchown:fchown(int, uid_t, gid_t)    mips,x86_64
void        sync(void)  all
int         __fcntl64:fcntl64(int, int, void*)  arm,x86,mips
int         __fstatfs64:fstatfs64(int, size_t, struct statfs*)  arm,x86,mips
int         fstatfs(int, struct statfs*)  x86_64
ssize_t     sendfile(int out_fd, int in_fd, off_t* offset, size_t count)  all
ssize_t     sendfile64(int out_fd, int in_fd, off64_t* offset, size_t count)  arm,x86,mips
int         fstatat:fstatat64(int dirfd, const char* path, struct stat* buf, int flags)   arm,x86,mips
int         mkdirat(int dirfd, const char* pathname, mode_t mode)  all
int         fchownat(int dirfd, const char* path, uid_t owner, gid_t group, int flags)  all
int         fchmodat(int dirfd, const char* path, mode_t mode, int flags)  all
int         renameat(int olddirfd, const char* oldpath, int newdirfd, const char* newpath)  all
int         fsetxattr(int, const char*, const void*, size_t, int) all
ssize_t     fgetxattr(int, const char*, void*, size_t) all
ssize_t     flistxattr(int, char*, size_t) all
int         fremovexattr(int, const char*) all

# file system
int     link(const char*, const char*)  all
int     unlink(const char*)             all
int     unlinkat(int, const char*, int)   all
int     chdir(const char*)              all
int     mknod(const char*, mode_t, dev_t)  all
int     chmod(const char*, mode_t)          all
int     chown:chown32(const char*, uid_t, gid_t)  arm,x86
int     chown:chown(const char*, uid_t, gid_t)    mips,x86_64
int     lchown:lchown32(const char*, uid_t, gid_t)  arm,x86
int     lchown:lchown(const char*, uid_t, gid_t)  mips,x86_64
int     mount(const char*, const char*, const char*, unsigned long, const void*)  all
int     umount(const char*)  custom
int     umount2(const char*, int)  all
int     fstat:fstat64(int, struct stat*)    arm,x86,mips
int     fstat(int, struct stat*)    x86_64
int     stat:stat64(const char*, struct stat*)  arm,x86,mips
int     stat(const char*, struct stat*)  x86_64
int     lstat:lstat64(const char*, struct stat*)  arm,x86,mips
int     lstat(const char*, struct stat*)  x86_64
int     mkdir(const char*, mode_t) all
int     readlink(const char*, char*, size_t)  all
int     rmdir(const char*)  all
int     rename(const char*, const char*)  all
int     __getcwd:getcwd(char* buf, size_t size)  all
int     access(const char*, int)  all
int     faccessat(int, const char*, int, int)  all
int     symlink(const char*, const char*)  all
int     fchdir(int)    all
int     truncate(const char*, off_t)    all
int     truncate64(const char*, off64_t)    arm,x86,mips
int     setxattr(const char*, const char*, const void*, size_t, int) all
int     lsetxattr(const char*, const char*, const void*, size_t, int) all
ssize_t getxattr(const char*, const char*, void*, size_t) all
ssize_t lgetxattr(const char*, const char*, void*, size_t) all
ssize_t listxattr(const char*, char*, size_t) all
ssize_t llistxattr(const char*, char*, size_t) all
int     removexattr(const char*, const char*) all
int     lremovexattr(const char*, const char*) all
int     __statfs64:statfs64(const char*, size_t, struct statfs*)  arm,x86,mips
int     statfs(const char*, struct statfs*)  x86_64
long    unshare(unsigned long)  all
int     swapon(const char*, int) all
int     swapoff(const char*) all

# time
int           pause()                       all
int           gettimeofday(struct timeval*, struct timezone*)       all
int           settimeofday(const struct timeval*, const struct timezone*)   all
clock_t       times(struct tms*)       all
int           nanosleep(const struct timespec*, struct timespec*)   all
int           clock_gettime(clockid_t clk_id, struct timespec* tp)    all
int           clock_settime(clockid_t clk_id, const struct timespec* tp)  all
int           clock_getres(clockid_t clk_id, struct timespec* res)   all
int           clock_nanosleep(clockid_t clock_id, int flags, const struct timespec* req, struct timespec* rem)  all
int           getitimer(int, const struct itimerval*)   all
int           setitimer(int, const struct itimerval*, struct itimerval*)  all
int           __timer_create:timer_create(clockid_t clockid, struct sigevent* evp, timer_t* timerid)    all
int           __timer_settime:timer_settime(timer_t, int, const struct itimerspec*, struct itimerspec*) all
int           __timer_gettime:timer_gettime(timer_t, struct itimerspec*)                                all
int           __timer_getoverrun:timer_getoverrun(timer_t)                                              all
int           __timer_delete:timer_delete(timer_t)                                                      all
int           utimes(const char*, const struct timeval tvp[2])                          all
int           utimensat(int, const char*, const struct timespec times[2], int)         all
int           timerfd_create(clockid_t, int)   all
int           timerfd_settime(int, int, const struct itimerspec*, struct itimerspec*)   all
int           timerfd_gettime(int, struct itimerspec*)   all

# signals
int     sigaction(int, const struct sigaction*, struct sigaction*)  arm,x86,mips
int     sigpending(sigset_t*)  arm,x86,mips
int     __rt_sigaction:rt_sigaction(int, const struct sigaction*, struct sigaction*, size_t)  all
int     __rt_sigprocmask:rt_sigprocmask(int, const sigset_t*, sigset_t*, size_t)  all
int     __rt_sigsuspend:rt_sigsuspend(const sigset_t*, size_t)  all
int     __rt_sigtimedwait:rt_sigtimedwait(const sigset_t*, struct siginfo_t*, struct timespec_t*, size_t)  all
int     signalfd4(int, const sigset_t*, size_t, int)  all

# sockets
int           socket(int, int, int)              arm,mips,x86_64
int           socketpair(int, int, int, int*)    arm,mips,x86_64
int           bind(int, struct sockaddr*, int)  arm,mips,x86_64
int           connect(int, struct sockaddr*, socklen_t)   arm,mips,x86_64
int           listen(int, int)                   arm,mips,x86_64
int           accept(int, struct sockaddr*, socklen_t*)  arm,mips,x86_64
int           getsockname(int, struct sockaddr*, socklen_t*)  arm,mips,x86_64
int           getpeername(int, struct sockaddr*, socklen_t*)  arm,mips,x86_64
int           sendto(int, const void*, size_t, int, const struct sockaddr*, socklen_t)  arm,mips,x86_64
int           recvfrom(int, void*, size_t, unsigned int, struct sockaddr*, socklen_t*)  arm,mips,x86_64
int           shutdown(int, int)  arm,mips,x86_64
int           setsockopt(int, int, int, const void*, socklen_t)  arm,mips,x86_64
int           getsockopt(int, int, int, void*, socklen_t*)    arm,mips,x86_64
int           sendmsg(int, const struct msghdr*, unsigned int)  arm,mips,x86_64
int           recvmsg(int, struct msghdr*, unsigned int)   arm,mips,x86_64

# sockets for x86. These are done as an "indexed" call to socketcall syscall.
int           socket:socketcall:1(int, int, int) x86
int           bind:socketcall:2(int, struct sockaddr*, int)  x86
int           connect:socketcall:3(int, struct sockaddr*, socklen_t)   x86
int           listen:socketcall:4(int, int)                   x86
int           accept:socketcall:5(int, struct sockaddr*, socklen_t*)  x86
int           getsockname:socketcall:6(int, struct sockaddr*, socklen_t*)  x86
int           getpeername:socketcall:7(int, struct sockaddr*, socklen_t*)  x86
int           socketpair:socketcall:8(int, int, int, int*)    x86
int           sendto:socketcall:11(int, const void*, size_t, int, const struct sockaddr*, socklen_t)  x86
int           recvfrom:socketcall:12(int, void*, size_t, unsigned int, struct sockaddr*, socklen_t*)  x86
int           shutdown:socketcall:13(int, int)  x86
int           setsockopt:socketcall:14(int, int, int, const void*, socklen_t)  x86
int           getsockopt:socketcall:15(int, int, int, void*, socklen_t*)    x86
int           sendmsg:socketcall:16(int, const struct msghdr*, unsigned int)  x86
int           recvmsg:socketcall:17(int, struct msghdr*, unsigned int)   x86

# scheduler & real-time
int sched_setscheduler(pid_t pid, int policy, const struct sched_param* param)  all
int sched_getscheduler(pid_t pid)  all
int sched_yield(void)  all
int sched_setparam(pid_t pid, const struct sched_param* param)  all
int sched_getparam(pid_t pid, struct sched_param* param)  all
int sched_get_priority_max(int policy)  all
int sched_get_priority_min(int policy)  all
int sched_rr_get_interval(pid_t pid, struct timespec* interval)  all
int sched_setaffinity(pid_t pid, size_t setsize, const cpu_set_t* set) all
int __sched_getaffinity:sched_getaffinity(pid_t pid, size_t setsize, cpu_set_t* set)  all
int __getcpu:getcpu(unsigned* cpu, unsigned* node, void* unused) all

# io priorities
int ioprio_set(int which, int who, int ioprio) all
int ioprio_get(int which, int who) all

# other
int     uname(struct utsname*)  all
mode_t  umask(mode_t)  all
int     __reboot:reboot(int, int, int, void*)  all
int     __syslog:syslog(int, char*, int)  all
int     init_module(void*, unsigned long, const char*)  all
int     delete_module(const char*, unsigned int)   all
int     klogctl:syslog(int, char*, int)   all
int     sysinfo(struct sysinfo*)  all
int     personality(unsigned long)  all
long    perf_event_open(struct perf_event_attr* attr_uptr, pid_t pid, int cpu, int group_fd, unsigned long flags) all

# futex
int     futex(void*, int, int, void*, void*, int) all

# epoll
int     epoll_create(int size)     all
int     epoll_ctl(int epfd, int op, int fd, struct epoll_event* event)    all
int     epoll_wait(int epfd, struct epoll_event* events, int max, int timeout)   all

int     inotify_init(void)      all
int     inotify_add_watch(int, const char*, unsigned int)  all
int     inotify_rm_watch(int, unsigned int)  all

int     poll(struct pollfd*, unsigned int, long)  all

int     eventfd:eventfd2(unsigned int, int)  all

# ARM-specific ARM_NR_BASE == 0x0f0000 == 983040
int     __set_tls:__ARM_NR_set_tls(void*)                                 arm
int     cacheflush:__ARM_NR_cacheflush(long start, long end, long flags)  arm

# MIPS-specific
int     _flush_cache:cacheflush(char* addr, const int nbytes, const int op) mips
int     syscall(int number, ...) mips