nanosleep Linux system call

Pause the calling thread for a relative interval unless interrupted.

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

Number on each ABI Linux 7.3

nanosleep in the Linux 7.3 system call tables
ABINo.HexEntry pointInstructionNRArgument locationsKernel tableInteractive view
x86-64350x23sys_nanosleepsyscallraxrdi, rsi, rdx, r10, r8, r9syscall_64.tbl:47Open
i3861620xa2sys_nanosleep_time32int 0x80eaxebx, ecx, edx, esi, edi, ebpsyscall_32.tbl:177Open
AArch641010x65sys_nanosleepsvc #0x8x0, x1, x2, x3, x4, x5syscall.tbl:130Open
ARM EABI1620xa2sys_nanosleep_time32svc #0r7r0, r1, r2, r3, r4, r5syscall.tbl:179Open
RISC-V 641010x65sys_nanosleepecalla7a0, a1, a2, a3, a4, a5syscall.tbl:130Open
LoongArch 641010x65sys_nanosleepsyscall 0a7a0, a1, a2, a3, a4, a5syscall.tbl:130Open
PowerPC 641620xa2sys_nanosleepscr0r3, r4, r5, r6, r7, r8syscall.tbl:212Open
PowerPC 321620xa2sys_nanosleep_time32scr0r3, r4, r5, r6, r7, r8syscall.tbl:211Open
IBM Z (s390x)1620xa2sys_nanosleepsvc 0r1r2, r3, r4, r5, r6, r7syscall.tbl:133Open
MIPS o3241660x1046sys_nanosleep_time32syscallv0a0, a1, a2, a3, Stack (5), Stack (6)syscall_o32.tbl:180Open
MIPS n3260340x1792sys_nanosleep_time32syscallv0a0, a1, a2, a3, a4, a5syscall_n32.tbl:44Open
MIPS n6450340x13aasys_nanosleepsyscallv0a0, a1, a2, a3, a4, a5syscall_n64.tbl:44Open

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_nanosleep(struct __kernel_timespec __user *rqtp, struct __kernel_timespec __user *rmtp);

x86-64, AArch64, RISC-V 64, LoongArch 64, PowerPC 64, IBM Z (s390x), MIPS n64 · Declaration: include/linux/syscalls.h:599

asmlinkage long sys_nanosleep_time32(struct old_timespec32 __user *rqtp, struct old_timespec32 __user *rmtp);

i386, ARM EABI, PowerPC 32, MIPS o32, MIPS n32 · Declaration: include/linux/syscalls.h:601

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

Manual page

nanosleep(2)

Bundled kernel releases

Bundled releases whose tables define nanosleep
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.163all 3
Linux 2.6.122all 2
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.