From 7ecc83b2d7c36f2dcca1037ad7d28c7ae1a32435 Mon Sep 17 00:00:00 2001 From: Giuseppe CAVALLARO Date: Thu, 1 Sep 2011 21:51:42 +0000 Subject: [PATCH] --- yaml --- r: 265751 b: refs/heads/master c: 4f2f25f9f04a92aab31e3bc1dcb84bec33acc773 h: refs/heads/master i: 265749: 75b4ffd69429a9a6523a7534fcecb6b4830a85c1 265747: 5eefac627df785e80e490ac82688f2b7a9762e05 265743: 7abb2a3261e9d1bda3c1a0860f9b8999bc197ea5 v: v3 --- [refs] | 2 +- trunk/Documentation/networking/stmmac.txt | 33 ++++++++++++++++++++++- 2 files changed, 33 insertions(+), 2 deletions(-) diff --git a/[refs] b/[refs] index 884e247d8d72..5f60d1690583 100644 --- a/[refs] +++ b/[refs] @@ -1,2 +1,2 @@ --- -refs/heads/master: 6096ce0b02c1cb5a5df6a726c5727c267b2468e0 +refs/heads/master: 4f2f25f9f04a92aab31e3bc1dcb84bec33acc773 diff --git a/trunk/Documentation/networking/stmmac.txt b/trunk/Documentation/networking/stmmac.txt index 57a24108b845..40ec92ce4c84 100644 --- a/trunk/Documentation/networking/stmmac.txt +++ b/trunk/Documentation/networking/stmmac.txt @@ -235,7 +235,38 @@ reset procedure etc). o enh_desc.c: functions for handling enhanced descriptors o norm_desc.c: functions for handling normal descriptors -5) TODO: +5) Debug Information + +The driver exports many information i.e. internal statistics, +debug information, MAC and DMA registers etc. + +These can be read in several ways depending on the +type of the information actually needed. + +For example a user can be use the ethtool support +to get statistics: e.g. using: ethtool -S ethX +(that shows the Management counters (MMC) if supported) +or sees the MAC/DMA registers: e.g. using: ethtool -d ethX + +Compiling the Kernel with CONFIG_DEBUG_FS and enabling the +STMMAC_DEBUG_FS option the driver will export the following +debugfs entries: + +/sys/kernel/debug/stmmaceth/descriptors_status + To show the DMA TX/RX descriptor rings + +Developer can also use the "debug" module parameter to get +further debug information. + +In the end, there are other macros (that cannot be enabled +via menuconfig) to turn-on the RX/TX DMA debugging, +specific MAC core debug printk etc. Others to enable the +debug in the TX and RX processes. +All these are only useful during the developing stage +and should never enabled inside the code for general usage. +In fact, these can generate an huge amount of debug messages. + +6) TODO: o XGMAC is not supported. o Review the timer optimisation code to use an embedded device that will be available in new chip generations.