/* $Id: tmux.h,v 1.214 2009-01-10 01:51:22 nicm Exp $ */ /* * Copyright (c) 2007 Nicholas Marriott * * Permission to use, copy, modify, and distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ #ifndef TMUX_H #define TMUX_H #define PROTOCOL_VERSION -4 /* Shut up gcc warnings about empty if bodies. */ #define RB_AUGMENT(x) do {} while (0) #include #include #ifndef NO_QUEUE_H #include #else #include "compat/queue.h" #endif #ifndef NO_TREE_H #include #else #include "compat/tree.h" #endif #ifndef BROKEN_POLL #include #else #undef HAVE_POLL #include "compat/bsd-poll.h" #endif #ifndef BROKEN_GETOPT #include #else #include "compat/getopt.h" #endif #include #include #include #include #include #include #include "array.h" extern const char *__progname; #ifndef GETOPT_PREFIX #define GETOPT_PREFIX "" #endif #ifndef INFTIM #define INFTIM -1 #endif #ifndef WAIT_ANY #define WAIT_ANY -1 #endif #ifndef SUN_LEN #define SUN_LEN(sun) (sizeof (sun)->sun_path) #endif #ifndef __dead #define __dead __attribute__ ((__noreturn__)) #endif #ifndef __packed #define __packed __attribute__ ((__packed__)) #endif #ifndef timercmp #define timercmp(tvp, uvp, cmp) \ (((tvp)->tv_sec == (uvp)->tv_sec) ? \ ((tvp)->tv_usec cmp (uvp)->tv_usec) : \ ((tvp)->tv_sec cmp (uvp)->tv_sec)) #endif #ifndef timeradd #define timeradd(tvp, uvp, vvp) \ do { \ (vvp)->tv_sec = (tvp)->tv_sec + (uvp)->tv_sec; \ (vvp)->tv_usec = (tvp)->tv_usec + (uvp)->tv_usec; \ if ((vvp)->tv_usec >= 1000000) { \ (vvp)->tv_sec++; \ (vvp)->tv_usec -= 1000000; \ } \ } while (0) #endif #ifndef TTY_NAME_MAX #define TTY_NAME_MAX 32 #endif #ifdef NO_PATHS_H #define _PATH_BSHELL "/bin/sh" #define _PATH_TMP "/tmp/" #define _PATH_DEVNULL "/dev/null" #endif /* Default configuration file. */ #define DEFAULT_CFG ".tmux.conf" /* Default prompt history length. */ #define PROMPT_HISTORY 100 /* Fatal errors. */ #define fatal(msg) log_fatal("%s: %s", __func__, msg); #define fatalx(msg) log_fatalx("%s: %s", __func__, msg); /* Definition to shut gcc up about unused arguments. */ #define unused __attribute__ ((unused)) /* Attribute to make gcc check printf-like arguments. */ #define printflike1 __attribute__ ((format (printf, 1, 2))) #define printflike2 __attribute__ ((format (printf, 2, 3))) #define printflike3 __attribute__ ((format (printf, 3, 4))) #define printflike4 __attribute__ ((format (printf, 4, 5))) /* Number of items in array. */ #define nitems(_a) (sizeof((_a)) / sizeof((_a)[0])) /* Buffer macros. */ #define BUFFER_USED(b) ((b)->size) #define BUFFER_FREE(b) ((b)->space - (b)->off - (b)->size) #define BUFFER_IN(b) ((b)->base + (b)->off + (b)->size) #define BUFFER_OUT(b) ((b)->base + (b)->off) /* Buffer structure. */ struct buffer { u_char *base; /* buffer start */ size_t space; /* total size of buffer */ size_t size; /* size of data in buffer */ size_t off; /* offset of data in buffer */ }; /* Bell option values. */ #define BELL_NONE 0 #define BELL_ANY 1 #define BELL_CURRENT 2 /* Key codes. ncurses defines KEY_*. Grrr. */ #define KEYC_NONE 0x00ffff #define KEYC_OFFSET 0x010000 #define KEYC_ESCAPE 0x020000 #define KEYC_CONTROL 0x080000 #define KEYC_SHIFT 0x100000 #define KEYC_ADDESC(k) ((k) | KEYC_ESCAPE) #define KEYC_REMOVEESC(k) ((k) & ~KEYC_ESCAPE) #define KEYC_ISESC(k) ((k) != KEYC_NONE && ((k) & KEYC_ESCAPE)) #define KEYC_ADDCTL(k) ((k) | KEYC_CONTROL) #define KEYC_REMOVECTL(k) ((k) & ~KEYC_CONTROL) #define KEYC_ISCTL(k) ((k) != KEYC_NONE && ((k) & KEYC_CONTROL)) #define KEYC_ADDSFT(k) ((k) | KEYC_SHIFT) #define KEYC_REMOVESFT(k) ((k) & ~KEYC_SHIFT) #define KEYC_ISSFT(k) ((k) != KEYC_NONE && ((k) & KEYC_SHIFT)) /* Function keys. */ #define KEYC_F1 (KEYC_OFFSET + 0x01) #define KEYC_F2 (KEYC_OFFSET + 0x02) #define KEYC_F3 (KEYC_OFFSET + 0x03) #define KEYC_F4 (KEYC_OFFSET + 0x04) #define KEYC_F5 (KEYC_OFFSET + 0x05) #define KEYC_F6 (KEYC_OFFSET + 0x06) #define KEYC_F7 (KEYC_OFFSET + 0x07) #define KEYC_F8 (KEYC_OFFSET + 0x08) #define KEYC_F9 (KEYC_OFFSET + 0x09) #define KEYC_F10 (KEYC_OFFSET + 0x10) #define KEYC_F11 (KEYC_OFFSET + 0x11) #define KEYC_F12 (KEYC_OFFSET + 0x12) #define KEYC_IC (KEYC_OFFSET + 0x13) #define KEYC_DC (KEYC_OFFSET + 0x14) #define KEYC_HOME (KEYC_OFFSET + 0x15) #define KEYC_END (KEYC_OFFSET + 0x16) #define KEYC_NPAGE (KEYC_OFFSET + 0x17) #define KEYC_PPAGE (KEYC_OFFSET + 0x18) /* Arrow keys. */ #define KEYC_UP (KEYC_OFFSET + 0x50) #define KEYC_DOWN (KEYC_OFFSET + 0x51) #define KEYC_LEFT (KEYC_OFFSET + 0x52) #define KEYC_RIGHT (KEYC_OFFSET + 0x53) /* Numeric keypad. Numbered from top-left, KPY_X. */ #define KEYC_KP0_1 (KEYC_OFFSET + 0x100) #define KEYC_KP0_2 (KEYC_OFFSET + 0x101) #define KEYC_KP0_3 (KEYC_OFFSET + 0x102) #define KEYC_KP1_0 (KEYC_OFFSET + 0x103) #define KEYC_KP1_1 (KEYC_OFFSET + 0x104) #define KEYC_KP1_2 (KEYC_OFFSET + 0x105) #define KEYC_KP1_3 (KEYC_OFFSET + 0x106) #define KEYC_KP2_0 (KEYC_OFFSET + 0x107) #define KEYC_KP2_1 (KEYC_OFFSET + 0x108) #define KEYC_KP2_2 (KEYC_OFFSET + 0x109) #define KEYC_KP3_0 (KEYC_OFFSET + 0x10a) #define KEYC_KP3_1 (KEYC_OFFSET + 0x10b) #define KEYC_KP3_2 (KEYC_OFFSET + 0x10c) #define KEYC_KP3_3 (KEYC_OFFSET + 0x10d) #define KEYC_KP4_0 (KEYC_OFFSET + 0x10e) #define KEYC_KP4_2 (KEYC_OFFSET + 0x10f) /* Termcap codes. */ enum tty_code_code { TTYC_AX = 0, TTYC_ACSC, /* acs_chars, ac */ TTYC_BEL, /* bell, bl */ TTYC_BLINK, /* enter_blink_mode, mb */ TTYC_BOLD, /* enter_bold_mode, md */ TTYC_CIVIS, /* cursor_invisible, vi */ TTYC_CLEAR, /* clear_screen, cl */ TTYC_CNORM, /* cursor_normal, ve */ TTYC_COLORS, /* max_colors, Co */ TTYC_CR, /* carriage_return, cr */ TTYC_CSR, /* change_scroll_region, cs */ TTYC_CUB, /* parm_left_cursor, LE */ TTYC_CUB1, /* cursor_left, le */ TTYC_CUD, /* parm_down_cursor, DO */ TTYC_CUD1, /* cursor_down, do */ TTYC_CUF, /* parm_right_cursor, RI */ TTYC_CUF1, /* cursor_right, nd */ TTYC_CUP, /* cursor_address, cm */ TTYC_CUU, /* parm_up_cursor, UP */ TTYC_CUU1, /* cursor_up, up */ TTYC_DCH, /* parm_dch, DC */ TTYC_DCH1, /* delete_character, dc */ TTYC_DIM, /* enter_dim_mode, mh */ TTYC_DL, /* parm_delete_line, DL */ TTYC_DL1, /* delete_line, dl */ TTYC_ED, /* clr_eos, cd */ TTYC_EL, /* clr_eol, ce */ TTYC_EL1, /* clr_bol, cb */ TTYC_ENACS, /* ena_acs, eA */ TTYC_ICH, /* parm_ich, IC */ TTYC_ICH1, /* insert_character, ic */ TTYC_IL, /* parm_insert_line, IL */ TTYC_IL1, /* insert_line, il */ TTYC_INVIS, /* enter_secure_mode, mk */ TTYC_IS1, /* init_1string, i1 */ TTYC_IS2, /* init_2string, i2 */ TTYC_IS3, /* init_3string, i3 */ TTYC_KCUB1, /* key_left, kl */ TTYC_KCUD1, /* key_down, kd */ TTYC_KCUF1, /* key_right, kr */ TTYC_KCUU1, /* key_up, ku */ TTYC_KDCH1, /* key_dc, kD */ TTYC_KEND, /* key_end, ke */ TTYC_KF1, /* key_f1, k1 */ TTYC_KF10, /* key_f10, k; */ TTYC_KF11, /* key_f11, F1 */ TTYC_KF12, /* key_f12, 21 */ TTYC_KF2, /* key_f2, k2 */ TTYC_KF3, /* key_f3, k3 */ TTYC_KF4, /* key_f4, k4 */ TTYC_KF5, /* key_f5, k5 */ TTYC_KF6, /* key_f6, k6 */ TTYC_KF7, /* key_f7, k7 */ TTYC_KF8, /* key_f8, k8 */ TTYC_KF9, /* key_f9, k9 */ TTYC_KHOME, /* key_home, kh */ TTYC_KICH1, /* key_ic, kI */ TTYC_KMOUS, /* key_mouse, Km */ TTYC_KNP, /* key_npage, kN */ TTYC_KPP, /* key_ppage, kP */ TTYC_OP, /* orig_pair, op */ TTYC_REV, /* enter_reverse_mode, mr */ TTYC_RI, /* scroll_reverse, sr */ TTYC_RMACS, /* exit_alt_charset_mode */ TTYC_RMCUP, /* exit_ca_mode, te */ TTYC_RMKX, /* keypad_local, ke */ TTYC_SETAB, /* set_a_background, AB */ TTYC_SETAF, /* set_a_foreground, AF */ TTYC_SGR0, /* exit_attribute_mode, me */ TTYC_SMACS, /* enter_alt_charset_mode, as */ TTYC_SMCUP, /* enter_ca_mode, ti */ TTYC_SMKX, /* keypad_xmit, ks */ TTYC_SMSO, /* enter_standout_mode, so */ TTYC_SMUL, /* enter_underline_mode, us */ }; #define NTTYCODE (TTYC_SMUL + 1) /* Termcap types. */ enum tty_code_type { TTYCODE_NONE = 0, TTYCODE_STRING, TTYCODE_NUMBER, TTYCODE_FLAG, }; /* Termcap code. */ struct tty_code { enum tty_code_type type; union { char *string; int number; int flag; } value; }; /* Entry in terminal code table. */ struct tty_term_code_entry { enum tty_code_code code; enum tty_code_type type; const char *name; }; /* Output commands. */ enum tty_cmd { TTY_BELL, TTY_CARRIAGERETURN, TTY_CELL, TTY_CLEARENDOFLINE, TTY_CLEARENDOFSCREEN, TTY_CLEARLINE, TTY_CLEARSCREEN, TTY_CLEARSTARTOFLINE, TTY_CLEARSTARTOFSCREEN, TTY_CURSORDOWN, TTY_CURSORLEFT, TTY_CURSORMODE, TTY_CURSORMOVE, TTY_CURSORRIGHT, TTY_CURSORUP, TTY_DELETECHARACTER, TTY_DELETELINE, TTY_INSERTCHARACTER, TTY_INSERTLINE, TTY_INSERTMODE, TTY_KCURSORMODE, TTY_KKEYPADMODE, TTY_LINEFEED, TTY_MOUSEMODE, TTY_REVERSEINDEX, TTY_SCROLLREGION, }; /* Message codes. */ enum hdrtype { MSG_COMMAND, MSG_ERROR, MSG_PRINT, MSG_EXIT, MSG_EXITING, MSG_EXITED, MSG_DETACH, MSG_IDENTIFY, MSG_READY, MSG_RESIZE, }; /* Message header structure. */ struct hdr { enum hdrtype type; size_t size; }; struct msg_command_data { pid_t pid; /* pid from $TMUX or -1 */ u_int idx; /* index from $TMUX */ size_t namelen; }; struct msg_identify_data { char tty[TTY_NAME_MAX]; int version; #define IDENTIFY_UTF8 0x1 #define IDENTIFY_256COLOURS 0x2 #define IDENTIFY_HASDEFAULTS 0x4 int flags; u_int sx; u_int sy; size_t termlen; }; struct msg_resize_data { u_int sx; u_int sy; }; /* Modes. */ #define MODE_CURSOR 0x1 #define MODE_INSERT 0x2 #define MODE_KCURSOR 0x4 #define MODE_KKEYPAD 0x8 #define MODE_MOUSE 0x10 /* Grid output. */ #ifdef DEBUG #define GRID_DEBUG(gd, fmt, ...) log_debug3("%s: (sx=%u, sy=%u, hsize=%u) " \ fmt, __func__, (gd)->sx, (gd)->sy, (gd)->hsize, ## __VA_ARGS__) #else #define GRID_DEBUG(...) #endif /* Grid attributes. */ #define GRID_ATTR_BRIGHT 0x1 #define GRID_ATTR_DIM 0x2 #define GRID_ATTR_UNDERSCORE 0x4 #define GRID_ATTR_BLINK 0x8 #define GRID_ATTR_REVERSE 0x10 #define GRID_ATTR_HIDDEN 0x20 #define GRID_ATTR_ITALICS 0x40 #define GRID_ATTR_CHARSET 0x80 /* alternative character set */ /* Grid flags. */ #define GRID_FLAG_FG256 0x1 #define GRID_FLAG_BG256 0x2 #define GRID_FLAG_PADDING 0x4 /* Grid cell. */ struct grid_cell { u_short data; u_char attr; u_char flags; u_char fg; u_char bg; } __packed; /* Grid data. */ struct grid_data { u_int sx; u_int sy; u_int hsize; u_int hlimit; u_int *size; struct grid_cell **data; }; /* Option data structures. */ struct options_entry { char *name; enum { OPTIONS_STRING, OPTIONS_NUMBER, OPTIONS_KEY, OPTIONS_COLOURS } type; union { char *string; long long number; int key; u_char colours; } value; SPLAY_ENTRY(options_entry) entry; }; struct options { SPLAY_HEAD(options_tree, options_entry) tree; struct options *parent; }; /* Screen selection. */ struct screen_sel { int flag; u_int sx; u_int sy; u_int ex; u_int ey; struct grid_cell cell; }; /* Virtual screen. */ struct screen { char *title; struct grid_data *grid; /* grid data */ u_int cx; /* cursor x */ u_int cy; /* cursor y */ u_int rupper; /* scroll region top */ u_int rlower; /* scroll region bottom */ int mode; struct screen_sel sel; }; /* Screen redraw context. */ struct screen_redraw_ctx { void *data; void (*write)(void *, enum tty_cmd, ...); u_int saved_cx; u_int saved_cy; struct screen *s; }; /* Screen write context. */ struct screen_write_ctx { void *data; void (*write)(void *, enum tty_cmd, ...); struct screen *s; }; /* Screen size. */ #define screen_size_x(s) ((s)->grid->sx) #define screen_size_y(s) ((s)->grid->sy) #define screen_hsize(s) ((s)->grid->hsize) #define screen_hlimit(s) ((s)->grid->hlimit) /* Input parser sequence argument. */ struct input_arg { u_char data[64]; size_t used; }; /* Input parser context. */ struct input_ctx { struct window *w; struct screen_write_ctx ctx; u_char *buf; size_t len; size_t off; struct grid_cell cell; /* current cell data */ struct grid_cell saved_cell; u_int saved_cx; u_int saved_cy; #define MAXSTRINGLEN 1024 u_char *string_buf; size_t string_len; int string_type; #define STRING_SYSTEM 0 #define STRING_APPLICATION 1 #define STRING_NAME 2 u_char utf8_buf[4]; u_int utf8_len; u_int utf8_off; u_char intermediate; void *(*state)(u_char, struct input_ctx *); u_char private; ARRAY_DECL(, struct input_arg) args; }; /* * Window mode. Windows can be in several modes and this is used to call the * right function to handle input and output. */ struct client; struct window_mode { struct screen *(*init)(struct window *); void (*free)(struct window *); void (*resize)(struct window *, u_int, u_int); void (*key)(struct window *, struct client *, int); }; /* Window structure. */ struct window { char *name; char *cmd; int fd; struct buffer *in; struct buffer *out; struct input_ctx ictx; struct options options; int flags; #define WINDOW_BELL 0x1 #define WINDOW_HIDDEN 0x2 #define WINDOW_ACTIVITY 0x4 struct screen *screen; struct screen base; const struct window_mode *mode; void *modedata; u_int references; }; ARRAY_DECL(windows, struct window *); /* Entry on local window list. */ struct winlink { int idx; struct window *window; RB_ENTRY(winlink) entry; SLIST_ENTRY(winlink) sentry; }; RB_HEAD(winlinks, winlink); SLIST_HEAD(winlink_stack, winlink); /* Paste buffer. */ struct paste_buffer { char *data; struct timeval tv; }; ARRAY_DECL(paste_stack, struct paste_buffer *); /* Client session. */ struct session_alert { struct winlink *wl; int type; SLIST_ENTRY(session_alert) entry; }; struct session { char *name; struct timeval tv; u_int sx; u_int sy; struct winlink *curw; struct winlink_stack lastw; struct winlinks windows; struct options options; struct paste_stack buffers; SLIST_HEAD(, session_alert) alerts; #define SESSION_UNATTACHED 0x1 /* not attached to any clients */ int flags; }; ARRAY_DECL(sessions, struct session *); /* TTY information. */ struct tty_key { int key; char *string; int flags; #define TTYKEY_MODIFIER 0x1 #define TTYKEY_RAW 0x2 RB_ENTRY(tty_key) entry; }; struct tty_term { char *name; u_int references; struct tty_code codes[NTTYCODE]; #define TERM_HASDEFAULTS 0x1 #define TERM_256COLOURS 0x2 int flags; SLIST_ENTRY(tty_term) entry; }; SLIST_HEAD(tty_terms, tty_term); struct tty { char *path; char *termname; struct tty_term *term; int fd; struct buffer *in; struct buffer *out; int log_fd; struct termios tio; struct grid_cell cell; u_char acs[UCHAR_MAX + 1]; #define TTY_NOCURSOR 0x1 #define TTY_FREEZE 0x2 #define TTY_ESCAPE 0x4 #define TTY_UTF8 0x8 int flags; int term_flags; struct timeval key_timer; size_t ksize; /* maximum key size */ RB_HEAD(tty_keys, tty_key) ktree; }; /* Client connection. */ struct client { int fd; struct buffer *in; struct buffer *out; char *title; struct tty tty; struct timeval status_timer; u_int sx; u_int sy; #define CLIENT_TERMINAL 0x1 #define CLIENT_PREFIX 0x2 #define CLIENT_MOUSE 0x4 #define CLIENT_REDRAW 0x8 #define CLIENT_STATUS 0x10 int flags; char *message_string; struct timeval message_timer; char *prompt_string; char *prompt_buffer; size_t prompt_index; void (*prompt_callback)(void *, char *); void *prompt_data; u_int prompt_hindex; ARRAY_DECL(, char *) prompt_hdata; struct session *session; }; ARRAY_DECL(clients, struct client *); /* Client context. */ struct client_ctx { int srv_fd; struct buffer *srv_in; struct buffer *srv_out; #define CCTX_DETACH 0x1 #define CCTX_EXIT 0x2 int flags; }; /* Key/command line command. */ struct cmd_ctx { struct client *cmdclient; struct client *curclient; struct session *cursession; struct msg_command_data *msgdata; void (*print)(struct cmd_ctx *, const char *, ...); void (*info)(struct cmd_ctx *, const char *, ...); void (*error)(struct cmd_ctx *, const char *, ...); }; struct cmd { const struct cmd_entry *entry; void *data; }; struct cmd_entry { const char *name; const char *alias; const char *usage; #define CMD_STARTSERVER 0x1 #define CMD_CANTNEST 0x2 #define CMD_KFLAG 0x4 #define CMD_DFLAG 0x8 #define CMD_ONEARG 0x10 #define CMD_ZEROONEARG 0x20 #define CMD_GFLAG 0x40 #define CMD_UFLAG 0x80 int flags; void (*init)(struct cmd *, int); int (*parse)(struct cmd *, int, char **, char **); void (*exec)(struct cmd *, struct cmd_ctx *); void (*send)(struct cmd *, struct buffer *); void (*recv)(struct cmd *, struct buffer *); void (*free)(struct cmd *); void (*print)(struct cmd *, char *, size_t); }; /* Generic command data. */ struct cmd_target_data { int flags; char *target; char *arg; }; struct cmd_srcdst_data { int flags; char *src; char *dst; char *arg; }; struct cmd_buffer_data { int flags; char *target; int buffer; char *arg; }; struct cmd_option_data { int flags; char *target; char *option; char *value; }; /* Key binding. */ struct key_binding { int key; struct cmd *cmd; SPLAY_ENTRY(key_binding) entry; }; SPLAY_HEAD(key_bindings, key_binding); /* Set/display option data. */ struct set_option_entry { const char *name; enum { SET_OPTION_STRING, SET_OPTION_NUMBER, SET_OPTION_KEY, SET_OPTION_COLOUR, SET_OPTION_FLAG, SET_OPTION_CHOICE } type; u_int minimum; u_int maximum; const char **choices; }; extern const struct set_option_entry set_option_table[]; extern const struct set_option_entry set_window_option_table[]; #define NSETOPTION 17 #define NSETWINDOWOPTION 10 /* Edit keys. */ enum mode_key { MODEKEY_BOL, MODEKEY_CLEARSEL, MODEKEY_COPYSEL, MODEKEY_DOWN, MODEKEY_EOL, MODEKEY_LEFT, MODEKEY_NONE, MODEKEY_NPAGE, MODEKEY_NWORD, MODEKEY_PPAGE, MODEKEY_PWORD, MODEKEY_QUIT, MODEKEY_RIGHT, MODEKEY_STARTSEL, MODEKEY_UP, }; #define MODEKEY_EMACS 0 #define MODEKEY_VI 1 #ifdef NO_STRTONUM /* strtonum.c */ long long strtonum(const char *, long long, long long, const char **); #endif #ifdef NO_STRLCPY /* strlcpy.c */ size_t strlcpy(char *, const char *, size_t); #endif #ifdef NO_STRLCAT /* strlcat.c */ size_t strlcat(char *, const char *, size_t); #endif #ifdef NO_DAEMON /* daemon.c */ int daemon(int, int); #endif #ifdef NO_FORKPTY /* forkpty.c */ pid_t forkpty(int *, char *, struct termios *, struct winsize *); #endif #ifdef NO_ASPRINTF /* asprintf.c */ int asprintf(char **, const char *, ...); int vasprintf(char **, const char *, va_list); #endif #ifdef NO_FGETLN /* fgetln.c */ char *fgetln(FILE *, size_t *); #endif /* tmux.c */ extern volatile sig_atomic_t sigwinch; extern volatile sig_atomic_t sigterm; extern struct options global_options; extern struct options global_window_options; extern char *cfg_file; extern int debug_level; extern int be_quiet; extern time_t start_time; extern const char *socket_path; void logfile(const char *); void siginit(void); void sigreset(void); /* cfg.c */ int load_cfg(const char *, char **x); /* mode-key.c */ enum mode_key mode_key_lookup(int, int); /* options.c */ int options_cmp(struct options_entry *, struct options_entry *); SPLAY_PROTOTYPE(options_tree, options_entry, entry, options_cmp); void options_init(struct options *, struct options *); void options_free(struct options *); struct options_entry *options_find1(struct options *, const char *); struct options_entry *options_find(struct options *, const char *); int options_remove(struct options *, const char *); void printflike3 options_set_string( struct options *, const char *, const char *, ...); char *options_get_string(struct options *, const char *); void options_set_number(struct options *, const char *, long long); long long options_get_number(struct options *, const char *); /* tty.c */ void tty_init(struct tty *, char *, char *); void tty_set_title(struct tty *, const char *); int tty_open(struct tty *, char **); void tty_close(struct tty *); void tty_free(struct tty *); void tty_write(struct tty *, struct screen *, enum tty_cmd, ...); void tty_vwrite( struct tty *, struct screen *s, enum tty_cmd, va_list); /* tty-term.c */ extern struct tty_terms tty_terms; extern struct tty_term_code_entry tty_term_codes[NTTYCODE]; struct tty_term *tty_term_find(char *, int, char **); void tty_term_free(struct tty_term *); int tty_term_has(struct tty_term *, enum tty_code_code); const char *tty_term_string(struct tty_term *, enum tty_code_code); const char *tty_term_string1(struct tty_term *, enum tty_code_code, int); const char *tty_term_string2( struct tty_term *, enum tty_code_code, int, int); int tty_term_number(struct tty_term *, enum tty_code_code); int tty_term_flag(struct tty_term *, enum tty_code_code); /* tty-keys.c */ int tty_keys_cmp(struct tty_key *, struct tty_key *); RB_PROTOTYPE(tty_keys, tty_key, entry, tty_keys_cmp); void tty_keys_init(struct tty *); void tty_keys_free(struct tty *); int tty_keys_next(struct tty *, int *); /* tty-write.c */ void tty_write_client(void *, enum tty_cmd, ...); void tty_vwrite_client(void *, enum tty_cmd, va_list); void tty_write_window(void *, enum tty_cmd, ...); void tty_vwrite_window(void *, enum tty_cmd, va_list); void tty_write_session(void *, enum tty_cmd, ...); void tty_vwrite_session(void *, enum tty_cmd, va_list); /* options-cmd.c */ void set_option_string(struct cmd_ctx *, struct options *, const struct set_option_entry *, char *); void set_option_number(struct cmd_ctx *, struct options *, const struct set_option_entry *, char *); void set_option_key(struct cmd_ctx *, struct options *, const struct set_option_entry *, char *); void set_option_colour(struct cmd_ctx *, struct options *, const struct set_option_entry *, char *); void set_option_flag(struct cmd_ctx *, struct options *, const struct set_option_entry *, char *); void set_option_choice(struct cmd_ctx *, struct options *, const struct set_option_entry *, char *); /* paste.c */ void paste_init_stack(struct paste_stack *); void paste_free_stack(struct paste_stack *); struct paste_buffer *paste_walk_stack(struct paste_stack *, uint *); struct paste_buffer *paste_get_top(struct paste_stack *); struct paste_buffer *paste_get_index(struct paste_stack *, u_int); int paste_free_top(struct paste_stack *); int paste_free_index(struct paste_stack *, u_int); void paste_add(struct paste_stack *, const char *, u_int); int paste_replace(struct paste_stack *, u_int, const char *); /* arg.c */ struct client *arg_parse_client(const char *); struct session *arg_parse_session(const char *); int arg_parse_window(const char *, struct session **, int *); /* cmd.c */ struct cmd *cmd_parse(int, char **, char **); void cmd_exec(struct cmd *, struct cmd_ctx *); void cmd_send(struct cmd *, struct buffer *); struct cmd *cmd_recv(struct buffer *); void cmd_free(struct cmd *); void cmd_send_string(struct buffer *, const char *); char *cmd_recv_string(struct buffer *); struct session *cmd_current_session(struct cmd_ctx *); struct client *cmd_find_client(struct cmd_ctx *, const char *); struct session *cmd_find_session(struct cmd_ctx *, const char *); struct winlink *cmd_find_window( struct cmd_ctx *, const char *, struct session **); extern const struct cmd_entry *cmd_table[]; extern const struct cmd_entry cmd_attach_session_entry; extern const struct cmd_entry cmd_bind_key_entry; extern const struct cmd_entry cmd_command_prompt_entry; extern const struct cmd_entry cmd_copy_mode_entry; extern const struct cmd_entry cmd_delete_buffer_entry; extern const struct cmd_entry cmd_detach_client_entry; extern const struct cmd_entry cmd_has_session_entry; extern const struct cmd_entry cmd_kill_server_entry; extern const struct cmd_entry cmd_kill_session_entry; extern const struct cmd_entry cmd_kill_window_entry; extern const struct cmd_entry cmd_last_window_entry; extern const struct cmd_entry cmd_link_window_entry; extern const struct cmd_entry cmd_list_buffers_entry; extern const struct cmd_entry cmd_list_clients_entry; extern const struct cmd_entry cmd_list_commands_entry; extern const struct cmd_entry cmd_list_keys_entry; extern const struct cmd_entry cmd_list_sessions_entry; extern const struct cmd_entry cmd_list_windows_entry; extern const struct cmd_entry cmd_move_window_entry; extern const struct cmd_entry cmd_new_session_entry; extern const struct cmd_entry cmd_new_window_entry; extern const struct cmd_entry cmd_next_window_entry; extern const struct cmd_entry cmd_paste_buffer_entry; extern const struct cmd_entry cmd_previous_window_entry; extern const struct cmd_entry cmd_refresh_client_entry; extern const struct cmd_entry cmd_rename_session_entry; extern const struct cmd_entry cmd_rename_window_entry; extern const struct cmd_entry cmd_respawn_window_entry; extern const struct cmd_entry cmd_scroll_mode_entry; extern const struct cmd_entry cmd_select_window_entry; extern const struct cmd_entry cmd_send_keys_entry; extern const struct cmd_entry cmd_send_prefix_entry; extern const struct cmd_entry cmd_server_info_entry; extern const struct cmd_entry cmd_select_prompt_entry; extern const struct cmd_entry cmd_set_buffer_entry; extern const struct cmd_entry cmd_set_option_entry; extern const struct cmd_entry cmd_set_window_option_entry; extern const struct cmd_entry cmd_show_buffer_entry; extern const struct cmd_entry cmd_show_options_entry; extern const struct cmd_entry cmd_show_window_options_entry; extern const struct cmd_entry cmd_source_file_entry; extern const struct cmd_entry cmd_start_server_entry; extern const struct cmd_entry cmd_swap_window_entry; extern const struct cmd_entry cmd_switch_client_entry; extern const struct cmd_entry cmd_unbind_key_entry; extern const struct cmd_entry cmd_unlink_window_entry; /* cmd-string.c */ int cmd_string_parse(const char *, struct cmd **, char **); /* cmd-generic.c */ #define CMD_TARGET_WINDOW_USAGE "[-t target-window]" #define CMD_TARGET_SESSION_USAGE "[-t target-session]" #define CMD_TARGET_CLIENT_USAGE "[-t target-client]" void cmd_target_init(struct cmd *, int); int cmd_target_parse(struct cmd *, int, char **, char **); void cmd_target_exec(struct cmd *, struct cmd_ctx *); void cmd_target_send(struct cmd *, struct buffer *); void cmd_target_recv(struct cmd *, struct buffer *); void cmd_target_free(struct cmd *); void cmd_target_print(struct cmd *, char *, size_t); #define CMD_SRCDST_WINDOW_USAGE "[-s src-window] [-t dst-window]" #define CMD_SRCDST_SESSION_USAGE "[-s src-session] [-t dst-session]" #define CMD_SRCDST_CLIENT_USAGE "[-s src-client] [-t dst-client]" void cmd_srcdst_init(struct cmd *, int); int cmd_srcdst_parse(struct cmd *, int, char **, char **); void cmd_srcdst_exec(struct cmd *, struct cmd_ctx *); void cmd_srcdst_send(struct cmd *, struct buffer *); void cmd_srcdst_recv(struct cmd *, struct buffer *); void cmd_srcdst_free(struct cmd *); void cmd_srcdst_print(struct cmd *, char *, size_t); #define CMD_BUFFER_WINDOW_USAGE "[-b buffer-index] [-t target-window]" #define CMD_BUFFER_SESSION_USAGE "[-b buffer-index] [-t target-session]" #define CMD_BUFFER_CLIENT_USAGE "[-b buffer-index] [-t target-client]" void cmd_buffer_init(struct cmd *, int); int cmd_buffer_parse(struct cmd *, int, char **, char **); void cmd_buffer_exec(struct cmd *, struct cmd_ctx *); void cmd_buffer_send(struct cmd *, struct buffer *); void cmd_buffer_recv(struct cmd *, struct buffer *); void cmd_buffer_free(struct cmd *); void cmd_buffer_print(struct cmd *, char *, size_t); #define CMD_OPTION_WINDOW_USAGE "[-gu] [-t target-window] option [value]" #define CMD_OPTION_SESSION_USAGE "[-gu] [-t target-session] option [value]" #define CMD_OPTION_CLIENT_USAGE "[-gu] [-t target-client] option [value]" void cmd_option_init(struct cmd *, int); int cmd_option_parse(struct cmd *, int, char **, char **); void cmd_option_exec(struct cmd *, struct cmd_ctx *); void cmd_option_send(struct cmd *, struct buffer *); void cmd_option_recv(struct cmd *, struct buffer *); void cmd_option_free(struct cmd *); void cmd_option_print(struct cmd *, char *, size_t); /* client.c */ int client_init(const char *, struct client_ctx *, int, int); int client_flush(struct client_ctx *); int client_main(struct client_ctx *); /* client-msg.c */ int client_msg_dispatch(struct client_ctx *, char **); /* client-fn.c */ void client_write_server(struct client_ctx *, enum hdrtype, void *, size_t); void client_write_server2( struct client_ctx *, enum hdrtype, void *, size_t, void *, size_t); void client_fill_session(struct msg_command_data *); /* key-bindings.c */ extern struct key_bindings key_bindings; int key_bindings_cmp(struct key_binding *, struct key_binding *); SPLAY_PROTOTYPE(key_bindings, key_binding, entry, key_bindings_cmp); struct key_binding *key_bindings_lookup(int); void key_bindings_add(int, struct cmd *); void key_bindings_remove(int); void key_bindings_init(void); void key_bindings_free(void); void key_bindings_dispatch(int, struct client *); void printflike2 key_bindings_error(struct cmd_ctx *, const char *, ...); void printflike2 key_bindings_print(struct cmd_ctx *, const char *, ...); void printflike2 key_bindings_info(struct cmd_ctx *, const char *, ...); /* key-string.c */ int key_string_lookup_string(const char *); const char *key_string_lookup_key(int); /* server.c */ extern struct clients clients; int server_start(const char *); /* server-msg.c */ int server_msg_dispatch(struct client *); /* server-fn.c */ void server_set_client_message(struct client *, const char *); void server_clear_client_message(struct client *); void server_set_client_prompt( struct client *, const char *, void (*)(void *, char *), void *); void server_clear_client_prompt(struct client *); struct session *server_extract_session( struct msg_command_data *, char *, char **); void server_write_client( struct client *, enum hdrtype, const void *, size_t); void server_write_session( struct session *, enum hdrtype, const void *, size_t); void server_write_window( struct window *, enum hdrtype, const void *, size_t); void server_redraw_client(struct client *); void server_status_client(struct client *); void server_redraw_session(struct session *); void server_status_session(struct session *); void server_redraw_window(struct window *); void server_status_window(struct window *); /* status.c */ void status_redraw(struct client *); void status_message_redraw(struct client *); void status_prompt_redraw(struct client *); void status_prompt_key(struct client *, int); /* resize.c */ void recalculate_sizes(void); /* input.c */ void input_init(struct window *); void input_free(struct window *); void input_parse(struct window *); /* input-key.c */ void input_key(struct window *, int); /* colour.c */ const char *colour_tostring(u_char); u_char colour_fromstring(const char *); u_char colour_translate256(u_char); /* grid.c */ extern const struct grid_cell grid_default_cell; struct grid_data *grid_create(u_int, u_int, u_int); void grid_destroy(struct grid_data *); void grid_reduce_line(struct grid_data *, u_int, u_int); void grid_expand_line(struct grid_data *, u_int, u_int); void grid_scroll_line(struct grid_data *); const struct grid_cell *grid_peek_cell(struct grid_data *, u_int, u_int); struct grid_cell *grid_get_cell(struct grid_data *, u_int, u_int); void grid_set_cell( struct grid_data *, u_int, u_int, const struct grid_cell *); void grid_clear(struct grid_data *, u_int, u_int, u_int, u_int); void grid_fill(struct grid_data *, const struct grid_cell *, u_int, u_int, u_int, u_int); void grid_fill_lines( struct grid_data *, const struct grid_cell *, u_int, u_int); void grid_clear_lines(struct grid_data *, u_int, u_int); void grid_move_lines(struct grid_data *, u_int, u_int, u_int); void grid_clear_cells(struct grid_data *, u_int, u_int, u_int); void grid_move_cells(struct grid_data *, u_int, u_int, u_int, u_int); /* grid-view.c */ const struct grid_cell *grid_view_peek_cell(struct grid_data *, u_int, u_int); struct grid_cell *grid_view_get_cell(struct grid_data *, u_int, u_int); void grid_view_set_cell( struct grid_data *, u_int, u_int, const struct grid_cell *); void grid_view_clear(struct grid_data *, u_int, u_int, u_int, u_int); void grid_view_fill(struct grid_data *, const struct grid_cell *, u_int, u_int, u_int, u_int); void grid_view_scroll_region_up(struct grid_data *, u_int, u_int); void grid_view_scroll_region_down(struct grid_data *, u_int, u_int); void grid_view_insert_lines(struct grid_data *, u_int, u_int); void grid_view_insert_lines_region( struct grid_data *, u_int, u_int, u_int, u_int); void grid_view_delete_lines(struct grid_data *, u_int, u_int); void grid_view_delete_lines_region( struct grid_data *, u_int, u_int, u_int, u_int); void grid_view_insert_cells(struct grid_data *, u_int, u_int, u_int); void grid_view_delete_cells(struct grid_data *, u_int, u_int, u_int); /* screen-write.c */ void screen_write_start_window(struct screen_write_ctx *, struct window *); void screen_write_start_client(struct screen_write_ctx *, struct client *); void screen_write_start_session( struct screen_write_ctx *, struct session *); void screen_write_start(struct screen_write_ctx *, struct screen *, void (*)(void *, enum tty_cmd, ...), void *); void screen_write_stop(struct screen_write_ctx *); void printflike3 screen_write_puts( struct screen_write_ctx *, struct grid_cell *, const char *, ...); void screen_write_putc( struct screen_write_ctx *, struct grid_cell *, u_char); void screen_write_copy(struct screen_write_ctx *, struct screen *, u_int, u_int, u_int, u_int); void screen_write_cursorup(struct screen_write_ctx *, u_int); void screen_write_cursordown(struct screen_write_ctx *, u_int); void screen_write_cursorright(struct screen_write_ctx *, u_int); void screen_write_cursorleft(struct screen_write_ctx *, u_int); void screen_write_insertcharacter(struct screen_write_ctx *, u_int); void screen_write_deletecharacter(struct screen_write_ctx *, u_int); void screen_write_insertline(struct screen_write_ctx *, u_int); void screen_write_deleteline(struct screen_write_ctx *, u_int); void screen_write_clearline(struct screen_write_ctx *); void screen_write_clearendofline(struct screen_write_ctx *); void screen_write_clearstartofline(struct screen_write_ctx *); void screen_write_cursormove(struct screen_write_ctx *, u_int, u_int); void screen_write_cursormode(struct screen_write_ctx *, int); void screen_write_reverseindex(struct screen_write_ctx *); void screen_write_scrollregion(struct screen_write_ctx *, u_int, u_int); void screen_write_insertmode(struct screen_write_ctx *, int); void screen_write_mousemode(struct screen_write_ctx *, int); void screen_write_linefeed(struct screen_write_ctx *); void screen_write_carriagereturn(struct screen_write_ctx *); void screen_write_kcursormode(struct screen_write_ctx *, int); void screen_write_kkeypadmode(struct screen_write_ctx *, int); void screen_write_clearendofscreen(struct screen_write_ctx *); void screen_write_clearstartofscreen(struct screen_write_ctx *); void screen_write_clearscreen(struct screen_write_ctx *); void screen_write_cell(struct screen_write_ctx *, const struct grid_cell *); /* screen-redraw.c */ void screen_redraw_start_window(struct screen_redraw_ctx *, struct window *); void screen_redraw_start_client(struct screen_redraw_ctx *, struct client *); void screen_redraw_start_session( struct screen_redraw_ctx *, struct session *); void screen_redraw_start(struct screen_redraw_ctx *, struct screen *, void (*)(void *, enum tty_cmd, ...), void *); void screen_redraw_stop(struct screen_redraw_ctx *); void printflike3 screen_redraw_puts( struct screen_redraw_ctx *, struct grid_cell *, const char *, ...); void screen_redraw_putc( struct screen_redraw_ctx *, struct grid_cell *, u_char); void screen_redraw_cell(struct screen_redraw_ctx *, u_int, u_int); void screen_redraw_lines(struct screen_redraw_ctx *, u_int, u_int); void screen_redraw_columns(struct screen_redraw_ctx *, u_int, u_int); /* screen.c */ void screen_init(struct screen *, u_int, u_int, u_int); void screen_reinit(struct screen *); void screen_free(struct screen *); void screen_set_title(struct screen *, const char *); void screen_resize(struct screen *, u_int, u_int); void screen_set_selection( struct screen *, u_int, u_int, u_int, u_int, struct grid_cell *); void screen_clear_selection(struct screen *); int screen_check_selection(struct screen *, u_int, u_int); void screen_display_copy_area(struct screen *, struct screen *, u_int, u_int, u_int, u_int, u_int, u_int); /* window.c */ extern struct windows windows; int window_cmp(struct window *, struct window *); int winlink_cmp(struct winlink *, struct winlink *); RB_PROTOTYPE(windows, window, entry, window_cmp); RB_PROTOTYPE(winlinks, winlink, entry, winlink_cmp); struct winlink *winlink_find_by_index(struct winlinks *, int); struct winlink *winlink_find_by_window(struct winlinks *, struct window *); int winlink_next_index(struct winlinks *); struct winlink *winlink_add(struct winlinks *, struct window *, int); void winlink_remove(struct winlinks *, struct winlink *); struct winlink *winlink_next(struct winlinks *, struct winlink *); struct winlink *winlink_previous(struct winlinks *, struct winlink *); void winlink_stack_push(struct winlink_stack *, struct winlink *); void winlink_stack_remove(struct winlink_stack *, struct winlink *); struct window *window_create(const char *, const char *, const char **, u_int, u_int, u_int); int window_spawn(struct window *, const char *, const char **); void window_destroy(struct window *); int window_resize(struct window *, u_int, u_int); int window_set_mode(struct window *, const struct window_mode *); void window_reset_mode(struct window *); void window_parse(struct window *); void window_key(struct window *, struct client *, int); /* window-copy.c */ extern const struct window_mode window_copy_mode; /* window-scroll.c */ extern const struct window_mode window_scroll_mode; /* window-more.c */ extern const struct window_mode window_more_mode; void window_more_vadd(struct window *, const char *, va_list); void printflike2 window_more_add(struct window *, const char *, ...); /* session.c */ extern struct sessions sessions; void session_alert_add(struct session *, struct window *, int); void session_alert_cancel(struct session *, struct winlink *); int session_alert_has(struct session *, struct winlink *, int); int session_alert_has_window(struct session *, struct window *, int); struct session *session_find(const char *); struct session *session_create(const char *, const char *, u_int, u_int); void session_destroy(struct session *); int session_index(struct session *, u_int *); struct winlink *session_new(struct session *, const char *, const char *, int); struct winlink *session_attach(struct session *, struct window *, int); int session_detach(struct session *, struct winlink *); int session_has(struct session *, struct window *); int session_next(struct session *); int session_previous(struct session *); int session_select(struct session *, int); int session_last(struct session *); /* utf8.c */ u_int utf8_combine(const u_char [4]); void utf8_split(u_int, u_char [4]); int utf8_width(u_int); /* buffer.c */ struct buffer *buffer_create(size_t); void buffer_destroy(struct buffer *); void buffer_clear(struct buffer *); void buffer_ensure(struct buffer *, size_t); void buffer_add(struct buffer *, size_t); void buffer_reverse_add(struct buffer *, size_t); void buffer_remove(struct buffer *, size_t); void buffer_reverse_remove(struct buffer *, size_t); void buffer_insert_range(struct buffer *, size_t, size_t); void buffer_delete_range(struct buffer *, size_t, size_t); void buffer_write(struct buffer *, const void *, size_t); void buffer_read(struct buffer *, void *, size_t); void buffer_write8(struct buffer *, uint8_t); void buffer_write16(struct buffer *, uint16_t); uint8_t buffer_read8(struct buffer *); uint16_t buffer_read16(struct buffer *); /* buffer-poll.c */ void buffer_set( struct pollfd *, int, struct buffer *, struct buffer *); int buffer_poll(struct pollfd *, struct buffer *, struct buffer *); void buffer_flush(int, struct buffer *n, struct buffer *); /* log.c */ #define LOG_FACILITY LOG_DAEMON void log_open_syslog(int); void log_open_tty(int); void log_open_file(int, const char *); void log_close(void); void log_vwrite(int, const char *, va_list); void log_write(int, const char *, ...); void printflike1 log_warn(const char *, ...); void printflike1 log_warnx(const char *, ...); void printflike1 log_info(const char *, ...); void printflike1 log_debug(const char *, ...); void printflike1 log_debug2(const char *, ...); void printflike1 log_debug3(const char *, ...); __dead void log_vfatal(const char *, va_list); __dead void log_fatal(const char *, ...); __dead void log_fatalx(const char *, ...); /* xmalloc.c */ char *xstrdup(const char *); void *xcalloc(size_t, size_t); void *xmalloc(size_t); void *xrealloc(void *, size_t, size_t); void xfree(void *); int printflike2 xasprintf(char **, const char *, ...); int xvasprintf(char **, const char *, va_list); int printflike3 xsnprintf(char *, size_t, const char *, ...); int xvsnprintf(char *, size_t, const char *, va_list); int printflike3 printpath(char *, size_t, const char *, ...); char *xdirname(const char *); char *xbasename(const char *); /* xmalloc-debug.c */ #ifdef DEBUG #define xmalloc_caller() __builtin_return_address(0) void xmalloc_clear(void); void xmalloc_report(pid_t, const char *); void xmalloc_new(void *, void *, size_t); void xmalloc_change(void *, void *, void *, size_t); void xmalloc_free(void *); #endif #endif