purego-libwayland

Go bindings for libwayland-server without cgo, loaded at runtime through github.com/bnema/purego.

Status

Early v0.x. A server-side libwayland runtime (server/ package).

Requirements

Linux, Go 1.27, and libwayland-server.so.0 at runtime.

Build

CGO_ENABLED=0 go build ./...

Protocol bindings

Generated protocol bindings live in github.com/bnema/go-wayland-bindings, one package per protocol under server/<pkg>, for example server/xdgshell and server/wlrlayershell. They build on this runtime's server package.

Display integration

Display.SetGlobalFilter(func(Client, *Global) bool) controls which clients see and bind each global; passing nil removes the filter. Set it before clients receive restricted globals. Global handles are stable, including during creation; filters must not create globals or block. Filter by g.Interface() (for example, g.Interface() != "xwayland_shell_v1" || c == xwaylandClient), not a captured handle assigned by AddGlobal: creation can invoke the filter before that assignment. Interface() and Version() expose stored metadata without allocation, including during creation.

Display.AddFDRW(fd, onReadable, onWritable) registers a non-blocking fd with writable interest initially disabled. Source.SetWritable(true) arms writable callbacks after EAGAIN; SetWritable(false) disarms them when output drains. Both return errors on registration/update failures. Readable interest remains active. Callbacks run on the display goroutine with no dispatch allocations. AddFD remains the readable-only API. Hangup/error readiness calls onReadable; remove the source on EOF/error. The caller owns the original fd.

These APIs, like other libwayland operations, belong on the display's OS-locked goroutine (use Do or Post from other goroutines).

License

MIT, see LICENSE.

source

1# purego-libwayland
2
3Go bindings for libwayland-server without cgo, loaded at runtime through github.com/bnema/purego.
4
5## Status
6
7Early v0.x. A server-side libwayland runtime (`server/` package).
8
9## Requirements
10
11Linux, Go 1.27, and `libwayland-server.so.0` at runtime.
12
13## Build
14
15```sh
16CGO_ENABLED=0 go build ./...
17```
18
19## Protocol bindings
20
21Generated protocol bindings live in [github.com/bnema/go-wayland-bindings](https://github.com/bnema/go-wayland-bindings), one package per protocol under `server/<pkg>`, for example `server/xdgshell` and `server/wlrlayershell`. They build on this runtime's `server` package.
22
23## Display integration
24
25`Display.SetGlobalFilter(func(Client, *Global) bool)` controls which clients see
26and bind each global; passing `nil` removes the filter. Set it before clients
27receive restricted globals. Global handles are stable, including during creation;
28filters must not create globals or block. Filter by `g.Interface()` (for example,
29`g.Interface() != "xwayland_shell_v1" || c == xwaylandClient`), not a captured
30handle assigned by `AddGlobal`: creation can invoke the filter before that
31assignment. `Interface()` and `Version()` expose stored metadata without
32allocation, including during creation.
33
34`Display.AddFDRW(fd, onReadable, onWritable)` registers a non-blocking fd with
35writable interest initially disabled. `Source.SetWritable(true)` arms writable
36callbacks after `EAGAIN`; `SetWritable(false)` disarms them when output drains.
37Both return errors on registration/update failures. Readable interest remains
38active. Callbacks run on the display goroutine with no dispatch allocations.
39`AddFD` remains the readable-only API. Hangup/error readiness calls onReadable;
40remove the source on EOF/error. The caller owns the original fd.
41
42These APIs, like other libwayland operations, belong on the display's OS-locked
43goroutine (use `Do` or `Post` from other goroutines).
44
45## License
46
47MIT, see `LICENSE`.

README.md RawHistoryFolder