STRUCT FCOE_FCF(9)

💖 struct fcoe_fcf(9) — Fibre-Channel Forwarder 💖

okay so this is a page from the Kernel API Manual, section 9, and it's all about struct fcoe_fcf — the Fibre-Channel Forwarder. bestie, get comfy, we're going in 🫶

---

✨ NAME ✨

struct fcoe_fcf — Fibre-Channel Forwarder. yes that's the whole name, she's concise, she's iconic 👑

---

🌸 SYNOPSIS 🌸

struct fcoe_fcf {
    struct list_head list;
    struct work_struct event_work;
    struct fcoe_ctlr *fip;
    struct fcoe_fcf_device *fcf_dev;
    unsigned long time;
    u64 switch_name;
    u64 fabric_name;
    u32 fc_map;
    u16 vfid;
    u8 fcf_mac[ETH_ALEN];
    u8 fcoe_mac[ETH_ALEN];
    u8 pri;
    u8 flogi_sent;
    u16 flags;
    u32 fka_period;
    u8 fd_flags:1;
 };

look at her. all those fields. main character energy fr fr 💅 (and yes, fd_flags really is a 1-bit bitfield, she's tiny but fierce 🎀)

---

🦋 Members 🦋

• list — list linkage. she's linked up, that's her whole job 💫
• event_work — Work for FC Transport actions queue ⚙️
• fip — The controller that the FCF was discovered on. iykyk, this is where she was found 🕵️‍♀️
• fcf_dev — The associated fcoe_fcf_device instance 🫶
• time — system time (jiffies) when an advertisement was last received ⏰ ngl this is literally just a timestamp in jiffies, no cap
• switch_name — WWN of switch from advertisement 🔥
• fabric_name — WWN of fabric from advertisement 🌈
• fc_map — FC_MAP value from advertisement 🗺️
• vfid — virtual fabric ID 👑
• fcf_mac — Ethernet address of the FCF for FIP traffic 📬
• fcoe_mac — Ethernet address of the FCF for FCoE traffic 📨 (yes bestie, there are TWO macs, don't mix them up 😭)
• pri — selection priority, smaller values are better ⭐ (so like, be small, be powerful)
• flogi_sent — current FLOGI sent to this FCF 📤
• flags — flags received from advertisement 🚩
• fka_period — keep-alive period, in jiffies 💓 (again: jiffies, not seconds, don't come for me)
• fd_flags — no need for FKA from ENode 🙈

---

🌼 Description 🌼

A Fibre-Channel Forwarder (FCF) is the entity on the Ethernet that passes FCoE frames on to an FC fabric. that's the whole vibe — she's the middlewoman, the connector, the one who gets your frames where they need to go 🚀

This structure represents one FCF from which advertisements have been received. one FCF, one struct, periodt 💜

When looking up an FCF, switch_name, fabric_name, fc_map, vfid, and fcf_mac together form the lookup key. so like — all five of those, together, no skipping, that's the combo that unlocks her 🔑

---

💀 SEE ALSO 💀

• Kernel file ./include/scsi/libfcoe.h
• enum fip_state(9)
• struct fcoe_ctlr(9)
• fcoe_ctlr_priv(9)
• struct fcoe_rport(9)
• is_fip_mode(9)
• struct fcoe_percpu_s(9)
• struct fcoe_port(9)
• fcoe_get_netdev(9)
• struct fcoe_netdev_mapping(9)

go read those too bestie, the whole friend group is a slay 🌸✨

---

ngl, everything here lives in ./include/scsi and this page is dated October 2026, from the Kernel API Manual, struct fcoe_fcf(9) — mwah, bye, go read your headers 💋💖