2014-09-14 17:57:15 +00:00
|
|
|
.\" -*-Nroff-*-
|
|
|
|
|
.\"
|
|
|
|
|
.TH wmppp.app 1 "September 1998" "Debian Project" "Debian GNU/Linux"
|
|
|
|
|
.SH NAME
|
|
|
|
|
wmppp \- Graphically monitor the average PPP load
|
|
|
|
|
.P
|
|
|
|
|
.SH SYNOPSIS
|
2015-05-20 03:31:08 +00:00
|
|
|
.B wmppp [OPTIONS]
|
2014-09-14 17:57:15 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
|
\fBwmppp.app\fP displays a dynamic representation of the load on the
|
|
|
|
|
PPP line on a 64x64 miniwindow. It also starts and stops the
|
|
|
|
|
connection and displays the time enlapsed since the it came up. The
|
|
|
|
|
traffic on the interface is also monitored.
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
|
|
|
|
.B \-display <display\ name>
|
|
|
|
|
name of display to use
|
|
|
|
|
.TP
|
2015-05-20 03:31:08 +00:00
|
|
|
.B \-geometry +XPOS+YPOS
|
|
|
|
|
initial window position
|
|
|
|
|
.TP
|
2014-09-14 17:57:15 +00:00
|
|
|
.B \-t
|
|
|
|
|
sets the on-line timer to display MM:SS instead of the default HH:MM.
|
|
|
|
|
.TP
|
|
|
|
|
.B \-u <update rate>
|
|
|
|
|
sets the frequency, in seconds, for updates to the display. Valid
|
|
|
|
|
range is 1-10, default value is 5.
|
|
|
|
|
.TP
|
|
|
|
|
.B \-i <device>
|
|
|
|
|
choose the net device (ppp1, ippp0, etc.) to monitor. (Note that this
|
|
|
|
|
feature is EXPERIMENTAL and should be used with caution. Bug reports
|
|
|
|
|
are welcomed.)
|
|
|
|
|
.TP
|
2015-05-20 03:31:08 +00:00
|
|
|
.B \-speed <cmd>
|
|
|
|
|
command to report connection speed
|
|
|
|
|
.TP
|
|
|
|
|
.B \-start <cmd>
|
|
|
|
|
command to connect
|
|
|
|
|
.TP
|
|
|
|
|
.B \-stop <cmd>
|
|
|
|
|
command to disconnect
|
|
|
|
|
.TP
|
|
|
|
|
.B \-ifdown <cmd>
|
|
|
|
|
command to redial
|
|
|
|
|
.TP
|
|
|
|
|
.B \-stampfile <path>
|
|
|
|
|
file used to calculate uptime
|
|
|
|
|
.TP
|
2014-09-14 17:57:15 +00:00
|
|
|
.B \-h
|
|
|
|
|
displays a command line summary
|
|
|
|
|
.TP
|
|
|
|
|
.B \-v
|
|
|
|
|
displays the version number.
|
|
|
|
|
.SH CONFIGURATION
|
|
|
|
|
The configuration file (see below) may contain any of the following
|
2015-05-20 03:31:08 +00:00
|
|
|
key-value pairs. The format is \fIkey: value\fP. Note that these values will be
|
|
|
|
|
overwritten by the corresponding command line options.
|
2014-09-14 17:57:15 +00:00
|
|
|
.TP
|
|
|
|
|
.I start
|
|
|
|
|
The program that starts the connection
|
|
|
|
|
.TP
|
|
|
|
|
.I stop
|
|
|
|
|
The program that stops the connection
|
|
|
|
|
.TP
|
|
|
|
|
.I speed
|
|
|
|
|
This program reports the speed of the connection. This program should
|
|
|
|
|
output \fI<speed>\fP, that is, a \fInumber\fP is expected and not the
|
|
|
|
|
whole \"CONNECT\" line the modem outputs.
|
|
|
|
|
.TP
|
|
|
|
|
.I ifdown
|
|
|
|
|
This program is run if the line goes down, and the \fIstop\fP program
|
|
|
|
|
hasn't been run. (Redial program)
|
|
|
|
|
.TP
|
|
|
|
|
.I stampfile
|
|
|
|
|
The modification time of this file is used to calculate the amount of
|
|
|
|
|
time the connection has been up. Something like \fItouch <stampfile>\fP
|
|
|
|
|
should be run for this to work.
|
|
|
|
|
.SH FILES
|
|
|
|
|
.TP
|
|
|
|
|
/var/run/wmppp.\fIppp0\fP
|
2015-05-20 03:30:57 +00:00
|
|
|
this is the stamp file use to determine the amount of time enlapsed
|
2014-09-14 17:57:15 +00:00
|
|
|
since the connection came up. This file should be managed by the ip-up
|
|
|
|
|
and ip-down scripts. On Debian systems, \fI/etc/ppp/ip-up.d/00wmppp\fP
|
|
|
|
|
creates the file, and \fI/etc/ppp/ip-down.d/00wmppp\fP removes it.
|
|
|
|
|
.TP
|
|
|
|
|
/etc/wmppprc
|
|
|
|
|
System wide defaults
|
|
|
|
|
.TP
|
|
|
|
|
$HOME/.wmppprc
|
|
|
|
|
User defined settings
|
|
|
|
|
.TP
|
|
|
|
|
/etc/wmppprc.fixed
|
|
|
|
|
System wide fixed options, this overrides the user settings
|
|
|
|
|
.SH AUTHORS
|
|
|
|
|
\fBwmppp.app\fP was written by \fIMartijn Pieterse
|
|
|
|
|
<pieterse@xs4all.nl>\fP and \fIAntoine Nulle <warp@xs4all.nl>\fP, and
|
|
|
|
|
it's based on work by \fIBeat Christen <bchriste@iiic.ethz.ch>\fP
|
|
|
|
|
(asclock) and \fIMichael Callahan <callahan@maths.ox.ac.uk>\fP, \fIAl
|
|
|
|
|
Longyear longyear@netcom.com\fP and \fIPaul Mackerras
|
|
|
|
|
<Paul.Mackerras@cs.anu.edu.au>\fP (pppstats).
|
|
|
|
|
.P
|
|
|
|
|
Email regarding wmppp should be sent to
|
2018-05-14 15:53:13 +00:00
|
|
|
\fIwmaker-dev@googlegroups.com\fP.
|
2014-09-14 17:57:15 +00:00
|
|
|
.P
|
|
|
|
|
This manpage was written by \fIMarcelo Magallon
|
|
|
|
|
<mmagallo@debian.org\fP for the \fIDebian Project\fP
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.BR pppd (8),
|
|
|
|
|
.BR pppstats (8),
|
|
|
|
|
.BR plog (1),
|
|
|
|
|
.BR pon (1),
|
|
|
|
|
.BR poff (1)
|
|
|
|
|
|
