diff -urN 2.4.10pre12/Documentation/Configure.help netconsole/Documentation/Configure.help --- 2.4.10pre12/Documentation/Configure.help Thu Sep 20 01:43:25 2001 +++ netconsole/Documentation/Configure.help Thu Sep 20 06:56:17 2001 @@ -9997,6 +9997,11 @@ say M here and read Documentation/modules.txt. This is recommended. The module will be called skfp.o. +Network logging support +CONFIG_NETCONSOLE + If you want to log kernel messages over the network, then say + "M" here. See Documentation/networking/netlogging.txt for details. + HIgh Performance Parallel Interface support (EXPERIMENTAL) CONFIG_HIPPI HIgh Performance Parallel Interface (HIPPI) is a 800Mbit/sec and diff -urN 2.4.10pre12/Documentation/networking/netlogging.txt netconsole/Documentation/networking/netlogging.txt --- 2.4.10pre12/Documentation/networking/netlogging.txt Thu Jan 1 01:00:00 1970 +++ netconsole/Documentation/networking/netlogging.txt Thu Sep 20 06:55:44 2001 @@ -0,0 +1,46 @@ + +started by Ingo Molnar , 2001.09.17 + +the network console can be configured over the module interface, +by specifying the dev=, target_ip=, source_port=, target_port= +module parameters. Sample use: + +insmod netconsole dev=eth0 target_ip=0x0a000701 \ + source_port=6666 target_port=6666 + +IP addresses must be specified in hexadecimal numbers. The +above example uses target host IP 10.0.7.1. + +if the module is loaded then all kernel messages are sent to the +target host via UDP packets. The remote host should run the +client-side 'netconsole' daemon to display & log the messages. + +WARNING: the default setting uses the broadcast ethernet address +to send packets, which can cause increased load on other systems +on the same ethernet segment. If this is not desired, then the +target ethernet address can be specified via the target_eth_byte0, +target_eth_byte1 ... byte5 module parameters. Eg.: + +insmod netconsole dev=eth0 target_ip=0x0a000701 \ + source_port=6666 target_port=6666 \ + target_eth_byte0=0x00 \ + target_eth_byte1=0x02\ + target_eth_byte2=0xA5 \ + target_eth_byte3=0x13 \ + target_eth_byte4=0x51 \ + target_eth_byte5=0xDD + +will instruct the netconsole code to use target ethernet address +00:02:A5:13:51:DD. + +NOTE: the network device (eth0 in the above case) can run any kind +of other network traffic, netconsole is not intrusive. Netconsole +might cause slight delays in other traffic if the volume of kernel +messages is high, but should have no other impact. + +netconsole was designed to be as instantaneous as possible, to +enable the logging of even the most critical kernel bugs. It works +from IRQ contexts as well, and does not enable interrupts while +sending packets. Due to these unique needs, configuration can not +be more automatic, and some fundamental limitations will remain: +only IP networks, UDP packets and ethernet devices are supported.