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