projects / people / ms / network.git / blame
| Commit | Line | Data |
|---|---|---|
| d4f0a25c MT |
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] |