History log of /freebsd-current/usr.bin/netstat/netstat.1
Revision Date Author Comments
# bdcbfde3 23-Nov-2023 Warner Losh <imp@FreeBSD.org>

usr.bin: Remove ancient SCCS tags.

Remove ancient SCCS tags from the tree, automated scripting, with two
minor fixup to keep things compiling. All the common forms in the tree
were removed with a perl script.

Sponsored by: Netflix


# b2c76c41 16-Aug-2023 Warner Losh <imp@FreeBSD.org>

Remove $FreeBSD$: one-line nroff pattern

Remove /^\.\\"\s*\$FreeBSD\$$\n/


# 3af3571c 16-Aug-2023 Doug Rabson <dfr@FreeBSD.org>

netstat(1): fix manpage date

MFC after: 1 week


# 182e8ae2 14-Aug-2023 Doug Rabson <dfr@FreeBSD.org>

netstat(1): teach netstat to attach to jails

Add -j <jail> flag to netstat(1) to allow access to network information
from a jail.

MFC after: 1 week
Differential Revision: https://reviews.freebsd.org/D41446


# 372e3d56 26-Jul-2023 Mike Karels <karels@FreeBSD.org>

netstat -i: compute most field widths dynamically

The network and address fields were sometimes truncated for netstat -i
without -W, and often much too wide for netstat -i with the -W option.
Fields such as normal packet counts often overflowed. As a result,
columns didn't line up, and large white spaces made it harder to
follow a line across the display. Change the code to compute the
required field sizes for network, address, and various packet counts.
Hoist the code to format network and address into a subroutine that
can be called twice, once to measure the required field widths,
and once to emit the values. Use separate field widths for input
and output packets, byte counts, and error and drop counters.
These are left at defaults (the preceding values) with the -h
option, in which case the fields have a limited total width.
An extra space is included between the Network and Address, which
otherwise seemed too close.

Change the mention of -W with -i in the man page to say that most
field widths are computed dynamically in this case.

MFC after: 1 week
Reviewed by: sjg, glebius
Differential Revision: https://reviews.freebsd.org/D41160


# e495600c 26-Jun-2023 Tom Hukins <tom@FreeBSD.org>

netstat(1): Use simpler language

Reviewed by: imp, Mina Galić
Pull Request: https://github.com/freebsd/freebsd-src/pull/771


# 373b9597 18-Apr-2023 Michael Tuexen <tuexen@FreeBSD.org>

netstat: document that PCB information can't be read from corefiles

Reviewed by: glebius, cc
Sponsored by: Netflix, Inc.
Differential Revision: https://reviews.freebsd.org/D39610


# 91706f0d 18-Feb-2023 Fernando Apesteguía <fernape@FreeBSD.org>

netstat.1: Clarify -i and -I priorities

netstat(1) allows to specify both -i (all interfaces) and -I <ifname>.
However, when both are specified, -I always overrides -i.
Add a comment where appropriate the same way we do in rm(1) for -f and -i.

PR: 202708
Reported by: demon@
Approved by: manpages (pauamma@)
Differential Revision: https://reviews.freebsd.org/D38654


# 657729a8 02-Dec-2022 Gleb Smirnoff <glebius@FreeBSD.org>

Retire trpt(8).

trpt(8) was utility to pull TCP debugging data from the kernel
originating back from 4.2BSD. It is not used nowadays by TCP
developers. We have more powerful debugging facilities, e.g.
the Dtrace probing, the TCP black box logging and siftr.

Discussed with: rscheff, tuexen, rrs, jtl and others


# 231092bb 02-Jul-2022 Mike Karels <karels@FreeBSD.org>

netstat -i: do not truncate interface names

The field for interface names for netstat -i was 5 characters by
default, which is no longer sufficient with names like "vlan1234"
and "vtnet0". netstat -iW computed the necessary field width, but
also enlarged the address field by a lot (especially with IPv6 enabled).
Make netstat -i compute the field width for interface names with or
without -W. Note that the existing default output does not fit in
80 columns in any case. Update the man page accordingly, documenting
the remaining effect of -W with -i. Also add -W to the list of
General Options, as there are numerous pointers to this.

Reported by: Chris Ross
Reviewed by: melifaro, rgrimes, cy
Differential Revision: https://reviews.freebsd.org/D35703
MFC after: 1 week


# d59bc188 27-May-2022 Gleb Smirnoff <glebius@FreeBSD.org>

sockbuf: remove unused mbuf counter and cluster counter

With M_EXTPG mbufs these two counters already do not represent the
reality. As we are moving towards protocol independent socket buffers,
which may not even use mbufs at all, the counters become less and less
relevant. The only userland seeing them was 'netstat -x'.

PR: 264181 (exp-run)
Reviewed by: markj
Differential revision: https://reviews.freebsd.org/D35334


# 0e5e35e3 09-Oct-2020 Richard Scheffenegger <rscheff@FreeBSD.org>

Extend netstat to display TCP stack and detailed congestion state

Adding the "-c" option used to show detailed per-connection
congestion control state for TCP sessions.

This is one summary patch, which adds the relevant variables into
xtcpcb. As previous "spare" space is used, these changes are ABI
compatible.

Reviewed by: tuexen
MFC after: 2 weeks
Sponsored by: NetApp, Inc.
Differential Revision: https://reviews.freebsd.org/D26518


# b98a21f6 13-Sep-2020 Michael Tuexen <tuexen@FreeBSD.org>

Add a -C option to netstat to display the congestion control for
TCP connections.

Reviewed by: rscheff
MFC after: 1 week
Sponsored by: Netflix, Inc.
Differential Revision: https://reviews.freebsd.org/D26414


# f8f51b49 21-Jul-2020 Fernando Apesteguía <fernape@FreeBSD.org>

netstat(1): Add EXAMPLES section

* Add small EXAMPLES section
* Fix warning reported by mandoc (./netstat.1:747:2: WARNING: skipping paragraph
macro: Pp before Ss)

Approved by: manpages (gbe)
Differential Revision: https://reviews.freebsd.org/D25212


# 752c009f 22-Mar-2018 Jonathan T. Looney <jtl@FreeBSD.org>

Bump netstat.1's .Dd after r331347.


# 2529f56e 22-Mar-2018 Jonathan T. Looney <jtl@FreeBSD.org>

Add the "TCP Blackbox Recorder" which we discussed at the developer
summits at BSDCan and BSDCam in 2017.

The TCP Blackbox Recorder allows you to capture events on a TCP connection
in a ring buffer. It stores metadata with the event. It optionally stores
the TCP header associated with an event (if the event is associated with a
packet) and also optionally stores information on the sockets.

It supports setting a log ID on a TCP connection and using this to correlate
multiple connections that share a common log ID.

You can log connections in different modes. If you are doing a coordinated
test with a particular connection, you may tell the system to put it in
mode 4 (continuous dump). Or, if you just want to monitor for errors, you
can put it in mode 1 (ring buffer) and dump all the ring buffers associated
with the connection ID when we receive an error signal for that connection
ID. You can set a default mode that will be applied to a particular ratio
of incoming connections. You can also manually set a mode using a socket
option.

This commit includes only basic probes. rrs@ has added quite an abundance
of probes in his TCP development work. He plans to commit those soon.

There are user-space programs which we plan to commit as ports. These read
the data from the log device and output pcapng files, and then let you
analyze the data (and metadata) in the pcapng files.

Reviewed by: gnn (previous version)
Obtained from: Netflix, Inc.
Relnotes: yes
Differential Revision: https://reviews.freebsd.org/D11085


# c1fa8470 09-Sep-2017 Michael Tuexen <tuexen@FreeBSD.org>

The combination of IPv6 and SCTP is also supported.

MFC after: 1 week


# fbbd9655 28-Feb-2017 Warner Losh <imp@FreeBSD.org>

Renumber copyright clause 4

Renumber cluase 4 to 3, per what everybody else did when BSD granted
them permission to remove clause 3. My insistance on keeping the same
numbering for legal reasons is too pedantic, so give up on that point.

Submitted by: Jan Schaumann <jschauma@stevens.edu>
Pull Request: https://github.com/freebsd/freebsd/pull/96


# 06691045 01-Dec-2015 Craig Rodrigues <rodrigc@FreeBSD.org>

Add more text to explain --libxo flag.


# e7ae88ee 27-Aug-2015 John-Mark Gurney <jmg@FreeBSD.org>

add documentation for timers that silby added in r197244, almost 6 years
ago...


# 6fe17960 06-Apr-2015 Gleb Smirnoff <glebius@FreeBSD.org>

Like it was already done for 'netstat -i', drop the kvm(3) support
in 'netstat -r'.

The netstat/route.c was the last abuser of struct ifnet and struct
rtentry in the tree. With this change if_var.h can become kernel
only include, _WANT_RTENTRY can go away and projects/ifnet and
projects/routing can go forward.

Differential Revision: https://reviews.freebsd.org/D2242
Reviewed by: melifaro, gnn
Sponsored by: Nginx, Inc.
Sponsored by: Netflix


# c151f24d 06-Apr-2015 Gleb Smirnoff <glebius@FreeBSD.org>

o Make net.inet6.ip6.mif6table return special API structure, that doesn't
contain kernel pointers, and instead has interface index.
Bump __FreeBSD_version for that change.
o Now, netstat/mroute6.c no longer needs to kvm_read(3) struct ifnet, and
no longer needs to include if_var.h

Note that this change is far from being a complete move of IPv6 multicast
routing to a proper API. Other structures are still dumped into their
sysctls as is, requiring userland application to #define _KERNEL when
including ip6_mroute.h and then call kvm_read(3) to gather all bits and
pieces. But fixing this is out of scope of the opaque ifnet project.

Sponsored by: Nginx, Inc.
Sponsored by: Netflix


# 6504b42f 21-Feb-2015 Marcel Moolenaar <marcel@FreeBSD.org>

Document that netstat(1) supports libxo(3).


# 275b7839 06-Jun-2014 Joel Dahl <joel@FreeBSD.org>

Minor mdoc nit.


# 997a303f 04-Jun-2014 Allan Jude <allanjude@FreeBSD.org>

Sadly, we do not actually live in the future.

Approved by: wblock (mentor)


# fd2c6bc9 03-Jun-2014 Allan Jude <allanjude@FreeBSD.org>

Further updates to the netstat(1) man page and usage message

- Reformat the entire man page
- Create a proper synopsis section
- Use itemized-lists to describe each flag, rather than paragraphs
- Cross-reference common flags to a 'general flags' sub-section with short
inline description of the flag
- Label 'general flags' sub-section
- Apply additional fixes suggested by wblock, brueffer, and bdrewery
- Update .Dd that got undone previously
- Change the order of the .Op Fl to be alphabetical
- Add the -i | -I interface flags to the description of 'interface
display mode'
- Fix missing parameters in man page
- Fix missing parameters in usage()
- Sync man page and usage()

MFC Note: stable/9 and stable/10 do not have -R, will need to be removed
when merged

CR: D58
Reviewed by: brueffer, bcr
Approved by: wblock (mentor)
MFC after: 7 days
Sponsored by: ScaleEngine Inc.


# ada0a6dd 25-May-2014 Allan Jude <allanjude@FreeBSD.org>

Add path markup on sys/mbuf.h to previous netstat(1) man page update

Submitted by: brueffer
Reviewed by: eadler (mentor)


# e9fa95e9 25-May-2014 Allan Jude <allanjude@FreeBSD.org>

Document the new -R flag of netstat(1) introduced in r266448 that tracks the
flowid for each socket.

Reviewed by: adrian
Approved by: eadler (mentor)


# 66dcee72 15-Mar-2014 Gleb Smirnoff <glebius@FreeBSD.org>

Garbage collect long time obsoleted (or never used) stuff from routing API.


# 45c203fc 14-Mar-2014 Gleb Smirnoff <glebius@FreeBSD.org>

Remove AppleTalk support.

AppleTalk was a network transport protocol for Apple Macintosh devices
in 80s and then 90s. Starting with Mac OS X in 2000 the AppleTalk was
a legacy protocol and primary networking protocol is TCP/IP. The last
Mac OS X release to support AppleTalk happened in 2009. The same year
routing equipment vendors (namely Cisco) end their support.

Thus, AppleTalk won't be supported in FreeBSD 11.0-RELEASE.


# 2c284d93 13-Mar-2014 Gleb Smirnoff <glebius@FreeBSD.org>

Remove IPX support.

IPX was a network transport protocol in Novell's NetWare network operating
system from late 80s and then 90s. The NetWare itself switched to TCP/IP
as default transport in 1998. Later, in this century the Novell Open
Enterprise Server became successor of Novell NetWare. The last release
that claimed to still support IPX was OES 2 in 2007. Routing equipment
vendors (e.g. Cisco) discontinued support for IPX in 2011.

Thus, IPX won't be supported in FreeBSD 11.0-RELEASE.


# 120dc21b 11-Jan-2014 Alexander V. Chernikov <melifaro@FreeBSD.org>

Bump dates in nestat(1) and route(8) man pages.
Fix several small errors introduced by r260524.

Suggested by: glebius
MFC after: 2 weeks


# 17ed2e8e 10-Jan-2014 Alexander V. Chernikov <melifaro@FreeBSD.org>

Add -4/-6 shorthand for -finet/-finet6 in route(8) and netstat(8).

MFC after: 2 weeks


# 82b90729 30-Oct-2013 Gleb Smirnoff <glebius@FreeBSD.org>

'netstat -i' no longer supports working on a vmcore.


# 3fddef95 12-Jul-2013 Hiroki Sato <hrs@FreeBSD.org>

Add -F fibnum option to specify an FIB number for -r flag.


# 7e4f8ab6 09-Mar-2013 Alexander V. Chernikov <melifaro@FreeBSD.org>

Add forgotten .El

MFC with: r248112


# 69cf5b29 09-Mar-2013 Alexander V. Chernikov <melifaro@FreeBSD.org>

Document netstat -Q flags meaning.

MFC after: 1 week


# da52b4ca 11-Dec-2010 Joel Dahl <joel@FreeBSD.org>

Remove the advertising clause from UCB copyrighted files in usr.bin. This
is in accordance with the information provided at
ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change

Also add $FreeBSD$ to a few files to keep svn happy.

Discussed with: imp, rwatson


# f5d34df5 17-Nov-2010 George V. Neville-Neil <gnn@FreeBSD.org>

Add new, per connection, statistics for TCP, including:
Retransmitted Packets
Zero Window Advertisements
Out of Order Receives

These statistics are available via the -T argument to
netstat(1).
MFC after: 2 weeks


# a7d5f7eb 19-Oct-2010 Jamie Gritton <jamie@FreeBSD.org>

A new jail(8) with a configuration file, to replace the work currently done
by /etc/rc.d/jail.


# fe0506d7 09-Mar-2010 Marcel Moolenaar <marcel@FreeBSD.org>

Create the altix project branch. The altix project will add support
for the SGI Altix 350 to FreeBSD/ia64. The hardware used for porting
is a two-module system, consisting of a base compute module and a
CPU expansion module. SGI's NUMAFlex architecture can be an excellent
platform to test CPU affinity and NUMA-aware features in FreeBSD.


# f8366572 22-Feb-2010 Robert Watson <rwatson@FreeBSD.org>

Update date on netstat(1) for -Q.

Suggested by: bz
MFC after: 1 week


# 0153eb66 22-Feb-2010 Robert Watson <rwatson@FreeBSD.org>

Teach netstat(1) to print out netisr statistics when given the -Q argument.
Currently supports only reporting on live systems via sysctl, kmem support
needs to be edded.

MFC after: 1 week
Sponsored by: Juniper Networks


# 0985bbea 09-Feb-2010 Xin LI <delphij@FreeBSD.org>

MFC r202060:

Add a new option, -q howmany, which when used in conjuction with -w,
exits netstat after _howmany_ outputs.

Requested by: thomasa
Reviewed by: freebsd-net (bms, old version in early 2007)


# bf10ffe1 10-Jan-2010 Xin LI <delphij@FreeBSD.org>

Add a new option, -q howmany, which when used in conjuction with -w,
exits netstat after _howmany_ outputs.

Requested by: thomasa
Reviewed by: freebsd-net (bms, old version in early 2007)
MFC after: 1 month


# 3ee7e0d4 01-Dec-2009 John Baldwin <jhb@FreeBSD.org>

Remove -t from the manpage and usage.


# b8614722 15-Sep-2009 Mike Silbersack <silby@FreeBSD.org>

Add the ability to see TCP timers via netstat -x. This can be a useful
feature when you have a seemingly stuck socket and want to figure
out why it has not been closed yet.

No plans to MFC this, as it changes the netstat sysctl ABI.

Reviewed by: andre, rwatson, Eric Van Gyzen


# e5002279 09-Jul-2009 Edward Tomasz Napierala <trasz@FreeBSD.org>

Add manual page links to advertise procstat(1) a little better.

Approved by: re (kib)


# 0e37f3e1 19-Jun-2009 Christian S.J. Peron <csjp@FreeBSD.org>

Implement the -z (zero counters) option for the various bpf counters.
Add necessary changes to the kernel for this (basically introduce a
bpf_zero_counters() function). As well, update the man page.

MFC after: 1 month
Discussed with: rwatson


# 57e9cb8c 15-Feb-2009 Bruce M Simpson <bms@FreeBSD.org>

Now that ifmcstat(8) does not suck, retire host-mode netstat -g.
This change will not be back-ported.


# 8bee8d89 10-Jan-2009 Ruslan Ermilov <ru@FreeBSD.org>

Fix markup and spelling.


# d7f03759 19-Oct-2008 Ulf Lilleengen <lulf@FreeBSD.org>

- Import the HEAD csup code which is the basis for the cvsmode work.


# 49f287f8 15-May-2008 George V. Neville-Neil <gnn@FreeBSD.org>

Update the kernel to count the number of mbufs and clusters
(all types) used per socket buffer.

Add support to netstat to print out all of the socket buffer
statistics.

Update the netstat manual page to describe the new -x flag
which gives the extended output.

Reviewed by: rwatson, julian


# 664fd46b 10-Jun-2007 Ceri Davies <ceri@FreeBSD.org>

Document SCTP support.


# cb29445a 29-Sep-2006 Ruslan Ermilov <ru@FreeBSD.org>

Markup fixes.


# 9d518675 18-Dec-2005 Christian S.J. Peron <csjp@FreeBSD.org>

Provide some basic documentation explaining what the bpf(4) flags are
supposed to mean. Also, add an external references for bpf now that we
reference flags from that man page.


# 4e9e907d 18-Nov-2005 Ruslan Ermilov <ru@FreeBSD.org>

-mdoc sweep.


# b6de9e91 27-Sep-2005 Max Laier <mlaier@FreeBSD.org>

Remove bridge(4) from the tree. if_bridge(4) is a full functional
replacement and has additional features which make it superior.

Discussed on: -arch
Reviewed by: thompsa
X-MFC-after: never (RELENG_6 as transition period)


# 6b463eed 07-Sep-2005 Christian S.J. Peron <csjp@FreeBSD.org>

Merge bpfstat's functionality into the netstat(1) utility. This adds
a -B option which causes bpf peers to be printed. This option can be
used in conjunction with -I if information about specific interfaces
is desired. This is similar to what NetBSD added to their version of
netstat.

$ netstat -B
Pid Netif Flags Recv Drop Match Sblen Hblen Command
1137 lo0 p--s-- 0 0 0 0 0 tcpdump
205 sis0 -ifs-l 37331 0 1 0 0 dhclient
$

$ netstat -I lo0 -B
Pid Netif Flags Recv Drop Match Sblen Hblen Command
1174 lo0 p--s-- 0 0 0 0 0 tcpdump
$

-Add bpf.c which stores all the code for retrieving and parsing bpf
related statistics.
-Modify main.c to add support for the -B option and hook it into the
program logic.
-Add bpf.c to the build.
-Document this new functionality in the man page and bump the revision
date.
-Add prototype for bpf_stats function.


# b7cc0362 23-Aug-2005 Yaroslav Tykhiy <ytykhiy@gmail.com>

List -W as one of the meaningful options to the -i (interfaces)
display of netstat(1).

MFC after: 3 days


# c2dfd19f 18-Aug-2005 Gleb Smirnoff <glebius@FreeBSD.org>

Add a new switch -h for interface stats mode, which prints all interface
statistics in human readable form.

In collaboration with: vsevolod
Reviewed by: cperciva


# 099a0e58 31-May-2004 Bosko Milekic <bmilekic@FreeBSD.org>

Bring in mbuma to replace mballoc.

mbuma is an Mbuf & Cluster allocator built on top of a number of
extensions to the UMA framework, all included herein.

Extensions to UMA worth noting:
- Better layering between slab <-> zone caches; introduce
Keg structure which splits off slab cache away from the
zone structure and allows multiple zones to be stacked
on top of a single Keg (single type of slab cache);
perhaps we should look into defining a subset API on
top of the Keg for special use by malloc(9),
for example.
- UMA_ZONE_REFCNT zones can now be added, and reference
counters automagically allocated for them within the end
of the associated slab structures. uma_find_refcnt()
does a kextract to fetch the slab struct reference from
the underlying page, and lookup the corresponding refcnt.

mbuma things worth noting:
- integrates mbuf & cluster allocations with extended UMA
and provides caches for commonly-allocated items; defines
several zones (two primary, one secondary) and two kegs.
- change up certain code paths that always used to do:
m_get() + m_clget() to instead just use m_getcl() and
try to take advantage of the newly defined secondary
Packet zone.
- netstat(1) and systat(1) quickly hacked up to do basic
stat reporting but additional stats work needs to be
done once some other details within UMA have been taken
care of and it becomes clearer to how stats will work
within the modified framework.

From the user perspective, one implication is that the
NMBCLUSTERS compile-time option is no longer used. The
maximum number of clusters is still capped off according
to maxusers, but it can be made unlimited by setting
the kern.ipc.nmbclusters boot-time tunable to zero.
Work should be done to write an appropriate sysctl
handler allowing dynamic tuning of kern.ipc.nmbclusters
at runtime.

Additional things worth noting/known issues (READ):
- One report of 'ips' (ServeRAID) driver acting really
slow in conjunction with mbuma. Need more data.
Latest report is that ips is equally sucking with
and without mbuma.
- Giant leak in NFS code sometimes occurs, can't
reproduce but currently analyzing; brueffer is
able to reproduce but THIS IS NOT an mbuma-specific
problem and currently occurs even WITHOUT mbuma.
- Issues in network locking: there is at least one
code path in the rip code where one or more locks
are acquired and we end up in m_prepend() with
M_WAITOK, which causes WITNESS to whine from within
UMA. Current temporary solution: force all UMA
allocations to be M_NOWAIT from within UMA for now
to avoid deadlocks unless WITNESS is defined and we
can determine with certainty that we're not holding
any locks when we're M_WAITOK.
- I've seen at least one weird socketbuffer empty-but-
mbuf-still-attached panic. I don't believe this
to be related to mbuma but please keep your eyes
open, turn on debugging, and capture crash dumps.

This change removes more code than it adds.

A paper is available detailing the change and considering
various performance issues, it was presented at BSDCan2004:
http://www.unixdaemons.com/~bmilekic/netbuf_bmilekic.pdf
Please read the paper for Future Work and implementation
details, as well as credits.

Testing and Debugging:
rwatson,
brueffer,
Ketrien I. Saihr-Kesenchedra,
...
Reviewed by: Lots of people (for different parts)


# 0d25a5d8 19-May-2004 Ruslan Ermilov <ru@FreeBSD.org>

Bumped document date.
Fixed the grammar nit.


# 1d2a7e07 25-Mar-2004 Bruce M Simpson <bms@FreeBSD.org>

Sort SRCS in Makefile and document -g option additions.

Nudged by: ru


# dbe0253a 23-Dec-2003 Alfred Perlstein <alfred@FreeBSD.org>

Restore old netstat -m output.
A new flag '-c' can be used to ask for the cache stats.


# 25d295e1 28-Nov-2003 Bruce M Simpson <bms@FreeBSD.org>

Fix some minor nits in netstat whereby large interface names would be
truncated. In environments where many tunnel or vlan interfaces are created,
interface names have high numbers which overflow the field width.

PRs: bin/52349, bin/35838
Submitted by: Mike Tancsa, Scot W. Hetzel
Approved by: re (rwatson)


# c7b9b5bb 07-Aug-2003 Jeffrey Hsu <hsu@FreeBSD.org>

1. Add support for printing PIM-related statistics with
netstat -s -p pim

2. Print information about the bandwidth meters installed in the kernel with
netstat -g

Submitted by: Pavlin Radoslavov <pavlin@icir.org>


# c002b2c8 21-May-2003 Ruslan Ermilov <ru@FreeBSD.org>

Revert last delta.

The -l option is deprecated (hence undocumented in usage() and
SYNOPSIS), as was threatened in the commitlog accompanying rev.
1.10 of main.c.

Approved by: re (blanket)


# 66fe5468 25-Mar-2003 Giorgos Keramidas <keramida@FreeBSD.org>

Document the undcumnt -l option (that's a lowercase `el').

PR: 48466
Submitted by: Peter Philipp <dot.bomb@freenet.de>


# 811ae392 23-Oct-2001 Murray Stokely <murray@FreeBSD.org>

Fix typo.

PR: docs/31388
Submitted by: Yoshihiko Sarumaru <mistral@imasy.or.jp>


# d44ddba9 11-Sep-2001 Ruslan Ermilov <ru@FreeBSD.org>

Implement the ``-f address_family'' filter for -i.

Prodded by: Igor Podlesny <poige@morning.ru>


# e2beaf70 07-Sep-2001 Ruslan Ermilov <ru@FreeBSD.org>

Yay!
Make this manpage readable and match the reality.


# ad3a51b8 27-Aug-2001 Dima Dorfman <dd@FreeBSD.org>

-a is not an options (sic).


# 37a79c45 27-Aug-2001 Dima Dorfman <dd@FreeBSD.org>

Mention what an asterisk means in the -i display.

PR: 30069
Submitted by: andrew@ugh.net.au


# f247324d 15-Jul-2001 Dima Dorfman <dd@FreeBSD.org>

Remove whitespace at EOL.


# 5521ff5a 06-Jul-2001 Ruslan Ermilov <ru@FreeBSD.org>

mdoc(7) police: sort SEE ALSO xrefs (sort -b -f +2 -3 +1 -2).


# c73d99b5 23-Jun-2001 Ruslan Ermilov <ru@FreeBSD.org>

Add netstat(1) knob to reset net.inet.{ip|icmp|tcp|udp|igmp}.stats.
For example, ``netstat -s -p ip -z'' will show and reset IP stats.

PR: bin/17338


# aafccd6d 23-Jun-2001 Ruslan Ermilov <ru@FreeBSD.org>

Honor -s -s (don't show zero stats) with -r, untangle SYNOPSIS further.
(usage() still is not synchronized with SYNOPSIS, intentionally.)


# cf5e44f8 15-Jun-2001 Ruslan Ermilov <ru@FreeBSD.org>

First round of netstat(1) cleanup.

Removed the ambiguity in -s, -f, -p and -i flags handling.
Basically, there are four displays (except others):

1. PCB display.
2. Protocol statistics display. (-s)
3. Interface statistics display. (-i)
4. Per-interface protocol statistics display. (-i -s)

All of the above except 3) can be limited to a particular
protocol family (-f) or a single protocol (-p).

Some examples:

1. netstat -f inet -- show PCBs of all INET protocols
2. netstat -p udp -- show PCB of UDP protocol only (NEW!)
3. netstat -s -- show protocol statistics for all families
4. netstat -s -f inet -- show INET protocols statistics
5. netstat -s -p icmp -- show ICMP protocol statistics

This is a work in progress. Manpage has been fixed slightly,
but is still incomplete.


# 65ea0024 14-Jun-2001 Assar Westerlund <assar@FreeBSD.org>

add the option -S for printing port numbers symbolically but addresses
numerically. clean up the CFLAGS in Makefile.


# d15c5f56 14-Jun-2001 Ruslan Ermilov <ru@FreeBSD.org>

Restore -M -N support for -m.

PR: 20808


# 1f389209 14-Jun-2001 Ruslan Ermilov <ru@FreeBSD.org>

Removed -h option.


# 74cf6cfe 11-Jun-2001 Hajimu UMEMOTO <ume@FreeBSD.org>

Mention about -rl behavior change. Now, MTU is printed.


# b9408975 06-May-2001 Ruslan Ermilov <ru@FreeBSD.org>

Restore printing of routes cloned from a RTF_CLONING parent
(e.g., ARP table entries) with the default routing display.

PR: bin/26970
Reviewed by: wollman
MFC after: 3 days


# 8eda0140 18-Mar-2001 Ruslan Ermilov <ru@FreeBSD.org>

s/protocol-cloned/cloned/ I have missed in 1.24 -> 1.25.


# 080b7f49 15-Mar-2001 Dag-Erling Smørgrav <des@FreeBSD.org>

Add a -W flag that tells netstat not to truncate addresses even if they are
too long for the column they're printed in.

Move variable definitions out of netstat.h and into main.c.

Clean up some warnings.


# 089cdfad 15-Mar-2001 Ruslan Ermilov <ru@FreeBSD.org>

net/route.c:

A route generated from an RTF_CLONING route had the RTF_WASCLONED flag
set but did not have a reference to the parent route, as documented in
the rtentry(9) manpage. This prevented such routes from being deleted
when their parent route is deleted.

Now, for example, if you delete an IP address from a network interface,
all ARP entries that were cloned from this interface route are flushed.

This also has an impact on netstat(1) output. Previously, dynamically
created ARP cache entries (RTF_STATIC flag is unset) were displayed as
part of the routing table display (-r). Now, they are only printed if
the -a option is given.

netinet/in.c, netinet/in_rmx.c:

When address is removed from an interface, also delete all routes that
point to this interface and address. Previously, for example, if you
changed the address on an interface, outgoing IP datagrams might still
use the old address. The only solution was to delete and re-add some
routes. (The problem is easily observed with the route(8) command.)

Note, that if the socket was already bound to the local address before
this address is removed, new datagrams generated from this socket will
still be sent from the old address.

PR: kern/20785, kern/21914
Reviewed by: wollman (the idea)


# d0353b83 01-Feb-2001 Ruslan Ermilov <ru@FreeBSD.org>

mdoc(7) police: split punctuation characters + misc fixes.


# 8fe908ef 20-Nov-2000 Ruslan Ermilov <ru@FreeBSD.org>

mdoc(7) police: use the new features of the Nm macro.


# 1c6d96a1 11-Mar-2000 Yoshinobu Inoue <shin@FreeBSD.org>

Add "-l" option description.

Noticed the necessity by Ben Smithurst <ben@scientia.demon.co.uk> message
on freebsd-current.


# 87faa07b 29-Feb-2000 Sheldon Hearn <sheldonh@FreeBSD.org>

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.


# ac55add0 13-Dec-1999 Guido van Rooij <guido@FreeBSD.org>

Add new option, -L that will listen the various listen queue lengths.

Reviewed by: Garrett Wollman <wollman@khavrinen.lcs.mit.edu>,
Clive Lin <clive@GnatS.CirX.ORG>


# cfa1ca9d 07-Dec-1999 Yoshinobu Inoue <shin@FreeBSD.org>

udp IPv6 support, IPv6/IPv4 tunneling support in kernel,
packet divert at kernel for IPv6/IPv4 translater daemon

This includes queue related patch submitted by jburkhol@home.com.

Submitted by: queue related patch from jburkhol@home.com
Reviewed by: freebsd-arch, cvs-committers
Obtained from: KAME project


# df48b0d0 30-Oct-1999 Alexey Zelkin <phantom@FreeBSD.org>

uncomment FILES section (it look reasonable here)
mdoc(7)'fy


# 4cf49a43 21-Oct-1999 Julian Elischer <julian@FreeBSD.org>

Whistle's Netgraph link-layer (sometimes more) networking infrastructure.
Been in production for 3 years now. Gives Instant Frame relay to if_sr
and if_ar drivers, and PPPOE support soon. See:
ftp://ftp.whistle.com/pub/archie/netgraph/index.html
for on-line manual pages.

Reviewed by: Doug Rabson (dfr@freebsd.org)
Obtained from: Whistle CVS tree


# 5ff829fd 06-Sep-1999 Sheldon Hearn <sheldonh@FreeBSD.org>

Add xrefs to the {f,net,sock}stat.1 manpages. While I'm in there, fix
the sockstat.1 document title, which still remembers when sockstat was
called lsock.

Reviewed by: mpp


# c3aac50f 27-Aug-1999 Peter Wemm <peter@FreeBSD.org>

$Id$ -> $FreeBSD$


# 6d6189a4 11-Aug-1999 Nik Clayton <nik@FreeBSD.org>

Document the use of the -a flag in conjunction with the -r flag.

PR: docs/13037
Submitted by: Christopher Masto <chris@netmonger.net>


# 3be5f1f5 12-Jul-1999 Nik Clayton <nik@FreeBSD.org>

Add $Id$, to make it simpler for members of the translation teams to
track.

The $Id$ line is normally at the bottom of the main comment block in the
man page, separated from the rest of the manpage by an empty comment,
like so;

.\" $Id$
.\"

If the immediately preceding comment is a @(#) format ID marker than the
the $Id$ will line up underneath it with no intervening blank lines.
Otherwise, an additional blank line is inserted.

Approved by: bde


# 0024d1db 26-Apr-1999 Luigi Rizzo <luigi@FreeBSD.org>

Add support for printing bridging statistics with ``-p bdg '' .
If someone has a better flag to use I'll be glad to change it.


# b2ab9053 03-May-1998 Steve Price <steve@FreeBSD.org>

Remove (now) invalid .Xr trsp 8

PR: 6494
Submitted by: Don Morrison <dmorrisn@u.washington.edu>


# fbf8628c 26-Oct-1997 Steve Price <steve@FreeBSD.org>

Typo fix.

PR: docs/4579
Submitted by: Stephen J. Roznowski <sjr@home.net>


# 1336da0d 15-Jun-1996 Peter Wemm <peter@FreeBSD.org>

make netstat distinguish broadcast and blackhole routes where they appear.

(RTF_BLACKHOLE was already documented as being shown, but the code ignored
it)

Sumbitted by: Greg Lehey <grog@lemis.de>


# ce1355d5 07-Jun-1996 Julian Elischer <julian@FreeBSD.org>

I guess the docs should mention the new protocol at least once.


# 33b6236d 13-Apr-1996 John Hay <jhay@FreeBSD.org>

Document that ipx is a valid protocol for the -f option.
Comment out ns and iso. They are not supported anymore.


# 0b87c915 29-Feb-1996 David Greenman <dg@FreeBSD.org>

Make the -w option actually useful to people. Instead of it creating a
messy 130 column collage, output the system totals -or- info for a
specific interface if -I is given. Also wait for <interval> before
outputting the first sample so that it represents meaningful data (as
opposed to the total since the system was booted - most busy systems
wrap around many times during their operation, so these numbers are
only misleading).


# 270d3d75 20-Jan-1996 Mike Pritchard <mpp@FreeBSD.org>

Fix a variety of minor typos and cross references in a bunch of
man pages.

Masanobu Saitoh <msaitoh@spa.is.uec.ac.jp>
Giles Lean <giles@nemeton.com.au>
<soda@sra.co.jp>


# c70b84bd 14-Dec-1994 Garrett Wollman <wollman@FreeBSD.org>

Document new route flags.


# e1e293a5 11-Oct-1994 David Greenman <dg@FreeBSD.org>

Added '-b' option to display the number of in and out bytes on a given
interface (used with -i and -I flag).


# b3bfc719 05-Aug-1994 David Greenman <dg@FreeBSD.org>

Converted 'vmunix' to 'kernel'.


# 9b50d902 26-May-1994 Rodney W. Grimes <rgrimes@FreeBSD.org>

BSD 4.4 Lite Usr.bin Sources