vsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget./translations/zh_CN/arch/powerpc/syscall64-abimodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/zh_TW/arch/powerpc/syscall64-abimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/it_IT/arch/powerpc/syscall64-abimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/ja_JP/arch/powerpc/syscall64-abimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/ko_KR/arch/powerpc/syscall64-abimodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/sp_SP/arch/powerpc/syscall64-abimodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(h/Power Architecture 64-bit Linux system call ABIh]h/Power Architecture 64-bit Linux system call ABI}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhH/var/lib/git/docbuild/linux/Documentation/arch/powerpc/syscall64-abi.rsthKubh)}(hhh](h)}(hsyscallh]hsyscall}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Invocationh]h Invocation}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubh paragraph)}(hThe syscall is made with the sc instruction, and returns with execution continuing at the instruction following the sc instruction.h]hThe syscall is made with the sc instruction, and returns with execution continuing at the instruction following the sc instruction.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hIf PPC_FEATURE2_SCV appears in the AT_HWCAP2 ELF auxiliary vector, the scv 0 instruction is an alternative that may provide better performance, with some differences to calling sequence.h]hIf PPC_FEATURE2_SCV appears in the AT_HWCAP2 ELF auxiliary vector, the scv 0 instruction is an alternative that may provide better performance, with some differences to calling sequence.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hsyscall calling sequence\ [1]_ matches the Power Architecture 64-bit ELF ABI specification C function calling sequence, including register preservation rules, with the following differences.h](hsyscall calling sequence }(hhhhhNhNubhfootnote_reference)}(h[1]_h]h1}(hjhhhNhNubah}(h]id1ah ]h"]h$]h&]refidid2docnamearch/powerpc/syscall64-abiuh1hhhresolvedKubh matches the Power Architecture 64-bit ELF ABI specification C function calling sequence, including register preservation rules, with the following differences.}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubhfootnote)}(htSome syscalls (typically low-level management functions) may have different calling sequences (e.g., rt_sigreturn). h](hlabel)}(h1h]h1}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j%hj!ubh)}(hsSome syscalls (typically low-level management functions) may have different calling sequences (e.g., rt_sigreturn).h]hsSome syscalls (typically low-level management functions) may have different calling sequences (e.g., rt_sigreturn).}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj!ubeh}(h]jah ]h"]1ah$]h&]j ajjuh1jhhhKhhhhjKubeh}(h] invocationah ]h"]h$] invocationah&]uh1hhhhhhhhK referencedKubh)}(hhh](h)}(h Parametersh]h Parameters}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShhhhhKubh)}(h*The system call number is specified in r0.h]h*The system call number is specified in r0.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjShhubh)}(hIThere is a maximum of 6 integer parameters to a syscall, passed in r3-r8.h]hIThere is a maximum of 6 integer parameters to a syscall, passed in r3-r8.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjShhubeh}(h] parametersah ]h"] parametersah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Return valueh]h Return value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh bullet_list)}(hhh](h list_item)}(hX4For the sc instruction, both a value and an error condition are returned. cr0.SO is the error condition, and r3 is the return value. When cr0.SO is clear, the syscall succeeded and r3 is the return value. When cr0.SO is set, the syscall failed and r3 is the error value (that normally corresponds to errno). h]h)}(hX3For the sc instruction, both a value and an error condition are returned. cr0.SO is the error condition, and r3 is the return value. When cr0.SO is clear, the syscall succeeded and r3 is the return value. When cr0.SO is set, the syscall failed and r3 is the error value (that normally corresponds to errno).h]hX3For the sc instruction, both a value and an error condition are returned. cr0.SO is the error condition, and r3 is the return value. When cr0.SO is clear, the syscall succeeded and r3 is the return value. When cr0.SO is set, the syscall failed and r3 is the error value (that normally corresponds to errno).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hFor the scv 0 instruction, the return value indicates failure if it is -4095..-1 (i.e., it is >= -MAX_ERRNO (-4095) as an unsigned comparison), in which case the error value is the negated return value. h]h)}(hFor the scv 0 instruction, the return value indicates failure if it is -4095..-1 (i.e., it is >= -MAX_ERRNO (-4095) as an unsigned comparison), in which case the error value is the negated return value.h]hFor the scv 0 instruction, the return value indicates failure if it is -4095..-1 (i.e., it is >= -MAX_ERRNO (-4095) as an unsigned comparison), in which case the error value is the negated return value.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK&hjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]bullet-uh1jhhhK hjhhubeh}(h] return-valueah ]h"] return valueah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hStackh]hStack}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK+ubh)}(h~System calls do not modify the caller's stack frame. For example, the caller's stack frame LR and CR save fields are not used.h]hSystem calls do not modify the caller’s stack frame. For example, the caller’s stack frame LR and CR save fields are not used.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hjhhubeh}(h]stackah ]h"]h$]stackah&]uh1hhhhhhhhK+jRKubh)}(hhh](h)}(hRegister preservation rulesh]hRegister preservation rules}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK0ubh)}(hURegister preservation rules match the ELF ABI calling sequence with some differences.h]hURegister preservation rules match the ELF ABI calling sequence with some differences.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjhhubh)}(hHFor the sc instruction, the differences from the ELF ABI are as follows:h]hHFor the sc instruction, the differences from the ELF ABI are as follows:}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK4hjhhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j>hj;ubj?)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j>hj;ubj?)}(hhh]h}(h]h ]h"]h$]h&]colwidthK)uh1j>hj;ubhthead)}(hhh]hrow)}(hhh](hentry)}(hhh]h)}(hRegisterh]hRegister}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK7hjjubah}(h]h ]h"]h$]h&]uh1jhhjeubji)}(hhh]h)}(hPreservation Rulesh]hPreservation Rules}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK7hjubah}(h]h ]h"]h$]h&]uh1jhhjeubji)}(hhh]h)}(hPurposeh]hPurpose}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK7hjubah}(h]h ]h"]h$]h&]uh1jhhjeubeh}(h]h ]h"]h$]h&]uh1jchj`ubah}(h]h ]h"]h$]h&]uh1j^hj;ubhtbody)}(hhh](jd)}(hhh](ji)}(hhh]h)}(hr0h]hr0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(hVolatileh]hVolatile}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(h(System call number.)h]h(System call number.)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjubah}(h]h ]h"]h$]h&]uh1jhhjubeh}(h]h ]h"]h$]h&]uh1jchjubjd)}(hhh](ji)}(hhh]h)}(hr3h]hr3}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(hVolatileh]hVolatile}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hj(ubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(h (Parameter 1, and return value.)h]h (Parameter 1, and return value.)}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hj?ubah}(h]h ]h"]h$]h&]uh1jhhjubeh}(h]h ]h"]h$]h&]uh1jchjubjd)}(hhh](ji)}(hhh]h)}(hr4-r8h]hr4-r8}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hj_ubah}(h]h ]h"]h$]h&]uh1jhhj\ubji)}(hhh]h)}(hVolatileh]hVolatile}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hjvubah}(h]h ]h"]h$]h&]uh1jhhj\ubji)}(hhh]h)}(h(Parameters 2-6.)h]h(Parameters 2-6.)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hjubah}(h]h ]h"]h$]h&]uh1jhhj\ubeh}(h]h ]h"]h$]h&]uh1jchjubjd)}(hhh](ji)}(hhh]h)}(hcr0h]hcr0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(hVolatileh]hVolatile}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(h'(cr0.SO is the return error condition.)h]h'(cr0.SO is the return error condition.)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjubah}(h]h ]h"]h$]h&]uh1jhhjubeh}(h]h ]h"]h$]h&]uh1jchjubjd)}(hhh](ji)}(hhh]h)}(h cr1, cr5-7h]h cr1, cr5-7}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(h Nonvolatileh]h Nonvolatile}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h}(h]h ]h"]h$]h&]uh1jhhjubeh}(h]h ]h"]h$]h&]uh1jchjubjd)}(hhh](ji)}(hhh]h)}(hlrh]hlr}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChj;ubah}(h]h ]h"]h$]h&]uh1jhhj8ubji)}(hhh]h)}(h Nonvolatileh]h Nonvolatile}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChjRubah}(h]h ]h"]h$]h&]uh1jhhj8ubji)}(hhh]h}(h]h ]h"]h$]h&]uh1jhhj8ubeh}(h]h ]h"]h$]h&]uh1jchjubeh}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]colsKuh1j9hj6ubah}(h]h ]h"]h$]h&]uh1j4hjhhhhhNubh)}(hKFor the scv 0 instruction, the differences from the ELF ABI are as follows:h]hKFor the scv 0 instruction, the differences from the ELF ABI are as follows:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhjhhubj5)}(hhh]j:)}(hhh](j?)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j>hjubj?)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j>hjubj?)}(hhh]h}(h]h ]h"]h$]h&]colwidthK)uh1j>hjubj_)}(hhh]jd)}(hhh](ji)}(hhh]h)}(hRegisterh]hRegister}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(hPreservation Rulesh]hPreservation Rules}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(hPurposeh]hPurpose}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjubah}(h]h ]h"]h$]h&]uh1jhhjubeh}(h]h ]h"]h$]h&]uh1jchjubah}(h]h ]h"]h$]h&]uh1j^hjubj)}(hhh](jd)}(hhh](ji)}(hhh]h)}(hr0h]hr0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(hVolatileh]hVolatile}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhj1ubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(h(System call number.)h]h(System call number.)}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhjHubah}(h]h ]h"]h$]h&]uh1jhhjubeh}(h]h ]h"]h$]h&]uh1jchjubjd)}(hhh](ji)}(hhh]h)}(hr3h]hr3}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjhubah}(h]h ]h"]h$]h&]uh1jhhjeubji)}(hhh]h)}(hVolatileh]hVolatile}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjubah}(h]h ]h"]h$]h&]uh1jhhjeubji)}(hhh]h)}(h (Parameter 1, and return value.)h]h (Parameter 1, and return value.)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjubah}(h]h ]h"]h$]h&]uh1jhhjeubeh}(h]h ]h"]h$]h&]uh1jchjubjd)}(hhh](ji)}(hhh]h)}(hr4-r8h]hr4-r8}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(hVolatileh]hVolatile}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(h(Parameters 2-6.)h]h(Parameters 2-6.)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjubah}(h]h ]h"]h$]h&]uh1jhhjubeh}(h]h ]h"]h$]h&]uh1jchjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1j9hjubah}(h]h ]h"]h$]h&]uh1j4hjhhhhhNubh)}(heAll floating point and vector data registers as well as control and status registers are nonvolatile.h]heAll floating point and vector data registers as well as control and status registers are nonvolatile.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjhhubeh}(h]register-preservation-rulesah ]h"]h$]register preservation rulesah&]uh1hhhhhhhhK0jRKubh)}(hhh](h)}(hTransactional Memoryh]hTransactional Memory}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hhhhhKVubh)}(hSyscall behavior can change if the processor is in transactional or suspended transaction state, and the syscall can affect the behavior of the transaction.h]hSyscall behavior can change if the processor is in transactional or suspended transaction state, and the syscall can affect the behavior of the transaction.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhj*hhubh)}(hX_If the processor is in suspended state when a syscall is made, the syscall will be performed as normal, and will return as normal. The syscall will be performed in suspended state, so its side effects will be persistent according to the usual transactional memory semantics. A syscall may or may not result in the transaction being doomed by hardware.h]hX_If the processor is in suspended state when a syscall is made, the syscall will be performed as normal, and will return as normal. The syscall will be performed in suspended state, so its side effects will be persistent according to the usual transactional memory semantics. A syscall may or may not result in the transaction being doomed by hardware.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKZhj*hhubh)}(hIf the processor is in transactional state when a syscall is made, then the behavior depends on the presence of PPC_FEATURE2_HTM_NOSC in the AT_HWCAP2 ELF auxiliary vector.h]hIf the processor is in transactional state when a syscall is made, then the behavior depends on the presence of PPC_FEATURE2_HTM_NOSC in the AT_HWCAP2 ELF auxiliary vector.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK`hj*hhubj)}(hhh](j)}(hIf present, which is the case for newer kernels, then the syscall will not be performed and the transaction will be doomed by the kernel with the failure code TM_CAUSE_SYSCALL | TM_CAUSE_PERSISTENT in the TEXASR SPR. h]h)}(hIf present, which is the case for newer kernels, then the syscall will not be performed and the transaction will be doomed by the kernel with the failure code TM_CAUSE_SYSCALL | TM_CAUSE_PERSISTENT in the TEXASR SPR.h]hIf present, which is the case for newer kernels, then the syscall will not be performed and the transaction will be doomed by the kernel with the failure code TM_CAUSE_SYSCALL | TM_CAUSE_PERSISTENT in the TEXASR SPR.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKdhjhubah}(h]h ]h"]h$]h&]uh1jhjehhhhhNubj)}(hX?If not present (older kernels), then the kernel will suspend the transactional state and the syscall will proceed as in the case of a suspended state syscall, and will resume the transactional state before returning to the caller. This case is not well defined or supported, so this behavior should not be relied upon. h]h)}(hX>If not present (older kernels), then the kernel will suspend the transactional state and the syscall will proceed as in the case of a suspended state syscall, and will resume the transactional state before returning to the caller. This case is not well defined or supported, so this behavior should not be relied upon.h]hX>If not present (older kernels), then the kernel will suspend the transactional state and the syscall will proceed as in the case of a suspended state syscall, and will resume the transactional state before returning to the caller. This case is not well defined or supported, so this behavior should not be relied upon.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhjubah}(h]h ]h"]h$]h&]uh1jhjehhhhhNubeh}(h]h ]h"]h$]h&]jjuh1jhhhKdhj*hhubh)}(h;scv 0 syscalls will always behave as PPC_FEATURE2_HTM_NOSC.h]h;scv 0 syscalls will always behave as PPC_FEATURE2_HTM_NOSC.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhj*hhubeh}(h]transactional-memoryah ]h"]h$]transactional memoryah&]uh1hhhhhhhhKVjRKubh)}(hhh](h)}(hptraceh]hptrace}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKqubh)}(hWhen ptracing system calls (PTRACE_SYSCALL), the pt_regs.trap value contains the system call type that can be used to distinguish between sc and scv 0 system calls, and the different register conventions can be accounted for.h]hWhen ptracing system calls (PTRACE_SYSCALL), the pt_regs.trap value contains the system call type that can be used to distinguish between sc and scv 0 system calls, and the different register conventions can be accounted for.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjhhubh)}(hIf the value of (pt_regs.trap & 0xfff0) is 0xc00 then the system call was performed with the sc instruction, if it is 0x3000 then the system call was performed with the scv 0 instruction.h]hIf the value of (pt_regs.trap & 0xfff0) is 0xc00 then the system call was performed with the sc instruction, if it is 0x3000 then the system call was performed with the scv 0 instruction.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKvhjhhubeh}(h]ptraceah ]h"]ptraceah$]h&]uh1hhhhhhhhKqubeh}(h]syscallah ]h"]syscallah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hvsyscallh]hvsyscall}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK{ubh)}(hvsyscall calling sequence matches the syscall calling sequence, with the following differences. Some vsyscalls may have different calling sequences.h]hvsyscall calling sequence matches the syscall calling sequence, with the following differences. Some vsyscalls may have different calling sequences.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK}hjhhubh)}(hhh](h)}(hParameters and return valueh]hParameters and return value}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hDr0 is not used as an input. The vsyscall is selected by its address.h]hDr0 is not used as an input. The vsyscall is selected by its address.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]parameters-and-return-valueah ]h"]parameters and return valueah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hStackh]hStack}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7hhhhhKubh)}(hDThe vsyscall may or may not use the caller's stack frame save areas.h]hFThe vsyscall may or may not use the caller’s stack frame save areas.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj7hhubeh}(h]id3ah ]h"]h$]jah&]uh1hhjhhhhhKjRKubh)}(hhh](h)}(hRegister preservation rulesh]hRegister preservation rules}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hhhhhKubj5)}(hhh]j:)}(hhh](j?)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1j>hjqubj?)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j>hjqubj)}(hhh](jd)}(hhh](ji)}(hhh]h)}(hr0h]hr0}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(hVolatileh]hVolatile}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhjubeh}(h]h ]h"]h$]h&]uh1jchjubjd)}(hhh](ji)}(hhh]h)}(h cr1, cr5-7h]h cr1, cr5-7}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(hVolatileh]hVolatile}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhjubeh}(h]h ]h"]h$]h&]uh1jchjubjd)}(hhh](ji)}(hhh]h)}(hlrh]hlr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhjubji)}(hhh]h)}(hVolatileh]hVolatile}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhjubeh}(h]h ]h"]h$]h&]uh1jchjubeh}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]colsKuh1j9hjnubah}(h]h ]h"]h$]h&]uh1j4hj]hhhhhNubeh}(h]id4ah ]h"]h$]j(ah&]uh1hhjhhhhhKjRKubh)}(hhh](h)}(h Invocationh]h Invocation}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJhhhhhKubh)}(h_The vsyscall is performed with a branch-with-link instruction to the vsyscall function address.h]h_The vsyscall is performed with a branch-with-link instruction to the vsyscall function address.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjJhhubeh}(h]id5ah ]h"]h$]jPah&]uh1hhjhhhhhKjRKubh)}(hhh](h)}(hTransactional Memoryh]hTransactional Memory}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjphhhhhKubh)}(hvsyscalls will run in the same transactional state as the caller. A vsyscall may or may not result in the transaction being doomed by hardware.h]hvsyscalls will run in the same transactional state as the caller. A vsyscall may or may not result in the transaction being doomed by hardware.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjphhubeh}(h]id6ah ]h"]h$]jah&]uh1hhjhhhhhKjRKubeh}(h]vsyscallah ]h"]vsyscallah$]h&]uh1hhhhhhhhK{ubeh}(h]/power-architecture-64-bit-linux-system-call-abiah ]h"]/power architecture 64-bit linux system call abiah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjhfootnote_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}1]jasrefids}nameids}(jjjj invocationNjGjjjjjstackNregister preservation rulesNtransactional memoryNjjjjj4j1u nametypes}(jjj jGjjj j j jjj4uh}(jhjhjLhj jjj!jjSjjjjj$jjj*jjjjj1jjXj7jEj]jkjJjjpu footnote_refs}j ]jas citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes]j!a citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jKsRparse_messages](hsystem_message)}(hhh]h)}(h(Duplicate implicit target name: "stack".h]h,Duplicate implicit target name: “stack”.}(hj6 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3 ubah}(h]h ]h"]h$]h&]jXalevelKtypeINFOsourcehlineKuh1j1 hj7hhhhhKubj2 )}(hhh]h)}(h>Duplicate implicit target name: "register preservation rules".h]hBDuplicate implicit target name: “register preservation rules”.}(hjR hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjO ubah}(h]h ]h"]h$]h&]jEalevelKtypejL sourcehlineKuh1j1 hj]hhhhhKubj2 )}(hhh]h)}(h-Duplicate implicit target name: "invocation".h]h1Duplicate implicit target name: “invocation”.}(hjm hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjj ubah}(h]h ]h"]h$]h&]jkalevelKtypejL sourcehlineKuh1j1 hjJhhhhhKubj2 )}(hhh]h)}(h7Duplicate implicit target name: "transactional memory".h]h;Duplicate implicit target name: “transactional memory”.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]jalevelKtypejL sourcehlineKuh1j1 hjphhhhhKubetransform_messages] transformerN include_log] decorationNhhub.