WAFFLE_GBM(3)

🎀 NAME 🎀

Bestie, say hi to the whole squad 👋 — <purple>waffle_gbm</purple>, <purple>waffle_gbm_display</purple>, <purple>waffle_gbm_config</purple>, <purple>waffle_gbm_context</purple>, and <purple>waffle_gbm_window</purple>, all documented right here in waffle_gbm(3).

And what are they, you ask? They are literally containers for underlying native GBM objects ✨. That's the whole job description. They hold the native stuff, they look cute doing it, periodt 💅.

---

💖 SYNOPSIS 💖

First things first, you gotta bring in the header:

#include <waffle_gbm.h>

Then boom, four structs, waiting for you like 🦋:

struct waffle_gbm_display {
    struct gbm_device *gbm_device;
    EGLDisplay egl_display;
};

struct waffle_gbm_config {
    struct waffle_gbm_display display;
    EGLConfig egl_config;
};

struct waffle_gbm_context {
    struct waffle_gbm_display display;
    EGLContext egl_context;
};

struct waffle_gbm_window {
    struct waffle_gbm_display display;
    struct gbm_surface *gbm_surface;
    EGLSurface egl_surface;
};

Vibe check on each one, no cap:

• waffle_gbm_display — carries its very own <cyan>struct gbm_device *gbm_device</cyan> plus an `EGLDisplay egl_display. 🌈
• waffle_gbm_config — nests a whole waffle_gbm_display in there (as display, obvs) and adds an `EGLConfig egl_config. It's giving ✨collector✨.
• waffle_gbm_context — same deal, it's got a waffle_gbm_display display and an `EGLContext egl_context. 👑
• waffle_gbm_window — the main character fr: it holds a waffle_gbm_display display, a <cyan>struct gbm_surface *gbm_surface</cyan>, AND an `EGLSurface egl_surface. Ate and left no crumbs 💅💖

Like, the way every single one of the last three is built on top of waffle_gbm_display? That's iconic inheritance-by-nesting energy. 🫶

---

😭 ISSUES 😭

Found a bug? Got a feature request bubbling in your brain? Please report bugs or feature requests to https://gitlab.freedesktop.org/mesa/waffle/issues. That's the spot, bestie — not my DMs 🥲.

---

🌸 SEE ALSO 🌸

Go read these next, they're the besties of this page:

• waffle(7)
• waffle_native(3)

---

💜 AUTHOR 💜

Chad Versace <chad.versace@linux.intel.com>     Former maintainer 👑

---

🍓 COPYRIGHT 🍓

Copyright © 2013 Intel

This manual page is licensed under the Creative Commons Attribution-ShareAlike 3.0 United States License (CC BY-SA 3.0). Wanna see a copy of this license? Visit http://creativecommons.org.license/by-sa/3.0/us. 🎀

---

okay that's the whole thing fr fr. no skips, no missing bits, every struct field intact 🤝

And that's a wrap on waffle_gbm(3) from the waffle manual, dated 07/06/2026 🦋✨ thanks for reading, mwah 💖Ctrl+D your way out whenever, love u, bye 👋💅