mtest(8) [freebsd man page]

MTEST(8)						    BSD 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 operations.

     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 specified, a source-specific join will be performed; 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 mem-
     berships 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 per-
     form 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 Multicast Filters, RFC 3678.

AUTHORS

     Bruce Simpson
     Steve Deering
     Wilbert De Graaf

BSD
								  April 29, 2009							       BSD

Check Out this Related Man Page

setipv4sourcefilter(3N) 												   setipv4sourcefilter(3N)

NAME

       setipv4sourcefilter() - set IPv4 multicast source filter state

SYNOPSIS

DESCRIPTION

       This  function  sets  the multicast source filter state for an IPv4 multicast group on a given socket.  This function can be used to join a
       multicast group by specifying a filter mode of (with or without a source list), or by specifying a filter mode of with a  non-empty  source
       list.   If  the	multicast group is already joined, this function replaces the existing filter mode and source list with the ones provided.
       This function can be used to leave a multicast group by specifying a filter mode of and an empty source list.

   Parameters
       s	 Specifies the descriptor identifying the socket.  The socket address family must be and the socket type must be

       interface Holds the IPv4 address of a local interface, or If set to the system chooses a multicast group by matching the multicast  address
		 only;	or  when  joining  a group, the system chooses the interface that datagrams for the group would be sent from, based on the
		 routing configuration.

       group	 Holds the IPv4 multicast address of the group.

       fmode	 Identifies the filter mode.  The value of this field must be either or which are defined in

       numsrc	 Holds the number of source addresses in the slist array.

       slist	 Points to an array of IPv4 addresses of sources to include or exclude depending on the filter mode.

RETURN VALUES

       returns the following values:

	      Successful completion.

	      Failure.
		   is set to indicate the error.

ERRORS

       If fails, is set to one of the following values:

	      The argument	    s is not a valid descriptor.

	      This function is not supported by the socket type.

	      Insufficient memory is available for internal
				    system data structures.

	      numsrc		    exceeds the maximum number of sources allowed, as determined by the ndd tunable parameters and

	      The specified IP address is not a local interface address; or
				    trying to leave an unjoined group.

	      group		    is not an IPv4 multicast address; or slist contains an invalid source address; or the specified filter mode is
				    not valid.

AUTHOR

       was developed by HP and the IETF.

SEE ALSO

       ndd(1M), socket(2), getipv4sourcefilter(3N), getsourcefilter(3N), setsourcefilter(3N), ip(7P), ip6(7P).

STANDARDS CONFORMANCE

       RFC 3678

															   setipv4sourcefilter(3N)

Linux and UNIX Man Pages

mtest(8) [freebsd man page]

Check Out this Related Man Page