i3
commands.c
Go to the documentation of this file.
1/*
2 * vim:ts=4:sw=4:expandtab
3 *
4 * i3 - an improved dynamic tiling window manager
5 * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
6 *
7 * commands.c: all command functions (see commands_parser.c)
8 *
9 */
10#include "all.h"
11#include "shmlog.h"
12
13#include <fcntl.h>
14#include <stdint.h>
15#include <unistd.h>
16
17// Macros to make the YAJL API a bit easier to use.
18#define y(x, ...) (cmd_output->json_gen != NULL ? yajl_gen_##x(cmd_output->json_gen, ##__VA_ARGS__) : 0)
19#define ystr(str) (cmd_output->json_gen != NULL ? yajl_gen_string(cmd_output->json_gen, (unsigned char *)str, strlen(str)) : 0)
20#define ysuccess(success) \
21 do { \
22 if (cmd_output->json_gen != NULL) { \
23 y(map_open); \
24 ystr("success"); \
25 y(bool, success); \
26 y(map_close); \
27 } \
28 } while (0)
29#define yerror(format, ...) \
30 do { \
31 if (cmd_output->json_gen != NULL) { \
32 char *message; \
33 sasprintf(&message, format, ##__VA_ARGS__); \
34 y(map_open); \
35 ystr("success"); \
36 y(bool, false); \
37 ystr("error"); \
38 ystr(message); \
39 y(map_close); \
40 free(message); \
41 } \
42 } while (0)
43
46#define HANDLE_INVALID_MATCH \
47 do { \
48 if (current_match->error != NULL) { \
49 yerror("Invalid match: %s", current_match->error); \
50 return; \
51 } \
52 } while (0)
53
59#define HANDLE_EMPTY_MATCH \
60 do { \
61 HANDLE_INVALID_MATCH; \
62 \
63 if (match_is_empty(current_match)) { \
64 while (!TAILQ_EMPTY(&owindows)) { \
65 owindow *ow = TAILQ_FIRST(&owindows); \
66 TAILQ_REMOVE(&owindows, ow, owindows); \
67 free(ow); \
68 } \
69 owindow *ow = smalloc(sizeof(owindow)); \
70 ow->con = focused; \
71 TAILQ_INIT(&owindows); \
72 TAILQ_INSERT_TAIL(&owindows, ow, owindows); \
73 } \
74 } while (0)
75
76/*
77 * Checks whether we switched to a new workspace and returns false in that case,
78 * signaling that further workspace switching should be done by the calling function
79 * If not, calls workspace_back_and_forth() if workspace_auto_back_and_forth is set
80 * and return true, signaling that no further workspace switching should occur in the calling function.
81 *
82 */
83static bool maybe_back_and_forth(struct CommandResultIR *cmd_output, const char *name) {
84 Con *ws = con_get_workspace(focused);
85
86 /* If we switched to a different workspace, do nothing */
87 if (strcmp(ws->name, name) != 0)
88 return false;
89
90 DLOG("This workspace is already focused.\n");
91 if (config.workspace_auto_back_and_forth) {
92 workspace_back_and_forth();
93 cmd_output->needs_tree_render = true;
94 }
95 return true;
96}
97
98/*
99 * Return the passed workspace unless it is the current one and auto back and
100 * forth is enabled, in which case the back_and_forth workspace is returned.
101 */
102static Con *maybe_auto_back_and_forth_workspace(Con *workspace) {
103 Con *current, *baf;
104
105 if (!config.workspace_auto_back_and_forth)
106 return workspace;
107
108 current = con_get_workspace(focused);
109
110 if (current == workspace) {
111 baf = workspace_back_and_forth_get();
112 if (baf != NULL) {
113 DLOG("Substituting workspace with back_and_forth, as it is focused.\n");
114 return baf;
115 }
116 }
117
118 return workspace;
119}
120
121/*******************************************************************************
122 * Criteria functions.
123 ******************************************************************************/
124
125/*
126 * Helper data structure for an operation window (window on which the operation
127 * will be performed). Used to build the TAILQ owindows.
128 *
129 */
130typedef struct owindow {
131 Con *con;
132 TAILQ_ENTRY(owindow) owindows;
133} owindow;
134
135typedef TAILQ_HEAD(owindows_head, owindow) owindows_head;
136
137static owindows_head owindows;
138
139/*
140 * Initializes the specified 'Match' data structure and the initial state of
141 * commands.c for matching target windows of a command.
142 *
143 */
144void cmd_criteria_init(I3_CMD) {
145 Con *con;
146 owindow *ow;
147
148 DLOG("Initializing criteria, current_match = %p\n", current_match);
149 match_free(current_match);
150 match_init(current_match);
151 while (!TAILQ_EMPTY(&owindows)) {
152 ow = TAILQ_FIRST(&owindows);
153 TAILQ_REMOVE(&owindows, ow, owindows);
154 free(ow);
155 }
156 TAILQ_INIT(&owindows);
157 /* copy all_cons */
158 TAILQ_FOREACH (con, &all_cons, all_cons) {
159 ow = smalloc(sizeof(owindow));
160 ow->con = con;
161 TAILQ_INSERT_TAIL(&owindows, ow, owindows);
162 }
163}
164
165/*
166 * A match specification just finished (the closing square bracket was found),
167 * so we filter the list of owindows.
168 *
169 */
170void cmd_criteria_match_windows(I3_CMD) {
171 owindow *next, *current;
172
173 DLOG("match specification finished, matching...\n");
174 /* copy the old list head to iterate through it and start with a fresh
175 * list which will contain only matching windows */
176 struct owindows_head old = owindows;
177 TAILQ_INIT(&owindows);
178 for (next = TAILQ_FIRST(&old); next != TAILQ_END(&old);) {
179 /* make a copy of the next pointer and advance the pointer to the
180 * next element as we are going to invalidate the element’s
181 * next/prev pointers by calling TAILQ_INSERT_TAIL later */
182 current = next;
183 next = TAILQ_NEXT(next, owindows);
184
185 DLOG("checking if con %p / %s matches\n", current->con, current->con->name);
186
187 /* We use this flag to prevent matching on window-less containers if
188 * only window-specific criteria were specified. */
189 bool accept_match = false;
190
191 if (current_match->con_id != NULL) {
192 accept_match = true;
193
194 if (current_match->con_id == current->con) {
195 DLOG("con_id matched.\n");
196 } else {
197 DLOG("con_id does not match.\n");
198 FREE(current);
199 continue;
200 }
201 }
202
203 if (current_match->mark != NULL && !TAILQ_EMPTY(&(current->con->marks_head))) {
204 accept_match = true;
205 bool matched_by_mark = false;
206
207 mark_t *mark;
208 TAILQ_FOREACH (mark, &(current->con->marks_head), marks) {
209 if (!regex_matches(current_match->mark, mark->name))
210 continue;
211
212 DLOG("match by mark\n");
213 matched_by_mark = true;
214 break;
215 }
216
217 if (!matched_by_mark) {
218 DLOG("mark does not match.\n");
219 FREE(current);
220 continue;
221 }
222 }
223
224 if (current->con->window != NULL) {
225 if (match_matches_window(current_match, current->con->window)) {
226 DLOG("matches window!\n");
227 accept_match = true;
228 } else {
229 DLOG("doesn't match\n");
230 FREE(current);
231 continue;
232 }
233 }
234
235 if (accept_match) {
236 TAILQ_INSERT_TAIL(&owindows, current, owindows);
237 } else {
238 FREE(current);
239 continue;
240 }
241 }
242
243 TAILQ_FOREACH (current, &owindows, owindows) {
244 DLOG("matching: %p / %s\n", current->con, current->con->name);
245 }
246}
247
248/*
249 * Interprets a ctype=cvalue pair and adds it to the current match
250 * specification.
251 *
252 */
253void cmd_criteria_add(I3_CMD, const char *ctype, const char *cvalue) {
254 match_parse_property(current_match, ctype, cvalue);
255}
256
257static void move_matches_to_workspace(Con *ws) {
258 owindow *current;
259 TAILQ_FOREACH (current, &owindows, owindows) {
260 DLOG("matching: %p / %s\n", current->con, current->con->name);
261 con_move_to_workspace(current->con, ws, true, false, false);
262 }
263}
264
265#define CHECK_MOVE_CON_TO_WORKSPACE \
266 do { \
267 HANDLE_EMPTY_MATCH; \
268 if (TAILQ_EMPTY(&owindows)) { \
269 yerror("Nothing to move: specified criteria don't match any window"); \
270 return; \
271 } else { \
272 bool found = false; \
273 owindow *current = TAILQ_FIRST(&owindows); \
274 while (current) { \
275 owindow *next = TAILQ_NEXT(current, owindows); \
276 \
277 if (current->con->type == CT_WORKSPACE && !con_has_children(current->con)) { \
278 TAILQ_REMOVE(&owindows, current, owindows); \
279 } else { \
280 found = true; \
281 } \
282 \
283 current = next; \
284 } \
285 if (!found) { \
286 yerror("Nothing to move: workspace empty"); \
287 return; \
288 } \
289 } \
290 } while (0)
291
292/*
293 * Implementation of 'move [window|container] [to] workspace
294 * next|prev|next_on_output|prev_on_output|current'.
295 *
296 */
297void cmd_move_con_to_workspace(I3_CMD, const char *which) {
298 DLOG("which=%s\n", which);
299
300 CHECK_MOVE_CON_TO_WORKSPACE;
301
302 /* get the workspace */
303 Con *ws;
304 if (strcmp(which, "next") == 0)
305 ws = workspace_next();
306 else if (strcmp(which, "prev") == 0)
307 ws = workspace_prev();
308 else if (strcmp(which, "next_on_output") == 0)
309 ws = workspace_next_on_output();
310 else if (strcmp(which, "prev_on_output") == 0)
311 ws = workspace_prev_on_output();
312 else if (strcmp(which, "current") == 0)
313 ws = con_get_workspace(focused);
314 else {
315 yerror("BUG: called with which=%s", which);
316 return;
317 }
318
319 move_matches_to_workspace(ws);
320
321 cmd_output->needs_tree_render = true;
322 // XXX: default reply for now, make this a better reply
323 ysuccess(true);
324}
325
326/*
327 * Implementation of 'move [window|container] [to] workspace back_and_forth'.
328 *
329 */
330void cmd_move_con_to_workspace_back_and_forth(I3_CMD) {
331 Con *ws = workspace_back_and_forth_get();
332 if (ws == NULL) {
333 yerror("No workspace was previously active.");
334 return;
335 }
336
337 HANDLE_EMPTY_MATCH;
338
339 move_matches_to_workspace(ws);
340
341 cmd_output->needs_tree_render = true;
342 // XXX: default reply for now, make this a better reply
343 ysuccess(true);
344}
345
346/*
347 * Implementation of 'move [--no-auto-back-and-forth] [window|container] [to] workspace <name>'.
348 *
349 */
350void cmd_move_con_to_workspace_name(I3_CMD, const char *name, const char *no_auto_back_and_forth) {
351 if (strncasecmp(name, "__", strlen("__")) == 0) {
352 yerror("You cannot move containers to i3-internal workspaces (\"%s\").", name);
353 return;
354 }
355
356 CHECK_MOVE_CON_TO_WORKSPACE;
357
358 LOG("should move window to workspace %s\n", name);
359 /* get the workspace */
360 Con *ws = workspace_get(name);
361
362 if (no_auto_back_and_forth == NULL) {
363 ws = maybe_auto_back_and_forth_workspace(ws);
364 }
365
366 move_matches_to_workspace(ws);
367
368 cmd_output->needs_tree_render = true;
369 // XXX: default reply for now, make this a better reply
370 ysuccess(true);
371}
372
373/*
374 * Implementation of 'move [--no-auto-back-and-forth] [window|container] [to] workspace number <name>'.
375 *
376 */
377void cmd_move_con_to_workspace_number(I3_CMD, const char *which, const char *no_auto_back_and_forth) {
378 CHECK_MOVE_CON_TO_WORKSPACE;
379
380 LOG("should move window to workspace %s\n", which);
381
382 long parsed_num = ws_name_to_number(which);
383 if (parsed_num == -1) {
384 LOG("Could not parse initial part of \"%s\" as a number.\n", which);
385 yerror("Could not parse number \"%s\"", which);
386 return;
387 }
388
389 Con *ws = get_existing_workspace_by_num(parsed_num);
390 if (!ws) {
391 ws = workspace_get(which);
392 }
393
394 if (no_auto_back_and_forth == NULL) {
395 ws = maybe_auto_back_and_forth_workspace(ws);
396 }
397
398 move_matches_to_workspace(ws);
399
400 cmd_output->needs_tree_render = true;
401 // XXX: default reply for now, make this a better reply
402 ysuccess(true);
403}
404
405/*
406 * Convert a string direction ("left", "right", etc.) to a direction_t. Assumes
407 * valid direction string.
408 */
409static direction_t parse_direction(const char *str) {
410 if (strcmp(str, "left") == 0) {
411 return D_LEFT;
412 } else if (strcmp(str, "right") == 0) {
413 return D_RIGHT;
414 } else if (strcmp(str, "up") == 0) {
415 return D_UP;
416 } else if (strcmp(str, "down") == 0) {
417 return D_DOWN;
418 } else {
419 ELOG("Invalid direction. This is a parser bug.\n");
420 assert(false);
421 }
422}
423
424static void cmd_resize_floating(I3_CMD, const char *direction_str, Con *floating_con, int px) {
425 Rect old_rect = floating_con->rect;
426 Con *focused_con = con_descend_focused(floating_con);
427
428 direction_t direction;
429 if (strcmp(direction_str, "height") == 0) {
430 direction = D_DOWN;
431 } else if (strcmp(direction_str, "width") == 0) {
432 direction = D_RIGHT;
433 } else {
434 direction = parse_direction(direction_str);
435 }
436 orientation_t orientation = orientation_from_direction(direction);
437
438 /* ensure that resize will take place even if pixel increment is smaller than
439 * height increment or width increment.
440 * fixes #1011 */
441 const i3Window *window = focused_con->window;
442 if (window != NULL) {
443 if (orientation == VERT) {
444 if (px < 0) {
445 px = (-px < window->height_increment) ? -window->height_increment : px;
446 } else {
447 px = (px < window->height_increment) ? window->height_increment : px;
448 }
449 } else {
450 if (px < 0) {
451 px = (-px < window->width_increment) ? -window->width_increment : px;
452 } else {
453 px = (px < window->width_increment) ? window->width_increment : px;
454 }
455 }
456 }
457
458 if (orientation == VERT) {
459 floating_con->rect.height += px;
460 } else {
461 floating_con->rect.width += px;
462 }
463 floating_check_size(floating_con, orientation == VERT);
464
465 /* Did we actually resize anything or did the size constraints prevent us?
466 * If we could not resize, exit now to not move the window. */
467 if (rect_equals(old_rect, floating_con->rect)) {
468 return;
469 }
470
471 if (direction == D_UP) {
472 floating_con->rect.y -= (floating_con->rect.height - old_rect.height);
473 } else if (direction == D_LEFT) {
474 floating_con->rect.x -= (floating_con->rect.width - old_rect.width);
475 }
476
477 /* If this is a scratchpad window, don't auto center it from now on. */
478 if (floating_con->scratchpad_state == SCRATCHPAD_FRESH) {
479 floating_con->scratchpad_state = SCRATCHPAD_CHANGED;
480 }
481}
482
483static bool cmd_resize_tiling_direction(I3_CMD, Con *current, const char *direction, int px, int ppt) {
484 Con *second = NULL;
485 Con *first = current;
486 direction_t search_direction = parse_direction(direction);
487
488 bool res = resize_find_tiling_participants(&first, &second, search_direction, false);
489 if (!res) {
490 yerror("No second container found in this direction.");
491 return false;
492 }
493
494 if (ppt) {
495 /* For backwards compatibility, 'X px or Y ppt' means that ppt is
496 * preferred. */
497 px = 0;
498 }
499 return resize_neighboring_cons(first, second, px, ppt);
500}
501
502static bool cmd_resize_tiling_width_height(I3_CMD, Con *current, const char *direction, int px, double ppt) {
503 LOG("width/height resize\n");
504
505 /* get the appropriate current container (skip stacked/tabbed cons) */
506 Con *dummy = NULL;
507 direction_t search_direction = (strcmp(direction, "width") == 0 ? D_LEFT : D_DOWN);
508 bool search_result = resize_find_tiling_participants(&current, &dummy, search_direction, true);
509 if (search_result == false) {
510 yerror("Failed to find appropriate tiling containers for resize operation");
511 return false;
512 }
513
514 /* get the default percentage */
515 int children = con_num_children(current->parent);
516 LOG("ins. %d children\n", children);
517 double percentage = 1.0 / children;
518 LOG("default percentage = %f\n", percentage);
519
520 /* Ensure all the other children have a percentage set. */
521 Con *child;
522 TAILQ_FOREACH (child, &(current->parent->nodes_head), nodes) {
523 LOG("child->percent = %f (child %p)\n", child->percent, child);
524 if (child->percent == 0.0)
525 child->percent = percentage;
526 }
527
528 double new_current_percent;
529 double subtract_percent;
530 if (ppt != 0.0) {
531 new_current_percent = current->percent + ppt;
532 } else {
533 /* Convert px change to change in percentages */
534 ppt = (double)px / (double)con_rect_size_in_orientation(current->parent);
535 new_current_percent = current->percent + ppt;
536 }
537 subtract_percent = ppt / (children - 1);
538 if (ppt < 0.0 && new_current_percent < percent_for_1px(current)) {
539 yerror("Not resizing, container would end with less than 1px");
540 return false;
541 }
542
543 LOG("new_current_percent = %f\n", new_current_percent);
544 LOG("subtract_percent = %f\n", subtract_percent);
545 /* Ensure that the new percentages are positive. */
546 if (subtract_percent >= 0.0) {
547 TAILQ_FOREACH (child, &(current->parent->nodes_head), nodes) {
548 if (child == current) {
549 continue;
550 }
551 if (child->percent - subtract_percent < percent_for_1px(child)) {
552 yerror("Not resizing, already at minimum size (child %p would end up with a size of %.f", child, child->percent - subtract_percent);
553 return false;
554 }
555 }
556 }
557
558 current->percent = new_current_percent;
559 LOG("current->percent after = %f\n", current->percent);
560
561 TAILQ_FOREACH (child, &(current->parent->nodes_head), nodes) {
562 if (child == current)
563 continue;
564 child->percent -= subtract_percent;
565 LOG("child->percent after (%p) = %f\n", child, child->percent);
566 }
567
568 return true;
569}
570
571/*
572 * Implementation of 'resize grow|shrink <direction> [<px> px] [or <ppt> ppt]'.
573 *
574 */
575void cmd_resize(I3_CMD, const char *way, const char *direction, long resize_px, long resize_ppt) {
576 DLOG("resizing in way %s, direction %s, px %ld or ppt %ld\n", way, direction, resize_px, resize_ppt);
577 if (strcmp(way, "shrink") == 0) {
578 resize_px *= -1;
579 resize_ppt *= -1;
580 }
581
582 HANDLE_EMPTY_MATCH;
583
584 owindow *current;
585 TAILQ_FOREACH (current, &owindows, owindows) {
586 /* Don't handle dock windows (issue #1201) */
587 if (current->con->window && current->con->window->dock) {
588 DLOG("This is a dock window. Not resizing (con = %p)\n)", current->con);
589 continue;
590 }
591
592 Con *floating_con;
593 if ((floating_con = con_inside_floating(current->con))) {
594 cmd_resize_floating(current_match, cmd_output, direction, floating_con, resize_px);
595 } else {
596 if (strcmp(direction, "width") == 0 ||
597 strcmp(direction, "height") == 0) {
598 const double ppt = (double)resize_ppt / 100.0;
599 if (!cmd_resize_tiling_width_height(current_match, cmd_output,
600 current->con, direction,
601 resize_px, ppt)) {
602 yerror("Cannot resize.");
603 return;
604 }
605 } else {
606 if (!cmd_resize_tiling_direction(current_match, cmd_output,
607 current->con, direction,
608 resize_px, resize_ppt)) {
609 yerror("Cannot resize.");
610 return;
611 }
612 }
613 }
614 }
615
616 cmd_output->needs_tree_render = true;
617 // XXX: default reply for now, make this a better reply
618 ysuccess(true);
619}
620
621static bool resize_set_tiling(I3_CMD, Con *target, orientation_t resize_orientation, bool is_ppt, long target_size) {
622 direction_t search_direction;
623 char *mode;
624 if (resize_orientation == HORIZ) {
625 search_direction = D_LEFT;
626 mode = "width";
627 } else {
628 search_direction = D_DOWN;
629 mode = "height";
630 }
631
632 /* Get the appropriate current container (skip stacked/tabbed cons) */
633 Con *dummy;
634 resize_find_tiling_participants(&target, &dummy, search_direction, true);
635
636 /* Calculate new size for the target container */
637 double ppt = 0.0;
638 int px = 0;
639 if (is_ppt) {
640 ppt = (double)target_size / 100.0 - target->percent;
641 } else {
642 px = target_size - (resize_orientation == HORIZ ? target->rect.width : target->rect.height);
643 }
644
645 /* Perform resizing and report failure if not possible */
646 return cmd_resize_tiling_width_height(current_match, cmd_output,
647 target, mode, px, ppt);
648}
649
650/*
651 * Implementation of 'resize set <width> [px | ppt] <height> [px | ppt]'.
652 *
653 */
654void cmd_resize_set(I3_CMD, long cwidth, const char *mode_width, long cheight, const char *mode_height) {
655 DLOG("resizing to %ld %s x %ld %s\n", cwidth, mode_width, cheight, mode_height);
656 if (cwidth < 0 || cheight < 0) {
657 yerror("Dimensions cannot be negative.");
658 return;
659 }
660
661 HANDLE_EMPTY_MATCH;
662
663 owindow *current;
664 bool success = true;
665 TAILQ_FOREACH (current, &owindows, owindows) {
666 Con *floating_con;
667 if ((floating_con = con_inside_floating(current->con))) {
668 Con *output = con_get_output(floating_con);
669 if (cwidth == 0) {
670 cwidth = floating_con->rect.width;
671 } else if (mode_width && strcmp(mode_width, "ppt") == 0) {
672 cwidth = output->rect.width * ((double)cwidth / 100.0);
673 }
674 if (cheight == 0) {
675 cheight = floating_con->rect.height;
676 } else if (mode_height && strcmp(mode_height, "ppt") == 0) {
677 cheight = output->rect.height * ((double)cheight / 100.0);
678 }
679 floating_resize(floating_con, cwidth, cheight);
680 } else {
681 if (current->con->window && current->con->window->dock) {
682 DLOG("This is a dock window. Not resizing (con = %p)\n)", current->con);
683 continue;
684 }
685
686 if (cwidth > 0) {
687 bool is_ppt = mode_width && strcmp(mode_width, "ppt") == 0;
688 success &= resize_set_tiling(current_match, cmd_output, current->con,
689 HORIZ, is_ppt, cwidth);
690 }
691 if (cheight > 0) {
692 bool is_ppt = mode_height && strcmp(mode_height, "ppt") == 0;
693 success &= resize_set_tiling(current_match, cmd_output, current->con,
694 VERT, is_ppt, cheight);
695 }
696 }
697 }
698
699 cmd_output->needs_tree_render = true;
700 ysuccess(success);
701}
702
703static int border_width_from_style(border_style_t border_style, long border_width, Con *con) {
704 if (border_style == BS_NONE) {
705 return 0;
706 }
707 if (border_width >= 0) {
708 return logical_px(border_width);
709 }
710
711 const bool is_floating = con_inside_floating(con) != NULL;
712 /* Load the configured defaults. */
713 if (is_floating && border_style == config.default_floating_border) {
714 return config.default_floating_border_width;
715 } else if (!is_floating && border_style == config.default_border) {
716 return config.default_border_width;
717 } else {
718 /* Use some hardcoded values. */
719 return logical_px(border_style == BS_NORMAL ? 2 : 1);
720 }
721}
722
723/*
724 * Implementation of 'border normal|pixel [<n>]', 'border none|1pixel|toggle'.
725 *
726 */
727void cmd_border(I3_CMD, const char *border_style_str, long border_width) {
728 DLOG("border style should be changed to %s with border width %ld\n", border_style_str, border_width);
729 owindow *current;
730
731 HANDLE_EMPTY_MATCH;
732
733 TAILQ_FOREACH (current, &owindows, owindows) {
734 DLOG("matching: %p / %s\n", current->con, current->con->name);
735
736 border_style_t border_style;
737 if (strcmp(border_style_str, "toggle") == 0) {
738 border_style = (current->con->border_style + 1) % 3;
739 } else if (strcmp(border_style_str, "normal") == 0) {
740 border_style = BS_NORMAL;
741 } else if (strcmp(border_style_str, "pixel") == 0) {
742 border_style = BS_PIXEL;
743 } else if (strcmp(border_style_str, "none") == 0) {
744 border_style = BS_NONE;
745 } else {
746 yerror("BUG: called with border_style=%s", border_style_str);
747 return;
748 }
749
750 /* User changed the border */
751 current->con->max_user_border_style = border_style;
752 const int con_border_width = border_width_from_style(border_style, border_width, current->con);
753 con_set_border_style(current->con, border_style, con_border_width);
754 }
755
756 cmd_output->needs_tree_render = true;
757 ysuccess(true);
758}
759
760/*
761 * Implementation of 'nop <comment>'.
762 *
763 */
764void cmd_nop(I3_CMD, const char *comment) {
765 LOG("-------------------------------------------------\n");
766 LOG(" NOP: %.4000s\n", comment);
767 LOG("-------------------------------------------------\n");
768 ysuccess(true);
769}
770
771/*
772 * Implementation of 'append_layout <path>'.
773 *
774 */
775void cmd_append_layout(I3_CMD, const char *cpath) {
776 LOG("Appending layout \"%s\"\n", cpath);
777
778 /* Make sure we allow paths like '~/.i3/layout.json' */
779 char *path = resolve_tilde(cpath);
780
781 char *buf = NULL;
782 ssize_t len;
783 if ((len = slurp(path, &buf)) < 0) {
784 yerror("Could not slurp \"%s\".", path);
785 /* slurp already logged an error. */
786 goto out;
787 }
788
789 if (!json_validate(buf, len)) {
790 ELOG("Could not parse \"%s\" as JSON, not loading.\n", path);
791 yerror("Could not parse \"%s\" as JSON.", path);
792 goto out;
793 }
794
795 json_content_t content = json_determine_content(buf, len);
796 LOG("JSON content = %d\n", content);
797 if (content == JSON_CONTENT_UNKNOWN) {
798 ELOG("Could not determine the contents of \"%s\", not loading.\n", path);
799 yerror("Could not determine the contents of \"%s\".", path);
800 goto out;
801 }
802
803 Con *parent = focused;
804 if (content == JSON_CONTENT_WORKSPACE) {
805 parent = output_get_content(con_get_output(parent));
806 } else {
807 /* We need to append the layout to a split container, since a leaf
808 * container must not have any children (by definition).
809 * Note that we explicitly check for workspaces, since they are okay for
810 * this purpose, but con_accepts_window() returns false for workspaces. */
811 while (parent->type != CT_WORKSPACE && !con_accepts_window(parent))
812 parent = parent->parent;
813 }
814 DLOG("Appending to parent=%p instead of focused=%p\n", parent, focused);
815 char *errormsg = NULL;
816 tree_append_json(parent, buf, len, &errormsg);
817 if (errormsg != NULL) {
818 yerror(errormsg);
819 free(errormsg);
820 /* Note that we continue executing since tree_append_json() has
821 * side-effects — user-provided layouts can be partly valid, partly
822 * invalid, leading to half of the placeholder containers being
823 * created. */
824 } else {
825 ysuccess(true);
826 }
827
828 // XXX: This is a bit of a kludge. Theoretically, render_con(parent,
829 // false); should be enough, but when sending 'workspace 4; append_layout
830 // /tmp/foo.json', the needs_tree_render == true of the workspace command
831 // is not executed yet and will be batched with append_layout’s
832 // needs_tree_render after the parser finished. We should check if that is
833 // necessary at all.
834 render_con(croot);
835
836 restore_open_placeholder_windows(parent);
837
838 if (content == JSON_CONTENT_WORKSPACE)
839 ipc_send_workspace_event("restored", parent, NULL);
840
841 cmd_output->needs_tree_render = true;
842out:
843 free(path);
844 free(buf);
845}
846
847/*
848 * Implementation of 'workspace next|prev|next_on_output|prev_on_output'.
849 *
850 */
851void cmd_workspace(I3_CMD, const char *which) {
852 Con *ws;
853
854 DLOG("which=%s\n", which);
855
856 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
857 yerror("Cannot switch workspace while in global fullscreen");
858 return;
859 }
860
861 if (strcmp(which, "next") == 0)
862 ws = workspace_next();
863 else if (strcmp(which, "prev") == 0)
864 ws = workspace_prev();
865 else if (strcmp(which, "next_on_output") == 0)
866 ws = workspace_next_on_output();
867 else if (strcmp(which, "prev_on_output") == 0)
868 ws = workspace_prev_on_output();
869 else {
870 yerror("BUG: called with which=%s", which);
871 return;
872 }
873
874 workspace_show(ws);
875
876 cmd_output->needs_tree_render = true;
877 // XXX: default reply for now, make this a better reply
878 ysuccess(true);
879}
880
881/*
882 * Implementation of 'workspace [--no-auto-back-and-forth] number <name>'
883 *
884 */
885void cmd_workspace_number(I3_CMD, const char *which, const char *_no_auto_back_and_forth) {
886 const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
887
888 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
889 yerror("Cannot switch workspace while in global fullscreen");
890 return;
891 }
892
893 long parsed_num = ws_name_to_number(which);
894 if (parsed_num == -1) {
895 yerror("Could not parse initial part of \"%s\" as a number.", which);
896 return;
897 }
898
899 Con *workspace = get_existing_workspace_by_num(parsed_num);
900 if (!workspace) {
901 LOG("There is no workspace with number %ld, creating a new one.\n", parsed_num);
902 ysuccess(true);
903 workspace_show_by_name(which);
904 cmd_output->needs_tree_render = true;
905 return;
906 }
907 if (!no_auto_back_and_forth && maybe_back_and_forth(cmd_output, workspace->name)) {
908 ysuccess(true);
909 return;
910 }
911 workspace_show(workspace);
912
913 cmd_output->needs_tree_render = true;
914 // XXX: default reply for now, make this a better reply
915 ysuccess(true);
916}
917
918/*
919 * Implementation of 'workspace back_and_forth'.
920 *
921 */
922void cmd_workspace_back_and_forth(I3_CMD) {
923 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
924 yerror("Cannot switch workspace while in global fullscreen");
925 return;
926 }
927
928 workspace_back_and_forth();
929
930 cmd_output->needs_tree_render = true;
931 // XXX: default reply for now, make this a better reply
932 ysuccess(true);
933}
934
935/*
936 * Implementation of 'workspace [--no-auto-back-and-forth] <name>'
937 *
938 */
939void cmd_workspace_name(I3_CMD, const char *name, const char *_no_auto_back_and_forth) {
940 const bool no_auto_back_and_forth = (_no_auto_back_and_forth != NULL);
941
942 if (strncasecmp(name, "__", strlen("__")) == 0) {
943 yerror("You cannot switch to the i3-internal workspaces (\"%s\").", name);
944 return;
945 }
946
947 if (con_get_fullscreen_con(croot, CF_GLOBAL)) {
948 yerror("Cannot switch workspace while in global fullscreen");
949 return;
950 }
951
952 DLOG("should switch to workspace %s\n", name);
953 if (!no_auto_back_and_forth && maybe_back_and_forth(cmd_output, name)) {
954 ysuccess(true);
955 return;
956 }
957 workspace_show_by_name(name);
958
959 cmd_output->needs_tree_render = true;
960 // XXX: default reply for now, make this a better reply
961 ysuccess(true);
962}
963
964/*
965 * Implementation of 'mark [--add|--replace] [--toggle] <mark>'
966 *
967 */
968void cmd_mark(I3_CMD, const char *mark, const char *mode, const char *toggle) {
969 HANDLE_EMPTY_MATCH;
970
971 owindow *current = TAILQ_FIRST(&owindows);
972 if (current == NULL) {
973 yerror("Given criteria don't match a window");
974 return;
975 }
976
977 /* Marks must be unique, i.e., no two windows must have the same mark. */
978 if (current != TAILQ_LAST(&owindows, owindows_head)) {
979 yerror("A mark must not be put onto more than one window");
980 return;
981 }
982
983 DLOG("matching: %p / %s\n", current->con, current->con->name);
984
985 mark_mode_t mark_mode = (mode == NULL || strcmp(mode, "--replace") == 0) ? MM_REPLACE : MM_ADD;
986 if (toggle != NULL) {
987 con_mark_toggle(current->con, mark, mark_mode);
988 } else {
989 con_mark(current->con, mark, mark_mode);
990 }
991
992 cmd_output->needs_tree_render = true;
993 // XXX: default reply for now, make this a better reply
994 ysuccess(true);
995}
996
997/*
998 * Implementation of 'unmark [mark]'
999 *
1000 */
1001void cmd_unmark(I3_CMD, const char *mark) {
1002 if (match_is_empty(current_match)) {
1003 con_unmark(NULL, mark);
1004 } else {
1005 owindow *current;
1006 TAILQ_FOREACH (current, &owindows, owindows) {
1007 con_unmark(current->con, mark);
1008 }
1009 }
1010
1011 cmd_output->needs_tree_render = true;
1012 // XXX: default reply for now, make this a better reply
1013 ysuccess(true);
1014}
1015
1016/*
1017 * Implementation of 'mode <string>'.
1018 *
1019 */
1020void cmd_mode(I3_CMD, const char *mode) {
1021 DLOG("mode=%s\n", mode);
1022 switch_mode(mode);
1023
1024 // XXX: default reply for now, make this a better reply
1025 ysuccess(true);
1026}
1027
1028typedef struct user_output_name {
1029 char *name;
1030 TAILQ_ENTRY(user_output_name) user_output_names;
1031} user_output_name;
1032typedef TAILQ_HEAD(user_output_names_head, user_output_name) user_output_names_head;
1033
1034static void user_output_names_add(user_output_names_head *list, const char *name) {
1035 const bool get_non_primary = (strcasecmp("nonprimary", name) == 0);
1036 if (get_non_primary || strcmp(name, "next") == 0) {
1037 /* "next" (or "nonprimary") here work like a wildcard: It "expands" to
1038 * all available (or non-primary) outputs. */
1039 Output *output;
1040 TAILQ_FOREACH (output, &outputs, outputs) {
1041 if (get_non_primary && output->primary) {
1042 continue;
1043 }
1044
1045 user_output_name *co = scalloc(sizeof(user_output_name), 1);
1046 co->name = sstrdup(output_primary_name(output));
1047 TAILQ_INSERT_TAIL(list, co, user_output_names);
1048 }
1049 return;
1050 }
1051
1052 user_output_name *co = scalloc(sizeof(user_output_name), 1);
1053 co->name = sstrdup(name);
1054 TAILQ_INSERT_TAIL(list, co, user_output_names);
1055 return;
1056}
1057
1058static Output *user_output_names_find_next(user_output_names_head *names, Output *current_output) {
1059 Output *target_output = NULL;
1060 user_output_name *uo;
1061 TAILQ_FOREACH (uo, names, user_output_names) {
1062 if (!target_output) {
1063 /* The first available output from the list is used in 2 cases:
1064 * 1. When we must wrap around the user list. For example, if user
1065 * specifies outputs A B C and C is `current_output`.
1066 * 2. When the current output is not in the user list. For example,
1067 * user specifies A B C and D is `current_output`. */
1068 target_output = get_output_from_string(current_output, uo->name);
1069 }
1070 if (strcasecmp(output_primary_name(current_output), uo->name) == 0) {
1071 /* The current output is in the user list */
1072 while (true) {
1073 /* This corrupts the outer loop but it is ok since we are going
1074 * to break anyway. */
1075 uo = TAILQ_NEXT(uo, user_output_names);
1076 if (!uo) {
1077 /* We reached the end of the list. We should use the first
1078 * available output that, if it exists, is already saved in
1079 * target_output. */
1080 break;
1081 }
1082 Output *out = get_output_from_string(current_output, uo->name);
1083 if (out) {
1084 return out;
1085 }
1086 }
1087 break;
1088 }
1089 }
1090 return target_output;
1091}
1092
1093static void user_output_names_free(user_output_names_head *names) {
1094 user_output_name *uo;
1095 while (!TAILQ_EMPTY(names)) {
1096 uo = TAILQ_FIRST(names);
1097 free(uo->name);
1098 TAILQ_REMOVE(names, uo, user_output_names);
1099 free(uo);
1100 }
1101}
1102
1103/*
1104 * Implementation of 'move [window|container|workspace] [to] output <strings>'.
1105 *
1106 */
1107void cmd_move_con_to_output(I3_CMD, const char *name, bool move_workspace) {
1108 /* Initialize a data structure that is used to save multiple user-specified
1109 * output names since this function is called multiple types for each
1110 * command call. */
1111 static user_output_names_head names = TAILQ_HEAD_INITIALIZER(names);
1112
1113 if (name) {
1114 user_output_names_add(&names, name);
1115 return;
1116 }
1117
1118 HANDLE_EMPTY_MATCH;
1119
1120 if (TAILQ_EMPTY(&names)) {
1121 yerror("At least one output must be specified");
1122 return;
1123 }
1124
1125 bool success = false;
1126 owindow *current;
1127 TAILQ_FOREACH (current, &owindows, owindows) {
1128 Con *ws = con_get_workspace(current->con);
1129 if (con_is_internal(ws)) {
1130 continue;
1131 }
1132
1133 Output *current_output = get_output_for_con(ws);
1134 Output *target_output = user_output_names_find_next(&names, current_output);
1135 if (target_output) {
1136 if (move_workspace) {
1137 workspace_move_to_output(ws, target_output);
1138 } else {
1139 con_move_to_output(current->con, target_output, true);
1140 }
1141 success = true;
1142 }
1143 }
1144 user_output_names_free(&names);
1145
1146 cmd_output->needs_tree_render = success;
1147 if (success) {
1148 ysuccess(true);
1149 } else {
1150 yerror("No output matched");
1151 }
1152}
1153
1154/*
1155 * Implementation of 'move [container|window] [to] mark <str>'.
1156 *
1157 */
1158void cmd_move_con_to_mark(I3_CMD, const char *mark) {
1159 DLOG("moving window to mark \"%s\"\n", mark);
1160
1161 HANDLE_EMPTY_MATCH;
1162
1163 bool result = true;
1164 owindow *current;
1165 TAILQ_FOREACH (current, &owindows, owindows) {
1166 DLOG("moving matched window %p / %s to mark \"%s\"\n", current->con, current->con->name, mark);
1167 result &= con_move_to_mark(current->con, mark);
1168 }
1169
1170 cmd_output->needs_tree_render = true;
1171 ysuccess(result);
1172}
1173
1174/*
1175 * Implementation of 'floating enable|disable|toggle'
1176 *
1177 */
1178void cmd_floating(I3_CMD, const char *floating_mode) {
1179 owindow *current;
1180
1181 DLOG("floating_mode=%s\n", floating_mode);
1182
1183 HANDLE_EMPTY_MATCH;
1184
1185 TAILQ_FOREACH (current, &owindows, owindows) {
1186 DLOG("matching: %p / %s\n", current->con, current->con->name);
1187 if (strcmp(floating_mode, "toggle") == 0) {
1188 DLOG("should toggle mode\n");
1189 toggle_floating_mode(current->con, false);
1190 } else {
1191 DLOG("should switch mode to %s\n", floating_mode);
1192 if (strcmp(floating_mode, "enable") == 0) {
1193 floating_enable(current->con, false);
1194 } else {
1195 floating_disable(current->con);
1196 }
1197 }
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 'split v|h|t|vertical|horizontal|toggle'.
1207 *
1208 */
1209void cmd_split(I3_CMD, const char *direction) {
1210 HANDLE_EMPTY_MATCH;
1211
1212 owindow *current;
1213 LOG("splitting in direction %c\n", direction[0]);
1214 TAILQ_FOREACH (current, &owindows, owindows) {
1215 if (con_is_docked(current->con)) {
1216 ELOG("Cannot split a docked container, skipping.\n");
1217 continue;
1218 }
1219
1220 DLOG("matching: %p / %s\n", current->con, current->con->name);
1221 if (direction[0] == 't') {
1222 layout_t current_layout;
1223 if (current->con->type == CT_WORKSPACE) {
1224 current_layout = current->con->layout;
1225 } else {
1226 current_layout = current->con->parent->layout;
1227 }
1228 /* toggling split orientation */
1229 if (current_layout == L_SPLITH) {
1230 tree_split(current->con, VERT);
1231 } else {
1232 tree_split(current->con, HORIZ);
1233 }
1234 } else {
1235 tree_split(current->con, (direction[0] == 'v' ? VERT : HORIZ));
1236 }
1237 }
1238
1239 cmd_output->needs_tree_render = true;
1240 // XXX: default reply for now, make this a better reply
1241 ysuccess(true);
1242}
1243
1244/*
1245 * Implementation of 'kill [window|client]'.
1246 *
1247 */
1248void cmd_kill(I3_CMD, const char *kill_mode_str) {
1249 if (kill_mode_str == NULL)
1250 kill_mode_str = "window";
1251
1252 DLOG("kill_mode=%s\n", kill_mode_str);
1253
1254 int kill_mode;
1255 if (strcmp(kill_mode_str, "window") == 0)
1256 kill_mode = KILL_WINDOW;
1257 else if (strcmp(kill_mode_str, "client") == 0)
1258 kill_mode = KILL_CLIENT;
1259 else {
1260 yerror("BUG: called with kill_mode=%s", kill_mode_str);
1261 return;
1262 }
1263
1264 HANDLE_EMPTY_MATCH;
1265
1266 owindow *current;
1267 TAILQ_FOREACH (current, &owindows, owindows) {
1268 con_close(current->con, kill_mode);
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 'exec [--no-startup-id] <command>'.
1278 *
1279 */
1280void cmd_exec(I3_CMD, const char *nosn, const char *command) {
1281 bool no_startup_id = (nosn != NULL);
1282
1283 HANDLE_EMPTY_MATCH;
1284
1285 int count = 0;
1286 owindow *current;
1287 TAILQ_FOREACH (current, &owindows, owindows) {
1288 count++;
1289 }
1290
1291 if (count > 1) {
1292 LOG("WARNING: Your criteria for the exec command match %d containers, "
1293 "so the command will execute this many times.\n",
1294 count);
1295 }
1296
1297 TAILQ_FOREACH (current, &owindows, owindows) {
1298 DLOG("should execute %s, no_startup_id = %d\n", command, no_startup_id);
1299 start_application(command, no_startup_id);
1300 }
1301
1302 ysuccess(true);
1303}
1304
1305#define CMD_FOCUS_WARN_CHILDREN \
1306 do { \
1307 int count = 0; \
1308 owindow *current; \
1309 TAILQ_FOREACH (current, &owindows, owindows) { \
1310 count++; \
1311 } \
1312 \
1313 if (count > 1) { \
1314 LOG("WARNING: Your criteria for the focus command matches %d containers, " \
1315 "while only exactly one container can be focused at a time.\n", \
1316 count); \
1317 } \
1318 } while (0)
1319
1320/*
1321 * Implementation of 'focus left|right|up|down|next|prev'.
1322 *
1323 */
1324void cmd_focus_direction(I3_CMD, const char *direction_str) {
1325 HANDLE_EMPTY_MATCH;
1326 CMD_FOCUS_WARN_CHILDREN;
1327
1328 direction_t direction;
1329 position_t position;
1330 bool auto_direction = true;
1331 if (strcmp(direction_str, "prev") == 0) {
1332 position = BEFORE;
1333 } else if (strcmp(direction_str, "next") == 0) {
1334 position = AFTER;
1335 } else {
1336 auto_direction = false;
1337 direction = parse_direction(direction_str);
1338 }
1339
1340 owindow *current;
1341 TAILQ_FOREACH (current, &owindows, owindows) {
1342 Con *ws = con_get_workspace(current->con);
1343 if (!ws || con_is_internal(ws)) {
1344 continue;
1345 }
1346 if (auto_direction) {
1347 orientation_t o = con_orientation(current->con->parent);
1348 direction = direction_from_orientation_position(o, position);
1349 }
1350 tree_next(current->con, direction);
1351 }
1352
1353 cmd_output->needs_tree_render = true;
1354 // XXX: default reply for now, make this a better reply
1355 ysuccess(true);
1356}
1357
1358/*
1359 * Implementation of 'focus next|prev sibling'
1360 *
1361 */
1362void cmd_focus_sibling(I3_CMD, const char *direction_str) {
1363 HANDLE_EMPTY_MATCH;
1364 CMD_FOCUS_WARN_CHILDREN;
1365
1366 const position_t direction = (STARTS_WITH(direction_str, "prev")) ? BEFORE : AFTER;
1367 owindow *current;
1368 TAILQ_FOREACH (current, &owindows, owindows) {
1369 Con *ws = con_get_workspace(current->con);
1370 if (!ws || con_is_internal(ws)) {
1371 continue;
1372 }
1373 Con *next = get_tree_next_sibling(current->con, direction);
1374 if (next) {
1375 if (next->type == CT_WORKSPACE) {
1376 /* On the workspace level, we need to make sure that the
1377 * workspace change happens properly. However, workspace_show
1378 * descends focus so we also have to put focus on the workspace
1379 * itself to maintain consistency. See #3997. */
1380 workspace_show(next);
1381 con_focus(next);
1382 } else {
1383 con_activate(next);
1384 }
1385 }
1386 }
1387
1388 cmd_output->needs_tree_render = true;
1389 // XXX: default reply for now, make this a better reply
1390 ysuccess(true);
1391}
1392
1393/*
1394 * Implementation of 'focus tiling|floating|mode_toggle'.
1395 *
1396 */
1397void cmd_focus_window_mode(I3_CMD, const char *window_mode) {
1398 DLOG("window_mode = %s\n", window_mode);
1399
1400 bool to_floating = false;
1401 if (strcmp(window_mode, "mode_toggle") == 0) {
1402 to_floating = !con_inside_floating(focused);
1403 } else if (strcmp(window_mode, "floating") == 0) {
1404 to_floating = true;
1405 } else if (strcmp(window_mode, "tiling") == 0) {
1406 to_floating = false;
1407 }
1408
1409 Con *ws = con_get_workspace(focused);
1410 Con *current;
1411 bool success = false;
1412 TAILQ_FOREACH (current, &(ws->focus_head), focused) {
1413 if ((to_floating && current->type != CT_FLOATING_CON) ||
1414 (!to_floating && current->type == CT_FLOATING_CON))
1415 continue;
1416
1417 con_activate_unblock(con_descend_focused(current));
1418 success = true;
1419 break;
1420 }
1421
1422 if (success) {
1423 cmd_output->needs_tree_render = true;
1424 ysuccess(true);
1425 } else {
1426 yerror("Failed to find a %s container in workspace.", to_floating ? "floating" : "tiling");
1427 }
1428}
1429
1430/*
1431 * Implementation of 'focus parent|child'.
1432 *
1433 */
1434void cmd_focus_level(I3_CMD, const char *level) {
1435 DLOG("level = %s\n", level);
1436 bool success = false;
1437
1438 /* Focusing the parent can only be allowed if the newly
1439 * focused container won't escape the fullscreen container. */
1440 if (strcmp(level, "parent") == 0) {
1441 if (focused && focused->parent) {
1442 if (con_fullscreen_permits_focusing(focused->parent))
1443 success = level_up();
1444 else
1445 ELOG("'focus parent': Currently in fullscreen, not going up\n");
1446 }
1447 }
1448
1449 /* Focusing a child should always be allowed. */
1450 else
1451 success = level_down();
1452
1453 cmd_output->needs_tree_render = success;
1454 // XXX: default reply for now, make this a better reply
1455 ysuccess(success);
1456}
1457
1458/*
1459 * Implementation of 'focus'.
1460 *
1461 */
1462void cmd_focus(I3_CMD) {
1463 DLOG("current_match = %p\n", current_match);
1464
1465 if (match_is_empty(current_match)) {
1466 ELOG("You have to specify which window/container should be focused.\n");
1467 ELOG("Example: [class=\"urxvt\" title=\"irssi\"] focus\n");
1468
1469 yerror("You have to specify which window/container should be focused");
1470 return;
1471 } else if (TAILQ_EMPTY(&owindows)) {
1472 yerror("No window matches given criteria");
1473 return;
1474 }
1475
1476 CMD_FOCUS_WARN_CHILDREN;
1477
1478 Con *__i3_scratch = workspace_get("__i3_scratch");
1479 owindow *current;
1480 TAILQ_FOREACH (current, &owindows, owindows) {
1481 Con *ws = con_get_workspace(current->con);
1482 /* If no workspace could be found, this was a dock window.
1483 * Just skip it, you cannot focus dock windows. */
1484 if (!ws)
1485 continue;
1486
1487 /* In case this is a scratchpad window, call scratchpad_show(). */
1488 if (ws == __i3_scratch) {
1489 scratchpad_show(current->con);
1490 /* While for the normal focus case we can change focus multiple
1491 * times and only a single window ends up focused, we could show
1492 * multiple scratchpad windows. So, rather break here. */
1493 break;
1494 }
1495
1496 LOG("focusing %p / %s\n", current->con, current->con->name);
1497 con_activate_unblock(current->con);
1498 }
1499
1500 cmd_output->needs_tree_render = true;
1501 ysuccess(true);
1502}
1503
1504/*
1505 * Implementation of 'fullscreen enable|toggle [global]' and
1506 * 'fullscreen disable'
1507 *
1508 */
1509void cmd_fullscreen(I3_CMD, const char *action, const char *fullscreen_mode) {
1510 fullscreen_mode_t mode = strcmp(fullscreen_mode, "global") == 0 ? CF_GLOBAL : CF_OUTPUT;
1511 DLOG("%s fullscreen, mode = %s\n", action, fullscreen_mode);
1512 owindow *current;
1513
1514 HANDLE_EMPTY_MATCH;
1515
1516 TAILQ_FOREACH (current, &owindows, owindows) {
1517 DLOG("matching: %p / %s\n", current->con, current->con->name);
1518 if (strcmp(action, "toggle") == 0) {
1519 con_toggle_fullscreen(current->con, mode);
1520 } else if (strcmp(action, "enable") == 0) {
1521 con_enable_fullscreen(current->con, mode);
1522 } else if (strcmp(action, "disable") == 0) {
1523 con_disable_fullscreen(current->con);
1524 }
1525 }
1526
1527 cmd_output->needs_tree_render = true;
1528 // XXX: default reply for now, make this a better reply
1529 ysuccess(true);
1530}
1531
1532/*
1533 * Implementation of 'sticky enable|disable|toggle'.
1534 *
1535 */
1536void cmd_sticky(I3_CMD, const char *action) {
1537 DLOG("%s sticky on window\n", action);
1538 HANDLE_EMPTY_MATCH;
1539
1540 owindow *current;
1541 TAILQ_FOREACH (current, &owindows, owindows) {
1542 if (current->con->window == NULL) {
1543 ELOG("only containers holding a window can be made sticky, skipping con = %p\n", current->con);
1544 continue;
1545 }
1546 DLOG("setting sticky for container = %p / %s\n", current->con, current->con->name);
1547
1548 bool sticky = false;
1549 if (strcmp(action, "enable") == 0)
1550 sticky = true;
1551 else if (strcmp(action, "disable") == 0)
1552 sticky = false;
1553 else if (strcmp(action, "toggle") == 0)
1554 sticky = !current->con->sticky;
1555
1556 current->con->sticky = sticky;
1557 ewmh_update_sticky(current->con->window->id, sticky);
1558 }
1559
1560 /* A window we made sticky might not be on a visible workspace right now, so we need to make
1561 * sure it gets pushed to the front now. */
1562 output_push_sticky_windows(focused);
1563
1564 ewmh_update_wm_desktop();
1565
1566 cmd_output->needs_tree_render = true;
1567 ysuccess(true);
1568}
1569
1570/*
1571 * Implementation of 'move <direction> [<amount> [px|ppt]]'.
1572 *
1573 */
1574void cmd_move_direction(I3_CMD, const char *direction_str, long amount, const char *mode) {
1575 owindow *current;
1576 HANDLE_EMPTY_MATCH;
1577
1578 Con *initially_focused = focused;
1579 direction_t direction = parse_direction(direction_str);
1580
1581 const bool is_ppt = mode && strcmp(mode, "ppt") == 0;
1582
1583 DLOG("moving in direction %s, %ld %s\n", direction_str, amount, mode);
1584 TAILQ_FOREACH (current, &owindows, owindows) {
1585 if (con_is_floating(current->con)) {
1586 DLOG("floating move with %ld %s\n", amount, mode);
1587 Rect newrect = current->con->parent->rect;
1588 Con *output = con_get_output(current->con);
1589
1590 switch (direction) {
1591 case D_LEFT:
1592 newrect.x -= is_ppt ? output->rect.width * ((double)amount / 100.0) : amount;
1593 break;
1594 case D_RIGHT:
1595 newrect.x += is_ppt ? output->rect.width * ((double)amount / 100.0) : amount;
1596 break;
1597 case D_UP:
1598 newrect.y -= is_ppt ? output->rect.height * ((double)amount / 100.0) : amount;
1599 break;
1600 case D_DOWN:
1601 newrect.y += is_ppt ? output->rect.height * ((double)amount / 100.0) : amount;
1602 break;
1603 }
1604
1605 cmd_output->needs_tree_render = floating_reposition(current->con->parent, newrect);
1606 } else {
1607 tree_move(current->con, direction);
1608 cmd_output->needs_tree_render = true;
1609 }
1610 }
1611
1612 /* The move command should not disturb focus. con_exists is called because
1613 * tree_move calls tree_flatten. */
1614 if (focused != initially_focused && con_exists(initially_focused)) {
1615 con_activate(initially_focused);
1616 }
1617
1618 // XXX: default reply for now, make this a better reply
1619 ysuccess(true);
1620}
1621
1622/*
1623 * Implementation of 'layout default|stacked|stacking|tabbed|splitv|splith'.
1624 *
1625 */
1626void cmd_layout(I3_CMD, const char *layout_str) {
1627 HANDLE_EMPTY_MATCH;
1628
1629 layout_t layout;
1630 if (!layout_from_name(layout_str, &layout)) {
1631 yerror("Unknown layout \"%s\", this is a mismatch between code and parser spec.", layout_str);
1632 return;
1633 }
1634
1635 DLOG("changing layout to %s (%d)\n", layout_str, layout);
1636
1637 owindow *current;
1638 TAILQ_FOREACH (current, &owindows, owindows) {
1639 if (con_is_docked(current->con)) {
1640 ELOG("cannot change layout of a docked container, skipping it.\n");
1641 continue;
1642 }
1643
1644 DLOG("matching: %p / %s\n", current->con, current->con->name);
1645 con_set_layout(current->con, layout);
1646 }
1647
1648 cmd_output->needs_tree_render = true;
1649 // XXX: default reply for now, make this a better reply
1650 ysuccess(true);
1651}
1652
1653/*
1654 * Implementation of 'layout toggle [all|split]'.
1655 *
1656 */
1657void cmd_layout_toggle(I3_CMD, const char *toggle_mode) {
1658 owindow *current;
1659
1660 if (toggle_mode == NULL)
1661 toggle_mode = "default";
1662
1663 DLOG("toggling layout (mode = %s)\n", toggle_mode);
1664
1665 /* check if the match is empty, not if the result is empty */
1666 if (match_is_empty(current_match))
1667 con_toggle_layout(focused, toggle_mode);
1668 else {
1669 TAILQ_FOREACH (current, &owindows, owindows) {
1670 DLOG("matching: %p / %s\n", current->con, current->con->name);
1671 con_toggle_layout(current->con, toggle_mode);
1672 }
1673 }
1674
1675 cmd_output->needs_tree_render = true;
1676 // XXX: default reply for now, make this a better reply
1677 ysuccess(true);
1678}
1679
1680/*
1681 * Implementation of 'exit'.
1682 *
1683 */
1684void cmd_exit(I3_CMD) {
1685 LOG("Exiting due to user command.\n");
1686 exit(EXIT_SUCCESS);
1687
1688 /* unreached */
1689}
1690
1691/*
1692 * Implementation of 'reload'.
1693 *
1694 */
1695void cmd_reload(I3_CMD) {
1696 LOG("reloading\n");
1697
1698 kill_nagbar(config_error_nagbar_pid, false);
1699 kill_nagbar(command_error_nagbar_pid, false);
1700 /* start_nagbar() will refuse to start a new process if the passed pid is
1701 * set. This will happen when our child watcher is triggered by libev when
1702 * the loop re-starts. However, config errors might be detected before
1703 * that since we will read the config right now with load_configuration.
1704 * See #4104. */
1705 config_error_nagbar_pid = command_error_nagbar_pid = -1;
1706
1707 load_configuration(NULL, C_RELOAD);
1708 x_set_i3_atoms();
1709 /* Send an IPC event just in case the ws names have changed */
1710 ipc_send_workspace_event("reload", NULL, NULL);
1711 /* Send an update event for each barconfig just in case it has changed */
1712 Barconfig *current;
1713 TAILQ_FOREACH (current, &barconfigs, configs) {
1714 ipc_send_barconfig_update_event(current);
1715 }
1716
1717 // XXX: default reply for now, make this a better reply
1718 ysuccess(true);
1719}
1720
1721/*
1722 * Implementation of 'restart'.
1723 *
1724 */
1725void cmd_restart(I3_CMD) {
1726 LOG("restarting i3\n");
1727 int exempt_fd = -1;
1728 if (cmd_output->client != NULL) {
1729 exempt_fd = cmd_output->client->fd;
1730 LOG("Carrying file descriptor %d across restart\n", exempt_fd);
1731 int flags;
1732 if ((flags = fcntl(exempt_fd, F_GETFD)) < 0 ||
1733 fcntl(exempt_fd, F_SETFD, flags & ~FD_CLOEXEC) < 0) {
1734 ELOG("Could not disable FD_CLOEXEC on fd %d\n", exempt_fd);
1735 }
1736 char *fdstr = NULL;
1737 sasprintf(&fdstr, "%d", exempt_fd);
1738 setenv("_I3_RESTART_FD", fdstr, 1);
1739 }
1740 ipc_shutdown(SHUTDOWN_REASON_RESTART, exempt_fd);
1741 unlink(config.ipc_socket_path);
1742 if (current_log_stream_socket_path != NULL) {
1743 unlink(current_log_stream_socket_path);
1744 }
1745 /* We need to call this manually since atexit handlers don’t get called
1746 * when exec()ing */
1747 purge_zerobyte_logfile();
1748 i3_restart(false);
1749 /* unreached */
1750 assert(false);
1751}
1752
1753/*
1754 * Implementation of 'open'.
1755 *
1756 */
1757void cmd_open(I3_CMD) {
1758 LOG("opening new container\n");
1759 Con *con = tree_open_con(NULL, NULL);
1760 con->layout = L_SPLITH;
1761 con_activate(con);
1762
1763 y(map_open);
1764 ystr("success");
1765 y(bool, true);
1766 ystr("id");
1767 y(integer, (uintptr_t)con);
1768 y(map_close);
1769
1770 cmd_output->needs_tree_render = true;
1771}
1772
1773/*
1774 * Implementation of 'focus output <output>'.
1775 *
1776 */
1777void cmd_focus_output(I3_CMD, const char *name) {
1778 static user_output_names_head names = TAILQ_HEAD_INITIALIZER(names);
1779 if (name) {
1780 user_output_names_add(&names, name);
1781 return;
1782 }
1783
1784 if (TAILQ_EMPTY(&names)) {
1785 yerror("At least one output must be specified");
1786 return;
1787 }
1788
1789 HANDLE_EMPTY_MATCH;
1790
1791 if (TAILQ_EMPTY(&owindows)) {
1792 ysuccess(true);
1793 return;
1794 }
1795
1796 Output *current_output = get_output_for_con(TAILQ_FIRST(&owindows)->con);
1797 Output *target_output = user_output_names_find_next(&names, current_output);
1798 user_output_names_free(&names);
1799 bool success = false;
1800 if (target_output) {
1801 success = true;
1802
1803 /* get visible workspace on output */
1804 Con *ws = NULL;
1805 GREP_FIRST(ws, output_get_content(target_output->con), workspace_is_visible(child));
1806 if (!ws) {
1807 yerror("BUG: No workspace found on output.");
1808 return;
1809 }
1810
1811 workspace_show(ws);
1812 }
1813
1814 cmd_output->needs_tree_render = success;
1815 if (success) {
1816 ysuccess(true);
1817 } else {
1818 yerror("No output matched");
1819 }
1820}
1821
1822/*
1823 * Implementation of 'move [window|container] [to] [absolute] position [<pos_x> [px|ppt] <pos_y> [px|ppt]]
1824 *
1825 */
1826void cmd_move_window_to_position(I3_CMD, long x, const char *mode_x, long y, const char *mode_y) {
1827 bool has_error = false;
1828
1829 owindow *current;
1830 HANDLE_EMPTY_MATCH;
1831
1832 TAILQ_FOREACH (current, &owindows, owindows) {
1833 if (!con_is_floating(current->con)) {
1834 ELOG("Cannot change position. The window/container is not floating\n");
1835
1836 if (!has_error) {
1837 yerror("Cannot change position of a window/container because it is not floating.");
1838 has_error = true;
1839 }
1840
1841 continue;
1842 }
1843
1844 Rect newrect = current->con->parent->rect;
1845 Con *output = con_get_output(current->con);
1846
1847 newrect.x = mode_x && strcmp(mode_x, "ppt") == 0 ? output->rect.width * ((double)x / 100.0) : x;
1848 newrect.y = mode_y && strcmp(mode_y, "ppt") == 0 ? output->rect.height * ((double)y / 100.0) : y;
1849 DLOG("moving to position %d %s %d %s\n", newrect.x, mode_x, newrect.y, mode_y);
1850
1851 if (!floating_reposition(current->con->parent, newrect)) {
1852 yerror("Cannot move window/container out of bounds.");
1853 has_error = true;
1854 }
1855 }
1856
1857 if (!has_error)
1858 ysuccess(true);
1859}
1860
1861/*
1862 * Implementation of 'move [window|container] [to] [absolute] position center
1863 *
1864 */
1865void cmd_move_window_to_center(I3_CMD, const char *method) {
1866 bool has_error = false;
1867 HANDLE_EMPTY_MATCH;
1868
1869 owindow *current;
1870 TAILQ_FOREACH (current, &owindows, owindows) {
1871 Con *floating_con = con_inside_floating(current->con);
1872 if (floating_con == NULL) {
1873 ELOG("con %p / %s is not floating, cannot move it to the center.\n",
1874 current->con, current->con->name);
1875
1876 if (!has_error) {
1877 yerror("Cannot change position of a window/container because it is not floating.");
1878 has_error = true;
1879 }
1880
1881 continue;
1882 }
1883
1884 if (strcmp(method, "absolute") == 0) {
1885 DLOG("moving to absolute center\n");
1886 floating_center(floating_con, croot->rect);
1887
1888 floating_maybe_reassign_ws(floating_con);
1889 cmd_output->needs_tree_render = true;
1890 }
1891
1892 if (strcmp(method, "position") == 0) {
1893 DLOG("moving to center\n");
1894 floating_center(floating_con, con_get_workspace(floating_con)->rect);
1895
1896 cmd_output->needs_tree_render = true;
1897 }
1898 }
1899
1900 // XXX: default reply for now, make this a better reply
1901 if (!has_error)
1902 ysuccess(true);
1903}
1904
1905/*
1906 * Implementation of 'move [window|container] [to] position mouse'
1907 *
1908 */
1909void cmd_move_window_to_mouse(I3_CMD) {
1910 HANDLE_EMPTY_MATCH;
1911
1912 owindow *current;
1913 TAILQ_FOREACH (current, &owindows, owindows) {
1914 Con *floating_con = con_inside_floating(current->con);
1915 if (floating_con == NULL) {
1916 DLOG("con %p / %s is not floating, cannot move it to the mouse position.\n",
1917 current->con, current->con->name);
1918 continue;
1919 }
1920
1921 DLOG("moving floating container %p / %s to cursor position\n", floating_con, floating_con->name);
1922 floating_move_to_pointer(floating_con);
1923 }
1924
1925 cmd_output->needs_tree_render = true;
1926 ysuccess(true);
1927}
1928
1929/*
1930 * Implementation of 'move scratchpad'.
1931 *
1932 */
1933void cmd_move_scratchpad(I3_CMD) {
1934 DLOG("should move window to scratchpad\n");
1935 owindow *current;
1936
1937 HANDLE_EMPTY_MATCH;
1938
1939 TAILQ_FOREACH (current, &owindows, owindows) {
1940 DLOG("matching: %p / %s\n", current->con, current->con->name);
1941 scratchpad_move(current->con);
1942 }
1943
1944 cmd_output->needs_tree_render = true;
1945 // XXX: default reply for now, make this a better reply
1946 ysuccess(true);
1947}
1948
1949/*
1950 * Implementation of 'scratchpad show'.
1951 *
1952 */
1953void cmd_scratchpad_show(I3_CMD) {
1954 DLOG("should show scratchpad window\n");
1955 owindow *current;
1956 bool result = false;
1957
1958 if (match_is_empty(current_match)) {
1959 result = scratchpad_show(NULL);
1960 } else {
1961 TAILQ_FOREACH (current, &owindows, owindows) {
1962 DLOG("matching: %p / %s\n", current->con, current->con->name);
1963 result |= scratchpad_show(current->con);
1964 }
1965 }
1966
1967 cmd_output->needs_tree_render = true;
1968
1969 ysuccess(result);
1970}
1971
1972/*
1973 * Implementation of 'swap [container] [with] id|con_id|mark <arg>'.
1974 *
1975 */
1976void cmd_swap(I3_CMD, const char *mode, const char *arg) {
1977 HANDLE_EMPTY_MATCH;
1978
1979 owindow *match = TAILQ_FIRST(&owindows);
1980 if (match == NULL) {
1981 yerror("No match found for swapping.");
1982 return;
1983 }
1984 if (match->con == NULL) {
1985 yerror("Match %p has no container.", match);
1986 return;
1987 }
1988
1989 Con *con;
1990 if (strcmp(mode, "id") == 0) {
1991 long target;
1992 if (!parse_long(arg, &target, 0)) {
1993 yerror("Failed to parse %s into a window id.", arg);
1994 return;
1995 }
1996
1997 con = con_by_window_id(target);
1998 } else if (strcmp(mode, "con_id") == 0) {
1999 long target;
2000 if (!parse_long(arg, &target, 0)) {
2001 yerror("Failed to parse %s into a container id.", arg);
2002 return;
2003 }
2004
2005 con = con_by_con_id(target);
2006 } else if (strcmp(mode, "mark") == 0) {
2007 con = con_by_mark(arg);
2008 } else {
2009 yerror("Unhandled swap mode \"%s\". This is a bug.", mode);
2010 return;
2011 }
2012
2013 if (con == NULL) {
2014 yerror("Could not find container for %s = %s", mode, arg);
2015 return;
2016 }
2017
2018 if (match != TAILQ_LAST(&owindows, owindows_head)) {
2019 LOG("More than one container matched the swap command, only using the first one.");
2020 }
2021
2022 DLOG("Swapping %p with %p.\n", match->con, con);
2023 bool result = con_swap(match->con, con);
2024
2025 cmd_output->needs_tree_render = true;
2026 // XXX: default reply for now, make this a better reply
2027 ysuccess(result);
2028}
2029
2030/*
2031 * Implementation of 'title_format <format>'
2032 *
2033 */
2034void cmd_title_format(I3_CMD, const char *format) {
2035 DLOG("setting title_format to \"%s\"\n", format);
2036 HANDLE_EMPTY_MATCH;
2037
2038 owindow *current;
2039 TAILQ_FOREACH (current, &owindows, owindows) {
2040 DLOG("setting title_format for %p / %s\n", current->con, current->con->name);
2041 FREE(current->con->title_format);
2042
2043 /* If we only display the title without anything else, we can skip the parsing step,
2044 * so we remove the title format altogether. */
2045 if (strcasecmp(format, "%title") != 0) {
2046 current->con->title_format = sstrdup(format);
2047
2048 if (current->con->window != NULL) {
2049 i3String *formatted_title = con_parse_title_format(current->con);
2050 ewmh_update_visible_name(current->con->window->id, i3string_as_utf8(formatted_title));
2051 I3STRING_FREE(formatted_title);
2052 }
2053 } else {
2054 if (current->con->window != NULL) {
2055 /* We can remove _NET_WM_VISIBLE_NAME since we don't display a custom title. */
2056 ewmh_update_visible_name(current->con->window->id, NULL);
2057 }
2058 }
2059
2060 if (current->con->window != NULL) {
2061 /* Make sure the window title is redrawn immediately. */
2062 current->con->window->name_x_changed = true;
2063 } else {
2064 /* For windowless containers we also need to force the redrawing. */
2065 FREE(current->con->deco_render_params);
2066 }
2067 }
2068
2069 cmd_output->needs_tree_render = true;
2070 ysuccess(true);
2071}
2072
2073/*
2074 * Implementation of 'title_window_icon <yes|no|toggle>' and 'title_window_icon padding <px>'
2075 *
2076 */
2077void cmd_title_window_icon(I3_CMD, const char *enable, int padding) {
2078 bool is_toggle = false;
2079 if (enable != NULL) {
2080 if (strcmp(enable, "toggle") == 0) {
2081 is_toggle = true;
2082 } else if (!boolstr(enable)) {
2083 padding = -1;
2084 }
2085 }
2086 DLOG("setting window_icon=%d\n", padding);
2087 HANDLE_EMPTY_MATCH;
2088
2089 owindow *current;
2090 TAILQ_FOREACH (current, &owindows, owindows) {
2091 if (is_toggle) {
2092 const int current_padding = current->con->window_icon_padding;
2093 if (padding > 0) {
2094 if (current_padding < 0) {
2095 current->con->window_icon_padding = padding;
2096 } else {
2097 /* toggle off, but store padding given */
2098 current->con->window_icon_padding = -(padding + 1);
2099 }
2100 } else {
2101 /* Set to negative of (current value+1) to keep old padding when toggling */
2102 current->con->window_icon_padding = -(current_padding + 1);
2103 }
2104 } else {
2105 current->con->window_icon_padding = padding;
2106 }
2107 DLOG("Set window_icon for %p / %s to %d\n", current->con, current->con->name, current->con->window_icon_padding);
2108
2109 if (current->con->window != NULL) {
2110 /* Make sure the window title is redrawn immediately. */
2111 current->con->window->name_x_changed = true;
2112 } else {
2113 /* For windowless containers we also need to force the redrawing. */
2114 FREE(current->con->deco_render_params);
2115 }
2116 }
2117
2118 cmd_output->needs_tree_render = true;
2119 ysuccess(true);
2120}
2121
2122/*
2123 * Implementation of 'rename workspace [<name>] to <name>'
2124 *
2125 */
2126void cmd_rename_workspace(I3_CMD, const char *old_name, const char *new_name) {
2127 if (strncasecmp(new_name, "__", strlen("__")) == 0) {
2128 yerror("Cannot rename workspace to \"%s\": names starting with __ are i3-internal.", new_name);
2129 return;
2130 }
2131 if (old_name) {
2132 LOG("Renaming workspace \"%s\" to \"%s\"\n", old_name, new_name);
2133 } else {
2134 LOG("Renaming current workspace to \"%s\"\n", new_name);
2135 }
2136
2137 Con *workspace;
2138 if (old_name) {
2139 workspace = get_existing_workspace_by_name(old_name);
2140 } else {
2141 workspace = con_get_workspace(focused);
2142 old_name = workspace->name;
2143 }
2144
2145 if (!workspace) {
2146 yerror("Old workspace \"%s\" not found", old_name);
2147 return;
2148 }
2149
2150 Con *check_dest = get_existing_workspace_by_name(new_name);
2151
2152 /* If check_dest == workspace, the user might be changing the case of the
2153 * workspace, or it might just be a no-op. */
2154 if (check_dest != NULL && check_dest != workspace) {
2155 yerror("New workspace \"%s\" already exists", new_name);
2156 return;
2157 }
2158
2159 /* Change the name and try to parse it as a number. */
2160 /* old_name might refer to workspace->name, so copy it before free()ing */
2161 char *old_name_copy = sstrdup(old_name);
2162 FREE(workspace->name);
2163 workspace->name = sstrdup(new_name);
2164
2165 workspace->num = ws_name_to_number(new_name);
2166 LOG("num = %d\n", workspace->num);
2167
2168 /* By re-attaching, the sort order will be correct afterwards. */
2169 Con *previously_focused = focused;
2170 Con *previously_focused_content = focused->type == CT_WORKSPACE ? focused->parent : NULL;
2171 Con *parent = workspace->parent;
2172 con_detach(workspace);
2173 con_attach(workspace, parent, false);
2174 ipc_send_workspace_event("rename", workspace, NULL);
2175
2176 Con *assigned = get_assigned_output(workspace->name, workspace->num);
2177 if (assigned) {
2178 workspace_move_to_output(workspace, get_output_for_con(assigned));
2179 }
2180
2181 bool can_restore_focus = previously_focused != NULL;
2182 /* NB: If previously_focused is a workspace we can't work directly with it
2183 * since it might have been cleaned up by workspace_show() already,
2184 * depending on the focus order/number of other workspaces on the output.
2185 * Instead, we loop through the available workspaces and only focus
2186 * previously_focused if we still find it. */
2187 if (previously_focused_content) {
2188 Con *workspace = NULL;
2189 GREP_FIRST(workspace, previously_focused_content, child == previously_focused);
2190 can_restore_focus &= (workspace != NULL);
2191 }
2192
2193 if (can_restore_focus) {
2194 /* Restore the previous focus since con_attach messes with the focus. */
2195 workspace_show(con_get_workspace(previously_focused));
2196 con_focus(previously_focused);
2197 }
2198
2199 /* Let back-and-forth work after renaming the previous workspace.
2200 * See #3694. */
2201 if (previous_workspace_name && !strcmp(previous_workspace_name, old_name_copy)) {
2202 FREE(previous_workspace_name);
2203 previous_workspace_name = sstrdup(new_name);
2204 }
2205
2206 cmd_output->needs_tree_render = true;
2207 ysuccess(true);
2208
2209 ewmh_update_desktop_properties();
2210
2211 startup_sequence_rename_workspace(old_name_copy, new_name);
2212 free(old_name_copy);
2213}
2214
2215/*
2216 * Implementation of 'bar mode dock|hide|invisible|toggle [<bar_id>]'
2217 *
2218 */
2219void cmd_bar_mode(I3_CMD, const char *bar_mode, const char *bar_id) {
2220 int mode = M_DOCK;
2221 bool toggle = false;
2222 if (strcmp(bar_mode, "dock") == 0)
2223 mode = M_DOCK;
2224 else if (strcmp(bar_mode, "hide") == 0)
2225 mode = M_HIDE;
2226 else if (strcmp(bar_mode, "invisible") == 0)
2227 mode = M_INVISIBLE;
2228 else if (strcmp(bar_mode, "toggle") == 0)
2229 toggle = true;
2230 else {
2231 ELOG("Unknown bar mode \"%s\", this is a mismatch between code and parser spec.\n", bar_mode);
2232 assert(false);
2233 }
2234
2235 if (TAILQ_EMPTY(&barconfigs)) {
2236 yerror("No bars found\n");
2237 return;
2238 }
2239
2240 Barconfig *current = NULL;
2241 TAILQ_FOREACH (current, &barconfigs, configs) {
2242 if (bar_id && strcmp(current->id, bar_id) != 0) {
2243 continue;
2244 }
2245
2246 if (toggle) {
2247 mode = (current->mode + 1) % 2;
2248 }
2249
2250 DLOG("Changing bar mode of bar_id '%s' from '%d' to '%s (%d)'\n",
2251 current->id, current->mode, bar_mode, mode);
2252 if ((int)current->mode != mode) {
2253 current->mode = mode;
2254 ipc_send_barconfig_update_event(current);
2255 }
2256
2257 if (bar_id) {
2258 /* We are looking for a specific bar and we found it */
2259 ysuccess(true);
2260 return;
2261 }
2262 }
2263
2264 if (bar_id) {
2265 /* We are looking for a specific bar and we did not find it */
2266 yerror("Changing bar mode of bar_id %s failed, bar_id not found.\n", bar_id);
2267 } else {
2268 /* We have already handled the case of no bars, so we must have
2269 * updated all active bars now. */
2270 ysuccess(true);
2271 }
2272}
2273
2274/*
2275 * Implementation of 'bar hidden_state hide|show|toggle [<bar_id>]'
2276 *
2277 */
2278void cmd_bar_hidden_state(I3_CMD, const char *bar_hidden_state, const char *bar_id) {
2279 int hidden_state = S_SHOW;
2280 bool toggle = false;
2281 if (strcmp(bar_hidden_state, "hide") == 0)
2282 hidden_state = S_HIDE;
2283 else if (strcmp(bar_hidden_state, "show") == 0)
2284 hidden_state = S_SHOW;
2285 else if (strcmp(bar_hidden_state, "toggle") == 0)
2286 toggle = true;
2287 else {
2288 ELOG("Unknown bar state \"%s\", this is a mismatch between code and parser spec.\n", bar_hidden_state);
2289 assert(false);
2290 }
2291
2292 if (TAILQ_EMPTY(&barconfigs)) {
2293 yerror("No bars found\n");
2294 return;
2295 }
2296
2297 Barconfig *current = NULL;
2298 TAILQ_FOREACH (current, &barconfigs, configs) {
2299 if (bar_id && strcmp(current->id, bar_id) != 0) {
2300 continue;
2301 }
2302
2303 if (toggle) {
2304 hidden_state = (current->hidden_state + 1) % 2;
2305 }
2306
2307 DLOG("Changing bar hidden_state of bar_id '%s' from '%d' to '%s (%d)'\n",
2308 current->id, current->hidden_state, bar_hidden_state, hidden_state);
2309 if ((int)current->hidden_state != hidden_state) {
2310 current->hidden_state = hidden_state;
2311 ipc_send_barconfig_update_event(current);
2312 }
2313
2314 if (bar_id) {
2315 /* We are looking for a specific bar and we found it */
2316 ysuccess(true);
2317 return;
2318 }
2319 }
2320
2321 if (bar_id) {
2322 /* We are looking for a specific bar and we did not find it */
2323 yerror("Changing bar hidden_state of bar_id %s failed, bar_id not found.\n", bar_id);
2324 } else {
2325 /* We have already handled the case of no bars, so we must have
2326 * updated all active bars now. */
2327 ysuccess(true);
2328 }
2329}
2330
2331/*
2332 * Implementation of 'shmlog <size>|toggle|on|off'
2333 *
2334 */
2335void cmd_shmlog(I3_CMD, const char *argument) {
2336 if (!strcmp(argument, "toggle"))
2337 /* Toggle shm log, if size is not 0. If it is 0, set it to default. */
2338 shmlog_size = shmlog_size ? -shmlog_size : default_shmlog_size;
2339 else if (!strcmp(argument, "on"))
2340 shmlog_size = default_shmlog_size;
2341 else if (!strcmp(argument, "off"))
2342 shmlog_size = 0;
2343 else {
2344 long new_size = 0;
2345 if (!parse_long(argument, &new_size, 0)) {
2346 yerror("Failed to parse %s into a shmlog size.", argument);
2347 return;
2348 }
2349 /* If shm logging now, restart logging with the new size. */
2350 if (shmlog_size > 0) {
2351 shmlog_size = 0;
2352 LOG("Restarting shm logging...\n");
2353 init_logging();
2354 }
2355 shmlog_size = (int)new_size;
2356 }
2357 LOG("%s shm logging\n", shmlog_size > 0 ? "Enabling" : "Disabling");
2358 init_logging();
2359 update_shmlog_atom();
2360 ysuccess(true);
2361}
2362
2363/*
2364 * Implementation of 'debuglog toggle|on|off'
2365 *
2366 */
2367void cmd_debuglog(I3_CMD, const char *argument) {
2368 bool logging = get_debug_logging();
2369 if (!strcmp(argument, "toggle")) {
2370 LOG("%s debug logging\n", logging ? "Disabling" : "Enabling");
2371 set_debug_logging(!logging);
2372 } else if (!strcmp(argument, "on") && !logging) {
2373 LOG("Enabling debug logging\n");
2374 set_debug_logging(true);
2375 } else if (!strcmp(argument, "off") && logging) {
2376 LOG("Disabling debug logging\n");
2377 set_debug_logging(false);
2378 }
2379 // XXX: default reply for now, make this a better reply
2380 ysuccess(true);
2381}
2382
2383static int *gaps_inner(gaps_t *gaps) {
2384 return &(gaps->inner);
2385}
2386
2387static int *gaps_top(gaps_t *gaps) {
2388 return &(gaps->top);
2389}
2390
2391static int *gaps_left(gaps_t *gaps) {
2392 return &(gaps->left);
2393}
2394
2395static int *gaps_bottom(gaps_t *gaps) {
2396 return &(gaps->bottom);
2397}
2398
2399static int *gaps_right(gaps_t *gaps) {
2400 return &(gaps->right);
2401}
2402
2403typedef int *(*gap_accessor)(gaps_t *);
2404
2405static bool gaps_update(gap_accessor get, const char *scope, const char *mode, int pixels) {
2406 DLOG("gaps_update(scope=%s, mode=%s, pixels=%d)\n", scope, mode, pixels);
2407 Con *workspace = con_get_workspace(focused);
2408
2409 const int global_gap_size = *get(&(config.gaps));
2410 int current_value = global_gap_size;
2411 if (strcmp(scope, "current") == 0) {
2412 current_value += *get(&(workspace->gaps));
2413 }
2414 DLOG("global_gap_size=%d, current_value=%d\n", global_gap_size, current_value);
2415
2416 bool reset = false;
2417 if (strcmp(mode, "plus") == 0)
2418 current_value += pixels;
2419 else if (strcmp(mode, "minus") == 0)
2420 current_value -= pixels;
2421 else if (strcmp(mode, "set") == 0) {
2422 current_value = pixels;
2423 reset = true;
2424 } else if (strcmp(mode, "toggle") == 0) {
2425 current_value = !current_value * pixels;
2426 reset = true;
2427 } else {
2428 ELOG("Invalid mode %s when changing gaps", mode);
2429 return false;
2430 }
2431
2432 /* See https://github.com/Airblader/i3/issues/262 */
2433 int min_value = 0;
2434 const bool is_outer = get(&(config.gaps)) != gaps_inner(&(config.gaps));
2435 if (is_outer) {
2436 /* Outer gaps can compensate inner gaps. */
2437 if (strcmp(scope, "all") == 0) {
2438 min_value = -config.gaps.inner;
2439 } else {
2440 min_value = -config.gaps.inner - workspace->gaps.inner;
2441 }
2442 }
2443
2444 if (current_value < min_value) {
2445 current_value = min_value;
2446 }
2447
2448 if (strcmp(scope, "all") == 0) {
2449 Con *output = NULL;
2450 TAILQ_FOREACH (output, &(croot->nodes_head), nodes) {
2451 Con *cur_ws = NULL;
2452 Con *content = output_get_content(output);
2453 TAILQ_FOREACH (cur_ws, &(content->nodes_head), nodes) {
2454 int *gaps_value = get(&(cur_ws->gaps));
2455 DLOG("current gaps_value = %d\n", *gaps_value);
2456
2457 if (reset) {
2458 *gaps_value = 0;
2459 } else {
2460 int max_compensate = 0;
2461 if (is_outer) {
2462 max_compensate = config.gaps.inner;
2463 }
2464 if (*gaps_value + current_value + max_compensate < 0) {
2465 /* Enforce new per-workspace gap size minimum value (in case
2466 current_value is smaller than before): the workspace can at most
2467 have a negative gap size of -current_value - max_compensate. */
2468 *gaps_value = -current_value - max_compensate;
2469 }
2470 }
2471 DLOG("gaps_value after fix = %d\n", *gaps_value);
2472 }
2473 }
2474
2475 *get(&(config.gaps)) = current_value;
2476 DLOG("global gaps value after fix = %d\n", *get(&(config.gaps)));
2477 } else {
2478 int *gaps_value = get(&(workspace->gaps));
2479 *gaps_value = current_value - global_gap_size;
2480 }
2481
2482 return true;
2483}
2484
2489void cmd_gaps(I3_CMD, const char *type, const char *scope, const char *mode, const char *value) {
2490 int pixels = logical_px(atoi(value));
2491
2492 if (!strcmp(type, "inner")) {
2493 if (!gaps_update(gaps_inner, scope, mode, pixels)) {
2494 goto error;
2495 }
2496 /* Update all workspaces with a no-op change (plus 0) so that the
2497 * minimum value is re-calculated and applied as a side effect. */
2498 if (!gaps_update(gaps_top, "all", "plus", 0) ||
2499 !gaps_update(gaps_bottom, "all", "plus", 0) ||
2500 !gaps_update(gaps_right, "all", "plus", 0) ||
2501 !gaps_update(gaps_left, "all", "plus", 0)) {
2502 goto error;
2503 }
2504 } else if (!strcmp(type, "outer")) {
2505 if (!gaps_update(gaps_top, scope, mode, pixels) ||
2506 !gaps_update(gaps_bottom, scope, mode, pixels) ||
2507 !gaps_update(gaps_right, scope, mode, pixels) ||
2508 !gaps_update(gaps_left, scope, mode, pixels)) {
2509 goto error;
2510 }
2511 } else if (!strcmp(type, "vertical")) {
2512 if (!gaps_update(gaps_top, scope, mode, pixels) ||
2513 !gaps_update(gaps_bottom, scope, mode, pixels)) {
2514 goto error;
2515 }
2516 } else if (!strcmp(type, "horizontal")) {
2517 if (!gaps_update(gaps_right, scope, mode, pixels) ||
2518 !gaps_update(gaps_left, scope, mode, pixels)) {
2519 goto error;
2520 }
2521 } else if (!strcmp(type, "top")) {
2522 if (!gaps_update(gaps_top, scope, mode, pixels)) {
2523 goto error;
2524 }
2525 } else if (!strcmp(type, "bottom")) {
2526 if (!gaps_update(gaps_bottom, scope, mode, pixels)) {
2527 goto error;
2528 }
2529 } else if (!strcmp(type, "right")) {
2530 if (!gaps_update(gaps_right, scope, mode, pixels)) {
2531 goto error;
2532 }
2533 } else if (!strcmp(type, "left")) {
2534 if (!gaps_update(gaps_left, scope, mode, pixels)) {
2535 goto error;
2536 }
2537 } else {
2538 ELOG("Invalid type %s when changing gaps", type);
2539 goto error;
2540 }
2541
2542 cmd_output->needs_tree_render = true;
2543 // XXX: default reply for now, make this a better reply
2544 ysuccess(true);
2545 return;
2546
2547error:
2548 ysuccess(false);
2549}
shmlog_size
int shmlog_size
Definition: log.c:47
get_debug_logging
bool get_debug_logging(void)
Checks if debug logging is active.
Definition: log.c:212
init_logging
void init_logging(void)
Initializes logging by creating an error logfile in /tmp (or XDG_RUNTIME_DIR, see get_process_filenam...
Definition: log.c:95
set_debug_logging
void set_debug_logging(const bool _debug_logging)
Set debug logging.
Definition: log.c:220
current_log_stream_socket_path
char * current_log_stream_socket_path
Definition: log.c:380
purge_zerobyte_logfile
void purge_zerobyte_logfile(void)
Deletes the unused log files.
Definition: log.c:358
switch_mode
void switch_mode(const char *new_mode)
Switches the key bindings to the given mode, if the mode exists.
Definition: bindings.c:620
command_error_nagbar_pid
pid_t command_error_nagbar_pid
Definition: bindings.c:19
outputs
struct outputs_head outputs
Definition: randr.c:22
get_output_from_string
Output * get_output_from_string(Output *current_output, const char *output_str)
Returns an 'output' corresponding to one of left/right/down/up or a specific output name.
Definition: output.c:33
output_push_sticky_windows
void output_push_sticky_windows(Con *old_focus)
Iterates over all outputs and pushes sticky windows to the currently visible workspace on that output...
Definition: output.c:77
output_primary_name
char * output_primary_name(Output *output)
Retrieves the primary name of an output.
Definition: output.c:53
get_output_for_con
Output * get_output_for_con(Con *con)
Returns the output for the given con.
Definition: output.c:57
output_get_content
Con * output_get_content(Con *output)
Returns the output container below the given output container.
Definition: output.c:16
marks
struct pending_marks * marks
json_validate
bool json_validate(const char *buf, const size_t len)
Returns true if the provided JSON could be parsed by yajl.
Definition: load_layout.c:600
json_determine_content
json_content_t json_determine_content(const char *buf, const size_t len)
Definition: load_layout.c:627
tree_append_json
void tree_append_json(Con *con, const char *buf, const size_t len, char **errormsg)
Definition: load_layout.c:660
default_shmlog_size
const int default_shmlog_size
Definition: main.c:84
ewmh_update_visible_name
void ewmh_update_visible_name(xcb_window_t window, const char *name)
Updates _NET_WM_VISIBLE_NAME.
Definition: ewmh.c:216
ewmh_update_desktop_properties
void ewmh_update_desktop_properties(void)
Updates all the EWMH desktop properties.
Definition: ewmh.c:118
ewmh_update_wm_desktop
void ewmh_update_wm_desktop(void)
Updates _NET_WM_DESKTOP for all windows.
Definition: ewmh.c:184
ewmh_update_sticky
void ewmh_update_sticky(xcb_window_t window, bool sticky)
Set or remove _NET_WM_STATE_STICKY on the window.
Definition: ewmh.c:279
resize_find_tiling_participants
bool resize_find_tiling_participants(Con **current, Con **other, direction_t direction, bool both_sides)
Definition: resize.c:70
percent_for_1px
double percent_for_1px(Con *con)
Calculate the minimum percent needed for the given container to be at least 1 pixel.
Definition: resize.c:129
resize_neighboring_cons
bool resize_neighboring_cons(Con *first, Con *second, int px, int ppt)
Resize the two given containers using the given amount of pixels or percentage points.
Definition: resize.c:144
current_match
static Match current_match
Definition: commands_parser.c:145
workspace_back_and_forth_get
Con * workspace_back_and_forth_get(void)
Returns the previously focused workspace con, or NULL if unavailable.
Definition: workspace.c:822
get_existing_workspace_by_name
Con * get_existing_workspace_by_name(const char *name)
Returns the workspace with the given name or NULL if such a workspace does not exist.
Definition: workspace.c:30
workspace_next_on_output
Con * workspace_next_on_output(void)
Returns the next workspace on the same output.
Definition: workspace.c:697
workspace_show
void workspace_show(Con *workspace)
Switches to the given workspace.
Definition: workspace.c:428
workspace_is_visible
bool workspace_is_visible(Con *ws)
Returns true if the workspace is currently visible.
Definition: workspace.c:314
workspace_prev_on_output
Con * workspace_prev_on_output(void)
Returns the previous workspace on the same output.
Definition: workspace.c:752
workspace_get
Con * workspace_get(const char *num)
Returns a pointer to the workspace with the given number (starting at 0), creating the workspace if n...
Definition: workspace.c:131
workspace_back_and_forth
void workspace_back_and_forth(void)
Focuses the previously focused workspace.
Definition: workspace.c:809
workspace_move_to_output
void workspace_move_to_output(Con *ws, Output *output)
Move the given workspace to the specified output.
Definition: workspace.c:974
workspace_next
Con * workspace_next(void)
Returns the next workspace.
Definition: workspace.c:568
get_existing_workspace_by_num
Con * get_existing_workspace_by_num(int num)
Returns the workspace with the given number or NULL if such a workspace does not exist.
Definition: workspace.c:44
workspace_prev
Con * workspace_prev(void)
Returns the previous workspace.
Definition: workspace.c:631
workspace_show_by_name
void workspace_show_by_name(const char *num)
Looks up the workspace by name and switches to it.
Definition: workspace.c:560
previous_workspace_name
char * previous_workspace_name
Stores a copy of the name of the last used workspace for the workspace back-and-forth switching.
Definition: workspace.c:19
get_assigned_output
Con * get_assigned_output(const char *name, long parsed_num)
Returns the first output that is assigned to a workspace specified by the given name or number.
Definition: workspace.c:84
update_shmlog_atom
void update_shmlog_atom(void)
Set up the SHMLOG_PATH atom.
Definition: x.c:1442
x_set_i3_atoms
void x_set_i3_atoms(void)
Sets up i3 specific atoms (I3_SOCKET_PATH and I3_CONFIG_PATH)
Definition: x.c:1456
tree_move
void tree_move(Con *con, direction_t direction)
Moves the given container in the given direction.
Definition: move.c:258
focused
struct Con * focused
Definition: tree.c:13
croot
struct Con * croot
Definition: tree.c:12
tree_next
void tree_next(Con *con, direction_t direction)
Changes focus in the given direction.
Definition: tree.c:591
level_up
bool level_up(void)
Moves focus one level up.
Definition: tree.c:386
level_down
bool level_down(void)
Moves focus one level down.
Definition: tree.c:409
tree_open_con
Con * tree_open_con(Con *con, i3Window *window)
Opens an empty container in the current container.
Definition: tree.c:149
all_cons
struct all_cons_head all_cons
Definition: tree.c:15
tree_split
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:327
get_tree_next_sibling
Con * get_tree_next_sibling(Con *con, position_t direction)
Get the previous / next sibling.
Definition: tree.c:633
render_con
void render_con(Con *con)
"Renders" the given container (and its children), meaning that all rects are updated correctly.
Definition: render.c:42
orientation_from_direction
orientation_t orientation_from_direction(direction_t direction)
Convert a direction to its corresponding orientation.
Definition: util.c:456
ws_name_to_number
int ws_name_to_number(const char *name)
Parses the workspace name as a number.
Definition: util.c:109
kill_nagbar
void kill_nagbar(pid_t nagbar_pid, bool wait_for_it)
Kills the i3-nagbar process, if nagbar_pid != -1.
Definition: util.c:387
i3_restart
void i3_restart(bool forget_layout)
Restart i3 in-place appends -a to argument list to disable autostart.
Definition: util.c:278
parse_long
bool parse_long(const char *str, long *out, int base)
Converts a string into a long using strtol().
Definition: util.c:409
rect_equals
bool rect_equals(Rect a, Rect b)
Definition: util.c:59
slurp
ssize_t slurp(const char *path, char **buf)
Slurp reads path in its entirety into buf, returning the length of the file or -1 if the file could n...
Definition: util.c:427
layout_from_name
bool layout_from_name(const char *layout_str, layout_t *out)
Set 'out' to the layout_t value for the given layout.
Definition: util.c:82
direction_from_orientation_position
direction_t direction_from_orientation_position(orientation_t orientation, position_t position)
Convert orientation and position to the corresponding direction.
Definition: util.c:472
floating_check_size
void floating_check_size(Con *floating_con, bool prefer_height)
Called when a floating window is created or resized.
Definition: floating.c:75
floating_disable
void floating_disable(Con *con)
Disables floating mode for the given container by re-attaching the container to its old parent.
Definition: floating.c:418
floating_center
void floating_center(Con *con, Rect rect)
Centers a floating con above the specified rect.
Definition: floating.c:527
toggle_floating_mode
void toggle_floating_mode(Con *con, bool automatic)
Calls floating_enable() for tiling containers and floating_disable() for floating containers.
Definition: floating.c:455
floating_resize
void floating_resize(Con *floating_con, uint32_t x, uint32_t y)
Sets size of the CT_FLOATING_CON to specified dimensions.
Definition: floating.c:769
floating_maybe_reassign_ws
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 not...
Definition: floating.c:488
floating_move_to_pointer
void floating_move_to_pointer(Con *con)
Moves the given floating con to the current pointer position.
Definition: floating.c:536
floating_enable
bool 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:232
floating_reposition
bool 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:742
con_move_to_workspace
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:1466
con_move_to_mark
bool con_move_to_mark(Con *con, const char *mark)
Moves the given container to the given mark.
Definition: con.c:1436
con_get_fullscreen_con
Con * con_get_fullscreen_con(Con *con, fullscreen_mode_t fullscreen_mode)
Returns the first fullscreen node below this node.
Definition: con.c:525
con_is_floating
bool con_is_floating(Con *con)
Returns true if the node is floating.
Definition: con.c:596
con_close
void con_close(Con *con, kill_window_t kill_window)
Closes the given container.
Definition: con.c:331
con_orientation
orientation_t con_orientation(Con *con)
Returns the orientation of the given container (for stacked containers, vertical orientation is used ...
Definition: con.c:1517
con_unmark
void con_unmark(Con *con, const char *name)
Removes marks from containers.
Definition: con.c:836
con_get_workspace
Con * con_get_workspace(Con *con)
Gets the workspace container this node is on.
Definition: con.c:477
con_disable_fullscreen
void con_disable_fullscreen(Con *con)
Disables fullscreen mode for the given container, if necessary.
Definition: con.c:1195
con_is_docked
bool con_is_docked(Con *con)
Returns true if the container is a docked container.
Definition: con.c:605
con_set_border_style
void con_set_border_style(Con *con, border_style_t border_style, int border_width)
Sets the given border style on con, correctly keeping the position/size of a floating window.
Definition: con.c:1845
con_by_con_id
Con * con_by_con_id(long target)
Returns the container with the given container ID or NULL if no such container exists.
Definition: con.c:686
con_mark
void con_mark(Con *con, const char *mark, mark_mode_t mode)
Assigns a mark to the container.
Definition: con.c:806
con_by_window_id
Con * con_by_window_id(xcb_window_t window)
Returns the container with the given client window ID or NULL if no such container exists.
Definition: con.c:671
con_activate_unblock
void con_activate_unblock(Con *con)
Activates the container like in con_activate but removes fullscreen restrictions and properly warps t...
Definition: con.c:297
con_by_mark
Con * con_by_mark(const char *mark)
Returns the container with the given mark or NULL if no such container exists.
Definition: con.c:726
con_mark_toggle
void con_mark_toggle(Con *con, const char *mark, mark_mode_t mode)
Toggles the mark on a container.
Definition: con.c:791
con_inside_floating
Con * con_inside_floating(Con *con)
Checks if the given container is either floating or inside some floating container.
Definition: con.c:620
con_fullscreen_permits_focusing
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:2184
con_swap
bool con_swap(Con *first, Con *second)
Swaps the two containers.
Definition: con.c:2425
con_accepts_window
bool con_accepts_window(Con *con)
Returns true if this node accepts a window (if the node swallows windows, it might already have swall...
Definition: con.c:444
con_rect_size_in_orientation
uint32_t con_rect_size_in_orientation(Con *con)
Returns given container's rect size depending on its orientation.
Definition: con.c:2545
con_is_internal
bool con_is_internal(Con *con)
Returns true if the container is internal, such as __i3_scratch.
Definition: con.c:588
con_exists
bool con_exists(Con *con)
Returns true if the given container (still) exists.
Definition: con.c:702
con_detach
void con_detach(Con *con)
Detaches the given container from its current parent.
Definition: con.c:230
con_move_to_output
void con_move_to_output(Con *con, Output *output, bool fix_coordinates)
Moves the given container to the currently focused container on the visible workspace on the given ou...
Definition: con.c:1484
con_toggle_fullscreen
void con_toggle_fullscreen(Con *con, int fullscreen_mode)
Toggles fullscreen mode for the given container.
Definition: con.c:1095
con_attach
void con_attach(Con *con, Con *parent, bool ignore_focus)
Attaches the given container to the given parent.
Definition: con.c:222
con_parse_title_format
i3String * con_parse_title_format(Con *con)
Returns the window title considering the current title format.
Definition: con.c:2376
con_num_children
int con_num_children(Con *con)
Returns the number of children of this container.
Definition: con.c:983
con_set_layout
void con_set_layout(Con *con, layout_t layout)
This function changes the layout of a given container.
Definition: con.c:1883
con_activate
void con_activate(Con *con)
Sets input focus to the given container and raises it to the top.
Definition: con.c:287
con_toggle_layout
void con_toggle_layout(Con *con, const char *toggle_mode)
This function toggles the layout of a given container.
Definition: con.c:1968
con_enable_fullscreen
void con_enable_fullscreen(Con *con, fullscreen_mode_t fullscreen_mode)
Enables fullscreen mode for the given container, if necessary.
Definition: con.c:1149
con_focus
void con_focus(Con *con)
Sets input focus to the given container.
Definition: con.c:246
con_get_output
Con * con_get_output(Con *con)
Gets the output container (first container with CT_OUTPUT in hierarchy) this node is on.
Definition: con.c:463
con_descend_focused
Con * con_descend_focused(Con *con)
Returns the focused con inside this client, descending the tree as far as possible.
Definition: con.c:1590
ipc_shutdown
void ipc_shutdown(shutdown_reason_t reason, int exempt_fd)
Calls shutdown() on each socket and closes it.
Definition: ipc.c:192
ipc_send_workspace_event
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:1617
ipc_send_barconfig_update_event
void ipc_send_barconfig_update_event(Barconfig *barconfig)
For the barconfig update events, we send the serialized barconfig.
Definition: ipc.c:1662
config
Config config
Definition: config.c:19
load_configuration
bool load_configuration(const char *override_configpath, config_load_t load_type)
(Re-)loads the configuration file (sets useful defaults before).
Definition: config.c:166
barconfigs
struct barconfig_head barconfigs
Definition: config.c:21
start_application
void start_application(const char *command, bool no_startup_id)
Starts the given application by passing it through a shell.
Definition: startup.c:133
startup_sequence_rename_workspace
void startup_sequence_rename_workspace(const char *old_name, const char *new_name)
Renames workspaces that are mentioned in the startup sequences.
Definition: startup.c:259
match_is_empty
bool match_is_empty(Match *match)
Check if a match is empty.
Definition: match.c:39
match_init
void match_init(Match *match)
Initializes the Match data structure.
Definition: match.c:26
match_free
void match_free(Match *match)
Frees the given match.
Definition: match.c:275
match_matches_window
bool match_matches_window(Match *match, i3Window *window)
Check if a match data structure matches the given window.
Definition: match.c:89
match_parse_property
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:291
ysuccess
#define ysuccess(success)
Definition: commands.c:20
cmd_resize_floating
static void cmd_resize_floating(I3_CMD, const char *direction_str, Con *floating_con, int px)
Definition: commands.c:424
gaps_bottom
static int * gaps_bottom(gaps_t *gaps)
Definition: commands.c:2395
CMD_FOCUS_WARN_CHILDREN
#define CMD_FOCUS_WARN_CHILDREN
Definition: commands.c:1305
gaps_left
static int * gaps_left(gaps_t *gaps)
Definition: commands.c:2391
cmd_move_con_to_mark
void cmd_move_con_to_mark(I3_CMD, const char *mark)
Implementation of 'move [window|container] [to] mark <str>'.
Definition: commands.c:1158
gaps_update
static bool gaps_update(gap_accessor get, const char *scope, const char *mode, int pixels)
Definition: commands.c:2405
y
#define y(x,...)
Definition: commands.c:18
cmd_move_con_to_workspace_number
void cmd_move_con_to_workspace_number(I3_CMD, const char *which, const char *no_auto_back_and_forth)
Implementation of 'move [–no-auto-back-and-forth] [window|container] [to] workspace number <number>'.
Definition: commands.c:377
cmd_append_layout
void cmd_append_layout(I3_CMD, const char *cpath)
Implementation of 'append_layout <path>'.
Definition: commands.c:775
cmd_focus_sibling
void cmd_focus_sibling(I3_CMD, const char *direction_str)
Implementation of 'focus next|prev sibling'.
Definition: commands.c:1362
cmd_resize_tiling_direction
static bool cmd_resize_tiling_direction(I3_CMD, Con *current, const char *direction, int px, int ppt)
Definition: commands.c:483
cmd_mode
void cmd_mode(I3_CMD, const char *mode)
Implementation of 'mode <string>'.
Definition: commands.c:1020
cmd_nop
void cmd_nop(I3_CMD, const char *comment)
Implementation of 'nop <comment>'.
Definition: commands.c:764
cmd_rename_workspace
void cmd_rename_workspace(I3_CMD, const char *old_name, const char *new_name)
Implementation of 'rename workspace <name> to <name>'.
Definition: commands.c:2126
cmd_focus
void cmd_focus(I3_CMD)
Implementation of 'focus'.
Definition: commands.c:1462
cmd_sticky
void cmd_sticky(I3_CMD, const char *action)
Implementation of 'sticky enable|disable|toggle'.
Definition: commands.c:1536
cmd_bar_hidden_state
void cmd_bar_hidden_state(I3_CMD, const char *bar_hidden_state, const char *bar_id)
Implementation of 'bar hidden_state hide|show|toggle [<bar_id>]'.
Definition: commands.c:2278
border_width_from_style
static int border_width_from_style(border_style_t border_style, long border_width, Con *con)
Definition: commands.c:703
cmd_bar_mode
void cmd_bar_mode(I3_CMD, const char *bar_mode, const char *bar_id)
Implementation of 'bar mode dock|hide|invisible|toggle [<bar_id>]'.
Definition: commands.c:2219
cmd_floating
void cmd_floating(I3_CMD, const char *floating_mode)
Implementation of 'floating enable|disable|toggle'.
Definition: commands.c:1178
gaps_right
static int * gaps_right(gaps_t *gaps)
Definition: commands.c:2399
cmd_criteria_match_windows
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:170
parse_direction
static direction_t parse_direction(const char *str)
Definition: commands.c:409
maybe_back_and_forth
static bool maybe_back_and_forth(struct CommandResultIR *cmd_output, const char *name)
Definition: commands.c:83
maybe_auto_back_and_forth_workspace
static Con * maybe_auto_back_and_forth_workspace(Con *workspace)
Definition: commands.c:102
cmd_focus_window_mode
void cmd_focus_window_mode(I3_CMD, const char *window_mode)
Implementation of 'focus tiling|floating|mode_toggle'.
Definition: commands.c:1397
cmd_mark
void cmd_mark(I3_CMD, const char *mark, const char *mode, const char *toggle)
Implementation of 'mark [–add|–replace] [–toggle] <mark>'.
Definition: commands.c:968
cmd_resize
void cmd_resize(I3_CMD, const char *way, const char *direction, long resize_px, long resize_ppt)
Implementation of 'resize grow|shrink <direction> [<px> px] [or <ppt> ppt]'.
Definition: commands.c:575
cmd_move_con_to_output
void cmd_move_con_to_output(I3_CMD, const char *name, bool move_workspace)
Implementation of 'move [window|container] [to] output <str>'.
Definition: commands.c:1107
cmd_exec
void cmd_exec(I3_CMD, const char *nosn, const char *command)
Implementation of 'exec [–no-startup-id] <command>'.
Definition: commands.c:1280
cmd_move_window_to_position
void cmd_move_window_to_position(I3_CMD, long x, const char *mode_x, long y, const char *mode_y)
Implementation of 'move [window|container] [to] [absolute] position [<pos_x> [px|ppt] <pos_y> [px|ppt...
Definition: commands.c:1826
cmd_focus_direction
void cmd_focus_direction(I3_CMD, const char *direction_str)
Implementation of 'focus left|right|up|down'.
Definition: commands.c:1324
cmd_move_con_to_workspace_back_and_forth
void cmd_move_con_to_workspace_back_and_forth(I3_CMD)
Implementation of 'move [window|container] [to] workspace back_and_forth'.
Definition: commands.c:330
cmd_restart
void cmd_restart(I3_CMD)
Implementation of 'restart'.
Definition: commands.c:1725
cmd_move_con_to_workspace_name
void cmd_move_con_to_workspace_name(I3_CMD, const char *name, const char *no_auto_back_and_forth)
Implementation of 'move [–no-auto-back-and-forth] [window|container] [to] workspace <name>'.
Definition: commands.c:350
cmd_move_window_to_mouse
void cmd_move_window_to_mouse(I3_CMD)
Implementation of 'move [window|container] [to] position mouse'.
Definition: commands.c:1909
cmd_resize_set
void cmd_resize_set(I3_CMD, long cwidth, const char *mode_width, long cheight, const char *mode_height)
Implementation of 'resize set <width> [px | ppt] <height> [px | ppt]'.
Definition: commands.c:654
CHECK_MOVE_CON_TO_WORKSPACE
#define CHECK_MOVE_CON_TO_WORKSPACE
Definition: commands.c:265
cmd_focus_level
void cmd_focus_level(I3_CMD, const char *level)
Implementation of 'focus parent|child'.
Definition: commands.c:1434
cmd_swap
void cmd_swap(I3_CMD, const char *mode, const char *arg)
Implementation of 'swap [container] [with] id|con_id|mark <arg>'.
Definition: commands.c:1976
cmd_criteria_add
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:253
HANDLE_EMPTY_MATCH
#define HANDLE_EMPTY_MATCH
When the command did not include match criteria (!), we use the currently focused container.
Definition: commands.c:59
cmd_layout
void cmd_layout(I3_CMD, const char *layout_str)
Implementation of 'layout default|stacked|stacking|tabbed|splitv|splith'.
Definition: commands.c:1626
cmd_title_window_icon
void cmd_title_window_icon(I3_CMD, const char *enable, int padding)
Implementation of 'title_window_icon <yes|no|toggle>' and 'title_window_icon <padding|toggle> <px>'.
Definition: commands.c:2077
cmd_workspace
void cmd_workspace(I3_CMD, const char *which)
Implementation of 'workspace next|prev|next_on_output|prev_on_output'.
Definition: commands.c:851
cmd_gaps
void cmd_gaps(I3_CMD, const char *type, const char *scope, const char *mode, const char *value)
Implementation of 'gaps inner|outer|top|right|bottom|left|horizontal|vertical current|all set|plus|mi...
Definition: commands.c:2489
cmd_unmark
void cmd_unmark(I3_CMD, const char *mark)
Implementation of 'unmark [mark]'.
Definition: commands.c:1001
cmd_fullscreen
void cmd_fullscreen(I3_CMD, const char *action, const char *fullscreen_mode)
Implementation of 'fullscreen [enable|disable|toggle] [global]'.
Definition: commands.c:1509
cmd_move_con_to_workspace
void cmd_move_con_to_workspace(I3_CMD, const char *which)
Implementation of 'move [window|container] [to] workspace next|prev|next_on_output|prev_on_output'.
Definition: commands.c:297
ystr
#define ystr(str)
Definition: commands.c:19
cmd_open
void cmd_open(I3_CMD)
Implementation of 'open'.
Definition: commands.c:1757
cmd_shmlog
void cmd_shmlog(I3_CMD, const char *argument)
Implementation of 'shmlog <size>|toggle|on|off'.
Definition: commands.c:2335
cmd_debuglog
void cmd_debuglog(I3_CMD, const char *argument)
Implementation of 'debuglog toggle|on|off'.
Definition: commands.c:2367
yerror
#define yerror(format,...)
Definition: commands.c:29
cmd_kill
void cmd_kill(I3_CMD, const char *kill_mode_str)
Implementation of 'kill [window|client]'.
Definition: commands.c:1248
cmd_workspace_number
void cmd_workspace_number(I3_CMD, const char *which, const char *_no_auto_back_and_forth)
Implementation of 'workspace [–no-auto-back-and-forth] number <number>'.
Definition: commands.c:885
resize_set_tiling
static bool resize_set_tiling(I3_CMD, Con *target, orientation_t resize_orientation, bool is_ppt, long target_size)
Definition: commands.c:621
cmd_move_direction
void cmd_move_direction(I3_CMD, const char *direction_str, long amount, const char *mode)
Implementation of 'move <direction> [<amount> [px|ppt]]'.
Definition: commands.c:1574
cmd_move_window_to_center
void cmd_move_window_to_center(I3_CMD, const char *method)
Implementation of 'move [window|container] [to] [absolute] position center.
Definition: commands.c:1865
cmd_title_format
void cmd_title_format(I3_CMD, const char *format)
Implementation of 'title_format <format>'.
Definition: commands.c:2034
cmd_layout_toggle
void cmd_layout_toggle(I3_CMD, const char *toggle_mode)
Implementation of 'layout toggle [all|split]'.
Definition: commands.c:1657
cmd_focus_output
void cmd_focus_output(I3_CMD, const char *name)
Implementation of 'focus output <output>'.
Definition: commands.c:1777
gaps_inner
static int * gaps_inner(gaps_t *gaps)
Definition: commands.c:2383
cmd_border
void cmd_border(I3_CMD, const char *border_style_str, long border_width)
Implementation of 'border normal|pixel [<n>]', 'border none|1pixel|toggle'.
Definition: commands.c:727
user_output_names_find_next
static Output * user_output_names_find_next(user_output_names_head *names, Output *current_output)
Definition: commands.c:1058
cmd_workspace_name
void cmd_workspace_name(I3_CMD, const char *name, const char *_no_auto_back_and_forth)
Implementation of 'workspace [–no-auto-back-and-forth] <name>'.
Definition: commands.c:939
gaps_top
static int * gaps_top(gaps_t *gaps)
Definition: commands.c:2387
cmd_scratchpad_show
void cmd_scratchpad_show(I3_CMD)
Implementation of 'scratchpad show'.
Definition: commands.c:1953
move_matches_to_workspace
static void move_matches_to_workspace(Con *ws)
Definition: commands.c:257
cmd_split
void cmd_split(I3_CMD, const char *direction)
Implementation of 'split v|h|t|vertical|horizontal|toggle'.
Definition: commands.c:1209
cmd_resize_tiling_width_height
static bool cmd_resize_tiling_width_height(I3_CMD, Con *current, const char *direction, int px, double ppt)
Definition: commands.c:502
cmd_workspace_back_and_forth
void cmd_workspace_back_and_forth(I3_CMD)
Implementation of 'workspace back_and_forth'.
Definition: commands.c:922
user_output_names_free
static void user_output_names_free(user_output_names_head *names)
Definition: commands.c:1093
cmd_reload
void cmd_reload(I3_CMD)
Implementation of 'reload'.
Definition: commands.c:1695
gap_accessor
int *(* gap_accessor)(gaps_t *)
Definition: commands.c:2403
cmd_exit
void cmd_exit(I3_CMD)
Implementation of 'exit'.
Definition: commands.c:1684
cmd_move_scratchpad
void cmd_move_scratchpad(I3_CMD)
Implementation of 'move scratchpad'.
Definition: commands.c:1933
regex_matches
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:61
restore_open_placeholder_windows
void restore_open_placeholder_windows(Con *parent)
Open placeholder windows for all children of parent.
Definition: restore_layout.c:250
config_error_nagbar_pid
pid_t config_error_nagbar_pid
Definition: config_parser.c:45
scratchpad_show
bool 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:85
scratchpad_move
void scratchpad_move(Con *con)
Moves the specified window to the __i3_scratch workspace, making it floating and setting the appropri...
Definition: scratchpad.c:19
C_RELOAD
@ C_RELOAD
Definition: configuration.h:432
i3String
struct _i3String i3String
Opaque data structure for storing strings.
Definition: libi3.h:49
logical_px
int logical_px(const int logical)
Convert a logical amount of pixels (e.g.
resolve_tilde
char * resolve_tilde(const char *path)
This function resolves ~ in pathnames.
DLOG
#define DLOG(fmt,...)
Definition: libi3.h:105
LOG
#define LOG(fmt,...)
Definition: libi3.h:95
sstrdup
char * sstrdup(const char *str)
Safe-wrapper around strdup which exits if malloc returns NULL (meaning that there is no more memory a...
ELOG
#define ELOG(fmt,...)
Definition: libi3.h:100
i3string_as_utf8
const char * i3string_as_utf8(i3String *str)
Returns the UTF-8 encoded version of the i3String.
scalloc
void * scalloc(size_t num, size_t size)
Safe-wrapper around calloc which exits if malloc returns NULL (meaning that there is no more memory a...
sasprintf
int sasprintf(char **strp, const char *fmt,...)
Safe-wrapper around asprintf which exits if it returns -1 (meaning that there is no more memory avail...
boolstr
bool boolstr(const char *str)
Reports whether str represents the enabled state (1, yes, true, …).
I3STRING_FREE
#define I3STRING_FREE(str)
Securely i3string_free by setting the pointer to NULL to prevent accidentally using freed memory.
Definition: libi3.h:243
smalloc
void * smalloc(size_t size)
Safe-wrapper around malloc which exits if malloc returns NULL (meaning that there is no more memory a...
TAILQ_FOREACH
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:347
TAILQ_END
#define TAILQ_END(head)
Definition: queue.h:337
TAILQ_INIT
#define TAILQ_INIT(head)
Definition: queue.h:360
TAILQ_HEAD
#define TAILQ_HEAD(name, type)
Definition: queue.h:318
TAILQ_INSERT_TAIL
#define TAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:376
TAILQ_FIRST
#define TAILQ_FIRST(head)
Definition: queue.h:336
TAILQ_REMOVE
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:402
TAILQ_NEXT
#define TAILQ_NEXT(elm, field)
Definition: queue.h:338
TAILQ_HEAD_INITIALIZER
#define TAILQ_HEAD_INITIALIZER(head)
Definition: queue.h:324
TAILQ_EMPTY
#define TAILQ_EMPTY(head)
Definition: queue.h:344
TAILQ_LAST
#define TAILQ_LAST(head, headname)
Definition: queue.h:339
TAILQ_ENTRY
#define TAILQ_ENTRY(type)
Definition: queue.h:327
cmd_criteria_init
void cmd_criteria_init(I3_CMD)
Initializes the specified 'Match' data structure and the initial state of commands....
I3_CMD
#define I3_CMD
The beginning of the prototype for every cmd_ function.
Definition: commands.h:17
position_t
position_t
Definition: data.h:63
AFTER
@ AFTER
Definition: data.h:64
BEFORE
@ BEFORE
Definition: data.h:63
layout_t
layout_t
Container layouts.
Definition: data.h:105
L_SPLITH
@ L_SPLITH
Definition: data.h:112
mark_mode_t
mark_mode_t
Definition: data.h:99
MM_ADD
@ MM_ADD
Definition: data.h:100
MM_REPLACE
@ MM_REPLACE
Definition: data.h:99
orientation_t
orientation_t
Definition: data.h:60
VERT
@ VERT
Definition: data.h:62
HORIZ
@ HORIZ
Definition: data.h:61
fullscreen_mode_t
fullscreen_mode_t
Fullscreen modes.
Definition: data.h:633
CF_OUTPUT
@ CF_OUTPUT
Definition: data.h:634
CF_GLOBAL
@ CF_GLOBAL
Definition: data.h:635
border_style_t
border_style_t
Definition: data.h:65
BS_NONE
@ BS_NONE
Definition: data.h:66
BS_PIXEL
@ BS_PIXEL
Definition: data.h:67
BS_NORMAL
@ BS_NORMAL
Definition: data.h:68
KILL_CLIENT
@ KILL_CLIENT
Definition: data.h:75
KILL_WINDOW
@ KILL_WINDOW
Definition: data.h:74
direction_t
direction_t
Definition: data.h:56
D_RIGHT
@ D_RIGHT
Definition: data.h:57
D_LEFT
@ D_LEFT
Definition: data.h:56
D_UP
@ D_UP
Definition: data.h:58
D_DOWN
@ D_DOWN
Definition: data.h:59
SHUTDOWN_REASON_RESTART
@ SHUTDOWN_REASON_RESTART
Definition: ipc.h:94
GREP_FIRST
#define GREP_FIRST(dest, head, condition)
Definition: util.h:38
FREE
#define FREE(pointer)
Definition: util.h:47
STARTS_WITH
#define STARTS_WITH(string, needle)
Definition: util.h:25
json_content_t
json_content_t
Definition: load_layout.h:15
JSON_CONTENT_UNKNOWN
@ JSON_CONTENT_UNKNOWN
Definition: load_layout.h:18
JSON_CONTENT_WORKSPACE
@ JSON_CONTENT_WORKSPACE
Definition: load_layout.h:27
owindow::con
Con * con
Definition: commands.c:131
CommandResultIR
Holds an intermediate representation of the result of a call to any command.
Definition: commands_parser.h:21
Config::gaps
gaps_t gaps
Definition: configuration.h:273
Config::workspace_auto_back_and_forth
bool workspace_auto_back_and_forth
Automatic workspace back and forth switching.
Definition: configuration.h:189
Config::default_border_width
int default_border_width
Definition: configuration.h:116
Config::default_floating_border_width
int default_floating_border_width
Definition: configuration.h:117
Config::ipc_socket_path
char * ipc_socket_path
Definition: configuration.h:110
Config::default_border
border_style_t default_border
The default border style for new windows.
Definition: configuration.h:222
Config::default_floating_border
border_style_t default_floating_border
The default border style for new floating windows.
Definition: configuration.h:225
Barconfig
Holds the status bar configuration (i3bar).
Definition: configuration.h:287
Barconfig::hidden_state
enum Barconfig::@8 hidden_state
Barconfig::id
char * id
Automatically generated ID for this bar config.
Definition: configuration.h:290
Barconfig::mode
enum Barconfig::@7 mode
Bar display mode (hide unless modifier is pressed or show in dock mode or always hide in invisible mo...
gaps_t
Definition: data.h:150
gaps_t::inner
int inner
Definition: data.h:151
gaps_t::left
int left
Definition: data.h:155
gaps_t::right
int right
Definition: data.h:153
gaps_t::top
int top
Definition: data.h:152
gaps_t::bottom
int bottom
Definition: data.h:154
Rect
Stores a rectangle, for example the size of a window, the child window etc.
Definition: data.h:189
Rect::height
uint32_t height
Definition: data.h:193
Rect::x
uint32_t x
Definition: data.h:190
Rect::y
uint32_t y
Definition: data.h:191
Rect::width
uint32_t width
Definition: data.h:192
xoutput
An Output is a physical output on your graphics driver.
Definition: data.h:395
xoutput::con
Con * con
Pointer to the Con which represents this output.
Definition: data.h:415
xoutput::primary
bool primary
Definition: data.h:407
Window
A 'Window' is a type which contains an xcb_window_t and all the related information (hints like _NET_...
Definition: data.h:428
Window::height_increment
int height_increment
Definition: data.h:495
Window::name_x_changed
bool name_x_changed
Flag to force re-rendering the decoration upon changes.
Definition: data.h:456
Window::id
xcb_window_t id
Definition: data.h:429
Window::dock
enum Window::@11 dock
Whether the window says it is a dock window.
Window::width_increment
int width_increment
Definition: data.h:494
Match::mark
struct regex * mark
Definition: data.h:541
Match::con_id
Con * con_id
Definition: data.h:566
mark_t
Definition: data.h:637
mark_t::name
char * name
Definition: data.h:638
Con
A 'Con' represents everything from the X11 root window down to a single X11 window.
Definition: data.h:647
Con::parent
struct Con * parent
Definition: data.h:682
Con::scratchpad_state
enum Con::@20 scratchpad_state
Con::type
enum Con::@18 type
Con::percent
double percent
Definition: data.h:716
Con::rect
struct Rect rect
Definition: data.h:686
Con::gaps
gaps_t gaps
Only applicable for containers of type CT_WORKSPACE.
Definition: data.h:680
Con::sticky
bool sticky
Definition: data.h:743
Con::max_user_border_style
border_style_t max_user_border_style
Definition: data.h:768
Con::layout
layout_t layout
Definition: data.h:759
Con::num
int num
the workspace number, if this Con is of type CT_WORKSPACE and the workspace is not a named workspace ...
Definition: data.h:677
Con::window_icon_padding
int window_icon_padding
Whether the window icon should be displayed, and with what padding.
Definition: data.h:704
Con::window
struct Window * window
Definition: data.h:722
Con::title_format
char * title_format
The format with which the window's name should be displayed.
Definition: data.h:699
Con::border_style
border_style_t border_style
Definition: data.h:761
Con::name
char * name
Definition: data.h:696
Con::deco_render_params
struct deco_render_params * deco_render_params
Cache for the decoration rendering.
Definition: data.h:728
Generated by doxygen 1.9.6