xref: /freebsd/usr.sbin/mtest/mtest.8 (revision 271c3a9060f2ee55607ebe146523f888e1db2654)
1.\"
2.\" $FreeBSD$
3.\"
4.\" The following requests are required for all man pages.
5.Dd March 8, 2007
6.Os
7.Dt MTEST 8
8.Sh NAME
9.Nm mtest
10.Nd test multicast membership socket operations and ioctls
11.Sh SYNOPSIS
12.Nm
13.Sh DESCRIPTION
14The
15.Nm
16utility
17is a small program for testing the multicast membership socket operations
18and ioctls.
19It accepts the following commands, interactively:
20.Bl -tag -width "a ifname e.e.e.e.e.e" -compact -offset indent
21.It Ic j Ar g.g.g.g Ar i.i.i.i
22Join the IP group address
23.Ar g.g.g.g
24on the interface with address
25.Ar i.i.i.i .
26.Ar i.i.i.i
27may be specified as 0.0.0.0 to use the default interface.
28.It Ic l Ar g.g.g.g Ar i.i.i.i
29Leave the IP group address
30.Ar g.g.g.g
31on the interface with address
32.Ar i.i.i.i .
33.It Ic a Ar ifname Ar e.e.e.e.e.e
34Join the Ethernet group address
35.Ar e.e.e.e.e.e
36on interface
37.Ar ifname .
38.It Ic d Ar ifname Ar e.e.e.e.e.e
39Leave the Ethernet group address
40.Ar e.e.e.e.e.e
41on interface
42.Ar ifname .
43.It Ic m Ar ifname Ar 1/0
44Set or reset ALLMULTI mode on interface
45.Ar ifname .
46.It Ic p Ar ifname Ar 1/0
47Set or reset promiscuous mode on interface
48.Ar ifname .
49.\"
50.It Ic i Ar g.g.g.g Ar i.i.i.i Ar n Ar x.x.x.x ...
51Set the socket with group membership of
52.Ar g.g.g.g
53on IPv4 address
54.Ar i.i.i.i
55to include filter mode, and add
56.Ar n
57sources beginning with
58.Ar x.x.x.x
59to the inclusion filter list.
60.\"
61.It Ic e Ar g.g.g.g Ar i.i.i.i Ar n Ar x.x.x.x ...
62Set the socket with group membership of
63.Ar g.g.g.g
64on IPv4 address
65.Ar i.i.i.i
66to exclude filter mode, and add
67.Ar n
68sources beginning with
69.Ar x.x.x.x
70to the exclusion filter list.
71.\"
72.It Ic t Ar g.g.g.g Ar i.i.i.i Ar s.s.s.s
73Set the socket with group membership of
74.Ar g.g.g.g
75on IPv4 address
76.Ar i.i.i.i
77to block traffic from source
78.Ar s.s.s.s .
79.\"
80.It Ic b Ar g.g.g.g Ar i.i.i.i Ar s.s.s.s
81Set the socket with group membership of
82.Ar g.g.g.g
83on IPv4 address
84.Ar i.i.i.i
85to allow traffic from source
86.Ar s.s.s.s .
87.\"
88.It Ic g Ar g.g.g.g Ar i.i.i.i Ar n
89Print
90.Ar n
91source filter entries for group
92.An g.g.g.g
93on IPv4 address
94.An i.i.i.i .
95.\"
96.It Ic f Ar filename
97Read commands from the file
98.Ar filename .
99.It Ic s Ar n
100Sleep for
101.Ar n
102seconds.
103.It Ic ?\&
104List legal commands.
105.It Ic q
106Quit the program.
107.El
108.Sh SEE ALSO
109.Rs
110.%A D. Thaler
111.%A B. Fenner
112.%A B. Quinn
113.%T "Socket Interface Extensions for Multicast Filters"
114.%O RFC 3678
115.Re
116.Sh AUTHORS
117.An -split
118.An "Steve Deering"
119.An "Wilbert De Graaf"
120