1 2 3 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 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255
use std::env;
use std::ffi::{OsStr, OsString};
use std::io::{Error as IoError, ErrorKind, Result as IoResult};
use std::os::unix::io::{IntoRawFd, RawFd};
use std::path::PathBuf;
#[cfg(feature = "use_system_lib")]
use wayland_sys::server::wl_display;
use crate::imp::DisplayInner;
use crate::{Client, Filter, Global, Interface, Main, Resource};
/// The wayland display
///
/// This is the core of your wayland server, this object must
/// be kept alive as long as your server is running. It allows
/// you to manage listening sockets and clients.
pub struct Display {
inner: DisplayInner,
}
impl std::fmt::Debug for Display {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
f.write_str("Display { ... }")
}
}
impl Display {
/// Create a new display
///
/// This method provides you a `Display` and inserts it into an existing
/// `calloop::EventLoop`.
///
/// Note that at this point, your server is not yet ready to receive connections,
/// your need to add listening sockets using the `add_socket*` methods.
#[allow(clippy::new_without_default)]
pub fn new() -> Display {
Display { inner: DisplayInner::new() }
}
/// Create a new global object
///
/// This object will be advertised to all clients, and they will
/// be able to instantiate it from their registries.
///
/// Your filter will receinve an event whenever a client instantiates
/// this global.
///
/// The version specified is the **highest supported version**, you must
/// be able to handle clients that choose to instantiate this global with
/// a lower version number.
pub fn create_global<I, E>(&mut self, version: u32, filter: Filter<E>) -> Global<I>
where
I: Interface + AsRef<Resource<I>> + From<Resource<I>>,
E: From<(Main<I>, u32)> + 'static,
{
assert!(
version <= I::VERSION,
"Cannot create global {} with version {}, maximum protocol version is {}.",
I::NAME,
version,
I::VERSION
);
Global::create(self.inner.create_global(
version,
move |main, id, ddata| filter.send((main, id).into(), ddata),
None::<fn(_) -> bool>,
))
}
/// Create a new global object with a client filter
///
/// This object will only be advertized to clients for which your
/// client filter closure returns `true`. Note that this client filter cannot
/// access the `DispatchData` as it may be invoked outside of a dispatch. As
/// such it should only rely on the client-associated user-data to make its
/// decision.
///
/// Your event filter will be receive an event whenever a client instantiates
/// this global.
///
/// The version specified is the **highest supported version**, you must
/// be able to handle clients that choose to instantiate this global with
/// a lower version number.
pub fn create_global_with_filter<I, E, F>(
&mut self,
version: u32,
filter: Filter<E>,
mut client_filter: F,
) -> Global<I>
where
I: Interface + AsRef<Resource<I>> + From<Resource<I>>,
E: From<(Main<I>, u32)> + 'static,
F: FnMut(Client) -> bool + 'static,
{
assert!(
version <= I::VERSION,
"Cannot create global {} with version {}, maximum protocol version is {}.",
I::NAME,
version,
I::VERSION
);
Global::create(self.inner.create_global(
version,
move |main, id, ddata| filter.send((main, id).into(), ddata),
Some(move |client_inner| client_filter(Client::make(client_inner))),
))
}
/// Flush events to the clients
///
/// Will send as many pending events as possible to the respective sockets of the clients.
/// Will not block, but might not send everything if the socket buffer fills up.
///
/// The provided `data` will be mutably accessible from all the callbacks that may be called
/// during this (destructors notably) via the [`DispatchData`](struct.DispatchData.html) mechanism.
/// If you don't need global data, you can just provide a `&mut ()` there.
pub fn flush_clients<T: std::any::Any>(&mut self, data: &mut T) {
let data = crate::DispatchData::wrap(data);
self.inner.flush_clients(data)
}
/// Dispatches all pending messages to their respective filters
///
/// This method will block waiting for messages until one of these occur:
///
/// - Some messages are received, in which case all pending messages are processed
/// - The timeout is reached
/// - An error occurs
///
/// If `timeout` is a duration of 0, this function will only process pending messages and then
/// return, not blocking.
///
/// The provided `data` will be mutably accessible from all the callbacks, via the
/// [`DispatchData`](struct.DispatchData.html) mechanism. If you don't need global data, you
/// can just provide a `&mut ()` there.
///
/// In general for good performance you will want to integrate the `Display` into your own event loop,
/// monitoring the file descriptor retrieved by the `get_poll_fd()` method, and only calling this method
/// when messages are available, with a timeout of `0`.
pub fn dispatch<T: std::any::Any>(
&mut self,
timeout: std::time::Duration,
data: &mut T,
) -> IoResult<()> {
let data = crate::DispatchData::wrap(data);
let ms = timeout.as_millis();
let clamped_timeout = if ms > std::i32::MAX as u128 { std::i32::MAX } else { ms as i32 };
self.inner.dispatch(clamped_timeout, data)
}
/// Retrieve the underlying file descriptor
///
/// This file descriptor can be monitored for activity with a poll/epoll like mechanism.
/// When it becomes readable, this means that there are pending messages that would be dispatched if
/// you call `dispatch` with a timeout of 0.
///
/// You should not use this file descriptor for any other purpose than monitoring it.
pub fn get_poll_fd(&self) -> RawFd {
self.inner.get_poll_fd()
}
}
impl Display {
/// Add a listening socket to this display
///
/// Wayland clients will be able to connect to your compositor from this socket.
///
/// Socket will be created in the directory specified by the environment variable
/// `XDG_RUNTIME_DIR`.
///
/// If a name is provided, it is used. Otherwise, if `WAYLAND_DISPLAY` environment
/// variable is set, its contents are used as socket name. Otherwise, `wayland-0` is used.
///
/// Errors if `name` contains an interior null, or if `XDG_RUNTIME_DIR` is not set,
/// or if specified could not be bound (either it is already used or the compositor
/// does not have the rights to create it).
pub fn add_socket<S>(&mut self, name: Option<S>) -> IoResult<()>
where
S: AsRef<OsStr>,
{
self.inner.add_socket(name)
}
/// Add an automatically named listening socket to this display
///
/// Wayland clients will be able to connect to your compositor from this socket.
///
/// Socket will be created in the directory specified by the environment variable
/// `XDG_RUNTIME_DIR`. The directory is scanned for any name in the form `wayland-$d` with
/// `0 <= $d < 32` and the first available one is used.
///
/// Errors if `XDG_RUNTIME_DIR` is not set, or all 32 names are already in use.
pub fn add_socket_auto(&mut self) -> IoResult<OsString> {
self.inner.add_socket_auto()
}
/// Add existing listening socket to this display
///
/// Wayland clients will be able to connect to your compositor from this socket.
///
/// The existing socket fd must already be created, opened, and locked.
/// The fd must be properly set to CLOEXEC and bound to a socket file
/// with both bind() and listen() already called. An error is returned
/// otherwise.
pub fn add_socket_from<T>(&mut self, socket: T) -> IoResult<()>
where
T: IntoRawFd,
{
unsafe { self.add_socket_fd(socket.into_raw_fd()) }
}
/// Add existing listening socket to this display from a raw file descriptor
///
/// Wayland clients will be able to connect to your compositor from this socket.
///
/// The library takes ownership of the provided socket if this method returns
/// successfully.
///
/// # Safety
///
/// The existing socket fd must already be created, opened, and locked.
/// The fd must be properly set to CLOEXEC and bound to a socket file
/// with both bind() and listen() already called. An error is returned
/// otherwise.
pub unsafe fn add_socket_fd(&mut self, fd: RawFd) -> IoResult<()> {
self.inner.add_socket_fd(fd)
}
/// Create a new client to this display from an already-existing connected Fd
///
/// # Safety
///
/// The provided file descriptor must be associated to a valid client connection.
pub unsafe fn create_client<T: std::any::Any>(&mut self, fd: RawFd, data: &mut T) -> Client {
let data = crate::DispatchData::wrap(data);
Client::make(self.inner.create_client(fd, data))
}
}
#[cfg(feature = "use_system_lib")]
impl Display {
/// Retrieve a pointer from the C lib to this `wl_display`
pub fn c_ptr(&self) -> *mut wl_display {
self.inner.ptr()
}
}
pub(crate) fn get_runtime_dir() -> IoResult<PathBuf> {
match env::var_os("XDG_RUNTIME_DIR") {
Some(s) => Ok(s.into()),
None => Err(IoError::new(ErrorKind::NotFound, "XDG_RUNTIME_DIR env variable is not set")),
}
}