Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 20 May 2012 01:40:24 +0000 (UTC)
From:      Glen Barber <gjb@FreeBSD.org>
To:        src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-8@freebsd.org
Subject:   svn commit: r235674 - stable/8/share/man/man4
Message-ID:  <201205200140.q4K1eO2o058515@svn.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: gjb (doc committer)
Date: Sun May 20 01:40:24 2012
New Revision: 235674
URL: http://svn.freebsd.org/changeset/base/235674

Log:
  MFC r235567:
  
  mdoc(7) style/formatting fixes.
  
  While here, fix a few nits igor(1) does not like.

Modified:
  stable/8/share/man/man4/siftr.4
Directory Properties:
  stable/8/share/man/man4/   (props changed)

Modified: stable/8/share/man/man4/siftr.4
==============================================================================
--- stable/8/share/man/man4/siftr.4	Sun May 20 01:40:12 2012	(r235673)
+++ stable/8/share/man/man4/siftr.4	Sun May 20 01:40:24 2012	(r235674)
@@ -91,7 +91,7 @@ utilises the
 .Xr sysctl 8
 interface to export its configuration variables to user-space.
 The following variables are available:
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va net.inet.siftr.enabled
 controls whether the module performs its
 measurements or not.
@@ -104,7 +104,7 @@ packet filtering hooks are only inserted
 .Va net.inet.siftr.enabled
 is set to 1.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va net.inet.siftr.ppl
 controls how many inbound/outbound packets for a given TCP connection will cause
 a log message to be generated for the connection.
@@ -113,13 +113,13 @@ every packet of every TCP connection.
 The value can be set to any integer in the range [1,2^32], and can be changed at
 any time, even while the module is enabled.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va net.inet.siftr.logfile
 controls the path to the file that the module writes its log messages to.
 By default, the file /var/log/siftr.log is used.
 The path can be changed at any time, even while the module is enabled.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va net.inet.siftr.genhashes
 controls whether a hash is generated for each TCP packet seen by
 .Nm .
@@ -150,36 +150,36 @@ sysname=FreeBSD    sysver=604000    ipmo
 .Ed
 .Pp
 Field descriptions are as follows:
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va enable_time_secs
 time at which the module was enabled, in seconds since the UNIX epoch.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va enable_time_usecs
 time at which the module was enabled, in microseconds since enable_time_secs.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va siftrver
 version of
 .Nm .
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va hz
 tick rate of the kernel in ticks per second.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va tcp_rtt_scale
 smoothed RTT estimate scaling factor.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va sysname
 operating system name.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va sysver
 operating system version.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va ipmode
 IP mode as defined at compile time.
 An ipmode of "4" means IPv6 is not supported and IP addresses are logged in
@@ -202,7 +202,7 @@ o,0xbec491a5,1238556193.463551,172.16.7.
 .Ed
 .Pp
 Field descriptions are as follows:
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 1
 Direction of packet that triggered the log message.
 Either
@@ -211,77 +211,77 @@ for in, or
 .Qq o
 for out.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 2
 Hash of the packet that triggered the log message.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 3
 Time at which the packet that triggered the log message was processed by
 the
 .Xr pfil 9
 hook function, in seconds and microseconds since the UNIX epoch.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 4
 The IPv4 or IPv6 address of the local host, in dotted quad (IPv4 packet)
 or colon-separated hex (IPv6 packet) notation.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 5
 The TCP port that the local host is communicating via.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 6
 The IPv4 or IPv6 address of the foreign host, in dotted quad (IPv4 packet)
 or colon-separated hex (IPv6 packet) notation.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 7
 The TCP port that the foreign host is communicating via.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 8
 The slow start threshold for the flow, in bytes.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 9
 The current congestion window for the flow, in bytes.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 10
 The current bandwidth-controlled window for the flow, in bytes.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 11
 The current sending window for the flow, in bytes.
 The post scaled value is reported, except during the initial handshake (first
 few packets), during which time the unscaled value is reported.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 12
 The current receive window for the flow, in bytes.
 The post scaled value is always reported.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 13
 The current window scaling factor for the sending window.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 14
 The current window scaling factor for the receiving window.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 15
 The current state of the TCP finite state machine, as defined
 in
 .Aq Pa netinet/tcp_fsm.h .
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 16
 The maximum segment size for the flow, in bytes.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 17
 The current smoothed RTT estimate for the flow, in units of TCP_RTT_SCALE * HZ,
 where TCP_RTT_SCALE is a define found in tcp_var.h, and HZ is the kernel's tick
@@ -289,46 +289,46 @@ timer.
 Divide by TCP_RTT_SCALE * HZ to get the RTT in secs. TCP_RTT_SCALE and HZ are
 reported in the enable log message.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 18
 SACK enabled indicator. 1 if SACK enabled, 0 otherwise.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 19
 The current state of the TCP flags for the flow.
 See
 .Aq Pa netinet/tcp_var.h
 for information about the various flags.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 20
 The current retransmission timeout length for the flow, in units of HZ, where HZ
 is the kernel's tick timer.
 Divide by HZ to get the timeout length in seconds. HZ is reported in the
 enable log message.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 21
 The current size of the socket send buffer in bytes.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 22
 The current number of bytes in the socket send buffer.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 23
 The current size of the socket receive buffer in bytes.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 24
 The current number of bytes in the socket receive buffer.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 25
 The current number of unacknowledged bytes in-flight.
 Bytes acknowledged via SACK are not excluded from this count.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va 26
 The current number of segments in the reassembly queue.
 .El
@@ -350,82 +350,82 @@ flow_list=172.16.7.28;22-172.16.2.5;5593
 .Ed
 .Pp
 Field descriptions are as follows:
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va disable_time_secs
 Time at which the module was disabled, in seconds since the UNIX epoch.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va disable_time_usecs
 Time at which the module was disabled, in microseconds since disable_time_secs.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va num_inbound_tcp_pkts
 Number of TCP packets that traversed up the network stack.
 This only includes inbound TCP packets during the periods when
 .Nm
 was enabled.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va num_outbound_tcp_pkts
 Number of TCP packets that traversed down the network stack.
 This only includes outbound TCP packets during the periods when
 .Nm
 was enabled.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va total_tcp_pkts
 The summation of num_inbound_tcp_pkts and num_outbound_tcp_pkts.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va num_inbound_skipped_pkts_malloc
 Number of inbound packets that were not processed because of failed malloc() calls.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va num_outbound_skipped_pkts_malloc
 Number of outbound packets that were not processed because of failed malloc() calls.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va num_inbound_skipped_pkts_mtx
 Number of inbound packets that were not processed because of failure to add the
 packet to the packet processing queue.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va num_outbound_skipped_pkts_mtx
 Number of outbound packets that were not processed because of failure to add the
 packet to the packet processing queue.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va num_inbound_skipped_pkts_tcb
 Number of inbound packets that were not processed because of failure to find the
 TCP control block associated with the packet.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va num_outbound_skipped_pkts_tcb
 Number of outbound packets that were not processed because of failure to find
 the TCP control block associated with the packet.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va num_inbound_skipped_pkts_icb
 Number of inbound packets that were not processed because of failure to find the
 IP control block associated with the packet.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va num_outbound_skipped_pkts_icb
 Number of outbound packets that were not processed because of failure to find
 the IP control block associated with the packet.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va total_skipped_tcp_pkts
 The summation of all skipped packet counters.
 .El
-.Bl -tag -offset indent
+.Bl -tag -offset indent -width Va
 .It Va flow_list
 A CSV list of TCP flows that triggered data log messages to be generated since
 the module was loaded.
 Each flow entry in the CSV list is
 formatted as
 .Qq local_ip;local_port-foreign_ip;foreign_port .
-If there are no entries in the list (i.e. no data log messages were generated),
+If there are no entries in the list (i.e., no data log messages were generated),
 the value will be blank.
 If there is at least one entry in the list, a trailing comma will always be
 present.
@@ -498,10 +498,10 @@ the system to trigger a dump of the stat
 flow.
 With the PPL set to 1, we are in effect sampling each TCP flow's control block
 state as frequently as flow packets enter/leave the system.
-For example, setting PPL to 2 halves the sampling rate i.e. every second flow
+For example, setting PPL to 2 halves the sampling rate i.e., every second flow
 packet (inbound OR outbound) causes a dump of the control block state.
 .Pp
-The distinction between interrogating individual packets vs interrogating the
+The distinction between interrogating individual packets versus interrogating the
 control block is important, because
 .Nm
 does not remove the need for packet capturing tools like
@@ -543,7 +543,7 @@ If one thread holds the lock, the other 
 This does introduce some additional bounded delay into the kernel's packet
 processing code path.
 .Pp
-In some cases (e.g. low memory, connection termination), TCP packets that enter
+In some cases (e.g., low memory, connection termination), TCP packets that enter
 the
 .Nm
 .Xr pfil 9



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201205200140.q4K1eO2o058515>