ng_hub(4)

ng_hub4

Packet distribution netgraph node

Usage

#include <netgraph/ng_hub.h>

Overview

The hub node type provides a simple mechanism for distributing packets over several links. Packets received on any of the hooks are forwarded out the other hooks. Packets are not altered in any way.

Hooks

A hub node accepts any request to connect, regardless of the hook name, as long as the name is unique.

Control messages

This node type supports the generic control messages, plus the following:

NGM_HUB_SET_PERSISTENT (setpersistent)

This command sets the persistent flag on the node, and takes no arguments.

Shutdown

This node shuts down upon receipt of a NGM_SHUTDOWN control message, or when all hooks have been disconnected. Setting the persistent flag via a NGM_HUB_SET_PERSISTENT control message disables automatic node shutdown when the last hook gets disconnected.

Releases

53 releases since FreeBSD 4.11-RELEASE; the text changed 34 times.

  1. 4.11
  2. 5.3–6.3
  3. 6.4
  4. 7.0
  5. 7.1
  6. 7.2
  7. 7.3
  8. 7.4
  9. 8.0
  10. 8.1
  11. 8.2
  12. 8.3
  13. 8.4
  14. 9.0
  15. 9.1
  16. 9.2
  17. 9.3
  18. 10.0
  19. 10.1
  20. 10.2
  21. 10.3
  22. 10.4
  23. 11.0
  24. 11.1
  25. 11.2
  26. 11.3
  27. 11.4
  28. 12.0
  29. 12.1
  30. 12.2
  31. 12.3
  32. 12.4
  33. 13.0–13.2
  34. 13.3–15.1
  35. 16.0

History

The ng_hub node type appeared in FreeBSD 5.3.

Authors

Ruslan Ermilov ⟨[email protected]⟩

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.