ice_get_link_status(9)

💅 ice_get_link_status(9) 💅

okay bestie, welcome to the Kernel API Manual page for ice_get_link_status — the lil link-status vibe check for the ice driver. no cap, it's giving "is the HW network link up or not" and it's here to tell you. 🫶

---

🌸 NAME 🌸

ice_get_link_status — get status of the HW network link ✨

✨ SYNOPSIS ✨

int ice_get_link_status (struct ice_port_info *pi , bool *link_up );

🎀 ARGUMENTS 🎀

• pi — port information structure. that's the port info bestie, it's literally a struct ice_port_info *.
• link_up — pointer to bool (true/false = linkup/linkdown). yes, it points at a bool and the bool is doing the whole up/down storyline. 💖

🦋 DESCRIPTION 🦋

so the variable link_up is true if the link is up, and false if the link is down. simple, iconic, slay, no notes. ✨

but listen: the variable link_up is invalid if status is non zero. like, do not trust it, do not pass go, do not collect $200. 💀

as a result of this call, link status reporting becomes enabled. periodt. 💅

bestie warning: link_up is invalid when status is non zero — that's the original tea, fr fr.

🌈 SEE ALSO 🌈

the kernel file is ./drivers/net/ethernet/intel/ice/ice_common.c — yes, that exact path. and the whole ice cinematic universe pulls up below, every single one, no cap:

Kernel file ./drivers/net/ethernet/intel/ice/ice_common.c
ice_dump_phy_type(9), ice_set_mac_type(9), ice_is_generic_mac(9),
ice_clear_pf_cfg(9), ice_aq_manage_mac_read(9), ice_aq_get_phy_caps(9),
ice_aq_get_link_topo_handle(9), ice_aq_get_netlist_node(9),
ice_find_netlist_node(9), ice_is_media_cage_present(9),
ice_get_media_type(9), ice_get_link_status_datalen(9),
ice_aq_get_link_info(9), ice_fill_tx_timer_and_fc_thresh(9),
ice_aq_set_mac_cfg(9), ice_init_fltr_mgmt_struct(9),
ice_cleanup_fltr_mgmt_struct(9), ice_get_itr_intrl_gran(9),
ice_wait_fw_load(9), ice_init_hw(9), ice_deinit_hw(9),
ice_check_reset(9), ice_pf_reset(9), ice_reset(9),
ice_copy_rxq_ctx_to_hw(9), ice_copy_rxq_ctx_from_hw(9),
ice_pack_rxq_ctx(9), ice_unpack_rxq_ctx(9), ice_write_rxq_ctx(9),
ice_read_rxq_ctx(9), ice_pack_txq_ctx(9), ice_pack_txq_ctx_full(9),
ice_unpack_txq_ctx_full(9), ice_copy_txq_ctx_from_hw(9),
ice_copy_txq_ctx_to_hw(9), ice_read_txq_ctx(9), ice_write_txq_ctx(9),
ice_pack_txtime_ctx(9), ice_sbq_send_cmd(9), ice_sbq_rw_reg(9),
ice_should_retry_sq_send_cmd(9), ice_sq_send_cmd_retry(9),
ice_aq_send_cmd(9), ice_aq_get_fw_ver(9), ice_aq_send_driver_ver(9),
ice_aq_q_shutdown(9), ice_aq_req_res(9), ice_aq_release_res(9),
ice_acquire_res(9), ice_release_res(9), ice_aq_alloc_free_res(9),
ice_alloc_hw_res(9), ice_free_hw_res(9), ice_get_num_per_func(9),
ice_parse_common_caps(9), ice_recalc_port_limited_caps(9),
ice_parse_vf_func_caps(9), ice_parse_vsi_func_caps(9),
ice_parse_1588_func_caps(9), ice_parse_fdir_func_caps(9),
ice_parse_func_caps(9), ice_func_id_to_logical_id(9),
ice_parse_valid_functions_cap(9), ice_parse_vf_dev_caps(9),
ice_parse_vsi_dev_caps(9), ice_parse_1588_dev_caps(9),
ice_parse_fdir_dev_caps(9), ice_parse_sensor_reading_cap(9),
ice_parse_nac_topo_dev_caps(9), ice_parse_dev_caps(9),
ice_is_phy_rclk_in_netlist(9), ice_is_clock_mux_in_netlist(9),
ice_is_cgu_in_netlist(9), ice_is_gps_in_netlist(9), ice_aq_list_caps(9),
ice_discover_dev_caps(9), ice_discover_func_caps(9),
ice_set_safe_mode_caps(9), ice_get_caps(9), ice_aq_manage_mac_write(9),
ice_aq_clear_pxe_mode(9), ice_clear_pxe_mode(9),
ice_aq_set_port_params(9), ice_is_100m_speed_supported(9),
ice_get_link_speed_based_on_phy_type(9), ice_update_phy_type(9),
ice_aq_set_phy_cfg(9), ice_update_link_info(9),
ice_aq_get_phy_equalization(9), ice_aq_get_fec_stats(9),
ice_cache_phy_user_req(9), ice_caps_to_fc_mode(9),
ice_caps_to_fec_mode(9), ice_cfg_phy_fc(9), ice_set_fc(9),
ice_phy_caps_equals_cfg(9), ice_copy_phy_caps_to_cfg(9),
ice_cfg_phy_fec(9), ice_aq_set_link_restart_an(9),
ice_aq_set_event_mask(9), ice_aq_set_mac_loopback(9),
ice_aq_set_port_id_led(9), ice_aq_get_port_options(9),
ice_aq_set_port_option(9), ice_get_phy_lane_number(9),
ice_aq_sff_eeprom(9), __ice_aq_get_set_rss_lut(9),
ice_aq_get_rss_lut(9), ice_aq_set_rss_lut(9),
__ice_aq_get_set_rss_key(9), ice_aq_get_rss_key(9),
ice_aq_set_rss_key(9), ice_aq_add_lan_txq(9), ice_aq_dis_lan_txq(9),
ice_aq_cfg_lan_txq(9), ice_aq_add_rdma_qsets(9), ice_aq_set_txtimeq(9),
ice_get_lan_q_ctx(9), ice_ena_vsi_txq(9), ice_dis_vsi_txq(9),
ice_cfg_vsi_qs(9), ice_cfg_vsi_lan(9), ice_cfg_vsi_rdma(9),
ice_ena_vsi_rdma_qset(9), ice_dis_vsi_rdma_qset(9),
ice_aq_get_cgu_input_pin_measure(9), ice_aq_get_cgu_abilities(9),
ice_aq_set_input_pin_cfg(9), ice_aq_get_input_pin_cfg(9),
ice_aq_set_output_pin_cfg(9), ice_aq_get_output_pin_cfg(9),
ice_aq_get_cgu_dpll_status(9), ice_aq_set_cgu_dpll_config(9),
ice_aq_set_cgu_ref_prio(9), ice_aq_get_cgu_ref_prio(9),
ice_aq_get_cgu_info(9), ice_aq_set_phy_rec_clk_out(9),
ice_aq_get_phy_rec_clk_out(9), ice_aq_get_sensor_reading(9),
ice_replay_pre_init(9), ice_replay_vsi(9), ice_replay_post(9),
ice_stat_update40(9), ice_stat_update32(9), ice_sched_query_elem(9),
ice_aq_read_i2c(9), ice_aq_write_i2c(9), ice_get_pca9575_handle(9),
ice_read_pca9575_reg(9), ice_aq_set_gpio(9), ice_aq_get_gpio(9),
ice_is_fw_api_min_ver(9), ice_fw_supports_link_override(9),
ice_get_link_default_override(9), ice_is_phy_caps_an_enabled(9),
ice_is_fw_health_report_supported(9), ice_aq_set_health_status_cfg(9),
ice_aq_set_lldp_mib(9), ice_fw_supports_lldp_fltr_ctrl(9),
ice_lldp_fltr_add_remove(9), ice_lldp_execute_pending_mib(9),
ice_fw_supports_report_dflt_cfg(9), ice_get_link_speed(9),
ice_get_dest_cgu(9), ice_read_cgu_reg(9), ice_write_cgu_reg(9)

---

and that's the whole page bestie. this lil manual page is from ./drivers/net/ethernet/intel/ice, dated October 2026, and it's all about ice_get_link_status(9) — byeee, go check that link status, mwah 🫶💖