read Linux system call

Read bytes from an open file descriptor into a buffer.

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

Number on each ABI Linux 7.3

read in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-6400x0sys_readsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:12Open
i38630x3sys_readint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:18Open
AArch64630x3fsys_readsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:82Open
ARM EABI30x3sys_readsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:18Open
RISC-V 64630x3fsys_readecalla7a0, a1, a2, a3, a4, a5syscall.tbl:82Open
LoongArch 64630x3fsys_readsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:82Open
PowerPC 6430x3sys_readscr0r3, r4, r5, r6, r7, r8syscall.tbl:13Open
PowerPC 3230x3sys_readscr0r3, r4, r5, r6, r7, r8syscall.tbl:13Open
IBM Z (s390x)30x3sys_readsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:12Open
MIPS o3240030xfa3sys_readsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:13Open
MIPS n3260000x1770sys_readsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:10Open
MIPS n6450000x1388sys_readsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:10Open

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_read(unsigned int fd, char __user *buf, size_t count);

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

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

Manual page

read(2)

Bundled kernel releases

Bundled releases whose tables define read
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.