| 1 |
Chinese translated version of Documentation/arch/arm/kernel_user_helpers.rst |
| 2 |
|
| 3 |
If you have any comment or update to the content, please contact the |
| 4 |
original document maintainer directly. However, if you have a problem |
| 5 |
communicating in English you can also ask the Chinese maintainer for |
| 6 |
help. Contact the Chinese maintainer if this translation is outdated |
| 7 |
or if there is a problem with the translation. |
| 8 |
|
| 9 |
Maintainer: Nicolas Pitre <[email protected]> |
| 10 |
Dave Martin <[email protected]> |
| 11 |
Chinese maintainer: Fu Wei <[email protected]> |
| 12 |
--------------------------------------------------------------------- |
| 13 |
Documentation/arch/arm/kernel_user_helpers.rst 的中文翻譯 |
| 14 |
|
| 15 |
如果想評論或更新本文的內容,請直接聯繫原文檔的維護者。如果你使用英文 |
| 16 |
交流有困難的話,也可以向中文版維護者求助。如果本翻譯更新不及時或者翻 |
| 17 |
譯存在問題,請聯繫中文版維護者。 |
| 18 |
英文版維護者: Nicolas Pitre <[email protected]> |
| 19 |
Dave Martin <[email protected]> |
| 20 |
中文版維護者: 傅煒 Fu Wei <[email protected]> |
| 21 |
中文版翻譯者: 傅煒 Fu Wei <[email protected]> |
| 22 |
中文版校譯者: 宋冬生 Dongsheng Song <[email protected]> |
| 23 |
傅煒 Fu Wei <[email protected]> |
| 24 |
|
| 25 |
|
| 26 |
以下爲正文 |
| 27 |
--------------------------------------------------------------------- |
| 28 |
內核提供的用戶空間輔助代碼 |
| 29 |
========================= |
| 30 |
|
| 31 |
在內核內存空間的固定地址處,有一個由內核提供並可從用戶空間訪問的代碼 |
| 32 |
段。它用於向用戶空間提供因在許多 ARM CPU 中未實現的特性和/或指令而需 |
| 33 |
內核提供幫助的某些操作。這些代碼直接在用戶模式下執行的想法是爲了獲得 |
| 34 |
最佳效率,但那些與內核計數器聯繫過於緊密的部分,則被留給了用戶庫實現。 |
| 35 |
事實上,此代碼甚至可能因不同的 CPU 而異,這取決於其可用的指令集或它 |
| 36 |
是否爲 SMP 系統。換句話說,內核保留在不作出警告的情況下根據需要更改 |
| 37 |
這些代碼的權利。只有本文檔描述的入口及其結果是保證穩定的。 |
| 38 |
|
| 39 |
這與完全成熟的 VDSO 實現不同(但兩者並不衝突),儘管如此,VDSO 可阻止 |
| 40 |
某些通過常量高效跳轉到那些代碼段的彙編技巧。且由於那些代碼段在返回用戶 |
| 41 |
代碼前僅使用少量的代碼週期,則一個 VDSO 間接遠程調用將會在這些簡單的 |
| 42 |
操作上增加一個可測量的開銷。 |
| 43 |
|
| 44 |
在對那些擁有原生支持的新型處理器進行代碼優化時,僅在已爲其他操作使用 |
| 45 |
了類似的新增指令,而導致二進制結果已與早期 ARM 處理器不兼容的情況下, |
| 46 |
用戶空間才應繞過這些輔助代碼,並在內聯函數中實現這些操作(無論是通過 |
| 47 |
編譯器在代碼中直接放置,還是作爲庫函數調用實現的一部分)。也就是說, |
| 48 |
如果你編譯的代碼不會爲了其他目的使用新指令,則不要僅爲了避免使用這些 |
| 49 |
內核輔助代碼,導致二進制程序無法在早期處理器上運行。 |
| 50 |
|
| 51 |
新的輔助代碼可能隨着時間的推移而增加,所以新內核中的某些輔助代碼在舊 |
| 52 |
內核中可能不存在。因此,程序必須在對任何輔助代碼調用假設是安全之前, |
| 53 |
檢測 __kuser_helper_version 的值(見下文)。理想情況下,這種檢測應該 |
| 54 |
只在進程啓動時執行一次;如果內核版本不支持所需輔助代碼,則該進程可儘早 |
| 55 |
中止執行。 |
| 56 |
|
| 57 |
kuser_helper_version |
| 58 |
-------------------- |
| 59 |
|
| 60 |
位置: 0xffff0ffc |
| 61 |
|
| 62 |
參考聲明: |
| 63 |
|
| 64 |
extern int32_t __kuser_helper_version; |
| 65 |
|
| 66 |
定義: |
| 67 |
|
| 68 |
這個區域包含了當前運行內核實現的輔助代碼版本號。用戶空間可以通過讀 |
| 69 |
取此版本號以確定特定的輔助代碼是否存在。 |
| 70 |
|
| 71 |
使用範例: |
| 72 |
|
| 73 |
#define __kuser_helper_version (*(int32_t *)0xffff0ffc) |
| 74 |
|
| 75 |
void check_kuser_version(void) |
| 76 |
{ |
| 77 |
if (__kuser_helper_version < 2) { |
| 78 |
fprintf(stderr, "can't do atomic operations, kernel too old\n"); |
| 79 |
abort(); |
| 80 |
} |
| 81 |
} |
| 82 |
|
| 83 |
注意: |
| 84 |
|
| 85 |
用戶空間可以假設這個域的值不會在任何單個進程的生存期內改變。也就 |
| 86 |
是說,這個域可以僅在庫的初始化階段或進程啓動階段讀取一次。 |
| 87 |
|
| 88 |
kuser_get_tls |
| 89 |
------------- |
| 90 |
|
| 91 |
位置: 0xffff0fe0 |
| 92 |
|
| 93 |
參考原型: |
| 94 |
|
| 95 |
void * __kuser_get_tls(void); |
| 96 |
|
| 97 |
輸入: |
| 98 |
|
| 99 |
lr = 返回地址 |
| 100 |
|
| 101 |
輸出: |
| 102 |
|
| 103 |
r0 = TLS 值 |
| 104 |
|
| 105 |
被篡改的寄存器: |
| 106 |
|
| 107 |
無 |
| 108 |
|
| 109 |
定義: |
| 110 |
|
| 111 |
獲取之前通過 __ARM_NR_set_tls 系統調用設置的 TLS 值。 |
| 112 |
|
| 113 |
使用範例: |
| 114 |
|
| 115 |
typedef void * (__kuser_get_tls_t)(void); |
| 116 |
#define __kuser_get_tls (*(__kuser_get_tls_t *)0xffff0fe0) |
| 117 |
|
| 118 |
void foo() |
| 119 |
{ |
| 120 |
void *tls = __kuser_get_tls(); |
| 121 |
printf("TLS = %p\n", tls); |
| 122 |
} |
| 123 |
|
| 124 |
注意: |
| 125 |
|
| 126 |
- 僅在 __kuser_helper_version >= 1 時,此輔助代碼存在 |
| 127 |
(從內核版本 2.6.12 開始)。 |
| 128 |
|
| 129 |
kuser_cmpxchg |
| 130 |
------------- |
| 131 |
|
| 132 |
位置: 0xffff0fc0 |
| 133 |
|
| 134 |
參考原型: |
| 135 |
|
| 136 |
int __kuser_cmpxchg(int32_t oldval, int32_t newval, volatile int32_t *ptr); |
| 137 |
|
| 138 |
輸入: |
| 139 |
|
| 140 |
r0 = oldval |
| 141 |
r1 = newval |
| 142 |
r2 = ptr |
| 143 |
lr = 返回地址 |
| 144 |
|
| 145 |
輸出: |
| 146 |
|
| 147 |
r0 = 成功代碼 (零或非零) |
| 148 |
C flag = 如果 r0 == 0 則置 1,如果 r0 != 0 則清零。 |
| 149 |
|
| 150 |
被篡改的寄存器: |
| 151 |
|
| 152 |
r3, ip, flags |
| 153 |
|
| 154 |
定義: |
| 155 |
|
| 156 |
僅在 *ptr 爲 oldval 時原子保存 newval 於 *ptr 中。 |
| 157 |
如果 *ptr 被改變,則返回值爲零,否則爲非零值。 |
| 158 |
如果 *ptr 被改變,則 C flag 也會被置 1,以實現調用代碼中的彙編 |
| 159 |
優化。 |
| 160 |
|
| 161 |
使用範例: |
| 162 |
|
| 163 |
typedef int (__kuser_cmpxchg_t)(int oldval, int newval, volatile int *ptr); |
| 164 |
#define __kuser_cmpxchg (*(__kuser_cmpxchg_t *)0xffff0fc0) |
| 165 |
|
| 166 |
int atomic_add(volatile int *ptr, int val) |
| 167 |
{ |
| 168 |
int old, new; |
| 169 |
|
| 170 |
do { |
| 171 |
old = *ptr; |
| 172 |
new = old + val; |
| 173 |
} while(__kuser_cmpxchg(old, new, ptr)); |
| 174 |
|
| 175 |
return new; |
| 176 |
} |
| 177 |
|
| 178 |
注意: |
| 179 |
|
| 180 |
- 這個例程已根據需要包含了內存屏障。 |
| 181 |
|
| 182 |
- 僅在 __kuser_helper_version >= 2 時,此輔助代碼存在 |
| 183 |
(從內核版本 2.6.12 開始)。 |
| 184 |
|
| 185 |
kuser_memory_barrier |
| 186 |
-------------------- |
| 187 |
|
| 188 |
位置: 0xffff0fa0 |
| 189 |
|
| 190 |
參考原型: |
| 191 |
|
| 192 |
void __kuser_memory_barrier(void); |
| 193 |
|
| 194 |
輸入: |
| 195 |
|
| 196 |
lr = 返回地址 |
| 197 |
|
| 198 |
輸出: |
| 199 |
|
| 200 |
無 |
| 201 |
|
| 202 |
被篡改的寄存器: |
| 203 |
|
| 204 |
無 |
| 205 |
|
| 206 |
定義: |
| 207 |
|
| 208 |
應用於任何需要內存屏障以防止手動數據修改帶來的一致性問題,以及 |
| 209 |
__kuser_cmpxchg 中。 |
| 210 |
|
| 211 |
使用範例: |
| 212 |
|
| 213 |
typedef void (__kuser_dmb_t)(void); |
| 214 |
#define __kuser_dmb (*(__kuser_dmb_t *)0xffff0fa0) |
| 215 |
|
| 216 |
注意: |
| 217 |
|
| 218 |
- 僅在 __kuser_helper_version >= 3 時,此輔助代碼存在 |
| 219 |
(從內核版本 2.6.15 開始)。 |
| 220 |
|
| 221 |
kuser_cmpxchg64 |
| 222 |
--------------- |
| 223 |
|
| 224 |
位置: 0xffff0f60 |
| 225 |
|
| 226 |
參考原型: |
| 227 |
|
| 228 |
int __kuser_cmpxchg64(const int64_t *oldval, |
| 229 |
const int64_t *newval, |
| 230 |
volatile int64_t *ptr); |
| 231 |
|
| 232 |
輸入: |
| 233 |
|
| 234 |
r0 = 指向 oldval |
| 235 |
r1 = 指向 newval |
| 236 |
r2 = 指向目標值 |
| 237 |
lr = 返回地址 |
| 238 |
|
| 239 |
輸出: |
| 240 |
|
| 241 |
r0 = 成功代碼 (零或非零) |
| 242 |
C flag = 如果 r0 == 0 則置 1,如果 r0 != 0 則清零。 |
| 243 |
|
| 244 |
被篡改的寄存器: |
| 245 |
|
| 246 |
r3, lr, flags |
| 247 |
|
| 248 |
定義: |
| 249 |
|
| 250 |
僅在 *ptr 等於 *oldval 指向的 64 位值時,原子保存 *newval |
| 251 |
指向的 64 位值於 *ptr 中。如果 *ptr 被改變,則返回值爲零, |
| 252 |
否則爲非零值。 |
| 253 |
|
| 254 |
如果 *ptr 被改變,則 C flag 也會被置 1,以實現調用代碼中的彙編 |
| 255 |
優化。 |
| 256 |
|
| 257 |
使用範例: |
| 258 |
|
| 259 |
typedef int (__kuser_cmpxchg64_t)(const int64_t *oldval, |
| 260 |
const int64_t *newval, |
| 261 |
volatile int64_t *ptr); |
| 262 |
#define __kuser_cmpxchg64 (*(__kuser_cmpxchg64_t *)0xffff0f60) |
| 263 |
|
| 264 |
int64_t atomic_add64(volatile int64_t *ptr, int64_t val) |
| 265 |
{ |
| 266 |
int64_t old, new; |
| 267 |
|
| 268 |
do { |
| 269 |
old = *ptr; |
| 270 |
new = old + val; |
| 271 |
} while(__kuser_cmpxchg64(&old, &new, ptr)); |
| 272 |
|
| 273 |
return new; |
| 274 |
} |
| 275 |
|
| 276 |
注意: |
| 277 |
|
| 278 |
- 這個例程已根據需要包含了內存屏障。 |
| 279 |
|
| 280 |
- 由於這個過程的代碼長度(此輔助代碼跨越 2 個常規的 kuser “槽”), |
| 281 |
因此 0xffff0f80 不被作爲有效的入口點。 |
| 282 |
|
| 283 |
- 僅在 __kuser_helper_version >= 5 時,此輔助代碼存在 |
| 284 |
(從內核版本 3.1 開始)。 |
| 285 |
|