From 4488c8c34ba38146aab52fd60211bb32cdc87267 Mon Sep 17 00:00:00 2001
From: Rick Macklem <rmacklem@FreeBSD.org>
Date: Sun, 11 Jul 2021 13:34:16 -0700
Subject: [PATCH] mount_nfs.8: Add information for "nconnect" to man page

Commit 1e0a518d6548 added a new NFS mount option "nconnect".
This patch adds information on this option to the man page.

It also adds an IMPLEMENTATION section that explains how
the default I/O size is determined and that "nfsstat -m" can
be used to find out what option settings are actually in use.

This is a content change.

Reviewed by:	gbe (manpages)
MFC after:	2 weeks
Differential Revision:	https://reviews.freebsd.org/D31135
---
 sbin/mount_nfs/mount_nfs.8 | 43 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 42 insertions(+), 1 deletion(-)

diff --git a/sbin/mount_nfs/mount_nfs.8 b/sbin/mount_nfs/mount_nfs.8
index 36a3c180b1e3..648cb2128e90 100644
--- a/sbin/mount_nfs/mount_nfs.8
+++ b/sbin/mount_nfs/mount_nfs.8
@@ -28,7 +28,7 @@
 .\"	@(#)mount_nfs.8	8.3 (Berkeley) 3/29/95
 .\" $FreeBSD$
 .\"
-.Dd June 26, 2021
+.Dd July 10, 2021
 .Dt MOUNT_NFS 8
 .Os
 .Sh NAME
@@ -196,6 +196,25 @@ If this is set to 0 it disables positive name caching for the mount point.
 Override the default of NFS_DEFAULT_NEGNAMETIMEO for the timeout (in seconds)
 for negative name cache entries.
 If this is set to 0 it disables negative name caching for the mount point.
+.It Cm nconnect Ns = Ns Aq Ar value
+Specify the number of TCP connections (1-16) to be used
+for an NFS Version 4, minor version 1 or 2 mount.
+Multiple TCP connections can provide more client to server network
+bandwidth for certain network configurations such as:
+.Bd -literal
+- Multiple network interfaces that are aggregated together.
+- A fast network interface that uses multiple queues.
+.Ed
+.sp
+The first TCP connection will be used for all RPCs that consist
+entirely of small RPC messages.
+The RPCs that can have large RPC messages (Read/Readdir/Write) are
+distributed over the additional TCP connections in a round robin
+fashion.
+This option will result in more IP port#s being used.
+This option requires the
+.Cm nfsv4
+option.
 .It Cm nfsv2
 Use the NFS Version 2 protocol (the default is to try version 3 first
 then version 2).
@@ -586,9 +605,31 @@ Same as
 Same as
 .Fl o Cm nfsv4
 .El
+.Sh IMPLEMENTATION NOTES
+When neither the
+.Cm rsize
+nor
+.Cm wsize
+options are specified, the I/O size will be set to the largest value
+supported by both the NFS client and server.
+The largest value supported by the NFS client is defined by
+the tunable
+.Cd vfs.maxbcachebuf
+which can be set to a power of two up to
+.Cd kern.maxphys .
+.Pp
+The
+.Xr nfsstat 1
+command with the
+.Ic -m
+command line option will show what
+.Nm
+option settings are actually in use for the mount.
 .Sh SEE ALSO
+.Xr nfsstat 1 ,
 .Xr nmount 2 ,
 .Xr unmount 2 ,
+.Xr lagg 4 ,
 .Xr nfsv4 4 ,
 .Xr fstab 5 ,
 .Xr gssd 8 ,