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-2022 Teddy Hogeborn
6
* Copyright © 2008-2022 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(),
57
strsignal(), strcmp(), strncmp() */
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 */
855
/* Work around Debian bug #633582:
856
<https://bugs.debian.org/633582> */
857
int plugindir_fd = open(/* plugindir or */ PDIR, O_RDONLY);
858
if(plugindir_fd == -1){
860
error(0, errno, "open(\"" PDIR "\")");
863
ret = (int)TEMP_FAILURE_RETRY(fstat(plugindir_fd, &st));
865
error(0, errno, "fstat");
867
if(S_ISDIR(st.st_mode) and st.st_uid == 0 and st.st_gid == 0){
868
ret = fchown(plugindir_fd, uid, gid);
870
error(0, errno, "fchown");
877
/* Work around Debian bug #981302
878
<https://bugs.debian.org/981302> */
879
if(lstat("/dev/fd", &st) != 0 and errno == ENOENT){
880
ret = symlink("/proc/self/fd", "/dev/fd");
882
error(0, errno, "Failed to create /dev/fd symlink");
887
/* Lower permissions */
890
error(0, errno, "setgid");
748
892
ret = setuid(uid);
894
error(0, errno, "setuid");
753
897
/* 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 */
899
dir_fd = open(plugindir != NULL ? plugindir : PDIR, O_RDONLY |
902
#else /* not O_CLOEXEC */
904
#endif /* not O_CLOEXEC */
773
906
if(dir_fd == -1){
774
perror("Could not open plugin dir");
907
error(0, errno, "Could not open plugin dir");
775
908
exitstatus = EX_UNAVAILABLE;
780
913
/* Set the FD_CLOEXEC flag on the directory */
781
914
ret = set_cloexec_flag(dir_fd);
783
perror("set_cloexec_flag");
784
TEMP_FAILURE_RETRY(close(dir_fd));
916
error(0, errno, "set_cloexec_flag");
785
917
exitstatus = EX_OSERR;
788
920
#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;
923
int good_name(const struct dirent * const dirent){
924
const char * const patterns[] = { ".*", "#*#", "*~", "*.dpkg-new",
925
"*.dpkg-old", "*.dpkg-bak",
926
"*.dpkg-divert", NULL };
928
#pragma GCC diagnostic push
929
#pragma GCC diagnostic ignored "-Wcast-qual"
931
for(const char **pat = (const char **)patterns;
932
*pat != NULL; pat++){
934
#pragma GCC diagnostic pop
936
if(fnmatch(*pat, dirent->d_name, FNM_FILE_NAME | FNM_PERIOD)
939
fprintf(stderr, "Ignoring plugin dir entry \"%s\""
940
" matching pattern %s\n", dirent->d_name, *pat);
948
int numplugins = scandirat(dir_fd, ".", &direntries, good_name,
950
if(numplugins == -1){
951
error(0, errno, "Could not scan plugin dir");
953
exitstatus = EX_OSERR;
799
957
FD_ZERO(&rfds_all);
801
959
/* 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",
960
for(int i = 0; i < numplugins; i++){
962
int plugin_fd = openat(dir_fd, direntries[i]->d_name, O_RDONLY);
964
error(0, errno, "Could not open plugin");
877
ret = (int)TEMP_FAILURE_RETRY(stat(filename, &st));
968
ret = (int)TEMP_FAILURE_RETRY(fstat(plugin_fd, &st));
970
error(0, errno, "stat");
884
976
/* Ignore non-executable files */
885
977
if(not S_ISREG(st.st_mode)
886
or (TEMP_FAILURE_RETRY(access(filename, X_OK)) != 0)){
978
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);
981
fprintf(stderr, "Ignoring plugin dir entry \"%s/%s\""
982
" with bad type or mode\n",
983
plugindir != NULL ? plugindir : PDIR,
984
direntries[i]->d_name);
895
plugin *p = getplugin(dirst->d_name);
991
plugin *p = getplugin(direntries[i]->d_name);
993
error(0, errno, "getplugin");
903
1000
fprintf(stderr, "Ignoring disabled plugin \"%s\"\n",
1001
direntries[i]->d_name);
1004
free(direntries[i]);
913
1011
for(char **a = g->argv + 1; *a != NULL; a++){
914
1012
if(not add_argument(p, *a)){
915
perror("add_argument");
1013
error(0, errno, "add_argument");
918
1016
/* Add global environment variables */
919
1017
for(char **e = g->environ; *e != NULL; e++){
920
1018
if(not add_environment(p, *e, false)){
921
perror("add_environment");
1019
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
1024
/* If this plugin has any environment variables, we need to
1025
duplicate the environment from this process, too. */
929
1026
if(p->environ[0] != NULL){
930
1027
for(char **e = environ; *e != NULL; e++){
931
1028
if(not add_environment(p, *e, false)){
932
perror("add_environment");
1029
error(0, errno, "add_environment");
938
1036
ret = (int)TEMP_FAILURE_RETRY(pipe(pipefd));
1037
#else /* O_CLOEXEC */
1038
ret = (int)TEMP_FAILURE_RETRY(pipe2(pipefd, O_CLOEXEC));
1039
#endif /* O_CLOEXEC */
941
exitstatus = EX_OSERR;
1041
error(0, errno, "pipe");
1042
exitstatus = EX_OSERR;
1043
free(direntries[i]);
1046
if(pipefd[0] >= FD_SETSIZE){
1047
fprintf(stderr, "pipe()[0] (%d) >= FD_SETSIZE (%d)", pipefd[0],
1051
exitstatus = EX_OSERR;
1052
free(direntries[i]);
944
1056
/* Ask OS to automatic close the pipe on exec */
945
1057
ret = set_cloexec_flag(pipefd[0]);
947
perror("set_cloexec_flag");
1059
error(0, errno, "set_cloexec_flag");
948
1062
exitstatus = EX_OSERR;
1063
free(direntries[i]);
951
1066
ret = set_cloexec_flag(pipefd[1]);
953
perror("set_cloexec_flag");
1068
error(0, errno, "set_cloexec_flag");
954
1071
exitstatus = EX_OSERR;
1072
free(direntries[i]);
1075
#endif /* not O_CLOEXEC */
957
1076
/* Block SIGCHLD until process is safely in process list */
958
1077
ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_BLOCK,
959
1078
&sigchld_action.sa_mask,
962
perror("sigprocmask");
1081
error(0, errno, "sigprocmask");
963
1082
exitstatus = EX_OSERR;
1083
free(direntries[i]);
966
1086
/* Starting a new process to be watched */
970
1090
} while(pid == -1 and errno == EINTR);
1092
error(0, errno, "fork");
1093
TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1094
&sigchld_action.sa_mask, NULL));
973
1097
exitstatus = EX_OSERR;
1098
free(direntries[i]);
977
1102
/* this is the child process */
978
1103
ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1105
error(0, errno, "sigaction");
981
1106
_exit(EX_OSERR);
983
1108
ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
985
perror("sigprocmask");
1110
error(0, errno, "sigprocmask");
986
1111
_exit(EX_OSERR);
989
1114
ret = dup2(pipefd[1], STDOUT_FILENO); /* replace our stdout */
1116
error(0, errno, "dup2");
992
1117
_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){
1120
if(fexecve(plugin_fd, p->argv,
1121
(p->environ[0] != NULL) ? p->environ : environ) < 0){
1122
error(0, errno, "fexecve for %s/%s",
1123
plugindir != NULL ? plugindir : PDIR,
1124
direntries[i]->d_name);
1011
1127
/* no return */
1013
1129
/* Parent process */
1014
TEMP_FAILURE_RETRY(close(pipefd[1])); /* Close unused write end of
1017
plugin *new_plugin = getplugin(dirst->d_name);
1130
close(pipefd[1]); /* Close unused write end of pipe */
1132
plugin *new_plugin = getplugin(direntries[i]->d_name);
1018
1133
if(new_plugin == NULL){
1019
perror("getplugin");
1134
error(0, errno, "getplugin");
1020
1135
ret = (int)(TEMP_FAILURE_RETRY
1021
1136
(sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask,
1024
perror("sigprocmask");
1139
error(0, errno, "sigprocmask");
1026
1141
exitstatus = EX_OSERR;
1142
free(direntries[i]);
1145
free(direntries[i]);
1030
1147
new_plugin->pid = pid;
1031
1148
new_plugin->fd = pipefd[0];
1151
fprintf(stderr, "Plugin %s started (PID %" PRIdMAX ")\n",
1152
new_plugin->name, (intmax_t) (new_plugin->pid));
1033
1155
/* Unblock SIGCHLD so signal handler can be run if this process
1034
1156
has already completed */
1035
1157
ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1036
1158
&sigchld_action.sa_mask,
1039
perror("sigprocmask");
1161
error(0, errno, "sigprocmask");
1040
1162
exitstatus = EX_OSERR;
1044
FD_SET(new_plugin->fd, &rfds_all); /* Spurious warning from
1166
FD_SET(new_plugin->fd, &rfds_all);
1047
1168
if(maxfd < new_plugin->fd){
1048
1169
maxfd = new_plugin->fd;
1052
TEMP_FAILURE_RETRY(closedir(dir));
1054
1177
free_plugin(getplugin(NULL));
1056
1179
for(plugin *p = plugin_list; p != NULL; p = p->next){