[people/ms/network.git] / man / network-zone-pppoe.txt

= network-zone-pppoe(8)

== NAME
network-zone-pppoe - PPP over Ethernet

== SYNOPSIS
[verse]
`network zone new ZONE pppoe ...`

== DESCRIPTION
The `pppoe` hook creates a PPPoE connection to your ISP.

== OPTIONS
The following options are understood:

`--username=USERNAME`::
	Sets the username for authentication.

`--password=PASSWORD`::
	Sets the password for authentication.
	+
	Use the `--auth=` option to transmit it in a secure manner to the provider.

`--mtu=N`::
	Sets the default MTU of the PPP connection.

`--auth=[chap|pap]`::
	Define the authentication method that is used to authenticate against your
	provider. The default is to use the provider's preference.

	* _Challange-Handshake Authentication Protocol_ (`chap`) is the preferred,
	secure method.
	* _Password Authentication Protocol_ (`pap`) sends the plaintext password
	to the authentication server which is the reason why it should be avoided.

`--access-concentrator=STRING`::
	By this option, you may define the name of the access concentrator.

`--service-name=STRING`::
	By this option, you may define the service name.

`--ipv6=[on|off]`::
	By this option, you may enable or disable IPv6.

`--prefix-delegation=[on|off]`::
	By this option, you may enable or disable the delegation through your
	provider of one IPv6 prefix to your system.

== AUTHORS
Michael Tremer

== SEE ALSO
link:network[8],
link:network-zone[8]
Commit	Line	Data
d4f0a25c	1	= network-zone-pppoe(8)
d4f0a25c MT	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
6b1e7474 MT	49	== AUTHORS
	50	Michael Tremer
	51
d4f0a25c MT	52	== SEE ALSO
	53	link:network[8],
	54	link:network-zone[8]