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-2021 Teddy Hogeborn
6
* Copyright © 2008-2021 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
#define _GNU_SOURCE /* TEMP_FAILURE_RETRY(), getline(),
26
asprintf(), O_CLOEXEC */
26
#define _GNU_SOURCE /* strchrnul(), TEMP_FAILURE_RETRY(),
27
getline(), asprintf(), O_CLOEXEC,
28
scandirat(), pipe2() */
29
#include <argp.h> /* argp_program_version,
30
argp_program_bug_address,
32
struct argp_state, argp_error(),
33
ARGP_NO_EXIT, argp_state_help,
35
ARGP_HELP_USAGE, ARGP_HELP_EXIT_OK,
36
ARGP_KEY_ARG, ARGP_ERR_UNKNOWN,
37
struct argp, argp_parse(),
38
ARGP_IN_ORDER, ARGP_NO_HELP */
39
#include <stdbool.h> /* bool, false, true */
40
#include <sys/types.h> /* pid_t, sig_atomic_t, uid_t, gid_t,
41
getuid(), setgid(), setuid() */
27
42
#include <stddef.h> /* size_t, NULL */
28
#include <stdlib.h> /* malloc(), exit(), EXIT_SUCCESS,
30
#include <stdbool.h> /* bool, true, false */
31
#include <stdio.h> /* perror, fileno(), fprintf(),
32
stderr, STDOUT_FILENO */
33
#include <sys/types.h> /* DIR, fdopendir(), stat(), struct
34
stat, waitpid(), WIFEXITED(),
35
WEXITSTATUS(), wait(), pid_t,
36
uid_t, gid_t, getuid(), getgid(),
38
#include <sys/select.h> /* fd_set, select(), FD_ZERO(),
39
FD_SET(), FD_ISSET(), FD_CLR */
40
#include <sys/wait.h> /* wait(), waitpid(), WIFEXITED(),
41
WEXITSTATUS(), WTERMSIG(),
43
#include <sys/stat.h> /* struct stat, stat(), S_ISREG() */
44
#include <iso646.h> /* and, or, not */
45
#include <dirent.h> /* DIR, struct dirent, fdopendir(),
46
readdir(), closedir(), dirfd() */
47
#include <unistd.h> /* struct stat, stat(), S_ISREG(),
48
fcntl(), setuid(), setgid(),
49
F_GETFD, F_SETFD, FD_CLOEXEC,
50
access(), pipe(), fork(), close()
51
dup2(), STDOUT_FILENO, _exit(),
52
execv(), write(), read(),
43
#include <iso646.h> /* or, and, not */
44
#include <string.h> /* strcmp(), strdup(), strchrnul(),
45
strncmp(), strlen(), strcpy(),
46
strsep(), strchr(), strsignal() */
47
#include <stdlib.h> /* malloc(), free(), reallocarray(),
48
realloc(), EXIT_SUCCESS */
49
#include <errno.h> /* errno, EINTR, ENOMEM, ECHILD,
50
error_t, EINVAL, EMFILE, ENFILE,
52
#include <stdint.h> /* SIZE_MAX */
53
#define _GNU_SOURCE /* strchrnul(), TEMP_FAILURE_RETRY(),
54
getline(), asprintf(), O_CLOEXEC,
55
scandirat(), pipe2() */
56
#include <unistd.h> /* TEMP_FAILURE_RETRY(), ssize_t,
57
write(), STDOUT_FILENO, uid_t,
58
gid_t, getuid(), fchown(), close(),
59
symlink(), setgid(), setuid(),
60
faccessat(), X_OK, pipe(), pipe2(),
61
fork(), _exit(), dup2(), fexecve(),
54
63
#include <fcntl.h> /* fcntl(), F_GETFD, F_SETFD,
56
#include <string.h> /* strsep, strlen(), asprintf(),
58
#include <errno.h> /* errno */
59
#include <argp.h> /* struct argp_option, struct
60
argp_state, struct argp,
61
argp_parse(), ARGP_ERR_UNKNOWN,
62
ARGP_KEY_END, ARGP_KEY_ARG,
64
#include <signal.h> /* struct sigaction, sigemptyset(),
65
sigaddset(), sigaction(),
66
sigprocmask(), SIG_BLOCK, SIGCHLD,
67
SIG_UNBLOCK, kill(), sig_atomic_t
69
#include <errno.h> /* errno, EBADF */
70
#include <inttypes.h> /* intmax_t, PRIdMAX, strtoimax() */
64
FD_CLOEXEC, open(), O_RDONLY,
65
O_CLOEXEC, openat() */
66
#include <sys/wait.h> /* waitpid(), WNOHANG, WIFEXITED(),
67
WEXITSTATUS(), WIFSIGNALED(),
69
#include <error.h> /* error() */
70
#include <stdio.h> /* FILE, fprintf(), fopen(),
71
getline(), fclose(), EOF,
73
#include <dirent.h> /* struct dirent, scandirat(),
75
#include <sys/stat.h> /* struct stat, fstat(), S_ISDIR(),
77
#include <sys/select.h> /* fd_set, FD_ZERO(), FD_SETSIZE,
78
FD_SET(), select(), FD_CLR(),
80
#include <signal.h> /* struct sigaction, SA_NOCLDSTOP,
81
sigemptyset(), sigaddset(),
82
SIGCHLD, sigprocmask(), SIG_BLOCK,
83
SIG_UNBLOCK, kill(), SIGTERM */
71
84
#include <sysexits.h> /* EX_OSERR, EX_USAGE, EX_IOERR,
72
85
EX_CONFIG, EX_UNAVAILABLE, EX_OK */
86
#include <inttypes.h> /* intmax_t, strtoimax(), PRIdMAX */
87
#include <fnmatch.h> /* fnmatch(), FNM_FILE_NAME,
88
FNM_PERIOD, FNM_NOMATCH */
74
90
#define BUFFER_SIZE 256
76
92
#define PDIR "/lib/mandos/plugins.d"
93
#define PHDIR "/lib/mandos/plugin-helpers"
77
94
#define AFILE "/conf/conf.d/mandos/plugin-runner.conf"
79
96
const char *argp_program_version = "plugin-runner " VERSION;
80
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
97
const char *argp_program_bug_address = "<mandos@recompile.se>";
82
99
typedef struct plugin{
83
100
char *name; /* can be NULL or any plugin name */
486
538
plugin *p = getplugin(arg);
488
540
p->disabled = false;
492
545
case 128: /* --plugin-dir */
494
547
plugindir = strdup(arg);
548
if(plugindir != NULL){
496
552
case 129: /* --config-file */
497
553
/* This is already done by parse_opt_config_file() */
499
555
case 130: /* --userid */
500
tmpmax = strtoimax(arg, &tmp, 10);
556
tmp_id = strtoimax(arg, &tmp, 10);
501
557
if(errno != 0 or tmp == arg or *tmp != '\0'
502
or tmpmax != (uid_t)tmpmax){
558
or tmp_id != (uid_t)tmp_id){
503
559
argp_error(state, "Bad user ID number: \"%s\", using %"
504
560
PRIdMAX, arg, (intmax_t)uid);
509
566
case 131: /* --groupid */
510
tmpmax = strtoimax(arg, &tmp, 10);
567
tmp_id = strtoimax(arg, &tmp, 10);
511
568
if(errno != 0 or tmp == arg or *tmp != '\0'
512
or tmpmax != (gid_t)tmpmax){
569
or tmp_id != (gid_t)tmp_id){
513
570
argp_error(state, "Bad group ID number: \"%s\", using %"
514
571
PRIdMAX, arg, (intmax_t)gid);
519
577
case 132: /* --debug */
580
case 133: /* --plugin-helper-dir */
581
free(pluginhelperdir);
582
pluginhelperdir = strdup(arg);
583
if(pluginhelperdir != NULL){
523
588
* These reproduce what we would get without ARGP_NO_HELP
525
590
case '?': /* --help */
526
591
state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
527
592
argp_state_help(state, state->out_stream, ARGP_HELP_STD_HELP);
593
__builtin_unreachable();
528
594
case -3: /* --usage */
529
595
state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
530
596
argp_state_help(state, state->out_stream,
531
597
ARGP_HELP_USAGE | ARGP_HELP_EXIT_OK);
598
__builtin_unreachable();
532
599
case 'V': /* --version */
533
600
fprintf(state->out_stream, "%s\n", argp_program_version);
534
601
exit(EXIT_SUCCESS);
743
/* Strip permissions down to nobody */
854
/* Work around Debian bug #633582:
855
<https://bugs.debian.org/633582> */
856
int plugindir_fd = open(/* plugindir or */ PDIR, O_RDONLY);
857
if(plugindir_fd == -1){
859
error(0, errno, "open(\"" PDIR "\")");
862
ret = (int)TEMP_FAILURE_RETRY(fstat(plugindir_fd, &st));
864
error(0, errno, "fstat");
866
if(S_ISDIR(st.st_mode) and st.st_uid == 0 and st.st_gid == 0){
867
ret = fchown(plugindir_fd, uid, gid);
869
error(0, errno, "fchown");
876
/* Work around Debian bug #981302
877
<https://bugs.debian.org/981302> */
878
if(lstat("/dev/fd", &st) != 0 and errno == ENOENT){
879
ret = symlink("/proc/self/fd", "/dev/fd");
881
error(0, errno, "Failed to create /dev/fd symlink");
886
/* Lower permissions */
889
error(0, errno, "setgid");
748
891
ret = setuid(uid);
893
error(0, errno, "setuid");
753
896
/* Open plugin directory with close_on_exec flag */
756
if(plugindir == NULL){
757
dir_fd = open(PDIR, O_RDONLY |
760
#else /* not O_CLOEXEC */
762
#endif /* not O_CLOEXEC */
765
dir_fd = open(plugindir, O_RDONLY |
768
#else /* not O_CLOEXEC */
770
#endif /* not O_CLOEXEC */
898
dir_fd = open(plugindir != NULL ? plugindir : PDIR, O_RDONLY |
901
#else /* not O_CLOEXEC */
903
#endif /* not O_CLOEXEC */
773
905
if(dir_fd == -1){
774
perror("Could not open plugin dir");
906
error(0, errno, "Could not open plugin dir");
775
907
exitstatus = EX_UNAVAILABLE;
780
912
/* Set the FD_CLOEXEC flag on the directory */
781
913
ret = set_cloexec_flag(dir_fd);
783
perror("set_cloexec_flag");
784
TEMP_FAILURE_RETRY(close(dir_fd));
915
error(0, errno, "set_cloexec_flag");
785
916
exitstatus = EX_OSERR;
788
919
#endif /* O_CLOEXEC */
790
dir = fdopendir(dir_fd);
792
perror("Could not open plugin dir");
793
TEMP_FAILURE_RETRY(close(dir_fd));
794
exitstatus = EX_OSERR;
922
int good_name(const struct dirent * const dirent){
923
const char * const patterns[] = { ".*", "#*#", "*~", "*.dpkg-new",
924
"*.dpkg-old", "*.dpkg-bak",
925
"*.dpkg-divert", NULL };
927
#pragma GCC diagnostic push
928
#pragma GCC diagnostic ignored "-Wcast-qual"
930
for(const char **pat = (const char **)patterns;
931
*pat != NULL; pat++){
933
#pragma GCC diagnostic pop
935
if(fnmatch(*pat, dirent->d_name, FNM_FILE_NAME | FNM_PERIOD)
938
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
939
" matching pattern %s\n", dirent->d_name, *pat);
947
int numplugins = scandirat(dir_fd, ".", &direntries, good_name,
949
if(numplugins == -1){
950
error(0, errno, "Could not scan plugin dir");
952
exitstatus = EX_OSERR;
799
956
FD_ZERO(&rfds_all);
801
958
/* Read and execute any executable in the plugin directory*/
804
dirst = readdir(dir);
805
} while(dirst == NULL and errno == EINTR);
807
/* All directory entries have been processed */
811
exitstatus = EX_IOERR;
817
d_name_len = strlen(dirst->d_name);
819
/* Ignore dotfiles, backup files and other junk */
821
bool bad_name = false;
823
const char const *bad_prefixes[] = { ".", "#", NULL };
825
const char const *bad_suffixes[] = { "~", "#", ".dpkg-new",
828
".dpkg-divert", NULL };
829
for(const char **pre = bad_prefixes; *pre != NULL; pre++){
830
size_t pre_len = strlen(*pre);
831
if((d_name_len >= pre_len)
832
and strncmp((dirst->d_name), *pre, pre_len) == 0){
834
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
835
" with bad prefix %s\n", dirst->d_name, *pre);
844
for(const char **suf = bad_suffixes; *suf != NULL; suf++){
845
size_t suf_len = strlen(*suf);
846
if((d_name_len >= suf_len)
847
and (strcmp((dirst->d_name)+d_name_len-suf_len, *suf)
850
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
851
" with bad suffix %s\n", dirst->d_name, *suf);
864
if(plugindir == NULL){
865
ret = (int)TEMP_FAILURE_RETRY(asprintf(&filename, PDIR "/%s",
868
ret = (int)TEMP_FAILURE_RETRY(asprintf(&filename, "%s/%s",
959
for(int i = 0; i < numplugins; i++){
961
int plugin_fd = openat(dir_fd, direntries[i]->d_name, O_RDONLY);
963
error(0, errno, "Could not open plugin");
877
ret = (int)TEMP_FAILURE_RETRY(stat(filename, &st));
967
ret = (int)TEMP_FAILURE_RETRY(fstat(plugin_fd, &st));
969
error(0, errno, "stat");
884
975
/* Ignore non-executable files */
885
976
if(not S_ISREG(st.st_mode)
886
or (TEMP_FAILURE_RETRY(access(filename, X_OK)) != 0)){
977
or (TEMP_FAILURE_RETRY(faccessat(dir_fd, direntries[i]->d_name,
888
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
889
" with bad type or mode\n", filename);
980
fprintf(stderr, "Ignoring plugin dir entry \"%s/%s\""
981
" with bad type or mode\n",
982
plugindir != NULL ? plugindir : PDIR,
983
direntries[i]->d_name);
895
plugin *p = getplugin(dirst->d_name);
990
plugin *p = getplugin(direntries[i]->d_name);
992
error(0, errno, "getplugin");
903
999
fprintf(stderr, "Ignoring disabled plugin \"%s\"\n",
1000
direntries[i]->d_name);
1003
free(direntries[i]);
913
1010
for(char **a = g->argv + 1; *a != NULL; a++){
914
1011
if(not add_argument(p, *a)){
915
perror("add_argument");
1012
error(0, errno, "add_argument");
918
1015
/* Add global environment variables */
919
1016
for(char **e = g->environ; *e != NULL; e++){
920
1017
if(not add_environment(p, *e, false)){
921
perror("add_environment");
1018
error(0, errno, "add_environment");
926
/* If this plugin has any environment variables, we will call
927
using execve and need to duplicate the environment from this
1023
/* If this plugin has any environment variables, we need to
1024
duplicate the environment from this process, too. */
929
1025
if(p->environ[0] != NULL){
930
1026
for(char **e = environ; *e != NULL; e++){
931
1027
if(not add_environment(p, *e, false)){
932
perror("add_environment");
1028
error(0, errno, "add_environment");
938
1035
ret = (int)TEMP_FAILURE_RETRY(pipe(pipefd));
1036
#else /* O_CLOEXEC */
1037
ret = (int)TEMP_FAILURE_RETRY(pipe2(pipefd, O_CLOEXEC));
1038
#endif /* O_CLOEXEC */
941
exitstatus = EX_OSERR;
1040
error(0, errno, "pipe");
1041
exitstatus = EX_OSERR;
1042
free(direntries[i]);
1045
if(pipefd[0] >= FD_SETSIZE){
1046
fprintf(stderr, "pipe()[0] (%d) >= FD_SETSIZE (%d)", pipefd[0],
1050
exitstatus = EX_OSERR;
1051
free(direntries[i]);
944
1055
/* Ask OS to automatic close the pipe on exec */
945
1056
ret = set_cloexec_flag(pipefd[0]);
947
perror("set_cloexec_flag");
1058
error(0, errno, "set_cloexec_flag");
948
1061
exitstatus = EX_OSERR;
1062
free(direntries[i]);
951
1065
ret = set_cloexec_flag(pipefd[1]);
953
perror("set_cloexec_flag");
1067
error(0, errno, "set_cloexec_flag");
954
1070
exitstatus = EX_OSERR;
1071
free(direntries[i]);
1074
#endif /* not O_CLOEXEC */
957
1075
/* Block SIGCHLD until process is safely in process list */
958
1076
ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_BLOCK,
959
1077
&sigchld_action.sa_mask,
962
perror("sigprocmask");
1080
error(0, errno, "sigprocmask");
963
1081
exitstatus = EX_OSERR;
1082
free(direntries[i]);
966
1085
/* Starting a new process to be watched */
970
1089
} while(pid == -1 and errno == EINTR);
1091
error(0, errno, "fork");
1092
TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1093
&sigchld_action.sa_mask, NULL));
973
1096
exitstatus = EX_OSERR;
1097
free(direntries[i]);
977
1101
/* this is the child process */
978
1102
ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1104
error(0, errno, "sigaction");
981
1105
_exit(EX_OSERR);
983
1107
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
985
perror("sigprocmask");
1109
error(0, errno, "sigprocmask");
986
1110
_exit(EX_OSERR);
989
1113
ret = dup2(pipefd[1], STDOUT_FILENO); /* replace our stdout */
1115
error(0, errno, "dup2");
992
1116
_exit(EX_OSERR);
996
/* If dir has no file descriptor, we could not set FD_CLOEXEC
997
above and must now close it manually here. */
1000
if(p->environ[0] == NULL){
1001
if(execv(filename, p->argv) < 0){
1006
if(execve(filename, p->argv, p->environ) < 0){
1119
if(fexecve(plugin_fd, p->argv,
1120
(p->environ[0] != NULL) ? p->environ : environ) < 0){
1121
error(0, errno, "fexecve for %s/%s",
1122
plugindir != NULL ? plugindir : PDIR,
1123
direntries[i]->d_name);
1011
1126
/* no return */
1013
1128
/* Parent process */
1014
TEMP_FAILURE_RETRY(close(pipefd[1])); /* Close unused write end of
1017
plugin *new_plugin = getplugin(dirst->d_name);
1129
close(pipefd[1]); /* Close unused write end of pipe */
1131
plugin *new_plugin = getplugin(direntries[i]->d_name);
1018
1132
if(new_plugin == NULL){
1019
perror("getplugin");
1133
error(0, errno, "getplugin");
1020
1134
ret = (int)(TEMP_FAILURE_RETRY
1021
1135
(sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask,
1024
perror("sigprocmask");
1138
error(0, errno, "sigprocmask");
1026
1140
exitstatus = EX_OSERR;
1141
free(direntries[i]);
1144
free(direntries[i]);
1030
1146
new_plugin->pid = pid;
1031
1147
new_plugin->fd = pipefd[0];
1150
fprintf(stderr, "Plugin %s started (PID %" PRIdMAX ")\n",
1151
new_plugin->name, (intmax_t) (new_plugin->pid));
1033
1154
/* Unblock SIGCHLD so signal handler can be run if this process
1034
1155
has already completed */
1035
1156
ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1036
1157
&sigchld_action.sa_mask,
1039
perror("sigprocmask");
1160
error(0, errno, "sigprocmask");
1040
1161
exitstatus = EX_OSERR;
1044
FD_SET(new_plugin->fd, &rfds_all); /* Spurious warning from
1165
FD_SET(new_plugin->fd, &rfds_all);
1047
1167
if(maxfd < new_plugin->fd){
1048
1168
maxfd = new_plugin->fd;
1052
TEMP_FAILURE_RETRY(closedir(dir));
1054
1176
free_plugin(getplugin(NULL));
1056
1178
for(plugin *p = plugin_list; p != NULL; p = p->next){