pcie_tph_get_cpu_st(9)

📦 version 7.3.1, in nixpkgs unstable

💅 pcie_tph_get_cpu_st — the kernel API manual, bestie edition ✨

okay so real talk: this is a page from the Kernel API Manual, and it's about pcie_tph_get_cpu_st. yes that's a mouthful, no you're not gonna say it out loud. let's get into it 🫶

✨ NAME ✨

pcie_tph_get_cpu_st — Retrieve Steering Tag for a target memory associated with a specific CPU

like, you give it a CPU, and it goes and fetches the Steering Tag for the memory that CPU is vibing with. that's the whole gig 💜

🎀 SYNOPSIS 🎀

int pcie_tph_get_cpu_st (struct pci_dev *pdev , enum tph_mem_type
mem_type , unsigned int cpu , u16 *tag );

that's the signature, character for character, no cap. four things go in, one int comes out 📥

🦋 ARGUMENTS 🦋

  • pdev — the PCI device. your main character device, obvi.
  • mem_type — the target memory type, which is either volatile or persistent RAM. pick your fighter 🌸
  • cpu — the associated CPU id. this is the CPU we're doing all this for 💫
  • tag — the Steering Tag to be returned. it's the output spot, bestie — that's where the good stuff lands 🎁

🌈 DESCRIPTION 🌈

Return the Steering Tag for a target memory that is associated with a specific CPU as indicated by cpu.

that's it. that's the function. it looks at the cpu you handed it, finds the target memory tied to that CPU, and hands you back the Steering Tag. lowkey elegant, highkey iconic 👑

🔥 RETURN 🔥

  • 0 if success 🎉
  • otherwise a negative value (-errno) — so if you see a negative number, that's the universe telling you something went sideways, and it's literally just the negated errno 💀

💖 SEE ALSO 💖

peep the kernel file ./drivers/pci/tph.c for the full lore, plus these besties:

they're all in the same friend group, go say hi 🧚

and that's the page!! 🎀 sign-off time: this lil beauty lives in ./drivers/pci, dated October 2026, and it's part of the Kernel API Manual (that's the pcie_tph_get_cpu_st(9) manual section 9 situation, iykyk). go forth and steer those tags, bestie 💅✨

📦 where this page comes from