fc_eh_timed_out(9)

🌸 NAME 🌸

fc_eh_timed_out — FC Transport I/O timeout intercept handler, bestie. This one is from the Kernel API Manual, and yes, she is very specific about her job.

---

✨ SYNOPSIS ✨

enum scsi_timeout_action fc_eh_timed_out (struct scsi_cmnd *scmd );

---

💅 ARGUMENTS 💅

• scmd — the SCSI command that timed out. That’s the whole argument, and honestly she ate.

---

🦋 DESCRIPTION 🦋

Okay so this routine protects against error handlers getting invoked while an rport is in a blocked state — usually because connectivity got temporarily lost. It’s giving “don’t panic, the rport is literally unavailable rn.”

If the error handlers are allowed to proceed, requests to abort i/o, reset the target, etc. will likely fail, because there is no way to communicate with the device to perform the requested function. Those failures may result in the midlayer taking the device offline, requiring manual intervention to restore operation. Not cute. We don’t want that.

This routine, called whenever an i/o times out, validates the state of the underlying rport. If the rport is blocked, it returns EH_RESET_TIMER, which will continue to reschedule the timeout. Eventually, either the device will return, or devloss_tmo will fire, and when the timeout then fires, it will be handled normally. If the rport is not blocked, normal error handling continues. Slay, predictable behavior.

---

🎀 NOTES 🎀

🚨 This routine assumes no locks are held on entry. Respect the vibe check, please.

---

👑 SEE ALSO 👑

Kernel file ./drivers/scsi/scsi_transport_fc.c, plus the whole friend group:

• 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_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_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)

---

Byeee from ./drivers/scsi, dated October 2026 — still your girl fc_eh_timed_out(9) 💅✨🫶