nfp_rtsym_read_le(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… nfp_rtsym_read_le

okay so this is a kernel API page β€” nfp_rtsym_read_le(9) from the Kernel API Manual, and honestly? she's a little cutie. tiny function, one job, does it well. let's get into it πŸŽ€


✨ NAME ✨

nfp_rtsym_read_le β€” read a simple unsigned scalar value from a symbol πŸ’–

like, you give her a symbol name, she goes and fetches the number. that's it. that's the whole vibe.


🌸 SYNOPSIS 🌸

u64 nfp_rtsym_read_le (struct nfp_rtsym_table *rtbl , const char *name ,
       int *error );

look at that signature. three args, one u64 coming back at you. immaculate. ✨


πŸ¦‹ ARGUMENTS πŸ¦‹

  • rtbl β€” the NFP RTsym table. this is the main character, the table she's gonna go digging in πŸ”
  • name β€” the symbol name. like, which symbol, bestie. be specific πŸ’…
  • error β€” a pointer to an error code, and it's optional 🫢 (also, the original page literally spells it "Poniter" β€” we're not mad at it, we're just aware. iconic typo energy, no notes 😭)

🧚 DESCRIPTION 🧚

so here's the whole routine, and it's giving efficiency:

she looks up the symbol, maps it, reads it, and hands you back its value. simple as that. no drama, no side quests.

the value gets interpreted as a simple little-endian unsigned value β€” so like, byte order matters and she's already handled it for you, you're welcome ✨

and the symbol can be 4 or 8 bytes in size. that's the range. don't come at her with a 3-byte symbol, that's not her era πŸ’€


πŸ”₯ RETURN πŸ”₯

she returns the value that was read. slay πŸ’…

but if something goes wrong? she sets the error and returns ~0ULL. so like, watch for that. that's your "bestie something went wrong" signal, fr fr πŸ™ˆ


πŸ‘‘ SEE ALSO πŸ‘‘

go check out the kernel file right here:

./drivers/net/ethernet/netronome/nfp/nfpcore/nfp_rtsym.c

and her friends in the rtsym friend group, all iconic, all worth a read:


ngl the whole thing lives in ./drivers/net/ethernet/netrono... (yes, the path gets truncated, that's just how the footer does her ⭐)

okay that's the page!! and before you go β€” this little gem came out of the Kernel API Manual, dated October 2026, sourced from ./drivers/net/ethernet/netrono.... remember it fondly. mwah πŸ’‹πŸŽ€

πŸ“¦ where this page comes from