1PPPOE-CONNECT(8)            System Manager's Manual           PPPOE-CONNECT(8)
2
3
4

NAME

6       pppoe-connect - Shell script to manage a PPPoE link
7
8

SYNOPSIS

10       pppoe-connect [config_file]
11
12       pppoe-connect interface user [config_file]
13
14
15

DESCRIPTION

17       pppoe-connect  is a shell script which manages a PPPoE connection using
18       the Roaring Penguin user-space PPPoE client.  If you omit  config_file,
19       the default file /etc/sysconfig/network-scripts/ifcfg-ppp0 is used.  If
20       you supply interface and user, then they override the  Ethernet  inter‐
21       face and user-name settings in the configuration file.
22
23       Note  that  normally,  you  should  not  invoke pppoe-connect directly.
24       Instead, use pppoe-start to bring up the PPPoE connection.
25
26       pppoe-connect first reads a configuration file.  It then  brings  up  a
27       PPPoE connection.  If the connection ever drops, a message is logged to
28       syslog, and pppoe-connect re-establishes the connection.  In  addition,
29       each  time  the  connection is dropped or cannot be established, pppoe-
30       connect executes the script /etc/ppp/pppoe-lost if  it  exists  and  is
31       executable.
32
33
34       The  shell  script  pppoe-stop causes pppoe-connect to break out of its
35       loop, bring the connection down, and exit.
36
37

TECHNICAL DETAILS

39       pppoe-connect uses the following shell variables from the configuration
40       file:
41
42
43       ETH    The  Ethernet interface connected to the DSL modem (for example,
44              eth0).
45
46
47       USER   The PPPoE user-id (for example, b1xxnxnx@sympatico.ca).
48
49
50       PIDFILE
51              A file in which to write the  process-ID  of  the  pppoe-connect
52              process (for example, /var/run/pppoe.pid).  Two additional files
53              ($PIDFILE.pppd and $PIDFILE.pppoe) hold the process-ID's of  the
54              pppd and pppoe processes, respectively.
55
56
57       By using different configuration files with different PIDFILE settings,
58       you can manage multiple PPPoE connections.  Just specify the configura‐
59       tion file as an argument to pppoe-start and pppoe-stop.
60
61

AUTHOR

63       pppoe-connect was written by David F. Skoll <dfs@roaringpenguin.com>.
64
65       The pppoe home page is http://www.roaringpenguin.com/pppoe/.
66
67

SEE ALSO

69       pppoe(8), pppoe-start(8), pppoe-stop(8), pppd(8), pppoe.conf(5), pppoe-
70       setup(8),  pppoe-status(8),  pppoe-sniff(8),  pppoe-server(8),   pppoe-
71       relay(8)
72
73
74
75
764th Berkeley Distribution      21 February 2000               PPPOE-CONNECT(8)
Impressum