fc_remote_port_rolechg(9)

✨ fc_remote_port_rolechg 💅

okay so bestie, welcome to the glow-up era of fc_remote_port_rolechg — this is a Kernel API Manual moment and honestly? iconic. it's giving "the FC transport needs a heads-up" energy and we're gonna walk through it together, no cap. 🦋

---

🌸 NAME 🌸

fc_remote_port_rolechg — notifies the fc transport that the roles on a remote may have changed. fr fr that's the whole vibe.

---

🎀 SYNOPSIS 🎀

void fc_remote_port_rolechg (struct fc_rport *rport , u32 roles );

like, that's the signature, don't come for me about the spacing, it's verbatim and we respect it 💖

---

💜 ARGUMENTS 💜

• rport — the remote port that changed. the main character of this whole situation, lowkey.
• roles — new roles for this port. the fresh fit it's trying on ✨

---

👑 DESCRIPTION 👑

okay so here's the tea, bestie 🍓 — the LLDD calls this routine to notify the transport that the roles on a remote port may have changed. like, "hey girl, things might be different now" energy.

the largest effect of this? if a port now becomes a FCP Target, it must be allocated a scsi target id. literally must. no skipping that step, periodt.

and if the port is no longer a FCP target? any scsi target id value assigned to it will persist in case the role changes back to include FCP Target. so it's not gone forever, it's just on pause, iykyk 🫶

no changes in the scsi midlayer will be invoked if the role changes (in the expectation that the role will be resumed). if it doesn't? normal error processing will take place. so like, the system's got a backup plan, we love that for it 💀

⚠️ warning bestie: should not be called from interrupt context. do not do it. not the vibe. 🙈

---

🌈 NOTES 🌈

this routine assumes no locks are held on entry. read that again. no locks. held. on entry. okay? okay. 💅

---

⭐ SEE ALSO ⭐

kernel file ./drivers/scsi/scsi_transport_fc.c — and honestly the whole friend group is here, say hi to everybody:

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

like, the whole squad showed up. ate and left no crumbs 👑🔥

---

aaaand that's the page bestie!! 🧚 this iconic little number lives in ./drivers/scsi and it's stamped October 2026 — mwah, go forth and notify the transport responsibly 💖🎀✨