|GET_ROBUST_LIST(2)||Linux System Calls||GET_ROBUST_LIST(2)|
NAMEget_robust_list, set_robust_list - get/set list of robust futexes
long get_robust_list(int pid , struct robust_list_head ** head_ptr ,
size_t * len_ptr );
long set_robust_list(struct robust_list_head * head , size_t len );
DESCRIPTIONThe 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 notified about only the location of the head of the list.
RETURN VALUEThe set_robust_list() and get_robust_list() system calls return zero when the operation is successful, an error code otherwise.
ERRORSThe set_robust_list() system call can fail with the following error:
- len does not match the size of structure struct robust_list_head expected by kernel.
The get_robust_list() system call can fail with the following errors:
- The calling process does not have permission to see the robust futex list of the thread with the thread ID pid, and does not have the CAP_SYS_PTRACE capability.
- No thread with the thread ID pid could be found.
- The head of the robust futex list can't be stored at the location head.
VERSIONSThese system calls were added in Linux 2.6.17. No library support is provided; use syscall(2).
NOTESThese 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 syscall(2).
COLOPHONThis page is part of release 3.53 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.