open_by_handle_at on x64

obtain handle for a pathname and open file via a handle

sys_open_by_handle_at(int mountdirfd, struct file_handle *handle, int flags)
number304 (0x130)
abicommon
kconfigCONFIG_FHANDLE
entry pointsys_open_by_handle_at
sinceLinux 3.3 or earlier (3.3 is the first release scanned for x64)
man pageopen_by_handle_at(2)
sourceelixir.bootlin.com

Registers

registervalue
rax304, the syscall number
rdiint mountdirfd
rsistruct file_handle *handle
rdxint flags
raxthe return value

Then run syscall to enter the kernel.

The syscall instruction clobbers rcx (the return address lands in rcx) and r11 (the flags land in r11).

Since Linux 5.14 the kernel reads the syscall number from eax and ignores the upper 32 bits of rax. Older kernels fail with ENOSYS when those bits are not zero, and mov eax, N clears them, so it works on both.

Same syscall on other architectures

Get this as JSON: https://api.syscall.sh/v2/syscalls/x64/open_by_handle_at