History log of /src/usr.bin/netstat/netstat.1
Revision (<<< Hide revision tags) (Show revision tags >>>) Date Author Comments
Revision tags: perseant-exfatfs-base-20250801 netbsd-11-base perseant-exfatfs-base-20240630 perseant-exfatfs-base
# 1.76 21-Dec-2022 msaitoh

Add note about "netstat -mssv".


Revision tags: netbsd-10-base
# 1.75 07-Jan-2022 bad

branches: 1.75.2;
mention ifmcstat(8) in SEE ALSO.


Revision tags: cjep_sun2x-base1 cjep_sun2x-base cjep_staticlib_x-base1 cjep_staticlib_x-base
# 1.74 21-Jul-2020 gutteridge

netstat.1: add various xrefs present in the body to "See Also"


Revision tags: netbsd-9-3-RELEASE netbsd-9-2-RELEASE netbsd-9-1-RELEASE phil-wifi-20200421 phil-wifi-20200411 is-mlppp-base phil-wifi-20200406 netbsd-8-2-RELEASE netbsd-9-0-RELEASE netbsd-9-0-RC2 netbsd-9-0-RC1 phil-wifi-20191119 netbsd-9-base phil-wifi-20190609 netbsd-8-1-RELEASE netbsd-8-1-RC1 pgoyette-compat-merge-20190127 pgoyette-compat-20190127 pgoyette-compat-20190118 pgoyette-compat-1226 pgoyette-compat-1126 pgoyette-compat-1020 pgoyette-compat-0930 pgoyette-compat-0906 pgoyette-compat-0728 netbsd-8-0-RELEASE phil-wifi-base pgoyette-compat-0625 netbsd-8-0-RC2 pgoyette-compat-0521 pgoyette-compat-0502 pgoyette-compat-0422 netbsd-8-0-RC1 pgoyette-compat-0415 pgoyette-compat-0407 pgoyette-compat-0330 pgoyette-compat-0322 pgoyette-compat-0315 pgoyette-compat-base matt-nb8-mediatek-base perseant-stdc-iso10646-base netbsd-8-base prg-localcount2-base3 prg-localcount2-base2 prg-localcount2-base1 prg-localcount2-base pgoyette-localcount-20170426 bouyer-socketcan-base1 pgoyette-localcount-20170320 bouyer-socketcan-base pgoyette-localcount-20170107 pgoyette-localcount-20161104 localcount-20160914 pgoyette-localcount-20160806 pgoyette-localcount-20160726 pgoyette-localcount-base
# 1.73 12-May-2016 ozaki-r

branches: 1.73.8; 1.73.18;
Remove duplicate routing flag list

We alreay have it in route(8) and shouldn't have another one.
(Actually the removed list is forgot to be updated.)


# 1.72 23-Mar-2015 roy

Add RTF_BROADCAST to mark routes used for the broadcast address when
they are created on the fly. This makes it clear what the route is for
and allows an optimisation in ip_output() by avoiding a call to
in_broadcast() because most of the time we do talk to a host.
It also avoids a needless allocation for the storage of llinfo_arp and
thus vanishes from arp(8) - it showed as incomplete anyway so this
is a nice side effect.

Guard against this and routes marked with RTF_BLACKHOLE in
ip_fastforward().
While here, guard against routes marked with RTF_BLACKHOLE in
ip6_fastforward().
RTF_BROADCAST is IPv4 only, so don't bother checking that here.


# 1.71 26-Feb-2015 roy

Document RTF_LOCAL


# 1.70 11-Oct-2014 wiz

Give flag argument in description. Add two articles.


# 1.69 11-Oct-2014 enami

- Explicitly describe that kvm(3) is used when -M/-N option is used since
nowadays sysctl(3) is the default information retrieval method.
- Fix description about default value for -N; it is no longer a single value
these days, so just say see kvm_openfiles(3) rahter than repeating
several lines description here.


# 1.68 09-Oct-2014 enami

As described in kvm_openfiles(3), default core file is not /dev/kmem
but /dev/mem. Actually, passing /dev/kmem to -M doesn't work.


Revision tags: netbsd-7-2-RELEASE netbsd-7-1-2-RELEASE netbsd-7-1-1-RELEASE netbsd-7-1-RELEASE netbsd-7-1-RC2 netbsd-7-nhusb-base-20170116 netbsd-7-1-RC1 netbsd-7-0-2-RELEASE netbsd-7-nhusb-base netbsd-7-0-1-RELEASE netbsd-7-0-RELEASE netbsd-7-0-RC3 netbsd-7-0-RC2 netbsd-7-0-RC1 netbsd-7-base yamt-pagecache-base9 tls-earlyentropy-base riastradh-xf86-video-intel-2-7-1-pre-2-21-15 riastradh-drm2-base3 tls-maxphys-base
# 1.67 18-Oct-2013 bad

Make the -f option accept multiple address families.
Bump man page date.


Revision tags: riastradh-drm2-base2 riastradh-drm2-base1 riastradh-drm2-base agc-symver-base
# 1.66 01-Mar-2013 joerg

Retire OSI network stack. OK core@


Revision tags: yamt-pagecache-base8 yamt-pagecache-base7 yamt-pagecache-base6
# 1.65 19-Oct-2012 msaitoh

Add -t flag.


# 1.64 19-Oct-2012 msaitoh

Add note about -l option. Fixes PR#47085 reported by Julian Fagir.


# 1.63 25-Sep-2012 pgoyette

Sort -h option properly (not between -I and -i)

XXX Should the date be updated?


Revision tags: netbsd-6-0-6-RELEASE netbsd-6-0-5-RELEASE netbsd-6-0-4-RELEASE netbsd-6-0-3-RELEASE netbsd-6-0-2-RELEASE netbsd-6-0-1-RELEASE matt-nb6-plus-nbase netbsd-6-0-RELEASE netbsd-6-0-RC2 matt-nb6-plus-base netbsd-6-0-RC1 yamt-pagecache-base5 yamt-pagecache-base4 netbsd-6-base
# 1.62 11-Nov-2011 gdt

branches: 1.62.2; 1.62.6;
Move RTF_ANNOUNCE flag so that it no longer conflicts with RTF_PROTO2.

RTF_ANNOUNCE was defined as RTF_PROTO2. The flag is used to indicated
that host should act as a proxy for a link level arp or ndp request.
(If RTF_PROTO2 is used as an experimental flag (as advertised),
various problems can occur.)

This commit provides a first-class definition with its own bit for
RTF_ANNOUNCE, removes the old aliasing definitions, and adds support
for the new RTF_ANNOUNCE flag to netstat(8) and route(8).,

Also, remove unused RTF_ flags that collide with RTF_PROTO1:
netinet/icmp6.h defined RTF_PROBEMTU as RTF_PROTO1
netinet/if_inarp.h defined RTF_USETRAILERS as RTF_PROTO1
(Neither of these flags are used anywhere. Both have been removed
to reduce chances of collision with RTF_PROTO1.)

Figuring this out and the diff are the work of Beverly Schwartz of
BBN.

(Passed release build, boot in VM, with no apparently related atf
failures.)

Approved for Public Release, Distribution Unlimited
This material is based upon work supported by the Defense Advanced
Research Projects Agency and Space and Naval Warfare Systems Center,
Pacific, under Contract No. N66001-09-C-2073.


Revision tags: yamt-pagecache-base3 yamt-pagecache-base2 yamt-pagecache-base
# 1.61 21-Jun-2011 wiz

branches: 1.61.2;
New sentence, new line.


# 1.60 21-Jun-2011 kefren

add a sentence regarding multiple tags


Revision tags: cherry-xenmp-base bouyer-quota2-nbase bouyer-quota2-base matt-mips64-premerge-20101231
# 1.59 06-Dec-2010 pooka

Insert word "mbuf" to description of -m (so you can search for it).
No functional change.


# 1.58 30-Jun-2010 wiz

Bump date for previous (mpls).


# 1.57 29-Jun-2010 kefren

Add mpls into family address list


# 1.56 27-Jun-2010 kefren

Add -T flag, that shows tags in route output


# 1.55 24-Feb-2010 pooka

Add -h, which makes output of bytes counts "humanized" (e.g. -bih)

(netstat had -h some 15 years ago, but since then it has been just
a fancy way of calling usage())


Revision tags: matt-premerge-20091211
# 1.54 13-Sep-2009 wiz

Fix section for sysctl xref (it is 3, not 2).


# 1.53 13-Sep-2009 elad

Checkin work in progress to make netstat use sysctl rather than kvm(3).

This commit mostly adds code written by Claudio Jeker for OpenBSD to
support sysctl in the interface printing parts (-i, -I, -w). The port has
been ported to NetBSD with tiny adjustments -- of course all bugs etc.
are mine.

Also add and document a -X flag to force sysctl usage. The documentation
notes this flag may be removed at any time and its presence should not be
relied on.

Some misc. comments/#ifdef changes/code snippet moves as well.

Please note that no functionality should change as the routing and
interface printing code is still not fully supported.

Mailing list reference:

http://mail-index.netbsd.org/tech-userlevel/2009/09/09/msg002604.html


# 1.52 28-Jun-2009 dholland

Fix typo


# 1.51 28-May-2009 christos

fix typo (Silas Silva)


Revision tags: jym-xensuspend-nbase jym-xensuspend-base
# 1.50 11-Mar-2009 joerg

Fix markup


# 1.49 14-Feb-2009 wiz

Sort option descriptions, and options in usage.
Covers PR 40627.


Revision tags: netbsd-5-0-RC2 netbsd-5-0-RC1 netbsd-5-base matt-mips64-base2 mjf-devfs2-base wrstuden-revivesa-base-3 wrstuden-revivesa-base-2 wrstuden-revivesa-base-1 yamt-pf42-base4 yamt-pf42-base3 hpcarm-cleanup-nbase yamt-pf42-baseX yamt-pf42-base2 wrstuden-revivesa-base yamt-pf42-base keiichi-mipv6-nbase keiichi-mipv6-base matt-armv6-nbase cube-autoconf-base matt-armv6-base hpcarm-cleanup-base
# 1.48 30-Aug-2007 jnemeth

branches: 1.48.12; 1.48.14;
bump date


# 1.47 30-Aug-2007 jnemeth

PR/36867 - Zafer Aydogan -- trsp is no longer


Revision tags: matt-mips64-base
# 1.46 30-Jul-2007 pavel

branches: 1.46.4; 1.46.6;
Add xref to sockstat, from Zafer Aydogan in PR misc/36706.
Bump date.


Revision tags: abandoned-netbsd-4-base netbsd-4-base chap-midi-nbase chap-midi-base
# 1.45 28-Dec-2005 rpaulo

branches: 1.45.6; 1.45.8;
Bump date for previous.


# 1.44 28-Dec-2005 rpaulo

Explain the netstat -B flag column.


# 1.43 11-Sep-2005 wiz

Punctuation fix. From YOMURA Masanori in private mail.


# 1.42 11-Sep-2005 wiz

Argument is address_family, not "address family". From YOMURA Masanori in private mail.


# 1.41 06-Aug-2005 rpaulo

Explained how -B works and how it works in conjunction with -I or -s.

Reviewed by wiz@


Revision tags: netbsd-3-1-1-RELEASE netbsd-3-0-3-RELEASE netbsd-3-1-RELEASE netbsd-3-0-2-RELEASE netbsd-3-1-RC4 netbsd-3-1-RC3 netbsd-3-1-RC2 netbsd-3-1-RC1 netbsd-3-0-1-RELEASE netbsd-3-0-RELEASE netbsd-3-0-RC6 netbsd-3-0-RC5 netbsd-3-0-RC4 netbsd-3-0-RC3 netbsd-3-0-RC2 netbsd-3-0-RC1 netbsd-2-0-3-RELEASE netbsd-2-1-RELEASE netbsd-2-1-RC6 netbsd-2-1-RC5 netbsd-2-1-RC4 netbsd-2-1-RC3 netbsd-2-1-RC2 netbsd-2-1-RC1 netbsd-2-0-2-RELEASE netbsd-3-base netbsd-2-0-1-RELEASE netbsd-2-base netbsd-2-0-RELEASE netbsd-2-0-RC5 netbsd-2-0-RC4 netbsd-2-0-RC3 netbsd-2-0-RC2 netbsd-2-0-RC1 netbsd-2-0-base
# 1.40 07-Aug-2003 agc

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.


# 1.39 02-Mar-2003 itojun

TF_PROTO1/2 mixup. from itou makoto


# 1.38 25-Feb-2003 wiz

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.


# 1.37 04-Feb-2003 perry

"Utilize" has exactly the same meaning as "use," but it is more
difficult to read and understand. Most manuals of English style
therefore say that you should use "use".


Revision tags: fvdl_fs64_base
# 1.36 30-Sep-2002 grant

New sentence, new line.


# 1.35 03-Jul-2002 enami

Introduce -q flag to print some information (like number of packets dropped
due to queue full) about software interrupt queues such as ipintrq.


# 1.34 02-Jul-2002 soren

Sync SYNOPSIS and usage() with reality.


Revision tags: netbsd-1-6-PATCH002-RELEASE netbsd-1-6-PATCH002 netbsd-1-6-PATCH002-RC4 netbsd-1-6-PATCH002-RC3 netbsd-1-6-PATCH002-RC2 netbsd-1-6-PATCH002-RC1 netbsd-1-6-PATCH001 netbsd-1-6-PATCH001-RELEASE netbsd-1-6-PATCH001-RC3 netbsd-1-6-PATCH001-RC2 netbsd-1-6-PATCH001-RC1 netbsd-1-6-RELEASE netbsd-1-6-RC3 netbsd-1-6-RC2 netbsd-1-6-RC1 netbsd-1-6-base
# 1.33 01-Dec-2001 wiz

Whitespace cleanup.


# 1.32 03-Sep-2001 sommerfeld

Cross-reference fstat(1)


# 1.31 28-May-2001 itojun

typo


# 1.30 28-May-2001 assar

add `-s' that prints port numbers symbolically but addresses numerically


# 1.29 06-May-2001 wiz

Change xref for vmstat(8) to vmstat(1).
Whitespace, punctuation and spelling fixes while I'm here.


# 1.28 27-Jan-2001 itojun

mark cloned routes with RTF_CLONED. present it with netstat -r by "c".

let static routes overwrite cloned routes, as cloned routes can come back again
if necessary. behavior same as freebsd/bsdi, code partially from bsdi42.
(NRL rt->rt_parent was not added)
should fix PR 11916 and maybe some other PRs with ARP behavior.

recompilation of usr.sbin/route6d is suggested.


# 1.27 15-Aug-2000 jhawk

Add kernel counters for arp events, displayable with netstat -s -f arp


Revision tags: netbsd-1-5-RELEASE netbsd-1-5-BETA2 netbsd-1-5-BETA netbsd-1-5-ALPHA2 netbsd-1-5-base minoura-xpg4dl-base wrstuden-devbsize-19991221 wrstuden-devbsize-base
# 1.26 13-Dec-1999 itojun

branches: 1.26.4;
per-interface statistics.
bring in and enable KAME scopeid hack.
lots of cleanups.
(sync with latest KAME)


Revision tags: comdex-fall-1999-base
# 1.25 15-Sep-1999 is

branches: 1.25.4;
Add -L option. netstat -r -L behaves like 4.3BSD netstat -r, that is, it
does not show route table entries pointing to link level addresses (ARP
entries or IPv6 neighbour discovery entries).


# 1.24 15-Sep-1999 is

Netstat knows about "-f inet6".


# 1.23 12-Sep-1999 dbj

RTF_PROTO1 is indicated by the flag '1' and RTF_PROTO2 is indicated by the flag '2',
not the other way around


# 1.22 01-Jul-1999 itojun

make netstat IPv6-ready.


Revision tags: netbsd-1-4-PATCH003 netbsd-1-4-PATCH002 netbsd-1-4-PATCH001 netbsd-1-4-RELEASE netbsd-1-4-base
# 1.21 22-Mar-1999 garbled

More and more .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.


# 1.20 14-Mar-1999 kristerw

There is no -h flag. From OpenBSD.


# 1.19 02-Feb-1999 lukem

remove sentence consistenting solely of "When"


# 1.18 15-Jan-1999 kml

Added a verbose flag for route display that will show
the various route metrics.


# 1.17 18-Jul-1998 lukem

use AF_LOCAL instead of AF_UNIX. support -f local as synonym for -f unix


# 1.16 03-Jun-1998 thorpej

Add an option to dump the contents of a PCB at the specified address, and
implement this for TCP.


# 1.15 19-Mar-1998 kml

Add support for a '-b' option to provide byte counts in and out,
instead of just packet counts. On the byte screens, errors and
collisions are not shown, since they are more packet count related.


# 1.14 28-Oct-1997 kml

Added (and documented) a change to the route display, so that mtu values
which have been locked are indicated by an 'L' appended to the MTU value.
Locked routes have path mtu discovery turned off.


Revision tags: netbsd-1-3-base
# 1.13 19-Oct-1997 lukem

branches: 1.13.2;
fix up .Nm usage, getopt returns -1 not EOF


# 1.12 01-Aug-1997 mikel

add 'atalk' to list of arguments recognized by -f, minor cleanup


Revision tags: SYN_cache_cur_base netbsd-1-2-PATCH001 netbsd-1-2-RELEASE netbsd-1-2-BETA netbsd-1-2-base netbsd-1-1-PATCH001 netbsd-1-1-RELEASE netbsd-1-1-base
# 1.11 03-Oct-1995 thorpej

New-style RCS ids.


# 1.10 27-Sep-1995 jtc

iostat is in section 8; PR #1533


# 1.9 27-Sep-1995 jtc

vmstat is in section 8; PR #1532


# 1.8 10-Aug-1995 thorpej

If set, show a route's mtu in the routing table display.


# 1.7 06-Aug-1994 jtc

vmunix -> netbsd (PR #375)


Revision tags: netbsd-1-0-base
# 1.6 13-May-1994 mycroft

branches: 1.6.2;
Clean up import.


# 1.5 01-Apr-1994 cgd

there will be no more /vmunix! from Mark Weaver.


# 1.4 03-Feb-1994 jtc

vmunix -> netbsd


# 1.3 11-Jan-1994 brezak

Incorporate changes for IP mcast and IGMP from cmaeda@cs.washington.edu.


# 1.2 01-Aug-1993 mycroft

Add RCS indentifiers.


Revision tags: netbsd-0-9-RELEASE netbsd-0-9-BETA netbsd-0-9-ALPHA2 netbsd-0-9-ALPHA netbsd-0-9-base netbsd-0-8 netbsd-alpha-1 patchkit-0-2-2
# 1.1 21-Mar-1993 cgd

branches: 1.1.1;
after 0.2.2 "stable" patches applied