uretprobe(2)

uretprobe2

Execute pending return uprobes

Usage

int uretprobe(void);

Overview

uretprobe() is an alternative to breakpoint instructions for triggering return uprobe consumers.

Calls to uretprobe() are only made from the user-space trampoline provided by the kernel. Calls from any other place result in a SIGILL.

Return value

The return value is architecture-specific.

Errors

SIGILL

uretprobe() was called by a user-space program.

Versions

The behavior varies across systems.

Caveats

uretprobe() exists only to allow the invocation of return uprobe consumers. It should never be called directly.

Standards

None.

History

Linux 6.11.

uretprobe() was initially introduced for the x86_64 architecture where it was shown to be faster than breakpoint traps. It might be extended to other architectures.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.