Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MTEST(8)		     System Manager's Manual			MTEST(8)

NAME
     mtest -- test multicast socket operations

SYNOPSIS
     mtest

DESCRIPTION
     The  mtest  utility  is a small program for testing multicast socket opera-
     tions.

     It accepts the following commands, interactively, or as part of a	scripted
     input file (useful for automated testing):

	   a ifname mac-addr	     Join  the link-layer group address mac-addr
				     on interface  ifname.   The  group  address
				     should be in IEEE 802 MAC format, delimited
				     by colon (':') characters.
	   d ifname mac-addr	     Leave the link-layer group address mac-addr
				     on interface ifname.
	   m ifname 1/0 	     Set  or  reset  ALLMULTI  mode on interface
				     ifname.  This option is deprecated  and  is
				     now a no-op.
	   p ifname 1/0 	     Set  or reset promiscuous mode on interface
				     ifname.

	   j mcast-addr ifname [source-addr]
				     Join the multicast  address  mcast-addr  on
				     the interface with name ifname.

				     If an optional source source-addr is speci-
				     fied,  a  source-specific join will be per-
				     formed; if mtest is already joined  to  the
				     multicast address, the source will be added
				     to its filter list.

	   l mcast-addr ifname [source-addr]
				     Leave  the  multicast address mcast-addr on
				     the interface with address  ifname.   If  a
				     source  source-addr is specified, only that
				     source will be left.
	   i mcast-addr ifname n source-addr ...
				     Set   the	 socket   with	 membership   of
				     mcast-addr  on  interface ifname to include
				     filter mode, and add  n  sources  beginning
				     with  source-addr	to  the inclusion filter
				     list.
	   e mcast-addr ifname n source-addr ...
				     Set   the	 socket   with	 membership   of
				     mcast-addr  on  interface ifname to exclude
				     filter mode, and add  n  sources  beginning
				     with  source-addr	to  the exclusion filter
				     list.
	   t mcast-addr ifname source-addr
				     Set   the	 socket   with	 membership   of
				     mcast-addr  on  interface	ifname	to block
				     traffic from source source-addr.
	   b mcast-addr ifname source-addr
				     Set   the	 socket   with	 membership   of
				     mcast-addr  on  interface	ifname	to allow
				     traffic from source source-addr.

	   g mcast-addr ifname n     Print   n	 source   filter   entries   for
				     mcast-addr on interface ifname.

	   f filename		     Read commands from the file filename.
	   s n			     Sleep for n seconds.
	   ?			     List legal commands.
	   q			     Quit the program.

IMPLEMENTATION NOTES
     For  each command implemented by mtest, the address family of each argument
     must be identical; it is not possible to  mix  IPv4  multicast  memberships
     with IPv6, for example.

     To  support IPv6, all commands have now changed to accept an interface name
     rather than an interface address.	For IPv4, the  program	will  perform  a
     lookup  of  the  primary  IP address based on the interface name.	This may
     fail if no primary IP address is assigned.

SEE ALSO
     D. Thaler, B. Fenner, and B. Quinn, Socket Interface Extensions for  Multi-
     cast Filters, RFC 3678.

AUTHORS
     Bruce Simpson
     Steve Deering
     Wilbert De Graaf

FreeBSD ports 15.quarterly	 April 29, 2009 			MTEST(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mtest&sektion=8&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help