pppstatus(1)

NAME

pppstatus - console-based PPP status monitor

SYNOPSIS

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

DESCRIPTION

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.

OPTIONS

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.

--bytes: Display statistics about bytes transmitted and received.

--packets: Display statistics about packets transmitted and received.

--errors: Display error information.

--ipaddress: Show your IP address.

--costs: Calculate costs of current connection and costs of all connections on current month according to your provider's tariffs.

COMMANDS

r: Redraw the display.

q: Quit.

SIGNALS

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

FILES

/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>

AUTHOR

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.