xref: /netbsd/external/bsd/tmux/dist/tmux.h (revision ae2d633d)
1 /* $OpenBSD$ */
2 
3 /*
4  * Copyright (c) 2007 Nicholas Marriott <nicholas.marriott@gmail.com>
5  *
6  * Permission to use, copy, modify, and distribute this software for any
7  * purpose with or without fee is hereby granted, provided that the above
8  * copyright notice and this permission notice appear in all copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14  * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
15  * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
16  * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17  */
18 
19 #ifndef TMUX_H
20 #define TMUX_H
21 
22 #include <sys/time.h>
23 #include <sys/uio.h>
24 
25 #include <limits.h>
26 #include <stdarg.h>
27 #include <stdio.h>
28 #include <termios.h>
29 
30 #ifdef HAVE_UTEMPTER
31 #include <utempter.h>
32 #endif
33 
34 #include "compat.h"
35 #include "tmux-protocol.h"
36 #include "xmalloc.h"
37 
38 extern char   **environ;
39 
40 struct args;
41 struct args_command_state;
42 struct client;
43 struct cmd;
44 struct cmd_find_state;
45 struct cmdq_item;
46 struct cmdq_list;
47 struct cmdq_state;
48 struct cmds;
49 struct control_state;
50 struct environ;
51 struct format_job_tree;
52 struct format_tree;
53 struct input_ctx;
54 struct job;
55 struct menu_data;
56 struct mode_tree_data;
57 struct mouse_event;
58 struct options;
59 struct options_array_item;
60 struct options_entry;
61 struct screen_write_citem;
62 struct screen_write_cline;
63 struct screen_write_ctx;
64 struct session;
65 struct tty_ctx;
66 struct tty_code;
67 struct tty_key;
68 struct tmuxpeer;
69 struct tmuxproc;
70 struct winlink;
71 
72 /* Default configuration files and socket paths. */
73 #ifndef TMUX_CONF
74 #define TMUX_CONF "/etc/tmux.conf:~/.tmux.conf"
75 #endif
76 #ifndef TMUX_SOCK
77 #define TMUX_SOCK "$TMUX_TMPDIR:" _PATH_TMP
78 #endif
79 #ifndef TMUX_TERM
80 #define TMUX_TERM "screen"
81 #endif
82 
83 /* Minimum layout cell size, NOT including border lines. */
84 #define PANE_MINIMUM 1
85 
86 /* Minimum and maximum window size. */
87 #define WINDOW_MINIMUM PANE_MINIMUM
88 #define WINDOW_MAXIMUM 10000
89 
90 /* Automatic name refresh interval, in microseconds. Must be < 1 second. */
91 #define NAME_INTERVAL 500000
92 
93 /* Default pixel cell sizes. */
94 #define DEFAULT_XPIXEL 16
95 #define DEFAULT_YPIXEL 32
96 
97 /* Attribute to make GCC check printf-like arguments. */
98 #define printflike(a, b) __attribute__ ((format (printf, a, b)))
99 
100 /* Number of items in array. */
101 #ifndef nitems
102 #define nitems(_a) (sizeof((_a)) / sizeof((_a)[0]))
103 #endif
104 
105 /* Alert option values. */
106 #define ALERT_NONE 0
107 #define ALERT_ANY 1
108 #define ALERT_CURRENT 2
109 #define ALERT_OTHER 3
110 
111 /* Visual option values. */
112 #define VISUAL_OFF 0
113 #define VISUAL_ON 1
114 #define VISUAL_BOTH 2
115 
116 /* No key or unknown key. */
117 #define KEYC_NONE            0x000ff000000000ULL
118 #define KEYC_UNKNOWN         0x000fe000000000ULL
119 
120 /*
121  * Base for special (that is, not Unicode) keys. An enum must be at most a
122  * signed int, so these are based in the highest Unicode PUA.
123  */
124 #define KEYC_BASE            0x0000000010e000ULL
125 #define KEYC_USER            0x0000000010f000ULL
126 
127 /* Key modifier bits. */
128 #define KEYC_META            0x00100000000000ULL
129 #define KEYC_CTRL            0x00200000000000ULL
130 #define KEYC_SHIFT           0x00400000000000ULL
131 
132 /* Key flag bits. */
133 #define KEYC_LITERAL         0x01000000000000ULL
134 #define KEYC_KEYPAD          0x02000000000000ULL
135 #define KEYC_CURSOR          0x04000000000000ULL
136 #define KEYC_IMPLIED_META    0x08000000000000ULL
137 #define KEYC_BUILD_MODIFIERS 0x10000000000000ULL
138 #define KEYC_VI              0x20000000000000ULL
139 
140 /* Masks for key bits. */
141 #define KEYC_MASK_MODIFIERS  0x00f00000000000ULL
142 #define KEYC_MASK_FLAGS      0xff000000000000ULL
143 #define KEYC_MASK_KEY        0x000fffffffffffULL
144 
145 /* Available user keys. */
146 #define KEYC_NUSER 1000
147 
148 /* Is this a mouse key? */
149 #define KEYC_IS_MOUSE(key) \
150 	(((key) & KEYC_MASK_KEY) >= KEYC_MOUSE && \
151 	 ((key) & KEYC_MASK_KEY) < KEYC_BSPACE)
152 
153 /* Is this a Unicode key? */
154 #define KEYC_IS_UNICODE(key) \
155 	(((key) & KEYC_MASK_KEY) > 0x7f && \
156 	 (((key) & KEYC_MASK_KEY) < KEYC_BASE || \
157 	  ((key) & KEYC_MASK_KEY) >= KEYC_BASE_END))
158 
159 /* Multiple click timeout. */
160 #define KEYC_CLICK_TIMEOUT 300
161 
162 /* Mouse key codes. */
163 #define KEYC_MOUSE_KEY(name)					\
164 	KEYC_ ## name ## _PANE,					\
165 	KEYC_ ## name ## _STATUS,				\
166 	KEYC_ ## name ## _STATUS_LEFT,				\
167 	KEYC_ ## name ## _STATUS_RIGHT,				\
168 	KEYC_ ## name ## _STATUS_DEFAULT,			\
169 	KEYC_ ## name ## _BORDER
170 #define KEYC_MOUSE_STRING(name, s)				\
171 	{ #s "Pane", KEYC_ ## name ## _PANE },			\
172 	{ #s "Status", KEYC_ ## name ## _STATUS },		\
173 	{ #s "StatusLeft", KEYC_ ## name ## _STATUS_LEFT },	\
174 	{ #s "StatusRight", KEYC_ ## name ## _STATUS_RIGHT },	\
175 	{ #s "StatusDefault", KEYC_ ## name ## _STATUS_DEFAULT }, \
176 	{ #s "Border", KEYC_ ## name ## _BORDER }
177 
178 /*
179  * A single key. This can be ASCII or Unicode or one of the keys between
180  * KEYC_BASE and KEYC_BASE_END.
181  */
182 typedef unsigned long long key_code;
183 
184 /* Special key codes. */
185 enum {
186 	/* Focus events. */
187 	KEYC_FOCUS_IN = KEYC_BASE,
188 	KEYC_FOCUS_OUT,
189 
190 	/* "Any" key, used if not found in key table. */
191 	KEYC_ANY,
192 
193 	/* Paste brackets. */
194 	KEYC_PASTE_START,
195 	KEYC_PASTE_END,
196 
197 	/* Mouse keys. */
198 	KEYC_MOUSE, /* unclassified mouse event */
199 	KEYC_DRAGGING, /* dragging in progress */
200 	KEYC_DOUBLECLICK, /* double click complete */
201 	KEYC_MOUSE_KEY(MOUSEMOVE),
202 	KEYC_MOUSE_KEY(MOUSEDOWN1),
203 	KEYC_MOUSE_KEY(MOUSEDOWN2),
204 	KEYC_MOUSE_KEY(MOUSEDOWN3),
205 	KEYC_MOUSE_KEY(MOUSEDOWN6),
206 	KEYC_MOUSE_KEY(MOUSEDOWN7),
207 	KEYC_MOUSE_KEY(MOUSEDOWN8),
208 	KEYC_MOUSE_KEY(MOUSEDOWN9),
209 	KEYC_MOUSE_KEY(MOUSEDOWN10),
210 	KEYC_MOUSE_KEY(MOUSEDOWN11),
211 	KEYC_MOUSE_KEY(MOUSEUP1),
212 	KEYC_MOUSE_KEY(MOUSEUP2),
213 	KEYC_MOUSE_KEY(MOUSEUP3),
214 	KEYC_MOUSE_KEY(MOUSEUP6),
215 	KEYC_MOUSE_KEY(MOUSEUP7),
216 	KEYC_MOUSE_KEY(MOUSEUP8),
217 	KEYC_MOUSE_KEY(MOUSEUP9),
218 	KEYC_MOUSE_KEY(MOUSEUP10),
219 	KEYC_MOUSE_KEY(MOUSEUP11),
220 	KEYC_MOUSE_KEY(MOUSEDRAG1),
221 	KEYC_MOUSE_KEY(MOUSEDRAG2),
222 	KEYC_MOUSE_KEY(MOUSEDRAG3),
223 	KEYC_MOUSE_KEY(MOUSEDRAG6),
224 	KEYC_MOUSE_KEY(MOUSEDRAG7),
225 	KEYC_MOUSE_KEY(MOUSEDRAG8),
226 	KEYC_MOUSE_KEY(MOUSEDRAG9),
227 	KEYC_MOUSE_KEY(MOUSEDRAG10),
228 	KEYC_MOUSE_KEY(MOUSEDRAG11),
229 	KEYC_MOUSE_KEY(MOUSEDRAGEND1),
230 	KEYC_MOUSE_KEY(MOUSEDRAGEND2),
231 	KEYC_MOUSE_KEY(MOUSEDRAGEND3),
232 	KEYC_MOUSE_KEY(MOUSEDRAGEND6),
233 	KEYC_MOUSE_KEY(MOUSEDRAGEND7),
234 	KEYC_MOUSE_KEY(MOUSEDRAGEND8),
235 	KEYC_MOUSE_KEY(MOUSEDRAGEND9),
236 	KEYC_MOUSE_KEY(MOUSEDRAGEND10),
237 	KEYC_MOUSE_KEY(MOUSEDRAGEND11),
238 	KEYC_MOUSE_KEY(WHEELUP),
239 	KEYC_MOUSE_KEY(WHEELDOWN),
240 	KEYC_MOUSE_KEY(SECONDCLICK1),
241 	KEYC_MOUSE_KEY(SECONDCLICK2),
242 	KEYC_MOUSE_KEY(SECONDCLICK3),
243 	KEYC_MOUSE_KEY(SECONDCLICK6),
244 	KEYC_MOUSE_KEY(SECONDCLICK7),
245 	KEYC_MOUSE_KEY(SECONDCLICK8),
246 	KEYC_MOUSE_KEY(SECONDCLICK9),
247 	KEYC_MOUSE_KEY(SECONDCLICK10),
248 	KEYC_MOUSE_KEY(SECONDCLICK11),
249 	KEYC_MOUSE_KEY(DOUBLECLICK1),
250 	KEYC_MOUSE_KEY(DOUBLECLICK2),
251 	KEYC_MOUSE_KEY(DOUBLECLICK3),
252 	KEYC_MOUSE_KEY(DOUBLECLICK6),
253 	KEYC_MOUSE_KEY(DOUBLECLICK7),
254 	KEYC_MOUSE_KEY(DOUBLECLICK8),
255 	KEYC_MOUSE_KEY(DOUBLECLICK9),
256 	KEYC_MOUSE_KEY(DOUBLECLICK10),
257 	KEYC_MOUSE_KEY(DOUBLECLICK11),
258 	KEYC_MOUSE_KEY(TRIPLECLICK1),
259 	KEYC_MOUSE_KEY(TRIPLECLICK2),
260 	KEYC_MOUSE_KEY(TRIPLECLICK3),
261 	KEYC_MOUSE_KEY(TRIPLECLICK6),
262 	KEYC_MOUSE_KEY(TRIPLECLICK7),
263 	KEYC_MOUSE_KEY(TRIPLECLICK8),
264 	KEYC_MOUSE_KEY(TRIPLECLICK9),
265 	KEYC_MOUSE_KEY(TRIPLECLICK10),
266 	KEYC_MOUSE_KEY(TRIPLECLICK11),
267 
268 	/* Backspace key. */
269 	KEYC_BSPACE,
270 
271 	/* Function keys. */
272 	KEYC_F1,
273 	KEYC_F2,
274 	KEYC_F3,
275 	KEYC_F4,
276 	KEYC_F5,
277 	KEYC_F6,
278 	KEYC_F7,
279 	KEYC_F8,
280 	KEYC_F9,
281 	KEYC_F10,
282 	KEYC_F11,
283 	KEYC_F12,
284 	KEYC_IC,
285 	KEYC_DC,
286 	KEYC_HOME,
287 	KEYC_END,
288 	KEYC_NPAGE,
289 	KEYC_PPAGE,
290 	KEYC_BTAB,
291 
292 	/* Arrow keys. */
293 	KEYC_UP,
294 	KEYC_DOWN,
295 	KEYC_LEFT,
296 	KEYC_RIGHT,
297 
298 	/* Numeric keypad. */
299 	KEYC_KP_SLASH,
300 	KEYC_KP_STAR,
301 	KEYC_KP_MINUS,
302 	KEYC_KP_SEVEN,
303 	KEYC_KP_EIGHT,
304 	KEYC_KP_NINE,
305 	KEYC_KP_PLUS,
306 	KEYC_KP_FOUR,
307 	KEYC_KP_FIVE,
308 	KEYC_KP_SIX,
309 	KEYC_KP_ONE,
310 	KEYC_KP_TWO,
311 	KEYC_KP_THREE,
312 	KEYC_KP_ENTER,
313 	KEYC_KP_ZERO,
314 	KEYC_KP_PERIOD,
315 
316 	/* End of special keys. */
317 	KEYC_BASE_END
318 };
319 
320 /* Termcap codes. */
321 enum tty_code_code {
322 	TTYC_ACSC,
323 	TTYC_AM,
324 	TTYC_AX,
325 	TTYC_BCE,
326 	TTYC_BEL,
327 	TTYC_BIDI,
328 	TTYC_BLINK,
329 	TTYC_BOLD,
330 	TTYC_CIVIS,
331 	TTYC_CLEAR,
332 	TTYC_CLMG,
333 	TTYC_CMG,
334 	TTYC_CNORM,
335 	TTYC_COLORS,
336 	TTYC_CR,
337 	TTYC_CS,
338 	TTYC_CSR,
339 	TTYC_CUB,
340 	TTYC_CUB1,
341 	TTYC_CUD,
342 	TTYC_CUD1,
343 	TTYC_CUF,
344 	TTYC_CUF1,
345 	TTYC_CUP,
346 	TTYC_CUU,
347 	TTYC_CUU1,
348 	TTYC_CVVIS,
349 	TTYC_DCH,
350 	TTYC_DCH1,
351 	TTYC_DIM,
352 	TTYC_DL,
353 	TTYC_DL1,
354 	TTYC_DSBP,
355 	TTYC_DSEKS,
356 	TTYC_DSFCS,
357 	TTYC_DSMG,
358 	TTYC_E3,
359 	TTYC_ECH,
360 	TTYC_ED,
361 	TTYC_EL,
362 	TTYC_EL1,
363 	TTYC_ENACS,
364 	TTYC_ENBP,
365 	TTYC_ENEKS,
366 	TTYC_ENFCS,
367 	TTYC_ENMG,
368 	TTYC_FSL,
369 	TTYC_HOME,
370 	TTYC_HPA,
371 	TTYC_ICH,
372 	TTYC_ICH1,
373 	TTYC_IL,
374 	TTYC_IL1,
375 	TTYC_INDN,
376 	TTYC_INVIS,
377 	TTYC_KCBT,
378 	TTYC_KCUB1,
379 	TTYC_KCUD1,
380 	TTYC_KCUF1,
381 	TTYC_KCUU1,
382 	TTYC_KDC2,
383 	TTYC_KDC3,
384 	TTYC_KDC4,
385 	TTYC_KDC5,
386 	TTYC_KDC6,
387 	TTYC_KDC7,
388 	TTYC_KDCH1,
389 	TTYC_KDN2,
390 	TTYC_KDN3,
391 	TTYC_KDN4,
392 	TTYC_KDN5,
393 	TTYC_KDN6,
394 	TTYC_KDN7,
395 	TTYC_KEND,
396 	TTYC_KEND2,
397 	TTYC_KEND3,
398 	TTYC_KEND4,
399 	TTYC_KEND5,
400 	TTYC_KEND6,
401 	TTYC_KEND7,
402 	TTYC_KF1,
403 	TTYC_KF10,
404 	TTYC_KF11,
405 	TTYC_KF12,
406 	TTYC_KF13,
407 	TTYC_KF14,
408 	TTYC_KF15,
409 	TTYC_KF16,
410 	TTYC_KF17,
411 	TTYC_KF18,
412 	TTYC_KF19,
413 	TTYC_KF2,
414 	TTYC_KF20,
415 	TTYC_KF21,
416 	TTYC_KF22,
417 	TTYC_KF23,
418 	TTYC_KF24,
419 	TTYC_KF25,
420 	TTYC_KF26,
421 	TTYC_KF27,
422 	TTYC_KF28,
423 	TTYC_KF29,
424 	TTYC_KF3,
425 	TTYC_KF30,
426 	TTYC_KF31,
427 	TTYC_KF32,
428 	TTYC_KF33,
429 	TTYC_KF34,
430 	TTYC_KF35,
431 	TTYC_KF36,
432 	TTYC_KF37,
433 	TTYC_KF38,
434 	TTYC_KF39,
435 	TTYC_KF4,
436 	TTYC_KF40,
437 	TTYC_KF41,
438 	TTYC_KF42,
439 	TTYC_KF43,
440 	TTYC_KF44,
441 	TTYC_KF45,
442 	TTYC_KF46,
443 	TTYC_KF47,
444 	TTYC_KF48,
445 	TTYC_KF49,
446 	TTYC_KF5,
447 	TTYC_KF50,
448 	TTYC_KF51,
449 	TTYC_KF52,
450 	TTYC_KF53,
451 	TTYC_KF54,
452 	TTYC_KF55,
453 	TTYC_KF56,
454 	TTYC_KF57,
455 	TTYC_KF58,
456 	TTYC_KF59,
457 	TTYC_KF6,
458 	TTYC_KF60,
459 	TTYC_KF61,
460 	TTYC_KF62,
461 	TTYC_KF63,
462 	TTYC_KF7,
463 	TTYC_KF8,
464 	TTYC_KF9,
465 	TTYC_KHOM2,
466 	TTYC_KHOM3,
467 	TTYC_KHOM4,
468 	TTYC_KHOM5,
469 	TTYC_KHOM6,
470 	TTYC_KHOM7,
471 	TTYC_KHOME,
472 	TTYC_KIC2,
473 	TTYC_KIC3,
474 	TTYC_KIC4,
475 	TTYC_KIC5,
476 	TTYC_KIC6,
477 	TTYC_KIC7,
478 	TTYC_KICH1,
479 	TTYC_KIND,
480 	TTYC_KLFT2,
481 	TTYC_KLFT3,
482 	TTYC_KLFT4,
483 	TTYC_KLFT5,
484 	TTYC_KLFT6,
485 	TTYC_KLFT7,
486 	TTYC_KMOUS,
487 	TTYC_KNP,
488 	TTYC_KNXT2,
489 	TTYC_KNXT3,
490 	TTYC_KNXT4,
491 	TTYC_KNXT5,
492 	TTYC_KNXT6,
493 	TTYC_KNXT7,
494 	TTYC_KPP,
495 	TTYC_KPRV2,
496 	TTYC_KPRV3,
497 	TTYC_KPRV4,
498 	TTYC_KPRV5,
499 	TTYC_KPRV6,
500 	TTYC_KPRV7,
501 	TTYC_KRI,
502 	TTYC_KRIT2,
503 	TTYC_KRIT3,
504 	TTYC_KRIT4,
505 	TTYC_KRIT5,
506 	TTYC_KRIT6,
507 	TTYC_KRIT7,
508 	TTYC_KUP2,
509 	TTYC_KUP3,
510 	TTYC_KUP4,
511 	TTYC_KUP5,
512 	TTYC_KUP6,
513 	TTYC_KUP7,
514 	TTYC_MS,
515 	TTYC_OL,
516 	TTYC_OP,
517 	TTYC_RECT,
518 	TTYC_REV,
519 	TTYC_RGB,
520 	TTYC_RI,
521 	TTYC_RIN,
522 	TTYC_RMACS,
523 	TTYC_RMCUP,
524 	TTYC_RMKX,
525 	TTYC_SE,
526 	TTYC_SETAB,
527 	TTYC_SETAF,
528 	TTYC_SETAL,
529 	TTYC_SETRGBB,
530 	TTYC_SETRGBF,
531 	TTYC_SETULC,
532 	TTYC_SGR0,
533 	TTYC_SITM,
534 	TTYC_SMACS,
535 	TTYC_SMCUP,
536 	TTYC_SMKX,
537 	TTYC_SMOL,
538 	TTYC_SMSO,
539 	TTYC_SMUL,
540 	TTYC_SMULX,
541 	TTYC_SMXX,
542 	TTYC_SS,
543 	TTYC_SWD,
544 	TTYC_SYNC,
545 	TTYC_TC,
546 	TTYC_TSL,
547 	TTYC_U8,
548 	TTYC_VPA,
549 	TTYC_XT
550 };
551 
552 /* Character classes. */
553 #define WHITESPACE " "
554 
555 /* Mode keys. */
556 #define MODEKEY_EMACS 0
557 #define MODEKEY_VI 1
558 
559 /* Modes. */
560 #define MODE_CURSOR 0x1
561 #define MODE_INSERT 0x2
562 #define MODE_KCURSOR 0x4
563 #define MODE_KKEYPAD 0x8
564 #define MODE_WRAP 0x10
565 #define MODE_MOUSE_STANDARD 0x20
566 #define MODE_MOUSE_BUTTON 0x40
567 #define MODE_CURSOR_BLINKING 0x80
568 #define MODE_MOUSE_UTF8 0x100
569 #define MODE_MOUSE_SGR 0x200
570 #define MODE_BRACKETPASTE 0x400
571 #define MODE_FOCUSON 0x800
572 #define MODE_MOUSE_ALL 0x1000
573 #define MODE_ORIGIN 0x2000
574 #define MODE_CRLF 0x4000
575 #define MODE_KEXTENDED 0x8000
576 #define MODE_CURSOR_VERY_VISIBLE 0x10000
577 #define MODE_CURSOR_BLINKING_SET 0x20000
578 
579 #define ALL_MODES 0xffffff
580 #define ALL_MOUSE_MODES (MODE_MOUSE_STANDARD|MODE_MOUSE_BUTTON|MODE_MOUSE_ALL)
581 #define MOTION_MOUSE_MODES (MODE_MOUSE_BUTTON|MODE_MOUSE_ALL)
582 #define CURSOR_MODES (MODE_CURSOR|MODE_CURSOR_BLINKING|MODE_CURSOR_VERY_VISIBLE)
583 
584 /* Mouse protocol constants. */
585 #define MOUSE_PARAM_MAX 0xff
586 #define MOUSE_PARAM_UTF8_MAX 0x7ff
587 #define MOUSE_PARAM_BTN_OFF 0x20
588 #define MOUSE_PARAM_POS_OFF 0x21
589 
590 /* A single UTF-8 character. */
591 typedef u_int utf8_char;
592 
593 /*
594  * An expanded UTF-8 character. UTF8_SIZE must be big enough to hold combining
595  * characters as well. It can't be more than 32 bytes without changes to how
596  * characters are stored.
597  */
598 #define UTF8_SIZE 21
599 struct utf8_data {
600 	u_char	data[UTF8_SIZE];
601 
602 	u_char	have;
603 	u_char	size;
604 
605 	u_char	width;	/* 0xff if invalid */
606 };
607 enum utf8_state {
608 	UTF8_MORE,
609 	UTF8_DONE,
610 	UTF8_ERROR
611 };
612 
613 /* Colour flags. */
614 #define COLOUR_FLAG_256 0x01000000
615 #define COLOUR_FLAG_RGB 0x02000000
616 
617 /* Special colours. */
618 #define COLOUR_DEFAULT(c) ((c) == 8 || (c) == 9)
619 
620 /* Replacement palette. */
621 struct colour_palette {
622 	int	 fg;
623 	int	 bg;
624 
625 	int	*palette;
626 	int	*default_palette;
627 };
628 
629 /* Grid attributes. Anything above 0xff is stored in an extended cell. */
630 #define GRID_ATTR_BRIGHT 0x1
631 #define GRID_ATTR_DIM 0x2
632 #define GRID_ATTR_UNDERSCORE 0x4
633 #define GRID_ATTR_BLINK 0x8
634 #define GRID_ATTR_REVERSE 0x10
635 #define GRID_ATTR_HIDDEN 0x20
636 #define GRID_ATTR_ITALICS 0x40
637 #define GRID_ATTR_CHARSET 0x80	/* alternative character set */
638 #define GRID_ATTR_STRIKETHROUGH 0x100
639 #define GRID_ATTR_UNDERSCORE_2 0x200
640 #define GRID_ATTR_UNDERSCORE_3 0x400
641 #define GRID_ATTR_UNDERSCORE_4 0x800
642 #define GRID_ATTR_UNDERSCORE_5 0x1000
643 #define GRID_ATTR_OVERLINE 0x2000
644 
645 /* All underscore attributes. */
646 #define GRID_ATTR_ALL_UNDERSCORE \
647 	(GRID_ATTR_UNDERSCORE|	 \
648 	 GRID_ATTR_UNDERSCORE_2| \
649 	 GRID_ATTR_UNDERSCORE_3| \
650 	 GRID_ATTR_UNDERSCORE_4| \
651 	 GRID_ATTR_UNDERSCORE_5)
652 
653 /* Grid flags. */
654 #define GRID_FLAG_FG256 0x1
655 #define GRID_FLAG_BG256 0x2
656 #define GRID_FLAG_PADDING 0x4
657 #define GRID_FLAG_EXTENDED 0x8
658 #define GRID_FLAG_SELECTED 0x10
659 #define GRID_FLAG_NOPALETTE 0x20
660 #define GRID_FLAG_CLEARED 0x40
661 
662 /* Grid line flags. */
663 #define GRID_LINE_WRAPPED 0x1
664 #define GRID_LINE_EXTENDED 0x2
665 #define GRID_LINE_DEAD 0x4
666 
667 #define CELL_INSIDE 0
668 #define CELL_TOPBOTTOM 1
669 #define CELL_LEFTRIGHT 2
670 #define CELL_TOPLEFT 3
671 #define CELL_TOPRIGHT 4
672 #define CELL_BOTTOMLEFT 5
673 #define CELL_BOTTOMRIGHT 6
674 #define CELL_TOPJOIN 7
675 #define CELL_BOTTOMJOIN 8
676 #define CELL_LEFTJOIN 9
677 #define CELL_RIGHTJOIN 10
678 #define CELL_JOIN 11
679 #define CELL_OUTSIDE 12
680 
681 #define CELL_BORDERS " xqlkmjwvtun~"
682 #define SIMPLE_BORDERS " |-+++++++++."
683 #define PADDED_BORDERS "             "
684 
685 /* Grid cell data. */
686 struct grid_cell {
687 	struct utf8_data	data;
688 	u_short			attr;
689 	u_char			flags;
690 	int			fg;
691 	int			bg;
692 	int			us;
693 };
694 
695 /* Grid extended cell entry. */
696 struct grid_extd_entry {
697 	utf8_char		data;
698 	u_short			attr;
699 	u_char			flags;
700 	int			fg;
701 	int			bg;
702 	int			us;
703 } __packed;
704 
705 /* Grid cell entry. */
706 struct grid_cell_entry {
707 	u_char			flags;
708 	union {
709 		u_int		offset;
710 		struct {
711 			u_char	attr;
712 			u_char	fg;
713 			u_char	bg;
714 			u_char	data;
715 		} data;
716 	};
717 } __packed;
718 
719 /* Grid line. */
720 struct grid_line {
721 	struct grid_cell_entry	*celldata;
722 	u_int			 cellused;
723 	u_int			 cellsize;
724 
725 	struct grid_extd_entry	*extddata;
726 	u_int			 extdsize;
727 
728 	int			 flags;
729 };
730 
731 /* Entire grid of cells. */
732 struct grid {
733 	int			 flags;
734 #define GRID_HISTORY 0x1 /* scroll lines into history */
735 
736 	u_int			 sx;
737 	u_int			 sy;
738 
739 	u_int			 hscrolled;
740 	u_int			 hsize;
741 	u_int			 hlimit;
742 
743 	struct grid_line	*linedata;
744 };
745 
746 /* Virtual cursor in a grid. */
747 struct grid_reader {
748 	struct grid	*gd;
749 	u_int		 cx;
750 	u_int		 cy;
751 };
752 
753 /* Style alignment. */
754 enum style_align {
755 	STYLE_ALIGN_DEFAULT,
756 	STYLE_ALIGN_LEFT,
757 	STYLE_ALIGN_CENTRE,
758 	STYLE_ALIGN_RIGHT,
759 	STYLE_ALIGN_ABSOLUTE_CENTRE
760 };
761 
762 /* Style list. */
763 enum style_list {
764 	STYLE_LIST_OFF,
765 	STYLE_LIST_ON,
766 	STYLE_LIST_FOCUS,
767 	STYLE_LIST_LEFT_MARKER,
768 	STYLE_LIST_RIGHT_MARKER,
769 };
770 
771 /* Style range. */
772 enum style_range_type {
773 	STYLE_RANGE_NONE,
774 	STYLE_RANGE_LEFT,
775 	STYLE_RANGE_RIGHT,
776 	STYLE_RANGE_WINDOW
777 };
778 struct style_range {
779 	enum style_range_type	 type;
780 	u_int			 argument;
781 
782 	u_int			 start;
783 	u_int			 end; /* not included */
784 
785 	TAILQ_ENTRY(style_range) entry;
786 };
787 TAILQ_HEAD(style_ranges, style_range);
788 
789 /* Style default. */
790 enum style_default_type {
791 	STYLE_DEFAULT_BASE,
792 	STYLE_DEFAULT_PUSH,
793 	STYLE_DEFAULT_POP
794 };
795 
796 /* Style option. */
797 struct style {
798 	struct grid_cell	gc;
799 	int			ignore;
800 
801 	int			fill;
802 	enum style_align	align;
803 	enum style_list		list;
804 
805 	enum style_range_type	range_type;
806 	u_int			range_argument;
807 
808 	enum style_default_type	default_type;
809 };
810 
811 /* Cursor style. */
812 enum screen_cursor_style {
813 	SCREEN_CURSOR_DEFAULT,
814 	SCREEN_CURSOR_BLOCK,
815 	SCREEN_CURSOR_UNDERLINE,
816 	SCREEN_CURSOR_BAR
817 };
818 
819 /* Virtual screen. */
820 struct screen_sel;
821 struct screen_titles;
822 struct screen {
823 	char				*title;
824 	char				*path;
825 	struct screen_titles		*titles;
826 
827 	struct grid			*grid;	  /* grid data */
828 
829 	u_int				 cx;	  /* cursor x */
830 	u_int				 cy;	  /* cursor y */
831 
832 	enum screen_cursor_style	 cstyle;  /* cursor style */
833 	enum screen_cursor_style	 default_cstyle;
834 	int				 ccolour; /* cursor colour */
835 	int				 default_ccolour;
836 
837 	u_int				 rupper;  /* scroll region top */
838 	u_int				 rlower;  /* scroll region bottom */
839 
840 	int				 mode;
841 	int				 default_mode;
842 
843 	u_int				 saved_cx;
844 	u_int				 saved_cy;
845 	struct grid			*saved_grid;
846 	struct grid_cell		 saved_cell;
847 	int				 saved_flags;
848 
849 	bitstr_t			*tabs;
850 	struct screen_sel		*sel;
851 
852 	struct screen_write_cline	*write_list;
853 };
854 
855 /* Screen write context. */
856 typedef void (*screen_write_init_ctx_cb)(struct screen_write_ctx *,
857     struct tty_ctx *);
858 struct screen_write_ctx {
859 	struct window_pane		*wp;
860 	struct screen			*s;
861 
862 	int				 flags;
863 #define SCREEN_WRITE_SYNC 0x1
864 #define SCREEN_WRITE_ZWJ 0x2
865 
866 	screen_write_init_ctx_cb	 init_ctx_cb;
867 	void				*arg;
868 
869 	struct screen_write_citem	*item;
870 	u_int				 scrolled;
871 	u_int				 bg;
872 };
873 
874 /* Box border lines option. */
875 enum box_lines {
876 	BOX_LINES_DEFAULT = -1,
877 	BOX_LINES_SINGLE,
878 	BOX_LINES_DOUBLE,
879 	BOX_LINES_HEAVY,
880 	BOX_LINES_SIMPLE,
881 	BOX_LINES_ROUNDED,
882 	BOX_LINES_PADDED,
883 	BOX_LINES_NONE
884 };
885 
886 /* Pane border lines option. */
887 enum pane_lines {
888 	PANE_LINES_SINGLE,
889 	PANE_LINES_DOUBLE,
890 	PANE_LINES_HEAVY,
891 	PANE_LINES_SIMPLE,
892 	PANE_LINES_NUMBER
893 };
894 
895 /* Pane border indicator option. */
896 #define PANE_BORDER_OFF 0
897 #define PANE_BORDER_COLOUR 1
898 #define PANE_BORDER_ARROWS 2
899 #define PANE_BORDER_BOTH 3
900 
901 /* Screen redraw context. */
902 struct screen_redraw_ctx {
903 	struct client	*c;
904 
905 	u_int		 statuslines;
906 	int		 statustop;
907 
908 	int		 pane_status;
909 	enum pane_lines	 pane_lines;
910 
911 	struct grid_cell no_pane_gc;
912 	int		 no_pane_gc_set;
913 
914 	u_int		 sx;
915 	u_int		 sy;
916 	u_int		 ox;
917 	u_int		 oy;
918 };
919 
920 /* Screen size. */
921 #define screen_size_x(s) ((s)->grid->sx)
922 #define screen_size_y(s) ((s)->grid->sy)
923 #define screen_hsize(s) ((s)->grid->hsize)
924 #define screen_hlimit(s) ((s)->grid->hlimit)
925 
926 /* Menu. */
927 struct menu_item {
928 	const char	*name;
929 	key_code	 key;
930 	const char	*command;
931 };
932 struct menu {
933 	const char		*title;
934 	struct menu_item	*items;
935 	u_int			 count;
936 	u_int			 width;
937 };
938 typedef void (*menu_choice_cb)(struct menu *, u_int, key_code, void *);
939 
940 /*
941  * Window mode. Windows can be in several modes and this is used to call the
942  * right function to handle input and output.
943  */
944 struct window_mode_entry;
945 struct window_mode {
946 	const char	*name;
947 	const char	*default_format;
948 
949 	struct screen	*(*init)(struct window_mode_entry *,
950 			     struct cmd_find_state *, struct args *);
951 	void		 (*free)(struct window_mode_entry *);
952 	void		 (*resize)(struct window_mode_entry *, u_int, u_int);
953 	void		 (*update)(struct window_mode_entry *);
954 	void		 (*key)(struct window_mode_entry *, struct client *,
955 			     struct session *, struct winlink *, key_code,
956 			     struct mouse_event *);
957 
958 	const char	*(*key_table)(struct window_mode_entry *);
959 	void		 (*command)(struct window_mode_entry *, struct client *,
960 			     struct session *, struct winlink *, struct args *,
961 			     struct mouse_event *);
962 	void		 (*formats)(struct window_mode_entry *,
963 			     struct format_tree *);
964 };
965 
966 /* Active window mode. */
967 struct window_mode_entry {
968 	struct window_pane		*wp;
969 	struct window_pane		*swp;
970 
971 	const struct window_mode	*mode;
972 	void				*data;
973 
974 	struct screen			*screen;
975 	u_int				 prefix;
976 
977 	TAILQ_ENTRY(window_mode_entry)	 entry;
978 };
979 
980 /* Offsets into pane buffer. */
981 struct window_pane_offset {
982 	size_t	used;
983 };
984 
985 /* Queued pane resize. */
986 struct window_pane_resize {
987 	u_int				sx;
988 	u_int				sy;
989 
990 	u_int				osx;
991 	u_int				osy;
992 
993 	TAILQ_ENTRY(window_pane_resize)	entry;
994 };
995 TAILQ_HEAD(window_pane_resizes, window_pane_resize);
996 
997 /* Child window structure. */
998 struct window_pane {
999 	u_int		 id;
1000 	u_int		 active_point;
1001 
1002 	struct window	*window;
1003 	struct options	*options;
1004 
1005 	struct layout_cell *layout_cell;
1006 	struct layout_cell *saved_layout_cell;
1007 
1008 	u_int		 sx;
1009 	u_int		 sy;
1010 
1011 	u_int		 xoff;
1012 	u_int		 yoff;
1013 
1014 	int		 flags;
1015 #define PANE_REDRAW 0x1
1016 #define PANE_DROP 0x2
1017 #define PANE_FOCUSED 0x4
1018 /* 0x8 unused */
1019 /* 0x10 unused */
1020 /* 0x20 unused */
1021 #define PANE_INPUTOFF 0x40
1022 #define PANE_CHANGED 0x80
1023 #define PANE_EXITED 0x100
1024 #define PANE_STATUSREADY 0x200
1025 #define PANE_STATUSDRAWN 0x400
1026 #define PANE_EMPTY 0x800
1027 #define PANE_STYLECHANGED 0x1000
1028 
1029 	int		 argc;
1030 	char	       **argv;
1031 	char		*shell;
1032 	char		*cwd;
1033 
1034 	pid_t		 pid;
1035 	char		 tty[TTY_NAME_MAX];
1036 	int		 status;
1037 	struct timeval	 dead_time;
1038 
1039 	int		 fd;
1040 	struct bufferevent *event;
1041 
1042 	struct window_pane_offset offset;
1043 	size_t		 base_offset;
1044 
1045 	struct window_pane_resizes resize_queue;
1046 	struct event	 resize_timer;
1047 
1048 	struct input_ctx *ictx;
1049 
1050 	struct grid_cell cached_gc;
1051 	struct grid_cell cached_active_gc;
1052 	struct colour_palette palette;
1053 
1054 	int		 pipe_fd;
1055 	struct bufferevent *pipe_event;
1056 	struct window_pane_offset pipe_offset;
1057 
1058 	struct screen	*screen;
1059 	struct screen	 base;
1060 
1061 	struct screen	 status_screen;
1062 	size_t		 status_size;
1063 
1064 	TAILQ_HEAD(, window_mode_entry) modes;
1065 
1066 	char		*searchstr;
1067 	int		 searchregex;
1068 
1069 	int		 border_gc_set;
1070 	struct grid_cell border_gc;
1071 
1072 	TAILQ_ENTRY(window_pane) entry;
1073 	RB_ENTRY(window_pane) tree_entry;
1074 };
1075 TAILQ_HEAD(window_panes, window_pane);
1076 RB_HEAD(window_pane_tree, window_pane);
1077 
1078 /* Window structure. */
1079 struct window {
1080 	u_int			 id;
1081 	void			*latest;
1082 
1083 	char			*name;
1084 	struct event		 name_event;
1085 	struct timeval		 name_time;
1086 
1087 	struct event		 alerts_timer;
1088 	struct event		 offset_timer;
1089 
1090 	struct timeval		 activity_time;
1091 
1092 	struct window_pane	*active;
1093 	struct window_pane	*last;
1094 	struct window_panes	 panes;
1095 
1096 	int			 lastlayout;
1097 	struct layout_cell	*layout_root;
1098 	struct layout_cell	*saved_layout_root;
1099 	char			*old_layout;
1100 
1101 	u_int			 sx;
1102 	u_int			 sy;
1103 	u_int			 manual_sx;
1104 	u_int			 manual_sy;
1105 	u_int			 xpixel;
1106 	u_int			 ypixel;
1107 
1108 	u_int			 new_sx;
1109 	u_int			 new_sy;
1110 	u_int			 new_xpixel;
1111 	u_int			 new_ypixel;
1112 
1113 	struct utf8_data	*fill_character;
1114 	int			 flags;
1115 #define WINDOW_BELL 0x1
1116 #define WINDOW_ACTIVITY 0x2
1117 #define WINDOW_SILENCE 0x4
1118 #define WINDOW_ZOOMED 0x8
1119 #define WINDOW_WASZOOMED 0x10
1120 #define WINDOW_RESIZE 0x20
1121 #define WINDOW_ALERTFLAGS (WINDOW_BELL|WINDOW_ACTIVITY|WINDOW_SILENCE)
1122 
1123 	int			 alerts_queued;
1124 	TAILQ_ENTRY(window)	 alerts_entry;
1125 
1126 	struct options		*options;
1127 
1128 	u_int			 references;
1129 	TAILQ_HEAD(, winlink)	 winlinks;
1130 
1131 	RB_ENTRY(window)	 entry;
1132 };
1133 RB_HEAD(windows, window);
1134 
1135 /* Entry on local window list. */
1136 struct winlink {
1137 	int		 idx;
1138 	struct session	*session;
1139 	struct window	*window;
1140 
1141 	int		 flags;
1142 #define WINLINK_BELL 0x1
1143 #define WINLINK_ACTIVITY 0x2
1144 #define WINLINK_SILENCE 0x4
1145 #define WINLINK_ALERTFLAGS (WINLINK_BELL|WINLINK_ACTIVITY|WINLINK_SILENCE)
1146 
1147 	RB_ENTRY(winlink) entry;
1148 	TAILQ_ENTRY(winlink) wentry;
1149 	TAILQ_ENTRY(winlink) sentry;
1150 };
1151 RB_HEAD(winlinks, winlink);
1152 TAILQ_HEAD(winlink_stack, winlink);
1153 
1154 /* Window size option. */
1155 #define WINDOW_SIZE_LARGEST 0
1156 #define WINDOW_SIZE_SMALLEST 1
1157 #define WINDOW_SIZE_MANUAL 2
1158 #define WINDOW_SIZE_LATEST 3
1159 
1160 /* Pane border status option. */
1161 #define PANE_STATUS_OFF 0
1162 #define PANE_STATUS_TOP 1
1163 #define PANE_STATUS_BOTTOM 2
1164 
1165 /* Layout direction. */
1166 enum layout_type {
1167 	LAYOUT_LEFTRIGHT,
1168 	LAYOUT_TOPBOTTOM,
1169 	LAYOUT_WINDOWPANE
1170 };
1171 
1172 /* Layout cells queue. */
1173 TAILQ_HEAD(layout_cells, layout_cell);
1174 
1175 /* Layout cell. */
1176 struct layout_cell {
1177 	enum layout_type type;
1178 
1179 	struct layout_cell *parent;
1180 
1181 	u_int		 sx;
1182 	u_int		 sy;
1183 
1184 	u_int		 xoff;
1185 	u_int		 yoff;
1186 
1187 	struct window_pane *wp;
1188 	struct layout_cells cells;
1189 
1190 	TAILQ_ENTRY(layout_cell) entry;
1191 };
1192 
1193 /* Environment variable. */
1194 struct environ_entry {
1195 	char		*name;
1196 	char		*value;
1197 
1198 	int		 flags;
1199 #define ENVIRON_HIDDEN 0x1
1200 
1201 	RB_ENTRY(environ_entry) entry;
1202 };
1203 
1204 /* Client session. */
1205 struct session_group {
1206 	const char		*name;
1207 	TAILQ_HEAD(, session)	 sessions;
1208 
1209 	RB_ENTRY(session_group)	 entry;
1210 };
1211 RB_HEAD(session_groups, session_group);
1212 
1213 struct session {
1214 	u_int		 id;
1215 
1216 	char		*name;
1217 	const char	*cwd;
1218 
1219 	struct timeval	 creation_time;
1220 	struct timeval	 last_attached_time;
1221 	struct timeval	 activity_time;
1222 	struct timeval	 last_activity_time;
1223 
1224 	struct event	 lock_timer;
1225 
1226 	struct winlink	*curw;
1227 	struct winlink_stack lastw;
1228 	struct winlinks	 windows;
1229 
1230 	int		 statusat;
1231 	u_int		 statuslines;
1232 
1233 	struct options	*options;
1234 
1235 #define SESSION_PASTING 0x1
1236 #define SESSION_ALERTED 0x2
1237 	int		 flags;
1238 
1239 	u_int		 attached;
1240 
1241 	struct termios	*tio;
1242 
1243 	struct environ	*environ;
1244 
1245 	int		 references;
1246 
1247 	TAILQ_ENTRY(session) gentry;
1248 	RB_ENTRY(session)    entry;
1249 };
1250 RB_HEAD(sessions, session);
1251 
1252 /* Mouse button masks. */
1253 #define MOUSE_MASK_BUTTONS 195
1254 #define MOUSE_MASK_SHIFT 4
1255 #define MOUSE_MASK_META 8
1256 #define MOUSE_MASK_CTRL 16
1257 #define MOUSE_MASK_DRAG 32
1258 #define MOUSE_MASK_MODIFIERS (MOUSE_MASK_SHIFT|MOUSE_MASK_META|MOUSE_MASK_CTRL)
1259 
1260 /* Mouse wheel type. */
1261 #define MOUSE_WHEEL_UP 64
1262 #define MOUSE_WHEEL_DOWN 65
1263 
1264 /* Mouse button type. */
1265 #define MOUSE_BUTTON_1 0
1266 #define MOUSE_BUTTON_2 1
1267 #define MOUSE_BUTTON_3 2
1268 #define MOUSE_BUTTON_6 66
1269 #define MOUSE_BUTTON_7 67
1270 #define MOUSE_BUTTON_8 128
1271 #define MOUSE_BUTTON_9 129
1272 #define MOUSE_BUTTON_10 130
1273 #define MOUSE_BUTTON_11 131
1274 
1275 /* Mouse helpers. */
1276 #define MOUSE_BUTTONS(b) ((b) & MOUSE_MASK_BUTTONS)
1277 #define MOUSE_WHEEL(b) \
1278 	(((b) & MOUSE_MASK_BUTTONS) == MOUSE_WHEEL_UP || \
1279 	 ((b) & MOUSE_MASK_BUTTONS) == MOUSE_WHEEL_DOWN)
1280 #define MOUSE_DRAG(b) ((b) & MOUSE_MASK_DRAG)
1281 #define MOUSE_RELEASE(b) (((b) & MOUSE_MASK_BUTTONS) == 3)
1282 
1283 /* Mouse input. */
1284 struct mouse_event {
1285 	int		valid;
1286 	int		ignore;
1287 
1288 	key_code	key;
1289 
1290 	int		statusat;
1291 	u_int		statuslines;
1292 
1293 	u_int		x;
1294 	u_int		y;
1295 	u_int		b;
1296 
1297 	u_int		lx;
1298 	u_int		ly;
1299 	u_int		lb;
1300 
1301 	u_int		ox;
1302 	u_int		oy;
1303 
1304 	int		s;
1305 	int		w;
1306 	int		wp;
1307 
1308 	u_int		sgr_type;
1309 	u_int		sgr_b;
1310 };
1311 
1312 /* Key event. */
1313 struct key_event {
1314 	key_code		key;
1315 	struct mouse_event	m;
1316 };
1317 
1318 /* Terminal definition. */
1319 struct tty_term {
1320 	char		*name;
1321 	struct tty	*tty;
1322 	int		 features;
1323 
1324 	char		 acs[UCHAR_MAX + 1][2];
1325 
1326 	struct tty_code	*codes;
1327 
1328 #define TERM_256COLOURS 0x1
1329 #define TERM_NOAM 0x2
1330 #define TERM_DECSLRM 0x4
1331 #define TERM_DECFRA 0x8
1332 #define TERM_RGBCOLOURS 0x10
1333 #define TERM_VT100LIKE 0x20
1334 	int		 flags;
1335 
1336 	LIST_ENTRY(tty_term) entry;
1337 };
1338 LIST_HEAD(tty_terms, tty_term);
1339 
1340 /* Client terminal. */
1341 struct tty {
1342 	struct client	*client;
1343 	struct event	 start_timer;
1344 	struct event	 clipboard_timer;
1345 
1346 	u_int		 sx;
1347 	u_int		 sy;
1348 	u_int		 xpixel;
1349 	u_int		 ypixel;
1350 
1351 	u_int		 cx;
1352 	u_int		 cy;
1353 	enum screen_cursor_style cstyle;
1354 	int		 ccolour;
1355 
1356 	int		 oflag;
1357 	u_int		 oox;
1358 	u_int		 ooy;
1359 	u_int		 osx;
1360 	u_int		 osy;
1361 
1362 	int		 mode;
1363 
1364 	u_int		 rlower;
1365 	u_int		 rupper;
1366 
1367 	u_int		 rleft;
1368 	u_int		 rright;
1369 
1370 	struct event	 event_in;
1371 	struct evbuffer	*in;
1372 	struct event	 event_out;
1373 	struct evbuffer	*out;
1374 	struct event	 timer;
1375 	size_t		 discarded;
1376 
1377 	struct termios	 tio;
1378 
1379 	struct grid_cell cell;
1380 	struct grid_cell last_cell;
1381 
1382 #define TTY_NOCURSOR 0x1
1383 #define TTY_FREEZE 0x2
1384 #define TTY_TIMER 0x4
1385 #define TTY_NOBLOCK 0x8
1386 #define TTY_STARTED 0x10
1387 #define TTY_OPENED 0x20
1388 #define TTY_OSC52QUERY 0x40
1389 #define TTY_BLOCK 0x80
1390 #define TTY_HAVEDA 0x100
1391 #define TTY_HAVEXDA 0x200
1392 #define TTY_SYNCING 0x400
1393 	int		 flags;
1394 
1395 	struct tty_term	*term;
1396 
1397 	u_int		 mouse_last_x;
1398 	u_int		 mouse_last_y;
1399 	u_int		 mouse_last_b;
1400 	int		 mouse_drag_flag;
1401 	void		(*mouse_drag_update)(struct client *,
1402 			    struct mouse_event *);
1403 	void		(*mouse_drag_release)(struct client *,
1404 			    struct mouse_event *);
1405 
1406 	struct event	 key_timer;
1407 	struct tty_key	*key_tree;
1408 };
1409 
1410 /* Terminal command context. */
1411 typedef void (*tty_ctx_redraw_cb)(const struct tty_ctx *);
1412 typedef int (*tty_ctx_set_client_cb)(struct tty_ctx *, struct client *);
1413 struct tty_ctx {
1414 	struct screen		*s;
1415 
1416 	tty_ctx_redraw_cb	 redraw_cb;
1417 	tty_ctx_set_client_cb	 set_client_cb;
1418 	void			*arg;
1419 
1420 	const struct grid_cell	*cell;
1421 	int			 wrapped;
1422 
1423 	u_int			 num;
1424 	void			*ptr;
1425 
1426 	/*
1427 	 * Cursor and region position before the screen was updated - this is
1428 	 * where the command should be applied; the values in the screen have
1429 	 * already been updated.
1430 	 */
1431 	u_int		 ocx;
1432 	u_int		 ocy;
1433 
1434 	u_int		 orupper;
1435 	u_int		 orlower;
1436 
1437 	/* Target region (usually pane) offset and size. */
1438 	u_int		 xoff;
1439 	u_int		 yoff;
1440 	u_int		 rxoff;
1441 	u_int		 ryoff;
1442 	u_int		 sx;
1443 	u_int		 sy;
1444 
1445 	/* The background colour used for clearing (erasing). */
1446 	u_int		 bg;
1447 
1448 	/* The default colours and palette. */
1449 	struct grid_cell defaults;
1450 	struct colour_palette *palette;
1451 
1452 	/* Containing region (usually window) offset and size. */
1453 	int		 bigger;
1454 	u_int		 wox;
1455 	u_int		 woy;
1456 	u_int		 wsx;
1457 	u_int		 wsy;
1458 };
1459 
1460 /* Saved message entry. */
1461 struct message_entry {
1462 	char				*msg;
1463 	u_int				 msg_num;
1464 	struct timeval			 msg_time;
1465 
1466 	TAILQ_ENTRY(message_entry)	 entry;
1467 };
1468 TAILQ_HEAD(message_list, message_entry);
1469 
1470 /* Argument type. */
1471 enum args_type {
1472 	ARGS_NONE,
1473 	ARGS_STRING,
1474 	ARGS_COMMANDS
1475 };
1476 
1477 /* Argument value. */
1478 struct args_value {
1479 	enum args_type		 type;
1480 	union {
1481 		char		*string;
1482 		struct cmd_list	*cmdlist;
1483 	};
1484 	char			*cached;
1485 	TAILQ_ENTRY(args_value)	 entry;
1486 };
1487 
1488 /* Arguments set. */
1489 struct args_entry;
1490 RB_HEAD(args_tree, args_entry);
1491 
1492 /* Arguments parsing type. */
1493 enum args_parse_type {
1494 	ARGS_PARSE_INVALID,
1495 	ARGS_PARSE_STRING,
1496 	ARGS_PARSE_COMMANDS_OR_STRING,
1497 	ARGS_PARSE_COMMANDS
1498 };
1499 
1500 /* Arguments parsing state. */
1501 typedef enum args_parse_type (*args_parse_cb)(struct args *, u_int, char **);
1502 struct args_parse {
1503 	const char	*template;
1504 	int		 lower;
1505 	int		 upper;
1506 	args_parse_cb	 cb;
1507 };
1508 
1509 /* Command find structures. */
1510 enum cmd_find_type {
1511 	CMD_FIND_PANE,
1512 	CMD_FIND_WINDOW,
1513 	CMD_FIND_SESSION,
1514 };
1515 struct cmd_find_state {
1516 	int			 flags;
1517 	struct cmd_find_state	*current;
1518 
1519 	struct session		*s;
1520 	struct winlink		*wl;
1521 	struct window		*w;
1522 	struct window_pane	*wp;
1523 	int			 idx;
1524 };
1525 
1526 /* Command find flags. */
1527 #define CMD_FIND_PREFER_UNATTACHED 0x1
1528 #define CMD_FIND_QUIET 0x2
1529 #define CMD_FIND_WINDOW_INDEX 0x4
1530 #define CMD_FIND_DEFAULT_MARKED 0x8
1531 #define CMD_FIND_EXACT_SESSION 0x10
1532 #define CMD_FIND_EXACT_WINDOW 0x20
1533 #define CMD_FIND_CANFAIL 0x40
1534 
1535 /* List of commands. */
1536 struct cmd_list {
1537 	int		 references;
1538 	u_int		 group;
1539 	struct cmds	*list;
1540 };
1541 
1542 /* Command return values. */
1543 enum cmd_retval {
1544 	CMD_RETURN_ERROR = -1,
1545 	CMD_RETURN_NORMAL = 0,
1546 	CMD_RETURN_WAIT,
1547 	CMD_RETURN_STOP
1548 };
1549 
1550 /* Command parse result. */
1551 enum cmd_parse_status {
1552 	CMD_PARSE_ERROR,
1553 	CMD_PARSE_SUCCESS
1554 };
1555 struct cmd_parse_result {
1556 	enum cmd_parse_status	 status;
1557 	struct cmd_list		*cmdlist;
1558 	char			*error;
1559 };
1560 struct cmd_parse_input {
1561 	int			 flags;
1562 #define CMD_PARSE_QUIET 0x1
1563 #define CMD_PARSE_PARSEONLY 0x2
1564 #define CMD_PARSE_NOALIAS 0x4
1565 #define CMD_PARSE_VERBOSE 0x8
1566 #define CMD_PARSE_ONEGROUP 0x10
1567 
1568 	const char		*file;
1569 	u_int			 line;
1570 
1571 	struct cmdq_item	*item;
1572 	struct client		*c;
1573 	struct cmd_find_state	 fs;
1574 };
1575 
1576 /* Command queue flags. */
1577 #define CMDQ_STATE_REPEAT 0x1
1578 #define CMDQ_STATE_CONTROL 0x2
1579 #define CMDQ_STATE_NOHOOKS 0x4
1580 
1581 /* Command queue callback. */
1582 typedef enum cmd_retval (*cmdq_cb) (struct cmdq_item *, void *);
1583 
1584 /* Command definition flag. */
1585 struct cmd_entry_flag {
1586 	char			 flag;
1587 	enum cmd_find_type	 type;
1588 	int			 flags;
1589 };
1590 
1591 /* Command definition. */
1592 struct cmd_entry {
1593 	const char		*name;
1594 	const char		*alias;
1595 
1596 	struct args_parse	 args;
1597 	const char		*usage;
1598 
1599 	struct cmd_entry_flag	 source;
1600 	struct cmd_entry_flag	 target;
1601 
1602 #define CMD_STARTSERVER 0x1
1603 #define CMD_READONLY 0x2
1604 #define CMD_AFTERHOOK 0x4
1605 #define CMD_CLIENT_CFLAG 0x8
1606 #define CMD_CLIENT_TFLAG 0x10
1607 #define CMD_CLIENT_CANFAIL 0x20
1608 	int		 flags;
1609 
1610 	enum cmd_retval	 (*exec)(struct cmd *, struct cmdq_item *);
1611 };
1612 
1613 /* Status line. */
1614 #define STATUS_LINES_LIMIT 5
1615 struct status_line_entry {
1616 	char			*expanded;
1617 	struct style_ranges	 ranges;
1618 };
1619 struct status_line {
1620 	struct event		 timer;
1621 
1622 	struct screen		 screen;
1623 	struct screen		*active;
1624 	int			 references;
1625 
1626 	struct grid_cell	 style;
1627 	struct status_line_entry entries[STATUS_LINES_LIMIT];
1628 };
1629 
1630 /* Prompt type. */
1631 #define PROMPT_NTYPES 4
1632 enum prompt_type {
1633 	PROMPT_TYPE_COMMAND,
1634 	PROMPT_TYPE_SEARCH,
1635 	PROMPT_TYPE_TARGET,
1636 	PROMPT_TYPE_WINDOW_TARGET,
1637 	PROMPT_TYPE_INVALID = 0xff
1638 };
1639 
1640 /* File in client. */
1641 typedef void (*client_file_cb) (struct client *, const char *, int, int,
1642     struct evbuffer *, void *);
1643 struct client_file {
1644 	struct client			*c;
1645 	struct tmuxpeer			*peer;
1646 	struct client_files		*tree;
1647 	int				 references;
1648 	int				 stream;
1649 
1650 	char				*path;
1651 	struct evbuffer			*buffer;
1652 	struct bufferevent		*event;
1653 
1654 	int				 fd;
1655 	int				 error;
1656 	int				 closed;
1657 
1658 	client_file_cb			 cb;
1659 	void				*data;
1660 
1661 	RB_ENTRY(client_file)		 entry;
1662 };
1663 RB_HEAD(client_files, client_file);
1664 
1665 /* Client window. */
1666 struct client_window {
1667 	u_int			 window;
1668 	struct window_pane	*pane;
1669 
1670 	u_int			 sx;
1671 	u_int			 sy;
1672 
1673 	RB_ENTRY(client_window)	 entry;
1674 };
1675 RB_HEAD(client_windows, client_window);
1676 
1677 /* Visible areas not obstructed by overlays. */
1678 #define OVERLAY_MAX_RANGES 3
1679 struct overlay_ranges {
1680 	u_int	px[OVERLAY_MAX_RANGES];
1681 	u_int	nx[OVERLAY_MAX_RANGES];
1682 };
1683 
1684 /* Client connection. */
1685 typedef int (*prompt_input_cb)(struct client *, void *, const char *, int);
1686 typedef void (*prompt_free_cb)(void *);
1687 typedef void (*overlay_check_cb)(struct client*, void *, u_int, u_int, u_int,
1688 	    struct overlay_ranges *);
1689 typedef struct screen *(*overlay_mode_cb)(struct client *, void *, u_int *,
1690 	    u_int *);
1691 typedef void (*overlay_draw_cb)(struct client *, void *,
1692 	    struct screen_redraw_ctx *);
1693 typedef int (*overlay_key_cb)(struct client *, void *, struct key_event *);
1694 typedef void (*overlay_free_cb)(struct client *, void *);
1695 typedef void (*overlay_resize_cb)(struct client *, void *);
1696 struct client {
1697 	const char		*name;
1698 	struct tmuxpeer		*peer;
1699 	struct cmdq_list	*queue;
1700 
1701 	struct client_windows	 windows;
1702 
1703 	struct control_state	*control_state;
1704 	u_int			 pause_age;
1705 
1706 	pid_t			 pid;
1707 	int			 fd;
1708 	int			 out_fd;
1709 	struct event		 event;
1710 	int			 retval;
1711 
1712 	struct timeval		 creation_time;
1713 	struct timeval		 activity_time;
1714 
1715 	struct environ		*environ;
1716 	struct format_job_tree	*jobs;
1717 
1718 	char			*title;
1719 	char			*path;
1720 	const char		*cwd;
1721 
1722 	char			*term_name;
1723 	int			 term_features;
1724 	char			*term_type;
1725 	char		       **term_caps;
1726 	u_int			 term_ncaps;
1727 
1728 	char			*ttyname;
1729 	struct tty		 tty;
1730 
1731 	size_t			 written;
1732 	size_t			 discarded;
1733 	size_t			 redraw;
1734 
1735 	struct event		 repeat_timer;
1736 
1737 	struct event		 click_timer;
1738 	u_int			 click_button;
1739 	struct mouse_event	 click_event;
1740 
1741 	struct status_line	 status;
1742 
1743 #define CLIENT_TERMINAL 0x1
1744 #define CLIENT_LOGIN 0x2
1745 #define CLIENT_EXIT 0x4
1746 #define CLIENT_REDRAWWINDOW 0x8
1747 #define CLIENT_REDRAWSTATUS 0x10
1748 #define CLIENT_REPEAT 0x20
1749 #define CLIENT_SUSPENDED 0x40
1750 #define CLIENT_ATTACHED 0x80
1751 #define CLIENT_EXITED 0x100
1752 #define CLIENT_DEAD 0x200
1753 #define CLIENT_REDRAWBORDERS 0x400
1754 #define CLIENT_READONLY 0x800
1755 #define CLIENT_NOSTARTSERVER 0x1000
1756 #define CLIENT_CONTROL 0x2000
1757 #define CLIENT_CONTROLCONTROL 0x4000
1758 #define CLIENT_FOCUSED 0x8000
1759 #define CLIENT_UTF8 0x10000
1760 #define CLIENT_IGNORESIZE 0x20000
1761 #define CLIENT_IDENTIFIED 0x40000
1762 #define CLIENT_STATUSFORCE 0x80000
1763 #define CLIENT_DOUBLECLICK 0x100000
1764 #define CLIENT_TRIPLECLICK 0x200000
1765 #define CLIENT_SIZECHANGED 0x400000
1766 #define CLIENT_STATUSOFF 0x800000
1767 #define CLIENT_REDRAWSTATUSALWAYS 0x1000000
1768 #define CLIENT_REDRAWOVERLAY 0x2000000
1769 #define CLIENT_CONTROL_NOOUTPUT 0x4000000
1770 #define CLIENT_DEFAULTSOCKET 0x8000000
1771 #define CLIENT_STARTSERVER 0x10000000
1772 #define CLIENT_REDRAWPANES 0x20000000
1773 #define CLIENT_NOFORK 0x40000000
1774 #define CLIENT_ACTIVEPANE 0x80000000ULL
1775 #define CLIENT_CONTROL_PAUSEAFTER 0x100000000ULL
1776 #define CLIENT_CONTROL_WAITEXIT 0x200000000ULL
1777 #define CLIENT_WINDOWSIZECHANGED 0x400000000ULL
1778 #define CLIENT_CLIPBOARDBUFFER 0x800000000ULL
1779 #define CLIENT_ALLREDRAWFLAGS		\
1780 	(CLIENT_REDRAWWINDOW|		\
1781 	 CLIENT_REDRAWSTATUS|		\
1782 	 CLIENT_REDRAWSTATUSALWAYS|	\
1783 	 CLIENT_REDRAWBORDERS|		\
1784 	 CLIENT_REDRAWOVERLAY|		\
1785 	 CLIENT_REDRAWPANES)
1786 #define CLIENT_UNATTACHEDFLAGS	\
1787 	(CLIENT_DEAD|		\
1788 	 CLIENT_SUSPENDED|	\
1789 	 CLIENT_EXIT)
1790 #define CLIENT_NODETACHFLAGS	\
1791 	(CLIENT_DEAD|		\
1792 	 CLIENT_EXIT)
1793 #define CLIENT_NOSIZEFLAGS	\
1794 	(CLIENT_DEAD|		\
1795 	 CLIENT_SUSPENDED|	\
1796 	 CLIENT_EXIT)
1797 	uint64_t		 flags;
1798 
1799 	enum {
1800 		CLIENT_EXIT_RETURN,
1801 		CLIENT_EXIT_SHUTDOWN,
1802 		CLIENT_EXIT_DETACH
1803 	}			 exit_type;
1804 	enum msgtype		 exit_msgtype;
1805 	char			*exit_session;
1806 	char			*exit_message;
1807 
1808 	struct key_table	*keytable;
1809 
1810 	uint64_t		 redraw_panes;
1811 
1812 	int			 message_ignore_keys;
1813 	int			 message_ignore_styles;
1814 	char			*message_string;
1815 	struct event		 message_timer;
1816 
1817 	char			*prompt_string;
1818 	struct utf8_data	*prompt_buffer;
1819 	char			*prompt_last;
1820 	size_t			 prompt_index;
1821 	prompt_input_cb		 prompt_inputcb;
1822 	prompt_free_cb		 prompt_freecb;
1823 	void			*prompt_data;
1824 	u_int			 prompt_hindex[PROMPT_NTYPES];
1825 	enum {
1826 		PROMPT_ENTRY,
1827 		PROMPT_COMMAND
1828 	}			 prompt_mode;
1829 	struct utf8_data	*prompt_saved;
1830 #define PROMPT_SINGLE 0x1
1831 #define PROMPT_NUMERIC 0x2
1832 #define PROMPT_INCREMENTAL 0x4
1833 #define PROMPT_NOFORMAT 0x8
1834 #define PROMPT_KEY 0x10
1835 	int			 prompt_flags;
1836 	enum prompt_type	 prompt_type;
1837 	int			 prompt_cursor;
1838 
1839 	struct session		*session;
1840 	struct session		*last_session;
1841 
1842 	int			 references;
1843 
1844 	void			*pan_window;
1845 	u_int			 pan_ox;
1846 	u_int			 pan_oy;
1847 
1848 	overlay_check_cb	 overlay_check;
1849 	overlay_mode_cb		 overlay_mode;
1850 	overlay_draw_cb		 overlay_draw;
1851 	overlay_key_cb		 overlay_key;
1852 	overlay_free_cb		 overlay_free;
1853 	overlay_resize_cb	 overlay_resize;
1854 	void			*overlay_data;
1855 	struct event		 overlay_timer;
1856 
1857 	struct client_files	 files;
1858 
1859 	u_int			*clipboard_panes;
1860 	u_int			 clipboard_npanes;
1861 
1862 	TAILQ_ENTRY(client)	 entry;
1863 };
1864 TAILQ_HEAD(clients, client);
1865 
1866 /* Control mode subscription type. */
1867 enum control_sub_type {
1868 	CONTROL_SUB_SESSION,
1869 	CONTROL_SUB_PANE,
1870 	CONTROL_SUB_ALL_PANES,
1871 	CONTROL_SUB_WINDOW,
1872 	CONTROL_SUB_ALL_WINDOWS
1873 };
1874 
1875 /* Key binding and key table. */
1876 struct key_binding {
1877 	key_code		 key;
1878 	struct cmd_list		*cmdlist;
1879 	const char		*note;
1880 
1881 	int			 flags;
1882 #define KEY_BINDING_REPEAT 0x1
1883 
1884 	RB_ENTRY(key_binding)	 entry;
1885 };
1886 RB_HEAD(key_bindings, key_binding);
1887 
1888 struct key_table {
1889 	const char		*name;
1890 	struct key_bindings	 key_bindings;
1891 	struct key_bindings	 default_key_bindings;
1892 
1893 	u_int			 references;
1894 
1895 	RB_ENTRY(key_table)	 entry;
1896 };
1897 RB_HEAD(key_tables, key_table);
1898 
1899 /* Option data. */
1900 RB_HEAD(options_array, options_array_item);
1901 union options_value {
1902 	char			*string;
1903 	long long		 number;
1904 	struct style		 style;
1905 	struct options_array	 array;
1906 	struct cmd_list		*cmdlist;
1907 };
1908 
1909 /* Option table entries. */
1910 enum options_table_type {
1911 	OPTIONS_TABLE_STRING,
1912 	OPTIONS_TABLE_NUMBER,
1913 	OPTIONS_TABLE_KEY,
1914 	OPTIONS_TABLE_COLOUR,
1915 	OPTIONS_TABLE_FLAG,
1916 	OPTIONS_TABLE_CHOICE,
1917 	OPTIONS_TABLE_COMMAND
1918 };
1919 
1920 #define OPTIONS_TABLE_NONE 0
1921 #define OPTIONS_TABLE_SERVER 0x1
1922 #define OPTIONS_TABLE_SESSION 0x2
1923 #define OPTIONS_TABLE_WINDOW 0x4
1924 #define OPTIONS_TABLE_PANE 0x8
1925 
1926 #define OPTIONS_TABLE_IS_ARRAY 0x1
1927 #define OPTIONS_TABLE_IS_HOOK 0x2
1928 #define OPTIONS_TABLE_IS_STYLE 0x4
1929 
1930 struct options_table_entry {
1931 	const char		 *name;
1932 	const char		 *alternative_name;
1933 	enum options_table_type	  type;
1934 	int			  scope;
1935 	int			  flags;
1936 
1937 	u_int			  minimum;
1938 	u_int			  maximum;
1939 	const char		**choices;
1940 
1941 	const char		 *default_str;
1942 	long long		  default_num;
1943 	const char		**default_arr;
1944 
1945 	const char		 *separator;
1946 	const char		 *pattern;
1947 
1948 	const char		 *text;
1949 	const char		 *unit;
1950 };
1951 
1952 struct options_name_map {
1953 	const char		*from;
1954 	const char		*to;
1955 };
1956 
1957 /* Common command usages. */
1958 #define CMD_TARGET_PANE_USAGE "[-t target-pane]"
1959 #define CMD_TARGET_WINDOW_USAGE "[-t target-window]"
1960 #define CMD_TARGET_SESSION_USAGE "[-t target-session]"
1961 #define CMD_TARGET_CLIENT_USAGE "[-t target-client]"
1962 #define CMD_SRCDST_PANE_USAGE "[-s src-pane] [-t dst-pane]"
1963 #define CMD_SRCDST_WINDOW_USAGE "[-s src-window] [-t dst-window]"
1964 #define CMD_SRCDST_SESSION_USAGE "[-s src-session] [-t dst-session]"
1965 #define CMD_SRCDST_CLIENT_USAGE "[-s src-client] [-t dst-client]"
1966 #define CMD_BUFFER_USAGE "[-b buffer-name]"
1967 
1968 /* Spawn common context. */
1969 struct spawn_context {
1970 	struct cmdq_item	 *item;
1971 
1972 	struct session		 *s;
1973 	struct winlink		 *wl;
1974 	struct client		 *tc;
1975 
1976 	struct window_pane	 *wp0;
1977 	struct layout_cell	 *lc;
1978 
1979 	const char		 *name;
1980 	char			**argv;
1981 	int			  argc;
1982 	struct environ		 *environ;
1983 
1984 	int			  idx;
1985 	const char		 *cwd;
1986 
1987 	int			  flags;
1988 #define SPAWN_KILL 0x1
1989 #define SPAWN_DETACHED 0x2
1990 #define SPAWN_RESPAWN 0x4
1991 #define SPAWN_BEFORE 0x8
1992 #define SPAWN_NONOTIFY 0x10
1993 #define SPAWN_FULLSIZE 0x20
1994 #define SPAWN_EMPTY 0x40
1995 #define SPAWN_ZOOM 0x80
1996 };
1997 
1998 /* Mode tree sort order. */
1999 struct mode_tree_sort_criteria {
2000 	u_int	field;
2001 	int	reversed;
2002 };
2003 
2004 /* tmux.c */
2005 extern struct options	*global_options;
2006 extern struct options	*global_s_options;
2007 extern struct options	*global_w_options;
2008 extern struct environ	*global_environ;
2009 extern struct timeval	 start_time;
2010 extern const char	*socket_path;
2011 extern const char	*shell_command;
2012 extern int		 ptm_fd;
2013 extern const char	*shell_command;
2014 int		 checkshell(const char *);
2015 void		 setblocking(int, int);
2016 uint64_t	 get_timer(void);
2017 const char	*sig2name(int);
2018 const char	*find_cwd(void);
2019 const char	*find_home(void);
2020 const char	*getversion(void);
2021 
2022 /* proc.c */
2023 struct imsg;
2024 int	proc_send(struct tmuxpeer *, enum msgtype, int, const void *, size_t);
2025 struct tmuxproc *proc_start(const char *);
2026 void	proc_loop(struct tmuxproc *, int (*)(void));
2027 void	proc_exit(struct tmuxproc *);
2028 void	proc_set_signals(struct tmuxproc *, void(*)(int));
2029 void	proc_clear_signals(struct tmuxproc *, int);
2030 struct tmuxpeer *proc_add_peer(struct tmuxproc *, int,
2031 	    void (*)(struct imsg *, void *), void *);
2032 void	proc_remove_peer(struct tmuxpeer *);
2033 void	proc_kill_peer(struct tmuxpeer *);
2034 void	proc_flush_peer(struct tmuxpeer *);
2035 void	proc_toggle_log(struct tmuxproc *);
2036 pid_t	proc_fork_and_daemon(int *);
2037 uid_t	proc_get_peer_uid(struct tmuxpeer *);
2038 
2039 /* cfg.c */
2040 extern int cfg_finished;
2041 extern struct client *cfg_client;
2042 extern char **cfg_files;
2043 extern u_int cfg_nfiles;
2044 extern int cfg_quiet;
2045 void	start_cfg(void);
2046 int	load_cfg(const char *, struct client *, struct cmdq_item *, int,
2047 	    struct cmdq_item **);
2048 int	load_cfg_from_buffer(const void *, size_t, const char *,
2049 	    struct client *, struct cmdq_item *, int, struct cmdq_item **);
2050 void printflike(1, 2) cfg_add_cause(const char *, ...);
2051 void	cfg_print_causes(struct cmdq_item *);
2052 void	cfg_show_causes(struct session *);
2053 
2054 /* paste.c */
2055 struct paste_buffer;
2056 const char	*paste_buffer_name(struct paste_buffer *);
2057 u_int		 paste_buffer_order(struct paste_buffer *);
2058 time_t		 paste_buffer_created(struct paste_buffer *);
2059 const char	*paste_buffer_data(struct paste_buffer *, size_t *);
2060 struct paste_buffer *paste_walk(struct paste_buffer *);
2061 struct paste_buffer *paste_get_top(const char **);
2062 struct paste_buffer *paste_get_name(const char *);
2063 void		 paste_free(struct paste_buffer *);
2064 void		 paste_add(const char *, char *, size_t);
2065 int		 paste_rename(const char *, const char *, char **);
2066 int		 paste_set(char *, size_t, const char *, char **);
2067 void		 paste_replace(struct paste_buffer *, char *, size_t);
2068 char		*paste_make_sample(struct paste_buffer *);
2069 
2070 /* format.c */
2071 #define FORMAT_STATUS 0x1
2072 #define FORMAT_FORCE 0x2
2073 #define FORMAT_NOJOBS 0x4
2074 #define FORMAT_VERBOSE 0x8
2075 #define FORMAT_NONE 0
2076 #define FORMAT_PANE 0x80000000U
2077 #define FORMAT_WINDOW 0x40000000U
2078 struct format_tree;
2079 struct format_modifier;
2080 typedef void *(*format_cb)(struct format_tree *);
2081 void		 format_tidy_jobs(void);
2082 const char	*format_skip(const char *, const char *);
2083 int		 format_true(const char *);
2084 struct format_tree *format_create(struct client *, struct cmdq_item *, int,
2085 		     int);
2086 void		 format_free(struct format_tree *);
2087 void		 format_merge(struct format_tree *, struct format_tree *);
2088 struct window_pane *format_get_pane(struct format_tree *);
2089 void printflike(3, 4) format_add(struct format_tree *, const char *,
2090 		     const char *, ...);
2091 void		 format_add_tv(struct format_tree *, const char *,
2092 		     struct timeval *);
2093 void		 format_add_cb(struct format_tree *, const char *, format_cb);
2094 void		 format_log_debug(struct format_tree *, const char *);
2095 void		 format_each(struct format_tree *, void (*)(const char *,
2096 		     const char *, void *), void *);
2097 char		*format_expand_time(struct format_tree *, const char *);
2098 char		*format_expand(struct format_tree *, const char *);
2099 char		*format_single(struct cmdq_item *, const char *,
2100 		     struct client *, struct session *, struct winlink *,
2101 		     struct window_pane *);
2102 char		*format_single_from_state(struct cmdq_item *, const char *,
2103 		    struct client *, struct cmd_find_state *);
2104 char		*format_single_from_target(struct cmdq_item *, const char *);
2105 struct format_tree *format_create_defaults(struct cmdq_item *, struct client *,
2106 		     struct session *, struct winlink *, struct window_pane *);
2107 struct format_tree *format_create_from_state(struct cmdq_item *,
2108 		     struct client *, struct cmd_find_state *);
2109 struct format_tree *format_create_from_target(struct cmdq_item *);
2110 void		 format_defaults(struct format_tree *, struct client *,
2111 		     struct session *, struct winlink *, struct window_pane *);
2112 void		 format_defaults_window(struct format_tree *, struct window *);
2113 void		 format_defaults_pane(struct format_tree *,
2114 		     struct window_pane *);
2115 void		 format_defaults_paste_buffer(struct format_tree *,
2116 		     struct paste_buffer *);
2117 void		 format_lost_client(struct client *);
2118 char		*format_grid_word(struct grid *, u_int, u_int);
2119 char		*format_grid_line(struct grid *, u_int);
2120 
2121 /* format-draw.c */
2122 void		 format_draw(struct screen_write_ctx *,
2123 		     const struct grid_cell *, u_int, const char *,
2124 		     struct style_ranges *, int);
2125 u_int		 format_width(const char *);
2126 char		*format_trim_left(const char *, u_int);
2127 char		*format_trim_right(const char *, u_int);
2128 
2129 /* notify.c */
2130 void	notify_hook(struct cmdq_item *, const char *);
2131 void	notify_client(const char *, struct client *);
2132 void	notify_session(const char *, struct session *);
2133 void	notify_winlink(const char *, struct winlink *);
2134 void	notify_session_window(const char *, struct session *, struct window *);
2135 void	notify_window(const char *, struct window *);
2136 void	notify_pane(const char *, struct window_pane *);
2137 
2138 /* options.c */
2139 struct options	*options_create(struct options *);
2140 void		 options_free(struct options *);
2141 struct options	*options_get_parent(struct options *);
2142 void		 options_set_parent(struct options *, struct options *);
2143 struct options_entry *options_first(struct options *);
2144 struct options_entry *options_next(struct options_entry *);
2145 struct options_entry *options_empty(struct options *,
2146 		     const struct options_table_entry *);
2147 struct options_entry *options_default(struct options *,
2148 		     const struct options_table_entry *);
2149 char		*options_default_to_string(const struct options_table_entry *);
2150 const char	*options_name(struct options_entry *);
2151 struct options	*options_owner(struct options_entry *);
2152 const struct options_table_entry *options_table_entry(struct options_entry *);
2153 struct options_entry *options_get_only(struct options *, const char *);
2154 struct options_entry *options_get(struct options *, const char *);
2155 void		 options_array_clear(struct options_entry *);
2156 union options_value *options_array_get(struct options_entry *, u_int);
2157 int		 options_array_set(struct options_entry *, u_int, const char *,
2158 		     int, char **);
2159 int		 options_array_assign(struct options_entry *, const char *,
2160 		     char **);
2161 struct options_array_item *options_array_first(struct options_entry *);
2162 struct options_array_item *options_array_next(struct options_array_item *);
2163 u_int		 options_array_item_index(struct options_array_item *);
2164 union options_value *options_array_item_value(struct options_array_item *);
2165 int		 options_is_array(struct options_entry *);
2166 int		 options_is_string(struct options_entry *);
2167 char		*options_to_string(struct options_entry *, int, int);
2168 char		*options_parse(const char *, int *);
2169 struct options_entry *options_parse_get(struct options *, const char *, int *,
2170 		     int);
2171 char		*options_match(const char *, int *, int *);
2172 struct options_entry *options_match_get(struct options *, const char *, int *,
2173 		     int, int *);
2174 const char	*options_get_string(struct options *, const char *);
2175 long long	 options_get_number(struct options *, const char *);
2176 struct options_entry * printflike(4, 5) options_set_string(struct options *,
2177 		     const char *, int, const char *, ...);
2178 struct options_entry *options_set_number(struct options *, const char *,
2179 		     long long);
2180 int		 options_scope_from_name(struct args *, int,
2181 		     const char *, struct cmd_find_state *, struct options **,
2182 		     char **);
2183 int		 options_scope_from_flags(struct args *, int,
2184 		     struct cmd_find_state *, struct options **, char **);
2185 struct style	*options_string_to_style(struct options *, const char *,
2186 		     struct format_tree *);
2187 int		 options_from_string(struct options *,
2188 		     const struct options_table_entry *, const char *,
2189 		     const char *, int, char **);
2190 int	 	 options_find_choice(const struct options_table_entry *,
2191 		     const char *, char **);
2192 void		 options_push_changes(const char *);
2193 int		 options_remove_or_default(struct options_entry *, int,
2194 		     char **);
2195 
2196 /* options-table.c */
2197 extern const struct options_table_entry	options_table[];
2198 extern const struct options_name_map	options_other_names[];
2199 
2200 /* job.c */
2201 typedef void (*job_update_cb) (struct job *);
2202 typedef void (*job_complete_cb) (struct job *);
2203 typedef void (*job_free_cb) (void *);
2204 #define JOB_NOWAIT 0x1
2205 #define JOB_KEEPWRITE 0x2
2206 #define JOB_PTY 0x4
2207 struct job	*job_run(const char *, int, char **, struct environ *,
2208 		     struct session *, const char *, job_update_cb,
2209 		     job_complete_cb, job_free_cb, void *, int, int, int);
2210 void		 job_free(struct job *);
2211 int		 job_transfer(struct job *, pid_t *, char *, size_t);
2212 void		 job_resize(struct job *, u_int, u_int);
2213 void		 job_check_died(pid_t, int);
2214 int		 job_get_status(struct job *);
2215 void		*job_get_data(struct job *);
2216 struct bufferevent *job_get_event(struct job *);
2217 void		 job_kill_all(void);
2218 int		 job_still_running(void);
2219 void		 job_print_summary(struct cmdq_item *, int);
2220 
2221 /* environ.c */
2222 struct environ *environ_create(void);
2223 void	environ_free(struct environ *);
2224 struct environ_entry *environ_first(struct environ *);
2225 struct environ_entry *environ_next(struct environ_entry *);
2226 void	environ_copy(struct environ *, struct environ *);
2227 struct environ_entry *environ_find(struct environ *, const char *);
2228 void printflike(4, 5) environ_set(struct environ *, const char *, int,
2229 	    const char *, ...);
2230 void	environ_clear(struct environ *, const char *);
2231 void	environ_put(struct environ *, const char *, int);
2232 void	environ_unset(struct environ *, const char *);
2233 void	environ_update(struct options *, struct environ *, struct environ *);
2234 void	environ_push(struct environ *);
2235 void printflike(2, 3) environ_log(struct environ *, const char *, ...);
2236 struct environ *environ_for_session(struct session *, int);
2237 
2238 /* tty.c */
2239 void	tty_create_log(void);
2240 int	tty_window_bigger(struct tty *);
2241 int	tty_window_offset(struct tty *, u_int *, u_int *, u_int *, u_int *);
2242 void	tty_update_window_offset(struct window *);
2243 void	tty_update_client_offset(struct client *);
2244 void	tty_raw(struct tty *, const char *);
2245 void	tty_attributes(struct tty *, const struct grid_cell *,
2246 	    const struct grid_cell *, struct colour_palette *);
2247 void	tty_reset(struct tty *);
2248 void	tty_region_off(struct tty *);
2249 void	tty_margin_off(struct tty *);
2250 void	tty_cursor(struct tty *, u_int, u_int);
2251 void	tty_clipboard_query(struct tty *);
2252 void	tty_putcode(struct tty *, enum tty_code_code);
2253 void	tty_putcode1(struct tty *, enum tty_code_code, int);
2254 void	tty_putcode2(struct tty *, enum tty_code_code, int, int);
2255 void	tty_putcode3(struct tty *, enum tty_code_code, int, int, int);
2256 void	tty_putcode_ptr1(struct tty *, enum tty_code_code, const void *);
2257 void	tty_putcode_ptr2(struct tty *, enum tty_code_code, const void *,
2258 	    const void *);
2259 void	tty_puts(struct tty *, const char *);
2260 void	tty_putc(struct tty *, u_char);
2261 void	tty_putn(struct tty *, const void *, size_t, u_int);
2262 void	tty_cell(struct tty *, const struct grid_cell *,
2263 	    const struct grid_cell *, struct colour_palette *);
2264 int	tty_init(struct tty *, struct client *);
2265 void	tty_resize(struct tty *);
2266 void	tty_set_size(struct tty *, u_int, u_int, u_int, u_int);
2267 void	tty_start_tty(struct tty *);
2268 void	tty_send_requests(struct tty *);
2269 void	tty_stop_tty(struct tty *);
2270 void	tty_set_title(struct tty *, const char *);
2271 void	tty_set_path(struct tty *, const char *);
2272 void	tty_update_mode(struct tty *, int, struct screen *);
2273 void	tty_draw_line(struct tty *, struct screen *, u_int, u_int, u_int,
2274 	    u_int, u_int, const struct grid_cell *, struct colour_palette *);
2275 void	tty_sync_start(struct tty *);
2276 void	tty_sync_end(struct tty *);
2277 int	tty_open(struct tty *, char **);
2278 void	tty_close(struct tty *);
2279 void	tty_free(struct tty *);
2280 void	tty_update_features(struct tty *);
2281 void	tty_set_selection(struct tty *, const char *, size_t);
2282 void	tty_write(void (*)(struct tty *, const struct tty_ctx *),
2283 	    struct tty_ctx *);
2284 void	tty_cmd_alignmenttest(struct tty *, const struct tty_ctx *);
2285 void	tty_cmd_cell(struct tty *, const struct tty_ctx *);
2286 void	tty_cmd_cells(struct tty *, const struct tty_ctx *);
2287 void	tty_cmd_clearendofline(struct tty *, const struct tty_ctx *);
2288 void	tty_cmd_clearendofscreen(struct tty *, const struct tty_ctx *);
2289 void	tty_cmd_clearline(struct tty *, const struct tty_ctx *);
2290 void	tty_cmd_clearscreen(struct tty *, const struct tty_ctx *);
2291 void	tty_cmd_clearstartofline(struct tty *, const struct tty_ctx *);
2292 void	tty_cmd_clearstartofscreen(struct tty *, const struct tty_ctx *);
2293 void	tty_cmd_deletecharacter(struct tty *, const struct tty_ctx *);
2294 void	tty_cmd_clearcharacter(struct tty *, const struct tty_ctx *);
2295 void	tty_cmd_deleteline(struct tty *, const struct tty_ctx *);
2296 void	tty_cmd_erasecharacter(struct tty *, const struct tty_ctx *);
2297 void	tty_cmd_insertcharacter(struct tty *, const struct tty_ctx *);
2298 void	tty_cmd_insertline(struct tty *, const struct tty_ctx *);
2299 void	tty_cmd_linefeed(struct tty *, const struct tty_ctx *);
2300 void	tty_cmd_scrollup(struct tty *, const struct tty_ctx *);
2301 void	tty_cmd_scrolldown(struct tty *, const struct tty_ctx *);
2302 void	tty_cmd_reverseindex(struct tty *, const struct tty_ctx *);
2303 void	tty_cmd_setselection(struct tty *, const struct tty_ctx *);
2304 void	tty_cmd_rawstring(struct tty *, const struct tty_ctx *);
2305 void	tty_cmd_syncstart(struct tty *, const struct tty_ctx *);
2306 void	tty_default_colours(struct grid_cell *, struct window_pane *);
2307 
2308 /* tty-term.c */
2309 extern struct tty_terms tty_terms;
2310 u_int		 tty_term_ncodes(void);
2311 void		 tty_term_apply(struct tty_term *, const char *, int);
2312 void		 tty_term_apply_overrides(struct tty_term *);
2313 struct tty_term *tty_term_create(struct tty *, char *, char **, u_int, int *,
2314 		     char **);
2315 void		 tty_term_free(struct tty_term *);
2316 int		 tty_term_read_list(const char *, int, char ***, u_int *,
2317 		     char **);
2318 void		 tty_term_free_list(char **, u_int);
2319 int		 tty_term_has(struct tty_term *, enum tty_code_code);
2320 const char	*tty_term_string(struct tty_term *, enum tty_code_code);
2321 const char	*tty_term_string1(struct tty_term *, enum tty_code_code, int);
2322 const char	*tty_term_string2(struct tty_term *, enum tty_code_code, int,
2323 		     int);
2324 const char	*tty_term_string3(struct tty_term *, enum tty_code_code, int,
2325 		     int, int);
2326 const char	*tty_term_ptr1(struct tty_term *, enum tty_code_code,
2327 		     const void *);
2328 const char	*tty_term_ptr2(struct tty_term *, enum tty_code_code,
2329 		     const void *, const void *);
2330 int		 tty_term_number(struct tty_term *, enum tty_code_code);
2331 int		 tty_term_flag(struct tty_term *, enum tty_code_code);
2332 const char	*tty_term_describe(struct tty_term *, enum tty_code_code);
2333 
2334 /* tty-features.c */
2335 void		 tty_add_features(int *, const char *, const char *);
2336 const char	*tty_get_features(int);
2337 int		 tty_apply_features(struct tty_term *, int);
2338 void		 tty_default_features(int *, const char *, u_int);
2339 
2340 /* tty-acs.c */
2341 int		 tty_acs_needed(struct tty *);
2342 const char	*tty_acs_get(struct tty *, u_char);
2343 int		 tty_acs_reverse_get(struct tty *, const char *, size_t);
2344 const struct utf8_data *tty_acs_double_borders(int);
2345 const struct utf8_data *tty_acs_heavy_borders(int);
2346 const struct utf8_data *tty_acs_rounded_borders(int);
2347 
2348 /* tty-keys.c */
2349 void		tty_keys_build(struct tty *);
2350 void		tty_keys_free(struct tty *);
2351 int		tty_keys_next(struct tty *);
2352 
2353 /* arguments.c */
2354 void		 args_set(struct args *, u_char, struct args_value *);
2355 struct args 	*args_create(void);
2356 struct args	*args_parse(const struct args_parse *, struct args_value *,
2357 		     u_int, char **);
2358 struct args	*args_copy(struct args *, int, char **);
2359 void		 args_to_vector(struct args *, int *, char ***);
2360 struct args_value *args_from_vector(int, char **);
2361 void		 args_free_value(struct args_value *);
2362 void		 args_free_values(struct args_value *, u_int);
2363 void		 args_free(struct args *);
2364 char		*args_print(struct args *);
2365 char		*args_escape(const char *);
2366 int		 args_has(struct args *, u_char);
2367 const char	*args_get(struct args *, u_char);
2368 u_char		 args_first(struct args *, struct args_entry **);
2369 u_char		 args_next(struct args_entry **);
2370 u_int		 args_count(struct args *);
2371 struct args_value *args_values(struct args *);
2372 struct args_value *args_value(struct args *, u_int);
2373 const char	*args_string(struct args *, u_int);
2374 struct cmd_list	*args_make_commands_now(struct cmd *, struct cmdq_item *,
2375 		     u_int, int);
2376 struct args_command_state *args_make_commands_prepare(struct cmd *,
2377 		     struct cmdq_item *, u_int, const char *, int, int);
2378 struct cmd_list *args_make_commands(struct args_command_state *, int, char **,
2379 		     char **);
2380 void		 args_make_commands_free(struct args_command_state *);
2381 char		*args_make_commands_get_command(struct args_command_state *);
2382 struct args_value *args_first_value(struct args *, u_char);
2383 struct args_value *args_next_value(struct args_value *);
2384 long long	 args_strtonum(struct args *, u_char, long long, long long,
2385 		     char **);
2386 long long	 args_percentage(struct args *, u_char, long long,
2387 		     long long, long long, char **);
2388 long long	 args_string_percentage(const char *, long long, long long,
2389 		     long long, char **);
2390 
2391 /* cmd-find.c */
2392 int		 cmd_find_target(struct cmd_find_state *, struct cmdq_item *,
2393 		     const char *, enum cmd_find_type, int);
2394 struct client	*cmd_find_best_client(struct session *);
2395 struct client	*cmd_find_client(struct cmdq_item *, const char *, int);
2396 void		 cmd_find_clear_state(struct cmd_find_state *, int);
2397 int		 cmd_find_empty_state(struct cmd_find_state *);
2398 int		 cmd_find_valid_state(struct cmd_find_state *);
2399 void		 cmd_find_copy_state(struct cmd_find_state *,
2400 		     struct cmd_find_state *);
2401 void		 cmd_find_from_session(struct cmd_find_state *,
2402 		     struct session *, int);
2403 void		 cmd_find_from_winlink(struct cmd_find_state *,
2404 		     struct winlink *, int);
2405 int		 cmd_find_from_session_window(struct cmd_find_state *,
2406 		     struct session *, struct window *, int);
2407 int		 cmd_find_from_window(struct cmd_find_state *, struct window *,
2408 		     int);
2409 void		 cmd_find_from_winlink_pane(struct cmd_find_state *,
2410 		     struct winlink *, struct window_pane *, int);
2411 int		 cmd_find_from_pane(struct cmd_find_state *,
2412 		     struct window_pane *, int);
2413 int		 cmd_find_from_client(struct cmd_find_state *, struct client *,
2414 		     int);
2415 int		 cmd_find_from_mouse(struct cmd_find_state *,
2416 		     struct mouse_event *, int);
2417 int		 cmd_find_from_nothing(struct cmd_find_state *, int);
2418 
2419 /* cmd.c */
2420 extern const struct cmd_entry *cmd_table[];
2421 void printflike(3, 4) cmd_log_argv(int, char **, const char *, ...);
2422 void		 cmd_prepend_argv(int *, char ***, const char *);
2423 void		 cmd_append_argv(int *, char ***, const char *);
2424 int		 cmd_pack_argv(int, char **, char *, size_t);
2425 int		 cmd_unpack_argv(char *, size_t, int, char ***);
2426 char	       **cmd_copy_argv(int, char **);
2427 void		 cmd_free_argv(int, char **);
2428 char		*cmd_stringify_argv(int, char **);
2429 char		*cmd_get_alias(const char *);
2430 const struct cmd_entry *cmd_get_entry(struct cmd *);
2431 struct args	*cmd_get_args(struct cmd *);
2432 u_int		 cmd_get_group(struct cmd *);
2433 void		 cmd_get_source(struct cmd *, const char **, u_int *);
2434 struct cmd	*cmd_parse(struct args_value *, u_int, const char *, u_int,
2435 		     char **);
2436 struct cmd	*cmd_copy(struct cmd *, int, char **);
2437 void		 cmd_free(struct cmd *);
2438 char		*cmd_print(struct cmd *);
2439 struct cmd_list	*cmd_list_new(void);
2440 struct cmd_list	*cmd_list_copy(struct cmd_list *, int, char **);
2441 void		 cmd_list_append(struct cmd_list *, struct cmd *);
2442 void		 cmd_list_append_all(struct cmd_list *, struct cmd_list *);
2443 void		 cmd_list_move(struct cmd_list *, struct cmd_list *);
2444 void		 cmd_list_free(struct cmd_list *);
2445 char		*cmd_list_print(struct cmd_list *, int);
2446 struct cmd	*cmd_list_first(struct cmd_list *);
2447 struct cmd	*cmd_list_next(struct cmd *);
2448 int		 cmd_list_all_have(struct cmd_list *, int);
2449 int		 cmd_list_any_have(struct cmd_list *, int);
2450 int		 cmd_mouse_at(struct window_pane *, struct mouse_event *,
2451 		     u_int *, u_int *, int);
2452 struct winlink	*cmd_mouse_window(struct mouse_event *, struct session **);
2453 struct window_pane *cmd_mouse_pane(struct mouse_event *, struct session **,
2454 		     struct winlink **);
2455 char		*cmd_template_replace(const char *, const char *, int);
2456 
2457 /* cmd-attach-session.c */
2458 enum cmd_retval	 cmd_attach_session(struct cmdq_item *, const char *, int, int,
2459 		     int, const char *, int, const char *);
2460 
2461 /* cmd-parse.c */
2462 void		 cmd_parse_empty(struct cmd_parse_input *);
2463 struct cmd_parse_result *cmd_parse_from_file(FILE *, struct cmd_parse_input *);
2464 struct cmd_parse_result *cmd_parse_from_string(const char *,
2465 		     struct cmd_parse_input *);
2466 enum cmd_parse_status cmd_parse_and_insert(const char *,
2467 		     struct cmd_parse_input *, struct cmdq_item *,
2468 		     struct cmdq_state *, char **);
2469 enum cmd_parse_status cmd_parse_and_append(const char *,
2470 		     struct cmd_parse_input *, struct client *,
2471 		     struct cmdq_state *, char **);
2472 struct cmd_parse_result *cmd_parse_from_buffer(const void *, size_t,
2473 		     struct cmd_parse_input *);
2474 struct cmd_parse_result *cmd_parse_from_arguments(struct args_value *, u_int,
2475 		     struct cmd_parse_input *);
2476 
2477 /* cmd-queue.c */
2478 struct cmdq_state *cmdq_new_state(struct cmd_find_state *, struct key_event *,
2479 		     int);
2480 struct cmdq_state *cmdq_link_state(struct cmdq_state *);
2481 struct cmdq_state *cmdq_copy_state(struct cmdq_state *);
2482 void		  cmdq_free_state(struct cmdq_state *);
2483 void printflike(3, 4) cmdq_add_format(struct cmdq_state *, const char *,
2484 		     const char *, ...);
2485 void		  cmdq_add_formats(struct cmdq_state *, struct format_tree *);
2486 void		  cmdq_merge_formats(struct cmdq_item *, struct format_tree *);
2487 struct cmdq_list *cmdq_new(void);
2488 void cmdq_free(struct cmdq_list *);
2489 const char	 *cmdq_get_name(struct cmdq_item *);
2490 struct client	 *cmdq_get_client(struct cmdq_item *);
2491 struct client	 *cmdq_get_target_client(struct cmdq_item *);
2492 struct cmdq_state *cmdq_get_state(struct cmdq_item *);
2493 struct cmd_find_state *cmdq_get_target(struct cmdq_item *);
2494 struct cmd_find_state *cmdq_get_source(struct cmdq_item *);
2495 struct key_event *cmdq_get_event(struct cmdq_item *);
2496 struct cmd_find_state *cmdq_get_current(struct cmdq_item *);
2497 int		  cmdq_get_flags(struct cmdq_item *);
2498 struct cmdq_item *cmdq_get_command(struct cmd_list *, struct cmdq_state *);
2499 #define cmdq_get_callback(cb, data) cmdq_get_callback1(#cb, cb, data)
2500 struct cmdq_item *cmdq_get_callback1(const char *, cmdq_cb, void *);
2501 struct cmdq_item *cmdq_get_error(const char *);
2502 struct cmdq_item *cmdq_insert_after(struct cmdq_item *, struct cmdq_item *);
2503 struct cmdq_item *cmdq_append(struct client *, struct cmdq_item *);
2504 void printflike(4, 5) cmdq_insert_hook(struct session *, struct cmdq_item *,
2505 		     struct cmd_find_state *, const char *, ...);
2506 void		 cmdq_continue(struct cmdq_item *);
2507 u_int		 cmdq_next(struct client *);
2508 struct cmdq_item *cmdq_running(struct client *);
2509 void		 cmdq_guard(struct cmdq_item *, const char *, int);
2510 void printflike(2, 3) cmdq_print(struct cmdq_item *, const char *, ...);
2511 void printflike(2, 3) cmdq_error(struct cmdq_item *, const char *, ...);
2512 
2513 /* cmd-wait-for.c */
2514 void	cmd_wait_for_flush(void);
2515 
2516 /* client.c */
2517 int	client_main(struct event_base *, int, char **, uint64_t, int);
2518 
2519 /* key-bindings.c */
2520 struct key_table *key_bindings_get_table(const char *, int);
2521 struct key_table *key_bindings_first_table(void);
2522 struct key_table *key_bindings_next_table(struct key_table *);
2523 void	 key_bindings_unref_table(struct key_table *);
2524 struct key_binding *key_bindings_get(struct key_table *, key_code);
2525 struct key_binding *key_bindings_get_default(struct key_table *, key_code);
2526 struct key_binding *key_bindings_first(struct key_table *);
2527 struct key_binding *key_bindings_next(struct key_table *, struct key_binding *);
2528 void	 key_bindings_add(const char *, key_code, const char *, int,
2529 	     struct cmd_list *);
2530 void	 key_bindings_remove(const char *, key_code);
2531 void	 key_bindings_reset(const char *, key_code);
2532 void	 key_bindings_remove_table(const char *);
2533 void	 key_bindings_reset_table(const char *);
2534 void	 key_bindings_init(void);
2535 struct cmdq_item *key_bindings_dispatch(struct key_binding *,
2536 	     struct cmdq_item *, struct client *, struct key_event *,
2537 	     struct cmd_find_state *);
2538 
2539 /* key-string.c */
2540 key_code	 key_string_lookup_string(const char *);
2541 const char	*key_string_lookup_key(key_code, int);
2542 
2543 /* alerts.c */
2544 void	alerts_reset_all(void);
2545 void	alerts_queue(struct window *, int);
2546 void	alerts_check_session(struct session *);
2547 
2548 /* file.c */
2549 int	 file_cmp(struct client_file *, struct client_file *);
2550 RB_PROTOTYPE(client_files, client_file, entry, file_cmp);
2551 struct client_file *file_create_with_peer(struct tmuxpeer *,
2552 	    struct client_files *, int, client_file_cb, void *);
2553 struct client_file *file_create_with_client(struct client *, int,
2554 	    client_file_cb, void *);
2555 void	 file_free(struct client_file *);
2556 void	 file_fire_done(struct client_file *);
2557 void	 file_fire_read(struct client_file *);
2558 int	 file_can_print(struct client *);
2559 void printflike(2, 3) file_print(struct client *, const char *, ...);
2560 void printflike(2, 0) file_vprint(struct client *, const char *, va_list);
2561 void	 file_print_buffer(struct client *, void *, size_t);
2562 void printflike(2, 3) file_error(struct client *, const char *, ...);
2563 void	 file_write(struct client *, const char *, int, const void *, size_t,
2564 	     client_file_cb, void *);
2565 void	 file_read(struct client *, const char *, client_file_cb, void *);
2566 void	 file_push(struct client_file *);
2567 int	 file_write_left(struct client_files *);
2568 void	 file_write_open(struct client_files *, struct tmuxpeer *,
2569 	     struct imsg *, int, int, client_file_cb, void *);
2570 void	 file_write_data(struct client_files *, struct imsg *);
2571 void	 file_write_close(struct client_files *, struct imsg *);
2572 void	 file_read_open(struct client_files *, struct tmuxpeer *, struct imsg *,
2573 	     int, int, client_file_cb, void *);
2574 void	 file_write_ready(struct client_files *, struct imsg *);
2575 void	 file_read_data(struct client_files *, struct imsg *);
2576 void	 file_read_done(struct client_files *, struct imsg *);
2577 
2578 /* server.c */
2579 extern struct tmuxproc *server_proc;
2580 extern struct clients clients;
2581 extern struct cmd_find_state marked_pane;
2582 extern struct message_list message_log;
2583 void	 server_set_marked(struct session *, struct winlink *,
2584 	     struct window_pane *);
2585 void	 server_clear_marked(void);
2586 int	 server_is_marked(struct session *, struct winlink *,
2587 	     struct window_pane *);
2588 int	 server_check_marked(void);
2589 int	 server_start(struct tmuxproc *, int, struct event_base *, int, char *);
2590 void	 server_update_socket(void);
2591 void	 server_add_accept(int);
2592 void printflike(1, 2) server_add_message(const char *, ...);
2593 int	 server_create_socket(int, char **);
2594 
2595 /* server-client.c */
2596 RB_PROTOTYPE(client_windows, client_window, entry, server_client_window_cmp);
2597 u_int	 server_client_how_many(void);
2598 void	 server_client_set_overlay(struct client *, u_int, overlay_check_cb,
2599 	     overlay_mode_cb, overlay_draw_cb, overlay_key_cb,
2600 	     overlay_free_cb, overlay_resize_cb, void *);
2601 void	 server_client_clear_overlay(struct client *);
2602 void	 server_client_overlay_range(u_int, u_int, u_int, u_int, u_int, u_int,
2603 	     u_int, struct overlay_ranges *);
2604 void	 server_client_set_key_table(struct client *, const char *);
2605 const char *server_client_get_key_table(struct client *);
2606 int	 server_client_check_nested(struct client *);
2607 int	 server_client_handle_key(struct client *, struct key_event *);
2608 struct client *server_client_create(int);
2609 int	 server_client_open(struct client *, char **);
2610 void	 server_client_unref(struct client *);
2611 void	 server_client_set_session(struct client *, struct session *);
2612 void	 server_client_lost(struct client *);
2613 void	 server_client_suspend(struct client *);
2614 void	 server_client_detach(struct client *, enum msgtype);
2615 void	 server_client_exec(struct client *, const char *);
2616 void	 server_client_loop(void);
2617 void	 server_client_push_stdout(struct client *);
2618 void	 server_client_push_stderr(struct client *);
2619 const char *server_client_get_cwd(struct client *, struct session *);
2620 void	 server_client_set_flags(struct client *, const char *);
2621 const char *server_client_get_flags(struct client *);
2622 struct client_window *server_client_get_client_window(struct client *, u_int);
2623 struct client_window *server_client_add_client_window(struct client *, u_int);
2624 struct window_pane *server_client_get_pane(struct client *);
2625 void	 server_client_set_pane(struct client *, struct window_pane *);
2626 void	 server_client_remove_pane(struct window_pane *);
2627 
2628 /* server-fn.c */
2629 void	 server_redraw_client(struct client *);
2630 void	 server_status_client(struct client *);
2631 void	 server_redraw_session(struct session *);
2632 void	 server_redraw_session_group(struct session *);
2633 void	 server_status_session(struct session *);
2634 void	 server_status_session_group(struct session *);
2635 void	 server_redraw_window(struct window *);
2636 void	 server_redraw_window_borders(struct window *);
2637 void	 server_status_window(struct window *);
2638 void	 server_lock(void);
2639 void	 server_lock_session(struct session *);
2640 void	 server_lock_client(struct client *);
2641 void	 server_kill_pane(struct window_pane *);
2642 void	 server_kill_window(struct window *, int);
2643 void	 server_renumber_session(struct session *);
2644 void	 server_renumber_all(void);
2645 int	 server_link_window(struct session *,
2646 	     struct winlink *, struct session *, int, int, int, char **);
2647 void	 server_unlink_window(struct session *, struct winlink *);
2648 void	 server_destroy_pane(struct window_pane *, int);
2649 void	 server_destroy_session(struct session *);
2650 void	 server_check_unattached(void);
2651 void	 server_unzoom_window(struct window *);
2652 
2653 /* status.c */
2654 extern char	**status_prompt_hlist[];
2655 extern u_int	  status_prompt_hsize[];
2656 void	 status_timer_start(struct client *);
2657 void	 status_timer_start_all(void);
2658 void	 status_update_cache(struct session *);
2659 int	 status_at_line(struct client *);
2660 u_int	 status_line_size(struct client *);
2661 struct style_range *status_get_range(struct client *, u_int, u_int);
2662 void	 status_init(struct client *);
2663 void	 status_free(struct client *);
2664 int	 status_redraw(struct client *);
2665 void printflike(5, 6) status_message_set(struct client *, int, int, int,
2666 	     const char *, ...);
2667 void	 status_message_clear(struct client *);
2668 int	 status_message_redraw(struct client *);
2669 void	 status_prompt_set(struct client *, struct cmd_find_state *,
2670 	     const char *, const char *, prompt_input_cb, prompt_free_cb,
2671 	     void *, int, enum prompt_type);
2672 void	 status_prompt_clear(struct client *);
2673 int	 status_prompt_redraw(struct client *);
2674 int	 status_prompt_key(struct client *, key_code);
2675 void	 status_prompt_update(struct client *, const char *, const char *);
2676 void	 status_prompt_load_history(void);
2677 void	 status_prompt_save_history(void);
2678 const char *status_prompt_type_string(u_int);
2679 enum prompt_type status_prompt_type(const char *type);
2680 
2681 /* resize.c */
2682 void	 resize_window(struct window *, u_int, u_int, int, int);
2683 void	 default_window_size(struct client *, struct session *, struct window *,
2684 	     u_int *, u_int *, u_int *, u_int *, int);
2685 void	 recalculate_size(struct window *, int);
2686 void	 recalculate_sizes(void);
2687 void	 recalculate_sizes_now(int);
2688 
2689 /* input.c */
2690 struct input_ctx *input_init(struct window_pane *, struct bufferevent *,
2691 	     struct colour_palette *);
2692 void	 input_free(struct input_ctx *);
2693 void	 input_reset(struct input_ctx *, int);
2694 struct evbuffer *input_pending(struct input_ctx *);
2695 void	 input_parse_pane(struct window_pane *);
2696 void	 input_parse_buffer(struct window_pane *, u_char *, size_t);
2697 void	 input_parse_screen(struct input_ctx *, struct screen *,
2698 	     screen_write_init_ctx_cb, void *, u_char *, size_t);
2699 void	 input_reply_clipboard(struct bufferevent *, const char *, size_t,
2700 	     const char *);
2701 
2702 /* input-key.c */
2703 void	 input_key_build(void);
2704 int	 input_key_pane(struct window_pane *, key_code, struct mouse_event *);
2705 int	 input_key(struct screen *, struct bufferevent *, key_code);
2706 int	 input_key_get_mouse(struct screen *, struct mouse_event *, u_int,
2707 	     u_int, const char **, size_t *);
2708 
2709 /* colour.c */
2710 int	 colour_find_rgb(u_char, u_char, u_char);
2711 int	 colour_join_rgb(u_char, u_char, u_char);
2712 void	 colour_split_rgb(int, u_char *, u_char *, u_char *);
2713 int	 colour_force_rgb(int);
2714 const char *colour_tostring(int);
2715 int	 colour_fromstring(const char *s);
2716 int	 colour_256toRGB(int);
2717 int	 colour_256to16(int);
2718 int	 colour_byname(const char *);
2719 void	 colour_palette_init(struct colour_palette *);
2720 void	 colour_palette_clear(struct colour_palette *);
2721 void	 colour_palette_free(struct colour_palette *);
2722 int	 colour_palette_get(struct colour_palette *, int);
2723 int	 colour_palette_set(struct colour_palette *, int, int);
2724 void	 colour_palette_from_option(struct colour_palette *, struct options *);
2725 
2726 /* attributes.c */
2727 const char *attributes_tostring(int);
2728 int	 attributes_fromstring(const char *);
2729 
2730 /* grid.c */
2731 extern const struct grid_cell grid_default_cell;
2732 void	 grid_empty_line(struct grid *, u_int, u_int);
2733 int	 grid_cells_equal(const struct grid_cell *, const struct grid_cell *);
2734 int	 grid_cells_look_equal(const struct grid_cell *,
2735 	     const struct grid_cell *);
2736 struct grid *grid_create(u_int, u_int, u_int);
2737 void	 grid_destroy(struct grid *);
2738 int	 grid_compare(struct grid *, struct grid *);
2739 void	 grid_collect_history(struct grid *);
2740 void	 grid_remove_history(struct grid *, u_int );
2741 void	 grid_scroll_history(struct grid *, u_int);
2742 void	 grid_scroll_history_region(struct grid *, u_int, u_int, u_int);
2743 void	 grid_clear_history(struct grid *);
2744 const struct grid_line *grid_peek_line(struct grid *, u_int);
2745 void	 grid_get_cell(struct grid *, u_int, u_int, struct grid_cell *);
2746 void	 grid_set_cell(struct grid *, u_int, u_int, const struct grid_cell *);
2747 void	 grid_set_padding(struct grid *, u_int, u_int);
2748 void	 grid_set_cells(struct grid *, u_int, u_int, const struct grid_cell *,
2749 	     const char *, size_t);
2750 struct grid_line *grid_get_line(struct grid *, u_int);
2751 void	 grid_adjust_lines(struct grid *, u_int);
2752 void	 grid_clear(struct grid *, u_int, u_int, u_int, u_int, u_int);
2753 void	 grid_clear_lines(struct grid *, u_int, u_int, u_int);
2754 void	 grid_move_lines(struct grid *, u_int, u_int, u_int, u_int);
2755 void	 grid_move_cells(struct grid *, u_int, u_int, u_int, u_int, u_int);
2756 char	*grid_string_cells(struct grid *, u_int, u_int, u_int,
2757 	     struct grid_cell **, int, int, int);
2758 void	 grid_duplicate_lines(struct grid *, u_int, struct grid *, u_int,
2759 	     u_int);
2760 void	 grid_reflow(struct grid *, u_int);
2761 void	 grid_wrap_position(struct grid *, u_int, u_int, u_int *, u_int *);
2762 void	 grid_unwrap_position(struct grid *, u_int *, u_int *, u_int, u_int);
2763 u_int	 grid_line_length(struct grid *, u_int);
2764 
2765 /* grid-reader.c */
2766 void	 grid_reader_start(struct grid_reader *, struct grid *, u_int, u_int);
2767 void	 grid_reader_get_cursor(struct grid_reader *, u_int *, u_int *);
2768 u_int	 grid_reader_line_length(struct grid_reader *);
2769 int	 grid_reader_in_set(struct grid_reader *, const char *);
2770 void	 grid_reader_cursor_right(struct grid_reader *, int, int);
2771 void	 grid_reader_cursor_left(struct grid_reader *, int);
2772 void	 grid_reader_cursor_down(struct grid_reader *);
2773 void	 grid_reader_cursor_up(struct grid_reader *);
2774 void	 grid_reader_cursor_start_of_line(struct grid_reader *, int);
2775 void	 grid_reader_cursor_end_of_line(struct grid_reader *, int, int);
2776 void	 grid_reader_cursor_next_word(struct grid_reader *, const char *);
2777 void	 grid_reader_cursor_next_word_end(struct grid_reader *, const char *);
2778 void	 grid_reader_cursor_previous_word(struct grid_reader *, const char *,
2779 	     int, int);
2780 int	 grid_reader_cursor_jump(struct grid_reader *,
2781 	     const struct utf8_data *);
2782 int	 grid_reader_cursor_jump_back(struct grid_reader *,
2783 	     const struct utf8_data *);
2784 void	 grid_reader_cursor_back_to_indentation(struct grid_reader *);
2785 
2786 /* grid-view.c */
2787 void	 grid_view_get_cell(struct grid *, u_int, u_int, struct grid_cell *);
2788 void	 grid_view_set_cell(struct grid *, u_int, u_int,
2789 	     const struct grid_cell *);
2790 void	 grid_view_set_padding(struct grid *, u_int, u_int);
2791 void	 grid_view_set_cells(struct grid *, u_int, u_int,
2792 	     const struct grid_cell *, const char *, size_t);
2793 void	 grid_view_clear_history(struct grid *, u_int);
2794 void	 grid_view_clear(struct grid *, u_int, u_int, u_int, u_int, u_int);
2795 void	 grid_view_scroll_region_up(struct grid *, u_int, u_int, u_int);
2796 void	 grid_view_scroll_region_down(struct grid *, u_int, u_int, u_int);
2797 void	 grid_view_insert_lines(struct grid *, u_int, u_int, u_int);
2798 void	 grid_view_insert_lines_region(struct grid *, u_int, u_int, u_int,
2799 	     u_int);
2800 void	 grid_view_delete_lines(struct grid *, u_int, u_int, u_int);
2801 void	 grid_view_delete_lines_region(struct grid *, u_int, u_int, u_int,
2802 	     u_int);
2803 void	 grid_view_insert_cells(struct grid *, u_int, u_int, u_int, u_int);
2804 void	 grid_view_delete_cells(struct grid *, u_int, u_int, u_int, u_int);
2805 char	*grid_view_string_cells(struct grid *, u_int, u_int, u_int);
2806 
2807 /* screen-write.c */
2808 void	 screen_write_make_list(struct screen *);
2809 void	 screen_write_free_list(struct screen *);
2810 void	 screen_write_start_pane(struct screen_write_ctx *,
2811 	     struct window_pane *, struct screen *);
2812 void	 screen_write_start(struct screen_write_ctx *, struct screen *);
2813 void	 screen_write_start_callback(struct screen_write_ctx *, struct screen *,
2814 	     screen_write_init_ctx_cb, void *);
2815 void	 screen_write_stop(struct screen_write_ctx *);
2816 void	 screen_write_reset(struct screen_write_ctx *);
2817 size_t printflike(1, 2) screen_write_strlen(const char *, ...);
2818 int printflike(7, 8) screen_write_text(struct screen_write_ctx *, u_int, u_int,
2819 	     u_int, int, const struct grid_cell *, const char *, ...);
2820 void printflike(3, 4) screen_write_puts(struct screen_write_ctx *,
2821 	     const struct grid_cell *, const char *, ...);
2822 void printflike(4, 5) screen_write_nputs(struct screen_write_ctx *,
2823 	     ssize_t, const struct grid_cell *, const char *, ...);
2824 void printflike(4, 0) screen_write_vnputs(struct screen_write_ctx *, ssize_t,
2825 	     const struct grid_cell *, const char *, va_list);
2826 void	 screen_write_putc(struct screen_write_ctx *, const struct grid_cell *,
2827 	     u_char);
2828 void	 screen_write_fast_copy(struct screen_write_ctx *, struct screen *,
2829 	     u_int, u_int, u_int, u_int);
2830 void	 screen_write_hline(struct screen_write_ctx *, u_int, int, int);
2831 void	 screen_write_vline(struct screen_write_ctx *, u_int, int, int);
2832 void	 screen_write_menu(struct screen_write_ctx *, struct menu *, int,
2833 	     const struct grid_cell *);
2834 void	 screen_write_box(struct screen_write_ctx *, u_int, u_int, int,
2835 	     const struct grid_cell *, const char *);
2836 void	 screen_write_preview(struct screen_write_ctx *, struct screen *, u_int,
2837 	     u_int);
2838 void	 screen_write_backspace(struct screen_write_ctx *);
2839 void	 screen_write_mode_set(struct screen_write_ctx *, int);
2840 void	 screen_write_mode_clear(struct screen_write_ctx *, int);
2841 void	 screen_write_cursorup(struct screen_write_ctx *, u_int);
2842 void	 screen_write_cursordown(struct screen_write_ctx *, u_int);
2843 void	 screen_write_cursorright(struct screen_write_ctx *, u_int);
2844 void	 screen_write_cursorleft(struct screen_write_ctx *, u_int);
2845 void	 screen_write_alignmenttest(struct screen_write_ctx *);
2846 void	 screen_write_insertcharacter(struct screen_write_ctx *, u_int, u_int);
2847 void	 screen_write_deletecharacter(struct screen_write_ctx *, u_int, u_int);
2848 void	 screen_write_clearcharacter(struct screen_write_ctx *, u_int, u_int);
2849 void	 screen_write_insertline(struct screen_write_ctx *, u_int, u_int);
2850 void	 screen_write_deleteline(struct screen_write_ctx *, u_int, u_int);
2851 void	 screen_write_clearline(struct screen_write_ctx *, u_int);
2852 void	 screen_write_clearendofline(struct screen_write_ctx *, u_int);
2853 void	 screen_write_clearstartofline(struct screen_write_ctx *, u_int);
2854 void	 screen_write_cursormove(struct screen_write_ctx *, int, int, int);
2855 void	 screen_write_reverseindex(struct screen_write_ctx *, u_int);
2856 void	 screen_write_scrollregion(struct screen_write_ctx *, u_int, u_int);
2857 void	 screen_write_linefeed(struct screen_write_ctx *, int, u_int);
2858 void	 screen_write_scrollup(struct screen_write_ctx *, u_int, u_int);
2859 void	 screen_write_scrolldown(struct screen_write_ctx *, u_int, u_int);
2860 void	 screen_write_carriagereturn(struct screen_write_ctx *);
2861 void	 screen_write_clearendofscreen(struct screen_write_ctx *, u_int);
2862 void	 screen_write_clearstartofscreen(struct screen_write_ctx *, u_int);
2863 void	 screen_write_clearscreen(struct screen_write_ctx *, u_int);
2864 void	 screen_write_clearhistory(struct screen_write_ctx *);
2865 void	 screen_write_fullredraw(struct screen_write_ctx *);
2866 void	 screen_write_collect_end(struct screen_write_ctx *);
2867 void	 screen_write_collect_add(struct screen_write_ctx *,
2868 	     const struct grid_cell *);
2869 void	 screen_write_cell(struct screen_write_ctx *, const struct grid_cell *);
2870 void	 screen_write_setselection(struct screen_write_ctx *, u_char *, u_int);
2871 void	 screen_write_rawstring(struct screen_write_ctx *, u_char *, u_int);
2872 void	 screen_write_alternateon(struct screen_write_ctx *,
2873 	     struct grid_cell *, int);
2874 void	 screen_write_alternateoff(struct screen_write_ctx *,
2875 	     struct grid_cell *, int);
2876 
2877 /* screen-redraw.c */
2878 void	 screen_redraw_screen(struct client *);
2879 void	 screen_redraw_pane(struct client *, struct window_pane *);
2880 
2881 /* screen.c */
2882 void	 screen_init(struct screen *, u_int, u_int, u_int);
2883 void	 screen_reinit(struct screen *);
2884 void	 screen_free(struct screen *);
2885 void	 screen_reset_tabs(struct screen *);
2886 void	 screen_set_cursor_style(u_int, enum screen_cursor_style *, int *);
2887 void	 screen_set_cursor_colour(struct screen *, int);
2888 int	 screen_set_title(struct screen *, const char *);
2889 void	 screen_set_path(struct screen *, const char *);
2890 void	 screen_push_title(struct screen *);
2891 void	 screen_pop_title(struct screen *);
2892 void	 screen_resize(struct screen *, u_int, u_int, int);
2893 void	 screen_resize_cursor(struct screen *, u_int, u_int, int, int, int);
2894 void	 screen_set_selection(struct screen *, u_int, u_int, u_int, u_int,
2895 	     u_int, int, struct grid_cell *);
2896 void	 screen_clear_selection(struct screen *);
2897 void	 screen_hide_selection(struct screen *);
2898 int	 screen_check_selection(struct screen *, u_int, u_int);
2899 void	 screen_select_cell(struct screen *, struct grid_cell *,
2900 	     const struct grid_cell *);
2901 void	 screen_alternate_on(struct screen *, struct grid_cell *, int);
2902 void	 screen_alternate_off(struct screen *, struct grid_cell *, int);
2903 const char *screen_mode_to_string(int);
2904 
2905 /* window.c */
2906 extern struct windows windows;
2907 extern struct window_pane_tree all_window_panes;
2908 int		 window_cmp(struct window *, struct window *);
2909 RB_PROTOTYPE(windows, window, entry, window_cmp);
2910 int		 winlink_cmp(struct winlink *, struct winlink *);
2911 RB_PROTOTYPE(winlinks, winlink, entry, winlink_cmp);
2912 int		 window_pane_cmp(struct window_pane *, struct window_pane *);
2913 RB_PROTOTYPE(window_pane_tree, window_pane, tree_entry, window_pane_cmp);
2914 struct winlink	*winlink_find_by_index(struct winlinks *, int);
2915 struct winlink	*winlink_find_by_window(struct winlinks *, struct window *);
2916 struct winlink	*winlink_find_by_window_id(struct winlinks *, u_int);
2917 u_int		 winlink_count(struct winlinks *);
2918 struct winlink	*winlink_add(struct winlinks *, int);
2919 void		 winlink_set_window(struct winlink *, struct window *);
2920 void		 winlink_remove(struct winlinks *, struct winlink *);
2921 struct winlink	*winlink_next(struct winlink *);
2922 struct winlink	*winlink_previous(struct winlink *);
2923 struct winlink	*winlink_next_by_number(struct winlink *, struct session *,
2924 		     int);
2925 struct winlink	*winlink_previous_by_number(struct winlink *, struct session *,
2926 		     int);
2927 void		 winlink_stack_push(struct winlink_stack *, struct winlink *);
2928 void		 winlink_stack_remove(struct winlink_stack *, struct winlink *);
2929 struct window	*window_find_by_id_str(const char *);
2930 struct window	*window_find_by_id(u_int);
2931 void		 window_update_activity(struct window *);
2932 struct window	*window_create(u_int, u_int, u_int, u_int);
2933 void		 window_pane_set_event(struct window_pane *);
2934 struct window_pane *window_get_active_at(struct window *, u_int, u_int);
2935 struct window_pane *window_find_string(struct window *, const char *);
2936 int		 window_has_pane(struct window *, struct window_pane *);
2937 int		 window_set_active_pane(struct window *, struct window_pane *,
2938 		     int);
2939 void		 window_update_focus(struct window *);
2940 void		 window_pane_update_focus(struct window_pane *);
2941 void		 window_redraw_active_switch(struct window *,
2942 		     struct window_pane *);
2943 struct window_pane *window_add_pane(struct window *, struct window_pane *,
2944 		     u_int, int);
2945 void		 window_resize(struct window *, u_int, u_int, int, int);
2946 void		 window_pane_send_resize(struct window_pane *, u_int, u_int);
2947 int		 window_zoom(struct window_pane *);
2948 int		 window_unzoom(struct window *);
2949 int		 window_push_zoom(struct window *, int, int);
2950 int		 window_pop_zoom(struct window *);
2951 void		 window_lost_pane(struct window *, struct window_pane *);
2952 void		 window_remove_pane(struct window *, struct window_pane *);
2953 struct window_pane *window_pane_at_index(struct window *, u_int);
2954 struct window_pane *window_pane_next_by_number(struct window *,
2955 			struct window_pane *, u_int);
2956 struct window_pane *window_pane_previous_by_number(struct window *,
2957 			struct window_pane *, u_int);
2958 int		 window_pane_index(struct window_pane *, u_int *);
2959 u_int		 window_count_panes(struct window *);
2960 void		 window_destroy_panes(struct window *);
2961 struct window_pane *window_pane_find_by_id_str(const char *);
2962 struct window_pane *window_pane_find_by_id(u_int);
2963 int		 window_pane_destroy_ready(struct window_pane *);
2964 void		 window_pane_resize(struct window_pane *, u_int, u_int);
2965 int		 window_pane_set_mode(struct window_pane *,
2966 		     struct window_pane *, const struct window_mode *,
2967 		     struct cmd_find_state *, struct args *);
2968 void		 window_pane_reset_mode(struct window_pane *);
2969 void		 window_pane_reset_mode_all(struct window_pane *);
2970 int		 window_pane_key(struct window_pane *, struct client *,
2971 		     struct session *, struct winlink *, key_code,
2972 		     struct mouse_event *);
2973 int		 window_pane_visible(struct window_pane *);
2974 u_int		 window_pane_search(struct window_pane *, const char *, int,
2975 		     int);
2976 const char	*window_printable_flags(struct winlink *, int);
2977 struct window_pane *window_pane_find_up(struct window_pane *);
2978 struct window_pane *window_pane_find_down(struct window_pane *);
2979 struct window_pane *window_pane_find_left(struct window_pane *);
2980 struct window_pane *window_pane_find_right(struct window_pane *);
2981 void		 window_set_name(struct window *, const char *);
2982 void		 window_add_ref(struct window *, const char *);
2983 void		 window_remove_ref(struct window *, const char *);
2984 void		 winlink_clear_flags(struct winlink *);
2985 int		 winlink_shuffle_up(struct session *, struct winlink *, int);
2986 int		 window_pane_start_input(struct window_pane *,
2987 		     struct cmdq_item *, char **);
2988 void		*window_pane_get_new_data(struct window_pane *,
2989 		     struct window_pane_offset *, size_t *);
2990 void		 window_pane_update_used_data(struct window_pane *,
2991 		     struct window_pane_offset *, size_t);
2992 void		 window_set_fill_character(struct window *);
2993 
2994 /* layout.c */
2995 u_int		 layout_count_cells(struct layout_cell *);
2996 struct layout_cell *layout_create_cell(struct layout_cell *);
2997 void		 layout_free_cell(struct layout_cell *);
2998 void		 layout_print_cell(struct layout_cell *, const char *, u_int);
2999 void		 layout_destroy_cell(struct window *, struct layout_cell *,
3000 		     struct layout_cell **);
3001 void		 layout_resize_layout(struct window *, struct layout_cell *,
3002 		     enum layout_type, int, int);
3003 struct layout_cell *layout_search_by_border(struct layout_cell *, u_int, u_int);
3004 void		 layout_set_size(struct layout_cell *, u_int, u_int, u_int,
3005 		     u_int);
3006 void		 layout_make_leaf(struct layout_cell *, struct window_pane *);
3007 void		 layout_make_node(struct layout_cell *, enum layout_type);
3008 void		 layout_fix_offsets(struct window *);
3009 void		 layout_fix_panes(struct window *, struct window_pane *);
3010 void		 layout_resize_adjust(struct window *, struct layout_cell *,
3011 		     enum layout_type, int);
3012 void		 layout_init(struct window *, struct window_pane *);
3013 void		 layout_free(struct window *);
3014 void		 layout_resize(struct window *, u_int, u_int);
3015 void		 layout_resize_pane(struct window_pane *, enum layout_type,
3016 		     int, int);
3017 void		 layout_resize_pane_to(struct window_pane *, enum layout_type,
3018 		     u_int);
3019 void		 layout_assign_pane(struct layout_cell *, struct window_pane *,
3020 		     int);
3021 struct layout_cell *layout_split_pane(struct window_pane *, enum layout_type,
3022 		     int, int);
3023 void		 layout_close_pane(struct window_pane *);
3024 int		 layout_spread_cell(struct window *, struct layout_cell *);
3025 void		 layout_spread_out(struct window_pane *);
3026 
3027 /* layout-custom.c */
3028 char		*layout_dump(struct layout_cell *);
3029 int		 layout_parse(struct window *, const char *, char **);
3030 
3031 /* layout-set.c */
3032 int		 layout_set_lookup(const char *);
3033 u_int		 layout_set_select(struct window *, u_int);
3034 u_int		 layout_set_next(struct window *);
3035 u_int		 layout_set_previous(struct window *);
3036 
3037 /* mode-tree.c */
3038 typedef void (*mode_tree_build_cb)(void *, struct mode_tree_sort_criteria *,
3039 				   uint64_t *, const char *);
3040 typedef void (*mode_tree_draw_cb)(void *, void *, struct screen_write_ctx *,
3041 	     u_int, u_int);
3042 typedef int (*mode_tree_search_cb)(void *, void *, const char *);
3043 typedef void (*mode_tree_menu_cb)(void *, struct client *, key_code);
3044 typedef u_int (*mode_tree_height_cb)(void *, u_int);
3045 typedef key_code (*mode_tree_key_cb)(void *, void *, u_int);
3046 typedef void (*mode_tree_each_cb)(void *, void *, struct client *, key_code);
3047 u_int	 mode_tree_count_tagged(struct mode_tree_data *);
3048 void	*mode_tree_get_current(struct mode_tree_data *);
3049 const char *mode_tree_get_current_name(struct mode_tree_data *);
3050 void	 mode_tree_expand_current(struct mode_tree_data *);
3051 void	 mode_tree_collapse_current(struct mode_tree_data *);
3052 void	 mode_tree_expand(struct mode_tree_data *, uint64_t);
3053 int	 mode_tree_set_current(struct mode_tree_data *, uint64_t);
3054 void	 mode_tree_each_tagged(struct mode_tree_data *, mode_tree_each_cb,
3055 	     struct client *, key_code, int);
3056 void	 mode_tree_up(struct mode_tree_data *, int);
3057 void	 mode_tree_down(struct mode_tree_data *, int);
3058 struct mode_tree_data *mode_tree_start(struct window_pane *, struct args *,
3059 	     mode_tree_build_cb, mode_tree_draw_cb, mode_tree_search_cb,
3060 	     mode_tree_menu_cb, mode_tree_height_cb, mode_tree_key_cb, void *,
3061 	     const struct menu_item *, const char **, u_int, struct screen **);
3062 void	 mode_tree_zoom(struct mode_tree_data *, struct args *);
3063 void	 mode_tree_build(struct mode_tree_data *);
3064 void	 mode_tree_free(struct mode_tree_data *);
3065 void	 mode_tree_resize(struct mode_tree_data *, u_int, u_int);
3066 struct mode_tree_item *mode_tree_add(struct mode_tree_data *,
3067 	     struct mode_tree_item *, void *, uint64_t, const char *,
3068 	     const char *, int);
3069 void	 mode_tree_draw_as_parent(struct mode_tree_item *);
3070 void	 mode_tree_no_tag(struct mode_tree_item *);
3071 void	 mode_tree_remove(struct mode_tree_data *, struct mode_tree_item *);
3072 void	 mode_tree_draw(struct mode_tree_data *);
3073 int	 mode_tree_key(struct mode_tree_data *, struct client *, key_code *,
3074 	     struct mouse_event *, u_int *, u_int *);
3075 void	 mode_tree_run_command(struct client *, struct cmd_find_state *,
3076 	     const char *, const char *);
3077 
3078 /* window-buffer.c */
3079 extern const struct window_mode window_buffer_mode;
3080 
3081 /* window-tree.c */
3082 extern const struct window_mode window_tree_mode;
3083 
3084 /* window-clock.c */
3085 extern const struct window_mode window_clock_mode;
3086 extern const char window_clock_table[14][5][5];
3087 
3088 /* window-client.c */
3089 extern const struct window_mode window_client_mode;
3090 
3091 /* window-copy.c */
3092 extern const struct window_mode window_copy_mode;
3093 extern const struct window_mode window_view_mode;
3094 void printflike(3, 4) window_copy_add(struct window_pane *, int, const char *,
3095 		     ...);
3096 void printflike(3, 0) window_copy_vadd(struct window_pane *, int, const char *,
3097 		     va_list);
3098 void		 window_copy_pageup(struct window_pane *, int);
3099 void		 window_copy_start_drag(struct client *, struct mouse_event *);
3100 char		*window_copy_get_word(struct window_pane *, u_int, u_int);
3101 char		*window_copy_get_line(struct window_pane *, u_int);
3102 
3103 /* window-option.c */
3104 extern const struct window_mode window_customize_mode;
3105 
3106 /* names.c */
3107 void	 check_window_name(struct window *);
3108 char	*default_window_name(struct window *);
3109 char	*parse_window_name(const char *);
3110 
3111 /* control.c */
3112 void	control_discard(struct client *);
3113 void	control_start(struct client *);
3114 void	control_stop(struct client *);
3115 void	control_set_pane_on(struct client *, struct window_pane *);
3116 void	control_set_pane_off(struct client *, struct window_pane *);
3117 void	control_continue_pane(struct client *, struct window_pane *);
3118 void	control_pause_pane(struct client *, struct window_pane *);
3119 struct window_pane_offset *control_pane_offset(struct client *,
3120 	   struct window_pane *, int *);
3121 void	control_reset_offsets(struct client *);
3122 void printflike(2, 3) control_write(struct client *, const char *, ...);
3123 void	control_write_output(struct client *, struct window_pane *);
3124 int	control_all_done(struct client *);
3125 void	control_add_sub(struct client *, const char *, enum control_sub_type,
3126     	   int, const char *);
3127 void	control_remove_sub(struct client *, const char *);
3128 
3129 /* control-notify.c */
3130 void	control_notify_input(struct client *, struct window_pane *,
3131 	    const u_char *, size_t);
3132 void	control_notify_pane_mode_changed(int);
3133 void	control_notify_window_layout_changed(struct window *);
3134 void	control_notify_window_pane_changed(struct window *);
3135 void	control_notify_window_unlinked(struct session *, struct window *);
3136 void	control_notify_window_linked(struct session *, struct window *);
3137 void	control_notify_window_renamed(struct window *);
3138 void	control_notify_client_session_changed(struct client *);
3139 void	control_notify_client_detached(struct client *);
3140 void	control_notify_session_renamed(struct session *);
3141 void	control_notify_session_created(struct session *);
3142 void	control_notify_session_closed(struct session *);
3143 void	control_notify_session_window_changed(struct session *);
3144 
3145 /* session.c */
3146 extern struct sessions sessions;
3147 extern u_int next_session_id;
3148 int	session_cmp(struct session *, struct session *);
3149 RB_PROTOTYPE(sessions, session, entry, session_cmp);
3150 int		 session_alive(struct session *);
3151 struct session	*session_find(const char *);
3152 struct session	*session_find_by_id_str(const char *);
3153 struct session	*session_find_by_id(u_int);
3154 struct session	*session_create(const char *, const char *, const char *,
3155 		     struct environ *, struct options *, struct termios *);
3156 void		 session_destroy(struct session *, int,	 const char *);
3157 void		 session_add_ref(struct session *, const char *);
3158 void		 session_remove_ref(struct session *, const char *);
3159 char		*session_check_name(const char *);
3160 void		 session_update_activity(struct session *, struct timeval *);
3161 struct session	*session_next_session(struct session *);
3162 struct session	*session_previous_session(struct session *);
3163 struct winlink	*session_new(struct session *, const char *, int, char **,
3164 		     const char *, const char *, int, char **);
3165 struct winlink	*session_attach(struct session *, struct window *, int,
3166 		     char **);
3167 int		 session_detach(struct session *, struct winlink *);
3168 int		 session_has(struct session *, struct window *);
3169 int		 session_is_linked(struct session *, struct window *);
3170 int		 session_next(struct session *, int);
3171 int		 session_previous(struct session *, int);
3172 int		 session_select(struct session *, int);
3173 int		 session_last(struct session *);
3174 int		 session_set_current(struct session *, struct winlink *);
3175 struct session_group *session_group_contains(struct session *);
3176 struct session_group *session_group_find(const char *);
3177 struct session_group *session_group_new(const char *);
3178 void		 session_group_add(struct session_group *, struct session *);
3179 void		 session_group_synchronize_to(struct session *);
3180 void		 session_group_synchronize_from(struct session *);
3181 u_int		 session_group_count(struct session_group *);
3182 u_int		 session_group_attached_count(struct session_group *);
3183 void		 session_renumber_windows(struct session *);
3184 
3185 /* utf8.c */
3186 utf8_char	 utf8_build_one(u_char);
3187 enum utf8_state	 utf8_from_data(const struct utf8_data *, utf8_char *);
3188 void		 utf8_to_data(utf8_char, struct utf8_data *);
3189 void		 utf8_set(struct utf8_data *, u_char);
3190 void		 utf8_copy(struct utf8_data *, const struct utf8_data *);
3191 enum utf8_state	 utf8_open(struct utf8_data *, u_char);
3192 enum utf8_state	 utf8_append(struct utf8_data *, u_char);
3193 int		 utf8_isvalid(const char *);
3194 int		 utf8_strvis(char *, const char *, size_t, int);
3195 int		 utf8_stravis(char **, const char *, int);
3196 int		 utf8_stravisx(char **, const char *, size_t, int);
3197 char		*utf8_sanitize(const char *);
3198 size_t		 utf8_strlen(const struct utf8_data *);
3199 u_int		 utf8_strwidth(const struct utf8_data *, ssize_t);
3200 struct utf8_data *utf8_fromcstr(const char *);
3201 char		*utf8_tocstr(struct utf8_data *);
3202 u_int		 utf8_cstrwidth(const char *);
3203 char		*utf8_padcstr(const char *, u_int);
3204 char		*utf8_rpadcstr(const char *, u_int);
3205 int		 utf8_cstrhas(const char *, const struct utf8_data *);
3206 
3207 /* osdep-*.c */
3208 char		*osdep_get_name(int, char *);
3209 char		*osdep_get_cwd(int);
3210 struct event_base *osdep_event_init(void);
3211 
3212 /* log.c */
3213 void	log_add_level(void);
3214 int	log_get_level(void);
3215 void	log_open(const char *);
3216 void	log_toggle(const char *);
3217 void	log_close(void);
3218 void printflike(1, 2) log_debug(const char *, ...);
3219 __dead void printflike(1, 2) fatal(const char *, ...);
3220 __dead void printflike(1, 2) fatalx(const char *, ...);
3221 
3222 /* menu.c */
3223 #define MENU_NOMOUSE 0x1
3224 #define MENU_TAB 0x2
3225 #define MENU_STAYOPEN 0x4
3226 struct menu	*menu_create(const char *);
3227 void		 menu_add_items(struct menu *, const struct menu_item *,
3228 		    struct cmdq_item *, struct client *,
3229 		    struct cmd_find_state *);
3230 void		 menu_add_item(struct menu *, const struct menu_item *,
3231 		    struct cmdq_item *, struct client *,
3232 		    struct cmd_find_state *);
3233 void		 menu_free(struct menu *);
3234 struct menu_data *menu_prepare(struct menu *, int, struct cmdq_item *, u_int,
3235 		    u_int, struct client *, struct cmd_find_state *,
3236 		    menu_choice_cb, void *);
3237 int		 menu_display(struct menu *, int, struct cmdq_item *, u_int,
3238 		    u_int, struct client *, struct cmd_find_state *,
3239 		    menu_choice_cb, void *);
3240 struct screen	*menu_mode_cb(struct client *, void *, u_int *, u_int *);
3241 void		 menu_check_cb(struct client *, void *, u_int, u_int, u_int,
3242 		    struct overlay_ranges *);
3243 void		 menu_draw_cb(struct client *, void *,
3244 		    struct screen_redraw_ctx *);
3245 void		 menu_free_cb(struct client *, void *);
3246 int		 menu_key_cb(struct client *, void *, struct key_event *);
3247 
3248 /* popup.c */
3249 #define POPUP_CLOSEEXIT 0x1
3250 #define POPUP_CLOSEEXITZERO 0x2
3251 #define POPUP_INTERNAL 0x4
3252 typedef void (*popup_close_cb)(int, void *);
3253 typedef void (*popup_finish_edit_cb)(char *, size_t, void *);
3254 int		 popup_display(int, int, struct cmdq_item *, u_int, u_int,
3255 		    u_int, u_int, struct environ *, const char *, int, char **,
3256 		    const char *, const char *, struct client *,
3257 		    struct session *, const char *, const char *,
3258 		    popup_close_cb, void *);
3259 int		 popup_editor(struct client *, const char *, size_t,
3260 		    popup_finish_edit_cb, void *);
3261 
3262 /* style.c */
3263 int		 style_parse(struct style *,const struct grid_cell *,
3264 		     const char *);
3265 const char	*style_tostring(struct style *);
3266 void		 style_add(struct grid_cell *, struct options *,
3267 		     const char *, struct format_tree *);
3268 void		 style_apply(struct grid_cell *, struct options *,
3269 		     const char *, struct format_tree *);
3270 void		 style_set(struct style *, const struct grid_cell *);
3271 void		 style_copy(struct style *, struct style *);
3272 
3273 /* spawn.c */
3274 struct winlink	*spawn_window(struct spawn_context *, char **);
3275 struct window_pane *spawn_pane(struct spawn_context *, char **);
3276 
3277 /* regsub.c */
3278 char		*regsub(const char *, const char *, const char *, int);
3279 
3280 /* server-acl.c */
3281 void			 server_acl_init(void);
3282 struct server_acl_user	*server_acl_user_find(uid_t);
3283 void 			 server_acl_display(struct cmdq_item *);
3284 void			 server_acl_user_allow(uid_t);
3285 void			 server_acl_user_deny(uid_t);
3286 void			 server_acl_user_allow_write(uid_t);
3287 void			 server_acl_user_deny_write(uid_t);
3288 int			 server_acl_join(struct client *);
3289 uid_t			 server_acl_get_uid(struct server_acl_user *);
3290 
3291 #endif /* TMUX_H */
3292