STRUCT POLYVAL_ELEM(9)

💅 struct polyval_elem(9) 💅

okay so bestie, welcome to the Kernel API Manual — this page is literally all about struct polyval_elem, and it's genuinely not as scary as it sounds, i promise 🫶

---

✨ NAME ✨

struct polyval_elem — an element of the POLYVAL finite field 🌸

---

🎀 SYNOPSIS 🎀

struct polyval_elem {
    union {
      u8 bytes[POLYVAL_BLOCK_SIZE];
      struct {
        __le64 lo;
        __le64 hi;
      };
    };
 };

like, that's the whole vibe. a union of a union, living its best life 💀

---

🦋 MEMBERS 🦋

• {unnamed_union} — anonymous, no name, no notes, it's giving mysterious main character energy 🙈
• bytes — the element seen as a byte array (it's unioned with lo and hi, so same memory, different outfit 💅)
• {unnamed_struct} — also anonymous, also iconic, also unnamed 😭
• lo — the low 64 terms of the element's polynomial ✨
• hi — the high 64 terms of the element's polynomial ✨

---

👑 DESCRIPTION 👑

so this struct represents, like, one single element of the finite field GF(2^128) 🔥

and it does it the POLYVAL way: little-endian byte order and natural bit order. no cap, that's the convention, that's the whole thing, periodt 💜

---

🌈 SEE ALSO 🌈

Kernel file ./include/crypto/gf128hash.h:

• struct ghash_key(9)
• struct polyval_key(9)
• struct ghash_ctx(9)
• struct polyval_ctx(9)
• ghash_preparekey(9)
• polyval_preparekey(9)
• ghash_init(9)
• polyval_init(9)
• polyval_import_blkaligned(9)
• polyval_export_blkaligned(9)
• ghash_update(9)
• polyval_update(9)
• ghash_final(9)
• polyval_final(9)
• ghash(9)
• polyval(9)

---

ngl bestie, read the whole gf128hash.h family before you go poking at the raw bytes — the import/export helpers exist for a reason 💖

---

okay that's the page!! this one came from ./include/crypto and it's dated October 2026, aka the future, aka she's ahead of her time 🧚‍♀️✨ mwah, go slay your finite field math 💅🎀