run_translation_test(9)

💖 NAME 💖

okay so bestie, welcome to the run_translation_test(9) page from the Kernel API Manual ✨ run_translation_test — execute forward and reverse translations. That's the whole vibe: forward, reverse, translations, both directions. periodt 💅

✨ SYNOPSIS ✨

       int run_translation_test (u64 dpa , int pos , u8 r_eiw , u16 r_eig , u8
       hb_ways , int math , u64 expect_hpa );

🎀 ARGUMENTS 🎀

• dpa — device physical address. address-core, no cap 💅
• pos — expected position in region interleave. the position bestie, as expected ✨
• r_eiw — region encoded interleave ways. region encoded, interleave ways, iconic 🎀
• r_eig — region encoded interleave granularity. granularity era 🦋
• hb_ways — host bridge interleave ways. host bridge, interleave ways, main character energy 👑
• math — interleave arithmetic (MODULO_MATH or XOR_MATH). pick your math vibe 🔥
• expect_hpa — -- undescribed -- oop 😭 the source literally leaves this one undescribed, so that's all we got, bestie.

🌸 RETURN 🌸

• 0 on success, -1 on failure 💀. That's it: success gets a cute zero, failure gets a minus one.

🦋 SEE ALSO 🦋

Kernel file ./tools/testing/cxl/test/cxl_translate.c is the main-character file to check, plus these besties: to_hpa(9), to_dpa(9), to_pos(9), parse_test_vector(9). iykyk 🦋

mwah 💋 this page's source/version is ./tools/testing/cxl/test, and the date is October 2026 — that's the footer vibe folded into this cute sign-off instead of copied. k bye bestie 🫶✨