LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man2 / get_robust_list.2

diff --git a/original/man2/get_robust_list.2 b/original/man2/get_robust_list.2
index 010db4a..e87592d 100644 (file)
--- a/original/man2/get_robust_list.2
+++ b/original/man2/get_robust_list.2
@@ -1,6 +1,7 @@
 .\" Copyright (C) 2006 Red Hat, Inc. All Rights Reserved.
 .\" Written by Ivana Varekova <varekova@redhat.com>
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -20,26 +21,31 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" FIXME Something could be added to this page (or exit(2))
 .\"       about exit_robust_list processing
 .\"
-.TH GET_ROBUST_LIST 2 2012-05-03 Linux "Linux System Calls"
+.TH GET_ROBUST_LIST 2 2015-01-22 Linux "Linux System Calls"
 .SH NAME
 get_robust_list, set_robust_list \- get/set list of robust futexes
 .SH SYNOPSIS
 .nf
 .B #include <linux/futex.h>
+.B #include <sys/types.h>
 .B #include <syscall.h>
 .sp
 .BI "long get_robust_list(int " pid ", struct robust_list_head **" head_ptr ,
-.BI "                    size_t *" len_ptr );
+.BI "                     size_t *" len_ptr );
 .BI "long set_robust_list(struct robust_list_head *" head ", size_t " len );
 .fi
+
+.IR Note :
+There are no glibc wrappers for these system calls; see NOTES.
 .SH DESCRIPTION
 The robust futex implementation needs to maintain per-thread lists of robust
 futexes which are unlocked when the thread exits.
-These lists are managed in user space; the kernel is only notified about
+These lists are managed in user space; the kernel is notified about only
 the location of the head of the list.
 
 The
@@ -69,7 +75,7 @@ The
 .I len
 argument should be
 .IR sizeof(*head) .
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR set_robust_list ()
 and
@@ -109,21 +115,30 @@ The head of the robust futex list can't be stored at the location
 .IR head .
 .SH VERSIONS
 These system calls were added in Linux 2.6.17.
-No library support is provided; use
-.BR syscall (2).
 .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).
 
 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.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR futex (2)
 .\" .BR pthread_mutexattr_setrobust_np (3)
-.br
-The kernel source files
+
 .IR Documentation/robust-futexes.txt
 and
-.IR Documentation/robust-futex-ABI.txt .
+.IR Documentation/robust-futex-ABI.txt
+in the Linux kernel source tree
 .\" http://lwn.net/Articles/172149/
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.