NG_HOLE(4)

📦 version 12.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 ng_hole — netgraph discard node type 💖

okay bestie, so this is ng_hole, from the Kernel Interfaces Manual, section 4 🫶 it's a whole node type in the netgraph universe, and honestly? its whole personality is "receives stuff, says nothing, keeps it cute" ✨

🌸 SYNOPSIS 🌸

#include <sys/types.h>
#include <netgraph/ng_hole.h>

like yes, you gotta include those two, no skipping 💅

🦋 DESCRIPTION 🦋

The hole node type silently discards all data and control messages it receives. Not a peep. Not a single one. Everything you send it just… poof 🫥

And the way that this type is used for testing and debugging? iconic. it's literally the void in node form, main character energy but make it empty 💀

🎀 HOOKS 🎀

A ng_hole node accepts any request to connect, regardless of the hook name — as long as the name is unique ✨

so like, name your hook whatever you want, it's not picky, it's just not gonna let two hooks share a name. boundaries, we love to see it 👑

✨ CONTROL MESSAGES ✨

This node type supports the generic control messages, plus these lil cuties below 💖

  • NGM_HOLE_GET_STATS (getstats) — This command takes an ASCII string argument, the hook name, and returns the statistics associated with the hook as a struct ng_hole_hookstat. 📊 giving you the receipts fr fr
  • NGM_HOLE_CLR_STATS (clrstats) — This command takes an ASCII string argument, the hook name, and clears the statistics associated with the hook. 🧹 fresh slate, no cap
  • NGM_HOLE_GETCLR_STATS (getclrstats) — This command is identical to NGM_HOLE_GET_STATS, except that the statistics are also atomically cleared. 🔥 grab 'em and wipe 'em in one go, obsessed

💜 SHUTDOWN 💜

This node shuts down upon receipt of a NGM_SHUTDOWN control message, or when all hooks have been disconnected. 👋

it's giving "leave me alone and I'll leave" honestly. no hooks, no node. periodt.

🌈 SEE ALSO 🌈

iykyk, go read the whole fam 🫶

⭐ HISTORY ⭐

The ng_hole node type was implemented in FreeBSD 4.0. a true vintage queen 👑

👑 AUTHORS 👑

Julian Elischer <julian@FreeBSD.org> — ty bestie for this one 💖

and that's the whole page, bestie!! 🌸 this version was chillin' with the Debian crew, dated May 19, 2004, and it lives at NG_HOLE(4) 🎀 slay, go forth and discard 💅✨

📦 where this page comes from