STRUCT TIPC_LINK(9)

💅 NAME 💅

okay so bestie, this is the struct tipc_link(9) page from the Kernel API Manual, and it's literally all about the TIPC link data structure. no cap, it's giving “one struct to hold the whole link vibe.” 💖

struct tipc_link — TIPC link data structure ✨

🌸 SYNOPSIS 🌸

struct tipc_link {
    u32 addr;
    char name[TIPC_MAX_LINK_NAME];
    struct net *net;
    u16 peer_session;
    u16 session;
    u16 snd_nxt_state;
    u16 rcv_nxt_state;
    u32 peer_bearer_id;
    u32 bearer_id;
    u32 tolerance;
    u32 abort_limit;
    u32 state;
    u16 peer_caps;
    bool in_session;
    bool active;
    u32 silent_intv_cnt;
    char if_name[TIPC_MAX_IF_NAME];
    u32 priority;
    char net_plane;
    struct tipc_mon_state mon_state;
    u16 rst_cnt;
    u16 drop_point;
    struct sk_buff *failover_reasm_skb;
    struct sk_buff_head failover_deferdq;
    u16 mtu;
    u16 advertised_mtu;
    struct sk_buff_head transmq;
    struct sk_buff_head backlogq;
    struct {
      u16 len;
      u16 limit;
      struct sk_buff *target_bskb;
    } backlog[5];
    u16 snd_nxt;
    u16 rcv_nxt;
    u32 rcv_unacked;
    struct sk_buff_head deferdq;
    struct sk_buff_head *inputq;
    struct sk_buff_head *namedq;
    struct sk_buff_head wakeupq;
    u16 window;
    u16 min_win;
    u16 ssthresh;
    u16 max_win;
    u16 cong_acks;
    u16 checkpoint;
    struct sk_buff *reasm_buf;
    struct sk_buff *reasm_tnlmsg;
    u16 ackers;
    u16 acked;
    u16 last_gap;
    struct tipc_gap_ack_blks *last_ga;
    struct tipc_link *bc_rcvlink;
    struct tipc_link *bc_sndlink;
    u8 nack_state;
    bool bc_peer_is_up;
    struct tipc_stats stats;
};

🫶 Members 🫶

okay, deep breath, because this is the member-by-member tour and we're not skipping a single one. periodt. 💅

• addr — network address of link's peer node 👑
• name — link name character string 🎀
• net — pointer to namespace struct 🦋
• peer_session — link session # being used by peer end of link ✨
• session — session to be used by link 💖
• snd_nxt_state — next send seq number 🌸
• rcv_nxt_state — next rcv seq number 🌈
• peer_bearer_id — bearer id used by link's peer endpoint 🫶
• bearer_id — local bearer id used by link 💅
• tolerance — minimum link continuity loss needed to reset link [in ms] 🔥
• abort_limit — # of unacknowledged continuity probes needed to reset link 💀
• state — current state of link FSM ⭐
• peer_caps — bitmap describing capabilities of peer node 🧚
• in_session — have received ACTIVATE_MSG from peer 💌
• active — link is active ✅
• silent_intv_cnt — # of timer intervals without any reception from peer 😭
• if_name — associated interface name 🍓
• priority — current link priority 👑
• net_plane — current link network plane ('A' through 'H') 🌈
• mon_state — cookie with information needed by link monitor 🍪
• rst_cnt — link reset counter 🔁
• drop_point — seq number for failover handling (FIXME) 🙈
• failover_reasm_skb — saved failover msg ptr (FIXME) 💀
• failover_deferdq — deferred message queue for failover processing (FIXME) 🫠
• mtu — current maximum packet size for this link 📦
• advertised_mtu — advertised own mtu when link is being established 📣
• transmq — the link's transmit queue 🚀
• backlogq — queue for messages waiting to be sent 🕰️
• backlog — link's backlog by priority (importance) 🥇
• snd_nxt — next sequence number to be used ➡️
• rcv_nxt — next sequence number to expect for inbound messages ⬅️
• rcv_unacked — # messages read by user, but not yet acked back to peer 😬
• deferdq — deferred receive queue 📥
• inputq — buffer queue for messages to be delivered upwards ⬆️
• namedq — buffer queue for name table messages to be delivered upwards 🏷️
• wakeupq — linked list of wakeup msgs waiting for link congestion to abate 😴
• window — sliding window size for congestion handling 🪟
• min_win — minimal send window to be used by link 🧸
• ssthresh — slow start threshold for congestion handling 🐢
• max_win — maximal send window to be used by link 🐘
• cong_acks — congestion acks for congestion avoidance (FIXME) 🙃
• checkpoint — seq number for congestion window size handling 🚩
• reasm_buf — head of partially reassembled inbound message fragments 🧩
• reasm_tnlmsg — fragmentation/reassembly area for tunnel protocol message 🚇
• ackers — # of peers that needs to ack each packet before it can be released ✅
• acked — # last packet acked by a certain peer. Used for broadcast. 📡
• last_gap — last gap ack blocks for bcast (FIXME) 💫
• last_ga — ptr to gap ack blocks 🧷
• bc_rcvlink — the peer specific link used for broadcast reception 📻
• bc_sndlink — the namespace global link used for broadcast sending 📢
• nack_state — bcast nack state 🚫
• bc_peer_is_up — peer has acked the bcast init msg 👀
• stats — collects statistics regarding link activity 📊

👀 SEE ALSO 👀

Kernel file ./net/tipc/link.c — that's the spot, bestie. and these are the linked-up functions you're gonna wanna peek at:

• tipc_link_create(9)
• tipc_link_bc_create(9)
• tipc_link_fsm_evt(9)
• tipc_link_too_silent(9)
• link_schedule_user(9)
• link_prepare_wakeup(9)
• tipc_link_set_skb_retransmit_time(9)
• tipc_link_xmit(9)
• link_retransmit_failure(9)
• tipc_get_gap_ack_blks(9)
• tipc_link_failover_prepare(9)
• tipc_link_reset_stats(9)
• tipc_link_dump(9)

mwah 💋 this page came from ./net/tipc, dated October 2026, and it's literally the struct tipc_link(9) page. bye bestie 🫶✨