Magic SysRq Key

From OpenVZ Virtuozzo Containers Wiki
Revision as of 11:16, 13 June 2006 by Kir (talk | contribs) (Added a link to remote console setup, added missing article)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Alt-SysRq-* is a "magical" key combo you can hit which the kernel will respond to regardless of whatever else it is doing, unless it is completely locked up.

/proc/sys/kernel/sysrq[edit]

When running a kernel with SysRq compiled in (as in all binary kernels released by OpenVZ), /proc/sys/kernel/sysrq file controls the functions allowed to be invoked via the SysRq key. Here is the list of possible values in /proc/sys/kernel/sysrq:

0 disable sysrq completely
1 enable all functions of sysrq
>1 bitmask of allowed sysrq functions

You can set the value in the file by the following command:

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

Available keys[edit]

To use SysRq feature you should press the key combo 'Alt-SysRq-<command key>'. The 'SysRq' key is also known as the 'Print Screen' key. Other way, if you don't have physical access to the node, only ssh, you can do

echo "command key" > /proc/sysrq-trigger

Here is the list of most useful command keys:

b Will immediately reboot the system without syncing or unmounting your disks
s Will attempt to sync all mounted filesystems
u Will attempt to remount all mounted filesystems read-only
p Will dump the current registers and flags to your console
t Will dump a list of current tasks and their information to your console
m Will dump current memory info to your console
0...9 Sets the console log level, controlling which kernel messages will be printed to your console. (0, for example would make it so that only emergency messages like PANICs or OOPSes would make it to your console)
f Will call oom_kill to kill a memory hog process
e Send a SIGTERM to all processes, except for init
i Send a SIGKILL to all processes, except for init
h Will display help

All output will appear on the console and/or in /var/log/messages file. In some cases you need to set up a remote console in order to catch all the messages you need.

Example[edit]

Suppose for some strange reason your system is working slow and you want to ask developers what happens, then don't forget to press Alt-SysRq-p and Alt-SysRq-t several times, and attach /var/log/messages to a request.