bert hubert ahu@ds9a.nl http://lartc.org/wondershaper (c) Copyright 2002 Simon Séhier simon@sehier.fr - Camptocamp (c) Copyright 2015 - HTB magnific0 http://www.github.com/magnific0 (c) Copyright 2012-2017 Licenced under the GPL

Wonder Shaper is a script that allow the user to limit the bandwidth of one or more network adapters. It does so by using iproute's tc command, but greatly simplifies its operation. Wonder Shaper was first released by Bert Hubert in 2002, but the original version lacked a command-line interface, from on version 1.2 this feature was added. From version 1.3, the HTB queing is used instead of CBQ, allowing better bandwith managment on high speed (above ten megabits) links. In version 1.4 an improved ingress shaping method was implemented and the ability to limit either down or up (both is still possible too). The original README is a rather lengthy document and is saved under README.old, for those who'd like some more background information. Except any notes on operation this document is considered up-to-date.

You can run wondershaper (as any user with sufficient permissions) without installation. However if you want to install the script onto your system you can simply run:

    sudo make install

wondershaper [-hcs] [-a <adapter>] [-d <rate>] [-u <rate>]

The following command line options are allowed:

• -h Display help

• -a <adapter> Set the adpter

• -d <rate> Set maximum download rate (in Kbps) and/or

• -u <rate> Set maximum upload rate (in Kbps)

• -p Use the presets in /etc/conf.d/wondershaper.conf

• -c Clear the limits from adapter

• -s Show the current status of adapter

The different modes are:

wondershaper -a <adapter> -d <rate> -u <rate>

wondershaper -c -a <adapter>

wondershaper -s -a <adapter>

Some examples:

wondershaper -a eth0 -d 1024 -u 512

wondershaper -a eth1 -d 94000 -u 94000  # could be used on a 100Mbps link

wondershaper -a eth1 -u 94000  # only limit upload

wondershaper -c -a eth0