]> git.sur5r.net Git - i3/i3/blob - src/x.c
change many LOG/printf messages to use DLOG
[i3/i3] / src / x.c
1 /*
2  * vim:ts=4:sw=4:expandtab
3  */
4
5 #include "all.h"
6
7 /* Stores the X11 window ID of the currently focused window */
8 static xcb_window_t focused_id = XCB_NONE;
9
10 /*
11  * Describes the X11 state we may modify (map state, position, window stack).
12  * There is one entry per container. The state represents the current situation
13  * as X11 sees it (with the exception of the order in the state_head CIRCLEQ,
14  * which represents the order that will be pushed to X11, while old_state_head
15  * represents the current order). It will be updated in x_push_changes().
16  *
17  */
18 typedef struct con_state {
19     xcb_window_t id;
20     bool mapped;
21     bool child_mapped;
22
23     /* For reparenting, we have a flag (need_reparent) and the X ID of the old
24      * frame this window was in. The latter is necessary because we need to
25      * ignore UnmapNotify events (by changing the window event mask). */
26     bool need_reparent;
27     xcb_window_t old_frame;
28
29     Rect rect;
30     Rect window_rect;
31
32     bool initial;
33
34     char *name;
35
36     CIRCLEQ_ENTRY(con_state) state;
37     CIRCLEQ_ENTRY(con_state) old_state;
38 } con_state;
39
40 CIRCLEQ_HEAD(state_head, con_state) state_head =
41     CIRCLEQ_HEAD_INITIALIZER(state_head);
42
43 CIRCLEQ_HEAD(old_state_head, con_state) old_state_head =
44     CIRCLEQ_HEAD_INITIALIZER(old_state_head);
45
46 /*
47  * Returns the container state for the given frame. This function always
48  * returns a container state (otherwise, there is a bug in the code and the
49  * container state of a container for which x_con_init() was not called was
50  * requested).
51  *
52  */
53 static con_state *state_for_frame(xcb_window_t window) {
54     con_state *state;
55     CIRCLEQ_FOREACH(state, &state_head, state)
56         if (state->id == window)
57             return state;
58
59     /* TODO: better error handling? */
60     ELOG("No state found\n");
61     assert(false);
62     return NULL;
63 }
64
65 /*
66  * Initializes the X11 part for the given container. Called exactly once for
67  * every container from con_new().
68  *
69  */
70 void x_con_init(Con *con) {
71     /* TODO: maybe create the window when rendering first? we could then even
72      * get the initial geometry right */
73
74     uint32_t mask = 0;
75     uint32_t values[2];
76
77     /* our own frames should not be managed */
78     mask |= XCB_CW_OVERRIDE_REDIRECT;
79     values[0] = 1;
80
81     /* We want to know when… */
82     mask |= XCB_CW_EVENT_MASK;
83     values[1] = FRAME_EVENT_MASK;
84
85     Rect dims = { -15, -15, 10, 10 };
86     con->frame = create_window(conn, dims, XCB_WINDOW_CLASS_INPUT_OUTPUT, XCURSOR_CURSOR_POINTER, false, mask, values);
87     con->gc = xcb_generate_id(conn);
88     xcb_create_gc(conn, con->gc, con->frame, 0, 0);
89
90     struct con_state *state = scalloc(sizeof(struct con_state));
91     state->id = con->frame;
92     state->mapped = false;
93     state->initial = true;
94     CIRCLEQ_INSERT_HEAD(&state_head, state, state);
95     CIRCLEQ_INSERT_HEAD(&old_state_head, state, old_state);
96     DLOG("adding new state for window id 0x%08x\n", state->id);
97 }
98
99 /*
100  * Re-initializes the associated X window state for this container. You have
101  * to call this when you assign a client to an empty container to ensure that
102  * its state gets updated correctly.
103  *
104  */
105 void x_reinit(Con *con) {
106     struct con_state *state;
107
108     if ((state = state_for_frame(con->frame)) == NULL) {
109         ELOG("window state not found\n");
110         return;
111     }
112
113     DLOG("resetting state %p to initial\n", state);
114     state->initial = true;
115     state->child_mapped = false;
116     memset(&(state->window_rect), 0, sizeof(Rect));
117 }
118
119 /*
120  * Reparents the child window of the given container (necessary for sticky
121  * containers). The reparenting happens in the next call of x_push_changes().
122  *
123  */
124 void x_reparent_child(Con *con, Con *old) {
125     struct con_state *state;
126     if ((state = state_for_frame(con->frame)) == NULL) {
127         ELOG("window state for con not found\n");
128         return;
129     }
130
131     state->need_reparent = true;
132     state->old_frame = old->frame;
133 }
134
135 /*
136  * Moves a child window from Container src to Container dest.
137  *
138  */
139 void x_move_win(Con *src, Con *dest) {
140     struct con_state *state_src, *state_dest;
141
142     if ((state_src = state_for_frame(src->frame)) == NULL) {
143         ELOG("window state for src not found\n");
144         return;
145     }
146
147     if ((state_dest = state_for_frame(dest->frame)) == NULL) {
148         ELOG("window state for dest not found\n");
149         return;
150     }
151
152     Rect zero;
153     memset(&zero, 0, sizeof(Rect));
154     if (memcmp(&(state_dest->window_rect), &(zero), sizeof(Rect)) == 0) {
155         memcpy(&(state_dest->window_rect), &(state_src->window_rect), sizeof(Rect));
156         DLOG("COPYING RECT\n");
157     }
158 }
159
160 /*
161  * Kills the window decoration associated with the given container.
162  *
163  */
164 void x_con_kill(Con *con) {
165     con_state *state;
166
167     xcb_destroy_window(conn, con->frame);
168     state = state_for_frame(con->frame);
169     CIRCLEQ_REMOVE(&state_head, state, state);
170     CIRCLEQ_REMOVE(&old_state_head, state, old_state);
171     FREE(state->name);
172     free(state);
173
174     /* Invalidate focused_id to correctly focus new windows with the same ID */
175     focused_id = XCB_NONE;
176 }
177
178 /*
179  * Returns true if the client supports the given protocol atom (like WM_DELETE_WINDOW)
180  *
181  */
182 static bool window_supports_protocol(xcb_window_t window, xcb_atom_t atom) {
183     xcb_get_property_cookie_t cookie;
184     xcb_get_wm_protocols_reply_t protocols;
185     bool result = false;
186
187     cookie = xcb_get_wm_protocols_unchecked(conn, window, atoms[WM_PROTOCOLS]);
188     if (xcb_get_wm_protocols_reply(conn, cookie, &protocols, NULL) != 1)
189         return false;
190
191     /* Check if the client’s protocols have the requested atom set */
192     for (uint32_t i = 0; i < protocols.atoms_len; i++)
193         if (protocols.atoms[i] == atom)
194             result = true;
195
196     xcb_get_wm_protocols_reply_wipe(&protocols);
197
198     return result;
199 }
200
201 /*
202  * Kills the given X11 window using WM_DELETE_WINDOW (if supported).
203  *
204  */
205 void x_window_kill(xcb_window_t window) {
206     /* if this window does not support WM_DELETE_WINDOW, we kill it the hard way */
207     if (!window_supports_protocol(window, atoms[WM_DELETE_WINDOW])) {
208         LOG("Killing window the hard way\n");
209         xcb_kill_client(conn, window);
210         return;
211     }
212
213     xcb_client_message_event_t ev;
214
215     memset(&ev, 0, sizeof(xcb_client_message_event_t));
216
217     ev.response_type = XCB_CLIENT_MESSAGE;
218     ev.window = window;
219     ev.type = atoms[WM_PROTOCOLS];
220     ev.format = 32;
221     ev.data.data32[0] = atoms[WM_DELETE_WINDOW];
222     ev.data.data32[1] = XCB_CURRENT_TIME;
223
224     LOG("Sending WM_DELETE to the client\n");
225     xcb_send_event(conn, false, window, XCB_EVENT_MASK_NO_EVENT, (char*)&ev);
226     xcb_flush(conn);
227 }
228
229 /*
230  * Draws the decoration of the given container onto its parent.
231  *
232  */
233 void x_draw_decoration(Con *con) {
234     /* This code needs to run for:
235      *  • leaf containers
236      *  • non-leaf containers which are in a stacking container
237      *
238      * It does not need to run for:
239      *  • floating containers (they don’t have a decoration)
240      */
241     if ((!con_is_leaf(con) && con->parent->layout != L_STACKED) ||
242         con->type == CT_FLOATING_CON)
243         return;
244     DLOG("decoration should be rendered for con %p\n", con);
245
246     /* 1: find out which colors to use */
247     struct Colortriple *color;
248     if (con->urgent)
249         color = &config.client.urgent;
250     else if (con == focused)
251         color = &config.client.focused;
252     else if (con == TAILQ_FIRST(&(con->parent->focus_head)))
253         color = &config.client.focused_inactive;
254     else
255         color = &config.client.unfocused;
256
257     Con *parent = con->parent;
258     int border_style = con_border_style(con);
259
260     /* 2: draw a rectangle in border color around the client */
261     if (border_style != BS_NONE && con_is_leaf(con)) {
262         Rect br = con_border_style_rect(con);
263         Rect *r = &(con->rect);
264 #if 0
265         DLOG("con->rect spans %d x %d\n", con->rect.width, con->rect.height);
266         DLOG("border_rect spans (%d, %d) with %d x %d\n", border_rect.x, border_rect.y, border_rect.width, border_rect.height);
267         DLOG("window_rect spans (%d, %d) with %d x %d\n", con->window_rect.x, con->window_rect.y, con->window_rect.width, con->window_rect.height);
268 #endif
269
270         /* These rectangles represents the border around the child window
271          * (left, bottom and right part). We don’t just fill the whole
272          * rectangle because some childs are not freely resizable and we want
273          * their background color to "shine through". */
274         xcb_change_gc_single(conn, con->gc, XCB_GC_FOREGROUND, color->background);
275         xcb_rectangle_t borders[] = {
276             { 0, 0, br.x, r->height },
277             { 0, r->height + br.height + br.y, r->width, r->height },
278             { r->width + br.width + br.x, 0, r->width, r->height }
279         };
280         xcb_poly_fill_rectangle(conn, con->frame, con->gc, 3, borders);
281         /* 1pixel border needs an additional line at the top */
282         if (border_style == BS_1PIXEL) {
283             xcb_rectangle_t topline = { br.x, 0, con->rect.width + br.width + br.x, br.y };
284             xcb_poly_fill_rectangle(conn, con->frame, con->gc, 1, &topline);
285         }
286     }
287
288     /* if this is a borderless/1pixel window, we don’t * need to render the
289      * decoration. */
290     if (border_style != BS_NORMAL) {
291         DLOG("border style not BS_NORMAL, aborting rendering of decoration\n");
292         return;
293     }
294
295     /* 3: paint the bar */
296     xcb_change_gc_single(conn, parent->gc, XCB_GC_FOREGROUND, color->background);
297     xcb_rectangle_t drect = { con->deco_rect.x, con->deco_rect.y, con->deco_rect.width, con->deco_rect.height };
298     xcb_poly_fill_rectangle(conn, parent->frame, parent->gc, 1, &drect);
299
300     /* 4: draw the two lines in border color */
301     xcb_draw_line(conn, parent->frame, parent->gc, color->border,
302             con->deco_rect.x, /* x */
303             con->deco_rect.y, /* y */
304             con->deco_rect.x + con->deco_rect.width, /* to_x */
305             con->deco_rect.y); /* to_y */
306     xcb_draw_line(conn, parent->frame, parent->gc, color->border,
307             con->deco_rect.x, /* x */
308             con->deco_rect.y + con->deco_rect.height - 1, /* y */
309             con->deco_rect.x + con->deco_rect.width, /* to_x */
310             con->deco_rect.y + con->deco_rect.height - 1); /* to_y */
311
312     /* 5: draw the title */
313     i3Font *font = load_font(conn, config.font);
314     uint32_t mask = XCB_GC_FOREGROUND | XCB_GC_BACKGROUND | XCB_GC_FONT;
315     uint32_t values[] = { color->text, color->background, font->id };
316     xcb_change_gc(conn, parent->gc, mask, values);
317     int text_offset_y = font->height + (con->deco_rect.height - font->height) / 2 - 1;
318
319     struct Window *win = con->window;
320     if (win == NULL || win->name_x == NULL) {
321         /* this is a non-leaf container, we need to make up a good description */
322         // TODO: use a good description instead of just "another container"
323         xcb_image_text_8(
324             conn,
325             strlen("another container"),
326             parent->frame,
327             parent->gc,
328             con->deco_rect.x + 2,
329             con->deco_rect.y + text_offset_y,
330             "another container"
331         );
332         return;
333     }
334
335     int indent_level = 0,
336         indent_mult = 0;
337     Con *il_parent = con->parent;
338     if (il_parent->type != L_STACKED) {
339         while (1) {
340             DLOG("il_parent = %p, layout = %d\n", il_parent, il_parent->layout);
341             if (il_parent->layout == L_STACKED)
342                 indent_level++;
343             if (il_parent->type == CT_WORKSPACE)
344                 break;
345             il_parent = il_parent->parent;
346             indent_mult++;
347         }
348     }
349     DLOG("indent_level = %d, indent_mult = %d\n", indent_level, indent_mult);
350     int indent_px = (indent_level * 5) * indent_mult;
351
352     if (win->uses_net_wm_name)
353         xcb_image_text_16(
354             conn,
355             win->name_len,
356             parent->frame,
357             parent->gc,
358             con->deco_rect.x + 2 + indent_px,
359             con->deco_rect.y + text_offset_y,
360             (xcb_char2b_t*)win->name_x
361         );
362     else
363         xcb_image_text_8(
364             conn,
365             win->name_len,
366             parent->frame,
367             parent->gc,
368             con->deco_rect.x + 2 + indent_px,
369             con->deco_rect.y + text_offset_y,
370             win->name_x
371         );
372 }
373
374 /*
375  * This function pushes the properties of each node of the layout tree to
376  * X11 if they have changed (like the map state, position of the window, …).
377  * It recursively traverses all children of the given node.
378  *
379  */
380 static void x_push_node(Con *con) {
381     Con *current;
382     con_state *state;
383     Rect rect = con->rect;
384
385     DLOG("Pushing changes for node %p / %s\n", con, con->name);
386     state = state_for_frame(con->frame);
387
388     if (state->name != NULL) {
389         DLOG("pushing name %s for con %p\n", state->name, con);
390
391         xcb_change_property(conn, XCB_PROP_MODE_REPLACE, con->frame,
392                             WM_NAME, STRING, 8, strlen(state->name), state->name);
393         FREE(state->name);
394     }
395
396     if (con->window == NULL) {
397         /* Calculate the height of all window decorations which will be drawn on to
398          * this frame. */
399         uint32_t max_y = 0, max_height = 0;
400         TAILQ_FOREACH(current, &(con->nodes_head), nodes) {
401             Rect *dr = &(current->deco_rect);
402             if (dr->y >= max_y && dr->height >= max_height) {
403                 max_y = dr->y;
404                 max_height = dr->height;
405             }
406         }
407         rect.height = max_y + max_height;
408         if (rect.height == 0) {
409             DLOG("Unmapping container because it does not contain anything atm.\n");
410             con->mapped = false;
411         }
412     }
413
414     /* reparent the child window (when the window was moved due to a sticky
415      * container) */
416     if (state->need_reparent && con->window != NULL) {
417         DLOG("Reparenting child window\n");
418
419         /* Temporarily set the event masks to XCB_NONE so that we won’t get
420          * UnmapNotify events (otherwise the handler would close the container).
421          * These events are generated automatically when reparenting. */
422         uint32_t values[] = { XCB_NONE };
423         xcb_change_window_attributes(conn, state->old_frame, XCB_CW_EVENT_MASK, values);
424         xcb_change_window_attributes(conn, con->window->id, XCB_CW_EVENT_MASK, values);
425
426         xcb_reparent_window(conn, con->window->id, con->frame, 0, 0);
427
428         values[0] = FRAME_EVENT_MASK;
429         xcb_change_window_attributes(conn, state->old_frame, XCB_CW_EVENT_MASK, values);
430         values[0] = CHILD_EVENT_MASK;
431         xcb_change_window_attributes(conn, con->window->id, XCB_CW_EVENT_MASK, values);
432
433         state->old_frame = XCB_NONE;
434         state->need_reparent = false;
435
436         con->ignore_unmap++;
437         DLOG("ignore_unmap for reparenting of con %p (win 0x%08x) is now %d\n",
438                 con, con->window->id, con->ignore_unmap);
439     }
440
441     bool fake_notify = false;
442     /* set new position if rect changed */
443     if (memcmp(&(state->rect), &rect, sizeof(Rect)) != 0) {
444         DLOG("setting rect (%d, %d, %d, %d)\n", rect.x, rect.y, rect.width, rect.height);
445         xcb_set_window_rect(conn, con->frame, rect);
446         memcpy(&(state->rect), &rect, sizeof(Rect));
447         fake_notify = true;
448     }
449
450     /* dito, but for child windows */
451     if (con->window != NULL &&
452         memcmp(&(state->window_rect), &(con->window_rect), sizeof(Rect)) != 0) {
453         DLOG("setting window rect (%d, %d, %d, %d)\n",
454             con->window_rect.x, con->window_rect.y, con->window_rect.width, con->window_rect.height);
455         xcb_set_window_rect(conn, con->window->id, con->window_rect);
456         memcpy(&(state->window_rect), &(con->window_rect), sizeof(Rect));
457         fake_notify = true;
458     }
459
460     /* Map if map state changed, also ensure that the child window
461      * is changed if we are mapped *and* in initial state (meaning the
462      * container was empty before, but now got a child). Unmaps are handled in
463      * x_push_node_unmaps(). */
464     if ((state->mapped != con->mapped || (con->mapped && state->initial)) &&
465         con->mapped) {
466         xcb_void_cookie_t cookie;
467
468         if (con->window != NULL) {
469             /* Set WM_STATE_NORMAL because GTK applications don’t want to
470              * drag & drop if we don’t. Also, xprop(1) needs it. */
471             long data[] = { XCB_WM_STATE_NORMAL, XCB_NONE };
472             xcb_change_property(conn, XCB_PROP_MODE_REPLACE, con->window->id,
473                                 atoms[WM_STATE], atoms[WM_STATE], 32, 2, data);
474         }
475
476         if (!state->child_mapped && con->window != NULL) {
477             cookie = xcb_map_window(conn, con->window->id);
478             DLOG("mapping child window (serial %d)\n", cookie.sequence);
479             /* Ignore enter_notifies which are generated when mapping */
480             add_ignore_event(cookie.sequence);
481             state->child_mapped = true;
482         }
483
484         cookie = xcb_map_window(conn, con->frame);
485         DLOG("mapping container (serial %d)\n", cookie.sequence);
486         /* Ignore enter_notifies which are generated when mapping */
487         add_ignore_event(cookie.sequence);
488         state->mapped = con->mapped;
489     }
490
491     if (fake_notify) {
492         DLOG("Sending fake configure notify\n");
493         fake_absolute_configure_notify(con);
494     }
495
496     /* handle all children and floating windows of this node */
497     TAILQ_FOREACH(current, &(con->nodes_head), nodes)
498         x_push_node(current);
499
500     TAILQ_FOREACH(current, &(con->floating_head), floating_windows)
501         x_push_node(current);
502
503     if (con->type != CT_ROOT && con->type != CT_OUTPUT)
504         x_draw_decoration(con);
505 }
506
507 /*
508  * Same idea as in x_push_node(), but this function only unmaps windows. It is
509  * necessary to split this up to handle new fullscreen clients properly: The
510  * new window needs to be mapped and focus needs to be set *before* the
511  * underlying windows are unmapped. Otherwise, focus will revert to the
512  * PointerRoot and will then be set to the new window, generating unnecessary
513  * FocusIn/FocusOut events.
514  *
515  */
516 static void x_push_node_unmaps(Con *con) {
517     Con *current;
518     con_state *state;
519
520     DLOG("Pushing changes (with unmaps) for node %p / %s\n", con, con->name);
521     state = state_for_frame(con->frame);
522
523     /* map/unmap if map state changed, also ensure that the child window
524      * is changed if we are mapped *and* in initial state (meaning the
525      * container was empty before, but now got a child) */
526     if ((state->mapped != con->mapped || (con->mapped && state->initial)) &&
527         !con->mapped) {
528         xcb_void_cookie_t cookie;
529         if (con->window != NULL) {
530             /* Set WM_STATE_WITHDRAWN, it seems like Java apps need it */
531             long data[] = { XCB_WM_STATE_WITHDRAWN, XCB_NONE };
532             xcb_change_property(conn, XCB_PROP_MODE_REPLACE, con->window->id,
533                                 atoms[WM_STATE], atoms[WM_STATE], 32, 2, data);
534         }
535
536         cookie = xcb_unmap_window(conn, con->frame);
537         DLOG("unmapping container (serial %d)\n", cookie.sequence);
538         /* we need to increase ignore_unmap for this container (if it
539          * contains a window) and for every window "under" this one which
540          * contains a window */
541         if (con->window != NULL) {
542             con->ignore_unmap++;
543             DLOG("ignore_unmap for con %p (frame 0x%08x) now %d\n", con, con->frame, con->ignore_unmap);
544         }
545         /* Ignore enter_notifies which are generated when unmapping */
546         add_ignore_event(cookie.sequence);
547         state->mapped = con->mapped;
548     }
549
550     /* handle all children and floating windows of this node */
551     TAILQ_FOREACH(current, &(con->nodes_head), nodes)
552         x_push_node_unmaps(current);
553
554     TAILQ_FOREACH(current, &(con->floating_head), floating_windows)
555         x_push_node_unmaps(current);
556 }
557
558 /*
559  * Pushes all changes (state of each node, see x_push_node() and the window
560  * stack) to X11.
561  *
562  */
563 void x_push_changes(Con *con) {
564     con_state *state;
565
566     DLOG("\n\n PUSHING CHANGES\n\n");
567     x_push_node(con);
568
569     DLOG("-- PUSHING WINDOW STACK --\n");
570     bool order_changed = false;
571     /* X11 correctly represents the stack if we push it from bottom to top */
572     CIRCLEQ_FOREACH_REVERSE(state, &state_head, state) {
573         DLOG("stack: 0x%08x\n", state->id);
574         con_state *prev = CIRCLEQ_PREV(state, state);
575         con_state *old_prev = CIRCLEQ_PREV(state, old_state);
576         if (prev != old_prev)
577             order_changed = true;
578         if ((state->initial || order_changed) && prev != CIRCLEQ_END(&state_head)) {
579             DLOG("Stacking 0x%08x above 0x%08x\n", prev->id, state->id);
580             uint32_t mask = 0;
581             mask |= XCB_CONFIG_WINDOW_SIBLING;
582             mask |= XCB_CONFIG_WINDOW_STACK_MODE;
583             uint32_t values[] = {state->id, XCB_STACK_MODE_ABOVE};
584
585             xcb_configure_window(conn, prev->id, mask, values);
586         }
587         state->initial = false;
588     }
589
590     xcb_window_t to_focus = focused->frame;
591     if (focused->window != NULL)
592         to_focus = focused->window->id;
593
594     DLOG("focused_id = 0x%08x, to_focus = 0x%08x\n", focused_id, to_focus);
595     if (focused_id != to_focus) {
596         if (!focused->mapped) {
597             DLOG("Not updating focus (to %p / %s), focused window is not mapped.\n", focused, focused->name);
598         } else {
599             DLOG("Updating focus (focused: %p / %s)\n", focused, focused->name);
600             xcb_set_input_focus(conn, XCB_INPUT_FOCUS_POINTER_ROOT, to_focus, XCB_CURRENT_TIME);
601             focused_id = to_focus;
602         }
603     }
604
605     xcb_flush(conn);
606     DLOG("\n\n ENDING CHANGES\n\n");
607
608     x_push_node_unmaps(con);
609
610     /* save the current stack as old stack */
611     CIRCLEQ_FOREACH(state, &state_head, state) {
612         CIRCLEQ_REMOVE(&old_state_head, state, old_state);
613         CIRCLEQ_INSERT_TAIL(&old_state_head, state, old_state);
614     }
615     CIRCLEQ_FOREACH(state, &old_state_head, old_state) {
616         DLOG("old stack: 0x%08x\n", state->id);
617     }
618 }
619
620 /*
621  * Raises the specified container in the internal stack of X windows. The
622  * next call to x_push_changes() will make the change visible in X11.
623  *
624  */
625 void x_raise_con(Con *con) {
626     con_state *state;
627     DLOG("raising in new stack: %p / %s\n", con, con->name);
628     state = state_for_frame(con->frame);
629
630     CIRCLEQ_REMOVE(&state_head, state, state);
631     CIRCLEQ_INSERT_HEAD(&state_head, state, state);
632 }
633
634 /*
635  * Sets the WM_NAME property (so, no UTF8, but used only for debugging anyways)
636  * of the given name. Used for properly tagging the windows for easily spotting
637  * i3 windows in xwininfo -root -all.
638  *
639  */
640 void x_set_name(Con *con, const char *name) {
641     struct con_state *state;
642
643     if ((state = state_for_frame(con->frame)) == NULL) {
644         ELOG("window state not found\n");
645         return;
646     }
647
648     FREE(state->name);
649     state->name = sstrdup(name);
650 }