From nobody@FreeBSD.org  Tue Nov 15 15:31:48 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 2D48F1065674
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 15 Nov 2011 15:31:48 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 1CAE28FC16
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 15 Nov 2011 15:31:48 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id pAFFVk0P045999
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 15 Nov 2011 15:31:46 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id pAFFVkoW045998;
	Tue, 15 Nov 2011 15:31:46 GMT
	(envelope-from nobody)
Message-Id: <201111151531.pAFFVkoW045998@red.freebsd.org>
Date: Tue, 15 Nov 2011 15:31:46 GMT
From: Vincent Hoffman-Kazlauskas <vince@unsane.co.uk>
To: freebsd-gnats-submit@FreeBSD.org
Subject: unclear/incomplete description of per-interface statistics flag in netstat(1)
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         162587
>Category:       docs
>Synopsis:       unclear/incomplete description of per-interface statistics flag in netstat(1)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Nov 15 15:40:07 UTC 2011
>Closed-Date:    
>Last-Modified:  Sun Jul 22 17:01:48 UTC 2012
>Originator:     Vincent Hoffman-Kazlauskas
>Release:        9.0-RC2
>Organization:
>Environment:
FreeBSD zfstest 9.0-RC2 FreeBSD 9.0-RC2 #1 r227515:227516M: Mon Nov 14 23:15:40 GMT 2011     root@zfstest:/usr/obj/usr/src/sys/ZFSTEST  amd64
>Description:
netstat(1) contains the following:
     netstat -i | -I interface -s [-f protocol_family | -p protocol] [-M core]
             [-N system]
             Display per-interface statistics for each network protocol, for a
             particular protocol_family, or for a single protocol.

however IPv4 (and maybe more, I dont know or how to find out,) does not support per interface statistics. 

>How-To-Repeat:
[root@zfstest ~]# netstat -i -s -f inet
[root@zfstest ~]# 

>Fix:
possibly reword to something like.

     netstat -i | -I interface -s [-f protocol_family | -p protocol] [-M core]
             [-N system]
             Display per-interface statistics for each network protocol, for a
             particular protocol_family, or for a single protocol. Currently
             this is only supported for inet6.

Otherwise maybe exclude rather than include, it depends what is supported as leaving off the -f protocol_family only displays ip6 and icmp6 for me, but I dont use or know much about pfkey atalk netgraph or ipx, so i cant test them easily.



>Release-Note:
>Audit-Trail:
Class-Changed-From-To: sw-bug->doc-bug 
Class-Changed-By: gjb 
Class-Changed-When: Tue Nov 15 16:32:47 UTC 2011 
Class-Changed-Why:  
Reclassify. 



Responsible-Changed-From-To: freebsd-bugs->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Tue Nov 15 16:32:47 UTC 2011 
Responsible-Changed-Why:  
I'll take it. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=162587 
Responsible-Changed-From-To: gjb->freebsd-doc 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Sun Jul 22 17:01:01 UTC 2012 
Responsible-Changed-Why:  
Back to the pool for now, as I have not been able to make progress 
on this. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=162587 
>Unformatted:
