PPPLOAD(1)

NAME
pppload - display an xload-style graph of PPP activity

SYNOPSIS
pppload [-cmd ppp_cmd] [-i interval] [-device name] [-p period] [-retry interval] [-rx] [-norx] [-rxcolor color] [-tx] [-notx] [-txcolor color]

DESCRIPTION
pppload displays a graph of PPP transmit and receive throughput in a style similar to xload(1). pppload displays the average transmit and receive throughput in bytes per second. For every 512bps, a horizontal line is drawn. The graph autoscales to fit the maximum transmit or receieve rate. In the upper-left corner, the total number of bytes transamitted and received is shown.

  OPTIONS

-cmd ppp_cmd
    The command used to start the PPP link. If the PPP link is not up, or happens to fails, this command will be used to restart it.

-d n
    Draw a horizontal divider for every 'n' bytes per second of throughput (default: 512).

-h  Print command line usage.

-device name
    Network device to monitor (default: tun)

-i interval
    The statistics polling interval in seconds (default: 5).

-link link
    The PPP link number to be monitored (default: 0).

-p period
    The load averaging period in seconds (default: 60). The actual number of samples that are averaged is equal to period / interval.

-retry interval
    The time between retries when dialling the PPP link (default: 60).

-rx Enable drawing of receive rates (default).

-norx
    Disable drawing of receive rates.

-rxcolor color
    The name of the color to draw receive rates in (default: forestgreen).

-tx Enable drawing of transmit rates (default).

-notx
    Disable drawing of transmit rates.

-txcolor color
    The name of the color to draw transmit rates in (default: red).

AUTHOR
Sean Vyain <svyain@mail.tds.net, smvyain@softart.com> www.geocities.com/SiliconValley/Pines/1029/pppload.html

FREEBSD PORT
Examples of usage for the FreeBSD port: For tun0 (tun is the default device,0 is the default link number): % pppload & For the first ne2000 ethernet card: % pppload -device ed -link 0 & for the third ppp device: % pppload -device ppp -link 2 &

BUGS
The port to FreeBSD can't determine when the link is up or down, so some of the command line options like -cmd -percmd may not work. Command line is awkward with -device and -link. Keeps track of all packets network device has ever used, even if it has gone down then up again. This is different than the linux version. Requires awk, grep, and netstat to get the data. Very short polling times are definitely not recommended. Network interface names are limited to a total of 4 characters or less at the moment, e.g. ppp0 ed3 ze1.

Modified January 1998