aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJoern Engel <joern@logfs.org>2013-04-19 12:19:14 -0700
committerJoern Engel <joern@logfs.org>2013-04-19 12:19:14 -0700
commite284f3493206d4268267db4557c7ee6f89ed2314 (patch)
tree3544a77594a2961540c3d02f432f81317c26f810
parentda5ddbde42fe16b699fda85e69ccbcfac73533e5 (diff)
downloadbcon2-e284f3493206d4268267db4557c7ee6f89ed2314.tar.gz
netconsole: s/syslogd/cancd/ in documentation
Using syslogd to capture netconsole is known to be broken, see for example https://bugzilla.redhat.com/show_bug.cgi?id=432160 or any of the many other bug reports. We should not advertise it, much less as a first choice. The fact that syslogd tends to initially work makes it worse, as that creates false hope. Cancd is a syslog-for-netconsole of sorts and in my experience works better than any alternative for non-trivial setups, i.e. more than a single machine sending netconsole traffic. Since my hacked-up version of cancd is no longer compatible with Oracle's original, I linked to both. Signed-off-by: Joern Engel <joern@logfs.org>
-rw-r--r--Documentation/networking/netconsole.txt16
1 files changed, 12 insertions, 4 deletions
diff --git a/Documentation/networking/netconsole.txt b/Documentation/networking/netconsole.txt
index 2e9e0ae2cd453d..c59d2bf2d0278a 100644
--- a/Documentation/networking/netconsole.txt
+++ b/Documentation/networking/netconsole.txt
@@ -54,9 +54,7 @@ address.
The remote host has several options to receive the kernel messages,
for example:
-1) syslogd
-
-2) netcat
+1) netcat
On distributions using a BSD-based netcat version (e.g. Fedora,
openSUSE and Ubuntu) the listening port must be specified without
@@ -65,10 +63,20 @@ for example:
'nc -u -l -p <port>' / 'nc -u -l <port>' or
'netcat -u -l -p <port>' / 'netcat -u -l <port>'
-3) socat
+2) socat
'socat udp-recv:<port> -'
+3) cancd
+
+ A daemon written specifically for netconsole that is good at capturing
+ output from many machines. Using netcat for several machines either
+ interleaves output from all machines or requires the use of per-machine
+ ports.
+
+ https://git.kernel.org/cgit/linux/kernel/git/joern/cancd.git/
+ https://oss.oracle.com/projects/cancd/
+
Dynamic reconfiguration:
========================