share/man/man4/dummynet.4

   1 .\"
   2 .\" $FreeBSD: src/share/man/man4/dummynet.4,v 1.4.2.12 2002/11/18 21:51:16 luigi Exp $
   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 .Em dummynet
  12 is a system facility that permits the control of traffic
  13 going through the various network interfaces, by applying bandwidth
  14 and queue size limitations, implementing different scheduling and queue
  15 management policies, and emulating delays and losses.
  16 .Pp
  17 The user interface for
  18 .Em dummynet
  19 is implemented by the
  20 .Nm ipfw
  21 program, so the reader is referred to the
  22 .Xr ipfw 8
  23 manpage for a complete description of the capabilities of
  24 .Nm
  25 and on how to use it.
  26 .Sh KERNEL OPTIONS
  27 The following options in the kernel configuration file are related to
  28 .Nm
  29 operation:
  30 .Bd -literal
  31   IPFIREWALL               - enable ipfirewall (required for dummynet).
  32   IPFIREWALL_VERBOSE       - enable firewall output.
  33   IPFIREWALL_VERBOSE_LIMIT - limit firewall output.
  34   DUMMYNET                 - enable dummynet operation.
  35   NMBCLUSTERS              - set the amount of network packet buffers
  36 .Ed
  37 .Pp
  38 Generally, the following options are required:
  39 .Bd -literal
  40   options IPFIREWALL
  41   options DUMMYNET
  42 .Ed
  43 .Pp
  44 additionally, one may want to increase the number
  45 of mbuf clusters (used to store network packets) according to the
  46 sum of the bandwidth-delay products and queue sizes of all configured
  47 pipes.
  48 Timer granularity is controlled by
  49 .Xr sysctl 8
  50 variable
  51 .Va net.inet.ip.dummynet.hz ,
  52 which is set to 1000 by default.
  53 .Sh SEE ALSO
  54 .Xr setsockopt 2 ,
  55 .Xr bridge 4 ,
  56 .Xr ip 4 ,
  57 .Xr ipfw 8 ,
  58 .Xr sysctl 8
  59 .Sh HISTORY
  60 .Nm
  61 was initially implemented as a testing tool for TCP congestion control
  62 by
  63 .An Luigi Rizzo Aq Mt luigi@iet.unipi.it ,
  64 as described on ACM Computer Communication Review, Jan.97 issue.
  65 Later it has been then modified to work at the ip and bridging
  66 level, integrated with the IPFW packet filter, and extended to
  67 support multiple queueing and scheduling policies.