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