share/man/man4/dummynet.4

   1 .\"
   2 .\" $FreeBSD$
   3 .\"
   4 .Dd October 28, 2002
   5 .Dt DUMMYNET 4
   6 .Os
   7 .Sh NAME
   8 .Nm dummynet
   9 .Nd traffic shaper, bandwidth manager and delay emulator
  10 .Sh DESCRIPTION
  11 The
  12 .Nm
  13 system facility permits the control of traffic
  14 going through the various network interfaces, by applying bandwidth
  15 and queue size limitations, implementing different scheduling and queue
  16 management policies, and emulating delays and losses.
  17 .Pp
  18 The user interface for
  19 .Nm
  20 is implemented by the
  21 .Xr ipfw 8
  22 utility, so please refer to the
  23 .Xr ipfw 8
  24 manpage for a complete description of the
  25 .Nm
  26 capabilities and how to use it.
  27 .Ss Kernel Options
  28 The following options in the kernel configuration file are related to
  29 .Nm
  30 operation:
  31 .Pp
  32 .Bl -tag -width ".Dv IPFIREWALL_VERBOSE_LIMIT" -offset indent -compact
  33 .It Dv IPFIREWALL
  34 enable ipfirewall (required for
  35 .Nm )
  36 .It Dv IPFIREWALL_VERBOSE
  37 enable firewall output
  38 .It Dv IPFIREWALL_VERBOSE_LIMIT
  39 limit firewall output
  40 .It Dv DUMMYNET
  41 enable
  42 .Nm
  43 operation
  44 .It Dv HZ
  45 set the timer granularity
  46 .El
  47 .Pp
  48 Generally, the following options are required:
  49 .Bd -literal -offset indent
  50 options IPFIREWALL
  51 options DUMMYNET
  52 options HZ=1000         # strongly recommended
  53 .Ed
  54 .Pp
  55 Additionally, one may want to increase the number
  56 of mbuf clusters (used to store network packets) according to the
  57 sum of the bandwidth-delay products and queue sizes of all configured
  58 pipes.
  59 .Sh SEE ALSO
  60 .Xr setsockopt 2 ,
  61 .Xr if_bridge 4 ,
  62 .Xr ip 4 ,
  63 .Xr ipfw 8 ,
  64 .Xr sysctl 8
  65 .Sh HISTORY
  66 The
  67 .Nm
  68 facility
  69 was initially implemented as a testing tool for
  70 .Tn TCP
  71 congestion control by
  72 .An Luigi Rizzo Aq luigi@iet.unipi.it ,
  73 as described on ACM Computer Communication Review, Jan.97 issue.
  74 Later it has been modified to work at the
  75 .Tn IP
  76 and bridging levels, integrated with the
  77 .Xr ipfw 4
  78 packet filter, and extended to
  79 support multiple queueing and scheduling policies.