summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorglebius <glebius@FreeBSD.org>2014-01-22 10:31:56 +0000
committerglebius <glebius@FreeBSD.org>2014-01-22 10:31:56 +0000
commit3b6c6cb1cd686fbb2186ab2721074ff53d5def73 (patch)
tree5d24888723ba8bda7330749f49bd86b8d7811fe2
parent99ea781723ac0ee95e527398c3fc265fded7e25f (diff)
downloadFreeBSD-src-3b6c6cb1cd686fbb2186ab2721074ff53d5def73.zip
FreeBSD-src-3b6c6cb1cd686fbb2186ab2721074ff53d5def73.tar.gz
Merge r258702: Fix some misinformation in netgraph manual pages.
-rw-r--r--lib/libnetgraph/netgraph.34
-rw-r--r--share/man/man4/netgraph.433
2 files changed, 19 insertions, 18 deletions
diff --git a/lib/libnetgraph/netgraph.3 b/lib/libnetgraph/netgraph.3
index d2ef8bd..bd55797 100644
--- a/lib/libnetgraph/netgraph.3
+++ b/lib/libnetgraph/netgraph.3
@@ -35,7 +35,7 @@
.\" $FreeBSD$
.\" $Whistle: netgraph.3,v 1.7 1999/01/25 07:14:06 archie Exp $
.\"
-.Dd January 27, 2004
+.Dd November 25, 2013
.Dt NETGRAPH 3
.Os
.Sh NAME
@@ -57,7 +57,7 @@
.Sh LIBRARY
.Lb libnetgraph
.Sh SYNOPSIS
-.In netgraph.h
+.In netgraph/netgraph.h
.Ft int
.Fn NgMkSockNode "const char *name" "int *csp" "int *dsp"
.Ft int
diff --git a/share/man/man4/netgraph.4 b/share/man/man4/netgraph.4
index 6783973..e4cc20d 100644
--- a/share/man/man4/netgraph.4
+++ b/share/man/man4/netgraph.4
@@ -36,7 +36,7 @@
.\" $Whistle: netgraph.4,v 1.7 1999/01/28 23:54:52 julian Exp $
.\" $FreeBSD$
.\"
-.Dd May 25, 2008
+.Dd November 25, 2013
.Dt NETGRAPH 4
.Os
.Sh NAME
@@ -292,7 +292,7 @@ unless specifically declared to be a reader in their definition.
(See
.Dv NGM_READONLY
in
-.In ng_message.h . )
+.In netgraph/ng_message.h . )
.Pp
While this mode of operation
results in good performance, it has a few implications for node
@@ -840,26 +840,27 @@ and should be used as a starting point for new node writers.
.Ss Netgraph Message Structure
Control messages have the following structure:
.Bd -literal
-#define NG_CMDSTRSIZ 32 /* Max command string (including nul) */
+#define NG_CMDSTRSIZ 32 /* Max command string (including null) */
struct ng_mesg {
struct ng_msghdr {
u_char version; /* Must equal NG_VERSION */
- u_char spare; /* Pad to 2 bytes */
- u_short arglen; /* Length of cmd/resp data */
- u_long flags; /* Message status flags */
- u_long token; /* Reply should have the same token */
- u_long typecookie; /* Node type understanding this message */
- u_long cmd; /* Command identifier */
- u_char cmdstr[NG_CMDSTRSIZ]; /* Cmd string (for debug) */
+ u_char spare; /* Pad to 4 bytes */
+ uint16_t spare2;
+ uint32_t arglen; /* Length of cmd/resp data */
+ uint32_t cmd; /* Command identifier */
+ uint32_t flags; /* Message status flags */
+ uint32_t token; /* Reply should have the same token */
+ uint32_t typecookie; /* Node type understanding this message */
+ u_char cmdstr[NG_CMDSTRSIZ]; /* cmd string + \0 */
} header;
- char data[0]; /* Start of cmd/resp data */
+ char data[]; /* placeholder for actual data */
};
-#define NG_ABI_VERSION 5 /* Netgraph kernel ABI version */
-#define NG_VERSION 4 /* Netgraph message version */
-#define NGF_ORIG 0x0000 /* Command */
-#define NGF_RESP 0x0001 /* Response */
+#define NG_ABI_VERSION 12 /* Netgraph kernel ABI version */
+#define NG_VERSION 8 /* Netgraph message version */
+#define NGF_ORIG 0x00000000 /* The msg is the original request */
+#define NGF_RESP 0x00000001 /* The message is a response */
.Ed
.Pp
Control messages have the fixed header shown above, followed by a
@@ -1296,7 +1297,7 @@ Used in conjunction with
either
.Xr ppp 8
or the
-.Pa net/mpd
+.Pa net/mpd5
port.
.It BRIDGE
This node, together with the Ethernet nodes, allows a very flexible
OpenPOWER on IntegriCloud