rrsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/locking/mutex-designmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/zh_TW/locking/mutex-designmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/it_IT/locking/mutex-designmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/ja_JP/locking/mutex-designmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/ko_KR/locking/mutex-designmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget(/translations/sp_SP/locking/mutex-designmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhU/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/locking/mutex-design.rsthKubhnote)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]h paragraph)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hh5Documentation/translations/zh_CN/disclaimer-zh_CN.rsthKhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh field_list)}(hhh](hfield)}(hhh](h field_name)}(hOriginalh]hOriginal}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh field_body)}(h'Documentation/locking/mutex-design.rst h]h)}(h&Documentation/locking/mutex-design.rsth]h&Documentation/locking/mutex-design.rst}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(h翻译h]h翻译}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhKubh)}(h.唐艺舟 Tang Yizhou h]h)}(h-唐艺舟 Tang Yizhou h](h唐艺舟 Tang Yizhou <}(hj hhhNhNubh reference)}(htangyeechou@gmail.comh]htangyeechou@gmail.com}(hj*hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:tangyeechou@gmail.comuh1j(hj ubh>}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhj ubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhsection)}(hhh](htitle)}(h通用互斥锁子系统h]h通用互斥锁子系统}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjXhhhhhK ubh)}(hhh](h)}(hhh](h)}(h初稿h]h初稿}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjnhhhKubh)}(hIngo Molnar h]h)}(hIngo Molnar h](h Ingo Molnar <}(hjhhhNhNubj))}(hmingo@redhat.comh]hmingo@redhat.com}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:mingo@redhat.comuh1j(hjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhjnubeh}(h]h ]h"]h$]h&]uh1hhhhKhjkhhubh)}(hhh](h)}(h更新h]h更新}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhKubh)}(h#Davidlohr Bueso h]h)}(h"Davidlohr Bueso h](hDavidlohr Bueso <}(hjhhhNhNubj))}(hdavidlohr@hp.comh]hdavidlohr@hp.com}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:davidlohr@hp.comuh1j(hjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]uh1hhhhKhjkhhubeh}(h]h ]h"]h$]h&]uh1hhjXhhhhhKubjW)}(hhh](j\)}(h什么是互斥锁？h]h什么是互斥锁？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhKubh)}(hX在Linux内核中，互斥锁（mutex）指的是一个特殊的加锁原语，它在共享内存系统上 强制保证序列化，而不仅仅是指在学术界或类似的理论教科书中出现的通用术语“相互 排斥”。互斥锁是一种睡眠锁，它的行为类似于二进制信号量（semaphores），在 2006年被引入时[1]，作为后者的替代品。这种新的数据结构提供了许多优点，包括更 简单的接口，以及在当时更少的代码量（见缺陷）。h]hX在Linux内核中，互斥锁（mutex）指的是一个特殊的加锁原语，它在共享内存系统上 强制保证序列化，而不仅仅是指在学术界或类似的理论教科书中出现的通用术语“相互 排斥”。互斥锁是一种睡眠锁，它的行为类似于二进制信号量（semaphores），在 2006年被引入时[1]，作为后者的替代品。这种新的数据结构提供了许多优点，包括更 简单的接口，以及在当时更少的代码量（见缺陷）。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h$[1] https://lwn.net/Articles/164802/h](h[1] }(hjhhhNhNubj))}(h https://lwn.net/Articles/164802/h]h https://lwn.net/Articles/164802/}(hj!hhhNhNubah}(h]h ]h"]h$]h&]refurij#uh1j(hjubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id2ah ]h"]什么是互斥锁？ah$]h&]uh1jVhjXhhhhhKubjW)}(hhh](j\)}(h实现h]h实现}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hj>hhhhhK"ubh)}(hX 互斥锁由“struct mutex”表示，在include/linux/mutex.h中定义，并在 kernel/locking/mutex.c中实现。这些锁使用一个原子变量（->owner）来跟踪 它们生命周期内的锁状态。字段owner实际上包含的是指向当前锁所有者的 `struct task_struct *` 指针，因此如果无人持有锁，则它的值为空（NULL）。 由于task_struct的指针至少按L1_CACHE_BYTES对齐，低位（3）被用来存储额外 的状态（例如，等待者列表非空）。在其最基本的形式中，它还包括一个等待队列和 一个确保对其序列化访问的自旋锁。此外，CONFIG_MUTEX_SPIN_ON_OWNER=y的 系统使用一个自旋MCS锁（->osq，译注：MCS是两个人名的合并缩写），在下文的 （ii）中描述。h](hX 互斥锁由“struct mutex”表示，在include/linux/mutex.h中定义，并在 kernel/locking/mutex.c中实现。这些锁使用一个原子变量（->owner）来跟踪 它们生命周期内的锁状态。字段owner实际上包含的是指向当前锁所有者的 }(hjOhhhNhNubhtitle_reference)}(h`struct task_struct *`h]hstruct task_struct *}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jWhjOubhX 指针，因此如果无人持有锁，则它的值为空（NULL）。 由于task_struct的指针至少按L1_CACHE_BYTES对齐，低位（3）被用来存储额外 的状态（例如，等待者列表非空）。在其最基本的形式中，它还包括一个等待队列和 一个确保对其序列化访问的自旋锁。此外，CONFIG_MUTEX_SPIN_ON_OWNER=y的 系统使用一个自旋MCS锁（->osq，译注：MCS是两个人名的合并缩写），在下文的 （ii）中描述。}(hjOhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK$hj>hhubh)}(hZ准备获得一把自旋锁时，有三种可能经过的路径，取决于锁的状态：h]hZ准备获得一把自旋锁时，有三种可能经过的路径，取决于锁的状态：}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hj>hhubhenumerated_list)}(hhh](h list_item)}(hX#快速路径：试图通过调用cmpxchg()修改锁的所有者为当前任务，以此原子化地 获取锁。这只在无竞争的情况下有效（cmpxchg()检查值是否为0，所以3个状态 比特必须为0）。如果锁处在竞争状态，代码进入下一个可能的路径。 h]h)}(hX"快速路径：试图通过调用cmpxchg()修改锁的所有者为当前任务，以此原子化地 获取锁。这只在无竞争的情况下有效（cmpxchg()检查值是否为0，所以3个状态 比特必须为0）。如果锁处在竞争状态，代码进入下一个可能的路径。h]hX"快速路径：试图通过调用cmpxchg()修改锁的所有者为当前任务，以此原子化地 获取锁。这只在无竞争的情况下有效（cmpxchg()检查值是否为0，所以3个状态 比特必须为0）。如果锁处在竞争状态，代码进入下一个可能的路径。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hX\中速路径：也就是乐观自旋，当锁的所有者正在运行并且没有其它优先级更高的 任务（need_resched，需要重新调度）准备运行时，当前任务试图自旋来获得 锁。原理是，如果锁的所有者正在运行，它很可能不久就会释放锁。互斥锁自旋体 使用MCS锁排队，这样只有一个自旋体可以竞争互斥锁。 MCS锁（由Mellor-Crummey和Scott提出）是一个简单的自旋锁，它具有一些 理想的特性，比如公平，以及每个CPU在试图获得锁时在一个本地变量上自旋。 它避免了常见的“检测-设置”自旋锁实现导致的（CPU核间）缓存行回弹 （cacheline bouncing）这种昂贵的开销。一个类MCS锁是为实现睡眠锁的 乐观自旋而专门定制的。这种定制MCS锁的一个重要特性是，它有一个额外的属性， 当自旋体需要重新调度时，它们能够退出MCS自旋锁队列。这进一步有助于避免 以下场景：需要重新调度的MCS自旋体将继续自旋等待自旋体所有者，即将获得 MCS锁时却直接进入慢速路径。 h](h)}(hX中速路径：也就是乐观自旋，当锁的所有者正在运行并且没有其它优先级更高的 任务（need_resched，需要重新调度）准备运行时，当前任务试图自旋来获得 锁。原理是，如果锁的所有者正在运行，它很可能不久就会释放锁。互斥锁自旋体 使用MCS锁排队，这样只有一个自旋体可以竞争互斥锁。h]hX中速路径：也就是乐观自旋，当锁的所有者正在运行并且没有其它优先级更高的 任务（need_resched，需要重新调度）准备运行时，当前任务试图自旋来获得 锁。原理是，如果锁的所有者正在运行，它很可能不久就会释放锁。互斥锁自旋体 使用MCS锁排队，这样只有一个自旋体可以竞争互斥锁。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK4hjubh)}(hXMCS锁（由Mellor-Crummey和Scott提出）是一个简单的自旋锁，它具有一些 理想的特性，比如公平，以及每个CPU在试图获得锁时在一个本地变量上自旋。 它避免了常见的“检测-设置”自旋锁实现导致的（CPU核间）缓存行回弹 （cacheline bouncing）这种昂贵的开销。一个类MCS锁是为实现睡眠锁的 乐观自旋而专门定制的。这种定制MCS锁的一个重要特性是，它有一个额外的属性， 当自旋体需要重新调度时，它们能够退出MCS自旋锁队列。这进一步有助于避免 以下场景：需要重新调度的MCS自旋体将继续自旋等待自旋体所有者，即将获得 MCS锁时却直接进入慢速路径。h]hXMCS锁（由Mellor-Crummey和Scott提出）是一个简单的自旋锁，它具有一些 理想的特性，比如公平，以及每个CPU在试图获得锁时在一个本地变量上自旋。 它避免了常见的“检测-设置”自旋锁实现导致的（CPU核间）缓存行回弹 （cacheline bouncing）这种昂贵的开销。一个类MCS锁是为实现睡眠锁的 乐观自旋而专门定制的。这种定制MCS锁的一个重要特性是，它有一个额外的属性， 当自旋体需要重新调度时，它们能够退出MCS自旋锁队列。这进一步有助于避免 以下场景：需要重新调度的MCS自旋体将继续自旋等待自旋体所有者，即将获得 MCS锁时却直接进入慢速路径。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h慢速路径：最后的手段，如果仍然无法获得锁，该任务会被添加到等待队列中， 休眠直到被解锁路径唤醒。在通常情况下，它以TASK_UNINTERRUPTIBLE状态 阻塞。 h]h)}(h慢速路径：最后的手段，如果仍然无法获得锁，该任务会被添加到等待队列中， 休眠直到被解锁路径唤醒。在通常情况下，它以TASK_UNINTERRUPTIBLE状态 阻塞。h]h慢速路径：最后的手段，如果仍然无法获得锁，该任务会被添加到等待队列中， 休眠直到被解锁路径唤醒。在通常情况下，它以TASK_UNINTERRUPTIBLE状态 阻塞。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]enumtype lowerromanprefix(suffix)uh1jhj>hhhhhK0ubh)}(hXN虽然从形式上看，内核互斥锁是可睡眠的锁，路径(ii)使它实际上成为混合类型。通过 简单地不中断一个任务并忙着等待几个周期，而不是立即睡眠，这种锁已经被认为显著 改善一些工作负载的性能。注意，这种技术也被用于读写信号量（rw-semaphores）。h]hXN虽然从形式上看，内核互斥锁是可睡眠的锁，路径(ii)使它实际上成为混合类型。通过 简单地不中断一个任务并忙着等待几个周期，而不是立即睡眠，这种锁已经被认为显著 改善一些工作负载的性能。注意，这种技术也被用于读写信号量（rw-semaphores）。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhj>hhubeh}(h]id3ah ]h"]实现ah$]h&]uh1jVhjXhhhhhK"ubjW)}(hhh](j\)}(h语义h]h语义}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhKKubh)}(h4互斥锁子系统检查并强制执行以下规则:h]h4互斥锁子系统检查并强制执行以下规则:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjhhubh block_quote)}(hX- 每次只有一个任务可以持有该互斥锁。 - 只有锁的所有者可以解锁该互斥锁。 - 不允许多次解锁。 - 不允许递归加锁/解锁。 - 互斥锁只能通过API进行初始化（见下文）。 - 一个任务不能在持有互斥锁的情况下退出。 - 持有锁的内存区域不得被释放。 - 被持有的锁不能被重新初始化。 - 互斥锁不能用于硬件或软件中断上下文，如小任务（tasklet）和定时器。 h]h bullet_list)}(hhh](j)}(h3每次只有一个任务可以持有该互斥锁。h]h)}(hj*h]h3每次只有一个任务可以持有该互斥锁。}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhj(ubah}(h]h ]h"]h$]h&]uh1jhj%ubj)}(h0只有锁的所有者可以解锁该互斥锁。h]h)}(hjAh]h0只有锁的所有者可以解锁该互斥锁。}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKPhj?ubah}(h]h ]h"]h$]h&]uh1jhj%ubj)}(h不允许多次解锁。h]h)}(hjXh]h不允许多次解锁。}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKQhjVubah}(h]h ]h"]h$]h&]uh1jhj%ubj)}(h不允许递归加锁/解锁。h]h)}(hjoh]h不允许递归加锁/解锁。}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjmubah}(h]h ]h"]h$]h&]uh1jhj%ubj)}(h9互斥锁只能通过API进行初始化（见下文）。h]h)}(hjh]h9互斥锁只能通过API进行初始化（见下文）。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKShjubah}(h]h ]h"]h$]h&]uh1jhj%ubj)}(h9一个任务不能在持有互斥锁的情况下退出。h]h)}(hjh]h9一个任务不能在持有互斥锁的情况下退出。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThjubah}(h]h ]h"]h$]h&]uh1jhj%ubj)}(h*持有锁的内存区域不得被释放。h]h)}(hjh]h*持有锁的内存区域不得被释放。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKUhjubah}(h]h ]h"]h$]h&]uh1jhj%ubj)}(h*被持有的锁不能被重新初始化。h]h)}(hjh]h*被持有的锁不能被重新初始化。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKVhjubah}(h]h ]h"]h$]h&]uh1jhj%ubj)}(h_互斥锁不能用于硬件或软件中断上下文，如小任务（tasklet）和定时器。 h]h)}(h^互斥锁不能用于硬件或软件中断上下文，如小任务（tasklet）和定时器。h]h^互斥锁不能用于硬件或软件中断上下文，如小任务（tasklet）和定时器。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhjubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]bullet-uh1j#hhhKOhjubah}(h]h ]h"]h$]h&]uh1jhhhKOhjhhubh)}(h当CONFIG DEBUG_MUTEXES被启用时，这些语义将被完全强制执行。此外，互斥锁 调试代码还实现了一些其它特性，使锁的调试更容易、更快速：h]h当CONFIG DEBUG_MUTEXES被启用时，这些语义将被完全强制执行。此外，互斥锁 调试代码还实现了一些其它特性，使锁的调试更容易、更快速：}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKYhjhhubj)}(hXo- 当打印到调试输出时，总是使用互斥锁的符号名称。 - 加锁点跟踪，函数名符号化查找，系统持有的全部锁的列表，打印出它们。 - 所有者跟踪。 - 检测自我递归的锁并打印所有相关信息。 - 检测多任务环形依赖死锁，并打印所有受影响的锁和任务（并且只限于这些任务）。 h]j$)}(hhh](j)}(hE当打印到调试输出时，总是使用互斥锁的符号名称。h]h)}(hjh]hE当打印到调试输出时，总是使用互斥锁的符号名称。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hc加锁点跟踪，函数名符号化查找，系统持有的全部锁的列表，打印出它们。h]h)}(hj4h]hc加锁点跟踪，函数名符号化查找，系统持有的全部锁的列表，打印出它们。}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK]hj2ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h所有者跟踪。h]h)}(hjKh]h所有者跟踪。}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK^hjIubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h6检测自我递归的锁并打印所有相关信息。h]h)}(hjbh]h6检测自我递归的锁并打印所有相关信息。}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK_hj`ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hq检测多任务环形依赖死锁，并打印所有受影响的锁和任务（并且只限于这些任务）。 h]h)}(ho检测多任务环形依赖死锁，并打印所有受影响的锁和任务（并且只限于这些任务）。h]ho检测多任务环形依赖死锁，并打印所有受影响的锁和任务（并且只限于这些任务）。}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK`hjwubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]jjuh1j#hhhK\hjubah}(h]h ]h"]h$]h&]uh1jhhhK\hjhhubeh}(h]id4ah ]h"]语义ah$]h&]uh1jVhjXhhhhhKKubjW)}(hhh](j\)}(h接口h]h接口}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhKdubh)}(h静态定义互斥锁::h]h静态定义互斥锁:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKehjhhubh literal_block)}(hDEFINE_MUTEX(name);h]hDEFINE_MUTEX(name);}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKghjhhubh)}(h动态初始化互斥锁::h]h动态初始化互斥锁:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKihjhhubj)}(hmutex_init(mutex);h]hmutex_init(mutex);}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKkhjhhubh)}(h;以不可中断方式（uninterruptible）获取互斥锁::h]h:以不可中断方式（uninterruptible）获取互斥锁:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKmhjhhubj)}(hvoid mutex_lock(struct mutex *lock); void mutex_lock_nested(struct mutex *lock, unsigned int subclass); int mutex_trylock(struct mutex *lock);h]hvoid mutex_lock(struct mutex *lock); void mutex_lock_nested(struct mutex *lock, unsigned int subclass); int mutex_trylock(struct mutex *lock);}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKohjhhubh)}(h6以可中断方式（interruptible）获取互斥锁::h]h5以可中断方式（interruptible）获取互斥锁:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshjhhubj)}(hint mutex_lock_interruptible_nested(struct mutex *lock, unsigned int subclass); int mutex_lock_interruptible(struct mutex *lock);h]hint mutex_lock_interruptible_nested(struct mutex *lock, unsigned int subclass); int mutex_lock_interruptible(struct mutex *lock);}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKuhjhhubh)}(hR当原子变量减为0时，以可中断方式（interruptible）获取互斥锁::h]hQ当原子变量减为0时，以可中断方式（interruptible）获取互斥锁:}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhjhhubj)}(hAint atomic_dec_and_mutex_lock(atomic_t *cnt, struct mutex *lock);h]hAint atomic_dec_and_mutex_lock(atomic_t *cnt, struct mutex *lock);}hj4sbah}(h]h ]h"]h$]h&]hhuh1jhhhK{hjhhubh)}(h释放互斥锁::h]h释放互斥锁:}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK}hjhhubj)}(h&void mutex_unlock(struct mutex *lock);h]h&void mutex_unlock(struct mutex *lock);}hjPsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubh)}(h#检测是否已经获取互斥锁::h]h"检测是否已经获取互斥锁:}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h(int mutex_is_locked(struct mutex *lock);h]h(int mutex_is_locked(struct mutex *lock);}hjlsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjhhubeh}(h]id5ah ]h"]接口ah$]h&]uh1jVhjXhhhhhKdubjW)}(hhh](j\)}(h缺陷h]h缺陷}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhKubh)}(hX与它最初的设计和目的不同，'struct mutex' 是内核中最大的锁之一。例如：在 x86-64上它是32字节，而 'struct semaphore' 是24字节，rw_semaphore是 40字节。更大的结构体大小意味着更多的CPU缓存和内存占用。h]hX 与它最初的设计和目的不同，’struct mutex’ 是内核中最大的锁之一。例如：在 x86-64上它是32字节，而 ‘struct semaphore’ 是24字节，rw_semaphore是 40字节。更大的结构体大小意味着更多的CPU缓存和内存占用。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id6ah ]h"]缺陷ah$]h&]uh1jVhjXhhhhhKubjW)}(hhh](j\)}(h何时使用互斥锁h]h何时使用互斥锁}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhKubh)}(h总是优先选择互斥锁而不是任何其它锁原语，除非互斥锁的严格语义不合适，和/或临界区 阻止锁被共享。h]h总是优先选择互斥锁而不是任何其它锁原语，除非互斥锁的严格语义不合适，和/或临界区 阻止锁被共享。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id7ah ]h"]何时使用互斥锁ah$]h&]uh1jVhjXhhhhhKubeh}(h]id1ah ]h"]通用互斥锁子系统ah$]h&]uh1jVhhhhhhhK ubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(j[N generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jjj;j8jjjjjj|jjjju nametypes}(jj;jjjjjuh}(jjXj8jjj>jjj|jjjjju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}j KsRparse_messages]transform_messages] transformerN include_log]9Documentation/translations/zh_CN/locking/mutex-design.rst(NNNNta decorationNhhub.