tipc_crypto_key_try_align(9)

💖 tipc_crypto_key_try_align(9) — align RX keys if possible 💖

okay so bestie, this page is from the Kernel API Manual, and ngl it's lowkey niche but highkey iconic. not me being obsessed with tipc_crypto_key_try_align(9) — the key-slot alignment moment has main character energy 💅✨

---

🌸 NAME 🌸

tipc_crypto_key_try_align — Align RX keys if possible 🎀

✨ SYNOPSIS ✨

bool tipc_crypto_key_try_align (struct tipc_crypto *rx , u8 new_pending
       );

🦋 ARGUMENTS 🦋

• rx — RX crypto handle. that's the crypto handle on the RX side, periodt 💜
• new_pending — new pending slot if aligned (= TX key from peer). yep, that exact parenthetical is doing important work, don't skip it 👀

🔥 DESCRIPTION 🔥

So the peer has used an unknown key slot — fr fr, this only happens when the peer has left and rejoned, or when we are the newcomer. 😭 (yes, “rejoned” is the spelling we're keeping, iykyk.)

That means there must be no active key but a pending key at an unaligned slot. if so, we try to move the pending key to the new slot. slay, periodt. ✨

🫶 NOTE 🫶

A potential passive key can exist — and it will be shifted correspondingly! don't forget that icon, bestie 💖

👑 RETURN 👑

"true" if the key is successfully aligned, otherwise "false" — that's the whole vibe check, no cap 💅

🌈 SEE ALSO 🌈

• Kernel file ./net/tipc/crypto.c — yes, the source file, periodt 📂
• struct tipc_tfm(9)
• struct tipc_aead(9)
• struct tipc_crypto_stats(9)
• struct tipc_crypto(9)
• tipc_aead_key_validate(9)
• tipc_aead_key_generate(9)
• tipc_aead_free(9)
• tipc_aead_tfm_next(9)
• tipc_aead_init(9)
• tipc_aead_clone(9)
• tipc_aead_mem_alloc(9)
• tipc_aead_encrypt(9)
• tipc_aead_decrypt(9)
• tipc_ehdr_validate(9)
• tipc_ehdr_build(9)
• tipc_crypto_key_init(9)
• tipc_crypto_key_attach(9)
• tipc_crypto_key_pick_tx(9)
• tipc_crypto_key_synch(9)
• tipc_crypto_xmit(9)
• tipc_crypto_rcv(9)
• tipc_crypto_msg_rcv(9)
• tipc_crypto_key_distr(9)
• tipc_crypto_key_xmit(9)
• tipc_crypto_key_rcv(9)
• tipc_crypto_work_rx(9)
• tipc_crypto_rekeying_sched(9)
• tipc_crypto_work_tx(9)

---

made with love in ./net/tipc, October 2026 — mwah 💋🎀