[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 New
Headers show
Series
  • Untitled series #36408
Related show

Commit Message

Wilco Dijkstra via Libc-alpha April 4, 2021, 11:58 a.m.
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

---
 man2/get_robust_list.2 | 19 ++++++++-----------
 1 file changed, 8 insertions(+), 11 deletions(-)

-- 
2.31.0

Comments

Wilco Dijkstra via Libc-alpha April 5, 2021, 11:39 a.m. | #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

> 



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

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