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 275
- compare with another revision
- download diff
- download tarball
- view history from revision 275
- Committer: Teddy Hogeborn
- Date: 2009-01-18 00:16:57 UTC
- Revision ID: teddy@fukt.bsnet.se-20090118001657-6mo3ae73ldy5tegf
* debian/mandos-client.postinst: Converted to Bourne shell. Also
minor message change.
* debian/mandos-client.postrm: Minor message change.
* debian/mandos.postinst: Converted to Bourne shell. Also minor
message change.
* debian/mandos.prerm: Minor message change.
minor message change.
* debian/mandos-client.postrm: Minor message change.
* debian/mandos.postinst: Converted to Bourne shell. Also minor
message change.
* debian/mandos.prerm: Minor message change.
- files added:
- .bzr-builddeb
- debian
- debian/po
- files removed:
- network-protocol.txt
- files renamed:
- mandos-client.c => plugin-runner.c
- mandos-client.xml => plugin-runner.xml
- plugins.d/password-request.c => plugins.d/mandos-client.c
- plugins.d/password-request.xml => plugins.d/mandos-client.xml
- files modified:
- Makefile
added
removed
plugin-runner.c
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,2009 Teddy Hogeborn
6
* Copyright © 2008,2009 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
21
22
* Contact the authors at <mandos@fukt.bsnet.se>.
22
23
*/
23
24
24
#define _GNU_SOURCE /* TEMP_FAILURE_RETRY() */
25
26
#include <stdio.h> /* popen(), fileno(), fprintf(),
25
#define _GNU_SOURCE /* TEMP_FAILURE_RETRY(), getline(),
26
asprintf() */
27
#include <stddef.h> /* size_t, NULL */
28
#include <stdlib.h> /* malloc(), exit(), EXIT_FAILURE,
29
EXIT_SUCCESS, realloc() */
30
#include <stdbool.h> /* bool, true, false */
31
#include <stdio.h> /* perror, fileno(), fprintf(),
27
32
stderr, STDOUT_FILENO */
33
#include <sys/types.h> /* DIR, opendir(), stat(), struct
34
stat, waitpid(), WIFEXITED(),
35
WEXITSTATUS(), wait(), pid_t,
36
uid_t, gid_t, getuid(), getgid(),
37
dirfd() */
38
#include <sys/select.h> /* fd_set, select(), FD_ZERO(),
39
FD_SET(), FD_ISSET(), FD_CLR */
40
#include <sys/wait.h> /* wait(), waitpid(), WIFEXITED(),
41
WEXITSTATUS() */
42
#include <sys/stat.h> /* struct stat, stat(), S_ISREG() */
28
43
#include <iso646.h> /* and, or, not */
29
#include <sys/types.h> /* DIR, opendir(), stat(),
30
struct stat, waitpid(),
31
WIFEXITED(), WEXITSTATUS(),
32
wait() */
33
#include <sys/wait.h> /* wait() */
34
44
#include <dirent.h> /* DIR, struct dirent, opendir(),
35
readdir(), closedir() */
36
#include <sys/stat.h> /* struct stat, stat(), S_ISREG() */
45
readdir(), closedir(), dirfd() */
37
46
#include <unistd.h> /* struct stat, stat(), S_ISREG(),
38
fcntl() */
39
#include <fcntl.h> /* fcntl() */
40
#include <stddef.h> /* NULL */
41
#include <stdlib.h> /* EXIT_FAILURE */
42
#include <sys/select.h> /* fd_set, select(), FD_ZERO(),
43
FD_SET(), FD_ISSET() */
44
#include <string.h> /* strlen(), strcpy(), strcat() */
45
#include <stdbool.h> /* true */
46
#include <sys/wait.h> /* waitpid(), WIFEXITED(),
47
WEXITSTATUS() */
47
fcntl(), setuid(), setgid(),
48
F_GETFD, F_SETFD, FD_CLOEXEC,
49
access(), pipe(), fork(), close()
50
dup2(), STDOUT_FILENO, _exit(),
51
execv(), write(), read(),
52
close() */
53
#include <fcntl.h> /* fcntl(), F_GETFD, F_SETFD,
54
FD_CLOEXEC */
55
#include <string.h> /* strsep, strlen(), asprintf() */
48
56
#include <errno.h> /* errno */
49
#include <argp.h> /* struct argp_option,
50
struct argp_state, struct argp,
51
argp_parse() */
57
#include <argp.h> /* struct argp_option, struct
58
argp_state, struct argp,
59
argp_parse(), ARGP_ERR_UNKNOWN,
60
ARGP_KEY_END, ARGP_KEY_ARG,
61
error_t */
62
#include <signal.h> /* struct sigaction, sigemptyset(),
63
sigaddset(), sigaction(),
64
sigprocmask(), SIG_BLOCK, SIGCHLD,
65
SIG_UNBLOCK, kill() */
66
#include <errno.h> /* errno, EBADF */
67
#include <inttypes.h> /* intmax_t, SCNdMAX, PRIdMAX, */
52
68
53
69
#define BUFFER_SIZE 256
54
70
55
struct process;
56
57
typedef struct process{
71
#define PDIR "/lib/mandos/plugins.d"
72
#define AFILE "/conf/conf.d/mandos/plugin-runner.conf"
73
74
const char *argp_program_version = "plugin-runner " VERSION;
75
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
76
77
typedef struct plugin{
78
char *name; /* can be NULL or any plugin name */
79
char **argv;
80
int argc;
81
char **environ;
82
int envc;
83
bool disabled;
84
85
/* Variables used for running processes*/
58
86
pid_t pid;
59
87
int fd;
60
88
char *buffer;
61
89
size_t buffer_size;
62
90
size_t buffer_length;
63
91
bool eof;
64
bool completed;
65
int status;
66
struct process *next;
67
} process;
68
69
typedef struct plugin{
70
char *name; /* can be NULL or any plugin name */
71
char **argv;
72
int argc;
73
bool disabled;
92
volatile bool completed;
93
volatile int status;
74
94
struct plugin *next;
75
95
} plugin;
76
96
77
static plugin *getplugin(char *name, plugin **plugin_list){
78
for (plugin *p = *plugin_list; p != NULL; p = p->next){
79
if ((p->name == name)
80
or (p->name and name and (strcmp(p->name, name) == 0))){
97
static plugin *plugin_list = NULL;
98
99
/* Gets an existing plugin based on name,
100
or if none is found, creates a new one */
101
static plugin *getplugin(char *name){
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))){
81
106
return p;
82
107
}
83
108
}
84
109
/* Create a new plugin */
85
110
plugin *new_plugin = malloc(sizeof(plugin));
86
if (new_plugin == NULL){
87
perror("malloc");
88
exit(EXIT_FAILURE);
89
}
90
new_plugin->name = name;
111
if(new_plugin == NULL){
112
return NULL;
113
}
114
char *copy_name = NULL;
115
if(name != NULL){
116
copy_name = strdup(name);
117
if(copy_name == NULL){
118
free(new_plugin);
119
return NULL;
120
}
121
}
122
123
*new_plugin = (plugin) { .name = copy_name,
124
.argc = 1,
125
.disabled = false,
126
.next = plugin_list };
127
91
128
new_plugin->argv = malloc(sizeof(char *) * 2);
92
if (new_plugin->argv == NULL){
93
perror("malloc");
94
exit(EXIT_FAILURE);
129
if(new_plugin->argv == NULL){
130
free(copy_name);
131
free(new_plugin);
132
return NULL;
95
133
}
96
new_plugin->argv[0] = name;
134
new_plugin->argv[0] = copy_name;
97
135
new_plugin->argv[1] = NULL;
98
new_plugin->argc = 1;
99
new_plugin->disabled = false;
100
new_plugin->next = *plugin_list;
136
137
new_plugin->environ = malloc(sizeof(char *));
138
if(new_plugin->environ == NULL){
139
free(copy_name);
140
free(new_plugin->argv);
141
free(new_plugin);
142
return NULL;
143
}
144
new_plugin->environ[0] = NULL;
145
101
146
/* Append the new plugin to the list */
102
*plugin_list = new_plugin;
147
plugin_list = new_plugin;
103
148
return new_plugin;
104
149
}
105
150
106
static void addargument(plugin *p, char *arg){
107
p->argv[p->argc] = arg;
108
p->argv = realloc(p->argv, sizeof(char *) * (size_t)(p->argc + 2));
109
if (p->argv == NULL){
110
perror("malloc");
111
exit(EXIT_FAILURE);
112
}
113
p->argc++;
114
p->argv[p->argc] = NULL;
151
/* Helper function for add_argument and add_environment */
152
static bool add_to_char_array(const char *new, char ***array,
153
int *len){
154
/* Resize the pointed-to array to hold one more pointer */
155
*array = realloc(*array, sizeof(char *)
156
* (size_t) ((*len) + 2));
157
/* Malloc check */
158
if(*array == NULL){
159
return false;
160
}
161
/* Make a copy of the new string */
162
char *copy = strdup(new);
163
if(copy == NULL){
164
return false;
165
}
166
/* Insert the copy */
167
(*array)[*len] = copy;
168
(*len)++;
169
/* Add a new terminating NULL pointer to the last element */
170
(*array)[*len] = NULL;
171
return true;
172
}
173
174
/* Add to a plugin's argument vector */
175
static bool add_argument(plugin *p, const char *arg){
176
if(p == NULL){
177
return false;
178
}
179
return add_to_char_array(arg, &(p->argv), &(p->argc));
180
}
181
182
/* Add to a plugin's environment */
183
static bool add_environment(plugin *p, const char *def, bool replace){
184
if(p == NULL){
185
return false;
186
}
187
/* namelen = length of name of environment variable */
188
size_t namelen = (size_t)(strchrnul(def, '=') - def);
189
/* Search for this environment variable */
190
for(char **e = p->environ; *e != NULL; e++){
191
if(strncmp(*e, def, namelen + 1) == 0){
192
/* It already exists */
193
if(replace){
194
char *new = realloc(*e, strlen(def) + 1);
195
if(new == NULL){
196
return false;
197
}
198
*e = new;
199
strcpy(*e, def);
200
}
201
return true;
202
}
203
}
204
return add_to_char_array(def, &(p->environ), &(p->envc));
115
205
}
116
206
117
207
/*
119
209
* Descriptor Flags".
120
210
* *Note File Descriptor Flags:(libc)Descriptor Flags.
121
211
*/
122
static int set_cloexec_flag(int fd)
123
{
212
static int set_cloexec_flag(int fd){
124
213
int ret = fcntl(fd, F_GETFD, 0);
125
214
/* If reading the flags failed, return error indication now. */
126
215
if(ret < 0){
130
219
return fcntl(fd, F_SETFD, ret | FD_CLOEXEC);
131
220
}
132
221
133
const char *argp_program_version = "plugbasedclient 0.9";
134
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
135
136
process *process_list = NULL;
137
138
/* Mark a process as completed when it exits, and save its exit
222
223
/* Mark processes as completed when they exit, and save their exit
139
224
status. */
140
void handle_sigchld(__attribute__((unused)) int sig){
141
process *proc = process_list;
142
int status;
143
pid_t pid = wait(&status);
144
while(proc != NULL and proc->pid != pid){
145
proc = proc->next;
146
}
147
if(proc == NULL){
148
/* Process not found in process list */
149
return;
150
}
151
proc->status = status;
152
proc->completed = true;
225
static void handle_sigchld(__attribute__((unused)) int sig){
226
while(true){
227
plugin *proc = plugin_list;
228
int status;
229
pid_t pid = waitpid(-1, &status, WNOHANG);
230
if(pid == 0){
231
/* Only still running child processes */
232
break;
233
}
234
if(pid == -1){
235
if(errno != ECHILD){
236
perror("waitpid");
237
}
238
/* No child processes */
239
break;
240
}
241
242
/* A child exited, find it in process_list */
243
while(proc != NULL and proc->pid != pid){
244
proc = proc->next;
245
}
246
if(proc == NULL){
247
/* Process not found in process list */
248
continue;
249
}
250
proc->status = status;
251
proc->completed = true;
252
}
253
}
254
255
/* Prints out a password to stdout */
256
static bool print_out_password(const char *buffer, size_t length){
257
ssize_t ret;
258
for(size_t written = 0; written < length; written += (size_t)ret){
259
ret = TEMP_FAILURE_RETRY(write(STDOUT_FILENO, buffer + written,
260
length - written));
261
if(ret < 0){
262
return false;
263
}
264
}
265
return true;
266
}
267
268
/* Removes and free a plugin from the plugin list */
269
static void free_plugin(plugin *plugin_node){
270
271
for(char **arg = plugin_node->argv; *arg != NULL; arg++){
272
free(*arg);
273
}
274
free(plugin_node->argv);
275
for(char **env = plugin_node->environ; *env != NULL; env++){
276
free(*env);
277
}
278
free(plugin_node->environ);
279
free(plugin_node->buffer);
280
281
/* Removes the plugin from the singly-linked list */
282
if(plugin_node == plugin_list){
283
/* First one - simple */
284
plugin_list = plugin_list->next;
285
} else {
286
/* Second one or later */
287
for(plugin *p = plugin_list; p != NULL; p = p->next){
288
if(p->next == plugin_node){
289
p->next = plugin_node->next;
290
break;
291
}
292
}
293
}
294
295
free(plugin_node);
296
}
297
298
static void free_plugin_list(void){
299
while(plugin_list != NULL){
300
free_plugin(plugin_list);
301
}
153
302
}
154
303
155
304
int main(int argc, char *argv[]){
156
const char *plugindir = "/conf/conf.d/mandos/plugins.d";
305
char *plugindir = NULL;
306
char *argfile = NULL;
307
FILE *conffp;
157
308
size_t d_name_len;
158
309
DIR *dir = NULL;
159
310
struct dirent *dirst;
160
311
struct stat st;
161
312
fd_set rfds_all;
162
int ret, maxfd = 0;
313
int ret, numchars, maxfd = 0;
314
ssize_t sret;
315
intmax_t tmpmax;
163
316
uid_t uid = 65534;
164
317
gid_t gid = 65534;
165
318
bool debug = false;
167
320
struct sigaction old_sigchld_action;
168
321
struct sigaction sigchld_action = { .sa_handler = handle_sigchld,
169
322
.sa_flags = SA_NOCLDSTOP };
170
char *plus_options = NULL;
171
char **plus_argv = NULL;
323
char **custom_argv = NULL;
324
int custom_argc = 0;
172
325
173
326
/* Establish a signal handler */
174
327
sigemptyset(&sigchld_action.sa_mask);
175
328
ret = sigaddset(&sigchld_action.sa_mask, SIGCHLD);
176
if(ret < 0){
329
if(ret == -1){
177
330
perror("sigaddset");
178
exit(EXIT_FAILURE);
331
exitstatus = EXIT_FAILURE;
332
goto fallback;
179
333
}
180
334
ret = sigaction(SIGCHLD, &sigchld_action, &old_sigchld_action);
181
if(ret < 0){
335
if(ret == -1){
182
336
perror("sigaction");
183
exit(EXIT_FAILURE);
337
exitstatus = EXIT_FAILURE;
338
goto fallback;
184
339
}
185
340
186
341
/* The options we understand. */
188
343
{ .name = "global-options", .key = 'g',
189
344
.arg = "OPTION[,OPTION[,...]]",
190
345
.doc = "Options passed to all plugins" },
346
{ .name = "global-env", .key = 'G',
347
.arg = "VAR=value",
348
.doc = "Environment variable passed to all plugins" },
191
349
{ .name = "options-for", .key = 'o',
192
350
.arg = "PLUGIN:OPTION[,OPTION[,...]]",
193
351
.doc = "Options passed only to specified plugin" },
352
{ .name = "env-for", .key = 'E',
353
.arg = "PLUGIN:ENV=value",
354
.doc = "Environment variable passed to specified plugin" },
194
355
{ .name = "disable", .key = 'd',
195
356
.arg = "PLUGIN",
196
357
.doc = "Disable a specific plugin", .group = 1 },
358
{ .name = "enable", .key = 'e',
359
.arg = "PLUGIN",
360
.doc = "Enable a specific plugin", .group = 1 },
197
361
{ .name = "plugin-dir", .key = 128,
198
362
.arg = "DIRECTORY",
199
363
.doc = "Specify a different plugin directory", .group = 2 },
200
{ .name = "userid", .key = 129,
201
.arg = "ID", .flags = 0,
202
.doc = "User ID the plugins will run as", .group = 2 },
203
{ .name = "groupid", .key = 130,
204
.arg = "ID", .flags = 0,
205
.doc = "Group ID the plugins will run as", .group = 2 },
206
{ .name = "debug", .key = 131,
207
.doc = "Debug mode", .group = 3 },
364
{ .name = "config-file", .key = 129,
365
.arg = "FILE",
366
.doc = "Specify a different configuration file", .group = 2 },
367
{ .name = "userid", .key = 130,
368
.arg = "ID", .flags = 0,
369
.doc = "User ID the plugins will run as", .group = 3 },
370
{ .name = "groupid", .key = 131,
371
.arg = "ID", .flags = 0,
372
.doc = "Group ID the plugins will run as", .group = 3 },
373
{ .name = "debug", .key = 132,
374
.doc = "Debug mode", .group = 4 },
208
375
{ .name = NULL }
209
376
};
210
377
211
error_t parse_opt (int key, char *arg, struct argp_state *state) {
212
/* Get the INPUT argument from `argp_parse', which we know is a
213
pointer to our plugin list pointer. */
214
plugin **plugins = state->input;
215
switch (key) {
216
case 'g':
217
if (arg != NULL){
218
char *p = strtok(arg, ",");
219
do{
220
addargument(getplugin(NULL, plugins), p);
221
p = strtok(NULL, ",");
222
} while (p != NULL);
223
}
224
break;
225
case 'o':
226
if (arg != NULL){
227
char *name = strtok(arg, ":");
228
char *p = strtok(NULL, ":");
229
if(p != NULL){
230
p = strtok(p, ",");
231
do{
232
addargument(getplugin(name, plugins), p);
233
p = strtok(NULL, ",");
234
} while (p != NULL);
235
}
236
}
237
break;
238
case 'd':
239
if (arg != NULL){
240
getplugin(arg, plugins)->disabled = true;
241
}
242
break;
243
case 128:
244
plugindir = arg;
245
break;
246
case 129:
247
uid = (uid_t)strtol(arg, NULL, 10);
248
break;
249
case 130:
250
gid = (gid_t)strtol(arg, NULL, 10);
251
break;
252
case 131:
378
error_t parse_opt(int key, char *arg, __attribute__((unused))
379
struct argp_state *state) {
380
switch(key) {
381
case 'g': /* --global-options */
382
if(arg != NULL){
383
char *p;
384
while((p = strsep(&arg, ",")) != NULL){
385
if(p[0] == '\0'){
386
continue;
387
}
388
if(not add_argument(getplugin(NULL), p)){
389
perror("add_argument");
390
return ARGP_ERR_UNKNOWN;
391
}
392
}
393
}
394
break;
395
case 'G': /* --global-env */
396
if(arg == NULL){
397
break;
398
}
399
if(not add_environment(getplugin(NULL), arg, true)){
400
perror("add_environment");
401
}
402
break;
403
case 'o': /* --options-for */
404
if(arg != NULL){
405
char *p_name = strsep(&arg, ":");
406
if(p_name[0] == '\0' or arg == NULL){
407
break;
408
}
409
char *opt = strsep(&arg, ":");
410
if(opt[0] == '\0' or opt == NULL){
411
break;
412
}
413
char *p;
414
while((p = strsep(&opt, ",")) != NULL){
415
if(p[0] == '\0'){
416
continue;
417
}
418
if(not add_argument(getplugin(p_name), p)){
419
perror("add_argument");
420
return ARGP_ERR_UNKNOWN;
421
}
422
}
423
}
424
break;
425
case 'E': /* --env-for */
426
if(arg == NULL){
427
break;
428
}
429
{
430
char *envdef = strchr(arg, ':');
431
if(envdef == NULL){
432
break;
433
}
434
*envdef = '\0';
435
if(not add_environment(getplugin(arg), envdef+1, true)){
436
perror("add_environment");
437
}
438
}
439
break;
440
case 'd': /* --disable */
441
if(arg != NULL){
442
plugin *p = getplugin(arg);
443
if(p == NULL){
444
return ARGP_ERR_UNKNOWN;
445
}
446
p->disabled = true;
447
}
448
break;
449
case 'e': /* --enable */
450
if(arg != NULL){
451
plugin *p = getplugin(arg);
452
if(p == NULL){
453
return ARGP_ERR_UNKNOWN;
454
}
455
p->disabled = false;
456
}
457
break;
458
case 128: /* --plugin-dir */
459
free(plugindir);
460
plugindir = strdup(arg);
461
if(plugindir == NULL){
462
perror("strdup");
463
}
464
break;
465
case 129: /* --config-file */
466
/* This is already done by parse_opt_config_file() */
467
break;
468
case 130: /* --userid */
469
ret = sscanf(arg, "%" SCNdMAX "%n", &tmpmax, &numchars);
470
if(ret < 1 or tmpmax != (uid_t)tmpmax
471
or arg[numchars] != '\0'){
472
fprintf(stderr, "Bad user ID number: \"%s\", using %"
473
PRIdMAX "\n", arg, (intmax_t)uid);
474
} else {
475
uid = (uid_t)tmpmax;
476
}
477
break;
478
case 131: /* --groupid */
479
ret = sscanf(arg, "%" SCNdMAX "%n", &tmpmax, &numchars);
480
if(ret < 1 or tmpmax != (gid_t)tmpmax
481
or arg[numchars] != '\0'){
482
fprintf(stderr, "Bad group ID number: \"%s\", using %"
483
PRIdMAX "\n", arg, (intmax_t)gid);
484
} else {
485
gid = (gid_t)tmpmax;
486
}
487
break;
488
case 132: /* --debug */
253
489
debug = true;
254
490
break;
255
case ARGP_KEY_ARG:
256
if(plus_options != NULL or arg == NULL or arg[0] != '+'){
257
argp_usage (state);
258
}
259
plus_options = arg;
260
break;
261
case ARGP_KEY_END:
262
break;
263
default:
264
return ARGP_ERR_UNKNOWN;
265
}
266
return 0;
267
}
268
269
plugin *plugin_list = NULL;
270
271
struct argp argp = { .options = options, .parser = parse_opt,
272
.args_doc = "[+PLUS_SEPARATED_OPTIONS]",
491
/*
492
* When adding more options before this line, remember to also add a
493
* "case" to the "parse_opt_config_file" function below.
494
*/
495
case ARGP_KEY_ARG:
496
/* Cryptsetup always passes an argument, which is an empty
497
string if "none" was specified in /etc/crypttab. So if
498
argument was empty, we ignore it silently. */
499
if(arg[0] != '\0'){
500
fprintf(stderr, "Ignoring unknown argument \"%s\"\n", arg);
501
}
502
break;
503
case ARGP_KEY_END:
504
break;
505
default:
506
return ARGP_ERR_UNKNOWN;
507
}
508
return 0;
509
}
510
511
/* This option parser is the same as parse_opt() above, except it
512
ignores everything but the --config-file option. */
513
error_t parse_opt_config_file(int key, char *arg,
514
__attribute__((unused))
515
struct argp_state *state) {
516
switch(key) {
517
case 'g': /* --global-options */
518
case 'G': /* --global-env */
519
case 'o': /* --options-for */
520
case 'E': /* --env-for */
521
case 'd': /* --disable */
522
case 'e': /* --enable */
523
case 128: /* --plugin-dir */
524
break;
525
case 129: /* --config-file */
526
free(argfile);
527
argfile = strdup(arg);
528
if(argfile == NULL){
529
perror("strdup");
530
}
531
break;
532
case 130: /* --userid */
533
case 131: /* --groupid */
534
case 132: /* --debug */
535
case ARGP_KEY_ARG:
536
case ARGP_KEY_END:
537
break;
538
default:
539
return ARGP_ERR_UNKNOWN;
540
}
541
return 0;
542
}
543
544
struct argp argp = { .options = options,
545
.parser = parse_opt_config_file,
546
.args_doc = "",
273
547
.doc = "Mandos plugin runner -- Run plugins" };
274
548
275
argp_parse (&argp, argc, argv, 0, 0, &plugin_list);
276
277
if(plus_options){
278
/* This is a mangled argument in the form of
279
"+--option+--other-option=parameter+--yet-another-option", etc */
280
/* Make new argc and argv vars, and call argp_parse() again. */
281
plus_options++; /* skip the first '+' character */
282
const char delims[] = "+";
283
char *arg;
284
int new_argc = 1;
285
plus_argv = malloc(sizeof(char*) * 2);
286
if(plus_argv == NULL){
549
/* Parse using parse_opt_config_file() in order to get the custom
550
config file location, if any. */
551
ret = argp_parse(&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
552
if(ret == ARGP_ERR_UNKNOWN){
553
fprintf(stderr, "Unknown error while parsing arguments\n");
554
exitstatus = EXIT_FAILURE;
555
goto fallback;
556
}
557
558
/* Reset to the normal argument parser */
559
argp.parser = parse_opt;
560
561
/* Open the configfile if available */
562
if(argfile == NULL){
563
conffp = fopen(AFILE, "r");
564
} else {
565
conffp = fopen(argfile, "r");
566
}
567
if(conffp != NULL){
568
char *org_line = NULL;
569
char *p, *arg, *new_arg, *line;
570
size_t size = 0;
571
const char whitespace_delims[] = " \r\t\f\v\n";
572
const char comment_delim[] = "#";
573
574
custom_argc = 1;
575
custom_argv = malloc(sizeof(char*) * 2);
576
if(custom_argv == NULL){
287
577
perror("malloc");
288
578
exitstatus = EXIT_FAILURE;
289
goto end;
290
}
291
plus_argv[0] = argv[0];
292
plus_argv[1] = NULL;
293
arg = strtok(plus_options, delims); /* Get first argument */
294
while(arg != NULL){
295
new_argc++;
296
plus_argv = realloc(plus_argv, sizeof(char *)
297
* ((unsigned int) new_argc + 1));
298
if(plus_argv == NULL){
299
perror("malloc");
300
exitstatus = EXIT_FAILURE;
301
goto end;
302
}
303
plus_argv[new_argc-1] = arg;
304
plus_argv[new_argc] = NULL;
305
arg = strtok(NULL, delims); /* Get next argument */
306
}
307
argp_parse (&argp, new_argc, plus_argv, 0, 0, &plugin_list);
579
goto fallback;
580
}
581
custom_argv[0] = argv[0];
582
custom_argv[1] = NULL;
583
584
/* for each line in the config file, strip whitespace and ignore
585
commented text */
586
while(true){
587
sret = getline(&org_line, &size, conffp);
588
if(sret == -1){
589
break;
590
}
591
592
line = org_line;
593
arg = strsep(&line, comment_delim);
594
while((p = strsep(&arg, whitespace_delims)) != NULL){
595
if(p[0] == '\0'){
596
continue;
597
}
598
new_arg = strdup(p);
599
if(new_arg == NULL){
600
perror("strdup");
601
exitstatus = EXIT_FAILURE;
602
free(org_line);
603
goto fallback;
604
}
605
606
custom_argc += 1;
607
custom_argv = realloc(custom_argv, sizeof(char *)
608
* ((unsigned int) custom_argc + 1));
609
if(custom_argv == NULL){
610
perror("realloc");
611
exitstatus = EXIT_FAILURE;
612
free(org_line);
613
goto fallback;
614
}
615
custom_argv[custom_argc-1] = new_arg;
616
custom_argv[custom_argc] = NULL;
617
}
618
}
619
free(org_line);
620
} else {
621
/* Check for harmful errors and go to fallback. Other errors might
622
not affect opening plugins */
623
if(errno == EMFILE or errno == ENFILE or errno == ENOMEM){
624
perror("fopen");
625
exitstatus = EXIT_FAILURE;
626
goto fallback;
627
}
628
}
629
/* If there was any arguments from configuration file,
630
pass them to parser as command arguments */
631
if(custom_argv != NULL){
632
ret = argp_parse(&argp, custom_argc, custom_argv, ARGP_IN_ORDER,
633
0, NULL);
634
if(ret == ARGP_ERR_UNKNOWN){
635
fprintf(stderr, "Unknown error while parsing arguments\n");
636
exitstatus = EXIT_FAILURE;
637
goto fallback;
638
}
639
}
640
641
/* Parse actual command line arguments, to let them override the
642
config file */
643
ret = argp_parse(&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
644
if(ret == ARGP_ERR_UNKNOWN){
645
fprintf(stderr, "Unknown error while parsing arguments\n");
646
exitstatus = EXIT_FAILURE;
647
goto fallback;
308
648
}
309
649
310
650
if(debug){
314
654
for(char **a = p->argv; *a != NULL; a++){
315
655
fprintf(stderr, "\tArg: %s\n", *a);
316
656
}
657
fprintf(stderr, "...and %d environment variables\n", p->envc);
658
for(char **a = p->environ; *a != NULL; a++){
659
fprintf(stderr, "\t%s\n", *a);
660
}
317
661
}
318
662
}
319
663
664
/* Strip permissions down to nobody */
320
665
ret = setuid(uid);
321
if (ret == -1){
666
if(ret == -1){
322
667
perror("setuid");
323
}
324
668
}
325
669
setgid(gid);
326
if (ret == -1){
670
if(ret == -1){
327
671
perror("setgid");
328
672
}
329
673
330
dir = opendir(plugindir);
674
if(plugindir == NULL){
675
dir = opendir(PDIR);
676
} else {
677
dir = opendir(plugindir);
678
}
679
331
680
if(dir == NULL){
332
681
perror("Could not open plugin dir");
333
682
exitstatus = EXIT_FAILURE;
334
goto end;
683
goto fallback;
335
684
}
336
685
337
686
/* Set the FD_CLOEXEC flag on the directory, if possible */
342
691
if(ret < 0){
343
692
perror("set_cloexec_flag");
344
693
exitstatus = EXIT_FAILURE;
345
goto end;
694
goto fallback;
346
695
}
347
696
}
348
697
}
349
698
350
699
FD_ZERO(&rfds_all);
351
700
701
/* Read and execute any executable in the plugin directory*/
352
702
while(true){
353
703
dirst = readdir(dir);
354
704
355
// All directory entries have been processed
705
/* All directory entries have been processed */
356
706
if(dirst == NULL){
707
if(errno == EBADF){
708
perror("readdir");
709
exitstatus = EXIT_FAILURE;
710
goto fallback;
711
}
357
712
break;
358
713
}
359
714
360
715
d_name_len = strlen(dirst->d_name);
361
716
362
// Ignore dotfiles, backup files and other junk
717
/* Ignore dotfiles, backup files and other junk */
363
718
{
364
719
bool bad_name = false;
365
720
367
722
368
723
const char const *bad_suffixes[] = { "~", "#", ".dpkg-new",
369
724
".dpkg-old",
725
".dpkg-bak",
370
726
".dpkg-divert", NULL };
371
727
for(const char **pre = bad_prefixes; *pre != NULL; pre++){
372
728
size_t pre_len = strlen(*pre);
380
736
break;
381
737
}
382
738
}
383
384
739
if(bad_name){
385
740
continue;
386
741
}
387
388
742
for(const char **suf = bad_suffixes; *suf != NULL; suf++){
389
743
size_t suf_len = strlen(*suf);
390
744
if((d_name_len >= suf_len)
403
757
continue;
404
758
}
405
759
}
406
407
char *filename = malloc(d_name_len + strlen(plugindir) + 2);
408
if (filename == NULL){
409
perror("malloc");
410
exitstatus = EXIT_FAILURE;
411
goto end;
412
}
413
strcpy(filename, plugindir); /* Spurious warning */
414
strcat(filename, "/"); /* Spurious warning */
415
strcat(filename, dirst->d_name); /* Spurious warning */
416
417
stat(filename, &st);
418
419
if (not S_ISREG(st.st_mode) or (access(filename, X_OK) != 0)){
760
761
char *filename;
762
if(plugindir == NULL){
763
ret = asprintf(&filename, PDIR "/%s", dirst->d_name);
764
} else {
765
ret = asprintf(&filename, "%s/%s", plugindir, dirst->d_name);
766
}
767
if(ret < 0){
768
perror("asprintf");
769
continue;
770
}
771
772
ret = stat(filename, &st);
773
if(ret == -1){
774
perror("stat");
775
free(filename);
776
continue;
777
}
778
779
/* Ignore non-executable files */
780
if(not S_ISREG(st.st_mode) or (access(filename, X_OK) != 0)){
420
781
if(debug){
421
782
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
422
783
" with bad type or mode\n", filename);
424
785
free(filename);
425
786
continue;
426
787
}
427
if(getplugin(dirst->d_name, &plugin_list)->disabled){
788
789
plugin *p = getplugin(dirst->d_name);
790
if(p == NULL){
791
perror("getplugin");
792
free(filename);
793
continue;
794
}
795
if(p->disabled){
428
796
if(debug){
429
797
fprintf(stderr, "Ignoring disabled plugin \"%s\"\n",
430
798
dirst->d_name);
432
800
free(filename);
433
801
continue;
434
802
}
435
plugin *p = getplugin(dirst->d_name, &plugin_list);
436
803
{
437
804
/* Add global arguments to argument list for this plugin */
438
plugin *g = getplugin(NULL, &plugin_list);
439
for(char **a = g->argv + 1; *a != NULL; a++){
440
addargument(p, *a);
441
}
442
}
443
int pipefd[2];
805
plugin *g = getplugin(NULL);
806
if(g != NULL){
807
for(char **a = g->argv + 1; *a != NULL; a++){
808
if(not add_argument(p, *a)){
809
perror("add_argument");
810
}
811
}
812
/* Add global environment variables */
813
for(char **e = g->environ; *e != NULL; e++){
814
if(not add_environment(p, *e, false)){
815
perror("add_environment");
816
}
817
}
818
}
819
}
820
/* If this plugin has any environment variables, we will call
821
using execve and need to duplicate the environment from this
822
process, too. */
823
if(p->environ[0] != NULL){
824
for(char **e = environ; *e != NULL; e++){
825
if(not add_environment(p, *e, false)){
826
perror("add_environment");
827
}
828
}
829
}
830
831
int pipefd[2];
444
832
ret = pipe(pipefd);
445
if (ret == -1){
833
if(ret == -1){
446
834
perror("pipe");
447
835
exitstatus = EXIT_FAILURE;
448
goto end;
836
goto fallback;
449
837
}
838
/* Ask OS to automatic close the pipe on exec */
450
839
ret = set_cloexec_flag(pipefd[0]);
451
840
if(ret < 0){
452
841
perror("set_cloexec_flag");
453
842
exitstatus = EXIT_FAILURE;
454
goto end;
843
goto fallback;
455
844
}
456
845
ret = set_cloexec_flag(pipefd[1]);
457
846
if(ret < 0){
458
847
perror("set_cloexec_flag");
459
848
exitstatus = EXIT_FAILURE;
460
goto end;
849
goto fallback;
461
850
}
462
851
/* Block SIGCHLD until process is safely in process list */
463
ret = sigprocmask (SIG_BLOCK, &sigchld_action.sa_mask, NULL);
852
ret = sigprocmask(SIG_BLOCK, &sigchld_action.sa_mask, NULL);
464
853
if(ret < 0){
465
854
perror("sigprocmask");
466
855
exitstatus = EXIT_FAILURE;
467
goto end;
856
goto fallback;
468
857
}
469
// Starting a new process to be watched
858
/* Starting a new process to be watched */
470
859
pid_t pid = fork();
860
if(pid == -1){
861
perror("fork");
862
exitstatus = EXIT_FAILURE;
863
goto fallback;
864
}
471
865
if(pid == 0){
472
866
/* this is the child process */
473
867
ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
475
869
perror("sigaction");
476
870
_exit(EXIT_FAILURE);
477
871
}
478
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
872
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
479
873
if(ret < 0){
480
874
perror("sigprocmask");
481
875
_exit(EXIT_FAILURE);
482
876
}
483
dup2(pipefd[1], STDOUT_FILENO); /* replace our stdout */
877
878
ret = dup2(pipefd[1], STDOUT_FILENO); /* replace our stdout */
879
if(ret == -1){
880
perror("dup2");
881
_exit(EXIT_FAILURE);
882
}
484
883
485
884
if(dirfd(dir) < 0){
486
885
/* If dir has no file descriptor, we could not set FD_CLOEXEC
487
886
above and must now close it manually here. */
488
887
closedir(dir);
489
888
}
490
if(execv(filename, p->argv) < 0){
491
perror("execv");
492
_exit(EXIT_FAILURE);
889
if(p->environ[0] == NULL){
890
if(execv(filename, p->argv) < 0){
891
perror("execv");
892
_exit(EXIT_FAILURE);
893
}
894
} else {
895
if(execve(filename, p->argv, p->environ) < 0){
896
perror("execve");
897
_exit(EXIT_FAILURE);
898
}
493
899
}
494
900
/* no return */
495
901
}
496
/* parent process */
902
/* Parent process */
903
close(pipefd[1]); /* Close unused write end of pipe */
497
904
free(filename);
498
close(pipefd[1]); /* close unused write end of pipe */
499
process *new_process = malloc(sizeof(process));
500
if (new_process == NULL){
501
perror("malloc");
502
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
905
plugin *new_plugin = getplugin(dirst->d_name);
906
if(new_plugin == NULL){
907
perror("getplugin");
908
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
503
909
if(ret < 0){
504
perror("sigprocmask");
910
perror("sigprocmask");
505
911
}
506
912
exitstatus = EXIT_FAILURE;
507
goto end;
913
goto fallback;
508
914
}
509
915
510
*new_process = (struct process){ .pid = pid,
511
.fd = pipefd[0],
512
.next = process_list };
513
// List handling
514
process_list = new_process;
916
new_plugin->pid = pid;
917
new_plugin->fd = pipefd[0];
918
515
919
/* Unblock SIGCHLD so signal handler can be run if this process
516
920
has already completed */
517
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
921
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
518
922
if(ret < 0){
519
923
perror("sigprocmask");
520
924
exitstatus = EXIT_FAILURE;
521
goto end;
522
}
523
524
FD_SET(new_process->fd, &rfds_all);
525
526
if (maxfd < new_process->fd){
527
maxfd = new_process->fd;
528
}
529
530
}
531
532
/* Free the plugin list */
533
for(plugin *next; plugin_list != NULL; plugin_list = next){
534
next = plugin_list->next;
535
free(plugin_list->argv);
536
free(plugin_list);
925
goto fallback;
926
}
927
928
FD_SET(new_plugin->fd, &rfds_all);
929
930
if(maxfd < new_plugin->fd){
931
maxfd = new_plugin->fd;
932
}
537
933
}
538
934
539
935
closedir(dir);
540
936
dir = NULL;
541
937
542
if (process_list == NULL){
543
fprintf(stderr, "No plugin processes started, exiting\n");
544
exitstatus = EXIT_FAILURE;
545
goto end;
938
for(plugin *p = plugin_list; p != NULL; p = p->next){
939
if(p->pid != 0){
940
break;
941
}
942
if(p->next == NULL){
943
fprintf(stderr, "No plugin processes started. Incorrect plugin"
944
" directory?\n");
945
free_plugin_list();
946
}
546
947
}
547
while(process_list){
948
949
/* Main loop while running plugins exist */
950
while(plugin_list){
548
951
fd_set rfds = rfds_all;
549
952
int select_ret = select(maxfd+1, &rfds, NULL, NULL, NULL);
550
if (select_ret == -1){
953
if(select_ret == -1){
551
954
perror("select");
552
955
exitstatus = EXIT_FAILURE;
553
goto end;
956
goto fallback;
554
957
}
555
958
/* OK, now either a process completed, or something can be read
556
959
from one of them */
557
for(process *proc = process_list; proc ; proc = proc->next){
960
for(plugin *proc = plugin_list; proc != NULL;){
558
961
/* Is this process completely done? */
559
962
if(proc->eof and proc->completed){
560
963
/* Only accept the plugin output if it exited cleanly */
561
964
if(not WIFEXITED(proc->status)
562
965
or WEXITSTATUS(proc->status) != 0){
563
966
/* Bad exit by plugin */
967
564
968
if(debug){
565
969
if(WIFEXITED(proc->status)){
566
fprintf(stderr, "Plugin %d exited with status %d\n",
567
proc->pid, WEXITSTATUS(proc->status));
970
fprintf(stderr, "Plugin %" PRIdMAX " exited with status"
971
" %d\n", (intmax_t) (proc->pid),
972
WEXITSTATUS(proc->status));
568
973
} else if(WIFSIGNALED(proc->status)) {
569
fprintf(stderr, "Plugin %d killed by signal %d\n",
570
proc->pid, WTERMSIG(proc->status));
974
fprintf(stderr, "Plugin %" PRIdMAX " killed by signal"
975
" %d\n", (intmax_t) (proc->pid),
976
WTERMSIG(proc->status));
571
977
} else if(WCOREDUMP(proc->status)){
572
fprintf(stderr, "Plugin %d dumped core\n", proc->pid);
978
fprintf(stderr, "Plugin %" PRIdMAX " dumped core\n",
979
(intmax_t) (proc->pid));
573
980
}
574
981
}
982
575
983
/* Remove the plugin */
576
984
FD_CLR(proc->fd, &rfds_all);
985
577
986
/* Block signal while modifying process_list */
578
ret = sigprocmask (SIG_BLOCK, &sigchld_action.sa_mask, NULL);
987
ret = sigprocmask(SIG_BLOCK, &sigchld_action.sa_mask, NULL);
579
988
if(ret < 0){
580
989
perror("sigprocmask");
581
990
exitstatus = EXIT_FAILURE;
582
goto end;
583
}
584
/* Delete this process entry from the list */
585
if(process_list == proc){
586
/* First one - simple */
587
process_list = proc->next;
588
} else {
589
/* Second one or later */
590
for(process *p = process_list; p != NULL; p = p->next){
591
if(p->next == proc){
592
p->next = proc->next;
593
break;
594
}
595
}
596
}
991
goto fallback;
992
}
993
994
plugin *next_plugin = proc->next;
995
free_plugin(proc);
996
proc = next_plugin;
997
597
998
/* We are done modifying process list, so unblock signal */
598
ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask,
599
NULL);
999
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask,
1000
NULL);
600
1001
if(ret < 0){
601
1002
perror("sigprocmask");
602
}
603
free(proc->buffer);
604
free(proc);
605
/* We deleted this process from the list, so we can't go
606
proc->next. Therefore, start over from the beginning of
607
the process list */
608
break;
1003
exitstatus = EXIT_FAILURE;
1004
goto fallback;
1005
}
1006
1007
if(plugin_list == NULL){
1008
break;
1009
}
1010
1011
continue;
609
1012
}
1013
610
1014
/* This process exited nicely, so print its buffer */
611
for(size_t written = 0; written < proc->buffer_length;
612
written += (size_t)ret){
613
ret = TEMP_FAILURE_RETRY(write(STDOUT_FILENO,
614
proc->buffer + written,
615
proc->buffer_length
616
- written));
617
if(ret < 0){
618
perror("write");
619
exitstatus = EXIT_FAILURE;
620
goto end;
621
}
1015
1016
bool bret = print_out_password(proc->buffer,
1017
proc->buffer_length);
1018
if(not bret){
1019
perror("print_out_password");
1020
exitstatus = EXIT_FAILURE;
622
1021
}
623
goto end;
1022
goto fallback;
624
1023
}
1024
625
1025
/* This process has not completed. Does it have any output? */
626
1026
if(proc->eof or not FD_ISSET(proc->fd, &rfds)){
627
1027
/* This process had nothing to say at this time */
1028
proc = proc->next;
628
1029
continue;
629
1030
}
630
1031
/* Before reading, make the process' data buffer large enough */
631
1032
if(proc->buffer_length + BUFFER_SIZE > proc->buffer_size){
632
1033
proc->buffer = realloc(proc->buffer, proc->buffer_size
633
1034
+ (size_t) BUFFER_SIZE);
634
if (proc->buffer == NULL){
1035
if(proc->buffer == NULL){
635
1036
perror("malloc");
636
1037
exitstatus = EXIT_FAILURE;
637
goto end;
1038
goto fallback;
638
1039
}
639
1040
proc->buffer_size += BUFFER_SIZE;
640
1041
}
641
1042
/* Read from the process */
642
ret = read(proc->fd, proc->buffer + proc->buffer_length,
643
BUFFER_SIZE);
644
if(ret < 0){
1043
sret = read(proc->fd, proc->buffer + proc->buffer_length,
1044
BUFFER_SIZE);
1045
if(sret < 0){
645
1046
/* Read error from this process; ignore the error */
1047
proc = proc->next;
646
1048
continue;
647
1049
}
648
if(ret == 0){
1050
if(sret == 0){
649
1051
/* got EOF */
650
1052
proc->eof = true;
651
1053
} else {
652
proc->buffer_length += (size_t) ret;
1054
proc->buffer_length += (size_t) sret;
653
1055
}
654
1056
}
655
1057
}
656
if(process_list == NULL){
657
fprintf(stderr, "All plugin processes failed, exiting\n");
658
exitstatus = EXIT_FAILURE;
1058
1059
1060
fallback:
1061
1062
if(plugin_list == NULL or exitstatus != EXIT_SUCCESS){
1063
/* Fallback if all plugins failed, none are found or an error
1064
occured */
1065
bool bret;
1066
fprintf(stderr, "Going to fallback mode using getpass(3)\n");
1067
char *passwordbuffer = getpass("Password: ");
1068
size_t len = strlen(passwordbuffer);
1069
/* Strip trailing newline */
1070
if(len > 0 and passwordbuffer[len-1] == '\n'){
1071
passwordbuffer[len-1] = '\0'; /* not strictly necessary */
1072
len--;
1073
}
1074
bret = print_out_password(passwordbuffer, len);
1075
if(not bret){
1076
perror("print_out_password");
1077
exitstatus = EXIT_FAILURE;
1078
}
659
1079
}
660
1080
661
end:
662
1081
/* Restore old signal handler */
663
sigaction(SIGCHLD, &old_sigchld_action, NULL);
664
665
free(plus_argv);
666
667
/* Free the plugin list */
668
for(plugin *next; plugin_list != NULL; plugin_list = next){
669
next = plugin_list->next;
670
free(plugin_list->argv);
671
free(plugin_list);
1082
ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1083
if(ret == -1){
1084
perror("sigaction");
1085
exitstatus = EXIT_FAILURE;
1086
}
1087
1088
if(custom_argv != NULL){
1089
for(char **arg = custom_argv+1; *arg != NULL; arg++){
1090
free(*arg);
1091
}
1092
free(custom_argv);
672
1093
}
673
1094
674
1095
if(dir != NULL){
675
1096
closedir(dir);
676
1097
}
677
1098
678
/* Free the process list and kill the processes */
679
for(process *next; process_list != NULL; process_list = next){
680
next = process_list->next;
681
close(process_list->fd);
682
kill(process_list->pid, SIGTERM);
683
free(process_list->buffer);
684
free(process_list);
1099
/* Kill the processes */
1100
for(plugin *p = plugin_list; p != NULL; p = p->next){
1101
if(p->pid != 0){
1102
close(p->fd);
1103
ret = kill(p->pid, SIGTERM);
1104
if(ret == -1 and errno != ESRCH){
1105
/* Set-uid proccesses might not get closed */
1106
perror("kill");
1107
}
1108
}
685
1109
}
686
1110
687
1111
/* Wait for any remaining child processes to terminate */
692
1116
perror("wait");
693
1117
}
694
1118
1119
free_plugin_list();
1120
1121
free(plugindir);
1122
free(argfile);
1123
695
1124
return exitstatus;
696
1125
}
Loggerhead is a web-based interface for Breezy
Version: 2.0.2.dev0