pon(1) — Linux manual page


PON(1)                         Debian PPPD                        PON(1)

NAME         top

       pon, poff, plog - starts up, shuts down or lists the log of PPP

SYNOPSIS         top

       pon [ isp-name [ options ] ]
       poff [ -r ] [ -d ] [ -c ] [ -a ] [ -h ] [ isp-name ]
       plog [ arguments ]

DESCRIPTION         top

       This manual page describes the pon, plog and poff scripts, which
       allow users to control PPP connections.

       pon, invoked without arguments, runs the /etc/ppp/ppp_on_boot
       file, if it exists and is executable. Otherwise, a PPP connection
       will be started using configuration from /etc/ppp/peers/provider.
       This is the default behaviour unless an isp-name argument is

       For instance, to use ISP configuration "myisp" run:

              pon myisp

       pon will then use the options file /etc/ppp/peers/myisp.  You can
       pass additional options after the ISP name, too.  pon can be used
       to run multiple, simultaneous PPP connections.

       poff closes a PPP connection. If more than one PPP connection
       exists, the one named in the argument to poff will be killed,

              poff myprovider2

       will terminate the connection to myprovider2, and leave the PPP
       connections to e.g. "myprovider1" or "myprovider3" up and

       poff takes the following command line options:

              -r     causes the connection to be redialed after it is

              -d     toggles the state of pppd's debug option.

              -c     causes pppd(8) to renegotiate compression.

              -a     stops all running ppp connections. If the argument
                     isp-name is given it will be ignored.

              -h     displays help information.

              -v     prints the version and exits.

              If no argument is given, poff will stop or signal pppd if
              and only if there is exactly one running. If more than one
              connection is active, it will exit with an error code of

       plog shows you the last few lines of /var/log/ppp.log. If that
       file doesn't exist, it shows you the last few lines of your
       /var/log/syslog file, but excluding the lines not generated by
       pppd.  This script makes use of the tail(1) command, so arguments
       that can be passed to tail(1) can also be passed to plog.

       Note: the plog script can only be used by root or another system
       administrator in group "adm", due to security reasons. Also, to
       have all pppd-generated information in one logfile, that plog can
       show, you need the following line in your /etc/syslog.conf file:

       local2.*       -/var/log/ppp.log

FILES         top

              PPPd system options file.

              System PAP passwords file.

              System CHAP passwords file.

              Directory holding the peer options files. The default file
              is called provider.

              The chat script invoked from the default

              The default PPP log file.

AUTHORS         top

       The p-commands were written by Christoph Lameter
       <clameter@debian.org>.  Updated and revised by Philip Hands
       This manual was written by Othmar Pasteka <othmar@tron.at>.
       Modified by Rob Levin <lilo@openprojects.net>, with some
       extensions taken from the old p-commands manual written by John
       Hasler <jhasler@debian.org>.

SEE ALSO         top

       pppd(8), chat(8), tail(1).

COLOPHON         top

       This page is part of the ppp (An implementation of the Point-to-
       Point Protocol (PPP)) project.  Information about the project can
       be found at ⟨https://ppp.samba.org/⟩.  If you have a bug report
       for this manual page, see
       ⟨https://github.com/paulusmack/ppp/issues⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨https://github.com/paulusmack/ppp⟩ on 2023-06-23.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2023-05-01.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

Debian Project                  July 2000                         PON(1)