fc_block_rport(9)

💅 fc_block_rport — Kernel API Manual, bestie edition ✨

Okay so this is fc_block_rport(9) from the Kernel API Manual, and it's lowkey one of those tiny functions that keeps your whole SCSI stack from falling apart. Let's get into it 🫶

---

🌸 NAME 🌸

fc_block_rport — block the SCSI eh thread for a blocked fc_rport. That's it, that's the whole vibe 💅

---

✨ SYNOPSIS ✨

int fc_block_rport (struct fc_rport *rport );

---

🎀 ARGUMENTS 🎀

• rport — the remote port that scsi_eh is trying to recover. This is the poor little guy the error handler is out here trying to rescue 😭

---

🦋 DESCRIPTION 🦋

Okay so picture this: you're in a FC LLD scsi_eh callback, right? You can call this routine from there. What it does is it blocks the scsi_eh thread until the fc_rport leaves FC_PORTSTATE_BLOCKED, or until the fast_io_fail_tmo fires — whichever happens first, no cap ⏳

Why do we even need this? Because if you don't block, the scsi_eh will go ahead and fail recovery actions for rports that are already blocked, and that leads to offlined SCSI devices. Which is giving disaster. So yeah, this little block is doing main character energy work behind the scenes 👑

---

🔥 RETURN 🔥

• 0 — the fc_rport left the state FC_PORTSTATE_BLOCKED. Slay, we're free 💖
• FAST_IO_FAIL — the fast_io_fail_tmo fired. This one should be passed back to scsi_eh, fr fr, don't just drop it 🙈

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/scsi/scsi_transport_fc.c — and honestly the whole friend group is here, so let's list them all out:

• fc_get_event_number(9)
• fc_host_post_fc_event(9)
• fc_host_post_event(9)
• fc_host_post_vendor_event(9)
• fc_find_rport_by_wwpn(9)
• fc_host_fpin_rcv(9)
• fc_eh_timed_out(9)
• fc_queue_work(9)
• fc_flush_work(9)
• fc_queue_devloss_work(9)
• fc_flush_devloss(9)
• fc_remove_host(9)
• fc_starget_delete(9)
• fc_rport_final_delete(9)
• fc_remote_port_create(9)
• fc_remote_port_add(9)
• fc_remote_port_delete(9)
• fc_remote_port_rolechg(9)
• fc_timeout_deleted_rport(9)
• fc_timeout_fail_rport_io(9)
• fc_scsi_scan_rport(9)
• fc_block_scsi_eh(9)
• fc_vport_setup(9)
• fc_vport_create(9)
• fc_vport_terminate(9)
• fc_vport_sched_delete(9)
• fc_bsg_job_timeout(9)
• fc_bsg_host_dispatch(9)
• fc_bsg_rport_dispatch(9)
• fc_bsg_hostadd(9)
• fc_bsg_rportadd(9)
• fc_bsg_remove(9)

---

And that's the whole page, bestie 🧚 Signing off from the ./drivers/scsi source, dated October 2026, manual fc_block_rport(9) in the Kernel API Manual — go block those rports and stay iconic 💜