.TH network-zone-pppoe 8 "21 Jun 2012" "@VERSION@" "network man page"

.SH NAME
network-zone-pppoe \- Network Configuration Control Program

.SH SYNOPSIS
\fBnetwork [OPTIONS] zone create <zone> pppoe ...\fR
.P
All options may be edited on zones which have already been set up with the \fBpppoe\fR hook:
.P
\fBnetwork [OPTIONS] zone <zone> edit ...\fR

.SH DESCRIPTION
The pppoe hook creates a PPPoE connection to your ISP.
.PP

.SH OPTIONS
The \fBpppoe\fR hook offers various configuration options:

\fB--port\fR = ...
.RS 4
This options sets the port, pppd is using to connect to the modem.
.PP
This may be a normal ethernet or vlan interface.
.RE
.PP

\fB--username\fR = ...
.RS 4
Sets the username for authentication.
.RE
.PP

\fB--password\fR = ...
.RS 4
Sets the password for authentication.
.PP
Use the \fB--auth=\fR option to transmit it in a secure manner to the provider.
.RE
.PP

\fB--mtu\fR = 1492
.RS 4
Sets the default MTU of the PPP connection. The default value is 1492 which is
a common MTU used for DSL.
.RE
.PP

\fB--auth\fR = [chap|pap]
.RS 4
Define the authentication method that is used to authenticate
against your provider. The default is to use the provider's preference.
.PP
* \fBChallange-Handshake Authentication Protocol\fR (chap) is the preferred
secure method.
.PP
* \fBPassword Authentication Protocol\fR (pap) sends the plaintext password
to the authentication server which is the reason why it should be avoided
to use PAP.
.RE
.PP

\fB--access-concentrator\fR = ...
.RS 4
By this option, you may define the name of the access concentrator.
.RE
.PP

\fB--service-name\fR = ...
.RS 4
By this option, you may define the service name.
.RE
.PP

.SH SEE ALSO
network(8), network-zone(8)

.SH AUTHOR
Michael Tremer (michael.tremer@ipfire.org)