plog

PON(1)                            Debian PPPD                           PON(1)

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

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

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

   pon
       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 given.

       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  pppd  options  after the ISP name, too.  pon can be used to
       run multiple, simultaneous PPP connections.

       pon takes the following command line options:

              -q --quick
                     disconnect when ip-up finishes running.  This function is
                     only available to the root user.

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

              poff myprovider2

       will terminate the connection to myprovider2, and leave the PPP connec-
       tions to e.g. "myprovider1" or "myprovider3" up and running.

       poff takes the following command line options:

              -r     causes the connection to be redialed after it is dropped.

              -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 connec-
              tion is active, it will exit with an error code of 1.

   plog
       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 admin-
       istrator  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
       /etc/ppp/options
              PPPd system options file.

       /etc/ppp/pap-secrets
              System PAP passwords file.

       /etc/ppp/chap-secrets
              System CHAP passwords file.

       /etc/ppp/peers/
              Directory  holding  the  peer options files. The default file is
              called provider.

       /etc/chatscripts/provider
              The     chat     script     invoked     from     the     default
              /etc/ppp/peers/provider.

       /var/log/ppp.log
              The default PPP log file.

AUTHORS
       The p-commands were written by Christoph Lameter <clameter@debian.org>.
       Updated and revised by Philip Hands <phil@hands.com>.
       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
       pppd(8), chat(8), tail(1).

Debian Project                     July 2000                            PON(1)