STRUCT KVMPPC_GS_BUFF(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… struct kvmppc_gs_buff(9) πŸ’…

ok so bestie, we're in the Kernel API Manual, section 9 β€” that's the kernel-internal docs bestie, the ones you read when you're really in it. this page is all about struct kvmppc_gs_buff, and the name literally spells it out: it's a guest state buffer with metadata. like, the buffer itself is the main character, but it brought its little entourage of bookkeeping fields along for the ride πŸŽ€


✨ NAME ✨

struct kvmppc_gs_buff β€” a guest state buffer with metadata. no cap, that's the whole vibe: data + the receipts about the data πŸ§ΎπŸ’–


πŸ¦‹ SYNOPSIS πŸ¦‹

struct kvmppc_gs_buff {
    size_t capacity;
    size_t len;
    unsigned long guest_id;
    unsigned long vcpu_id;
    struct kvmppc_gs_header *hdr;
 };

ok bestie look at her. five fields. very demure, very mindful 🌸


πŸ‘‘ Members πŸ‘‘

  • capacity β€” total length of the buffer. like, how much room she has to work with, periodt πŸ“
  • len β€” current length of the elements and the header. yes both. the header counts too, don't forget the header πŸ’…
  • guest_id β€” guest id associated with the buffer. whose guest is this? this one 🫢
  • vcpu_id β€” vcpu_id associated with the buffer. the vcpu said "that's me" 🧚
  • hdr β€” the serialised guest state buffer. that's a struct kvmppc_gs_header *, and it's exactly what it sounds like ✨

🌈 SEE ALSO 🌈

Kernel file ./arch/powerpc/include/asm/guest-state-buffer.h β€” that's the home base, the source of truth, the mothership πŸ πŸ’œ

and then the whole friend group, fr fr:

like, the whole extended universe is in there. go click around, iykyk πŸ”₯


bestie reminder: this page gives you the struct and the road map, not the behaviour. so don't go assuming anything about how these get written, read or sized β€” that's what the SEE ALSO list is for, and the header file ./arch/powerpc/include/asm/guest-state-buffer.h is right there πŸ’€

ok that's the whole page, no notes, she ate πŸ’…βœ¨ this lil drop came to you from ./arch/powerpc/include/asm, dated October 2026 β€” go forth and read the header bestie, ily πŸ«ΆπŸŽ€πŸ’–

πŸ“¦ where this page comes from