i3
startup.c
Go to the documentation of this file.
1 /*
2  * vim:ts=4:sw=4:expandtab
3  *
4  * i3 - an improved dynamic tiling window manager
5  * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
6  *
7  * startup.c: Startup notification code. Ensures a startup notification context
8  * is setup when launching applications. We store the current
9  * workspace to open windows in that startup notification context on
10  * the appropriate workspace.
11  *
12  */
13 #include "all.h"
14 #include "sd-daemon.h"
15 
16 #include <paths.h>
17 #include <sys/types.h>
18 #include <sys/wait.h>
19 #include <unistd.h>
20 
21 #define SN_API_NOT_YET_FROZEN 1
22 #include <libsn/sn-launcher.h>
23 
24 static TAILQ_HEAD(startup_sequence_head, Startup_Sequence) startup_sequences =
25  TAILQ_HEAD_INITIALIZER(startup_sequences);
26 
27 /*
28  * After 60 seconds, a timeout will be triggered for each startup sequence.
29  *
30  * The timeout will just trigger completion of the sequence, so the normal
31  * completion process takes place (startup_monitor_event will free it).
32  *
33  */
34 static void startup_timeout(EV_P_ ev_timer *w, int revents) {
35  const char *id = sn_launcher_context_get_startup_id(w->data);
36  DLOG("Timeout for startup sequence %s\n", id);
37 
38  struct Startup_Sequence *current, *sequence = NULL;
39  TAILQ_FOREACH (current, &startup_sequences, sequences) {
40  if (strcmp(current->id, id) != 0)
41  continue;
42 
43  sequence = current;
44  break;
45  }
46 
47  /* Unref the context (for the timeout itself, see start_application) */
48  sn_launcher_context_unref(w->data);
49 
50  if (!sequence) {
51  DLOG("Sequence already deleted, nevermind.\n");
52  free(w);
53  return;
54  }
55 
56  /* Complete the startup sequence, will trigger its deletion. */
57  sn_launcher_context_complete(w->data);
58  free(w);
59 }
60 
61 /*
62  * Some applications (such as Firefox) mark a startup sequence as completed
63  * *before* they even map a window. Therefore, we cannot entirely delete the
64  * startup sequence once it’s marked as complete. Instead, we’ll mark it for
65  * deletion in 30 seconds and use that chance to delete old sequences.
66  *
67  * This function returns the number of active (!) startup notifications, that
68  * is, those which are not marked for deletion yet. This is used for changing
69  * the root window cursor.
70  *
71  */
72 static int _prune_startup_sequences(void) {
73  time_t current_time = time(NULL);
74  int active_sequences = 0;
75 
76  /* Traverse the list and delete everything which was marked for deletion 30
77  * seconds ago or earlier. */
78  struct Startup_Sequence *current, *next;
79  for (next = TAILQ_FIRST(&startup_sequences);
80  next != TAILQ_END(&startup_sequences);) {
81  current = next;
82  next = TAILQ_NEXT(next, sequences);
83 
84  if (current->delete_at == 0) {
85  active_sequences++;
86  continue;
87  }
88 
89  if (current_time <= current->delete_at)
90  continue;
91 
92  startup_sequence_delete(current);
93  }
94 
95  return active_sequences;
96 }
97 
98 /*
99  * Deletes a startup sequence, ignoring whether its timeout has elapsed.
100  * Useful when e.g. a window is moved between workspaces and its children
101  * shouldn't spawn on the original workspace.
102  *
103  */
105  assert(sequence != NULL);
106  DLOG("Deleting startup sequence %s, delete_at = %lld, current_time = %lld\n",
107  sequence->id, (long long)sequence->delete_at, (long long)time(NULL));
108 
109  /* Unref the context, will be free()d */
110  sn_launcher_context_unref(sequence->context);
111 
112  /* Delete our internal sequence */
113  TAILQ_REMOVE(&startup_sequences, sequence, sequences);
114 
115  free(sequence->id);
116  free(sequence->workspace);
117  FREE(sequence);
118 }
119 
120 /*
121  * Starts the given application by passing it through a shell. We use double
122  * fork to avoid zombie processes. As the started application’s parent exits
123  * (immediately), the application is reparented to init (process-id 1), which
124  * correctly handles children, so we don’t have to do it :-).
125  *
126  * The shell used to start applications is the system's bourne shell (i.e.,
127  * /bin/sh).
128  *
129  * The no_startup_id flag determines whether a startup notification context
130  * (and ID) should be created, which is the default and encouraged behavior.
131  *
132  */
133 void start_application(const char *command, bool no_startup_id) {
134  SnLauncherContext *context = NULL;
135 
136  if (!no_startup_id) {
137  /* Create a startup notification context to monitor the progress of this
138  * startup. */
139  context = sn_launcher_context_new(sndisplay, conn_screen);
140  sn_launcher_context_set_name(context, "i3");
141  sn_launcher_context_set_description(context, "exec command in i3");
142  /* Chop off everything starting from the first space (if there are any
143  * spaces in the command), since we don’t want the parameters. */
144  char *first_word = sstrdup(command);
145  char *space = strchr(first_word, ' ');
146  if (space)
147  *space = '\0';
148  sn_launcher_context_initiate(context, "i3", first_word, last_timestamp);
149  free(first_word);
150 
151  /* Trigger a timeout after 60 seconds */
152  struct ev_timer *timeout = scalloc(1, sizeof(struct ev_timer));
153  ev_timer_init(timeout, startup_timeout, 60.0, 0.);
154  timeout->data = context;
155  ev_timer_start(main_loop, timeout);
156 
157  LOG("startup id = %s\n", sn_launcher_context_get_startup_id(context));
158 
159  /* Save the ID and current workspace in our internal list of startup
160  * sequences */
162  struct Startup_Sequence *sequence = scalloc(1, sizeof(struct Startup_Sequence));
163  sequence->id = sstrdup(sn_launcher_context_get_startup_id(context));
164  sequence->workspace = sstrdup(ws->name);
165  sequence->context = context;
166  TAILQ_INSERT_TAIL(&startup_sequences, sequence, sequences);
167 
168  /* Increase the refcount once (it starts with 1, so it will be 2 now) for
169  * the timeout. Even if the sequence gets completed, the timeout still
170  * needs the context (but will unref it then) */
171  sn_launcher_context_ref(context);
172  }
173 
174  LOG("executing: %s\n", command);
175  if (fork() == 0) {
176  /* Child process */
177  setsid();
178  setrlimit(RLIMIT_CORE, &original_rlimit_core);
179  /* Close all socket activation file descriptors explicitly, we disabled
180  * FD_CLOEXEC to keep them open when restarting i3. */
181  for (int fd = SD_LISTEN_FDS_START;
183  fd++) {
184  close(fd);
185  }
186  unsetenv("LISTEN_PID");
187  unsetenv("LISTEN_FDS");
188  signal(SIGPIPE, SIG_DFL);
189  if (fork() == 0) {
190  /* Setup the environment variable(s) */
191  if (!no_startup_id)
192  sn_launcher_context_setup_child_process(context);
193  setenv("I3SOCK", current_socketpath, 1);
194 
195  execl(_PATH_BSHELL, _PATH_BSHELL, "-c", command, NULL);
196  /* not reached */
197  }
198  _exit(EXIT_SUCCESS);
199  }
200  wait(0);
201 
202  if (!no_startup_id) {
203  /* Change the pointer of the root window to indicate progress */
205  }
206 }
207 
208 /*
209  * Called by libstartup-notification when something happens
210  *
211  */
212 void startup_monitor_event(SnMonitorEvent *event, void *userdata) {
213  SnStartupSequence *snsequence;
214 
215  snsequence = sn_monitor_event_get_startup_sequence(event);
216 
217  /* Get the corresponding internal startup sequence */
218  const char *id = sn_startup_sequence_get_id(snsequence);
219  struct Startup_Sequence *current, *sequence = NULL;
220  TAILQ_FOREACH (current, &startup_sequences, sequences) {
221  if (strcmp(current->id, id) != 0)
222  continue;
223 
224  sequence = current;
225  break;
226  }
227 
228  if (!sequence) {
229  DLOG("Got event for startup sequence that we did not initiate (ID = %s). Ignoring.\n", id);
230  return;
231  }
232 
233  switch (sn_monitor_event_get_type(event)) {
234  case SN_MONITOR_EVENT_COMPLETED:
235  DLOG("startup sequence %s completed\n", sn_startup_sequence_get_id(snsequence));
236 
237  /* Mark the given sequence for deletion in 30 seconds. */
238  time_t current_time = time(NULL);
239  sequence->delete_at = current_time + 30;
240  DLOG("Will delete startup sequence %s at timestamp %lld\n",
241  sequence->id, (long long)sequence->delete_at);
242 
243  if (_prune_startup_sequences() == 0) {
244  DLOG("No more startup sequences running, changing root window cursor to default pointer.\n");
245  /* Change the pointer of the root window to indicate progress */
247  }
248  break;
249  default:
250  /* ignore */
251  break;
252  }
253 }
254 
255 /*
256  * Renames workspaces that are mentioned in the startup sequences.
257  *
258  */
259 void startup_sequence_rename_workspace(const char *old_name, const char *new_name) {
260  struct Startup_Sequence *current;
261  TAILQ_FOREACH (current, &startup_sequences, sequences) {
262  if (strcmp(current->workspace, old_name) != 0)
263  continue;
264  DLOG("Renaming workspace \"%s\" to \"%s\" in startup sequence %s.\n",
265  old_name, new_name, current->id);
266  free(current->workspace);
267  current->workspace = sstrdup(new_name);
268  }
269 }
270 
271 /*
272  * Gets the stored startup sequence for the _NET_STARTUP_ID of a given window.
273  *
274  */
276  xcb_get_property_reply_t *startup_id_reply, bool ignore_mapped_leader) {
277  /* The _NET_STARTUP_ID is only needed during this function, so we get it
278  * here and don’t save it in the 'cwindow'. */
279  if (startup_id_reply == NULL || xcb_get_property_value_length(startup_id_reply) == 0) {
280  FREE(startup_id_reply);
281  DLOG("No _NET_STARTUP_ID set on window 0x%08x\n", cwindow->id);
282  if (cwindow->leader == XCB_NONE)
283  return NULL;
284 
285  /* This is a special case that causes the leader's startup sequence
286  * to only be returned if it has never been mapped, useful primarily
287  * when trying to delete a sequence.
288  *
289  * It's generally inappropriate to delete a leader's sequence when
290  * moving a child window, but if the leader has no container, it's
291  * likely permanently unmapped and the child is the "real" window. */
292  if (ignore_mapped_leader && con_by_window_id(cwindow->leader) != NULL) {
293  DLOG("Ignoring leader window 0x%08x\n", cwindow->leader);
294  return NULL;
295  }
296 
297  DLOG("Checking leader window 0x%08x\n", cwindow->leader);
298 
299  xcb_get_property_cookie_t cookie;
300 
301  cookie = xcb_get_property(conn, false, cwindow->leader,
302  A__NET_STARTUP_ID, XCB_GET_PROPERTY_TYPE_ANY, 0, 512);
303  startup_id_reply = xcb_get_property_reply(conn, cookie, NULL);
304 
305  if (startup_id_reply == NULL ||
306  xcb_get_property_value_length(startup_id_reply) == 0) {
307  FREE(startup_id_reply);
308  DLOG("No _NET_STARTUP_ID set on the leader either\n");
309  return NULL;
310  }
311  }
312 
313  char *startup_id;
314  sasprintf(&startup_id, "%.*s", xcb_get_property_value_length(startup_id_reply),
315  (char *)xcb_get_property_value(startup_id_reply));
316  struct Startup_Sequence *current, *sequence = NULL;
317  TAILQ_FOREACH (current, &startup_sequences, sequences) {
318  if (strcmp(current->id, startup_id) != 0)
319  continue;
320 
321  sequence = current;
322  break;
323  }
324 
325  if (!sequence) {
326  DLOG("WARNING: This sequence (ID %s) was not found\n", startup_id);
327  free(startup_id);
328  free(startup_id_reply);
329  return NULL;
330  }
331 
332  free(startup_id);
333  free(startup_id_reply);
334 
335  return sequence;
336 }
337 
338 /*
339  * Checks if the given window belongs to a startup notification by checking if
340  * the _NET_STARTUP_ID property is set on the window (or on its leader, if it’s
341  * unset).
342  *
343  * If so, returns the workspace on which the startup was initiated.
344  * Returns NULL otherwise.
345  *
346  */
347 char *startup_workspace_for_window(i3Window *cwindow, xcb_get_property_reply_t *startup_id_reply) {
348  struct Startup_Sequence *sequence = startup_sequence_get(cwindow, startup_id_reply, false);
349  if (sequence == NULL)
350  return NULL;
351 
352  /* If the startup sequence's time span has elapsed, delete it. */
353  time_t current_time = time(NULL);
354  if (sequence->delete_at > 0 && current_time > sequence->delete_at) {
355  DLOG("Deleting expired startup sequence %s\n", sequence->id);
356  startup_sequence_delete(sequence);
357  return NULL;
358  }
359 
360  return sequence->workspace;
361 }
362 
363 /*
364  * Deletes the startup sequence for a window if it exists.
365  *
366  */
368  struct Startup_Sequence *sequence;
369  xcb_get_property_cookie_t cookie;
370  xcb_get_property_reply_t *startup_id_reply;
371 
372  cookie = xcb_get_property(conn, false, win->id, A__NET_STARTUP_ID,
373  XCB_GET_PROPERTY_TYPE_ANY, 0, 512);
374  startup_id_reply = xcb_get_property_reply(conn, cookie, NULL);
375 
376  sequence = startup_sequence_get(win, startup_id_reply, true);
377  if (sequence != NULL) {
378  startup_sequence_delete(sequence);
379  }
380 }
Con * con_get_workspace(Con *con)
Gets the workspace container this node is on.
Definition: con.c:477
Con * con_by_window_id(xcb_window_t window)
Returns the container with the given client window ID or NULL if no such container exists.
Definition: con.c:668
char * current_socketpath
Definition: ipc.c:26
xcb_timestamp_t last_timestamp
The last timestamp we got from X11 (timestamps are included in some events and are used for some thin...
Definition: main.c:64
int conn_screen
Definition: main.c:56
xcb_connection_t * conn
XCB connection and root screen.
Definition: main.c:54
int listen_fds
The number of file descriptors passed via socket activation.
Definition: main.c:46
SnDisplay * sndisplay
Definition: main.c:59
struct rlimit original_rlimit_core
The original value of RLIMIT_CORE when i3 was started.
Definition: main.c:43
struct ev_loop * main_loop
Definition: main.c:79
struct Startup_Sequence * startup_sequence_get(i3Window *cwindow, xcb_get_property_reply_t *startup_id_reply, bool ignore_mapped_leader)
Gets the stored startup sequence for the _NET_STARTUP_ID of a given window.
Definition: startup.c:275
char * startup_workspace_for_window(i3Window *cwindow, xcb_get_property_reply_t *startup_id_reply)
Checks if the given window belongs to a startup notification by checking if the _NET_STARTUP_ID prope...
Definition: startup.c:347
void startup_sequence_delete_by_window(i3Window *win)
Deletes the startup sequence for a window if it exists.
Definition: startup.c:367
static int _prune_startup_sequences(void)
Definition: startup.c:72
void start_application(const char *command, bool no_startup_id)
Starts the given application by passing it through a shell.
Definition: startup.c:133
void startup_sequence_delete(struct Startup_Sequence *sequence)
Deletes a startup sequence, ignoring whether its timeout has elapsed.
Definition: startup.c:104
static TAILQ_HEAD(startup_sequence_head, Startup_Sequence)
Definition: startup.c:24
void startup_sequence_rename_workspace(const char *old_name, const char *new_name)
Renames workspaces that are mentioned in the startup sequences.
Definition: startup.c:259
void startup_monitor_event(SnMonitorEvent *event, void *userdata)
Called by libstartup-notification when something happens.
Definition: startup.c:212
struct Con * focused
Definition: tree.c:13
void xcursor_set_root_cursor(int cursor_id)
Sets the cursor of the root window to the 'pointer' cursor.
Definition: xcursor.c:49
char * sstrdup(const char *str)
Safe-wrapper around strdup which exits if malloc returns NULL (meaning that there is no more memory a...
#define DLOG(fmt,...)
Definition: libi3.h:105
#define LOG(fmt,...)
Definition: libi3.h:95
int sasprintf(char **strp, const char *fmt,...)
Safe-wrapper around asprintf which exits if it returns -1 (meaning that there is no more memory avail...
void * scalloc(size_t num, size_t size)
Safe-wrapper around calloc which exits if malloc returns NULL (meaning that there is no more memory a...
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:347
#define TAILQ_END(head)
Definition: queue.h:337
#define TAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:376
#define TAILQ_FIRST(head)
Definition: queue.h:336
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:402
#define TAILQ_NEXT(elm, field)
Definition: queue.h:338
#define TAILQ_HEAD_INITIALIZER(head)
Definition: queue.h:324
#define SD_LISTEN_FDS_START
Definition: sd-daemon.h:102
#define FREE(pointer)
Definition: util.h:47
@ XCURSOR_CURSOR_WATCH
Definition: xcursor.h:24
@ XCURSOR_CURSOR_POINTER
Definition: xcursor.h:17
Used during the config file lexing/parsing to keep the state of the lexer in order to provide useful ...
Definition: configuration.h:33
Stores internal information about a startup sequence, like the workspace it was initiated on.
Definition: data.h:226
char * id
startup ID for this sequence, generated by libstartup-notification
Definition: data.h:228
time_t delete_at
time at which this sequence should be deleted (after it was marked as completed)
Definition: data.h:235
char * workspace
workspace on which this startup was initiated
Definition: data.h:230
SnLauncherContext * context
libstartup-notification context for this launch
Definition: data.h:232
A 'Window' is a type which contains an xcb_window_t and all the related information (hints like _NET_...
Definition: data.h:394
xcb_window_t id
Definition: data.h:395
xcb_window_t leader
Holds the xcb_window_t (just an ID) for the leader window (logical parent for toolwindows and similar...
Definition: data.h:399
A 'Con' represents everything from the X11 root window down to a single X11 window.
Definition: data.h:613
char * name
Definition: data.h:659