uretprobe(2) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| RETURN VALUE \| ERRORS \| VERSIONS \| STANDARDS \| HISTORY \| CAVEATS \| COLOPHON

uretprobe(2)               System Calls Manual               uretprobe(2)

NAME top

       uretprobe - execute pending return uprobes

SYNOPSIS top

       int uretprobe(void);

DESCRIPTION top

       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 top

       The return value is architecture-specific.

ERRORS top

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

VERSIONS top

       The behavior varies across systems.

STANDARDS top

       None.

HISTORY top

       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 top

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

COLOPHON top

       This page is part of the man-pages (Linux kernel and C library
       user-space interface documentation) project.  Information about
       the project can be found at 
       ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report
       for this manual page, see
       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
       This page was obtained from the tarball man-pages-6.10.tar.gz
       fetched from
       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
       2025-02-02.  If you discover any rendering problems in this HTML
       version of the page, or you believe there is a better or more up-
       to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not
       part of the original manual page), send a mail to
       man-pages@man7.org

Linux man-pages 6.10            2024-08-21                   uretprobe(2)