freedesktop.wayland-cursor

// freedesktop.wayland-cursor — the client-side pointer.
//
// WHAT CANNOT BE ASSERTED HERE, AND WHY THE FIRST VERSION OF THIS FILE CRASHED
//
// `wl_cursor_theme_load(name, size, shm)` is not callable without a compositor,
// and not merely inadvisable: line 410 of upstream's wayland-cursor.c is
//
//     theme->pool = shm_pool_create(shm, size * size * 4);
//
// which reaches `wl_shm_create_pool(shm, ...)` and dereferences the proxy with
// no null check. The first version of this test passed `nullptr` on the theory
// that only the theme PARSER would run — it segfaulted (exit 139). A `wl_shm`
// comes from a compositor's registry, so the buffer half of this library
// belongs in a program that has one, exactly as opening /dev/input/event*
// belongs outside tests/examples/libinput.
//
// WHAT IS ASSERTED IS STILL THE PART THAT CARRIES THE PACKAGING RISK: that the
// hand-written module wrapper exports every name, that the two PUBLIC structs
// are usable as values rather than opaque handles, and that libwayland-client
// is really linked in. The compiled-in cursor search path being empty — the
// other packaging decision — is checked in the fork's CI by grepping the
// binary, which is the only place it is visible.
// …