mirror of
https://gitlab.freedesktop.org/wlroots/wlroots.git
synced 2026-04-14 08:22:25 -04:00
57f8cf9cd4
Spawning subprocesses is finicky, and the correct way to do it depends on the current process state which we have no control of. Signal masks, handlers, limits, scheduling and open file descriptors are a few examples of things that inadvertently get inherited and cause issues for either the parent or the child. We introduced a temporary workaround against common issues by clearing signal masks and signal handlers known to cause issues for Xwayland, but this was only a bandaid. Introduce xwayland_spawn_func_t, which allows the compositor to specify an implementation of a process spawner that will be used to launch Xwayland whenever needed. This spawner can then do any cleanup and accounting as the compositor sees fit. The spawner takes 4 arguments: The path to Xwayland, the arguments we have constructed for Xwayland, the environment variables that must be set for Xwayland, and the file descriptors that must have CLOEXEC cleared after fork but before exec to be correctly inherited by Xwayland. A default implementation is provided both for convenience and as a sample for implementers to look at.
76 lines
2 KiB
C
76 lines
2 KiB
C
/*
|
|
* This an unstable interface of wlroots. No guarantees are made regarding the
|
|
* future consistency of this API.
|
|
*/
|
|
#ifndef WLR_USE_UNSTABLE
|
|
#error "Add -DWLR_USE_UNSTABLE to enable unstable wlroots features"
|
|
#endif
|
|
|
|
#ifndef WLR_XWAYLAND_SERVER_H
|
|
#define WLR_XWAYLAND_SERVER_H
|
|
|
|
#include <stdbool.h>
|
|
#include <sys/types.h>
|
|
#include <time.h>
|
|
#include <wayland-server-core.h>
|
|
|
|
/**
|
|
* Xwayland spawn function. pathname and args are compatible with the execv
|
|
* family of functions. envp is a NULL terminated list of enironment variables
|
|
* that must be added before exec, while uncloexec is a -1 terminated list of
|
|
* file descriptors that must have CLOEXEC unset after fork but before exec.
|
|
*/
|
|
typedef bool (*xwayland_spawn_func_t)(char *pathname, char *args[], char *envp[], int uncloexec[]);
|
|
|
|
struct wlr_xwayland_server_options {
|
|
bool lazy;
|
|
bool enable_wm;
|
|
bool no_touch_pointer_emulation;
|
|
bool force_xrandr_emulation;
|
|
int terminate_delay; // in seconds, 0 to terminate immediately
|
|
xwayland_spawn_func_t spawn_handler;
|
|
};
|
|
|
|
struct wlr_xwayland_server {
|
|
struct wl_client *client;
|
|
struct wl_event_source *pipe_source;
|
|
int wm_fd[2], wl_fd[2];
|
|
bool ready;
|
|
|
|
time_t server_start;
|
|
|
|
/* Anything above display is reset on Xwayland restart, rest is conserved */
|
|
|
|
int display;
|
|
char display_name[16];
|
|
int x_fd[2];
|
|
struct wl_event_source *x_fd_read_event[2];
|
|
struct wlr_xwayland_server_options options;
|
|
|
|
struct wl_display *wl_display;
|
|
struct wl_event_source *idle_source;
|
|
|
|
struct {
|
|
struct wl_signal start;
|
|
struct wl_signal ready;
|
|
struct wl_signal destroy;
|
|
} events;
|
|
|
|
void *data;
|
|
|
|
struct {
|
|
struct wl_listener client_destroy;
|
|
struct wl_listener display_destroy;
|
|
} WLR_PRIVATE;
|
|
};
|
|
|
|
struct wlr_xwayland_server_ready_event {
|
|
struct wlr_xwayland_server *server;
|
|
int wm_fd;
|
|
};
|
|
|
|
struct wlr_xwayland_server *wlr_xwayland_server_create(
|
|
struct wl_display *display, struct wlr_xwayland_server_options *options);
|
|
void wlr_xwayland_server_destroy(struct wlr_xwayland_server *server);
|
|
|
|
#endif
|