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

   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  * This public header defines the different constants and message types to use
   8  * for the IPC interface to i3 (see docs/ipc for more information).
   9  *
  10  */
  11 #pragma once
  12
  13 #include <stdint.h>
  14
  15 typedef struct i3_ipc_header {
  16     /* 6 = strlen(I3_IPC_MAGIC) */
  17     char magic[6];
  18     uint32_t size;
  19     uint32_t type;
  20 } __attribute__((packed)) i3_ipc_header_t;
  21
  22 /*
  23  * Messages from clients to i3
  24  *
  25  */
  26
  27 /** Never change this, only on major IPC breakage (don’t do that) */
  28 #define I3_IPC_MAGIC "i3-ipc"
  29
  30 /** The payload of the message will be interpreted as a command */
  31 #define I3_IPC_MESSAGE_TYPE_COMMAND 0
  32
  33 /** Requests the current workspaces from i3 */
  34 #define I3_IPC_MESSAGE_TYPE_GET_WORKSPACES 1
  35
  36 /** Subscribe to the specified events */
  37 #define I3_IPC_MESSAGE_TYPE_SUBSCRIBE 2
  38
  39 /** Requests the current outputs from i3 */
  40 #define I3_IPC_MESSAGE_TYPE_GET_OUTPUTS 3
  41
  42 /** Requests the tree layout from i3 */
  43 #define I3_IPC_MESSAGE_TYPE_GET_TREE 4
  44
  45 /** Request the current defined marks from i3 */
  46 #define I3_IPC_MESSAGE_TYPE_GET_MARKS 5
  47
  48 /** Request the configuration for a specific 'bar' */
  49 #define I3_IPC_MESSAGE_TYPE_GET_BAR_CONFIG 6
  50
  51 /** Request the i3 version */
  52 #define I3_IPC_MESSAGE_TYPE_GET_VERSION 7
  53
  54 /*
  55  * Messages from i3 to clients
  56  *
  57  */
  58
  59 /** Command reply type */
  60 #define I3_IPC_REPLY_TYPE_COMMAND 0
  61
  62 /** Workspaces reply type */
  63 #define I3_IPC_REPLY_TYPE_WORKSPACES 1
  64
  65 /** Subscription reply type */
  66 #define I3_IPC_REPLY_TYPE_SUBSCRIBE 2
  67
  68 /** Outputs reply type */
  69 #define I3_IPC_REPLY_TYPE_OUTPUTS 3
  70
  71 /** Tree reply type */
  72 #define I3_IPC_REPLY_TYPE_TREE 4
  73
  74 /** Marks reply type */
  75 #define I3_IPC_REPLY_TYPE_MARKS 5
  76
  77 /** Bar config reply type */
  78 #define I3_IPC_REPLY_TYPE_BAR_CONFIG 6
  79
  80 /** i3 version reply type */
  81 #define I3_IPC_REPLY_TYPE_VERSION 7
  82
  83 /*
  84  * Events from i3 to clients. Events have the first bit set high.
  85  *
  86  */
  87 #define I3_IPC_EVENT_MASK (1 << 31)
  88
  89 /* The workspace event will be triggered upon changes in the workspace list */
  90 #define I3_IPC_EVENT_WORKSPACE (I3_IPC_EVENT_MASK | 0)
  91
  92 /* The output event will be triggered upon changes in the output list */
  93 #define I3_IPC_EVENT_OUTPUT (I3_IPC_EVENT_MASK | 1)
  94
  95 /* The output event will be triggered upon mode changes */
  96 #define I3_IPC_EVENT_MODE (I3_IPC_EVENT_MASK | 2)
  97
  98 /* The window event will be triggered upon window changes */
  99 #define I3_IPC_EVENT_WINDOW (I3_IPC_EVENT_MASK | 3)
 100
 101 /** Bar config update will be triggered to update the bar config */
 102 #define I3_IPC_EVENT_BARCONFIG_UPDATE (I3_IPC_EVENT_MASK | 4)
 103
 104 /** The binding event will be triggered when bindings run */
 105 #define I3_IPC_EVENT_BINDING (I3_IPC_EVENT_MASK | 5)