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.158
- compare with another revision
- download diff
- download tarball
- view history from revision 237.2.158
- Committer: Teddy Hogeborn
- Date: 2009-10-26 21:16: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-20091026211616-38e9wynf4428ip2l
Merge from release branch.
- files added:
- initramfs-tools-hook-conf
- files removed:
- DBUS-API
- debian/source
- debian/tests
- debian/upstream
- dracut-module
- network-hooks.d
- plugin-helpers
- files modified:
- .bzrignore
added
removed
plugin-runner.c
2
2
/*
3
3
* Mandos plugin runner - Run Mandos plugins
4
4
*
5
* Copyright © 2008-2022 Teddy Hogeborn
6
* Copyright © 2008-2022 Björn Påhlsson
7
*
8
* This file is part of Mandos.
9
*
10
* Mandos is free software: you can redistribute it and/or modify it
11
* under the terms of the GNU General Public License as published by
12
* the Free Software Foundation, either version 3 of the License, or
13
* (at your option) any later version.
14
*
15
* Mandos is distributed in the hope that it will be useful, but
5
* Copyright © 2008,2009 Teddy Hogeborn
6
* Copyright © 2008,2009 Björn Påhlsson
7
*
8
* This program is free software: you can redistribute it and/or
9
* modify it under the terms of the GNU General Public License as
10
* published by the Free Software Foundation, either version 3 of the
11
* License, or (at your option) any later version.
12
*
13
* This program is distributed in the hope that it will be useful, but
16
14
* WITHOUT ANY WARRANTY; without even the implied warranty of
17
15
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18
16
* General Public License for more details.
19
17
*
20
18
* You should have received a copy of the GNU General Public License
21
* along with Mandos. If not, see <http://www.gnu.org/licenses/>.
19
* along with this program. If not, see
20
* <http://www.gnu.org/licenses/>.
22
21
*
23
* Contact the authors at <mandos@recompile.se>.
22
* Contact the authors at <mandos@fukt.bsnet.se>.
24
23
*/
25
24
26
#define _GNU_SOURCE /* strchrnul(), TEMP_FAILURE_RETRY(),
27
getline(), asprintf(), O_CLOEXEC,
28
scandirat(), pipe2() */
29
#include <argp.h> /* argp_program_version,
30
argp_program_bug_address,
31
struct argp_option,
32
struct argp_state, argp_error(),
33
ARGP_NO_EXIT, argp_state_help,
34
ARGP_HELP_STD_HELP,
35
ARGP_HELP_USAGE, ARGP_HELP_EXIT_OK,
36
ARGP_KEY_ARG, ARGP_ERR_UNKNOWN,
37
struct argp, argp_parse(),
38
ARGP_IN_ORDER, ARGP_NO_HELP */
39
#include <stdbool.h> /* bool, false, true */
40
#include <sys/types.h> /* pid_t, sig_atomic_t, uid_t, gid_t,
41
getuid(), setgid(), setuid() */
25
#define _GNU_SOURCE /* TEMP_FAILURE_RETRY(), getline(),
26
asprintf(), O_CLOEXEC */
42
27
#include <stddef.h> /* size_t, NULL */
43
#include <iso646.h> /* or, and, not */
44
#include <string.h> /* strcmp(), strdup(), strchrnul(),
45
strncmp(), strlen(), strcpy(),
46
strsep(), strchr(), strsignal() */
47
#include <stdlib.h> /* malloc(), free(), reallocarray(),
48
realloc(), EXIT_SUCCESS */
49
#include <errno.h> /* errno, EINTR, ENOMEM, ECHILD,
50
error_t, EINVAL, EMFILE, ENFILE,
51
ENOENT, ESRCH */
52
#include <stdint.h> /* SIZE_MAX */
53
#define _GNU_SOURCE /* strchrnul(), TEMP_FAILURE_RETRY(),
54
getline(), asprintf(), O_CLOEXEC,
55
scandirat(), pipe2() */
56
#include <unistd.h> /* TEMP_FAILURE_RETRY(), ssize_t,
57
write(), STDOUT_FILENO, uid_t,
58
gid_t, getuid(), fchown(), close(),
59
symlink(), setgid(), setuid(),
60
faccessat(), X_OK, pipe(), pipe2(),
61
fork(), _exit(), dup2(), fexecve(),
62
read(), getpass() */
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(),
32
stderr, STDOUT_FILENO */
33
#include <sys/types.h> /* DIR, fdopendir(), 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(), WTERMSIG(),
42
WCOREDUMP() */
43
#include <sys/stat.h> /* struct stat, stat(), S_ISREG() */
44
#include <iso646.h> /* and, or, not */
45
#include <dirent.h> /* DIR, struct dirent, fdopendir(),
46
readdir(), closedir(), dirfd() */
47
#include <unistd.h> /* struct stat, stat(), S_ISREG(),
48
fcntl(), setuid(), setgid(),
49
F_GETFD, F_SETFD, FD_CLOEXEC,
50
access(), pipe(), fork(), close()
51
dup2(), STDOUT_FILENO, _exit(),
52
execv(), write(), read(),
53
close() */
63
54
#include <fcntl.h> /* fcntl(), F_GETFD, F_SETFD,
64
FD_CLOEXEC, open(), O_RDONLY,
65
O_CLOEXEC, openat() */
66
#include <sys/wait.h> /* waitpid(), WNOHANG, WIFEXITED(),
67
WEXITSTATUS(), WIFSIGNALED(),
68
WTERMSIG(), wait() */
69
#include <error.h> /* error() */
70
#include <stdio.h> /* FILE, fprintf(), fopen(),
71
getline(), fclose(), EOF,
72
asprintf(), stderr */
73
#include <dirent.h> /* struct dirent, scandirat(),
74
alphasort() */
75
#include <sys/stat.h> /* struct stat, fstat(), S_ISDIR(),
76
lstat(), S_ISREG() */
77
#include <sys/select.h> /* fd_set, FD_ZERO(), FD_SETSIZE,
78
FD_SET(), select(), FD_CLR(),
79
FD_ISSET() */
80
#include <signal.h> /* struct sigaction, SA_NOCLDSTOP,
81
sigemptyset(), sigaddset(),
82
SIGCHLD, sigprocmask(), SIG_BLOCK,
83
SIG_UNBLOCK, kill(), SIGTERM */
84
#include <sysexits.h> /* EX_OSERR, EX_USAGE, EX_IOERR,
85
EX_CONFIG, EX_UNAVAILABLE, EX_OK */
86
#include <inttypes.h> /* intmax_t, strtoimax(), PRIdMAX */
87
#include <fnmatch.h> /* fnmatch(), FNM_FILE_NAME,
88
FNM_PERIOD, FNM_NOMATCH */
55
FD_CLOEXEC */
56
#include <string.h> /* strsep, strlen(), asprintf(),
57
strsignal() */
58
#include <errno.h> /* errno */
59
#include <argp.h> /* struct argp_option, struct
60
argp_state, struct argp,
61
argp_parse(), ARGP_ERR_UNKNOWN,
62
ARGP_KEY_END, ARGP_KEY_ARG,
63
error_t */
64
#include <signal.h> /* struct sigaction, sigemptyset(),
65
sigaddset(), sigaction(),
66
sigprocmask(), SIG_BLOCK, SIGCHLD,
67
SIG_UNBLOCK, kill(), sig_atomic_t
68
*/
69
#include <errno.h> /* errno, EBADF */
70
#include <inttypes.h> /* intmax_t, PRIdMAX, strtoimax() */
71
#include <sysexits.h> /* EX_OSERR, EX_USAGE */
89
72
90
73
#define BUFFER_SIZE 256
91
74
92
75
#define PDIR "/lib/mandos/plugins.d"
93
#define PHDIR "/lib/mandos/plugin-helpers"
94
76
#define AFILE "/conf/conf.d/mandos/plugin-runner.conf"
95
77
96
78
const char *argp_program_version = "plugin-runner " VERSION;
97
const char *argp_program_bug_address = "<mandos@recompile.se>";
79
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
98
80
99
81
typedef struct plugin{
100
82
char *name; /* can be NULL or any plugin name */
120
102
121
103
/* Gets an existing plugin based on name,
122
104
or if none is found, creates a new one */
123
__attribute__((warn_unused_result))
124
105
static plugin *getplugin(char *name){
125
106
/* Check for existing plugin with that name */
126
107
for(plugin *p = plugin_list; p != NULL; p = p->next){
187
168
}
188
169
189
170
/* Helper function for add_argument and add_environment */
190
__attribute__((nonnull, warn_unused_result))
191
171
static bool add_to_char_array(const char *new, char ***array,
192
172
int *len){
193
173
/* Resize the pointed-to array to hold one more pointer */
194
char **new_array = NULL;
195
174
do {
196
#if defined(__GLIBC_PREREQ) and __GLIBC_PREREQ(2, 26)
197
new_array = reallocarray(*array, (size_t)((*len) + 2),
198
sizeof(char *));
199
#else
200
if(((size_t)((*len) + 2)) > (SIZE_MAX / sizeof(char *))){
201
/* overflow */
202
new_array = NULL;
203
errno = ENOMEM;
204
} else {
205
new_array = realloc(*array, (size_t)((*len) + 2)
206
* sizeof(char *));
207
}
208
#endif
209
} while(new_array == NULL and errno == EINTR);
175
*array = realloc(*array, sizeof(char *)
176
* (size_t) ((*len) + 2));
177
} while(*array == NULL and errno == EINTR);
210
178
/* Malloc check */
211
if(new_array == NULL){
179
if(*array == NULL){
212
180
return false;
213
181
}
214
*array = new_array;
215
182
/* Make a copy of the new string */
216
183
char *copy;
217
184
do {
229
196
}
230
197
231
198
/* Add to a plugin's argument vector */
232
__attribute__((nonnull(2), warn_unused_result))
233
199
static bool add_argument(plugin *p, const char *arg){
234
200
if(p == NULL){
235
201
return false;
238
204
}
239
205
240
206
/* Add to a plugin's environment */
241
__attribute__((nonnull(2), warn_unused_result))
242
207
static bool add_environment(plugin *p, const char *def, bool replace){
243
208
if(p == NULL){
244
209
return false;
246
211
/* namelen = length of name of environment variable */
247
212
size_t namelen = (size_t)(strchrnul(def, '=') - def);
248
213
/* Search for this environment variable */
249
for(char **envdef = p->environ; *envdef != NULL; envdef++){
250
if(strncmp(*envdef, def, namelen + 1) == 0){
214
for(char **e = p->environ; *e != NULL; e++){
215
if(strncmp(*e, def, namelen + 1) == 0){
251
216
/* It already exists */
252
217
if(replace){
253
char *new_envdef;
218
char *new;
254
219
do {
255
new_envdef = realloc(*envdef, strlen(def) + 1);
256
} while(new_envdef == NULL and errno == EINTR);
257
if(new_envdef == NULL){
220
new = realloc(*e, strlen(def) + 1);
221
} while(new == NULL and errno == EINTR);
222
if(new == NULL){
258
223
return false;
259
224
}
260
*envdef = new_envdef;
261
strcpy(*envdef, def);
225
*e = new;
226
strcpy(*e, def);
262
227
}
263
228
return true;
264
229
}
266
231
return add_to_char_array(def, &(p->environ), &(p->envc));
267
232
}
268
233
269
#ifndef O_CLOEXEC
270
234
/*
271
235
* Based on the example in the GNU LibC manual chapter 13.13 "File
272
236
* Descriptor Flags".
273
237
| [[info:libc:Descriptor%20Flags][File Descriptor Flags]] |
274
238
*/
275
__attribute__((warn_unused_result))
276
239
static int set_cloexec_flag(int fd){
277
240
int ret = (int)TEMP_FAILURE_RETRY(fcntl(fd, F_GETFD, 0));
278
241
/* If reading the flags failed, return error indication now. */
283
246
return (int)TEMP_FAILURE_RETRY(fcntl(fd, F_SETFD,
284
247
ret | FD_CLOEXEC));
285
248
}
286
#endif /* not O_CLOEXEC */
287
249
288
250
289
251
/* Mark processes as completed when they exit, and save their exit
303
265
/* No child processes */
304
266
break;
305
267
}
306
error(0, errno, "waitpid");
268
perror("waitpid");
307
269
}
308
270
309
271
/* A child exited, find it in process_list */
321
283
}
322
284
323
285
/* Prints out a password to stdout */
324
__attribute__((nonnull, warn_unused_result))
325
286
static bool print_out_password(const char *buffer, size_t length){
326
287
ssize_t ret;
327
288
for(size_t written = 0; written < length; written += (size_t)ret){
335
296
}
336
297
337
298
/* Removes and free a plugin from the plugin list */
338
__attribute__((nonnull))
339
299
static void free_plugin(plugin *plugin_node){
340
300
341
for(char **arg = (plugin_node->argv)+1; *arg != NULL; arg++){
301
for(char **arg = plugin_node->argv; *arg != NULL; arg++){
342
302
free(*arg);
343
303
}
344
free(plugin_node->name);
345
304
free(plugin_node->argv);
346
305
for(char **env = plugin_node->environ; *env != NULL; env++){
347
306
free(*env);
374
333
375
334
int main(int argc, char *argv[]){
376
335
char *plugindir = NULL;
377
char *pluginhelperdir = NULL;
378
336
char *argfile = NULL;
379
337
FILE *conffp;
380
struct dirent **direntries = NULL;
338
size_t d_name_len;
339
DIR *dir = NULL;
340
struct dirent *dirst;
381
341
struct stat st;
382
342
fd_set rfds_all;
383
343
int ret, maxfd = 0;
391
351
.sa_flags = SA_NOCLDSTOP };
392
352
char **custom_argv = NULL;
393
353
int custom_argc = 0;
394
int dir_fd = -1;
395
354
396
355
/* Establish a signal handler */
397
356
sigemptyset(&sigchld_action.sa_mask);
398
357
ret = sigaddset(&sigchld_action.sa_mask, SIGCHLD);
399
358
if(ret == -1){
400
error(0, errno, "sigaddset");
401
exitstatus = EX_OSERR;
359
perror("sigaddset");
360
exitstatus = EXIT_FAILURE;
402
361
goto fallback;
403
362
}
404
363
ret = sigaction(SIGCHLD, &sigchld_action, &old_sigchld_action);
405
364
if(ret == -1){
406
error(0, errno, "sigaction");
407
exitstatus = EX_OSERR;
365
perror("sigaction");
366
exitstatus = EXIT_FAILURE;
408
367
goto fallback;
409
368
}
410
369
442
401
.doc = "Group ID the plugins will run as", .group = 3 },
443
402
{ .name = "debug", .key = 132,
444
403
.doc = "Debug mode", .group = 4 },
445
{ .name = "plugin-helper-dir", .key = 133,
446
.arg = "DIRECTORY",
447
.doc = "Specify a different plugin helper directory",
448
.group = 2 },
449
404
/*
450
405
* These reproduce what we would get without ARGP_NO_HELP
451
406
*/
458
413
{ .name = NULL }
459
414
};
460
415
461
__attribute__((nonnull(3)))
462
416
error_t parse_opt(int key, char *arg, struct argp_state *state){
463
417
errno = 0;
464
418
switch(key){
465
419
char *tmp;
466
intmax_t tmp_id;
420
intmax_t tmpmax;
467
421
case 'g': /* --global-options */
468
422
{
469
423
char *plugin_option;
472
426
break;
473
427
}
474
428
}
475
errno = 0;
476
429
}
477
430
break;
478
431
case 'G': /* --global-env */
479
if(add_environment(getplugin(NULL), arg, true)){
480
errno = 0;
481
}
432
add_environment(getplugin(NULL), arg, true);
482
433
break;
483
434
case 'o': /* --options-for */
484
435
{
501
452
break;
502
453
}
503
454
}
504
errno = 0;
505
455
}
506
456
break;
507
457
case 'E': /* --env-for */
519
469
errno = EINVAL;
520
470
break;
521
471
}
522
if(add_environment(getplugin(arg), envdef, true)){
523
errno = 0;
524
}
472
add_environment(getplugin(arg), envdef, true);
525
473
}
526
474
break;
527
475
case 'd': /* --disable */
529
477
plugin *p = getplugin(arg);
530
478
if(p != NULL){
531
479
p->disabled = true;
532
errno = 0;
533
480
}
534
481
}
535
482
break;
538
485
plugin *p = getplugin(arg);
539
486
if(p != NULL){
540
487
p->disabled = false;
541
errno = 0;
542
488
}
543
489
}
544
490
break;
545
491
case 128: /* --plugin-dir */
546
492
free(plugindir);
547
493
plugindir = strdup(arg);
548
if(plugindir != NULL){
549
errno = 0;
550
}
551
494
break;
552
495
case 129: /* --config-file */
553
496
/* This is already done by parse_opt_config_file() */
554
497
break;
555
498
case 130: /* --userid */
556
tmp_id = strtoimax(arg, &tmp, 10);
499
tmpmax = strtoimax(arg, &tmp, 10);
557
500
if(errno != 0 or tmp == arg or *tmp != '\0'
558
or tmp_id != (uid_t)tmp_id){
501
or tmpmax != (uid_t)tmpmax){
559
502
argp_error(state, "Bad user ID number: \"%s\", using %"
560
503
PRIdMAX, arg, (intmax_t)uid);
561
504
break;
562
505
}
563
uid = (uid_t)tmp_id;
564
errno = 0;
506
uid = (uid_t)tmpmax;
565
507
break;
566
508
case 131: /* --groupid */
567
tmp_id = strtoimax(arg, &tmp, 10);
509
tmpmax = strtoimax(arg, &tmp, 10);
568
510
if(errno != 0 or tmp == arg or *tmp != '\0'
569
or tmp_id != (gid_t)tmp_id){
511
or tmpmax != (gid_t)tmpmax){
570
512
argp_error(state, "Bad group ID number: \"%s\", using %"
571
513
PRIdMAX, arg, (intmax_t)gid);
572
514
break;
573
515
}
574
gid = (gid_t)tmp_id;
575
errno = 0;
516
gid = (gid_t)tmpmax;
576
517
break;
577
518
case 132: /* --debug */
578
519
debug = true;
579
520
break;
580
case 133: /* --plugin-helper-dir */
581
free(pluginhelperdir);
582
pluginhelperdir = strdup(arg);
583
if(pluginhelperdir != NULL){
584
errno = 0;
585
}
586
break;
587
521
/*
588
522
* These reproduce what we would get without ARGP_NO_HELP
589
523
*/
590
524
case '?': /* --help */
591
525
state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
592
526
argp_state_help(state, state->out_stream, ARGP_HELP_STD_HELP);
593
__builtin_unreachable();
594
527
case -3: /* --usage */
595
528
state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
596
529
argp_state_help(state, state->out_stream,
597
530
ARGP_HELP_USAGE | ARGP_HELP_EXIT_OK);
598
__builtin_unreachable();
599
531
case 'V': /* --version */
600
532
fprintf(state->out_stream, "%s\n", argp_program_version);
601
533
exit(EXIT_SUCCESS);
611
543
if(arg[0] == '\0'){
612
544
break;
613
545
}
614
#if __GNUC__ >= 7
615
__attribute__((fallthrough));
616
#else
617
/* FALLTHROUGH */
618
#endif
619
546
default:
620
547
return ARGP_ERR_UNKNOWN;
621
548
}
640
567
case 129: /* --config-file */
641
568
free(argfile);
642
569
argfile = strdup(arg);
643
if(argfile != NULL){
644
errno = 0;
645
}
646
570
break;
647
571
case 130: /* --userid */
648
572
case 131: /* --groupid */
649
573
case 132: /* --debug */
650
case 133: /* --plugin-helper-dir */
651
574
case '?': /* --help */
652
575
case -3: /* --usage */
653
576
case 'V': /* --version */
675
598
case ENOMEM:
676
599
default:
677
600
errno = ret;
678
error(0, errno, "argp_parse");
601
perror("argp_parse");
679
602
exitstatus = EX_OSERR;
680
603
goto fallback;
681
604
case EINVAL:
702
625
custom_argc = 1;
703
626
custom_argv = malloc(sizeof(char*) * 2);
704
627
if(custom_argv == NULL){
705
error(0, errno, "malloc");
706
exitstatus = EX_OSERR;
628
perror("malloc");
629
exitstatus = EXIT_FAILURE;
707
630
goto fallback;
708
631
}
709
632
custom_argv[0] = argv[0];
725
648
}
726
649
new_arg = strdup(p);
727
650
if(new_arg == NULL){
728
error(0, errno, "strdup");
729
exitstatus = EX_OSERR;
651
perror("strdup");
652
exitstatus = EXIT_FAILURE;
730
653
free(org_line);
731
654
goto fallback;
732
655
}
733
656
734
657
custom_argc += 1;
735
{
736
#if defined(__GLIBC_PREREQ) and __GLIBC_PREREQ(2, 26)
737
char **new_argv = reallocarray(custom_argv,
738
(size_t)custom_argc + 1,
739
sizeof(char *));
740
#else
741
char **new_argv = NULL;
742
if(((size_t)custom_argc + 1) > (SIZE_MAX / sizeof(char *))){
743
/* overflow */
744
errno = ENOMEM;
745
} else {
746
new_argv = realloc(custom_argv, ((size_t)custom_argc + 1)
747
* sizeof(char *));
748
}
749
#endif
750
if(new_argv == NULL){
751
error(0, errno, "reallocarray");
752
exitstatus = EX_OSERR;
753
free(new_arg);
754
free(org_line);
755
goto fallback;
756
} else {
757
custom_argv = new_argv;
758
}
658
custom_argv = realloc(custom_argv, sizeof(char *)
659
* ((unsigned int) custom_argc + 1));
660
if(custom_argv == NULL){
661
perror("realloc");
662
exitstatus = EXIT_FAILURE;
663
free(org_line);
664
goto fallback;
759
665
}
760
666
custom_argv[custom_argc-1] = new_arg;
761
667
custom_argv[custom_argc] = NULL;
765
671
ret = fclose(conffp);
766
672
} while(ret == EOF and errno == EINTR);
767
673
if(ret == EOF){
768
error(0, errno, "fclose");
769
exitstatus = EX_IOERR;
674
perror("fclose");
675
exitstatus = EXIT_FAILURE;
770
676
goto fallback;
771
677
}
772
678
free(org_line);
774
680
/* Check for harmful errors and go to fallback. Other errors might
775
681
not affect opening plugins */
776
682
if(errno == EMFILE or errno == ENFILE or errno == ENOMEM){
777
error(0, errno, "fopen");
778
exitstatus = EX_OSERR;
683
perror("fopen");
684
exitstatus = EXIT_FAILURE;
779
685
goto fallback;
780
686
}
781
687
}
791
697
case ENOMEM:
792
698
default:
793
699
errno = ret;
794
error(0, errno, "argp_parse");
700
perror("argp_parse");
795
701
exitstatus = EX_OSERR;
796
702
goto fallback;
797
703
case EINVAL:
811
717
case ENOMEM:
812
718
default:
813
719
errno = ret;
814
error(0, errno, "argp_parse");
720
perror("argp_parse");
815
721
exitstatus = EX_OSERR;
816
722
goto fallback;
817
723
case EINVAL:
819
725
goto fallback;
820
726
}
821
727
822
{
823
char *pluginhelperenv;
824
bool bret = true;
825
ret = asprintf(&pluginhelperenv, "MANDOSPLUGINHELPERDIR=%s",
826
pluginhelperdir != NULL ? pluginhelperdir : PHDIR);
827
if(ret != -1){
828
bret = add_environment(getplugin(NULL), pluginhelperenv, true);
829
}
830
if(ret == -1 or not bret){
831
error(0, errno, "Failed to set MANDOSPLUGINHELPERDIR"
832
" environment variable to \"%s\" for all plugins\n",
833
pluginhelperdir != NULL ? pluginhelperdir : PHDIR);
834
}
835
if(ret != -1){
836
free(pluginhelperenv);
837
}
838
}
839
840
728
if(debug){
841
for(plugin *p = plugin_list; p != NULL; p = p->next){
729
for(plugin *p = plugin_list; p != NULL; p=p->next){
842
730
fprintf(stderr, "Plugin: %s has %d arguments\n",
843
731
p->name ? p->name : "Global", p->argc - 1);
844
732
for(char **a = p->argv; *a != NULL; a++){
851
739
}
852
740
}
853
741
854
if(getuid() == 0){
855
/* Work around Debian bug #633582:
856
<https://bugs.debian.org/633582> */
857
int plugindir_fd = open(/* plugindir or */ PDIR, O_RDONLY);
858
if(plugindir_fd == -1){
859
if(errno != ENOENT){
860
error(0, errno, "open(\"" PDIR "\")");
861
}
862
} else {
863
ret = (int)TEMP_FAILURE_RETRY(fstat(plugindir_fd, &st));
864
if(ret == -1){
865
error(0, errno, "fstat");
866
} else {
867
if(S_ISDIR(st.st_mode) and st.st_uid == 0 and st.st_gid == 0){
868
ret = fchown(plugindir_fd, uid, gid);
869
if(ret == -1){
870
error(0, errno, "fchown");
871
}
872
}
873
}
874
close(plugindir_fd);
875
}
876
877
/* Work around Debian bug #981302
878
<https://bugs.debian.org/981302> */
879
if(lstat("/dev/fd", &st) != 0 and errno == ENOENT){
880
ret = symlink("/proc/self/fd", "/dev/fd");
881
if(ret == -1){
882
error(0, errno, "Failed to create /dev/fd symlink");
883
}
884
}
885
}
886
887
/* Lower permissions */
888
ret = setgid(gid);
742
/* Strip permissions down to nobody */
743
setgid(gid);
889
744
if(ret == -1){
890
error(0, errno, "setgid");
745
perror("setgid");
891
746
}
892
747
ret = setuid(uid);
893
748
if(ret == -1){
894
error(0, errno, "setuid");
749
perror("setuid");
895
750
}
896
751
897
752
/* Open plugin directory with close_on_exec flag */
898
753
{
899
dir_fd = open(plugindir != NULL ? plugindir : PDIR, O_RDONLY |
900
#ifdef O_CLOEXEC
901
O_CLOEXEC
902
#else /* not O_CLOEXEC */
903
0
904
#endif /* not O_CLOEXEC */
905
);
754
int dir_fd = -1;
755
if(plugindir == NULL){
756
dir_fd = open(PDIR, O_RDONLY |
757
#ifdef O_CLOEXEC
758
O_CLOEXEC
759
#else /* not O_CLOEXEC */
760
0
761
#endif /* not O_CLOEXEC */
762
);
763
} else {
764
dir_fd = open(plugindir, O_RDONLY |
765
#ifdef O_CLOEXEC
766
O_CLOEXEC
767
#else /* not O_CLOEXEC */
768
0
769
#endif /* not O_CLOEXEC */
770
);
771
}
906
772
if(dir_fd == -1){
907
error(0, errno, "Could not open plugin dir");
908
exitstatus = EX_UNAVAILABLE;
773
perror("Could not open plugin dir");
774
exitstatus = EXIT_FAILURE;
909
775
goto fallback;
910
776
}
911
777
913
779
/* Set the FD_CLOEXEC flag on the directory */
914
780
ret = set_cloexec_flag(dir_fd);
915
781
if(ret < 0){
916
error(0, errno, "set_cloexec_flag");
917
exitstatus = EX_OSERR;
782
perror("set_cloexec_flag");
783
TEMP_FAILURE_RETRY(close(dir_fd));
784
exitstatus = EXIT_FAILURE;
918
785
goto fallback;
919
786
}
920
787
#endif /* O_CLOEXEC */
921
}
922
923
int good_name(const struct dirent * const dirent){
924
const char * const patterns[] = { ".*", "#*#", "*~", "*.dpkg-new",
925
"*.dpkg-old", "*.dpkg-bak",
926
"*.dpkg-divert", NULL };
927
#ifdef __GNUC__
928
#pragma GCC diagnostic push
929
#pragma GCC diagnostic ignored "-Wcast-qual"
930
#endif
931
for(const char **pat = (const char **)patterns;
932
*pat != NULL; pat++){
933
#ifdef __GNUC__
934
#pragma GCC diagnostic pop
935
#endif
936
if(fnmatch(*pat, dirent->d_name, FNM_FILE_NAME | FNM_PERIOD)
937
!= FNM_NOMATCH){
938
if(debug){
939
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
940
" matching pattern %s\n", dirent->d_name, *pat);
941
}
942
return 0;
943
}
788
789
dir = fdopendir(dir_fd);
790
if(dir == NULL){
791
perror("Could not open plugin dir");
792
TEMP_FAILURE_RETRY(close(dir_fd));
793
exitstatus = EXIT_FAILURE;
794
goto fallback;
944
795
}
945
return 1;
946
}
947
948
int numplugins = scandirat(dir_fd, ".", &direntries, good_name,
949
alphasort);
950
if(numplugins == -1){
951
error(0, errno, "Could not scan plugin dir");
952
direntries = NULL;
953
exitstatus = EX_OSERR;
954
goto fallback;
955
796
}
956
797
957
798
FD_ZERO(&rfds_all);
958
799
959
800
/* Read and execute any executable in the plugin directory*/
960
for(int i = 0; i < numplugins; i++){
961
962
int plugin_fd = openat(dir_fd, direntries[i]->d_name, O_RDONLY);
963
if(plugin_fd == -1){
964
error(0, errno, "Could not open plugin");
965
free(direntries[i]);
801
while(true){
802
do {
803
dirst = readdir(dir);
804
} while(dirst == NULL and errno == EINTR);
805
806
/* All directory entries have been processed */
807
if(dirst == NULL){
808
if(errno == EBADF){
809
perror("readdir");
810
exitstatus = EXIT_FAILURE;
811
goto fallback;
812
}
813
break;
814
}
815
816
d_name_len = strlen(dirst->d_name);
817
818
/* Ignore dotfiles, backup files and other junk */
819
{
820
bool bad_name = false;
821
822
const char const *bad_prefixes[] = { ".", "#", NULL };
823
824
const char const *bad_suffixes[] = { "~", "#", ".dpkg-new",
825
".dpkg-old",
826
".dpkg-bak",
827
".dpkg-divert", NULL };
828
for(const char **pre = bad_prefixes; *pre != NULL; pre++){
829
size_t pre_len = strlen(*pre);
830
if((d_name_len >= pre_len)
831
and strncmp((dirst->d_name), *pre, pre_len) == 0){
832
if(debug){
833
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
834
" with bad prefix %s\n", dirst->d_name, *pre);
835
}
836
bad_name = true;
837
break;
838
}
839
}
840
if(bad_name){
841
continue;
842
}
843
for(const char **suf = bad_suffixes; *suf != NULL; suf++){
844
size_t suf_len = strlen(*suf);
845
if((d_name_len >= suf_len)
846
and (strcmp((dirst->d_name)+d_name_len-suf_len, *suf)
847
== 0)){
848
if(debug){
849
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
850
" with bad suffix %s\n", dirst->d_name, *suf);
851
}
852
bad_name = true;
853
break;
854
}
855
}
856
857
if(bad_name){
858
continue;
859
}
860
}
861
862
char *filename;
863
if(plugindir == NULL){
864
ret = (int)TEMP_FAILURE_RETRY(asprintf(&filename, PDIR "/%s",
865
dirst->d_name));
866
} else {
867
ret = (int)TEMP_FAILURE_RETRY(asprintf(&filename, "%s/%s",
868
plugindir,
869
dirst->d_name));
870
}
871
if(ret < 0){
872
perror("asprintf");
966
873
continue;
967
874
}
968
ret = (int)TEMP_FAILURE_RETRY(fstat(plugin_fd, &st));
875
876
ret = (int)TEMP_FAILURE_RETRY(stat(filename, &st));
969
877
if(ret == -1){
970
error(0, errno, "stat");
971
close(plugin_fd);
972
free(direntries[i]);
878
perror("stat");
879
free(filename);
973
880
continue;
974
881
}
975
882
976
883
/* Ignore non-executable files */
977
884
if(not S_ISREG(st.st_mode)
978
or (TEMP_FAILURE_RETRY(faccessat(dir_fd, direntries[i]->d_name,
979
X_OK, 0)) != 0)){
885
or (TEMP_FAILURE_RETRY(access(filename, X_OK)) != 0)){
980
886
if(debug){
981
fprintf(stderr, "Ignoring plugin dir entry \"%s/%s\""
982
" with bad type or mode\n",
983
plugindir != NULL ? plugindir : PDIR,
984
direntries[i]->d_name);
887
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
888
" with bad type or mode\n", filename);
985
889
}
986
close(plugin_fd);
987
free(direntries[i]);
890
free(filename);
988
891
continue;
989
892
}
990
893
991
plugin *p = getplugin(direntries[i]->d_name);
894
plugin *p = getplugin(dirst->d_name);
992
895
if(p == NULL){
993
error(0, errno, "getplugin");
994
close(plugin_fd);
995
free(direntries[i]);
896
perror("getplugin");
897
free(filename);
996
898
continue;
997
899
}
998
900
if(p->disabled){
999
901
if(debug){
1000
902
fprintf(stderr, "Ignoring disabled plugin \"%s\"\n",
1001
direntries[i]->d_name);
903
dirst->d_name);
1002
904
}
1003
close(plugin_fd);
1004
free(direntries[i]);
905
free(filename);
1005
906
continue;
1006
907
}
1007
908
{
1010
911
if(g != NULL){
1011
912
for(char **a = g->argv + 1; *a != NULL; a++){
1012
913
if(not add_argument(p, *a)){
1013
error(0, errno, "add_argument");
914
perror("add_argument");
1014
915
}
1015
916
}
1016
917
/* Add global environment variables */
1017
918
for(char **e = g->environ; *e != NULL; e++){
1018
919
if(not add_environment(p, *e, false)){
1019
error(0, errno, "add_environment");
920
perror("add_environment");
1020
921
}
1021
922
}
1022
923
}
1023
924
}
1024
/* If this plugin has any environment variables, we need to
1025
duplicate the environment from this process, too. */
925
/* If this plugin has any environment variables, we will call
926
using execve and need to duplicate the environment from this
927
process, too. */
1026
928
if(p->environ[0] != NULL){
1027
929
for(char **e = environ; *e != NULL; e++){
1028
930
if(not add_environment(p, *e, false)){
1029
error(0, errno, "add_environment");
931
perror("add_environment");
1030
932
}
1031
933
}
1032
934
}
1033
935
1034
936
int pipefd[2];
1035
#ifndef O_CLOEXEC
1036
937
ret = (int)TEMP_FAILURE_RETRY(pipe(pipefd));
1037
#else /* O_CLOEXEC */
1038
ret = (int)TEMP_FAILURE_RETRY(pipe2(pipefd, O_CLOEXEC));
1039
#endif /* O_CLOEXEC */
1040
938
if(ret == -1){
1041
error(0, errno, "pipe");
1042
exitstatus = EX_OSERR;
1043
free(direntries[i]);
1044
goto fallback;
1045
}
1046
if(pipefd[0] >= FD_SETSIZE){
1047
fprintf(stderr, "pipe()[0] (%d) >= FD_SETSIZE (%d)", pipefd[0],
1048
FD_SETSIZE);
1049
close(pipefd[0]);
1050
close(pipefd[1]);
1051
exitstatus = EX_OSERR;
1052
free(direntries[i]);
1053
goto fallback;
1054
}
1055
#ifndef O_CLOEXEC
939
perror("pipe");
940
exitstatus = EXIT_FAILURE;
941
goto fallback;
942
}
1056
943
/* Ask OS to automatic close the pipe on exec */
1057
944
ret = set_cloexec_flag(pipefd[0]);
1058
945
if(ret < 0){
1059
error(0, errno, "set_cloexec_flag");
1060
close(pipefd[0]);
1061
close(pipefd[1]);
1062
exitstatus = EX_OSERR;
1063
free(direntries[i]);
946
perror("set_cloexec_flag");
947
exitstatus = EXIT_FAILURE;
1064
948
goto fallback;
1065
949
}
1066
950
ret = set_cloexec_flag(pipefd[1]);
1067
951
if(ret < 0){
1068
error(0, errno, "set_cloexec_flag");
1069
close(pipefd[0]);
1070
close(pipefd[1]);
1071
exitstatus = EX_OSERR;
1072
free(direntries[i]);
952
perror("set_cloexec_flag");
953
exitstatus = EXIT_FAILURE;
1073
954
goto fallback;
1074
955
}
1075
#endif /* not O_CLOEXEC */
1076
956
/* Block SIGCHLD until process is safely in process list */
1077
957
ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_BLOCK,
1078
958
&sigchld_action.sa_mask,
1079
959
NULL));
1080
960
if(ret < 0){
1081
error(0, errno, "sigprocmask");
1082
exitstatus = EX_OSERR;
1083
free(direntries[i]);
961
perror("sigprocmask");
962
exitstatus = EXIT_FAILURE;
1084
963
goto fallback;
1085
964
}
1086
965
/* Starting a new process to be watched */
1089
968
pid = fork();
1090
969
} while(pid == -1 and errno == EINTR);
1091
970
if(pid == -1){
1092
error(0, errno, "fork");
1093
TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1094
&sigchld_action.sa_mask, NULL));
1095
close(pipefd[0]);
1096
close(pipefd[1]);
1097
exitstatus = EX_OSERR;
1098
free(direntries[i]);
971
perror("fork");
972
exitstatus = EXIT_FAILURE;
1099
973
goto fallback;
1100
974
}
1101
975
if(pid == 0){
1102
976
/* this is the child process */
1103
977
ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1104
978
if(ret < 0){
1105
error(0, errno, "sigaction");
1106
_exit(EX_OSERR);
979
perror("sigaction");
980
_exit(EXIT_FAILURE);
1107
981
}
1108
982
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1109
983
if(ret < 0){
1110
error(0, errno, "sigprocmask");
1111
_exit(EX_OSERR);
984
perror("sigprocmask");
985
_exit(EXIT_FAILURE);
1112
986
}
1113
987
1114
988
ret = dup2(pipefd[1], STDOUT_FILENO); /* replace our stdout */
1115
989
if(ret == -1){
1116
error(0, errno, "dup2");
1117
_exit(EX_OSERR);
990
perror("dup2");
991
_exit(EXIT_FAILURE);
1118
992
}
1119
993
1120
if(fexecve(plugin_fd, p->argv,
1121
(p->environ[0] != NULL) ? p->environ : environ) < 0){
1122
error(0, errno, "fexecve for %s/%s",
1123
plugindir != NULL ? plugindir : PDIR,
1124
direntries[i]->d_name);
1125
_exit(EX_OSERR);
994
if(dirfd(dir) < 0){
995
/* If dir has no file descriptor, we could not set FD_CLOEXEC
996
above and must now close it manually here. */
997
closedir(dir);
998
}
999
if(p->environ[0] == NULL){
1000
if(execv(filename, p->argv) < 0){
1001
perror("execv");
1002
_exit(EXIT_FAILURE);
1003
}
1004
} else {
1005
if(execve(filename, p->argv, p->environ) < 0){
1006
perror("execve");
1007
_exit(EXIT_FAILURE);
1008
}
1126
1009
}
1127
1010
/* no return */
1128
1011
}
1129
1012
/* Parent process */
1130
close(pipefd[1]); /* Close unused write end of pipe */
1131
close(plugin_fd);
1132
plugin *new_plugin = getplugin(direntries[i]->d_name);
1013
TEMP_FAILURE_RETRY(close(pipefd[1])); /* Close unused write end of
1014
pipe */
1015
free(filename);
1016
plugin *new_plugin = getplugin(dirst->d_name);
1133
1017
if(new_plugin == NULL){
1134
error(0, errno, "getplugin");
1018
perror("getplugin");
1135
1019
ret = (int)(TEMP_FAILURE_RETRY
1136
1020
(sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask,
1137
1021
NULL)));
1138
1022
if(ret < 0){
1139
error(0, errno, "sigprocmask");
1023
perror("sigprocmask");
1140
1024
}
1141
exitstatus = EX_OSERR;
1142
free(direntries[i]);
1025
exitstatus = EXIT_FAILURE;
1143
1026
goto fallback;
1144
1027
}
1145
free(direntries[i]);
1146
1028
1147
1029
new_plugin->pid = pid;
1148
1030
new_plugin->fd = pipefd[0];
1149
1150
if(debug){
1151
fprintf(stderr, "Plugin %s started (PID %" PRIdMAX ")\n",
1152
new_plugin->name, (intmax_t) (new_plugin->pid));
1153
}
1154
1031
1155
1032
/* Unblock SIGCHLD so signal handler can be run if this process
1156
1033
has already completed */
1157
1034
ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1158
1035
&sigchld_action.sa_mask,
1159
1036
NULL));
1160
1037
if(ret < 0){
1161
error(0, errno, "sigprocmask");
1162
exitstatus = EX_OSERR;
1038
perror("sigprocmask");
1039
exitstatus = EXIT_FAILURE;
1163
1040
goto fallback;
1164
1041
}
1165
1042
1166
FD_SET(new_plugin->fd, &rfds_all);
1043
FD_SET(new_plugin->fd, &rfds_all); /* Spurious warning from
1044
-Wconversion */
1167
1045
1168
1046
if(maxfd < new_plugin->fd){
1169
1047
maxfd = new_plugin->fd;
1170
1048
}
1171
1049
}
1172
1050
1173
free(direntries);
1174
direntries = NULL;
1175
close(dir_fd);
1176
dir_fd = -1;
1051
TEMP_FAILURE_RETRY(closedir(dir));
1052
dir = NULL;
1177
1053
free_plugin(getplugin(NULL));
1178
1054
1179
1055
for(plugin *p = plugin_list; p != NULL; p = p->next){
1192
1068
fd_set rfds = rfds_all;
1193
1069
int select_ret = select(maxfd+1, &rfds, NULL, NULL, NULL);
1194
1070
if(select_ret == -1 and errno != EINTR){
1195
error(0, errno, "select");
1196
exitstatus = EX_OSERR;
1071
perror("select");
1072
exitstatus = EXIT_FAILURE;
1197
1073
goto fallback;
1198
1074
}
1199
1075
/* OK, now either a process completed, or something can be read
1218
1094
(intmax_t) (proc->pid),
1219
1095
WTERMSIG(proc->status),
1220
1096
strsignal(WTERMSIG(proc->status)));
1097
} else if(WCOREDUMP(proc->status)){
1098
fprintf(stderr, "Plugin %s [%" PRIdMAX "] dumped"
1099
" core\n", proc->name, (intmax_t) (proc->pid));
1221
1100
}
1222
1101
}
1223
1102
1224
1103
/* Remove the plugin */
1225
FD_CLR(proc->fd, &rfds_all);
1104
FD_CLR(proc->fd, &rfds_all); /* Spurious warning from
1105
-Wconversion */
1226
1106
1227
1107
/* Block signal while modifying process_list */
1228
1108
ret = (int)TEMP_FAILURE_RETRY(sigprocmask
1230
1110
&sigchld_action.sa_mask,
1231
1111
NULL));
1232
1112
if(ret < 0){
1233
error(0, errno, "sigprocmask");
1234
exitstatus = EX_OSERR;
1113
perror("sigprocmask");
1114
exitstatus = EXIT_FAILURE;
1235
1115
goto fallback;
1236
1116
}
1237
1117
1244
1124
(sigprocmask(SIG_UNBLOCK,
1245
1125
&sigchld_action.sa_mask, NULL)));
1246
1126
if(ret < 0){
1247
error(0, errno, "sigprocmask");
1248
exitstatus = EX_OSERR;
1127
perror("sigprocmask");
1128
exitstatus = EXIT_FAILURE;
1249
1129
goto fallback;
1250
1130
}
1251
1131
1261
1141
bool bret = print_out_password(proc->buffer,
1262
1142
proc->buffer_length);
1263
1143
if(not bret){
1264
error(0, errno, "print_out_password");
1265
exitstatus = EX_IOERR;
1144
perror("print_out_password");
1145
exitstatus = EXIT_FAILURE;
1266
1146
}
1267
1147
goto fallback;
1268
1148
}
1269
1149
1270
1150
/* This process has not completed. Does it have any output? */
1271
if(proc->eof or not FD_ISSET(proc->fd, &rfds)){
1151
if(proc->eof or not FD_ISSET(proc->fd, &rfds)){ /* Spurious
1152
warning from
1153
-Wconversion */
1272
1154
/* This process had nothing to say at this time */
1273
1155
proc = proc->next;
1274
1156
continue;
1275
1157
}
1276
1158
/* Before reading, make the process' data buffer large enough */
1277
1159
if(proc->buffer_length + BUFFER_SIZE > proc->buffer_size){
1278
char *new_buffer = realloc(proc->buffer, proc->buffer_size
1279
+ (size_t) BUFFER_SIZE);
1280
if(new_buffer == NULL){
1281
error(0, errno, "malloc");
1282
exitstatus = EX_OSERR;
1160
proc->buffer = realloc(proc->buffer, proc->buffer_size
1161
+ (size_t) BUFFER_SIZE);
1162
if(proc->buffer == NULL){
1163
perror("malloc");
1164
exitstatus = EXIT_FAILURE;
1283
1165
goto fallback;
1284
1166
}
1285
proc->buffer = new_buffer;
1286
1167
proc->buffer_size += BUFFER_SIZE;
1287
1168
}
1288
1169
/* Read from the process */
1307
1188
1308
1189
fallback:
1309
1190
1310
if(plugin_list == NULL or (exitstatus != EXIT_SUCCESS
1311
and exitstatus != EX_OK)){
1191
if(plugin_list == NULL or exitstatus != EXIT_SUCCESS){
1312
1192
/* Fallback if all plugins failed, none are found or an error
1313
1193
occured */
1314
1194
bool bret;
1322
1202
}
1323
1203
bret = print_out_password(passwordbuffer, len);
1324
1204
if(not bret){
1325
error(0, errno, "print_out_password");
1326
exitstatus = EX_IOERR;
1205
perror("print_out_password");
1206
exitstatus = EXIT_FAILURE;
1327
1207
}
1328
1208
}
1329
1209
1330
1210
/* Restore old signal handler */
1331
1211
ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1332
1212
if(ret == -1){
1333
error(0, errno, "sigaction");
1334
exitstatus = EX_OSERR;
1213
perror("sigaction");
1214
exitstatus = EXIT_FAILURE;
1335
1215
}
1336
1216
1337
1217
if(custom_argv != NULL){
1341
1221
free(custom_argv);
1342
1222
}
1343
1223
1344
free(direntries);
1345
1346
if(dir_fd != -1){
1347
close(dir_fd);
1224
if(dir != NULL){
1225
closedir(dir);
1348
1226
}
1349
1227
1350
1228
/* Kill the processes */
1354
1232
ret = kill(p->pid, SIGTERM);
1355
1233
if(ret == -1 and errno != ESRCH){
1356
1234
/* Set-uid proccesses might not get closed */
1357
error(0, errno, "kill");
1235
perror("kill");
1358
1236
}
1359
1237
}
1360
1238
}
1364
1242
ret = wait(NULL);
1365
1243
} while(ret >= 0);
1366
1244
if(errno != ECHILD){
1367
error(0, errno, "wait");
1245
perror("wait");
1368
1246
}
1369
1247
1370
1248
free_plugin_list();
1371
1249
1372
1250
free(plugindir);
1373
free(pluginhelperdir);
1374
1251
free(argfile);
1375
1252
1376
1253
return exitstatus;
Loggerhead is a web-based interface for Breezy
Version: 2.0.2.dev0