NAME

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

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 connections 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 connection 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  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

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