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

Message ID 20210404115847.78166-26-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/get_robust_list.2 | 19 ++++++++-----------
 1 file changed, 8 insertions(+), 11 deletions(-)
  

Comments

Michael Kerrisk \(man-pages\) April 5, 2021, 11:39 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/get_robust_list.2 | 19 ++++++++-----------
>  1 file changed, 8 insertions(+), 11 deletions(-)

Patch applied.

Thanks,

Michael


> diff --git a/man2/get_robust_list.2 b/man2/get_robust_list.2
> index dd43cded2..b1368ddd3 100644
> --- a/man2/get_robust_list.2
> +++ b/man2/get_robust_list.2
> @@ -32,16 +32,16 @@
>  get_robust_list, set_robust_list \- get/set list of robust futexes
>  .SH SYNOPSIS
>  .nf
> -.B #include <linux/futex.h>
> -.B #include <syscall.h>
> +.BR "#include <linux/futex.h>" \
> +"    /* Definition of " "struct robust_list_head" " */"
> +.BR "#include <sys/syscall.h>" "    /* Definition of " SYS_* " constants */"
> +.B #include <unistd.h>
>  .PP
> -.BI "long get_robust_list(int " pid ", struct robust_list_head **" head_ptr ,
> -.BI "                     size_t *" len_ptr );
> -.BI "long set_robust_list(struct robust_list_head *" head ", size_t " len );
> +.BI "long syscall(SYS_get_robust_list, int " pid ,
> +.BI "             struct robust_list_head **" head_ptr ", size_t *" len_ptr );
> +.BI "long syscall(SYS_set_robust_list,"
> +.BI "             struct robust_list_head *" head ", size_t " len );
>  .fi
> -.PP
> -.IR Note :
> -There are no glibc wrappers for these system calls; see NOTES.
>  .SH DESCRIPTION
>  These system calls deal with per-thread robust futex lists.
>  These lists are managed in user space:
> @@ -138,9 +138,6 @@ could be found.
>  These system calls were added in Linux 2.6.17.
>  .SH NOTES
>  These system calls are not needed by normal applications.
> -No support for them is provided in glibc.
> -In the unlikely event that you want to call them directly, use
> -.BR syscall (2).
>  .PP
>  A thread can have only one robust futex list;
>  therefore applications that wish
>
  

Patch

diff --git a/man2/get_robust_list.2 b/man2/get_robust_list.2
index dd43cded2..b1368ddd3 100644
--- a/man2/get_robust_list.2
+++ b/man2/get_robust_list.2
@@ -32,16 +32,16 @@ 
 get_robust_list, set_robust_list \- get/set list of robust futexes
 .SH SYNOPSIS
 .nf
-.B #include <linux/futex.h>
-.B #include <syscall.h>
+.BR "#include <linux/futex.h>" \
+"    /* Definition of " "struct robust_list_head" " */"
+.BR "#include <sys/syscall.h>" "    /* Definition of " SYS_* " constants */"
+.B #include <unistd.h>
 .PP
-.BI "long get_robust_list(int " pid ", struct robust_list_head **" head_ptr ,
-.BI "                     size_t *" len_ptr );
-.BI "long set_robust_list(struct robust_list_head *" head ", size_t " len );
+.BI "long syscall(SYS_get_robust_list, int " pid ,
+.BI "             struct robust_list_head **" head_ptr ", size_t *" len_ptr );
+.BI "long syscall(SYS_set_robust_list,"
+.BI "             struct robust_list_head *" head ", size_t " len );
 .fi
-.PP
-.IR Note :
-There are no glibc wrappers for these system calls; see NOTES.
 .SH DESCRIPTION
 These system calls deal with per-thread robust futex lists.
 These lists are managed in user space:
@@ -138,9 +138,6 @@  could be found.
 These system calls were added in Linux 2.6.17.
 .SH NOTES
 These system calls are not needed by normal applications.
-No support for them is provided in glibc.
-In the unlikely event that you want to call them directly, use
-.BR syscall (2).
 .PP
 A thread can have only one robust futex list;
 therefore applications that wish