1998-12-21 22:37:53 +00:00
|
|
|
.\"
|
1999-08-28 00:22:10 +00:00
|
|
|
.\" $FreeBSD$
|
1998-12-21 22:37:53 +00:00
|
|
|
.\"
|
2002-10-28 07:24:58 +00:00
|
|
|
.Dd October 28, 2002
|
1998-12-21 22:37:53 +00:00
|
|
|
.Dt DUMMYNET 4
|
|
|
|
|
.Os
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm dummynet
|
2002-10-28 07:24:58 +00:00
|
|
|
.Nd traffic shaper, bandwidth manager and delay emulator
|
1998-12-21 22:37:53 +00:00
|
|
|
.Sh DESCRIPTION
|
2002-11-29 11:39:20 +00:00
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
system facility permits the control of traffic
|
1998-12-21 22:37:53 +00:00
|
|
|
going through the various network interfaces, by applying bandwidth
|
2002-10-28 07:24:58 +00:00
|
|
|
and queue size limitations, implementing different scheduling and queue
|
|
|
|
|
management policies, and emulating delays and losses.
|
1998-12-21 22:37:53 +00:00
|
|
|
.Pp
|
2002-10-28 07:24:58 +00:00
|
|
|
The user interface for
|
2002-11-29 11:39:20 +00:00
|
|
|
.Nm
|
2002-10-28 07:24:58 +00:00
|
|
|
is implemented by the
|
|
|
|
|
.Xr ipfw 8
|
2002-11-29 11:39:20 +00:00
|
|
|
utility, so please refer to the
|
|
|
|
|
.Xr ipfw 8
|
|
|
|
|
manpage for a complete description of the
|
2000-11-20 18:41:33 +00:00
|
|
|
.Nm
|
2002-11-29 11:39:20 +00:00
|
|
|
capabilities and how to use it.
|
|
|
|
|
.Ss Kernel Options
|
2002-10-28 07:24:58 +00:00
|
|
|
The following options in the kernel configuration file are related to
|
2000-11-20 18:41:33 +00:00
|
|
|
.Nm
|
1998-12-21 22:37:53 +00:00
|
|
|
operation:
|
2002-11-29 11:39:20 +00:00
|
|
|
.Pp
|
|
|
|
|
.Bl -tag -width ".Dv IPFIREWALL_VERBOSE_LIMIT" -offset indent -compact
|
|
|
|
|
.It Dv IPFIREWALL
|
|
|
|
|
enable ipfirewall (required for
|
|
|
|
|
.Nm )
|
|
|
|
|
.It Dv IPFIREWALL_VERBOSE
|
|
|
|
|
enable firewall output
|
|
|
|
|
.It Dv IPFIREWALL_VERBOSE_LIMIT
|
|
|
|
|
limit firewall output
|
|
|
|
|
.It Dv DUMMYNET
|
|
|
|
|
enable
|
|
|
|
|
.Nm
|
|
|
|
|
operation
|
|
|
|
|
.It Dv NMBCLUSTERS
|
|
|
|
|
set the amount of network packet buffers
|
|
|
|
|
.It Dv HZ
|
|
|
|
|
set the timer granularity
|
|
|
|
|
.El
|
1998-12-21 22:37:53 +00:00
|
|
|
.Pp
|
|
|
|
|
Generally, the following options are required:
|
2002-11-29 11:39:20 +00:00
|
|
|
.Bd -literal -offset indent
|
|
|
|
|
options IPFIREWALL
|
|
|
|
|
options DUMMYNET
|
|
|
|
|
options HZ=1000 # strongly recommended
|
1998-12-21 22:37:53 +00:00
|
|
|
.Ed
|
2000-12-29 09:18:45 +00:00
|
|
|
.Pp
|
2002-11-29 11:39:20 +00:00
|
|
|
Additionally, one may want to increase the number
|
1998-12-21 22:37:53 +00:00
|
|
|
of mbuf clusters (used to store network packets) according to the
|
|
|
|
|
sum of the bandwidth-delay products and queue sizes of all configured
|
|
|
|
|
pipes.
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr setsockopt 2 ,
|
2001-09-30 12:49:21 +00:00
|
|
|
.Xr bridge 4 ,
|
1998-12-21 22:37:53 +00:00
|
|
|
.Xr ip 4 ,
|
|
|
|
|
.Xr ipfw 8 ,
|
2000-11-15 16:00:07 +00:00
|
|
|
.Xr sysctl 8
|
1998-12-21 22:37:53 +00:00
|
|
|
.Sh HISTORY
|
2002-11-29 11:39:20 +00:00
|
|
|
The
|
1998-12-21 22:37:53 +00:00
|
|
|
.Nm
|
2002-11-29 11:39:20 +00:00
|
|
|
facility
|
|
|
|
|
was initially implemented as a testing tool for
|
|
|
|
|
.Tn TCP
|
|
|
|
|
congestion control by
|
2000-11-01 11:17:33 +00:00
|
|
|
.An Luigi Rizzo Aq luigi@iet.unipi.it ,
|
2002-10-28 07:24:58 +00:00
|
|
|
as described on ACM Computer Communication Review, Jan.97 issue.
|
2002-11-29 11:39:20 +00:00
|
|
|
Later it has been modified to work at the
|
|
|
|
|
.Tn IP
|
|
|
|
|
and bridging levels, integrated with the
|
|
|
|
|
.Xr ipfw 4
|
|
|
|
|
packet filter, and extended to
|
2002-10-28 07:24:58 +00:00
|
|
|
support multiple queueing and scheduling policies.
|
