xref: /openbsd-src/usr.bin/tmux/tmux.h (revision c0dd97bfcad3dab6c31ec12b9de1274fd2d2f993)
1 /* $OpenBSD: tmux.h,v 1.808 2017/10/25 11:26:11 nicm Exp $ */
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 #define PROTOCOL_VERSION 8
23 
24 #include <sys/time.h>
25 #include <sys/queue.h>
26 #include <sys/tree.h>
27 
28 #include <bitstring.h>
29 #include <event.h>
30 #include <limits.h>
31 #include <stdarg.h>
32 #include <stdint.h>
33 #include <stdio.h>
34 #include <termios.h>
35 #include <wchar.h>
36 
37 #include "xmalloc.h"
38 
39 extern char   **environ;
40 
41 struct args;
42 struct client;
43 struct cmd_find_state;
44 struct cmdq_item;
45 struct cmdq_list;
46 struct environ;
47 struct format_job_tree;
48 struct input_ctx;
49 struct mode_tree_data;
50 struct mouse_event;
51 struct options;
52 struct options_entry;
53 struct session;
54 struct tmuxpeer;
55 struct tmuxproc;
56 
57 /* Default global configuration file. */
58 #define TMUX_CONF "/etc/tmux.conf"
59 
60 /*
61  * Minimum layout cell size, NOT including separator line. The scroll region
62  * cannot be one line in height so this must be at least two.
63  */
64 #define PANE_MINIMUM 2
65 
66 /* Automatic name refresh interval, in microseconds. Must be < 1 second. */
67 #define NAME_INTERVAL 500000
68 
69 /* Maximum size of data to hold from a pane. */
70 #define READ_SIZE 4096
71 
72 /* Attribute to make GCC check printf-like arguments. */
73 #define printflike(a, b) __attribute__ ((format (printf, a, b)))
74 
75 /* Number of items in array. */
76 #ifndef nitems
77 #define nitems(_a) (sizeof((_a)) / sizeof((_a)[0]))
78 #endif
79 
80 /* Alert option values. */
81 #define ALERT_NONE 0
82 #define ALERT_ANY 1
83 #define ALERT_CURRENT 2
84 #define ALERT_OTHER 3
85 
86 /* Visual option values. */
87 #define VISUAL_OFF 0
88 #define VISUAL_ON 1
89 #define VISUAL_BOTH 2
90 
91 /* Special key codes. */
92 #define KEYC_NONE 0xffff00000000ULL
93 #define KEYC_UNKNOWN 0xfffe00000000ULL
94 #define KEYC_BASE 0x000010000000ULL
95 #define KEYC_USER 0x000020000000ULL
96 
97 /* Available user keys. */
98 #define KEYC_NUSER 1000
99 
100 /* Key modifier bits. */
101 #define KEYC_ESCAPE 0x200000000000ULL
102 #define KEYC_CTRL 0x400000000000ULL
103 #define KEYC_SHIFT 0x800000000000ULL
104 #define KEYC_XTERM 0x1000000000000ULL
105 
106 /* Mask to obtain key w/o modifiers. */
107 #define KEYC_MASK_MOD (KEYC_ESCAPE|KEYC_CTRL|KEYC_SHIFT|KEYC_XTERM)
108 #define KEYC_MASK_KEY (~KEYC_MASK_MOD)
109 
110 /* Is this a mouse key? */
111 #define KEYC_IS_MOUSE(key) (((key) & KEYC_MASK_KEY) >= KEYC_MOUSE &&	\
112     ((key) & KEYC_MASK_KEY) < KEYC_BSPACE)
113 
114 /* Multiple click timeout. */
115 #define KEYC_CLICK_TIMEOUT 300
116 
117 /* Mouse key codes. */
118 #define KEYC_MOUSE_KEY(name)				\
119 	KEYC_ ## name ## _PANE,				\
120 	KEYC_ ## name ## _STATUS,			\
121 	KEYC_ ## name ## _BORDER
122 #define KEYC_MOUSE_STRING(name, s)			\
123 	{ #s "Pane", KEYC_ ## name ## _PANE },		\
124 	{ #s "Status", KEYC_ ## name ## _STATUS },	\
125 	{ #s "Border", KEYC_ ## name ## _BORDER }
126 
127 /*
128  * A single key. This can be ASCII or Unicode or one of the keys starting at
129  * KEYC_BASE.
130  */
131 typedef unsigned long long key_code;
132 
133 /* Special key codes. */
134 enum {
135 	/* Focus events. */
136 	KEYC_FOCUS_IN = KEYC_BASE,
137 	KEYC_FOCUS_OUT,
138 
139 	/* Paste brackets. */
140 	KEYC_PASTE_START,
141 	KEYC_PASTE_END,
142 
143 	/* Mouse keys. */
144 	KEYC_MOUSE, /* unclassified mouse event */
145 	KEYC_DRAGGING, /* dragging in progress */
146 	KEYC_MOUSE_KEY(MOUSEMOVE),
147 	KEYC_MOUSE_KEY(MOUSEDOWN1),
148 	KEYC_MOUSE_KEY(MOUSEDOWN2),
149 	KEYC_MOUSE_KEY(MOUSEDOWN3),
150 	KEYC_MOUSE_KEY(MOUSEUP1),
151 	KEYC_MOUSE_KEY(MOUSEUP2),
152 	KEYC_MOUSE_KEY(MOUSEUP3),
153 	KEYC_MOUSE_KEY(MOUSEDRAG1),
154 	KEYC_MOUSE_KEY(MOUSEDRAG2),
155 	KEYC_MOUSE_KEY(MOUSEDRAG3),
156 	KEYC_MOUSE_KEY(MOUSEDRAGEND1),
157 	KEYC_MOUSE_KEY(MOUSEDRAGEND2),
158 	KEYC_MOUSE_KEY(MOUSEDRAGEND3),
159 	KEYC_MOUSE_KEY(WHEELUP),
160 	KEYC_MOUSE_KEY(WHEELDOWN),
161 	KEYC_MOUSE_KEY(DOUBLECLICK1),
162 	KEYC_MOUSE_KEY(DOUBLECLICK2),
163 	KEYC_MOUSE_KEY(DOUBLECLICK3),
164 	KEYC_MOUSE_KEY(TRIPLECLICK1),
165 	KEYC_MOUSE_KEY(TRIPLECLICK2),
166 	KEYC_MOUSE_KEY(TRIPLECLICK3),
167 
168 	/* Backspace key. */
169 	KEYC_BSPACE,
170 
171 	/* Function keys. */
172 	KEYC_F1,
173 	KEYC_F2,
174 	KEYC_F3,
175 	KEYC_F4,
176 	KEYC_F5,
177 	KEYC_F6,
178 	KEYC_F7,
179 	KEYC_F8,
180 	KEYC_F9,
181 	KEYC_F10,
182 	KEYC_F11,
183 	KEYC_F12,
184 	KEYC_IC,
185 	KEYC_DC,
186 	KEYC_HOME,
187 	KEYC_END,
188 	KEYC_NPAGE,
189 	KEYC_PPAGE,
190 	KEYC_BTAB,
191 
192 	/* Arrow keys. */
193 	KEYC_UP,
194 	KEYC_DOWN,
195 	KEYC_LEFT,
196 	KEYC_RIGHT,
197 
198 	/* Numeric keypad. */
199 	KEYC_KP_SLASH,
200 	KEYC_KP_STAR,
201 	KEYC_KP_MINUS,
202 	KEYC_KP_SEVEN,
203 	KEYC_KP_EIGHT,
204 	KEYC_KP_NINE,
205 	KEYC_KP_PLUS,
206 	KEYC_KP_FOUR,
207 	KEYC_KP_FIVE,
208 	KEYC_KP_SIX,
209 	KEYC_KP_ONE,
210 	KEYC_KP_TWO,
211 	KEYC_KP_THREE,
212 	KEYC_KP_ENTER,
213 	KEYC_KP_ZERO,
214 	KEYC_KP_PERIOD,
215 };
216 
217 /* Termcap codes. */
218 enum tty_code_code {
219 	TTYC_AX = 0,
220 	TTYC_ACSC,
221 	TTYC_BCE,
222 	TTYC_BEL,
223 	TTYC_BLINK,
224 	TTYC_BOLD,
225 	TTYC_CIVIS,
226 	TTYC_CLEAR,
227 	TTYC_CNORM,
228 	TTYC_COLORS,
229 	TTYC_CR,
230 	TTYC_CS,
231 	TTYC_CSR,
232 	TTYC_CUB,
233 	TTYC_CUB1,
234 	TTYC_CUD,
235 	TTYC_CUD1,
236 	TTYC_CUF,
237 	TTYC_CUF1,
238 	TTYC_CUP,
239 	TTYC_CUU,
240 	TTYC_CUU1,
241 	TTYC_CVVIS,
242 	TTYC_DCH,
243 	TTYC_DCH1,
244 	TTYC_DIM,
245 	TTYC_DL,
246 	TTYC_DL1,
247 	TTYC_E3,
248 	TTYC_ECH,
249 	TTYC_ED,
250 	TTYC_EL,
251 	TTYC_EL1,
252 	TTYC_ENACS,
253 	TTYC_FSL,
254 	TTYC_HOME,
255 	TTYC_HPA,
256 	TTYC_ICH,
257 	TTYC_ICH1,
258 	TTYC_IL,
259 	TTYC_IL1,
260 	TTYC_INDN,
261 	TTYC_INVIS,
262 	TTYC_KCBT,
263 	TTYC_KCUB1,
264 	TTYC_KCUD1,
265 	TTYC_KCUF1,
266 	TTYC_KCUU1,
267 	TTYC_KDC2,
268 	TTYC_KDC3,
269 	TTYC_KDC4,
270 	TTYC_KDC5,
271 	TTYC_KDC6,
272 	TTYC_KDC7,
273 	TTYC_KDCH1,
274 	TTYC_KDN2,
275 	TTYC_KDN3,
276 	TTYC_KDN4,
277 	TTYC_KDN5,
278 	TTYC_KDN6,
279 	TTYC_KDN7,
280 	TTYC_KEND,
281 	TTYC_KEND2,
282 	TTYC_KEND3,
283 	TTYC_KEND4,
284 	TTYC_KEND5,
285 	TTYC_KEND6,
286 	TTYC_KEND7,
287 	TTYC_KF1,
288 	TTYC_KF10,
289 	TTYC_KF11,
290 	TTYC_KF12,
291 	TTYC_KF13,
292 	TTYC_KF14,
293 	TTYC_KF15,
294 	TTYC_KF16,
295 	TTYC_KF17,
296 	TTYC_KF18,
297 	TTYC_KF19,
298 	TTYC_KF2,
299 	TTYC_KF20,
300 	TTYC_KF21,
301 	TTYC_KF22,
302 	TTYC_KF23,
303 	TTYC_KF24,
304 	TTYC_KF25,
305 	TTYC_KF26,
306 	TTYC_KF27,
307 	TTYC_KF28,
308 	TTYC_KF29,
309 	TTYC_KF3,
310 	TTYC_KF30,
311 	TTYC_KF31,
312 	TTYC_KF32,
313 	TTYC_KF33,
314 	TTYC_KF34,
315 	TTYC_KF35,
316 	TTYC_KF36,
317 	TTYC_KF37,
318 	TTYC_KF38,
319 	TTYC_KF39,
320 	TTYC_KF4,
321 	TTYC_KF40,
322 	TTYC_KF41,
323 	TTYC_KF42,
324 	TTYC_KF43,
325 	TTYC_KF44,
326 	TTYC_KF45,
327 	TTYC_KF46,
328 	TTYC_KF47,
329 	TTYC_KF48,
330 	TTYC_KF49,
331 	TTYC_KF5,
332 	TTYC_KF50,
333 	TTYC_KF51,
334 	TTYC_KF52,
335 	TTYC_KF53,
336 	TTYC_KF54,
337 	TTYC_KF55,
338 	TTYC_KF56,
339 	TTYC_KF57,
340 	TTYC_KF58,
341 	TTYC_KF59,
342 	TTYC_KF6,
343 	TTYC_KF60,
344 	TTYC_KF61,
345 	TTYC_KF62,
346 	TTYC_KF63,
347 	TTYC_KF7,
348 	TTYC_KF8,
349 	TTYC_KF9,
350 	TTYC_KHOM2,
351 	TTYC_KHOM3,
352 	TTYC_KHOM4,
353 	TTYC_KHOM5,
354 	TTYC_KHOM6,
355 	TTYC_KHOM7,
356 	TTYC_KHOME,
357 	TTYC_KIC2,
358 	TTYC_KIC3,
359 	TTYC_KIC4,
360 	TTYC_KIC5,
361 	TTYC_KIC6,
362 	TTYC_KIC7,
363 	TTYC_KICH1,
364 	TTYC_KIND,
365 	TTYC_KLFT2,
366 	TTYC_KLFT3,
367 	TTYC_KLFT4,
368 	TTYC_KLFT5,
369 	TTYC_KLFT6,
370 	TTYC_KLFT7,
371 	TTYC_KMOUS,
372 	TTYC_KNP,
373 	TTYC_KNXT2,
374 	TTYC_KNXT3,
375 	TTYC_KNXT4,
376 	TTYC_KNXT5,
377 	TTYC_KNXT6,
378 	TTYC_KNXT7,
379 	TTYC_KPP,
380 	TTYC_KPRV2,
381 	TTYC_KPRV3,
382 	TTYC_KPRV4,
383 	TTYC_KPRV5,
384 	TTYC_KPRV6,
385 	TTYC_KPRV7,
386 	TTYC_KRI,
387 	TTYC_KRIT2,
388 	TTYC_KRIT3,
389 	TTYC_KRIT4,
390 	TTYC_KRIT5,
391 	TTYC_KRIT6,
392 	TTYC_KRIT7,
393 	TTYC_KUP2,
394 	TTYC_KUP3,
395 	TTYC_KUP4,
396 	TTYC_KUP5,
397 	TTYC_KUP6,
398 	TTYC_KUP7,
399 	TTYC_MS,
400 	TTYC_OP,
401 	TTYC_REV,
402 	TTYC_RI,
403 	TTYC_RMACS,
404 	TTYC_RMCUP,
405 	TTYC_RMKX,
406 	TTYC_SE,
407 	TTYC_SETAB,
408 	TTYC_SETAF,
409 	TTYC_SETRGBB,
410 	TTYC_SETRGBF,
411 	TTYC_SGR0,
412 	TTYC_SITM,
413 	TTYC_SMACS,
414 	TTYC_SMCUP,
415 	TTYC_SMKX,
416 	TTYC_SMSO,
417 	TTYC_SMUL,
418 	TTYC_SMXX,
419 	TTYC_SS,
420 	TTYC_TC,
421 	TTYC_TSL,
422 	TTYC_U8,
423 	TTYC_VPA,
424 	TTYC_XENL,
425 	TTYC_XT,
426 };
427 
428 /* Message codes. */
429 enum msgtype {
430 	MSG_VERSION = 12,
431 
432 	MSG_IDENTIFY_FLAGS = 100,
433 	MSG_IDENTIFY_TERM,
434 	MSG_IDENTIFY_TTYNAME,
435 	MSG_IDENTIFY_OLDCWD, /* unused */
436 	MSG_IDENTIFY_STDIN,
437 	MSG_IDENTIFY_ENVIRON,
438 	MSG_IDENTIFY_DONE,
439 	MSG_IDENTIFY_CLIENTPID,
440 	MSG_IDENTIFY_CWD,
441 
442 	MSG_COMMAND = 200,
443 	MSG_DETACH,
444 	MSG_DETACHKILL,
445 	MSG_EXIT,
446 	MSG_EXITED,
447 	MSG_EXITING,
448 	MSG_LOCK,
449 	MSG_READY,
450 	MSG_RESIZE,
451 	MSG_SHELL,
452 	MSG_SHUTDOWN,
453 	MSG_STDERR,
454 	MSG_STDIN,
455 	MSG_STDOUT,
456 	MSG_SUSPEND,
457 	MSG_UNLOCK,
458 	MSG_WAKEUP,
459 	MSG_EXEC,
460 };
461 
462 /*
463  * Message data.
464  *
465  * Don't forget to bump PROTOCOL_VERSION if any of these change!
466  */
467 struct msg_command_data {
468 	int	argc;
469 }; /* followed by packed argv */
470 
471 struct msg_stdin_data {
472 	ssize_t	size;
473 	char	data[BUFSIZ];
474 };
475 
476 struct msg_stdout_data {
477 	ssize_t	size;
478 	char	data[BUFSIZ];
479 };
480 
481 struct msg_stderr_data {
482 	ssize_t	size;
483 	char	data[BUFSIZ];
484 };
485 
486 /* Mode keys. */
487 #define MODEKEY_EMACS 0
488 #define MODEKEY_VI 1
489 
490 /* Modes. */
491 #define MODE_CURSOR 0x1
492 #define MODE_INSERT 0x2
493 #define MODE_KCURSOR 0x4
494 #define MODE_KKEYPAD 0x8	/* set = application, clear = number */
495 #define MODE_WRAP 0x10		/* whether lines wrap */
496 #define MODE_MOUSE_STANDARD 0x20
497 #define MODE_MOUSE_BUTTON 0x40
498 #define MODE_BLINKING 0x80
499 #define MODE_MOUSE_UTF8 0x100
500 #define MODE_MOUSE_SGR 0x200
501 #define MODE_BRACKETPASTE 0x400
502 #define MODE_FOCUSON 0x800
503 #define MODE_MOUSE_ALL 0x1000
504 
505 #define ALL_MODES 0xffffff
506 #define ALL_MOUSE_MODES (MODE_MOUSE_STANDARD|MODE_MOUSE_BUTTON|MODE_MOUSE_ALL)
507 
508 /*
509  * A single UTF-8 character. UTF8_SIZE must be big enough to hold at least one
510  * combining character as well.
511 */
512 #define UTF8_SIZE 9
513 struct utf8_data {
514 	u_char	data[UTF8_SIZE];
515 
516 	u_char	have;
517 	u_char	size;
518 
519 	u_char	width;	/* 0xff if invalid */
520 } __packed;
521 enum utf8_state {
522 	UTF8_MORE,
523 	UTF8_DONE,
524 	UTF8_ERROR
525 };
526 
527 /* Colour flags. */
528 #define COLOUR_FLAG_256 0x01000000
529 #define COLOUR_FLAG_RGB 0x02000000
530 
531 /* Grid attributes. Anything above 0xff is stored in an extended cell. */
532 #define GRID_ATTR_BRIGHT 0x1
533 #define GRID_ATTR_DIM 0x2
534 #define GRID_ATTR_UNDERSCORE 0x4
535 #define GRID_ATTR_BLINK 0x8
536 #define GRID_ATTR_REVERSE 0x10
537 #define GRID_ATTR_HIDDEN 0x20
538 #define GRID_ATTR_ITALICS 0x40
539 #define GRID_ATTR_CHARSET 0x80	/* alternative character set */
540 #define GRID_ATTR_STRIKETHROUGH 0x100
541 
542 /* Grid flags. */
543 #define GRID_FLAG_FG256 0x1
544 #define GRID_FLAG_BG256 0x2
545 #define GRID_FLAG_PADDING 0x4
546 #define GRID_FLAG_EXTENDED 0x8
547 #define GRID_FLAG_SELECTED 0x10
548 #define GRID_FLAG_NOPALETTE 0x20
549 
550 /* Grid line flags. */
551 #define GRID_LINE_WRAPPED 0x1
552 #define GRID_LINE_EXTENDED 0x2
553 
554 /* Grid cell data. */
555 struct grid_cell {
556 	u_char			flags;
557 	u_short			attr;
558 	int			fg;
559 	int			bg;
560 	struct utf8_data	data;
561 };
562 struct grid_cell_entry {
563 	u_char			flags;
564 	union {
565 		u_int		offset;
566 		struct {
567 			u_char	attr;
568 			u_char	fg;
569 			u_char	bg;
570 			u_char	data;
571 		} data;
572 	};
573 } __packed;
574 
575 /* Grid line. */
576 struct grid_line {
577 	u_int			 cellused;
578 	u_int			 cellsize;
579 	struct grid_cell_entry	*celldata;
580 
581 	u_int			 extdsize;
582 	struct grid_cell	*extddata;
583 
584 	int			 flags;
585 } __packed;
586 
587 /* Entire grid of cells. */
588 struct grid {
589 	int			 flags;
590 #define GRID_HISTORY 0x1 /* scroll lines into history */
591 
592 	u_int			 sx;
593 	u_int			 sy;
594 
595 	u_int			 hscrolled;
596 	u_int			 hsize;
597 	u_int			 hlimit;
598 
599 	struct grid_line	*linedata;
600 };
601 
602 /* Hook data structures. */
603 struct hook {
604 	const char	*name;
605 
606 	struct cmd_list	*cmdlist;
607 
608 	RB_ENTRY(hook)	 entry;
609 };
610 
611 /* Scheduled job. */
612 struct job;
613 typedef void (*job_update_cb) (struct job *);
614 typedef void (*job_complete_cb) (struct job *);
615 typedef void (*job_free_cb) (void *);
616 struct job {
617 	enum {
618 		JOB_RUNNING,
619 		JOB_DEAD,
620 		JOB_CLOSED
621 	} state;
622 
623 	char			*cmd;
624 	pid_t			 pid;
625 	int			 status;
626 
627 	int			 fd;
628 	struct bufferevent	*event;
629 
630 	job_update_cb		 updatecb;
631 	job_complete_cb		 completecb;
632 	job_free_cb		 freecb;
633 	void			*data;
634 
635 	LIST_ENTRY(job)		 entry;
636 };
637 LIST_HEAD(joblist, job);
638 
639 /* Screen selection. */
640 struct screen_sel {
641 	int		 flag;
642 	int		 hidden;
643 
644 	int		 rectflag;
645 	enum {
646 		LINE_SEL_NONE,
647 		LINE_SEL_LEFT_RIGHT,
648 		LINE_SEL_RIGHT_LEFT,
649 	} lineflag;
650 
651 	int		 modekeys;
652 
653 	u_int		 sx;
654 	u_int		 sy;
655 
656 	u_int		 ex;
657 	u_int		 ey;
658 
659 	struct grid_cell cell;
660 };
661 
662 /* Virtual screen. */
663 struct screen_titles;
664 struct screen {
665 	char			*title;
666 	struct screen_titles	*titles;
667 
668 	struct grid		*grid;		/* grid data */
669 
670 	u_int			 cx;		/* cursor x */
671 	u_int			 cy;		/* cursor y */
672 
673 	u_int			 cstyle;	/* cursor style */
674 	char			*ccolour;	/* cursor colour string */
675 
676 	u_int			 rupper;	/* scroll region top */
677 	u_int			 rlower;	/* scroll region bottom */
678 
679 	int			 mode;
680 
681 	bitstr_t		*tabs;
682 
683 	struct screen_sel	 sel;
684 };
685 
686 /* Screen write context. */
687 struct screen_write_collect_item;
688 struct screen_write_collect_line;
689 struct screen_write_ctx {
690 	struct window_pane	*wp;
691 	struct screen		*s;
692 
693 	struct screen_write_collect_item *item;
694 	struct screen_write_collect_line *list;
695 	u_int			 scrolled;
696 	u_int			 bg;
697 
698 	u_int			 cells;
699 	u_int			 written;
700 	u_int			 skipped;
701 };
702 
703 /* Screen size. */
704 #define screen_size_x(s) ((s)->grid->sx)
705 #define screen_size_y(s) ((s)->grid->sy)
706 #define screen_hsize(s) ((s)->grid->hsize)
707 #define screen_hlimit(s) ((s)->grid->hlimit)
708 
709 /*
710  * Window mode. Windows can be in several modes and this is used to call the
711  * right function to handle input and output.
712  */
713 struct window_mode {
714 	const char	*name;
715 
716 	struct screen	*(*init)(struct window_pane *, struct cmd_find_state *,
717 			     struct args *);
718 	void		 (*free)(struct window_pane *);
719 	void		 (*resize)(struct window_pane *, u_int, u_int);
720 	void		 (*key)(struct window_pane *, struct client *,
721 			     struct session *, key_code, struct mouse_event *);
722 
723 	const char	*(*key_table)(struct window_pane *);
724 	void		 (*command)(struct window_pane *, struct client *,
725 			     struct session *, struct args *,
726 			     struct mouse_event *);
727 };
728 #define WINDOW_MODE_TIMEOUT 180
729 
730 /* Structures for choose mode. */
731 struct window_choose_data {
732 	struct client		*start_client;
733 	struct session		*start_session;
734 
735 	u_int			 idx;
736 	int			 type;
737 #define TREE_OTHER 0x0
738 #define TREE_WINDOW 0x1
739 #define TREE_SESSION 0x2
740 
741 	struct session		*tree_session; /* session of items in tree */
742 
743 	struct winlink		*wl;
744 	int			 pane_id;
745 
746 	char			*ft_template;
747 	struct format_tree	*ft;
748 
749 	char			*command;
750 };
751 
752 /* Child window structure. */
753 struct window_pane {
754 	u_int		 id;
755 	u_int		 active_point;
756 
757 	struct window	*window;
758 
759 	struct layout_cell *layout_cell;
760 	struct layout_cell *saved_layout_cell;
761 
762 	u_int		 sx;
763 	u_int		 sy;
764 
765 	u_int		 osx;
766 	u_int		 osy;
767 
768 	u_int		 xoff;
769 	u_int		 yoff;
770 
771 	int		 flags;
772 #define PANE_REDRAW 0x1
773 #define PANE_DROP 0x2
774 #define PANE_FOCUSED 0x4
775 #define PANE_RESIZE 0x8
776 #define PANE_RESIZEFORCE 0x10
777 #define PANE_FOCUSPUSH 0x20
778 #define PANE_INPUTOFF 0x40
779 #define PANE_CHANGED 0x80
780 #define PANE_EXITED 0x100
781 #define PANE_STATUSREADY 0x200
782 #define PANE_STATUSDRAWN 0x400
783 
784 	int		 argc;
785 	char	       **argv;
786 	char		*shell;
787 	const char	*cwd;
788 
789 	pid_t		 pid;
790 	char		 tty[TTY_NAME_MAX];
791 	int		 status;
792 
793 	int		 fd;
794 	struct bufferevent *event;
795 
796 	struct event	 resize_timer;
797 
798 	struct input_ctx *ictx;
799 
800 	struct grid_cell colgc;
801 
802 	int		*palette;
803 
804 	int		 pipe_fd;
805 	struct bufferevent *pipe_event;
806 	size_t		 pipe_off;
807 
808 	struct screen	*screen;
809 	struct screen	 base;
810 
811 	struct screen	 status_screen;
812 	size_t		 status_size;
813 
814 	/* Saved in alternative screen mode. */
815 	u_int		 saved_cx;
816 	u_int		 saved_cy;
817 	struct grid	*saved_grid;
818 	struct grid_cell saved_cell;
819 
820 	const struct window_mode *mode;
821 	void		*modedata;
822 	struct event	 modetimer;
823 	time_t		 modelast;
824 	u_int		 modeprefix;
825 	char		*searchstr;
826 
827 	TAILQ_ENTRY(window_pane) entry;
828 	RB_ENTRY(window_pane) tree_entry;
829 };
830 TAILQ_HEAD(window_panes, window_pane);
831 RB_HEAD(window_pane_tree, window_pane);
832 
833 /* Window structure. */
834 struct window {
835 	u_int		 id;
836 
837 	char		*name;
838 	struct event	 name_event;
839 	struct timeval	 name_time;
840 
841 	struct event	 alerts_timer;
842 
843 	struct timeval	 activity_time;
844 
845 	struct window_pane *active;
846 	struct window_pane *last;
847 	struct window_panes panes;
848 
849 	int		 lastlayout;
850 	struct layout_cell *layout_root;
851 	struct layout_cell *saved_layout_root;
852 	char		*old_layout;
853 
854 	u_int		 sx;
855 	u_int		 sy;
856 
857 	int		 flags;
858 #define WINDOW_BELL 0x1
859 #define WINDOW_ACTIVITY 0x2
860 /* 0x4 unused */
861 #define WINDOW_SILENCE 0x8
862 #define WINDOW_ZOOMED 0x1000
863 #define WINDOW_FORCEWIDTH 0x2000
864 #define WINDOW_FORCEHEIGHT 0x4000
865 #define WINDOW_STYLECHANGED 0x8000
866 #define WINDOW_ALERTFLAGS (WINDOW_BELL|WINDOW_ACTIVITY|WINDOW_SILENCE)
867 
868 	int		 alerts_queued;
869 	TAILQ_ENTRY(window) alerts_entry;
870 
871 	struct options	*options;
872 
873 	struct grid_cell style;
874 	struct grid_cell active_style;
875 
876 	u_int		 references;
877 	TAILQ_HEAD(, winlink) winlinks;
878 
879 	RB_ENTRY(window) entry;
880 };
881 RB_HEAD(windows, window);
882 
883 /* Entry on local window list. */
884 struct winlink {
885 	int		 idx;
886 	struct session	*session;
887 	struct window	*window;
888 
889 	size_t		 status_width;
890 	struct grid_cell status_cell;
891 	char		*status_text;
892 
893 	int		 flags;
894 #define WINLINK_BELL 0x1
895 #define WINLINK_ACTIVITY 0x2
896 #define WINLINK_SILENCE 0x4
897 #define WINLINK_ALERTFLAGS (WINLINK_BELL|WINLINK_ACTIVITY|WINLINK_SILENCE)
898 
899 	RB_ENTRY(winlink) entry;
900 	TAILQ_ENTRY(winlink) wentry;
901 	TAILQ_ENTRY(winlink) sentry;
902 };
903 RB_HEAD(winlinks, winlink);
904 TAILQ_HEAD(winlink_stack, winlink);
905 
906 /* Layout direction. */
907 enum layout_type {
908 	LAYOUT_LEFTRIGHT,
909 	LAYOUT_TOPBOTTOM,
910 	LAYOUT_WINDOWPANE
911 };
912 
913 /* Layout cells queue. */
914 TAILQ_HEAD(layout_cells, layout_cell);
915 
916 /* Layout cell. */
917 struct layout_cell {
918 	enum layout_type type;
919 
920 	struct layout_cell *parent;
921 
922 	u_int		 sx;
923 	u_int		 sy;
924 
925 	u_int		 xoff;
926 	u_int		 yoff;
927 
928 	struct window_pane *wp;
929 	struct layout_cells cells;
930 
931 	TAILQ_ENTRY(layout_cell) entry;
932 };
933 
934 /* Environment variable. */
935 struct environ_entry {
936 	char		*name;
937 	char		*value;
938 
939 	RB_ENTRY(environ_entry) entry;
940 };
941 
942 /* Client session. */
943 struct session_group {
944 	const char		*name;
945 	TAILQ_HEAD(, session)	 sessions;
946 
947 	RB_ENTRY(session_group)	 entry;
948 };
949 RB_HEAD(session_groups, session_group);
950 
951 struct session {
952 	u_int		 id;
953 
954 	char		*name;
955 	const char	*cwd;
956 
957 	struct timeval	 creation_time;
958 	struct timeval	 last_attached_time;
959 	struct timeval	 activity_time;
960 	struct timeval	 last_activity_time;
961 
962 	struct event	 lock_timer;
963 
964 	u_int		 sx;
965 	u_int		 sy;
966 
967 	struct winlink	*curw;
968 	struct winlink_stack lastw;
969 	struct winlinks	 windows;
970 
971 	int		 statusat;
972 
973 	struct hooks	*hooks;
974 	struct options	*options;
975 
976 #define SESSION_UNATTACHED 0x1	/* not attached to any clients */
977 #define SESSION_PASTING 0x2
978 #define SESSION_ALERTED 0x4
979 	int		 flags;
980 
981 	u_int		 attached;
982 
983 	struct termios	*tio;
984 
985 	struct environ	*environ;
986 
987 	int		 references;
988 
989 	TAILQ_ENTRY(session) gentry;
990 	RB_ENTRY(session)    entry;
991 };
992 RB_HEAD(sessions, session);
993 
994 /* Mouse button masks. */
995 #define MOUSE_MASK_BUTTONS 3
996 #define MOUSE_MASK_SHIFT 4
997 #define MOUSE_MASK_META 8
998 #define MOUSE_MASK_CTRL 16
999 #define MOUSE_MASK_DRAG 32
1000 #define MOUSE_MASK_WHEEL 64
1001 
1002 /* Mouse wheel states. */
1003 #define MOUSE_WHEEL_UP 0
1004 #define MOUSE_WHEEL_DOWN 64
1005 
1006 /* Mouse helpers. */
1007 #define MOUSE_BUTTONS(b) ((b) & MOUSE_MASK_BUTTONS)
1008 #define MOUSE_WHEEL(b) ((b) & MOUSE_MASK_WHEEL)
1009 #define MOUSE_DRAG(b) ((b) & MOUSE_MASK_DRAG)
1010 #define MOUSE_RELEASE(b) (((b) & MOUSE_MASK_BUTTONS) == 3)
1011 
1012 /* Mouse input. */
1013 struct mouse_event {
1014 	int		valid;
1015 
1016 	key_code	key;
1017 	int		statusat;
1018 
1019 	u_int		x;
1020 	u_int		y;
1021 	u_int		b;
1022 
1023 	u_int		lx;
1024 	u_int		ly;
1025 	u_int		lb;
1026 
1027 	int		s;
1028 	int		w;
1029 	int		wp;
1030 
1031 	u_int		sgr_type;
1032 	u_int		sgr_b;
1033 };
1034 
1035 /* TTY information. */
1036 struct tty_key {
1037 	char		 ch;
1038 	key_code	 key;
1039 
1040 	struct tty_key	*left;
1041 	struct tty_key	*right;
1042 
1043 	struct tty_key	*next;
1044 };
1045 
1046 struct tty_code;
1047 struct tty_term {
1048 	char		*name;
1049 	u_int		 references;
1050 
1051 	char		 acs[UCHAR_MAX + 1][2];
1052 
1053 	struct tty_code	*codes;
1054 
1055 #define TERM_256COLOURS 0x1
1056 #define TERM_EARLYWRAP 0x2
1057 	int		 flags;
1058 
1059 	LIST_ENTRY(tty_term) entry;
1060 };
1061 LIST_HEAD(tty_terms, tty_term);
1062 
1063 struct tty {
1064 	struct client	*client;
1065 
1066 	u_int		 sx;
1067 	u_int		 sy;
1068 
1069 	u_int		 cx;
1070 	u_int		 cy;
1071 	u_int		 cstyle;
1072 	char		*ccolour;
1073 
1074 	int		 mode;
1075 
1076 	u_int		 rlower;
1077 	u_int		 rupper;
1078 
1079 	u_int		 rleft;
1080 	u_int		 rright;
1081 
1082 	int		 fd;
1083 	struct event	 event_in;
1084 	struct evbuffer	*in;
1085 	struct event	 event_out;
1086 	struct evbuffer	*out;
1087 	struct event	 timer;
1088 	size_t		 discarded;
1089 
1090 	struct termios	 tio;
1091 
1092 	struct grid_cell cell;
1093 
1094 	int		 last_wp;
1095 	struct grid_cell last_cell;
1096 
1097 #define TTY_NOCURSOR 0x1
1098 #define TTY_FREEZE 0x2
1099 #define TTY_TIMER 0x4
1100 #define TTY_UTF8 0x8
1101 #define TTY_STARTED 0x10
1102 #define TTY_OPENED 0x20
1103 #define TTY_FOCUS 0x40
1104 #define TTY_BLOCK 0x80
1105 	int		 flags;
1106 
1107 	struct tty_term	*term;
1108 	char		*term_name;
1109 	int		 term_flags;
1110 	enum {
1111 		TTY_VT100,
1112 		TTY_VT101,
1113 		TTY_VT102,
1114 		TTY_VT220,
1115 		TTY_VT320,
1116 		TTY_VT420,
1117 		TTY_UNKNOWN
1118 	} term_type;
1119 
1120 	struct mouse_event mouse;
1121 	int		 mouse_drag_flag;
1122 	void		(*mouse_drag_update)(struct client *,
1123 			    struct mouse_event *);
1124 	void		(*mouse_drag_release)(struct client *,
1125 			    struct mouse_event *);
1126 
1127 	struct event	 key_timer;
1128 	struct tty_key	*key_tree;
1129 };
1130 #define TTY_TYPES \
1131 	{ "VT100", "VT101", "VT102", "VT220", "VT320", "VT420", "Unknown" }
1132 
1133 /* TTY command context. */
1134 struct tty_ctx {
1135 	struct window_pane	*wp;
1136 
1137 	const struct grid_cell	*cell;
1138 	int			 wrapped;
1139 
1140 	u_int		 num;
1141 	void		*ptr;
1142 
1143 	/*
1144 	 * Cursor and region position before the screen was updated - this is
1145 	 * where the command should be applied; the values in the screen have
1146 	 * already been updated.
1147 	 */
1148 	u_int		 ocx;
1149 	u_int		 ocy;
1150 
1151 	u_int		 orupper;
1152 	u_int		 orlower;
1153 
1154 	u_int		 xoff;
1155 	u_int		 yoff;
1156 
1157 	/* The background colour used for clearing (erasing). */
1158 	u_int		 bg;
1159 };
1160 
1161 /* Saved message entry. */
1162 struct message_entry {
1163 	char	*msg;
1164 	u_int	 msg_num;
1165 	time_t	 msg_time;
1166 	TAILQ_ENTRY(message_entry) entry;
1167 };
1168 
1169 /* Parsed arguments structures. */
1170 struct args_entry;
1171 RB_HEAD(args_tree, args_entry);
1172 struct args {
1173 	struct args_tree	  tree;
1174 	int			  argc;
1175 	char			**argv;
1176 };
1177 
1178 /* Command find structures. */
1179 enum cmd_find_type {
1180 	CMD_FIND_PANE,
1181 	CMD_FIND_WINDOW,
1182 	CMD_FIND_SESSION,
1183 };
1184 struct cmd_find_state {
1185 	int			 flags;
1186 	struct cmd_find_state	*current;
1187 
1188 	struct session		*s;
1189 	struct winlink		*wl;
1190 	struct window		*w;
1191 	struct window_pane	*wp;
1192 	int			 idx;
1193 };
1194 
1195 /* Command find flags. */
1196 #define CMD_FIND_PREFER_UNATTACHED 0x1
1197 #define CMD_FIND_QUIET 0x2
1198 #define CMD_FIND_WINDOW_INDEX 0x4
1199 #define CMD_FIND_DEFAULT_MARKED 0x8
1200 #define CMD_FIND_EXACT_SESSION 0x10
1201 #define CMD_FIND_EXACT_WINDOW 0x20
1202 #define CMD_FIND_CANFAIL 0x40
1203 
1204 /* Command and list of commands. */
1205 struct cmd {
1206 	const struct cmd_entry	*entry;
1207 	struct args		*args;
1208 
1209 	char			*file;
1210 	u_int			 line;
1211 
1212 #define CMD_CONTROL 0x1
1213 	int			 flags;
1214 
1215 	TAILQ_ENTRY(cmd)	 qentry;
1216 };
1217 
1218 struct cmd_list {
1219 	int			 references;
1220 	TAILQ_HEAD(, cmd)	 list;
1221 };
1222 
1223 /* Command return values. */
1224 enum cmd_retval {
1225 	CMD_RETURN_ERROR = -1,
1226 	CMD_RETURN_NORMAL = 0,
1227 	CMD_RETURN_WAIT,
1228 	CMD_RETURN_STOP
1229 };
1230 
1231 /* Command queue item type. */
1232 enum cmdq_type {
1233 	CMDQ_COMMAND,
1234 	CMDQ_CALLBACK,
1235 };
1236 
1237 /* Command queue item shared state. */
1238 struct cmdq_shared {
1239 	int			 references;
1240 
1241 	int			 flags;
1242 #define CMDQ_SHARED_REPEAT 0x1
1243 
1244 	struct format_tree	*formats;
1245 
1246 	struct mouse_event	 mouse;
1247 	struct cmd_find_state	 current;
1248 };
1249 
1250 /* Command queue item. */
1251 typedef enum cmd_retval (*cmdq_cb) (struct cmdq_item *, void *);
1252 struct cmdq_item {
1253 	const char		*name;
1254 	struct cmdq_list	*queue;
1255 	struct cmdq_item	*next;
1256 
1257 	struct client		*client;
1258 
1259 	enum cmdq_type		 type;
1260 	u_int			 group;
1261 
1262 	u_int			 number;
1263 	time_t			 time;
1264 
1265 	int			 flags;
1266 #define CMDQ_FIRED 0x1
1267 #define CMDQ_WAITING 0x2
1268 #define CMDQ_NOHOOKS 0x4
1269 
1270 	struct cmdq_shared	*shared;
1271 	struct cmd_find_state	 source;
1272 	struct cmd_find_state	 target;
1273 
1274 	struct cmd_list		*cmdlist;
1275 	struct cmd		*cmd;
1276 
1277 	cmdq_cb			 cb;
1278 	void			*data;
1279 
1280 	TAILQ_ENTRY(cmdq_item)	 entry;
1281 };
1282 TAILQ_HEAD(cmdq_list, cmdq_item);
1283 
1284 /* Command definition flag. */
1285 struct cmd_entry_flag {
1286 	char			 flag;
1287 	enum cmd_find_type	 type;
1288 	int			 flags;
1289 };
1290 
1291 /* Command definition. */
1292 struct cmd_entry {
1293 	const char		*name;
1294 	const char		*alias;
1295 
1296 	struct {
1297 		const char	*template;
1298 		int		 lower;
1299 		int		 upper;
1300 	} args;
1301 	const char		*usage;
1302 
1303 	struct cmd_entry_flag	 source;
1304 	struct cmd_entry_flag	 target;
1305 
1306 #define CMD_STARTSERVER 0x1
1307 #define CMD_READONLY 0x2
1308 #define CMD_AFTERHOOK 0x4
1309 	int		 flags;
1310 
1311 	enum cmd_retval	 (*exec)(struct cmd *, struct cmdq_item *);
1312 };
1313 
1314 /* Client connection. */
1315 typedef int (*prompt_input_cb)(struct client *, void *, const char *, int);
1316 typedef void (*prompt_free_cb)(void *);
1317 struct client {
1318 	const char	*name;
1319 	struct tmuxpeer	*peer;
1320 	struct cmdq_list queue;
1321 
1322 	pid_t		 pid;
1323 	int		 fd;
1324 	struct event	 event;
1325 	int		 retval;
1326 
1327 	struct timeval	 creation_time;
1328 	struct timeval	 activity_time;
1329 
1330 	struct environ	*environ;
1331 	struct format_job_tree	*jobs;
1332 
1333 	char		*title;
1334 	const char	*cwd;
1335 
1336 	char		*term;
1337 	char		*ttyname;
1338 	struct tty	 tty;
1339 
1340 	size_t		 written;
1341 	size_t		 discarded;
1342 	size_t		 redraw;
1343 
1344 	void		(*stdin_callback)(struct client *, int, void *);
1345 	void		*stdin_callback_data;
1346 	struct evbuffer	*stdin_data;
1347 	int		 stdin_closed;
1348 	struct evbuffer	*stdout_data;
1349 	struct evbuffer	*stderr_data;
1350 
1351 	struct event	 repeat_timer;
1352 
1353 	struct event	 click_timer;
1354 	u_int		 click_button;
1355 
1356 	struct event	 status_timer;
1357 	struct screen	 status;
1358 
1359 	struct screen	*old_status;
1360 
1361 #define CLIENT_TERMINAL 0x1
1362 #define CLIENT_LOGIN 0x2
1363 #define CLIENT_EXIT 0x4
1364 #define CLIENT_REDRAW 0x8
1365 #define CLIENT_STATUS 0x10
1366 #define CLIENT_REPEAT 0x20
1367 #define CLIENT_SUSPENDED 0x40
1368 #define CLIENT_ATTACHED 0x80
1369 #define CLIENT_IDENTIFY 0x100
1370 #define CLIENT_DEAD 0x200
1371 #define CLIENT_BORDERS 0x400
1372 #define CLIENT_READONLY 0x800
1373 #define CLIENT_DETACHING 0x1000
1374 #define CLIENT_CONTROL 0x2000
1375 #define CLIENT_CONTROLCONTROL 0x4000
1376 #define CLIENT_FOCUSED 0x8000
1377 #define CLIENT_UTF8 0x10000
1378 #define CLIENT_256COLOURS 0x20000
1379 #define CLIENT_IDENTIFIED 0x40000
1380 #define CLIENT_STATUSFORCE 0x80000
1381 #define CLIENT_DOUBLECLICK 0x100000
1382 #define CLIENT_TRIPLECLICK 0x200000
1383 #define CLIENT_SIZECHANGED 0x400000
1384 #define CLIENT_STATUSOFF 0x800000
1385 	int		 flags;
1386 	struct key_table *keytable;
1387 
1388 	struct event	 identify_timer;
1389 	void		(*identify_callback)(struct client *,
1390 			     struct window_pane *);
1391 	void		*identify_callback_data;
1392 
1393 	char		*message_string;
1394 	struct event	 message_timer;
1395 	u_int		 message_next;
1396 	TAILQ_HEAD(, message_entry) message_log;
1397 
1398 	char		*prompt_string;
1399 	struct utf8_data *prompt_buffer;
1400 	size_t		 prompt_index;
1401 	prompt_input_cb	 prompt_inputcb;
1402 	prompt_free_cb	 prompt_freecb;
1403 	void		*prompt_data;
1404 	u_int		 prompt_hindex;
1405 	enum { PROMPT_ENTRY, PROMPT_COMMAND } prompt_mode;
1406 
1407 #define PROMPT_SINGLE 0x1
1408 #define PROMPT_NUMERIC 0x2
1409 #define PROMPT_INCREMENTAL 0x4
1410 #define PROMPT_NOFORMAT 0x8
1411 	int		 prompt_flags;
1412 
1413 	struct session	*session;
1414 	struct session	*last_session;
1415 
1416 	int		 wlmouse;
1417 
1418 	int		 references;
1419 
1420 	TAILQ_ENTRY(client) entry;
1421 };
1422 TAILQ_HEAD(clients, client);
1423 
1424 /* Key binding and key table. */
1425 struct key_binding {
1426 	key_code		 key;
1427 	struct cmd_list		*cmdlist;
1428 
1429 	int			 flags;
1430 #define KEY_BINDING_REPEAT 0x1
1431 
1432 	RB_ENTRY(key_binding)	 entry;
1433 };
1434 RB_HEAD(key_bindings, key_binding);
1435 
1436 struct key_table {
1437 	const char		 *name;
1438 	struct key_bindings	 key_bindings;
1439 
1440 	u_int			 references;
1441 
1442 	RB_ENTRY(key_table)	 entry;
1443 };
1444 RB_HEAD(key_tables, key_table);
1445 
1446 /* Option table entries. */
1447 enum options_table_type {
1448 	OPTIONS_TABLE_STRING,
1449 	OPTIONS_TABLE_NUMBER,
1450 	OPTIONS_TABLE_KEY,
1451 	OPTIONS_TABLE_COLOUR,
1452 	OPTIONS_TABLE_ATTRIBUTES,
1453 	OPTIONS_TABLE_FLAG,
1454 	OPTIONS_TABLE_CHOICE,
1455 	OPTIONS_TABLE_STYLE,
1456 	OPTIONS_TABLE_ARRAY,
1457 };
1458 enum options_table_scope {
1459 	OPTIONS_TABLE_NONE,
1460 	OPTIONS_TABLE_SERVER,
1461 	OPTIONS_TABLE_SESSION,
1462 	OPTIONS_TABLE_WINDOW,
1463 };
1464 
1465 struct options_table_entry {
1466 	const char		 *name;
1467 	enum options_table_type	  type;
1468 	enum options_table_scope  scope;
1469 
1470 	u_int			  minimum;
1471 	u_int			  maximum;
1472 	const char		**choices;
1473 
1474 	const char		 *default_str;
1475 	long long		  default_num;
1476 
1477 	const char		 *separator;
1478 	const char		 *style;
1479 };
1480 
1481 /* Common command usages. */
1482 #define CMD_TARGET_PANE_USAGE "[-t target-pane]"
1483 #define CMD_TARGET_WINDOW_USAGE "[-t target-window]"
1484 #define CMD_TARGET_SESSION_USAGE "[-t target-session]"
1485 #define CMD_TARGET_CLIENT_USAGE "[-t target-client]"
1486 #define CMD_SRCDST_PANE_USAGE "[-s src-pane] [-t dst-pane]"
1487 #define CMD_SRCDST_WINDOW_USAGE "[-s src-window] [-t dst-window]"
1488 #define CMD_SRCDST_SESSION_USAGE "[-s src-session] [-t dst-session]"
1489 #define CMD_SRCDST_CLIENT_USAGE "[-s src-client] [-t dst-client]"
1490 #define CMD_BUFFER_USAGE "[-b buffer-name]"
1491 
1492 /* tmux.c */
1493 extern struct hooks	*global_hooks;
1494 extern struct options	*global_options;
1495 extern struct options	*global_s_options;
1496 extern struct options	*global_w_options;
1497 extern struct environ	*global_environ;
1498 extern struct timeval	 start_time;
1499 extern const char	*socket_path;
1500 extern const char	*shell_command;
1501 extern int		 ptm_fd;
1502 extern const char	*shell_command;
1503 int		 areshell(const char *);
1504 void		 setblocking(int, int);
1505 const char	*find_home(void);
1506 
1507 /* proc.c */
1508 struct imsg;
1509 int	proc_send(struct tmuxpeer *, enum msgtype, int, const void *, size_t);
1510 struct tmuxproc *proc_start(const char *);
1511 void	proc_loop(struct tmuxproc *, int (*)(void));
1512 void	proc_exit(struct tmuxproc *);
1513 void	proc_set_signals(struct tmuxproc *, void(*)(int));
1514 void	proc_clear_signals(struct tmuxproc *, int);
1515 struct tmuxpeer *proc_add_peer(struct tmuxproc *, int,
1516 	    void (*)(struct imsg *, void *), void *);
1517 void	proc_remove_peer(struct tmuxpeer *);
1518 void	proc_kill_peer(struct tmuxpeer *);
1519 void	proc_toggle_log(struct tmuxproc *);
1520 
1521 /* cfg.c */
1522 extern int cfg_finished;
1523 void	start_cfg(void);
1524 int	load_cfg(const char *, struct client *, struct cmdq_item *, int);
1525 void	set_cfg_file(const char *);
1526 void printflike(1, 2) cfg_add_cause(const char *, ...);
1527 void	cfg_print_causes(struct cmdq_item *);
1528 void	cfg_show_causes(struct session *);
1529 
1530 /* paste.c */
1531 struct paste_buffer;
1532 const char	*paste_buffer_name(struct paste_buffer *);
1533 u_int		 paste_buffer_order(struct paste_buffer *);
1534 time_t		 paste_buffer_created(struct paste_buffer *);
1535 const char	*paste_buffer_data(struct paste_buffer *, size_t *);
1536 struct paste_buffer *paste_walk(struct paste_buffer *);
1537 struct paste_buffer *paste_get_top(const char **);
1538 struct paste_buffer *paste_get_name(const char *);
1539 void		 paste_free(struct paste_buffer *);
1540 void		 paste_add(char *, size_t);
1541 int		 paste_rename(const char *, const char *, char **);
1542 int		 paste_set(char *, size_t, const char *, char **);
1543 char		*paste_make_sample(struct paste_buffer *);
1544 
1545 /* format.c */
1546 #define FORMAT_STATUS 0x1
1547 #define FORMAT_FORCE 0x2
1548 #define FORMAT_NOJOBS 0x4
1549 #define FORMAT_NONE 0
1550 #define FORMAT_PANE 0x80000000U
1551 #define FORMAT_WINDOW 0x40000000U
1552 struct format_tree;
1553 int		 format_true(const char *);
1554 struct format_tree *format_create(struct client *, struct cmdq_item *, int,
1555 		     int);
1556 void		 format_free(struct format_tree *);
1557 void printflike(3, 4) format_add(struct format_tree *, const char *,
1558 		     const char *, ...);
1559 char		*format_expand_time(struct format_tree *, const char *, time_t);
1560 char		*format_expand(struct format_tree *, const char *);
1561 char		*format_single(struct cmdq_item *, const char *,
1562 		     struct client *, struct session *, struct winlink *,
1563 		     struct window_pane *);
1564 void		 format_defaults(struct format_tree *, struct client *,
1565 		     struct session *, struct winlink *, struct window_pane *);
1566 void		 format_defaults_window(struct format_tree *, struct window *);
1567 void		 format_defaults_pane(struct format_tree *,
1568 		     struct window_pane *);
1569 void		 format_defaults_paste_buffer(struct format_tree *,
1570 		     struct paste_buffer *);
1571 void		 format_lost_client(struct client *);
1572 
1573 /* hooks.c */
1574 struct hook;
1575 struct hooks	*hooks_get(struct session *);
1576 struct hooks	*hooks_create(struct hooks *);
1577 void		 hooks_free(struct hooks *);
1578 struct hook	*hooks_first(struct hooks *);
1579 struct hook	*hooks_next(struct hook *);
1580 void		 hooks_add(struct hooks *, const char *, struct cmd_list *);
1581 void		 hooks_copy(struct hooks *, struct hooks *);
1582 void		 hooks_remove(struct hooks *, const char *);
1583 struct hook	*hooks_find(struct hooks *, const char *);
1584 void printflike(4, 5) hooks_run(struct hooks *, struct client *,
1585 		    struct cmd_find_state *, const char *, ...);
1586 void printflike(4, 5) hooks_insert(struct hooks *, struct cmdq_item *,
1587 		    struct cmd_find_state *, const char *, ...);
1588 
1589 /* notify.c */
1590 void	notify_input(struct window_pane *, struct evbuffer *);
1591 void	notify_client(const char *, struct client *);
1592 void	notify_session(const char *, struct session *);
1593 void	notify_winlink(const char *, struct winlink *);
1594 void	notify_session_window(const char *, struct session *, struct window *);
1595 void	notify_window(const char *, struct window *);
1596 void	notify_pane(const char *, struct window_pane *);
1597 
1598 /* options.c */
1599 struct options	*options_create(struct options *);
1600 void		 options_free(struct options *);
1601 struct options_entry *options_first(struct options *);
1602 struct options_entry *options_next(struct options_entry *);
1603 struct options_entry *options_empty(struct options *,
1604 		     const struct options_table_entry *);
1605 struct options_entry *options_default(struct options *,
1606 		     const struct options_table_entry *);
1607 const char	*options_name(struct options_entry *);
1608 const struct options_table_entry *options_table_entry(struct options_entry *);
1609 struct options_entry *options_get_only(struct options *, const char *);
1610 struct options_entry *options_get(struct options *, const char *);
1611 void		 options_remove(struct options_entry *);
1612 void		 options_array_clear(struct options_entry *);
1613 const char	*options_array_get(struct options_entry *, u_int);
1614 int		 options_array_set(struct options_entry *, u_int, const char *,
1615 		     int);
1616 int		 options_array_size(struct options_entry *, u_int *);
1617 void		 options_array_assign(struct options_entry *, const char *);
1618 int		 options_isstring(struct options_entry *);
1619 const char	*options_tostring(struct options_entry *, int, int);
1620 char		*options_parse(const char *, int *);
1621 struct options_entry *options_parse_get(struct options *, const char *, int *,
1622 		     int);
1623 char		*options_match(const char *, int *, int *);
1624 struct options_entry *options_match_get(struct options *, const char *, int *,
1625 		     int, int *);
1626 const char	*options_get_string(struct options *, const char *);
1627 long long	 options_get_number(struct options *, const char *);
1628 const struct grid_cell *options_get_style(struct options *, const char *);
1629 struct options_entry * printflike(4, 5) options_set_string(struct options *,
1630 		     const char *, int, const char *, ...);
1631 struct options_entry *options_set_number(struct options *, const char *,
1632 		     long long);
1633 struct options_entry *options_set_style(struct options *, const char *, int,
1634 		     const char *);
1635 enum options_table_scope options_scope_from_flags(struct args *, int,
1636 		     struct cmd_find_state *, struct options **, char **);
1637 void		 options_style_update_new(struct options *,
1638 		     struct options_entry *);
1639 void		 options_style_update_old(struct options *,
1640 		     struct options_entry *);
1641 
1642 /* options-table.c */
1643 extern const struct options_table_entry options_table[];
1644 
1645 /* job.c */
1646 extern struct joblist all_jobs;
1647 struct job	*job_run(const char *, struct session *, const char *,
1648 		     job_update_cb, job_complete_cb, job_free_cb, void *);
1649 void		 job_free(struct job *);
1650 void		 job_died(struct job *, int);
1651 
1652 /* environ.c */
1653 struct environ *environ_create(void);
1654 void	environ_free(struct environ *);
1655 struct environ_entry *environ_first(struct environ *);
1656 struct environ_entry *environ_next(struct environ_entry *);
1657 void	environ_copy(struct environ *, struct environ *);
1658 struct environ_entry *environ_find(struct environ *, const char *);
1659 void printflike(3, 4) environ_set(struct environ *, const char *, const char *,
1660 	    ...);
1661 void	environ_clear(struct environ *, const char *);
1662 void	environ_put(struct environ *, const char *);
1663 void	environ_unset(struct environ *, const char *);
1664 void	environ_update(struct options *, struct environ *, struct environ *);
1665 void	environ_push(struct environ *);
1666 void printflike(2, 3) environ_log(struct environ *, const char *, ...);
1667 struct environ *environ_for_session(struct session *, int);
1668 
1669 /* tty.c */
1670 void	tty_create_log(void);
1671 void	tty_raw(struct tty *, const char *);
1672 void	tty_attributes(struct tty *, const struct grid_cell *,
1673 	    const struct window_pane *);
1674 void	tty_reset(struct tty *);
1675 void	tty_region_off(struct tty *);
1676 void	tty_margin_off(struct tty *);
1677 void	tty_cursor(struct tty *, u_int, u_int);
1678 void	tty_putcode(struct tty *, enum tty_code_code);
1679 void	tty_putcode1(struct tty *, enum tty_code_code, int);
1680 void	tty_putcode2(struct tty *, enum tty_code_code, int, int);
1681 void	tty_putcode3(struct tty *, enum tty_code_code, int, int, int);
1682 void	tty_putcode_ptr1(struct tty *, enum tty_code_code, const void *);
1683 void	tty_putcode_ptr2(struct tty *, enum tty_code_code, const void *,
1684 	    const void *);
1685 void	tty_puts(struct tty *, const char *);
1686 void	tty_putc(struct tty *, u_char);
1687 void	tty_putn(struct tty *, const void *, size_t, u_int);
1688 int	tty_init(struct tty *, struct client *, int, char *);
1689 void	tty_resize(struct tty *);
1690 void	tty_set_size(struct tty *, u_int, u_int);
1691 void	tty_start_tty(struct tty *);
1692 void	tty_stop_tty(struct tty *);
1693 void	tty_set_title(struct tty *, const char *);
1694 void	tty_update_mode(struct tty *, int, struct screen *);
1695 void	tty_draw_pane(struct tty *, const struct window_pane *, u_int, u_int,
1696 	    u_int);
1697 void	tty_draw_line(struct tty *, const struct window_pane *, struct screen *,
1698 	    u_int, u_int, u_int);
1699 int	tty_open(struct tty *, char **);
1700 void	tty_close(struct tty *);
1701 void	tty_free(struct tty *);
1702 void	tty_set_type(struct tty *, int);
1703 void	tty_write(void (*)(struct tty *, const struct tty_ctx *),
1704 	    struct tty_ctx *);
1705 void	tty_cmd_alignmenttest(struct tty *, const struct tty_ctx *);
1706 void	tty_cmd_cell(struct tty *, const struct tty_ctx *);
1707 void	tty_cmd_cells(struct tty *, const struct tty_ctx *);
1708 void	tty_cmd_clearendofline(struct tty *, const struct tty_ctx *);
1709 void	tty_cmd_clearendofscreen(struct tty *, const struct tty_ctx *);
1710 void	tty_cmd_clearline(struct tty *, const struct tty_ctx *);
1711 void	tty_cmd_clearscreen(struct tty *, const struct tty_ctx *);
1712 void	tty_cmd_clearstartofline(struct tty *, const struct tty_ctx *);
1713 void	tty_cmd_clearstartofscreen(struct tty *, const struct tty_ctx *);
1714 void	tty_cmd_deletecharacter(struct tty *, const struct tty_ctx *);
1715 void	tty_cmd_clearcharacter(struct tty *, const struct tty_ctx *);
1716 void	tty_cmd_deleteline(struct tty *, const struct tty_ctx *);
1717 void	tty_cmd_erasecharacter(struct tty *, const struct tty_ctx *);
1718 void	tty_cmd_insertcharacter(struct tty *, const struct tty_ctx *);
1719 void	tty_cmd_insertline(struct tty *, const struct tty_ctx *);
1720 void	tty_cmd_linefeed(struct tty *, const struct tty_ctx *);
1721 void	tty_cmd_scrollup(struct tty *, const struct tty_ctx *);
1722 void	tty_cmd_reverseindex(struct tty *, const struct tty_ctx *);
1723 void	tty_cmd_setselection(struct tty *, const struct tty_ctx *);
1724 void	tty_cmd_rawstring(struct tty *, const struct tty_ctx *);
1725 
1726 /* tty-term.c */
1727 extern struct tty_terms tty_terms;
1728 u_int		 tty_term_ncodes(void);
1729 struct tty_term *tty_term_find(char *, int, char **);
1730 void		 tty_term_free(struct tty_term *);
1731 int		 tty_term_has(struct tty_term *, enum tty_code_code);
1732 const char	*tty_term_string(struct tty_term *, enum tty_code_code);
1733 const char	*tty_term_string1(struct tty_term *, enum tty_code_code, int);
1734 const char	*tty_term_string2(struct tty_term *, enum tty_code_code, int,
1735 		     int);
1736 const char	*tty_term_string3(struct tty_term *, enum tty_code_code, int,
1737 		     int, int);
1738 const char	*tty_term_ptr1(struct tty_term *, enum tty_code_code,
1739 		     const void *);
1740 const char	*tty_term_ptr2(struct tty_term *, enum tty_code_code,
1741 		     const void *, const void *);
1742 int		 tty_term_number(struct tty_term *, enum tty_code_code);
1743 int		 tty_term_flag(struct tty_term *, enum tty_code_code);
1744 const char	*tty_term_describe(struct tty_term *, enum tty_code_code);
1745 
1746 /* tty-acs.c */
1747 int		 tty_acs_needed(struct tty *);
1748 const char	*tty_acs_get(struct tty *, u_char);
1749 
1750 /* tty-keys.c */
1751 void		tty_keys_build(struct tty *);
1752 void		tty_keys_free(struct tty *);
1753 key_code	tty_keys_next(struct tty *);
1754 
1755 /* arguments.c */
1756 void		 args_set(struct args *, u_char, const char *);
1757 struct args	*args_parse(const char *, int, char **);
1758 void		 args_free(struct args *);
1759 char		*args_print(struct args *);
1760 int		 args_has(struct args *, u_char);
1761 const char	*args_get(struct args *, u_char);
1762 long long	 args_strtonum(struct args *, u_char, long long, long long,
1763 		     char **);
1764 
1765 /* cmd-find.c */
1766 int		 cmd_find_target(struct cmd_find_state *, struct cmdq_item *,
1767 		     const char *, enum cmd_find_type, int);
1768 struct client	*cmd_find_client(struct cmdq_item *, const char *, int);
1769 void		 cmd_find_clear_state(struct cmd_find_state *, int);
1770 int		 cmd_find_empty_state(struct cmd_find_state *);
1771 int		 cmd_find_valid_state(struct cmd_find_state *);
1772 void		 cmd_find_copy_state(struct cmd_find_state *,
1773 		     struct cmd_find_state *);
1774 void		 cmd_find_log_state(const char *, struct cmd_find_state *);
1775 void		 cmd_find_from_session(struct cmd_find_state *,
1776 		     struct session *, int);
1777 void		 cmd_find_from_winlink(struct cmd_find_state *,
1778 		     struct winlink *, int);
1779 int		 cmd_find_from_session_window(struct cmd_find_state *,
1780 		     struct session *, struct window *, int);
1781 int		 cmd_find_from_window(struct cmd_find_state *, struct window *,
1782 		     int);
1783 void		 cmd_find_from_winlink_pane(struct cmd_find_state *,
1784 		     struct winlink *, struct window_pane *, int);
1785 int		 cmd_find_from_pane(struct cmd_find_state *,
1786 		     struct window_pane *, int);
1787 int		 cmd_find_from_client(struct cmd_find_state *, struct client *,
1788 		     int);
1789 int		 cmd_find_from_mouse(struct cmd_find_state *,
1790 		     struct mouse_event *, int);
1791 int		 cmd_find_from_nothing(struct cmd_find_state *, int);
1792 
1793 /* cmd.c */
1794 int		 cmd_pack_argv(int, char **, char *, size_t);
1795 int		 cmd_unpack_argv(char *, size_t, int, char ***);
1796 char	       **cmd_copy_argv(int, char **);
1797 void		 cmd_free_argv(int, char **);
1798 char		*cmd_stringify_argv(int, char **);
1799 struct cmd	*cmd_parse(int, char **, const char *, u_int, char **);
1800 char		*cmd_print(struct cmd *);
1801 int		 cmd_mouse_at(struct window_pane *, struct mouse_event *,
1802 		     u_int *, u_int *, int);
1803 struct winlink	*cmd_mouse_window(struct mouse_event *, struct session **);
1804 struct window_pane *cmd_mouse_pane(struct mouse_event *, struct session **,
1805 		     struct winlink **);
1806 char		*cmd_template_replace(const char *, const char *, int);
1807 extern const struct cmd_entry *cmd_table[];
1808 
1809 /* cmd-attach-session.c */
1810 enum cmd_retval	 cmd_attach_session(struct cmdq_item *, const char *, int, int,
1811 		     const char *, int);
1812 
1813 /* cmd-list.c */
1814 struct cmd_list	*cmd_list_parse(int, char **, const char *, u_int, char **);
1815 void		 cmd_list_free(struct cmd_list *);
1816 char		*cmd_list_print(struct cmd_list *);
1817 
1818 /* cmd-queue.c */
1819 struct cmdq_item *cmdq_get_command(struct cmd_list *, struct cmd_find_state *,
1820 		     struct mouse_event *, int);
1821 #define cmdq_get_callback(cb, data) cmdq_get_callback1(#cb, cb, data)
1822 struct cmdq_item *cmdq_get_callback1(const char *, cmdq_cb, void *);
1823 void		 cmdq_insert_after(struct cmdq_item *, struct cmdq_item *);
1824 void		 cmdq_append(struct client *, struct cmdq_item *);
1825 void printflike(3, 4) cmdq_format(struct cmdq_item *, const char *,
1826 		     const char *, ...);
1827 u_int		 cmdq_next(struct client *);
1828 void		 cmdq_guard(struct cmdq_item *, const char *, int);
1829 void printflike(2, 3) cmdq_print(struct cmdq_item *, const char *, ...);
1830 void printflike(2, 3) cmdq_error(struct cmdq_item *, const char *, ...);
1831 
1832 /* cmd-string.c */
1833 int		 cmd_string_split(const char *, int *, char ***);
1834 struct cmd_list	*cmd_string_parse(const char *, const char *, u_int, char **);
1835 
1836 /* cmd-wait-for.c */
1837 void	cmd_wait_for_flush(void);
1838 
1839 /* client.c */
1840 int	client_main(struct event_base *, int, char **, int);
1841 
1842 /* key-bindings.c */
1843 RB_PROTOTYPE(key_bindings, key_binding, entry, key_bindings_cmp);
1844 RB_PROTOTYPE(key_tables, key_table, entry, key_table_cmp);
1845 extern struct key_tables key_tables;
1846 int	 key_table_cmp(struct key_table *, struct key_table *);
1847 int	 key_bindings_cmp(struct key_binding *, struct key_binding *);
1848 struct key_table *key_bindings_get_table(const char *, int);
1849 void	 key_bindings_unref_table(struct key_table *);
1850 void	 key_bindings_add(const char *, key_code, int, struct cmd_list *);
1851 void	 key_bindings_remove(const char *, key_code);
1852 void	 key_bindings_remove_table(const char *);
1853 void	 key_bindings_init(void);
1854 void	 key_bindings_dispatch(struct key_binding *, struct cmdq_item *,
1855 	     struct client *, struct mouse_event *, struct cmd_find_state *);
1856 
1857 /* key-string.c */
1858 key_code	 key_string_lookup_string(const char *);
1859 const char	*key_string_lookup_key(key_code);
1860 
1861 /* alerts.c */
1862 void	alerts_reset_all(void);
1863 void	alerts_queue(struct window *, int);
1864 void	alerts_check_session(struct session *);
1865 
1866 /* server.c */
1867 extern struct tmuxproc *server_proc;
1868 extern struct clients clients;
1869 extern struct cmd_find_state marked_pane;
1870 void	 server_set_marked(struct session *, struct winlink *,
1871 	     struct window_pane *);
1872 void	 server_clear_marked(void);
1873 int	 server_is_marked(struct session *, struct winlink *,
1874 	     struct window_pane *);
1875 int	 server_check_marked(void);
1876 int	 server_start(struct tmuxproc *, struct event_base *, int, char *);
1877 void	 server_update_socket(void);
1878 void	 server_add_accept(int);
1879 
1880 /* server-client.c */
1881 u_int	 server_client_how_many(void);
1882 void	 server_client_set_identify(struct client *, u_int);
1883 void	 server_client_clear_identify(struct client *, struct window_pane *);
1884 void	 server_client_set_key_table(struct client *, const char *);
1885 const char *server_client_get_key_table(struct client *);
1886 int	 server_client_check_nested(struct client *);
1887 void	 server_client_handle_key(struct client *, key_code);
1888 void	 server_client_create(int);
1889 int	 server_client_open(struct client *, char **);
1890 void	 server_client_unref(struct client *);
1891 void	 server_client_lost(struct client *);
1892 void	 server_client_suspend(struct client *);
1893 void	 server_client_detach(struct client *, enum msgtype);
1894 void	 server_client_exec(struct client *, const char *);
1895 void	 server_client_loop(void);
1896 void	 server_client_push_stdout(struct client *);
1897 void	 server_client_push_stderr(struct client *);
1898 void printflike(2, 3) server_client_add_message(struct client *, const char *,
1899 	     ...);
1900 char	*server_client_get_path(struct client *, const char *);
1901 const char *server_client_get_cwd(struct client *);
1902 
1903 /* server-fn.c */
1904 void	 server_redraw_client(struct client *);
1905 void	 server_status_client(struct client *);
1906 void	 server_redraw_session(struct session *);
1907 void	 server_redraw_session_group(struct session *);
1908 void	 server_status_session(struct session *);
1909 void	 server_status_session_group(struct session *);
1910 void	 server_redraw_window(struct window *);
1911 void	 server_redraw_window_borders(struct window *);
1912 void	 server_status_window(struct window *);
1913 void	 server_lock(void);
1914 void	 server_lock_session(struct session *);
1915 void	 server_lock_client(struct client *);
1916 void	 server_kill_window(struct window *);
1917 int	 server_link_window(struct session *,
1918 	     struct winlink *, struct session *, int, int, int, char **);
1919 void	 server_unlink_window(struct session *, struct winlink *);
1920 void	 server_destroy_pane(struct window_pane *, int);
1921 void	 server_destroy_session(struct session *);
1922 void	 server_check_unattached(void);
1923 int	 server_set_stdin_callback(struct client *, void (*)(struct client *,
1924 	     int, void *), void *, char **);
1925 void	 server_unzoom_window(struct window *);
1926 
1927 /* status.c */
1928 void	 status_timer_start(struct client *);
1929 void	 status_timer_start_all(void);
1930 void	 status_update_saved(struct session *s);
1931 int	 status_at_line(struct client *);
1932 u_int	 status_line_size(struct session *);
1933 struct window *status_get_window_at(struct client *, u_int);
1934 int	 status_redraw(struct client *);
1935 void printflike(2, 3) status_message_set(struct client *, const char *, ...);
1936 void	 status_message_clear(struct client *);
1937 int	 status_message_redraw(struct client *);
1938 void	 status_prompt_set(struct client *, const char *, const char *,
1939 	     prompt_input_cb, prompt_free_cb, void *, int);
1940 void	 status_prompt_clear(struct client *);
1941 int	 status_prompt_redraw(struct client *);
1942 int	 status_prompt_key(struct client *, key_code);
1943 void	 status_prompt_update(struct client *, const char *, const char *);
1944 void	 status_prompt_load_history(void);
1945 void	 status_prompt_save_history(void);
1946 
1947 /* resize.c */
1948 void	 recalculate_sizes(void);
1949 
1950 /* input.c */
1951 void	 input_init(struct window_pane *);
1952 void	 input_free(struct window_pane *);
1953 void	 input_reset(struct window_pane *, int);
1954 struct evbuffer *input_pending(struct window_pane *);
1955 void	 input_parse(struct window_pane *);
1956 
1957 /* input-key.c */
1958 void	 input_key(struct window_pane *, key_code, struct mouse_event *);
1959 
1960 /* xterm-keys.c */
1961 char	*xterm_keys_lookup(key_code);
1962 int	 xterm_keys_find(const char *, size_t, size_t *, key_code *);
1963 
1964 /* colour.c */
1965 int	 colour_find_rgb(u_char, u_char, u_char);
1966 int	 colour_join_rgb(u_char, u_char, u_char);
1967 void	 colour_split_rgb(int, u_char *, u_char *, u_char *);
1968 const char *colour_tostring(int);
1969 int	 colour_fromstring(const char *s);
1970 u_char	 colour_256to16(u_char);
1971 
1972 /* attributes.c */
1973 const char *attributes_tostring(int);
1974 int	 attributes_fromstring(const char *);
1975 
1976 /* grid.c */
1977 extern const struct grid_cell grid_default_cell;
1978 int	 grid_cells_equal(const struct grid_cell *, const struct grid_cell *);
1979 struct grid *grid_create(u_int, u_int, u_int);
1980 void	 grid_destroy(struct grid *);
1981 int	 grid_compare(struct grid *, struct grid *);
1982 void	 grid_collect_history(struct grid *);
1983 void	 grid_scroll_history(struct grid *, u_int);
1984 void	 grid_scroll_history_region(struct grid *, u_int, u_int, u_int);
1985 void	 grid_clear_history(struct grid *);
1986 const struct grid_line *grid_peek_line(struct grid *, u_int);
1987 void	 grid_get_cell(struct grid *, u_int, u_int, struct grid_cell *);
1988 void	 grid_set_cell(struct grid *, u_int, u_int, const struct grid_cell *);
1989 void	 grid_set_cells(struct grid *, u_int, u_int, const struct grid_cell *,
1990 	     const char *, size_t);
1991 void	 grid_clear(struct grid *, u_int, u_int, u_int, u_int, u_int);
1992 void	 grid_clear_lines(struct grid *, u_int, u_int, u_int);
1993 void	 grid_move_lines(struct grid *, u_int, u_int, u_int, u_int);
1994 void	 grid_move_cells(struct grid *, u_int, u_int, u_int, u_int, u_int);
1995 char	*grid_string_cells(struct grid *, u_int, u_int, u_int,
1996 	     struct grid_cell **, int, int, int);
1997 void	 grid_duplicate_lines(struct grid *, u_int, struct grid *, u_int,
1998 	     u_int);
1999 u_int	 grid_reflow(struct grid *, struct grid *, u_int);
2000 
2001 /* grid-view.c */
2002 void	 grid_view_get_cell(struct grid *, u_int, u_int, struct grid_cell *);
2003 void	 grid_view_set_cell(struct grid *, u_int, u_int,
2004 	     const struct grid_cell *);
2005 void	 grid_view_set_cells(struct grid *, u_int, u_int,
2006 	     const struct grid_cell *, const char *, size_t);
2007 void	 grid_view_clear_history(struct grid *, u_int);
2008 void	 grid_view_clear(struct grid *, u_int, u_int, u_int, u_int, u_int);
2009 void	 grid_view_scroll_region_up(struct grid *, u_int, u_int, u_int);
2010 void	 grid_view_scroll_region_down(struct grid *, u_int, u_int, u_int);
2011 void	 grid_view_insert_lines(struct grid *, u_int, u_int, u_int);
2012 void	 grid_view_insert_lines_region(struct grid *, u_int, u_int, u_int,
2013 	u_int);
2014 void	 grid_view_delete_lines(struct grid *, u_int, u_int, u_int);
2015 void	 grid_view_delete_lines_region(struct grid *, u_int, u_int, u_int,
2016 	u_int);
2017 void	 grid_view_insert_cells(struct grid *, u_int, u_int, u_int, u_int);
2018 void	 grid_view_delete_cells(struct grid *, u_int, u_int, u_int, u_int);
2019 char	*grid_view_string_cells(struct grid *, u_int, u_int, u_int);
2020 
2021 /* screen-write.c */
2022 void	 screen_write_start(struct screen_write_ctx *, struct window_pane *,
2023 	     struct screen *);
2024 void	 screen_write_stop(struct screen_write_ctx *);
2025 void	 screen_write_reset(struct screen_write_ctx *);
2026 size_t printflike(1, 2) screen_write_cstrlen(const char *, ...);
2027 void printflike(4, 5) screen_write_cnputs(struct screen_write_ctx *,
2028 	     ssize_t, const struct grid_cell *, const char *, ...);
2029 size_t printflike(1, 2) screen_write_strlen(const char *, ...);
2030 void printflike(3, 4) screen_write_puts(struct screen_write_ctx *,
2031 	     const struct grid_cell *, const char *, ...);
2032 void printflike(4, 5) screen_write_nputs(struct screen_write_ctx *,
2033 	     ssize_t, const struct grid_cell *, const char *, ...);
2034 void	 screen_write_vnputs(struct screen_write_ctx *, ssize_t,
2035 	     const struct grid_cell *, const char *, va_list);
2036 void	 screen_write_putc(struct screen_write_ctx *, const struct grid_cell *,
2037 	     u_char);
2038 void	 screen_write_copy(struct screen_write_ctx *, struct screen *, u_int,
2039 	     u_int, u_int, u_int, bitstr_t *, const struct grid_cell *);
2040 void	 screen_write_hline(struct screen_write_ctx *, u_int, int, int);
2041 void	 screen_write_vline(struct screen_write_ctx *, u_int, int, int);
2042 void	 screen_write_box(struct screen_write_ctx *, u_int, u_int);
2043 void	 screen_write_preview(struct screen_write_ctx *, struct screen *, u_int,
2044 	     u_int);
2045 void	 screen_write_backspace(struct screen_write_ctx *);
2046 void	 screen_write_mode_set(struct screen_write_ctx *, int);
2047 void	 screen_write_mode_clear(struct screen_write_ctx *, int);
2048 void	 screen_write_cursorup(struct screen_write_ctx *, u_int);
2049 void	 screen_write_cursordown(struct screen_write_ctx *, u_int);
2050 void	 screen_write_cursorright(struct screen_write_ctx *, u_int);
2051 void	 screen_write_cursorleft(struct screen_write_ctx *, u_int);
2052 void	 screen_write_alignmenttest(struct screen_write_ctx *);
2053 void	 screen_write_insertcharacter(struct screen_write_ctx *, u_int, u_int);
2054 void	 screen_write_deletecharacter(struct screen_write_ctx *, u_int, u_int);
2055 void	 screen_write_clearcharacter(struct screen_write_ctx *, u_int, u_int);
2056 void	 screen_write_insertline(struct screen_write_ctx *, u_int, u_int);
2057 void	 screen_write_deleteline(struct screen_write_ctx *, u_int, u_int);
2058 void	 screen_write_clearline(struct screen_write_ctx *, u_int);
2059 void	 screen_write_clearendofline(struct screen_write_ctx *, u_int);
2060 void	 screen_write_clearstartofline(struct screen_write_ctx *, u_int);
2061 void	 screen_write_cursormove(struct screen_write_ctx *, u_int, u_int);
2062 void	 screen_write_reverseindex(struct screen_write_ctx *, u_int);
2063 void	 screen_write_scrollregion(struct screen_write_ctx *, u_int, u_int);
2064 void	 screen_write_linefeed(struct screen_write_ctx *, int, u_int);
2065 void	 screen_write_scrollup(struct screen_write_ctx *, u_int, u_int);
2066 void	 screen_write_carriagereturn(struct screen_write_ctx *);
2067 void	 screen_write_clearendofscreen(struct screen_write_ctx *, u_int);
2068 void	 screen_write_clearstartofscreen(struct screen_write_ctx *, u_int);
2069 void	 screen_write_clearscreen(struct screen_write_ctx *, u_int);
2070 void	 screen_write_clearhistory(struct screen_write_ctx *);
2071 void	 screen_write_collect_end(struct screen_write_ctx *);
2072 void	 screen_write_collect_add(struct screen_write_ctx *,
2073 	     const struct grid_cell *);
2074 void	 screen_write_cell(struct screen_write_ctx *, const struct grid_cell *);
2075 void	 screen_write_setselection(struct screen_write_ctx *, u_char *, u_int);
2076 void	 screen_write_rawstring(struct screen_write_ctx *, u_char *, u_int);
2077 
2078 /* screen-redraw.c */
2079 void	 screen_redraw_update(struct client *);
2080 void	 screen_redraw_screen(struct client *, int, int, int);
2081 void	 screen_redraw_pane(struct client *, struct window_pane *);
2082 
2083 /* screen.c */
2084 void	 screen_init(struct screen *, u_int, u_int, u_int);
2085 void	 screen_reinit(struct screen *);
2086 void	 screen_free(struct screen *);
2087 void	 screen_reset_tabs(struct screen *);
2088 void	 screen_set_cursor_style(struct screen *, u_int);
2089 void	 screen_set_cursor_colour(struct screen *, const char *);
2090 void	 screen_set_title(struct screen *, const char *);
2091 void	 screen_push_title(struct screen *);
2092 void	 screen_pop_title(struct screen *);
2093 void	 screen_resize(struct screen *, u_int, u_int, int);
2094 void	 screen_set_selection(struct screen *,
2095 	     u_int, u_int, u_int, u_int, u_int, struct grid_cell *);
2096 void	 screen_clear_selection(struct screen *);
2097 void	 screen_hide_selection(struct screen *);
2098 int	 screen_check_selection(struct screen *, u_int, u_int);
2099 void	 screen_select_cell(struct screen *, struct grid_cell *,
2100 	     const struct grid_cell *);
2101 
2102 /* window.c */
2103 extern struct windows windows;
2104 extern struct window_pane_tree all_window_panes;
2105 int		 window_cmp(struct window *, struct window *);
2106 RB_PROTOTYPE(windows, window, entry, window_cmp);
2107 int		 winlink_cmp(struct winlink *, struct winlink *);
2108 RB_PROTOTYPE(winlinks, winlink, entry, winlink_cmp);
2109 int		 window_pane_cmp(struct window_pane *, struct window_pane *);
2110 RB_PROTOTYPE(window_pane_tree, window_pane, tree_entry, window_pane_cmp);
2111 struct winlink	*winlink_find_by_index(struct winlinks *, int);
2112 struct winlink	*winlink_find_by_window(struct winlinks *, struct window *);
2113 struct winlink	*winlink_find_by_window_id(struct winlinks *, u_int);
2114 u_int		 winlink_count(struct winlinks *);
2115 struct winlink	*winlink_add(struct winlinks *, int);
2116 void		 winlink_set_window(struct winlink *, struct window *);
2117 void		 winlink_remove(struct winlinks *, struct winlink *);
2118 struct winlink	*winlink_next(struct winlink *);
2119 struct winlink	*winlink_previous(struct winlink *);
2120 struct winlink	*winlink_next_by_number(struct winlink *, struct session *,
2121 		     int);
2122 struct winlink	*winlink_previous_by_number(struct winlink *, struct session *,
2123 		     int);
2124 void		 winlink_stack_push(struct winlink_stack *, struct winlink *);
2125 void		 winlink_stack_remove(struct winlink_stack *, struct winlink *);
2126 struct window	*window_find_by_id_str(const char *);
2127 struct window	*window_find_by_id(u_int);
2128 void		 window_update_activity(struct window *);
2129 struct window	*window_create(u_int, u_int);
2130 struct window	*window_create_spawn(const char *, int, char **, const char *,
2131 		     const char *, const char *, struct environ *,
2132 		     struct termios *, u_int, u_int, u_int, char **);
2133 struct window_pane *window_get_active_at(struct window *, u_int, u_int);
2134 struct window_pane *window_find_string(struct window *, const char *);
2135 int		 window_has_pane(struct window *, struct window_pane *);
2136 int		 window_set_active_pane(struct window *, struct window_pane *);
2137 void		 window_redraw_active_switch(struct window *,
2138 		     struct window_pane *);
2139 struct window_pane *window_add_pane(struct window *, struct window_pane *,
2140 		     int, u_int);
2141 void		 window_resize(struct window *, u_int, u_int);
2142 int		 window_zoom(struct window_pane *);
2143 int		 window_unzoom(struct window *);
2144 void		 window_lost_pane(struct window *, struct window_pane *);
2145 void		 window_remove_pane(struct window *, struct window_pane *);
2146 struct window_pane *window_pane_at_index(struct window *, u_int);
2147 struct window_pane *window_pane_next_by_number(struct window *,
2148 			struct window_pane *, u_int);
2149 struct window_pane *window_pane_previous_by_number(struct window *,
2150 			struct window_pane *, u_int);
2151 int		 window_pane_index(struct window_pane *, u_int *);
2152 u_int		 window_count_panes(struct window *);
2153 void		 window_destroy_panes(struct window *);
2154 struct window_pane *window_pane_find_by_id_str(const char *);
2155 struct window_pane *window_pane_find_by_id(u_int);
2156 int		 window_pane_destroy_ready(struct window_pane *);
2157 int		 window_pane_spawn(struct window_pane *, int, char **,
2158 		     const char *, const char *, const char *, struct environ *,
2159 		     struct termios *, char **);
2160 void		 window_pane_resize(struct window_pane *, u_int, u_int);
2161 void		 window_pane_alternate_on(struct window_pane *,
2162 		     struct grid_cell *, int);
2163 void		 window_pane_alternate_off(struct window_pane *,
2164 		     struct grid_cell *, int);
2165 void		 window_pane_set_palette(struct window_pane *, u_int, int);
2166 void		 window_pane_unset_palette(struct window_pane *, u_int);
2167 void		 window_pane_reset_palette(struct window_pane *);
2168 int		 window_pane_get_palette(const struct window_pane *, int);
2169 int		 window_pane_set_mode(struct window_pane *,
2170 		     const struct window_mode *, struct cmd_find_state *,
2171 		     struct args *);
2172 void		 window_pane_reset_mode(struct window_pane *);
2173 void		 window_pane_key(struct window_pane *, struct client *,
2174 		     struct session *, key_code, struct mouse_event *);
2175 int		 window_pane_visible(struct window_pane *);
2176 u_int		 window_pane_search(struct window_pane *, const char *);
2177 const char	*window_printable_flags(struct winlink *);
2178 struct window_pane *window_pane_find_up(struct window_pane *);
2179 struct window_pane *window_pane_find_down(struct window_pane *);
2180 struct window_pane *window_pane_find_left(struct window_pane *);
2181 struct window_pane *window_pane_find_right(struct window_pane *);
2182 void		 window_set_name(struct window *, const char *);
2183 void		 window_add_ref(struct window *, const char *);
2184 void		 window_remove_ref(struct window *, const char *);
2185 void		 winlink_clear_flags(struct winlink *);
2186 int		 winlink_shuffle_up(struct session *, struct winlink *);
2187 
2188 /* layout.c */
2189 u_int		 layout_count_cells(struct layout_cell *);
2190 struct layout_cell *layout_create_cell(struct layout_cell *);
2191 void		 layout_free_cell(struct layout_cell *);
2192 void		 layout_print_cell(struct layout_cell *, const char *, u_int);
2193 void		 layout_destroy_cell(struct window *, struct layout_cell *,
2194 		     struct layout_cell **);
2195 void		 layout_set_size(struct layout_cell *, u_int, u_int, u_int,
2196 		     u_int);
2197 void		 layout_make_leaf(struct layout_cell *, struct window_pane *);
2198 void		 layout_make_node(struct layout_cell *, enum layout_type);
2199 void		 layout_fix_offsets(struct layout_cell *);
2200 void		 layout_fix_panes(struct window *, u_int, u_int);
2201 void		 layout_resize_adjust(struct window *, struct layout_cell *,
2202 		     enum layout_type, int);
2203 void		 layout_init(struct window *, struct window_pane *);
2204 void		 layout_free(struct window *);
2205 void		 layout_resize(struct window *, u_int, u_int);
2206 void		 layout_resize_pane(struct window_pane *, enum layout_type,
2207 		     int, int);
2208 void		 layout_resize_pane_to(struct window_pane *, enum layout_type,
2209 		     u_int);
2210 void		 layout_assign_pane(struct layout_cell *, struct window_pane *);
2211 struct layout_cell *layout_split_pane(struct window_pane *, enum layout_type,
2212 		     int, int, int);
2213 void		 layout_close_pane(struct window_pane *);
2214 
2215 /* layout-custom.c */
2216 char		*layout_dump(struct layout_cell *);
2217 int		 layout_parse(struct window *, const char *);
2218 
2219 /* layout-set.c */
2220 int		 layout_set_lookup(const char *);
2221 u_int		 layout_set_select(struct window *, u_int);
2222 u_int		 layout_set_next(struct window *);
2223 u_int		 layout_set_previous(struct window *);
2224 
2225 /* mode-tree.c */
2226 u_int	 mode_tree_count_tagged(struct mode_tree_data *);
2227 void	*mode_tree_get_current(struct mode_tree_data *);
2228 void	 mode_tree_each_tagged(struct mode_tree_data *, void (*)(void *, void *,
2229 	     struct client *, key_code), struct client *, key_code, int);
2230 void	 mode_tree_up(struct mode_tree_data *, int);
2231 void	 mode_tree_down(struct mode_tree_data *, int);
2232 struct mode_tree_data *mode_tree_start(struct window_pane *, struct args *,
2233 	     void (*)(void *, u_int, uint64_t *, const char *),
2234 	     struct screen *(*)(void *, void *, u_int, u_int),
2235 	     int (*)(void *, void *, const char *), void *, const char **,
2236 	     u_int, struct screen **);
2237 void	 mode_tree_build(struct mode_tree_data *);
2238 void	 mode_tree_free(struct mode_tree_data *);
2239 void	 mode_tree_resize(struct mode_tree_data *, u_int, u_int);
2240 struct mode_tree_item *mode_tree_add(struct mode_tree_data *,
2241 	     struct mode_tree_item *, void *, uint64_t, const char *,
2242 	     const char *, int);
2243 void	 mode_tree_remove(struct mode_tree_data *, struct mode_tree_item *);
2244 void	 mode_tree_draw(struct mode_tree_data *);
2245 int	 mode_tree_key(struct mode_tree_data *, struct client *, key_code *,
2246 	     struct mouse_event *);
2247 void	 mode_tree_run_command(struct client *, struct cmd_find_state *,
2248 	     const char *, const char *);
2249 
2250 /* window-buffer.c */
2251 extern const struct window_mode window_buffer_mode;
2252 
2253 /* window-tree.c */
2254 extern const struct window_mode window_tree_mode;
2255 
2256 /* window-clock.c */
2257 extern const struct window_mode window_clock_mode;
2258 extern const char window_clock_table[14][5][5];
2259 
2260 /* window-client.c */
2261 extern const struct window_mode window_client_mode;
2262 
2263 /* window-copy.c */
2264 extern const struct window_mode window_copy_mode;
2265 void		 window_copy_init_from_pane(struct window_pane *, int);
2266 void		 window_copy_init_for_output(struct window_pane *);
2267 void printflike(2, 3) window_copy_add(struct window_pane *, const char *, ...);
2268 void		 window_copy_vadd(struct window_pane *, const char *, va_list);
2269 void		 window_copy_pageup(struct window_pane *, int);
2270 void		 window_copy_start_drag(struct client *, struct mouse_event *);
2271 void		 window_copy_add_formats(struct window_pane *,
2272 		     struct format_tree *);
2273 
2274 /* names.c */
2275 void	 check_window_name(struct window *);
2276 char	*default_window_name(struct window *);
2277 char	*parse_window_name(const char *);
2278 
2279 /* control.c */
2280 void	control_callback(struct client *, int, void *);
2281 void printflike(2, 3) control_write(struct client *, const char *, ...);
2282 void	control_write_buffer(struct client *, struct evbuffer *);
2283 
2284 /* control-notify.c */
2285 void	control_notify_input(struct client *, struct window_pane *,
2286 	    struct evbuffer *);
2287 void	control_notify_pane_mode_changed(int);
2288 void	control_notify_window_layout_changed(struct window *);
2289 void	control_notify_window_pane_changed(struct window *);
2290 void	control_notify_window_unlinked(struct session *, struct window *);
2291 void	control_notify_window_linked(struct session *, struct window *);
2292 void	control_notify_window_renamed(struct window *);
2293 void	control_notify_client_session_changed(struct client *);
2294 void	control_notify_session_renamed(struct session *);
2295 void	control_notify_session_created(struct session *);
2296 void	control_notify_session_closed(struct session *);
2297 void	control_notify_session_window_changed(struct session *);
2298 
2299 /* session.c */
2300 extern struct sessions sessions;
2301 extern struct session_groups session_groups;
2302 int	session_cmp(struct session *, struct session *);
2303 RB_PROTOTYPE(sessions, session, entry, session_cmp);
2304 int	session_group_cmp(struct session_group *, struct session_group *);
2305 RB_PROTOTYPE(session_groups, session_group, entry, session_group_cmp);
2306 int		 session_alive(struct session *);
2307 struct session	*session_find(const char *);
2308 struct session	*session_find_by_id_str(const char *);
2309 struct session	*session_find_by_id(u_int);
2310 struct session	*session_create(const char *, const char *, int, char **,
2311 		     const char *, const char *, struct environ *,
2312 		     struct termios *, int, u_int, u_int, char **);
2313 void		 session_destroy(struct session *, const char *);
2314 void		 session_add_ref(struct session *, const char *);
2315 void		 session_remove_ref(struct session *, const char *);
2316 int		 session_check_name(const char *);
2317 void		 session_update_activity(struct session *, struct timeval *);
2318 struct session	*session_next_session(struct session *);
2319 struct session	*session_previous_session(struct session *);
2320 struct winlink	*session_new(struct session *, const char *, int, char **,
2321 		     const char *, const char *, int, char **);
2322 struct winlink	*session_attach(struct session *, struct window *, int,
2323 		     char **);
2324 int		 session_detach(struct session *, struct winlink *);
2325 int		 session_has(struct session *, struct window *);
2326 int		 session_is_linked(struct session *, struct window *);
2327 int		 session_next(struct session *, int);
2328 int		 session_previous(struct session *, int);
2329 int		 session_select(struct session *, int);
2330 int		 session_last(struct session *);
2331 int		 session_set_current(struct session *, struct winlink *);
2332 struct session_group *session_group_contains(struct session *);
2333 struct session_group *session_group_find(const char *);
2334 struct session_group *session_group_new(const char *);
2335 void		 session_group_add(struct session_group *, struct session *);
2336 void		 session_group_synchronize_to(struct session *);
2337 void		 session_group_synchronize_from(struct session *);
2338 void		 session_renumber_windows(struct session *);
2339 
2340 /* utf8.c */
2341 void		 utf8_set(struct utf8_data *, u_char);
2342 void		 utf8_copy(struct utf8_data *, const struct utf8_data *);
2343 enum utf8_state	 utf8_open(struct utf8_data *, u_char);
2344 enum utf8_state	 utf8_append(struct utf8_data *, u_char);
2345 enum utf8_state	 utf8_combine(const struct utf8_data *, wchar_t *);
2346 enum utf8_state	 utf8_split(wchar_t, struct utf8_data *);
2347 int		 utf8_isvalid(const char *);
2348 int		 utf8_strvis(char *, const char *, size_t, int);
2349 int		 utf8_stravis(char **, const char *, int);
2350 char		*utf8_sanitize(const char *);
2351 size_t		 utf8_strlen(const struct utf8_data *);
2352 u_int		 utf8_strwidth(const struct utf8_data *, ssize_t);
2353 struct utf8_data *utf8_fromcstr(const char *);
2354 char		*utf8_tocstr(struct utf8_data *);
2355 u_int		 utf8_cstrwidth(const char *);
2356 char		*utf8_rtrimcstr(const char *, u_int);
2357 char		*utf8_trimcstr(const char *, u_int);
2358 char		*utf8_padcstr(const char *, u_int);
2359 
2360 /* procname.c */
2361 char   *get_proc_name(int, char *);
2362 
2363 /* log.c */
2364 void	log_add_level(void);
2365 int	log_get_level(void);
2366 void	log_open(const char *);
2367 void	log_toggle(const char *);
2368 void	log_close(void);
2369 void printflike(1, 2) log_debug(const char *, ...);
2370 __dead void printflike(1, 2) fatal(const char *, ...);
2371 __dead void printflike(1, 2) fatalx(const char *, ...);
2372 
2373 /* style.c */
2374 int		 style_parse(const struct grid_cell *,
2375 		     struct grid_cell *, const char *);
2376 const char	*style_tostring(struct grid_cell *);
2377 void		 style_apply(struct grid_cell *, struct options *,
2378 		     const char *);
2379 void		 style_apply_update(struct grid_cell *, struct options *,
2380 		     const char *);
2381 int		 style_equal(const struct grid_cell *,
2382 		     const struct grid_cell *);
2383 
2384 #endif /* TMUX_H */
2385