i3
commands.c
Go to the documentation of this file.
1 #undef I3__FILE__
2 #define I3__FILE__ "commands.c"
3 /*
4  * vim:ts=4:sw=4:expandtab
5  *
6  * i3 - an improved dynamic tiling window manager
7  * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
8  *
9  * commands.c: all command functions (see commands_parser.c)
10  *
11  */
12 #include <float.h>
13 #include <stdarg.h>
14 
15 #ifdef I3_ASAN_ENABLED
16 #include <sanitizer/lsan_interface.h>
17 #endif
18 
19 #include "all.h"
20 #include "shmlog.h"
21 
22 // Macros to make the YAJL API a bit easier to use.
23 #define y(x, ...) (cmd_output->json_gen != NULL ? yajl_gen_##x(cmd_output->json_gen, ##__VA_ARGS__) : 0)
24 #define ystr(str) (cmd_output->json_gen != NULL ? yajl_gen_string(cmd_output->json_gen, (unsigned char *)str, strlen(str)) : 0)
25 #define ysuccess(success) \
26  do { \
27  if (cmd_output->json_gen != NULL) { \
28  y(map_open); \
29  ystr("success"); \
30  y(bool, success); \
31  y(map_close); \
32  } \
33  } while (0)
34 #define yerror(format, ...) \
35  do { \
36  if (cmd_output->json_gen != NULL) { \
37  char *message; \
38  sasprintf(&message, format, ##__VA_ARGS__); \
39  y(map_open); \
40  ystr("success"); \
41  y(bool, false); \
42  ystr("error"); \
43  ystr(message); \
44  y(map_close); \
45  free(message); \
46  } \
47  } while (0)
48 
51 #define HANDLE_INVALID_MATCH \
52  do { \
53  if (current_match->error != NULL) { \
54  yerror("Invalid match: %s", current_match->error); \
55  return; \
56  } \
57  } while (0)
58 
64 #define HANDLE_EMPTY_MATCH \
65  do { \
66  HANDLE_INVALID_MATCH; \
67  \
68  if (match_is_empty(current_match)) { \
69  while (!TAILQ_EMPTY(&owindows)) { \
70  owindow *ow = TAILQ_FIRST(&owindows); \
71  TAILQ_REMOVE(&owindows, ow, owindows); \
72  free(ow); \
73  } \
74  owindow *ow = smalloc(sizeof(owindow)); \
75  ow->con = focused; \
76  TAILQ_INIT(&owindows); \
77  TAILQ_INSERT_TAIL(&owindows, ow, owindows); \
78  } \
79  } while (0)
80 
81 /*
82  * Returns true if a is definitely greater than b (using the given epsilon)
83  *
84  */
85 static bool definitelyGreaterThan(float a, float b, float epsilon) {
86  return (a - b) > ((fabs(a) < fabs(b) ? fabs(b) : fabs(a)) * epsilon);
87 }
88 
89 /*
90  * Returns the output containing the given container.
91  */
92 static Output *get_output_of_con(Con *con) {
93  Con *output_con = con_get_output(con);
94  Output *output = get_output_by_name(output_con->name);
95  assert(output != NULL);
96 
97  return output;
98 }
99 
100 /*
101  * Checks whether we switched to a new workspace and returns false in that case,
102  * signaling that further workspace switching should be done by the calling function
103  * If not, calls workspace_back_and_forth() if workspace_auto_back_and_forth is set
104  * and return true, signaling that no further workspace switching should occur in the calling function.
105  *
106  */
107 static bool maybe_back_and_forth(struct CommandResultIR *cmd_output, const char *name) {
109 
110  /* If we switched to a different workspace, do nothing */
111  if (strcmp(ws->name, name) != 0)
112  return false;
113 
114  DLOG("This workspace is already focused.\n");
117  cmd_output->needs_tree_render = true;
118  }
119  return true;
120 }
121 
122 /*
123  * Return the passed workspace unless it is the current one and auto back and
124  * forth is enabled, in which case the back_and_forth workspace is returned.
125  */
127  Con *current, *baf;
128 
130  return workspace;
131 
132  current = con_get_workspace(focused);
133 
134  if (current == workspace) {
136  if (baf != NULL) {
137  DLOG("Substituting workspace with back_and_forth, as it is focused.\n");
138  return baf;
139  }
140  }
141 
142  return workspace;
143 }
144 
145 /*******************************************************************************
146  * Criteria functions.
147  ******************************************************************************/
148 
149 /*
150  * Helper data structure for an operation window (window on which the operation
151  * will be performed). Used to build the TAILQ owindows.
152  *
153  */
154 typedef struct owindow {
156  TAILQ_ENTRY(owindow) owindows;
157 } owindow;
158 
159 typedef TAILQ_HEAD(owindows_head, owindow) owindows_head;
160 
161 static owindows_head owindows;
162 
163 /*
164  * Initializes the specified 'Match' data structure and the initial state of
165  * commands.c for matching target windows of a command.
166  *
167  */
169  Con *con;
170  owindow *ow;
171 
172  DLOG("Initializing criteria, current_match = %p\n", current_match);
175  while (!TAILQ_EMPTY(&owindows)) {
176  ow = TAILQ_FIRST(&owindows);
177  TAILQ_REMOVE(&owindows, ow, owindows);
178  free(ow);
179  }
180  TAILQ_INIT(&owindows);
181  /* copy all_cons */
183  ow = smalloc(sizeof(owindow));
184  ow->con = con;
185  TAILQ_INSERT_TAIL(&owindows, ow, owindows);
186  }
187 }
188 
189 /*
190  * A match specification just finished (the closing square bracket was found),
191  * so we filter the list of owindows.
192  *
193  */
195  owindow *next, *current;
196 
197  DLOG("match specification finished, matching...\n");
198  /* copy the old list head to iterate through it and start with a fresh
199  * list which will contain only matching windows */
200  struct owindows_head old = owindows;
201  TAILQ_INIT(&owindows);
202  for (next = TAILQ_FIRST(&old); next != TAILQ_END(&old);) {
203  /* make a copy of the next pointer and advance the pointer to the
204  * next element as we are going to invalidate the element’s
205  * next/prev pointers by calling TAILQ_INSERT_TAIL later */
206  current = next;
207  next = TAILQ_NEXT(next, owindows);
208 
209  DLOG("checking if con %p / %s matches\n", current->con, current->con->name);
210 
211  /* We use this flag to prevent matching on window-less containers if
212  * only window-specific criteria were specified. */
213  bool accept_match = false;
214 
215  if (current_match->con_id != NULL) {
216  accept_match = true;
217 
218  if (current_match->con_id == current->con) {
219  DLOG("con_id matched.\n");
220  } else {
221  DLOG("con_id does not match.\n");
222  FREE(current);
223  continue;
224  }
225  }
226 
227  if (current_match->mark != NULL && !TAILQ_EMPTY(&(current->con->marks_head))) {
228  accept_match = true;
229  bool matched_by_mark = false;
230 
231  mark_t *mark;
232  TAILQ_FOREACH(mark, &(current->con->marks_head), marks) {
233  if (!regex_matches(current_match->mark, mark->name))
234  continue;
235 
236  DLOG("match by mark\n");
237  matched_by_mark = true;
238  break;
239  }
240 
241  if (!matched_by_mark) {
242  DLOG("mark does not match.\n");
243  FREE(current);
244  continue;
245  }
246  }
247 
248  if (current->con->window != NULL) {
249  if (match_matches_window(current_match, current->con->window)) {
250  DLOG("matches window!\n");
251  accept_match = true;
252  } else {
253  DLOG("doesn't match\n");
254  FREE(current);
255  continue;
256  }
257  }
258 
259  if (accept_match) {
260  TAILQ_INSERT_TAIL(&owindows, current, owindows);
261  } else {
262  FREE(current);
263  continue;
264  }
265  }
266 
267  TAILQ_FOREACH(current, &owindows, owindows) {
268  DLOG("matching: %p / %s\n", current->con, current->con->name);
269  }
270 }
271 
272 /*
273  * Interprets a ctype=cvalue pair and adds it to the current match
274  * specification.
275  *
276  */
277 void cmd_criteria_add(I3_CMD, const char *ctype, const char *cvalue) {
278  match_parse_property(current_match, ctype, cvalue);
279 }
280 
281 /*
282  * Implementation of 'move [window|container] [to] workspace
283  * next|prev|next_on_output|prev_on_output|current'.
284  *
285  */
286 void cmd_move_con_to_workspace(I3_CMD, const char *which) {
287  owindow *current;
288 
289  DLOG("which=%s\n", which);
290 
291  /* We have nothing to move:
292  * when criteria was specified but didn't match any window or
293  * when criteria wasn't specified and we don't have any window focused. */
294  if ((!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) ||
295  (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
297  ysuccess(false);
298  return;
299  }
300 
302 
303  /* get the workspace */
304  Con *ws;
305  if (strcmp(which, "next") == 0)
306  ws = workspace_next();
307  else if (strcmp(which, "prev") == 0)
308  ws = workspace_prev();
309  else if (strcmp(which, "next_on_output") == 0)
311  else if (strcmp(which, "prev_on_output") == 0)
313  else if (strcmp(which, "current") == 0)
315  else {
316  ELOG("BUG: called with which=%s\n", which);
317  ysuccess(false);
318  return;
319  }
320 
321  TAILQ_FOREACH(current, &owindows, owindows) {
322  DLOG("matching: %p / %s\n", current->con, current->con->name);
323  con_move_to_workspace(current->con, ws, true, false, false);
324  }
325 
326  cmd_output->needs_tree_render = true;
327  // XXX: default reply for now, make this a better reply
328  ysuccess(true);
329 }
330 
336  owindow *current;
337  Con *ws;
338 
340 
341  if (ws == NULL) {
342  yerror("No workspace was previously active.");
343  return;
344  }
345 
347 
348  TAILQ_FOREACH(current, &owindows, owindows) {
349  DLOG("matching: %p / %s\n", current->con, current->con->name);
350  con_move_to_workspace(current->con, ws, true, false, false);
351  }
352 
353  cmd_output->needs_tree_render = true;
354  // XXX: default reply for now, make this a better reply
355  ysuccess(true);
356 }
357 
358 /*
359  * Implementation of 'move [--no-auto-back-and-forth] [window|container] [to] workspace <name>'.
360  *
361  */
362 void cmd_move_con_to_workspace_name(I3_CMD, const char *name, const char *_no_auto_back_and_forth) {
363  if (strncasecmp(name, "__", strlen("__")) == 0) {
364  LOG("You cannot move containers to i3-internal workspaces (\"%s\").\n", name);
365  ysuccess(false);
366  return;
367  }
368 
369  const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
370  owindow *current;
371 
372  /* We have nothing to move:
373  * when criteria was specified but didn't match any window or
374  * when criteria wasn't specified and we don't have any window focused. */
375  if (!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) {
376  ELOG("No windows match your criteria, cannot move.\n");
377  ysuccess(false);
378  return;
379  } else if (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
381  ysuccess(false);
382  return;
383  }
384 
385  LOG("should move window to workspace %s\n", name);
386  /* get the workspace */
387  Con *ws = workspace_get(name, NULL);
388 
389  if (!no_auto_back_and_forth)
391 
393 
394  TAILQ_FOREACH(current, &owindows, owindows) {
395  DLOG("matching: %p / %s\n", current->con, current->con->name);
396  con_move_to_workspace(current->con, ws, true, false, false);
397  }
398 
399  cmd_output->needs_tree_render = true;
400  // XXX: default reply for now, make this a better reply
401  ysuccess(true);
402 }
403 
404 /*
405  * Implementation of 'move [--no-auto-back-and-forth] [window|container] [to] workspace number <name>'.
406  *
407  */
408 void cmd_move_con_to_workspace_number(I3_CMD, const char *which, const char *_no_auto_back_and_forth) {
409  const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
410  owindow *current;
411 
412  /* We have nothing to move:
413  * when criteria was specified but didn't match any window or
414  * when criteria wasn't specified and we don't have any window focused. */
415  if ((!match_is_empty(current_match) && TAILQ_EMPTY(&owindows)) ||
416  (match_is_empty(current_match) && focused->type == CT_WORKSPACE &&
418  ysuccess(false);
419  return;
420  }
421 
422  LOG("should move window to workspace %s\n", which);
423  /* get the workspace */
424  Con *output, *workspace = NULL;
425 
426  long parsed_num = ws_name_to_number(which);
427 
428  if (parsed_num == -1) {
429  LOG("Could not parse initial part of \"%s\" as a number.\n", which);
430  yerror("Could not parse number \"%s\"", which);
431  return;
432  }
433 
434  TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
435  GREP_FIRST(workspace, output_get_content(output),
436  child->num == parsed_num);
437 
438  if (!workspace) {
439  workspace = workspace_get(which, NULL);
440  }
441 
442  if (!no_auto_back_and_forth)
443  workspace = maybe_auto_back_and_forth_workspace(workspace);
444 
446 
447  TAILQ_FOREACH(current, &owindows, owindows) {
448  DLOG("matching: %p / %s\n", current->con, current->con->name);
449  con_move_to_workspace(current->con, workspace, true, false, false);
450  }
451 
452  cmd_output->needs_tree_render = true;
453  // XXX: default reply for now, make this a better reply
454  ysuccess(true);
455 }
456 
457 static void cmd_resize_floating(I3_CMD, const char *way, const char *direction, Con *floating_con, int px) {
458  LOG("floating resize\n");
459  Rect old_rect = floating_con->rect;
460  Con *focused_con = con_descend_focused(floating_con);
461 
462  /* ensure that resize will take place even if pixel increment is smaller than
463  * height increment or width increment.
464  * fixes #1011 */
465  const i3Window *window = focused_con->window;
466  if (window != NULL) {
467  if (strcmp(direction, "up") == 0 || strcmp(direction, "down") == 0 ||
468  strcmp(direction, "height") == 0) {
469  if (px < 0)
470  px = (-px < window->height_increment) ? -window->height_increment : px;
471  else
472  px = (px < window->height_increment) ? window->height_increment : px;
473  } else if (strcmp(direction, "left") == 0 || strcmp(direction, "right") == 0) {
474  if (px < 0)
475  px = (-px < window->width_increment) ? -window->width_increment : px;
476  else
477  px = (px < window->width_increment) ? window->width_increment : px;
478  }
479  }
480 
481  if (strcmp(direction, "up") == 0) {
482  floating_con->rect.height += px;
483  } else if (strcmp(direction, "down") == 0 || strcmp(direction, "height") == 0) {
484  floating_con->rect.height += px;
485  } else if (strcmp(direction, "left") == 0) {
486  floating_con->rect.width += px;
487  } else {
488  floating_con->rect.width += px;
489  }
490 
491  floating_check_size(floating_con);
492 
493  /* Did we actually resize anything or did the size constraints prevent us?
494  * If we could not resize, exit now to not move the window. */
495  if (memcmp(&old_rect, &(floating_con->rect), sizeof(Rect)) == 0)
496  return;
497 
498  if (strcmp(direction, "up") == 0) {
499  floating_con->rect.y -= (floating_con->rect.height - old_rect.height);
500  } else if (strcmp(direction, "left") == 0) {
501  floating_con->rect.x -= (floating_con->rect.width - old_rect.width);
502  }
503 
504  /* If this is a scratchpad window, don't auto center it from now on. */
505  if (floating_con->scratchpad_state == SCRATCHPAD_FRESH)
506  floating_con->scratchpad_state = SCRATCHPAD_CHANGED;
507 }
508 
509 static bool cmd_resize_tiling_direction(I3_CMD, Con *current, const char *way, const char *direction, int ppt) {
510  LOG("tiling resize\n");
511  Con *second = NULL;
512  Con *first = current;
513  direction_t search_direction;
514  if (!strcmp(direction, "left"))
515  search_direction = D_LEFT;
516  else if (!strcmp(direction, "right"))
517  search_direction = D_RIGHT;
518  else if (!strcmp(direction, "up"))
519  search_direction = D_UP;
520  else
521  search_direction = D_DOWN;
522 
523  bool res = resize_find_tiling_participants(&first, &second, search_direction);
524  if (!res) {
525  LOG("No second container in this direction found.\n");
526  ysuccess(false);
527  return false;
528  }
529 
530  /* get the default percentage */
531  int children = con_num_children(first->parent);
532  LOG("ins. %d children\n", children);
533  double percentage = 1.0 / children;
534  LOG("default percentage = %f\n", percentage);
535 
536  /* resize */
537  LOG("second->percent = %f\n", second->percent);
538  LOG("first->percent before = %f\n", first->percent);
539  if (first->percent == 0.0)
540  first->percent = percentage;
541  if (second->percent == 0.0)
542  second->percent = percentage;
543  double new_first_percent = first->percent + ((double)ppt / 100.0);
544  double new_second_percent = second->percent - ((double)ppt / 100.0);
545  LOG("new_first_percent = %f\n", new_first_percent);
546  LOG("new_second_percent = %f\n", new_second_percent);
547  /* Ensure that the new percentages are positive and greater than
548  * 0.05 to have a reasonable minimum size. */
549  if (definitelyGreaterThan(new_first_percent, 0.05, DBL_EPSILON) &&
550  definitelyGreaterThan(new_second_percent, 0.05, DBL_EPSILON)) {
551  first->percent += ((double)ppt / 100.0);
552  second->percent -= ((double)ppt / 100.0);
553  LOG("first->percent after = %f\n", first->percent);
554  LOG("second->percent after = %f\n", second->percent);
555  } else {
556  LOG("Not resizing, already at minimum size\n");
557  }
558 
559  return true;
560 }
561 
562 static bool cmd_resize_tiling_width_height(I3_CMD, Con *current, const char *way, const char *direction, int ppt) {
563  LOG("width/height resize\n");
564  /* get the appropriate current container (skip stacked/tabbed cons) */
565  while (current->parent->layout == L_STACKED ||
566  current->parent->layout == L_TABBED)
567  current = current->parent;
568 
569  /* Then further go up until we find one with the matching orientation. */
570  orientation_t search_orientation =
571  (strcmp(direction, "width") == 0 ? HORIZ : VERT);
572 
573  while (current->type != CT_WORKSPACE &&
574  current->type != CT_FLOATING_CON &&
575  (con_orientation(current->parent) != search_orientation || con_num_children(current->parent) == 1))
576  current = current->parent;
577 
578  /* get the default percentage */
579  int children = con_num_children(current->parent);
580  LOG("ins. %d children\n", children);
581  double percentage = 1.0 / children;
582  LOG("default percentage = %f\n", percentage);
583 
584  orientation_t orientation = con_orientation(current->parent);
585 
586  if ((orientation == HORIZ &&
587  strcmp(direction, "height") == 0) ||
588  (orientation == VERT &&
589  strcmp(direction, "width") == 0)) {
590  LOG("You cannot resize in that direction. Your focus is in a %s split container currently.\n",
591  (orientation == HORIZ ? "horizontal" : "vertical"));
592  ysuccess(false);
593  return false;
594  }
595 
596  if (children == 1) {
597  LOG("This is the only container, cannot resize.\n");
598  ysuccess(false);
599  return false;
600  }
601 
602  /* Ensure all the other children have a percentage set. */
603  Con *child;
604  TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
605  LOG("child->percent = %f (child %p)\n", child->percent, child);
606  if (child->percent == 0.0)
607  child->percent = percentage;
608  }
609 
610  double new_current_percent = current->percent + ((double)ppt / 100.0);
611  double subtract_percent = ((double)ppt / 100.0) / (children - 1);
612  LOG("new_current_percent = %f\n", new_current_percent);
613  LOG("subtract_percent = %f\n", subtract_percent);
614  /* Ensure that the new percentages are positive and greater than
615  * 0.05 to have a reasonable minimum size. */
616  TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
617  if (child == current)
618  continue;
619  if (!definitelyGreaterThan(child->percent - subtract_percent, 0.05, DBL_EPSILON)) {
620  LOG("Not resizing, already at minimum size (child %p would end up with a size of %.f\n", child, child->percent - subtract_percent);
621  ysuccess(false);
622  return false;
623  }
624  }
625  if (!definitelyGreaterThan(new_current_percent, 0.05, DBL_EPSILON)) {
626  LOG("Not resizing, already at minimum size\n");
627  ysuccess(false);
628  return false;
629  }
630 
631  current->percent += ((double)ppt / 100.0);
632  LOG("current->percent after = %f\n", current->percent);
633 
634  TAILQ_FOREACH(child, &(current->parent->nodes_head), nodes) {
635  if (child == current)
636  continue;
637  child->percent -= subtract_percent;
638  LOG("child->percent after (%p) = %f\n", child, child->percent);
639  }
640 
641  return true;
642 }
643 
644 /*
645  * Implementation of 'resize grow|shrink <direction> [<px> px] [or <ppt> ppt]'.
646  *
647  */
648 void cmd_resize(I3_CMD, const char *way, const char *direction, long resize_px, long resize_ppt) {
649  DLOG("resizing in way %s, direction %s, px %ld or ppt %ld\n", way, direction, resize_px, resize_ppt);
650  if (strcmp(way, "shrink") == 0) {
651  resize_px *= -1;
652  resize_ppt *= -1;
653  }
654 
656 
657  owindow *current;
658  TAILQ_FOREACH(current, &owindows, owindows) {
659  /* Don't handle dock windows (issue #1201) */
660  if (current->con->window && current->con->window->dock) {
661  DLOG("This is a dock window. Not resizing (con = %p)\n)", current->con);
662  continue;
663  }
664 
665  Con *floating_con;
666  if ((floating_con = con_inside_floating(current->con))) {
667  cmd_resize_floating(current_match, cmd_output, way, direction, floating_con, resize_px);
668  } else {
669  if (strcmp(direction, "width") == 0 ||
670  strcmp(direction, "height") == 0) {
672  current->con, way, direction, resize_ppt))
673  return;
674  } else {
676  current->con, way, direction, resize_ppt))
677  return;
678  }
679  }
680  }
681 
682  cmd_output->needs_tree_render = true;
683  // XXX: default reply for now, make this a better reply
684  ysuccess(true);
685 }
686 
687 /*
688  * Implementation of 'resize set <px> [px] <px> [px]'.
689  *
690  */
691 void cmd_resize_set(I3_CMD, long cwidth, long cheight) {
692  DLOG("resizing to %ldx%ld px\n", cwidth, cheight);
693  if (cwidth <= 0 || cheight <= 0) {
694  ELOG("Resize failed: dimensions cannot be negative (was %ldx%ld)\n", cwidth, cheight);
695  return;
696  }
697 
699 
700  owindow *current;
701  TAILQ_FOREACH(current, &owindows, owindows) {
702  Con *floating_con;
703  if ((floating_con = con_inside_floating(current->con))) {
704  floating_resize(floating_con, cwidth, cheight);
705  } else {
706  ELOG("Resize failed: %p not a floating container\n", current->con);
707  }
708  }
709 
710  cmd_output->needs_tree_render = true;
711  // XXX: default reply for now, make this a better reply
712  ysuccess(true);
713 }
714 
715 /*
716  * Implementation of 'border normal|pixel [<n>]', 'border none|1pixel|toggle'.
717  *
718  */
719 void cmd_border(I3_CMD, const char *border_style_str, long border_width) {
720  DLOG("border style should be changed to %s with border width %ld\n", border_style_str, border_width);
721  owindow *current;
722 
724 
725  TAILQ_FOREACH(current, &owindows, owindows) {
726  DLOG("matching: %p / %s\n", current->con, current->con->name);
727  int border_style = current->con->border_style;
728  int con_border_width = border_width;
729 
730  if (strcmp(border_style_str, "toggle") == 0) {
731  border_style++;
732  border_style %= 3;
733  con_border_width = 3;
734  } else {
735  if (strcmp(border_style_str, "normal") == 0) {
736  border_style = BS_NORMAL;
737  } else if (strcmp(border_style_str, "pixel") == 0) {
738  border_style = BS_PIXEL;
739  } else if (strcmp(border_style_str, "1pixel") == 0 ||
740  strcmp(border_style_str, "none") == 0) {
741  border_style = BS_PIXEL;
742  con_border_width = 3;
743  } else {
744  ELOG("BUG: called with border_style=%s\n", border_style_str);
745  ysuccess(false);
746  return;
747  }
748  }
749 
750  con_set_border_style(current->con, border_style, logical_px(con_border_width));
751  }
752 
753  cmd_output->needs_tree_render = true;
754  // XXX: default reply for now, make this a better reply
755  ysuccess(true);
756 }
757 
758 /*
759  * Implementation of 'nop <comment>'.
760  *
761  */
762 void cmd_nop(I3_CMD, const char *comment) {
763  LOG("-------------------------------------------------\n");
764  LOG(" NOP: %s\n", comment);
765  LOG("-------------------------------------------------\n");
766 }
767 
768 /*
769  * Implementation of 'append_layout <path>'.
770  *
771  */
772 void cmd_append_layout(I3_CMD, const char *cpath) {
773  char *path = sstrdup(cpath);
774  LOG("Appending layout \"%s\"\n", path);
775 
776  /* Make sure we allow paths like '~/.i3/layout.json' */
777  path = resolve_tilde(path);
778 
779  json_content_t content = json_determine_content(path);
780  LOG("JSON content = %d\n", content);
781  if (content == JSON_CONTENT_UNKNOWN) {
782  ELOG("Could not determine the contents of \"%s\", not loading.\n", path);
783  yerror("Could not determine the contents of \"%s\".", path);
784  free(path);
785  return;
786  }
787 
788  Con *parent = focused;
789  if (content == JSON_CONTENT_WORKSPACE) {
790  parent = output_get_content(con_get_output(parent));
791  } else {
792  /* We need to append the layout to a split container, since a leaf
793  * container must not have any children (by definition).
794  * Note that we explicitly check for workspaces, since they are okay for
795  * this purpose, but con_accepts_window() returns false for workspaces. */
796  while (parent->type != CT_WORKSPACE && !con_accepts_window(parent))
797  parent = parent->parent;
798  }
799  DLOG("Appending to parent=%p instead of focused=%p\n", parent, focused);
800  char *errormsg = NULL;
801  tree_append_json(parent, path, &errormsg);
802  if (errormsg != NULL) {
803  yerror(errormsg);
804  free(errormsg);
805  /* Note that we continue executing since tree_append_json() has
806  * side-effects — user-provided layouts can be partly valid, partly
807  * invalid, leading to half of the placeholder containers being
808  * created. */
809  } else {
810  ysuccess(true);
811  }
812 
813  // XXX: This is a bit of a kludge. Theoretically, render_con(parent,
814  // false); should be enough, but when sending 'workspace 4; append_layout
815  // /tmp/foo.json', the needs_tree_render == true of the workspace command
816  // is not executed yet and will be batched with append_layout’s
817  // needs_tree_render after the parser finished. We should check if that is
818  // necessary at all.
819  render_con(croot, false);
820 
822 
823  if (content == JSON_CONTENT_WORKSPACE)
824  ipc_send_workspace_event("restored", parent, NULL);
825 
826  free(path);
827  cmd_output->needs_tree_render = true;
828 }
829 
830 /*
831  * Implementation of 'workspace next|prev|next_on_output|prev_on_output'.
832  *
833  */
834 void cmd_workspace(I3_CMD, const char *which) {
835  Con *ws;
836 
837  DLOG("which=%s\n", which);
838 
840  LOG("Cannot switch workspace while in global fullscreen\n");
841  ysuccess(false);
842  return;
843  }
844 
845  if (strcmp(which, "next") == 0)
846  ws = workspace_next();
847  else if (strcmp(which, "prev") == 0)
848  ws = workspace_prev();
849  else if (strcmp(which, "next_on_output") == 0)
851  else if (strcmp(which, "prev_on_output") == 0)
853  else {
854  ELOG("BUG: called with which=%s\n", which);
855  ysuccess(false);
856  return;
857  }
858 
859  workspace_show(ws);
860 
861  cmd_output->needs_tree_render = true;
862  // XXX: default reply for now, make this a better reply
863  ysuccess(true);
864 }
865 
866 /*
867  * Implementation of 'workspace [--no-auto-back-and-forth] number <name>'
868  *
869  */
870 void cmd_workspace_number(I3_CMD, const char *which, const char *_no_auto_back_and_forth) {
871  const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
872  Con *output, *workspace = NULL;
873 
875  LOG("Cannot switch workspace while in global fullscreen\n");
876  ysuccess(false);
877  return;
878  }
879 
880  long parsed_num = ws_name_to_number(which);
881 
882  if (parsed_num == -1) {
883  LOG("Could not parse initial part of \"%s\" as a number.\n", which);
884  yerror("Could not parse number \"%s\"", which);
885  return;
886  }
887 
888  TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
889  GREP_FIRST(workspace, output_get_content(output),
890  child->num == parsed_num);
891 
892  if (!workspace) {
893  LOG("There is no workspace with number %ld, creating a new one.\n", parsed_num);
894  ysuccess(true);
895  workspace_show_by_name(which);
896  cmd_output->needs_tree_render = true;
897  return;
898  }
899  if (!no_auto_back_and_forth && maybe_back_and_forth(cmd_output, workspace->name))
900  return;
901  workspace_show(workspace);
902 
903  cmd_output->needs_tree_render = true;
904  // XXX: default reply for now, make this a better reply
905  ysuccess(true);
906 }
907 
908 /*
909  * Implementation of 'workspace back_and_forth'.
910  *
911  */
914  LOG("Cannot switch workspace while in global fullscreen\n");
915  ysuccess(false);
916  return;
917  }
918 
920 
921  cmd_output->needs_tree_render = true;
922  // XXX: default reply for now, make this a better reply
923  ysuccess(true);
924 }
925 
926 /*
927  * Implementation of 'workspace [--no-auto-back-and-forth] <name>'
928  *
929  */
930 void cmd_workspace_name(I3_CMD, const char *name, const char *_no_auto_back_and_forth) {
931  const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
932 
933  if (strncasecmp(name, "__", strlen("__")) == 0) {
934  LOG("You cannot switch to the i3-internal workspaces (\"%s\").\n", name);
935  ysuccess(false);
936  return;
937  }
938 
940  LOG("Cannot switch workspace while in global fullscreen\n");
941  ysuccess(false);
942  return;
943  }
944 
945  DLOG("should switch to workspace %s\n", name);
946  if (!no_auto_back_and_forth && maybe_back_and_forth(cmd_output, name))
947  return;
949 
950  cmd_output->needs_tree_render = true;
951  // XXX: default reply for now, make this a better reply
952  ysuccess(true);
953 }
954 
955 /*
956  * Implementation of 'mark [--add|--replace] [--toggle] <mark>'
957  *
958  */
959 void cmd_mark(I3_CMD, const char *mark, const char *mode, const char *toggle) {
961 
962  owindow *current = TAILQ_FIRST(&owindows);
963  if (current == NULL) {
964  ysuccess(false);
965  return;
966  }
967 
968  /* Marks must be unique, i.e., no two windows must have the same mark. */
969  if (current != TAILQ_LAST(&owindows, owindows_head)) {
970  yerror("A mark must not be put onto more than one window");
971  return;
972  }
973 
974  DLOG("matching: %p / %s\n", current->con, current->con->name);
975 
976  mark_mode_t mark_mode = (mode == NULL || strcmp(mode, "--replace") == 0) ? MM_REPLACE : MM_ADD;
977  if (toggle != NULL) {
978  con_mark_toggle(current->con, mark, mark_mode);
979  } else {
980  con_mark(current->con, mark, mark_mode);
981  }
982 
983  cmd_output->needs_tree_render = true;
984  // XXX: default reply for now, make this a better reply
985  ysuccess(true);
986 }
987 
988 /*
989  * Implementation of 'unmark [mark]'
990  *
991  */
992 void cmd_unmark(I3_CMD, const char *mark) {
994  con_unmark(NULL, mark);
995  } else {
996  owindow *current;
997  TAILQ_FOREACH(current, &owindows, owindows) {
998  con_unmark(current->con, mark);
999  }
1000  }
1001 
1002  cmd_output->needs_tree_render = true;
1003  // XXX: default reply for now, make this a better reply
1004  ysuccess(true);
1005 }
1006 
1007 /*
1008  * Implementation of 'mode <string>'.
1009  *
1010  */
1011 void cmd_mode(I3_CMD, const char *mode) {
1012  DLOG("mode=%s\n", mode);
1013  switch_mode(mode);
1014 
1015  // XXX: default reply for now, make this a better reply
1016  ysuccess(true);
1017 }
1018 
1019 /*
1020  * Implementation of 'move [window|container] [to] output <str>'.
1021  *
1022  */
1023 void cmd_move_con_to_output(I3_CMD, const char *name) {
1024  DLOG("Should move window to output \"%s\".\n", name);
1026 
1027  owindow *current;
1028  bool had_error = false;
1029  TAILQ_FOREACH(current, &owindows, owindows) {
1030  DLOG("matching: %p / %s\n", current->con, current->con->name);
1031 
1032  Output *current_output = get_output_of_con(current->con);
1033  assert(current_output != NULL);
1034 
1035  Output *output = get_output_from_string(current_output, name);
1036  if (output == NULL) {
1037  ELOG("Could not find output \"%s\", skipping.\n", name);
1038  had_error = true;
1039  continue;
1040  }
1041 
1042  Con *ws = NULL;
1043  GREP_FIRST(ws, output_get_content(output->con), workspace_is_visible(child));
1044  if (ws == NULL) {
1045  ELOG("Could not find a visible workspace on output %p.\n", output);
1046  had_error = true;
1047  continue;
1048  }
1049 
1050  con_move_to_workspace(current->con, ws, true, false, false);
1051  }
1052 
1053  cmd_output->needs_tree_render = true;
1054  ysuccess(!had_error);
1055 }
1056 
1057 /*
1058  * Implementation of 'move [container|window] [to] mark <str>'.
1059  *
1060  */
1061 void cmd_move_con_to_mark(I3_CMD, const char *mark) {
1062  DLOG("moving window to mark \"%s\"\n", mark);
1063 
1065 
1066  bool result = true;
1067  owindow *current;
1068  TAILQ_FOREACH(current, &owindows, owindows) {
1069  DLOG("moving matched window %p / %s to mark \"%s\"\n", current->con, current->con->name, mark);
1070  result &= con_move_to_mark(current->con, mark);
1071  }
1072 
1073  cmd_output->needs_tree_render = true;
1074  ysuccess(result);
1075 }
1076 
1077 /*
1078  * Implementation of 'floating enable|disable|toggle'
1079  *
1080  */
1081 void cmd_floating(I3_CMD, const char *floating_mode) {
1082  owindow *current;
1083 
1084  DLOG("floating_mode=%s\n", floating_mode);
1085 
1087 
1088  TAILQ_FOREACH(current, &owindows, owindows) {
1089  DLOG("matching: %p / %s\n", current->con, current->con->name);
1090  if (strcmp(floating_mode, "toggle") == 0) {
1091  DLOG("should toggle mode\n");
1092  toggle_floating_mode(current->con, false);
1093  } else {
1094  DLOG("should switch mode to %s\n", floating_mode);
1095  if (strcmp(floating_mode, "enable") == 0) {
1096  floating_enable(current->con, false);
1097  } else {
1098  floating_disable(current->con, false);
1099  }
1100  }
1101  }
1102 
1103  cmd_output->needs_tree_render = true;
1104  // XXX: default reply for now, make this a better reply
1105  ysuccess(true);
1106 }
1107 
1108 /*
1109  * Implementation of 'move workspace to [output] <str>'.
1110  *
1111  */
1112 void cmd_move_workspace_to_output(I3_CMD, const char *name) {
1113  DLOG("should move workspace to output %s\n", name);
1114 
1116 
1117  owindow *current;
1118  TAILQ_FOREACH(current, &owindows, owindows) {
1119  Con *ws = con_get_workspace(current->con);
1120  bool success = workspace_move_to_output(ws, name);
1121  if (!success) {
1122  ELOG("Failed to move workspace to output.\n");
1123  ysuccess(false);
1124  return;
1125  }
1126  }
1127 
1128  cmd_output->needs_tree_render = true;
1129  // XXX: default reply for now, make this a better reply
1130  ysuccess(true);
1131 }
1132 
1133 /*
1134  * Implementation of 'split v|h|t|vertical|horizontal|toggle'.
1135  *
1136  */
1137 void cmd_split(I3_CMD, const char *direction) {
1139 
1140  owindow *current;
1141  LOG("splitting in direction %c\n", direction[0]);
1142  TAILQ_FOREACH(current, &owindows, owindows) {
1143  if (con_is_docked(current->con)) {
1144  ELOG("Cannot split a docked container, skipping.\n");
1145  continue;
1146  }
1147 
1148  DLOG("matching: %p / %s\n", current->con, current->con->name);
1149  if (direction[0] == 't') {
1150  layout_t current_layout;
1151  if (current->con->type == CT_WORKSPACE) {
1152  current_layout = current->con->layout;
1153  } else {
1154  current_layout = current->con->parent->layout;
1155  }
1156  /* toggling split orientation */
1157  if (current_layout == L_SPLITH) {
1158  tree_split(current->con, VERT);
1159  } else {
1160  tree_split(current->con, HORIZ);
1161  }
1162  } else {
1163  tree_split(current->con, (direction[0] == 'v' ? VERT : HORIZ));
1164  }
1165  }
1166 
1167  cmd_output->needs_tree_render = true;
1168  // XXX: default reply for now, make this a better reply
1169  ysuccess(true);
1170 }
1171 
1172 /*
1173  * Implementation of 'kill [window|client]'.
1174  *
1175  */
1176 void cmd_kill(I3_CMD, const char *kill_mode_str) {
1177  if (kill_mode_str == NULL)
1178  kill_mode_str = "window";
1179 
1180  DLOG("kill_mode=%s\n", kill_mode_str);
1181 
1182  int kill_mode;
1183  if (strcmp(kill_mode_str, "window") == 0)
1184  kill_mode = KILL_WINDOW;
1185  else if (strcmp(kill_mode_str, "client") == 0)
1186  kill_mode = KILL_CLIENT;
1187  else {
1188  ELOG("BUG: called with kill_mode=%s\n", kill_mode_str);
1189  ysuccess(false);
1190  return;
1191  }
1192 
1194 
1195  owindow *current;
1196  TAILQ_FOREACH(current, &owindows, owindows) {
1197  con_close(current->con, kill_mode);
1198  }
1199 
1200  cmd_output->needs_tree_render = true;
1201  // XXX: default reply for now, make this a better reply
1202  ysuccess(true);
1203 }
1204 
1205 /*
1206  * Implementation of 'exec [--no-startup-id] <command>'.
1207  *
1208  */
1209 void cmd_exec(I3_CMD, const char *nosn, const char *command) {
1210  bool no_startup_id = (nosn != NULL);
1211 
1212  DLOG("should execute %s, no_startup_id = %d\n", command, no_startup_id);
1213  start_application(command, no_startup_id);
1214 
1215  // XXX: default reply for now, make this a better reply
1216  ysuccess(true);
1217 }
1218 
1219 /*
1220  * Implementation of 'focus left|right|up|down'.
1221  *
1222  */
1223 void cmd_focus_direction(I3_CMD, const char *direction) {
1224  DLOG("direction = *%s*\n", direction);
1225 
1226  if (strcmp(direction, "left") == 0)
1227  tree_next('p', HORIZ);
1228  else if (strcmp(direction, "right") == 0)
1229  tree_next('n', HORIZ);
1230  else if (strcmp(direction, "up") == 0)
1231  tree_next('p', VERT);
1232  else if (strcmp(direction, "down") == 0)
1233  tree_next('n', VERT);
1234  else {
1235  ELOG("Invalid focus direction (%s)\n", direction);
1236  ysuccess(false);
1237  return;
1238  }
1239 
1240  cmd_output->needs_tree_render = true;
1241  // XXX: default reply for now, make this a better reply
1242  ysuccess(true);
1243 }
1244 
1245 /*
1246  * Implementation of 'focus tiling|floating|mode_toggle'.
1247  *
1248  */
1249 void cmd_focus_window_mode(I3_CMD, const char *window_mode) {
1250  DLOG("window_mode = %s\n", window_mode);
1251 
1252  Con *ws = con_get_workspace(focused);
1253  if (ws != NULL) {
1254  if (strcmp(window_mode, "mode_toggle") == 0) {
1256  window_mode = "tiling";
1257  else
1258  window_mode = "floating";
1259  }
1260  Con *current;
1261  TAILQ_FOREACH(current, &(ws->focus_head), focused) {
1262  if ((strcmp(window_mode, "floating") == 0 && current->type != CT_FLOATING_CON) ||
1263  (strcmp(window_mode, "tiling") == 0 && current->type == CT_FLOATING_CON))
1264  continue;
1265 
1266  con_focus(con_descend_focused(current));
1267  break;
1268  }
1269  }
1270 
1271  cmd_output->needs_tree_render = true;
1272  // XXX: default reply for now, make this a better reply
1273  ysuccess(true);
1274 }
1275 
1276 /*
1277  * Implementation of 'focus parent|child'.
1278  *
1279  */
1280 void cmd_focus_level(I3_CMD, const char *level) {
1281  DLOG("level = %s\n", level);
1282  bool success = false;
1283 
1284  /* Focusing the parent can only be allowed if the newly
1285  * focused container won't escape the fullscreen container. */
1286  if (strcmp(level, "parent") == 0) {
1287  if (focused && focused->parent) {
1289  success = level_up();
1290  else
1291  ELOG("'focus parent': Currently in fullscreen, not going up\n");
1292  }
1293  }
1294 
1295  /* Focusing a child should always be allowed. */
1296  else
1297  success = level_down();
1298 
1299  cmd_output->needs_tree_render = success;
1300  // XXX: default reply for now, make this a better reply
1301  ysuccess(success);
1302 }
1303 
1304 /*
1305  * Implementation of 'focus'.
1306  *
1307  */
1309  DLOG("current_match = %p\n", current_match);
1310 
1312  ELOG("You have to specify which window/container should be focused.\n");
1313  ELOG("Example: [class=\"urxvt\" title=\"irssi\"] focus\n");
1314 
1315  yerror("You have to specify which window/container should be focused");
1316 
1317  return;
1318  }
1319 
1320  Con *__i3_scratch = workspace_get("__i3_scratch", NULL);
1321  int count = 0;
1322  owindow *current;
1323  TAILQ_FOREACH(current, &owindows, owindows) {
1324  Con *ws = con_get_workspace(current->con);
1325  /* If no workspace could be found, this was a dock window.
1326  * Just skip it, you cannot focus dock windows. */
1327  if (!ws)
1328  continue;
1329 
1330  /* Check the fullscreen focus constraints. */
1331  if (!con_fullscreen_permits_focusing(current->con)) {
1332  LOG("Cannot change focus while in fullscreen mode (fullscreen rules).\n");
1333  ysuccess(false);
1334  return;
1335  }
1336 
1337  /* In case this is a scratchpad window, call scratchpad_show(). */
1338  if (ws == __i3_scratch) {
1339  scratchpad_show(current->con);
1340  count++;
1341  /* While for the normal focus case we can change focus multiple
1342  * times and only a single window ends up focused, we could show
1343  * multiple scratchpad windows. So, rather break here. */
1344  break;
1345  }
1346 
1347  /* If the container is not on the current workspace,
1348  * workspace_show() will switch to a different workspace and (if
1349  * enabled) trigger a mouse pointer warp to the currently focused
1350  * container (!) on the target workspace.
1351  *
1352  * Therefore, before calling workspace_show(), we make sure that
1353  * 'current' will be focused on the workspace. However, we cannot
1354  * just con_focus(current) because then the pointer will not be
1355  * warped at all (the code thinks we are already there).
1356  *
1357  * So we focus 'current' to make it the currently focused window of
1358  * the target workspace, then revert focus. */
1359  Con *currently_focused = focused;
1360  con_focus(current->con);
1361  con_focus(currently_focused);
1362 
1363  /* Now switch to the workspace, then focus */
1364  workspace_show(ws);
1365  LOG("focusing %p / %s\n", current->con, current->con->name);
1366  con_focus(current->con);
1367  count++;
1368  }
1369 
1370  if (count > 1)
1371  LOG("WARNING: Your criteria for the focus command matches %d containers, "
1372  "while only exactly one container can be focused at a time.\n",
1373  count);
1374 
1375  cmd_output->needs_tree_render = true;
1376  ysuccess(count > 0);
1377 }
1378 
1379 /*
1380  * Implementation of 'fullscreen enable|toggle [global]' and
1381  * 'fullscreen disable'
1382  *
1383  */
1384 void cmd_fullscreen(I3_CMD, const char *action, const char *fullscreen_mode) {
1385  fullscreen_mode_t mode = strcmp(fullscreen_mode, "global") == 0 ? CF_GLOBAL : CF_OUTPUT;
1386  DLOG("%s fullscreen, mode = %s\n", action, fullscreen_mode);
1387  owindow *current;
1388 
1390 
1391  TAILQ_FOREACH(current, &owindows, owindows) {
1392  DLOG("matching: %p / %s\n", current->con, current->con->name);
1393  if (strcmp(action, "toggle") == 0) {
1394  con_toggle_fullscreen(current->con, mode);
1395  } else if (strcmp(action, "enable") == 0) {
1396  con_enable_fullscreen(current->con, mode);
1397  } else if (strcmp(action, "disable") == 0) {
1398  con_disable_fullscreen(current->con);
1399  }
1400  }
1401 
1402  cmd_output->needs_tree_render = true;
1403  // XXX: default reply for now, make this a better reply
1404  ysuccess(true);
1405 }
1406 
1407 /*
1408  * Implementation of 'sticky enable|disable|toggle'.
1409  *
1410  */
1411 void cmd_sticky(I3_CMD, const char *action) {
1412  DLOG("%s sticky on window\n", action);
1414 
1415  owindow *current;
1416  TAILQ_FOREACH(current, &owindows, owindows) {
1417  if (current->con->window == NULL) {
1418  ELOG("only containers holding a window can be made sticky, skipping con = %p\n", current->con);
1419  continue;
1420  }
1421  DLOG("setting sticky for container = %p / %s\n", current->con, current->con->name);
1422 
1423  bool sticky = false;
1424  if (strcmp(action, "enable") == 0)
1425  sticky = true;
1426  else if (strcmp(action, "disable") == 0)
1427  sticky = false;
1428  else if (strcmp(action, "toggle") == 0)
1429  sticky = !current->con->sticky;
1430 
1431  current->con->sticky = sticky;
1432  ewmh_update_sticky(current->con->window->id, sticky);
1433  }
1434 
1435  /* A window we made sticky might not be on a visible workspace right now, so we need to make
1436  * sure it gets pushed to the front now. */
1438 
1440 
1441  cmd_output->needs_tree_render = true;
1442  ysuccess(true);
1443 }
1444 
1445 /*
1446  * Implementation of 'move <direction> [<pixels> [px]]'.
1447  *
1448  */
1449 void cmd_move_direction(I3_CMD, const char *direction, long move_px) {
1450  owindow *current;
1452 
1453  Con *initially_focused = focused;
1454 
1455  TAILQ_FOREACH(current, &owindows, owindows) {
1456  DLOG("moving in direction %s, px %ld\n", direction, move_px);
1457  if (con_is_floating(current->con)) {
1458  DLOG("floating move with %ld pixels\n", move_px);
1459  Rect newrect = current->con->parent->rect;
1460  if (strcmp(direction, "left") == 0) {
1461  newrect.x -= move_px;
1462  } else if (strcmp(direction, "right") == 0) {
1463  newrect.x += move_px;
1464  } else if (strcmp(direction, "up") == 0) {
1465  newrect.y -= move_px;
1466  } else if (strcmp(direction, "down") == 0) {
1467  newrect.y += move_px;
1468  }
1469  floating_reposition(current->con->parent, newrect);
1470  } else {
1471  tree_move(current->con, (strcmp(direction, "right") == 0 ? D_RIGHT : (strcmp(direction, "left") == 0 ? D_LEFT : (strcmp(direction, "up") == 0 ? D_UP : D_DOWN))));
1472  cmd_output->needs_tree_render = true;
1473  }
1474  }
1475 
1476  /* the move command should not disturb focus */
1477  if (focused != initially_focused)
1478  con_focus(initially_focused);
1479 
1480  // XXX: default reply for now, make this a better reply
1481  ysuccess(true);
1482 }
1483 
1484 /*
1485  * Implementation of 'layout default|stacked|stacking|tabbed|splitv|splith'.
1486  *
1487  */
1488 void cmd_layout(I3_CMD, const char *layout_str) {
1490 
1491  if (strcmp(layout_str, "stacking") == 0)
1492  layout_str = "stacked";
1493  layout_t layout;
1494  /* default is a special case which will be handled in con_set_layout(). */
1495  if (strcmp(layout_str, "default") == 0)
1496  layout = L_DEFAULT;
1497  else if (strcmp(layout_str, "stacked") == 0)
1498  layout = L_STACKED;
1499  else if (strcmp(layout_str, "tabbed") == 0)
1500  layout = L_TABBED;
1501  else if (strcmp(layout_str, "splitv") == 0)
1502  layout = L_SPLITV;
1503  else if (strcmp(layout_str, "splith") == 0)
1504  layout = L_SPLITH;
1505  else {
1506  ELOG("Unknown layout \"%s\", this is a mismatch between code and parser spec.\n", layout_str);
1507  return;
1508  }
1509 
1510  DLOG("changing layout to %s (%d)\n", layout_str, layout);
1511 
1512  owindow *current;
1513  TAILQ_FOREACH(current, &owindows, owindows) {
1514  if (con_is_docked(current->con)) {
1515  ELOG("cannot change layout of a docked container, skipping it.\n");
1516  continue;
1517  }
1518 
1519  DLOG("matching: %p / %s\n", current->con, current->con->name);
1520  con_set_layout(current->con, layout);
1521  }
1522 
1523  cmd_output->needs_tree_render = true;
1524  // XXX: default reply for now, make this a better reply
1525  ysuccess(true);
1526 }
1527 
1528 /*
1529  * Implementation of 'layout toggle [all|split]'.
1530  *
1531  */
1532 void cmd_layout_toggle(I3_CMD, const char *toggle_mode) {
1533  owindow *current;
1534 
1535  if (toggle_mode == NULL)
1536  toggle_mode = "default";
1537 
1538  DLOG("toggling layout (mode = %s)\n", toggle_mode);
1539 
1540  /* check if the match is empty, not if the result is empty */
1542  con_toggle_layout(focused, toggle_mode);
1543  else {
1544  TAILQ_FOREACH(current, &owindows, owindows) {
1545  DLOG("matching: %p / %s\n", current->con, current->con->name);
1546  con_toggle_layout(current->con, toggle_mode);
1547  }
1548  }
1549 
1550  cmd_output->needs_tree_render = true;
1551  // XXX: default reply for now, make this a better reply
1552  ysuccess(true);
1553 }
1554 
1555 /*
1556  * Implementation of 'exit'.
1557  *
1558  */
1560  LOG("Exiting due to user command.\n");
1561 #ifdef I3_ASAN_ENABLED
1562  __lsan_do_leak_check();
1563 #endif
1564  ipc_shutdown();
1565  unlink(config.ipc_socket_path);
1566  xcb_disconnect(conn);
1567  exit(0);
1568 
1569  /* unreached */
1570 }
1571 
1572 /*
1573  * Implementation of 'reload'.
1574  *
1575  */
1577  LOG("reloading\n");
1580  load_configuration(conn, NULL, true);
1581  x_set_i3_atoms();
1582  /* Send an IPC event just in case the ws names have changed */
1583  ipc_send_workspace_event("reload", NULL, NULL);
1584  /* Send an update event for the barconfig just in case it has changed */
1585  update_barconfig();
1586 
1587  // XXX: default reply for now, make this a better reply
1588  ysuccess(true);
1589 }
1590 
1591 /*
1592  * Implementation of 'restart'.
1593  *
1594  */
1596  LOG("restarting i3\n");
1597  ipc_shutdown();
1598  unlink(config.ipc_socket_path);
1599  /* We need to call this manually since atexit handlers don’t get called
1600  * when exec()ing */
1602  i3_restart(false);
1603 
1604  // XXX: default reply for now, make this a better reply
1605  ysuccess(true);
1606 }
1607 
1608 /*
1609  * Implementation of 'open'.
1610  *
1611  */
1613  LOG("opening new container\n");
1614  Con *con = tree_open_con(NULL, NULL);
1615  con->layout = L_SPLITH;
1616  con_focus(con);
1617 
1618  y(map_open);
1619  ystr("success");
1620  y(bool, true);
1621  ystr("id");
1622  y(integer, (long int)con);
1623  y(map_close);
1624 
1625  cmd_output->needs_tree_render = true;
1626 }
1627 
1628 /*
1629  * Implementation of 'focus output <output>'.
1630  *
1631  */
1632 void cmd_focus_output(I3_CMD, const char *name) {
1633  owindow *current;
1634 
1635  DLOG("name = %s\n", name);
1636 
1638 
1639  /* get the output */
1640  Output *current_output = NULL;
1641  Output *output;
1642 
1643  TAILQ_FOREACH(current, &owindows, owindows)
1644  current_output = get_output_of_con(current->con);
1645  assert(current_output != NULL);
1646 
1647  output = get_output_from_string(current_output, name);
1648 
1649  if (!output) {
1650  LOG("No such output found.\n");
1651  ysuccess(false);
1652  return;
1653  }
1654 
1655  /* get visible workspace on output */
1656  Con *ws = NULL;
1657  GREP_FIRST(ws, output_get_content(output->con), workspace_is_visible(child));
1658  if (!ws) {
1659  ysuccess(false);
1660  return;
1661  }
1662 
1663  workspace_show(ws);
1664 
1665  cmd_output->needs_tree_render = true;
1666  // XXX: default reply for now, make this a better reply
1667  ysuccess(true);
1668 }
1669 
1670 /*
1671  * Implementation of 'move [window|container] [to] [absolute] position <px> [px] <px> [px]
1672  *
1673  */
1674 void cmd_move_window_to_position(I3_CMD, const char *method, long x, long y) {
1675  bool has_error = false;
1676 
1677  owindow *current;
1679 
1680  TAILQ_FOREACH(current, &owindows, owindows) {
1681  if (!con_is_floating(current->con)) {
1682  ELOG("Cannot change position. The window/container is not floating\n");
1683 
1684  if (!has_error) {
1685  yerror("Cannot change position of a window/container because it is not floating.");
1686  has_error = true;
1687  }
1688 
1689  continue;
1690  }
1691 
1692  if (strcmp(method, "absolute") == 0) {
1693  current->con->parent->rect.x = x;
1694  current->con->parent->rect.y = y;
1695 
1696  DLOG("moving to absolute position %ld %ld\n", x, y);
1698  cmd_output->needs_tree_render = true;
1699  }
1700 
1701  if (strcmp(method, "position") == 0) {
1702  Rect newrect = current->con->parent->rect;
1703 
1704  DLOG("moving to position %ld %ld\n", x, y);
1705  newrect.x = x;
1706  newrect.y = y;
1707 
1708  floating_reposition(current->con->parent, newrect);
1709  }
1710  }
1711 
1712  // XXX: default reply for now, make this a better reply
1713  if (!has_error)
1714  ysuccess(true);
1715 }
1716 
1717 /*
1718  * Implementation of 'move [window|container] [to] [absolute] position center
1719  *
1720  */
1721 void cmd_move_window_to_center(I3_CMD, const char *method) {
1722  bool has_error = false;
1724 
1725  owindow *current;
1726  TAILQ_FOREACH(current, &owindows, owindows) {
1727  Con *floating_con = con_inside_floating(current->con);
1728  if (floating_con == NULL) {
1729  ELOG("con %p / %s is not floating, cannot move it to the center.\n",
1730  current->con, current->con->name);
1731 
1732  if (!has_error) {
1733  yerror("Cannot change position of a window/container because it is not floating.");
1734  has_error = true;
1735  }
1736 
1737  continue;
1738  }
1739 
1740  if (strcmp(method, "absolute") == 0) {
1741  DLOG("moving to absolute center\n");
1742  floating_center(floating_con, croot->rect);
1743 
1744  floating_maybe_reassign_ws(floating_con);
1745  cmd_output->needs_tree_render = true;
1746  }
1747 
1748  if (strcmp(method, "position") == 0) {
1749  DLOG("moving to center\n");
1750  floating_center(floating_con, con_get_workspace(floating_con)->rect);
1751 
1752  cmd_output->needs_tree_render = true;
1753  }
1754  }
1755 
1756  // XXX: default reply for now, make this a better reply
1757  if (!has_error)
1758  ysuccess(true);
1759 }
1760 
1761 /*
1762  * Implementation of 'move [window|container] [to] position mouse'
1763  *
1764  */
1767 
1768  owindow *current;
1769  TAILQ_FOREACH(current, &owindows, owindows) {
1770  Con *floating_con = con_inside_floating(current->con);
1771  if (floating_con == NULL) {
1772  DLOG("con %p / %s is not floating, cannot move it to the mouse position.\n",
1773  current->con, current->con->name);
1774  continue;
1775  }
1776 
1777  DLOG("moving floating container %p / %s to cursor position\n", floating_con, floating_con->name);
1778  floating_move_to_pointer(floating_con);
1779  }
1780 
1781  cmd_output->needs_tree_render = true;
1782  ysuccess(true);
1783 }
1784 
1785 /*
1786  * Implementation of 'move scratchpad'.
1787  *
1788  */
1790  DLOG("should move window to scratchpad\n");
1791  owindow *current;
1792 
1794 
1795  TAILQ_FOREACH(current, &owindows, owindows) {
1796  DLOG("matching: %p / %s\n", current->con, current->con->name);
1797  scratchpad_move(current->con);
1798  }
1799 
1800  cmd_output->needs_tree_render = true;
1801  // XXX: default reply for now, make this a better reply
1802  ysuccess(true);
1803 }
1804 
1805 /*
1806  * Implementation of 'scratchpad show'.
1807  *
1808  */
1810  DLOG("should show scratchpad window\n");
1811  owindow *current;
1812 
1814  scratchpad_show(NULL);
1815  } else {
1816  TAILQ_FOREACH(current, &owindows, owindows) {
1817  DLOG("matching: %p / %s\n", current->con, current->con->name);
1818  scratchpad_show(current->con);
1819  }
1820  }
1821 
1822  cmd_output->needs_tree_render = true;
1823  // XXX: default reply for now, make this a better reply
1824  ysuccess(true);
1825 }
1826 
1827 /*
1828  * Implementation of 'title_format <format>'
1829  *
1830  */
1831 void cmd_title_format(I3_CMD, const char *format) {
1832  DLOG("setting title_format to \"%s\"\n", format);
1834 
1835  owindow *current;
1836  TAILQ_FOREACH(current, &owindows, owindows) {
1837  DLOG("setting title_format for %p / %s\n", current->con, current->con->name);
1838  FREE(current->con->title_format);
1839 
1840  /* If we only display the title without anything else, we can skip the parsing step,
1841  * so we remove the title format altogether. */
1842  if (strcasecmp(format, "%title") != 0) {
1843  current->con->title_format = sstrdup(format);
1844 
1845  if (current->con->window != NULL) {
1846  i3String *formatted_title = con_parse_title_format(current->con);
1847  ewmh_update_visible_name(current->con->window->id, i3string_as_utf8(formatted_title));
1848  I3STRING_FREE(formatted_title);
1849  }
1850  } else {
1851  if (current->con->window != NULL) {
1852  /* We can remove _NET_WM_VISIBLE_NAME since we don't display a custom title. */
1853  ewmh_update_visible_name(current->con->window->id, NULL);
1854  }
1855  }
1856 
1857  if (current->con->window != NULL) {
1858  /* Make sure the window title is redrawn immediately. */
1859  current->con->window->name_x_changed = true;
1860  } else {
1861  /* For windowless containers we also need to force the redrawing. */
1862  FREE(current->con->deco_render_params);
1863  }
1864  }
1865 
1866  cmd_output->needs_tree_render = true;
1867  ysuccess(true);
1868 }
1869 
1870 /*
1871  * Implementation of 'rename workspace [<name>] to <name>'
1872  *
1873  */
1874 void cmd_rename_workspace(I3_CMD, const char *old_name, const char *new_name) {
1875  if (strncasecmp(new_name, "__", strlen("__")) == 0) {
1876  LOG("Cannot rename workspace to \"%s\": names starting with __ are i3-internal.\n", new_name);
1877  ysuccess(false);
1878  return;
1879  }
1880  if (old_name) {
1881  LOG("Renaming workspace \"%s\" to \"%s\"\n", old_name, new_name);
1882  } else {
1883  LOG("Renaming current workspace to \"%s\"\n", new_name);
1884  }
1885 
1886  Con *output, *workspace = NULL;
1887  if (old_name) {
1888  TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
1889  GREP_FIRST(workspace, output_get_content(output),
1890  !strcasecmp(child->name, old_name));
1891  } else {
1892  workspace = con_get_workspace(focused);
1893  old_name = workspace->name;
1894  }
1895 
1896  if (!workspace) {
1897  yerror("Old workspace \"%s\" not found", old_name);
1898  return;
1899  }
1900 
1901  Con *check_dest = NULL;
1902  TAILQ_FOREACH(output, &(croot->nodes_head), nodes)
1903  GREP_FIRST(check_dest, output_get_content(output),
1904  !strcasecmp(child->name, new_name));
1905 
1906  /* If check_dest == workspace, the user might be changing the case of the
1907  * workspace, or it might just be a no-op. */
1908  if (check_dest != NULL && check_dest != workspace) {
1909  yerror("New workspace \"%s\" already exists", new_name);
1910  return;
1911  }
1912 
1913  /* Change the name and try to parse it as a number. */
1914  /* old_name might refer to workspace->name, so copy it before free()ing */
1915  char *old_name_copy = sstrdup(old_name);
1916  FREE(workspace->name);
1917  workspace->name = sstrdup(new_name);
1918 
1919  workspace->num = ws_name_to_number(new_name);
1920  LOG("num = %d\n", workspace->num);
1921 
1922  /* By re-attaching, the sort order will be correct afterwards. */
1923  Con *previously_focused = focused;
1924  Con *parent = workspace->parent;
1925  con_detach(workspace);
1926  con_attach(workspace, parent, false);
1927 
1928  /* Move the workspace to the correct output if it has an assignment */
1929  struct Workspace_Assignment *assignment = NULL;
1931  if (assignment->output == NULL)
1932  continue;
1933  if (strcmp(assignment->name, workspace->name) != 0 && (!name_is_digits(assignment->name) || ws_name_to_number(assignment->name) != workspace->num)) {
1934  continue;
1935  }
1936 
1937  workspace_move_to_output(workspace, assignment->output);
1938 
1939  if (previously_focused)
1940  workspace_show(con_get_workspace(previously_focused));
1941 
1942  break;
1943  }
1944 
1945  /* Restore the previous focus since con_attach messes with the focus. */
1946  con_focus(previously_focused);
1947 
1948  cmd_output->needs_tree_render = true;
1949  ysuccess(true);
1950 
1951  ipc_send_workspace_event("rename", workspace, NULL);
1955 
1956  startup_sequence_rename_workspace(old_name_copy, new_name);
1957  free(old_name_copy);
1958 }
1959 
1960 /*
1961  * Implementation of 'bar mode dock|hide|invisible|toggle [<bar_id>]'
1962  *
1963  */
1964 bool cmd_bar_mode(const char *bar_mode, const char *bar_id) {
1965  int mode = M_DOCK;
1966  bool toggle = false;
1967  if (strcmp(bar_mode, "dock") == 0)
1968  mode = M_DOCK;
1969  else if (strcmp(bar_mode, "hide") == 0)
1970  mode = M_HIDE;
1971  else if (strcmp(bar_mode, "invisible") == 0)
1972  mode = M_INVISIBLE;
1973  else if (strcmp(bar_mode, "toggle") == 0)
1974  toggle = true;
1975  else {
1976  ELOG("Unknown bar mode \"%s\", this is a mismatch between code and parser spec.\n", bar_mode);
1977  return false;
1978  }
1979 
1980  bool changed_sth = false;
1981  Barconfig *current = NULL;
1982  TAILQ_FOREACH(current, &barconfigs, configs) {
1983  if (bar_id && strcmp(current->id, bar_id) != 0)
1984  continue;
1985 
1986  if (toggle)
1987  mode = (current->mode + 1) % 2;
1988 
1989  DLOG("Changing bar mode of bar_id '%s' to '%s (%d)'\n", current->id, bar_mode, mode);
1990  current->mode = mode;
1991  changed_sth = true;
1992 
1993  if (bar_id)
1994  break;
1995  }
1996 
1997  if (bar_id && !changed_sth) {
1998  DLOG("Changing bar mode of bar_id %s failed, bar_id not found.\n", bar_id);
1999  return false;
2000  }
2001 
2002  return true;
2003 }
2004 
2005 /*
2006  * Implementation of 'bar hidden_state hide|show|toggle [<bar_id>]'
2007  *
2008  */
2009 bool cmd_bar_hidden_state(const char *bar_hidden_state, const char *bar_id) {
2010  int hidden_state = S_SHOW;
2011  bool toggle = false;
2012  if (strcmp(bar_hidden_state, "hide") == 0)
2013  hidden_state = S_HIDE;
2014  else if (strcmp(bar_hidden_state, "show") == 0)
2015  hidden_state = S_SHOW;
2016  else if (strcmp(bar_hidden_state, "toggle") == 0)
2017  toggle = true;
2018  else {
2019  ELOG("Unknown bar state \"%s\", this is a mismatch between code and parser spec.\n", bar_hidden_state);
2020  return false;
2021  }
2022 
2023  bool changed_sth = false;
2024  Barconfig *current = NULL;
2025  TAILQ_FOREACH(current, &barconfigs, configs) {
2026  if (bar_id && strcmp(current->id, bar_id) != 0)
2027  continue;
2028 
2029  if (toggle)
2030  hidden_state = (current->hidden_state + 1) % 2;
2031 
2032  DLOG("Changing bar hidden_state of bar_id '%s' to '%s (%d)'\n", current->id, bar_hidden_state, hidden_state);
2033  current->hidden_state = hidden_state;
2034  changed_sth = true;
2035 
2036  if (bar_id)
2037  break;
2038  }
2039 
2040  if (bar_id && !changed_sth) {
2041  DLOG("Changing bar hidden_state of bar_id %s failed, bar_id not found.\n", bar_id);
2042  return false;
2043  }
2044 
2045  return true;
2046 }
2047 
2048 /*
2049  * Implementation of 'bar (hidden_state hide|show|toggle)|(mode dock|hide|invisible|toggle) [<bar_id>]'
2050  *
2051  */
2052 void cmd_bar(I3_CMD, const char *bar_type, const char *bar_value, const char *bar_id) {
2053  bool ret;
2054  if (strcmp(bar_type, "mode") == 0)
2055  ret = cmd_bar_mode(bar_value, bar_id);
2056  else if (strcmp(bar_type, "hidden_state") == 0)
2057  ret = cmd_bar_hidden_state(bar_value, bar_id);
2058  else {
2059  ELOG("Unknown bar option type \"%s\", this is a mismatch between code and parser spec.\n", bar_type);
2060  ret = false;
2061  }
2062 
2063  ysuccess(ret);
2064  if (!ret)
2065  return;
2066 
2067  update_barconfig();
2068 }
2069 
2070 /*
2071  * Implementation of 'shmlog <size>|toggle|on|off'
2072  *
2073  */
2074 void cmd_shmlog(I3_CMD, const char *argument) {
2075  if (!strcmp(argument, "toggle"))
2076  /* Toggle shm log, if size is not 0. If it is 0, set it to default. */
2078  else if (!strcmp(argument, "on"))
2080  else if (!strcmp(argument, "off"))
2081  shmlog_size = 0;
2082  else {
2083  /* If shm logging now, restart logging with the new size. */
2084  if (shmlog_size > 0) {
2085  shmlog_size = 0;
2086  LOG("Restarting shm logging...\n");
2087  init_logging();
2088  }
2089  shmlog_size = atoi(argument);
2090  /* Make a weakly attempt at ensuring the argument is valid. */
2091  if (shmlog_size <= 0)
2093  }
2094  LOG("%s shm logging\n", shmlog_size > 0 ? "Enabling" : "Disabling");
2095  init_logging();
2097  // XXX: default reply for now, make this a better reply
2098  ysuccess(true);
2099 }
2100 
2101 /*
2102  * Implementation of 'debuglog toggle|on|off'
2103  *
2104  */
2105 void cmd_debuglog(I3_CMD, const char *argument) {
2106  bool logging = get_debug_logging();
2107  if (!strcmp(argument, "toggle")) {
2108  LOG("%s debug logging\n", logging ? "Disabling" : "Enabling");
2109  set_debug_logging(!logging);
2110  } else if (!strcmp(argument, "on") && !logging) {
2111  LOG("Enabling debug logging\n");
2112  set_debug_logging(true);
2113  } else if (!strcmp(argument, "off") && logging) {
2114  LOG("Disabling debug logging\n");
2115  set_debug_logging(false);
2116  }
2117  // XXX: default reply for now, make this a better reply
2118  ysuccess(true);
2119 }
static bool cmd_resize_tiling_direction(I3_CMD, Con *current, const char *way, const char *direction, int ppt)
Definition: commands.c:509
void cmd_mark(I3_CMD, const char *mark, const char *mode, const char *toggle)
Implementation of &#39;mark [–add|–replace] [–toggle] <mark>&#39;.
Definition: commands.c:959
uint32_t height
Definition: data.h:145
void floating_disable(Con *con, bool automatic)
Disables floating mode for the given container by re-attaching the container to its old parent...
Definition: floating.c:307
uint32_t x
Definition: data.h:142
Con * con_inside_floating(Con *con)
Checks if the given container is either floating or inside some floating container.
Definition: con.c:500
bool con_fullscreen_permits_focusing(Con *con)
Returns true if changing the focus to con would be allowed considering the fullscreen focus constrain...
Definition: con.c:1818
enum Con::@22 scratchpad_state
void scratchpad_move(Con *con)
Moves the specified window to the __i3_scratch workspace, making it floating and setting the appropri...
Definition: scratchpad.c:21
bool name_x_changed
Flag to force re-rendering the decoration upon changes.
Definition: data.h:392
Definition: data.h:61
void cmd_workspace_name(I3_CMD, const char *name, const char *_no_auto_back_and_forth)
Implementation of &#39;workspace [–no-auto-back-and-forth] <name>&#39;.
Definition: commands.c:930
layout_t
Container layouts.
Definition: data.h:84
void tree_next(char way, orientation_t orientation)
Changes focus in the given way (next/previous) and given orientation (horizontal/vertical).
Definition: tree.c:674
void con_mark(Con *con, const char *mark, mark_mode_t mode)
Assigns a mark to the container.
Definition: con.c:602
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:134
char * title_format
The format with which the window&#39;s name should be displayed.
Definition: data.h:599
Con * workspace_next(void)
Returns the next workspace.
Definition: workspace.c:509
Definition: data.h:63
char * name
Definition: data.h:541
int num
the workspace number, if this Con is of type CT_WORKSPACE and the workspace is not a named workspace ...
Definition: data.h:580
bool match_is_empty(Match *match)
Check if a match is empty.
Definition: match.c:41
void cmd_move_con_to_workspace(I3_CMD, const char *which)
Implementation of &#39;move [window|container] [to] workspace next|prev|next_on_output|prev_on_output&#39;.
Definition: commands.c:286
Definition: data.h:540
struct Window * window
Definition: data.h:617
char * name
Definition: data.h:596
Definition: data.h:87
void con_disable_fullscreen(Con *con)
Disables fullscreen mode for the given container, if necessary.
Definition: con.c:881
void con_focus(Con *con)
Sets input focus to the given container.
Definition: con.c:198
Con * tree_open_con(Con *con, i3Window *window)
Opens an empty container in the current container.
Definition: tree.c:137
void con_toggle_fullscreen(Con *con, int fullscreen_mode)
Toggles fullscreen mode for the given container.
Definition: con.c:781
bool workspace_auto_back_and_forth
Automatic workspace back and forth switching.
Definition: config.h:163
void * smalloc(size_t size)
Safe-wrapper around malloc which exits if malloc returns NULL (meaning that there is no more memory a...
Con * workspace_prev_on_output(void)
Returns the previous workspace on the same output.
Definition: workspace.c:694
void cmd_move_con_to_workspace_name(I3_CMD, const char *name, const char *_no_auto_back_and_forth)
Implementation of &#39;move [–no-auto-back-and-forth] [window|container] [to] workspace <name>&#39;...
Definition: commands.c:362
Output * get_output_from_string(Output *current_output, const char *output_str)
Returns an &#39;output&#39; corresponding to one of left/right/down/up or a specific output name...
Definition: output.c:33
#define TAILQ_EMPTY(head)
Definition: queue.h:344
#define I3STRING_FREE(str)
Securely i3string_free by setting the pointer to NULL to prevent accidentally using freed memory...
Definition: libi3.h:222
Con * output_get_content(Con *output)
Returns the output container below the given output container.
Definition: output.c:18
void tree_append_json(Con *con, const char *filename, char **errormsg)
Definition: load_layout.c:579
enum Barconfig::@8 mode
Bar display mode (hide unless modifier is pressed or show in dock mode or always hide in invisible mo...
void con_unmark(Con *con, const char *name)
Definition: con.c:631
void i3_restart(bool forget_layout)
Restart i3 in-place appends -a to argument list to disable autostart.
Definition: util.c:270
bool match_matches_window(Match *match, i3Window *window)
Check if a match data structure matches the given window.
Definition: match.c:89
void cmd_criteria_match_windows(I3_CMD)
A match specification just finished (the closing square bracket was found), so we filter the list of ...
Definition: commands.c:194
void cmd_criteria_add(I3_CMD, const char *ctype, const char *cvalue)
Interprets a ctype=cvalue pair and adds it to the current match specification.
Definition: commands.c:277
void output_push_sticky_windows(Con *to_focus)
Iterates over all outputs and pushes sticky windows to the currently visible workspace on that output...
Definition: output.c:55
void con_close(Con *con, kill_window_t kill_window)
Closes the given container.
Definition: con.c:227
Definition: data.h:79
void floating_reposition(Con *con, Rect newrect)
Repositions the CT_FLOATING_CON to have the coordinates specified by newrect, but only if the coordin...
Definition: floating.c:807
void match_parse_property(Match *match, const char *ctype, const char *cvalue)
Interprets a ctype=cvalue pair and adds it to the given match specification.
Definition: match.c:269
#define TAILQ_LAST(head, headname)
Definition: queue.h:339
void cmd_exec(I3_CMD, const char *nosn, const char *command)
Implementation of &#39;exec [–no-startup-id] <command>&#39;.
Definition: commands.c:1209
Definition: data.h:57
void scratchpad_show(Con *con)
Either shows the top-most scratchpad window (con == NULL) or shows the specified con (if it is scratc...
Definition: scratchpad.c:89
void match_init(Match *match)
Definition: match.c:28
bool get_debug_logging(void)
Checks if debug logging is active.
Definition: log.c:197
Stores which workspace (by name or number) goes to which output.
Definition: data.h:191
void cmd_resize(I3_CMD, const char *way, const char *direction, long resize_px, long resize_ppt)
Implementation of &#39;resize grow|shrink <direction> [<px> px] [or <ppt> ppt]&#39;.
Definition: commands.c:648
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:347
enum Barconfig::@9 hidden_state
int shmlog_size
Definition: log.c:47
const int default_shmlog_size
Definition: main.c:70
#define y(x,...)
Definition: commands.c:23
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:50
Con * workspace_back_and_forth_get(void)
Returns the previously focused workspace con, or NULL if unavailable.
Definition: workspace.c:764
#define FREE(pointer)
Definition: util.h:48
void match_free(Match *match)
Frees the given match.
Definition: match.c:254
orientation_t
Definition: data.h:58
struct barconfig_head barconfigs
Definition: config.c:19
void con_attach(Con *con, Con *parent, bool ignore_focus)
Attaches the given container to the given parent.
Definition: con.c:174
Con * con_descend_focused(Con *con)
Returns the focused con inside this client, descending the tree as far as possible.
Definition: con.c:1306
xcb_connection_t * conn
XCB connection and root screen.
Definition: main.c:43
void ewmh_update_current_desktop(void)
Updates _NET_CURRENT_DESKTOP with the current desktop number.
Definition: ewmh.c:23
void con_toggle_layout(Con *con, const char *toggle_mode)
This function toggles the layout of a given container.
Definition: con.c:1644
Definition: data.h:85
void cmd_criteria_init(I3_CMD)
Initializes the specified &#39;Match&#39; data structure and the initial state of commands.c for matching target windows of a command.
void con_mark_toggle(Con *con, const char *mark, mark_mode_t mode)
Toggles the mark on a container.
Definition: con.c:587
#define ystr(str)
Definition: commands.c:24
#define TAILQ_NEXT(elm, field)
Definition: queue.h:338
Config config
Definition: config.c:17
void floating_center(Con *con, Rect rect)
Centers a floating con above the specified rect.
Definition: floating.c:422
void cmd_floating(I3_CMD, const char *floating_mode)
Implementation of &#39;floating enable|disable|toggle&#39;.
Definition: commands.c:1081
bool floating_maybe_reassign_ws(Con *con)
Checks if con’s coordinates are within its workspace and re-assigns it to the actual workspace if no...
Definition: floating.c:393
Con * con_get_output(Con *con)
Gets the output container (first container with CT_OUTPUT in hierarchy) this node is on...
Definition: con.c:359
uint32_t y
Definition: data.h:143
#define ysuccess(success)
Definition: commands.c:25
void cmd_split(I3_CMD, const char *direction)
Implementation of &#39;split v|h|t|vertical|horizontal|toggle&#39;.
Definition: commands.c:1137
pid_t config_error_nagbar_pid
Definition: config_parser.c:46
void cmd_workspace_back_and_forth(I3_CMD)
Implementation of &#39;workspace back_and_forth&#39;.
Definition: commands.c:912
void set_debug_logging(const bool _debug_logging)
Set debug logging.
Definition: log.c:205
Definition: data.h:86
void con_detach(Con *con)
Detaches the given container from its current parent.
Definition: con.c:182
#define I3_CMD
The beginning of the prototype for every cmd_ function.
Definition: commands.h:15
fullscreen_mode_t
Fullscreen modes.
Definition: data.h:536
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:264
bool level_up(void)
Moves focus one level up.
Definition: tree.c:429
Definition: data.h:54
void cmd_debuglog(I3_CMD, const char *argument)
Definition: commands.c:2105
void workspace_show(Con *workspace)
Switches to the given workspace.
Definition: workspace.c:491
void kill_nagbar(pid_t *nagbar_pid, bool wait_for_it)
Kills the i3-nagbar process, if *nagbar_pid != -1.
Definition: util.c:433
struct Con * croot
Definition: tree.c:14
int height_increment
Definition: data.h:431
void x_set_i3_atoms(void)
Sets up i3 specific atoms (I3_SOCKET_PATH and I3_CONFIG_PATH)
Definition: x.c:1279
#define ELOG(fmt,...)
Definition: libi3.h:93
void cmd_shmlog(I3_CMD, const char *argument)
Definition: commands.c:2074
void cmd_mode(I3_CMD, const char *mode)
Implementation of &#39;mode <string>&#39;.
Definition: commands.c:1011
double percent
Definition: data.h:611
uint32_t width
Definition: data.h:144
void cmd_focus_window_mode(I3_CMD, const char *window_mode)
Implementation of &#39;focus tiling|floating|mode_toggle&#39;.
Definition: commands.c:1249
void cmd_move_window_to_mouse(I3_CMD)
Implementation of &#39;move [window|container] [to] position mouse&#39;.
Definition: commands.c:1765
void cmd_exit(I3_CMD)
Implementation of &#39;exit&#39;.
Definition: commands.c:1559
#define GREP_FIRST(dest, head, condition)
Definition: util.h:39
void cmd_layout_toggle(I3_CMD, const char *toggle_mode)
Implementation of &#39;layout toggle [all|split]&#39;.
Definition: commands.c:1532
void cmd_focus_output(I3_CMD, const char *name)
Implementation of &#39;focus output <output>&#39;.
Definition: commands.c:1632
static bool maybe_back_and_forth(struct CommandResultIR *cmd_output, const char *name)
Definition: commands.c:107
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:402
#define LOG(fmt,...)
Definition: libi3.h:88
bool cmd_bar_mode(const char *bar_mode, const char *bar_id)
Definition: commands.c:1964
void cmd_restart(I3_CMD)
Implementation of &#39;restart&#39;.
Definition: commands.c:1595
Con * con
Pointer to the Con which represents this output.
Definition: data.h:348
#define TAILQ_INIT(head)
Definition: queue.h:360
void cmd_append_layout(I3_CMD, const char *cpath)
Implementation of &#39;append_layout <path>&#39;.
Definition: commands.c:772
void cmd_sticky(I3_CMD, const char *action)
Implementation of &#39;sticky enable|disable|toggle&#39;.
Definition: commands.c:1411
Definition: data.h:91
void ewmh_update_visible_name(xcb_window_t window, const char *name)
Updates _NET_WM_VISIBLE_NAME.
Definition: ewmh.c:207
struct ws_assignments_head ws_assignments
Definition: main.c:86
struct Rect rect
Definition: data.h:586
void cmd_focus_level(I3_CMD, const char *level)
Implementation of &#39;focus parent|child&#39;.
Definition: commands.c:1280
static Output * get_output_of_con(Con *con)
Definition: commands.c:92
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 cmd_move_con_to_mark(I3_CMD, const char *mark)
Implementation of &#39;move [window|container] [to] mark <str>&#39;.
Definition: commands.c:1061
#define yerror(format,...)
Definition: commands.c:34
Con * workspace_next_on_output(void)
Returns the next workspace on the same output.
Definition: workspace.c:639
void toggle_floating_mode(Con *con, bool automatic)
Calls floating_enable() for tiling containers and floating_disable() for floating containers...
Definition: floating.c:360
void cmd_reload(I3_CMD)
Implementation of &#39;reload&#39;.
Definition: commands.c:1576
void cmd_kill(I3_CMD, const char *kill_mode_str)
Implementation of &#39;kill [window|client]&#39;.
Definition: commands.c:1176
uint32_t x
Definition: data.h:120
void cmd_move_direction(I3_CMD, const char *direction, long move_px)
Implementation of &#39;move <direction> [<pixels> [px]]&#39;.
Definition: commands.c:1449
Stores a rectangle, for example the size of a window, the child window etc.
Definition: data.h:141
Holds the status bar configuration (i3bar).
Definition: config.h:241
#define TAILQ_END(head)
Definition: queue.h:337
void init_logging(void)
Initializes logging by creating an error logfile in /tmp (or XDG_RUNTIME_DIR, see get_process_filenam...
Definition: log.c:83
void ipc_shutdown(void)
Calls shutdown() on each socket and closes it.
Definition: ipc.c:68
void cmd_move_window_to_center(I3_CMD, const char *method)
Implementation of &#39;move [window|container] [to] [absolute] position center.
Definition: commands.c:1721
void cmd_title_format(I3_CMD, const char *format)
Implementation of &#39;title_format <format>&#39;.
Definition: commands.c:1831
static Match current_match
xcb_window_t id
Definition: data.h:362
Con * con_get_workspace(Con *con)
Gets the workspace container this node is on.
Definition: con.c:373
static void cmd_resize_floating(I3_CMD, const char *way, const char *direction, Con *floating_con, int px)
Definition: commands.c:457
void cmd_open(I3_CMD)
Implementation of &#39;open&#39;.
Definition: commands.c:1612
direction_t
Definition: data.h:54
json_content_t json_determine_content(const char *filename)
Definition: load_layout.c:522
Con * workspace_prev(void)
Returns the previous workspace.
Definition: workspace.c:572
bool workspace_is_visible(Con *ws)
Returns true if the workspace is currently visible.
Definition: workspace.c:256
A &#39;Window&#39; is a type which contains an xcb_window_t and all the related information (hints like _NET_...
Definition: data.h:361
void cmd_focus_direction(I3_CMD, const char *direction)
Implementation of &#39;focus left|right|up|down&#39;.
Definition: commands.c:1223
orientation_t con_orientation(Con *con)
Returns the orientation of the given container (for stacked containers, vertical orientation is used ...
Definition: con.c:1166
bool level_down(void)
Moves focus one level down.
Definition: tree.c:452
void con_enable_fullscreen(Con *con, fullscreen_mode_t fullscreen_mode)
Enables fullscreen mode for the given container, if necessary.
Definition: con.c:835
Definition: data.h:55
bool resize_find_tiling_participants(Con **current, Con **other, direction_t direction)
Definition: resize.c:52
#define TAILQ_ENTRY(type)
Definition: queue.h:327
static bool cmd_resize_tiling_width_height(I3_CMD, Con *current, const char *way, const char *direction, int ppt)
Definition: commands.c:562
void cmd_rename_workspace(I3_CMD, const char *old_name, const char *new_name)
Implementation of &#39;rename workspace <name> to <name>&#39;.
Definition: commands.c:1874
void ewmh_update_sticky(xcb_window_t window, bool sticky)
Set or remove _NET_WM_STATE_STICKY on the window.
Definition: ewmh.c:270
void ewmh_update_wm_desktop(void)
Updates _NET_WM_DESKTOP for all windows.
Definition: ewmh.c:175
Con * con_get_fullscreen_con(Con *con, fullscreen_mode_t fullscreen_mode)
Returns the first fullscreen node below this node.
Definition: con.c:421
mark_mode_t
Definition: data.h:78
pid_t command_error_nagbar_pid
Definition: bindings.c:17
void tree_move(Con *con, int direction)
Moves the given container in the given direction (TOK_LEFT, TOK_RIGHT, TOK_UP, TOK_DOWN from cmdparse...
Definition: move.c:139
void cmd_move_con_to_output(I3_CMD, const char *name)
Implementation of &#39;move [window|container] [to] output <str>&#39;.
Definition: commands.c:1023
void switch_mode(const char *new_mode)
Switches the key bindings to the given mode, if the mode exists.
Definition: bindings.c:466
#define DLOG(fmt,...)
Definition: libi3.h:98
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:340
A &#39;Con&#39; represents everything from the X11 root window down to a single X11 window.
Definition: data.h:550
void restore_open_placeholder_windows(Con *parent)
Open placeholder windows for all children of parent.
void con_move_to_workspace(Con *con, Con *workspace, bool fix_coordinates, bool dont_warp, bool ignore_focus)
Moves the given container to the currently focused container on the given workspace.
Definition: con.c:1147
json_content_t
Definition: load_layout.h:13
struct deco_render_params * deco_render_params
Cache for the decoration rendering.
Definition: data.h:623
static bool definitelyGreaterThan(float a, float b, float epsilon)
Definition: commands.c:85
#define TAILQ_FIRST(head)
Definition: queue.h:336
#define HANDLE_EMPTY_MATCH
When the command did not include match criteria (!), we use the currently focused container...
Definition: commands.c:64
void cmd_workspace(I3_CMD, const char *which)
Implementation of &#39;workspace next|prev|next_on_output|prev_on_output&#39;.
Definition: commands.c:834
#define TAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:376
char * resolve_tilde(const char *path)
This function resolves ~ in pathnames.
void cmd_move_con_to_workspace_back_and_forth(I3_CMD)
Implementation of &#39;move [window|container] [to] workspace back_and_forth&#39;.
Definition: commands.c:335
Definition: data.h:56
enum Con::@20 type
const char * i3string_as_utf8(i3String *str)
Returns the UTF-8 encoded version of the i3String.
int logical_px(const int logical)
Convert a logical amount of pixels (e.g.
struct _i3String i3String
Opaque data structure for storing strings.
Definition: libi3.h:40
void cmd_move_window_to_position(I3_CMD, const char *method, long x, long y)
Implementation of &#39;move [window|container] [to] [absolute] position <px> [px] <px> [px]...
Definition: commands.c:1674
char * sstrdup(const char *str)
Safe-wrapper around strdup which exits if malloc returns NULL (meaning that there is no more memory a...
Definition: data.h:59
char * ipc_socket_path
Definition: config.h:96
int con_num_children(Con *con)
Returns the number of children of this container.
Definition: con.c:720
bool sticky
Definition: data.h:638
void render_con(Con *con, bool render_fullscreen)
"Renders" the given container (and its children), meaning that all rects are updated correctly...
Definition: render.c:42
layout_t layout
Definition: data.h:654
void cmd_workspace_number(I3_CMD, const char *which, const char *_no_auto_back_and_forth)
Implementation of &#39;workspace [–no-auto-back-and-forth] number <number>&#39;.
Definition: commands.c:870
void floating_move_to_pointer(Con *con)
Moves the given floating con to the current pointer position.
Definition: floating.c:431
border_style_t border_style
Definition: data.h:655
Definition: data.h:60
bool con_is_docked(Con *con)
Returns true if the container is a docked container.
Definition: con.c:485
i3String * con_parse_title_format(Con *con)
Returns the window title considering the current title format.
Definition: con.c:2011
struct regex * mark
Definition: data.h:453
void workspace_show_by_name(const char *num)
Looks up the workspace by name and switches to it.
Definition: workspace.c:499
void cmd_fullscreen(I3_CMD, const char *action, const char *fullscreen_mode)
Implementation of &#39;fullscreen [enable|disable|toggle] [global]&#39;.
Definition: commands.c:1384
void cmd_move_con_to_workspace_number(I3_CMD, const char *which, const char *_no_auto_back_and_forth)
Implementation of &#39;move [–no-auto-back-and-forth] [window|container] [to] workspace number <number>&#39;...
Definition: commands.c:408
void workspace_back_and_forth(void)
Focuses the previously focused workspace.
Definition: workspace.c:751
bool con_has_children(Con *con)
Returns true if this node has regular or floating children.
Definition: con.c:273
long ws_name_to_number(const char *name)
Parses the workspace name as a number.
Definition: util.c:76
void update_shmlog_atom()
Set up the SHMLOG_PATH atom.
Definition: x.c:1269
void floating_check_size(Con *floating_con)
Called when a floating window is created or resized.
Definition: floating.c:66
void cmd_focus(I3_CMD)
Implementation of &#39;focus&#39;.
Definition: commands.c:1308
bool regex_matches(struct regex *regex, const char *input)
Checks if the given regular expression matches the given input and returns true if it does...
Definition: regex.c:76
void floating_resize(Con *floating_con, int x, int y)
Sets size of the CT_FLOATING_CON to specified dimensions.
Definition: floating.c:833
void cmd_unmark(I3_CMD, const char *mark)
Implementation of &#39;unmark [mark]&#39;.
Definition: commands.c:992
Output * get_output_by_name(const char *name)
Returns the output with the given name if it is active (!) or NULL.
Definition: randr.c:52
struct all_cons_head all_cons
Definition: tree.c:17
void cmd_bar(I3_CMD, const char *bar_type, const char *bar_value, const char *bar_id)
Implementation of &#39;bar (hidden_state hide|show|toggle)|(mode dock|hide|invisible|toggle) [<bar_id>]&#39;...
Definition: commands.c:2052
enum Window::@13 dock
Whether the window says it is a dock window.
An Output is a physical output on your graphics driver.
Definition: data.h:330
bool workspace_move_to_output(Con *ws, const char *name)
Move the given workspace to the specified output.
Definition: workspace.c:912
bool con_is_floating(Con *con)
Returns true if the node is floating.
Definition: con.c:475
void cmd_move_workspace_to_output(I3_CMD, const char *name)
Implementation of &#39;move workspace to [output] <str>&#39;.
Definition: commands.c:1112
Con * focused
Definition: tree.c:15
Definition: data.h:90
void load_configuration(xcb_connection_t *conn, const char *override_configpath, bool reload)
Reads the configuration from ~/.i3/config or /etc/i3/config if not found.
Definition: config.c:72
bool con_move_to_mark(Con *con, const char *mark)
Moves the given container to the given mark.
Definition: con.c:1091
void update_barconfig()
Sends the current bar configuration as an event to all barconfig_update listeners.
Definition: config.c:35
static Con * maybe_auto_back_and_forth_workspace(Con *workspace)
Definition: commands.c:126
void cmd_layout(I3_CMD, const char *layout_str)
Implementation of &#39;layout default|stacked|stacking|tabbed|splitv|splith&#39;.
Definition: commands.c:1488
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:1511
void purge_zerobyte_logfile(void)
Deletes the unused log files.
Definition: log.c:344
int width_increment
Definition: data.h:430
void ewmh_update_desktop_names(void)
Updates _NET_DESKTOP_NAMES: "The names of all virtual desktops.
Definition: ewmh.c:55
struct Con * parent
Definition: data.h:582
bool cmd_bar_hidden_state(const char *bar_hidden_state, const char *bar_id)
Definition: commands.c:2009
typedef TAILQ_HEAD(owindows_head, owindow)
Definition: commands.c:159
void cmd_scratchpad_show(I3_CMD)
Implementation of &#39;scratchpad show&#39;.
Definition: commands.c:1809
Con * con_id
Definition: data.h:473
void cmd_border(I3_CMD, const char *border_style_str, long border_width)
Implementation of &#39;border normal|pixel [<n>]&#39;, &#39;border none|1pixel|toggle&#39;.
Definition: commands.c:719
void cmd_nop(I3_CMD, const char *comment)
Implementation of &#39;nop <comment>&#39;.
Definition: commands.c:762
char * id
Automatically generated ID for this bar config.
Definition: config.h:244
void ewmh_update_desktop_viewport(void)
Updates _NET_DESKTOP_VIEWPORT, which is an array of pairs of cardinals that define the top left corne...
Definition: ewmh.c:93
Con * con
Definition: commands.c:155
void tree_split(Con *con, orientation_t orientation)
Splits (horizontally or vertically) the given container by creating a new container which contains th...
Definition: tree.c:374
void con_set_layout(Con *con, layout_t layout)
This function changes the layout of a given container.
Definition: con.c:1553
void ipc_send_workspace_event(const char *change, Con *current, Con *old)
For the workspace events we send, along with the usual "change" field, also the workspace container i...
Definition: ipc.c:1233
void cmd_move_scratchpad(I3_CMD)
Implementation of &#39;move scratchpad&#39;.
Definition: commands.c:1789
void cmd_resize_set(I3_CMD, long cwidth, long cheight)
Implementation of &#39;resize set <px> [px] <px> [px]&#39;.
Definition: commands.c:691