NG_GIF(4)

✨ NAME ✨

okay bestie, meet ng_gif — the generic tunnel interface netgraph node type 💅 and yup, this is the NG_GIF(4) page from the Kernel Interfaces Manual. it’s giving “tunnel interface but make it netgraph,” and honestly? iconic ✨

🛠️ SYNOPSIS 🛠️

#include <netgraph/ng_gif.h>

🦋 DESCRIPTION 🦋

The ng_gif netgraph node type allows gif(4) interfaces to interact with the netgraph(4) networking subsystem 🫶. literally the social glue.

Once the ng_gif module is loaded in the kernel, a node is automatically created for each gif(4) interface in the system — no manual spawning needed, it just happens 💫. Each node will attempt to name itself with the same name as the associated interface. All ng_gif nodes are persistent for as long as the interface itself exists. main character energy: they stay as long as the interface does 👑.

Two hooks are supported: lower and orphans. The hook name divert may be used as an alias for lower, and is provided for compatibility with ng_ether(4). In reality the two names represent the same hook — same vibe, different label, iykyk 🏷️.

The lower hook is a connection to the raw 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 lower being connected. slay, outgoing traffic keeps doing its thing 💅.

The orphans hook is equivalent to 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 orphans and lower may be connected at any time. pick one, bestie — they cannot both be connected 🚫.

In all cases, frames are raw packets with the address family of the packet attached to the front.

When no hooks are connected, packets flow normally upwards and downwards. no hooks? no drama, normal flow 🌈.

🪝 HOOKS 🪝

This node type supports the following hooks:

• lower — connection to the lower device link layer.
• orphans — like lower, but only receives unrecognized packets.

📬 CONTROL MESSAGES 📬

This node type supports only the generic control messages. that’s it, that’s the message 💌.

🧪 EXAMPLES 🧪

This command dumps all unrecognized packets received by the gif0 interface to standard output decoded in hex and ASCII:

nghook -a gif0: orphans

🔗 SEE ALSO 🔗

gif(4), netgraph(4), netintro(4), ifconfig(8), ngctl(8), nghook(8)

💖 AUTHORS 💖

Brooks Davis <brooks@FreeBSD.org>

---

xoxo, your fave manual bestie 💖 this page is from Debian, dated September 18, 2001, and it’s the NG_GIF(4) manual — periodt 🎀