www.LinuxHowtos.org

uretprobe

Section: System Calls (2)
Updated: 202-0-08
Index Return to Main Contents

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 use-space trampoline provided by the kernel. Calls from any other place result in a SIGILL.

RETURN VALUE

The return value is architectur-specific.

ERRORS

SIGILL: uretprobe() was called by a use-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.