README.md 2.08 KB
Newer Older
1
2
3
wayland-info
============

Peter Hutterer's avatar
Peter Hutterer committed
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
`wayland-info` is a utility for displaying information about the Wayland
protocols supported by a Wayland compositor.

It can be used to check which Wayland protocols and versions are advertised
by the Wayland compositor.

`wayland-info` also provides additional information for a subset of Wayland
protocols it knows about, namely Linux DMABUF, presentation time, tablet and
XDG output protocols.

An example output is:

```
$ wayland-info
interface: 'wl_drm',                                     version:  2, name:  1
interface: 'wl_compositor',                              version:  4, name:  2
interface: 'wl_shm',                                     version:  1, name:  3
	formats: XRGB8888 ARGB8888
interface: 'wl_output',                                  version:  2, name:  4
	x: 0, y: 0, scale: 1,
	physical_width: 310 mm, physical_height: 170 mm,
	make: 'AUO', model: '0x123d',
	subpixel_orientation: unknown, output_transform: normal,
	mode:
		width: 1920 px, height: 1080 px, refresh: 60.049 Hz,
		flags: current preferred
[...]
```

`wayland-info` uses the Wayland protocol only and only shows features
that the compositor implements via Wayland protocols.
35
36
37
38

Building
========

Peter Hutterer's avatar
Peter Hutterer committed
39
`wayland-info` is built using [Meson](https://mesonbuild.com/) and depends
40
41
42
43
44
45
46
47
48
49
50
51
on [Wayland](https://gitlab.freedesktop.org/wayland/wayland) and
[wayland-protocols](https://cgit.freedesktop.org/wayland/wayland-protocols).

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

Running
=======

Peter Hutterer's avatar
Peter Hutterer committed
52
`wayland-info` does not accept any command line option.
53
54
55
56
57
58
59

	$ wayland-info

Credit
======

The code base of `wayland-info` is identical to `weston-info` and therefore
Peter Hutterer's avatar
Peter Hutterer committed
60
61
all credits for `wayland-info` go to the authors and contributors of
`weston-info`.
62

Peter Hutterer's avatar
Peter Hutterer committed
63
64
65
66
Because `weston-info` is a generally useful tool, even outside of weston,
and gives interesting information on any Wayland compositor, this is basically
a standalone version of `weston-info` as found in
[weston](https://gitlab.freedesktop.org/wayland/weston/) repository.