1 .\" $KAME: ifmcstat.8,v 1.6 2002/10/31 04:23:43 suz Exp $
3 .\" Copyright (C) 1995, 1996, 1997, 1998, and 1999 WIDE Project.
4 .\" All rights reserved.
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
14 .\" 3. Neither the name of the project nor the names of its contributors
15 .\" may be used to endorse or promote products derived from this software
16 .\" without specific prior written permission.
18 .\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
37 .Nd dump multicast group management statistics per interface
41 .Op Fl f Ar address-family
50 command dumps multicast group information from the kernel.
52 The following options are supported:
55 specifies the interface to be displayed.
57 .It Fl f Ar address-family
58 specifies the address-family to be displayed; currently only
65 The following options are only available if
67 has been built with support for
71 extracts values associated with the name list from the specified core,
72 instead of the default
75 extracts the name list from the specified kernel instead of the
76 default, which is the kernel image the system has booted from.
78 This is the same as specifying
81 This usage is deprecated; it is supported only for backwards compatibility.
82 .Sh IMPLEMENTATION NOTES
85 support, the information displayed by
88 This support is recommended for debugging purposes.
89 It requires superuser privilege if used to inspect a running kernel.
91 When run without using
95 may print multicast MAC addresses twice if they are
96 referenced by a layer 3 protocol.
101 the names of all interfaces configured in the system will be
102 printed in the first column of output, even if no multicast
103 addresses are configured on those interfaces.