xref: /freebsd/usr.sbin/mld6query/mld6query.8 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
133841545SHajimu UMEMOTO.\"	$KAME: mld6query.8,v 1.5 2000/12/04 06:28:23 itojun Exp $
233841545SHajimu UMEMOTO.\"
3a61156e3SHajimu UMEMOTO.\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
4a61156e3SHajimu UMEMOTO.\" All rights reserved.
5a61156e3SHajimu UMEMOTO.\"
6a61156e3SHajimu UMEMOTO.\" Redistribution and use in source and binary forms, with or without
7a61156e3SHajimu UMEMOTO.\" modification, are permitted provided that the following conditions
8a61156e3SHajimu UMEMOTO.\" are met:
9a61156e3SHajimu UMEMOTO.\" 1. Redistributions of source code must retain the above copyright
10a61156e3SHajimu UMEMOTO.\"    notice, this list of conditions and the following disclaimer.
11a61156e3SHajimu UMEMOTO.\" 2. Redistributions in binary form must reproduce the above copyright
12a61156e3SHajimu UMEMOTO.\"    notice, this list of conditions and the following disclaimer in the
13a61156e3SHajimu UMEMOTO.\"    documentation and/or other materials provided with the distribution.
14a61156e3SHajimu UMEMOTO.\" 3. Neither the name of the project nor the names of its contributors
15a61156e3SHajimu UMEMOTO.\"    may be used to endorse or promote products derived from this software
16a61156e3SHajimu UMEMOTO.\"    without specific prior written permission.
17a61156e3SHajimu UMEMOTO.\"
18a61156e3SHajimu UMEMOTO.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
19a61156e3SHajimu UMEMOTO.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20a61156e3SHajimu UMEMOTO.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21a61156e3SHajimu UMEMOTO.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
22a61156e3SHajimu UMEMOTO.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23a61156e3SHajimu UMEMOTO.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24a61156e3SHajimu UMEMOTO.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25a61156e3SHajimu UMEMOTO.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26a61156e3SHajimu UMEMOTO.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27a61156e3SHajimu UMEMOTO.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28a61156e3SHajimu UMEMOTO.\" SUCH DAMAGE.
29a61156e3SHajimu UMEMOTO.\"
30a61156e3SHajimu UMEMOTO.Dd May 17, 1998
31a61156e3SHajimu UMEMOTO.Dt MLD6QUERY 8
32a4c37c81SRuslan Ermilov.Os
33a61156e3SHajimu UMEMOTO.\"
34a61156e3SHajimu UMEMOTO.Sh NAME
35a61156e3SHajimu UMEMOTO.Nm mld6query
36a61156e3SHajimu UMEMOTO.Nd send multicast listener query
37a61156e3SHajimu UMEMOTO.\"
38a61156e3SHajimu UMEMOTO.Sh SYNOPSIS
39a61156e3SHajimu UMEMOTO.Nm
40*71cf0564SStephen Hurd.Op Fl dgr
41a61156e3SHajimu UMEMOTO.Ar intface
42a61156e3SHajimu UMEMOTO.Op Ar maddr
43a61156e3SHajimu UMEMOTO.\"
44a61156e3SHajimu UMEMOTO.Sh DESCRIPTION
45490d5836SPhilippe CharnierThe
46a61156e3SHajimu UMEMOTO.Nm
47490d5836SPhilippe Charnierutility sends an IPv6 multicast listener discovery (MLD) query packet toward
48a61156e3SHajimu UMEMOTOthe specified multicast address,
49a61156e3SHajimu UMEMOTO.Ar maddr ,
50a61156e3SHajimu UMEMOTOtoward interface
51a61156e3SHajimu UMEMOTO.Ar intface .
52a61156e3SHajimu UMEMOTOIf you omit
53a61156e3SHajimu UMEMOTO.Ar maddr ,
54a61156e3SHajimu UMEMOTOlinklocal all nodes multicast address(ff02::1) is used.
55a61156e3SHajimu UMEMOTO.Pp
56a61156e3SHajimu UMEMOTOAfter sending a query,
57a61156e3SHajimu UMEMOTO.Nm
58a61156e3SHajimu UMEMOTOwaits for replies for at most 10 seconds.
59a61156e3SHajimu UMEMOTOIf a reply is returned,
60a61156e3SHajimu UMEMOTO.Nm
61a61156e3SHajimu UMEMOTOprints it with its type and then waits for another reply.
62a61156e3SHajimu UMEMOTO.Pp
63a61156e3SHajimu UMEMOTOThis program is provided only for debugging.
64a61156e3SHajimu UMEMOTOIt is not necessary for normal use.
65a61156e3SHajimu UMEMOTO.Pp
66a61156e3SHajimu UMEMOTOWith
67*71cf0564SStephen Hurd.Fl g ,
68*71cf0564SStephen Hurd.Nm
69*71cf0564SStephen Hurdwill transmit a General Query instead of the default Multicast-Address-Specific Query.
70*71cf0564SStephen HurdWith
71a61156e3SHajimu UMEMOTO.Fl d ,
72a61156e3SHajimu UMEMOTO.Nm
73a61156e3SHajimu UMEMOTOwill transmit MLD done packet instead of MLD query packet.
74a61156e3SHajimu UMEMOTOWith
75a61156e3SHajimu UMEMOTO.Fl r ,
76a61156e3SHajimu UMEMOTOsimilarly, MLD report packet will be transmitted.
77a61156e3SHajimu UMEMOTO.Fl dr
78a61156e3SHajimu UMEMOTOoptions are for debugging purposes only.
79a61156e3SHajimu UMEMOTO.\"
80caaaf8d1SDaniel Gerzo.Sh EXIT STATUS
81a61156e3SHajimu UMEMOTOThe program exits with 0 on success, non-zero on failures.
82a61156e3SHajimu UMEMOTO.\"
83a61156e3SHajimu UMEMOTO.\" .Sh SEE ALSO
84a61156e3SHajimu UMEMOTO.\"
85a61156e3SHajimu UMEMOTO.Sh HISTORY
86a61156e3SHajimu UMEMOTOThe
87a61156e3SHajimu UMEMOTO.Nm
88490d5836SPhilippe Charnierutility first appeared in WIDE/KAME IPv6 protocol stack kit.
89a61156e3SHajimu UMEMOTO.Sh BUGS
90490d5836SPhilippe CharnierThe
91490d5836SPhilippe Charnier.Nm
92490d5836SPhilippe Charnierutility does not take care of multicast addresses which have non link-local
93a61156e3SHajimu UMEMOTOscope.
94