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 165
- compare with another revision
- download diff
- download tarball
- view history from revision 165
- Committer: Teddy Hogeborn
- Date: 2008-09-05 18:37:28 UTC
- Revision ID: teddy@fukt.bsnet.se-20080905183728-l0m8v3vqa302uwrw
* mandos (main): Use EAFP with pidfile.
- files added:
- plugins.d/usplash
- files removed:
- .bzr-builddeb
- debian
- debian/po
- files renamed:
- plugins.d/mandos-client.c => plugins.d/password-request.c
- plugins.d/mandos-client.xml => plugins.d/password-request.xml
- 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,2009 Teddy Hogeborn
6
* Copyright © 2008,2009 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;
258
if(length>0 and buffer[length-1] == '\n'){
259
length--;
260
}
291
261
for(size_t written = 0; written < length; written += (size_t)ret){
292
262
ret = TEMP_FAILURE_RETRY(write(STDOUT_FILENO, buffer + written,
293
263
length - written));
310
280
}
311
281
free(plugin_node->environ);
312
282
free(plugin_node->buffer);
313
283
314
284
/* Removes the plugin from the singly-linked list */
315
285
if(plugin_node == plugin_list){
316
286
/* First one - simple */
344
314
struct stat st;
345
315
fd_set rfds_all;
346
316
int ret, maxfd = 0;
347
ssize_t sret;
348
317
uid_t uid = 65534;
349
318
gid_t gid = 65534;
350
319
bool debug = false;
359
328
sigemptyset(&sigchld_action.sa_mask);
360
329
ret = sigaddset(&sigchld_action.sa_mask, SIGCHLD);
361
330
if(ret == -1){
362
error(0, errno, "sigaddset");
363
exitstatus = EX_OSERR;
331
perror("sigaddset");
332
exitstatus = EXIT_FAILURE;
364
333
goto fallback;
365
334
}
366
335
ret = sigaction(SIGCHLD, &sigchld_action, &old_sigchld_action);
367
336
if(ret == -1){
368
error(0, errno, "sigaction");
369
exitstatus = EX_OSERR;
337
perror("sigaction");
338
exitstatus = EXIT_FAILURE;
370
339
goto fallback;
371
340
}
372
341
404
373
.doc = "Group ID the plugins will run as", .group = 3 },
405
374
{ .name = "debug", .key = 132,
406
375
.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
376
{ .name = NULL }
417
377
};
418
378
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;
379
error_t parse_opt (int key, char *arg, __attribute__((unused))
380
struct argp_state *state) {
381
switch (key) {
424
382
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;
383
if (arg != NULL){
384
char *p;
385
while((p = strsep(&arg, ",")) != NULL){
386
if(p[0] == '\0'){
387
continue;
388
}
389
if(not add_argument(getplugin(NULL), p)){
390
perror("add_argument");
391
return ARGP_ERR_UNKNOWN;
430
392
}
431
393
}
432
394
}
433
395
break;
434
396
case 'G': /* --global-env */
435
add_environment(getplugin(NULL), arg, true);
397
if(arg == NULL){
398
break;
399
}
400
{
401
char *envdef = strdup(arg);
402
if(envdef == NULL){
403
break;
404
}
405
if(not add_environment(getplugin(NULL), envdef, true)){
406
perror("add_environment");
407
}
408
}
436
409
break;
437
410
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;
411
if (arg != NULL){
412
char *p_name = strsep(&arg, ":");
413
if(p_name[0] == '\0' or arg == NULL){
414
break;
415
}
416
char *opt = strsep(&arg, ":");
417
if(opt[0] == '\0' or opt == NULL){
418
break;
419
}
420
char *p;
421
while((p = strsep(&opt, ",")) != NULL){
422
if(p[0] == '\0'){
423
continue;
424
}
425
if(not add_argument(getplugin(p_name), p)){
426
perror("add_argument");
427
return ARGP_ERR_UNKNOWN;
456
428
}
457
429
}
458
430
}
459
431
break;
460
432
case 'E': /* --env-for */
433
if(arg == NULL){
434
break;
435
}
461
436
{
462
437
char *envdef = strchr(arg, ':');
463
438
if(envdef == NULL){
464
argp_error(state, "No colon in \"%s\"", arg);
465
errno = EINVAL;
466
break;
467
}
468
*envdef = '\0';
439
break;
440
}
441
char *p_name = strndup(arg, (size_t) (envdef-arg));
442
if(p_name == NULL){
443
break;
444
}
469
445
envdef++;
470
if(arg[0] == '\0'){
471
argp_error(state, "Empty plugin name");
472
errno = EINVAL;
473
break;
446
if(not add_environment(getplugin(p_name), envdef, true)){
447
perror("add_environment");
474
448
}
475
add_environment(getplugin(arg), envdef, true);
476
449
}
477
450
break;
478
451
case 'd': /* --disable */
479
{
452
if (arg != NULL){
480
453
plugin *p = getplugin(arg);
481
if(p != NULL){
482
p->disabled = true;
454
if(p == NULL){
455
return ARGP_ERR_UNKNOWN;
483
456
}
457
p->disabled = true;
484
458
}
485
459
break;
486
460
case 'e': /* --enable */
487
{
461
if (arg != NULL){
488
462
plugin *p = getplugin(arg);
489
if(p != NULL){
490
p->disabled = false;
463
if(p == NULL){
464
return ARGP_ERR_UNKNOWN;
491
465
}
466
p->disabled = false;
492
467
}
493
468
break;
494
469
case 128: /* --plugin-dir */
495
free(plugindir);
496
470
plugindir = strdup(arg);
471
if(plugindir == NULL){
472
perror("strdup");
473
}
497
474
break;
498
475
case 129: /* --config-file */
499
476
/* This is already done by parse_opt_config_file() */
500
477
break;
501
478
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;
479
uid = (uid_t)strtol(arg, NULL, 10);
510
480
break;
511
481
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;
482
gid = (gid_t)strtol(arg, NULL, 10);
520
483
break;
521
484
case 132: /* --debug */
522
485
debug = true;
523
486
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
487
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
}
488
fprintf(stderr, "Ignoring unknown argument \"%s\"\n", arg);
489
break;
490
case ARGP_KEY_END:
491
break;
549
492
default:
550
493
return ARGP_ERR_UNKNOWN;
551
494
}
552
return errno; /* Set to 0 at start */
495
return 0;
553
496
}
554
497
555
498
/* This option parser is the same as parse_opt() above, except it
556
499
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){
500
error_t parse_opt_config_file (int key, char *arg,
501
__attribute__((unused))
502
struct argp_state *state) {
503
switch (key) {
562
504
case 'g': /* --global-options */
563
505
case 'G': /* --global-env */
564
506
case 'o': /* --options-for */
568
510
case 128: /* --plugin-dir */
569
511
break;
570
512
case 129: /* --config-file */
571
free(argfile);
572
513
argfile = strdup(arg);
573
break;
514
if(argfile == NULL){
515
perror("strdup");
516
}
517
break;
574
518
case 130: /* --userid */
575
519
case 131: /* --groupid */
576
520
case 132: /* --debug */
577
case '?': /* --help */
578
case -3: /* --usage */
579
case 'V': /* --version */
580
521
case ARGP_KEY_ARG:
522
case ARGP_KEY_END:
581
523
break;
582
524
default:
583
525
return ARGP_ERR_UNKNOWN;
584
526
}
585
return errno;
527
return 0;
586
528
}
587
529
588
530
struct argp argp = { .options = options,
590
532
.args_doc = "",
591
533
.doc = "Mandos plugin runner -- Run plugins" };
592
534
593
/* Parse using parse_opt_config_file() in order to get the custom
535
/* Parse using the parse_opt_config_file in order to get the custom
594
536
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;
537
ret = argp_parse (&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
538
if (ret == ARGP_ERR_UNKNOWN){
539
fprintf(stderr, "Unknown error while parsing arguments\n");
540
exitstatus = EXIT_FAILURE;
609
541
goto fallback;
610
542
}
611
543
613
545
argp.parser = parse_opt;
614
546
615
547
/* Open the configfile if available */
616
if(argfile == NULL){
548
if (argfile == NULL){
617
549
conffp = fopen(AFILE, "r");
618
550
} else {
619
551
conffp = fopen(argfile, "r");
620
}
552
}
621
553
if(conffp != NULL){
622
554
char *org_line = NULL;
623
555
char *p, *arg, *new_arg, *line;
624
556
size_t size = 0;
557
ssize_t sret;
625
558
const char whitespace_delims[] = " \r\t\f\v\n";
626
559
const char comment_delim[] = "#";
627
560
628
561
custom_argc = 1;
629
562
custom_argv = malloc(sizeof(char*) * 2);
630
563
if(custom_argv == NULL){
631
error(0, errno, "malloc");
632
exitstatus = EX_OSERR;
564
perror("malloc");
565
exitstatus = EXIT_FAILURE;
633
566
goto fallback;
634
567
}
635
568
custom_argv[0] = argv[0];
636
569
custom_argv[1] = NULL;
637
570
638
571
/* for each line in the config file, strip whitespace and ignore
639
572
commented text */
640
573
while(true){
642
575
if(sret == -1){
643
576
break;
644
577
}
645
578
646
579
line = org_line;
647
580
arg = strsep(&line, comment_delim);
648
581
while((p = strsep(&arg, whitespace_delims)) != NULL){
651
584
}
652
585
new_arg = strdup(p);
653
586
if(new_arg == NULL){
654
error(0, errno, "strdup");
655
exitstatus = EX_OSERR;
587
perror("strdup");
588
exitstatus = EXIT_FAILURE;
656
589
free(org_line);
657
590
goto fallback;
658
591
}
661
594
custom_argv = realloc(custom_argv, sizeof(char *)
662
595
* ((unsigned int) custom_argc + 1));
663
596
if(custom_argv == NULL){
664
error(0, errno, "realloc");
665
exitstatus = EX_OSERR;
597
perror("realloc");
598
exitstatus = EXIT_FAILURE;
666
599
free(org_line);
667
600
goto fallback;
668
601
}
669
602
custom_argv[custom_argc-1] = new_arg;
670
custom_argv[custom_argc] = NULL;
603
custom_argv[custom_argc] = NULL;
671
604
}
672
605
}
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
606
free(org_line);
682
607
} else {
683
608
/* Check for harmful errors and go to fallback. Other errors might
684
609
not affect opening plugins */
685
if(errno == EMFILE or errno == ENFILE or errno == ENOMEM){
686
error(0, errno, "fopen");
687
exitstatus = EX_OSERR;
610
if (errno == EMFILE or errno == ENFILE or errno == ENOMEM){
611
perror("fopen");
612
exitstatus = EXIT_FAILURE;
688
613
goto fallback;
689
614
}
690
615
}
691
/* If there were any arguments from the configuration file, pass
692
them to parser as command line arguments */
616
/* If there was any arguments from configuration file,
617
pass them to parser as command arguments */
693
618
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;
619
ret = argp_parse (&argp, custom_argc, custom_argv, ARGP_IN_ORDER,
620
0, NULL);
621
if (ret == ARGP_ERR_UNKNOWN){
622
fprintf(stderr, "Unknown error while parsing arguments\n");
623
exitstatus = EXIT_FAILURE;
708
624
goto fallback;
709
625
}
710
626
}
711
627
712
628
/* Parse actual command line arguments, to let them override the
713
629
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;
630
ret = argp_parse (&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
631
if (ret == ARGP_ERR_UNKNOWN){
632
fprintf(stderr, "Unknown error while parsing arguments\n");
633
exitstatus = EXIT_FAILURE;
728
634
goto fallback;
729
635
}
730
636
735
641
for(char **a = p->argv; *a != NULL; a++){
736
642
fprintf(stderr, "\tArg: %s\n", *a);
737
643
}
738
fprintf(stderr, "...and %d environment variables\n", p->envc);
644
fprintf(stderr, "...and %u environment variables\n", p->envc);
739
645
for(char **a = p->environ; *a != NULL; a++){
740
646
fprintf(stderr, "\t%s\n", *a);
741
647
}
743
649
}
744
650
745
651
/* Strip permissions down to nobody */
652
ret = setuid(uid);
653
if (ret == -1){
654
perror("setuid");
655
}
746
656
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 */
657
if (ret == -1){
658
perror("setgid");
659
}
660
661
if (plugindir == NULL){
662
dir = opendir(PDIR);
663
} else {
664
dir = opendir(plugindir);
665
}
666
667
if(dir == NULL){
668
perror("Could not open plugin dir");
669
exitstatus = EXIT_FAILURE;
670
goto fallback;
671
}
672
673
/* Set the FD_CLOEXEC flag on the directory, if possible */
756
674
{
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;
675
int dir_fd = dirfd(dir);
676
if(dir_fd >= 0){
677
ret = set_cloexec_flag(dir_fd);
678
if(ret < 0){
679
perror("set_cloexec_flag");
680
exitstatus = EXIT_FAILURE;
681
goto fallback;
682
}
798
683
}
799
684
}
800
685
802
687
803
688
/* Read and execute any executable in the plugin directory*/
804
689
while(true){
805
do {
806
dirst = readdir(dir);
807
} while(dirst == NULL and errno == EINTR);
690
dirst = readdir(dir);
808
691
809
692
/* All directory entries have been processed */
810
693
if(dirst == NULL){
811
if(errno == EBADF){
812
error(0, errno, "readdir");
813
exitstatus = EX_IOERR;
694
if (errno == EBADF){
695
perror("readdir");
696
exitstatus = EXIT_FAILURE;
814
697
goto fallback;
815
698
}
816
699
break;
826
709
827
710
const char const *bad_suffixes[] = { "~", "#", ".dpkg-new",
828
711
".dpkg-old",
829
".dpkg-bak",
830
712
".dpkg-divert", NULL };
831
713
for(const char **pre = bad_prefixes; *pre != NULL; pre++){
832
714
size_t pre_len = strlen(*pre);
846
728
for(const char **suf = bad_suffixes; *suf != NULL; suf++){
847
729
size_t suf_len = strlen(*suf);
848
730
if((d_name_len >= suf_len)
849
and (strcmp((dirst->d_name) + d_name_len-suf_len, *suf)
731
and (strcmp((dirst->d_name)+d_name_len-suf_len, *suf)
850
732
== 0)){
851
733
if(debug){
852
734
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
861
743
continue;
862
744
}
863
745
}
864
746
865
747
char *filename;
866
if(plugindir == NULL){
867
ret = (int)TEMP_FAILURE_RETRY(asprintf(&filename, PDIR "/%s",
868
dirst->d_name));
869
} else {
870
ret = (int)TEMP_FAILURE_RETRY(asprintf(&filename, "%s/%s",
871
plugindir,
872
dirst->d_name));
873
}
748
ret = asprintf(&filename, "%s/%s", plugindir, dirst->d_name);
874
749
if(ret < 0){
875
error(0, errno, "asprintf");
750
perror("asprintf");
876
751
continue;
877
752
}
878
753
879
ret = (int)TEMP_FAILURE_RETRY(stat(filename, &st));
880
if(ret == -1){
881
error(0, errno, "stat");
754
ret = stat(filename, &st);
755
if (ret == -1){
756
perror("stat");
882
757
free(filename);
883
758
continue;
884
759
}
885
760
886
761
/* Ignore non-executable files */
887
if(not S_ISREG(st.st_mode)
888
or (TEMP_FAILURE_RETRY(access(filename, X_OK)) != 0)){
762
if (not S_ISREG(st.st_mode) or (access(filename, X_OK) != 0)){
889
763
if(debug){
890
764
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
891
765
" with bad type or mode\n", filename);
896
770
897
771
plugin *p = getplugin(dirst->d_name);
898
772
if(p == NULL){
899
error(0, errno, "getplugin");
773
perror("getplugin");
900
774
free(filename);
901
775
continue;
902
776
}
914
788
if(g != NULL){
915
789
for(char **a = g->argv + 1; *a != NULL; a++){
916
790
if(not add_argument(p, *a)){
917
error(0, errno, "add_argument");
791
perror("add_argument");
918
792
}
919
793
}
920
794
/* Add global environment variables */
921
795
for(char **e = g->environ; *e != NULL; e++){
922
796
if(not add_environment(p, *e, false)){
923
error(0, errno, "add_environment");
797
perror("add_environment");
924
798
}
925
799
}
926
800
}
931
805
if(p->environ[0] != NULL){
932
806
for(char **e = environ; *e != NULL; e++){
933
807
if(not add_environment(p, *e, false)){
934
error(0, errno, "add_environment");
808
perror("add_environment");
935
809
}
936
810
}
937
811
}
938
812
939
813
int pipefd[2];
940
ret = (int)TEMP_FAILURE_RETRY(pipe(pipefd));
941
if(ret == -1){
942
error(0, errno, "pipe");
943
exitstatus = EX_OSERR;
814
ret = pipe(pipefd);
815
if (ret == -1){
816
perror("pipe");
817
exitstatus = EXIT_FAILURE;
944
818
goto fallback;
945
819
}
946
820
/* Ask OS to automatic close the pipe on exec */
947
821
ret = set_cloexec_flag(pipefd[0]);
948
822
if(ret < 0){
949
error(0, errno, "set_cloexec_flag");
950
exitstatus = EX_OSERR;
823
perror("set_cloexec_flag");
824
exitstatus = EXIT_FAILURE;
951
825
goto fallback;
952
826
}
953
827
ret = set_cloexec_flag(pipefd[1]);
954
828
if(ret < 0){
955
error(0, errno, "set_cloexec_flag");
956
exitstatus = EX_OSERR;
829
perror("set_cloexec_flag");
830
exitstatus = EXIT_FAILURE;
957
831
goto fallback;
958
832
}
959
833
/* 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));
834
ret = sigprocmask (SIG_BLOCK, &sigchld_action.sa_mask, NULL);
963
835
if(ret < 0){
964
error(0, errno, "sigprocmask");
965
exitstatus = EX_OSERR;
836
perror("sigprocmask");
837
exitstatus = EXIT_FAILURE;
966
838
goto fallback;
967
839
}
968
840
/* Starting a new process to be watched */
969
pid_t pid;
970
do {
971
pid = fork();
972
} while(pid == -1 and errno == EINTR);
841
pid_t pid = fork();
973
842
if(pid == -1){
974
error(0, errno, "fork");
975
exitstatus = EX_OSERR;
843
perror("fork");
844
exitstatus = EXIT_FAILURE;
976
845
goto fallback;
977
846
}
978
847
if(pid == 0){
979
848
/* this is the child process */
980
849
ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
981
850
if(ret < 0){
982
error(0, errno, "sigaction");
983
_exit(EX_OSERR);
851
perror("sigaction");
852
_exit(EXIT_FAILURE);
984
853
}
985
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
854
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
986
855
if(ret < 0){
987
error(0, errno, "sigprocmask");
988
_exit(EX_OSERR);
856
perror("sigprocmask");
857
_exit(EXIT_FAILURE);
989
858
}
990
859
991
860
ret = dup2(pipefd[1], STDOUT_FILENO); /* replace our stdout */
992
861
if(ret == -1){
993
error(0, errno, "dup2");
994
_exit(EX_OSERR);
862
perror("dup2");
863
_exit(EXIT_FAILURE);
995
864
}
996
865
997
866
if(dirfd(dir) < 0){
1001
870
}
1002
871
if(p->environ[0] == NULL){
1003
872
if(execv(filename, p->argv) < 0){
1004
error(0, errno, "execv");
1005
_exit(EX_OSERR);
873
perror("execv");
874
_exit(EXIT_FAILURE);
1006
875
}
1007
876
} else {
1008
877
if(execve(filename, p->argv, p->environ) < 0){
1009
error(0, errno, "execve");
1010
_exit(EX_OSERR);
878
perror("execve");
879
_exit(EXIT_FAILURE);
1011
880
}
1012
881
}
1013
882
/* no return */
1014
883
}
1015
884
/* Parent process */
1016
TEMP_FAILURE_RETRY(close(pipefd[1])); /* Close unused write end of
1017
pipe */
885
close(pipefd[1]); /* Close unused write end of pipe */
1018
886
free(filename);
1019
887
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)));
888
if (new_plugin == NULL){
889
perror("getplugin");
890
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1025
891
if(ret < 0){
1026
error(0, errno, "sigprocmask");
892
perror("sigprocmask");
1027
893
}
1028
exitstatus = EX_OSERR;
894
exitstatus = EXIT_FAILURE;
1029
895
goto fallback;
1030
896
}
1031
897
1034
900
1035
901
/* Unblock SIGCHLD so signal handler can be run if this process
1036
902
has already completed */
1037
ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1038
&sigchld_action.sa_mask,
1039
NULL));
903
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1040
904
if(ret < 0){
1041
error(0, errno, "sigprocmask");
1042
exitstatus = EX_OSERR;
905
perror("sigprocmask");
906
exitstatus = EXIT_FAILURE;
1043
907
goto fallback;
1044
908
}
1045
909
1046
FD_SET(new_plugin->fd, &rfds_all); /* Spurious warning from
1047
-Wconversion */
910
FD_SET(new_plugin->fd, &rfds_all);
1048
911
1049
if(maxfd < new_plugin->fd){
912
if (maxfd < new_plugin->fd){
1050
913
maxfd = new_plugin->fd;
1051
914
}
915
1052
916
}
1053
917
1054
TEMP_FAILURE_RETRY(closedir(dir));
918
closedir(dir);
1055
919
dir = NULL;
1056
free_plugin(getplugin(NULL));
1057
920
1058
921
for(plugin *p = plugin_list; p != NULL; p = p->next){
1059
922
if(p->pid != 0){
1060
923
break;
1065
928
free_plugin_list();
1066
929
}
1067
930
}
1068
931
1069
932
/* Main loop while running plugins exist */
1070
933
while(plugin_list){
1071
934
fd_set rfds = rfds_all;
1072
935
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;
936
if (select_ret == -1){
937
perror("select");
938
exitstatus = EXIT_FAILURE;
1076
939
goto fallback;
1077
940
}
1078
941
/* OK, now either a process completed, or something can be read
1079
942
from one of them */
1080
for(plugin *proc = plugin_list; proc != NULL;){
943
for(plugin *proc = plugin_list; proc != NULL; proc = proc->next){
1081
944
/* Is this process completely done? */
1082
if(proc->completed and proc->eof){
945
if(proc->eof and proc->completed){
1083
946
/* Only accept the plugin output if it exited cleanly */
1084
947
if(not WIFEXITED(proc->status)
1085
948
or WEXITSTATUS(proc->status) != 0){
1086
949
/* Bad exit by plugin */
1087
950
1088
951
if(debug){
1089
952
if(WIFEXITED(proc->status)){
1090
fprintf(stderr, "Plugin %s [%" PRIdMAX "] exited with"
1091
" status %d\n", proc->name,
1092
(intmax_t) (proc->pid),
953
fprintf(stderr, "Plugin %u exited with status %d\n",
954
(unsigned int) (proc->pid),
1093
955
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)));
956
} else if(WIFSIGNALED(proc->status)) {
957
fprintf(stderr, "Plugin %u killed by signal %d\n",
958
(unsigned int) (proc->pid),
959
WTERMSIG(proc->status));
1100
960
} else if(WCOREDUMP(proc->status)){
1101
fprintf(stderr, "Plugin %s [%" PRIdMAX "] dumped"
1102
" core\n", proc->name, (intmax_t) (proc->pid));
961
fprintf(stderr, "Plugin %d dumped core\n",
962
(unsigned int) (proc->pid));
1103
963
}
1104
964
}
1105
965
1106
966
/* Remove the plugin */
1107
FD_CLR(proc->fd, &rfds_all); /* Spurious warning from
1108
-Wconversion */
1109
967
FD_CLR(proc->fd, &rfds_all);
968
1110
969
/* Block signal while modifying process_list */
1111
ret = (int)TEMP_FAILURE_RETRY(sigprocmask
1112
(SIG_BLOCK,
1113
&sigchld_action.sa_mask,
1114
NULL));
970
ret = sigprocmask(SIG_BLOCK, &sigchld_action.sa_mask, NULL);
1115
971
if(ret < 0){
1116
error(0, errno, "sigprocmask");
1117
exitstatus = EX_OSERR;
972
perror("sigprocmask");
973
exitstatus = EXIT_FAILURE;
1118
974
goto fallback;
1119
975
}
1120
1121
plugin *next_plugin = proc->next;
1122
976
free_plugin(proc);
1123
proc = next_plugin;
1124
1125
977
/* 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)));
978
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask,
979
NULL);
1129
980
if(ret < 0){
1130
error(0, errno, "sigprocmask");
1131
exitstatus = EX_OSERR;
981
perror("sigprocmask");
982
exitstatus = EXIT_FAILURE;
1132
983
goto fallback;
1133
984
}
1134
985
1135
986
if(plugin_list == NULL){
1136
987
break;
1137
988
}
1138
1139
989
continue;
1140
990
}
1141
991
1142
992
/* This process exited nicely, so print its buffer */
1143
993
1144
994
bool bret = print_out_password(proc->buffer,
1145
995
proc->buffer_length);
1146
996
if(not bret){
1147
error(0, errno, "print_out_password");
1148
exitstatus = EX_IOERR;
997
perror("print_out_password");
998
exitstatus = EXIT_FAILURE;
1149
999
}
1150
1000
goto fallback;
1151
1001
}
1152
1002
1153
1003
/* 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 */
1004
if(proc->eof or not FD_ISSET(proc->fd, &rfds)){
1157
1005
/* This process had nothing to say at this time */
1158
proc = proc->next;
1159
1006
continue;
1160
1007
}
1161
1008
/* Before reading, make the process' data buffer large enough */
1162
1009
if(proc->buffer_length + BUFFER_SIZE > proc->buffer_size){
1163
1010
proc->buffer = realloc(proc->buffer, proc->buffer_size
1164
1011
+ (size_t) BUFFER_SIZE);
1165
if(proc->buffer == NULL){
1166
error(0, errno, "malloc");
1167
exitstatus = EX_OSERR;
1012
if (proc->buffer == NULL){
1013
perror("malloc");
1014
exitstatus = EXIT_FAILURE;
1168
1015
goto fallback;
1169
1016
}
1170
1017
proc->buffer_size += BUFFER_SIZE;
1171
1018
}
1172
1019
/* 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){
1020
ret = read(proc->fd, proc->buffer + proc->buffer_length,
1021
BUFFER_SIZE);
1022
if(ret < 0){
1178
1023
/* Read error from this process; ignore the error */
1179
proc = proc->next;
1180
1024
continue;
1181
1025
}
1182
if(sret == 0){
1026
if(ret == 0){
1183
1027
/* got EOF */
1184
1028
proc->eof = true;
1185
1029
} else {
1186
proc->buffer_length += (size_t) sret;
1030
proc->buffer_length += (size_t) ret;
1187
1031
}
1188
1032
}
1189
1033
}
1190
1191
1034
1035
1192
1036
fallback:
1193
1037
1194
if(plugin_list == NULL or (exitstatus != EXIT_SUCCESS
1195
and exitstatus != EX_OK)){
1038
if(plugin_list == NULL or exitstatus != EXIT_SUCCESS){
1196
1039
/* Fallback if all plugins failed, none are found or an error
1197
1040
occured */
1198
1041
bool bret;
1199
1042
fprintf(stderr, "Going to fallback mode using getpass(3)\n");
1200
1043
char *passwordbuffer = getpass("Password: ");
1201
size_t len = strlen(passwordbuffer);
1202
/* Strip trailing newline */
1203
if(len > 0 and passwordbuffer[len-1] == '\n'){
1204
passwordbuffer[len-1] = '\0'; /* not strictly necessary */
1205
len--;
1206
}
1207
bret = print_out_password(passwordbuffer, len);
1044
bret = print_out_password(passwordbuffer, strlen(passwordbuffer));
1208
1045
if(not bret){
1209
error(0, errno, "print_out_password");
1210
exitstatus = EX_IOERR;
1046
perror("print_out_password");
1047
exitstatus = EXIT_FAILURE;
1211
1048
}
1212
1049
}
1213
1050
1214
1051
/* Restore old signal handler */
1215
1052
ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1216
1053
if(ret == -1){
1217
error(0, errno, "sigaction");
1218
exitstatus = EX_OSERR;
1054
perror("sigaction");
1055
exitstatus = EXIT_FAILURE;
1219
1056
}
1220
1057
1221
1058
if(custom_argv != NULL){
1222
1059
for(char **arg = custom_argv+1; *arg != NULL; arg++){
1223
1060
free(*arg);
1229
1066
closedir(dir);
1230
1067
}
1231
1068
1232
/* Kill the processes */
1069
/* Free the process list and kill the processes */
1233
1070
for(plugin *p = plugin_list; p != NULL; p = p->next){
1234
1071
if(p->pid != 0){
1235
1072
close(p->fd);
1236
1073
ret = kill(p->pid, SIGTERM);
1237
1074
if(ret == -1 and errno != ESRCH){
1238
1075
/* Set-uid proccesses might not get closed */
1239
error(0, errno, "kill");
1076
perror("kill");
1240
1077
}
1241
1078
}
1242
1079
}
1243
1080
1244
1081
/* Wait for any remaining child processes to terminate */
1245
do {
1082
do{
1246
1083
ret = wait(NULL);
1247
1084
} while(ret >= 0);
1248
1085
if(errno != ECHILD){
1249
error(0, errno, "wait");
1086
perror("wait");
1250
1087
}
1251
1088
1252
1089
free_plugin_list();
1253
1090
1254
1091
free(plugindir);
Loggerhead is a web-based interface for Breezy
Version: 2.0.2.dev0