€•CqŒsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ'/translations/zh_CN/locking/locktorture”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ'/translations/zh_TW/locking/locktorture”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ'/translations/it_IT/locking/locktorture”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ'/translations/ja_JP/locking/locktorture”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ'/translations/ko_KR/locking/locktorture”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ'/translations/pt_BR/locking/locktorture”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ'/translations/sp_SP/locking/locktorture”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ"Kernel Lock Torture Test Operation”h]”hŒ"Kernel Lock Torture Test Operation”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³ŒA/var/lib/git/docbuild/linux/Documentation/locking/locktorture.rst”h´Kubh¶)”}”(hhh]”(h»)”}”(hŒCONFIG_LOCK_TORTURE_TEST”h]”hŒCONFIG_LOCK_TORTURE_TEST”…””}”(hhÎh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhhËh²hh³hÊh´KubhŒ paragraph”“”)”}”(hXThe CONFIG_LOCK_TORTURE_TEST config option provides a kernel module that runs torture tests on core kernel locking primitives. The kernel module, 'locktorture', may be built after the fact on the running kernel to be tested, if desired. The tests periodically output status messages via printk(), which can be examined via the dmesg (perhaps grepping for "torture"). The test is started when the module is loaded, and stops when the module is unloaded. This program is based on how RCU is tortured, via rcutorture.”h]”hX The CONFIG_LOCK_TORTURE_TEST config option provides a kernel module that runs torture tests on core kernel locking primitives. The kernel module, ‘locktorture’, may be built after the fact on the running kernel to be tested, if desired. The tests periodically output status messages via printk(), which can be examined via the dmesg (perhaps grepping for “tortureâ€). The test is started when the module is loaded, and stops when the module is unloaded. This program is based on how RCU is tortured, via rcutorture.”…””}”(hhÞh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KhhËh²hubhÝ)”}”(hX>This torture test consists of creating a number of kernel threads which acquire the lock and hold it for specific amount of time, thus simulating different critical region behaviors. The amount of contention on the lock can be simulated by either enlarging this critical region hold time and/or creating more kthreads.”h]”hX>This torture test consists of creating a number of kernel threads which acquire the lock and hold it for specific amount of time, thus simulating different critical region behaviors. The amount of contention on the lock can be simulated by either enlarging this critical region hold time and/or creating more kthreads.”…””}”(hhìh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KhhËh²hubeh}”(h]”Œconfig-lock-torture-test”ah ]”h"]”Œconfig_lock_torture_test”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒModule Parameters”h]”hŒModule Parameters”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjh²hh³hÊh´KubhÝ)”}”(hŒ)This module has the following parameters:”h]”hŒ)This module has the following parameters:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Khjh²hubh¶)”}”(hhh]”(h»)”}”(hŒLocktorture-specific”h]”hŒLocktorture-specific”…””}”(hj$h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj!h²hh³hÊh´KubhŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒ”nwriters_stress Number of kernel threads that will stress exclusive lock ownership (writers). The default value is twice the number of online CPUs. ”h]”(hŒterm”“”)”}”(hŒnwriters_stress”h]”hŒnwriters_stress”…””}”(hj?h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´K$hj9ubhŒ definition”“”)”}”(hhh]”hÝ)”}”(hŒƒNumber of kernel threads that will stress exclusive lock ownership (writers). The default value is twice the number of online CPUs.”h]”hŒƒNumber of kernel threads that will stress exclusive lock ownership (writers). The default value is twice the number of online CPUs.”…””}”(hjRh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K"hjOubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhj9ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´K$hj4ubj8)”}”(hŒônreaders_stress Number of kernel threads that will stress shared lock ownership (readers). The default is the same amount of writer locks. If the user did not specify nwriters_stress, then both readers and writers be the amount of online CPUs. ”h]”(j>)”}”(hŒnreaders_stress”h]”hŒnreaders_stress”…””}”(hjph²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´K*hjlubjN)”}”(hhh]”hÝ)”}”(hŒãNumber of kernel threads that will stress shared lock ownership (readers). The default is the same amount of writer locks. If the user did not specify nwriters_stress, then both readers and writers be the amount of online CPUs.”h]”hŒãNumber of kernel threads that will stress shared lock ownership (readers). The default is the same amount of writer locks. If the user did not specify nwriters_stress, then both readers and writers be the amount of online CPUs.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K'hj~ubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjlubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´K*hj4h²hubj8)”}”(hXNtorture_type Type of lock to torture. By default, only spinlocks will be tortured. This module can torture the following locks, with string values as follows: - "lock_busted": Simulates a buggy lock implementation. - "spin_lock": spin_lock() and spin_unlock() pairs. - "spin_lock_irq": spin_lock_irq() and spin_unlock_irq() pairs. - "rw_lock": read/write lock() and unlock() rwlock pairs. - "rw_lock_irq": read/write lock_irq() and unlock_irq() rwlock pairs. - "mutex_lock": mutex_lock() and mutex_unlock() pairs. - "rtmutex_lock": rtmutex_lock() and rtmutex_unlock() pairs. Kernel must have CONFIG_RT_MUTEXES=y. - "rwsem_lock": read/write down() and up() semaphore pairs. ”h]”(j>)”}”(hŒ torture_type”h]”hŒ torture_type”…””}”(hjŸh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´KJhj›ubjN)”}”(hhh]”(hÝ)”}”(hŒ‘Type of lock to torture. By default, only spinlocks will be tortured. This module can torture the following locks, with string values as follows:”h]”hŒ‘Type of lock to torture. By default, only spinlocks will be tortured. This module can torture the following locks, with string values as follows:”…””}”(hj°h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K-hj­ubhŒ block_quote”“”)”}”(hXx- "lock_busted": Simulates a buggy lock implementation. - "spin_lock": spin_lock() and spin_unlock() pairs. - "spin_lock_irq": spin_lock_irq() and spin_unlock_irq() pairs. - "rw_lock": read/write lock() and unlock() rwlock pairs. - "rw_lock_irq": read/write lock_irq() and unlock_irq() rwlock pairs. - "mutex_lock": mutex_lock() and mutex_unlock() pairs. - "rtmutex_lock": rtmutex_lock() and rtmutex_unlock() pairs. Kernel must have CONFIG_RT_MUTEXES=y. - "rwsem_lock": read/write down() and up() semaphore pairs. ”h]”hŒ bullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ?"lock_busted": Simulates a buggy lock implementation. ”h]”j3)”}”(hhh]”j8)”}”(hŒ6"lock_busted": Simulates a buggy lock implementation. ”h]”(j>)”}”(hŒ"lock_busted":”h]”hŒ“lock_bustedâ€:”…””}”(hjÖh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´K2hjÒubjN)”}”(hhh]”hÝ)”}”(hŒ&Simulates a buggy lock implementation.”h]”hŒ&Simulates a buggy lock implementation.”…””}”(hjçh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K2hjäubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjÒubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´K2hjÏubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hjËubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆubjÊ)”}”(hŒ;"spin_lock": spin_lock() and spin_unlock() pairs. ”h]”j3)”}”(hhh]”j8)”}”(hŒ2"spin_lock": spin_lock() and spin_unlock() pairs. ”h]”(j>)”}”(hŒ "spin_lock":”h]”hŒ“spin_lockâ€:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´K5hjubjN)”}”(hhh]”hÝ)”}”(hŒ$spin_lock() and spin_unlock() pairs.”h]”hŒ$spin_lock() and spin_unlock() pairs.”…””}”(hj)h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K5hj&ubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´K5hjubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆubjÊ)”}”(hŒG"spin_lock_irq": spin_lock_irq() and spin_unlock_irq() pairs. ”h]”j3)”}”(hhh]”j8)”}”(hŒ>"spin_lock_irq": spin_lock_irq() and spin_unlock_irq() pairs. ”h]”(j>)”}”(hŒ"spin_lock_irq":”h]”hŒ“spin_lock_irqâ€:”…””}”(hjZh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´K8hjVubjN)”}”(hhh]”hÝ)”}”(hŒ,spin_lock_irq() and spin_unlock_irq() pairs.”h]”hŒ,spin_lock_irq() and spin_unlock_irq() pairs.”…””}”(hjkh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K8hjhubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjVubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´K8hjSubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hjOubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆubjÊ)”}”(hŒA"rw_lock": read/write lock() and unlock() rwlock pairs. ”h]”j3)”}”(hhh]”j8)”}”(hŒ8"rw_lock": read/write lock() and unlock() rwlock pairs. ”h]”(j>)”}”(hŒ "rw_lock":”h]”hŒ“rw_lockâ€:”…””}”(hjœh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´K;hj˜ubjN)”}”(hhh]”hÝ)”}”(hŒ,read/write lock() and unlock() rwlock pairs.”h]”hŒ,read/write lock() and unlock() rwlock pairs.”…””}”(hj­h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K;hjªubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhj˜ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´K;hj•ubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hj‘ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆubjÊ)”}”(hŒV"rw_lock_irq": read/write lock_irq() and unlock_irq() rwlock pairs. ”h]”j3)”}”(hhh]”j8)”}”(hŒD"rw_lock_irq": read/write lock_irq() and unlock_irq() rwlock pairs. ”h]”(j>)”}”(hŒ"rw_lock_irq":”h]”hŒ“rw_lock_irqâ€:”…””}”(hjÞh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´K?hjÚubjN)”}”(hhh]”hÝ)”}”(hŒ4read/write lock_irq() and unlock_irq() rwlock pairs.”h]”hŒ4read/write lock_irq() and unlock_irq() rwlock pairs.”…””}”(hjïh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K>hjìubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjÚubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´K?hj×ubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hjÓubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆubjÊ)”}”(hŒ>"mutex_lock": mutex_lock() and mutex_unlock() pairs. ”h]”j3)”}”(hhh]”j8)”}”(hŒ5"mutex_lock": mutex_lock() and mutex_unlock() pairs. ”h]”(j>)”}”(hŒ "mutex_lock":”h]”hŒ“mutex_lockâ€:”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´KBhjubjN)”}”(hhh]”hÝ)”}”(hŒ&mutex_lock() and mutex_unlock() pairs.”h]”hŒ&mutex_lock() and mutex_unlock() pairs.”…””}”(hj1h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KBhj.ubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´KBhjubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆubjÊ)”}”(hŒs"rtmutex_lock": rtmutex_lock() and rtmutex_unlock() pairs. Kernel must have CONFIG_RT_MUTEXES=y. ”h]”j3)”}”(hhh]”j8)”}”(hŒa"rtmutex_lock": rtmutex_lock() and rtmutex_unlock() pairs. Kernel must have CONFIG_RT_MUTEXES=y. ”h]”(j>)”}”(hŒ"rtmutex_lock":”h]”hŒ“rtmutex_lockâ€:”…””}”(hjbh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´KFhj^ubjN)”}”(hhh]”hÝ)”}”(hŒPrtmutex_lock() and rtmutex_unlock() pairs. Kernel must have CONFIG_RT_MUTEXES=y.”h]”hŒPrtmutex_lock() and rtmutex_unlock() pairs. Kernel must have CONFIG_RT_MUTEXES=y.”…””}”(hjsh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KEhjpubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhj^ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´KFhj[ubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hjWubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆubjÊ)”}”(hŒD"rwsem_lock": read/write down() and up() semaphore pairs. ”h]”j3)”}”(hhh]”j8)”}”(hŒ;"rwsem_lock": read/write down() and up() semaphore pairs. ”h]”(j>)”}”(hŒ "rwsem_lock":”h]”hŒ“rwsem_lockâ€:”…””}”(hj¤h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´KJhj ubjN)”}”(hhh]”hÝ)”}”(hŒ+read/write down() and up() semaphore pairs.”h]”hŒ+read/write down() and up() semaphore pairs.”…””}”(hjµh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KIhj²ubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhj ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´KJhjubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hj™ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÉhjÆubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jÄh³hÊh´K1hjÀubah}”(h]”h ]”h"]”h$]”h&]”uh1j¾h³hÊh´K1hj­ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jMhj›ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´KJhj4h²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1j2hj!h²hh³hÊh´Nubeh}”(h]”Œlocktorture-specific”ah ]”h"]”Œlocktorture-specific”ah$]”h&]”uh1hµhjh²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒ!Torture-framework (RCU + locking)”h]”hŒ!Torture-framework (RCU + locking)”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjh²hh³hÊh´KMubj3)”}”(hhh]”(j8)”}”(hŒéshutdown_secs The number of seconds to run the test before terminating the test and powering off the system. The default is zero, which disables test termination and system shutdown. This capability is useful for automated testing. ”h]”(j>)”}”(hŒ shutdown_secs”h]”hŒ shutdown_secs”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´KShjubjN)”}”(hhh]”hÝ)”}”(hŒÚThe number of seconds to run the test before terminating the test and powering off the system. The default is zero, which disables test termination and system shutdown. This capability is useful for automated testing.”h]”hŒÚThe number of seconds to run the test before terminating the test and powering off the system. The default is zero, which disables test termination and system shutdown. This capability is useful for automated testing.”…””}”(hj,h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KPhj)ubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´KShjubj8)”}”(hXAonoff_interval The number of seconds between each attempt to execute a randomly selected CPU-hotplug operation. Defaults to zero, which disables CPU hotplugging. In CONFIG_HOTPLUG_CPU=n kernels, locktorture will silently refuse to do any CPU-hotplug operations regardless of what value is specified for onoff_interval. ”h]”(j>)”}”(hŒonoff_interval”h]”hŒonoff_interval”…””}”(hjJh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´K[hjFubjN)”}”(hhh]”hÝ)”}”(hX1The number of seconds between each attempt to execute a randomly selected CPU-hotplug operation. Defaults to zero, which disables CPU hotplugging. In CONFIG_HOTPLUG_CPU=n kernels, locktorture will silently refuse to do any CPU-hotplug operations regardless of what value is specified for onoff_interval.”h]”hX1The number of seconds between each attempt to execute a randomly selected CPU-hotplug operation. Defaults to zero, which disables CPU hotplugging. In CONFIG_HOTPLUG_CPU=n kernels, locktorture will silently refuse to do any CPU-hotplug operations regardless of what value is specified for onoff_interval.”…””}”(hj[h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KVhjXubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjFubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´K[hjh²hubj8)”}”(hXjonoff_holdoff The number of seconds to wait until starting CPU-hotplug operations. This would normally only be used when locktorture was built into the kernel and started automatically at boot time, in which case it is useful in order to avoid confusing boot-time code with CPUs coming and going. This parameter is only useful if CONFIG_HOTPLUG_CPU is enabled. ”h]”(j>)”}”(hŒ onoff_holdoff”h]”hŒ onoff_holdoff”…””}”(hjyh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´KdhjuubjN)”}”(hhh]”hÝ)”}”(hX[The number of seconds to wait until starting CPU-hotplug operations. This would normally only be used when locktorture was built into the kernel and started automatically at boot time, in which case it is useful in order to avoid confusing boot-time code with CPUs coming and going. This parameter is only useful if CONFIG_HOTPLUG_CPU is enabled.”h]”hX[The number of seconds to wait until starting CPU-hotplug operations. This would normally only be used when locktorture was built into the kernel and started automatically at boot time, in which case it is useful in order to avoid confusing boot-time code with CPUs coming and going. This parameter is only useful if CONFIG_HOTPLUG_CPU is enabled.”…””}”(hjŠh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K^hj‡ubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjuubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´Kdhjh²hubj8)”}”(hŒçstat_interval Number of seconds between statistics-related printk()s. By default, locktorture will report stats every 60 seconds. Setting the interval to zero causes the statistics to be printed -only- when the module is unloaded. ”h]”(j>)”}”(hŒ stat_interval”h]”hŒ stat_interval”…””}”(hj¨h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´Kjhj¤ubjN)”}”(hhh]”hÝ)”}”(hŒØNumber of seconds between statistics-related printk()s. By default, locktorture will report stats every 60 seconds. Setting the interval to zero causes the statistics to be printed -only- when the module is unloaded.”h]”hŒØNumber of seconds between statistics-related printk()s. By default, locktorture will report stats every 60 seconds. Setting the interval to zero causes the statistics to be printed -only- when the module is unloaded.”…””}”(hj¹h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Kghj¶ubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhj¤ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´Kjhjh²hubj8)”}”(hŒústutter The length of time to run the test before pausing for this same period of time. Defaults to "stutter=5", so as to run and pause for (roughly) five-second intervals. Specifying "stutter=0" causes the test to run continuously without pausing. ”h]”(j>)”}”(hŒstutter”h]”hŒstutter”…””}”(hj×h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´KqhjÓubjN)”}”(hhh]”hÝ)”}”(hŒñThe length of time to run the test before pausing for this same period of time. Defaults to "stutter=5", so as to run and pause for (roughly) five-second intervals. Specifying "stutter=0" causes the test to run continuously without pausing.”h]”hŒùThe length of time to run the test before pausing for this same period of time. Defaults to “stutter=5â€, so as to run and pause for (roughly) five-second intervals. Specifying “stutter=0†causes the test to run continuously without pausing.”…””}”(hjèh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Kmhjåubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjÓubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´Kqhjh²hubj8)”}”(hŒ±shuffle_interval The number of seconds to keep the test threads affinitized to a particular subset of the CPUs, defaults to 3 seconds. Used in conjunction with test_no_idle_hz. ”h]”(j>)”}”(hŒshuffle_interval”h]”hŒshuffle_interval”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´KvhjubjN)”}”(hhh]”hÝ)”}”(hŒŸThe number of seconds to keep the test threads affinitized to a particular subset of the CPUs, defaults to 3 seconds. Used in conjunction with test_no_idle_hz.”h]”hŒŸThe number of seconds to keep the test threads affinitized to a particular subset of the CPUs, defaults to 3 seconds. Used in conjunction with test_no_idle_hz.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Kthjubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´Kvhjh²hubj8)”}”(hŒ»verbose Enable verbose debugging printing, via printk(). Enabled by default. This extra information is mostly related to high-level errors and reports from the main 'torture' framework. ”h]”(j>)”}”(hŒverbose”h]”hŒverbose”…””}”(hj5h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j=h³hÊh´K}hj1ubjN)”}”(hhh]”hÝ)”}”(hŒ±Enable verbose debugging printing, via printk(). Enabled by default. This extra information is mostly related to high-level errors and reports from the main 'torture' framework.”h]”hŒµEnable verbose debugging printing, via printk(). Enabled by default. This extra information is mostly related to high-level errors and reports from the main ‘torture’ framework.”…””}”(hjFh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KyhjCubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhj1ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÊh´K}hjh²hubeh}”(h]”h ]”h"]”h$]”h&]”uh1j2hjh²hh³hÊh´Nubeh}”(h]”Œtorture-framework-rcu-locking”ah ]”h"]”Œ!torture-framework (rcu + locking)”ah$]”h&]”uh1hµhjh²hh³hÊh´KMubeh}”(h]”Œmodule-parameters”ah ]”h"]”Œmodule parameters”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒ Statistics”h]”hŒ Statistics”…””}”(hjyh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjvh²hh³hÊh´K€ubhÝ)”}”(hŒ0Statistics are printed in the following format::”h]”hŒ/Statistics are printed in the following format:”…””}”(hj‡h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K‚hjvh²hubhŒ literal_block”“”)”}”(hX spin_lock-torture: Writes: Total: 93746064 Max/Min: 0/0 Fail: 0 (A) (B) (C) (D) (E) (A): Lock type that is being tortured -- torture_type parameter. (B): Number of writer lock acquisitions. If dealing with a read/write primitive a second "Reads" statistics line is printed. (C): Number of times the lock was acquired. (D): Min and max number of times threads failed to acquire the lock. (E): true/false values if there were errors acquiring the lock. This should -only- be positive if there is a bug in the locking primitive's implementation. Otherwise a lock should never fail (i.e., spin_lock()). Of course, the same applies for (C), above. A dummy example of this is the "lock_busted" type.”h]”hX spin_lock-torture: Writes: Total: 93746064 Max/Min: 0/0 Fail: 0 (A) (B) (C) (D) (E) (A): Lock type that is being tortured -- torture_type parameter. (B): Number of writer lock acquisitions. If dealing with a read/write primitive a second "Reads" statistics line is printed. (C): Number of times the lock was acquired. (D): Min and max number of times threads failed to acquire the lock. (E): true/false values if there were errors acquiring the lock. This should -only- be positive if there is a bug in the locking primitive's implementation. Otherwise a lock should never fail (i.e., spin_lock()). Of course, the same applies for (C), above. A dummy example of this is the "lock_busted" type.”…””}”hj—sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1j•h³hÊh´K„hjvh²hubeh}”(h]”Œ statistics”ah ]”h"]”Œ statistics”ah$]”h&]”uh1hµhh·h²hh³hÊh´K€ubh¶)”}”(hhh]”(h»)”}”(hŒUsage”h]”hŒUsage”…””}”(hj²h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj¯h²hh³hÊh´K—ubhÝ)”}”(hŒ3The following script may be used to torture locks::”h]”hŒ2The following script may be used to torture locks:”…””}”(hjÀh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K™hj¯h²hubj–)”}”(hŒR#!/bin/sh modprobe locktorture sleep 3600 rmmod locktorture dmesg | grep torture:”h]”hŒR#!/bin/sh modprobe locktorture sleep 3600 rmmod locktorture dmesg | grep torture:”…””}”hjÎsbah}”(h]”h ]”h"]”h$]”h&]”j¥j¦uh1j•h³hÊh´K›hj¯h²hubhÝ)”}”(hXThe output can be manually inspected for the error flag of "!!!". One could of course create a more elaborate script that automatically checked for such errors. The "rmmod" command forces a "SUCCESS", "FAILURE", or "RCU_HOTPLUG" indication to be printk()ed. The first two are self-explanatory, while the last indicates that while there were no locking failures, CPU-hotplug problems were detected.”h]”hX£The output can be manually inspected for the error flag of “!!!â€. One could of course create a more elaborate script that automatically checked for such errors. The “rmmod†command forces a “SUCCESSâ€, “FAILUREâ€, or “RCU_HOTPLUG†indication to be printk()ed. The first two are self-explanatory, while the last indicates that while there were no locking failures, CPU-hotplug problems were detected.”…””}”(hjÜh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K¢hj¯h²hubhÝ)”}”(hŒ'Also see: Documentation/RCU/torture.rst”h]”hŒ'Also see: Documentation/RCU/torture.rst”…””}”(hjêh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K©hj¯h²hubeh}”(h]”Œusage”ah ]”h"]”Œusage”ah$]”h&]”uh1hµhh·h²hh³hÊh´K—ubeh}”(h]”Œ"kernel-lock-torture-test-operation”ah ]”h"]”Œ"kernel lock torture test operation”ah$]”h&]”uh1hµhhh²hh³hÊh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÊuh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hºNŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j+Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÊŒ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jjhÿhüjsjpjjýjkjhj¬j©jýjúuŒ nametypes”}”(j‰hÿ‰js‰j‰jk‰j¬‰jý‰uh}”(jh·hühËjpjjýj!jhjj©jvjúj¯uŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nh²hub.