MAN page from RedHat Other pload-0.9.5-2.9.0.i386.rpm

PLOAD

Section: User Commands (1)
Updated:
Index

NAME

pload - display ppp throughput statistics in an X window

SYNOPSIS

pload [-toolkitoption ...] [-minscale n] [-indiv n]
[-outdiv n] [-logscale] [-jumpscroll n] [-update n] [-in] [-out] [-horiz] [-nolabel] [-nochart] [-average n] [-device X] [-hl color] [-incolor color] [-outcolor color] [-noproc] [-ncmsg message][-iformat fmt] [-oformat fmt]

DESCRIPTION

The pload program displays information about network interface (ppp) statistics.Additionally, for Linux 2.2 it can display statistics for any interface thatreports to /proc/net/dev .

OPTIONS

Pload accepts all of the standard X Toolkit command line options (see X(1)).The order of the options in unimportant. Additionally, pload acceptsthe following options:

-minscale n

The minscale option sets the minimum integer number of scale lines to display. The number of divisions will not go below the number specified. The default is 1.

-indiv n

Show dividing lines for a rate of n bytes per second for received data. The default is to show a line every 1024 bytes per second (1 k/s).

-outdiv n

Show dividing lines for a rate of n bytes per second for sent data. The default is to show a line every 1024 bytes per second (1 k/s).

-logscale

The logscale option enables graphing the base 10 logarithm of the rates. This ismost useful for high bandwith devices like ethernet. The -indiv and -outdiv optionsinteract with this option: a scale line will be drawn for 10*div, 100*div,1000*div, ... bytes. The default is to graph linearly.

-jumpscroll n

This option sets number of pixels to shift to the left when the graphreaches the right edge of the window. Smooth scrolling is achieved by the defaultsetting of 1.

-update n

The displayed charts are updated every integer n seconds. The default is toupdate every 1 seconds.

-in

Only show the chart for received data.

-out

Only show the chart for sent data. Default action is to show both charts.

-horiz

Display side by side. Default is to display vertically.

-nolabel

This option suppresses the normal display of the total bytes and current rate label.

-nochart

Don't show the charts. If -nolabel is not set, pload will only show the textlabels. If -nolabel and -nochart are set, pload won't do anything.

-average n

Average or smooth over n number of samples in the calculations of the currentrates for the displayed graphs. The default is to average over 10 points. For a moreinstantaneous response this can be set to 1.

-device X

Monitor this device. The default is ppp0.

-hl color

This option specifies the color of the scale lines.

-incolor color

Set the foreground color for the inbound chart to color. Thedefault is red.

-outcolor color

Set the foreground color for the outbound chart to color. Thedefault is darkgreen.

-fg color

Set the form foreground color to color.

-bg color

Set the background color to color.

-fn fontspec

Set the label font to fontspec.

-noproc

This option is only valid for Linux >=2.2. It disables the default usage of theproc filesystem for gathering device statistics. The more portable ioctl()method is used instead. When -noproc is specified only ppp stats can be read.

-ncmsg message

Display message in the labels when offline. The default is "No Connection".

-iformat fmt

Use string fmt for the inbound label. The fmt string will be displayedliterally with the special tags %t %r and %M expanding to the interface total, currentrate, and maximum rate respectively. The default is "%t %r in".

-oformat fmt

Same as -iformat but for out bound data. The default is "%t %r out".

RESOURCES

All of the options available above and more can be set using the resourcesof the widgets in pload. The following can be added to a user .Xdefaultsor system wide Pload.ad file. Additional customisation can be accomplishedby examining the running executable with editres(1).

  Pload*update                     :1  Pload*ichart.foreground          :red  Pload*ichart.jumpScroll          :1  Pload*ochart.foreground          :darkgreen  Pload*ochart.jumpScroll          :1  Pload*topform*borderWidth        :0  Pload*topform*font               :fixed  Pload.geometry                   :180x200  Pload*showIn                     :True  Pload*showOut                    :True  Pload*device                     :ppp0  Pload*showLabel                  :True  Pload*showChart                  :True  Pload*averagePoints              :10  Pload*inDiv                      :1024  Pload*outDiv                     :1024  Pload*logScale                   :False  Pload*horiz                      :False  Pload*useProc                    :True  Pload*noConnectMsg               :No Connection  Pload*inFormat                   :%t %r in  Pload*outFormat                  :%t %r out

BUGS

Resizing doesn't work right under icewm and kwm with opaque resize turned on. The labels flash. Totals seem to wrap at ULONG_MAX.

COPYRIGHT

AUTHOR

Pload was written by Matt Smith <mdsmithAATTengr.utk.edu> with ideas and help fromChristian Bauer,Scott Berg,David Brownlee,Mathieu Clabaut,Todd Larason,and Roland Smith.

This document was created byman2html,using the manual pages.