NG_ATMLLC(4)

πŸ’– NG_ATMLLC πŸ’–

okay bestie, so we're looking at ng_atmllc from the Kernel Interfaces Manual β€” section 4, kernel interfaces, the whole vibe. sit down, grab a boba, and let's get into it πŸ§‹βœ¨


✨ NAME ✨

ng_atmllc β€” the ATM LLC netgraph node type. that's it, that's the girl πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <netgraph/ng_atmllc.h>

like, include the header, obviously πŸ™ˆ


🌸 DESCRIPTION 🌸

so the atmllc node type is literally a translator. she takes frames and converts them in and out of ATM LLC encapsulation, exactly as specified by RFC 1483. no cap, that's her whole job 🫢

in LLC encapsulation, the protocol of a given protocol data unit (PDU) gets specified by an IEEE 802.2 LLC header, and possibly after that there's an IEEE 802.1a SubNetwork Attachment Point (SNAP) header riding along too. and rn? this node handles the Ethernet and FDDI protocols. just those two. she's focused πŸ’…

here's the tea on how she moves data:

  • she transmits and receives ATM PDUs on the atm hook πŸŽ€
  • PDUs that come in get decoded and forwarded to the ether or fddi hooks, whichever fits 🌈
  • data that arrives on the ether or fddi hooks is assumed to be full Ethernet or FDDI packets (as appropriate, bestie β€” don't send her half a packet, she will know 😭), and then she encapsulates it into a PDU and sends it out via the atm hook ✨

it's giving relay. it's giving middleman. it's giving iconic. periodt πŸ‘‘


πŸ”₯ HOOKS πŸ”₯

this node type supports the following hooks, and yes we're going through all of them:

  • atm β€” the ATM connection. typically you'd connect this hook to an ng_atm(4) node, because that one handles the whole transmission-of-ATM-PDUs-over-an-ATM-device situation. she's the plug, not the whole power grid πŸ’œ
  • ether β€” the Ethernet connection. this hook sends and receives Ethernet frames. normally you'd connect it to an ng_eiface(4) node if that's what you've got going on 🌸
  • fddi β€” the FDDI connection. this hook sends and receives FDDI frames. that's the whole description, she's lowkey mysterious like that πŸ¦‹

πŸ’Œ CONTROL MESSAGES πŸ’Œ

this node type supports the generic control messages. that's it. nothing extra, nothing spicy, just the generics. we love a low-maintenance queen πŸŽ€


πŸ’€ SHUTDOWN πŸ’€

this node shuts down when:

  1. she receives a NGM_SHUTDOWN control message, OR
  2. all hooks have been disconnected πŸ™ˆ

that's the whole exit strategy. no drama, just vibes ending 🫢


πŸ‘€ SEE ALSO πŸ‘€

go read them, bestie, iykyk πŸ“šβœ¨


πŸ‘‘ AUTHORS πŸ‘‘

Benno Rice <benno@FreeBSD.org> β€” thank you for your service, king πŸ«‘πŸ’–


and that's the whole page, no cap. this absolute classic dropped on Debian, dated March 8, 2004 β€” and she's still serving looks to this day πŸ’…βœ¨πŸŽ€

πŸ“¦ where this page comes from