From fdc74d1a1d81a0d602b6143947304967ab141657 Mon Sep 17 00:00:00 2001 From: wiz Date: Fri, 3 Mar 2017 11:36:20 +0000 Subject: [PATCH] Improve wording and formatting. New sentence, new line. Fix typo. --- share/man/man4/wm.4 | 41 ++++++++++++++++++++++++----------------- 1 file changed, 24 insertions(+), 17 deletions(-) diff --git a/share/man/man4/wm.4 b/share/man/man4/wm.4 index a9cc62472eed..40353308ff65 100644 --- a/share/man/man4/wm.4 +++ b/share/man/man4/wm.4 @@ -1,4 +1,4 @@ -.\" $NetBSD: wm.4,v 1.32 2017/03/03 10:44:25 knakahara Exp $ +.\" $NetBSD: wm.4,v 1.33 2017/03/03 11:36:20 wiz Exp $ .\" .\" Copyright 2002, 2003 Wasabi Systems, Inc. .\" All rights reserved. @@ -173,34 +173,41 @@ for information on how to enable this feature. .Sh OPTIONS .Bl -tag -width WM_RX_INTR_PROCESS_LIMIT_DEFAULT -offset 3n .It Dv WM_RX_PROCESS_LIMIT_DEFAULT -The maxinum number of received packets which processed in each +The maximum number of received packets processed in each .Xr softint 9 -context. This option only effects for multiqueue. The value range -is between zero to UINT_MAX. The default value is 100. -When you increase this value, receive latency would increase and -receive throughput would increase. +context. +This option only affects multiqueue. +The value range is from zero to +.Dv UINT_MAX . +The default value is 100. +When you increase this value, both the receive latency and +the receive throughput will increase. .It Dv WM_RX_INTR_PROCESS_LIMIT_DEFAULT -The maxinum number of received packets which processed in each -hardware interrupt context. This option only effects for multiqueue. -The value range is between zero to UINT_MAX. The default value is 0. -When you increase this value, receive latency would decrease and -receive throughput would decrease. +The maximum number of received packets processed in each +hardware interrupt context. +This option only affects multiqueue. +The value range is from zero to +.Dv UINT_MAX . +The default value is 0. +When you increase this value, both the receive latency and +the receive throughput will decrease. .El .Pp Setting -.Em WM_RX_INTR_PROCESS_LIMIT_DEFAULT +.Dv WM_RX_INTR_PROCESS_LIMIT_DEFAULT to zero means so-called polling mode, that is, once an interrupt occurs, the driver keep processing received packets until -.Em WM_RX_PROCESS_LIMIT_DEFAULT . +.Dv WM_RX_PROCESS_LIMIT_DEFAULT . Polling mode increases latency a little, however it supresses performance degration at high load very well. .Pp If you want to disable polling mode (to use traditional interrupt driven mode), you should set -.Em WM_RX_PROCESS_LIMIT_DEFAULT -zero and set -.Em WM_RX_INTR_PROCESS_LIMIT_DEFAULT -UINT_MAX. +.Dv WM_RX_PROCESS_LIMIT_DEFAULT +to zero and set +.Dv WM_RX_INTR_PROCESS_LIMIT_DEFAULT +to +.Dv UINT_MAX . .Sh SEE ALSO .Xr arp 4 , .Xr ifmedia 4 ,