1TRICKLED(8)               BSD System Manager's Manual              TRICKLED(8)
2

NAME

4     trickled — userspace bandwidth manager daemon
5

SYNOPSIS

7     trickled [-h] [-v] [-V] [-f] [-s] [-d rate] [-u rate] [-t seconds]
8              [-l length] [-p priority] [-c file] [-n path] [-N seconds]
9              [-w size]
10

DESCRIPTION

12     trickled is a userspace bandwidth manager daemon.  trickled manages sev‐
13     eral trickle(1) sessions at a time, shaping across multiple sessions.
14
15     The options are as follows:
16
17     -v           Increases the verbosity level (can be specified multiple
18                  times).
19
20     -V           Prints version.
21
22     -f           Runs trickled in the foreground.
23
24     -s           Uses syslog for all output (instead of stderr).
25
26     -d rate      Limit the download bandwidth consumption to rate KB/s.
27
28     -u rate      Limit the upload bandwidth consumption to rate KB/s.
29
30     -t seconds   Set smoothing time to seconds s.  The smoothing time deter‐
31                  mines with what intervals trickled will try to let the
32                  application transcieve data.  Smaller values will result in
33                  a more continuous (smooth) session, while larger values may
34                  produce bursts in the sending and receiving data.  Smaller
35                  values (0.1 - 1 s) are ideal for interactive applications
36                  while slightly larger values (1 - 10 s) are better for
37                  applications that need bulk transfer.  This parameter is
38                  customizable on a per-application basis via
39                  trickled.conf(5).  The default value is 5 s.
40
41     -l length    Set smoothing length to length KB.  The smoothing length is
42                  a fallback of the smoothing time.  If trickled cannot meet
43                  the requested smoothing time, it will instead fall back on
44                  sending length KB of data.  The default value is 10 KB.
45
46     -p priority  Set default priority to priority.
47
48     -c file      Use the configuration file file.  This file must be of the
49                  format documented in trickled.conf(5).
50
51     -n path      Set socket name to path.  By default, trickled uses
52                  /tmp/.trickled.sock.
53
54     -N seconds   Notifies user of total bandwidth consumption every seconds
55                  s.
56
57     -w size      Set peak detection window size to size KB.  This determines
58                  how aggressive trickled is at eliminating bandwidth consump‐
59                  tion peaks.  Lower values will be more aggressive, but may
60                  also result in over shaping.  The default value (512 KB) is
61                  usually sufficient.
62

EXAMPLES

64     trickled -u 10 -d 20
65
66     Limit aggregate trickle(1) upload bandwidth consumption to 10 KB/s and
67     download consumption to 20 KB/s.
68

SEE ALSO

70     trickle(1), trickled.conf(5), syslog(3), netintro(4)
71

AUTHORS

73     trickled has been developed by Marius Aamodt Eriksen ⟨marius@monkey.org⟩.
74
75BSD                            February 27, 2003                           BSD
Impressum