wayland_sys/
server.rs

1//! Bindings to the client library `libwayland-server.so`
2//!
3//! The generated handle is named `wayland_server_handle()`
4
5#![cfg_attr(rustfmt, rustfmt_skip)]
6
7use super::common::*;
8#[cfg(feature = "server")]
9use libc::{gid_t, pid_t, uid_t};
10#[cfg(feature = "server")]
11use std::os::raw::c_char;
12use std::os::raw::{c_int, c_void};
13#[cfg(all(feature = "server", feature = "dlopen"))]
14use once_cell::sync::Lazy;
15
16pub enum wl_client {}
17pub enum wl_display {}
18pub enum wl_event_loop {}
19pub enum wl_event_source {}
20pub enum wl_global {}
21pub enum wl_resource {}
22pub enum wl_shm_buffer {}
23
24pub type wl_event_loop_fd_func_t = unsafe extern "C" fn(c_int, u32, *mut c_void) -> c_int;
25pub type wl_event_loop_timer_func_t = unsafe extern "C" fn(*mut c_void) -> c_int;
26pub type wl_event_loop_signal_func_t = unsafe extern "C" fn(c_int, *mut c_void) -> c_int;
27pub type wl_event_loop_idle_func_t = unsafe extern "C" fn(*mut c_void) -> ();
28pub type wl_global_bind_func_t = unsafe extern "C" fn(*mut wl_client, *mut c_void, u32, u32) -> ();
29pub type wl_notify_func_t = unsafe extern "C" fn(*mut wl_listener, *mut c_void) -> ();
30pub type wl_resource_destroy_func_t = unsafe extern "C" fn(*mut wl_resource) -> ();
31pub type wl_display_global_filter_func_t =
32    unsafe extern "C" fn(*const wl_client, *const wl_global, *mut c_void) -> bool;
33pub type wl_client_for_each_resource_iterator_func_t =
34    unsafe extern "C" fn(*mut wl_resource, *mut c_void) -> c_int;
35
36#[repr(C)]
37pub struct wl_listener {
38    pub link: wl_list,
39    pub notify: wl_notify_func_t,
40}
41
42#[repr(C)]
43pub struct wl_signal {
44    pub listener_list: wl_list,
45}
46
47#[cfg(feature = "server")]
48external_library!(WaylandServer, "wayland-server",
49    functions:
50    // wl_client
51        fn wl_client_flush(*mut wl_client) -> (),
52        fn wl_client_destroy(*mut wl_client) -> (),
53        fn wl_client_get_display(*mut wl_client) -> *mut wl_display,
54        fn wl_client_get_credentials(*mut wl_client, *mut pid_t, *mut uid_t, *mut gid_t) -> (),
55        fn wl_client_get_object(*mut wl_client, u32) -> *mut wl_resource,
56        fn wl_client_add_destroy_listener(*mut wl_client, *mut wl_listener) -> (),
57        fn wl_client_get_destroy_listener(*mut wl_client, wl_notify_func_t) -> *mut wl_listener,
58        fn wl_client_post_no_memory(*mut wl_client) -> (),
59        #[cfg(feature = "libwayland_server_1_23")]
60        fn wl_client_set_max_buffer_size(*mut wl_client, usize) -> (),
61        fn wl_resource_create(*mut wl_client, *const wl_interface, c_int, u32) -> *mut wl_resource,
62        fn wl_client_get_link(*mut wl_client) -> *mut wl_list,
63        fn wl_client_from_link(*mut wl_list) -> *mut wl_client,
64        fn wl_client_for_each_resource(*mut wl_client, wl_client_for_each_resource_iterator_func_t, *mut c_void) -> (),
65    // wl_display
66        fn wl_client_create(*mut wl_display, c_int) -> *mut wl_client,
67        fn wl_display_create() -> *mut wl_display,
68        fn wl_display_destroy(*mut wl_display) -> (),
69        fn wl_display_destroy_clients(*mut wl_display) -> (),
70        fn wl_display_get_serial(*mut wl_display) -> u32,
71        fn wl_display_next_serial(*mut wl_display) -> u32,
72        fn wl_display_add_socket(*mut wl_display, *const c_char) -> c_int,
73        fn wl_display_add_socket_auto(*mut wl_display) -> *const c_char,
74        fn wl_display_add_socket_fd(*mut wl_display, c_int) -> c_int,
75        fn wl_display_add_shm_format(*mut wl_display, u32) -> *mut u32,
76        fn wl_display_get_event_loop(*mut wl_display) -> *mut wl_event_loop,
77        fn wl_display_terminate(*mut wl_display) -> (),
78        fn wl_display_run(*mut wl_display) -> (),
79        fn wl_display_flush_clients(*mut wl_display) -> (),
80        fn wl_display_add_destroy_listener(*mut wl_display, *mut wl_listener) -> (),
81        fn wl_display_get_destroy_listener(*mut wl_display, wl_notify_func_t) -> *mut wl_listener,
82        fn wl_global_create(*mut wl_display, *const wl_interface, c_int, *mut c_void, wl_global_bind_func_t) -> *mut wl_global,
83        fn wl_display_init_shm(*mut wl_display) -> c_int,
84        fn wl_display_add_client_created_listener(*mut wl_display, *mut wl_listener) -> (),
85        fn wl_display_set_global_filter(*mut wl_display, wl_display_global_filter_func_t, *mut c_void) -> (),
86        fn wl_display_get_client_list(*mut wl_display) -> *mut wl_list,
87        #[cfg(feature = "libwayland_server_1_23")]
88        fn wl_display_set_default_max_buffer_size(*mut wl_display, usize) -> (),
89    // wl_event_loop
90        fn wl_event_loop_create() -> *mut wl_event_loop,
91        fn wl_event_loop_destroy(*mut wl_event_loop) -> (),
92        fn wl_event_loop_add_fd(*mut wl_event_loop, c_int, u32, wl_event_loop_fd_func_t, *mut c_void) -> *mut wl_event_source,
93        fn wl_event_loop_add_timer(*mut wl_event_loop, wl_event_loop_timer_func_t, *mut c_void) -> *mut wl_event_source,
94        fn wl_event_loop_add_signal(*mut wl_event_loop, c_int, wl_event_loop_signal_func_t, *mut c_void) -> *mut wl_event_source,
95        fn wl_event_loop_dispatch(*mut wl_event_loop, c_int) -> c_int,
96        fn wl_event_loop_dispatch_idle(*mut wl_event_loop) -> (),
97        fn wl_event_loop_add_idle(*mut wl_event_loop, wl_event_loop_idle_func_t, *mut c_void) -> *mut wl_event_source,
98        fn wl_event_loop_get_fd(*mut wl_event_loop) -> c_int,
99        fn wl_event_loop_add_destroy_listener(*mut wl_event_loop, *mut wl_listener) -> (),
100        fn wl_event_loop_get_destroy_listener(*mut wl_event_loop, wl_notify_func_t) -> *mut wl_listener,
101    // wl_event_source
102        fn wl_event_source_fd_update(*mut wl_event_source, u32) -> c_int,
103        fn wl_event_source_timer_update(*mut wl_event_source, c_int) -> c_int,
104        fn wl_event_source_remove(*mut wl_event_source) -> c_int,
105        fn wl_event_source_check(*mut wl_event_source) -> (),
106    // wl_global
107        fn wl_global_remove(*mut wl_global) -> (),
108        fn wl_global_destroy(*mut wl_global) -> (),
109        #[cfg(feature = "libwayland_server_1_22")]
110        fn wl_global_get_name(*mut wl_global, *mut wl_client) -> u32,
111        fn wl_global_get_user_data(*const wl_global) -> *mut c_void,
112    // wl_resource
113        fn wl_resource_post_event_array(*mut wl_resource, u32, *mut wl_argument) -> (),
114        fn wl_resource_queue_event_array(*mut wl_resource, u32, *mut wl_argument) -> (),
115        fn wl_resource_post_no_memory(*mut wl_resource) -> (),
116        fn wl_resource_set_implementation(*mut wl_resource, *const c_void, *mut c_void, Option<wl_resource_destroy_func_t>) -> (),
117        fn wl_resource_set_dispatcher(*mut wl_resource, wl_dispatcher_func_t, *const c_void, *mut c_void, Option<wl_resource_destroy_func_t>) -> (),
118        fn wl_resource_destroy(*mut wl_resource) -> (),
119        fn wl_resource_get_client(*mut wl_resource) -> *mut wl_client,
120        fn wl_resource_get_id(*mut wl_resource) -> u32,
121        fn wl_resource_get_link(*mut wl_resource) -> *mut wl_list,
122        fn wl_resource_from_link(*mut wl_list) -> *mut wl_resource,
123        fn wl_resource_find_for_client(*mut wl_list, *mut wl_client) -> (),
124        fn wl_resource_set_user_data(*mut wl_resource, *mut c_void) -> (),
125        fn wl_resource_get_user_data(*mut wl_resource) -> *mut c_void,
126        fn wl_resource_get_version(*mut wl_resource) -> c_int,
127        fn wl_resource_get_class(*mut wl_resource) -> *const c_char,
128        fn wl_resource_set_destructor(*mut wl_resource, Option<wl_resource_destroy_func_t>) -> (),
129        fn wl_resource_instance_of(*mut wl_resource, *const wl_interface, *const c_void) -> c_int,
130        fn wl_resource_add_destroy_listener(*mut wl_resource, *mut wl_listener) -> (),
131        fn wl_resource_get_destroy_listener(*mut wl_resource, wl_notify_func_t) -> *mut wl_listener,
132    // wl_shm
133        fn wl_shm_buffer_begin_access(*mut wl_shm_buffer) -> (),
134        fn wl_shm_buffer_end_access(*mut wl_shm_buffer) -> (),
135        fn wl_shm_buffer_get(*mut wl_resource) -> *mut wl_shm_buffer,
136        fn wl_shm_buffer_get_data(*mut wl_shm_buffer) -> *mut c_void,
137        fn wl_shm_buffer_get_stride(*mut wl_shm_buffer) -> i32,
138        fn wl_shm_buffer_get_format(*mut wl_shm_buffer) -> u32,
139        fn wl_shm_buffer_get_width(*mut wl_shm_buffer) -> i32,
140        fn wl_shm_buffer_get_height(*mut wl_shm_buffer) -> i32,
141    // wl_log
142        fn wl_log_set_handler_server(wl_log_func_t) -> (),
143    // wl_list
144        fn wl_list_init(*mut wl_list) -> (),
145        fn wl_list_insert(*mut wl_list, *mut wl_list) -> (),
146        fn wl_list_remove(*mut wl_list) -> (),
147        fn wl_list_length(*const wl_list) -> c_int,
148        fn wl_list_empty(*const wl_list) -> c_int,
149        fn wl_list_insert_list(*mut wl_list,*mut wl_list) -> (),
150
151    // arrays
152        fn wl_array_init(*mut wl_array) -> (),
153        fn wl_array_release(*mut wl_array) -> (),
154        fn wl_array_add(*mut wl_array,usize) -> (),
155        fn wl_array_copy(*mut wl_array, *mut wl_array) -> (),
156    varargs:
157        fn wl_resource_post_event(*mut wl_resource, u32) -> (),
158        fn wl_resource_queue_event(*mut wl_resource, u32) -> (),
159        fn wl_resource_post_error(*mut wl_resource, u32, *const c_char) -> (),
160);
161
162#[cfg(all(feature = "server", feature = "dlopen"))]
163pub fn wayland_server_option() -> Option<&'static WaylandServer> {
164    static WAYLAND_SERVER_OPTION: Lazy<Option<WaylandServer>> = Lazy::new(||{
165        let versions = ["libwayland-server.so.0", "libwayland-server.so"];
166        for ver in &versions {
167            match unsafe { WaylandServer::open(ver) } {
168                Ok(h) => return Some(h),
169                Err(::dlib::DlError::CantOpen(_)) => continue,
170                Err(::dlib::DlError::MissingSymbol(s)) => {
171                    log::error!("Found library {ver} cannot be used: symbol {s} is missing.");
172                    return None;
173                }
174            }
175        }
176        None
177    });
178
179    WAYLAND_SERVER_OPTION.as_ref()
180}
181
182#[cfg(all(feature = "server", feature = "dlopen"))]
183pub fn wayland_server_handle() -> &'static WaylandServer {
184    static WAYLAND_SERVER_HANDLE: Lazy<&'static WaylandServer> = Lazy::new(|| wayland_server_option().expect("Library libwayland-server.so could not be loaded."));
185
186    &WAYLAND_SERVER_HANDLE
187}
188
189#[cfg(all(feature = "server", not(feature = "dlopen")))]
190pub fn is_lib_available() -> bool {
191    true
192}
193#[cfg(all(feature = "server", feature = "dlopen"))]
194pub fn is_lib_available() -> bool {
195    wayland_server_option().is_some()
196}
197
198#[cfg(feature = "server")]
199pub mod signal {
200    #![allow(clippy::cast_ptr_alignment, clippy::missing_safety_doc)]
201    #[cfg(feature = "dlopen")]
202    use super::wayland_server_handle as wsh;
203    #[cfg(not(feature = "dlopen"))]
204    use super::{wl_list_init, wl_list_insert};
205    use super::{wl_listener, wl_notify_func_t, wl_signal};
206    use crate::common::wl_list;
207    use std::os::raw::c_void;
208    use std::ptr;
209
210    macro_rules! container_of(
211        ($ptr: expr, $container: ident, $field: ident) => {
212            ($ptr as *mut u8).sub(memoffset::offset_of!($container, $field)) as *mut $container
213        }
214    );
215
216    macro_rules! list_for_each(
217        ($pos: ident, $head:expr, $container: ident, $field: ident, $action: block) => {
218            let mut $pos = container_of!((*$head).next, $container, $field);
219            while &mut (*$pos).$field as *mut _ != $head {
220                $action;
221                $pos = container_of!((*$pos).$field.next, $container, $field);
222            }
223        }
224    );
225
226    macro_rules! list_for_each_safe(
227        ($pos: ident, $head: expr, $container: ident, $field: ident, $action: block) => {
228            let mut $pos = container_of!((*$head).next, $container, $field);
229            let mut tmp = container_of!((*$pos).$field.next, $container, $field);
230            while &mut (*$pos).$field as *mut _ != $head {
231                $action;
232                $pos = tmp;
233                tmp = container_of!((*$pos).$field.next, $container, $field);
234            }
235        }
236    );
237
238    pub unsafe fn wl_signal_init(signal: *mut wl_signal) {
239        // Safety: signal is a valid initialized wl_signal
240        ffi_dispatch!(wsh(), wl_list_init, unsafe { &mut (*signal).listener_list });
241    }
242
243    pub unsafe fn wl_signal_add(signal: *mut wl_signal, listener: *mut wl_listener) {
244        // Safety: signal and listener are valid pointers
245        ffi_dispatch!(
246            wsh(),
247            wl_list_insert,
248            unsafe { (*signal).listener_list.prev },
249            unsafe { &mut (*listener).link }
250        )
251    }
252
253    pub unsafe fn wl_signal_get(
254        signal: *mut wl_signal,
255        notify: wl_notify_func_t,
256    ) -> *mut wl_listener {
257        // Safety: the signal pointer is valid
258        unsafe {
259            list_for_each!(l, &mut (*signal).listener_list as *mut wl_list, wl_listener, link, {
260                // nightly only lint
261                #[allow(unknown_lints)]
262                #[allow(unpredictable_function_pointer_comparisons)]
263                if (*l).notify == notify {
264                    return l;
265                }
266            });
267        }
268
269        ptr::null_mut()
270    }
271
272    pub unsafe fn wl_signal_emit(signal: *mut wl_signal, data: *mut c_void) {
273        // Safety: the signal pointer is valid
274        unsafe {
275            list_for_each_safe!(l, &mut (*signal).listener_list as *mut wl_list, wl_listener, link, {
276                ((*l).notify)(l, data);
277            });
278        }
279    }
280
281    #[repr(C)]
282    struct ListenerWithUserData {
283        listener: wl_listener,
284        user_data: *mut c_void,
285    }
286
287    pub fn rust_listener_create(notify: wl_notify_func_t) -> *mut wl_listener {
288        let data = Box::into_raw(Box::new(ListenerWithUserData {
289            listener: wl_listener {
290                link: wl_list { prev: ptr::null_mut(), next: ptr::null_mut() },
291                notify,
292            },
293            user_data: ptr::null_mut(),
294        }));
295
296        // SAFETY: data is a valid pointer for `ListenerWithUserData`.
297        unsafe { std::ptr::addr_of_mut!((*data).listener) }
298    }
299
300    pub unsafe fn rust_listener_get_user_data(listener: *mut wl_listener) -> *mut c_void {
301        // Safety: listener is a valid pointer to a listener created by rust_listener_create
302        let data = unsafe { container_of!(listener, ListenerWithUserData, listener) };
303        unsafe { (*data).user_data }
304    }
305
306    pub unsafe fn rust_listener_set_user_data(listener: *mut wl_listener, user_data: *mut c_void) {
307        // Safety: listener is a valid pointer to a listener created by rust_listener_create
308        let data = unsafe { container_of!(listener, ListenerWithUserData, listener) };
309        unsafe { (*data).user_data = user_data }
310    }
311
312    pub unsafe fn rust_listener_destroy(listener: *mut wl_listener) {
313        // Safety: listener is a valid pointer to a listener created by rust_listener_create
314        let data = unsafe { container_of!(listener, ListenerWithUserData, listener) };
315        let _ = unsafe { Box::from_raw(data) };
316    }
317}