TC-TCINDEX(8)

📦
version 6.1.0 · 2 versions
, in debian bookworm, ubuntu noble

💖 TC-TCINDEX — the traffic control index filter, bestie edition 💖

okay so like. this is a page from the Linux manual set, and the manual name is tc-tcindex, section 8 (that's the admin-commands girlies section, iykyk). sit down, grab a strawberry, we're matching packets 💅

✨ NAME ✨

tcindex — the traffic control index filter 🎀

🦋 SYNOPSIS 🦋

tc filter ... tcindex [ hash SIZE ] [ mask MASK ] [ shift SHIFT ] [
        pass_on | fall_through ] [ classid CLASSID ] [ action
        ACTION_SPEC ]

that's it. that's the whole summoning ritual ✨

🌸 DESCRIPTION 🌸

this filter lets you match packets based on their tcindex field value. and what even is that, you ask? it's literally the combo of the DSCP and ECN fields exactly as they show up in IPv4 and IPv6 headers. no cap. it's giving "the header fields said let me introduce myself" 💖

👑 OPTIONS 👑 (the full menu, no skips, periodt)

  • action ACTION_SPEC — slaps an action from the generic actions framework onto any packet that matches. your matching packets get a lil makeover 🫶
  • classid CLASSID — pushes matching packets into the class identified by CLASSID. like a bouncer but the good kind, walking your packets straight to their section of the club 💅
  • hash SIZE — the hash table size, in entries. defaults to 64. yes babes, sixty-four. iconic number.
  • mask MASK — an optional bitmask that gets binary-ANDed with the packet's tcindex field before it's used. bit math said "let me filter the vibe first" ✨
  • shift SHIFT — how many bits to right-shift the packet's tcindex value before use. and listen: if a mask has been set, the masking happens BEFORE the shifting. order matters, bestie, don't get it twisted 🙈
  • pass_on — if this flag is set, then failing to find a class for the resulting ID makes the filter fail and leads to the next filter being consulted. it's giving "not my problem, next up" 😭
  • fall_through — the exact opposite of pass_on, and also the default. the filter will classify the packet even if there's no class present for the resulting class ID. it just... does it. main character energy, no class needed 👑

🌈 SEE ALSO 🌈

  • tc(8) — go read it, it's the mothership 🧚
💀 real talk though: pass_on and fall_through are opposites and only one of them is the default, so if you're out here guessing, the vibes will not save you. check the flag. every time.

that's the whole page, bestie — every option, every default, every field, all accounted for. no facts were harmed in the making of this rewrite, only prose got a glow-up 💖

🌸 this page came from iproute2, dated 21 Oct 2015, and it's titled Traffic control index filter(8). mwah. go configure something. 🎀✨

📦 where this page comes from