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