xpppoem_helptext

适用于linux2.4版本内核的pppoe监控程序源代码

usage:  xpppoem [-options ...]

xload lookalike program displaying a histogram of DSL throughput.

where options include:
    -display dpy        X server on which to display
    -geometry geom      size and location of window
    -nolabel            do not show a headline over histogram
    -nograph            do not show histogram but only a color pad
    -fn font            font to use in label
    -unit number        data rate representing one scale unit
                        the default value is 20000
    -scale number       minimum number of scale lines
    -update seconds     interval between updates
    -bg color           background color of text label
    -fg color           graph color
    -hl color           scale and text color
    -online color       background color when online
    -busy color|off     indicate throughput by changing colors
                        based on -busy_samples average. 0 cps will
                        show the -online color. The value given
                        with -cps_range shows the -busy color.
                        Color "off" disables color changing.
    -busy_samples value  number of samples for changing colors
                        (default: 15)
    -cps_range value    upper cps limit of a color scale defined
                        with -online and -busy (default: 90000)
                        Note: if this value is larger than the
                        largest "-show" number, the eternal average
                        of the connection determines the color.
    -offline color      background color when offline
    -jumpscroll value   number of pixels to scroll on overflow

This program monitors the DSL connection of a Linux kernel 2.4.4
by reading the files /proc/net/pppoe and /proc/net/dev once a second.
It prints a status report on stderr once per second and a change
notification on stdout each time the connection changes its state.
The status report is a text line containing the fields :
'State' which is either 'DSL OFF' or 'DSL ON' or a device name
'Time (local)' which is a timestamp like 'YYMMDD.hhmmss'
'1s' , '15s' , '300s' show the average bytes-per-second for the last
 1, 15 resp. 300 samples (resp. -1 until valid).
'total =  bytes / uptime' shows a summary since the connection went ON:
 bytes-per-second = sent plus received bytes / life time in seconds
Snapshot of Tue Oct 23 16:08:18 CEST 2001 :
 State    Time (local)      1s     15s    300s   total =  bytes / uptime
DSL ON   A11023.160818   53410   37265      -1   22145 =  5712k / 264s

Options of pppoem :
  -dev_name name
         Set the name of the device line in /proc/net/dev which shall
         be watched to obtain throughput information. If name is given
         as "-" then it will be read from /proc/net/pppoe when the
         connection is in state ON (this is the default setting).
  -pretend on|off
         If set to "on" ignore /proc/net/pppoe and always watch in
         /proc/net/dev the device given with -dev_name . The state is
         like permanent ON but the -dev_name gets displayed instead.
         One may monitor non-pppoe net devices like "lo" this way.
         It might even work with older kernels.
  -listen_stdin on|off
         If set to "on" ignore /proc . Listen for messages at stdin:
         "%ld %s %lf %lf" = is_on, dev_name, timestamp, count
         (is_on: 0=OFF,1=ON,2=-pretend, timestamp: seconds since 1970)
  -report  on|off|forward
         Control reporting on stdout and stderr. "off" disables all
         regular messages. "on" is the normal mode. "forward"
         prints messages to stdout suitable for -listen_stdin "on".
  -show  number:number:number
         Set the numbers of samples to be shown for the three gliding
         averages shown in the status line. Default is 1:15:300 .
  -help
         Print this text to stderr.