netdev_cap_txqueue(9)
π netdev_cap_txqueue(9) β from the Kernel API Manual β¨
okay bestie, welcome to the kernel API manual, this is the page for netdev_cap_txqueue(9) and honestly it's a little baddie with one job. let's get into it π«Ά
πΈ NAME πΈ
netdev_cap_txqueue β check if selected tx queue exceeds device queues π
like literally it's the vibe check for your queue index, no cap.
β SYNOPSIS β
u16 netdev_cap_txqueue (struct net_device *dev , u16 queue_index );
look at her. two arguments. returning a u16. main character energy fr π₯
π ARGUMENTS π
devβ the network device π₯οΈ like the actual NIC situation we're looking at.queue_indexβ the given tx queue index π« the number somebody handed you and was like "is this valid". we're about to find out.
π DESCRIPTION π
okay so here's the whole lore, and it's genuinely so simple:
- if the given tx queue index is >= the number of device tx queues, this function returns
0π - otherwise, it returns the originally passed tx queue index, untouched, unbothered, exactly as it came in π
that's it. that's the function. she checks, she clamps, she slays. no cap, no extra steps, no drama. β¨
π¦ SEE ALSO π¦
Kernel file ./include/linux/netdevice.h, plus a whole group chat of friends:
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)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_on(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)
iykyk, that's a whole friend group and they all ate π
and that's the page!! mwah π this one lives in ./include/linux, and it's dated October 2026, and yes the header up top really is netdev_cap_txqueue(9) β so go forth, clamp your queues, and remember: when in doubt, 0. periodt. πππ
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms