xref: /netbsd/usr.sbin/mld6query/mld6query.8 (revision e701e304)
1*e701e304Swiz.\"	$NetBSD: mld6query.8,v 1.9 2017/07/04 07:11:18 wiz Exp $
2a2ca80c8Sitojun.\"	$KAME: mld6query.8,v 1.5 2000/12/04 06:28:23 itojun Exp $
3a2ca80c8Sitojun.\"
4a7d1c859Sitojun.\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
5a7d1c859Sitojun.\" All rights reserved.
6a7d1c859Sitojun.\"
7a7d1c859Sitojun.\" Redistribution and use in source and binary forms, with or without
8a7d1c859Sitojun.\" modification, are permitted provided that the following conditions
9a7d1c859Sitojun.\" are met:
10a7d1c859Sitojun.\" 1. Redistributions of source code must retain the above copyright
11a7d1c859Sitojun.\"    notice, this list of conditions and the following disclaimer.
12a7d1c859Sitojun.\" 2. Redistributions in binary form must reproduce the above copyright
13a7d1c859Sitojun.\"    notice, this list of conditions and the following disclaimer in the
14a7d1c859Sitojun.\"    documentation and/or other materials provided with the distribution.
15a7d1c859Sitojun.\" 3. Neither the name of the project nor the names of its contributors
16a7d1c859Sitojun.\"    may be used to endorse or promote products derived from this software
17a7d1c859Sitojun.\"    without specific prior written permission.
18a7d1c859Sitojun.\"
19a7d1c859Sitojun.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
20a7d1c859Sitojun.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21a7d1c859Sitojun.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22a7d1c859Sitojun.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
23a7d1c859Sitojun.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24a7d1c859Sitojun.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25a7d1c859Sitojun.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26a7d1c859Sitojun.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27a7d1c859Sitojun.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28a7d1c859Sitojun.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29a7d1c859Sitojun.\" SUCH DAMAGE.
30a7d1c859Sitojun.\"
31a7d1c859Sitojun.Dd May 17, 1998
32a7d1c859Sitojun.Dt MLD6QUERY 8
33a7d1c859Sitojun.Os
34a7d1c859Sitojun.\"
35a7d1c859Sitojun.Sh NAME
36a7d1c859Sitojun.Nm mld6query
37a7d1c859Sitojun.Nd send multicast listener query
38a7d1c859Sitojun.\"
39a7d1c859Sitojun.Sh SYNOPSIS
40a7d1c859Sitojun.Nm
417ddaec43Sitojun.Op Fl dr
42a7d1c859Sitojun.Ar intface
43a7d1c859Sitojun.Op Ar maddr
44a7d1c859Sitojun.\"
45a7d1c859Sitojun.Sh DESCRIPTION
46a7d1c859Sitojun.Nm
47a7d1c859Sitojunsends an IPv6 multicast listener discovery (MLD) query packet toward
48a7d1c859Sitojunthe specified multicast address,
49a7d1c859Sitojun.Ar maddr ,
50a7d1c859Sitojuntoward interface
51a7d1c859Sitojun.Ar intface .
52a7d1c859SitojunIf you omit
53a7d1c859Sitojun.Ar maddr ,
547ddaec43Sitojunlinklocal all nodes multicast address(ff02::1) is used.
55a7d1c859Sitojun.Pp
56a7d1c859SitojunAfter sending a query,
57a7d1c859Sitojun.Nm
58a7d1c859Sitojunwaits for replies for at most 10 seconds.
59a7d1c859SitojunIf a reply is returned,
60a7d1c859Sitojun.Nm
61a7d1c859Sitojunprints it with its type and then waits for another reply.
62a7d1c859Sitojun.Pp
63a7d1c859SitojunThis program is provided only for debugging.
64a7d1c859SitojunIt is not necessary for normal use.
657ddaec43Sitojun.Pp
667ddaec43SitojunWith
677ddaec43Sitojun.Fl d ,
687ddaec43Sitojun.Nm
697ddaec43Sitojunwill transmit MLD done packet instead of MLD query packet.
707ddaec43SitojunWith
717ddaec43Sitojun.Fl r ,
727ddaec43Sitojunsimilarly, MLD report packet will be transmitted.
737ddaec43Sitojun.Fl dr
747ddaec43Sitojunoptions are for debugging purposes only.
75a7d1c859Sitojun.\"
764918722aSkleink.Sh EXIT STATUS
77*e701e304Swiz.Ex -std mld6query
78a7d1c859Sitojun.\"
79a7d1c859Sitojun.\" .Sh SEE ALSO
80a7d1c859Sitojun.\"
81a7d1c859Sitojun.Sh HISTORY
82a7d1c859SitojunThe
83a7d1c859Sitojun.Nm
84a7d1c859Sitojuncommand first appeared in WIDE/KAME IPv6 protocol stack kit.
85a7d1c859Sitojun.Sh BUGS
86279552d3Slukem.Nm
87a7d1c859Sitojundoes not take care of multicast addresses which have non link-local
88a7d1c859Sitojunscope.
89