DOKK / manpages / debian 11 / libwayland-doc / wl_interface.3.en
wl_interface(3) Wayland wl_interface(3)

wl_interface

#include <wayland-util.h>


const char * name
int version
int method_count
const struct wl_message * methods
int event_count
const struct wl_message * events

Protocol object interface

A wl_interface describes the API of a protocol object defined in the Wayland protocol specification. The protocol implementation uses a wl_interface within its marshalling machinery for encoding client requests.

The name of a wl_interface is the name of the corresponding protocol interface, and version represents the version of the interface. The members method_count and event_count represent the number of methods (requests) and events in the respective wl_message members.

For example, consider a protocol interface foo, marked as version 1, with two requests and one event.

<interface name="foo" version="1">

<request name="a"></request>
<request name="b"></request>
<event name="c"></event> </interface>

Given two wl_message arrays foo_requests and foo_events, a wl_interface for foo might be:

struct wl_interface foo_interface = {

"foo", 1,
2, foo_requests,
1, foo_events };

Note

The server side of the protocol may define interface implementation types that incorporate the term interface in their name. Take care to not confuse these server-side structs with a wl_interface variable whose name also ends in interface. For example, while the server may define a type struct wl_foo_interface, the client may define a struct wl_interface wl_foo_interface.

See also

wl_message

wl_proxy

Interfaces

Versioning

Number of events

const struct wl_message* wl_interface::events

Event signatures

Number of methods (requests)

const struct wl_message* wl_interface::methods

Method (request) signatures

Interface name

Interface version

Generated automatically by Doxygen for Wayland from the source code.

Mon Aug 31 2020 Version 1.18.0