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 new
<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:
55 <option>--username=
<replaceable>USERNAME
</replaceable></option>
60 Sets the username for authentication.
67 <option>--password=
<replaceable>PASSWORD
</replaceable></option>
72 Sets the password for authentication.
75 Use the
<option>--auth=
</option> option to transmit it
76 in a secure manner to the provider.
83 <option>--mtu=
<emphasis>N
</emphasis></option>
88 Sets the default MTU of the PPP connection.
95 <option>--auth=[chap|pap]
</option>
100 Define the authentication method that is used to
101 authenticate against your provider.
102 The default is to use the provider's preference.
107 <emphasis>Challange-Handshake Authentication Protocol
</emphasis>
108 (chap) is the preferred secure method.
113 <emphasis>Password Authentication Protocol
</emphasis>
114 (pap) sends the plaintext password to the authentication
115 server which is the reason why it should be avoided to use PAP.
124 <option>--access-concentrator=
<replaceable>STRING
</replaceable></option>
129 By this option, you may define the name of the access concentrator.
136 <option>--service-name=
<replaceable>STRING
</replaceable></option>
141 By this option, you may define the service name.
148 <option>--ipv6=[
<emphasis>on
</emphasis>|off]
</option>
153 By this option, you may enable or disable IPv6
159 <option>--prefix-delegation=[
<emphasis>on
</emphasis>|off]
</option>
164 By this option, you may enable or disable the delegation through your provider of one IPv6 prefix to your system.
173 <title>See Also
</title>
177 <refentrytitle>network
</refentrytitle>
178 <manvolnum>8</manvolnum>
181 <refentrytitle>network-zone
</refentrytitle>
182 <manvolnum>8</manvolnum>