Table of Contents
The open-source reference implementation of Wayland protocol is split in two C libraries, libwayland-client and libwayland-server. Their main responsibility is to handle the Inter-process communication (IPC) with each other, therefore guaranteeing the protocol objects marshaling and messages synchronization.
A client uses libwayland-client to communicate with one or more wayland servers. A wl_display object is created and manages each open connection to a server. At least one wl_event_queue object is created for each wl_display, this holds events as they are received from the server until they can be processed. Multi-threading is supported by creating an additional wl_event_queue for each additional thread, each object can have it's events placed in a particular queue, so potentially a different thread could be made to handle the events for each object created.
Though some conveinence functions are provided, libwayland-client is designed to allow the calling code to wait for events, so that different polling mechanisms can be used. A file descriptor is provided, when it becomes ready for reading the calling code can ask libwayland-client to read the available events from it into the wl_event_queue objects.
The library only provides low-level access to the wayland objects. Each object created by the client is represented by a wl_proxy object that this library creates. This includes the id that is actually communicated over the socket to the server, a void* data pointer that is intended to point at a client's representation of the object, and a pointer to a static wl_interface object, which is generated from the xml and identifies the object's class and can be used for introspection into the messages and events.
Messages are sent by calling wl_proxy_marshal. This will write a message to the socket, by using the message id and the wl_interface to identify the types of each argument and convert them into stream format. Most software will call type-safe wrappers generated from the xml description of the Wayland protocols. For instance the C header file generated from the xml defines the following inline function to transmit the wl_surface::attach message:
static inline void wl_surface_attach(struct wl_surface *wl_surface, struct wl_buffer *buffer, int32_t x, int32_t y) { wl_proxy_marshal((struct wl_proxy *) wl_surface, WL_SURFACE_ATTACH, buffer, x, y); }
Events (messages from the server) are handled by calling a "dispatcher" callback the client stores in the wl_proxy for each event. A language binding for a string-based interpreter, such as CPython, might have a dispatcher that uses the event name from the wl_interface to identify the function to call. The default dispatcher uses the message id number to index an array of functions pointers, called a wl_listener, and the wl_interface to convert data from the stream into arguments to the function. The C header file generated from the xml defines a per-class structure that forces the function pointers to be of the correct type, for instance the wl_surface::enter event defines this pointer in the wl_surface_listener object:
struct wl_surface_listener { void (*enter)(void *data, struct wl_surface *, struct wl_output *); ... }
This union represents all of the basic data types that can be passed in the wayland wire format. It is used by dispatchers and runtime-friendly versions of the event and request marshaling functions.
A wl_display object represents a client connection to a Wayland compositor. It is created with either wl_display_connect() or wl_display_connect_to_fd(). A connection is terminated using wl_display_disconnect().
A wl_display is also used as the wl_proxy for the wl_display singleton object on the compositor side.
A wl_display object handles all the data sent from and to the compositor. When a wl_proxy marshals a request, it will write its wire representation to the display's write buffer. The data is sent to the compositor when the client calls wl_display_flush().
Incoming data is handled in two steps: queueing and dispatching. In the queue step, the data coming from the display fd is interpreted and added to a queue. On the dispatch step, the handler for the incoming event set by the client on the corresponding wl_proxy is called.
A wl_display has at least one event queue, called the default queue. Clients can create additional event queues with wl_display_create_queue() and assign wl_proxy's to it. Events occurring in a particular proxy are always queued in its assigned queue. A client can ensure that a certain assumption, such as holding a lock or running from a given thread, is true when a proxy event handler is called by assigning that proxy to an event queue and making sure that this queue is only dispatched when the assumption holds.
The default queue is dispatched by calling wl_display_dispatch(). This will dispatch any events queued on the default queue and attempt to read from the display fd if it's empty. Events read are then queued on the appropriate queues according to the proxy assignment.
A user created queue is dispatched with wl_display_dispatch_queue(). This function behaves exactly the same as wl_display_dispatch() but it dispatches given queue instead of the default queue.
A real world example of event queue usage is Mesa's implementation of eglSwapBuffers() for the Wayland platform. This function might need to block until a frame callback is received, but dispatching the default queue could cause an event handler on the client to start drawing again. This problem is solved using another event queue, so that only the events handled by the EGL code are dispatched during the block.
This creates a problem where a thread dispatches a non-default queue, reading all the data from the display fd. If the application would call poll(2) after that it would block, even though there might be events queued on the default queue. Those events should be dispatched with pending() before flushing and blocking.
struct wl_display * wl_display_connect_to_fd(int fd)
The wl_display takes ownership of the fd and will close it when the display is destroyed. The fd will also be closed in case of failure.
struct wl_display * wl_display_connect(const char *name)
Connect to the Wayland display named name. If name is NULL, its value will be replaced with the WAYLAND_DISPLAY environment variable if it is set, otherwise display "wayland-0" will be used.
void wl_display_disconnect(struct wl_display *display)
Close the connection to display and free all resources associated with it.
int wl_display_get_fd(struct wl_display *display)
Return the file descriptor associated with a display so it can be integrated into the client's main loop.
int wl_display_roundtrip(struct wl_display *display)
Blocks until the server process all currently issued requests and sends out pending events on the default event queue.
Note: This function uses wl_display_dispatch_queue() internally. If you are using wl_display_read_events() from more threads, don't use this function (or make sure that calling wl_display_roundtrip() doesn't interfere with calling wl_display_prepare_read() and wl_display_read_events())
int wl_display_read_events(struct wl_display *display)
This will read events from the file descriptor for the display. This function does not dispatch events, it only reads and queues events into their corresponding event queues. If no data is available on the file descriptor, wl_display_read_events() returns immediately. To dispatch events that may have been queued, call wl_display_dispatch_pending() or wl_display_dispatch_queue_pending().
Before calling this function, wl_display_prepare_read() must be called first. When running in more threads (which is the usual case, since we'd use wl_display_dispatch() otherwise), every thread must call wl_display_prepare_read() before calling this function.
After calling wl_display_prepare_read() there can be some extra code before calling wl_display_read_events(), for example poll() or alike. Example of code in a thread:
while (wl_display_prepare_read(display) < 0) wl_display_dispatch_pending(display); wl_display_flush(display); ... some code ... fds[0].fd = wl_display_get_fd(display); fds[0].events = POLLIN; poll(fds, 1, -1); if (!everything_ok()) { wl_display_cancel_read(display); handle_error(); } if (wl_display_read_events(display) < 0) handle_error(); ...
After wl_display_prepare_read() succeeds, other threads that enter wl_display_read_events() will sleep until the very last thread enters it too or cancels. Therefore when the display fd becomes (or already is) readable, wl_display_read_events() should be called as soon as possible to unblock all threads. If wl_display_read_events() will not be called, then wl_display_cancel_read() must be called instead to let the other threads continue.
This function must not be called simultaneously with wl_display_dispatch(). It may lead to deadlock. If programmer wants, for some reason, use wl_display_dispatch() in one thread and wl_display_prepare_read() with wl_display_read_events() in another, extra care must be taken to serialize these calls, i. e. use mutexes or similar (on whole prepare + read sequence)
See also: wl_display_prepare_read(), wl_display_cancel_read(), wl_display_dispatch_pending(), wl_display_dispatch()
int wl_display_prepare_read(struct wl_display *display)
This function must be called before reading from the file descriptor using wl_display_read_events(). Calling wl_display_prepare_read() announces the calling thread's intention to read and ensures that until the thread is ready to read and calls wl_display_read_events(), no other thread will read from the file descriptor. This only succeeds if the event queue is empty though, and if there are undispatched events in the queue, -1 is returned and errno set to EAGAIN.
If a thread successfully calls wl_display_prepare_read(), it must either call wl_display_read_events() when it's ready or cancel the read intention by calling wl_display_cancel_read().
Use this function before polling on the display fd or to integrate the fd into a toolkit event loop in a race-free way. A correct usage would be (we left out most of error checking):
while (wl_display_prepare_read(display) != 0) wl_display_dispatch_pending(display); wl_display_flush(display); ret = poll(fds, nfds, -1); if (has_error(ret)) wl_display_cancel_read(display); else wl_display_read_events(display); wl_display_dispatch_pending(display);
Here we call wl_display_prepare_read(), which ensures that between returning from that call and eventually calling wl_display_read_events(), no other thread will read from the fd and queue events in our queue. If the call to wl_display_prepare_read() fails, we dispatch the pending events and try again until we're successful.
When using wl_display_dispatch() we'd have something like:
wl_display_dispatch_pending(display); wl_display_flush(display); poll(fds, nfds, -1); wl_display_dispatch(display);
This sequence in not thread-safe. The race is immediately after poll(), where one thread could preempt and read events before the other thread calls wl_display_dispatch(). This call now blocks and starves the other fds in the event loop.
Another race would be when using more event queues. When one thread calls wl_display_dispatch(_queue)(), then it reads all events from display's fd and queues them in appropriate queues. Then it dispatches only its own queue and the other events are sitting in their queues, waiting for dispatching. If that happens before the other thread managed to call poll(), it will block with events queued.
wl_display_prepare_read() function doesn't acquire exclusive access to the display's fd. It only registers that the thread calling this function has intention to read from fd. When all registered readers call wl_display_read_events(), only one (at random) eventually reads and queues the events and the others are sleeping meanwhile. This way we avoid races and still can read from more threads.
If the relevant queue is not the default queue, then wl_display_prepare_read_queue() and wl_display_dispatch_queue_pending() need to be used instead.
See also: wl_display_cancel_read(), wl_display_read_events()
void wl_display_cancel_read(struct wl_display *display)
After a thread successfully called wl_display_prepare_read() it must either call wl_display_read_events() or wl_display_cancel_read(). If the threads do not follow this rule it will lead to deadlock.
See also: wl_display_prepare_read(), wl_display_read_events()
int wl_display_dispatch(struct wl_display *display)
Dispatch the display's default event queue.
If the default event queue is empty, this function blocks until there are events to be read from the display fd. Events are read and queued on the appropriate event queues. Finally, events on the default event queue are dispatched.
In multi-threaded environment, programmer may want to use wl_display_read_events(). However, use of wl_display_read_events() must not be mixed with wl_display_dispatch(). See wl_display_read_events() and wl_display_prepare_read() for more details.
Note: It is not possible to check if there are events on the queue or not. For dispatching default queue events without blocking, see wl_display_dispatch_pending(). See also: wl_display_dispatch_pending(), wl_display_dispatch_queue(), wl_display_read_events()
int wl_display_dispatch_pending(struct wl_display *display)
This function dispatches events on the main event queue. It does not attempt to read the display fd and simply returns zero if the main queue is empty, i.e., it doesn't block.
This is necessary when a client's main loop wakes up on some fd other than the display fd (network socket, timer fd, etc) and calls wl_display_dispatch_queue() from that callback. This may queue up events in other queues while reading all data from the display fd. When the main loop returns from the handler, the display fd no longer has data, causing a call to poll(2) (or similar functions) to block indefinitely, even though there are events ready to dispatch.
To proper integrate the wayland display fd into a main loop, the client should always call wl_display_dispatch_pending() and then wl_display_flush() prior to going back to sleep. At that point, the fd typically doesn't have data so attempting I/O could block, but events queued up on the default queue should be dispatched.
A real-world example is a main loop that wakes up on a timerfd (or a sound card fd becoming writable, for example in a video player), which then triggers GL rendering and eventually eglSwapBuffers(). eglSwapBuffers() may call wl_display_dispatch_queue() if it didn't receive the frame event for the previous frame, and as such queue events in the default queue.
See also: wl_display_dispatch(), wl_display_dispatch_queue(), wl_display_flush()
int wl_display_get_error(struct wl_display *display)
Return the last error that occurred on the display. This may be an error sent by the server or caused by the local client.
Note: Errors are fatal. If this function returns non-zero the display can no longer be used.
uint32_t wl_display_get_protocol_error(struct wl_display *display, const struct wl_interface **interface, uint32_t *id)
int err = wl_display_get_error(display); if (err == EPROTO) { code = wl_display_get_protocol_error(display, &interface, &id); handle_error(code, interface, id); } ...
int wl_display_flush(struct wl_display *display)
Send all buffered data on the client side to the server. Clients should call this function before blocking. On success, the number of bytes sent to the server is returned. On failure, this function returns -1 and errno is set appropriately.
wl_display_flush() never blocks. It will write as much data as possible, but if all data could not be written, errno will be set to EAGAIN and -1 returned. In that case, use poll on the display file descriptor to wait for it to become writable again.
Event queues allows the events on a display to be handled in a thread-safe manner. See wl_display for details.
void wl_event_queue_destroy(struct wl_event_queue *queue)
Destroy the given event queue. Any pending event on that queue is discarded.
The wl_display object used to create the queue should not be destroyed until all event queues created with it are destroyed with this function.
struct wl_event_queue * wl_display_create_queue(struct wl_display *display)
int wl_display_roundtrip_queue(struct wl_display *display, struct wl_event_queue *queue)
Blocks until the server processes all currently issued requests and sends out pending events on the event queue.
Note: This function uses wl_display_dispatch_queue() internally. If you are using wl_display_read_events() from more threads, don't use this function (or make sure that calling wl_display_roundtrip_queue() doesn't interfere with calling wl_display_prepare_read() and wl_display_read_events()) See also: wl_display_roundtrip()
int wl_display_prepare_read_queue(struct wl_display *display, struct wl_event_queue *queue)
Atomically makes sure the queue is empty and stops any other thread from placing events into this (or any) queue. Caller must eventually call either wl_display_cancel_read() or wl_display_read_events(), usually after waiting for the display fd to become ready for reading, to release the lock.
See also: wl_display_prepare_read
int wl_display_dispatch_queue(struct wl_display *display, struct wl_event_queue *queue)
Dispatch all incoming events for objects assigned to the given event queue. On failure -1 is returned and errno set appropriately.
The behaviour of this function is exactly the same as the behaviour of wl_display_dispatch(), but it dispatches events on given queue, not on the default queue.
This function blocks if there are no events to dispatch (if there are, it only dispatches these events and returns immediately). When this function returns after blocking, it means that it read events from display's fd and queued them to appropriate queues. If among the incoming events were some events assigned to the given queue, they are dispatched by this moment.
Note: Since Wayland 1.5 the display has an extra queue for its own events (i. e. delete_id). This queue is dispatched always, no matter what queue we passed as an argument to this function. That means that this function can return non-0 value even when it haven't dispatched any event for the given queue. This function has the same constrains for using in multi-threaded apps as wl_display_dispatch().
See also: wl_display_dispatch(), wl_display_dispatch_pending(), wl_display_dispatch_queue_pending()
int wl_display_dispatch_queue_pending(struct wl_display *display, struct wl_event_queue *queue)
Dispatch all incoming events for objects assigned to the given event queue. On failure -1 is returned and errno set appropriately. If there are no events queued, this function returns immediately.
Since: 1.0.2
The list head is of "struct wl_list" type, and must be initialized using wl_list_init(). All entries in the list must be of the same type. The item type must have a "struct wl_list" member. This member will be initialized by wl_list_insert(). There is no need to call wl_list_init() on the individual item. To query if the list is empty in O(1), use wl_list_empty().
Let's call the list reference "struct wl_list foo_list", the item type as "item_t", and the item member as "struct wl_list link".
The following code will initialize a list:
struct wl_list foo_list; struct item_t { int foo; struct wl_list link; }; struct item_t item1, item2, item3; wl_list_init(&foo_list); wl_list_insert(&foo_list, &item1.link); // Pushes item1 at the head wl_list_insert(&foo_list, &item2.link); // Pushes item2 at the head wl_list_insert(&item2.link, &item3.link); // Pushes item3 after item2
The list now looks like [item2, item3, item1]
Iterate the list in ascending order:
item_t *item; wl_list_for_each(item, foo_list, link) { Do_something_with_item(item); }
A wl_proxy acts as a client side proxy to an object existing in the compositor. The proxy is responsible for converting requests made by the clients with wl_proxy_marshal() into Wayland's wire format. Events coming from the compositor are also handled by the proxy, which will in turn call the handler set with wl_proxy_add_listener().
Note: With the exception of function wl_proxy_set_queue(), functions accessing a wl_proxy are not normally used by client code. Clients should normally use the higher level interface generated by the scanner to interact with compositor objects.
struct wl_proxy * wl_proxy_create(struct wl_proxy *factory, const struct wl_interface *interface)
This function creates a new proxy object with the supplied interface. The proxy object will have an id assigned from the client id space. The id should be created on the compositor side by sending an appropriate request with wl_proxy_marshal().
The proxy will inherit the display and event queue of the factory object.
Note: This should not normally be used by non-generated code. See also: wl_display, wl_event_queue, wl_proxy_marshal()
void wl_proxy_destroy(struct wl_proxy *proxy)
int wl_proxy_add_listener(struct wl_proxy *proxy, void(**implementation)(void), void *data)
Set proxy's listener to implementation and its user data to data. If a listener has already been set, this function fails and nothing is changed.
implementation is a vector of function pointers. For an opcode n, implementation[n] should point to the handler of n for the given object.
const void * wl_proxy_get_listener(struct wl_proxy *proxy)
Gets the address to the proxy's listener; which is the listener set with wl_proxy_add_listener.
This function is useful in clients with multiple listeners on the same interface to allow the identification of which code to execute.
int wl_proxy_add_dispatcher(struct wl_proxy *proxy, wl_dispatcher_func_t dispatcher, const void *implementation, void *data)
Set proxy's listener to use dispatcher_func as its dispatcher and dispatcher_data as its dispatcher-specific implementation and its user data to data. If a listener has already been set, this function fails and nothing is changed.
The exact details of dispatcher_data depend on the dispatcher used. This function is intended to be used by language bindings, not user code.
struct wl_proxy * wl_proxy_marshal_array_constructor(struct wl_proxy *proxy, uint32_t opcode, union wl_argument *args, const struct wl_interface *interface)
Translates the request given by opcode and the extra arguments into the wire format and write it to the connection buffer. This version takes an array of the union type wl_argument.
For new-id arguments, this function will allocate a new wl_proxy and send the ID to the server. The new wl_proxy will be returned on success or NULL on errror with errno set accordingly.
Note: This is intended to be used by language bindings and not in non-generated code. See also: wl_proxy_marshal()
void wl_proxy_marshal(struct wl_proxy *proxy, uint32_t opcode,...)
This function is similar to wl_proxy_marshal_constructor(), except it doesn't create proxies for new-id arguments.
Note: This should not normally be used by non-generated code. See also: wl_proxy_create()
struct wl_proxy * wl_proxy_marshal_constructor(struct wl_proxy *proxy, uint32_t opcode, const struct wl_interface *interface,...)
Translates the request given by opcode and the extra arguments into the wire format and write it to the connection buffer.
For new-id arguments, this function will allocate a new wl_proxy and send the ID to the server. The new wl_proxy will be returned on success or NULL on errror with errno set accordingly.
Note: This should not normally be used by non-generated code.
void wl_proxy_marshal_array(struct wl_proxy *proxy, uint32_t opcode, union wl_argument *args)
This function is similar to wl_proxy_marshal_array_constructor(), except it doesn't create proxies for new-id arguments.
Note: This is intended to be used by language bindings and not in non-generated code. See also: wl_proxy_marshal()
void wl_proxy_set_user_data(struct wl_proxy *proxy, void *user_data)
Set the user data associated with proxy. When events for this proxy are received, user_data will be supplied to its listener.
void * wl_proxy_get_user_data(struct wl_proxy *proxy)
uint32_t wl_proxy_get_id(struct wl_proxy *proxy)
const char * wl_proxy_get_class(struct wl_proxy *proxy)
void wl_proxy_set_queue(struct wl_proxy *proxy, struct wl_event_queue *queue)
Assign proxy to event queue. Events coming from proxy will be queued in queue from now. If queue is NULL, then the display's default queue is set to the proxy.
Note: By default, the queue set in proxy is the one inherited from parent. See also: wl_display_dispatch_queue()
void wl_event_queue_destroy(struct wl_event_queue *queue)
void wl_proxy_marshal(struct wl_proxy *p, uint32_t opcode,...)
void wl_proxy_marshal_array(struct wl_proxy *p, uint32_t opcode, union wl_argument *args)
struct wl_proxy* wl_proxy_create(struct wl_proxy *factory, const struct wl_interface *interface)
struct wl_proxy* wl_proxy_marshal_constructor(struct wl_proxy *proxy, uint32_t opcode, const struct wl_interface *interface,...)
struct wl_proxy* wl_proxy_marshal_array_constructor(struct wl_proxy *proxy, uint32_t opcode, union wl_argument *args, const struct wl_interface *interface)
void wl_proxy_destroy(struct wl_proxy *proxy)
int wl_proxy_add_listener(struct wl_proxy *proxy, void(**implementation)(void), void *data)
const void* wl_proxy_get_listener(struct wl_proxy *proxy)
int wl_proxy_add_dispatcher(struct wl_proxy *proxy, wl_dispatcher_func_t dispatcher_func, const void *dispatcher_data, void *data)
void wl_proxy_set_user_data(struct wl_proxy *proxy, void *user_data)
void* wl_proxy_get_user_data(struct wl_proxy *proxy)
uint32_t wl_proxy_get_id(struct wl_proxy *proxy)
const char* wl_proxy_get_class(struct wl_proxy *proxy)
void wl_proxy_set_queue(struct wl_proxy *proxy, struct wl_event_queue *queue)
struct wl_display* wl_display_connect(const char *name)
struct wl_display* wl_display_connect_to_fd(int fd)
void wl_display_disconnect(struct wl_display *display)
int wl_display_get_fd(struct wl_display *display)
int wl_display_dispatch(struct wl_display *display)
int wl_display_dispatch_queue(struct wl_display *display, struct wl_event_queue *queue)
int wl_display_dispatch_queue_pending(struct wl_display *display, struct wl_event_queue *queue)
int wl_display_dispatch_pending(struct wl_display *display)
int wl_display_get_error(struct wl_display *display)
uint32_t wl_display_get_protocol_error(struct wl_display *display, const struct wl_interface **interface, uint32_t *id)
int wl_display_flush(struct wl_display *display)
int wl_display_roundtrip_queue(struct wl_display *display, struct wl_event_queue *queue)
int wl_display_roundtrip(struct wl_display *display)
struct wl_event_queue* wl_display_create_queue(struct wl_display *display)
int wl_display_prepare_read_queue(struct wl_display *display, struct wl_event_queue *queue)
int wl_display_prepare_read(struct wl_display *display)
void wl_display_cancel_read(struct wl_display *display)
int wl_display_read_events(struct wl_display *display)
void wl_log_set_handler_client(wl_log_func_t handler)
void proxy_destroy(struct wl_proxy *proxy)
void wl_log_set_handler_client(wl_log_func_t handler)
void wl_list_init(struct wl_list *list)
void wl_list_insert(struct wl_list *list, struct wl_list *elm)
void wl_list_remove(struct wl_list *elm)
int wl_list_length(const struct wl_list *list)
int wl_list_empty(const struct wl_list *list)
void wl_list_insert_list(struct wl_list *list, struct wl_list *other)
void wl_array_init(struct wl_array *array)
void wl_array_release(struct wl_array *array)
void* wl_array_add(struct wl_array *array, size_t size)
int wl_array_copy(struct wl_array *array, struct wl_array *source)
void wl_log(const char *fmt,...)
This macro allows conversion from a pointer to a item to its containing struct. This is useful if you have a contained item like a wl_list, wl_listener, or wl_signal, provided via a callback or other means and would like to retrieve the struct that contains it.
To demonstrate, the following example retrieves a pointer to example_container given only its destroy_listener member:
struct example_container { struct wl_listener destroy_listener; // other members... }; void example_container_destroy(struct wl_listener *listener, void *data) { struct example_container *ctr; ctr = wl_container_of(listener, ctr, destroy_listener); // destroy ctr... }
typedef int(* wl_dispatcher_func_t)(const void *, void *, uint32_t, const struct wl_message *, union wl_argument *))(const void *, void *, uint32_t, const struct wl_message *, union wl_argument *)
A dispatcher is a function that handles the emitting of callbacks in client code. For programs directly using the C library, this is done by using libffi to call function pointers. When binding to languages other than C, dispatchers provide a way to abstract the function calling process to be friendlier to other function calling systems.
A dispatcher takes five arguments: The first is the dispatcher-specific implementation data associated with the target object. The second is the object on which the callback is being invoked (either wl_proxy or wl_resource). The third and fourth arguments are the opcode the wl_messsage structure corresponding to the callback being emitted. The final argument is an array of arguments received from the other process via the wire protocol.
void wl_list_init(struct wl_list *list)
void wl_list_insert(struct wl_list *list, struct wl_list *elm)
void wl_list_remove(struct wl_list *elm)
int wl_list_length(const struct wl_list *list)
int wl_list_empty(const struct wl_list *list)
void wl_list_insert_list(struct wl_list *list, struct wl_list *other)
void wl_array_init(struct wl_array *array)
void wl_array_release(struct wl_array *array)
void* wl_array_add(struct wl_array *array, size_t size)
int wl_array_copy(struct wl_array *array, struct wl_array *source)