Another utility function, to free a string containing sensitive data.
[u/mdw/putty] / misc.h
1 /*
2 * Header for misc.c.
3 */
4
5 #ifndef PUTTY_MISC_H
6 #define PUTTY_MISC_H
7
8 #include "puttymem.h"
9
10 #include <stdio.h> /* for FILE * */
11 #include <stdarg.h> /* for va_list */
12 #include <time.h> /* for struct tm */
13
14 #ifndef FALSE
15 #define FALSE 0
16 #endif
17 #ifndef TRUE
18 #define TRUE 1
19 #endif
20
21 typedef struct Filename Filename;
22 typedef struct FontSpec FontSpec;
23
24 unsigned long parse_blocksize(const char *bs);
25 char ctrlparse(char *s, char **next);
26
27 char *dupstr(const char *s);
28 char *dupcat(const char *s1, ...);
29 char *dupprintf(const char *fmt, ...);
30 char *dupvprintf(const char *fmt, va_list ap);
31 void burnstr(char *string);
32
33 char *fgetline(FILE *fp);
34
35 void base64_encode_atom(unsigned char *data, int n, char *out);
36
37 struct bufchain_granule;
38 typedef struct bufchain_tag {
39 struct bufchain_granule *head, *tail;
40 int buffersize; /* current amount of buffered data */
41 } bufchain;
42
43 void bufchain_init(bufchain *ch);
44 void bufchain_clear(bufchain *ch);
45 int bufchain_size(bufchain *ch);
46 void bufchain_add(bufchain *ch, const void *data, int len);
47 void bufchain_prefix(bufchain *ch, void **data, int *len);
48 void bufchain_consume(bufchain *ch, int len);
49 void bufchain_fetch(bufchain *ch, void *data, int len);
50
51 struct tm ltime(void);
52
53 /*
54 * Debugging functions.
55 *
56 * Output goes to debug.log
57 *
58 * debug(()) (note the double brackets) is like printf().
59 *
60 * dmemdump() and dmemdumpl() both do memory dumps. The difference
61 * is that dmemdumpl() is more suited for when the memory address is
62 * important (say because you'll be recording pointer values later
63 * on). dmemdump() is more concise.
64 */
65
66 #ifdef DEBUG
67 void debug_printf(char *fmt, ...);
68 void debug_memdump(void *buf, int len, int L);
69 #define debug(x) (debug_printf x)
70 #define dmemdump(buf,len) debug_memdump (buf, len, 0);
71 #define dmemdumpl(buf,len) debug_memdump (buf, len, 1);
72 #else
73 #define debug(x)
74 #define dmemdump(buf,len)
75 #define dmemdumpl(buf,len)
76 #endif
77
78 #ifndef lenof
79 #define lenof(x) ( (sizeof((x))) / (sizeof(*(x))))
80 #endif
81
82 #ifndef min
83 #define min(x,y) ( (x) < (y) ? (x) : (y) )
84 #endif
85 #ifndef max
86 #define max(x,y) ( (x) > (y) ? (x) : (y) )
87 #endif
88
89 #define GET_32BIT_LSB_FIRST(cp) \
90 (((unsigned long)(unsigned char)(cp)[0]) | \
91 ((unsigned long)(unsigned char)(cp)[1] << 8) | \
92 ((unsigned long)(unsigned char)(cp)[2] << 16) | \
93 ((unsigned long)(unsigned char)(cp)[3] << 24))
94
95 #define PUT_32BIT_LSB_FIRST(cp, value) ( \
96 (cp)[0] = (unsigned char)(value), \
97 (cp)[1] = (unsigned char)((value) >> 8), \
98 (cp)[2] = (unsigned char)((value) >> 16), \
99 (cp)[3] = (unsigned char)((value) >> 24) )
100
101 #define GET_16BIT_LSB_FIRST(cp) \
102 (((unsigned long)(unsigned char)(cp)[0]) | \
103 ((unsigned long)(unsigned char)(cp)[1] << 8))
104
105 #define PUT_16BIT_LSB_FIRST(cp, value) ( \
106 (cp)[0] = (unsigned char)(value), \
107 (cp)[1] = (unsigned char)((value) >> 8) )
108
109 #define GET_32BIT_MSB_FIRST(cp) \
110 (((unsigned long)(unsigned char)(cp)[0] << 24) | \
111 ((unsigned long)(unsigned char)(cp)[1] << 16) | \
112 ((unsigned long)(unsigned char)(cp)[2] << 8) | \
113 ((unsigned long)(unsigned char)(cp)[3]))
114
115 #define GET_32BIT(cp) GET_32BIT_MSB_FIRST(cp)
116
117 #define PUT_32BIT_MSB_FIRST(cp, value) ( \
118 (cp)[0] = (unsigned char)((value) >> 24), \
119 (cp)[1] = (unsigned char)((value) >> 16), \
120 (cp)[2] = (unsigned char)((value) >> 8), \
121 (cp)[3] = (unsigned char)(value) )
122
123 #define PUT_32BIT(cp, value) PUT_32BIT_MSB_FIRST(cp, value)
124
125 #define GET_16BIT_MSB_FIRST(cp) \
126 (((unsigned long)(unsigned char)(cp)[0] << 8) | \
127 ((unsigned long)(unsigned char)(cp)[1]))
128
129 #define PUT_16BIT_MSB_FIRST(cp, value) ( \
130 (cp)[0] = (unsigned char)((value) >> 8), \
131 (cp)[1] = (unsigned char)(value) )
132
133 #endif