man/network-zone-pppoe.8.in

   1 .TH network-zone-pppoe 8 "21 Jun 2012" "@VERSION@" "network man page"
   2
   3 .SH NAME
   4 network-zone-pppoe \- Network Configuration Control Program
   5
   6 .SH SYNOPSIS
   7 \fBnetwork [OPTIONS] zone create <zone> pppoe ...\fR
   8 .P
   9 All options may be edited on zones which have already been set up with the \fBpppoe\fR hook:
  10 .P
  11 \fBnetwork [OPTIONS] zone <zone> edit ...\fR
  12
  13 .SH DESCRIPTION
  14 The pppoe hook creates a PPPoE connection to your ISP.
  15 .PP
  16
  17 .SH OPTIONS
  18 The \fBpppoe\fR hook offers various configuration options:
  19
  20 \fB--port\fR = ...
  21 .RS 4
  22 This options sets the port, pppd is using to connect to the modem.
  23 .PP
  24 This may be a normal ethernet or vlan interface.
  25 .RE
  26 .PP
  27
  28 \fB--username\fR = ...
  29 .RS 4
  30 Sets the username for authentication.
  31 .RE
  32 .PP
  33
  34 \fB--password\fR = ...
  35 .RS 4
  36 Sets the password for authentication.
  37 .PP
  38 Use the \fB--auth=\fR option to transmit it in a secure manner to the provider.
  39 .RE
  40 .PP
  41
  42 \fB--mtu\fR = 1492
  43 .RS 4
  44 Sets the default MTU of the PPP connection. The default value is 1492 which is
  45 a common MTU used for DSL.
  46 .RE
  47 .PP
  48
  49 \fB--auth\fR = [chap|pap]
  50 .RS 4
  51 Define the authentication method that is used to authenticate
  52 against your provider. The default is to use the provider's preference.
  53 .PP
  54 * \fBChallange-Handshake Authentication Protocol\fR (chap) is the preferred
  55 secure method.
  56 .PP
  57 * \fBPassword Authentication Protocol\fR (pap) sends the plaintext password
  58 to the authentication server which is the reason why it should be avoided
  59 to use PAP.
  60 .RE
  61 .PP
  62
  63 \fB--access-concentrator\fR = ...
  64 .RS 4
  65 By this option, you may define the name of the access concentrator.
  66 .RE
  67 .PP
  68
  69 \fB--service-name\fR = ...
  70 .RS 4
  71 By this option, you may define the service name.
  72 .RE
  73 .PP
  74
  75 .SH SEE ALSO
  76 network(8), network-zone(8)
  77
  78 .SH AUTHOR
  79 Michael Tremer (michael.tremer@ipfire.org)