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