Section 2: system calls
NAME fcntl – manipulate file descriptor SYNOPSIS #include <fcntl.h> #include <unistd.h> int fcntl(int fd, int cmd, … /* arg */); DESCRIPTION fcntl() performs one of the operations described below on the open file descriptor fd. The operation is determined by cmd. fcntl() can take an optional third argument. Whether or not this argument is required…
NAME chown, fchown, lchown, fchownat – change ownership of a file SYNOPSIS #include <unistd.h> int chown(const char *pathname, uid_t owner, gid_t group); int fchown(int fd, uid_t owner, gid_t group); int lchown(const char *pathname, uid_t owner, gid_t group); #include <fcntl.h> /* Definition of AT_* constants */ #include <unistd.h> int fchownat(int dirfd, const char *pathname, uid_t owner,…
NAME chown, fchown, lchown, fchownat – change ownership of a file SYNOPSIS #include <unistd.h> int chown(const char *pathname, uid_t owner, gid_t group); int fchown(int fd, uid_t owner, gid_t group); int lchown(const char *pathname, uid_t owner, gid_t group); #include <fcntl.h> /* Definition of AT_* constants */ #include <unistd.h> int fchownat(int dirfd, const char *pathname, uid_t owner,…
NAME chown, fchown, lchown, fchownat – change ownership of a file SYNOPSIS #include <unistd.h> int chown(const char *pathname, uid_t owner, gid_t group); int fchown(int fd, uid_t owner, gid_t group); int lchown(const char *pathname, uid_t owner, gid_t group); #include <fcntl.h> /* Definition of AT_* constants */ #include <unistd.h> int fchownat(int dirfd, const char *pathname, uid_t owner,…
NAME chmod, fchmod, fchmodat – change permissions of a file SYNOPSIS #include <sys/stat.h> int chmod(const char *pathname, mode_t mode); int fchmod(int fd, mode_t mode); #include <fcntl.h> /* Definition of AT_* constants */ #include <sys/stat.h> int fchmodat(int dirfd, const char *pathname, mode_t mode, int flags); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): fchmod(): Since glibc…
NAME chmod, fchmod, fchmodat – change permissions of a file SYNOPSIS #include <sys/stat.h> int chmod(const char *pathname, mode_t mode); int fchmod(int fd, mode_t mode); #include <fcntl.h> /* Definition of AT_* constants */ #include <sys/stat.h> int fchmodat(int dirfd, const char *pathname, mode_t mode, int flags); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): fchmod(): Since glibc…
NAME chdir, fchdir – change working directory SYNOPSIS #include <unistd.h> int chdir(const char *path); int fchdir(int fd); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): fchdir(): _XOPEN_SOURCE >= 500 || /* Since glibc 2.12: */ _POSIX_C_SOURCE >= 200809L || /* Glibc up to and including 2.19: */ _BSD_SOURCE DESCRIPTION chdir() changes the current working directory of the calling process to the directory specified in path. fchdir() is…
NAME afs_syscall, break, fattach, fdetach, ftime, getmsg, getpmsg, gtty, isastream, lock, madvise1, mpx, multiplexer, prof, profil, putmsg, putpmsg, security, stty, tuxcall, ulimit, vserver – unimplemented system calls SYNOPSIS Unimplemented system calls. DESCRIPTION These system calls are not implemented in the Linux 2.6.22 kernel. RETURN VALUE These system calls always return -1 and set errno to…
NAME afs_syscall, break, fattach, fdetach, ftime, getmsg, getpmsg, gtty, isastream, lock, madvise1, mpx, prof, profil, putmsg, putpmsg, security, stty, tuxcall, ulimit, vserver – unimplemented system calls SYNOPSIS Unimplemented system calls. DESCRIPTION These system calls are not implemented in the Linux kernel. RETURN VALUE These system calls always return -1 and set errno to ENOSYS. NOTES…
NAME fanotify_mark – add, remove, or modify an fanotify mark on a filesystem object SYNOPSIS #include <sys/fanotify.h> int fanotify_mark(int fanotify_fd, unsigned int flags, uint64_t mask, int dirfd, const char *pathname); DESCRIPTION For an overview of the fanotify API, see fanotify(7). fanotify_mark() adds, removes, or modifies an fanotify mark on a filesystem object. The caller must…
NAME fanotify_init – create and initialize fanotify group SYNOPSIS #include <fcntl.h> #include <sys/fanotify.h> int fanotify_init(unsigned int flags, unsigned int event_f_flags); DESCRIPTION For an overview of the fanotify API, see fanotify(7). fanotify_init() initializes a new fanotify group and returns a file descriptor for the event queue associated with the group. The file descriptor is used in…
NAME fallocate – manipulate file space SYNOPSIS #define _GNU_SOURCE /* See feature_test_macros(7) */ #include <fcntl.h> int fallocate(int fd, int mode, off_t offset, off_t len); DESCRIPTION This is a nonportable, Linux-specific system call. For the portable, POSIX.1-specified method of ensuring that space is allocated for a file, see posix_fallocate(3). fallocate() allows the caller to directly manipulate…
NAME posix_fadvise – predeclare an access pattern for file data SYNOPSIS #include <fcntl.h> int posix_fadvise(int fd, off_t offset, off_t len, int advice); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): posix_fadvise(): _POSIX_C_SOURCE >= 200112L DESCRIPTION Programs can use posix_fadvise() to announce an intention to access file data in a specific pattern in the future, thus allowing the…
NAME posix_fadvise – predeclare an access pattern for file data SYNOPSIS #include <fcntl.h> int posix_fadvise(int fd, off_t offset, off_t len, int advice); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): posix_fadvise(): _POSIX_C_SOURCE >= 200112L DESCRIPTION Programs can use posix_fadvise() to announce an intention to access file data in a specific pattern in the future, thus allowing the…
NAME fadvise64,fadvise64_64 – Give advice about file access SYNOPSIS long fadvise64_64 (int fs, loff_t offset, loff_t len, int advice, int fs, loff_t offset, loff_t len, int advice); long sys_fadvise64 (int fs, loff_t offset, loff_t len, int advice, int fs, loff_t offset, loff_t len, int advice); DESCRIPTION Allows an application to to tell the kernel how it expects to use a file handle, so that the kernel can choose appropriate read-ahead and caching techniques…
NAME access, faccessat, faccessat2 – check user’s permissions for a file SYNOPSIS #include <unistd.h> int access(const char *pathname, int mode); #include <fcntl.h> /* Definition of AT_* constants */ #include <unistd.h> int faccessat(int dirfd, const char *pathname, int mode, int flags); /* But see C library/kernel differences, below */ int faccessat2(int dirfd, const char *pathname, int…
NAME access, faccessat, faccessat2 – check user’s permissions for a file SYNOPSIS #include <unistd.h> int access(const char *pathname, int mode); #include <fcntl.h> /* Definition of AT_* constants */ #include <unistd.h> int faccessat(int dirfd, const char *pathname, int mode, int flags); /* But see C library/kernel differences, below */ int faccessat2(int dirfd, const char *pathname, int…
NAME exit_group – exit all threads in a process SYNOPSIS #include <linux/unistd.h> void exit_group(int status); DESCRIPTION This system call is equivalent to _exit(2) except that it terminates not only the calling thread, but all threads in the calling process’s thread group. RETURN VALUE This system call does not return. VERSIONS This call is present since…
NAME _exit, _Exit – terminate the calling process SYNOPSIS #include <unistd.h> void _exit(int status); #include <stdlib.h> void _Exit(int status); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): _Exit(): _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L DESCRIPTION _exit() terminates the calling process "immediately". Any open file descriptors belonging to the process are closed. Any children of the process are inherited…
NAME execveat – execute program relative to a directory file descriptor SYNOPSIS #include <unistd.h> int execveat(int dirfd, const char *pathname, char *const argv[], char *const envp[], int flags); DESCRIPTION The execveat() system call executes the program referred to by the combination of dirfd and pathname. It operates in exactly the same way as execve(2), except…