oa_1000bt1_get_tdr_distance(9)

💅 oa_1000bt1_get_tdr_distance(9) — the Kernel API Manual, bestie edition ✨

okay so this is a page from the Kernel API Manual, and honestly? it's giving "one tiny function, one big job." 🎀 Let's get into it.

---

🌸 NAME 🌸

oa_1000bt1_get_tdr_distance — get the distance to the main fault from a TDR register value. literally what it says on the tin, no cap 💖

---

✨ SYNOPSIS ✨

int oa_1000bt1_get_tdr_distance (u16 reg_value );

---

🦋 ARGUMENTS 🦋

• reg_value — the value you read out of the TDR register. that's it, that's the whole input 🫶

---

💜 DESCRIPTION 💜

So! This function takes a register value from the HDD.TDR register and extracts the distance to the main fault that the TDR feature detected. 🕵️‍♀️ It's basically the "how far away is the problem" machine.

The distance is measured in centimeters and ranges from 0 to 3100 centimeters. iconic range, honestly.

⚠️ but listen — if the distance is not available (0x3f), the function returns -ERANGE. so don't go reading that as a real distance, bestie, it's a "no answer, sorry" 😭

---

🌈 RETURN 🌈

• The distance to the main fault, in centimeters 🎀
• or -ERANGE if the resolution is not possible 🙈

---

👑 SEE ALSO 👑

• Kernel file ./drivers/net/phy/open_alliance_helpers.c
• oa_1000bt1_get_ethtool_cable_result_code(9)

---

🍓 SIGN-OFF 🍓

that's the whole page, bestie! 💅 it lives under ./drivers/net/phy, dated October 2026, and this lovely little manpage is oa_1000bt1_get_tdr_distance(9) — go forth and measure some cable faults ✨🧚💖