Plink now honours the Default Settings protocol and supports -l for username.
[sgt/putty] / putty.h
CommitLineData
374330e2 1#ifndef PUTTY_PUTTY_H
2#define PUTTY_PUTTY_H
3
4#define PUTTY_REG_POS "Software\\SimonTatham\\PuTTY"
de3df031 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"
374330e2 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
73251d5d 21GLOBAL HINSTANCE putty_inst;
22
374330e2 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
c9def1b8 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
374330e2 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
e14a5a13 41#define ATTR_BLINK 0x00000800UL
374330e2 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
55typedef HDC Context;
56#define SEL_NL { 13, 10 }
57
58GLOBAL int rows, cols, savelines;
59
60GLOBAL int font_width, font_height;
61
c9def1b8 62#define c_write1(_C) do { if (inbuf_head >= INBUF_SIZE) term_out(); \
63 inbuf[inbuf_head++] = (_C) ; } while(0)
374330e2 64#define INBUF_SIZE 2048
374330e2 65GLOBAL unsigned char inbuf[INBUF_SIZE];
c9def1b8 66GLOBAL int inbuf_head;
374330e2 67
68#define OUTBUF_SIZE 2048
69#define OUTBUF_MASK (OUTBUF_SIZE-1)
70GLOBAL unsigned char outbuf[OUTBUF_SIZE];
71GLOBAL int outbuf_head, outbuf_reap;
72
73GLOBAL int has_focus;
74
c9def1b8 75GLOBAL int app_cursor_keys, app_keypad_keys, vt52_mode;
76GLOBAL int repeat_off, cr_lf_return;
374330e2 77
cabfd08c 78GLOBAL int seen_key_event;
79GLOBAL int seen_disp_event;
80
d85548fe 81GLOBAL int session_closed;
82
5fd04f07 83GLOBAL char *logfile;
84
e14a5a13 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)
374330e2 92
93typedef enum {
94 TS_AYT, TS_BRK, TS_SYNCH, TS_EC, TS_EL, TS_GA, TS_NOP, TS_ABORT,
684d367c 95 TS_AO, TS_IP, TS_SUSP, TS_EOR, TS_EOF, TS_LECHO, TS_RECHO
374330e2 96} Telnet_Special;
97
98typedef enum {
99 MB_NOTHING, MB_SELECT, MB_EXTEND, MB_PASTE
100} Mouse_Button;
101
102typedef enum {
103 MA_NOTHING, MA_CLICK, MA_2CLK, MA_3CLK, MA_DRAG, MA_RELEASE
104} Mouse_Action;
105
106typedef enum {
107 VT_XWINDOWS, VT_OEMANSI, VT_OEMONLY, VT_POORMAN
108} VT_Mode;
109
110typedef 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);
4017be6d 116 SOCKET (*socket) (void);
8ccc75b0 117 int (*sendok) (void);
374330e2 118} Backend;
119
120GLOBAL Backend *back;
121
297d398b 122extern struct backend_list {
89ee5268 123 int protocol;
124 char *name;
125 Backend *backend;
126} backends[];
127
374330e2 128typedef struct {
5bc238bb 129 void (*send) (char *buf, int len);
130} Ldisc;
131
132GLOBAL Ldisc *ldisc;
133
134typedef struct {
374330e2 135 /* Basic options */
136 char host[512];
137 int port;
5e1a8e27 138 enum { PROT_RAW, PROT_TELNET, PROT_SSH } protocol;
374330e2 139 int close_on_exit;
9ef49106 140 int warn_on_close;
fef97f43 141 /* SSH options */
6abbf9e3 142 char remote_cmd[512];
fef97f43 143 int nopty;
979310f1 144 int agentfwd;
9697bfd2 145 enum { CIPHER_3DES, CIPHER_BLOWFISH, CIPHER_DES } cipher;
7cca0d81 146 char keyfile[FILENAME_MAX];
adf799dd 147 int sshprot; /* use v1 or v2 when both available */
ccbfb941 148 int try_tis_auth;
374330e2 149 /* Telnet options */
150 char termtype[32];
151 char termspeed[32];
37508af4 152 char environmt[1024]; /* VAR\tvalue\0VAR\tvalue\0\0 */
374330e2 153 char username[32];
154 int rfc_environ;
155 /* Keyboard options */
156 int bksp_is_delete;
157 int rxvt_homeend;
c9def1b8 158 int funky_type;
374330e2 159 int app_cursor;
160 int app_keypad;
c5e9c988 161 int nethack_keypad;
162 int alt_f4; /* is it special? */
163 int alt_space; /* is it special? */
5bc238bb 164 int ldisc_term;
c9def1b8 165 int scroll_on_key;
9ca5da42 166 char wintitle[256]; /* initial window title */
374330e2 167 /* Terminal options */
168 int savelines;
169 int dec_om;
170 int wrap_mode;
fef97f43 171 int lfhascr;
c9def1b8 172 int blink_cur;
173 int beep;
174 int scrollbar;
175 int locksize;
176 int bce;
177 int blinktext;
374330e2 178 int win_name_always;
179 int width, height;
180 char font[64];
181 int fontisbold;
182 int fontheight;
14963b8f 183 int fontcharset;
374330e2 184 /* Colour options */
185 int try_palette;
186 int bold_colour;
187 unsigned char colours[22][3];
188 /* Selection options */
189 int mouse_is_xterm;
190 short wordness[256];
c9def1b8 191 /* translations */
192 VT_Mode vtmode;
14963b8f 193 int xlat_enablekoiwin;
d3d16feb 194 int xlat_88592w1250;
14963b8f 195 int xlat_capslockcyr;
374330e2 196} Config;
197
e277c42d 198/*
199 * You can compile with -DSSH_DEFAULT to have ssh by default.
200 */
201#ifndef SSH_DEFAULT
202#define DEFAULT_PROTOCOL PROT_TELNET
203#define DEFAULT_PORT 23
204#else
205#define DEFAULT_PROTOCOL PROT_SSH
206#define DEFAULT_PORT 22
207#endif
208
4017be6d 209/*
210 * Some global flags denoting the type of application.
67779be7 211 *
212 * FLAG_VERBOSE is set when the user requests verbose details.
213 *
214 * FLAG_STDERR is set in command-line applications (which have a
215 * functioning stderr that it makes sense to write to) and not in
216 * GUI applications (which don't).
217 *
218 * FLAG_INTERACTIVE is set when a full interactive shell session is
219 * being run, _either_ because no remote command has been provided
220 * _or_ because the application is GUI and can't run non-
221 * interactively.
4017be6d 222 */
67779be7 223#define FLAG_VERBOSE 0x0001
224#define FLAG_STDERR 0x0002
225#define FLAG_INTERACTIVE 0x0004
4017be6d 226GLOBAL int flags;
227
374330e2 228GLOBAL Config cfg;
e277c42d 229GLOBAL int default_protocol;
230GLOBAL int default_port;
374330e2 231
4e23b276 232struct RSAKey; /* be a little careful of scope */
233
374330e2 234/*
235 * Exports from window.c.
236 */
e14a5a13 237void request_resize (int, int, int);
c9def1b8 238void do_text (Context, int, int, char *, int, unsigned long, int);
374330e2 239void set_title (char *);
240void set_icon (char *);
241void set_sbar (int, int, int);
f67b4e85 242Context get_ctx(void);
374330e2 243void free_ctx (Context);
244void palette_set (int, int, int, int);
245void palette_reset (void);
246void write_clip (void *, int);
247void get_clip (void **, int *);
248void optimised_move (int, int, int);
8d5de777 249void connection_fatal(char *, ...);
374330e2 250void fatalbox (char *, ...);
c9def1b8 251void beep (int);
6f34e365 252void begin_session(void);
ec8679e9 253void sys_cursor(int x, int y);
374330e2 254#define OPTIMISE_IS_SCROLL 1
255
256/*
257 * Exports from noise.c.
258 */
259void noise_get_heavy(void (*func) (void *, int));
260void noise_get_light(void (*func) (void *, int));
261void noise_ultralight(DWORD data);
262void random_save_seed(void);
de3df031 263void random_destroy_seed(void);
374330e2 264
265/*
266 * Exports from windlg.c.
267 */
268int do_config (void);
269int do_reconfig (HWND);
270void do_defaults (char *);
c5e9c988 271void logevent (char *);
272void showeventlog (HWND);
374330e2 273void showabout (HWND);
d4857987 274void verify_ssh_host_key(char *host, int port, char *keytype,
d5859615 275 char *keystr, char *fingerprint);
0a4aa984 276void get_sesslist(int allocate);
de3df031 277void registry_cleanup(void);
0a4aa984 278
7393a137 279GLOBAL int nsessions;
280GLOBAL char **sessions;
374330e2 281
282/*
283 * Exports from terminal.c.
284 */
285
286void term_init (void);
287void term_size (int, int, int);
288void term_out (void);
289void term_paint (Context, int, int, int, int);
290void term_scroll (int, int);
291void term_pwron (void);
292void term_clrsb (void);
293void term_mouse (Mouse_Button, Mouse_Action, int, int);
294void term_deselect (void);
295void term_update (void);
296void term_invalidate(void);
e14a5a13 297void term_blink(int set_cursor);
c9def1b8 298void term_paste(void);
299void term_nopaste(void);
374330e2 300
301/*
5e1a8e27 302 * Exports from raw.c.
303 */
304
3d9a14c9 305extern Backend raw_backend;
5e1a8e27 306
307/*
374330e2 308 * Exports from telnet.c.
309 */
310
c14776e8 311extern Backend telnet_backend;
374330e2 312
313/*
314 * Exports from ssh.c.
315 */
316
67779be7 317extern int (*ssh_get_password)(const char *prompt, char *str, int maxlen);
c14776e8 318extern Backend ssh_backend;
374330e2 319
320/*
5bc238bb 321 * Exports from ldisc.c.
322 */
323
324extern Ldisc ldisc_term, ldisc_simple;
325
326/*
374330e2 327 * Exports from sshrand.c.
328 */
329
330void random_add_noise(void *noise, int length);
331void random_init(void);
332int random_byte(void);
333void random_get_savedata(void **data, int *len);
334
335/*
336 * Exports from misc.c.
337 */
338
339/* #define MALLOC_LOG do this if you suspect putty of leaking memory */
340#ifdef MALLOC_LOG
341#define smalloc(z) (mlog(__FILE__,__LINE__), safemalloc(z))
342#define srealloc(y,z) (mlog(__FILE__,__LINE__), saferealloc(y,z))
343#define sfree(z) (mlog(__FILE__,__LINE__), safefree(z))
344void mlog(char *, int);
345#else
346#define smalloc safemalloc
347#define srealloc saferealloc
348#define sfree safefree
349#endif
350
351void *safemalloc(size_t);
352void *saferealloc(void *, size_t);
353void safefree(void *);
354
355/*
067a15ea 356 * Exports from version.c.
357 */
358extern char ver[];
359
360/*
b73fd1b1 361 * Exports from sizetip.c.
362 */
363void UpdateSizeTip(HWND src, int cx, int cy);
364void EnableSizeTip(int bEnable);
365
366/*
14963b8f 367 * Exports from xlat.c.
368 */
369unsigned char xlat_kbd2tty(unsigned char c);
370unsigned char xlat_tty2scr(unsigned char c);
371unsigned char xlat_latkbd2win(unsigned char c);
372
373/*
8f203108 374 * Exports from mscrypto.c
375 */
376#ifdef MSCRYPTOAPI
377int crypto_startup();
378void crypto_wrapup();
379#endif
380
381/*
5c58ad2d 382 * Exports from pageantc.c
383 */
384void agent_query(void *in, int inlen, void **out, int *outlen);
385int agent_exists(void);
386
387/*
374330e2 388 * A debug system.
389 */
390#ifdef DEBUG
391#include <stdarg.h>
392#define debug(x) (dprintf x)
393static void dprintf(char *fmt, ...) {
394 char buf[2048];
395 DWORD dw;
396 va_list ap;
397 static int gotconsole = 0;
398
399 if (!gotconsole) {
400 AllocConsole();
401 gotconsole = 1;
402 }
403
404 va_start(ap, fmt);
405 vsprintf(buf, fmt, ap);
406 WriteFile (GetStdHandle(STD_OUTPUT_HANDLE), buf, strlen(buf), &dw, NULL);
407 va_end(ap);
408}
409#else
410#define debug(x)
411#endif
412
413#endif