dpni_set_rx_tc_dist(9)

📦 version 7.3.1, in nixpkgs unstable

💅 dpni_set_rx_tc_dist(9) — the Kernel API Manual glow-up ✨

okay so first things first, bestie: this is a section 9 kernel API page, dpni_set_rx_tc_dist(9), and it's here to teach you how to set the Rx traffic class distribution configuration. that's the whole vibe. let's get into it 🎀

✨ SYNOPSIS ✨

int dpni_set_rx_tc_dist (struct fsl_mc_io *mc_io , u32 cmd_flags , u16
token , u8 tc_id , const struct dpni_rx_tc_dist_cfg *cfg );

look at that signature. it's giving function-that-returns-an-int. we love a return type that tells us something. 🫶

🌸 ARGUMENTS 🌸

  • mc_io — Pointer to MC portal's I/O object. this is your little doorway into the MC portal, she's iconic, keep her safe.
  • cmd_flags — Command flags; one or more of 'MC_CMD_FLAG_'. yes, one or more, stack 'em if you got 'em.
  • token — Token of DPNI object. that's your DPNI's little ID badge 💳
  • tc_id — Traffic class selection (0-7). so eight classes, zero through seven, no more no less, don't try to sneak an 8 in there 🙈
  • cfg — Traffic class distribution configuration. the whole point of the call, honestly. the main character of the argument list 👑

🦋 DESCRIPTION 🦋

so what does this bad boy do? it sets the Rx traffic class distribution configuration. that's it, that's the function. short and sweet, no cap.

⚠️ warning, and this is the important bit, bestie, do NOT skip it: if 'dist_mode != DPNI_DIST_MODE_NONE', call dpni_prepare_key_cfg first to prepare the key_cfg_iova parameter.

the way this is a whole two-step process and the manpage is just telling you the prerequisite in a warning block like it's no big deal 😭 literally call dpni_prepare_key_cfg FIRST. prepare the key config. then come back here. iykyk.

💀 RETURN 💀

...yeah. the RETURN section is just, like, empty. nothing. void. the page has a RETURN heading and then simply does not use it. not me refreshing for a documented return value 💀 i'm telling you what's on the page and what's on the page is silence.

🧚 SEE ALSO 🧚

the friend group. the whole crew. we are OBSESSED with how many of these there are:

  • Kernel file ./drivers/net/ethernet/freescale/dpaa2/dpni.c

and now the guest list, in order, and yes i'm keeping every single one because that's the rule 💖:

that's 56 siblings, bestie. 56. this function is never lonely, periodt. 🔥

🌸 and that's the page! source corner says the page lives with source ./drivers/net/ethernet/freesca... (yes it's truncated exactly like that, don't @ me, that's what it says 🙈) and it's dated October 2026, so she's from the future, very ahead of her time, we stan. go forth, call dpni_prepare_key_cfg first, and slay 💅✨🎀

📦 where this page comes from