octep_ctrl_n..._link_status(9)

💅 octep_ctrl_net_set_link_status — kernel API manual, bestie edition 🎀

okay so real quick before we dive in: this is a page from the Kernel API Manual (yes, the manual manual, section 9, the fancy kernel one) and we're talking about octep_ctrl_net_set_link_status. It's giving "I talk to firmware so you don't have to" energy and honestly? iconic. 🦋

---

✨ NAME ✨

octep_ctrl_net_set_link_status — set the link status in the firmware. that's it. that's the whole job. 💅

---

✨ SYNOPSIS ✨

int octep_ctrl_net_set_link_status (struct octep_device *oct , int vfid
, bool up , bool wait_for_response );

it returns an int, it takes four things, and it's coming for your link status. periodt. 🔥

---

✨ ARGUMENTS ✨

• oct — a non-null pointer to a struct octep_device. non-null, bestie. do NOT come in here with a NULL and expect a good time 😭
• vfid — the index of the virtual function. it's an int. it's a whole number. it's the vf identity. slay 🫶
• up — a bool status. boolean. yes/no. up or not-up. the vibe check in binary 💖
• wait_for_response — poll for a response. literally just "do we hang around waiting to hear back." ngl this one's doing main character energy in the argument list 🌸

---

✨ DESCRIPTION ✨

so the function does its thing and here's the return situation, no cap:

return value: 0 on success, -errno on failure

that's the whole deal. 0 means we ate and left no crumbs ✨. -errno means something went sideways and the error code is coming to tell you about it. 🙈

---

✨ SEE ALSO ✨

okay this list is LONG and honestly it's giving "family reunion" but every single one of these is invited so let's go 💀

• the kernel file ./drivers/net/ethernet/marvell/octeon_ep/octep_ctrl_net.h — yes that's the actual path, go look at it, iykyk 📁
• octep_ctrl_net_init(9)
• octep_ctrl_net_get_link_status(9)
• octep_ctrl_net_set_rx_state(9)
• octep_ctrl_net_get_mac_addr(9)
• octep_ctrl_net_set_mac_addr(9)
• octep_ctrl_net_get_mtu(9)
• octep_ctrl_net_set_mtu(9)
• octep_ctrl_net_get_if_stats(9)
• octep_ctrl_net_get_link_info(9)
• octep_ctrl_net_set_link_info(9)
• octep_ctrl_net_recv_fw_messages(9)
• octep_ctrl_net_get_info(9)
• octep_ctrl_net_dev_remove(9)
• octep_ctrl_net_set_offloads(9)
• octep_ctrl_net_uninit(9)

every single one accounted for. nobody left on read. 👑

---

⭐ friendly reminder that oct really does need to be a non-null pointer to a struct octep_device and the manual says it plainly — that's the one non-negotiable in this whole page. 🧚

---

and that's the page, bestie!! 🎀 source path was ./drivers/net/ethernet/marvell..., dated October 2026, and the page title is octep_ctrl_n..._link_status(9) in case you were wondering — mwah, go set some link status, ily 💜✨