diff options
author | brooks <brooks@FreeBSD.org> | 2001-09-26 23:50:17 +0000 |
---|---|---|
committer | brooks <brooks@FreeBSD.org> | 2001-09-26 23:50:17 +0000 |
commit | 375454f578bc844afecdc4726c1c0e71b42666b9 (patch) | |
tree | 88725114e0a34bf834a02b17a64b75614573d795 /share | |
parent | e8d737fac928d0d8d0832ffaa84c7e3fc8264d8a (diff) | |
download | FreeBSD-src-375454f578bc844afecdc4726c1c0e71b42666b9.zip FreeBSD-src-375454f578bc844afecdc4726c1c0e71b42666b9.tar.gz |
/home/brooks/ng_gif.message
Diffstat (limited to 'share')
-rw-r--r-- | share/man/man4/Makefile | 1 | ||||
-rw-r--r-- | share/man/man4/ng_gif.4 | 129 | ||||
-rw-r--r-- | share/man/man4/ng_gif_demux.4 | 114 |
3 files changed, 244 insertions, 0 deletions
diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index 08a76f6..950495a 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -90,6 +90,7 @@ MAN= aac.4 \ ng_echo.4 \ ng_ether.4 \ ng_frame_relay.4 \ + ng_gif.4 \ ng_hole.4 \ ng_iface.4 \ ng_ksocket.4 \ diff --git a/share/man/man4/ng_gif.4 b/share/man/man4/ng_gif.4 new file mode 100644 index 0000000..cc2e8d9 --- /dev/null +++ b/share/man/man4/ng_gif.4 @@ -0,0 +1,129 @@ +.\" Copyright 2000 The Aerospace Corporation. 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. +.\" 3. The name of The Aerospace Corporation may not be used to endorse or +.\" promote products derived from this software. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AEROSPACE CORPORATION "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 AEROSPACE CORPORATION 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. +.\" +.\" Author: Brooks Davis <brooks@FreeBSD.org> +.\" +.\" $FreeBSD$ +.\" +.Dd September 18, 2001 +.Dt NG_GIF 4 +.Os +.Sh NAME +.Nm ng_gif +.Nd Generic tunnel interface netgraph node type +.Sh SYNOPSIS +.Fd #include <netgraph/ng_gif.h> +.Sh DESCRIPTION +The +.Nm +netgraph node type allows +.Xr gif 4 +interfaces to interact with +the +.Xr netgraph 4 +networking subsystem. +Once the +.Nm +module is loaded in the kernel, a node is automatically created +for each +.Xr gif 4 +interface in the system. +Each node will attempt to name itself with the same name +as the associated interface. +All +.Nm +nodes are persistent for as long as the interface itself exists. +.Pp +Two hooks are supported: +.Dv lower +and +.Dv orphans . +The hook name +.Dv divert +may be used as an alias for +.Dv lower , +and is provided for compatibility with +.Xr ng_ether 4 . +In reality the two names represent the same hook. +.Pp +The +.Dv lower +hook is a connection to the raw +.Xr gif 4 +device. +When connected, all incoming packets are diverted out this hook. +Writing to this hook results in a raw encapsulated packet being transmitted +by the device. +Normal outgoing packets are not affected by +.Dv lower +being connected. +.Pp +The +.Dv orphans +hook is equivalent to +.Dv lower , +except that only unrecognized packets (that would otherwise be discarded) +are written to the hook, and normal incoming traffic is unaffected. +At most one of +.Dv orphans +and +.Dv lower +may be connected at any time. +.Pp +In all cases, frames are raw packets with the address family of the +packet attached to the front. +.Pp +When no hooks are connected, packets flow normally upwards and downwards. +.Sh HOOKS +This node type supports the following hooks: +.Pp +.Bl -tag -width orphans +.It Dv lower +Connection to the lower device link layer. +.It Dv orphans +Like +.Dv lower , +but only receives unrecognized packets. +.El +.Sh CONTROL MESSAGES +This node type supports only the generic control messages generic +control messages. +.Sh EXAMPLES +This command dumps all unrecognized packets received by the +.Dv gif0 +interface to standard output decoded in hex and ASCII: +.Bd -literal -offset indent +nghook -a gif0: orphans +.Ed +.Sh SEE ALSO +.Xr gif 4 , +.Xr netgraph 4 , +.Xr netintro 4 , +.Xr ifconfig 8 , +.Xr ngctl 8 , +.Xr nghook 8 +.Sh AUTHORS +.An Brooks Davis Aq brooks@FreeBSD.org diff --git a/share/man/man4/ng_gif_demux.4 b/share/man/man4/ng_gif_demux.4 new file mode 100644 index 0000000..5adaa96 --- /dev/null +++ b/share/man/man4/ng_gif_demux.4 @@ -0,0 +1,114 @@ +.\" Copyright 2000 The Aerospace Corporation. 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. +.\" 3. The name of The Aerospace Corporation may not be used to endorse or +.\" promote products derived from this software. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AEROSPACE CORPORATION "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 AEROSPACE CORPORATION 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. +.\" +.\" Author: Brooks Davis <brooks@FreeBSD.org> +.\" +.\" $FreeBSD$ +.\" +.Dd September 18, 2001 +.Dt NG_GIF_DEMUX 4 +.Os +.Sh NAME +.Nm ng_gif_demux +.Nd Demultiplexr for packets from +.Xr ng_gif 4 +nodes +.Sh SYNOPSIS +.Fd #include <netgraph/ng_gif_demux.h> +.Sh DESCRIPTION +The +.Nm +netgraph node type demultiplexes the output from +.Xr ng_gif 4 +nodes in the +.Xr netgraph 4 +networking subsystem. +.Pp +The +.Dv gif +hook is ment to be connected to the +.Dv lower +or +.Dv orphans +hook of an +.Xr ng_gif 4 +node. +The +.Dv inet , +.Dv inet6 , +.Dv atalk , +.Dv ipx , +.Dv atm , +.Dv natm , +and +.Dv ns +hooks output frames of the given type when they are recieved on the +.Dv gif +hook. +When a frame is recived on one of these hooks, it is encapsulated and +sent out the +.Dv gif +hook. +.Sh HOOKS +This node type supports the following hooks: +.Pp +.Bl -tag -width inet6 +.It Dv gif +Connection to the +.Dv lower +or +.Dv orphans +hook of an +.Xr ng_gif 4 +node. +.It Dv inet +Hook for input and output of IP frames. +.It Dv inet6 +Hook for input and output of IPv6 frames. +.It Dv atalk +Hook for input and output of AppleTalk frames. +.It Dv ipx +Hook for input and output of IPX frames. +.It Dv atm +Hook for input and output of ATM frames. +.It Dv natm +Hook for input and output of NATM frames. +.It Dv ns +Hook for input and output of NS frames. +.El +.Sh CONTROL MESSAGES +This node type supports only the generic control messages generic +control messages. +.Sh SEE ALSO +.Xr gif 4 , +.Xr netgraph 4 , +.Xr netintro 4 , +.Xr ng_gif 4 , +.Xr ifconfig 8 , +.Xr ngctl 8 , +.Xr nghook 8 +.Sh AUTHORS +.An Brooks Davis Aq brooks@FreeBSD.org |