git.distorted.org.uk Git - u/mdw/putty/blob - putty.h

   1 #ifndef PUTTY_PUTTY_H
   2 #define PUTTY_PUTTY_H
   3
   4 #define PUTTY_REG_POS "Software\\SimonTatham\\PuTTY"
   5 #define PUTTY_REG_PARENT "Software\\SimonTatham"
   6 #define PUTTY_REG_PARENT_CHILD "PuTTY"
   7 #define PUTTY_REG_GPARENT "Software"
   8 #define PUTTY_REG_GPARENT_CHILD "SimonTatham"
   9
  10 /*
  11  * Global variables. Most modules declare these `extern', but
  12  * window.c will do `#define PUTTY_DO_GLOBALS' before including this
  13  * module, and so will get them properly defined.
  14  */
  15 #ifdef PUTTY_DO_GLOBALS
  16 #define GLOBAL
  17 #else
  18 #define GLOBAL extern
  19 #endif
  20
  21 GLOBAL HINSTANCE putty_inst;
  22
  23 #define ATTR_ACTCURS 0x80000000UL      /* active cursor (block) */
  24 #define ATTR_PASCURS 0x40000000UL      /* passive cursor (box) */
  25 #define ATTR_INVALID 0x20000000UL
  26 #define ATTR_WRAPPED 0x10000000UL
  27
  28 #define LATTR_NORM   0x00000000UL
  29 #define LATTR_WIDE   0x01000000UL
  30 #define LATTR_TOP    0x02000000UL
  31 #define LATTR_BOT    0x03000000UL
  32 #define LATTR_MODE   0x03000000UL
  33
  34 #define ATTR_ASCII   0x00000000UL      /* normal ASCII charset ESC ( B */
  35 #define ATTR_GBCHR   0x00100000UL      /* UK variant   charset ESC ( A */
  36 #define ATTR_LINEDRW 0x00200000UL      /* line drawing charset ESC ( 0 */
  37
  38 #define ATTR_BOLD    0x00000100UL
  39 #define ATTR_UNDER   0x00000200UL
  40 #define ATTR_REVERSE 0x00000400UL
  41 #define ATTR_BLINK   0x00000800UL
  42 #define ATTR_FGMASK  0x0000F000UL
  43 #define ATTR_BGMASK  0x000F0000UL
  44 #define ATTR_FGSHIFT 12
  45 #define ATTR_BGSHIFT 16
  46
  47 #define ATTR_DEFAULT 0x00098000UL
  48 #define ATTR_DEFFG   0x00008000UL
  49 #define ATTR_DEFBG   0x00090000UL
  50 #define ATTR_CUR_XOR 0x000BA000UL
  51 #define ERASE_CHAR   (ATTR_DEFAULT | ' ')
  52 #define ATTR_MASK    0xFFFFFF00UL
  53 #define CHAR_MASK    0x000000FFUL
  54
  55 typedef HDC Context;
  56 #define SEL_NL { 13, 10 }
  57
  58 GLOBAL int rows, cols, savelines;
  59
  60 GLOBAL int font_width, font_height;
  61
  62 #define c_write1(_C) do { if (inbuf_head >= INBUF_SIZE) term_out(); \
  63                           inbuf[inbuf_head++] = (_C) ; } while(0)
  64 #define INBUF_SIZE 2048
  65 GLOBAL unsigned char inbuf[INBUF_SIZE];
  66 GLOBAL int inbuf_head;
  67
  68 #define OUTBUF_SIZE 2048
  69 #define OUTBUF_MASK (OUTBUF_SIZE-1)
  70 GLOBAL unsigned char outbuf[OUTBUF_SIZE];
  71 GLOBAL int outbuf_head, outbuf_reap;
  72
  73 GLOBAL int has_focus;
  74
  75 GLOBAL int app_cursor_keys, app_keypad_keys, vt52_mode;
  76 GLOBAL int repeat_off, cr_lf_return;
  77
  78 GLOBAL int seen_key_event;
  79 GLOBAL int seen_disp_event;
  80
  81 GLOBAL int session_closed;
  82
  83 GLOBAL char *logfile;
  84
  85 /*
  86  * I've just looked in the windows standard headr files for WM_USER, there
  87  * are hundreds of flags defined using the form WM_USER+123 so I've
  88  * renumbered this NETEVENT value and the two in window.c
  89  */
  90 #define WM_XUSER     (WM_USER + 0x2000)
  91 #define WM_NETEVENT  (WM_XUSER + 5)
  92
  93 typedef enum {
  94     TS_AYT, TS_BRK, TS_SYNCH, TS_EC, TS_EL, TS_GA, TS_NOP, TS_ABORT,
  95     TS_AO, TS_IP, TS_SUSP, TS_EOR, TS_EOF, TS_LECHO, TS_RECHO
  96 } Telnet_Special;
  97
  98 typedef enum {
  99     MB_NOTHING, MB_SELECT, MB_EXTEND, MB_PASTE
 100 } Mouse_Button;
 101
 102 typedef enum {
 103     MA_NOTHING, MA_CLICK, MA_2CLK, MA_3CLK, MA_DRAG, MA_RELEASE
 104 } Mouse_Action;
 105
 106 typedef enum {
 107     VT_XWINDOWS, VT_OEMANSI, VT_OEMONLY, VT_POORMAN
 108 } VT_Mode;
 109
 110 typedef struct {
 111     char *(*init) (HWND hwnd, char *host, int port, char **realhost);
 112     int (*msg) (WPARAM wParam, LPARAM lParam);
 113     void (*send) (char *buf, int len);
 114     void (*size) (void);
 115     void (*special) (Telnet_Special code);
 116     SOCKET (*socket) (void);
 117     int (*sendok) (void);
 118     int default_port;
 119 } Backend;
 120
 121 GLOBAL Backend *back;
 122
 123 extern struct backend_list {
 124     int protocol;
 125     char *name;
 126     Backend *backend;
 127 } backends[];
 128
 129 typedef struct {
 130     void (*send) (char *buf, int len);
 131 } Ldisc;
 132
 133 GLOBAL Ldisc *ldisc;
 134
 135 typedef struct {
 136     /* Basic options */
 137     char host[512];
 138     int port;
 139     enum { PROT_RAW, PROT_TELNET, PROT_SSH } protocol;
 140     int close_on_exit;
 141     int warn_on_close;
 142     /* SSH options */
 143     char remote_cmd[512];
 144     int nopty;
 145     int agentfwd;
 146     enum { CIPHER_3DES, CIPHER_BLOWFISH, CIPHER_DES } cipher;
 147     char keyfile[FILENAME_MAX];
 148     int sshprot;                       /* use v1 or v2 when both available */
 149     int try_tis_auth;
 150     /* Telnet options */
 151     char termtype[32];
 152     char termspeed[32];
 153     char environmt[1024];                    /* VAR\tvalue\0VAR\tvalue\0\0 */
 154     char username[32];
 155     int rfc_environ;
 156     /* Keyboard options */
 157     int bksp_is_delete;
 158     int rxvt_homeend;
 159     int funky_type;
 160     int app_cursor;
 161     int app_keypad;
 162     int nethack_keypad;
 163     int alt_f4;                        /* is it special? */
 164     int alt_space;                     /* is it special? */
 165     int ldisc_term;
 166     int scroll_on_key;
 167     char wintitle[256];                /* initial window title */
 168     /* Terminal options */
 169     int savelines;
 170     int dec_om;
 171     int wrap_mode;
 172     int lfhascr;
 173     int blink_cur;
 174     int beep;
 175     int scrollbar;
 176     int locksize;
 177     int bce;
 178     int blinktext;
 179     int win_name_always;
 180     int width, height;
 181     char font[64];
 182     int fontisbold;
 183     int fontheight;
 184     int fontcharset;
 185     /* Colour options */
 186     int try_palette;
 187     int bold_colour;
 188     unsigned char colours[22][3];
 189     /* Selection options */
 190     int mouse_is_xterm;
 191     short wordness[256];
 192     /* translations */
 193     VT_Mode vtmode;
 194     int xlat_enablekoiwin;
 195     int xlat_88592w1250;
 196     int xlat_capslockcyr;
 197 } Config;
 198
 199 /*
 200  * You can compile with -DSSH_DEFAULT to have ssh by default.
 201  */
 202 #ifndef SSH_DEFAULT
 203 #define DEFAULT_PROTOCOL PROT_TELNET
 204 #define DEFAULT_PORT 23
 205 #else
 206 #define DEFAULT_PROTOCOL PROT_SSH
 207 #define DEFAULT_PORT 22
 208 #endif
 209
 210 /*
 211  * Some global flags denoting the type of application.
 212  *
 213  * FLAG_VERBOSE is set when the user requests verbose details.
 214  *
 215  * FLAG_STDERR is set in command-line applications (which have a
 216  * functioning stderr that it makes sense to write to) and not in
 217  * GUI applications (which don't).
 218  *
 219  * FLAG_INTERACTIVE is set when a full interactive shell session is
 220  * being run, _either_ because no remote command has been provided
 221  * _or_ because the application is GUI and can't run non-
 222  * interactively.
 223  */
 224 #define FLAG_VERBOSE     0x0001
 225 #define FLAG_STDERR      0x0002
 226 #define FLAG_INTERACTIVE 0x0004
 227 GLOBAL int flags;
 228
 229 GLOBAL Config cfg;
 230 GLOBAL int default_protocol;
 231 GLOBAL int default_port;
 232
 233 struct RSAKey;                         /* be a little careful of scope */
 234
 235 /*
 236  * Exports from window.c.
 237  */
 238 void request_resize (int, int, int);
 239 void do_text (Context, int, int, char *, int, unsigned long, int);
 240 void set_title (char *);
 241 void set_icon (char *);
 242 void set_sbar (int, int, int);
 243 Context get_ctx(void);
 244 void free_ctx (Context);
 245 void palette_set (int, int, int, int);
 246 void palette_reset (void);
 247 void write_clip (void *, int);
 248 void get_clip (void **, int *);
 249 void optimised_move (int, int, int);
 250 void connection_fatal(char *, ...);
 251 void fatalbox (char *, ...);
 252 void beep (int);
 253 void begin_session(void);
 254 void sys_cursor(int x, int y);
 255 #define OPTIMISE_IS_SCROLL 1
 256
 257 /*
 258  * Exports from noise.c.
 259  */
 260 void noise_get_heavy(void (*func) (void *, int));
 261 void noise_get_light(void (*func) (void *, int));
 262 void noise_ultralight(DWORD data);
 263 void random_save_seed(void);
 264 void random_destroy_seed(void);
 265
 266 /*
 267  * Exports from windlg.c.
 268  */
 269 int do_config (void);
 270 int do_reconfig (HWND);
 271 void do_defaults (char *);
 272 void logevent (char *);
 273 void showeventlog (HWND);
 274 void showabout (HWND);
 275 void verify_ssh_host_key(char *host, int port, char *keytype,
 276                          char *keystr, char *fingerprint);
 277 void get_sesslist(int allocate);
 278 void registry_cleanup(void);
 279
 280 GLOBAL int nsessions;
 281 GLOBAL char **sessions;
 282
 283 /*
 284  * Exports from terminal.c.
 285  */
 286
 287 void term_init (void);
 288 void term_size (int, int, int);
 289 void term_out (void);
 290 void term_paint (Context, int, int, int, int);
 291 void term_scroll (int, int);
 292 void term_pwron (void);
 293 void term_clrsb (void);
 294 void term_mouse (Mouse_Button, Mouse_Action, int, int);
 295 void term_deselect (void);
 296 void term_update (void);
 297 void term_invalidate(void);
 298 void term_blink(int set_cursor);
 299 void term_paste(void);
 300 void term_nopaste(void);
 301
 302 /*
 303  * Exports from raw.c.
 304  */
 305
 306 extern Backend raw_backend;
 307
 308 /*
 309  * Exports from telnet.c.
 310  */
 311
 312 extern Backend telnet_backend;
 313
 314 /*
 315  * Exports from ssh.c.
 316  */
 317
 318 extern int (*ssh_get_password)(const char *prompt, char *str, int maxlen);
 319 extern Backend ssh_backend;
 320
 321 /*
 322  * Exports from ldisc.c.
 323  */
 324
 325 extern Ldisc ldisc_term, ldisc_simple;
 326
 327 /*
 328  * Exports from sshrand.c.
 329  */
 330
 331 void random_add_noise(void *noise, int length);
 332 void random_init(void);
 333 int random_byte(void);
 334 void random_get_savedata(void **data, int *len);
 335
 336 /*
 337  * Exports from misc.c.
 338  */
 339
 340 /* #define MALLOC_LOG  do this if you suspect putty of leaking memory */
 341 #ifdef MALLOC_LOG
 342 #define smalloc(z) (mlog(__FILE__,__LINE__), safemalloc(z))
 343 #define srealloc(y,z) (mlog(__FILE__,__LINE__), saferealloc(y,z))
 344 #define sfree(z) (mlog(__FILE__,__LINE__), safefree(z))
 345 void mlog(char *, int);
 346 #else
 347 #define smalloc safemalloc
 348 #define srealloc saferealloc
 349 #define sfree safefree
 350 #endif
 351
 352 void *safemalloc(size_t);
 353 void *saferealloc(void *, size_t);
 354 void safefree(void *);
 355
 356 /*
 357  * Exports from version.c.
 358  */
 359 extern char ver[];
 360
 361 /*
 362  * Exports from sizetip.c.
 363  */
 364 void UpdateSizeTip(HWND src, int cx, int cy);
 365 void EnableSizeTip(int bEnable);
 366
 367 /*
 368  * Exports from xlat.c.
 369  */
 370 unsigned char xlat_kbd2tty(unsigned char c);
 371 unsigned char xlat_tty2scr(unsigned char c);
 372 unsigned char xlat_latkbd2win(unsigned char c);
 373
 374 /*
 375  * Exports from mscrypto.c
 376  */
 377 #ifdef MSCRYPTOAPI
 378 int crypto_startup();
 379 void crypto_wrapup();
 380 #endif
 381
 382 /*
 383  * Exports from pageantc.c
 384  */
 385 void agent_query(void *in, int inlen, void **out, int *outlen);
 386 int agent_exists(void);
 387
 388 /*
 389  * A debug system.
 390  */
 391 #ifdef DEBUG
 392 #include <stdarg.h>
 393 #define debug(x) (dprintf x)
 394 static void dprintf(char *fmt, ...) {
 395     char buf[2048];
 396     DWORD dw;
 397     va_list ap;
 398     static int gotconsole = 0;
 399
 400     if (!gotconsole) {
 401         AllocConsole();
 402         gotconsole = 1;
 403     }
 404
 405     va_start(ap, fmt);
 406     vsprintf(buf, fmt, ap);
 407     WriteFile (GetStdHandle(STD_OUTPUT_HANDLE), buf, strlen(buf), &dw, NULL);
 408     va_end(ap);
 409 }
 410 #else
 411 #define debug(x)
 412 #endif
 413
 414 #endif