[PATCH -mm 6/9] netconsole: Update documentation for multiple target support
From: Satyam Sharma <hidden>
Date: 2007-07-04 11:09:26
Also in:
lkml
From: Satyam Sharma <redacted> [6/9] netconsole: Update documentation for multiple target support ... and add a few useful general purpose tips as well while we're at it. Signed-off-by: Satyam Sharma <redacted> Cc: Keiichi Kii <redacted> Cc: Takayoshi Kochi <redacted> --- Documentation/networking/netconsole.txt | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) --- diff -ruNp a/Documentation/networking/netconsole.txt b/Documentation/networking/netconsole.txt
--- a/Documentation/networking/netconsole.txt 2007-04-26 08:38:32.000000000 +0530
+++ b/Documentation/networking/netconsole.txt 2007-07-02 11:44:53.000000000 +0530@@ -34,6 +34,12 @@ Examples: insmod netconsole netconsole=@/,@10.0.0.2/ +It also supports logging to multiple remote agents by specifying +parameters for the multiple agents separated by semicolons and the +complete string enclosed in "quotes", thusly: + +modprobe netconsole netconsole="@/,@10.0.0.2/;@/eth1,6892@10.0.0.3/" + Built-in netconsole starts immediately after the TCP stack is initialized and attempts to bring up the supplied dev at the supplied address.
@@ -44,6 +50,18 @@ WARNING: the default target ethernet set ethernet address to send packets, which can cause increased load on other systems on the same ethernet segment. +TIP: some LAN switches may be configured to suppress ethernet broadcasts +so it is advised to explicitly specify the remote agents' MAC addresses +from the config parameters passed to netconsole. + +TIP: to find out the MAC address of 10.0.0.2, you may try using: +ping -c 1 10.0.0.2 ; /sbin/arp -n | grep 10.0.0.2 + +TIP: in case the remote logging agent is on a separate LAN subnet than +the sender, it is suggested to try specifying the default gateway's +(you may use /sbin/route -n to find out) MAC address as the remote MAC +address instead. + NOTE: the network device (eth1 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