From nobody@FreeBSD.org  Fri Nov  4 02:07:53 2005
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id B467F16A41F
	for <freebsd-gnats-submit@FreeBSD.org>; Fri,  4 Nov 2005 02:07:53 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 80B8C43D46
	for <freebsd-gnats-submit@FreeBSD.org>; Fri,  4 Nov 2005 02:07:53 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id jA427q5c085700
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 4 Nov 2005 02:07:52 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id jA427pvR085699;
	Fri, 4 Nov 2005 02:07:52 GMT
	(envelope-from nobody)
Message-Id: <200511040207.jA427pvR085699@www.freebsd.org>
Date: Fri, 4 Nov 2005 02:07:52 GMT
From: Reko Turja <reko.turja@liukuma.net>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Possible addition to xl(4) manpage, Diagnostics section
X-Send-Pr-Version: www-2.3

>Number:         88477
>Category:       docs
>Synopsis:       Possible addition to xl(4) manpage, Diagnostics section
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Nov 04 02:10:15 GMT 2005
>Closed-Date:    Sun Jul 20 16:51:54 UTC 2008
>Last-Modified:  Sun Jul 20 17:00:05 UTC 2008
>Originator:     Reko Turja
>Release:        6.0 STABLE
>Organization:
>Environment:
FreeBSD muppet.liukuma.net 6.0-STABLE FreeBSD 6.0-STABLE #7: Wed Nov  2 23:17:37 EET 2005     root@muppet.liukuma.net:/usr/obj/usr/src/sys/LIUKUMA  i386

>Description:
The 3com xl-series of adapters usually emit some messages like:

+xl0: transmission error: 90
+xl0: tx underrun, increasing tx start threshold to 180 bytes
+xl0: transmission error: 90
+xl0: tx underrun, increasing tx start threshold to 240 bytes
+xl0: transmission error: 90
+xl0: tx underrun, increasing tx start threshold to 300 bytes         

when the interface tunes itself.

Although usually harmless, I think the messages could/should be documented
in the xl manpage
>How-To-Repeat:
Give network adapter using the xl(4) driver some workload
>Fix:
There might be some other underlying technical snags with this one (I guess
if these messages appear constantly and tx treshold goes over some value
the adapter is broken...), but I'd suggest the following: 

Add another entry under diagnostics (maybe as the last one):

xl%d: transmission error: 90
xl%d: tx underrun, increasing tx start threshold to xxx bytes
This message may appear while the adapter tunes it's transmission buffers
under load. If these messages won't appear constantly but only soon after
reboot, or during heavy network load spikes, they can be probably ignored.
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Thu Jan 24 00:39:55 UTC 2008 
State-Changed-Why:  
Patched in current.  I have one of these cards and get the same messages, 
it would have been nice to see it in the manual page.  Thanks! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Thu Jan 24 00:39:55 UTC 2008 
Responsible-Changed-Why:  
Over to me, MFC reminder. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=88477 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/88477: commit references a PR
Date: Thu, 24 Jan 2008 00:39:42 +0000 (UTC)

 trhodes     2008-01-24 00:39:39 UTC
 
   FreeBSD src repository
 
   Modified files:
     share/man/man4       xl.4 
   Log:
   Add a diagnostic note about "transmission error ... tx underrun, increasing
   tx start threshold ..."  Looking around on the mailing lists, and even having
   one of these cards I agree the messages should be documented.
   
   Bump doc date.
   
   PR:     88477
   
   Revision  Changes    Path
   1.39      +6 -1      src/share/man/man4/xl.4
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/88477: commit references a PR
Date: Sun, 20 Jul 2008 16:00:20 +0000 (UTC)

 trhodes     2008-07-20 15:59:44 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_7)
     share/man/man4       xl.4 
   Log:
   SVN rev 180632 on 2008-07-20 15:59:44Z by trhodes
   
   MFC r175615:
   
   Add a diagnostic note about "transmission error ... tx underrun, increasing
   tx start threshold ..." Looking around on the mailing lists, and even having
   one of these cards I agree the messages should be documented.
   
   Bump doc date.
   
   PR: 88477
   
   Revision  Changes    Path
   1.38.2.1  +6 -1      src/share/man/man4/xl.4
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Sun Jul 20 16:51:32 UTC 2008 
State-Changed-Why:  
MFC completed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=88477 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/88477: commit references a PR
Date: Sun, 20 Jul 2008 16:51:27 +0000 (UTC)

 trhodes     2008-07-20 16:51:14 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_6)
     share/man/man4       xl.4 
   Log:
   SVN rev 180634 on 2008-07-20 16:51:14Z by trhodes
   
   MFC r175615:
   
   Add a diagnostic note about "transmission error ... tx underrun, increasing
   tx start threshold ..." Looking around on the mailing lists, and even having
   one of these cards I agree the messages should be documented.
   
   Bump doc date.
   
   PR: 88477
   
   Revision  Changes    Path
   1.34.2.4  +6 -1      src/share/man/man4/xl.4
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
