From nobody@FreeBSD.org  Thu Sep 16 00:15:41 2004
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 8266C16A4CE
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 16 Sep 2004 00:15:41 +0000 (GMT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 77AB343D2D
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 16 Sep 2004 00:15:41 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.12.11/8.12.11) with ESMTP id i8G0Ffix066631
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 16 Sep 2004 00:15:41 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.11/8.12.11/Submit) id i8G0FfpN066630;
	Thu, 16 Sep 2004 00:15:41 GMT
	(envelope-from nobody)
Message-Id: <200409160015.i8G0FfpN066630@www.freebsd.org>
Date: Thu, 16 Sep 2004 00:15:41 GMT
From: Guy Harris <guy@alum.mit.edu>
To: freebsd-gnats-submit@FreeBSD.org
Subject: mount_nfs man page is a bit out of date
X-Send-Pr-Version: www-2.3

>Number:         71782
>Category:       docs
>Synopsis:       mount_nfs(8) man page is a bit out of date
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Sep 16 00:20:24 GMT 2004
>Closed-Date:    Sat Oct 07 23:18:00 GMT 2006
>Last-Modified:  Sat Oct  7 23:20:21 GMT 2006
>Originator:     Guy Harris
>Release:        5.2.1
>Organization:
>Environment:
>Description:
The mount_nfs man page claims that NFS-over-TCP is mainly a BSD thing:

     -T      Use TCP transport instead of UDP.  This is recommended for
             servers that are not on the same LAN cable as the client.  (NB:
             This is NOT supported by most non-BSD servers.)

and

BUGS
     Due to the way that Sun RPC is implemented on top of UDP (unreliable
     datagram) transport, tuning such mounts is really a black art that can
     only be expected to have limited success.  For clients mounting servers
     that are not on the same LAN cable or that tend to be overloaded, TCP
     transport is strongly recommended, but unfortunately this is restricted
     to mostly 4.4BSD servers.

which is somewhat out-of-date now.

It also seems to think the "-r" and "-w" flags are mainly used for cranking I/O sizes down for use with UDP-only servers on lossy networks, which might lead some to think you can't use it to crank the sizes *up* on, for example, NFS-over-TCP connections.

The NetBSD mount_nfs man page says for "-T":

     -T      Use TCP transport instead of UDP.  This is recommended for
             servers that are not on the same physical network as the client.
             Not all NFS servers, especially not old ones, support this.

and doesn't have that BUGS item.

>How-To-Repeat:
      
>Fix:
      
>Release-Note:
>Audit-Trail:

From: Chris Pepper <pepper@reppep.com>
To: FreeBSD-gnats-submit@FreeBSD.org, Guy Harris <guy@alum.mit.edu>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/71782: mount_nfs man page is a bit out of date
Date: Sun, 19 Sep 2004 22:55:39 -0400

 At 12:15 AM +0000 2004/09/16, Guy Harris wrote:
 >  >Number:         71782
 >>Category:       docs
 >  >Synopsis:       mount_nfs man page is a bit out of date
 
 >  >Description:
 >The mount_nfs man page claims that NFS-over-TCP is mainly a BSD thing:
 >
 >      -T      Use TCP transport instead of UDP.  This is recommended for
 >              servers that are not on the same LAN cable as the client.  (NB:
 >              This is NOT supported by most non-BSD servers.)
 >
 >and
 >
 >BUGS
 >      Due to the way that Sun RPC is implemented on top of UDP (unreliable
 >      datagram) transport, tuning such mounts is really a black art that can
 >      only be expected to have limited success.  For clients mounting servers
 >      that are not on the same LAN cable or that tend to be overloaded, TCP
 >      transport is strongly recommended, but unfortunately this is restricted
 >      to mostly 4.4BSD servers.
 
 	Further, all three occurrences of 'cable' should be 
 'segment', as most of us are using network segments or subnets that 
 involve multiple cables (via hubs or switches). One cable per segment 
 (thicknet) is an anachronism.
 
 
 						Chris
 --
 Chris Pepper:               <http://www.reppep.com/~pepper/>
 Rockefeller University:     <http://www.rockefeller.edu/>
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Sun Dec 25 10:36:54 UTC 2005 
State-Changed-Why:  
Patched in CURRENT.  And I agree that some wording needs altered 
but that is another matter entirely. 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Sun Dec 25 10:36:54 UTC 2005 
Responsible-Changed-Why:  
Over to me. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=71782 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Sat Oct 7 23:17:28 UTC 2006 
State-Changed-Why:  
Changes have been merged to 6.X.  Thanks! 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/71782: commit references a PR
Date: Sat,  7 Oct 2006 23:17:18 +0000 (UTC)

 trhodes     2006-10-07 23:17:05 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_6)
     sbin/mount_nfs       mount_nfs.8 
   Log:
   Sync with CURRENT:
   Kill the BUGS section, and remove a similar line noted under -T.  As far
   as I know, Sun's NFS support works with TCP just fine.  This is even
   hinted at in the PR.
   
   PR:             71782
   
   Properly separate sentences by adding a semi-colon.
   
   Hinted by:      bmah
   Approved by:    re (bmah)
   
   Revision  Changes    Path
   1.43.2.1  +3 -14     src/sbin/mount_nfs/mount_nfs.8
 _______________________________________________
 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:
