fcoe_hostlist_lookup_port(9)

💅 fcoe_hostlist_lookup_port(9) — a Kernel API Manual moment 🎀

okay so bestie, welcome to the glow-up edition of fcoe_hostlist_lookup_port(9), straight out of the Kernel API Manual. this one's short and sweet and honestly it's giving "tiny function, big responsibilities" ✨

---

🌸 NAME 🌸

fcoe_hostlist_lookup_port — find the FCoE interface associated with a net device. that's it. that's the whole vibe check. 🦋

---

✨ SYNOPSIS ✨

struct fcoe_interface * fcoe_hostlist_lookup_port (const struct net_device *netdev );

literally just hand it a net device and it goes looking. main character lookup energy 👑

---

🎀 ARGUMENTS 🎀

• netdev — the net device used as a key 🔑 like, you're basically telling it "hey, find me the FCoE interface that matches this one." it's the search term, bestie, no cap.

---

💖 DESCRIPTION 💖

okay so the important part, and i need you to listen, because this is a locking situation and we do not play about locking:

Locking: must be called with the RNL mutex held. 🔒

that's the whole description. yes, really. it's a whole paragraph of "hold the lock first." consider this your friendly reminder that skipping the lock is not the move, it's giving undefined chaos 😭

---

🦋 RETURN 🦋

it returns either NULL or the FCoE interface — so like, you get your interface back if it found one, and NULL if it didn't. simple as that 🫶

---

🔥 SEE ALSO 🔥

all the siblings and cousins, gathered here for you, keeping the exact same names because we do not mess with function signatures in this house 💅

Kernel file ./drivers/scsi/fcoe/fcoe.c — and then, in order:

fcoe_interface_setup(9), fcoe_interface_create(9), fcoe_interface_remove(9), fcoe_interface_cleanup(9), fcoe_fip_recv(9), fcoe_fip_vlan_recv(9), fcoe_port_send(9), fcoe_fip_send(9), fcoe_update_src_mac(9), fcoe_get_src_mac(9), fcoe_lport_config(9), fcoe_netdev_config(9), fcoe_shost_config(9), fcoe_fdmi_info(9), fcoe_oem_match(9), fcoe_em_config(9), fcoe_if_destroy(9), fcoe_ddp_setup(9), fcoe_ddp_target(9), fcoe_ddp_done(9), fcoe_if_create(9), fcoe_if_init(9), fcoe_if_exit(9), fcoe_rcv(9), fcoe_alloc_paged_crc_eof(9), fcoe_xmit(9), fcoe_filter_frames(9), fcoe_recv_frame(9), fcoe_receive_work(9), fcoe_dev_setup(9), fcoe_dev_cleanup(9), fcoe_device_notification(9), fcoe_disable(9), fcoe_enable(9), fcoe_ctlr_enabled(9), fcoe_ctlr_mode(9), fcoe_destroy(9), fcoe_destroy_work(9), fcoe_match(9), fcoe_dcb_create(9), _fcoe_create(9), fcoe_create(9), fcoe_ctlr_alloc(9), fcoe_link_ok(9), fcoe_percpu_clean(9), fcoe_reset(9), fcoe_hostlist_lookup(9), fcoe_hostlist_add(9), fcoe_hostlist_del(9), fcoe_init(9), fcoe_exit(9), fcoe_flogi_resp(9), fcoe_logo_resp(9), fcoe_vport_create(9), fcoe_vport_destroy(9), fcoe_vport_remove(9), fcoe_vport_disable(9), fcoe_set_vport_symbolic_name(9), fcoe_set_port_id(9)

like, the whole friend group showed up. iconic. 🌈

---

and that's the page!! 🧚 this lil beauty lives in ./drivers/scsi/fcoe and the version/date stamp on it is October 2026 — so like, yeah, it's dated, but it's timeless 💜 mwah, go hold that RNL mutex, bestie 🍓💖