STRUCT DOCG3_CASCADE(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

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

okay so this is a page straight out of the Kernel API Manual β€” yes, that manual β€” and it's about one very specific little struct, bestie. buckle up πŸŽ€


✨ NAME ✨

struct docg3_cascade β€” a cascade of 1 to 4 docg3 chips. that's it, that's the whole vibe. one to four. no more, no less. πŸ‘‘


🌸 SYNOPSIS 🌸

struct docg3_cascade {
    struct mtd_info *floors[DOC_MAX_NBFLOORS];
    void __iomem *base;
    struct bch_control *bch;
    struct mutex lock;
 };

literally the whole struct, copied exactly, no notes. look at her. she's iconic. πŸ’–


πŸ¦‹ Members πŸ¦‹

  • floors β€” the floors, bestie. and yes, one physical docg3 chip is equal to one floor. that's the metaphor. we're doing floors. 🏒 (it's an array of struct mtd_info * sized DOC_MAX_NBFLOORS, iykyk)
  • base β€” the IO space you use to access all the chips in the cascade. it's a void __iomem *, so handle with care, mwah πŸ’…
  • bch β€” the BCH correcting control structure. a struct bch_control * doing its little error-correcting thing ✨
  • lock β€” a struct mutex whose entire job, her whole purpose, is protecting that docg3 IO space from concurrent accesses. no cutting in line. no cap. πŸ”’

🌈 SEE ALSO 🌈

  • Kernel file ./drivers/mtd/devices/docg3.h
  • struct docg3(9)

🫢 friendly reminder: the lock is there for a reason. concurrent accesses to the IO space are the enemy fr fr. respect the mutex.

and that's the whole page, bestie β€” sending you off with love from ./drivers/mtd/devices, dated October 2026. go read docg3.h next, you're gonna slay πŸ’œπŸ§šβ€β™€οΈβ­

πŸ“¦ where this page comes from