recvmsg Linux system call

Receive a socket message, including ancillary data such as passed descriptors.

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

Number on each ABI Linux 7.3

recvmsg in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-64470x2fsys_recvmsgsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:59Open
i3863720x174sys_recvmsg compat: compat_sys_recvmsgint 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:387Open
AArch642120xd4sys_recvmsg compat: compat_sys_recvmsgsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:256Open
ARM EABI2970x129sys_recvmsgsvc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:315Open
RISC-V 642120xd4sys_recvmsg compat: compat_sys_recvmsgecalla7a0, a1, a2, a3, a4, a5syscall.tbl:256Open
LoongArch 642120xd4sys_recvmsg compat: compat_sys_recvmsgsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:256Open
PowerPC 643420x156sys_recvmsg compat: compat_sys_recvmsgscr0r3, r4, r5, r6, r7, r8syscall.tbl:442Open
PowerPC 323420x156sys_recvmsg compat: compat_sys_recvmsgscr0r3, r4, r5, r6, r7, r8syscall.tbl:442Open
IBM Z (s390x)3720x174sys_recvmsgsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:326Open
MIPS o3241770x1051sys_recvmsg compat: compat_sys_recvmsgsyscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:191Open
MIPS n3260460x179ecompat_sys_recvmsgsyscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:56Open
MIPS n6450460x13b6sys_recvmsgsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:56Open

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_recvmsg(int fd, struct user_msghdr __user *msg, unsigned flags);

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

asmlinkage long compat_sys_recvmsg(int fd, struct compat_msghdr __user *msg, unsigned int flags);

MIPS n32 · Declaration: include/linux/compat.h:760

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

Manual page

recv(2)

Bundled kernel releases

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