Greg Kroah-Hartman
598cf27219
Link: https://lore.kernel.org/r/20260217200002.683975158@linuxfoundation.org Tested-by: Florian Fainelli <florian.fainelli@broadcom.com> Tested-by: Takeshi Ogasawara <takeshi.ogasawara@futuring-girl.com> Tested-by: Peter Schneider <pschneider1968@googlemail.com> Tested-by: Jon Hunter <jonathanh@nvidia.com> Tested-by: Salvatore Bonaccorso <carnil@debian.org> Tested-by: Brett A C Sheffield <bacs@librecast.net> Tested-by: Mark Brown <broonie@kernel.org> Tested-by: Luna Jernberg <droidbittin@gmail.com> Tested-by: Ronald Warsow <rwarsow@gmx.de> Tested-by: Justin M. Forbes <jforbes@fedoraproject.org> Tested-by: Ron Economos <re@w6rz.net> Tested-by: Miguel Ojeda <ojeda@kernel.org> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
40 lines
1.6 KiB
ReStructuredText
40 lines
1.6 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
========================
|
|
membarrier() System Call
|
|
========================
|
|
|
|
MEMBARRIER_CMD_{PRIVATE,GLOBAL}_EXPEDITED - Architecture requirements
|
|
=====================================================================
|
|
|
|
Memory barriers before updating rq->curr
|
|
----------------------------------------
|
|
|
|
The commands MEMBARRIER_CMD_PRIVATE_EXPEDITED and MEMBARRIER_CMD_GLOBAL_EXPEDITED
|
|
require each architecture to have a full memory barrier after coming from
|
|
user-space, before updating rq->curr. This barrier is implied by the sequence
|
|
rq_lock(); smp_mb__after_spinlock() in __schedule(). The barrier matches a full
|
|
barrier in the proximity of the membarrier system call exit, cf.
|
|
membarrier_{private,global}_expedited().
|
|
|
|
Memory barriers after updating rq->curr
|
|
---------------------------------------
|
|
|
|
The commands MEMBARRIER_CMD_PRIVATE_EXPEDITED and MEMBARRIER_CMD_GLOBAL_EXPEDITED
|
|
require each architecture to have a full memory barrier after updating rq->curr,
|
|
before returning to user-space. The schemes providing this barrier on the various
|
|
architectures are as follows.
|
|
|
|
- alpha, arc, arm, hexagon, mips rely on the full barrier implied by
|
|
spin_unlock() in finish_lock_switch().
|
|
|
|
- arm64 relies on the full barrier implied by switch_to().
|
|
|
|
- powerpc, riscv, s390, sparc, x86 rely on the full barrier implied by
|
|
switch_mm(), if mm is not NULL; they rely on the full barrier implied
|
|
by mmdrop(), otherwise. On powerpc and riscv, switch_mm() relies on
|
|
membarrier_arch_switch_mm().
|
|
|
|
The barrier matches a full barrier in the proximity of the membarrier system call
|
|
entry, cf. membarrier_{private,global}_expedited().
|