Debian Codegraph @

upstream/debian-unstable/man2/uretprobe.2

raw
1 .\" Copyright 2024, Jiri Olsa <[email protected]>
2 .\" Copyright, the authors of the Linux man-pages project
3 .\"
4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
5 .\"
6 .TH uretprobe 2 2026-02-08 "Linux man-pages 6.18"
7 .SH NAME
8 uretprobe
9 \-
10 execute pending return uprobes
11 .SH SYNOPSIS
12 .nf
13 .B int uretprobe(void);
14 .fi
15 .SH DESCRIPTION
16 .BR uretprobe ()
17 is an alternative to breakpoint instructions
18 for triggering return uprobe consumers.
19 .P
20 Calls to
21 .BR uretprobe ()
22 are only made from the user-space trampoline provided by the kernel.
23 Calls from any other place result in a
24 .BR SIGILL .
25 .SH RETURN VALUE
26 The return value is architecture-specific.
27 .SH ERRORS
28 .TP
29 .B SIGILL
30 .BR uretprobe ()
31 was called by a user-space program.
32 .SH VERSIONS
33 The behavior varies across systems.
34 .SH STANDARDS
35 None.
36 .SH HISTORY
37 Linux 6.11.
38 .P
39 .BR uretprobe ()
40 was initially introduced for the x86_64 architecture
41 where it was shown to be faster than breakpoint traps.
42 It might be extended to other architectures.
43 .SH CAVEATS
44 .BR uretprobe ()
45 exists only to allow the invocation of return uprobe consumers.
46 It should
47 .B never
48 be called directly.