diff options
author | bms <bms@FreeBSD.org> | 2007-04-10 00:26:12 +0000 |
---|---|---|
committer | bms <bms@FreeBSD.org> | 2007-04-10 00:26:12 +0000 |
commit | 84121b90712f942d2525e9acdf31d8cb47c4e6ef (patch) | |
tree | 2e2747af71c0c7692da1784180651d66a1770b3b /usr.sbin/ifmcstat/ifmcstat.8 | |
parent | 2ffc30645ae11e23b51eee230c0f87a3c3450e18 (diff) | |
download | FreeBSD-src-84121b90712f942d2525e9acdf31d8cb47c4e6ef.zip FreeBSD-src-84121b90712f942d2525e9acdf31d8cb47c4e6ef.tar.gz |
Considerably rework the ifmcstat utility.
* Build with or without INET, INET6, or KVM features.
* When built without KVM, the sysctl-based getifmaddrs() function
is used as the back-end for the utility.
* Reflect the fact that FreeBSD now uses the in_multi refcount as
a true refcount.
* Style.
The utility may now be run without super-user privilege, albeit with
a less detailed display, equivalent to that of the soon-to-be-retired
netstat -g host-mode output.
MFC after: 3 weeks
Diffstat (limited to 'usr.sbin/ifmcstat/ifmcstat.8')
-rw-r--r-- | usr.sbin/ifmcstat/ifmcstat.8 | 42 |
1 files changed, 40 insertions, 2 deletions
diff --git a/usr.sbin/ifmcstat/ifmcstat.8 b/usr.sbin/ifmcstat/ifmcstat.8 index 5298e71..c0effba 100644 --- a/usr.sbin/ifmcstat/ifmcstat.8 +++ b/usr.sbin/ifmcstat/ifmcstat.8 @@ -29,7 +29,7 @@ .\" .\" $FreeBSD$ .\" -.Dd March 20, 2007 +.Dd April 10, 2007 .Dt IFMCSTAT 8 .Os .Sh NAME @@ -60,6 +60,13 @@ specifies the address-family to be displayed; currently only and .Ar inet6 are supported. +.El +.Pp +The following options are only available if +.Nm +has been built with support for +.Xr kvm 3 . +.Bl -tag -width Fl .It Fl M Ar core extracts values associated with the name list from the specified core, instead of the default @@ -72,6 +79,37 @@ This is the same as specifying .Nm .Fl N Ar system . This usage is deprecated; it is supported only for backwards compatibility. +.Sh IMPLEMENTATION NOTES +When built without +.Xr kvm 3 +support, the information displayed by +.Nm +is more limited. +This support is recommended for debugging purposes. +It requires superuser privilege if used to inspect a running kernel. +.Pp +When run without using +.Xr kvm 3 +support, +.Nm +may print multicast MAC addresses twice if they are +referenced by a layer 3 protocol. +.Pp +When run with +.Xr kvm 3 +support, +the names of all interfaces configured in the system will be +printed in the first column of output, even if no multicast +addresses are configured on those interfaces. +.Sh SEE ALSO +.Xr getifaddrs 3 , +.Xr getifmaddrs 3 , +.Xr kvm 3 , +.Xr netstat 8 .Sh BUGS .Nm -needs superuser privilege. +does not support the +.Ar link +argument to the +.Ar address-family +option. |