---
name: "pppstatus"
section: "1"
platform: "linux"
package: "pppstatus"
version: "0.4.2-10"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/pppstatus"
---

# pppstatus(1)

console-based PPP status monitor

## 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\>

## SEE ALSO

**/usr/share/doc/pppstatus/README.**

## AUTHOR

This manual page was written by Dr. Guenter Bechly \<gbechly@debian.org\> (with improvements by Carlos Valdivia Yagüe \<valyag@teleline.es\>), for the Debian GNU/Linux system (but may be used by others).  Extensive changes by John Hasler \<john@dhh.gt.org\> 2002-2004.