Difference between revisions of "Magic SysRq Key"

From OpenVZ Virtuozzo Containers Wiki
Jump to: navigation, search
(Initial edition of article)
 
(Added a link to remote console setup, added missing article)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
−
It is a 'magical' key combo you can hit which the kernel will respond to
+
'''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.
 
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 ==
−
<tt>/proc/sys/kernel/sysrq</tt> controls the functions allowed to be invoked via the SysRq key.
+
 
 +
When running a kernel with SysRq compiled in (as in all binary kernels released by OpenVZ),
 +
<tt>/proc/sys/kernel/sysrq</tt> file controls the functions allowed to be invoked via the SysRq key.
 
Here is the list of possible values in <tt>/proc/sys/kernel/sysrq</tt>:<br>
 
Here is the list of possible values in <tt>/proc/sys/kernel/sysrq</tt>:<br>
  
−
<tt>0</tt> - disable sysrq completely<br>
+
{| class="wikitable"
−
<tt>1</tt> - enable all functions of sysrq<br>
+
! 0
−
><tt>1</tt> - bitmask of allowed sysrq functions<br>
+
| 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:
 
You can set the value in the file by the following command:
Line 15: Line 24:
 
</pre>
 
</pre>
  
−
To use SysRq feature you should press the key combo 'ALT-SysRq-<command key>'.
+
== Available keys ==
 +
 
 +
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
 
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
 
physical access to the node, only ssh, you can do
Line 24: Line 35:
 
Here is the list of most useful command keys:
 
Here is the list of most useful command keys:
  
−
<tt>b</tt> - Will immediately reboot the system without syncing or unmounting
+
{| class="wikitable"
−
your disks.<br>
+
! b
−
<tt>s</tt> - Will attempt to sync all mounted filesystems.<br>
+
| Will immediately re'''b'''oot the system without syncing or unmounting your disks
−
<tt>u</tt> - Will attempt to remount all mounted filesystems read-only.<br>
+
|-
−
<tt>p</tt> - Will dump the current registers and flags to your console.<br>
+
! s  
−
<tt>t</tt> - Will dump a list of current tasks and their information to your
+
| Will attempt to '''s'''ync all mounted filesystems
−
console.<br>
+
|-
−
<tt>m</tt> - Will dump current memory info to your console.<br>
+
! u
−
<tt>0</tt>-<tt>9</tt> - Sets the console log level, controlling which kernel messages
+
| Will attempt to remo'''u'''nt all mounted filesystems read-only
−
will be printed to your console. ('0', for example would make
+
|-
−
it so that only emergency messages like PANICs or OOPSes would
+
! p
−
make it to your console.)<br>
+
| Will dum'''p''' the current registers and flags to your console
−
<tt>f</tt> - Will call oom_kill to kill a memory hog process<br>
+
|-
−
<tt>e</tt> - Send a SIGTERM to all processes, except for init.<br>
+
! t
−
<tt>i</tt> - Send a SIGKILL to all processes, except for init.<br>
+
| Will dump a list of current '''t'''asks and their information to your console
−
<tt>h</tt> - Will display help<br>
+
|-
 +
! m
 +
| Will dump current '''m'''emory 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 SIGT'''E'''RM to all processes, except for init
 +
|-
 +
! i
 +
| Send a SIGK'''I'''LL to all processes, except for init
 +
|-
 +
! h
 +
| Will display '''h'''elp
 +
|}
 +
 
 +
All output will appear on the console and/or in <tt>/var/log/messages</tt> file. In some cases you need to [[Remote console setup|set up a remote console]] in order to catch all the messages you need.
  
−
All ouptput will be on console or in <tt>/var/log/messages</tt>
+
== Example ==
  
−
Example of using SysRq. Suppose for some strange reason your system is working slow and you want to
+
Suppose for some strange reason your system is working slow and you want to
 
ask developers what happens, then don't forget to press
 
ask developers what happens, then don't forget to press
−
<tt>alt-sysrq-p</tt> and <tt>alt-sysrq-t</tt> several times,
+
<tt>Alt-SysRq-p</tt> and <tt>Alt-SysRq-t</tt> several times,
−
and attach <tt>/var/log/messages</tt> to request.
+
and attach <tt>/var/log/messages</tt> to a request.
  
 
[[Category: Troubleshooting]]
 
[[Category: Troubleshooting]]
 +
[[Category: Kernel]]

Latest revision as of 11:16, 13 June 2006

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.

Retrieved from "https://wiki.openvz.org/index.php?title=Magic_SysRq_Key&oldid=1638"