1SHOREWALL6-TCDEVICE(5) [FIXME: manual] SHOREWALL6-TCDEVICE(5)
2
6 tcdevices - Shorewall6 Traffic Shaping Devices file
7
9 /etc/shorewall6/tcdevices
10
12 Entries in this file define the bandwidth for interfaces on which you
13 want traffic shaping to be enabled.
14 If you do not plan to use traffic shaping for a device, don't put it in
16 here as it limits the throughput of that device to the limits you set
17 here.
18 A note on the bandwidth definitions used in this file:
20 · don't use a space between the integer value and the unit: 30kbit is
22 valid while 30 kbit is not.
23 · you can use one of the following units:
25 kbps
27 Kilobytes per second.
28 mbps
30 Megabytes per second.
31 kbit
33 Kilobits per second.
34 mbit
36 Megabits per second.
37 bps or number
39 Bytes per second.
40 · Only whole integers are allowed.
42 The columns in the file are as follows.
44 INTERFACE - [number:]interface
46 Name of interface. Each interface may be listed only once in this
47 file. You may NOT specify the name of an alias (e.g., eth0:0) here;
48 see http://www.shorewall.net/FAQ.htm#faq18
49 You may NOT specify wildcards here, e.g. if you have multiple ppp
51 interfaces, you need to put them all in here!
52 If the device doesn't exist, a warning message will be issued
54 during "shorewall6 [re]start" and "shorewall6 refresh" and traffic
55 shaping configuration will be skipped for that device.
56 Shorewall6 assigns a sequential interface number to each interface
58 (the first entry in the file is interface 1, the second is
59 interface 2 and so on) Beginning with Shorewall6-perl 4.1.6, you
60 can explicitly specify the interface number by prefixing the
61 interface name with the number and a colon (":"). Example: 1:eth0.
62 IN-BANDWIDTH - bandwidth[:burst]
64 The incoming bandwidth of that interface. Please note that you are
65 not able to do traffic shaping on incoming traffic, as the traffic
66 is already received before you could do so. But this allows you to
67 define the maximum traffic allowed for this interface in total, if
68 the rate is exceeded, the packets are dropped. You want this mainly
69 if you have a DSL or Cable connection to avoid queuing at your
70 providers side.
71 If you don't want any traffic to be dropped, set this to a value to
73 zero in which case Shorewall6 will not create an ingress qdisc.Must
74 be set to zero if the REDIRECTED INTERFACES column is non-empty.
75 The optional burst option was added in Shorewall6 4.4.18. The
77 default burst is 10kb. A larger burst can help make the bandwidth
78 more accurate; often for fast lines, the enforced rate is well
79 below the specified bandwidth.
80 OUT-BANDWIDTH - bandwidth
82 The outgoing bandwidth of that interface. This is the maximum speed
83 your connection can handle. It is also the speed you can refer as
84 "full" if you define the tc classes in shorewall6-tcclasses[1](5).
85 Outgoing traffic above this rate will be dropped.
86 OPTIONS - {-|{classify|hfsc} ,...}
88 classify — When specified, Shorewall will not generate tc or
89 Netfilter rules to classify traffic based on packet marks. You must
90 do all classification using CLASSIFY rules in
91 shorewall-tcrules[2](5).
92 hfsc - Shorewall normally uses the Hierarchical Token Bucket
94 queuing discipline. When hfsc is specified, the Hierarchical Fair
95 Service Curves discipline is used instead.
96 REDIRECTED INTERFACES - [interface[,interface]...]
98 Added in Shorewall6-perl 4.1.6. May only be specified if the
99 interface in the INTERFACE column is an Intermediate Frame Block
100 (IFB) device. Causes packets that enter each listed interface to be
101 passed through the egress filters defined for this device, thus
102 providing a form of incoming traffic shaping. When this column is
103 non-empty, the classify option is assumed.
104
106 Example 1:
107 Suppose you are using PPP over Ethernet (DSL) and ppp0 is the
108 interface for this. The device has an outgoing bandwidth of 500kbit
109 and an incoming bandwidth of 6000kbit
110 #INTERFACE IN-BANDWIDTH OUT-BANDWIDTH OPTIONS REDIRECTED
112 # INTERFACES
113 1:ppp0 6000kbit 500kbit
114
116 /etc/shorewall6/tcdevices
117
119 http://shorewall.net/traffic_shaping.htm
120 shorewall6(8), shorewall6-accounting(5), shorewall6-actions(5),
122 shorewall6-blacklist(5), shorewall6-hosts(5), shorewall6-interfaces(5),
123 shorewall6-maclist(5), shorewall6-params(5), shorewall6-policy(5),
124 shorewall6-providers(5), shorewall6-route_rules(5),
125 shorewall6-routestopped(5), shorewall6-rules(5), shorewall6.conf(5),
126 shorewall6-secmarks(5), shorewall6-tcclasses(5), shorewall6-tcrules(5),
127 shorewall6-tos(5), shorewall6-tunnels(5), shorewall6-zones(5)
128
130 1. shorewall6-tcclasses
131 http://www.shorewall.net/manpages6/shorewall6-tcclasses.html
132 2. shorewall-tcrules
134 http://www.shorewall.net/manpages6/shorewall-tcrules.html
135[FIXME: source] 09/16/2011 SHOREWALL6-TCDEVICE(5)