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