fm10k_mbx_pull_head(9)

📦 version 7.3.1, in nixpkgs unstable

💅 fm10k_mbx_pull_head(9) — bestie's guide to the Kernel API Manual 🎀

okay so picture this: it's late, you're deep in the fm10k driver, and somebody hands you a mailbox head index and expects you to do something with it. bestie, that's literally this function. welcome to the group chat. ✨

🌸 SYNOPSIS 🌸

void fm10k_mbx_pull_head (struct fm10k_hw *hw , struct fm10k_mbx_info
*mbx , u16 head );

no cap, that's the whole signature. three args, zero return value, all vibes. 🫶

🦋 ARGUMENTS 🦋

  • hw — pointer to hardware structure. the actual silicon situation. main character of the silicon situation, honestly 👑
  • mbx — pointer to mailbox. the lil' mailbox we're working with 💌
  • head — acknowledgement number last received. yes, last received — that's the remote side's head, not yours. don't mix 'em up 🙈

💖 DESCRIPTION 💖

so what does she actually do? glad you asked. 💅

This function will push the tail index forward based on the remote head index. like, the remote told us where its head is at, and we scoot our tail up to match. it's giving "meet them where they're at," honestly.

Then it pulls up to mbmem_len DWORDs off of the head of the FIFO, and places them in the MBMEM registers associated with the mailbox. up to mbmem_len — so, y'know, however many fit. ⭐

ngl this is the whole function. no hidden lore, no secret options, no environment variables, no exit statuses. it's just: move the tail, scoop the DWORDs, drop 'em in MBMEM. periodt. 🎀

💜 SEE ALSO 💜

the friend group is large, bestie. like, alarmingly large. but every single one of them matters, so here we go, all of them, fr fr:

first up, the FIFO girlies:

then the mailbox index math crew (very ate, very precise):

the copy/enqueue squad:

crc check icons 🔥:

readiness + completeness besties:

header-creation royalty 👑:

the work/reset/size management committee:

and the entire process pipeline, which is a whole vibe:

and last but absolutely not least, the sm_mbx extended universe 🌈:

and obviously, the source file itself, the origin story:

./drivers/net/ethernet/intel/fm10k/fm10k_mbx.c

🧚 sign-off 🧚

that's the whole page, bestie — brought to you by the source at ./drivers/net/ethernet/intel/f..., dated October 2026, and filed under fm10k_mbx_pull_head(9). go forth and pull that head. slay. 💅✨🍓

📦 where this page comes from