statfs Linux system call

Report capacity, free space and other statistics for the filesystem containing a path.

In Linux 7.3, statfs is defined in the system call table of 12 of the 12 bundled ABIs.

Number on each ABI Linux 7.3

statfs in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-641370x89sys_statfssyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:149Open
i386990x63sys_statfs compat: compat_sys_statfsint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:114Open
AArch64430x2bsys_statfssvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:58Open
ARM EABI990x63sys_statfssvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:115Open
RISC-V 64430x2bsys_statfsecalla7a0, a1, a2, a3, a4, a5syscall.tbl:58Open
LoongArch 64430x2bsys_statfssyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:58Open
PowerPC 64990x63sys_statfs compat: compat_sys_statfsscr0r3, r4, r5, r6, r7, r8syscall.tbl:136Open
PowerPC 32990x63sys_statfs compat: compat_sys_statfsscr0r3, r4, r5, r6, r7, r8syscall.tbl:136Open
IBM Z (s390x)990x63sys_statfssvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:77Open
MIPS o3240990x1003sys_statfs compat: compat_sys_statfssyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:113Open
MIPS n3261340x17f6compat_sys_statfssyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:144Open
MIPS n6451340x140esys_statfssyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:144Open

Argument locations are the ABI’s calling convention for ARG1–ARG6 in order, not an assignment made for this call. On 32-bit ABIs, 64-bit values may occupy multiple registers and require alignment; assembly wrappers may reorder them. See syscall(2). A table entry does not mean the call exists in every kernel: most optional calls return ENOSYS when the matching configuration option or architecture support is not built.

Kernel declaration

asmlinkage long sys_statfs(const char __user * path, struct statfs __user *buf);

x86-64, i386, AArch64, ARM EABI, RISC-V 64, LoongArch 64, PowerPC 64, PowerPC 32, IBM Z (s390x), MIPS o32, MIPS n64 · Declaration: include/linux/syscalls.h:431

asmlinkage long compat_sys_statfs(const char __user *pathname, struct compat_statfs __user *buf);

MIPS n32 · Declaration: include/linux/compat.h:605

Signatures are kernel declarations and may differ from the C library wrappers.

Manual page

statfs(2)

Bundled kernel releases

Bundled releases whose tables define statfs
ReleaseABIs bundledDefined in the table of
Linux 7.312all 12
Linux 6.1812all 12
Linux 6.1212all 12
Linux 6.612all 12
Linux 5.1912all 12
Linux 4.155all 5
Linux 3.74all 4
Linux 3.03all 3
Linux 2.6.243all 3
Linux 2.6.163all 3
Linux 2.6.122all 2
Linux 1.01all 1

Each release is a separate snapshot, and older releases bundle fewer ABIs. This table does not claim the release in which the call first appeared. Numbers are listed where a release differs from Linux 7.3.