aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/powerpc/transactional_memory.txt
diff options
context:
space:
mode:
authorSam bobroff <sam.bobroff@au1.ibm.com>2015-04-10 00:16:47 -0400
committerMichael Ellerman <mpe@ellerman.id.au>2015-04-11 06:49:19 -0400
commitfeba40362b11341bee6d8ed58d54b896abbd9f84 (patch)
tree1260122ddfe4ae26ad224367097e2ca38fc8c6be /Documentation/powerpc/transactional_memory.txt
parent771e569e8200ab6f5cdbcd6513f7a476718bb44d (diff)
powerpc/tm: Abort syscalls in active transactions
This patch changes the syscall handler to doom (tabort) active transactions when a syscall is made and return immediately without performing the syscall. Currently, the system call instruction automatically suspends an active transaction which causes side effects to persist when an active transaction fails. This does change the kernel's behaviour, but in a way that was documented as unsupported. It doesn't reduce functionality because syscalls will still be performed after tsuspend. It also provides a consistent interface and makes the behaviour of user code substantially the same across powerpc and platforms that do not support suspended transactions (e.g. x86 and s390). Performance measurements using http://ozlabs.org/~anton/junkcode/null_syscall.c indicate the cost of a system call increases by about 0.5%. Signed-off-by: Sam Bobroff <sam.bobroff@au1.ibm.com> Acked-By: Michael Neuling <mikey@neuling.org> Signed-off-by: Michael Ellerman <mpe@ellerman.id.au>
Diffstat (limited to 'Documentation/powerpc/transactional_memory.txt')
-rw-r--r--Documentation/powerpc/transactional_memory.txt32
1 files changed, 16 insertions, 16 deletions
diff --git a/Documentation/powerpc/transactional_memory.txt b/Documentation/powerpc/transactional_memory.txt
index 9791e98ab49c..98b39af5254f 100644
--- a/Documentation/powerpc/transactional_memory.txt
+++ b/Documentation/powerpc/transactional_memory.txt
@@ -74,22 +74,23 @@ Causes of transaction aborts
74Syscalls 74Syscalls
75======== 75========
76 76
77Performing syscalls from within transaction is not recommended, and can lead 77Syscalls made from within an active transaction will not be performed and the
78to unpredictable results. 78transaction will be doomed by the kernel with the failure code TM_CAUSE_SYSCALL
79| TM_CAUSE_PERSISTENT.
79 80
80Syscalls do not by design abort transactions, but beware: The kernel code will 81Syscalls made from within a suspended transaction are performed as normal and
81not be running in transactional state. The effect of syscalls will always 82the transaction is not explicitly doomed by the kernel. However, what the
82remain visible, but depending on the call they may abort your transaction as a 83kernel does to perform the syscall may result in the transaction being doomed
83side-effect, read soon-to-be-aborted transactional data that should not remain 84by the hardware. The syscall is performed in suspended mode so any side
84invisible, etc. If you constantly retry a transaction that constantly aborts 85effects will be persistent, independent of transaction success or failure. No
85itself by calling a syscall, you'll have a livelock & make no progress. 86guarantees are provided by the kernel about which syscalls will affect
87transaction success.
86 88
87Simple syscalls (e.g. sigprocmask()) "could" be OK. Even things like write() 89Care must be taken when relying on syscalls to abort during active transactions
88from, say, printf() should be OK as long as the kernel does not access any 90if the calls are made via a library. Libraries may cache values (which may
89memory that was accessed transactionally. 91give the appearance of success) or perform operations that cause transaction
90 92failure before entering the kernel (which may produce different failure codes).
91Consider any syscalls that happen to work as debug-only -- not recommended for 93Examples are glibc's getpid() and lazy symbol resolution.
92production use. Best to queue them up till after the transaction is over.
93 94
94 95
95Signals 96Signals
@@ -176,8 +177,7 @@ kernel aborted a transaction:
176 TM_CAUSE_RESCHED Thread was rescheduled. 177 TM_CAUSE_RESCHED Thread was rescheduled.
177 TM_CAUSE_TLBI Software TLB invalide. 178 TM_CAUSE_TLBI Software TLB invalide.
178 TM_CAUSE_FAC_UNAV FP/VEC/VSX unavailable trap. 179 TM_CAUSE_FAC_UNAV FP/VEC/VSX unavailable trap.
179 TM_CAUSE_SYSCALL Currently unused; future syscalls that must abort 180 TM_CAUSE_SYSCALL Syscall from active transaction.
180 transactions for consistency will use this.
181 TM_CAUSE_SIGNAL Signal delivered. 181 TM_CAUSE_SIGNAL Signal delivered.
182 TM_CAUSE_MISC Currently unused. 182 TM_CAUSE_MISC Currently unused.
183 TM_CAUSE_ALIGNMENT Alignment fault. 183 TM_CAUSE_ALIGNMENT Alignment fault.