Differential D17411 Diff 49402 head/share/man/man4/vale.4

Changeset View

Standalone View

head/share/man/man4/vale.4

	Show First 20 Lines • Show All 53 Lines • ▼ Show 20 Lines
	.Nm			.Nm
	dynamically creates switches and ports as clients connect			dynamically creates switches and ports as clients connect
	to it using the			to it using the
	.Xr netmap 4			.Xr netmap 4
	API.			API.
	.Pp			.Pp
	.Nm			.Nm
	ports are named			ports are named
	.Pa vale[bdg:][port]			.Pa valeSSS:PPP
	where			where
	.Pa vale			.Pa vale
	is the prefix indicating a VALE switch rather than a standard interface,			is the prefix indicating a VALE switch rather than a standard interface,
	.Pa bdg			.Pa SSS
	indicates a specific switch (the colon is a separator),			indicates a specific switch (the colon is a separator),
	and			and
	.Pa port			.Pa PPP
	indicates a port within the switch.			indicates a port within the switch.
	Bridge and port names are arbitrary strings, the only			Both SSS and PPP have the form [0-9a-zA-Z_]+ , the string cannot
	constraint being that the full name must fit within 16			exceed IFNAMSIZ characters, and PPP cannot be the name of any
	characters.			existing OS network interface.
	.Pp			.Pp
	See			See
	.Xr netmap 4			.Xr netmap 4
	for details on the API.			for details on the API.
	.Ss LIMITS			.Ss LIMITS
	.Nm			.Nm
	currently supports up to 4 switches, 16 ports per switch, with			currently supports up to 4 switches, 16 ports per switch, with
	1024 buffers per port.			1024 buffers per port.
	Show All 10 Lines
	with throughput.			with throughput.
	.It dev.netmap.verbose			.It dev.netmap.verbose
	Set to non-zero values to enable in-kernel diagnostics.			Set to non-zero values to enable in-kernel diagnostics.
	.El			.El
	.Sh EXAMPLES			.Sh EXAMPLES
	Create one switch, with a traffic generator connected to one			Create one switch, with a traffic generator connected to one
	port, and a netmap-enabled tcpdump instance on another port:			port, and a netmap-enabled tcpdump instance on another port:
	.Bd -literal -offset indent			.Bd -literal -offset indent
	tcpdump -ni vale-a:1 &			tcpdump -ni valea:1 &
	pkt-gen -i vale-a:0 -f tx &			pkt-gen -i valea:0 -f tx &
	.Ed			.Ed
	.Pp			.Pp
	Create two switches,			Create two switches,
	each connected to two qemu machines on different ports.			each connected to two qemu machines on different ports.
	.Bd -literal -offset indent			.Bd -literal -offset indent
	qemu -net nic -net netmap,ifname=vale-1:a ... &			qemu -net nic -net netmap,ifname=vale1:a ... &
	qemu -net nic -net netmap,ifname=vale-1:b ... &			qemu -net nic -net netmap,ifname=vale1:b ... &
	qemu -net nic -net netmap,ifname=vale-2:c ... &			qemu -net nic -net netmap,ifname=vale2:c ... &
	qemu -net nic -net netmap,ifname=vale-2:d ... &			qemu -net nic -net netmap,ifname=vale2:d ... &
	.Ed			.Ed
	.Sh SEE ALSO			.Sh SEE ALSO
	.Xr netmap 4			.Xr netmap 4
	.Pp
	.Xr http://info.iet.unipi.it/~luigi/vale/
	.Pp			.Pp
	Luigi Rizzo, Giuseppe Lettieri: VALE, a switched ethernet for virtual machines,			Luigi Rizzo, Giuseppe Lettieri: VALE, a switched ethernet for virtual machines,
	June 2012, http://info.iet.unipi.it/~luigi/vale/			June 2012, http://info.iet.unipi.it/~luigi/vale/
	.Sh AUTHORS			.Sh AUTHORS
	.An -nosplit			.An -nosplit
	The			The
	.Nm			.Nm
	switch was designed and implemented in 2012 by			switch was designed and implemented in 2012 by
	.An Luigi Rizzo			.An Luigi Rizzo
	and			and
	.An Giuseppe Lettieri			.An Giuseppe Lettieri
	at the Universita` di Pisa.			at the Universita` di Pisa.
	.Pp			.Pp
	.Nm			.Nm
	was funded by the European Commission within FP7 Projects			was funded by the European Commission within FP7 Projects
	CHANGE (257422) and OPENLAB (287581).			CHANGE (257422) and OPENLAB (287581).