Differential D21803 Diff 62856 head/share/man/man4/ng_bridge.4

Changeset View

Standalone View

head/share/man/man4/ng_bridge.4

	Show All 28 Lines
	.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF			.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
	.\" THIS SOFTWARE, EVEN IF WHISTLE COMMUNICATIONS IS ADVISED OF THE POSSIBILITY			.\" THIS SOFTWARE, EVEN IF WHISTLE COMMUNICATIONS IS ADVISED OF THE POSSIBILITY
	.\" OF SUCH DAMAGE.			.\" OF SUCH DAMAGE.
	.\"			.\"
	.\" Author: Archie Cobbs <archie@FreeBSD.org>			.\" Author: Archie Cobbs <archie@FreeBSD.org>
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd May 5, 2010			.Dd October 2, 2019
	.Dt NG_BRIDGE 4			.Dt NG_BRIDGE 4
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm ng_bridge			.Nm ng_bridge
	.Nd Ethernet bridging netgraph node type			.Nd Ethernet bridging netgraph node type
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.In sys/types.h			.In sys/types.h
	.In netgraph/ng_bridge.h			.In netgraph/ng_bridge.h
	Show All 25 Lines
	.Pp			.Pp
	A looped back link will be temporarily muted, i.e., all traffic			A looped back link will be temporarily muted, i.e., all traffic
	received on that link is ignored.			received on that link is ignored.
	.Sh IPFW PROCESSING			.Sh IPFW PROCESSING
	Processing of IP packets via the			Processing of IP packets via the
	.Xr ipfirewall 4			.Xr ipfirewall 4
	mechanism on a per-link basis is not yet implemented.			mechanism on a per-link basis is not yet implemented.
	.Sh HOOKS			.Sh HOOKS
	This node type supports up to			This node type supports an unlimited number of hooks.
	.Dv NG_BRIDGE_MAX_LINKS
	hooks.
	Each connected hook represents a bridged link.			Each connected hook represents a bridged link.
	The hooks are named			The hooks are named
	.Dv link0 ,			.Dv link0 ,
	.Dv link1 ,			.Dv link1 ,
	etc.			etc.
	Typically these hooks are connected to the			Typically these hooks are connected to the
	.Dv lower			.Dv lower
	hooks of one or more			hooks of one or more
	Show All 11 Lines
	.It Dv NGM_BRIDGE_SET_CONFIG Pq Ic setconfig			.It Dv NGM_BRIDGE_SET_CONFIG Pq Ic setconfig
	Set the node configuration.			Set the node configuration.
	This command takes a			This command takes a
	.Dv "struct ng_bridge_config"			.Dv "struct ng_bridge_config"
	as an argument:			as an argument:
	.Bd -literal -offset 0n			.Bd -literal -offset 0n
	/* Node configuration structure */			/* Node configuration structure */
	struct ng_bridge_config {			struct ng_bridge_config {
	u_char ipfw[NG_BRIDGE_MAX_LINKS]; /* enable ipfw */
	u_char debugLevel; /* debug level */			u_char debugLevel; /* debug level */
	uint32_t loopTimeout; /* link loopback mute time */			uint32_t loopTimeout; /* link loopback mute time */
	uint32_t maxStaleness; /* max host age before nuking */			uint32_t maxStaleness; /* max host age before nuking */
	uint32_t minStableAge; /* min time for a stable host */			uint32_t minStableAge; /* min time for a stable host */
	};			};
	.Ed			.Ed
	.Pp			.Pp
	The
	.Dv ipfw
	array enables
	.Xr ipfirewall 4
	processing of IP packets received on the corresponding links.
	The			The
	.Dv debugLevel			.Dv debugLevel
	field sets the debug level on the node.			field sets the debug level on the node.
	At level of 2 or greater, detected loops are logged.			At level of 2 or greater, detected loops are logged.
	The default level is 1.			The default level is 1.
	.Pp			.Pp
	The			The
	.Dv loopTimeout			.Dv loopTimeout
	▲ Show 20 Lines • Show All 83 Lines • Show Last 20 Lines