Bug 159992 - Add docs detailing which drivers support netconsole
Add docs detailing which drivers support netconsole
Product: Red Hat Enterprise Linux 3
Classification: Red Hat
Component: kernel (Show other bugs)
All Linux
medium Severity medium
: ---
: ---
Assigned To: Jeff Moyer
Brian Brock
Depends On:
Blocks: 156320
  Show dependency treegraph
Reported: 2005-06-09 18:06 EDT by Tim Burke
Modified: 2007-11-30 17:07 EST (History)
1 user (show)

See Also:
Fixed In Version: RHSA-2005-663
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2005-09-28 11:20:54 EDT
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

  None (edit)
Description Tim Burke 2005-06-09 18:06:10 EDT
From: Jeff Moyer <jmoyer>
Date: Thu, 19 May 2005 10:57:15 -0400
Subject: [taroon patch] Add docs detailing which drivers support netconsole
Tracking: 0982.jmoyer.netconsole-drvrs-doc.patch
Archives: 2005-May/msg00359.html
Status: committed in -32.5.EL



Currently, our support staff tell customers that they can determine which
adapters support netconsole by doing the following:

  "A simple way to check what drivers have this capability is to install
   the kernel-source package and search the source code in
   /usr/src/kernel-<version> for the definition HAVE_POLL_CONTROLLER."

This is so incredibly poor it hurts.  Here is a patch that will add the
supported driver list to the Documentation/networking directory, which in
turn gets put into the kernel-doc package.

Please ACK.


[updated by petrides on 19-May-2005]

--- linux-2.4.21/Documentation/networking/netconsole.txt.orig
+++ linux-2.4.21/Documentation/networking/netconsole.txt
@@ -0,0 +1,26 @@
+The netconsole module provides 3 pieces of functionality:
+    1) generation of syslog messages which are delivered to a remote syslog
+       server
+    2) generation of netconsole messages which are delivered to a remote
+       netdump server
+    3) a network kernel crash dump facility
+The configuration for the module is specified in the /etc/sysconfig/netdump
+file, which is self-documented.  Once the parameters are specified in that
+provided you have installed the netdump rpm.
+Network drivers must implement a special hook in order to work with
+netconsole.  The following drivers implement this functionality, and thus
+can be used in conjunction with netconsole:
+    3c59x
+    b44
+    e100
+    e1000
+    eepro100
+    pcnet32
+    tg3
+    tlan
+    tulip
Comment 2 Ernie Petrides 2005-06-10 00:11:11 EDT
A fix for this problem was committed to the RHEL3 U6 patch pool
on 26-May-2005 (in kernel version 2.4.21-32.5.EL).
Comment 8 Red Hat Bugzilla 2005-09-28 11:20:55 EDT
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on the solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.


Note You need to log in before you can comment on or make changes to this bug.