svn commit: r355307 - head/share/man/man3

[Edward Tomasz Napierala]

Author: trasz
Date: Mon Dec  2 21:03:09 2019
New Revision: 355307
URL: https://svnweb.freebsd.org/changeset/base/355307

Log:
  Expand stats(3) man page to add a caveat regarding HZ.
  
  Suggested by:	thj
  Sponsored by:	Klara Inc, Netflix

Modified:
  head/share/man/man3/stats.3

Modified: head/share/man/man3/stats.3
==============================================================================
--- head/share/man/man3/stats.3	Mon Dec  2 21:00:29 2019	(r355306)
+++ head/share/man/man3/stats.3	Mon Dec  2 21:03:09 2019	(r355307)
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd October 7, 2019
+.Dd December 2, 2019
 .Dt STATS 3
 .Os
 .Sh NAME
@@ -960,3 +960,9 @@ The
 framework and this manual page were written by
 .An Lawrence Stewart Aq lstewart at FreeBSD.org
 and sponsored by Netflix, Inc.
+.Sh CAVEATS
+Granularity of timing-dependent network statistics, in particular TCP_RTT,
+depends on the
+.Dv HZ
+timer.
+To minimize the measurement error avoid using HZ lower than 1000.