NAME

uretprobe - execute pending return uprobes

SYNOPSIS

int uretprobe(void);

DESCRIPTION

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.

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.

CAVEATS

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