tmux.h

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