batadv_v_forward_penalty(9)

📦 version 7.3.1, in nixpkgs unstable

okay bestie, welcome to the batadv_v_forward_penalty(9) page from the Kernel API Manual ✨ this one is literally about applying a penalty to the throughput metric forwarded with B.A.T.M.A.N. V OGMs 🦋

✨ NAME ✨

batadv_v_forward_penalty — apply a penalty to the throughput metric forwarded with B.A.T.M.A.N. V OGMs 💅

🌸 SYNOPSIS 🌸

u32 batadv_v_forward_penalty (struct batadv_priv *bat_priv , struct
       batadv_hard_iface *if_incoming , struct batadv_hard_iface *if_outgoing ,
       u32 throughput );

🎀 ARGUMENTS 🎀

  • bat_priv — the bat priv with all the mesh interface information 👑
  • if_incoming — the interface where the OGM has been received 📥
  • if_outgoing — the interface where the OGM has to be forwarded to 📤
  • throughput — the current throughput 🍓

💅 DESCRIPTION 💅

okay so this function applies a penalty on the current throughput metric value based on the characteristic of the interface where the OGM has been received. no cap, that's the vibe check 🫶

Initially the per hardif hop penalty is applied to the throughput. After that the return value is then computed as follows:

  • throughput * 50% — if the incoming and outgoing interface are the same WiFi interface and the throughput is above 1MBit/s 🔥
  • throughput — if the outgoing interface is the default interface (i.e. this OGM is processed for the internal table and not forwarded) 🧚
  • throughput * node hop penalty — otherwise 💜

🔥 RETURN 🔥

the penalised throughput metric 😭👑

🦋 SEE ALSO 🦋

Kernel file ./net/batman-adv/bat_v_ogm.c 🌈

and that's the whole page, bestie 💖 this iconic lil manual comes from source ./net/batman-adv, dated October 2026, and it's literally the batadv_v_forward_penalty(9) page 🎀✨

📦 where this page comes from