Free Knowledge Resources


Linux Manual Pages


Free Software * Books

Source Code

Free Media

Linux

shorewall6-tcdevices(5)

NAME

   tcdevices - Shorewall6 Traffic Shaping Devices file

SYNOPSIS

   /etc/shorewall6/tcdevices

DESCRIPTION

   Entries in this file define the bandwidth for interfaces on which you
   want traffic shaping to be enabled.

   If you do not plan to use traffic shaping for a device, don't put it in
   here as it limits the throughput of that device to the limits you set
   here.

   A note on the bandwidth definitions used in this file:

   *   don't use a space between the integer value and the unit: 30kbit is
       valid while 30 kbit is not.

   *   you can use one of the following units:

       kbps
           Kilobytes per second.

       mbps
           Megabytes per second.

       kbit
           Kilobits per second.

       mbit
           Megabits per second.

       bps or number
           Bytes per second.

   *   Only whole integers are allowed.

   The columns in the file are as follows (where the column name is
   followed by a different name in parentheses, the different name is used
   in the alternate specification syntax).

   INTERFACE - [number:]interface
       Name of interface. Each interface may be listed only once in this
       file. You may NOT specify the name of an alias (e.g., eth0:0) here;
       see http://www.shorewall.net/FAQ.htm#faq18[1]

       You may NOT specify wildcards here, e.g. if you have multiple ppp
       interfaces, you need to put them all in here!

       If the device doesn't exist, a warning message will be issued
       during "shorewall6 [re]start" and "shorewall6 refresh" and traffic
       shaping configuration will be skipped for that device.

       Shorewall6 assigns a sequential interface number to each interface
       (the first entry in the file is interface 1, the second is
       interface 2 and so on) Beginning with Shorewall6-perl 4.1.6, you
       can explicitly specify the interface number by prefixing the
       interface name with the number and a colon (":"). Example: 1:eth0.

   IN-BANDWIDTH (in_bandwidth) -
   {-|bandwidth[:burst]|~bandwidth[:interval:decay_interval]}
       The incoming bandwidth of that interface. Please note that you are
       not able to do traffic shaping on incoming traffic, as the traffic
       is already received before you could do so. But this allows you to
       define the maximum traffic allowed for this interface in total, if
       the rate is exceeded, the packets are dropped. You want this mainly
       if you have a DSL or Cable connection to avoid queuing at your
       providers side.

       If you don't want any traffic to be dropped, set this to a value to
       zero in which case Shorewall will not create an ingress qdisc.Must
       be set to zero if the REDIRECTED INTERFACES column is non-empty.

       The optional burst option was added in Shorewall 4.4.18. The
       default burst is 10kb. A larger burst can help make the bandwidth
       more accurate; often for fast lines, the enforced rate is well
       below the specified bandwidth.

       What is described above creates a rate/burst policing filter.
       Beginning with Shorewall 4.4.25, a rate-estimated policing filter
       may be configured instead. Rate-estimated filters should be used
       with Ethernet adapters that have Generic Receive Offload enabled by
       default. See Shorewall FAQ 97a[2].

       To create a rate-estimated filter, precede the bandwidth with a
       tilde ("~"). The optional interval and decay_interval determine how
       often the rate is estimated and how many samples are retained for
       estimating. Please see
       http://ace-host.stuart.id.au/russell/files/tc/doc/estimators.txt
       for details.

   OUT-BANDWIDTH (out_bandwidth) - bandwidth
       The outgoing bandwidth of that interface. This is the maximum speed
       your connection can handle. It is also the speed you can refer as
       "full" if you define the tc classes in shorewall6-tcclasses[3](5).
       Outgoing traffic above this rate will be dropped.

   OPTIONS -
   {-|{classify|htb|hfsc|linklayer={ethernet|atm|adsl}|tsize=tsize|mtu=mtu|mpu=mpu|overhead=overhead}
   ,...}
       classify --- When specified, Shorewall will not generate tc or
       Netfilter rules to classify traffic based on packet marks. You must
       do all classification using CLASSIFY rules in
       shorewall6-tcrules[4](5).

       htb - Use the Hierarchical Token Bucket queuing discipline. This is
       the default.

       hfsc - Shorewall normally uses the Hierarchical Token Bucket
       queuing discipline. When hfsc is specified, the Hierarchical Fair
       Service Curves discipline is used instead(see tc-hfsc (7)).

       linklayer - Added in Shorewall 4.5.6. Type of link (ethernet, atm,
       adsl). When specified, causes scheduler packet size manipulation as
       described in tc-stab (8). When this option is given, the following
       options may also be given after it: mtu=mtu - The device MTU;
       default 2048 (will be rounded up to a power of two)

       mpu=mpubytes - Minimum packet size used in calculations. Smaller
       packets will be rounded up to this size

       tsize=tablesize - Size table entries; default is 512

       overhead=overheadbytes - Number of overhead bytes per packet.

   REDIRECTED INTERFACES (redirect) - [interface[,interface]...]
       Added in Shorewall6-perl 4.1.6. May only be specified if the
       interface in the INTERFACE column is an Intermediate Frame Block
       (IFB) device. Causes packets that enter each listed interface to be
       passed through the egress filters defined for this device, thus
       providing a form of incoming traffic shaping. When this column is
       non-empty, the classify option is assumed.

EXAMPLES

   Example 1:
       Suppose you are using PPP over Ethernet (DSL) and ppp0 is the
       interface for this. The device has an outgoing bandwidth of 500kbit
       and an incoming bandwidth of 6000kbit

                   #INTERFACE   IN-BANDWIDTH    OUT-BANDWIDTH         OPTIONS         REDIRECTED
                   #                                                                  INTERFACES
                   1:ppp0         6000kbit        500kbit

FILES

   /etc/shorewall6/tcdevices

SEE ALSO

   tc-hfsc (7)

   http://www.shorewall.net/traffic_shaping.htm[5]

   http://ace-host.stuart.id.au/russell/files/tc/doc/estimators.txt

   shorewall6(8), shorewall6-accounting(5), shorewall6-actions(5),
   shorewall6-blacklist(5), shorewall6-hosts(5), shorewall6-interfaces(5),
   shorewall6-maclist(5), shorewall6-netmap(5),shorewall6-params(5),
   shorewall6-policy(5), shorewall6-providers(5), shorewall6-rtrules(5),
   shorewall6-routestopped(5), shorewall6-rules(5), shorewall6.conf(5),
   shorewall6-secmarks(5), shorewall6-tcclasses(5), shorewall6-mangle(5),
   shorewall6-tos(5), shorewall6-tunnels(5), shorewall6-zones(5)

NOTES

    1. http://www.shorewall.net/FAQ.htm#faq18
       http://www.shorewall.net/FAQ.htm#faq18

    2. Shorewall FAQ 97a
       http://www.shorewall.net/FAQ.htm#faq97a

    3. shorewall6-tcclasses
       http://www.shorewall.net/manpages6/shorewall6-tcclasses.html

    4. shorewall6-tcrules
       http://www.shorewall.net/manpages6/shorewall6-tcrules.html

    5. http://www.shorewall.net/traffic_shaping.htm
       http://www.shorewall.net/traffic_shaping.htm



Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.


Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.


Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.


Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.


birds banner