# pon

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


* * *