getdents Linux system call
Read directory entries into a buffer in the kernel’s older record layout.
In Linux 7.3, getdents is defined in the system call table of 9 of the 12 bundled ABIs. It has no table entry on: AArch64, RISC-V 64, LoongArch 64.
Number on each ABI Linux 7.3
| ABI | No. | Hex | Entry point | Instruction | NR | Argument locations | Kernel table | Interactive view |
|---|---|---|---|---|---|---|---|---|
| x86-64 | 78 | 0x4e | sys_getdents | syscall | rax | rdi, rsi, rdx, r10, r8, r9 | syscall_64.tbl:90 | Open |
| i386 | 141 | 0x8d | sys_getdents compat: compat_sys_getdents | int 0x80 | eax | ebx, ecx, edx, esi, edi, ebp | syscall_32.tbl:156 | Open |
| AArch64 | Not in the Linux 7.3 table for this ABI. | |||||||
| ARM EABI | 141 | 0x8d | sys_getdents | svc #0 | r7 | r0, r1, r2, r3, r4, r5 | syscall.tbl:158 | Open |
| RISC-V 64 | Not in the Linux 7.3 table for this ABI. | |||||||
| LoongArch 64 | Not in the Linux 7.3 table for this ABI. | |||||||
| PowerPC 64 | 141 | 0x8d | sys_getdents compat: compat_sys_getdents | sc | r0 | r3, r4, r5, r6, r7, r8 | syscall.tbl:188 | Open |
| PowerPC 32 | 141 | 0x8d | sys_getdents compat: compat_sys_getdents | sc | r0 | r3, r4, r5, r6, r7, r8 | syscall.tbl:188 | Open |
| IBM Z (s390x) | 141 | 0x8d | sys_getdents | svc 0 | r1 | r2, r3, r4, r5, r6, r7 | syscall.tbl:112 | Open |
| MIPS o32 | 4141 | 0x102d | sys_getdents compat: compat_sys_getdents | syscall | v0 | a0, a1, a2, a3, Stack (5), Stack (6) | syscall_o32.tbl:155 | Open |
| MIPS n32 | 6076 | 0x17bc | compat_sys_getdents | syscall | v0 | a0, a1, a2, a3, a4, a5 | syscall_n32.tbl:86 | Open |
| MIPS n64 | 5076 | 0x13d4 | sys_getdents | syscall | v0 | a0, a1, a2, a3, a4, a5 | syscall_n64.tbl:86 | Open |
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_getdents(unsigned int fd, struct linux_dirent __user *dirent, unsigned int count);
x86-64, i386, ARM EABI, PowerPC 64, PowerPC 32, IBM Z (s390x), MIPS o32, MIPS n64 · Declaration: include/linux/syscalls.h:1106
asmlinkage long compat_sys_getdents(unsigned int fd, struct compat_linux_dirent __user *dirent, unsigned int count);
MIPS n32 · Declaration: include/linux/compat.h:619
Signatures are kernel declarations and may differ from the C library wrappers.
Manual page
Bundled kernel releases
| Release | ABIs bundled | Defined in the table of |
|---|---|---|
| Linux 7.3 | 12 | x86-64 · i386 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64 |
| Linux 6.18 | 12 | x86-64 · i386 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64 |
| Linux 6.12 | 12 | x86-64 · i386 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64 |
| Linux 6.6 | 12 | x86-64 · i386 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64 |
| Linux 5.19 | 12 | x86-64 · i386 · ARM EABI · PowerPC 64 · PowerPC 32 · IBM Z (s390x) · MIPS o32 · MIPS n32 · MIPS n64 |
| Linux 4.15 | 5 | x86-64 · i386 · ARM EABI |
| Linux 3.7 | 4 | x86-64 · i386 · ARM EABI |
| Linux 3.0 | 3 | all 3 |
| Linux 2.6.24 | 3 | all 3 |
| Linux 2.6.16 | 3 | all 3 |
| Linux 2.6.12 | 2 | all 2 |
| Linux 1.0 | 1 | none |
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.