2 <!DOCTYPE refentry PUBLIC
"-//OASIS/DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
5 <refentry id=
"network-zone-pppoe">
7 <title>network-zone-pppoe
</title>
8 <productname>network
</productname>
12 <contrib>Developer
</contrib>
13 <firstname>Michael
</firstname>
14 <surname>Tremer
</surname>
15 <email>michael.tremer@ipfire.org
</email>
21 <refentrytitle>network-zone-pppoe
</refentrytitle>
22 <manvolnum>8</manvolnum>
26 <refname>network-zone-pppoe
</refname>
27 <refpurpose>Network Configuration Control Program
</refpurpose>
32 <command>network zone create
<replaceable>ZONE
</replaceable> pppoe ...
</command>
37 <title>Description
</title>
40 The pppoe hook creates a PPPoE connection to your ISP.
45 <title>Options
</title>
48 The following options are understood:
54 <option>--port=
<replaceable>PORT
</replaceable></option>
59 This options sets the port, pppd is using to connect to
63 This may be a normal ethernet or vlan interface.
70 <option>--username=
<replaceable>USERNAME
</replaceable></option>
75 Sets the username for authentication.
82 <option>--password=
<replaceable>PASSWORD
</replaceable></option>
87 Sets the password for authentication.
90 Use the
<option>--auth=
</option> option to transmit it
91 in a secure manner to the provider.
98 <option>--mtu=
<emphasis>1492</emphasis></option>
103 Sets the default MTU of the PPP connection.
104 The default value is
1492 which is a common MTU used
112 <option>--auth=[chap|pap]
</option>
117 Define the authentication method that is used to
118 authenticate against your provider.
119 The default is to use the provider's preference.
124 <emphasis>Challange-Handshake Authentication Protocol
</emphasis>
125 (chap) is the preferred secure method.
130 <emphasis>Password Authentication Protocol
</emphasis>
131 (pap) sends the plaintext password to the authentication
132 server which is the reason why it should be avoided to use PAP.
141 <option>--access-concentrator=
<replaceable>STRING
</replaceable></option>
146 By this option, you may define the name of the access concentrator.
153 <option>--service-name=
<replaceable>STRING
</replaceable></option>
158 By this option, you may define the service name.
166 <title>See Also
</title>
170 <refentrytitle>network
</refentrytitle>
171 <manvolnum>8</manvolnum>
174 <refentrytitle>network-zone
</refentrytitle>
175 <manvolnum>8</manvolnum>