Improve wording and formatting.

New sentence, new line.
Fix typo.
This commit is contained in:
wiz 2017-03-03 11:36:20 +00:00
parent 70c816d80b
commit fdc74d1a1d
1 changed files with 24 additions and 17 deletions

View File

@ -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. .\" Copyright 2002, 2003 Wasabi Systems, Inc.
.\" All rights reserved. .\" All rights reserved.
@ -173,34 +173,41 @@ for information on how to enable this feature.
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width WM_RX_INTR_PROCESS_LIMIT_DEFAULT -offset 3n .Bl -tag -width WM_RX_INTR_PROCESS_LIMIT_DEFAULT -offset 3n
.It Dv WM_RX_PROCESS_LIMIT_DEFAULT .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 .Xr softint 9
context. This option only effects for multiqueue. The value range context.
is between zero to UINT_MAX. The default value is 100. This option only affects multiqueue.
When you increase this value, receive latency would increase and The value range is from zero to
receive throughput would increase. .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 .It Dv WM_RX_INTR_PROCESS_LIMIT_DEFAULT
The maxinum number of received packets which processed in each The maximum number of received packets processed in each
hardware interrupt context. This option only effects for multiqueue. hardware interrupt context.
The value range is between zero to UINT_MAX. The default value is 0. This option only affects multiqueue.
When you increase this value, receive latency would decrease and The value range is from zero to
receive throughput would decrease. .Dv UINT_MAX .
The default value is 0.
When you increase this value, both the receive latency and
the receive throughput will decrease.
.El .El
.Pp .Pp
Setting 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, to zero means so-called polling mode, that is, once an interrupt occurs,
the driver keep processing received packets until 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 Polling mode increases latency a little, however it supresses
performance degration at high load very well. performance degration at high load very well.
.Pp .Pp
If you want to disable polling mode (to use traditional interrupt If you want to disable polling mode (to use traditional interrupt
driven mode), you should set driven mode), you should set
.Em WM_RX_PROCESS_LIMIT_DEFAULT .Dv WM_RX_PROCESS_LIMIT_DEFAULT
zero and set to zero and set
.Em WM_RX_INTR_PROCESS_LIMIT_DEFAULT .Dv WM_RX_INTR_PROCESS_LIMIT_DEFAULT
UINT_MAX. to
.Dv UINT_MAX .
.Sh SEE ALSO .Sh SEE ALSO
.Xr arp 4 , .Xr arp 4 ,
.Xr ifmedia 4 , .Xr ifmedia 4 ,