summaryrefslogtreecommitdiffstats
path: root/Documentation/translations/zh_TW/admin-guide/sysrq.rst
blob: 4a08db00a495269cac47f8960be4752ab62d27c2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
.. include:: ../disclaimer-zh_TW.rst

:Original: Documentation/admin-guide/sysrq.rst

:翻譯:

 黃軍華 Junhua Huang <huang.junhua@zte.com.cn>

:校譯:

 司延騰 Yanteng Si <siyanteng@loongson.cn>

.. _tw_admin-guide_sysrq:

Linux 魔法系統請求鍵駭客
========================

針對 sysrq.c 的文檔說明

什麼是魔法 SysRq 鍵?
~~~~~~~~~~~~~~~~~~~~~

它是一個你可以輸入的具有魔法般的組合鍵。
無論內核在做什麼,內核都會響應 SysRq 鍵的輸入,除非內核完全卡死。

如何使能魔法 SysRq 鍵?
~~~~~~~~~~~~~~~~~~~~~~~

在配置內核時,我們需要設置 'Magic SysRq key (CONFIG_MAGIC_SYSRQ)' 爲 'Y'。
當運行一個編譯進 sysrq 功能的內核時,/proc/sys/kernel/sysrq 控制着被
SysRq 鍵調用的功能許可。這個文件的默認值由 CONFIG_MAGIC_SYSRQ_DEFAULT_ENABLE
配置符號設定,文件本身默認設置爲 1。以下是 /proc/sys/kernel/sysrq 中可能的
值列表:

   -  0 - 完全不使能 SysRq 鍵
   -  1 - 使能 SysRq 鍵的全部功能
   - >1 - 對於允許的 SysRq 鍵功能的比特掩碼(參見下面更詳細的功能描述)::

          2 =   0x2 - 使能對控制檯日誌記錄級別的控制
          4 =   0x4 - 使能對鍵盤的控制 (SAK, unraw)
          8 =   0x8 - 使能對進程的調試導出等
         16 =  0x10 - 使能同步命令
         32 =  0x20 - 使能重新掛載只讀
         64 =  0x40 - 使能對進程的信號操作 (term, kill, oom-kill)
        128 =  0x80 - 允許重啓、斷電
        256 = 0x100 - 允許讓所有實時任務變普通任務

你可以通過如下命令把值設置到這個文件中::

    echo "number" >/proc/sys/kernel/sysrq

這裏被寫入的 number 可以是 10 進制數,或者是帶着 0x 前綴的 16 進制數。
CONFIG_MAGIC_SYSRQ_DEFAULT_ENABLE 必須是以 16 進制數寫入。

注意,``/proc/sys/kernel/sysrq`` 的值隻影響通過鍵盤觸發 SySRq 的調用,對於
通過 ``/proc/sysrq-trigger`` 的任何操作調用都是允許的
(通過具有系統權限的用戶)。

如何使用魔法 SysRq 鍵?
~~~~~~~~~~~~~~~~~~~~~~~

在 x86 架構上
	你可以按下鍵盤組合鍵 :kbd:`ALT-SysRq-<command key>`。

	.. note::
	   一些鍵盤可能沒有標識 'SySRq' 鍵。'SySRq' 鍵也被當做 'Print Screen'鍵。
	   同時有些鍵盤無法處理同時按下這麼多鍵,因此你可以先按下鍵盤 :kbd:`Alt` 鍵,
	   然後按下鍵盤 :kbd:`SysRq` 鍵,再釋放鍵盤 :kbd:`SysRq` 鍵,之後按下鍵盤上命令鍵
	   :kbd:`<command key>`,最後釋放所有鍵。

在 SPARC 架構上
	你可以按下鍵盤組合鍵 :kbd:`ALT-STOP-<command key>` 。

在串行控制檯(只針對 PC 類型的標準串口)
        你可以發一個 ``BREAK`` ,然後在 5 秒內發送一個命令鍵,
	發送 ``BREAK`` 兩次將被翻譯爲一個正常的 BREAK 操作。

在 PowerPC 架構上
	按下鍵盤組合鍵 :kbd:`ALT - Print Screen` (或者 :kbd:`F13`) - :kbd:`<命令鍵>`:kbd:`Print Screen` (或者 :kbd:`F13`) - :kbd:`<命令鍵>` 或許也能實現。

在其他架構上
	如果你知道其他架構的組合鍵,請告訴我,我可以把它們添加到這部分。

在所有架構上
	寫一個字符到 /proc/sysrq-trigger 文件,例如::

		echo t > /proc/sysrq-trigger

這個命令鍵 :kbd:`<command key>` 是區分大小寫的。

什麼是命令鍵?
~~~~~~~~~~~~~~

=========== ================================================================
命令鍵	    功能
=========== ================================================================
``b``	    將立即重啓系統,不會同步或者卸載磁盤。

``c``	    將執行系統 crash,如果配置了系統 crashdump,將執行 crashdump。

``d``	    顯示所有持有的鎖。

``e``	    發送 SIGTERM 信號給所有進程,除了 init 進程。

``f``	    將調用 oom killer 殺掉一個過度佔用內存的進程,如果什麼任務都沒殺,
            也不會 panic。

``g``	    kgdb 使用(內核調試器)。

``h``	    將會顯示幫助。(實際上除了這裏列舉的鍵,其他的都將顯示幫助,
	    但是 ``h`` 容易記住):-)

``i``	    發送 SIGKILL 給所有進程,除了 init 進程。

``j``	    強制性的 “解凍它” - 用於被 FIFREEZE ioctl 操作凍住的文件系統。

``k``	    安全訪問祕鑰(SAK)殺掉在當前虛擬控制檯的所有程序,注意:參考
            下面 SAK 節重要論述。

``l``	    顯示所有活動 cpu 的棧回溯。

``m``	    將導出當前內存信息到你的控制檯。

``n``	    用於使所有實時任務變成普通任務。

``o``	    將關閉系統(如果配置和支持的話)。

``p``	    將導出當前寄存器和標誌位到控制檯。

``q``	    將導出每個 cpu 上所有已裝備的高精度定時器(不是完整的
            time_list 文件顯示的 timers)和所有時鐘事件設備的詳細信息。

``r``	    關閉鍵盤的原始模式,設置爲轉換模式。

``s``	    將嘗試同步所有的已掛載文件系統。

``t``	    將導出當前所有任務列表和它們的信息到控制檯。

``u``	    將嘗試重新掛載已掛載文件系統爲只讀。

``v``	    強制恢復幀緩存控制檯。
``v``	    觸發 ETM 緩存導出 [ARM 架構特有]

``w``	    導出處於不可中斷狀態(阻塞)的任務。

``x``	    在 ppc/powerpc 架構上用於 xmon 接口。
            在 sparc64 架構上用於顯示全局的 PMU(性能監控單元)寄存器。
            在 MIPS 架構上導出所有的 tlb 條目。

``y``	    顯示全局 cpu 寄存器 [SPARC-64 架構特有]

``z``	    導出 ftrace 緩存信息

``0``-``9`` 設置控制檯日誌級別,該級別控制什麼樣的內核信息將被打印到你的
	    控制檯。(比如 ``0`` ,將使得只有緊急信息,像 PANICs or OOPSes
	    才能到你的控制檯。)
=========== ================================================================

好了,我能用他們做什麼呢?
~~~~~~~~~~~~~~~~~~~~~~~~~~

嗯,當你的 X 服務端或者 svgalib 程序崩潰,unraw(r) 非原始模式命令鍵是非常
方便的。

sak(k)(安全訪問祕鑰)在你嘗試登陸的同時,又想確保當前控制檯沒有可以獲取你的
密碼的特洛伊木馬程序運行時是有用的。它會殺掉給定控制檯的所有程序,這樣你
就可以確認當前的登陸提示程序是實際來自 init 進程的程序,而不是某些特洛伊
木馬程序。

.. important::

   在其實際的形式中,在兼容 C2 安全標準的系統上,它不是一個真正的 SAK,
   它也不應該誤認爲此。

似乎其他人發現其可以作爲(系統終端聯機鍵)當你想退出一個程序,
同時不會讓你切換控制檯的方法。(比如,X 服務端或者 svgalib 程序)

``reboot(b)`` 是個好方法,當你不能關閉機器時,它等同於按下"復位"按鈕。

``crash(c)`` 可以用於手動觸發一個 crashdump,當系統卡住時。
注意當 crashdump 機制不可用時,這個只是觸發一個內核 crash。

``sync(s)`` 在拔掉可移動介質之前,或者在使用不提供優雅關機的
救援 shell 之後很方便 -- 它將確保你的數據被安全地寫入磁盤。注意,在你看到
屏幕上出現 "OK" 和 "Done" 之前,同步還沒有發生。

``umount(u)`` 可以用來標記文件系統正常卸載,從正在運行的系統角度來看,它們將
被重新掛載爲只讀。這個重新掛載動作直到你看到 "OK" 和 "Done" 信息出現在屏幕上
纔算完成。

日誌級別 ``0`` - ``9`` 用於當你的控制檯被大量的內核信息衝擊,你不想看見的時候。
選擇 ``0`` 將禁止除了最緊急的內核信息外的所有的內核信息輸出到控制檯。(但是如果
syslogd/klogd 進程是運行的,它們仍將被記錄。)

``term(e)````kill(i)`` 用於當你有些有點失控的進程,你無法通過其他方式殺掉
它們的時候,特別是它正在創建其他進程。

"just thaw ``it(j)`` " 用於當你的系統由於一個 FIFREEZE ioctl 調用而產生的文件
系統凍結,而導致的不響應時。

有的時候 SysRq 鍵在使用它之後,看起來像是“卡住”了,我能做些什麼?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

這也會發生在我這,我發現輕敲鍵盤兩側的 shift、alt 和 control 鍵,然後再次敲擊
一個無效的 SysRq 鍵序列可以解決問題。(比如,像鍵盤組合鍵 :kbd:`alt-sysrq-z` )
切換到另一個虛擬控制檯(鍵盤操作 :kbd:`ALT+Fn` ),然後再切回來應該也有幫助。

我敲擊了 SysRq 鍵,但像是什麼都沒發生,發生了什麼錯誤?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

有一些鍵盤對於 SysRq 鍵設置了不同的鍵值,而不是提前定義的 99
(查看在 ``include/uapi/linux/input-event-codes.h`` 文件中 ``KEY_SYSRQ`` 的定義)
或者就根本沒有 SysRq 鍵。在這些場景下,執行 ``showkey -s`` 命令來找到一個合適
的掃描碼序列,然後使用 ``setkeycodes <sequence> 99`` 命令映射這個序列值到通用
的 SysRq 鍵編碼上(比如 ``setkeycodes e05b 99`` )。最好將這個命令放在啓動腳本
中。
哦,順便說一句,你十秒鐘不輸入任何東西就將退出 “showkey”。

我想添加一個 SysRq 鍵事件到一個模塊中,如何去做呢?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

爲了註冊一個基礎函數到這個表中,首先你必須包含 ``include/linux/sysrq.h`` 頭
文件,這個頭文件定義了你所需要的所有東西。然後你必須創建一個 ``sysrq_key_op``
結構體,然後初始化它,使用如下內容,A) 你將使用的這個鍵的處理函數, B) 一個
help_msg 字符串,在 SysRq 鍵打印幫助信息時將打印出來,C) 一個 action_msg 字
符串,就在你的處理函數調用前打印出來。你的處理函數必須符合在 'sysrq.h' 文件中
的函數原型。

在 ``sysrq_key_op`` 結構體被創建後,你可以調用內核函數
``register_sysrq_key(int key, const struct sysrq_key_op *op_p);``,
該函數在表中的 'key' 對應位置內容是空的情況下,將通過 ``op_p`` 指針註冊這個操作
函數到表中 'key' 對應位置上。在模塊卸載的時候,你必須調用
``unregister_sysrq_key(int key, const struct sysrq_key_op *op_p)`` 函數,該函數
只有在當前該鍵對應的處理函數被註冊到了 'key' 對應位置時,纔會移除 'op_p' 指針
對應的鍵值操作函數。這是爲了防止在你註冊之後,該位置被改寫的情況。

魔法 SysRq 鍵系統的工作原理是將鍵對應操作函數註冊到鍵的操作查找表,
該表定義在 'drivers/tty/sysrq.c' 文件中。
該鍵表有許多在編譯時候就註冊進去的操作函數,但是是可變的。
並且有兩個函數作爲操作該表的接口被導出::

	register_sysrq_key 和 unregister_sysrq_key.

當然,永遠不要在表中留下無效指針,即,當你的模塊存在調用 register_sysrq_key()
函數,它一定要調用 unregister_sysrq_key() 來清除它使用過的 SysRq 鍵表條目。
表中的空指針是安全的。:)

如果對於某種原因,在 handle_sysrq 調用的處理函數中,你認爲有必要調用
handle_sysrq 函數時,你必須意識到當前你處於一個鎖中(你同時也處於一箇中斷處理
函數中,這意味着不能睡眠)。所以這時你必須使用 ``__handle_sysrq_nolock`` 替代。

當我敲擊一個 SysRq 組合鍵時,只有標題打印出現在控制檯?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

SysRq 鍵的輸出和所有其他控制檯輸出一樣,受制於控制檯日誌級別控制。
這意味着,如果內核以發行版內核中常見的 "quiet" 方式啓動,則輸出可能不會出現在實際
的控制檯上,即使它會出現在 dmesg 緩存中,也可以通過 dmesg 命令和 ``/proc/kmsg``
文件的消費訪問到。作爲一個特例,來自 sysrq 命令的標題行將被傳遞給所有控制檯
使用者,就好像當前日誌級別是最大的一樣。如果只發出標題頭,則幾乎可以肯定內核日誌
級別太低。如果你需要控制檯上的輸出,那麼你將需要臨時提高控制檯日誌級別,通過使用
鍵盤組合鍵 :kbd:`alt-sysrq-8` 或者::

    echo 8 > /proc/sysrq-trigger

在觸發了你感興趣的 SysRq 鍵命令後,記得恢復日誌級別到正常情況。

我有很多問題時,可以請教誰?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

請教在內核郵件列表上的人,郵箱:
	linux-kernel@vger.kernel.org

致謝
~~~~

- Mydraal <vulpyne@vulpyne.net> 撰寫了該文件
- Adam Sulmicki <adam@cfar.umd.edu> 進行了更新
- Jeremy M. Dolan <jmd@turbogeek.org> 在 2001/01/28 10:15:59 進行了更新
- Crutcher Dunnavant <crutcher+kernel@datastacks.com> 添加鍵註冊部分