Re: [PATCHv8 9/9] man2: Add uretprobe syscall page
From: Jiri Olsa <hidden>
Date: 2024-08-16 17:04:04
Also in:
bpf, linux-api, linux-man, lkml
On Fri, Aug 16, 2024 at 01:42:26PM +0200, Alejandro Colomar wrote:
Hi Steven, Jiri, On Wed, Aug 07, 2024 at 04:27:34PM GMT, Steven Rostedt wrote:quoted
Just in case nobody pinged you, the rest of the series is now in Linus's tree.Thanks for the ping! I have prepared some tweaks to the patch (see below). Also, I have some doubts. The prototype shows that it has no arguments (void), but the text said that arguments, if any, are arch-specific. Does any arch have arguments? Should we use a variadic prototype (...)?
hi, there are no args for x86.. it's there just to note that it might be different on other archs, so not sure what man page should say in such case.. keeping (void) is fine with me
Please add the changes proposed below to your patch, tweak anything if you consider it appropriate) and send it as v10.
it looks good to me, thanks a lot Acked-by: From: Jiri Olsa <jolsa@kernel.org> jirka
quoted hunk ↗ jump to hunk
Have a lovely day! Alexdiff --git i/man/man2/uretprobe.2 w/man/man2/uretprobe.2 index cf1c2b0d8..51b566998 100644 --- i/man/man2/uretprobe.2 +++ w/man/man2/uretprobe.2@@ -7,50 +7,43 @@ .SH NAME uretprobe \- execute pending return uprobes .SH SYNOPSIS .nf -.B int uretprobe(void) +.B int uretprobe(void); .fi .SH DESCRIPTION -The .BR uretprobe () -system call is an alternative to breakpoint instructions for triggering return -uprobe consumers. +is an alternative to breakpoint instructions +for triggering return uprobe consumers. .P Calls to .BR uretprobe () -system call are only made from the user-space trampoline provided by the kernel. +are only made from the user-space trampoline provided by the kernel. Calls from any other place result in a .BR SIGILL . -.SH RETURN VALUE -The +.P +Details of the arguments (if any) passed to .BR uretprobe () -system call return value is architecture-specific. +are architecture-specific. +.SH RETURN VALUE +The return value is architecture-specific. .SH ERRORS .TP .B SIGILL -The .BR uretprobe () -system call was called by a user-space program. +was called by a user-space program. .SH VERSIONS -Details of the -.BR uretprobe () -system call behavior vary across systems. +The behavior varies across systems. .SH STANDARDS None. .SH HISTORY -TBD -.SH NOTES -The +Linux 6.11. +.P .BR uretprobe () -system call was initially introduced for the x86_64 architecture +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. -.P -The +.SH CAVEATS .BR uretprobe () -system call exists only to allow the invocation of return uprobe consumers. +exists only to allow the invocation of return uprobe consumers. It should .B never be called directly. -Details of the arguments (if any) passed to -.BR uretprobe () -and the return value are architecture-specific.-- <https://www.alejandro-colomar.es/>