mirrors/wayland
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wayland/wayland.git synced 2026-06-25 13:13:59 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions
Core Wayland window system code and protocol
2742 commits 26 branches 111 tags 38 MiB
Find a file
Demi Marie Obenour 0322b023c5 connection: check that strings are valid UTF-8 
This is required by the specification since
2bbd80c8df ("doc: Require strings to be UTF-8").  This commit enforces
UTF-8 validity in the implementation as well.  There are Wayland
implementations that already check for UTF-8 validity, so a client or
server that sends invalid UTF-8 in a string is already broken in
practice as well as in theory.

It is possible for libwayland users to validate UTF-8 themselves, but
this is far more error-prone than validating it during unmarshalling.
Furthemore, users may assume that since the wire protocol requires valid
UTF-8, libwayland checks for valid UTF-8.  If the user passed these
strings without validation to an API that assumes valid UTF-8 without
any checks, undefined behavior could result.

Fixes: 2bbd80c8df ("doc: Require strings to be UTF-8")
Signed-off-by: Demi Marie Obenour <demi@invisiblethingslab.com>
2026-06-17 11:35:25 -04:00
.gitlab/issue_templates gitlab: make issue template the default 2023-11-21 15:44:31 +00:00
cursor cursor: fix discards 'const' qualifier 2026-03-03 21:36:37 +00:00
doc doc: add frozen=true interface attribute 2026-03-05 12:00:35 +00:00
egl egl: Make wayland-egl symbols check depend on wayland_egl 2025-06-08 17:30:55 +00:00
protocol protocol: add wl_pointer.warp event 2026-06-08 12:29:28 +02:00
src connection: check that strings are valid UTF-8 2026-06-17 11:35:25 -04:00
tests scanner: Fix types emitted for new_id arguments 2026-04-14 15:11:51 +03:00
.editorconfig editorconfig: follow wayland-protocols XML style 2026-01-22 11:08:28 +02:00
.git-blame-ignore-revs fix .git-blame-ignore-revs revision 2026-02-02 14:00:28 +01:00
.gitignore build: drop autotools 2021-03-05 09:15:04 +00:00
.gitlab-ci.yml ci: upgrade FreeBSD to v14.4 2026-03-10 12:31:35 +01:00
.mailmap Add a .mailmap file 2023-03-25 11:17:32 -05:00
.triage-policies.yml Add a triage-policies file for bugbot 2023-07-07 21:18:08 +10:00
CONTRIBUTING.md CONTRIBUTING: fix typo "excercising" 2020-12-17 16:03:14 -05:00
COPYING COPYING: Update to MIT Expat License rather than MIT X License 2015-06-12 15:31:21 -07:00
git-blame-ignore-revs add .git-blame-ignore-revs file 2026-02-02 14:54:52 +02:00
meson.build build: re-open main branch for regular development 2026-03-20 11:17:40 +01:00
meson_options.txt doc: make DocBook validation optional 2026-02-04 15:12:04 +00:00
README.md readme: convert to Markdown 2023-02-13 19:57:15 +01:00
release.sh release.sh: Don't push *all* tags 2023-01-16 10:03:54 +00:00
releasing.txt Add release.sh 2022-07-14 08:04:43 +00:00
wayland-scanner.m4 build: check wayland-scanner version 2020-01-16 17:25:06 +01:00
wayland-scanner.mk Pass input/output files as arguments to wayland-scanner 2017-08-18 15:20:24 +03:00

README.md

Wayland

Wayland is a project to define a protocol for a compositor to talk to its clients as well as a library implementation of the protocol. The compositor can be a standalone display server running on Linux kernel modesetting and evdev input devices, an X application, or a wayland client itself. The clients can be traditional applications, X servers (rootless or fullscreen) or other display servers.

The wayland protocol is essentially only about input handling and buffer management. The compositor receives input events and forwards them to the relevant client. The clients creates buffers and renders into them and notifies the compositor when it needs to redraw. The protocol also handles drag and drop, selections, window management and other interactions that must go through the compositor. However, the protocol does not handle rendering, which is one of the features that makes wayland so simple. All clients are expected to handle rendering themselves, typically through cairo or OpenGL.

Building the wayland libraries is fairly simple, aside from libffi, they don't have many dependencies:

$ git clone https://gitlab.freedesktop.org/wayland/wayland
$ cd wayland
$ meson build/ --prefix=PREFIX
$ ninja -C build/ install

where PREFIX is where you want to install the libraries.

See https://wayland.freedesktop.org for documentation.