1 .. SPDX-License-Identifier: GPL-2.0
2 .. include:: ../disclaimer-zh_CN.rst
3
4 :Original: Documentation/userspace-api/futex2.
5
6 :翻译:
7
8 李睿 Rui Li <me@lirui.org>
9
10 ======
11 futex2
12 ======
13
14 :作者: André Almeida <andrealmeid@collabora.
15
16 futex，或者称为快速用户互斥锁（fa
17 机制的系统调用，比如用户空间中
18 为实现更多高级接口的方式，如pthr
19
20 futex2是初代futex系统调用的后续版
21
22 用户API
23 =======
24
25 ``futex_waitv()``
26 -----------------
27
28 等待一个futex数组，可由其中任意
29
30 futex_waitv(struct futex_waitv *waiters, uns
31 unsigned int flags, struct times
32
33 struct futex_waitv {
34 __u64 val;
35 __u64 uaddr;
36 __u32 flags;
37 __u32 __reserved;
38 };
39
40 用户空间设置一个struct futex_waitv数
41 地址， ``val`` 为期望值， ``flags``
42 ``__reserved`` 需要置为0，但是它可用
43 ``waiters`` 传递。如果 ``waiters`` 或任
44
45 如果用户空间拥有32位的指针，那
46 得很精巧，在32/64位的指针上都正
47
48 ``nr_futexes`` 指定了数组的大小。不
49
50 系统调用的 ``flags`` 参数需要置0，
51
52 对于每个 ``waiters`` 数组中的项，在
53 不一致，系统调用会撤销截至目前
54 和验证都通过，系统调用会等待直
55
56 - 指定的timeout超时，返回 ``-ETIMEOUT`
57 - 一个信号被传递给睡眠中的任务
58 - 某个列表中的futex被唤醒，返回那
59
60 关于如何使用接口的例子可以在 ``t
61 中找到。
62
63 超时
64 ----
65
66 ``struct timespec *timeout`` 是一个指向
67 参数中指定要使用的时钟类型。支
68 系统调用只接受64位的timespec结构体
69
70 futex的类型
71 -----------
72
73 futex既可以是私有的也可以是共享
74 地址对所有进程都是一样的。这允
75 ``FUTEX_PRIVATE_FLAG`` 。对于那些不在
76 的虚拟地址（例如使用基于文件的
77 的行为，而且对私有futex和共享futex
78
79 futex可以是不同的大小：8，16，32或
80 标志指定。
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.