93b55f270782d3ca84f7181ee701cf09becdc680
[people/ms/network.git] / man / network-zone-pppoe.txt
1 = network-zone-pppoe(8)
2 Michael Tremer <michael.tremer@ipfire.org>
3
4 == NAME
5 network-zone-pppoe - PPP over Ethernet
6
7 == SYNOPSIS
8 [verse]
9 `network zone new ZONE pppoe ...`
10
11 == DESCRIPTION
12 The `pppoe` hook creates a PPPoE connection to your ISP.
13
14 == OPTIONS
15 The following options are understood:
16
17 `--username=USERNAME`::
18         Sets the username for authentication.
19
20 `--password=PASSWORD`::
21         Sets the password for authentication.
22         +
23         Use the `--auth=` option to transmit it in a secure manner to the provider.
24
25 `--mtu=N`::
26         Sets the default MTU of the PPP connection.
27
28 `--auth=[chap|pap]`::
29         Define the authentication method that is used to authenticate against your
30         provider. The default is to use the provider's preference.
31
32         * _Challange-Handshake Authentication Protocol_ (`chap`) is the preferred,
33         secure method.
34         * _Password Authentication Protocol_ (`pap`) sends the plaintext password
35         to the authentication server which is the reason why it should be avoided.
36
37 `--access-concentrator=STRING`::
38         By this option, you may define the name of the access concentrator.
39
40 `--service-name=STRING`::
41         By this option, you may define the service name.
42
43 `--ipv6=[on|off]`::
44         By this option, you may enable or disable IPv6.
45
46 `--prefix-delegation=[on|off]`::
47         By this option, you may enable or disable the delegation through your
48         provider of one IPv6 prefix to your system.
49
50 == SEE ALSO
51 link:network[8],
52 link:network-zone[8]