readlinkat Linux system call

Read a symbolic link using a directory descriptor to resolve relative paths.

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

Number on each ABI Linux 7.3

readlinkat in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-642670x10bsys_readlinkatsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:279Open
i3863050x131sys_readlinkatint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:320Open
AArch64780x4esys_readlinkatsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:100Open
ARM EABI3320x14csys_readlinkatsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:350Open
RISC-V 64780x4esys_readlinkatecalla7a0, a1, a2, a3, a4, a5syscall.tbl:100Open
LoongArch 64780x4esys_readlinkatsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:100Open
PowerPC 642960x128sys_readlinkatscr0r3, r4, r5, r6, r7, r8syscall.tbl:387Open
PowerPC 322960x128sys_readlinkatscr0r3, r4, r5, r6, r7, r8syscall.tbl:387Open
IBM Z (s390x)2980x12asys_readlinkatsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:252Open
MIPS o3242980x10casys_readlinkatsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:312Open
MIPS n3262610x1875sys_readlinkatsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:272Open
MIPS n6452570x1489sys_readlinkatsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:268Open

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_readlinkat(int dfd, const char __user *path, char __user *buf, int bufsiz);

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:528

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

Manual page

readlink(2)

Bundled kernel releases

Bundled releases whose tables define readlinkat
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.163x86-64 · i386
Linux 2.6.122none
Linux 1.01none

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.