i3
ipc.c
Go to the documentation of this file.
1 #undef I3__FILE__
2 #define I3__FILE__ "ipc.c"
3 /*
4  * vim:ts=4:sw=4:expandtab
5  *
6  * i3 - an improved dynamic tiling window manager
7  * © 2009-2012 Michael Stapelberg and contributors (see also: LICENSE)
8  *
9  * ipc.c: UNIX domain socket IPC (initialization, client handling, protocol).
10  *
11  */
12 #include "all.h"
13 #include "yajl_utils.h"
14 
15 #include <sys/socket.h>
16 #include <sys/un.h>
17 #include <fcntl.h>
18 #include <libgen.h>
19 #include <ev.h>
20 #include <yajl/yajl_gen.h>
21 #include <yajl/yajl_parse.h>
22 
23 char *current_socketpath = NULL;
24 
25 TAILQ_HEAD(ipc_client_head, ipc_client) all_clients = TAILQ_HEAD_INITIALIZER(all_clients);
26 
27 /*
28  * Puts the given socket file descriptor into non-blocking mode or dies if
29  * setting O_NONBLOCK failed. Non-blocking sockets are a good idea for our
30  * IPC model because we should by no means block the window manager.
31  *
32  */
33 static void set_nonblock(int sockfd) {
34  int flags = fcntl(sockfd, F_GETFL, 0);
35  flags |= O_NONBLOCK;
36  if (fcntl(sockfd, F_SETFL, flags) < 0)
37  err(-1, "Could not set O_NONBLOCK");
38 }
39 
40 /*
41  * Sends the specified event to all IPC clients which are currently connected
42  * and subscribed to this kind of event.
43  *
44  */
45 void ipc_send_event(const char *event, uint32_t message_type, const char *payload) {
46  ipc_client *current;
47  TAILQ_FOREACH(current, &all_clients, clients) {
48  /* see if this client is interested in this event */
49  bool interested = false;
50  for (int i = 0; i < current->num_events; i++) {
51  if (strcasecmp(current->events[i], event) != 0)
52  continue;
53  interested = true;
54  break;
55  }
56  if (!interested)
57  continue;
58 
59  ipc_send_message(current->fd, strlen(payload), message_type, (const uint8_t *)payload);
60  }
61 }
62 
63 /*
64  * Calls shutdown() on each socket and closes it. This function to be called
65  * when exiting or restarting only!
66  *
67  */
68 void ipc_shutdown(void) {
69  ipc_client *current;
70  while (!TAILQ_EMPTY(&all_clients)) {
71  current = TAILQ_FIRST(&all_clients);
72  shutdown(current->fd, SHUT_RDWR);
73  close(current->fd);
74  TAILQ_REMOVE(&all_clients, current, clients);
75  free(current);
76  }
77 }
78 
79 /*
80  * Executes the command and returns whether it could be successfully parsed
81  * or not (at the moment, always returns true).
82  *
83  */
84 IPC_HANDLER(command) {
85  /* To get a properly terminated buffer, we copy
86  * message_size bytes out of the buffer */
87  char *command = scalloc(message_size + 1);
88  strncpy(command, (const char *)message, message_size);
89  LOG("IPC: received: *%s*\n", command);
90  yajl_gen gen = yajl_gen_alloc(NULL);
91 
92  CommandResult *result = parse_command((const char *)command, gen);
93  free(command);
94 
95  if (result->needs_tree_render)
96  tree_render();
97 
98  command_result_free(result);
99 
100  const unsigned char *reply;
101  ylength length;
102  yajl_gen_get_buf(gen, &reply, &length);
103 
104  ipc_send_message(fd, length, I3_IPC_REPLY_TYPE_COMMAND,
105  (const uint8_t *)reply);
106 
107  yajl_gen_free(gen);
108 }
109 
110 static void dump_rect(yajl_gen gen, const char *name, Rect r) {
111  ystr(name);
112  y(map_open);
113  ystr("x");
114  y(integer, r.x);
115  ystr("y");
116  y(integer, r.y);
117  ystr("width");
118  y(integer, r.width);
119  ystr("height");
120  y(integer, r.height);
121  y(map_close);
122 }
123 
124 static void dump_binding(yajl_gen gen, Binding *bind) {
125  y(map_open);
126  ystr("input_code");
127  y(integer, bind->keycode);
128 
129  ystr("input_type");
130  ystr((const char *)(bind->input_type == B_KEYBOARD ? "keyboard" : "mouse"));
131 
132  ystr("symbol");
133  if (bind->symbol == NULL)
134  y(null);
135  else
136  ystr(bind->symbol);
137 
138  ystr("command");
139  ystr(bind->command);
140 
141  ystr("mods");
142  y(array_open);
143  for (int i = 0; i < 8; i++) {
144  if (bind->mods & (1 << i)) {
145  switch (1 << i) {
146  case XCB_MOD_MASK_SHIFT:
147  ystr("shift");
148  break;
149  case XCB_MOD_MASK_LOCK:
150  ystr("lock");
151  break;
152  case XCB_MOD_MASK_CONTROL:
153  ystr("ctrl");
154  break;
155  case XCB_MOD_MASK_1:
156  ystr("Mod1");
157  break;
158  case XCB_MOD_MASK_2:
159  ystr("Mod2");
160  break;
161  case XCB_MOD_MASK_3:
162  ystr("Mod3");
163  break;
164  case XCB_MOD_MASK_4:
165  ystr("Mod4");
166  break;
167  case XCB_MOD_MASK_5:
168  ystr("Mod5");
169  break;
170  }
171  }
172  }
173  y(array_close);
174 
175  y(map_close);
176 }
177 
178 void dump_node(yajl_gen gen, struct Con *con, bool inplace_restart) {
179  y(map_open);
180  ystr("id");
181  y(integer, (long int)con);
182 
183  ystr("type");
184  switch (con->type) {
185  case CT_ROOT:
186  ystr("root");
187  break;
188  case CT_OUTPUT:
189  ystr("output");
190  break;
191  case CT_CON:
192  ystr("con");
193  break;
194  case CT_FLOATING_CON:
195  ystr("floating_con");
196  break;
197  case CT_WORKSPACE:
198  ystr("workspace");
199  break;
200  case CT_DOCKAREA:
201  ystr("dockarea");
202  break;
203  default:
204  DLOG("About to dump unknown container type=%d. This is a bug.\n", con->type);
205  assert(false);
206  break;
207  }
208 
209  /* provided for backwards compatibility only. */
210  ystr("orientation");
211  if (!con_is_split(con))
212  ystr("none");
213  else {
214  if (con_orientation(con) == HORIZ)
215  ystr("horizontal");
216  else
217  ystr("vertical");
218  }
219 
220  ystr("scratchpad_state");
221  switch (con->scratchpad_state) {
222  case SCRATCHPAD_NONE:
223  ystr("none");
224  break;
225  case SCRATCHPAD_FRESH:
226  ystr("fresh");
227  break;
228  case SCRATCHPAD_CHANGED:
229  ystr("changed");
230  break;
231  }
232 
233  ystr("percent");
234  if (con->percent == 0.0)
235  y(null);
236  else
237  y(double, con->percent);
238 
239  ystr("urgent");
240  y(bool, con->urgent);
241 
242  if (con->mark != NULL) {
243  ystr("mark");
244  ystr(con->mark);
245  }
246 
247  ystr("focused");
248  y(bool, (con == focused));
249 
250  ystr("layout");
251  switch (con->layout) {
252  case L_DEFAULT:
253  DLOG("About to dump layout=default, this is a bug in the code.\n");
254  assert(false);
255  break;
256  case L_SPLITV:
257  ystr("splitv");
258  break;
259  case L_SPLITH:
260  ystr("splith");
261  break;
262  case L_STACKED:
263  ystr("stacked");
264  break;
265  case L_TABBED:
266  ystr("tabbed");
267  break;
268  case L_DOCKAREA:
269  ystr("dockarea");
270  break;
271  case L_OUTPUT:
272  ystr("output");
273  break;
274  }
275 
276  ystr("workspace_layout");
277  switch (con->workspace_layout) {
278  case L_DEFAULT:
279  ystr("default");
280  break;
281  case L_STACKED:
282  ystr("stacked");
283  break;
284  case L_TABBED:
285  ystr("tabbed");
286  break;
287  default:
288  DLOG("About to dump workspace_layout=%d (none of default/stacked/tabbed), this is a bug.\n", con->workspace_layout);
289  assert(false);
290  break;
291  }
292 
293  ystr("last_split_layout");
294  switch (con->layout) {
295  case L_SPLITV:
296  ystr("splitv");
297  break;
298  default:
299  ystr("splith");
300  break;
301  }
302 
303  ystr("border");
304  switch (con->border_style) {
305  case BS_NORMAL:
306  ystr("normal");
307  break;
308  case BS_NONE:
309  ystr("none");
310  break;
311  case BS_PIXEL:
312  ystr("pixel");
313  break;
314  }
315 
316  ystr("current_border_width");
317  y(integer, con->current_border_width);
318 
319  dump_rect(gen, "rect", con->rect);
320  dump_rect(gen, "deco_rect", con->deco_rect);
321  dump_rect(gen, "window_rect", con->window_rect);
322  dump_rect(gen, "geometry", con->geometry);
323 
324  ystr("name");
325  if (con->window && con->window->name)
326  ystr(i3string_as_utf8(con->window->name));
327  else if (con->name != NULL)
328  ystr(con->name);
329  else
330  y(null);
331 
332  if (con->type == CT_WORKSPACE) {
333  ystr("num");
334  y(integer, con->num);
335  }
336 
337  ystr("window");
338  if (con->window)
339  y(integer, con->window->id);
340  else
341  y(null);
342 
343  if (con->window && !inplace_restart) {
344  /* Window properties are useless to preserve when restarting because
345  * they will be queried again anyway. However, for i3-save-tree(1),
346  * they are very useful and save i3-save-tree dealing with X11. */
347  ystr("window_properties");
348  y(map_open);
349 
350 #define DUMP_PROPERTY(key, prop_name) \
351  do { \
352  if (con->window->prop_name != NULL) { \
353  ystr(key); \
354  ystr(con->window->prop_name); \
355  } \
356  } while (0)
357 
358  DUMP_PROPERTY("class", class_class);
359  DUMP_PROPERTY("instance", class_instance);
360  DUMP_PROPERTY("window_role", role);
361 
362  if (con->window->name != NULL) {
363  ystr("title");
364  ystr(i3string_as_utf8(con->window->name));
365  }
366 
367  ystr("transient_for");
368  if (con->window->transient_for == XCB_NONE)
369  y(null);
370  else
371  y(integer, con->window->transient_for);
372 
373  y(map_close);
374  }
375 
376  ystr("nodes");
377  y(array_open);
378  Con *node;
379  if (con->type != CT_DOCKAREA || !inplace_restart) {
380  TAILQ_FOREACH(node, &(con->nodes_head), nodes) {
381  dump_node(gen, node, inplace_restart);
382  }
383  }
384  y(array_close);
385 
386  ystr("floating_nodes");
387  y(array_open);
388  TAILQ_FOREACH(node, &(con->floating_head), floating_windows) {
389  dump_node(gen, node, inplace_restart);
390  }
391  y(array_close);
392 
393  ystr("focus");
394  y(array_open);
395  TAILQ_FOREACH(node, &(con->focus_head), focused) {
396  y(integer, (long int)node);
397  }
398  y(array_close);
399 
400  ystr("fullscreen_mode");
401  y(integer, con->fullscreen_mode);
402 
403  ystr("floating");
404  switch (con->floating) {
405  case FLOATING_AUTO_OFF:
406  ystr("auto_off");
407  break;
408  case FLOATING_AUTO_ON:
409  ystr("auto_on");
410  break;
411  case FLOATING_USER_OFF:
412  ystr("user_off");
413  break;
414  case FLOATING_USER_ON:
415  ystr("user_on");
416  break;
417  }
418 
419  ystr("swallows");
420  y(array_open);
421  Match *match;
422  TAILQ_FOREACH(match, &(con->swallow_head), matches) {
423  /* We will generate a new restart_mode match specification after this
424  * loop, so skip this one. */
425  if (match->restart_mode)
426  continue;
427  y(map_open);
428  if (match->dock != -1) {
429  ystr("dock");
430  y(integer, match->dock);
431  ystr("insert_where");
432  y(integer, match->insert_where);
433  }
434 
435 #define DUMP_REGEX(re_name) \
436  do { \
437  if (match->re_name != NULL) { \
438  ystr(#re_name); \
439  ystr(match->re_name->pattern); \
440  } \
441  } while (0)
442 
443  DUMP_REGEX(class);
444  DUMP_REGEX(instance);
445  DUMP_REGEX(window_role);
446  DUMP_REGEX(title);
447 
448 #undef DUMP_REGEX
449  y(map_close);
450  }
451 
452  if (inplace_restart) {
453  if (con->window != NULL) {
454  y(map_open);
455  ystr("id");
456  y(integer, con->window->id);
457  ystr("restart_mode");
458  y(bool, true);
459  y(map_close);
460  }
461  }
462  y(array_close);
463 
464  if (inplace_restart && con->window != NULL) {
465  ystr("depth");
466  y(integer, con->depth);
467  }
468 
469  y(map_close);
470 }
471 
472 static void dump_bar_config(yajl_gen gen, Barconfig *config) {
473  y(map_open);
474 
475  ystr("id");
476  ystr(config->id);
477 
478  if (config->num_outputs > 0) {
479  ystr("outputs");
480  y(array_open);
481  for (int c = 0; c < config->num_outputs; c++)
482  ystr(config->outputs[c]);
483  y(array_close);
484  }
485 
486 #define YSTR_IF_SET(name) \
487  do { \
488  if (config->name) { \
489  ystr(#name); \
490  ystr(config->name); \
491  } \
492  } while (0)
493 
494  YSTR_IF_SET(tray_output);
495  YSTR_IF_SET(socket_path);
496 
497  ystr("mode");
498  switch (config->mode) {
499  case M_HIDE:
500  ystr("hide");
501  break;
502  case M_INVISIBLE:
503  ystr("invisible");
504  break;
505  case M_DOCK:
506  default:
507  ystr("dock");
508  break;
509  }
510 
511  ystr("hidden_state");
512  switch (config->hidden_state) {
513  case S_SHOW:
514  ystr("show");
515  break;
516  case S_HIDE:
517  default:
518  ystr("hide");
519  break;
520  }
521 
522  ystr("modifier");
523  switch (config->modifier) {
524  case M_CONTROL:
525  ystr("ctrl");
526  break;
527  case M_SHIFT:
528  ystr("shift");
529  break;
530  case M_MOD1:
531  ystr("Mod1");
532  break;
533  case M_MOD2:
534  ystr("Mod2");
535  break;
536  case M_MOD3:
537  ystr("Mod3");
538  break;
539  /*
540  case M_MOD4:
541  ystr("Mod4");
542  break;
543  */
544  case M_MOD5:
545  ystr("Mod5");
546  break;
547  default:
548  ystr("Mod4");
549  break;
550  }
551 
552  if (config->wheel_up_cmd) {
553  ystr("wheel_up_cmd");
554  ystr(config->wheel_up_cmd);
555  }
556 
557  if (config->wheel_down_cmd) {
558  ystr("wheel_down_cmd");
559  ystr(config->wheel_down_cmd);
560  }
561 
562  ystr("position");
563  if (config->position == P_BOTTOM)
564  ystr("bottom");
565  else
566  ystr("top");
567 
568  YSTR_IF_SET(status_command);
569  YSTR_IF_SET(font);
570 
571  if (config->separator_symbol) {
572  ystr("separator_symbol");
573  ystr(config->separator_symbol);
574  }
575 
576  ystr("workspace_buttons");
577  y(bool, !config->hide_workspace_buttons);
578 
579  ystr("strip_workspace_numbers");
580  y(bool, config->strip_workspace_numbers);
581 
582  ystr("binding_mode_indicator");
583  y(bool, !config->hide_binding_mode_indicator);
584 
585  ystr("verbose");
586  y(bool, config->verbose);
587 
588 #undef YSTR_IF_SET
589 #define YSTR_IF_SET(name) \
590  do { \
591  if (config->colors.name) { \
592  ystr(#name); \
593  ystr(config->colors.name); \
594  } \
595  } while (0)
596 
597  ystr("colors");
598  y(map_open);
599  YSTR_IF_SET(background);
600  YSTR_IF_SET(statusline);
601  YSTR_IF_SET(separator);
602  YSTR_IF_SET(focused_workspace_border);
603  YSTR_IF_SET(focused_workspace_bg);
604  YSTR_IF_SET(focused_workspace_text);
605  YSTR_IF_SET(active_workspace_border);
606  YSTR_IF_SET(active_workspace_bg);
607  YSTR_IF_SET(active_workspace_text);
608  YSTR_IF_SET(inactive_workspace_border);
609  YSTR_IF_SET(inactive_workspace_bg);
610  YSTR_IF_SET(inactive_workspace_text);
611  YSTR_IF_SET(urgent_workspace_border);
612  YSTR_IF_SET(urgent_workspace_bg);
613  YSTR_IF_SET(urgent_workspace_text);
614  y(map_close);
615 
616  y(map_close);
617 #undef YSTR_IF_SET
618 }
619 
620 IPC_HANDLER(tree) {
621  setlocale(LC_NUMERIC, "C");
622  yajl_gen gen = ygenalloc();
623  dump_node(gen, croot, false);
624  setlocale(LC_NUMERIC, "");
625 
626  const unsigned char *payload;
627  ylength length;
628  y(get_buf, &payload, &length);
629 
630  ipc_send_message(fd, length, I3_IPC_REPLY_TYPE_TREE, payload);
631  y(free);
632 }
633 
634 /*
635  * Formats the reply message for a GET_WORKSPACES request and sends it to the
636  * client
637  *
638  */
639 IPC_HANDLER(get_workspaces) {
640  yajl_gen gen = ygenalloc();
641  y(array_open);
642 
643  Con *focused_ws = con_get_workspace(focused);
644 
645  Con *output;
646  TAILQ_FOREACH(output, &(croot->nodes_head), nodes) {
647  if (con_is_internal(output))
648  continue;
649  Con *ws;
650  TAILQ_FOREACH(ws, &(output_get_content(output)->nodes_head), nodes) {
651  assert(ws->type == CT_WORKSPACE);
652  y(map_open);
653 
654  ystr("num");
655  y(integer, ws->num);
656 
657  ystr("name");
658  ystr(ws->name);
659 
660  ystr("visible");
661  y(bool, workspace_is_visible(ws));
662 
663  ystr("focused");
664  y(bool, ws == focused_ws);
665 
666  ystr("rect");
667  y(map_open);
668  ystr("x");
669  y(integer, ws->rect.x);
670  ystr("y");
671  y(integer, ws->rect.y);
672  ystr("width");
673  y(integer, ws->rect.width);
674  ystr("height");
675  y(integer, ws->rect.height);
676  y(map_close);
677 
678  ystr("output");
679  ystr(output->name);
680 
681  ystr("urgent");
682  y(bool, ws->urgent);
683 
684  y(map_close);
685  }
686  }
687 
688  y(array_close);
689 
690  const unsigned char *payload;
691  ylength length;
692  y(get_buf, &payload, &length);
693 
694  ipc_send_message(fd, length, I3_IPC_REPLY_TYPE_WORKSPACES, payload);
695  y(free);
696 }
697 
698 /*
699  * Formats the reply message for a GET_OUTPUTS request and sends it to the
700  * client
701  *
702  */
703 IPC_HANDLER(get_outputs) {
704  yajl_gen gen = ygenalloc();
705  y(array_open);
706 
707  Output *output;
708  TAILQ_FOREACH(output, &outputs, outputs) {
709  y(map_open);
710 
711  ystr("name");
712  ystr(output->name);
713 
714  ystr("active");
715  y(bool, output->active);
716 
717  ystr("primary");
718  y(bool, output->primary);
719 
720  ystr("rect");
721  y(map_open);
722  ystr("x");
723  y(integer, output->rect.x);
724  ystr("y");
725  y(integer, output->rect.y);
726  ystr("width");
727  y(integer, output->rect.width);
728  ystr("height");
729  y(integer, output->rect.height);
730  y(map_close);
731 
732  ystr("current_workspace");
733  Con *ws = NULL;
734  if (output->con && (ws = con_get_fullscreen_con(output->con, CF_OUTPUT)))
735  ystr(ws->name);
736  else
737  y(null);
738 
739  y(map_close);
740  }
741 
742  y(array_close);
743 
744  const unsigned char *payload;
745  ylength length;
746  y(get_buf, &payload, &length);
747 
748  ipc_send_message(fd, length, I3_IPC_REPLY_TYPE_OUTPUTS, payload);
749  y(free);
750 }
751 
752 /*
753  * Formats the reply message for a GET_MARKS request and sends it to the
754  * client
755  *
756  */
757 IPC_HANDLER(get_marks) {
758  yajl_gen gen = ygenalloc();
759  y(array_open);
760 
761  Con *con;
763  if (con->mark != NULL)
764  ystr(con->mark);
765 
766  y(array_close);
767 
768  const unsigned char *payload;
769  ylength length;
770  y(get_buf, &payload, &length);
771 
772  ipc_send_message(fd, length, I3_IPC_REPLY_TYPE_MARKS, payload);
773  y(free);
774 }
775 
776 /*
777  * Returns the version of i3
778  *
779  */
780 IPC_HANDLER(get_version) {
781  yajl_gen gen = ygenalloc();
782  y(map_open);
783 
784  ystr("major");
785  y(integer, MAJOR_VERSION);
786 
787  ystr("minor");
788  y(integer, MINOR_VERSION);
789 
790  ystr("patch");
791  y(integer, PATCH_VERSION);
792 
793  ystr("human_readable");
794  ystr(I3_VERSION);
795 
796  y(map_close);
797 
798  const unsigned char *payload;
799  ylength length;
800  y(get_buf, &payload, &length);
801 
802  ipc_send_message(fd, length, I3_IPC_REPLY_TYPE_VERSION, payload);
803  y(free);
804 }
805 
806 /*
807  * Formats the reply message for a GET_BAR_CONFIG request and sends it to the
808  * client.
809  *
810  */
811 IPC_HANDLER(get_bar_config) {
812  yajl_gen gen = ygenalloc();
813 
814  /* If no ID was passed, we return a JSON array with all IDs */
815  if (message_size == 0) {
816  y(array_open);
817  Barconfig *current;
818  TAILQ_FOREACH(current, &barconfigs, configs) {
819  ystr(current->id);
820  }
821  y(array_close);
822 
823  const unsigned char *payload;
824  ylength length;
825  y(get_buf, &payload, &length);
826 
827  ipc_send_message(fd, length, I3_IPC_REPLY_TYPE_BAR_CONFIG, payload);
828  y(free);
829  return;
830  }
831 
832  /* To get a properly terminated buffer, we copy
833  * message_size bytes out of the buffer */
834  char *bar_id = scalloc(message_size + 1);
835  strncpy(bar_id, (const char *)message, message_size);
836  LOG("IPC: looking for config for bar ID \"%s\"\n", bar_id);
837  Barconfig *current, *config = NULL;
838  TAILQ_FOREACH(current, &barconfigs, configs) {
839  if (strcmp(current->id, bar_id) != 0)
840  continue;
841 
842  config = current;
843  break;
844  }
845 
846  if (!config) {
847  /* If we did not find a config for the given ID, the reply will contain
848  * a null 'id' field. */
849  y(map_open);
850 
851  ystr("id");
852  y(null);
853 
854  y(map_close);
855  } else {
856  dump_bar_config(gen, config);
857  }
858 
859  const unsigned char *payload;
860  ylength length;
861  y(get_buf, &payload, &length);
862 
863  ipc_send_message(fd, length, I3_IPC_REPLY_TYPE_BAR_CONFIG, payload);
864  y(free);
865 }
866 
867 /*
868  * Callback for the YAJL parser (will be called when a string is parsed).
869  *
870  */
871 static int add_subscription(void *extra, const unsigned char *s,
872  ylength len) {
873  ipc_client *client = extra;
874 
875  DLOG("should add subscription to extra %p, sub %.*s\n", client, (int)len, s);
876  int event = client->num_events;
877 
878  client->num_events++;
879  client->events = realloc(client->events, client->num_events * sizeof(char *));
880  /* We copy the string because it is not null-terminated and strndup()
881  * is missing on some BSD systems */
882  client->events[event] = scalloc(len + 1);
883  memcpy(client->events[event], s, len);
884 
885  DLOG("client is now subscribed to:\n");
886  for (int i = 0; i < client->num_events; i++)
887  DLOG("event %s\n", client->events[i]);
888  DLOG("(done)\n");
889 
890  return 1;
891 }
892 
893 /*
894  * Subscribes this connection to the event types which were given as a JSON
895  * serialized array in the payload field of the message.
896  *
897  */
898 IPC_HANDLER(subscribe) {
899  yajl_handle p;
900  yajl_status stat;
901  ipc_client *current, *client = NULL;
902 
903  /* Search the ipc_client structure for this connection */
904  TAILQ_FOREACH(current, &all_clients, clients) {
905  if (current->fd != fd)
906  continue;
907 
908  client = current;
909  break;
910  }
911 
912  if (client == NULL) {
913  ELOG("Could not find ipc_client data structure for fd %d\n", fd);
914  return;
915  }
916 
917  /* Setup the JSON parser */
918  static yajl_callbacks callbacks = {
919  .yajl_string = add_subscription,
920  };
921 
922  p = yalloc(&callbacks, (void *)client);
923  stat = yajl_parse(p, (const unsigned char *)message, message_size);
924  if (stat != yajl_status_ok) {
925  unsigned char *err;
926  err = yajl_get_error(p, true, (const unsigned char *)message,
927  message_size);
928  ELOG("YAJL parse error: %s\n", err);
929  yajl_free_error(p, err);
930 
931  const char *reply = "{\"success\":false}";
932  ipc_send_message(fd, strlen(reply), I3_IPC_REPLY_TYPE_SUBSCRIBE, (const uint8_t *)reply);
933  yajl_free(p);
934  return;
935  }
936  yajl_free(p);
937  const char *reply = "{\"success\":true}";
938  ipc_send_message(fd, strlen(reply), I3_IPC_REPLY_TYPE_SUBSCRIBE, (const uint8_t *)reply);
939 }
940 
941 /* The index of each callback function corresponds to the numeric
942  * value of the message type (see include/i3/ipc.h) */
944  handle_command,
945  handle_get_workspaces,
946  handle_subscribe,
947  handle_get_outputs,
948  handle_tree,
949  handle_get_marks,
950  handle_get_bar_config,
951  handle_get_version,
952 };
953 
954 /*
955  * Handler for activity on a client connection, receives a message from a
956  * client.
957  *
958  * For now, the maximum message size is 2048. I’m not sure for what the
959  * IPC interface will be used in the future, thus I’m not implementing a
960  * mechanism for arbitrarily long messages, as it seems like overkill
961  * at the moment.
962  *
963  */
964 static void ipc_receive_message(EV_P_ struct ev_io *w, int revents) {
965  uint32_t message_type;
966  uint32_t message_length;
967  uint8_t *message = NULL;
968 
969  int ret = ipc_recv_message(w->fd, &message_type, &message_length, &message);
970  /* EOF or other error */
971  if (ret < 0) {
972  /* Was this a spurious read? See ev(3) */
973  if (ret == -1 && errno == EAGAIN) {
974  FREE(message);
975  return;
976  }
977 
978  /* If not, there was some kind of error. We don’t bother
979  * and close the connection */
980  close(w->fd);
981 
982  /* Delete the client from the list of clients */
983  ipc_client *current;
984  TAILQ_FOREACH(current, &all_clients, clients) {
985  if (current->fd != w->fd)
986  continue;
987 
988  for (int i = 0; i < current->num_events; i++)
989  free(current->events[i]);
990  /* We can call TAILQ_REMOVE because we break out of the
991  * TAILQ_FOREACH afterwards */
992  TAILQ_REMOVE(&all_clients, current, clients);
993  free(current);
994  break;
995  }
996 
997  ev_io_stop(EV_A_ w);
998  free(w);
999  FREE(message);
1000 
1001  DLOG("IPC: client disconnected\n");
1002  return;
1003  }
1004 
1005  if (message_type >= (sizeof(handlers) / sizeof(handler_t)))
1006  DLOG("Unhandled message type: %d\n", message_type);
1007  else {
1008  handler_t h = handlers[message_type];
1009  h(w->fd, message, 0, message_length, message_type);
1010  }
1011 
1012  FREE(message);
1013 }
1014 
1015 /*
1016  * Handler for activity on the listening socket, meaning that a new client
1017  * has just connected and we should accept() him. Sets up the event handler
1018  * for activity on the new connection and inserts the file descriptor into
1019  * the list of clients.
1020  *
1021  */
1022 void ipc_new_client(EV_P_ struct ev_io *w, int revents) {
1023  struct sockaddr_un peer;
1024  socklen_t len = sizeof(struct sockaddr_un);
1025  int client;
1026  if ((client = accept(w->fd, (struct sockaddr *)&peer, &len)) < 0) {
1027  if (errno == EINTR)
1028  return;
1029  else
1030  perror("accept()");
1031  return;
1032  }
1033 
1034  /* Close this file descriptor on exec() */
1035  (void)fcntl(client, F_SETFD, FD_CLOEXEC);
1036 
1037  set_nonblock(client);
1038 
1039  struct ev_io *package = scalloc(sizeof(struct ev_io));
1040  ev_io_init(package, ipc_receive_message, client, EV_READ);
1041  ev_io_start(EV_A_ package);
1042 
1043  DLOG("IPC: new client connected on fd %d\n", w->fd);
1044 
1045  ipc_client *new = scalloc(sizeof(ipc_client));
1046  new->fd = client;
1047 
1048  TAILQ_INSERT_TAIL(&all_clients, new, clients);
1049 }
1050 
1051 /*
1052  * Creates the UNIX domain socket at the given path, sets it to non-blocking
1053  * mode, bind()s and listen()s on it.
1054  *
1055  */
1056 int ipc_create_socket(const char *filename) {
1057  int sockfd;
1058 
1060 
1061  char *resolved = resolve_tilde(filename);
1062  DLOG("Creating IPC-socket at %s\n", resolved);
1063  char *copy = sstrdup(resolved);
1064  const char *dir = dirname(copy);
1065  if (!path_exists(dir))
1066  mkdirp(dir);
1067  free(copy);
1068 
1069  /* Unlink the unix domain socket before */
1070  unlink(resolved);
1071 
1072  if ((sockfd = socket(AF_LOCAL, SOCK_STREAM, 0)) < 0) {
1073  perror("socket()");
1074  free(resolved);
1075  return -1;
1076  }
1077 
1078  (void)fcntl(sockfd, F_SETFD, FD_CLOEXEC);
1079 
1080  struct sockaddr_un addr;
1081  memset(&addr, 0, sizeof(struct sockaddr_un));
1082  addr.sun_family = AF_LOCAL;
1083  strncpy(addr.sun_path, resolved, sizeof(addr.sun_path) - 1);
1084  if (bind(sockfd, (struct sockaddr *)&addr, sizeof(struct sockaddr_un)) < 0) {
1085  perror("bind()");
1086  free(resolved);
1087  return -1;
1088  }
1089 
1090  set_nonblock(sockfd);
1091 
1092  if (listen(sockfd, 5) < 0) {
1093  perror("listen()");
1094  free(resolved);
1095  return -1;
1096  }
1097 
1098  current_socketpath = resolved;
1099  return sockfd;
1100 }
1101 
1102 /*
1103  * Generates a json workspace event. Returns a dynamically allocated yajl
1104  * generator. Free with yajl_gen_free().
1105  */
1106 yajl_gen ipc_marshal_workspace_event(const char *change, Con *current, Con *old) {
1107  setlocale(LC_NUMERIC, "C");
1108  yajl_gen gen = ygenalloc();
1109 
1110  y(map_open);
1111 
1112  ystr("change");
1113  ystr(change);
1114 
1115  ystr("current");
1116  if (current == NULL)
1117  y(null);
1118  else
1119  dump_node(gen, current, false);
1120 
1121  ystr("old");
1122  if (old == NULL)
1123  y(null);
1124  else
1125  dump_node(gen, old, false);
1126 
1127  y(map_close);
1128 
1129  setlocale(LC_NUMERIC, "");
1130 
1131  return gen;
1132 }
1133 
1134 /*
1135  * For the workspace events we send, along with the usual "change" field, also
1136  * the workspace container in "current". For focus events, we send the
1137  * previously focused workspace in "old".
1138  */
1139 void ipc_send_workspace_event(const char *change, Con *current, Con *old) {
1140  yajl_gen gen = ipc_marshal_workspace_event(change, current, old);
1141 
1142  const unsigned char *payload;
1143  ylength length;
1144  y(get_buf, &payload, &length);
1145 
1146  ipc_send_event("workspace", I3_IPC_EVENT_WORKSPACE, (const char *)payload);
1147 
1148  y(free);
1149 }
1150 
1155 void ipc_send_window_event(const char *property, Con *con) {
1156  DLOG("Issue IPC window %s event (con = %p, window = 0x%08x)\n",
1157  property, con, (con->window ? con->window->id : XCB_WINDOW_NONE));
1158 
1159  setlocale(LC_NUMERIC, "C");
1160  yajl_gen gen = ygenalloc();
1161 
1162  y(map_open);
1163 
1164  ystr("change");
1165  ystr(property);
1166 
1167  ystr("container");
1168  dump_node(gen, con, false);
1169 
1170  y(map_close);
1171 
1172  const unsigned char *payload;
1173  ylength length;
1174  y(get_buf, &payload, &length);
1175 
1176  ipc_send_event("window", I3_IPC_EVENT_WINDOW, (const char *)payload);
1177  y(free);
1178  setlocale(LC_NUMERIC, "");
1179 }
1180 
1185  DLOG("Issue barconfig_update event for id = %s\n", barconfig->id);
1186  setlocale(LC_NUMERIC, "C");
1187  yajl_gen gen = ygenalloc();
1188 
1189  dump_bar_config(gen, barconfig);
1190 
1191  const unsigned char *payload;
1192  ylength length;
1193  y(get_buf, &payload, &length);
1194 
1195  ipc_send_event("barconfig_update", I3_IPC_EVENT_BARCONFIG_UPDATE, (const char *)payload);
1196  y(free);
1197  setlocale(LC_NUMERIC, "");
1198 }
1199 
1200 /*
1201  * For the binding events, we send the serialized binding struct.
1202  */
1203 void ipc_send_binding_event(const char *event_type, Binding *bind) {
1204  DLOG("Issue IPC binding %s event (sym = %s, code = %d)\n", event_type, bind->symbol, bind->keycode);
1205 
1206  setlocale(LC_NUMERIC, "C");
1207 
1208  yajl_gen gen = ygenalloc();
1209 
1210  y(map_open);
1211 
1212  ystr("change");
1213  ystr(event_type);
1214 
1215  ystr("binding");
1216  dump_binding(gen, bind);
1217 
1218  y(map_close);
1219 
1220  const unsigned char *payload;
1221  ylength length;
1222  y(get_buf, &payload, &length);
1223 
1224  ipc_send_event("binding", I3_IPC_EVENT_BINDING, (const char *)payload);
1225 
1226  y(free);
1227  setlocale(LC_NUMERIC, "");
1228 }
Definition: ipc.h:25
Definition: data.h:95
const char * i3string_as_utf8(i3String *str)
Returns the UTF-8 encoded version of the i3String.
char * sstrdup(const char *str)
Safe-wrapper around strdup which exits if malloc returns NULL (meaning that there is no more memory a...
void ipc_shutdown(void)
Calls shutdown() on each socket and closes it.
Definition: ipc.c:68
bool urgent
Definition: data.h:501
char * name
Name of the output.
Definition: data.h:328
char * symbol
Symbol the user specified in configfile, if any.
Definition: data.h:274
void tree_render(void)
Renders the tree, that is rendering all outputs using render_con() and pushing the changes to X11 usi...
Definition: tree.c:516
Definition: data.h:61
uint32_t y
Definition: data.h:132
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:402
Config config
Definition: config.c:17
bool hide_binding_mode_indicator
Hide mode button? Configuration option is 'binding_mode_indicator no' but we invert the bool for the ...
Definition: config.h:302
Con * con_get_workspace(Con *con)
Gets the workspace container this node is on.
Definition: con.c:298
static void dump_bar_config(yajl_gen gen, Barconfig *config)
Definition: ipc.c:472
Stores a rectangle, for example the size of a window, the child window etc.
Definition: data.h:130
#define LOG(fmt,...)
Definition: libi3.h:76
bool workspace_is_visible(Con *ws)
Returns true if the workspace is currently visible.
Definition: workspace.c:229
enum Barconfig::@5 mode
Bar display mode (hide unless modifier is pressed or show in dock mode or always hide in invisible mo...
Definition: data.h:62
input_type_t input_type
Definition: data.h:242
enum Barconfig::@8 position
Bar position (bottom by default).
struct Rect rect
Definition: data.h:531
struct all_cons_head all_cons
Definition: tree.c:17
char * mark
Definition: data.h:545
Rect rect
x, y, width, height
Definition: data.h:334
#define ystr(str)
Definition: commands.c:20
CommandResult * parse_command(const char *input, yajl_gen gen)
Parses and executes the given command.
bool verbose
Enable verbose mode? Useful for debugging purposes.
Definition: config.h:305
size_t ylength
Definition: yajl_utils.h:22
#define TAILQ_FIRST(head)
Definition: queue.h:336
TAILQ_HEAD(ipc_client_head, ipc_client)
Definition: ipc.c:25
struct Window * window
Definition: data.h:564
IPC_HANDLER(command)
Definition: ipc.c:84
void dump_node(yajl_gen gen, struct Con *con, bool inplace_restart)
Definition: ipc.c:178
handler_t handlers[8]
Definition: ipc.c:943
An Output is a physical output on your graphics driver.
Definition: data.h:313
int ipc_recv_message(int sockfd, uint32_t *message_type, uint32_t *reply_length, uint8_t **reply)
Reads a message from the given socket file descriptor and stores its length (reply_length) as well as...
bool con_is_internal(Con *con)
Returns true if the container is internal, such as __i3_scratch.
Definition: con.c:392
void command_result_free(CommandResult *result)
Frees a CommandResult.
Holds a keybinding, consisting of a keycode combined with modifiers and the command which is executed...
Definition: data.h:239
static void ipc_receive_message(EV_P_ struct ev_io *w, int revents)
Definition: ipc.c:964
void ipc_send_event(const char *event, uint32_t message_type, const char *payload)
Sends the specified event to all IPC clients which are currently connected and subscribed to this kin...
Definition: ipc.c:45
static void dump_binding(yajl_gen gen, Binding *bind)
Definition: ipc.c:124
enum Con::@18 type
Definition: data.h:93
#define DLOG(fmt,...)
Definition: libi3.h:86
A struct that contains useful information about the result of a command as a whole (e...
char * command
Command, like in command mode.
Definition: data.h:284
Definition: data.h:94
int ipc_create_socket(const char *filename)
Creates the UNIX domain socket at the given path, sets it to non-blocking mode, bind()s and listen()s...
Definition: ipc.c:1056
Con * con_get_fullscreen_con(Con *con, fullscreen_mode_t fullscreen_mode)
Returns the first fullscreen node below this node.
Definition: con.c:346
char * wheel_up_cmd
Command that should be run when mouse wheel up button is pressed over i3bar to override the default b...
Definition: config.h:266
char ** events
Definition: ipc.h:30
struct outputs_head outputs
Definition: randr.c:28
uint32_t height
Definition: data.h:134
char * wheel_down_cmd
Command that should be run when mouse wheel down button is pressed over i3bar to override the default...
Definition: config.h:270
Con * focused
Definition: tree.c:15
Con * con
Pointer to the Con which represents this output.
Definition: data.h:331
char * id
Automatically generated ID for this bar config.
Definition: config.h:226
int num
the workspace number, if this Con is of type CT_WORKSPACE and the workspace is not a named workspace ...
Definition: data.h:527
char * name
Definition: data.h:537
Definition: data.h:99
enum Barconfig::@7 modifier
Bar modifier (to show bar when in hide mode).
static void dump_rect(yajl_gen gen, const char *name, Rect r)
Definition: ipc.c:110
int num_events
Definition: ipc.h:29
#define TAILQ_EMPTY(head)
Definition: queue.h:344
int ipc_send_message(int sockfd, const uint32_t message_size, const uint32_t message_type, const uint8_t *payload)
Formats a message (payload) of the given size and type and sends it to i3 via the given socket file d...
#define yalloc(callbacks, client)
Definition: yajl_utils.h:21
#define YSTR_IF_SET(name)
bool strip_workspace_numbers
Strip workspace numbers? Configuration option is 'strip_workspace_numbers yes'.
Definition: config.h:298
#define ygenalloc()
Definition: yajl_utils.h:20
bool active
Whether the output is currently active (has a CRTC attached with a valid mode)
Definition: data.h:319
char * resolve_tilde(const char *path)
This function resolves ~ in pathnames.
Definition: util.c:168
char * separator_symbol
A custom separator to use instead of a vertical line.
Definition: config.h:289
bool con_is_split(Con *con)
Definition: con.c:246
enum Match::@13 dock
#define ELOG(fmt,...)
Definition: libi3.h:81
Definition: data.h:58
A "match" is a data structure which acts like a mask or expression to match certain windows or not...
Definition: data.h:404
static int add_subscription(void *extra, const unsigned char *s, ylength len)
Definition: ipc.c:871
orientation_t con_orientation(Con *con)
Returns the orientation of the given container (for stacked containers, vertical orientation is used ...
Definition: con.c:889
A 'Con' represents everything from the X11 root window down to a single X11 window.
Definition: data.h:496
uint32_t x
Definition: data.h:131
enum Barconfig::@6 hidden_state
void * scalloc(size_t size)
Safe-wrapper around calloc which exits if malloc returns NULL (meaning that there is no more memory a...
char * current_socketpath
Definition: ipc.c:23
Definition: data.h:97
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:1139
uint32_t keycode
Keycode to bind.
Definition: data.h:266
enum Match::@15 insert_where
bool mkdirp(const char *path)
Emulates mkdir -p (creates any missing folders)
#define TAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:376
uint32_t mods
Bitmask consisting of BIND_MOD_1, BIND_MODE_SWITCH, …
Definition: data.h:269
struct Con * croot
Definition: tree.c:14
bool hide_workspace_buttons
Hide workspace buttons? Configuration option is 'workspace_buttons no' but we invert the bool to get ...
Definition: config.h:294
#define TAILQ_HEAD_INITIALIZER(head)
Definition: queue.h:324
yajl_gen ipc_marshal_workspace_event(const char *change, Con *current, Con *old)
Generates a json workspace event.
Definition: ipc.c:1106
bool restart_mode
Definition: data.h:447
bool path_exists(const char *path)
Checks if the given path exists by calling stat().
Definition: util.c:198
void ipc_new_client(EV_P_ struct ev_io *w, int revents)
Handler for activity on the listening socket, meaning that a new client has just connected and we sho...
Definition: ipc.c:1022
struct barconfig_head barconfigs
Definition: config.c:19
char ** outputs
Outputs on which this bar should show up on.
Definition: config.h:232
Con * output_get_content(Con *output)
Returns the output container below the given output container.
Definition: output.c:18
uint32_t y
Definition: data.h:31
xcb_window_t id
Definition: data.h:345
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:347
void(* handler_t)(int, uint8_t *, int, uint32_t, uint32_t)
Definition: ipc.h:45
#define DUMP_PROPERTY(key, prop_name)
Holds the status bar configuration (i3bar).
Definition: config.h:223
#define FREE(pointer)
Definition: util.h:48
bool primary
Definition: data.h:325
void ipc_send_window_event(const char *property, Con *con)
For the window events we send, along the usual "change" field, also the window container, in "container".
Definition: ipc.c:1155
Definition: data.h:60
int fd
Definition: ipc.h:26
uint32_t width
Definition: data.h:133
#define DUMP_REGEX(re_name)
Definition: data.h:98
void ipc_send_binding_event(const char *event_type, Binding *bind)
For the binding events, we send the serialized binding struct.
Definition: ipc.c:1203
int num_outputs
Number of outputs in the outputs array.
Definition: config.h:229
void ipc_send_barconfig_update_event(Barconfig *barconfig)
For the barconfig update events, we send the serialized barconfig.
Definition: ipc.c:1184