WARNING: Work in progress. This is not even in beta stage. Experimental. Not actually working.

A proxy for the bush!

C library and command line tool that emulates network bandwidth and latency for HTTP clients.

Intro

Bushpath's typical job is to be put between an HTTP client (for example a media player) and some kind of server or CDN. Then specific bandwidth and latency scenarios can be emulated for the client to see a specific network behavior.

TODO:

• Runtime configuration
• Tests

Setup

You need:

• GLib 2.0
• GIO library (comes with GLib usually)

On OSX:

You can just brew install glib (or install the GStreamer SDK framework: http://docs.gstreamer.com/display/GstSDK/Installing+on+Mac+OS+X).

On Linux:

Use your favorite package manager to get GLib development files and binaries (headers + static lib archive).

Other platforms:

Have a look at https://wiki.gnome.org/Projects/GLib/SupportedPlatforms and http://www.gtk.org/download/index.php.

Build

NOTE: If you happen to be on OSX and have the GStreamer framework already installed, then just run all these make commands with OSX_GSTREAMER=yes prepended. Thus you will use the headers / binaries included in the framework already and don't need a further install of GLib somewhere else.

Example:

OSX_GSTREAMER=yes make build

Clean & Build CLI (and lib)

make

Build lib only

make lib

Build CLI (and lib)

make cli

Build & Run CLI

make start

Clean

make clean

API & CLI

All build artifacts (with the CLI executable) will be located in the build folder after calling make.

After a library build you will find the exported API header file in the include folder.

Tests

To be done!