Stop nroff from complaining about the freeBSD version..

Also some updates to the vjc node man page.

11 files changed, 55 insertions, 29 deletions

diff --git a/share/man/man4/ng_UI.4 b/share/man/man4/ng_UI.4
index f432fc4cdb85..74b6832a2c4e 100644
--- a/share/man/man4/ng_UI.4
+++ b/share/man/man4/ng_UI.4
@@ -37,7 +37,7 @@
 .\"
 .Dd January 19, 1999
 .Dt NG_UI 8
-.Os FreeBSD 3
+.Os FreeBSD 4.0
 .Sh NAME
 .Nm ng_UI
 .Nd UI netgraph node type
diff --git a/share/man/man4/ng_async.4 b/share/man/man4/ng_async.4
index f07ef48e78d1..2d0a0d486fe7 100644
--- a/share/man/man4/ng_async.4
+++ b/share/man/man4/ng_async.4
@@ -37,7 +37,7 @@
 .\"
 .Dd January 19, 1999
 .Dt NG_ASYNC 8
-.Os FreeBSD 3
+.Os FreeBSD 4.0
 .Sh NAME
 .Nm ng_async
 .Nd asynchronous framing netgraph node type
diff --git a/share/man/man4/ng_echo.4 b/share/man/man4/ng_echo.4
index 4e5a08347eb8..7e22a6f8a20e 100644
--- a/share/man/man4/ng_echo.4
+++ b/share/man/man4/ng_echo.4
@@ -37,7 +37,7 @@
 .\"
 .Dd January 19, 1999
 .Dt NG_ECHO 8
-.Os FreeBSD 3
+.Os FreeBSD 4.0
 .Sh NAME
 .Nm ng_echo
 .Nd netgraph echo node type
diff --git a/share/man/man4/ng_frame_relay.4 b/share/man/man4/ng_frame_relay.4
index bdfe8e24cedc..fc9ef0f65759 100644
--- a/share/man/man4/ng_frame_relay.4
+++ b/share/man/man4/ng_frame_relay.4
@@ -37,7 +37,7 @@
 .\"
 .Dd January 19, 1999
 .Dt NG_FRAME_RELAY 8
-.Os FreeBSD 3
+.Os FreeBSD 4.0
 .Sh NAME
 .Nm ng_frame_relay
 .Nd Frame relay netgraph node type
diff --git a/share/man/man4/ng_hole.4 b/share/man/man4/ng_hole.4
index df3bf56bb5a1..472b22cd6e00 100644
--- a/share/man/man4/ng_hole.4
+++ b/share/man/man4/ng_hole.4
@@ -37,7 +37,7 @@
 .\"
 .Dd January 19, 1999
 .Dt NG_HOLE 8
-.Os FreeBSD 3
+.Os FreeBSD 4.0
 .Sh NAME
 .Nm ng_hole
 .Nd netgraph discard node type
diff --git a/share/man/man4/ng_iface.4 b/share/man/man4/ng_iface.4
index 3e0eabb5b596..7cb1884c16a9 100644
--- a/share/man/man4/ng_iface.4
+++ b/share/man/man4/ng_iface.4
@@ -37,7 +37,7 @@
 .\"
 .Dd January 19, 1999
 .Dt NG_IFACE 8
-.Os FreeBSD 3
+.Os FreeBSD 4.0
 .Sh NAME
 .Nm ng_iface
 .Nd interface netgraph node type
diff --git a/share/man/man4/ng_lmi.4 b/share/man/man4/ng_lmi.4
index 48c42f63598f..2ce52a7dfbd1 100644
--- a/share/man/man4/ng_lmi.4
+++ b/share/man/man4/ng_lmi.4
@@ -37,7 +37,7 @@
 .\"
 .Dd January 19, 1999
 .Dt NG_LMI 8
-.Os FreeBSD 3
+.Os FreeBSD 4.0
 .Sh NAME
 .Nm ng_lmi
 .Nd Frame relay LMI protocol netgraph node type
diff --git a/share/man/man4/ng_rfc1490.4 b/share/man/man4/ng_rfc1490.4
index d8a7cfc56d6c..a2aa9d008deb 100644
--- a/share/man/man4/ng_rfc1490.4
+++ b/share/man/man4/ng_rfc1490.4
@@ -37,7 +37,7 @@
 .\"
 .Dd January 19, 1999
 .Dt NG_RFC1490 8
-.Os FreeBSD 3
+.Os FreeBSD 4.0
 .Sh NAME
 .Nm ng_rfc1490
 .Nd RFC 1490 netgraph node type
diff --git a/share/man/man4/ng_tee.4 b/share/man/man4/ng_tee.4
index 66da25e9514f..e8cb8e4dcaa0 100644
--- a/share/man/man4/ng_tee.4
+++ b/share/man/man4/ng_tee.4
@@ -37,7 +37,7 @@
 .\"
 .Dd January 19, 1999
 .Dt NG_TEE 8
-.Os FreeBSD 3
+.Os FreeBSD 4.0
 .Sh NAME
 .Nm ng_tee
 .Nd netgraph ``tee'' node type
diff --git a/share/man/man4/ng_tty.4 b/share/man/man4/ng_tty.4
index 53141160ff53..c3f0aa567530 100644
--- a/share/man/man4/ng_tty.4
+++ b/share/man/man4/ng_tty.4
@@ -37,7 +37,7 @@
 .\"
 .Dd January 19, 1999
 .Dt NG_TTY 8
-.Os FreeBSD 3
+.Os FreeBSD 4.0
 .Sh NAME
 .Nm ng_tty
 .Nd netgraph node type that is also a line discipline
diff --git a/share/man/man4/ng_vjc.4 b/share/man/man4/ng_vjc.4
index 99ec56100145..8a5c365d00a3 100644
--- a/share/man/man4/ng_vjc.4
+++ b/share/man/man4/ng_vjc.4
@@ -37,7 +37,7 @@
 .\"
 .Dd January 19, 1999
 .Dt NG_VJC 8
-.Os FreeBSD 3
+.Os FreeBSD 4.0
 .Sh NAME
 .Nm ng_vjc
 .Nd Van Jacobsen compression netgraph node type
@@ -60,6 +60,7 @@ nodes represent the compressed side of the node. Packets received on the
 .Dv ip
 will be compressed or passed through as appropriate. Packets received
 on the other three hooks will be uncompressed as appropriate.
+This node also supports ``always pass through'' mode in either direction.
 .Pp
 Van Jacobsen compression only applies to TCP packets.
 Only ``normal'' (i.e., common case) TCP packets are actually compressed.
@@ -75,6 +76,7 @@ Other non-TCP IP packets are forwarded unchanged to
 When connecting to a
 .Xr ng_ppp 8
 node, the
+.Dv ip ,
 .Dv vjuncomp ,
 .Dv vjcomp , 
 and
@@ -82,10 +84,11 @@ and
 nodes should be connected to the
 .Xr ng_ppp 8
 node's
-.Dv vjcomp ,
-.Dv vjuncomp ,
+.Dv vjc_ip ,
+.Dv vjc_vjcomp ,
+.Dv vjc_vjuncomp ,
 and
-.Dv ip
+.Dv vjc_ip
 nodes, respectively.
 .Sh HOOKS
 This node type supports the following hooks:
@@ -102,32 +105,45 @@ Downstream uncompressed IP packets.
 .Sh CONTROL MESSAGES
 This node type supports the generic control messages, plus the following:
 .Bl -tag -width foo
-.It Dv NGM_VJC_CONFIG
+.It Dv NGM_VJC_SET_CONFIG
 This command resets the compression state and configures it according
 to the supplied
 .Dv "struct ngm_vjc_config"
 argument. This structure contains the following fields:
 .Bd -literal -offset 4n
 struct ngm_vjc_config {
-  u_char   enabled;       /* Enable compression/decompression */
+  u_char   enableComp;    /* Enable compression */
+  u_char   enableDecomp;  /* Enable decompression */
   u_char   numChannels;   /* Number of outgoing channels */
   u_char   compressCID;   /* OK to compress outgoing CID's */
 };
 .Ed
 .Pp
 When
-.Dv enabled
-is set to zero, the node operates in ``pass through'' mode, only
-accepting packets on the
+.Dv enableComp
+is set to zero, all packets received on the
 .Dv ip
-and
+hook are forwarded unchanged out the
 .Dv vjip
+hook.  Similarly, when
+.Dv enableDecomp
+is set to zero, all packets received on the
+.Dv vjip
+hook are forwarded unchanged out the
+.Dv ip
+hook, and packets are not accepted on the
+.Dv vjcomp
+and
+.Dv vjuncomp
 hooks.
-.Dv numChannels
-should be set to the number of compression channels, and is a value
-between 3 and 16, inclusive.
+When a node is first created,
+both compression and decompression are disabled and the node is
+therefore operating in bi-directional ``pass through'' mode.
 .Pp
-The
+When enabling compression,
+.Dv numChannels
+should be set to the number of outgoing compression channels, and is a value
+between 3 and 16, inclusive. Also, the
 .Dv compressCID
 field indicates whether it is OK to compress the CID field for
 outgoing compressed TCP packets. This value should be zero unless
@@ -142,9 +158,11 @@ structure, which is defined in
 .Dv "net/slcompress.h" .
 .It Dv NGM_VJC_CLR_STATS
 Clears the node statistics counters. Statistics are also cleared whenever the
-.Dv enabled
-field is changed from zero to one by a
-.Dv NGM_VJC_CONFIG
+.Dv enableComp
+or
+.Dv enableDecomp
+fields are changed from zero to one by a
+.Dv NGM_VJC_SET_CONFIG
 control message.
 .It Dv NGM_VJC_RECV_ERROR
 When the
@@ -158,9 +176,9 @@ This node shuts down upon receipt of a
 .Dv NGM_SHUTDOWN
 control message, or when all hooks have been disconnected.
 .Sh BUGS
-When used as a loadable kernel module, this node type requires that the file
+When used as a loadable kernel module, this node type requires the file
 .Dv "net/slcompress.c"
-was compiled into the kernel. Currently the only way to insure this
+to have been compiled into the kernel. Currently the only way to insure this
 is to include the
 .Dv slip ,
 .Dv ppp ,
@@ -169,6 +187,14 @@ or
 pseudo-devices in your kernel compilation. In the future there should
 be a kernel option that causes inclusion of this file without requiring
 one of these drivers.
+.Pp
+Because the initialization routine in the kernel implementation of
+Van Jacobsen compression initializes both compression and decompression
+at once, this node does not allow compression and decompression to
+be enabled in separate operations.  In order to enable one when
+the other is already enabled, first both must be disabled, then
+both enabled.  This of course resets the node state.  This restriction
+may be lifted in a later version.
 .Sh SEE ALSO
 .Xr netgraph 4 ,
 .Xr ng_ppp 8 ,