pidfd_open Linux system call

Open a descriptor referring to a process, avoiding later ambiguity from PID reuse.

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

Number on each ABI Linux 7.3

pidfd_open in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-644340x1b2sys_pidfd_opensyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:361Open
i3864340x1b2sys_pidfd_openint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:442Open
AArch644340x1b2sys_pidfd_opensvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:377Open
ARM EABI4340x1b2sys_pidfd_opensvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:451Open
RISC-V 644340x1b2sys_pidfd_openecalla7a0, a1, a2, a3, a4, a5syscall.tbl:377Open
LoongArch 644340x1b2sys_pidfd_opensyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:377Open
PowerPC 644340x1b2sys_pidfd_openscr0r3, r4, r5, r6, r7, r8syscall.tbl:527Open
PowerPC 324340x1b2sys_pidfd_openscr0r3, r4, r5, r6, r7, r8syscall.tbl:527Open
IBM Z (s390x)4340x1b2sys_pidfd_opensvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:363Open
MIPS o3244340x1152sys_pidfd_opensyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:424Open
MIPS n3264340x1922sys_pidfd_opensyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:375Open
MIPS n6454340x153asys_pidfd_opensyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:351Open

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_pidfd_open(pid_t pid, unsigned int flags);

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

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

Manual page

pidfd_open(2)

Bundled kernel releases

Bundled releases whose tables define pidfd_open
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.155none
Linux 3.74none
Linux 3.03none
Linux 2.6.243none
Linux 2.6.163none
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.