]>
Commit | Line | Data |
---|---|---|
7b8845a2 NP |
1 | =============================================== |
2 | Power Architecture 64-bit Linux system call ABI | |
3 | =============================================== | |
4 | ||
5 | syscall | |
6 | ======= | |
7 | ||
7fa95f9a NP |
8 | Invocation |
9 | ---------- | |
10 | The syscall is made with the sc instruction, and returns with execution | |
11 | continuing at the instruction following the sc instruction. | |
12 | ||
13 | If PPC_FEATURE2_SCV appears in the AT_HWCAP2 ELF auxiliary vector, the | |
14 | scv 0 instruction is an alternative that may provide better performance, | |
15 | with some differences to calling sequence. | |
16 | ||
4d2e26a3 | 17 | syscall calling sequence\ [1]_ matches the Power Architecture 64-bit ELF ABI |
7b8845a2 NP |
18 | specification C function calling sequence, including register preservation |
19 | rules, with the following differences. | |
20 | ||
4d2e26a3 MCC |
21 | .. [1] Some syscalls (typically low-level management functions) may have |
22 | different calling sequences (e.g., rt_sigreturn). | |
7b8845a2 | 23 | |
7fa95f9a NP |
24 | Parameters |
25 | ---------- | |
7b8845a2 NP |
26 | The system call number is specified in r0. |
27 | ||
28 | There is a maximum of 6 integer parameters to a syscall, passed in r3-r8. | |
29 | ||
7fa95f9a NP |
30 | Return value |
31 | ------------ | |
32 | - For the sc instruction, both a value and an error condition are returned. | |
33 | cr0.SO is the error condition, and r3 is the return value. When cr0.SO is | |
34 | clear, the syscall succeeded and r3 is the return value. When cr0.SO is set, | |
35 | the syscall failed and r3 is the error value (that normally corresponds to | |
36 | errno). | |
37 | ||
38 | - For the scv 0 instruction, the return value indicates failure if it is | |
39 | -4095..-1 (i.e., it is >= -MAX_ERRNO (-4095) as an unsigned comparison), | |
40 | in which case the error value is the negated return value. | |
7b8845a2 NP |
41 | |
42 | Stack | |
43 | ----- | |
44 | System calls do not modify the caller's stack frame. For example, the caller's | |
45 | stack frame LR and CR save fields are not used. | |
46 | ||
47 | Register preservation rules | |
48 | --------------------------- | |
49 | Register preservation rules match the ELF ABI calling sequence with the | |
50 | following differences: | |
51 | ||
209b44c8 MCC |
52 | +------------------------------------------------------------------------+ |
53 | | For the sc instruction, differences with the ELF ABI | | |
54 | +--------------+--------------+------------------------------------------+ | |
55 | | r0 | Volatile | (System call number.) | | |
56 | | rr3 | Volatile | (Parameter 1, and return value.) | | |
57 | | rr4-r8 | Volatile | (Parameters 2-6.) | | |
58 | | rcr0 | Volatile | (cr0.SO is the return error condition.) | | |
59 | | rcr1, cr5-7 | Nonvolatile | | | |
60 | | rlr | Nonvolatile | | | |
61 | +--------------+--------------+------------------------------------------+ | |
62 | | For the scv 0 instruction, differences with the ELF ABI | | |
63 | +--------------+--------------+------------------------------------------+ | |
64 | | r0 | Volatile | (System call number.) | | |
65 | | r3 | Volatile | (Parameter 1, and return value.) | | |
66 | | r4-r8 | Volatile | (Parameters 2-6.) | | |
67 | +--------------+--------------+------------------------------------------+ | |
7b8845a2 NP |
68 | |
69 | All floating point and vector data registers as well as control and status | |
70 | registers are nonvolatile. | |
71 | ||
7b8845a2 NP |
72 | Transactional Memory |
73 | -------------------- | |
74 | Syscall behavior can change if the processor is in transactional or suspended | |
75 | transaction state, and the syscall can affect the behavior of the transaction. | |
76 | ||
77 | If the processor is in suspended state when a syscall is made, the syscall | |
78 | will be performed as normal, and will return as normal. The syscall will be | |
79 | performed in suspended state, so its side effects will be persistent according | |
80 | to the usual transactional memory semantics. A syscall may or may not result | |
81 | in the transaction being doomed by hardware. | |
82 | ||
83 | If the processor is in transactional state when a syscall is made, then the | |
84 | behavior depends on the presence of PPC_FEATURE2_HTM_NOSC in the AT_HWCAP2 ELF | |
85 | auxiliary vector. | |
86 | ||
87 | - If present, which is the case for newer kernels, then the syscall will not | |
88 | be performed and the transaction will be doomed by the kernel with the | |
89 | failure code TM_CAUSE_SYSCALL | TM_CAUSE_PERSISTENT in the TEXASR SPR. | |
90 | ||
91 | - If not present (older kernels), then the kernel will suspend the | |
92 | transactional state and the syscall will proceed as in the case of a | |
93 | suspended state syscall, and will resume the transactional state before | |
94 | returning to the caller. This case is not well defined or supported, so this | |
95 | behavior should not be relied upon. | |
96 | ||
7fa95f9a | 97 | scv 0 syscalls will always behave as PPC_FEATURE2_HTM_NOSC. |
7b8845a2 NP |
98 | |
99 | vsyscall | |
100 | ======== | |
101 | ||
102 | vsyscall calling sequence matches the syscall calling sequence, with the | |
103 | following differences. Some vsyscalls may have different calling sequences. | |
104 | ||
105 | Parameters and return value | |
106 | --------------------------- | |
107 | r0 is not used as an input. The vsyscall is selected by its address. | |
108 | ||
109 | Stack | |
110 | ----- | |
111 | The vsyscall may or may not use the caller's stack frame save areas. | |
112 | ||
113 | Register preservation rules | |
114 | --------------------------- | |
4d2e26a3 MCC |
115 | |
116 | =========== ======== | |
117 | r0 Volatile | |
118 | cr1, cr5-7 Volatile | |
119 | lr Volatile | |
120 | =========== ======== | |
7b8845a2 NP |
121 | |
122 | Invocation | |
123 | ---------- | |
124 | The vsyscall is performed with a branch-with-link instruction to the vsyscall | |
125 | function address. | |
126 | ||
127 | Transactional Memory | |
128 | -------------------- | |
129 | vsyscalls will run in the same transactional state as the caller. A vsyscall | |
130 | may or may not result in the transaction being doomed by hardware. |