socketpair Linux system call

Create two connected sockets, often for local process communication.

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

Number on each ABI Linux 7.3

socketpair in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-64530x35sys_socketpairsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:65Open
i3863600x168sys_socketpairint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:375Open
AArch641990xc7sys_socketpairsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:243Open
ARM EABI2880x120sys_socketpairsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:306Open
RISC-V 641990xc7sys_socketpairecalla7a0, a1, a2, a3, a4, a5syscall.tbl:243Open
LoongArch 641990xc7sys_socketpairsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:243Open
PowerPC 643330x14dsys_socketpairscr0r3, r4, r5, r6, r7, r8syscall.tbl:433Open
PowerPC 323330x14dsys_socketpairscr0r3, r4, r5, r6, r7, r8syscall.tbl:433Open
IBM Z (s390x)3600x168sys_socketpairsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:314Open
MIPS o3241840x1058sys_socketpairsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:198Open
MIPS n3260520x17a4sys_socketpairsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:62Open
MIPS n6450520x13bcsys_socketpairsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:62Open

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_socketpair(int, int, int, int __user *);

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

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

Manual page

socketpair(2)

Bundled kernel releases

Bundled releases whose tables define socketpair
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.74x86-64 · AArch64 · ARM EABI
Linux 3.03x86-64 · ARM EABI
Linux 2.6.243x86-64 · ARM EABI
Linux 2.6.163x86-64 · ARM EABI
Linux 2.6.122x86-64
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.