To get this branch, use:
bzr branch
http://bzr.recompile.se/loggerhead/mandos/trunk
« back to all changes in this revision
Viewing changes to plugin-runner.c
- browse files at revision 190
- compare with another revision
- download diff
- download tarball
- view history from revision 190
- Committer: Teddy Hogeborn
- Date: 2008-09-19 12:02:03 UTC
- Revision ID: teddy@fukt.bsnet.se-20080919120203-xvsf3w1h0n2bvtkb
* debian/mandos-client.postinst: Use "type" instead of "which". Split
to functions. Create key.
to functions. Create key.
- files added:
- etc-plugins.d-README
- files removed:
- DBUS-API
- debian/po
- debian/source
- files modified:
- .bzrignore
added
removed
plugin-runner.c
1
/* -*- coding: utf-8; mode: c; mode: orgtbl -*- */
1
/* -*- coding: utf-8 -*- */
2
2
/*
3
3
* Mandos plugin runner - Run Mandos plugins
4
4
*
5
* Copyright © 2008-2011 Teddy Hogeborn
6
* Copyright © 2008-2011 Björn Påhlsson
5
* Copyright © 2007-2008 Teddy Hogeborn & Björn Påhlsson
7
6
*
8
7
* This program is free software: you can redistribute it and/or
9
8
* modify it under the terms of the GNU General Public License as
19
18
* along with this program. If not, see
20
19
* <http://www.gnu.org/licenses/>.
21
20
*
22
* Contact the authors at <mandos@recompile.se>.
21
* Contact the authors at <mandos@fukt.bsnet.se>.
23
22
*/
24
23
25
24
#define _GNU_SOURCE /* TEMP_FAILURE_RETRY(), getline(),
26
asprintf(), O_CLOEXEC */
25
asprintf() */
27
26
#include <stddef.h> /* size_t, NULL */
28
#include <stdlib.h> /* malloc(), exit(), EXIT_SUCCESS,
29
realloc() */
27
#include <stdlib.h> /* malloc(), exit(), EXIT_FAILURE,
28
EXIT_SUCCESS, realloc() */
30
29
#include <stdbool.h> /* bool, true, false */
31
#include <stdio.h> /* fileno(), fprintf(),
32
stderr, STDOUT_FILENO */
33
#include <sys/types.h> /* DIR, fdopendir(), stat(), struct
30
#include <stdio.h> /* perror, popen(), fileno(),
31
fprintf(), stderr, STDOUT_FILENO */
32
#include <sys/types.h> /* DIR, opendir(), stat(), struct
34
33
stat, waitpid(), WIFEXITED(),
35
34
WEXITSTATUS(), wait(), pid_t,
36
35
uid_t, gid_t, getuid(), getgid(),
38
37
#include <sys/select.h> /* fd_set, select(), FD_ZERO(),
39
38
FD_SET(), FD_ISSET(), FD_CLR */
40
39
#include <sys/wait.h> /* wait(), waitpid(), WIFEXITED(),
41
WEXITSTATUS(), WTERMSIG(),
42
WCOREDUMP() */
40
WEXITSTATUS() */
43
41
#include <sys/stat.h> /* struct stat, stat(), S_ISREG() */
44
42
#include <iso646.h> /* and, or, not */
45
#include <dirent.h> /* DIR, struct dirent, fdopendir(),
43
#include <dirent.h> /* DIR, struct dirent, opendir(),
46
44
readdir(), closedir(), dirfd() */
47
45
#include <unistd.h> /* struct stat, stat(), S_ISREG(),
48
46
fcntl(), setuid(), setgid(),
49
47
F_GETFD, F_SETFD, FD_CLOEXEC,
50
48
access(), pipe(), fork(), close()
51
dup2(), STDOUT_FILENO, _exit(),
49
dup2, STDOUT_FILENO, _exit(),
52
50
execv(), write(), read(),
53
51
close() */
54
52
#include <fcntl.h> /* fcntl(), F_GETFD, F_SETFD,
55
53
FD_CLOEXEC */
56
#include <string.h> /* strsep, strlen(), asprintf(),
57
strsignal(), strcmp(), strncmp() */
54
#include <string.h> /* strsep, strlen(), asprintf() */
58
55
#include <errno.h> /* errno */
59
56
#include <argp.h> /* struct argp_option, struct
60
57
argp_state, struct argp,
64
61
#include <signal.h> /* struct sigaction, sigemptyset(),
65
62
sigaddset(), sigaction(),
66
63
sigprocmask(), SIG_BLOCK, SIGCHLD,
67
SIG_UNBLOCK, kill(), sig_atomic_t
68
*/
64
SIG_UNBLOCK, kill() */
69
65
#include <errno.h> /* errno, EBADF */
70
#include <inttypes.h> /* intmax_t, PRIdMAX, strtoimax() */
71
#include <sysexits.h> /* EX_OSERR, EX_USAGE, EX_IOERR,
72
EX_CONFIG, EX_UNAVAILABLE, EX_OK */
73
#include <errno.h> /* errno */
74
#include <error.h> /* error() */
75
66
76
67
#define BUFFER_SIZE 256
77
68
78
69
#define PDIR "/lib/mandos/plugins.d"
79
70
#define AFILE "/conf/conf.d/mandos/plugin-runner.conf"
80
71
81
const char *argp_program_version = "plugin-runner " VERSION;
82
const char *argp_program_bug_address = "<mandos@recompile.se>";
72
const char *argp_program_version = "plugin-runner 1.0";
73
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
83
74
84
75
typedef struct plugin{
85
76
char *name; /* can be NULL or any plugin name */
88
79
char **environ;
89
80
int envc;
90
81
bool disabled;
91
82
92
83
/* Variables used for running processes*/
93
84
pid_t pid;
94
85
int fd;
96
87
size_t buffer_size;
97
88
size_t buffer_length;
98
89
bool eof;
99
volatile sig_atomic_t completed;
100
int status;
90
volatile bool completed;
91
volatile int status;
101
92
struct plugin *next;
102
93
} plugin;
103
94
106
97
/* Gets an existing plugin based on name,
107
98
or if none is found, creates a new one */
108
99
static plugin *getplugin(char *name){
109
/* Check for existing plugin with that name */
110
for(plugin *p = plugin_list; p != NULL; p = p->next){
111
if((p->name == name)
112
or (p->name and name and (strcmp(p->name, name) == 0))){
100
/* Check for exiting plugin with that name */
101
for (plugin *p = plugin_list; p != NULL; p = p->next){
102
if ((p->name == name)
103
or (p->name and name and (strcmp(p->name, name) == 0))){
113
104
return p;
114
105
}
115
106
}
116
107
/* Create a new plugin */
117
plugin *new_plugin = NULL;
118
do {
119
new_plugin = malloc(sizeof(plugin));
120
} while(new_plugin == NULL and errno == EINTR);
121
if(new_plugin == NULL){
108
plugin *new_plugin = malloc(sizeof(plugin));
109
if (new_plugin == NULL){
122
110
return NULL;
123
111
}
124
112
char *copy_name = NULL;
125
113
if(name != NULL){
126
do {
127
copy_name = strdup(name);
128
} while(copy_name == NULL and errno == EINTR);
114
copy_name = strdup(name);
129
115
if(copy_name == NULL){
130
int e = errno;
131
free(new_plugin);
132
errno = e;
133
116
return NULL;
134
117
}
135
118
}
136
119
137
*new_plugin = (plugin){ .name = copy_name,
138
.argc = 1,
139
.disabled = false,
140
.next = plugin_list };
120
*new_plugin = (plugin) { .name = copy_name,
121
.argc = 1,
122
.disabled = false,
123
.next = plugin_list };
141
124
142
do {
143
new_plugin->argv = malloc(sizeof(char *) * 2);
144
} while(new_plugin->argv == NULL and errno == EINTR);
145
if(new_plugin->argv == NULL){
146
int e = errno;
125
new_plugin->argv = malloc(sizeof(char *) * 2);
126
if (new_plugin->argv == NULL){
147
127
free(copy_name);
148
128
free(new_plugin);
149
errno = e;
150
129
return NULL;
151
130
}
152
131
new_plugin->argv[0] = copy_name;
153
132
new_plugin->argv[1] = NULL;
154
133
155
do {
156
new_plugin->environ = malloc(sizeof(char *));
157
} while(new_plugin->environ == NULL and errno == EINTR);
134
new_plugin->environ = malloc(sizeof(char *));
158
135
if(new_plugin->environ == NULL){
159
int e = errno;
160
136
free(copy_name);
161
137
free(new_plugin->argv);
162
138
free(new_plugin);
163
errno = e;
164
139
return NULL;
165
140
}
166
141
new_plugin->environ[0] = NULL;
174
149
static bool add_to_char_array(const char *new, char ***array,
175
150
int *len){
176
151
/* Resize the pointed-to array to hold one more pointer */
177
do {
178
*array = realloc(*array, sizeof(char *)
179
* (size_t) ((*len) + 2));
180
} while(*array == NULL and errno == EINTR);
152
*array = realloc(*array, sizeof(char *)
153
* (size_t) ((*len) + 2));
181
154
/* Malloc check */
182
155
if(*array == NULL){
183
156
return false;
184
157
}
185
158
/* Make a copy of the new string */
186
char *copy;
187
do {
188
copy = strdup(new);
189
} while(copy == NULL and errno == EINTR);
159
char *copy = strdup(new);
190
160
if(copy == NULL){
191
161
return false;
192
162
}
218
188
if(strncmp(*e, def, namelen + 1) == 0){
219
189
/* It already exists */
220
190
if(replace){
221
char *new;
222
do {
223
new = realloc(*e, strlen(def) + 1);
224
} while(new == NULL and errno == EINTR);
191
char *new = realloc(*e, strlen(def) + 1);
225
192
if(new == NULL){
226
193
return false;
227
194
}
237
204
/*
238
205
* Based on the example in the GNU LibC manual chapter 13.13 "File
239
206
* Descriptor Flags".
240
| [[info:libc:Descriptor%20Flags][File Descriptor Flags]] |
207
* *Note File Descriptor Flags:(libc)Descriptor Flags.
241
208
*/
242
209
static int set_cloexec_flag(int fd){
243
int ret = (int)TEMP_FAILURE_RETRY(fcntl(fd, F_GETFD, 0));
210
int ret = fcntl(fd, F_GETFD, 0);
244
211
/* If reading the flags failed, return error indication now. */
245
212
if(ret < 0){
246
213
return ret;
247
214
}
248
215
/* Store modified flag word in the descriptor. */
249
return (int)TEMP_FAILURE_RETRY(fcntl(fd, F_SETFD,
250
ret | FD_CLOEXEC));
216
return fcntl(fd, F_SETFD, ret | FD_CLOEXEC);
251
217
}
252
218
253
219
254
220
/* Mark processes as completed when they exit, and save their exit
255
221
status. */
256
222
static void handle_sigchld(__attribute__((unused)) int sig){
257
int old_errno = errno;
258
223
while(true){
259
224
plugin *proc = plugin_list;
260
225
int status;
264
229
break;
265
230
}
266
231
if(pid == -1){
267
if(errno == ECHILD){
268
/* No child processes */
269
break;
232
if (errno != ECHILD){
233
perror("waitpid");
270
234
}
271
error(0, errno, "waitpid");
235
/* No child processes */
236
break;
272
237
}
273
238
274
239
/* A child exited, find it in process_list */
280
245
continue;
281
246
}
282
247
proc->status = status;
283
proc->completed = 1;
248
proc->completed = true;
284
249
}
285
errno = old_errno;
286
250
}
287
251
288
252
/* Prints out a password to stdout */
310
274
}
311
275
free(plugin_node->environ);
312
276
free(plugin_node->buffer);
313
277
314
278
/* Removes the plugin from the singly-linked list */
315
279
if(plugin_node == plugin_list){
316
280
/* First one - simple */
344
308
struct stat st;
345
309
fd_set rfds_all;
346
310
int ret, maxfd = 0;
347
ssize_t sret;
348
311
uid_t uid = 65534;
349
312
gid_t gid = 65534;
350
313
bool debug = false;
359
322
sigemptyset(&sigchld_action.sa_mask);
360
323
ret = sigaddset(&sigchld_action.sa_mask, SIGCHLD);
361
324
if(ret == -1){
362
error(0, errno, "sigaddset");
363
exitstatus = EX_OSERR;
325
perror("sigaddset");
326
exitstatus = EXIT_FAILURE;
364
327
goto fallback;
365
328
}
366
329
ret = sigaction(SIGCHLD, &sigchld_action, &old_sigchld_action);
367
330
if(ret == -1){
368
error(0, errno, "sigaction");
369
exitstatus = EX_OSERR;
331
perror("sigaction");
332
exitstatus = EXIT_FAILURE;
370
333
goto fallback;
371
334
}
372
335
404
367
.doc = "Group ID the plugins will run as", .group = 3 },
405
368
{ .name = "debug", .key = 132,
406
369
.doc = "Debug mode", .group = 4 },
407
/*
408
* These reproduce what we would get without ARGP_NO_HELP
409
*/
410
{ .name = "help", .key = '?',
411
.doc = "Give this help list", .group = -1 },
412
{ .name = "usage", .key = -3,
413
.doc = "Give a short usage message", .group = -1 },
414
{ .name = "version", .key = 'V',
415
.doc = "Print program version", .group = -1 },
416
370
{ .name = NULL }
417
371
};
418
372
419
error_t parse_opt(int key, char *arg, struct argp_state *state){
420
errno = 0;
421
switch(key){
422
char *tmp;
423
intmax_t tmpmax;
373
error_t parse_opt (int key, char *arg, __attribute__((unused))
374
struct argp_state *state) {
375
switch (key) {
424
376
case 'g': /* --global-options */
425
{
426
char *plugin_option;
427
while((plugin_option = strsep(&arg, ",")) != NULL){
428
if(not add_argument(getplugin(NULL), plugin_option)){
429
break;
377
if (arg != NULL){
378
char *p;
379
while((p = strsep(&arg, ",")) != NULL){
380
if(p[0] == '\0'){
381
continue;
382
}
383
if(not add_argument(getplugin(NULL), p)){
384
perror("add_argument");
385
return ARGP_ERR_UNKNOWN;
430
386
}
431
387
}
432
388
}
433
389
break;
434
390
case 'G': /* --global-env */
435
add_environment(getplugin(NULL), arg, true);
391
if(arg == NULL){
392
break;
393
}
394
if(not add_environment(getplugin(NULL), arg, true)){
395
perror("add_environment");
396
}
436
397
break;
437
398
case 'o': /* --options-for */
438
{
439
char *option_list = strchr(arg, ':');
440
if(option_list == NULL){
441
argp_error(state, "No colon in \"%s\"", arg);
442
errno = EINVAL;
443
break;
444
}
445
*option_list = '\0';
446
option_list++;
447
if(arg[0] == '\0'){
448
argp_error(state, "Empty plugin name");
449
errno = EINVAL;
450
break;
451
}
452
char *option;
453
while((option = strsep(&option_list, ",")) != NULL){
454
if(not add_argument(getplugin(arg), option)){
455
break;
399
if (arg != NULL){
400
char *p_name = strsep(&arg, ":");
401
if(p_name[0] == '\0' or arg == NULL){
402
break;
403
}
404
char *opt = strsep(&arg, ":");
405
if(opt[0] == '\0' or opt == NULL){
406
break;
407
}
408
char *p;
409
while((p = strsep(&opt, ",")) != NULL){
410
if(p[0] == '\0'){
411
continue;
412
}
413
if(not add_argument(getplugin(p_name), p)){
414
perror("add_argument");
415
return ARGP_ERR_UNKNOWN;
456
416
}
457
417
}
458
418
}
459
419
break;
460
420
case 'E': /* --env-for */
421
if(arg == NULL){
422
break;
423
}
461
424
{
462
425
char *envdef = strchr(arg, ':');
463
426
if(envdef == NULL){
464
argp_error(state, "No colon in \"%s\"", arg);
465
errno = EINVAL;
466
427
break;
467
428
}
468
429
*envdef = '\0';
469
envdef++;
470
if(arg[0] == '\0'){
471
argp_error(state, "Empty plugin name");
472
errno = EINVAL;
473
break;
430
if(not add_environment(getplugin(arg), envdef+1, true)){
431
perror("add_environment");
474
432
}
475
add_environment(getplugin(arg), envdef, true);
476
433
}
477
434
break;
478
435
case 'd': /* --disable */
479
{
436
if (arg != NULL){
480
437
plugin *p = getplugin(arg);
481
if(p != NULL){
482
p->disabled = true;
438
if(p == NULL){
439
return ARGP_ERR_UNKNOWN;
483
440
}
441
p->disabled = true;
484
442
}
485
443
break;
486
444
case 'e': /* --enable */
487
{
445
if (arg != NULL){
488
446
plugin *p = getplugin(arg);
489
if(p != NULL){
490
p->disabled = false;
447
if(p == NULL){
448
return ARGP_ERR_UNKNOWN;
491
449
}
450
p->disabled = false;
492
451
}
493
452
break;
494
453
case 128: /* --plugin-dir */
495
454
free(plugindir);
496
455
plugindir = strdup(arg);
456
if(plugindir == NULL){
457
perror("strdup");
458
}
497
459
break;
498
460
case 129: /* --config-file */
499
461
/* This is already done by parse_opt_config_file() */
500
462
break;
501
463
case 130: /* --userid */
502
tmpmax = strtoimax(arg, &tmp, 10);
503
if(errno != 0 or tmp == arg or *tmp != '\0'
504
or tmpmax != (uid_t)tmpmax){
505
argp_error(state, "Bad user ID number: \"%s\", using %"
506
PRIdMAX, arg, (intmax_t)uid);
507
break;
508
}
509
uid = (uid_t)tmpmax;
464
uid = (uid_t)strtol(arg, NULL, 10);
510
465
break;
511
466
case 131: /* --groupid */
512
tmpmax = strtoimax(arg, &tmp, 10);
513
if(errno != 0 or tmp == arg or *tmp != '\0'
514
or tmpmax != (gid_t)tmpmax){
515
argp_error(state, "Bad group ID number: \"%s\", using %"
516
PRIdMAX, arg, (intmax_t)gid);
517
break;
518
}
519
gid = (gid_t)tmpmax;
467
gid = (gid_t)strtol(arg, NULL, 10);
520
468
break;
521
469
case 132: /* --debug */
522
470
debug = true;
523
471
break;
524
/*
525
* These reproduce what we would get without ARGP_NO_HELP
526
*/
527
case '?': /* --help */
528
state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
529
argp_state_help(state, state->out_stream, ARGP_HELP_STD_HELP);
530
case -3: /* --usage */
531
state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
532
argp_state_help(state, state->out_stream,
533
ARGP_HELP_USAGE | ARGP_HELP_EXIT_OK);
534
case 'V': /* --version */
535
fprintf(state->out_stream, "%s\n", argp_program_version);
536
exit(EXIT_SUCCESS);
537
break;
538
/*
539
* When adding more options before this line, remember to also add a
540
* "case" to the "parse_opt_config_file" function below.
541
*/
542
472
case ARGP_KEY_ARG:
543
473
/* Cryptsetup always passes an argument, which is an empty
544
474
string if "none" was specified in /etc/crypttab. So if
545
475
argument was empty, we ignore it silently. */
546
if(arg[0] == '\0'){
547
break;
476
if(arg[0] != '\0'){
477
fprintf(stderr, "Ignoring unknown argument \"%s\"\n", arg);
548
478
}
479
break;
480
case ARGP_KEY_END:
481
break;
549
482
default:
550
483
return ARGP_ERR_UNKNOWN;
551
484
}
552
return errno; /* Set to 0 at start */
485
return 0;
553
486
}
554
487
555
488
/* This option parser is the same as parse_opt() above, except it
556
489
ignores everything but the --config-file option. */
557
error_t parse_opt_config_file(int key, char *arg,
558
__attribute__((unused))
559
struct argp_state *state){
560
errno = 0;
561
switch(key){
490
error_t parse_opt_config_file (int key, char *arg,
491
__attribute__((unused))
492
struct argp_state *state) {
493
switch (key) {
562
494
case 'g': /* --global-options */
563
495
case 'G': /* --global-env */
564
496
case 'o': /* --options-for */
570
502
case 129: /* --config-file */
571
503
free(argfile);
572
504
argfile = strdup(arg);
573
break;
505
if(argfile == NULL){
506
perror("strdup");
507
}
508
break;
574
509
case 130: /* --userid */
575
510
case 131: /* --groupid */
576
511
case 132: /* --debug */
577
case '?': /* --help */
578
case -3: /* --usage */
579
case 'V': /* --version */
580
512
case ARGP_KEY_ARG:
513
case ARGP_KEY_END:
581
514
break;
582
515
default:
583
516
return ARGP_ERR_UNKNOWN;
584
517
}
585
return errno;
518
return 0;
586
519
}
587
520
588
521
struct argp argp = { .options = options,
590
523
.args_doc = "",
591
524
.doc = "Mandos plugin runner -- Run plugins" };
592
525
593
/* Parse using parse_opt_config_file() in order to get the custom
526
/* Parse using the parse_opt_config_file in order to get the custom
594
527
config file location, if any. */
595
ret = argp_parse(&argp, argc, argv,
596
ARGP_IN_ORDER | ARGP_NO_EXIT | ARGP_NO_HELP,
597
NULL, NULL);
598
switch(ret){
599
case 0:
600
break;
601
case ENOMEM:
602
default:
603
errno = ret;
604
error(0, errno, "argp_parse");
605
exitstatus = EX_OSERR;
606
goto fallback;
607
case EINVAL:
608
exitstatus = EX_USAGE;
528
ret = argp_parse (&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
529
if (ret == ARGP_ERR_UNKNOWN){
530
fprintf(stderr, "Unknown error while parsing arguments\n");
531
exitstatus = EXIT_FAILURE;
609
532
goto fallback;
610
533
}
611
534
613
536
argp.parser = parse_opt;
614
537
615
538
/* Open the configfile if available */
616
if(argfile == NULL){
539
if (argfile == NULL){
617
540
conffp = fopen(AFILE, "r");
618
541
} else {
619
542
conffp = fopen(argfile, "r");
620
}
543
}
621
544
if(conffp != NULL){
622
545
char *org_line = NULL;
623
546
char *p, *arg, *new_arg, *line;
624
547
size_t size = 0;
548
ssize_t sret;
625
549
const char whitespace_delims[] = " \r\t\f\v\n";
626
550
const char comment_delim[] = "#";
627
551
628
552
custom_argc = 1;
629
553
custom_argv = malloc(sizeof(char*) * 2);
630
554
if(custom_argv == NULL){
631
error(0, errno, "malloc");
632
exitstatus = EX_OSERR;
555
perror("malloc");
556
exitstatus = EXIT_FAILURE;
633
557
goto fallback;
634
558
}
635
559
custom_argv[0] = argv[0];
636
560
custom_argv[1] = NULL;
637
561
638
562
/* for each line in the config file, strip whitespace and ignore
639
563
commented text */
640
564
while(true){
642
566
if(sret == -1){
643
567
break;
644
568
}
645
569
646
570
line = org_line;
647
571
arg = strsep(&line, comment_delim);
648
572
while((p = strsep(&arg, whitespace_delims)) != NULL){
651
575
}
652
576
new_arg = strdup(p);
653
577
if(new_arg == NULL){
654
error(0, errno, "strdup");
655
exitstatus = EX_OSERR;
578
perror("strdup");
579
exitstatus = EXIT_FAILURE;
656
580
free(org_line);
657
581
goto fallback;
658
582
}
661
585
custom_argv = realloc(custom_argv, sizeof(char *)
662
586
* ((unsigned int) custom_argc + 1));
663
587
if(custom_argv == NULL){
664
error(0, errno, "realloc");
665
exitstatus = EX_OSERR;
588
perror("realloc");
589
exitstatus = EXIT_FAILURE;
666
590
free(org_line);
667
591
goto fallback;
668
592
}
669
593
custom_argv[custom_argc-1] = new_arg;
670
custom_argv[custom_argc] = NULL;
594
custom_argv[custom_argc] = NULL;
671
595
}
672
596
}
673
do {
674
ret = fclose(conffp);
675
} while(ret == EOF and errno == EINTR);
676
if(ret == EOF){
677
error(0, errno, "fclose");
678
exitstatus = EX_IOERR;
679
goto fallback;
680
}
681
597
free(org_line);
682
598
} else {
683
599
/* Check for harmful errors and go to fallback. Other errors might
684
600
not affect opening plugins */
685
if(errno == EMFILE or errno == ENFILE or errno == ENOMEM){
686
error(0, errno, "fopen");
687
exitstatus = EX_OSERR;
601
if (errno == EMFILE or errno == ENFILE or errno == ENOMEM){
602
perror("fopen");
603
exitstatus = EXIT_FAILURE;
688
604
goto fallback;
689
605
}
690
606
}
691
/* If there were any arguments from the configuration file, pass
692
them to parser as command line arguments */
607
/* If there was any arguments from configuration file,
608
pass them to parser as command arguments */
693
609
if(custom_argv != NULL){
694
ret = argp_parse(&argp, custom_argc, custom_argv,
695
ARGP_IN_ORDER | ARGP_NO_EXIT | ARGP_NO_HELP,
696
NULL, NULL);
697
switch(ret){
698
case 0:
699
break;
700
case ENOMEM:
701
default:
702
errno = ret;
703
error(0, errno, "argp_parse");
704
exitstatus = EX_OSERR;
705
goto fallback;
706
case EINVAL:
707
exitstatus = EX_CONFIG;
610
ret = argp_parse (&argp, custom_argc, custom_argv, ARGP_IN_ORDER,
611
0, NULL);
612
if (ret == ARGP_ERR_UNKNOWN){
613
fprintf(stderr, "Unknown error while parsing arguments\n");
614
exitstatus = EXIT_FAILURE;
708
615
goto fallback;
709
616
}
710
617
}
711
618
712
619
/* Parse actual command line arguments, to let them override the
713
620
config file */
714
ret = argp_parse(&argp, argc, argv,
715
ARGP_IN_ORDER | ARGP_NO_EXIT | ARGP_NO_HELP,
716
NULL, NULL);
717
switch(ret){
718
case 0:
719
break;
720
case ENOMEM:
721
default:
722
errno = ret;
723
error(0, errno, "argp_parse");
724
exitstatus = EX_OSERR;
725
goto fallback;
726
case EINVAL:
727
exitstatus = EX_USAGE;
621
ret = argp_parse (&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
622
if (ret == ARGP_ERR_UNKNOWN){
623
fprintf(stderr, "Unknown error while parsing arguments\n");
624
exitstatus = EXIT_FAILURE;
728
625
goto fallback;
729
626
}
730
627
735
632
for(char **a = p->argv; *a != NULL; a++){
736
633
fprintf(stderr, "\tArg: %s\n", *a);
737
634
}
738
fprintf(stderr, "...and %d environment variables\n", p->envc);
635
fprintf(stderr, "...and %u environment variables\n", p->envc);
739
636
for(char **a = p->environ; *a != NULL; a++){
740
637
fprintf(stderr, "\t%s\n", *a);
741
638
}
742
639
}
743
640
}
744
641
745
{
746
/* Work around Debian bug #633582:
747
<http://bugs.debian.org/633582> */
748
int plugindir_fd = open(/* plugindir or */ PDIR, O_RDONLY);
749
if(plugindir_fd == -1){
750
error(0, errno, "open");
751
} else {
752
ret = (int)TEMP_FAILURE_RETRY(fstat(plugindir_fd, &st));
753
if(ret == -1){
754
error(0, errno, "fstat");
755
} else {
756
if(S_ISDIR(st.st_mode) and st.st_uid == 0 and st.st_gid == 0){
757
ret = fchown(plugindir_fd, uid, gid);
758
if(ret == -1){
759
error(0, errno, "fchown");
760
}
761
}
762
}
763
TEMP_FAILURE_RETRY(close(plugindir_fd));
764
}
765
}
766
767
/* Lower permissions */
642
/* Strip permissions down to nobody */
643
ret = setuid(uid);
644
if (ret == -1){
645
perror("setuid");
646
}
768
647
setgid(gid);
769
if(ret == -1){
770
error(0, errno, "setgid");
771
}
772
ret = setuid(uid);
773
if(ret == -1){
774
error(0, errno, "setuid");
775
}
776
777
/* Open plugin directory with close_on_exec flag */
648
if (ret == -1){
649
perror("setgid");
650
}
651
652
if (plugindir == NULL){
653
dir = opendir(PDIR);
654
} else {
655
dir = opendir(plugindir);
656
}
657
658
if(dir == NULL){
659
perror("Could not open plugin dir");
660
exitstatus = EXIT_FAILURE;
661
goto fallback;
662
}
663
664
/* Set the FD_CLOEXEC flag on the directory, if possible */
778
665
{
779
int dir_fd = -1;
780
if(plugindir == NULL){
781
dir_fd = open(PDIR, O_RDONLY |
782
#ifdef O_CLOEXEC
783
O_CLOEXEC
784
#else /* not O_CLOEXEC */
785
0
786
#endif /* not O_CLOEXEC */
787
);
788
} else {
789
dir_fd = open(plugindir, O_RDONLY |
790
#ifdef O_CLOEXEC
791
O_CLOEXEC
792
#else /* not O_CLOEXEC */
793
0
794
#endif /* not O_CLOEXEC */
795
);
796
}
797
if(dir_fd == -1){
798
error(0, errno, "Could not open plugin dir");
799
exitstatus = EX_UNAVAILABLE;
800
goto fallback;
801
}
802
803
#ifndef O_CLOEXEC
804
/* Set the FD_CLOEXEC flag on the directory */
805
ret = set_cloexec_flag(dir_fd);
806
if(ret < 0){
807
error(0, errno, "set_cloexec_flag");
808
TEMP_FAILURE_RETRY(close(dir_fd));
809
exitstatus = EX_OSERR;
810
goto fallback;
811
}
812
#endif /* O_CLOEXEC */
813
814
dir = fdopendir(dir_fd);
815
if(dir == NULL){
816
error(0, errno, "Could not open plugin dir");
817
TEMP_FAILURE_RETRY(close(dir_fd));
818
exitstatus = EX_OSERR;
819
goto fallback;
666
int dir_fd = dirfd(dir);
667
if(dir_fd >= 0){
668
ret = set_cloexec_flag(dir_fd);
669
if(ret < 0){
670
perror("set_cloexec_flag");
671
exitstatus = EXIT_FAILURE;
672
goto fallback;
673
}
820
674
}
821
675
}
822
676
824
678
825
679
/* Read and execute any executable in the plugin directory*/
826
680
while(true){
827
do {
828
dirst = readdir(dir);
829
} while(dirst == NULL and errno == EINTR);
681
dirst = readdir(dir);
830
682
831
683
/* All directory entries have been processed */
832
684
if(dirst == NULL){
833
if(errno == EBADF){
834
error(0, errno, "readdir");
835
exitstatus = EX_IOERR;
685
if (errno == EBADF){
686
perror("readdir");
687
exitstatus = EXIT_FAILURE;
836
688
goto fallback;
837
689
}
838
690
break;
848
700
849
701
const char const *bad_suffixes[] = { "~", "#", ".dpkg-new",
850
702
".dpkg-old",
851
".dpkg-bak",
852
703
".dpkg-divert", NULL };
853
704
for(const char **pre = bad_prefixes; *pre != NULL; pre++){
854
705
size_t pre_len = strlen(*pre);
868
719
for(const char **suf = bad_suffixes; *suf != NULL; suf++){
869
720
size_t suf_len = strlen(*suf);
870
721
if((d_name_len >= suf_len)
871
and (strcmp((dirst->d_name) + d_name_len-suf_len, *suf)
722
and (strcmp((dirst->d_name)+d_name_len-suf_len, *suf)
872
723
== 0)){
873
724
if(debug){
874
725
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
883
734
continue;
884
735
}
885
736
}
886
737
887
738
char *filename;
888
739
if(plugindir == NULL){
889
ret = (int)TEMP_FAILURE_RETRY(asprintf(&filename, PDIR "/%s",
890
dirst->d_name));
740
ret = asprintf(&filename, PDIR "/%s", dirst->d_name);
891
741
} else {
892
ret = (int)TEMP_FAILURE_RETRY(asprintf(&filename, "%s/%s",
893
plugindir,
894
dirst->d_name));
742
ret = asprintf(&filename, "%s/%s", plugindir, dirst->d_name);
895
743
}
896
744
if(ret < 0){
897
error(0, errno, "asprintf");
745
perror("asprintf");
898
746
continue;
899
747
}
900
748
901
ret = (int)TEMP_FAILURE_RETRY(stat(filename, &st));
902
if(ret == -1){
903
error(0, errno, "stat");
749
ret = stat(filename, &st);
750
if (ret == -1){
751
perror("stat");
904
752
free(filename);
905
753
continue;
906
754
}
907
755
908
756
/* Ignore non-executable files */
909
if(not S_ISREG(st.st_mode)
910
or (TEMP_FAILURE_RETRY(access(filename, X_OK)) != 0)){
757
if (not S_ISREG(st.st_mode) or (access(filename, X_OK) != 0)){
911
758
if(debug){
912
759
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
913
760
" with bad type or mode\n", filename);
918
765
919
766
plugin *p = getplugin(dirst->d_name);
920
767
if(p == NULL){
921
error(0, errno, "getplugin");
768
perror("getplugin");
922
769
free(filename);
923
770
continue;
924
771
}
936
783
if(g != NULL){
937
784
for(char **a = g->argv + 1; *a != NULL; a++){
938
785
if(not add_argument(p, *a)){
939
error(0, errno, "add_argument");
786
perror("add_argument");
940
787
}
941
788
}
942
789
/* Add global environment variables */
943
790
for(char **e = g->environ; *e != NULL; e++){
944
791
if(not add_environment(p, *e, false)){
945
error(0, errno, "add_environment");
792
perror("add_environment");
946
793
}
947
794
}
948
795
}
953
800
if(p->environ[0] != NULL){
954
801
for(char **e = environ; *e != NULL; e++){
955
802
if(not add_environment(p, *e, false)){
956
error(0, errno, "add_environment");
803
perror("add_environment");
957
804
}
958
805
}
959
806
}
960
807
961
808
int pipefd[2];
962
ret = (int)TEMP_FAILURE_RETRY(pipe(pipefd));
963
if(ret == -1){
964
error(0, errno, "pipe");
965
exitstatus = EX_OSERR;
809
ret = pipe(pipefd);
810
if (ret == -1){
811
perror("pipe");
812
exitstatus = EXIT_FAILURE;
966
813
goto fallback;
967
814
}
968
815
/* Ask OS to automatic close the pipe on exec */
969
816
ret = set_cloexec_flag(pipefd[0]);
970
817
if(ret < 0){
971
error(0, errno, "set_cloexec_flag");
972
exitstatus = EX_OSERR;
818
perror("set_cloexec_flag");
819
exitstatus = EXIT_FAILURE;
973
820
goto fallback;
974
821
}
975
822
ret = set_cloexec_flag(pipefd[1]);
976
823
if(ret < 0){
977
error(0, errno, "set_cloexec_flag");
978
exitstatus = EX_OSERR;
824
perror("set_cloexec_flag");
825
exitstatus = EXIT_FAILURE;
979
826
goto fallback;
980
827
}
981
828
/* Block SIGCHLD until process is safely in process list */
982
ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_BLOCK,
983
&sigchld_action.sa_mask,
984
NULL));
829
ret = sigprocmask (SIG_BLOCK, &sigchld_action.sa_mask, NULL);
985
830
if(ret < 0){
986
error(0, errno, "sigprocmask");
987
exitstatus = EX_OSERR;
831
perror("sigprocmask");
832
exitstatus = EXIT_FAILURE;
988
833
goto fallback;
989
834
}
990
835
/* Starting a new process to be watched */
991
pid_t pid;
992
do {
993
pid = fork();
994
} while(pid == -1 and errno == EINTR);
836
pid_t pid = fork();
995
837
if(pid == -1){
996
error(0, errno, "fork");
997
exitstatus = EX_OSERR;
838
perror("fork");
839
exitstatus = EXIT_FAILURE;
998
840
goto fallback;
999
841
}
1000
842
if(pid == 0){
1001
843
/* this is the child process */
1002
844
ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1003
845
if(ret < 0){
1004
error(0, errno, "sigaction");
1005
_exit(EX_OSERR);
846
perror("sigaction");
847
_exit(EXIT_FAILURE);
1006
848
}
1007
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
849
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1008
850
if(ret < 0){
1009
error(0, errno, "sigprocmask");
1010
_exit(EX_OSERR);
851
perror("sigprocmask");
852
_exit(EXIT_FAILURE);
1011
853
}
1012
854
1013
855
ret = dup2(pipefd[1], STDOUT_FILENO); /* replace our stdout */
1014
856
if(ret == -1){
1015
error(0, errno, "dup2");
1016
_exit(EX_OSERR);
857
perror("dup2");
858
_exit(EXIT_FAILURE);
1017
859
}
1018
860
1019
861
if(dirfd(dir) < 0){
1023
865
}
1024
866
if(p->environ[0] == NULL){
1025
867
if(execv(filename, p->argv) < 0){
1026
error(0, errno, "execv for %s", filename);
1027
_exit(EX_OSERR);
868
perror("execv");
869
_exit(EXIT_FAILURE);
1028
870
}
1029
871
} else {
1030
872
if(execve(filename, p->argv, p->environ) < 0){
1031
error(0, errno, "execve for %s", filename);
1032
_exit(EX_OSERR);
873
perror("execve");
874
_exit(EXIT_FAILURE);
1033
875
}
1034
876
}
1035
877
/* no return */
1036
878
}
1037
879
/* Parent process */
1038
TEMP_FAILURE_RETRY(close(pipefd[1])); /* Close unused write end of
1039
pipe */
880
close(pipefd[1]); /* Close unused write end of pipe */
1040
881
free(filename);
1041
882
plugin *new_plugin = getplugin(dirst->d_name);
1042
if(new_plugin == NULL){
1043
error(0, errno, "getplugin");
1044
ret = (int)(TEMP_FAILURE_RETRY
1045
(sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask,
1046
NULL)));
883
if (new_plugin == NULL){
884
perror("getplugin");
885
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1047
886
if(ret < 0){
1048
error(0, errno, "sigprocmask");
887
perror("sigprocmask");
1049
888
}
1050
exitstatus = EX_OSERR;
889
exitstatus = EXIT_FAILURE;
1051
890
goto fallback;
1052
891
}
1053
892
1056
895
1057
896
/* Unblock SIGCHLD so signal handler can be run if this process
1058
897
has already completed */
1059
ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1060
&sigchld_action.sa_mask,
1061
NULL));
898
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1062
899
if(ret < 0){
1063
error(0, errno, "sigprocmask");
1064
exitstatus = EX_OSERR;
900
perror("sigprocmask");
901
exitstatus = EXIT_FAILURE;
1065
902
goto fallback;
1066
903
}
1067
904
1068
FD_SET(new_plugin->fd, &rfds_all); /* Spurious warning from
1069
-Wconversion */
905
FD_SET(new_plugin->fd, &rfds_all);
1070
906
1071
if(maxfd < new_plugin->fd){
907
if (maxfd < new_plugin->fd){
1072
908
maxfd = new_plugin->fd;
1073
909
}
910
1074
911
}
1075
912
1076
TEMP_FAILURE_RETRY(closedir(dir));
913
closedir(dir);
1077
914
dir = NULL;
1078
free_plugin(getplugin(NULL));
1079
915
1080
916
for(plugin *p = plugin_list; p != NULL; p = p->next){
1081
917
if(p->pid != 0){
1082
918
break;
1087
923
free_plugin_list();
1088
924
}
1089
925
}
1090
926
1091
927
/* Main loop while running plugins exist */
1092
928
while(plugin_list){
1093
929
fd_set rfds = rfds_all;
1094
930
int select_ret = select(maxfd+1, &rfds, NULL, NULL, NULL);
1095
if(select_ret == -1 and errno != EINTR){
1096
error(0, errno, "select");
1097
exitstatus = EX_OSERR;
931
if (select_ret == -1){
932
perror("select");
933
exitstatus = EXIT_FAILURE;
1098
934
goto fallback;
1099
935
}
1100
936
/* OK, now either a process completed, or something can be read
1101
937
from one of them */
1102
938
for(plugin *proc = plugin_list; proc != NULL;){
1103
939
/* Is this process completely done? */
1104
if(proc->completed and proc->eof){
940
if(proc->eof and proc->completed){
1105
941
/* Only accept the plugin output if it exited cleanly */
1106
942
if(not WIFEXITED(proc->status)
1107
943
or WEXITSTATUS(proc->status) != 0){
1108
944
/* Bad exit by plugin */
1109
945
1110
946
if(debug){
1111
947
if(WIFEXITED(proc->status)){
1112
fprintf(stderr, "Plugin %s [%" PRIdMAX "] exited with"
1113
" status %d\n", proc->name,
1114
(intmax_t) (proc->pid),
948
fprintf(stderr, "Plugin %u exited with status %d\n",
949
(unsigned int) (proc->pid),
1115
950
WEXITSTATUS(proc->status));
1116
} else if(WIFSIGNALED(proc->status)){
1117
fprintf(stderr, "Plugin %s [%" PRIdMAX "] killed by"
1118
" signal %d: %s\n", proc->name,
1119
(intmax_t) (proc->pid),
1120
WTERMSIG(proc->status),
1121
strsignal(WTERMSIG(proc->status)));
951
} else if(WIFSIGNALED(proc->status)) {
952
fprintf(stderr, "Plugin %u killed by signal %d\n",
953
(unsigned int) (proc->pid),
954
WTERMSIG(proc->status));
1122
955
} else if(WCOREDUMP(proc->status)){
1123
fprintf(stderr, "Plugin %s [%" PRIdMAX "] dumped"
1124
" core\n", proc->name, (intmax_t) (proc->pid));
956
fprintf(stderr, "Plugin %d dumped core\n",
957
(unsigned int) (proc->pid));
1125
958
}
1126
959
}
1127
960
1128
961
/* Remove the plugin */
1129
FD_CLR(proc->fd, &rfds_all); /* Spurious warning from
1130
-Wconversion */
1131
962
FD_CLR(proc->fd, &rfds_all);
963
1132
964
/* Block signal while modifying process_list */
1133
ret = (int)TEMP_FAILURE_RETRY(sigprocmask
1134
(SIG_BLOCK,
1135
&sigchld_action.sa_mask,
1136
NULL));
1137
if(ret < 0){
1138
error(0, errno, "sigprocmask");
1139
exitstatus = EX_OSERR;
1140
goto fallback;
965
ret = sigprocmask(SIG_BLOCK, &sigchld_action.sa_mask, NULL);
966
if(ret < 0){
967
perror("sigprocmask");
968
exitstatus = EXIT_FAILURE;
969
goto fallback;
970
}
971
972
/* We are done modifying process list, so unblock signal */
973
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask,
974
NULL);
975
if(ret < 0){
976
perror("sigprocmask");
977
exitstatus = EXIT_FAILURE;
978
goto fallback;
979
}
980
981
if(plugin_list == NULL){
982
break;
1141
983
}
1142
984
1143
985
plugin *next_plugin = proc->next;
1144
986
free_plugin(proc);
1145
987
proc = next_plugin;
1146
1147
/* We are done modifying process list, so unblock signal */
1148
ret = (int)(TEMP_FAILURE_RETRY
1149
(sigprocmask(SIG_UNBLOCK,
1150
&sigchld_action.sa_mask, NULL)));
1151
if(ret < 0){
1152
error(0, errno, "sigprocmask");
1153
exitstatus = EX_OSERR;
1154
goto fallback;
1155
}
1156
1157
if(plugin_list == NULL){
1158
break;
1159
}
1160
1161
988
continue;
1162
989
}
1163
990
1164
991
/* This process exited nicely, so print its buffer */
1165
992
1166
993
bool bret = print_out_password(proc->buffer,
1167
994
proc->buffer_length);
1168
995
if(not bret){
1169
error(0, errno, "print_out_password");
1170
exitstatus = EX_IOERR;
996
perror("print_out_password");
997
exitstatus = EXIT_FAILURE;
1171
998
}
1172
999
goto fallback;
1173
1000
}
1174
1001
1175
1002
/* This process has not completed. Does it have any output? */
1176
if(proc->eof or not FD_ISSET(proc->fd, &rfds)){ /* Spurious
1177
warning from
1178
-Wconversion */
1003
if(proc->eof or not FD_ISSET(proc->fd, &rfds)){
1179
1004
/* This process had nothing to say at this time */
1180
1005
proc = proc->next;
1181
1006
continue;
1184
1009
if(proc->buffer_length + BUFFER_SIZE > proc->buffer_size){
1185
1010
proc->buffer = realloc(proc->buffer, proc->buffer_size
1186
1011
+ (size_t) BUFFER_SIZE);
1187
if(proc->buffer == NULL){
1188
error(0, errno, "malloc");
1189
exitstatus = EX_OSERR;
1012
if (proc->buffer == NULL){
1013
perror("malloc");
1014
exitstatus = EXIT_FAILURE;
1190
1015
goto fallback;
1191
1016
}
1192
1017
proc->buffer_size += BUFFER_SIZE;
1193
1018
}
1194
1019
/* Read from the process */
1195
sret = TEMP_FAILURE_RETRY(read(proc->fd,
1196
proc->buffer
1197
+ proc->buffer_length,
1198
BUFFER_SIZE));
1199
if(sret < 0){
1020
ret = read(proc->fd, proc->buffer + proc->buffer_length,
1021
BUFFER_SIZE);
1022
if(ret < 0){
1200
1023
/* Read error from this process; ignore the error */
1201
1024
proc = proc->next;
1202
1025
continue;
1203
1026
}
1204
if(sret == 0){
1027
if(ret == 0){
1205
1028
/* got EOF */
1206
1029
proc->eof = true;
1207
1030
} else {
1208
proc->buffer_length += (size_t) sret;
1031
proc->buffer_length += (size_t) ret;
1209
1032
}
1210
1033
}
1211
1034
}
1212
1213
1035
1036
1214
1037
fallback:
1215
1038
1216
if(plugin_list == NULL or (exitstatus != EXIT_SUCCESS
1217
and exitstatus != EX_OK)){
1039
if(plugin_list == NULL or exitstatus != EXIT_SUCCESS){
1218
1040
/* Fallback if all plugins failed, none are found or an error
1219
1041
occured */
1220
1042
bool bret;
1228
1050
}
1229
1051
bret = print_out_password(passwordbuffer, len);
1230
1052
if(not bret){
1231
error(0, errno, "print_out_password");
1232
exitstatus = EX_IOERR;
1053
perror("print_out_password");
1054
exitstatus = EXIT_FAILURE;
1233
1055
}
1234
1056
}
1235
1057
1236
1058
/* Restore old signal handler */
1237
1059
ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1238
1060
if(ret == -1){
1239
error(0, errno, "sigaction");
1240
exitstatus = EX_OSERR;
1061
perror("sigaction");
1062
exitstatus = EXIT_FAILURE;
1241
1063
}
1242
1064
1243
1065
if(custom_argv != NULL){
1244
1066
for(char **arg = custom_argv+1; *arg != NULL; arg++){
1245
1067
free(*arg);
1251
1073
closedir(dir);
1252
1074
}
1253
1075
1254
/* Kill the processes */
1076
/* Free the process list and kill the processes */
1255
1077
for(plugin *p = plugin_list; p != NULL; p = p->next){
1256
1078
if(p->pid != 0){
1257
1079
close(p->fd);
1258
1080
ret = kill(p->pid, SIGTERM);
1259
1081
if(ret == -1 and errno != ESRCH){
1260
1082
/* Set-uid proccesses might not get closed */
1261
error(0, errno, "kill");
1083
perror("kill");
1262
1084
}
1263
1085
}
1264
1086
}
1265
1087
1266
1088
/* Wait for any remaining child processes to terminate */
1267
do {
1089
do{
1268
1090
ret = wait(NULL);
1269
1091
} while(ret >= 0);
1270
1092
if(errno != ECHILD){
1271
error(0, errno, "wait");
1093
perror("wait");
1272
1094
}
1273
1095
1274
1096
free_plugin_list();
1275
1097
1276
1098
free(plugindir);
Loggerhead is a web-based interface for Breezy
Version: 2.0.2.dev0