Debian Codegraph @

upstream/fedora-44/man2/uretprobe.2

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