i3
manage.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  * manage.c: Initially managing new windows (or existing ones on restart).
8  *
9  */
10 #include "all.h"
11 
12 #include "yajl_utils.h"
13 
14 #include <yajl/yajl_gen.h>
15 
16 /*
17  * Match frame and window depth. This is needed because X will refuse to reparent a
18  * window whose background is ParentRelative under a window with a different depth.
19  *
20  */
21 static xcb_window_t _match_depth(i3Window *win, Con *con) {
22  xcb_window_t old_frame = XCB_NONE;
23  if (con->depth != win->depth) {
24  old_frame = con->frame.id;
25  con->depth = win->depth;
26  x_con_reframe(con);
27  }
28  return old_frame;
29 }
30 
31 /*
32  * Remove all match criteria, the first swallowed window wins.
33  *
34  */
35 static void _remove_matches(Con *con) {
36  while (!TAILQ_EMPTY(&(con->swallow_head))) {
37  Match *first = TAILQ_FIRST(&(con->swallow_head));
38  TAILQ_REMOVE(&(con->swallow_head), first, matches);
39  match_free(first);
40  free(first);
41  }
42 }
43 
44 /*
45  * Go through all existing windows (if the window manager is restarted) and manage them
46  *
47  */
48 void manage_existing_windows(xcb_window_t root) {
49  xcb_query_tree_reply_t *reply;
50  int i, len;
51  xcb_window_t *children;
52  xcb_get_window_attributes_cookie_t *cookies;
53 
54  /* Get the tree of windows whose parent is the root window (= all) */
55  if ((reply = xcb_query_tree_reply(conn, xcb_query_tree(conn, root), 0)) == NULL)
56  return;
57 
58  len = xcb_query_tree_children_length(reply);
59  cookies = smalloc(len * sizeof(*cookies));
60 
61  /* Request the window attributes for every window */
62  children = xcb_query_tree_children(reply);
63  for (i = 0; i < len; ++i)
64  cookies[i] = xcb_get_window_attributes(conn, children[i]);
65 
66  /* Call manage_window with the attributes for every window */
67  for (i = 0; i < len; ++i)
68  manage_window(children[i], cookies[i], true);
69 
70  free(reply);
71  free(cookies);
72 }
73 
74 /*
75  * Restores the geometry of each window by reparenting it to the root window
76  * at the position of its frame.
77  *
78  * This is to be called *only* before exiting/restarting i3 because of evil
79  * side-effects which are to be expected when continuing to run i3.
80  *
81  */
82 void restore_geometry(void) {
83  DLOG("Restoring geometry\n");
84 
85  Con *con;
87  if (con->window) {
88  DLOG("Re-adding X11 border of %d px\n", con->border_width);
89  con->window_rect.width += (2 * con->border_width);
90  con->window_rect.height += (2 * con->border_width);
92  DLOG("placing window %08x at %d %d\n", con->window->id, con->rect.x, con->rect.y);
93  xcb_reparent_window(conn, con->window->id, root,
94  con->rect.x, con->rect.y);
95  }
96 
97  /* Strictly speaking, this line doesn’t really belong here, but since we
98  * are syncing, let’s un-register as a window manager first */
99  xcb_change_window_attributes(conn, root, XCB_CW_EVENT_MASK, (uint32_t[]){XCB_EVENT_MASK_SUBSTRUCTURE_REDIRECT});
100 
101  /* Make sure our changes reach the X server, we restart/exit now */
102  xcb_aux_sync(conn);
103 }
104 
105 /*
106  * Do some sanity checks and then reparent the window.
107  *
108  */
109 void manage_window(xcb_window_t window, xcb_get_window_attributes_cookie_t cookie,
110  bool needs_to_be_mapped) {
111  DLOG("window 0x%08x\n", window);
112 
113  xcb_drawable_t d = {window};
114  xcb_get_geometry_cookie_t geomc;
115  xcb_get_geometry_reply_t *geom;
116  xcb_get_window_attributes_reply_t *attr = NULL;
117 
118  xcb_get_property_cookie_t wm_type_cookie, strut_cookie, state_cookie,
119  utf8_title_cookie, title_cookie,
120  class_cookie, leader_cookie, transient_cookie,
121  role_cookie, startup_id_cookie, wm_hints_cookie,
122  wm_normal_hints_cookie, motif_wm_hints_cookie, wm_user_time_cookie, wm_desktop_cookie;
123 
124  geomc = xcb_get_geometry(conn, d);
125 
126  /* Check if the window is mapped (it could be not mapped when intializing and
127  calling manage_window() for every window) */
128  if ((attr = xcb_get_window_attributes_reply(conn, cookie, 0)) == NULL) {
129  DLOG("Could not get attributes\n");
130  xcb_discard_reply(conn, geomc.sequence);
131  return;
132  }
133 
134  if (needs_to_be_mapped && attr->map_state != XCB_MAP_STATE_VIEWABLE) {
135  xcb_discard_reply(conn, geomc.sequence);
136  goto out;
137  }
138 
139  /* Don’t manage clients with the override_redirect flag */
140  if (attr->override_redirect) {
141  xcb_discard_reply(conn, geomc.sequence);
142  goto out;
143  }
144 
145  /* Check if the window is already managed */
146  if (con_by_window_id(window) != NULL) {
147  DLOG("already managed (by con %p)\n", con_by_window_id(window));
148  xcb_discard_reply(conn, geomc.sequence);
149  goto out;
150  }
151 
152  /* Get the initial geometry (position, size, …) */
153  if ((geom = xcb_get_geometry_reply(conn, geomc, 0)) == NULL) {
154  DLOG("could not get geometry\n");
155  goto out;
156  }
157 
158  uint32_t values[1];
159 
160  /* Set a temporary event mask for the new window, consisting only of
161  * PropertyChange and StructureNotify. We need to be notified of
162  * PropertyChanges because the client can change its properties *after* we
163  * requested them but *before* we actually reparented it and have set our
164  * final event mask.
165  * We need StructureNotify because the client may unmap the window before
166  * we get to re-parent it.
167  * If this request fails, we assume the client has already unmapped the
168  * window between the MapRequest and our event mask change. */
169  values[0] = XCB_EVENT_MASK_PROPERTY_CHANGE |
170  XCB_EVENT_MASK_STRUCTURE_NOTIFY;
171  xcb_void_cookie_t event_mask_cookie =
172  xcb_change_window_attributes_checked(conn, window, XCB_CW_EVENT_MASK, values);
173  if (xcb_request_check(conn, event_mask_cookie) != NULL) {
174  LOG("Could not change event mask, the window probably already disappeared.\n");
175  goto out;
176  }
177 
178 #define GET_PROPERTY(atom, len) xcb_get_property(conn, false, window, atom, XCB_GET_PROPERTY_TYPE_ANY, 0, len)
179 
180  wm_type_cookie = GET_PROPERTY(A__NET_WM_WINDOW_TYPE, UINT32_MAX);
181  strut_cookie = GET_PROPERTY(A__NET_WM_STRUT_PARTIAL, UINT32_MAX);
182  state_cookie = GET_PROPERTY(A__NET_WM_STATE, UINT32_MAX);
183  utf8_title_cookie = GET_PROPERTY(A__NET_WM_NAME, 128);
184  leader_cookie = GET_PROPERTY(A_WM_CLIENT_LEADER, UINT32_MAX);
185  transient_cookie = GET_PROPERTY(XCB_ATOM_WM_TRANSIENT_FOR, UINT32_MAX);
186  title_cookie = GET_PROPERTY(XCB_ATOM_WM_NAME, 128);
187  class_cookie = GET_PROPERTY(XCB_ATOM_WM_CLASS, 128);
188  role_cookie = GET_PROPERTY(A_WM_WINDOW_ROLE, 128);
189  startup_id_cookie = GET_PROPERTY(A__NET_STARTUP_ID, 512);
190  wm_hints_cookie = xcb_icccm_get_wm_hints(conn, window);
191  wm_normal_hints_cookie = xcb_icccm_get_wm_normal_hints(conn, window);
192  motif_wm_hints_cookie = GET_PROPERTY(A__MOTIF_WM_HINTS, 5 * sizeof(uint64_t));
193  wm_user_time_cookie = GET_PROPERTY(A__NET_WM_USER_TIME, UINT32_MAX);
194  wm_desktop_cookie = GET_PROPERTY(A__NET_WM_DESKTOP, UINT32_MAX);
195 
196  i3Window *cwindow = scalloc(1, sizeof(i3Window));
197  cwindow->id = window;
198  cwindow->depth = get_visual_depth(attr->visual);
199 
200  int *buttons = bindings_get_buttons_to_grab();
201  xcb_grab_buttons(conn, window, buttons);
202  FREE(buttons);
203 
204  /* update as much information as possible so far (some replies may be NULL) */
205  window_update_class(cwindow, xcb_get_property_reply(conn, class_cookie, NULL));
206  window_update_name_legacy(cwindow, xcb_get_property_reply(conn, title_cookie, NULL));
207  window_update_name(cwindow, xcb_get_property_reply(conn, utf8_title_cookie, NULL));
208  window_update_leader(cwindow, xcb_get_property_reply(conn, leader_cookie, NULL));
209  window_update_transient_for(cwindow, xcb_get_property_reply(conn, transient_cookie, NULL));
210  window_update_strut_partial(cwindow, xcb_get_property_reply(conn, strut_cookie, NULL));
211  window_update_role(cwindow, xcb_get_property_reply(conn, role_cookie, NULL));
212  bool urgency_hint;
213  window_update_hints(cwindow, xcb_get_property_reply(conn, wm_hints_cookie, NULL), &urgency_hint);
214  border_style_t motif_border_style = BS_NORMAL;
215  window_update_motif_hints(cwindow, xcb_get_property_reply(conn, motif_wm_hints_cookie, NULL), &motif_border_style);
216  window_update_normal_hints(cwindow, xcb_get_property_reply(conn, wm_normal_hints_cookie, NULL), geom);
217  xcb_get_property_reply_t *type_reply = xcb_get_property_reply(conn, wm_type_cookie, NULL);
218  xcb_get_property_reply_t *state_reply = xcb_get_property_reply(conn, state_cookie, NULL);
219 
220  xcb_get_property_reply_t *startup_id_reply;
221  startup_id_reply = xcb_get_property_reply(conn, startup_id_cookie, NULL);
222  char *startup_ws = startup_workspace_for_window(cwindow, startup_id_reply);
223  DLOG("startup workspace = %s\n", startup_ws);
224 
225  /* Get _NET_WM_DESKTOP if it was set. */
226  xcb_get_property_reply_t *wm_desktop_reply;
227  wm_desktop_reply = xcb_get_property_reply(conn, wm_desktop_cookie, NULL);
228  cwindow->wm_desktop = NET_WM_DESKTOP_NONE;
229  if (wm_desktop_reply != NULL && xcb_get_property_value_length(wm_desktop_reply) != 0) {
230  uint32_t *wm_desktops = xcb_get_property_value(wm_desktop_reply);
231  cwindow->wm_desktop = (int32_t)wm_desktops[0];
232  }
233  FREE(wm_desktop_reply);
234 
235  /* check if the window needs WM_TAKE_FOCUS */
236  cwindow->needs_take_focus = window_supports_protocol(cwindow->id, A_WM_TAKE_FOCUS);
237 
238  /* read the preferred _NET_WM_WINDOW_TYPE atom */
239  cwindow->window_type = xcb_get_preferred_window_type(type_reply);
240 
241  /* Where to start searching for a container that swallows the new one? */
242  Con *search_at = croot;
243 
244  if (xcb_reply_contains_atom(type_reply, A__NET_WM_WINDOW_TYPE_DOCK)) {
245  LOG("This window is of type dock\n");
246  Output *output = get_output_containing(geom->x, geom->y);
247  if (output != NULL) {
248  DLOG("Starting search at output %s\n", output_primary_name(output));
249  search_at = output->con;
250  }
251 
252  /* find out the desired position of this dock window */
253  if (cwindow->reserved.top > 0 && cwindow->reserved.bottom == 0) {
254  DLOG("Top dock client\n");
255  cwindow->dock = W_DOCK_TOP;
256  } else if (cwindow->reserved.top == 0 && cwindow->reserved.bottom > 0) {
257  DLOG("Bottom dock client\n");
258  cwindow->dock = W_DOCK_BOTTOM;
259  } else {
260  DLOG("Ignoring invalid reserved edges (_NET_WM_STRUT_PARTIAL), using position as fallback:\n");
261  if (geom->y < (int16_t)(search_at->rect.height / 2)) {
262  DLOG("geom->y = %d < rect.height / 2 = %d, it is a top dock client\n",
263  geom->y, (search_at->rect.height / 2));
264  cwindow->dock = W_DOCK_TOP;
265  } else {
266  DLOG("geom->y = %d >= rect.height / 2 = %d, it is a bottom dock client\n",
267  geom->y, (search_at->rect.height / 2));
268  cwindow->dock = W_DOCK_BOTTOM;
269  }
270  }
271  }
272 
273  DLOG("Initial geometry: (%d, %d, %d, %d)\n", geom->x, geom->y, geom->width, geom->height);
274 
275  /* See if any container swallows this new window */
276  Match *match = NULL;
277  Con *nc = con_for_window(search_at, cwindow, &match);
278  const bool match_from_restart_mode = (match && match->restart_mode);
279  if (nc == NULL) {
280  Con *wm_desktop_ws = NULL;
281  Assignment *assignment;
282 
283  /* If not, check if it is assigned to a specific workspace */
284  if ((assignment = assignment_for(cwindow, A_TO_WORKSPACE)) ||
285  (assignment = assignment_for(cwindow, A_TO_WORKSPACE_NUMBER))) {
286  DLOG("Assignment matches (%p)\n", match);
287 
288  Con *assigned_ws = NULL;
289  if (assignment->type == A_TO_WORKSPACE_NUMBER) {
290  long parsed_num = ws_name_to_number(assignment->dest.workspace);
291 
292  assigned_ws = get_existing_workspace_by_num(parsed_num);
293  }
294  /* A_TO_WORKSPACE type assignment or fallback from A_TO_WORKSPACE_NUMBER
295  * when the target workspace number does not exist yet. */
296  if (!assigned_ws) {
297  assigned_ws = workspace_get(assignment->dest.workspace, NULL);
298  }
299 
300  nc = con_descend_tiling_focused(assigned_ws);
301  DLOG("focused on ws %s: %p / %s\n", assigned_ws->name, nc, nc->name);
302  if (nc->type == CT_WORKSPACE)
303  nc = tree_open_con(nc, cwindow);
304  else
305  nc = tree_open_con(nc->parent, cwindow);
306 
307  /* set the urgency hint on the window if the workspace is not visible */
308  if (!workspace_is_visible(assigned_ws))
309  urgency_hint = true;
310  } else if (cwindow->wm_desktop != NET_WM_DESKTOP_NONE &&
311  cwindow->wm_desktop != NET_WM_DESKTOP_ALL &&
312  (wm_desktop_ws = ewmh_get_workspace_by_index(cwindow->wm_desktop)) != NULL) {
313  /* If _NET_WM_DESKTOP is set to a specific desktop, we open it
314  * there. Note that we ignore the special value 0xFFFFFFFF here
315  * since such a window will be made sticky anyway. */
316 
317  DLOG("Using workspace %p / %s because _NET_WM_DESKTOP = %d.\n",
318  wm_desktop_ws, wm_desktop_ws->name, cwindow->wm_desktop);
319 
320  nc = con_descend_tiling_focused(wm_desktop_ws);
321  if (nc->type == CT_WORKSPACE)
322  nc = tree_open_con(nc, cwindow);
323  else
324  nc = tree_open_con(nc->parent, cwindow);
325  } else if (startup_ws) {
326  /* If it was started on a specific workspace, we want to open it there. */
327  DLOG("Using workspace on which this application was started (%s)\n", startup_ws);
328  nc = con_descend_tiling_focused(workspace_get(startup_ws, NULL));
329  DLOG("focused on ws %s: %p / %s\n", startup_ws, nc, nc->name);
330  if (nc->type == CT_WORKSPACE)
331  nc = tree_open_con(nc, cwindow);
332  else
333  nc = tree_open_con(nc->parent, cwindow);
334  } else {
335  /* If not, insert it at the currently focused position */
336  if (focused->type == CT_CON && con_accepts_window(focused)) {
337  LOG("using current container, focused = %p, focused->name = %s\n",
338  focused, focused->name);
339  nc = focused;
340  } else
341  nc = tree_open_con(NULL, cwindow);
342  }
343 
344  if ((assignment = assignment_for(cwindow, A_TO_OUTPUT))) {
345  con_move_to_output_name(nc, assignment->dest.output, true);
346  }
347  } else {
348  /* M_BELOW inserts the new window as a child of the one which was
349  * matched (e.g. dock areas) */
350  if (match != NULL && match->insert_where == M_BELOW) {
351  nc = tree_open_con(nc, cwindow);
352  }
353 
354  /* If M_BELOW is not used, the container is replaced. This happens with
355  * "swallows" criteria that are used for stored layouts, in which case
356  * we need to remove that criterion, because they should only be valid
357  * once. */
358  if (match != NULL && match->insert_where != M_BELOW) {
359  DLOG("Removing match %p from container %p\n", match, nc);
360  TAILQ_REMOVE(&(nc->swallow_head), match, matches);
361  match_free(match);
362  FREE(match);
363  }
364  }
365 
366  DLOG("new container = %p\n", nc);
367  if (nc->window != NULL && nc->window != cwindow) {
368  if (!restore_kill_placeholder(nc->window->id)) {
369  DLOG("Uh?! Container without a placeholder, but with a window, has swallowed this to-be-managed window?!\n");
370  } else {
371  /* Remove remaining criteria, the first swallowed window wins. */
372  _remove_matches(nc);
373  }
374  }
375  xcb_window_t old_frame = XCB_NONE;
376  if (nc->window != cwindow && nc->window != NULL) {
377  window_free(nc->window);
378  old_frame = _match_depth(cwindow, nc);
379  }
380  nc->window = cwindow;
381  x_reinit(nc);
382 
383  nc->border_width = geom->border_width;
384 
385  char *name;
386  sasprintf(&name, "[i3 con] container around %p", cwindow);
387  x_set_name(nc, name);
388  free(name);
389 
390  /* handle fullscreen containers */
391  Con *ws = con_get_workspace(nc);
393 
394  if (xcb_reply_contains_atom(state_reply, A__NET_WM_STATE_FULLSCREEN)) {
395  /* If this window is already fullscreen (after restarting!), skip
396  * toggling fullscreen, that would drop it out of fullscreen mode. */
397  if (fs != nc) {
398  Output *output = get_output_with_dimensions((Rect){geom->x, geom->y, geom->width, geom->height});
399  /* If the requested window geometry spans the whole area
400  * of an output, move the window to that output. This is
401  * needed e.g. for LibreOffice Impress multi-monitor
402  * presentations to work out of the box. */
403  if (output != NULL)
404  con_move_to_output(nc, output, false);
406  }
407  fs = NULL;
408  }
409 
410  bool set_focus = false;
411 
412  if (fs == NULL) {
413  DLOG("Not in fullscreen mode, focusing\n");
414  if (!cwindow->dock) {
415  /* Check that the workspace is visible and on the same output as
416  * the current focused container. If the window was assigned to an
417  * invisible workspace, we should not steal focus. */
418  Con *current_output = con_get_output(focused);
419  Con *target_output = con_get_output(ws);
420 
421  if (workspace_is_visible(ws) && current_output == target_output) {
422  if (!match_from_restart_mode) {
423  set_focus = true;
424  } else {
425  DLOG("not focusing, matched with restart_mode == true\n");
426  }
427  } else {
428  DLOG("workspace not visible, not focusing\n");
429  }
430  } else {
431  DLOG("dock, not focusing\n");
432  }
433  } else {
434  DLOG("fs = %p, ws = %p, not focusing\n", fs, ws);
435  /* Insert the new container in focus stack *after* the currently
436  * focused (fullscreen) con. This way, the new container will be
437  * focused after we return from fullscreen mode */
438  Con *first = TAILQ_FIRST(&(nc->parent->focus_head));
439  if (first != nc) {
440  /* We only modify the focus stack if the container is not already
441  * the first one. This can happen when existing containers swallow
442  * new windows, for example when restarting. */
443  TAILQ_REMOVE(&(nc->parent->focus_head), nc, focused);
444  TAILQ_INSERT_AFTER(&(nc->parent->focus_head), first, nc, focused);
445  }
446  }
447 
448  /* set floating if necessary */
449  bool want_floating = false;
450  if (xcb_reply_contains_atom(type_reply, A__NET_WM_WINDOW_TYPE_DIALOG) ||
451  xcb_reply_contains_atom(type_reply, A__NET_WM_WINDOW_TYPE_UTILITY) ||
452  xcb_reply_contains_atom(type_reply, A__NET_WM_WINDOW_TYPE_TOOLBAR) ||
453  xcb_reply_contains_atom(type_reply, A__NET_WM_WINDOW_TYPE_SPLASH) ||
454  xcb_reply_contains_atom(state_reply, A__NET_WM_STATE_MODAL) ||
455  (cwindow->max_width > 0 && cwindow->max_height > 0 &&
456  cwindow->min_height == cwindow->max_height &&
457  cwindow->min_width == cwindow->max_width)) {
458  LOG("This window is a dialog window, setting floating\n");
459  want_floating = true;
460  }
461 
462  if (xcb_reply_contains_atom(state_reply, A__NET_WM_STATE_STICKY))
463  nc->sticky = true;
464 
465  /* We ignore the hint for an internal workspace because windows in the
466  * scratchpad also have this value, but upon restarting i3 we don't want
467  * them to become sticky windows. */
468  if (cwindow->wm_desktop == NET_WM_DESKTOP_ALL && (ws == NULL || !con_is_internal(ws))) {
469  DLOG("This window has _NET_WM_DESKTOP = 0xFFFFFFFF. Will float it and make it sticky.\n");
470  nc->sticky = true;
471  want_floating = true;
472  }
473 
474  FREE(state_reply);
475  FREE(type_reply);
476 
477  if (cwindow->transient_for != XCB_NONE ||
478  (cwindow->leader != XCB_NONE &&
479  cwindow->leader != cwindow->id &&
480  con_by_window_id(cwindow->leader) != NULL)) {
481  LOG("This window is transient for another window, setting floating\n");
482  want_floating = true;
483 
484  if (config.popup_during_fullscreen == PDF_LEAVE_FULLSCREEN &&
485  fs != NULL) {
486  LOG("There is a fullscreen window, leaving fullscreen mode\n");
488  } else if (config.popup_during_fullscreen == PDF_SMART &&
489  fs != NULL &&
490  fs->window != NULL) {
491  i3Window *transient_win = cwindow;
492  while (transient_win != NULL &&
493  transient_win->transient_for != XCB_NONE) {
494  if (transient_win->transient_for == fs->window->id) {
495  LOG("This floating window belongs to the fullscreen window (popup_during_fullscreen == smart)\n");
496  set_focus = true;
497  break;
498  }
499  Con *next_transient = con_by_window_id(transient_win->transient_for);
500  if (next_transient == NULL)
501  break;
502  /* Some clients (e.g. x11-ssh-askpass) actually set
503  * WM_TRANSIENT_FOR to their own window id, so break instead of
504  * looping endlessly. */
505  if (transient_win == next_transient->window)
506  break;
507  transient_win = next_transient->window;
508  }
509  }
510  }
511 
512  /* dock clients cannot be floating, that makes no sense */
513  if (cwindow->dock)
514  want_floating = false;
515 
516  /* Store the requested geometry. The width/height gets raised to at least
517  * 75x50 when entering floating mode, which is the minimum size for a
518  * window to be useful (smaller windows are usually overlays/toolbars/…
519  * which are not managed by the wm anyways). We store the original geometry
520  * here because it’s used for dock clients. */
521  if (nc->geometry.width == 0)
522  nc->geometry = (Rect){geom->x, geom->y, geom->width, geom->height};
523 
524  if (motif_border_style != BS_NORMAL) {
525  DLOG("MOTIF_WM_HINTS specifies decorations (border_style = %d)\n", motif_border_style);
526  if (want_floating) {
528  } else {
529  con_set_border_style(nc, motif_border_style, config.default_border_width);
530  }
531  }
532 
533  if (want_floating) {
534  DLOG("geometry = %d x %d\n", nc->geometry.width, nc->geometry.height);
535  /* automatically set the border to the default value if a motif border
536  * was not specified */
537  bool automatic_border = (motif_border_style == BS_NORMAL);
538 
539  floating_enable(nc, automatic_border);
540  }
541 
542  /* explicitly set the border width to the default */
543  if (nc->current_border_width == -1) {
545  }
546 
547  /* to avoid getting an UnmapNotify event due to reparenting, we temporarily
548  * declare no interest in any state change event of this window */
549  values[0] = XCB_NONE;
550  xcb_change_window_attributes(conn, window, XCB_CW_EVENT_MASK, values);
551 
552  xcb_void_cookie_t rcookie = xcb_reparent_window_checked(conn, window, nc->frame.id, 0, 0);
553  if (xcb_request_check(conn, rcookie) != NULL) {
554  LOG("Could not reparent the window, aborting\n");
555  goto geom_out;
556  }
557 
558  values[0] = CHILD_EVENT_MASK & ~XCB_EVENT_MASK_ENTER_WINDOW;
559  xcb_change_window_attributes(conn, window, XCB_CW_EVENT_MASK, values);
560  xcb_flush(conn);
561 
562  /* Put the client inside the save set. Upon termination (whether killed or
563  * normal exit does not matter) of the window manager, these clients will
564  * be correctly reparented to their most closest living ancestor (=
565  * cleanup) */
566  xcb_change_save_set(conn, XCB_SET_MODE_INSERT, window);
567 
568  if (shape_supported) {
569  /* Receive ShapeNotify events whenever the client altered its window
570  * shape. */
571  xcb_shape_select_input(conn, window, true);
572 
573  /* Check if the window is shaped. Sadly, we can check only for the
574  * bounding shape, not for the input shape. */
575  xcb_shape_query_extents_cookie_t cookie =
576  xcb_shape_query_extents(conn, window);
577  xcb_shape_query_extents_reply_t *reply =
578  xcb_shape_query_extents_reply(conn, cookie, NULL);
579  if (reply != NULL && reply->bounding_shaped) {
580  cwindow->shaped = true;
581  }
582  FREE(reply);
583  }
584 
585  /* Check if any assignments match */
586  run_assignments(cwindow);
587 
588  /* 'ws' may be invalid because of the assignments, e.g. when the user uses
589  * "move window to workspace 1", but had it assigned to workspace 2. */
590  ws = con_get_workspace(nc);
591 
592  /* If this window was put onto an invisible workspace (via assignments), we
593  * render this workspace. It wouldn’t be rendered in our normal code path
594  * because only the visible workspaces get rendered.
595  *
596  * By rendering the workspace, we assign proper coordinates (read: not
597  * width=0, height=0) to the window, which is important for windows who
598  * actually use them to position their GUI elements, e.g. rhythmbox. */
599  if (ws && !workspace_is_visible(ws)) {
600  /* This is a bit hackish: we need to copy the content container’s rect
601  * to the workspace, because calling render_con() on the content
602  * container would also take the shortcut and not render the invisible
603  * workspace at all. However, just calling render_con() on the
604  * workspace isn’t enough either — it needs the rect. */
605  ws->rect = ws->parent->rect;
606  render_con(ws, false);
607  /* Disable setting focus, otherwise we’d move focus to an invisible
608  * workspace, which we generally prevent (e.g. in
609  * con_move_to_workspace). */
610  set_focus = false;
611  }
612  render_con(croot, false);
613 
614  cwindow->managed_since = time(NULL);
615 
616  /* Send an event about window creation */
617  ipc_send_window_event("new", nc);
618 
619  if (set_focus && assignment_for(cwindow, A_NO_FOCUS) != NULL) {
620  /* The first window on a workspace should always be focused. We have to
621  * compare with == 1 because the container has already been inserted at
622  * this point. */
623  if (con_num_windows(ws) == 1) {
624  DLOG("This is the first window on this workspace, ignoring no_focus.\n");
625  } else {
626  DLOG("no_focus was set for con = %p, not setting focus.\n", nc);
627  set_focus = false;
628  }
629  }
630 
631  if (set_focus) {
632  DLOG("Checking con = %p for _NET_WM_USER_TIME.\n", nc);
633 
634  uint32_t *wm_user_time;
635  xcb_get_property_reply_t *wm_user_time_reply = xcb_get_property_reply(conn, wm_user_time_cookie, NULL);
636  if (wm_user_time_reply != NULL && xcb_get_property_value_length(wm_user_time_reply) != 0 &&
637  (wm_user_time = xcb_get_property_value(wm_user_time_reply)) &&
638  wm_user_time[0] == 0) {
639  DLOG("_NET_WM_USER_TIME set to 0, not focusing con = %p.\n", nc);
640  set_focus = false;
641  }
642 
643  FREE(wm_user_time_reply);
644  } else {
645  xcb_discard_reply(conn, wm_user_time_cookie.sequence);
646  }
647 
648  if (set_focus) {
649  /* Even if the client doesn't want focus, we still need to focus the
650  * container to not break focus workflows. Our handling towards X will
651  * take care of not setting the input focus. However, one exception to
652  * this are clients using the globally active input model which we
653  * don't want to focus at all. */
655  set_focus = false;
656  }
657  }
658 
659  /* Defer setting focus after the 'new' event has been sent to ensure the
660  * proper window event sequence. */
661  if (set_focus && nc->mapped) {
662  DLOG("Now setting focus.\n");
663  con_activate(nc);
664  }
665 
666  tree_render();
667 
668  /* Destroy the old frame if we had to reframe the container. This needs to be done
669  * after rendering in order to prevent the background from flickering in its place. */
670  if (old_frame != XCB_NONE) {
671  xcb_destroy_window(conn, old_frame);
672  }
673 
674  /* Windows might get managed with the urgency hint already set (Pidgin is
675  * known to do that), so check for that and handle the hint accordingly.
676  * This code needs to be in this part of manage_window() because the window
677  * needs to be on the final workspace first. */
678  con_set_urgency(nc, urgency_hint);
679 
680  /* Update _NET_WM_DESKTOP. We invalidate the cached value first to force an update. */
681  cwindow->wm_desktop = NET_WM_DESKTOP_NONE;
683 
684  /* If a sticky window was mapped onto another workspace, make sure to pop it to the front. */
686 
687 geom_out:
688  free(geom);
689 out:
690  free(attr);
691 }
692 
693 /*
694  * Remanages a window: performs a swallow check and runs assignments.
695  * Returns con for the window regardless if it updated.
696  *
697  */
699  Match *match;
700  Con *nc = con_for_window(croot, con->window, &match);
701  if (nc == NULL || nc->window == NULL || nc->window == con->window) {
702  run_assignments(con->window);
703  return con;
704  }
705  /* Make sure the placeholder that wants to swallow this window didn't spawn
706  * after the window to follow current behavior: adding a placeholder won't
707  * swallow windows currently managed. */
708  if (nc->window->managed_since > con->window->managed_since) {
709  run_assignments(con->window);
710  return con;
711  }
712 
713  if (!restore_kill_placeholder(nc->window->id)) {
714  DLOG("Uh?! Container without a placeholder, but with a window, has swallowed this managed window?!\n");
715  } else {
716  _remove_matches(nc);
717  }
718  window_free(nc->window);
719 
720  xcb_window_t old_frame = _match_depth(con->window, nc);
721 
722  x_reparent_child(nc, con);
723 
724  bool moved_workpaces = (con_get_workspace(nc) != con_get_workspace(con));
725 
726  con_merge_into(con, nc);
727 
728  /* Destroy the old frame if we had to reframe the container. This needs to be done
729  * after rendering in order to prevent the background from flickering in its place. */
730  if (old_frame != XCB_NONE) {
731  xcb_destroy_window(conn, old_frame);
732  }
733 
734  run_assignments(nc->window);
735 
736  if (moved_workpaces) {
737  /* If the window is associated with a startup sequence, delete it so
738  * child windows won't be created on the old workspace. */
740 
742  }
743 
744  return nc;
745 }
con_num_windows
int con_num_windows(Con *con)
Count the number of windows (i.e., leaf containers).
Definition: con.c:959
Con::parent
struct Con * parent
Definition: data.h:672
get_existing_workspace_by_num
Con * get_existing_workspace_by_num(int num)
Returns the workspace with the given number or NULL if such a workspace does not exist.
Definition: workspace.c:44
window_update_role
void window_update_role(i3Window *win, xcb_get_property_reply_t *prop)
Updates the WM_WINDOW_ROLE.
Definition: window.c:212
Window::transient_for
xcb_window_t transient_for
Definition: data.h:436
con_by_window_id
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:647
window_update_name_legacy
void window_update_name_legacy(i3Window *win, xcb_get_property_reply_t *prop)
Updates the name by using WM_NAME (encoded in COMPOUND_TEXT).
Definition: window.c:98
tree_render
void tree_render(void)
Renders the tree, that is rendering all outputs using render_con() and pushing the changes to X11 usi...
Definition: tree.c:449
LOG
#define LOG(fmt,...)
Definition: libi3.h:94
NET_WM_DESKTOP_NONE
#define NET_WM_DESKTOP_NONE
Definition: workspace.h:24
assignment_for
Assignment * assignment_for(i3Window *window, int type)
Returns the first matching assignment for the given window.
Definition: assignments.c:69
ewmh_get_workspace_by_index
Con * ewmh_get_workspace_by_index(uint32_t idx)
Returns the workspace container as enumerated by the EWMH desktop model.
Definition: ewmh.c:351
Window::min_height
int min_height
Definition: data.h:498
ipc_send_window_event
void ipc_send_window_event(const char *property, Con *con)
For the window events we send, along the usual "change" field, also the window container,...
Definition: ipc.c:1643
Rect::y
uint32_t y
Definition: data.h:178
Window::doesnt_accept_focus
bool doesnt_accept_focus
Whether this window accepts focus.
Definition: data.h:465
TAILQ_INSERT_AFTER
#define TAILQ_INSERT_AFTER(head, listelm, elm, field)
Definition: queue.h:384
window_update_motif_hints
void window_update_motif_hints(i3Window *win, xcb_get_property_reply_t *prop, border_style_t *motif_border_style)
Updates the MOTIF_WM_HINTS.
Definition: window.c:413
con_descend_tiling_focused
Con * con_descend_tiling_focused(Con *con)
Returns the focused con inside this client, descending the tree as far as possible.
Definition: con.c:1531
Con::rect
struct Rect rect
Definition: data.h:676
x_reparent_child
void x_reparent_child(Con *con, Con *old)
Reparents the child window of the given container (necessary for sticky containers).
Definition: x.c:221
CHILD_EVENT_MASK
#define CHILD_EVENT_MASK
The XCB_CW_EVENT_MASK for the child (= real window)
Definition: xcb.h:35
window_update_leader
void window_update_leader(i3Window *win, xcb_get_property_reply_t *prop)
Updates the CLIENT_LEADER (logical parent window).
Definition: window.c:137
window_free
void window_free(i3Window *win)
Frees an i3Window and all its members.
Definition: window.c:16
window_update_strut_partial
void window_update_strut_partial(i3Window *win, xcb_get_property_reply_t *prop)
Updates the _NET_WM_STRUT_PARTIAL (reserved pixels at the screen edges)
Definition: window.c:187
run_assignments
void run_assignments(i3Window *window)
Checks the list of assignments for the given window and runs all matching ones (unless they have alre...
Definition: assignments.c:17
con_move_to_output_name
bool con_move_to_output_name(Con *con, const char *name, bool fix_coordinates)
Moves the given container to the currently focused container on the visible workspace on the output s...
Definition: con.c:1425
x_reinit
void x_reinit(Con *con)
Re-initializes the associated X window state for this container.
Definition: x.c:201
scalloc
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...
x_con_reframe
void x_con_reframe(Con *con)
Definition: x.c:298
border_style_t
border_style_t
Definition: data.h:65
get_output_containing
Output * get_output_containing(unsigned int x, unsigned int y)
Returns the active (!) output which contains the coordinates x, y or NULL if there is no output which...
Definition: randr.c:113
con_merge_into
void con_merge_into(Con *old, Con *new)
Merges container specific data that should move with the window (e.g.
Definition: con.c:2490
Window::dock
enum Window::@13 dock
Whether the window says it is a dock window.
output_primary_name
char * output_primary_name(Output *output)
Retrieves the primary name of an output.
Definition: output.c:51
Con::swallow_head
swallow_head
Definition: data.h:727
Window
A 'Window' is a type which contains an xcb_window_t and all the related information (hints like _NET_...
Definition: data.h:430
Con::mapped
bool mapped
Definition: data.h:638
startup_workspace_for_window
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:353
floating_enable
void floating_enable(Con *con, bool automatic)
Enables floating mode for the given container by detaching it from its parent, creating a new contain...
Definition: floating.c:224
con_move_to_output
void con_move_to_output(Con *con, Output *output, bool fix_coordinates)
Moves the given container to the currently focused container on the visible workspace on the given ou...
Definition: con.c:1410
TAILQ_EMPTY
#define TAILQ_EMPTY(head)
Definition: queue.h:344
all_cons
struct all_cons_head all_cons
Definition: tree.c:15
restore_kill_placeholder
bool restore_kill_placeholder(xcb_window_t placeholder)
Kill the placeholder window, if placeholder refers to a placeholder window.
Definition: restore_layout.c:271
Con::window_rect
struct Rect window_rect
Definition: data.h:679
reservedpx::bottom
uint32_t bottom
Definition: data.h:192
Config::default_floating_border_width
int default_floating_border_width
Definition: configuration.h:107
GET_PROPERTY
#define GET_PROPERTY(atom, len)
ws_name_to_number
long ws_name_to_number(const char *name)
Parses the workspace name as a number.
Definition: util.c:106
all.h
xcb_set_window_rect
void xcb_set_window_rect(xcb_connection_t *conn, xcb_window_t window, Rect r)
Configures the given window to have the size/position specified by given rect.
Definition: xcb.c:117
CF_OUTPUT
@ CF_OUTPUT
Definition: data.h:623
bindings_get_buttons_to_grab
int * bindings_get_buttons_to_grab(void)
Returns a list of buttons that should be grabbed on a window.
Definition: bindings.c:984
DLOG
#define DLOG(fmt,...)
Definition: libi3.h:104
Con::window
struct Window * window
Definition: data.h:708
con_activate
void con_activate(Con *con)
Sets input focus to the given container and raises it to the top.
Definition: con.c:263
restore_geometry
void restore_geometry(void)
Restores the geometry of each window by reparenting it to the root window at the position of its fram...
Definition: manage.c:82
Con::focus_head
focus_head
Definition: data.h:724
Match::restart_mode
bool restart_mode
Definition: data.h:575
xcb_reply_contains_atom
bool xcb_reply_contains_atom(xcb_get_property_reply_t *prop, xcb_atom_t atom)
Returns true if the given reply contains the given data.
Definition: xcb.c:163
TAILQ_FIRST
#define TAILQ_FIRST(head)
Definition: queue.h:336
manage_window
void manage_window(xcb_window_t window, xcb_get_window_attributes_cookie_t cookie, bool needs_to_be_mapped)
Do some sanity checks and then reparent the window.
Definition: manage.c:109
Window::window_type
xcb_atom_t window_type
The _NET_WM_WINDOW_TYPE for this window.
Definition: data.h:468
Config::default_border_width
int default_border_width
Definition: configuration.h:106
NET_WM_DESKTOP_ALL
#define NET_WM_DESKTOP_ALL
Definition: workspace.h:25
FREE
#define FREE(pointer)
Definition: util.h:47
get_output_with_dimensions
Output * get_output_with_dimensions(Rect rect)
Returns the active output which spans exactly the area specified by rect or NULL if there is no outpu...
Definition: randr.c:147
Assignment::dest
union Assignment::@19 dest
destination workspace/command/output, depending on the type
sasprintf
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...
Assignment
An Assignment makes specific windows go to a specific workspace/output or run a command for that wind...
Definition: data.h:586
get_visual_depth
uint16_t get_visual_depth(xcb_visualid_t visual_id)
Get depth of visual specified by visualid.
Definition: xcb.c:200
Con::border_width
int border_width
Definition: data.h:705
window_update_normal_hints
bool window_update_normal_hints(i3Window *win, xcb_get_property_reply_t *reply, xcb_get_geometry_reply_t *geom)
Updates the WM_NORMAL_HINTS.
Definition: window.c:251
xoutput
An Output is a physical output on your graphics driver.
Definition: data.h:395
con_get_output
Con * con_get_output(Con *con)
Gets the output container (first container with CT_OUTPUT in hierarchy) this node is on.
Definition: con.c:439
manage_existing_windows
void manage_existing_windows(xcb_window_t root)
Go through all existing windows (if the window manager is restarted) and manage them.
Definition: manage.c:48
window_update_hints
void window_update_hints(i3Window *win, xcb_get_property_reply_t *prop, bool *urgency_hint)
Updates the WM_HINTS (we only care about the input focus handling part).
Definition: window.c:372
con_is_internal
bool con_is_internal(Con *con)
Returns true if the container is internal, such as __i3_scratch.
Definition: con.c:567
_match_depth
static xcb_window_t _match_depth(i3Window *win, Con *con)
Definition: manage.c:21
Rect::width
uint32_t width
Definition: data.h:179
surface_t::id
xcb_drawable_t id
Definition: libi3.h:563
match_free
void match_free(Match *match)
Frees the given match.
Definition: match.c:241
Window::managed_since
time_t managed_since
Definition: data.h:515
xcb_get_preferred_window_type
xcb_atom_t xcb_get_preferred_window_type(xcb_get_property_reply_t *reply)
Returns the first supported _NET_WM_WINDOW_TYPE atom.
Definition: xcb.c:133
tree_open_con
Con * tree_open_con(Con *con, i3Window *window)
Opens an empty container in the current container.
Definition: tree.c:149
_remove_matches
static void _remove_matches(Con *con)
Definition: manage.c:35
shape_supported
bool shape_supported
Definition: main.c:92
Con::type
enum Con::@20 type
remanage_window
Con * remanage_window(Con *con)
Remanages a window: performs a swallow check and runs assignments.
Definition: manage.c:698
Window::id
xcb_window_t id
Definition: data.h:431
Match
A "match" is a data structure which acts like a mask or expression to match certain windows or not.
Definition: data.h:526
startup_sequence_delete_by_window
void startup_sequence_delete_by_window(i3Window *win)
Deletes the startup sequence for a window if it exists.
Definition: startup.c:373
Rect
struct Rect Rect
Definition: data.h:44
Assignment::type
enum Assignment::@18 type
type of this assignment:
smalloc
void * smalloc(size_t size)
Safe-wrapper around malloc which exits if malloc returns NULL (meaning that there is no more memory a...
Window::max_width
int max_width
Definition: data.h:501
focused
struct Con * focused
Definition: tree.c:13
Window::min_width
int min_width
Definition: data.h:497
con_set_urgency
void con_set_urgency(Con *con, bool urgent)
Set urgency flag to the container, all the parent containers and the workspace.
Definition: con.c:2173
output_push_sticky_windows
void output_push_sticky_windows(Con *old_focus)
Iterates over all outputs and pushes sticky windows to the currently visible workspace on that output...
Definition: output.c:75
xoutput::con
Con * con
Pointer to the Con which represents this output.
Definition: data.h:416
Assignment::output
char * output
Definition: data.h:614
Window::reserved
struct reservedpx reserved
Pixels the window reserves.
Definition: data.h:482
window_update_class
void window_update_class(i3Window *win, xcb_get_property_reply_t *prop)
Updates the WM_CLASS (consisting of the class and instance) for the given window.
Definition: window.c:29
con_for_window
Con * con_for_window(Con *con, i3Window *window, Match **store_match)
Returns the first container below 'con' which wants to swallow this window TODO: priority.
Definition: con.c:827
config
Config config
Definition: config.c:17
TAILQ_FOREACH
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:347
ewmh_update_wm_desktop
void ewmh_update_wm_desktop(void)
Updates _NET_WM_DESKTOP for all windows.
Definition: ewmh.c:182
con_toggle_fullscreen
void con_toggle_fullscreen(Con *con, int fullscreen_mode)
Toggles fullscreen mode for the given container.
Definition: con.c:1033
x_set_name
void x_set_name(Con *con, const char *name)
Sets the WM_NAME property (so, no UTF8, but used only for debugging anyways) of the given name.
Definition: x.c:1381
Con::sticky
bool sticky
Definition: data.h:734
window_update_transient_for
void window_update_transient_for(i3Window *win, xcb_get_property_reply_t *prop)
Updates the TRANSIENT_FOR (logical parent window).
Definition: window.c:162
Con::current_border_width
int current_border_width
Definition: data.h:706
Con::frame
surface_t frame
Definition: data.h:652
Assignment::workspace
char * workspace
Definition: data.h:613
Window::depth
uint16_t depth
Depth of the window.
Definition: data.h:485
reservedpx::top
uint32_t top
Definition: data.h:191
Window::shaped
bool shaped
The window has a nonrectangular shape.
Definition: data.h:509
TAILQ_REMOVE
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:402
Con::geometry
struct Rect geometry
the geometry this window requested when getting mapped
Definition: data.h:684
Con
A 'Con' represents everything from the X11 root window down to a single X11 window.
Definition: data.h:637
xcb_grab_buttons
void xcb_grab_buttons(xcb_connection_t *conn, xcb_window_t window, int *buttons)
Grab the specified buttons on a window when managing it.
Definition: xcb.c:309
Window::max_height
int max_height
Definition: data.h:502
con_accepts_window
bool con_accepts_window(Con *con)
Returns true if this node accepts a window (if the node swallows windows, it might already have swall...
Definition: con.c:420
BS_NORMAL
@ BS_NORMAL
Definition: data.h:65
render_con
void render_con(Con *con, bool already_inset)
"Renders" the given container (and its children), meaning that all rects are updated correctly.
Definition: render.c:42
Window::leader
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:435
workspace_get
Con * workspace_get(const char *num, bool *created)
Returns a pointer to the workspace with the given number (starting at 0), creating the workspace if n...
Definition: workspace.c:129
Rect::height
uint32_t height
Definition: data.h:180
con_get_fullscreen_covering_ws
Con * con_get_fullscreen_covering_ws(Con *ws)
Returns the fullscreen node that covers the given workspace if it exists.
Definition: con.c:552
conn
xcb_connection_t * conn
XCB connection and root screen.
Definition: main.c:44
croot
struct Con * croot
Definition: tree.c:12
con_set_border_style
void con_set_border_style(Con *con, int border_style, int border_width)
Sets the given border style on con, correctly keeping the position/size of a floating window.
Definition: con.c:1741
Con::name
char * name
Definition: data.h:686
yajl_utils.h
Match::insert_where
enum Match::@17 insert_where
root
xcb_window_t root
Definition: main.c:57
Rect::x
uint32_t x
Definition: data.h:177
Con::depth
uint16_t depth
Definition: data.h:797
window_update_name
void window_update_name(i3Window *win, xcb_get_property_reply_t *prop)
Updates the name by using _NET_WM_NAME (encoded in UTF-8) for the given window.
Definition: window.c:62
workspace_is_visible
bool workspace_is_visible(Con *ws)
Returns true if the workspace is currently visible.
Definition: workspace.c:333
window_supports_protocol
bool window_supports_protocol(xcb_window_t window, xcb_atom_t atom)
Returns true if the client supports the given protocol atom (like WM_DELETE_WINDOW)
Definition: x.c:307
con_get_workspace
Con * con_get_workspace(Con *con)
Gets the workspace container this node is on.
Definition: con.c:453
Window::needs_take_focus
bool needs_take_focus
Whether the application needs to receive WM_TAKE_FOCUS.
Definition: data.h:461
Window::wm_desktop
uint32_t wm_desktop
The _NET_WM_DESKTOP for this window.
Definition: data.h:471
Config::popup_during_fullscreen
enum Config::@8 popup_during_fullscreen
What should happen when a new popup is opened during fullscreen mode.
Rect
Stores a rectangle, for example the size of a window, the child window etc.
Definition: data.h:176