xref: /netbsd-src/external/bsd/tmux/dist/tmux.h (revision b7b7574d3bf8eeb51a1fa3977b59142ec6434a55)
1 /* $Id: tmux.h,v 1.4 2014/01/07 02:11:29 joerg Exp $ */
2 
3 /*
4  * Copyright (c) 2007 Nicholas Marriott <nicm@users.sourceforge.net>
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 #define PROTOCOL_VERSION 6
23 
24 #include <sys/param.h>
25 #include <sys/time.h>
26 #include <sys/uio.h>
27 
28 #include <event.h>
29 #include <limits.h>
30 #include <signal.h>
31 #include <stdarg.h>
32 #include <stdio.h>
33 #include <termios.h>
34 
35 #include "array.h"
36 
37 #include "compat.h"
38 
39 extern char    *__progname;
40 extern char   **environ;
41 
42 /* Default configuration files. */
43 #define DEFAULT_CFG ".tmux.conf"
44 #define SYSTEM_CFG "/etc/tmux.conf"
45 
46 /* Default prompt history length. */
47 #define PROMPT_HISTORY 100
48 
49 /*
50  * Minimum layout cell size, NOT including separator line. The scroll region
51  * cannot be one line in height so this must be at least two.
52  */
53 #define PANE_MINIMUM 2
54 
55 /* Automatic name refresh interval, in milliseconds. */
56 #define NAME_INTERVAL 500
57 
58 /* Maximum data to buffer for output before suspending writing to a tty. */
59 #define BACKOFF_THRESHOLD 16384
60 
61 /*
62  * Maximum sizes of strings in message data. Don't forget to bump
63  * PROTOCOL_VERSION if any of these change!
64  */
65 #define COMMAND_LENGTH 2048	/* packed argv size */
66 #define TERMINAL_LENGTH 128	/* length of TERM environment variable */
67 #define ENVIRON_LENGTH 1024	/* environment variable length */
68 
69 /*
70  * UTF-8 data size. This must be big enough to hold combined characters as well
71  * as single.
72  */
73 #define UTF8_SIZE 9
74 
75 /* Fatal errors. */
76 #define fatal(msg) log_fatal("%s: %s", __func__, msg);
77 #define fatalx(msg) log_fatalx("%s: %s", __func__, msg);
78 
79 /* Definition to shut gcc up about unused arguments. */
80 #define unused __attribute__ ((unused))
81 
82 /* Attribute to make gcc check printf-like arguments. */
83 #define vprintflike2 __attribute__ ((format (printf, 2, 0)))
84 #define vprintflike3 __attribute__ ((format (printf, 3, 0)))
85 #define vprintflike5 __attribute__ ((format (printf, 5, 0)))
86 #define printflike1 __attribute__ ((format (printf, 1, 2)))
87 #define printflike2 __attribute__ ((format (printf, 2, 3)))
88 #define printflike3 __attribute__ ((format (printf, 3, 4)))
89 #define printflike4 __attribute__ ((format (printf, 4, 5)))
90 #define printflike5 __attribute__ ((format (printf, 5, 6)))
91 
92 /* Number of items in array. */
93 #ifndef nitems
94 #define nitems(_a) (sizeof((_a)) / sizeof((_a)[0]))
95 #endif
96 
97 /* Bell option values. */
98 #define BELL_NONE 0
99 #define BELL_ANY 1
100 #define BELL_CURRENT 2
101 
102 /* Special key codes. */
103 #define KEYC_NONE 0xfff
104 #define KEYC_BASE 0x1000
105 
106 /* Key modifier bits. */
107 #define KEYC_ESCAPE 0x2000
108 #define KEYC_CTRL 0x4000
109 #define KEYC_SHIFT 0x8000
110 #define KEYC_PREFIX 0x10000
111 
112 /* Mask to obtain key w/o modifiers. */
113 #define KEYC_MASK_MOD (KEYC_ESCAPE|KEYC_CTRL|KEYC_SHIFT|KEYC_PREFIX)
114 #define KEYC_MASK_KEY (~KEYC_MASK_MOD)
115 
116 /* Other key codes. */
117 enum key_code {
118 	/* Mouse key. */
119 	KEYC_MOUSE = KEYC_BASE,
120 
121 	/* Backspace key. */
122 	KEYC_BSPACE,
123 
124 	/* Function keys. */
125 	KEYC_F1,
126 	KEYC_F2,
127 	KEYC_F3,
128 	KEYC_F4,
129 	KEYC_F5,
130 	KEYC_F6,
131 	KEYC_F7,
132 	KEYC_F8,
133 	KEYC_F9,
134 	KEYC_F10,
135 	KEYC_F11,
136 	KEYC_F12,
137 	KEYC_F13,
138 	KEYC_F14,
139 	KEYC_F15,
140 	KEYC_F16,
141 	KEYC_F17,
142 	KEYC_F18,
143 	KEYC_F19,
144 	KEYC_F20,
145 	KEYC_IC,
146 	KEYC_DC,
147 	KEYC_HOME,
148 	KEYC_END,
149 	KEYC_NPAGE,
150 	KEYC_PPAGE,
151 	KEYC_BTAB,
152 
153 	/* Arrow keys. */
154 	KEYC_UP,
155 	KEYC_DOWN,
156 	KEYC_LEFT,
157 	KEYC_RIGHT,
158 
159 	/* Numeric keypad. */
160 	KEYC_KP_SLASH,
161 	KEYC_KP_STAR,
162 	KEYC_KP_MINUS,
163 	KEYC_KP_SEVEN,
164 	KEYC_KP_EIGHT,
165 	KEYC_KP_NINE,
166 	KEYC_KP_PLUS,
167 	KEYC_KP_FOUR,
168 	KEYC_KP_FIVE,
169 	KEYC_KP_SIX,
170 	KEYC_KP_ONE,
171 	KEYC_KP_TWO,
172 	KEYC_KP_THREE,
173 	KEYC_KP_ENTER,
174 	KEYC_KP_ZERO,
175 	KEYC_KP_PERIOD,
176 };
177 
178 /* Termcap codes. */
179 enum tty_code_code {
180 	TTYC_AX = 0,
181 	TTYC_ACSC,	/* acs_chars, ac */
182 	TTYC_BEL,	/* bell, bl */
183 	TTYC_BLINK,	/* enter_blink_mode, mb */
184 	TTYC_BOLD,	/* enter_bold_mode, md */
185 	TTYC_CC,	/* set colour cursor, Cc */
186 	TTYC_CIVIS,	/* cursor_invisible, vi */
187 	TTYC_CLEAR,	/* clear_screen, cl */
188 	TTYC_CNORM,	/* cursor_normal, ve */
189 	TTYC_COLORS,	/* max_colors, Co */
190 	TTYC_CR,	/* restore cursor colour, Cr */
191 	TTYC_CS1,	/* set cursor style, Cs */
192 	TTYC_CSR,	/* change_scroll_region, cs */
193 	TTYC_CSR1,	/* reset cursor style, Csr */
194 	TTYC_CUB,	/* parm_left_cursor, LE */
195 	TTYC_CUB1,	/* cursor_left, le */
196 	TTYC_CUD,	/* parm_down_cursor, DO */
197 	TTYC_CUD1,	/* cursor_down, do */
198 	TTYC_CUF,	/* parm_right_cursor, RI */
199 	TTYC_CUF1,	/* cursor_right, nd */
200 	TTYC_CUP,	/* cursor_address, cm */
201 	TTYC_CUU,	/* parm_up_cursor, UP */
202 	TTYC_CUU1,	/* cursor_up, up */
203 	TTYC_DCH,	/* parm_dch, DC */
204 	TTYC_DCH1,	/* delete_character, dc */
205 	TTYC_DIM,	/* enter_dim_mode, mh */
206 	TTYC_DL,	/* parm_delete_line, DL */
207 	TTYC_DL1,	/* delete_line, dl */
208 	TTYC_EL,	/* clr_eol, ce */
209 	TTYC_EL1,	/* clr_bol, cb */
210 	TTYC_ENACS,	/* ena_acs, eA */
211 	TTYC_FSL,	/* from_status_line, fsl */
212 	TTYC_HOME,	/* cursor_home, ho */
213 	TTYC_HPA,	/* column_address, ch */
214 	TTYC_ICH,	/* parm_ich, IC */
215 	TTYC_ICH1,	/* insert_character, ic */
216 	TTYC_IL,	/* parm_insert_line, IL */
217 	TTYC_IL1,	/* insert_line, il */
218 	TTYC_INVIS,	/* enter_secure_mode, mk */
219 	TTYC_IS1,	/* init_1string, i1 */
220 	TTYC_IS2,	/* init_2string, i2 */
221 	TTYC_IS3,	/* init_3string, i3 */
222 	TTYC_KCBT,	/* key_btab, kB */
223 	TTYC_KCUB1,	/* key_left, kl */
224 	TTYC_KCUD1,	/* key_down, kd */
225 	TTYC_KCUF1,	/* key_right, kr */
226 	TTYC_KCUU1,	/* key_up, ku */
227 	TTYC_KDC2,
228 	TTYC_KDC3,
229 	TTYC_KDC4,
230 	TTYC_KDC5,
231 	TTYC_KDC6,
232 	TTYC_KDC7,
233 	TTYC_KDCH1,	/* key_dc, kD */
234 	TTYC_KDN2,
235 	TTYC_KDN3,
236 	TTYC_KDN4,
237 	TTYC_KDN5,
238 	TTYC_KDN6,
239 	TTYC_KDN7,
240 	TTYC_KEND,	/* key_end, ke */
241 	TTYC_KEND2,
242 	TTYC_KEND3,
243 	TTYC_KEND4,
244 	TTYC_KEND5,
245 	TTYC_KEND6,
246 	TTYC_KEND7,
247 	TTYC_KF1,	/* key_f1, k1 */
248 	TTYC_KF10,	/* key_f10, k; */
249 	TTYC_KF11,	/* key_f11, F1 */
250 	TTYC_KF12,	/* key_f12, F2 */
251 	TTYC_KF13,	/* key_f13, F3 */
252 	TTYC_KF14,	/* key_f14, F4 */
253 	TTYC_KF15,	/* key_f15, F5 */
254 	TTYC_KF16,	/* key_f16, F6 */
255 	TTYC_KF17,	/* key_f17, F7 */
256 	TTYC_KF18,	/* key_f18, F8 */
257 	TTYC_KF19,	/* key_f19, F9 */
258 	TTYC_KF2,	/* key_f2, k2 */
259 	TTYC_KF20,	/* key_f20, F10 */
260 	TTYC_KF3,	/* key_f3, k3 */
261 	TTYC_KF4,	/* key_f4, k4 */
262 	TTYC_KF5,	/* key_f5, k5 */
263 	TTYC_KF6,	/* key_f6, k6 */
264 	TTYC_KF7,	/* key_f7, k7 */
265 	TTYC_KF8,	/* key_f8, k8 */
266 	TTYC_KF9,	/* key_f9, k9 */
267 	TTYC_KHOM2,
268 	TTYC_KHOM3,
269 	TTYC_KHOM4,
270 	TTYC_KHOM5,
271 	TTYC_KHOM6,
272 	TTYC_KHOM7,
273 	TTYC_KHOME,	/* key_home, kh */
274 	TTYC_KIC2,
275 	TTYC_KIC3,
276 	TTYC_KIC4,
277 	TTYC_KIC5,
278 	TTYC_KIC6,
279 	TTYC_KIC7,
280 	TTYC_KICH1,	/* key_ic, kI */
281 	TTYC_KLFT2,
282 	TTYC_KLFT3,
283 	TTYC_KLFT4,
284 	TTYC_KLFT5,
285 	TTYC_KLFT6,
286 	TTYC_KLFT7,
287 	TTYC_KMOUS,	/* key_mouse, Km */
288 	TTYC_KNP,	/* key_npage, kN */
289 	TTYC_KNXT2,
290 	TTYC_KNXT3,
291 	TTYC_KNXT4,
292 	TTYC_KNXT5,
293 	TTYC_KNXT6,
294 	TTYC_KNXT7,
295 	TTYC_KPP,	/* key_ppage, kP */
296 	TTYC_KPRV2,
297 	TTYC_KPRV3,
298 	TTYC_KPRV4,
299 	TTYC_KPRV5,
300 	TTYC_KPRV6,
301 	TTYC_KPRV7,
302 	TTYC_KRIT2,
303 	TTYC_KRIT3,
304 	TTYC_KRIT4,
305 	TTYC_KRIT5,
306 	TTYC_KRIT6,
307 	TTYC_KRIT7,
308 	TTYC_KUP2,
309 	TTYC_KUP3,
310 	TTYC_KUP4,
311 	TTYC_KUP5,
312 	TTYC_KUP6,
313 	TTYC_KUP7,
314 	TTYC_MS,	/* modify xterm(1) selection */
315 	TTYC_OP,	/* orig_pair, op */
316 	TTYC_REV,	/* enter_reverse_mode, mr */
317 	TTYC_RI,	/* scroll_reverse, sr */
318 	TTYC_RMACS,	/* exit_alt_charset_mode */
319 	TTYC_RMCUP,	/* exit_ca_mode, te */
320 	TTYC_RMIR,	/* exit_insert_mode, ei */
321 	TTYC_RMKX,	/* keypad_local, ke */
322 	TTYC_SETAB,	/* set_a_background, AB */
323 	TTYC_SETAF,	/* set_a_foreground, AF */
324 	TTYC_SGR0,	/* exit_attribute_mode, me */
325 	TTYC_SITM,	/* enter_italics_mode, it */
326 	TTYC_SMACS,	/* enter_alt_charset_mode, as */
327 	TTYC_SMCUP,	/* enter_ca_mode, ti */
328 	TTYC_SMIR,	/* enter_insert_mode, im */
329 	TTYC_SMKX,	/* keypad_xmit, ks */
330 	TTYC_SMSO,	/* enter_standout_mode, so */
331 	TTYC_SMUL,	/* enter_underline_mode, us */
332 	TTYC_TSL,	/* to_status_line, tsl */
333 	TTYC_VPA,	/* row_address, cv */
334 	TTYC_XENL,	/* eat_newline_glitch, xn */
335 	TTYC_XT,	/* xterm(1)-compatible title, XT */
336 };
337 #define NTTYCODE (TTYC_XT + 1)
338 
339 /* Termcap types. */
340 enum tty_code_type {
341 	TTYCODE_NONE = 0,
342 	TTYCODE_STRING,
343 	TTYCODE_NUMBER,
344 	TTYCODE_FLAG,
345 };
346 
347 /* Termcap code. */
348 struct tty_code {
349 	enum tty_code_type	type;
350 	union {
351 		char	       *string;
352 		int		number;
353 		int		flag;
354 	} value;
355 };
356 
357 /* Entry in terminal code table. */
358 struct tty_term_code_entry {
359 	enum tty_code_code	code;
360 	enum tty_code_type	type;
361 	const char	       *name;
362 };
363 
364 /* Message codes. */
365 enum msgtype {
366 	MSG_COMMAND,
367 	MSG_DETACH,
368 	MSG_ERROR,
369 	MSG_EXIT,
370 	MSG_EXITED,
371 	MSG_EXITING,
372 	MSG_IDENTIFY,
373 	MSG_PRINT,
374 	MSG_READY,
375 	MSG_RESIZE,
376 	MSG_SHUTDOWN,
377 	MSG_SUSPEND,
378 	MSG_VERSION,
379 	MSG_WAKEUP,
380 	MSG_ENVIRON,
381 	MSG_UNLOCK,
382 	MSG_LOCK,
383 	MSG_SHELL,
384 	MSG_STDERR,
385 	MSG_STDOUT,
386 	MSG_DETACHKILL
387 };
388 
389 /*
390  * Message data.
391  *
392  * Don't forget to bump PROTOCOL_VERSION if any of these change!
393  */
394 struct msg_command_data {
395 	pid_t		pid;	/* PID from $TMUX or -1 */
396 	int		idx;	/* index from $TMUX or -1 */
397 
398 	int		argc;
399 	char		argv[COMMAND_LENGTH];
400 };
401 
402 struct msg_identify_data {
403 	char		cwd[MAXPATHLEN];
404 
405 	char		term[TERMINAL_LENGTH];
406 
407 #define IDENTIFY_UTF8 0x1
408 #define IDENTIFY_256COLOURS 0x2
409 #define IDENTIFY_88COLOURS 0x4
410 	int		flags;
411 };
412 
413 struct msg_lock_data {
414 	char		cmd[COMMAND_LENGTH];
415 };
416 
417 struct msg_environ_data {
418 	char		var[ENVIRON_LENGTH];
419 };
420 
421 struct msg_shell_data {
422 	char		shell[MAXPATHLEN];
423 };
424 
425 struct msg_exit_data {
426 	int		retcode;
427 };
428 
429 /* Mode key commands. */
430 enum mode_key_cmd {
431 	MODEKEY_NONE,
432 	MODEKEY_OTHER,
433 
434 	/* Editing keys. */
435 	MODEKEYEDIT_BACKSPACE,
436 	MODEKEYEDIT_CANCEL,
437 	MODEKEYEDIT_COMPLETE,
438 	MODEKEYEDIT_CURSORLEFT,
439 	MODEKEYEDIT_CURSORRIGHT,
440 	MODEKEYEDIT_DELETE,
441 	MODEKEYEDIT_DELETELINE,
442 	MODEKEYEDIT_DELETETOENDOFLINE,
443 	MODEKEYEDIT_ENDOFLINE,
444 	MODEKEYEDIT_ENTER,
445 	MODEKEYEDIT_HISTORYDOWN,
446 	MODEKEYEDIT_HISTORYUP,
447 	MODEKEYEDIT_PASTE,
448 	MODEKEYEDIT_STARTOFLINE,
449 	MODEKEYEDIT_SWITCHMODE,
450 	MODEKEYEDIT_SWITCHMODEAPPEND,
451 	MODEKEYEDIT_TRANSPOSECHARS,
452 
453 	/* Menu (choice) keys. */
454 	MODEKEYCHOICE_CANCEL,
455 	MODEKEYCHOICE_CHOOSE,
456 	MODEKEYCHOICE_DOWN,
457 	MODEKEYCHOICE_PAGEDOWN,
458 	MODEKEYCHOICE_PAGEUP,
459 	MODEKEYCHOICE_SCROLLDOWN,
460 	MODEKEYCHOICE_SCROLLUP,
461 	MODEKEYCHOICE_UP,
462 
463 	/* Copy keys. */
464 	MODEKEYCOPY_BACKTOINDENTATION,
465 	MODEKEYCOPY_BOTTOMLINE,
466 	MODEKEYCOPY_CANCEL,
467 	MODEKEYCOPY_CLEARSELECTION,
468 	MODEKEYCOPY_COPYLINE,
469 	MODEKEYCOPY_COPYENDOFLINE,
470 	MODEKEYCOPY_COPYSELECTION,
471 	MODEKEYCOPY_DOWN,
472 	MODEKEYCOPY_ENDOFLINE,
473 	MODEKEYCOPY_GOTOLINE,
474 	MODEKEYCOPY_HALFPAGEDOWN,
475 	MODEKEYCOPY_HALFPAGEUP,
476 	MODEKEYCOPY_HISTORYBOTTOM,
477 	MODEKEYCOPY_HISTORYTOP,
478 	MODEKEYCOPY_JUMP,
479 	MODEKEYCOPY_JUMPAGAIN,
480 	MODEKEYCOPY_JUMPREVERSE,
481 	MODEKEYCOPY_JUMPBACK,
482 	MODEKEYCOPY_LEFT,
483 	MODEKEYCOPY_MIDDLELINE,
484 	MODEKEYCOPY_NEXTPAGE,
485 	MODEKEYCOPY_NEXTSPACE,
486 	MODEKEYCOPY_NEXTSPACEEND,
487 	MODEKEYCOPY_NEXTWORD,
488 	MODEKEYCOPY_NEXTWORDEND,
489 	MODEKEYCOPY_PREVIOUSPAGE,
490 	MODEKEYCOPY_PREVIOUSSPACE,
491 	MODEKEYCOPY_PREVIOUSWORD,
492 	MODEKEYCOPY_RECTANGLETOGGLE,
493 	MODEKEYCOPY_RIGHT,
494 	MODEKEYCOPY_SCROLLDOWN,
495 	MODEKEYCOPY_SCROLLUP,
496 	MODEKEYCOPY_SEARCHAGAIN,
497 	MODEKEYCOPY_SEARCHDOWN,
498 	MODEKEYCOPY_SEARCHREVERSE,
499 	MODEKEYCOPY_SEARCHUP,
500 	MODEKEYCOPY_SELECTLINE,
501 	MODEKEYCOPY_STARTNUMBERPREFIX,
502 	MODEKEYCOPY_STARTOFLINE,
503 	MODEKEYCOPY_STARTSELECTION,
504 	MODEKEYCOPY_TOPLINE,
505 	MODEKEYCOPY_UP,
506 };
507 
508 /* Entry in the default mode key tables. */
509 struct mode_key_entry {
510 	int			key;
511 
512 	/*
513 	 * Editing mode for vi: 0 is edit mode, keys not in the table are
514 	 * returned as MODEKEY_OTHER; 1 is command mode, keys not in the table
515 	 * are returned as MODEKEY_NONE. This is also matched on, allowing some
516 	 * keys to be bound in edit mode.
517 	 */
518 	int			mode;
519 	enum mode_key_cmd	cmd;
520 };
521 
522 /* Data required while mode keys are in use. */
523 struct mode_key_data {
524 	struct mode_key_tree   *tree;
525 	int			mode;
526 };
527 #define MODEKEY_EMACS 0
528 #define MODEKEY_VI 1
529 
530 /* Binding between a key and a command. */
531 struct mode_key_binding {
532 	int			key;
533 
534 	int			mode;
535 	enum mode_key_cmd	cmd;
536 
537 	SPLAY_ENTRY(mode_key_binding) entry;
538 };
539 SPLAY_HEAD(mode_key_tree, mode_key_binding);
540 
541 /* Command to string mapping. */
542 struct mode_key_cmdstr {
543 	enum mode_key_cmd	 cmd;
544 	const char		*name;
545 };
546 
547 /* Named mode key table description. */
548 struct mode_key_table {
549 	const char			*name;
550 	const struct mode_key_cmdstr	*cmdstr;
551 	struct mode_key_tree		*tree;
552 	const struct mode_key_entry	*table;	/* default entries */
553 };
554 
555 /* Modes. */
556 #define MODE_CURSOR 0x1
557 #define MODE_INSERT 0x2
558 #define MODE_KCURSOR 0x4
559 #define MODE_KKEYPAD 0x8	/* set = application, clear = number */
560 #define MODE_WRAP 0x10		/* whether lines wrap */
561 #define MODE_MOUSE_STANDARD 0x20
562 #define MODE_MOUSE_BUTTON 0x40
563 #define MODE_MOUSE_ANY 0x80
564 #define MODE_MOUSE_UTF8 0x100
565 
566 #define ALL_MOUSE_MODES (MODE_MOUSE_STANDARD|MODE_MOUSE_BUTTON|MODE_MOUSE_ANY)
567 
568 /*
569  * A single UTF-8 character.
570  *
571  * The data member in this must be UTF8_SIZE to allow screen_write_copy to
572  * reinject stored UTF-8 data back into screen_write_cell after combining (ugh
573  * XXX XXX).
574  */
575 struct utf8_data {
576 	u_char	data[UTF8_SIZE];
577 
578 	size_t	have;
579 	size_t	size;
580 
581 	u_int	width;
582 };
583 
584 /* Grid output. */
585 #if defined(DEBUG) && \
586     ((defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || \
587      (defined(__GNUC__) && __GNUC__ >= 3))
588 #define GRID_DEBUG(gd, fmt, ...) log_debug2("%s: (sx=%u, sy=%u, hsize=%u) " \
589     fmt, __func__, (gd)->sx, (gd)->sy, (gd)->hsize, ## __VA_ARGS__)
590 #else
591 #define GRID_DEBUG(...)
592 #endif
593 
594 /* Grid attributes. */
595 #define GRID_ATTR_BRIGHT 0x1
596 #define GRID_ATTR_DIM 0x2
597 #define GRID_ATTR_UNDERSCORE 0x4
598 #define GRID_ATTR_BLINK 0x8
599 #define GRID_ATTR_REVERSE 0x10
600 #define GRID_ATTR_HIDDEN 0x20
601 #define GRID_ATTR_ITALICS 0x40
602 #define GRID_ATTR_CHARSET 0x80	/* alternative character set */
603 
604 /* Grid flags. */
605 #define GRID_FLAG_FG256 0x1
606 #define GRID_FLAG_BG256 0x2
607 #define GRID_FLAG_PADDING 0x4
608 #define GRID_FLAG_UTF8 0x8
609 
610 /* Grid line flags. */
611 #define GRID_LINE_WRAPPED 0x1
612 
613 /* Grid cell data. */
614 struct grid_cell {
615 	u_char	attr;
616 	u_char	flags;
617 	u_char	fg;
618 	u_char	bg;
619 	u_char	data;
620 } __packed;
621 
622 /* Grid cell UTF-8 data. Used instead of data in grid_cell for UTF-8 cells. */
623 struct grid_utf8 {
624 	u_char	width;
625 	u_char	data[UTF8_SIZE];
626 } __packed;
627 
628 /* Grid line. */
629 struct grid_line {
630 	u_int	cellsize;
631 	struct grid_cell *celldata;
632 
633 	u_int	utf8size;
634 	struct grid_utf8 *utf8data;
635 
636 	int	flags;
637 } __packed;
638 
639 /* Entire grid of cells. */
640 struct grid {
641 	int	flags;
642 #define GRID_HISTORY 0x1	/* scroll lines into history */
643 
644 	u_int	sx;
645 	u_int	sy;
646 
647 	u_int	hsize;
648 	u_int	hlimit;
649 
650 	struct grid_line *linedata;
651 };
652 
653 /* Option data structures. */
654 struct options_entry {
655 	char		*name;
656 
657 	enum {
658 		OPTIONS_STRING,
659 		OPTIONS_NUMBER,
660 		OPTIONS_DATA,
661 	} type;
662 
663 	char		*str;
664 	long long	 num;
665 	void		*data;
666 
667 	void		 (*freefn)(void *);
668 
669 	SPLAY_ENTRY(options_entry) entry;
670 };
671 
672 struct options {
673 	SPLAY_HEAD(options_tree, options_entry) tree;
674 	struct options	*parent;
675 };
676 
677 /* Key list for prefix option. */
678 ARRAY_DECL(keylist, int);
679 
680 /* Scheduled job. */
681 struct job {
682 	char		*cmd;
683 	pid_t		 pid;
684 	int		 status;
685 
686 	int		 fd;
687 	struct bufferevent *event;
688 
689 	void		(*callbackfn)(struct job *);
690 	void		(*freefn)(void *);
691 	void		*data;
692 
693 	LIST_ENTRY(job)	 lentry;
694 };
695 LIST_HEAD(joblist, job);
696 
697 /* Screen selection. */
698 struct screen_sel {
699 	int		 flag;
700 	int		 rectflag;
701 
702 	u_int		 sx;
703 	u_int		 sy;
704 
705 	u_int		 ex;
706 	u_int		 ey;
707 
708 	struct grid_cell cell;
709 };
710 
711 /* Virtual screen. */
712 struct screen {
713 	char		*title;
714 
715 	struct grid	*grid;		/* grid data */
716 
717 	u_int		 cx;		/* cursor x */
718 	u_int		 cy;		/* cursor y */
719 
720 	u_int		 cstyle;	/* cursor style */
721 	char		*ccolour;	/* cursor colour string */
722 
723 	u_int		 rupper;	/* scroll region top */
724 	u_int		 rlower;	/* scroll region bottom */
725 
726 	int		 mode;
727 
728 	bitstr_t	*tabs;
729 
730 	struct screen_sel sel;
731 };
732 
733 /* Screen write context. */
734 struct screen_write_ctx {
735 	struct window_pane *wp;
736 	struct screen	*s;
737 };
738 
739 /* Screen size. */
740 #define screen_size_x(s) ((s)->grid->sx)
741 #define screen_size_y(s) ((s)->grid->sy)
742 #define screen_hsize(s) ((s)->grid->hsize)
743 #define screen_hlimit(s) ((s)->grid->hlimit)
744 
745 /* Input parser context. */
746 struct input_ctx {
747 	struct window_pane     *wp;
748 	struct screen_write_ctx ctx;
749 
750 	struct grid_cell	cell;
751 
752 	struct grid_cell	old_cell;
753 	u_int 			old_cx;
754 	u_int			old_cy;
755 
756 	u_char			interm_buf[4];
757 	size_t			interm_len;
758 
759 	u_char			param_buf[64];
760 	size_t			param_len;
761 
762 	u_char			input_buf[256];
763 	size_t			input_len;
764 
765 	int			param_list[24];	/* -1 not present */
766 	u_int			param_list_len;
767 
768 	struct utf8_data	utf8data;
769 
770 	int			ch;
771 	int			flags;
772 #define INPUT_DISCARD 0x1
773 
774 	const struct input_state *state;
775 };
776 
777 /*
778  * Window mode. Windows can be in several modes and this is used to call the
779  * right function to handle input and output.
780  */
781 struct session;
782 struct window;
783 struct mouse_event;
784 struct window_mode {
785 	struct screen *(*init)(struct window_pane *);
786 	void	(*free)(struct window_pane *);
787 	void	(*resize)(struct window_pane *, u_int, u_int);
788 	void	(*key)(struct window_pane *, struct session *, int);
789 	void	(*mouse)(struct window_pane *,
790 		    struct session *, struct mouse_event *);
791 	void	(*timer)(struct window_pane *);
792 };
793 
794 /* Child window structure. */
795 struct window_utmp;
796 struct window_pane {
797 	u_int		 id;
798 
799 	struct window	*window;
800 	struct layout_cell *layout_cell;
801 
802 	u_int		 sx;
803 	u_int		 sy;
804 
805 	u_int		 xoff;
806 	u_int		 yoff;
807 
808 	int		 flags;
809 #define PANE_REDRAW 0x1
810 
811 	char		*cmd;
812 	char		*shell;
813 	char		*cwd;
814 
815 	pid_t		 pid;
816 	char		 tty[TTY_NAME_MAX];
817 
818 	int		 fd;
819 	struct bufferevent *event;
820 
821 	struct input_ctx ictx;
822 
823 	int		 pipe_fd;
824 	struct bufferevent *pipe_event;
825 	size_t		 pipe_off;
826 
827 	struct screen	*screen;
828 	struct screen	 base;
829 
830 	/* Saved in alternative screen mode. */
831 	u_int		 saved_cx;
832 	u_int		 saved_cy;
833 	struct grid	*saved_grid;
834 	struct grid_cell saved_cell;
835 
836 	const struct window_mode *mode;
837 	void		*modedata;
838 
839 	struct window_utmp *utmp;
840 
841 	TAILQ_ENTRY(window_pane) entry;
842 	RB_ENTRY(window_pane) tree_entry;
843 };
844 TAILQ_HEAD(window_panes, window_pane);
845 RB_HEAD(window_pane_tree, window_pane);
846 
847 /* Window structure. */
848 struct window {
849 	char		*name;
850 	struct event	 name_timer;
851 	struct timeval   silence_timer;
852 
853 	struct window_pane *active;
854 	struct window_pane *last;
855 	struct window_panes panes;
856 
857 	int		 lastlayout;
858 	struct layout_cell *layout_root;
859 
860 	u_int		 sx;
861 	u_int		 sy;
862 
863 	int		 flags;
864 #define WINDOW_BELL 0x1
865 #define WINDOW_ACTIVITY 0x2
866 #define WINDOW_REDRAW 0x4
867 #define WINDOW_SILENCE 0x8
868 
869 	struct options	 options;
870 
871 	u_int		 references;
872 };
873 ARRAY_DECL(windows, struct window *);
874 
875 /* Entry on local window list. */
876 struct winlink {
877 	int		 idx;
878 	struct window	*window;
879 
880 	size_t		 status_width;
881 	struct grid_cell status_cell;
882 	char		*status_text;
883 
884 	int              flags;
885 #define WINLINK_BELL 0x1
886 #define WINLINK_ACTIVITY 0x2
887 #define WINLINK_CONTENT 0x4
888 #define WINLINK_SILENCE 0x8
889 #define WINLINK_ALERTFLAGS \
890     (WINLINK_BELL|WINLINK_ACTIVITY|WINLINK_CONTENT|WINLINK_SILENCE)
891 
892 	RB_ENTRY(winlink) entry;
893 	TAILQ_ENTRY(winlink) sentry;
894 };
895 RB_HEAD(winlinks, winlink);
896 TAILQ_HEAD(winlink_stack, winlink);
897 
898 /* Layout direction. */
899 enum layout_type {
900 	LAYOUT_LEFTRIGHT,
901 	LAYOUT_TOPBOTTOM,
902 	LAYOUT_WINDOWPANE
903 };
904 
905 /* Layout cells queue. */
906 TAILQ_HEAD(layout_cells, layout_cell);
907 
908 /* Layout cell. */
909 struct layout_cell {
910 	enum layout_type type;
911 
912 	struct layout_cell *parent;
913 
914 	u_int		 sx;
915 	u_int		 sy;
916 
917 	u_int		 xoff;
918 	u_int		 yoff;
919 
920 	struct window_pane *wp;
921 	struct layout_cells cells;
922 
923 	TAILQ_ENTRY(layout_cell) entry;
924 };
925 
926 /* Paste buffer. */
927 struct paste_buffer {
928 	char		*data;
929 	size_t		 size;
930 };
931 ARRAY_DECL(paste_stack, struct paste_buffer *);
932 
933 /* Environment variable. */
934 struct environ_entry {
935 	char		*name;
936 	char		*value;
937 
938 	RB_ENTRY(environ_entry) entry;
939 };
940 RB_HEAD(environ, environ_entry);
941 
942 /* Client session. */
943 struct session_group {
944 	TAILQ_HEAD(, session) sessions;
945 
946 	TAILQ_ENTRY(session_group) entry;
947 };
948 TAILQ_HEAD(session_groups, session_group);
949 
950 struct session {
951 	u_int		 idx;
952 
953 	char		*name;
954 	char		*cwd;
955 
956 	struct timeval	 creation_time;
957 	struct timeval	 activity_time;
958 
959 	u_int		 sx;
960 	u_int		 sy;
961 
962 	struct winlink	*curw;
963 	struct winlink_stack lastw;
964 	struct winlinks	 windows;
965 
966 	struct options	 options;
967 
968 #define SESSION_UNATTACHED 0x1	/* not attached to any clients */
969 	int		 flags;
970 
971 	struct termios	*tio;
972 
973 	struct environ	 environ;
974 
975 	int		 wlmouse;
976 
977 	int		 references;
978 
979 	TAILQ_ENTRY(session) gentry;
980 	RB_ENTRY(session)    entry;
981 };
982 RB_HEAD(sessions, session);
983 ARRAY_DECL(sessionslist, struct session *);
984 
985 /* TTY information. */
986 struct tty_key {
987 	char		 ch;
988 	int		 key;
989 
990 	struct tty_key	*left;
991 	struct tty_key	*right;
992 
993 	struct tty_key	*next;
994 };
995 
996 struct tty_term {
997 	char		*name;
998 	u_int		 references;
999 
1000 	char		 acs[UCHAR_MAX + 1][2];
1001 
1002 	struct tty_code	 codes[NTTYCODE];
1003 
1004 #define TERM_256COLOURS 0x1
1005 #define TERM_88COLOURS 0x2
1006 #define TERM_EARLYWRAP 0x4
1007 	int		 flags;
1008 
1009 	LIST_ENTRY(tty_term) entry;
1010 };
1011 LIST_HEAD(tty_terms, tty_term);
1012 
1013 struct tty {
1014 	char		*path;
1015 
1016 	u_int		 sx;
1017 	u_int		 sy;
1018 
1019 	u_int		 cx;
1020 	u_int		 cy;
1021 	u_int		 cstyle;
1022 	char		*ccolour;
1023 
1024 	int		 mode;
1025 
1026 	u_int		 rlower;
1027 	u_int		 rupper;
1028 
1029 	char		*termname;
1030 	struct tty_term	*term;
1031 
1032 	int		 fd;
1033 	struct bufferevent *event;
1034 
1035 	int		 log_fd;
1036 
1037 	struct termios	 tio;
1038 
1039 	struct grid_cell cell;
1040 
1041 #define TTY_NOCURSOR 0x1
1042 #define TTY_FREEZE 0x2
1043 #define TTY_ESCAPE 0x4
1044 #define TTY_UTF8 0x8
1045 #define TTY_STARTED 0x10
1046 #define TTY_OPENED 0x20
1047 #define TTY_BACKOFF 0x40
1048 	int		 flags;
1049 
1050 	int		 term_flags;
1051 
1052 	void		 (*key_callback)(int, struct mouse_event *, void *);
1053 	void		*key_data;
1054 	struct event	 key_timer;
1055 	struct tty_key	*key_tree;
1056 };
1057 
1058 /* TTY command context and function pointer. */
1059 struct tty_ctx {
1060 	struct window_pane *wp;
1061 
1062 	const struct grid_cell *cell;
1063 	const struct grid_utf8 *utf8;
1064 
1065 	u_int		 num;
1066 	void		*ptr;
1067 
1068 	/*
1069 	 * Cursor and region position before the screen was updated - this is
1070 	 * where the command should be applied; the values in the screen have
1071 	 * already been updated.
1072 	 */
1073 	u_int		 ocx;
1074 	u_int		 ocy;
1075 
1076 	u_int		 orupper;
1077 	u_int		 orlower;
1078 
1079 	/* Saved last cell on line. */
1080 	struct grid_cell last_cell;
1081 	struct grid_utf8 last_utf8;
1082 	u_int		 last_width;
1083 };
1084 
1085 /*
1086  * xterm mouse mode is fairly silly. Buttons are in the bottom two
1087  * bits: 0 button 1; 1 button 2; 2 button 3; 3 buttons released.
1088  *
1089  * Bit 3 is shift; bit 4 is meta; bit 5 control.
1090  *
1091  * Bit 6 is added for mouse buttons 4 and 5.
1092  */
1093 /* Mouse input. */
1094 struct mouse_event {
1095 	u_int	b;
1096 #define MOUSE_1 0
1097 #define MOUSE_2 1
1098 #define MOUSE_3 2
1099 #define MOUSE_UP 3
1100 #define MOUSE_BUTTON 3
1101 #define MOUSE_DRAG 32
1102 #define MOUSE_45 64
1103 #define MOUSE_RESIZE_PANE 128 /* marker for resizing */
1104 	u_int	x;
1105 	u_int	y;
1106 };
1107 
1108 /* Saved message entry. */
1109 struct message_entry {
1110 	char   *msg;
1111 	time_t	msg_time;
1112 };
1113 
1114 /* Status output data from a job. */
1115 struct status_out {
1116 	char   *cmd;
1117 	char   *out;
1118 
1119 	RB_ENTRY(status_out) entry;
1120 };
1121 RB_HEAD(status_out_tree, status_out);
1122 
1123 /* Client connection. */
1124 struct client {
1125 	struct imsgbuf	 ibuf;
1126 	struct event	 event;
1127 	int		 retcode;
1128 
1129 	struct timeval	 creation_time;
1130 	struct timeval	 activity_time;
1131 
1132 	struct environ	 environ;
1133 
1134 	char		*title;
1135 	char		*cwd;
1136 
1137 	struct tty	 tty;
1138 
1139 	int		 stdin_fd;
1140 	void		*stdin_data;
1141 	void		(*stdin_callback)(struct client *, void *);
1142 	struct bufferevent *stdin_event;
1143 
1144 	int		 stdout_fd;
1145 	struct bufferevent *stdout_event;
1146 
1147 	int		 stderr_fd;
1148 	struct bufferevent *stderr_event;
1149 
1150 	struct event	 repeat_timer;
1151 
1152 	struct status_out_tree status_old;
1153 	struct status_out_tree status_new;
1154 	struct timeval	 status_timer;
1155 	struct screen	 status;
1156 
1157 #define CLIENT_TERMINAL 0x1
1158 #define CLIENT_PREFIX 0x2
1159 #define CLIENT_EXIT 0x4
1160 #define CLIENT_REDRAW 0x8
1161 #define CLIENT_STATUS 0x10
1162 #define CLIENT_REPEAT 0x20	/* allow command to repeat within repeat time */
1163 #define CLIENT_SUSPENDED 0x40
1164 #define CLIENT_BAD 0x80
1165 #define CLIENT_IDENTIFY 0x100
1166 #define CLIENT_DEAD 0x200
1167 #define CLIENT_BORDERS 0x400
1168 #define CLIENT_READONLY 0x800
1169 #define CLIENT_BACKOFF 0x1000
1170 #define CLIENT_REDRAWWINDOW 0x2000
1171 	int		 flags;
1172 
1173 	struct event	 identify_timer;
1174 
1175 	char		*message_string;
1176 	struct event	 message_timer;
1177 	ARRAY_DECL(, struct message_entry) message_log;
1178 
1179 	char		*prompt_string;
1180 	char		*prompt_buffer;
1181 	size_t		 prompt_index;
1182 	int		 (*prompt_callbackfn)(void *, const char *);
1183 	void		 (*prompt_freefn)(void *);
1184 	void		*prompt_data;
1185 	u_int            prompt_hindex;
1186 
1187 #define PROMPT_SINGLE 0x1
1188 	int		 prompt_flags;
1189 
1190 	struct mode_key_data prompt_mdata;
1191 
1192 	struct session	*session;
1193 	struct session	*last_session;
1194 
1195 	struct mouse_event last_mouse;
1196 
1197 	int		 references;
1198 };
1199 ARRAY_DECL(clients, struct client *);
1200 
1201 /* Parsed arguments. */
1202 struct args {
1203 	bitstr_t	*flags;
1204 	char		*values[SCHAR_MAX]; /* XXX This is awfully big. */
1205 
1206 	int		 argc;
1207 	char	       **argv;
1208 };
1209 
1210 /* Key/command line command. */
1211 struct cmd_ctx {
1212 	/*
1213 	 * curclient is the client where this command was executed if inside
1214 	 * tmux. This is NULL if the command came from the command-line.
1215 	 *
1216 	 * cmdclient is the client which sent the MSG_COMMAND to the server, if
1217 	 * any. This is NULL unless the command came from the command-line.
1218 	 *
1219 	 * cmdclient and curclient may both be NULL if the command is in the
1220 	 * configuration file.
1221 	 */
1222 	struct client  *curclient;
1223 	struct client  *cmdclient;
1224 
1225 	struct msg_command_data	*msgdata;
1226 
1227 	/* gcc2 doesn't understand attributes on function pointers... */
1228 #if defined(__GNUC__) && __GNUC__ >= 3
1229 	void printflike2 (*print)(struct cmd_ctx *, const char *, ...);
1230 	void printflike2 (*info)(struct cmd_ctx *, const char *, ...);
1231 	void printflike2 (*error)(struct cmd_ctx *, const char *, ...);
1232 #else
1233 	void (*print)(struct cmd_ctx *, const char *, ...);
1234 	void (*info)(struct cmd_ctx *, const char *, ...);
1235 	void (*error)(struct cmd_ctx *, const char *, ...);
1236 #endif
1237 };
1238 
1239 struct cmd {
1240 	const struct cmd_entry	*entry;
1241 	struct args		*args;
1242 
1243 	TAILQ_ENTRY(cmd)	 qentry;
1244 };
1245 struct cmd_list {
1246 	int		 	 references;
1247 	TAILQ_HEAD(, cmd) 	 list;
1248 };
1249 
1250 struct cmd_entry {
1251 	const char	*name;
1252 	const char	*alias;
1253 
1254 	const char	*args_template;
1255 	int		 args_lower;
1256 	int		 args_upper;
1257 
1258 	const char	*usage;
1259 
1260 #define CMD_STARTSERVER 0x1
1261 #define CMD_CANTNEST 0x2
1262 #define CMD_SENDENVIRON 0x4
1263 #define CMD_READONLY 0x8
1264 	int		 flags;
1265 
1266 	void		 (*key_binding)(struct cmd *, int);
1267 	int		 (*check)(struct args *);
1268 	int		 (*exec)(struct cmd *, struct cmd_ctx *);
1269 };
1270 
1271 /* Key binding. */
1272 struct key_binding {
1273 	int		 key;
1274 	struct cmd_list	*cmdlist;
1275 	int		 can_repeat;
1276 
1277 	SPLAY_ENTRY(key_binding) entry;
1278 };
1279 SPLAY_HEAD(key_bindings, key_binding);
1280 
1281 /*
1282  * Option table entries. The option table is the user-visible part of the
1283  * option, as opposed to the internal options (struct option) which are just
1284  * number or string.
1285  */
1286 enum options_table_type {
1287 	OPTIONS_TABLE_STRING,
1288 	OPTIONS_TABLE_NUMBER,
1289 	OPTIONS_TABLE_KEYS,
1290 	OPTIONS_TABLE_COLOUR,
1291 	OPTIONS_TABLE_ATTRIBUTES,
1292 	OPTIONS_TABLE_FLAG,
1293 	OPTIONS_TABLE_CHOICE
1294 };
1295 
1296 struct options_table_entry {
1297 	const char	       *name;
1298 	enum options_table_type	type;
1299 
1300 	u_int		 	minimum;
1301 	u_int		 	maximum;
1302 	const char	      **choices;
1303 
1304 	const char	       *default_str;
1305 	long long		default_num;
1306 };
1307 
1308 /* List of configuration causes. */
1309 ARRAY_DECL(causelist, char *);
1310 
1311 /* Common command usages. */
1312 #define CMD_TARGET_PANE_USAGE "[-t target-pane]"
1313 #define CMD_TARGET_WINDOW_USAGE "[-t target-window]"
1314 #define CMD_TARGET_SESSION_USAGE "[-t target-session]"
1315 #define CMD_TARGET_CLIENT_USAGE "[-t target-client]"
1316 #define CMD_SRCDST_PANE_USAGE "[-s src-pane] [-t dst-pane]"
1317 #define CMD_SRCDST_WINDOW_USAGE "[-s src-window] [-t dst-window]"
1318 #define CMD_SRCDST_SESSION_USAGE "[-s src-session] [-t dst-session]"
1319 #define CMD_SRCDST_CLIENT_USAGE "[-s src-client] [-t dst-client]"
1320 #define CMD_BUFFER_USAGE "[-b buffer-index]"
1321 
1322 /* tmux.c */
1323 extern struct options global_options;
1324 extern struct options global_s_options;
1325 extern struct options global_w_options;
1326 extern struct environ global_environ;
1327 extern struct event_base *ev_base;
1328 extern char	*cfg_file;
1329 extern char	*shell_cmd;
1330 extern int	 debug_level;
1331 extern time_t	 start_time;
1332 extern char	 socket_path[MAXPATHLEN];
1333 extern int	 login_shell;
1334 extern char	*environ_path;
1335 extern pid_t	 environ_pid;
1336 extern int	 environ_idx;
1337 void		 logfile(const char *);
1338 const char	*getshell(void);
1339 int		 checkshell(const char *);
1340 int		 areshell(const char *);
1341 void		 setblocking(int, int);
1342 __dead void	 shell_exec(const char *, const char *);
1343 
1344 /* cfg.c */
1345 extern int       cfg_finished;
1346 extern struct causelist cfg_causes;
1347 void printflike2 cfg_add_cause(struct causelist *, const char *, ...);
1348 int		 load_cfg(const char *, struct cmd_ctx *, struct causelist *);
1349 
1350 /* mode-key.c */
1351 extern const struct mode_key_table mode_key_tables[];
1352 extern struct mode_key_tree mode_key_tree_vi_edit;
1353 extern struct mode_key_tree mode_key_tree_vi_choice;
1354 extern struct mode_key_tree mode_key_tree_vi_copy;
1355 extern struct mode_key_tree mode_key_tree_emacs_edit;
1356 extern struct mode_key_tree mode_key_tree_emacs_choice;
1357 extern struct mode_key_tree mode_key_tree_emacs_copy;
1358 int	mode_key_cmp(struct mode_key_binding *, struct mode_key_binding *);
1359 SPLAY_PROTOTYPE(mode_key_tree, mode_key_binding, entry, mode_key_cmp);
1360 const char *mode_key_tostring(const struct mode_key_cmdstr *,
1361 	    enum mode_key_cmd);
1362 enum mode_key_cmd mode_key_fromstring(const struct mode_key_cmdstr *,
1363 	    const char *);
1364 const struct mode_key_table *mode_key_findtable(const char *);
1365 void	mode_key_init_trees(void);
1366 void	mode_key_init(struct mode_key_data *, struct mode_key_tree *);
1367 enum mode_key_cmd mode_key_lookup(struct mode_key_data *, int);
1368 
1369 /* options.c */
1370 int	options_cmp(struct options_entry *, struct options_entry *);
1371 SPLAY_PROTOTYPE(options_tree, options_entry, entry, options_cmp);
1372 void	options_init(struct options *, struct options *);
1373 void	options_free(struct options *);
1374 struct options_entry *options_find1(struct options *, const char *);
1375 struct options_entry *options_find(struct options *, const char *);
1376 void	options_remove(struct options *, const char *);
1377 struct options_entry *printflike3 options_set_string(
1378 	    struct options *, const char *, const char *, ...);
1379 char   *options_get_string(struct options *, const char *);
1380 struct options_entry *options_set_number(
1381 	    struct options *, const char *, long long);
1382 long long options_get_number(struct options *, const char *);
1383 struct options_entry *options_set_data(
1384 	    struct options *, const char *, void *, void (*)(void *));
1385 void   *options_get_data(struct options *, const char *);
1386 
1387 /* options-table.c */
1388 extern const struct options_table_entry server_options_table[];
1389 extern const struct options_table_entry session_options_table[];
1390 extern const struct options_table_entry window_options_table[];
1391 void	options_table_populate_tree(
1392 	    const struct options_table_entry *, struct options *);
1393 const char *options_table_print_entry(
1394 	    const struct options_table_entry *, struct options_entry *);
1395 
1396 /* job.c */
1397 extern struct joblist all_jobs;
1398 struct job *job_run(
1399 	    const char *, void (*)(struct job *), void (*)(void *), void *);
1400 void	job_free(struct job *);
1401 void	job_died(struct job *, int);
1402 
1403 /* environ.c */
1404 int	environ_cmp(struct environ_entry *, struct environ_entry *);
1405 RB_PROTOTYPE(environ, environ_entry, entry, environ_cmp);
1406 void	environ_init(struct environ *);
1407 void	environ_free(struct environ *);
1408 void	environ_copy(struct environ *, struct environ *);
1409 struct environ_entry *environ_find(struct environ *, const char *);
1410 void	environ_set(struct environ *, const char *, const char *);
1411 void	environ_put(struct environ *, const char *);
1412 void	environ_unset(struct environ *, const char *);
1413 void	environ_update(const char *, struct environ *, struct environ *);
1414 void	environ_push(struct environ *);
1415 
1416 /* tty.c */
1417 void	tty_raw(struct tty *, const char *);
1418 void	tty_attributes(struct tty *, const struct grid_cell *);
1419 void	tty_reset(struct tty *);
1420 void	tty_region_pane(struct tty *, const struct tty_ctx *, u_int, u_int);
1421 void	tty_region(struct tty *, u_int, u_int);
1422 void	tty_cursor_pane(struct tty *, const struct tty_ctx *, u_int, u_int);
1423 void	tty_cursor(struct tty *, u_int, u_int);
1424 void	tty_putcode(struct tty *, enum tty_code_code);
1425 void	tty_putcode1(struct tty *, enum tty_code_code, int);
1426 void	tty_putcode2(struct tty *, enum tty_code_code, int, int);
1427 void	tty_putcode_ptr1(struct tty *, enum tty_code_code, const void *);
1428 void	tty_putcode_ptr2(struct tty *, enum tty_code_code, const void *, const void *);
1429 void	tty_puts(struct tty *, const char *);
1430 void	tty_putc(struct tty *, u_char);
1431 void	tty_pututf8(struct tty *, const struct grid_utf8 *);
1432 void	tty_init(struct tty *, int, char *);
1433 int	tty_resize(struct tty *);
1434 void	tty_start_tty(struct tty *);
1435 void	tty_stop_tty(struct tty *);
1436 void	tty_set_title(struct tty *, const char *);
1437 void	tty_update_mode(struct tty *, int, struct screen *);
1438 void	tty_force_cursor_colour(struct tty *, const char *);
1439 void	tty_draw_line(struct tty *, struct screen *, u_int, u_int, u_int);
1440 int	tty_open(struct tty *, const char *, char **);
1441 void	tty_close(struct tty *);
1442 void	tty_free(struct tty *);
1443 void	tty_write(void (*)(
1444 	    struct tty *, const struct tty_ctx *), const struct tty_ctx *);
1445 void	tty_cmd_alignmenttest(struct tty *, const struct tty_ctx *);
1446 void	tty_cmd_cell(struct tty *, const struct tty_ctx *);
1447 void	tty_cmd_clearendofline(struct tty *, const struct tty_ctx *);
1448 void	tty_cmd_clearendofscreen(struct tty *, const struct tty_ctx *);
1449 void	tty_cmd_clearline(struct tty *, const struct tty_ctx *);
1450 void	tty_cmd_clearscreen(struct tty *, const struct tty_ctx *);
1451 void	tty_cmd_clearstartofline(struct tty *, const struct tty_ctx *);
1452 void	tty_cmd_clearstartofscreen(struct tty *, const struct tty_ctx *);
1453 void	tty_cmd_deletecharacter(struct tty *, const struct tty_ctx *);
1454 void	tty_cmd_deleteline(struct tty *, const struct tty_ctx *);
1455 void	tty_cmd_erasecharacter(struct tty *, const struct tty_ctx *);
1456 void	tty_cmd_insertcharacter(struct tty *, const struct tty_ctx *);
1457 void	tty_cmd_insertline(struct tty *, const struct tty_ctx *);
1458 void	tty_cmd_linefeed(struct tty *, const struct tty_ctx *);
1459 void	tty_cmd_utf8character(struct tty *, const struct tty_ctx *);
1460 void	tty_cmd_reverseindex(struct tty *, const struct tty_ctx *);
1461 void	tty_cmd_setselection(struct tty *, const struct tty_ctx *);
1462 void	tty_cmd_rawstring(struct tty *, const struct tty_ctx *);
1463 
1464 /* tty-term.c */
1465 extern struct tty_terms tty_terms;
1466 extern const struct tty_term_code_entry tty_term_codes[NTTYCODE];
1467 struct tty_term *tty_term_find(char *, int, const char *, char **);
1468 void		 tty_term_free(struct tty_term *);
1469 int		 tty_term_has(struct tty_term *, enum tty_code_code);
1470 const char	*tty_term_string(struct tty_term *, enum tty_code_code);
1471 const char	*tty_term_string1(struct tty_term *, enum tty_code_code, int);
1472 const char	*tty_term_string2(
1473 		     struct tty_term *, enum tty_code_code, int, int);
1474 const char	*tty_term_ptr1(
1475 		     struct tty_term *, enum tty_code_code, const void *);
1476 const char	*tty_term_ptr2(
1477 		     struct tty_term *, enum tty_code_code, const void *, const void *);
1478 int		 tty_term_number(struct tty_term *, enum tty_code_code);
1479 int		 tty_term_flag(struct tty_term *, enum tty_code_code);
1480 
1481 /* tty-acs.c */
1482 const char	*tty_acs_get(struct tty *, u_char);
1483 
1484 /* tty-keys.c */
1485 void	tty_keys_init(struct tty *);
1486 void	tty_keys_free(struct tty *);
1487 int	tty_keys_next(struct tty *);
1488 
1489 /* paste.c */
1490 struct paste_buffer *paste_walk_stack(struct paste_stack *, u_int *);
1491 struct paste_buffer *paste_get_top(struct paste_stack *);
1492 struct paste_buffer *paste_get_index(struct paste_stack *, u_int);
1493 int		 paste_free_top(struct paste_stack *);
1494 int		 paste_free_index(struct paste_stack *, u_int);
1495 void		 paste_add(struct paste_stack *, char *, size_t, u_int);
1496 int		 paste_replace(struct paste_stack *, u_int, char *, size_t);
1497 char		*paste_print(struct paste_buffer *, size_t);
1498 
1499 /* clock.c */
1500 extern const char clock_table[14][5][5];
1501 void		 clock_draw(struct screen_write_ctx *, int, int);
1502 
1503 /* arguments.c */
1504 struct args	*args_create(int, ...);
1505 struct args	*args_parse(const char *, int, char **);
1506 void		 args_free(struct args *);
1507 size_t		 args_print(struct args *, char *, size_t);
1508 int		 args_has(struct args *, u_char);
1509 void		 args_set(struct args *, u_char, const char *);
1510 const char	*args_get(struct args *, u_char);
1511 long long	 args_strtonum(
1512 		    struct args *, u_char, long long, long long, char **);
1513 
1514 /* cmd.c */
1515 int		 cmd_pack_argv(int, char **, char *, size_t);
1516 int		 cmd_unpack_argv(char *, size_t, int, char ***);
1517 char	       **cmd_copy_argv(int, char *const *);
1518 void		 cmd_free_argv(int, char **);
1519 struct cmd	*cmd_parse(int, char **, char **);
1520 int		 cmd_exec(struct cmd *, struct cmd_ctx *);
1521 void		 cmd_free(struct cmd *);
1522 size_t		 cmd_print(struct cmd *, char *, size_t);
1523 struct session	*cmd_current_session(struct cmd_ctx *, int);
1524 struct client	*cmd_current_client(struct cmd_ctx *);
1525 struct client	*cmd_find_client(struct cmd_ctx *, const char *);
1526 struct session	*cmd_find_session(struct cmd_ctx *, const char *, int);
1527 struct winlink	*cmd_find_window(
1528 		     struct cmd_ctx *, const char *, struct session **);
1529 int		 cmd_find_index(
1530 		     struct cmd_ctx *, const char *, struct session **);
1531 struct winlink	*cmd_find_pane(struct cmd_ctx *,
1532 		     const char *, struct session **, struct window_pane **);
1533 char		*cmd_template_replace(char *, const char *, int);
1534 extern const struct cmd_entry *cmd_table[];
1535 extern const struct cmd_entry cmd_attach_session_entry;
1536 extern const struct cmd_entry cmd_bind_key_entry;
1537 extern const struct cmd_entry cmd_break_pane_entry;
1538 extern const struct cmd_entry cmd_capture_pane_entry;
1539 extern const struct cmd_entry cmd_choose_buffer_entry;
1540 extern const struct cmd_entry cmd_choose_client_entry;
1541 extern const struct cmd_entry cmd_choose_session_entry;
1542 extern const struct cmd_entry cmd_choose_window_entry;
1543 extern const struct cmd_entry cmd_clear_history_entry;
1544 extern const struct cmd_entry cmd_clock_mode_entry;
1545 extern const struct cmd_entry cmd_command_prompt_entry;
1546 extern const struct cmd_entry cmd_confirm_before_entry;
1547 extern const struct cmd_entry cmd_copy_mode_entry;
1548 extern const struct cmd_entry cmd_delete_buffer_entry;
1549 extern const struct cmd_entry cmd_detach_client_entry;
1550 extern const struct cmd_entry cmd_display_message_entry;
1551 extern const struct cmd_entry cmd_display_panes_entry;
1552 extern const struct cmd_entry cmd_down_pane_entry;
1553 extern const struct cmd_entry cmd_find_window_entry;
1554 extern const struct cmd_entry cmd_has_session_entry;
1555 extern const struct cmd_entry cmd_if_shell_entry;
1556 extern const struct cmd_entry cmd_join_pane_entry;
1557 extern const struct cmd_entry cmd_kill_pane_entry;
1558 extern const struct cmd_entry cmd_kill_server_entry;
1559 extern const struct cmd_entry cmd_kill_session_entry;
1560 extern const struct cmd_entry cmd_kill_window_entry;
1561 extern const struct cmd_entry cmd_last_pane_entry;
1562 extern const struct cmd_entry cmd_last_window_entry;
1563 extern const struct cmd_entry cmd_link_window_entry;
1564 extern const struct cmd_entry cmd_list_buffers_entry;
1565 extern const struct cmd_entry cmd_list_clients_entry;
1566 extern const struct cmd_entry cmd_list_commands_entry;
1567 extern const struct cmd_entry cmd_list_keys_entry;
1568 extern const struct cmd_entry cmd_list_panes_entry;
1569 extern const struct cmd_entry cmd_list_sessions_entry;
1570 extern const struct cmd_entry cmd_list_windows_entry;
1571 extern const struct cmd_entry cmd_load_buffer_entry;
1572 extern const struct cmd_entry cmd_lock_client_entry;
1573 extern const struct cmd_entry cmd_lock_server_entry;
1574 extern const struct cmd_entry cmd_lock_session_entry;
1575 extern const struct cmd_entry cmd_move_window_entry;
1576 extern const struct cmd_entry cmd_new_session_entry;
1577 extern const struct cmd_entry cmd_new_window_entry;
1578 extern const struct cmd_entry cmd_next_layout_entry;
1579 extern const struct cmd_entry cmd_next_window_entry;
1580 extern const struct cmd_entry cmd_paste_buffer_entry;
1581 extern const struct cmd_entry cmd_pipe_pane_entry;
1582 extern const struct cmd_entry cmd_previous_layout_entry;
1583 extern const struct cmd_entry cmd_previous_window_entry;
1584 extern const struct cmd_entry cmd_refresh_client_entry;
1585 extern const struct cmd_entry cmd_rename_session_entry;
1586 extern const struct cmd_entry cmd_rename_window_entry;
1587 extern const struct cmd_entry cmd_resize_pane_entry;
1588 extern const struct cmd_entry cmd_respawn_pane_entry;
1589 extern const struct cmd_entry cmd_respawn_window_entry;
1590 extern const struct cmd_entry cmd_rotate_window_entry;
1591 extern const struct cmd_entry cmd_run_shell_entry;
1592 extern const struct cmd_entry cmd_save_buffer_entry;
1593 extern const struct cmd_entry cmd_select_layout_entry;
1594 extern const struct cmd_entry cmd_select_pane_entry;
1595 extern const struct cmd_entry cmd_select_window_entry;
1596 extern const struct cmd_entry cmd_send_keys_entry;
1597 extern const struct cmd_entry cmd_send_prefix_entry;
1598 extern const struct cmd_entry cmd_server_info_entry;
1599 extern const struct cmd_entry cmd_set_buffer_entry;
1600 extern const struct cmd_entry cmd_set_environment_entry;
1601 extern const struct cmd_entry cmd_set_option_entry;
1602 extern const struct cmd_entry cmd_set_window_option_entry;
1603 extern const struct cmd_entry cmd_show_buffer_entry;
1604 extern const struct cmd_entry cmd_show_environment_entry;
1605 extern const struct cmd_entry cmd_show_messages_entry;
1606 extern const struct cmd_entry cmd_show_options_entry;
1607 extern const struct cmd_entry cmd_show_window_options_entry;
1608 extern const struct cmd_entry cmd_source_file_entry;
1609 extern const struct cmd_entry cmd_split_window_entry;
1610 extern const struct cmd_entry cmd_start_server_entry;
1611 extern const struct cmd_entry cmd_suspend_client_entry;
1612 extern const struct cmd_entry cmd_swap_pane_entry;
1613 extern const struct cmd_entry cmd_swap_window_entry;
1614 extern const struct cmd_entry cmd_switch_client_entry;
1615 extern const struct cmd_entry cmd_unbind_key_entry;
1616 extern const struct cmd_entry cmd_unlink_window_entry;
1617 extern const struct cmd_entry cmd_up_pane_entry;
1618 
1619 /* cmd-list.c */
1620 struct cmd_list	*cmd_list_parse(int, char **, char **);
1621 int		 cmd_list_exec(struct cmd_list *, struct cmd_ctx *);
1622 void		 cmd_list_free(struct cmd_list *);
1623 size_t		 cmd_list_print(struct cmd_list *, char *, size_t);
1624 
1625 /* cmd-string.c */
1626 int	cmd_string_parse(const char *, struct cmd_list **, char **);
1627 
1628 /* client.c */
1629 int	client_main(int, char **, int);
1630 
1631 /* key-bindings.c */
1632 extern struct key_bindings key_bindings;
1633 int	 key_bindings_cmp(struct key_binding *, struct key_binding *);
1634 SPLAY_PROTOTYPE(key_bindings, key_binding, entry, key_bindings_cmp);
1635 struct key_binding *key_bindings_lookup(int);
1636 void	 key_bindings_add(int, int, struct cmd_list *);
1637 void	 key_bindings_remove(int);
1638 void	 key_bindings_clean(void);
1639 void	 key_bindings_init(void);
1640 void	 key_bindings_dispatch(struct key_binding *, struct client *);
1641 void printflike2 key_bindings_error(struct cmd_ctx *, const char *, ...);
1642 void printflike2 key_bindings_print(struct cmd_ctx *, const char *, ...);
1643 void printflike2 key_bindings_info(struct cmd_ctx *, const char *, ...);
1644 
1645 /* key-string.c */
1646 int	 key_string_lookup_string(const char *);
1647 const char *key_string_lookup_key(int);
1648 
1649 /* server.c */
1650 extern struct clients clients;
1651 extern struct clients dead_clients;
1652 extern struct paste_stack global_buffers;
1653 int	 server_start(void);
1654 void	 server_update_socket(void);
1655 
1656 /* server-client.c */
1657 void	 server_client_create(int);
1658 void	 server_client_lost(struct client *);
1659 void	 server_client_callback(int, short, void *);
1660 void	 server_client_status_timer(void);
1661 void	 server_client_loop(void);
1662 
1663 /* server-window.c */
1664 void	 server_window_loop(void);
1665 
1666 /* server-fn.c */
1667 void	 server_fill_environ(struct session *, struct environ *);
1668 void	 server_write_client(
1669 	     struct client *, enum msgtype, const void *, size_t);
1670 void	 server_write_session(
1671 	     struct session *, enum msgtype, const void *, size_t);
1672 void	 server_redraw_client(struct client *);
1673 void	 server_status_client(struct client *);
1674 void	 server_redraw_session(struct session *);
1675 void	 server_redraw_session_group(struct session *);
1676 void	 server_status_session(struct session *);
1677 void	 server_status_session_group(struct session *);
1678 void	 server_redraw_window(struct window *);
1679 void	 server_redraw_window_borders(struct window *);
1680 void	 server_status_window(struct window *);
1681 void	 server_lock(void);
1682 void	 server_lock_session(struct session *);
1683 void	 server_lock_client(struct client *);
1684 int	 server_unlock(const char *);
1685 void	 server_kill_window(struct window *);
1686 int	 server_link_window(struct session *,
1687 	     struct winlink *, struct session *, int, int, int, char **);
1688 void	 server_unlink_window(struct session *, struct winlink *);
1689 void	 server_destroy_pane(struct window_pane *);
1690 void	 server_destroy_session_group(struct session *);
1691 void	 server_destroy_session(struct session *);
1692 void	 server_check_unattached (void);
1693 void	 server_set_identify(struct client *);
1694 void	 server_clear_identify(struct client *);
1695 void	 server_update_event(struct client *);
1696 
1697 /* status.c */
1698 int	 status_out_cmp(struct status_out *, struct status_out *);
1699 RB_PROTOTYPE(status_out_tree, status_out, entry, status_out_cmp);
1700 void	 status_free_jobs(struct status_out_tree *);
1701 void	 status_update_jobs(struct client *);
1702 void	 status_set_window_at(struct client *, u_int);
1703 int	 status_redraw(struct client *);
1704 char	*status_replace(struct client *, struct session *,
1705 	     struct winlink *, struct window_pane *, const char *, time_t, int)
1706     __attribute__((__format__(__strftime__, 5, 0)));
1707 void printflike2 status_message_set(struct client *, const char *, ...);
1708 void	 status_message_clear(struct client *);
1709 int	 status_message_redraw(struct client *);
1710 void	 status_prompt_set(struct client *, const char *, const char *,
1711 	     int (*)(void *, const char *), void (*)(void *), void *, int);
1712 void	 status_prompt_clear(struct client *);
1713 int	 status_prompt_redraw(struct client *);
1714 void	 status_prompt_key(struct client *, int);
1715 void	 status_prompt_update(struct client *, const char *, const char *);
1716 
1717 /* resize.c */
1718 void	 recalculate_sizes(void);
1719 
1720 /* input.c */
1721 void	 input_init(struct window_pane *);
1722 void	 input_free(struct window_pane *);
1723 void	 input_parse(struct window_pane *);
1724 
1725 /* input-key.c */
1726 void	 input_key(struct window_pane *, int);
1727 void	 input_mouse(struct window_pane *, struct mouse_event *);
1728 
1729 /* xterm-keys.c */
1730 char	*xterm_keys_lookup(int);
1731 int	 xterm_keys_find(const char *, size_t, size_t *, int *);
1732 
1733 /* colour.c */
1734 void	 colour_set_fg(struct grid_cell *, int);
1735 void	 colour_set_bg(struct grid_cell *, int);
1736 const char *colour_tostring(int);
1737 int	 colour_fromstring(const char *);
1738 u_char	 colour_256to16(u_char);
1739 u_char	 colour_256to88(u_char);
1740 
1741 /* attributes.c */
1742 const char *attributes_tostring(u_char);
1743 int	 attributes_fromstring(const char *);
1744 
1745 /* grid.c */
1746 extern const struct grid_cell grid_default_cell;
1747 struct grid *grid_create(u_int, u_int, u_int);
1748 void	 grid_destroy(struct grid *);
1749 int	 grid_compare(struct grid *, struct grid *);
1750 void	 grid_collect_history(struct grid *);
1751 void	 grid_scroll_history(struct grid *);
1752 void	 grid_scroll_history_region(struct grid *, u_int, u_int);
1753 void	 grid_expand_line(struct grid *, u_int, u_int);
1754 void	 grid_expand_line_utf8(struct grid *, u_int, u_int);
1755 const struct grid_cell *grid_peek_cell(struct grid *, u_int, u_int);
1756 struct grid_cell *grid_get_cell(struct grid *, u_int, u_int);
1757 void	 grid_set_cell(struct grid *, u_int, u_int, const struct grid_cell *);
1758 const struct grid_utf8 *grid_peek_utf8(struct grid *, u_int, u_int);
1759 struct grid_utf8 *grid_get_utf8(struct grid *, u_int, u_int);
1760 void	 grid_set_utf8(struct grid *, u_int, u_int, const struct grid_utf8 *);
1761 void	 grid_clear(struct grid *, u_int, u_int, u_int, u_int);
1762 void	 grid_clear_lines(struct grid *, u_int, u_int);
1763 void	 grid_move_lines(struct grid *, u_int, u_int, u_int);
1764 void	 grid_move_cells(struct grid *, u_int, u_int, u_int, u_int);
1765 char	*grid_string_cells(struct grid *, u_int, u_int, u_int);
1766 void	 grid_duplicate_lines(
1767 	     struct grid *, u_int, struct grid *, u_int, u_int);
1768 
1769 /* grid-utf8.c */
1770 size_t	 grid_utf8_size(const struct grid_utf8 *);
1771 size_t	 grid_utf8_copy(const struct grid_utf8 *, char *, size_t);
1772 void	 grid_utf8_set(struct grid_utf8 *, const struct utf8_data *);
1773 int	 grid_utf8_append(struct grid_utf8 *, const struct utf8_data *);
1774 int	 grid_utf8_compare(const struct grid_utf8 *, const struct grid_utf8 *);
1775 
1776 /* grid-view.c */
1777 const struct grid_cell *grid_view_peek_cell(struct grid *, u_int, u_int);
1778 struct grid_cell *grid_view_get_cell(struct grid *, u_int, u_int);
1779 void	 grid_view_set_cell(
1780 	     struct grid *, u_int, u_int, const struct grid_cell *);
1781 const struct grid_utf8 *grid_view_peek_utf8(struct grid *, u_int, u_int);
1782 struct grid_utf8 *grid_view_get_utf8(struct grid *, u_int, u_int);
1783 void	 grid_view_set_utf8(
1784 	     struct grid *, u_int, u_int, const struct grid_utf8 *);
1785 void	 grid_view_clear_history(struct grid *);
1786 void	 grid_view_clear(struct grid *, u_int, u_int, u_int, u_int);
1787 void	 grid_view_scroll_region_up(struct grid *, u_int, u_int);
1788 void	 grid_view_scroll_region_down(struct grid *, u_int, u_int);
1789 void	 grid_view_insert_lines(struct grid *, u_int, u_int);
1790 void	 grid_view_insert_lines_region(struct grid *, u_int, u_int, u_int);
1791 void	 grid_view_delete_lines(struct grid *, u_int, u_int);
1792 void	 grid_view_delete_lines_region(struct grid *, u_int, u_int, u_int);
1793 void	 grid_view_insert_cells(struct grid *, u_int, u_int, u_int);
1794 void	 grid_view_delete_cells(struct grid *, u_int, u_int, u_int);
1795 char	*grid_view_string_cells(struct grid *, u_int, u_int, u_int);
1796 
1797 /* screen-write.c */
1798 void	 screen_write_start(
1799 	     struct screen_write_ctx *, struct window_pane *, struct screen *);
1800 void	 screen_write_stop(struct screen_write_ctx *);
1801 size_t printflike2 screen_write_cstrlen(int, const char *, ...);
1802 void printflike5 screen_write_cnputs(struct screen_write_ctx *,
1803 	     ssize_t, struct grid_cell *, int, const char *, ...);
1804 size_t printflike2 screen_write_strlen(int, const char *, ...);
1805 void printflike3 screen_write_puts(struct screen_write_ctx *,
1806 	     struct grid_cell *, const char *, ...);
1807 void printflike5 screen_write_nputs(struct screen_write_ctx *,
1808 	     ssize_t, struct grid_cell *, int, const char *, ...);
1809 void vprintflike5 screen_write_vnputs(struct screen_write_ctx *,
1810 	     ssize_t, struct grid_cell *, int, const char *, va_list);
1811 void	 screen_write_parsestyle(
1812 	     struct grid_cell *, struct grid_cell *, const char *);
1813 void	 screen_write_putc(
1814 	     struct screen_write_ctx *, struct grid_cell *, u_char);
1815 void	 screen_write_copy(struct screen_write_ctx *,
1816 	     struct screen *, u_int, u_int, u_int, u_int);
1817 void	 screen_write_backspace(struct screen_write_ctx *);
1818 void	 screen_write_cursorup(struct screen_write_ctx *, u_int);
1819 void	 screen_write_cursordown(struct screen_write_ctx *, u_int);
1820 void	 screen_write_cursorright(struct screen_write_ctx *, u_int);
1821 void	 screen_write_cursorleft(struct screen_write_ctx *, u_int);
1822 void	 screen_write_alignmenttest(struct screen_write_ctx *);
1823 void	 screen_write_insertcharacter(struct screen_write_ctx *, u_int);
1824 void	 screen_write_deletecharacter(struct screen_write_ctx *, u_int);
1825 void	 screen_write_insertline(struct screen_write_ctx *, u_int);
1826 void	 screen_write_deleteline(struct screen_write_ctx *, u_int);
1827 void	 screen_write_clearline(struct screen_write_ctx *);
1828 void	 screen_write_clearendofline(struct screen_write_ctx *);
1829 void	 screen_write_clearstartofline(struct screen_write_ctx *);
1830 void	 screen_write_cursormove(struct screen_write_ctx *, u_int, u_int);
1831 void	 screen_write_cursormode(struct screen_write_ctx *, int);
1832 void	 screen_write_reverseindex(struct screen_write_ctx *);
1833 void	 screen_write_scrollregion(struct screen_write_ctx *, u_int, u_int);
1834 void	 screen_write_insertmode(struct screen_write_ctx *, int);
1835 void	 screen_write_utf8mousemode(struct screen_write_ctx *, int);
1836 void	 screen_write_mousemode_on(struct screen_write_ctx *, int);
1837 void	 screen_write_mousemode_off(struct screen_write_ctx *);
1838 void	 screen_write_linefeed(struct screen_write_ctx *, int);
1839 void	 screen_write_linefeedscreen(struct screen_write_ctx *, int);
1840 void	 screen_write_carriagereturn(struct screen_write_ctx *);
1841 void	 screen_write_kcursormode(struct screen_write_ctx *, int);
1842 void	 screen_write_kkeypadmode(struct screen_write_ctx *, int);
1843 void	 screen_write_clearendofscreen(struct screen_write_ctx *);
1844 void	 screen_write_clearstartofscreen(struct screen_write_ctx *);
1845 void	 screen_write_clearscreen(struct screen_write_ctx *);
1846 void	 screen_write_cell(struct screen_write_ctx *,
1847 	     const struct grid_cell *, const struct utf8_data *);
1848 void	 screen_write_setselection(struct screen_write_ctx *, u_char *, u_int);
1849 void	 screen_write_rawstring(struct screen_write_ctx *, u_char *, u_int);
1850 
1851 /* screen-redraw.c */
1852 void	 screen_redraw_screen(struct client *, int, int);
1853 void	 screen_redraw_pane(struct client *, struct window_pane *);
1854 
1855 /* screen.c */
1856 void	 screen_init(struct screen *, u_int, u_int, u_int);
1857 void	 screen_reinit(struct screen *);
1858 void	 screen_free(struct screen *);
1859 void	 screen_reset_tabs(struct screen *);
1860 void	 screen_set_cursor_style(struct screen *, u_int);
1861 void	 screen_set_cursor_colour(struct screen *, const char *);
1862 void	 screen_set_title(struct screen *, const char *);
1863 void	 screen_resize(struct screen *, u_int, u_int);
1864 void	 screen_set_selection(struct screen *,
1865 	     u_int, u_int, u_int, u_int, u_int, struct grid_cell *);
1866 void	 screen_clear_selection(struct screen *);
1867 int	 screen_check_selection(struct screen *, u_int, u_int);
1868 
1869 /* window.c */
1870 extern struct windows windows;
1871 extern struct window_pane_tree all_window_panes;
1872 int		 winlink_cmp(struct winlink *, struct winlink *);
1873 RB_PROTOTYPE(winlinks, winlink, entry, winlink_cmp);
1874 int		 window_pane_cmp(struct window_pane *, struct window_pane *);
1875 RB_PROTOTYPE(window_pane_tree, window_pane, tree_entry, window_pane_cmp);
1876 struct winlink	*winlink_find_by_index(struct winlinks *, int);
1877 struct winlink	*winlink_find_by_window(struct winlinks *, struct window *);
1878 int		 winlink_next_index(struct winlinks *, int);
1879 u_int		 winlink_count(struct winlinks *);
1880 struct winlink	*winlink_add(struct winlinks *, int);
1881 void		 winlink_set_window(struct winlink *, struct window *);
1882 void		 winlink_remove(struct winlinks *, struct winlink *);
1883 struct winlink	*winlink_next(struct winlink *);
1884 struct winlink	*winlink_previous(struct winlink *);
1885 struct winlink	*winlink_next_by_number(struct winlink *, struct session *,
1886 		     int);
1887 struct winlink	*winlink_previous_by_number(struct winlink *, struct session *,
1888 		     int);
1889 void		 winlink_stack_push(struct winlink_stack *, struct winlink *);
1890 void		 winlink_stack_remove(struct winlink_stack *, struct winlink *);
1891 int		 window_index(struct window *, u_int *);
1892 struct window	*window_create1(u_int, u_int);
1893 struct window	*window_create(const char *, const char *, const char *,
1894 		     const char *, struct environ *, struct termios *,
1895 		     u_int, u_int, u_int, char **);
1896 void		 window_destroy(struct window *);
1897 struct window_pane *window_get_active_at(struct window *, u_int, u_int);
1898 void		 window_set_active_at(struct window *, u_int, u_int);
1899 struct window_pane *window_find_string(struct window *, const char *);
1900 void		 window_set_active_pane(struct window *, struct window_pane *);
1901 struct window_pane *window_add_pane(struct window *, u_int);
1902 void		 window_resize(struct window *, u_int, u_int);
1903 void		 window_remove_pane(struct window *, struct window_pane *);
1904 struct window_pane *window_pane_at_index(struct window *, u_int);
1905 struct window_pane *window_pane_next_by_number(struct window *,
1906 		        struct window_pane *, u_int);
1907 struct window_pane *window_pane_previous_by_number(struct window *,
1908 		        struct window_pane *, u_int);
1909 u_int		 window_pane_index(struct window *, struct window_pane *);
1910 u_int		 window_count_panes(struct window *);
1911 void		 window_destroy_panes(struct window *);
1912 struct window_pane *window_pane_find_by_id(u_int);
1913 struct window_pane *window_pane_create(struct window *, u_int, u_int, u_int);
1914 void		 window_pane_destroy(struct window_pane *);
1915 int		 window_pane_spawn(struct window_pane *, const char *,
1916 		     const char *, const char *, struct environ *,
1917 		     struct termios *, char **);
1918 void		 window_pane_resize(struct window_pane *, u_int, u_int);
1919 void		 window_pane_alternate_on(
1920 		     struct window_pane *, struct grid_cell *);
1921 void		 window_pane_alternate_off(
1922 		     struct window_pane *, struct grid_cell *);
1923 int		 window_pane_set_mode(
1924 		     struct window_pane *, const struct window_mode *);
1925 void		 window_pane_reset_mode(struct window_pane *);
1926 void		 window_pane_key(struct window_pane *, struct session *, int);
1927 void		 window_pane_mouse(struct window_pane *,
1928 		     struct session *, struct mouse_event *);
1929 int		 window_pane_visible(struct window_pane *);
1930 char		*window_pane_search(
1931 		     struct window_pane *, const char *, u_int *);
1932 char		*window_printable_flags(struct session *, struct winlink *);
1933 
1934 struct window_pane *window_pane_find_up(struct window_pane *);
1935 struct window_pane *window_pane_find_down(struct window_pane *);
1936 struct window_pane *window_pane_find_left(struct window_pane *);
1937 struct window_pane *window_pane_find_right(struct window_pane *);
1938 
1939 /* layout.c */
1940 u_int		 layout_count_cells(struct layout_cell *);
1941 struct layout_cell *layout_create_cell(struct layout_cell *);
1942 void		 layout_free_cell(struct layout_cell *);
1943 void		 layout_print_cell(struct layout_cell *, const char *, u_int);
1944 void		 layout_destroy_cell(struct layout_cell *, struct layout_cell **);
1945 void		 layout_set_size(
1946 		     struct layout_cell *, u_int, u_int, u_int, u_int);
1947 void		 layout_make_leaf(
1948 		     struct layout_cell *, struct window_pane *);
1949 void		 layout_make_node(struct layout_cell *, enum layout_type);
1950 void		 layout_fix_offsets(struct layout_cell *);
1951 void		 layout_fix_panes(struct window *, u_int, u_int);
1952 u_int		 layout_resize_check(struct layout_cell *, enum layout_type);
1953 void		 layout_resize_adjust(
1954 		     struct layout_cell *, enum layout_type, int);
1955 void		 layout_init(struct window *);
1956 void		 layout_free(struct window *);
1957 void		 layout_resize(struct window *, u_int, u_int);
1958 void		 layout_resize_pane(
1959 		     struct window_pane *, enum layout_type, int);
1960 void		 layout_resize_pane_mouse(
1961 		     struct client *c, struct mouse_event *mouse);
1962 void		 layout_assign_pane(struct layout_cell *, struct window_pane *);
1963 struct layout_cell *layout_split_pane(
1964 		     struct window_pane *, enum layout_type, int);
1965 void		 layout_close_pane(struct window_pane *);
1966 
1967 /* layout-custom.c */
1968 char		*layout_dump(struct window *);
1969 int		 layout_parse(struct window *, const char *);
1970 
1971 /* layout-set.c */
1972 const char	*layout_set_name(u_int);
1973 int		 layout_set_lookup(const char *);
1974 u_int		 layout_set_select(struct window *, u_int);
1975 u_int		 layout_set_next(struct window *);
1976 u_int		 layout_set_previous(struct window *);
1977 void		 layout_set_active_changed(struct window *);
1978 
1979 /* window-clock.c */
1980 extern const struct window_mode window_clock_mode;
1981 
1982 /* window-copy.c */
1983 extern const struct window_mode window_copy_mode;
1984 void		 window_copy_init_from_pane(struct window_pane *);
1985 void		 window_copy_init_for_output(struct window_pane *);
1986 void printflike2 window_copy_add(struct window_pane *, const char *, ...);
1987 void vprintflike2 window_copy_vadd(struct window_pane *, const char *, va_list);
1988 void		 window_copy_pageup(struct window_pane *);
1989 
1990 /* window-choose.c */
1991 extern const struct window_mode window_choose_mode;
1992 void vprintflike3 window_choose_vadd(
1993 		     struct window_pane *, int, const char *, va_list);
1994 void printflike3 window_choose_add(
1995 		     struct window_pane *, int, const char *, ...);
1996 void		 window_choose_ready(struct window_pane *,
1997 		     u_int, void (*)(void *, int), void (*)(void *), void *);
1998 
1999 /* names.c */
2000 void		 queue_window_name(struct window *);
2001 char		*default_window_name(struct window *);
2002 
2003 /* signal.c */
2004 void set_signals(void(*)(int, short, void *));
2005 void clear_signals(int);
2006 
2007 /* session.c */
2008 extern struct sessions sessions;
2009 extern struct sessions dead_sessions;
2010 extern struct session_groups session_groups;
2011 int	session_cmp(struct session *, struct session *);
2012 RB_PROTOTYPE(sessions, session, entry, session_cmp);
2013 int		 session_alive(struct session *);
2014 struct session	*session_find(const char *);
2015 struct session	*session_find_by_index(u_int);
2016 struct session	*session_create(const char *, const char *, const char *,
2017 		     struct environ *, struct termios *, int, u_int, u_int,
2018 		     char **);
2019 void		 session_destroy(struct session *);
2020 int		 session_check_name(const char *);
2021 void		 session_update_activity(struct session *);
2022 struct session	*session_next_session(struct session *);
2023 struct session	*session_previous_session(struct session *);
2024 struct winlink	*session_new(struct session *,
2025 		     const char *, const char *, const char *, int, char **);
2026 struct winlink	*session_attach(
2027 		     struct session *, struct window *, int, char **);
2028 int		 session_detach(struct session *, struct winlink *);
2029 struct winlink*	 session_has(struct session *, struct window *);
2030 int		 session_next(struct session *, int);
2031 int		 session_previous(struct session *, int);
2032 int		 session_select(struct session *, int);
2033 int		 session_last(struct session *);
2034 struct session_group *session_group_find(struct session *);
2035 u_int		 session_group_index(struct session_group *);
2036 void		 session_group_add(struct session *, struct session *);
2037 void		 session_group_remove(struct session *);
2038 void		 session_group_synchronize_to(struct session *);
2039 void		 session_group_synchronize_from(struct session *);
2040 void		 session_group_synchronize1(struct session *, struct session *);
2041 
2042 /* utf8.c */
2043 void	utf8_build(void);
2044 int	utf8_open(struct utf8_data *, u_char);
2045 int	utf8_append(struct utf8_data *, u_char);
2046 u_int	utf8_combine(const struct utf8_data *);
2047 u_int	utf8_split2(u_int, u_char *);
2048 
2049 /* osdep-*.c */
2050 char		*osdep_get_name(int, char *);
2051 struct event_base *osdep_event_init(void);
2052 
2053 /* log.c */
2054 void		 log_open_tty(int);
2055 void		 log_open_file(int, const char *);
2056 void		 log_close(void);
2057 void printflike1 log_warn(const char *, ...);
2058 void printflike1 log_warnx(const char *, ...);
2059 void printflike1 log_info(const char *, ...);
2060 void printflike1 log_debug(const char *, ...);
2061 void printflike1 log_debug2(const char *, ...);
2062 __dead void printflike1 log_fatal(const char *, ...);
2063 __dead void printflike1 log_fatalx(const char *, ...);
2064 
2065 /* xmalloc.c */
2066 char		*xstrdup(const char *);
2067 void		*xcalloc(size_t, size_t);
2068 void		*xmalloc(size_t);
2069 void		*xrealloc(void *, size_t, size_t);
2070 void		 xfree(void *);
2071 int printflike2	 xasprintf(char **, const char *, ...);
2072 int vprintflike2 xvasprintf(char **, const char *, va_list);
2073 int printflike3	 xsnprintf(char *, size_t, const char *, ...);
2074 int vprintflike3 xvsnprintf(char *, size_t, const char *, va_list);
2075 
2076 /* utmp.c */
2077 struct window_utmp *utmp_create(const char *);
2078 void		 utmp_destroy(struct window_utmp *);
2079 
2080 #endif /* TMUX_H */
2081