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   18644 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

ADSL-CONNECT(8)						       ADSL-CONNECT(8)

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

SYNOPSIS
       adsl-connect [config_file]

       adsl-connect interface user [config_file]

DESCRIPTION
       adsl-connect  is	 a shell script which manages an ADSL connection using
       the Roaring Penguin user-space PPPoE client.  If you omit  config_file,
       the default file /etc/sysconfig/network-scripts/ifcfg-ppp0 is used.  If
       you supply interface and user, then they override the  Ethernet	inter‐
       face and user-name settings in the configuration file.

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

       adsl-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 adsl-connect re-establishes the connection.	 In  addition,
       each time the connection is dropped or cannot be established, adsl-con‐
       nect executes the script /etc/ppp/adsl-lost if it exists	 and  is  exe‐
       cutable.

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

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

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

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

       PIDFILE
	      A file in which to write	the  process-ID	 of  the  adsl-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 adsl-start and adsl-stop.

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

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

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

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

Vote for polarhome