Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   4994 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

PPPOE-CONNECT(8)					      PPPOE-CONNECT(8)

NAME
       pppoe-connect - Shell script to manage a PPPoE link

SYNOPSIS
       pppoe-connect [config_file]

       pppoe-connect interface user [config_file]

DESCRIPTION
       pppoe-connect  is a shell script which manages a PPPoE connection using
       the Roaring Penguin user-space PPPoE client.  If you omit  config_file,
       the  default file /etc/ppp/pppoe.conf is used.  If you supply interface
       and user, then they override the Ethernet interface and user-name  set‐
       tings in the configuration file.

       Note  that  normally,  you  should  not	invoke pppoe-connect directly.
       Instead, use pppoe-start to bring up the PPPoE connection.

       pppoe-connect first reads a configuration file.	It then	 brings	 up  a
       PPPoE connection.  If the connection ever drops, a message is logged to
       syslog, and pppoe-connect re-establishes the connection.	 In  addition,
       each  time  the	connection is dropped or cannot be established, pppoe-
       connect executes the script /etc/ppp/pppoe-lost if  it  exists  and  is
       executable.

       The  shell  script  pppoe-stop causes pppoe-connect to break out of its
       loop, bring the connection down, and exit.

TECHNICAL DETAILS
       pppoe-connect uses the following shell variables from the configuration
       file:

       ETH    The  Ethernet interface connected to the DSL modem (for example,
	      eth0).

       USER   The PPPoE user-id (for example, b1xxnxnx@sympatico.ca).

       PIDFILE
	      A file in which to write the  process-ID	of  the	 pppoe-connect
	      process (for example, /var/run/pppoe.pid).  Two additional files
	      ($PIDFILE.pppd and $PIDFILE.pppoe) hold the process-ID's of  the
	      pppd and pppoe processes, respectively.

       By using different configuration files with different PIDFILE settings,
       you can manage multiple PPPoE connections.  Just specify the configura‐
       tion file as an argument to pppoe-start and pppoe-stop.

AUTHOR
       pppoe-connect was written by David F. Skoll <dfs@roaringpenguin.com>.

       The pppoe home page is http://www.roaringpenguin.com/pppoe/.

SEE ALSO
       pppoe(8), pppoe-start(8), pppoe-stop(8), pppd(8), pppoe.conf(5), pppoe-
       setup(8),  pppoe-status(8),  pppoe-sniff(8),  pppoe-server(8),	pppoe-
       relay(8)

4th Berkeley Distribution      21 February 2000		      PPPOE-CONNECT(8)

Vote for polarhome