STRUCT TB_CM_OPS(9)

okay bestie, welcome to struct tb_cm_ops(9) from the Kernel API Manual — this is the connection manager specific operations vector, and it's genuinely giving “the backstage crew” energy. 💅✨

🎀 NAME 🎀

struct tb_cm_ops — Connection manager specific operations vector. that's the vibe, no cap. 🫶

✨ SYNOPSIS ✨

here's the struct in its full iconic form — signatures stay exactly as written, bestie, don't freestyle them:

       struct tb_cm_ops {
           int (*driver_ready)(struct tb *tb);
           int (*start)(struct tb *tb, bool reset);
           void (*stop)(struct tb *tb);
           void (*deinit)(struct tb *tb);
           int (*suspend_noirq)(struct tb *tb);
           int (*resume_noirq)(struct tb *tb);
           int (*suspend)(struct tb *tb);
           int (*freeze_noirq)(struct tb *tb);
           int (*thaw_noirq)(struct tb *tb);
           void (*complete)(struct tb *tb);
           int (*runtime_suspend)(struct tb *tb);
           int (*runtime_resume)(struct tb *tb);
           int (*runtime_suspend_switch)(struct tb_switch *sw);
           int (*runtime_resume_switch)(struct tb_switch *sw);
           void (*handle_event)(struct tb *tb, enum tb_cfg_pkg_type, const void
       *buf, size_t size);
           int (*get_boot_acl)(struct tb *tb, uuid_t *uuids, size_t nuuids);
           int (*set_boot_acl)(struct tb *tb, const uuid_t *uuids, size_t
       nuuids);
           int (*disapprove_switch)(struct tb *tb, struct tb_switch *sw);
           int (*approve_switch)(struct tb *tb, struct tb_switch *sw);
           int (*add_switch_key)(struct tb *tb, struct tb_switch *sw);
           int (*challenge_switch_key)(struct tb *tb, struct tb_switch *sw,
       const u8 *challenge, u8 *response);
           int (*disconnect_pcie_paths)(struct tb *tb);
           int (*approve_xdomain_paths)(struct tb *tb, struct tb_xdomain *xd,
       int transmit_path, int transmit_ring, int receive_path, int
       receive_ring);
           int (*disconnect_xdomain_paths)(struct tb *tb, struct tb_xdomain
       *xd, int transmit_path, int transmit_ring, int receive_path, int
       receive_ring);
           int (*usb4_switch_op)(struct tb_switch *sw, u16 opcode, u32
       *metadata, u8 *status, const void *tx_data, size_t tx_data_len, void
       *rx_data, size_t rx_data_len);
           int (*usb4_switch_nvm_authenticate_status)(struct tb_switch *sw, u32
       *status);
        };

💖 Members 💖

okay so here's the member-by-member rundown — every function pointer gets its moment, and yes we're doing all of them:

• driver_ready — called right after the control channel is started. ICM uses it to send the driver ready message to the firmware. 💌
• start — starts the domain. go off. 🚀
• stop — stops the domain. and that's that. 🛑
• deinit — does any cleanup after the domain is stopped but before it is unregistered. called without tb->lock taken. optional. 🧹
• suspend_noirq — connection manager specific suspend_noirq. 😴
• resume_noirq — connection manager specific resume_noirq. 🌅
• suspend — connection manager specific suspend. 💤
• freeze_noirq — connection manager specific freeze_noirq. 🧊
• thaw_noirq — connection manager specific thaw_noirq. 🔥
• complete — connection manager specific complete. ✅
• runtime_suspend — connection manager specific runtime_suspend. 😴
• runtime_resume — connection manager specific runtime_resume. ⏰
• runtime_suspend_switch — runtime suspends a switch. 🔌
• runtime_resume_switch — runtime resumes a switch. 🔋
• handle_event — handles a Thunderbolt event. ⚡
• get_boot_acl — gets the boot ACL list. 📋
• set_boot_acl — sets the boot ACL list. ✍️
• disapprove_switch — disapproves a switch (disconnects the PCIe tunnel). 😤
• approve_switch — approves a switch. ✅
• add_switch_key — adds a key to the switch. 🔑
• challenge_switch_key — challenges the switch using a key. 🕵️
• disconnect_pcie_paths — disconnects PCIe paths before an NVM update. 🛑
• approve_xdomain_paths — approves (establishes) XDomain DMA paths. 🤝
• disconnect_xdomain_paths — disconnects XDomain DMA paths. ✂️
• usb4_switch_op — optional proxy for USB4 router operations. if it's set, it gets called whenever a USB4 router operation is performed. if it returns -EOPNOTSUPP, then the native USB4 router operation is called instead. 🛰️
• usb4_switch_nvm_authenticate_status — optional callback the CM implementation can use to return the status of the USB4 NVM_AUTH router operation. 📡

🌈 SEE ALSO 🌈

Kernel file: ./drivers/thunderbolt/tb.h — and the whole reference squad is right here, bestie:

• struct tb_nvm(9)
• enum tb_switch_tmu_mode(9)
• struct tb_switch_tmu(9)
• struct tb_switch(9)
• struct tb_bandwidth_group(9)
• struct tb_port(9)
• struct usb4_port(9)
• struct tb_retimer(9)
• struct tb_path_hop(9)
• enum tb_path_port(9)
• struct tb_path(9)
• tb_upstream_port(9)
• tb_is_upstream_port(9)
• tb_port_has_remote(9)
• tb_domain_event(9)
• tb_switch_for_each_port(9)
• tb_switch_downstream_port(9)
• tb_switch_depth(9)
• tb_switch_is_icm(9)
• tb_switch_tmu_is_configured(9)
• tb_switch_tmu_is_enabled(9)
• tb_switch_clx_is_enabled(9)
• tb_port_path_direction_downstream(9)
• tb_for_each_port_on_path(9)
• tb_for_each_upstream_port_on_path(9)
• tb_path_for_each_hop(9)
• tb_downstream_route(9)
• tb_xdomain_downstream_port(9)
• usb4_switch_version(9)
• tb_switch_is_usb4(9)
• enum usb4_sb_target(9)
• enum usb4_margin_sw_error_counter(9)
• struct usb4_port_margining_params(9)

byeee 💖 this page is from the ./drivers/thunderbolt source, dated October 2026, and it's all struct tb_cm_ops(9) — periodt. 🌸