[v5,24/35] getunwind.2: Use syscall(SYS_...); for system calls without a wrapper

Message ID 20210404115847.78166-25-alx.manpages@gmail.com
State Not applicable
Headers
Series None |

Commit Message

Alejandro Colomar April 4, 2021, 11:58 a.m. UTC
  Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
---
 man2/getunwind.2 | 14 ++++----------
 1 file changed, 4 insertions(+), 10 deletions(-)
  

Comments

Michael Kerrisk \(man-pages\) April 5, 2021, 11:37 a.m. UTC | #1
Hi Alex,

On 4/4/21 1:58 PM, Alejandro Colomar wrote:
> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
> ---
>  man2/getunwind.2 | 14 ++++----------
>  1 file changed, 4 insertions(+), 10 deletions(-)


Patch applied.

Thanks,

Michael


> diff --git a/man2/getunwind.2 b/man2/getunwind.2
> index 45535dccf..2c44506c7 100644
> --- a/man2/getunwind.2
> +++ b/man2/getunwind.2
> @@ -29,16 +29,14 @@
>  getunwind \- copy the unwind data to caller's buffer
>  .SH SYNOPSIS
>  .nf
> -.B #include <syscall.h>
>  .B #include <linux/unwind.h>
> +.BR "#include <sys/syscall.h>" "      /* Definition of " SYS_* " constants */"
> +.B #inlcude <unistd.h>
>  .PP
> -.BI "long getunwind(void " *buf ", size_t " buf_size );
> +.BI "long syscall(SYS_getunwind, void " *buf ", size_t " buf_size );
>  .fi
> -.PP
> -.IR Note :
> -There is no glibc wrapper for this system call; see NOTES.
>  .SH DESCRIPTION
> -.I Note: this function is obsolete.
> +.I Note: this system call is obsolete.
>  .PP
>  The
>  IA-64-specific
> @@ -102,9 +100,5 @@ and is available only on the IA-64 architecture.
>  This system call has been deprecated.
>  The modern way to obtain the kernel's unwind data is via the
>  .BR vdso (7).
> -.PP
> -Glibc does not provide a wrapper for this system call;
> -in the unlikely event that you want to call it, use
> -.BR syscall (2).
>  .SH SEE ALSO
>  .BR getauxval (3)
>
  

Patch

diff --git a/man2/getunwind.2 b/man2/getunwind.2
index 45535dccf..2c44506c7 100644
--- a/man2/getunwind.2
+++ b/man2/getunwind.2
@@ -29,16 +29,14 @@ 
 getunwind \- copy the unwind data to caller's buffer
 .SH SYNOPSIS
 .nf
-.B #include <syscall.h>
 .B #include <linux/unwind.h>
+.BR "#include <sys/syscall.h>" "      /* Definition of " SYS_* " constants */"
+.B #inlcude <unistd.h>
 .PP
-.BI "long getunwind(void " *buf ", size_t " buf_size );
+.BI "long syscall(SYS_getunwind, void " *buf ", size_t " buf_size );
 .fi
-.PP
-.IR Note :
-There is no glibc wrapper for this system call; see NOTES.
 .SH DESCRIPTION
-.I Note: this function is obsolete.
+.I Note: this system call is obsolete.
 .PP
 The
 IA-64-specific
@@ -102,9 +100,5 @@  and is available only on the IA-64 architecture.
 This system call has been deprecated.
 The modern way to obtain the kernel's unwind data is via the
 .BR vdso (7).
-.PP
-Glibc does not provide a wrapper for this system call;
-in the unlikely event that you want to call it, use
-.BR syscall (2).
 .SH SEE ALSO
 .BR getauxval (3)