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