pppstatus(1) console-based PPP status monitor


pppstatus [ -i <interface> ] [ -v vga|mono ] [ -s <speed> ] [ -d <console> ] [ --bytes ] [ --packets ]
     [ --errors ] [ --time ] [ --ipaddress ] [ --costs ]


This manual page documents briefly the pppstatus command. This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page.

pppstatus is a console-based utility for displaying the status of a PPP link, including connection verification, connecting time, costs calculation, top speed, e-mail check, ip address, graphical statistics, TX and RX leds, interface selection, and more. It even supports xDSL with pppoe.

There are two config for pppstatus: /etc/pppstatus/pppstatus.cfg which is always read first, and ~/.pppstatus/pppstatus.cfg which is read when the user is not root.

For further hints see /usr/share/doc/pppstatus/README.


The following options are available.
-i <interface>
Specify active interface to use. <interface> is one of ppp0, ppp1, etc.
-v vga|mono
Select video mode.
-s <speed>
Set your online connection speed. <speed> is 33.6, 56, etc.
-d <console>
Make pppstatus a daemon. <console> is the console to display on: 10 for /dev/tty/10, 11 for /dev/tty11, etc.
Display statistics about bytes transmitted and received.
Display statistics about packets transmitted and received.
Display error information.
Show your IP address.
Calculate costs of current connection and costs of all connections on current month according to your provider's tariffs.


Redraw the display.


In daemon mode HUP causes the config file to be reread. In other modes the program cleans up and exits.


/etc/pppstatus/pppstatus.cfg, /etc/pppstatus/costs, /etc/pppstatus/no_pppstatus_on_boot, /var/log/pppstatus/pppstatus.<interface>.<date>, /var/log/pppstatus/total.costs.<date>, ~/.pppstatus/pppstatus.cfg, ~/.pppstatus/costs, ~/.pppstatus/pppstatus.<interface>.<date>, ~/.pppstatus/total.costs.<date>


This manual page was written by Dr. Guenter Bechly <[email protected]> (with improvements by Carlos Valdivia Yagüe <[email protected]>), for the Debian GNU/Linux system (but may be used by others). Extensive changes by John Hasler <[email protected]> 2002-2004.