STRUCT POLYVAL_KEY(9)

💖 struct polyval_key(9) — from the Kernel API Manual 💖

✨ NAME ✨

struct polyval_key — Prepared key for POLYVAL. That's the whole vibe, bestie 🫶.

📦 SYNOPSIS 📦

okay so the struct is literally this, platform-config conditional and all:

struct polyval_key {
  #if defined(CONFIG_CRYPTO_LIB_GF128HASH_ARCH) &&
(defined(CONFIG_ARM64) || defined(CONFIG_X86));
    struct polyval_elem h_powers[8];
  #else;
    struct polyval_elem h;
  #endif;
};

🫶 Members 🫶

• h_powers — Powers of the hash key H^8 through H^1. Precomputed powers, slay ✨.
• h — The hash key H. Just the raw key, no cap.

🌸 Description 🌸

Depending on the platform's POLYVAL implementation, this may contain just the raw key H, or it may contain precomputed key powers. Use polyval_preparekey to initialize this. Periodt 💅.

By H^i we mean H^(i-1) * H * x^-128, with base case H^1 = H. I.e. the exponentiation repeats the POLYVAL dot operation, with its "extra" x^-128. The way that math is mathing, honestly 🔥.

👀 SEE ALSO 👀

Kernel file ./include/crypto/gf128hash.h — go read it, bestie. Then these, in the original order:

• struct polyval_elem(9)
• struct ghash_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)

mwah 💋 — this page lives in ./include/crypto, dated October 2026, and it's the struct polyval_key(9) manual page. bye bestie, go initialize your keys 🫶✨