From 3af6d22bb3850ab2bac67287e3a3d3b0e32868e5 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:41:07 +0200 Subject: Merging upstream version 6.7. Signed-off-by: Daniel Baumann --- man2/get_robust_list.2 | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) (limited to 'man2/get_robust_list.2') diff --git a/man2/get_robust_list.2 b/man2/get_robust_list.2 index 7ca4817..bd8682a 100644 --- a/man2/get_robust_list.2 +++ b/man2/get_robust_list.2 @@ -7,7 +7,7 @@ .\" FIXME Something could be added to this page (or exit(2)) .\" about exit_robust_list processing .\" -.TH get_robust_list 2 2022-10-30 "Linux man-pages 6.05.01" +.TH get_robust_list 2 2023-10-31 "Linux man-pages 6.7" .SH NAME get_robust_list, set_robust_list \- get/set list of robust futexes .SH LIBRARY @@ -19,13 +19,13 @@ Standard C library " /* Definition of " "struct robust_list_head" " */" .BR "#include " " /* Definition of " SYS_* " constants */" .B #include -.PP +.P .BI "long syscall(SYS_get_robust_list, int " pid , .BI " struct robust_list_head **" head_ptr ", size_t *" len_ptr ); .B long syscall(SYS_set_robust_list, .BI " struct robust_list_head *" head ", size_t " len ); .fi -.PP +.P .IR Note : glibc provides no wrappers for these system calls, necessitating the use of @@ -38,7 +38,7 @@ A thread can inform the kernel of the location of its robust futex list using .BR set_robust_list (). The address of a thread's robust futex list can be obtained using .BR get_robust_list (). -.PP +.P The purpose of the robust futex list is to ensure that if a thread accidentally fails to unlock a futex before terminating or calling .BR execve (2), @@ -50,7 +50,7 @@ bit is set in the futex word, and the kernel performs a .BR futex (2) .B FUTEX_WAKE operation on one of the threads waiting on the futex. -.PP +.P The .BR get_robust_list () system call returns the head of the robust futex list of the thread @@ -66,14 +66,14 @@ The size of the object pointed to by .I **head_ptr is stored in .IR len_ptr . -.PP +.P Permission to employ .BR get_robust_list () is governed by a ptrace access mode .B PTRACE_MODE_READ_REALCREDS check; see .BR ptrace (2). -.PP +.P The .BR set_robust_list () system call requests the kernel to record the head of the list of @@ -101,7 +101,7 @@ system call can fail with the following error: .I len does not equal .IR "sizeof(struct\ robust_list_head)" . -.PP +.P The .BR get_robust_list () system call can fail with the following errors: @@ -126,11 +126,11 @@ could be found. These system calls were added in Linux 2.6.17. .SH NOTES These system calls are not needed by normal applications. -.PP +.P A thread can have only one robust futex list; therefore applications that wish to use this functionality should use the robust mutexes provided by glibc. -.PP +.P In the initial implementation, a thread waiting on a futex was notified that the owner had died only if the owner terminated. @@ -138,7 +138,7 @@ Starting with Linux 2.6.28, .\" commit 8141c7f3e7aee618312fa1c15109e1219de784a7 notification was extended to include the case where the owner performs an .BR execve (2). -.PP +.P The thread IDs mentioned in the main text are .I kernel thread IDs of the kind returned by @@ -148,7 +148,7 @@ and .SH SEE ALSO .BR futex (2), .BR pthread_mutexattr_setrobust (3) -.PP +.P .I Documentation/robust\-futexes.txt and .I Documentation/robust\-futex\-ABI.txt -- cgit v1.2.3