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

= network-zone-bridge(8)

== NAME
network-zone-bridge - Manage network zones

== SYNOPSIS
[verse]
'network zone new ZONE bridge' ...
'network zone ZONE edit' ...

== DESCRIPTION
The bridge hook creates an ethernet bridge which acts as an unmanaged network
switch. It contains one or multiple physical network interfaces or virtual
devices which will be connected to each other.

The bridge hook is the preferred hook for local area network zones which are
connected to an ethernet network.

== OPTIONS
The following options are understood:

'--address=ADDRESS'::
	By this option, you may define the MAC address of the bridge. If this option
	is missing, a random MAC address will be generated.

'--mtu=MTU'::
	Sets the default MTU of the bridge.
	All ports in the bridge must support this MTU value.

'--stp=[_on_|off]'::
	This option enables or disables use of the _Spanning Tree Protocol_ (STP).
	This protocol is used to avoid loops in networks by dynamically disabling
	packet forwarding on links.
	+
	It is highly recommended to leave this option enabled when you add more
	than one device to the zone. Read below how the behaviour of STP can be changed.

Spanning Tree Protocol (802.1D) configuration options:

'--stp-forward-delay=_0_'::
	This sets the default time the interfaces are hold off after they have been
	added to a bridge. The default value is 0.

'--stp-hello=_2_'::
	This option defines how often a hello message should be sent. The value is
	given in seconds and the default is 2.

'--stp-priority=512'::
	The STP priority sets the ranking of this network device within the network.
	The bridge with the best rank (0 is best) will become the root bridge.

== AUTHORS
Michael Tremer

== SEE ALSO
link:network[8],
link:network-zone[8]
Commit	Line	Data
010f24cf	1	= network-zone-bridge(8)
010f24cf MT	2
	3	== NAME
	4	network-zone-bridge - Manage network zones
	5
	6	== SYNOPSIS
	7	[verse]
	8	'network zone new ZONE bridge' ...
	9	'network zone ZONE edit' ...
	10
	11	== DESCRIPTION
	12	The bridge hook creates an ethernet bridge which acts as an unmanaged network
	13	switch. It contains one or multiple physical network interfaces or virtual
	14	devices which will be connected to each other.
	15
	16	The bridge hook is the preferred hook for local area network zones which are
	17	connected to an ethernet network.
	18
	19	== OPTIONS
	20	The following options are understood:
	21
	22	'--address=ADDRESS'::
	23	By this option, you may define the MAC address of the bridge. If this option
	24	is missing, a random MAC address will be generated.
	25
	26	'--mtu=MTU'::
	27	Sets the default MTU of the bridge.
	28	All ports in the bridge must support this MTU value.
	29
	30	'--stp=[_on_\|off]'::
	31	This option enables or disables use of the _Spanning Tree Protocol_ (STP).
	32	This protocol is used to avoid loops in networks by dynamically disabling
	33	packet forwarding on links.
	34	+
	35	It is highly recommended to leave this option enabled when you add more
	36	than one device to the zone. Read below how the behaviour of STP can be changed.
	37
	38	Spanning Tree Protocol (802.1D) configuration options:
	39
	40	'--stp-forward-delay=_0_'::
	41	This sets the default time the interfaces are hold off after they have been
	42	added to a bridge. The default value is 0.
	43
	44	'--stp-hello=_2_'::
	45	This option defines how often a hello message should be sent. The value is
	46	given in seconds and the default is 2.
	47
	48	'--stp-priority=512'::
	49	The STP priority sets the ranking of this network device within the network.
	50	The bridge with the best rank (0 is best) will become the root bridge.
	51
6b1e7474 MT	52	== AUTHORS
	53	Michael Tremer
	54
010f24cf MT	55	== SEE ALSO
	56	link:network[8],
	57	link:network-zone[8]