From andrew@ugh.net.au  Fri Aug 24 22:52:06 2001
Return-Path: <andrew@ugh.net.au>
Received: from starbug.ugh.net.au (starbug.ugh.net.au [203.31.238.37])
	by hub.freebsd.org (Postfix) with ESMTP id 8E0A537B405
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 24 Aug 2001 22:52:05 -0700 (PDT)
	(envelope-from andrew@ugh.net.au)
Received: by starbug.ugh.net.au (Postfix, from userid 1000)
	id 71FAAA971; Sat, 25 Aug 2001 15:52:04 +1000 (EST)
Message-Id: <20010825055204.71FAAA971@starbug.ugh.net.au>
Date: Sat, 25 Aug 2001 15:52:04 +1000 (EST)
From: andrew@ugh.net.au
Reply-To: andrew@ugh.net.au
To: FreeBSD-gnats-submit@freebsd.org
Subject: netstat man page doesn't describe the meaning of *
X-Send-Pr-Version: 3.2

>Number:         30069
>Category:       docs
>Synopsis:       netstat man page doesn't describe the meaning of *
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Aug 24 23:00:01 PDT 2001
>Closed-Date:    Tue Aug 28 05:45:48 PDT 2001
>Last-Modified:  Tue Aug 28 05:47:57 PDT 2001
>Originator:     Andrew
>Release:        FreeBSD 4.3-STABLE i386
>Organization:
UgH!
>Environment:

	

>Description:

netstat -i shows the state of the network interfaces in the machine. It places
a * after the name of a device that is "down" however the manpage does not
mention this.

I wasn't sure if I should describe the interface as "down" or "not up". "down"
reads better but "not up" is what the code is actually testing for. I don't
know if it is possible (or if it ever will be possible) for an interface to
be not (up || down).

>How-To-Repeat:

	

>Fix:


--- /usr/src/usr.bin/netstat/netstat.1	Fri Aug 10 23:58:39 2001
+++ netstat.1	Sat Aug 25 15:44:18 2001
@@ -190,7 +190,9 @@
 .It Fl i
 Show the state of interfaces which have been auto-configured
 (interfaces statically configured into a system, but not
-located at boot time are not shown).
+located at boot time are not shown). A * after an interface name indicates
+the interface is not
+.Dq up .
 If the
 .Fl a
 options is also present, multicast addresses currently in use are shown
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Tue Aug 28 05:45:48 PDT 2001 
State-Changed-Why:  
Applied after some minor changes, thanks! 

Regarding the up/down thing: IFF_UP is a flag like IFF_BROADCAST, 
IFF_NOARP, IFF_LINK0, etc., but the opposite of being up is down; 
thus, if the flag isn't set, the interface is administratively down. 
Reflecting this was one of my changes. 

Thanks! 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=30069 
>Unformatted:
