3
3
* Mandos plugin runner - Run Mandos plugins
5
* Copyright © 2008,2009 Teddy Hogeborn
6
* Copyright © 2008,2009 Björn Påhlsson
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.
13
* This program is distributed in the hope that it will be useful, but
5
* Copyright © 2008-2020 Teddy Hogeborn
6
* Copyright © 2008-2020 Björn Påhlsson
8
* This file is part of Mandos.
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.
15
* Mandos is distributed in the hope that it will be useful, but
14
16
* WITHOUT ANY WARRANTY; without even the implied warranty of
15
17
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
18
* General Public License for more details.
18
20
* You should have received a copy of the GNU General Public License
19
* along with this program. If not, see
20
* <http://www.gnu.org/licenses/>.
21
* along with Mandos. If not, see <http://www.gnu.org/licenses/>.
22
* Contact the authors at <mandos@fukt.bsnet.se>.
23
* Contact the authors at <mandos@recompile.se>.
25
26
#define _GNU_SOURCE /* TEMP_FAILURE_RETRY(), getline(),
27
28
#include <stddef.h> /* size_t, NULL */
28
#include <stdlib.h> /* malloc(), exit(), EXIT_FAILURE,
29
EXIT_SUCCESS, realloc() */
29
#include <stdlib.h> /* malloc(), reallocarray(), realloc(),
30
EXIT_SUCCESS, exit() */
30
31
#include <stdbool.h> /* bool, true, false */
31
#include <stdio.h> /* perror, fileno(), fprintf(),
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(),
32
#include <stdio.h> /* fileno(), fprintf(),
33
stderr, STDOUT_FILENO, fclose() */
34
#include <sys/types.h> /* fstat(), struct stat, waitpid(),
35
WIFEXITED(), WEXITSTATUS(), wait(),
36
pid_t, uid_t, gid_t, getuid(),
38
38
#include <sys/select.h> /* fd_set, select(), FD_ZERO(),
39
39
FD_SET(), FD_ISSET(), FD_CLR */
40
40
#include <sys/wait.h> /* wait(), waitpid(), WIFEXITED(),
41
WEXITSTATUS(), WTERMSIG(),
43
#include <sys/stat.h> /* struct stat, stat(), S_ISREG() */
41
WEXITSTATUS(), WTERMSIG() */
42
#include <sys/stat.h> /* struct stat, fstat(), S_ISREG() */
44
43
#include <iso646.h> /* and, or, not */
45
#include <dirent.h> /* DIR, struct dirent, opendir(),
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(),
44
#include <dirent.h> /* struct dirent, scandirat() */
45
#include <unistd.h> /* fcntl(), F_GETFD, F_SETFD,
46
FD_CLOEXEC, write(), STDOUT_FILENO,
47
struct stat, fstat(), close(),
48
setgid(), setuid(), S_ISREG(),
49
faccessat() pipe2(), fork(),
50
_exit(), dup2(), fexecve(), read()
54
52
#include <fcntl.h> /* fcntl(), F_GETFD, F_SETFD,
56
#include <string.h> /* strsep, strlen(), asprintf(),
53
FD_CLOEXEC, openat(), scandirat(),
55
#include <string.h> /* strsep, strlen(), strsignal(),
56
strcmp(), strncmp() */
58
57
#include <errno.h> /* errno */
59
58
#include <argp.h> /* struct argp_option, struct
60
59
argp_state, struct argp,
376
428
.doc = "Group ID the plugins will run as", .group = 3 },
377
429
{ .name = "debug", .key = 132,
378
430
.doc = "Debug mode", .group = 4 },
431
{ .name = "plugin-helper-dir", .key = 133,
433
.doc = "Specify a different plugin helper directory",
436
* These reproduce what we would get without ARGP_NO_HELP
438
{ .name = "help", .key = '?',
439
.doc = "Give this help list", .group = -1 },
440
{ .name = "usage", .key = -3,
441
.doc = "Give a short usage message", .group = -1 },
442
{ .name = "version", .key = 'V',
443
.doc = "Print program version", .group = -1 },
382
error_t parse_opt(int key, char *arg, __attribute__((unused))
383
struct argp_state *state){
447
__attribute__((nonnull(3)))
448
error_t parse_opt(int key, char *arg, struct argp_state *state){
387
453
case 'g': /* --global-options */
389
455
char *plugin_option;
390
456
while((plugin_option = strsep(&arg, ",")) != NULL){
391
if(plugin_option[0] == '\0'){
394
457
if(not add_argument(getplugin(NULL), plugin_option)){
395
perror("add_argument");
396
return ARGP_ERR_UNKNOWN;
401
464
case 'G': /* --global-env */
405
if(not add_environment(getplugin(NULL), arg, true)){
406
perror("add_environment");
465
if(add_environment(getplugin(NULL), arg, true)){
409
469
case 'o': /* --options-for */
411
char *plugin_name = strsep(&arg, ":");
412
if(plugin_name[0] == '\0'){
416
while((plugin_option = strsep(&arg, ",")) != NULL){
417
if(not add_argument(getplugin(plugin_name), plugin_option)){
418
perror("add_argument");
419
return ARGP_ERR_UNKNOWN;
471
char *option_list = strchr(arg, ':');
472
if(option_list == NULL){
473
argp_error(state, "No colon in \"%s\"", arg);
480
argp_error(state, "Empty plugin name");
485
while((option = strsep(&option_list, ",")) != NULL){
486
if(not add_argument(getplugin(arg), option)){
424
493
case 'E': /* --env-for */
429
495
char *envdef = strchr(arg, ':');
430
496
if(envdef == NULL){
497
argp_error(state, "No colon in \"%s\"", arg);
434
if(not add_environment(getplugin(arg), envdef+1, true)){
435
perror("add_environment");
504
argp_error(state, "Empty plugin name");
508
if(add_environment(getplugin(arg), envdef, true)){
439
513
case 'd': /* --disable */
441
515
plugin *p = getplugin(arg);
443
return ARGP_ERR_UNKNOWN;
448
522
case 'e': /* --enable */
450
524
plugin *p = getplugin(arg);
452
return ARGP_ERR_UNKNOWN;
457
531
case 128: /* --plugin-dir */
459
533
plugindir = strdup(arg);
460
if(plugindir == NULL){
534
if(plugindir != NULL){
464
538
case 129: /* --config-file */
465
539
/* This is already done by parse_opt_config_file() */
467
541
case 130: /* --userid */
469
tmpmax = strtoimax(arg, &tmp, 10);
542
tmp_id = strtoimax(arg, &tmp, 10);
470
543
if(errno != 0 or tmp == arg or *tmp != '\0'
471
or tmpmax != (uid_t)tmpmax){
472
fprintf(stderr, "Bad user ID number: \"%s\", using %"
473
PRIdMAX "\n", arg, (intmax_t)uid);
544
or tmp_id != (uid_t)tmp_id){
545
argp_error(state, "Bad user ID number: \"%s\", using %"
546
PRIdMAX, arg, (intmax_t)uid);
478
552
case 131: /* --groupid */
480
tmpmax = strtoimax(arg, &tmp, 10);
553
tmp_id = strtoimax(arg, &tmp, 10);
481
554
if(errno != 0 or tmp == arg or *tmp != '\0'
482
or tmpmax != (gid_t)tmpmax){
483
fprintf(stderr, "Bad group ID number: \"%s\", using %"
484
PRIdMAX "\n", arg, (intmax_t)gid);
555
or tmp_id != (gid_t)tmp_id){
556
argp_error(state, "Bad group ID number: \"%s\", using %"
557
PRIdMAX, arg, (intmax_t)gid);
489
563
case 132: /* --debug */
566
case 133: /* --plugin-helper-dir */
567
free(pluginhelperdir);
568
pluginhelperdir = strdup(arg);
569
if(pluginhelperdir != NULL){
574
* These reproduce what we would get without ARGP_NO_HELP
576
case '?': /* --help */
577
state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
578
argp_state_help(state, state->out_stream, ARGP_HELP_STD_HELP);
579
__builtin_unreachable();
580
case -3: /* --usage */
581
state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
582
argp_state_help(state, state->out_stream,
583
ARGP_HELP_USAGE | ARGP_HELP_EXIT_OK);
584
__builtin_unreachable();
585
case 'V': /* --version */
586
fprintf(state->out_stream, "%s\n", argp_program_version);
493
590
* When adding more options before this line, remember to also add a
494
591
* "case" to the "parse_opt_config_file" function below.
630
759
/* Check for harmful errors and go to fallback. Other errors might
631
760
not affect opening plugins */
632
761
if(errno == EMFILE or errno == ENFILE or errno == ENOMEM){
634
exitstatus = EXIT_FAILURE;
762
error(0, errno, "fopen");
763
exitstatus = EX_OSERR;
638
/* If there was any arguments from configuration file,
639
pass them to parser as command arguments */
767
/* If there were any arguments from the configuration file, pass
768
them to parser as command line arguments */
640
769
if(custom_argv != NULL){
641
ret = argp_parse(&argp, custom_argc, custom_argv, ARGP_IN_ORDER,
643
if(ret == ARGP_ERR_UNKNOWN){
644
fprintf(stderr, "Unknown error while parsing arguments\n");
645
exitstatus = EXIT_FAILURE;
770
ret = argp_parse(&argp, custom_argc, custom_argv,
771
ARGP_IN_ORDER | ARGP_NO_EXIT | ARGP_NO_HELP,
779
error(0, errno, "argp_parse");
780
exitstatus = EX_OSERR;
783
exitstatus = EX_CONFIG;
650
788
/* Parse actual command line arguments, to let them override the
652
ret = argp_parse(&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
653
if(ret == ARGP_ERR_UNKNOWN){
654
fprintf(stderr, "Unknown error while parsing arguments\n");
655
exitstatus = EXIT_FAILURE;
790
ret = argp_parse(&argp, argc, argv,
791
ARGP_IN_ORDER | ARGP_NO_EXIT | ARGP_NO_HELP,
799
error(0, errno, "argp_parse");
800
exitstatus = EX_OSERR;
803
exitstatus = EX_USAGE;
808
char *pluginhelperenv;
810
ret = asprintf(&pluginhelperenv, "MANDOSPLUGINHELPERDIR=%s",
811
pluginhelperdir != NULL ? pluginhelperdir : PHDIR);
813
bret = add_environment(getplugin(NULL), pluginhelperenv, true);
815
if(ret == -1 or not bret){
816
error(0, errno, "Failed to set MANDOSPLUGINHELPERDIR"
817
" environment variable to \"%s\" for all plugins\n",
818
pluginhelperdir != NULL ? pluginhelperdir : PHDIR);
821
free(pluginhelperenv);
660
for(plugin *p = plugin_list; p != NULL; p=p->next){
826
for(plugin *p = plugin_list; p != NULL; p = p->next){
661
827
fprintf(stderr, "Plugin: %s has %d arguments\n",
662
828
p->name ? p->name : "Global", p->argc - 1);
663
829
for(char **a = p->argv; *a != NULL; a++){
673
/* Strip permissions down to nobody */
840
/* Work around Debian bug #633582:
841
<https://bugs.debian.org/633582> */
842
int plugindir_fd = open(/* plugindir or */ PDIR, O_RDONLY);
843
if(plugindir_fd == -1){
845
error(0, errno, "open(\"" PDIR "\")");
848
ret = (int)TEMP_FAILURE_RETRY(fstat(plugindir_fd, &st));
850
error(0, errno, "fstat");
852
if(S_ISDIR(st.st_mode) and st.st_uid == 0 and st.st_gid == 0){
853
ret = fchown(plugindir_fd, uid, gid);
855
error(0, errno, "fchown");
863
/* Lower permissions */
866
error(0, errno, "setgid");
678
868
ret = setuid(uid);
683
if(plugindir == NULL){
686
dir = opendir(plugindir);
690
perror("Could not open plugin dir");
691
exitstatus = EXIT_FAILURE;
695
/* Set the FD_CLOEXEC flag on the directory, if possible */
870
error(0, errno, "setuid");
873
/* Open plugin directory with close_on_exec flag */
697
int dir_fd = dirfd(dir);
699
ret = set_cloexec_flag(dir_fd);
701
perror("set_cloexec_flag");
702
exitstatus = EXIT_FAILURE;
875
dir_fd = open(plugindir != NULL ? plugindir : PDIR, O_RDONLY |
878
#else /* not O_CLOEXEC */
880
#endif /* not O_CLOEXEC */
883
error(0, errno, "Could not open plugin dir");
884
exitstatus = EX_UNAVAILABLE;
889
/* Set the FD_CLOEXEC flag on the directory */
890
ret = set_cloexec_flag(dir_fd);
892
error(0, errno, "set_cloexec_flag");
893
exitstatus = EX_OSERR;
896
#endif /* O_CLOEXEC */
899
int good_name(const struct dirent * const dirent){
900
const char * const patterns[] = { ".*", "#*#", "*~", "*.dpkg-new",
901
"*.dpkg-old", "*.dpkg-bak",
902
"*.dpkg-divert", NULL };
904
#pragma GCC diagnostic push
905
#pragma GCC diagnostic ignored "-Wcast-qual"
907
for(const char **pat = (const char **)patterns;
908
*pat != NULL; pat++){
910
#pragma GCC diagnostic pop
912
if(fnmatch(*pat, dirent->d_name, FNM_FILE_NAME | FNM_PERIOD)
915
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
916
" matching pattern %s\n", dirent->d_name, *pat);
924
int numplugins = scandirat(dir_fd, ".", &direntries, good_name,
926
if(numplugins == -1){
927
error(0, errno, "Could not scan plugin dir");
929
exitstatus = EX_OSERR;
708
933
FD_ZERO(&rfds_all);
710
935
/* Read and execute any executable in the plugin directory*/
712
dirst = readdir(dir);
714
/* All directory entries have been processed */
718
exitstatus = EXIT_FAILURE;
724
d_name_len = strlen(dirst->d_name);
726
/* Ignore dotfiles, backup files and other junk */
728
bool bad_name = false;
730
const char const *bad_prefixes[] = { ".", "#", NULL };
732
const char const *bad_suffixes[] = { "~", "#", ".dpkg-new",
735
".dpkg-divert", NULL };
736
for(const char **pre = bad_prefixes; *pre != NULL; pre++){
737
size_t pre_len = strlen(*pre);
738
if((d_name_len >= pre_len)
739
and strncmp((dirst->d_name), *pre, pre_len) == 0){
741
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
742
" with bad prefix %s\n", dirst->d_name, *pre);
751
for(const char **suf = bad_suffixes; *suf != NULL; suf++){
752
size_t suf_len = strlen(*suf);
753
if((d_name_len >= suf_len)
754
and (strcmp((dirst->d_name)+d_name_len-suf_len, *suf)
757
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
758
" with bad suffix %s\n", dirst->d_name, *suf);
771
if(plugindir == NULL){
772
ret = asprintf(&filename, PDIR "/%s", dirst->d_name);
774
ret = asprintf(&filename, "%s/%s", plugindir, dirst->d_name);
936
for(int i = 0; i < numplugins; i++){
938
int plugin_fd = openat(dir_fd, direntries[i]->d_name, O_RDONLY);
940
error(0, errno, "Could not open plugin");
781
ret = stat(filename, &st);
944
ret = (int)TEMP_FAILURE_RETRY(fstat(plugin_fd, &st));
946
error(0, errno, "stat");
788
952
/* Ignore non-executable files */
789
if(not S_ISREG(st.st_mode) or (access(filename, X_OK) != 0)){
953
if(not S_ISREG(st.st_mode)
954
or (TEMP_FAILURE_RETRY(faccessat(dir_fd, direntries[i]->d_name,
791
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
792
" with bad type or mode\n", filename);
957
fprintf(stderr, "Ignoring plugin dir entry \"%s/%s\""
958
" with bad type or mode\n",
959
plugindir != NULL ? plugindir : PDIR,
960
direntries[i]->d_name);
798
plugin *p = getplugin(dirst->d_name);
967
plugin *p = getplugin(direntries[i]->d_name);
969
error(0, errno, "getplugin");
806
976
fprintf(stderr, "Ignoring disabled plugin \"%s\"\n",
977
direntries[i]->d_name);
816
987
for(char **a = g->argv + 1; *a != NULL; a++){
817
988
if(not add_argument(p, *a)){
818
perror("add_argument");
989
error(0, errno, "add_argument");
821
992
/* Add global environment variables */
822
993
for(char **e = g->environ; *e != NULL; e++){
823
994
if(not add_environment(p, *e, false)){
824
perror("add_environment");
995
error(0, errno, "add_environment");
829
/* If this plugin has any environment variables, we will call
830
using execve and need to duplicate the environment from this
1000
/* If this plugin has any environment variables, we need to
1001
duplicate the environment from this process, too. */
832
1002
if(p->environ[0] != NULL){
833
1003
for(char **e = environ; *e != NULL; e++){
834
1004
if(not add_environment(p, *e, false)){
835
perror("add_environment");
1005
error(0, errno, "add_environment");
1012
ret = (int)TEMP_FAILURE_RETRY(pipe(pipefd));
1013
#else /* O_CLOEXEC */
1014
ret = (int)TEMP_FAILURE_RETRY(pipe2(pipefd, O_CLOEXEC));
1015
#endif /* O_CLOEXEC */
844
exitstatus = EXIT_FAILURE;
1017
error(0, errno, "pipe");
1018
exitstatus = EX_OSERR;
1019
free(direntries[i]);
1022
if(pipefd[0] >= FD_SETSIZE){
1023
fprintf(stderr, "pipe()[0] (%d) >= FD_SETSIZE (%d)", pipefd[0],
1027
exitstatus = EX_OSERR;
1028
free(direntries[i]);
847
1032
/* Ask OS to automatic close the pipe on exec */
848
1033
ret = set_cloexec_flag(pipefd[0]);
850
perror("set_cloexec_flag");
851
exitstatus = EXIT_FAILURE;
1035
error(0, errno, "set_cloexec_flag");
1038
exitstatus = EX_OSERR;
1039
free(direntries[i]);
854
1042
ret = set_cloexec_flag(pipefd[1]);
856
perror("set_cloexec_flag");
857
exitstatus = EXIT_FAILURE;
1044
error(0, errno, "set_cloexec_flag");
1047
exitstatus = EX_OSERR;
1048
free(direntries[i]);
1051
#endif /* not O_CLOEXEC */
860
1052
/* Block SIGCHLD until process is safely in process list */
861
ret = sigprocmask(SIG_BLOCK, &sigchld_action.sa_mask, NULL);
1053
ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_BLOCK,
1054
&sigchld_action.sa_mask,
863
perror("sigprocmask");
864
exitstatus = EXIT_FAILURE;
1057
error(0, errno, "sigprocmask");
1058
exitstatus = EX_OSERR;
1059
free(direntries[i]);
867
1062
/* Starting a new process to be watched */
1066
} while(pid == -1 and errno == EINTR);
871
exitstatus = EXIT_FAILURE;
1068
error(0, errno, "fork");
1069
TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1070
&sigchld_action.sa_mask, NULL));
1073
exitstatus = EX_OSERR;
1074
free(direntries[i]);
875
1078
/* this is the child process */
876
1079
ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1081
error(0, errno, "sigaction");
881
1084
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
883
perror("sigprocmask");
1086
error(0, errno, "sigprocmask");
887
1090
ret = dup2(pipefd[1], STDOUT_FILENO); /* replace our stdout */
1092
error(0, errno, "dup2");
894
/* If dir has no file descriptor, we could not set FD_CLOEXEC
895
above and must now close it manually here. */
898
if(p->environ[0] == NULL){
899
if(execv(filename, p->argv) < 0){
904
if(execve(filename, p->argv, p->environ) < 0){
1096
if(fexecve(plugin_fd, p->argv,
1097
(p->environ[0] != NULL) ? p->environ : environ) < 0){
1098
error(0, errno, "fexecve for %s/%s",
1099
plugindir != NULL ? plugindir : PDIR,
1100
direntries[i]->d_name);
911
1105
/* Parent process */
912
1106
close(pipefd[1]); /* Close unused write end of pipe */
914
plugin *new_plugin = getplugin(dirst->d_name);
1108
plugin *new_plugin = getplugin(direntries[i]->d_name);
915
1109
if(new_plugin == NULL){
917
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1110
error(0, errno, "getplugin");
1111
ret = (int)(TEMP_FAILURE_RETRY
1112
(sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask,
919
perror("sigprocmask");
1115
error(0, errno, "sigprocmask");
921
exitstatus = EXIT_FAILURE;
1117
exitstatus = EX_OSERR;
1118
free(direntries[i]);
1121
free(direntries[i]);
925
1123
new_plugin->pid = pid;
926
1124
new_plugin->fd = pipefd[0];
1127
fprintf(stderr, "Plugin %s started (PID %" PRIdMAX ")\n",
1128
new_plugin->name, (intmax_t) (new_plugin->pid));
928
1131
/* Unblock SIGCHLD so signal handler can be run if this process
929
1132
has already completed */
930
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1133
ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1134
&sigchld_action.sa_mask,
932
perror("sigprocmask");
933
exitstatus = EXIT_FAILURE;
1137
error(0, errno, "sigprocmask");
1138
exitstatus = EX_OSERR;