1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
|
/*++
/* NAME
/* mail_version 3
/* SUMMARY
/* time-dependent probe sender addresses
/* SYNOPSIS
/* #include <mail_version.h>
/*
/* typedef struct {
/* char *program; /* postfix */
/* int major; /* 2 */
/* int minor; /* 9 */
/* int patch; /* patchlevel or -1 */
/* char *snapshot; /* null or snapshot info */
/* } MAIL_VERSION;
/*
/* MAIL_VERSION *mail_version_parse(version_string, why)
/* const char *version_string;
/* const char **why;
/*
/* void mail_version_free(mp)
/* MAIL_VERSION *mp;
/*
/* const char *get_mail_version()
/*
/* int check_mail_version(version_string)
/* const char *version_string;
/* DESCRIPTION
/* This module understands the format of Postfix version strings
/* (for example the default value of "mail_version"), and
/* provides support to compare the compile-time version of a
/* Postfix program with the run-time version of a Postfix
/* library. Apparently, some distributions don't use proper
/* so-number versioning, causing programs to fail erratically
/* after an update replaces the library but not the program.
/*
/* A Postfix version string consists of two or three parts
/* separated by a single "-" character:
/* .IP \(bu
/* The first part is a string with the program name.
/* .IP \(bu
/* The second part is the program version: either two or three
/* non-negative integer numbers separated by single "."
/* character. Stable releases have a major version, minor
/* version and patchlevel; experimental releases (snapshots)
/* have only major and minor version numbers.
/* .IP \(bu
/* The third part is ignored with a stable release, otherwise
/* it is a string with the snapshot release date plus some
/* optional information.
/*
/* mail_version_parse() parses a version string.
/*
/* get_mail_version() returns the version string (the value
/* of DEF_MAIL_VERSION) that is compiled into the library.
/*
/* check_mail_version() compares the caller's version string
/* (usually the value of DEF_MAIL_VERSION) that is compiled
/* into the caller, and logs a warning when the strings differ.
/* DIAGNOSTICS
/* In the case of a parsing error, mail_version_parse() returns
/* a null pointer, and sets the why argument to a string with
/* problem details.
/* LICENSE
/* .ad
/* .fi
/* The Secure Mailer license must be distributed with this software.
/* AUTHOR(S)
/* Wietse Venema
/* IBM T.J. Watson Research
/* P.O. Box 704
/* Yorktown Heights, NY 10598, USA
/*--*/
/* System library. */
#include <sys_defs.h>
#include <stdlib.h>
#include <errno.h>
/* Utility library. */
#include <msg.h>
#include <mymalloc.h>
#include <stringops.h>
#include <split_at.h>
/* Global library. */
#include <mail_version.h>
/* mail_version_int - convert integer */
static int mail_version_int(const char *strval)
{
char *end;
int intval;
long longval;
errno = 0;
intval = longval = strtol(strval, &end, 10);
if (*strval == 0 || *end != 0 || errno == ERANGE || longval != intval)
intval = (-1);
return (intval);
}
/* mail_version_worker - do the parsing work */
static const char *mail_version_worker(MAIL_VERSION *mp, char *cp)
{
char *major_field;
char *minor_field;
char *patch_field;
/*
* Program name.
*/
if ((mp->program = mystrtok(&cp, "-")) == 0)
return ("no program name");
/*
* Major, minor, patchlevel. If this is a stable release, then we ignore
* text after the patchlevel, in case there are vendor extensions.
*/
if ((major_field = mystrtok(&cp, "-")) == 0)
return ("missing major version");
if ((minor_field = split_at(major_field, '.')) == 0)
return ("missing minor version");
if ((mp->major = mail_version_int(major_field)) < 0)
return ("bad major version");
patch_field = split_at(minor_field, '.');
if ((mp->minor = mail_version_int(minor_field)) < 0)
return ("bad minor version");
if (patch_field == 0)
mp->patch = -1;
else if ((mp->patch = mail_version_int(patch_field)) < 0)
return ("bad patchlevel");
/*
* Experimental release. If this is not a stable release, we take
* everything to the end of the string.
*/
if (patch_field != 0)
mp->snapshot = 0;
else if ((mp->snapshot = mystrtok(&cp, "")) == 0)
return ("missing snapshot field");
return (0);
}
/* mail_version_parse - driver */
MAIL_VERSION *mail_version_parse(const char *string, const char **why)
{
MAIL_VERSION *mp;
char *saved_string;
const char *err;
mp = (MAIL_VERSION *) mymalloc(sizeof(*mp));
saved_string = mystrdup(string);
if ((err = mail_version_worker(mp, saved_string)) != 0) {
*why = err;
myfree(saved_string);
myfree((void *) mp);
return (0);
} else {
return (mp);
}
}
/* mail_version_free - destroy version information */
void mail_version_free(MAIL_VERSION *mp)
{
myfree(mp->program);
myfree((void *) mp);
}
/* get_mail_version - return parsed mail version string */
const char *get_mail_version(void)
{
return (DEF_MAIL_VERSION);
}
/* check_mail_version - compare caller version with library version */
void check_mail_version(const char *version_string)
{
if (strcmp(version_string, DEF_MAIL_VERSION) != 0)
msg_warn("Postfix library version mis-match: wanted %s, found %s",
version_string, DEF_MAIL_VERSION);
}
#ifdef TEST
#include <unistd.h>
#include <vstring.h>
#include <vstream.h>
#include <vstring_vstream.h>
#define STR(x) vstring_str(x)
/* parse_sample - parse a sample string from argv or stdin */
static void parse_sample(const char *sample)
{
MAIL_VERSION *mp;
const char *why;
mp = mail_version_parse(sample, &why);
if (mp == 0) {
vstream_printf("ERROR: %s: %s\n", sample, why);
} else {
vstream_printf("program: %s\t", mp->program);
vstream_printf("major: %d\t", mp->major);
vstream_printf("minor: %d\t", mp->minor);
if (mp->patch < 0)
vstream_printf("snapshot: %s\n", mp->snapshot);
else
vstream_printf("patch: %d\n", mp->patch);
mail_version_free(mp);
}
vstream_fflush(VSTREAM_OUT);
}
/* main - the main program */
int main(int argc, char **argv)
{
VSTRING *inbuf = vstring_alloc(1);
int have_tty = isatty(0);
if (argc > 1) {
while (--argc > 0 && *++argv)
parse_sample(*argv);
} else {
for (;;) {
if (have_tty) {
vstream_printf("> ");
vstream_fflush(VSTREAM_OUT);
}
if (vstring_fgets_nonl(inbuf, VSTREAM_IN) <= 0)
break;
if (have_tty == 0)
vstream_printf("> %s\n", STR(inbuf));
if (*STR(inbuf) == 0 || *STR(inbuf) == '#')
continue;
parse_sample(STR(inbuf));
}
}
vstring_free(inbuf);
return (0);
}
#endif
|
