netif_dormant_on(9)

💤 NAME 💤

okay so this is the Kernel API Manual page for netif_dormant_on(9), and the name section is literally: netif_dormant_on — mark device as dormant. 💤

✨ SYNOPSIS ✨

bestie, the signature is giving "small function, specific job":

void netif_dormant_on (struct net_device *dev );

🎀 ARGUMENTS 🎀

• dev — network device. that's the whole argument list, iconic behavior honestly 🫶

🦋 DESCRIPTION 🦋

okay so you call this and it marks the device as dormant, as per RFC2863. 💤

the dormant state means the relevant interface is not actually in a condition to pass packets (i.e., it is not 'up') but it is in a "pending" state, waiting for some external event. like it's not doing the thing yet, but it's absolutely not out of the group chat. 🦋

for "on-demand" interfaces, this new state identifies the situation where the interface is waiting for events to place it in the up state. that's the vibe: waiting room energy, but make it networking. ✨

🌈 SEE ALSO 🌈

bestie the SEE ALSO section is huge and I respect it: the Kernel file ./include/linux/netdevice.h, struct gro_node(9), napi_is_scheduled(9), napi_schedule(9), napi_schedule_irqoff(9), napi_complete_done(9), napi_synchronize(9), napi_if_scheduled_mark_missed(9), enum netdev_priv_flags(9), struct net_device(9), netdev_priv(9), netdev_from_priv(9), netif_napi_add(9), netif_napi_add_config(9), netif_napi_add_tx(9), __netif_napi_del(9), netif_napi_del(9), netif_start_queue(9), netif_wake_queue(9), netif_stop_queue(9), netif_queue_stopped(9), netdev_queue_set_dql_min_limit(9), netdev_txq_bql_enqueue_prefetchw(9), netdev_txq_bql_complete_prefetchw(9), netdev_tx_sent_queue(9), netdev_sent_queue(9), netdev_tx_completed_queue(9), netdev_completed_queue(9), netdev_tx_reset_subqueue(9), netdev_reset_queue(9), netdev_cap_txqueue(9), netif_running(9), netif_start_subqueue(9), netif_stop_subqueue(9), __netif_subqueue_stopped(9), netif_subqueue_stopped(9), netif_wake_subqueue(9), netif_attr_test_mask(9), netif_attr_test_online(9), netif_attrmask_next(9), netif_attrmask_next_and(9), netif_is_multiqueue(9), dev_hold(9), dev_put(9), linkwatch_sync_dev(9), netif_carrier_ok(9), netif_dormant_off(9), netif_dormant(9), netif_testing_on(9), netif_testing_off(9), netif_testing(9), netif_oper_up(9), netif_device_present(9), netif_tx_lock(9), __dev_uc_sync(9), __dev_uc_unsync(9), __dev_mc_sync(9), __dev_mc_unsync(9). 💅

xoxo bestie, this page came from ./include/linux and is dated October 2026 — mwah 💋✨