Index: head/sbin/route/route.8
===================================================================
--- head/sbin/route/route.8	(revision 260539)
+++ head/sbin/route/route.8	(revision 260540)
@@ -1,512 +1,511 @@
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)route.8	8.3 (Berkeley) 3/19/94
 .\" $FreeBSD$
 .\"
-.Dd October 17, 2013
+.Dd January 11, 2014
 .Dt ROUTE 8
 .Os
 .Sh NAME
 .Nm route
 .Nd manually manipulate the routing tables
 .Sh SYNOPSIS
 .Nm
 .Op Fl dnqtv
 .Ar command
 .Oo
 .Op Ar modifiers
 .Ar args
 .Oc
 .Sh DESCRIPTION
 The
 .Nm
 utility is used to manually manipulate the network
 routing tables.
 It normally is not needed, as a
 system routing table management daemon, such as
 .Xr routed 8 ,
 should tend to this task.
 .Pp
 The
 .Nm
 utility supports a limited number of general options,
 but a rich command language, enabling the user to specify
 any arbitrary request that could be delivered via the
 programmatic interface discussed in
 .Xr route 4 .
 .Pp
 The following options are available:
 .Bl -tag -width indent
 .It Fl 4
 Specify
 .Cm inet
 address family as family hint for subcommands.
 .It Fl 6
 Specify
 .Cm inet
 address family as family hint for subcommands.
 .It Fl d
 Run in debug-only mode, i.e., do not actually modify the routing table.
 .It Fl n
 Bypass attempts to print host and network names symbolically
 when reporting actions.
 (The process of translating between symbolic
 names and numerical equivalents can be quite time consuming, and
 may require correct operation of the network; thus it may be expedient
 to forget this, especially when attempting to repair networking operations).
 .It Fl t
 Run in test-only mode.
 .Pa /dev/null
 is used instead of a socket.
 .It Fl v
 (verbose) Print additional details.
 .It Fl q
 Suppress all output from the
 .Cm add , change , delete ,
 and
 .Cm flush
 commands.
 .El
 .Pp
 The
 .Nm
 utility provides the following commands:
 .Pp
 .Bl -tag -width Fl -compact
 .It Cm add
 Add a route.
 .It Cm flush
 Remove all routes.
 .It Cm delete
 Delete a specific route.
 .It Cm del
 Another name for the
 .Cm delete
 command.
 .It Cm change
 Change aspects of a route (such as its gateway).
 .It Cm get
 Lookup and display the route for a destination.
 .It Cm monitor
 Continuously report any changes to the routing information base,
 routing lookup misses, or suspected network partitionings.
 .It Cm show
 Another name for the
 .Cm get
 command.
 .El
 .Pp
 The monitor command has the syntax:
 .Pp
 .Bd -ragged -offset indent -compact
 .Nm
 .Op Fl n
 .Cm monitor Op Fl fib Ar number
 .Ed
 .Pp
 The flush command has the syntax:
 .Pp
 .Bd -ragged -offset indent -compact
 .Nm
 .Oo Fl n Cm flush Oc Oo Ar family Oc Op Fl fib Ar number
 .Ed
 .Pp
 If the
 .Cm flush
 command is specified,
 .Nm
 will ``flush'' the routing tables of all gateway entries.
 When the address family may is specified by any of the
 .Fl osi ,
 .Fl xns ,
 .Fl atalk ,
 .Fl inet6 ,
-.Fl 6,
-.Fl inet,
 or
-.Fl 4
+.Fl inet
 modifiers, only routes having destinations with addresses in the
-delineated family will be deleted. Additionally,
+delineated family will be deleted.
+Additionally,
 .Fl 4
 or
 .Fl 6
 can be used as aliases for
 .Fl inet
 and
 .Fl inet6
 modifiers.
 When a
 .Fl fib
 option is specified, the operation will be applied to
 the specified FIB
 .Pq routing table .
 .Pp
 The other commands have the following syntax:
 .Pp
 .Bd -ragged -offset indent -compact
 .Nm
 .Op Fl n
 .Ar command
 .Op Fl net No \&| Fl host
 .Ar destination gateway
 .Op Ar netmask
 .Op Fl fib Ar number
 .Ed
 .Pp
 where
 .Ar destination
 is the destination host or network,
 .Ar gateway
 is the next-hop intermediary via which packets should be routed.
 Routes to a particular host may be distinguished from those to
 a network by interpreting the Internet address specified as the
 .Ar destination
 argument.
 The optional modifiers
 .Fl net
 and
 .Fl host
 force the destination to be interpreted as a network or a host, respectively.
 Otherwise, if the
 .Ar destination
 has a
 .Dq local address part
 of
 INADDR_ANY
 .Pq Li 0.0.0.0 ,
 or if the
 .Ar destination
 is the symbolic name of a network, then the route is
 assumed to be to a network; otherwise, it is presumed to be a
 route to a host.
 Optionally, the
 .Ar destination
 could also be specified in the
 .Ar net Ns / Ns Ar bits
 format.
 .Pp
 For example,
 .Li 128.32
 is interpreted as
 .Fl host Li 128.0.0.32 ;
 .Li 128.32.130
 is interpreted as
 .Fl host Li 128.32.0.130 ;
 .Fl net Li 128.32
 is interpreted as
 .Li 128.32.0.0;
 .Fl net Li 128.32.130
 is interpreted as
 .Li 128.32.130.0;
 and
 .Li 192.168.64/20
 is interpreted as
 .Fl net Li 192.168.64 Fl netmask Li 255.255.240.0 .
 .Pp
 A
 .Ar destination
 of
 .Ar default
 is a synonym for the default route.
 For
 .Li IPv4
 it is
 .Fl net Fl inet Li 0.0.0.0 ,
 and for
 .Li IPv6
 it is
 .Fl net Fl inet6 Li :: .
 .Pp
 If the destination is directly reachable
 via an interface requiring
 no intermediary system to act as a gateway, the
 .Fl interface
 modifier should be specified;
 the gateway given is the address of this host on the common network,
 indicating the interface to be used for transmission.
 Alternately, if the interface is point to point the name of the interface
 itself may be given, in which case the route remains valid even
 if the local or remote addresses change.
 .Pp
 The optional modifiers
 .Fl xns ,
 .Fl osi ,
 .Fl atalk ,
 and
 .Fl link
 specify that all subsequent addresses are in the
 .Tn XNS ,
 .Tn OSI ,
 or
 .Tn AppleTalk
 address families,
 or are specified as link-level addresses,
 and the names must be numeric specifications rather than
 symbolic names.
 .Pp
 The optional
 .Fl netmask
 modifier is intended
 to achieve the effect of an
 .Tn OSI
 .Tn ESIS
 redirect with the netmask option,
 or to manually add subnet routes with
 netmasks different from that of the implied network interface
 (as would otherwise be communicated using the OSPF or ISIS routing protocols).
 One specifies an additional ensuing address parameter
 (to be interpreted as a network mask).
 The implicit network mask generated in the AF_INET case
 can be overridden by making sure this option follows the destination parameter.
 .Pp
 For
 .Dv AF_INET6 ,
 the
 .Fl prefixlen
 qualifier
 is available instead of the
 .Fl mask
 qualifier because non-continuous masks are not allowed in IPv6.
 For example,
 .Fl prefixlen Li 32
 specifies network mask of
 .Li ffff:ffff:0000:0000:0000:0000:0000:0000
 to be used.
 The default value of prefixlen is 64 to get along with
 the aggregatable address.
 But 0 is assumed if
 .Cm default
 is specified.
 Note that the qualifier works only for
 .Dv AF_INET6
 address family.
 .Pp
 Routes have associated flags which influence operation of the protocols
 when sending to destinations matched by the routes.
 These flags may be set (or sometimes cleared)
 by indicating the following corresponding modifiers:
 .Bd -literal
 -xresolve  RTF_XRESOLVE   - emit mesg on use (for external lookup)
 -iface    ~RTF_GATEWAY    - destination is directly reachable
 -static    RTF_STATIC     - manually added route
 -nostatic ~RTF_STATIC     - pretend route added by kernel or daemon
 -reject    RTF_REJECT     - emit an ICMP unreachable when matched
 -blackhole RTF_BLACKHOLE  - silently discard pkts (during updates)
 -proto1    RTF_PROTO1     - set protocol specific routing flag #1
 -proto2    RTF_PROTO2     - set protocol specific routing flag #2
 -proto3    RTF_PROTO3     - set protocol specific routing flag #3
 .Ed
 .Pp
 The optional modifiers
 .Fl rtt ,
 .Fl rttvar ,
 .Fl sendpipe ,
 .Fl recvpipe ,
 .Fl mtu ,
 .Fl hopcount ,
 .Fl expire ,
 and
 .Fl ssthresh
 provide initial values to quantities maintained in the routing entry
 by transport level protocols, such as TCP or TP4.
 These may be individually locked by preceding each such modifier to
 be locked by
 the
 .Fl lock
 meta-modifier, or one can
 specify that all ensuing metrics may be locked by the
 .Fl lockrest
 meta-modifier.
 .Pp
 Note that
 .Fl expire
 accepts expiration time of the route as the number of seconds since the
 Epoch
 .Pq see Xr time 3 .
 When the first character of the number is
 .Dq +
 or
 .Dq - ,
 it is interpreted as a value relative to the current time.
 .Pp
 The optional modifier
 .Fl fib Ar number
 specifies that the command will be applied to a non-default FIB.
 The
 .Ar number
 must be smaller than the
 .Va net.fibs
 .Xr sysctl 8
 MIB.
 When this modifier is not specified,
 or a negative number is specified,
 the default FIB shown in the
 .Va net.my_fibnum
 .Xr sysctl 8
 MIB will be used.
 .Pp
 The
 .Ar number
 allows multiple FIBs by a comma-separeted list and/or range
 specification.
 The
 .Qq Fl fib Li 2,4,6
 means the FIB number 2, 4, and 6.
 The
 .Qq Fl fib Li 1,3-5,6
 means the 1, 3, 4, 5, and 6.
 .Pp
 In a
 .Cm change
 or
 .Cm add
 command where the destination and gateway are not sufficient to specify
 the route (as in the
 .Tn ISO
 case where several interfaces may have the
 same address), the
 .Fl ifp
 or
 .Fl ifa
 modifiers may be used to determine the interface or interface address.
 .Pp
 All symbolic names specified for a
 .Ar destination
 or
 .Ar gateway
 are looked up first as a host name using
 .Xr gethostbyname 3 .
 If this lookup fails,
 .Xr getnetbyname 3
 is then used to interpret the name as that of a network.
 .Pp
 The
 .Nm
 utility uses a routing socket and the new message types
 .Dv RTM_ADD , RTM_DELETE , RTM_GET ,
 and
 .Dv RTM_CHANGE .
 As such, only the super-user may modify
 the routing tables.
 .Sh EXIT STATUS
 .Ex -std
 .Sh EXAMPLES
 Add a default route to the network routing table.
 This will send all packets for destinations not available in the routing table
 to the default gateway at 192.168.1.1:
 .Pp
 .Dl route add -net 0.0.0.0/0 192.168.1.1
 .Pp
 A shorter version of adding a default route can also be written as:
 .Pp
 .Dl route add default 192.168.1.1
 .Pp
 Add a static route to the 172.16.10.0/24 network via the 172.16.1.1 gateway:
 .Pp
 .Dl route add -net 172.16.10.0/24 172.16.1.1
 .Pp
 Change the gateway of an already established static route in the routing table:
 .Pp
 .Dl route change -net 172.16.10.0/24 172.16.1.2
 .Pp
 Display the route for a destination network:
 .Pp
 .Dl route show 172.16.10.0
 .Pp
 Delete a static route from the routing table:
 .Pp
 .Dl route delete -net 172.16.10.0/24 172.16.1.2
 .Pp
 Remove all routes from the routing table:
 .Pp
 .Dl route flush
 .Sh DIAGNOSTICS
 .Bl -diag
 .It "add [host \&| network ] %s: gateway %s flags %x"
 The specified route is being added to the tables.
 The
 values printed are from the routing table entry supplied
 in the
 .Xr ioctl 2
 call.
 If the gateway address used was not the primary address of the gateway
 (the first one returned by
 .Xr gethostbyname 3 ) ,
 the gateway address is printed numerically as well as symbolically.
 .It "delete [ host \&| network ] %s: gateway %s flags %x"
 As above, but when deleting an entry.
 .It "%s %s done"
 When the
 .Cm flush
 command is specified, each routing table entry deleted
 is indicated with a message of this form.
 .It "Network is unreachable"
 An attempt to add a route failed because the gateway listed was not
 on a directly-connected network.
 The next-hop gateway must be given.
 .It "not in table"
 A delete operation was attempted for an entry which
 was not present in the tables.
 .It "routing table overflow"
 An add operation was attempted, but the system was
 low on resources and was unable to allocate memory
 to create the new entry.
 .It "gateway uses the same route"
 A
 .Cm change
 operation resulted in a route whose gateway uses the
 same route as the one being changed.
 The next-hop gateway should be reachable through a different route.
 .El
 .Sh SEE ALSO
 .\".Xr esis 4 ,
 .Xr netintro 4 ,
 .Xr route 4 ,
 .Xr arp 8 ,
 .Xr IPXrouted 8 ,
 .Xr routed 8
 .\".Xr XNSrouted 8
 .Sh HISTORY
 The
 .Nm
 utility appeared in
 .Bx 4.2 .
 .Sh BUGS
 The first paragraph may have slightly exaggerated
 .Xr routed 8 Ns 's
 abilities.
 .Pp
 Currently, routes with the
 .Dv RTF_BLACKHOLE
 flag set need to have the gateway set to an instance of the
 .Xr lo 4
 driver, using the
 .Fl iface
 option, for the flag to have any effect; unless IP fast forwarding
 is enabled, in which case the meaning of the flag will always
 be honored.
Index: head/usr.bin/netstat/netstat.1
===================================================================
--- head/usr.bin/netstat/netstat.1	(revision 260539)
+++ head/usr.bin/netstat/netstat.1	(revision 260540)
@@ -1,557 +1,557 @@
 .\" Copyright (c) 1983, 1990, 1992, 1993
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\"	@(#)netstat.1	8.8 (Berkeley) 4/18/94
 .\" $FreeBSD$
 .\"
-.Dd October 15, 2013
+.Dd January 11, 2014
 .Dt NETSTAT 1
 .Os
 .Sh NAME
 .Nm netstat
 .Nd show network status
 .Sh DESCRIPTION
 The
 .Nm
 command symbolically displays the contents of various network-related
 data structures.
 There are a number of output formats,
 depending on the options for the information presented.
 .Bl -tag -width indent
 .It Xo
 .Bk -words
 .Nm
 .Op Fl 46AaLnSTWx
 .Op Fl f Ar protocol_family | Fl p Ar protocol
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Ek
 .Xc
 Display a list of active sockets
 (protocol control blocks)
 for each network protocol,
 for a particular
 .Ar protocol_family ,
 or for a single
 .Ar protocol .
 If
 .Fl A
 is also present,
 show the address of a protocol control block (PCB)
 associated with a socket; used for debugging.
 If
 .Fl a
 is also present,
 show the state of all sockets;
 normally sockets used by server processes are not shown.
 If
 .Fl L
 is also present,
 show the size of the various listen queues.
 The first count shows the number of unaccepted connections,
 the second count shows the amount of unaccepted incomplete connections,
 and the third count is the maximum number of queued connections.
 If
 .Fl S
 is also present,
 show network addresses as numbers (as with
 .Fl n )
 but show ports symbolically.
 If
 .Fl x
 is present, display socket buffer and tcp timer statistics for each internet socket.
 When
 .Fl T
 is present, display information from the TCP control block, including
 retransmits, out-of-order packets received, and zero-sized windows advertised.
 .It Xo
 .Bk -words
 .Nm
 .Fl i | I Ar interface
 .Op Fl 46abdhnW
 .Op Fl f Ar address_family
 .Ek
 .Xc
 Show the state of all network interfaces or a single
 .Ar interface
 which have been auto-configured
 (interfaces statically configured into a system, but not
 located at boot time are not shown).
 An asterisk
 .Pq Dq Li *
 after an interface name indicates that the interface is
 .Dq down .
 If
 .Fl a
 is also present, multicast addresses currently in use are shown
 for each Ethernet interface and for each IP interface address.
 Multicast addresses are shown on separate lines following the interface
 address with which they are associated.
 If
 .Fl b
 is also present, show the number of bytes in and out.
 If
 .Fl d
 is also present, show the number of dropped packets.
 If
 .Fl h
 is also present, print all counters in human readable form.
 If
 .Fl W
 is also present, print interface names using a wider field size.
 .It Xo
 .Bk -words
 .Nm
 .Fl w Ar wait
 .Op Fl I Ar interface
 .Op Fl d
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Op Fl q Ar howmany
 .Ek
 .Xc
 At intervals of
 .Ar wait
 seconds,
 display the information regarding packet
 traffic on all configured network interfaces
 or a single
 .Ar interface .
 If
 .Fl q
 is also present, exit after
 .Ar howmany
 outputs.
 If
 .Fl d
 is also present, show the number of dropped packets.
 .It Xo
 .Bk -words
 .Nm
 .Fl s Op Fl s
 .Op Fl 46z
 .Op Fl f Ar protocol_family | Fl p Ar protocol
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Ek
 .Xc
 Display system-wide statistics for each network protocol,
 for a particular
 .Ar protocol_family ,
 or for a single
 .Ar protocol .
 If
 .Fl s
 is repeated, counters with a value of zero are suppressed.
 If
 .Fl z
 is also present, reset statistic counters after displaying them.
 .It Xo
 .Bk -words
 .Nm
 .Fl i | I Ar interface Fl s
 .Op Fl 46
 .Op Fl f Ar protocol_family | Fl p Ar protocol
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Ek
 .Xc
 Display per-interface statistics for each network protocol,
 for a particular
 .Ar protocol_family ,
 or for a single
 .Ar protocol .
 .It Xo
 .Bk -words
 .Nm
 .Fl m
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Ek
 .Xc
 Show statistics recorded by the memory management routines
 .Pq Xr mbuf 9 .
 The network manages a private pool of memory buffers.
 .It Xo
 .Bk -words
 .Nm
 .Fl B
 .Op Fl z
 .Op Fl I Ar interface
 .Ek
 .Xc
 Show statistics about
 .Xr bpf 4
 peers.
 This includes information like
 how many packets have been matched, dropped and received by the
 bpf device, also information about current buffer sizes and device
 states.
 .It Xo
 .Bk -words
 .Nm
 .Fl r
 .Op Fl 46AanW
 .Op Fl F Ar fibnum
 .Op Fl f Ar address_family
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Ek
 .Xc
 Display the contents of routing tables.
 When
 .Fl f
 is specified, a routing table for a particular
 .Ar address_family
 is displayed.
 When
 .Fl F
 is specified, a routing table with the number
 .Ar fibnum
 is displayed.
 If the specified
 .Ar fibnum
 is -1 or
 .Fl F
 is not specified,
 the default routing table is displayed.
 If
 .Fl A
 is also present,
 show the contents of the internal Patricia tree
 structures; used for debugging.
 If
 .Fl a
 is also present,
 show protocol-cloned routes
 (routes generated by an
 .Dv RTF_PRCLONING
 parent route);
 normally these routes are not shown.
 When
 .Fl W
 is also present,
 show the path MTU
 for each route,
 and print interface
 names with a wider
 field size.
 .It Xo
 .Bk -words
 .Nm
 .Fl rs
 .Op Fl s
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Ek
 .Xc
 Display routing statistics.
 If
 .Fl s
 is repeated, counters with a value of zero are suppressed.
 .It Xo
 .Bk -words
 .Nm
 .Fl g
 .Op Fl 46W
 .Op Fl f Ar address_family
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Ek
 .Xc
 Display the contents of the multicast virtual interface tables,
 and multicast forwarding caches.
 Entries in these tables will appear only when the kernel is
 actively forwarding multicast sessions.
 This option is applicable only to the
 .Cm inet
 and
 .Cm inet6
 address families.
 .It Xo
 .Bk -words
 .Nm
 .Fl gs
 .Op Fl 46s
 .Op Fl f Ar address_family
 .Op Fl M Ar core
 .Op Fl N Ar system
 .Ek
 .Xc
 Show multicast routing statistics.
 If
 .Fl s
 is repeated, counters with a value of zero are suppressed.
 .It Xo
 .Bk -words
 .Nm
 .Fl Q
 .Ek
 .Xc
 Show
 .Xr netisr 9
 statistics.
 The flags field shows available ISR handlers:
 .Bl -column ".Li W" ".Dv NETISR_SNP_FLAGS_DRAINEDCPU"
 .It Li C Ta Dv NETISR_SNP_FLAGS_M2CPUID Ta "Able to map mbuf to cpu id"
 .It Li D Ta Dv NETISR_SNP_FLAGS_DRAINEDCPU  Ta "Has queue drain handler"
 .It Li F Ta Dv NETISR_SNP_FLAGS_M2FLOW Ta "Able to map mbuf to flow id"
 .El
 .El
 .Pp
 Some options have the general meaning:
 .Bl -tag -width flag
 .It Fl 4
 Is shorthand for
 .Fl f
 .Ar inet
 .It Fl 6
 Is shorthand for
 .Fl f
 .Ar inet6
 .It Fl f Ar address_family , Fl p Ar protocol
 Limit display to those records
 of the specified
 .Ar address_family
 or a single
 .Ar protocol .
 The following address families and protocols are recognized:
 .Pp
 .Bl -tag -width ".Cm netgraph , ng Pq Dv AF_NETGRAPH" -compact
 .It Em Family
 .Em Protocols
 .It Cm inet Pq Dv AF_INET
 .Cm divert , icmp , igmp , ip , ipsec , pim, sctp , tcp , udp
 .It Cm inet6 Pq Dv AF_INET6
 .Cm icmp6 , ip6 , ipsec6 , rip6 , tcp , udp
 .It Cm pfkey Pq Dv PF_KEY
 .Cm pfkey
 .It Cm atalk Pq Dv AF_APPLETALK
 .Cm ddp
 .It Cm netgraph , ng Pq Dv AF_NETGRAPH
 .Cm ctrl , data
 .It Cm ipx Pq Dv AF_IPX
 .Cm ipx , spx
 .\".It Cm ns Pq Dv AF_NS
 .\".Cm idp , ns_err , spp
 .\".It Cm iso Pq Dv AF_ISO
 .\".Cm clnp , cltp , esis , tp
 .It Cm unix Pq Dv AF_UNIX
 .It Cm link Pq Dv AF_LINK
 .El
 .Pp
 The program will complain if
 .Ar protocol
 is unknown or if there is no statistics routine for it.
 .It Fl M
 Extract values associated with the name list from the specified core
 instead of the default
 .Pa /dev/kmem .
 .It Fl N
 Extract the name list from the specified system instead of the default,
 which is the kernel image the system has booted from.
 .It Fl n
 Show network addresses and ports as numbers.
 Normally
 .Nm
 attempts to resolve addresses and ports,
 and display them symbolically.
 .It Fl W
 In certain displays, avoid truncating addresses even if this causes
 some fields to overflow.
 .El
 .Pp
 The default display, for active sockets, shows the local
 and remote addresses, send and receive queue sizes (in bytes), protocol,
 and the internal state of the protocol.
 Address formats are of the form
 .Dq host.port
 or
 .Dq network.port
 if a socket's address specifies a network but no specific host address.
 When known, the host and network addresses are displayed symbolically
 according to the databases
 .Xr hosts 5
 and
 .Xr networks 5 ,
 respectively.
 If a symbolic name for an address is unknown, or if
 the
 .Fl n
 option is specified, the address is printed numerically, according
 to the address family.
 For more information regarding
 the Internet IPv4
 .Dq dot format ,
 refer to
 .Xr inet 3 .
 Unspecified,
 or
 .Dq wildcard ,
 addresses and ports appear as
 .Dq Li * .
 .Pp
 The interface display provides a table of cumulative
 statistics regarding packets transferred, errors, and collisions.
 The network addresses of the interface
 and the maximum transmission unit
 .Pq Dq mtu
 are also displayed.
 .Pp
 The routing table display indicates the available routes and their status.
 Each route consists of a destination host or network, and a gateway to use
 in forwarding packets.
 The flags field shows a collection of information about the route stored
 as binary choices.
 The individual flags are discussed in more detail in the
 .Xr route 8
 and
 .Xr route 4
 manual pages.
 The mapping between letters and flags is:
 .Bl -column ".Li W" ".Dv RTF_WASCLONED"
 .It Li 1 Ta Dv RTF_PROTO1 Ta "Protocol specific routing flag #1"
 .It Li 2 Ta Dv RTF_PROTO2 Ta "Protocol specific routing flag #2"
 .It Li 3 Ta Dv RTF_PROTO3 Ta "Protocol specific routing flag #3"
 .It Li B Ta Dv RTF_BLACKHOLE Ta "Just discard pkts (during updates)"
 .It Li b Ta Dv RTF_BROADCAST Ta "The route represents a broadcast address"
 .It Li C Ta Dv RTF_CLONING Ta "Generate new routes on use"
 .It Li c Ta Dv RTF_PRCLONING Ta "Protocol-specified generate new routes on use"
 .It Li D Ta Dv RTF_DYNAMIC Ta "Created dynamically (by redirect)"
 .It Li G Ta Dv RTF_GATEWAY Ta "Destination requires forwarding by intermediary"
 .It Li H Ta Dv RTF_HOST Ta "Host entry (net otherwise)"
 .It Li L Ta Dv RTF_LLINFO Ta "Valid protocol to link address translation"
 .It Li M Ta Dv RTF_MODIFIED Ta "Modified dynamically (by redirect)"
 .It Li R Ta Dv RTF_REJECT Ta "Host or net unreachable"
 .It Li S Ta Dv RTF_STATIC Ta "Manually added"
 .It Li U Ta Dv RTF_UP Ta "Route usable"
 .It Li W Ta Dv RTF_WASCLONED Ta "Route was generated as a result of cloning"
 .It Li X Ta Dv RTF_XRESOLVE Ta "External daemon translates proto to link address"
 .El
 .Pp
 Direct routes are created for each
 interface attached to the local host;
 the gateway field for such entries shows the address of the outgoing interface.
 The refcnt field gives the
 current number of active uses of the route.
 Connection oriented
 protocols normally hold on to a single route for the duration of
 a connection while connectionless protocols obtain a route while sending
 to the same destination.
 The use field provides a count of the number of packets
 sent using that route.
 The interface entry indicates the network interface utilized for the route.
 .Pp
 When
 .Nm
 is invoked with the
 .Fl w
 option and a
 .Ar wait
 interval argument, it displays a running count of statistics related to
 network interfaces.
 An obsolescent version of this option used a numeric parameter
 with no option, and is currently supported for backward compatibility.
 By default, this display summarizes information for all interfaces.
 Information for a specific interface may be displayed with the
 .Fl I
 option.
 .Pp
 The
 .Xr bpf 4
 flags displayed when
 .Nm
 is invoked with the
 .Fl B
 option represent the underlying parameters of the bpf peer.
 Each flag is
 represented as a single lower case letter.
 The mapping between the letters and flags in order of appearance are:
 .Bl -column ".Li i"
 .It Li p Ta Set if listening promiscuously
 .It Li i Ta Dv BIOCIMMEDIATE No has been set on the device
 .It Li f Ta Dv BIOCGHDRCMPLT No status: source link addresses are being
 filled automatically
 .It Li s Ta Dv BIOCGSEESENT No status: see packets originating locally and
 remotely on the interface.
 .It Li a Ta Packet reception generates a signal
 .It Li l Ta Dv BIOCLOCK No status: descriptor has been locked
 .El
 .Pp
 For more information about these flags, please refer to
 .Xr bpf 4 .
 .Pp
 The
 .Fl x
 flag causes
 .Nm
 to output all the information recorded about data
 stored in the socket buffers.
 The fields are:
 .Bl -column ".Li R-MBUF"
 .It Li R-MBUF Ta Number of mbufs in the receive queue.
 .It Li S-MBUF Ta Number of mbufs in the send queue.
 .It Li R-CLUS Ta Number of clusters, of any type, in the receive
 queue.
 .It Li S-CLUS Ta Number of clusters, of any type, in the send queue.
 .It Li R-HIWA Ta Receive buffer high water mark, in bytes.
 .It Li S-HIWA Ta Send buffer high water mark, in bytes.
 .It Li R-LOWA Ta Receive buffer low water mark, in bytes.
 .It Li S-LOWA Ta Send buffer low water mark, in bytes.
 .It Li R-BCNT Ta Receive buffer byte count.
 .It Li S-BCNT Ta Send buffer byte count.
 .It Li R-BMAX Ta Maximum bytes that can be used in the receive buffer.
 .It Li S-BMAX Ta Maximum bytes that can be used in the send buffer.
 .El
 .Sh SEE ALSO
 .Xr fstat 1 ,
 .Xr nfsstat 1 ,
 .Xr procstat 1 ,
 .Xr ps 1 ,
 .Xr sockstat 1 ,
 .Xr bpf 4 ,
 .Xr inet 4 ,
 .Xr route 4 ,
 .Xr unix 4 ,
 .Xr hosts 5 ,
 .Xr networks 5 ,
 .Xr protocols 5 ,
 .Xr services 5 ,
 .Xr iostat 8 ,
 .Xr route 8 ,
 .Xr trpt 8 ,
 .Xr vmstat 8 ,
 .Xr mbuf 9
 .Sh HISTORY
 The
 .Nm
 command appeared in
 .Bx 4.2 .
 .Pp
 IPv6 support was added by WIDE/KAME project.
 .Sh BUGS
 The notion of errors is ill-defined.