]> git.ipfire.org Git - people/ms/network.git/blob - man/network-zone-pppoe.txt
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]