git.sur5r.net Git - i3/i3/blob - include/ipc.h

   1 /*
   2  * vim:ts=4:sw=4:expandtab
   3  *
   4  * i3 - an improved dynamic tiling window manager
   5  * © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE)
   6  *
   7  * ipc.c: UNIX domain socket IPC (initialization, client handling, protocol).
   8  *
   9  */
  10 #ifndef I3_IPC_H
  11 #define I3_IPC_H
  12
  13 #include <ev.h>
  14 #include <stdbool.h>
  15 #include <yajl/yajl_gen.h>
  16 #include <yajl/yajl_parse.h>
  17
  18 #include "data.h"
  19 #include "tree.h"
  20
  21 #include "i3/ipc.h"
  22
  23 extern char *current_socketpath;
  24
  25 typedef struct ipc_client {
  26         int fd;
  27
  28         /* The events which this client wants to receive */
  29         int num_events;
  30         char **events;
  31
  32         TAILQ_ENTRY(ipc_client) clients;
  33 } ipc_client;
  34
  35 /*
  36  * Callback type for the different message types.
  37  *
  38  * message is the raw packet, as received from the UNIX domain socket. size
  39  * is the remaining size of bytes for this packet.
  40  *
  41  * message_size is the size of the message as the sender specified it.
  42  * message_type is the type of the message as the sender specified it.
  43  *
  44  */
  45 typedef void(*handler_t)(int, uint8_t*, int, uint32_t, uint32_t);
  46
  47 /* Macro to declare a callback */
  48 #define IPC_HANDLER(name) \
  49         static void handle_ ## name (int fd, uint8_t *message, \
  50                                      int size, uint32_t message_size, \
  51                                      uint32_t message_type)
  52
  53 /**
  54  * Handler for activity on the listening socket, meaning that a new client
  55  * has just connected and we should accept() him. Sets up the event handler
  56  * for activity on the new connection and inserts the file descriptor into
  57  * the list of clients.
  58  *
  59  */
  60 void ipc_new_client(EV_P_ struct ev_io *w, int revents);
  61
  62 /**
  63  * Creates the UNIX domain socket at the given path, sets it to non-blocking
  64  * mode, bind()s and listen()s on it.
  65  *
  66  */
  67 int ipc_create_socket(const char *filename);
  68
  69 /**
  70  * Sends the specified event to all IPC clients which are currently connected
  71  * and subscribed to this kind of event.
  72  *
  73  */
  74 void ipc_send_event(const char *event, uint32_t message_type, const char *payload);
  75
  76 /**
  77  * Calls shutdown() on each socket and closes it. This function to be called
  78  * when exiting or restarting only!
  79  *
  80  */
  81 void ipc_shutdown(void);
  82
  83 void dump_node(yajl_gen gen, Con *con, bool inplace_restart);
  84
  85 /**
  86  * For the workspace "focus" event we send, along the usual "change" field,
  87  * also the current and previous workspace, in "current" and "old"
  88  * respectively.
  89  */
  90 void ipc_send_workspace_focus_event(Con *current, Con *old);
  91
  92 #endif