rio_clr_err_stopped(9)

📦 version 7.3.1, in nixpkgs unstable

💅 rio_clr_err_stopped — a Kernel API Manual moment (section 9, bestie)

okay so we're in the Kernel API Manual, section 9, and today's main character is rio_clr_err_stopped. yes she clears port Error-stopped states. yes she's a little unfinished. we love her anyway 🫶

✨ NAME ✨

rio_clr_err_stopped — literally just clears port Error-stopped states. that's the whole gig 💅

🌸 SYNOPSIS 🌸

int rio_clr_err_stopped (struct rio_dev *rdev , u32 pnum , u32
err_status );

🎀 ARGUMENTS 🎀

  • rdev — a pointer to the RIO device control structure. she points, you vibe 🦋
  • pnum — the switch port number whose errors we're clearing. pick your port, bestie.
  • err_status — the port error status. plot twist: if it's 0, the register gets read from the device instead 👀

💖 DESCRIPTION 💖

so. TODO: right now this routine is not compatible with the recovery process specified for idt_gen3 RapidIO switch devices 😭. it has to be reviewed so it can implement a universal recovery process that's compatible with the full range of available devices. like, all of them. no pressure.

the IDT gen3 switch driver now implements its own HW-specific error handler that issues a soft port reset to the port, which resets the ERR_STOP bits and ackIDs. iconic of them honestly 🔥

ngl, the takeaway here is: this one's a work in progress, and the gen3 situation is being handled driver-side instead. don't @ me, that's what the page says 💀

🧚 SEE ALSO 🧚

Kernel file ./drivers/rapidio/rio.c plus this whole friend group:

and that's the page, bestie 🍓 this one lives in ./drivers/rapidio, dated October 2026, and it's been rio_clr_err_stopped(9) the whole time 💜✨

📦 where this page comes from