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
if_mpadm(1M) System Administration Commands if_mpadm(1M) NAME
if_mpadm - administer interfaces in an IP multipathing group SYNOPSIS
if_mpadm -d | -r ifname DESCRIPTION
The if_mpadm utility administers IP interfaces that are part of an IP Multipathing (IPMP) group. Currently, administration is limited to offlining IP interfaces and undoing previous offline operations. When an IP interface is taken offline, all IP data traffic that was flowing over the IP interface is moved to another IP interface in the IPMP group. In addition, all UP IP addresses hosted on the IP interface are brought down, causing in.mpathd(1M) to stop probe-based failure detection on the IP interface. As a result, an offline IP interface will not be used for any inbound or outbound IP traffic. Only IP inter- faces that are in an IPMP group may be brought offline. If the IP interface is the last functioning interface in the IPMP group, the off- line operation will fail. When an offline operation is undone, any IP addresses hosted on that IP interface are brought UP and will be considered by in.mpathd for probe-based failure detection. In addition, provided the IP interface is otherwise active (see in.mpathd(1M)), it will again be used to send and receive IP data traffic for the IPMP group. Note that not all offline operations can be undone. For instance, in.mpathd may have offlined an IP interface because its hardware address was not unique within its IPMP group. The ipmpstat utility can be used to determine why an IP interface is offline, identify which IP interfaces in a group are being used for inbound and outbound IP traffic, and more; see ipmpstat(1M). OPTIONS
The if_mpadm utility supports the following options: -d ifname Offline the IP interface specified by ifname. If ifname is not in an IPMP group, or the offline would cause the IPMP group to lose network connectivity, the operation will fail. -r ifname Undo a previous offline of the IP interface specified by ifname. If ifname is not offline, the operation will fail. EXAMPLES
Example 1 Offlining an IP Interface The following command offlines the IP interface under0, causing any IP packets that were being sent and received through it to be handled by another IP interface in its group. example% if_mpadm -d under0 Example 2 Undoing a Previous Offline Operation Use the following command to undo the operation in the previous example: example% if_mpdadm -r under0 ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ |Interface Stability |Unstable | +-----------------------------+-----------------------------+ SEE ALSO
ifconfig(1M), in.mpathd(1M), ipmpstat(1M), attributes(5) DIAGNOSTICS
cannot offline: no other functioning interfaces are in its IPMP group. Description: This message means that offlining the IP interface would leave the IPMP group without network connectivity. cannot offline: not a physical interface or not in an IPMP group Description: This means that the IP interface is not an underlying interface in an IPMP group, and therefore is not eligible to be offlined. SunOS 5.11 5 Jan 2009 if_mpadm(1M)