STRUCT FCOE_CTLR(9)

📦 version 7.3.1, in nixpkgs unstable

✨ struct fcoe_ctlr(9) ✨

okay so bestie, welcome to the struct fcoe_ctlr page from the Kernel API Manual — this is the FCoE Controller situation and its FIP state, and it's giving main character energy in the FCoE world fr fr 💅

🎀 NAME 🎀

struct fcoe_ctlr — FCoE Controller and FIP state 🦋

✨ SYNOPSIS ✨

struct fcoe_ctlr {
    enum fip_state state;
    enum fip_mode mode;
    struct fc_lport *lp;
    struct fcoe_fcf *sel_fcf;
    struct list_head fcfs;
    struct fcoe_ctlr_device *cdev;
    u16 fcf_count;
    unsigned long sol_time;
    unsigned long sel_time;
    unsigned long port_ka_time;
    unsigned long ctlr_ka_time;
    struct timer_list timer;
    struct work_struct timer_work;
    struct work_struct recv_work;
    struct sk_buff_head fip_recv_list;
    struct sk_buff *flogi_req;
    struct rnd_state rnd_state;
    u32 port_id;
    u16 user_mfs;
    u16 flogi_oxid;
    u8 flogi_req_send;
    u8 flogi_count;
    bool map_dest;
    bool fip_resp;
    u8 spma;
    u8 probe_tries;
    u8 priority;
    u8 dest_addr[ETH_ALEN];
    u8 ctl_src_addr[ETH_ALEN];
    void (*send)(struct fcoe_ctlr *, struct sk_buff *);
    void (*update_mac)(struct fc_lport *, u8 *addr);
    u8 * (*get_src_addr)(struct fc_lport *);
    struct mutex ctlr_mutex;
    spinlock_t ctlr_lock;
 };

like, that's the whole struct, no cap 👑

💖 Members 💖

okay so here's the field-by-field breakdown, bestie — every single one, let's go 🏃‍♀️💨

  • state — internal FIP state for the network link and for FIP or non-FIP mode 🌸
  • mode — the mode that the LLD selected ✨
  • lp — fc_lport: the libfc local port 🦋
  • sel_fcf — the FCF that's currently selected, or NULL 🎀
  • fcfs — the list of discovered FCFs 💫
  • cdev — (optional!) pointer to the sysfs fcoe_ctlr_device 🫶
  • fcf_count — how many discovered FCF entries there are 🔢
  • sol_time — the time when a multicast solicitation was last sent ⏰
  • sel_time — the time after which to select an FCF ⌛
  • port_ka_time — time of the next port keep-alive 💓
  • ctlr_ka_time — time of the next controller keep-alive 💞
  • timer — the timer struct used for all the delayed events ⏲️
  • timer_work — work_struct for doing keep-alives and resets 🔄
  • recv_work — work_struct for receiving FIP frames 📥
  • fip_recv_list — the list of received FIP frames 📜
  • flogi_req — a clone of the FLOGI request that was sent 📤
  • rnd_state — state for the pseudo-random number generator 🎲
  • port_id — the proposed or selected local-port ID 🆔
  • user_mfs — the configured maximum FC frame size, including the FC header 📏
  • flogi_oxid — the exchange ID of the most recent fabric login 🔑
  • flogi_req_send — send of FLOGI requested 📨
  • flogi_count — the number of FLOGI attempts in AUTO mode 🔁
  • map_dest — use the FC_MAP mode for destination MAC addresses 🗺️
  • fip_resp — start the FIP VLAN discovery responder 📡
  • spma — supports the SPMA server-provided MACs mode 💳
  • probe_tries — the number of FC_IDs probed 🔍
  • priority — DCBx FCoE APP priority ⭐
  • dest_addr — MAC address of the selected FC forwarder 🎯
  • ctl_src_addr — the native MAC address of our local port 🏠
  • send — LLD-supplied function to handle sending FIP Ethernet frames 🚀
  • update_mac — LLD-supplied function to handle changes to MAC addresses 🔧
  • get_src_addr — LLD-supplied function to supply a source MAC address 📮
  • ctlr_mutex — lock protecting this structure 🔒
  • ctlr_lock — spinlock covering flogi_req 🌀

🌈 Description 🌈

so like, this structure is used by all FCoE drivers — every single one, periodt 👑 It's holding all the info that all the FCoE low-level drivers (LLDs) need, plus the internal state for FIP, plus the fields that get shared with the LLDs. it's literally the group chat everyone's in 💬🫶

👀 SEE ALSO 👀

go read those too, iykyk 💜

and that's the page, bestie!! 🎉 this lil gem lives in ./include/scsi, it's part of the Kernel API Manual, and it's dated October 2026 ⭐ you're so welcome, mwah 💋🌸🦋

📦 where this page comes from