pppstatus(1)

pppstatus1

Console-based ppp status monitor

Usage

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

Overview

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>

Releases

5 releases since Debian 3.0 (Woody); the text changed 2 times.

  1. 3.0
  2. 3.1–4.0
  3. 5.0–6.0

-d since Debian 3.1 (Sarge).

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.

From pppstatus 0.4.2-10 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.