Difference between revisions of "Magic SysRq Key"

From OpenVZ Virtuozzo Containers Wiki
Jump to: navigation, search
(Initial edition of article)
(No difference)

Revision as of 08:57, 13 June 2006

It 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.

When running a kernel with SysRq compiled in (that's right in openVZ case), /proc/sys/kernel/sysrq 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

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 ouptput will be on console or in /var/log/messages

Example of using SysRq. 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 request.