Hi,
Since I see that you're adding documentation updates, you incorporate
this patch to Documentation/sysrq.txt and Documentation/Configure.help.
It changes the help for the magic sysrq to point people to the sysrq.txt
documentation, and also updates sysrq.txt to be more informative on some
topics. The patch is to 2.1.93, but applies happily to 2.1.98. Thank you.
-Myrdraal
--ZGiS0Q5IWpPtfppv
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="sysrq.txt-2.1.93.diff"
diff -r -u linux/Documentation/Configure.help linpatch/Documentation/Configure.help
--- linux/Documentation/Configure.help Tue Apr 7 14:31:57 1998
+++ linux/Documentation/Configure.help Tue Apr 7 14:38:06 1998
@@ -7008,14 +7008,12 @@
Magic System Request Key support
CONFIG_MAGIC_SYSRQ
- This is for kernel hackers who want to have some control over the
- system even if the system crashes during kernel debugging (e.g., to
- flush the disks, reboot the system immediately or dump some status
- information). This is accomplished by pressing various keys while
- holding SysRq (Alt+PrintScreen). As you are expected to be a kernel
- hacker to use this, the simple rule about learning what the keys
- mean is "Use the source, Luke!" -- read drivers/char/sysrq.c.
- Don't say Y unless you really know what this hack does.
+ This is for people who want to have some control over the
+ system even if the system crashes (e.g., to flush the disks, reboot
+ the system immediately or dump some status information). This is
+ accomplished by pressing various keys while holding SysRQ
+ (Alt+PrintScreen). For more information, and a list of valid command
+ keys, please see Documentation/sysrq.txt.
ISDN subsystem
CONFIG_ISDN
diff -r -u linux/Documentation/sysrq.txt linpatch/Documentation/sysrq.txt
--- linux/Documentation/sysrq.txt Tue Apr 7 14:31:57 1998
+++ linux/Documentation/sysrq.txt Tue Apr 7 14:06:26 1998
@@ -1,24 +1,26 @@
- MAGIC SYSRQ KEY DOCUMENTATION v1.0
+ MAGIC SYSRQ KEY DOCUMENTATION v1.1
------------------------------------
- [Fri Apr 3 08:27:12 EST 1998]
+ [Tue Apr 7 14:06:17 EDT 1998]
-1. What is the magic SysRQ key?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1. What is the magic SysRQ key?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
It is a 'magical' key combo you can hit, and the kernel will respond to
regardless of anything else, unless it is hard-locked.
-2. How do I enable the magic SysRQ key?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+2. How do I enable the magic SysRQ key?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You need to say yes to 'Magic SysRq key (CONFIG_MAGIC_SYSRQ)' when
configuring the kernel. This option is only available it 2.1.x or later
kernels.
-3. How do I use the magic SysRQ key?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-You press the key combo 'ALT-SysRQ-<command key>'.
+3. How do I use the magic SysRQ key?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+You press the key combo 'ALT-SysRQ-<command key>'. Note - some (older?)
+keyboards may not have a key labeled 'SysRQ'. 'SysRQ' is just the Print Screen
+key.
-4. What are the 'command' keys?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+4. What are the 'command' keys?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
'r' - Turns off keyboard raw mode and sets it to XLATE.
'k' - Kills all programs on the current virtual console.
@@ -51,8 +53,8 @@
'l' - Send a SIGKILL to all processes, INCLUDING init. (Your system
will be non-functional after this.)
-5. Okay, so what can I use them for?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+5. Okay, so what can I use them for?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Well, un'R'aw is very handy when your X server or a svgalib program crashes.
sa'K' (system attention key) is useful when you want to exit a program
@@ -76,14 +78,24 @@
are unable to kill any other way, especially if it's spawning other
processes.
-6. Sometimes SysRQ seems to get 'stuck' after using it, what can I do?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+6. Sometimes SysRQ seems to get 'stuck' after using it, what can I do?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
That happens to me, also. I've found that tapping shift, alt, and control
on both sides of the keyboard, and hitting an invalid sysrq sequence again
will fix the problem. (ie, something like alt-sysrq-z).
-7. I have more questions, who can I ask?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+7. I hit SysRQ, but nothing seems to happen, what's wrong?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+There are some keyboards which do not support 'SysRQ', you can try running
+'showkey -s' and pressing SysRQ or alt-SysRQ to see if it generates any
+0x54 codes. If it doesn't, you may define the magic sysrq sequence to a
+different key. Find the keycode with showkey, and change the define of
+'#define SYSRQ_KEY 0x54' in [/usr/src/linux/]include/asm/keyboard.h to
+the keycode of the key you wish to use, then recompile. Oh, and by the way,
+you exit 'showkey' by not typing for ten seconds.
+
+8. I have more questions, who can I ask?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You may feel free to send email to myrdraal@deathsdoor.com, and I will
respond as soon as possible.
-Myrdraal
--ZGiS0Q5IWpPtfppv--
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.rutgers.edu