Tree wide: Replace sstrerror() with STRERRNO.
[collectd.git] / src / exec.c
1 /**
2  * collectd - src/exec.c
3  * Copyright (C) 2007-2010  Florian octo Forster
4  * Copyright (C) 2007-2009  Sebastian Harl
5  * Copyright (C) 2008       Peter Holik
6  *
7  * This program is free software; you can redistribute it and/or modify it
8  * under the terms of the GNU General Public License as published by the
9  * Free Software Foundation; only version 2 of the License is applicable.
10  *
11  * This program is distributed in the hope that it will be useful, but
12  * WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License along
17  * with this program; if not, write to the Free Software Foundation, Inc.,
18  * 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
19  *
20  * Authors:
21  *   Florian octo Forster <octo at collectd.org>
22  *   Sebastian Harl <sh at tokkee.org>
23  *   Peter Holik <peter at holik.at>
24  **/
25
26 #define _DEFAULT_SOURCE
27 #define _BSD_SOURCE /* For setgroups */
28
29 #include "collectd.h"
30
31 #include "common.h"
32 #include "plugin.h"
33
34 #include "utils_cmd_putnotif.h"
35 #include "utils_cmd_putval.h"
36
37 #include <grp.h>
38 #include <pwd.h>
39 #include <signal.h>
40 #include <sys/types.h>
41
42 #ifdef HAVE_SYS_CAPABILITY_H
43 #include <sys/capability.h>
44 #endif
45
46 #define PL_NORMAL 0x01
47 #define PL_NOTIF_ACTION 0x02
48
49 #define PL_RUNNING 0x10
50
51 /*
52  * Private data types
53  */
54 /*
55  * Access to this structure is serialized using the `pl_lock' lock and the
56  * `PL_RUNNING' flag. The execution of notifications is *not* serialized, so
57  * all functions used to handle notifications MUST NOT write to this structure.
58  * The `pid' and `status' fields are thus unused if the `PL_NOTIF_ACTION' flag
59  * is set.
60  * The `PL_RUNNING' flag is set in `exec_read' and unset in `exec_read_one'.
61  */
62 struct program_list_s;
63 typedef struct program_list_s program_list_t;
64 struct program_list_s {
65   char *user;
66   char *group;
67   char *exec;
68   char **argv;
69   int pid;
70   int status;
71   int flags;
72   program_list_t *next;
73 };
74
75 typedef struct program_list_and_notification_s {
76   program_list_t *pl;
77   notification_t n;
78 } program_list_and_notification_t;
79
80 /*
81  * Private variables
82  */
83 static program_list_t *pl_head = NULL;
84 static pthread_mutex_t pl_lock = PTHREAD_MUTEX_INITIALIZER;
85
86 /*
87  * Functions
88  */
89 static void sigchld_handler(int __attribute__((unused)) signal) /* {{{ */
90 {
91   pid_t pid;
92   int status;
93   while ((pid = waitpid(-1, &status, WNOHANG)) > 0) {
94     program_list_t *pl;
95     for (pl = pl_head; pl != NULL; pl = pl->next)
96       if (pl->pid == pid)
97         break;
98     if (pl != NULL)
99       pl->status = status;
100   } /* while (waitpid) */
101 } /* void sigchld_handler }}} */
102
103 static int exec_config_exec(oconfig_item_t *ci) /* {{{ */
104 {
105   program_list_t *pl;
106   char buffer[128];
107   int i;
108
109   if (ci->children_num != 0) {
110     WARNING("exec plugin: The config option `%s' may not be a block.", ci->key);
111     return -1;
112   }
113   if (ci->values_num < 2) {
114     WARNING("exec plugin: The config option `%s' needs at least two "
115             "arguments.",
116             ci->key);
117     return -1;
118   }
119   if ((ci->values[0].type != OCONFIG_TYPE_STRING) ||
120       (ci->values[1].type != OCONFIG_TYPE_STRING)) {
121     WARNING("exec plugin: The first two arguments to the `%s' option must "
122             "be string arguments.",
123             ci->key);
124     return -1;
125   }
126
127   pl = calloc(1, sizeof(*pl));
128   if (pl == NULL) {
129     ERROR("exec plugin: calloc failed.");
130     return -1;
131   }
132
133   if (strcasecmp("NotificationExec", ci->key) == 0)
134     pl->flags |= PL_NOTIF_ACTION;
135   else
136     pl->flags |= PL_NORMAL;
137
138   pl->user = strdup(ci->values[0].value.string);
139   if (pl->user == NULL) {
140     ERROR("exec plugin: strdup failed.");
141     sfree(pl);
142     return -1;
143   }
144
145   pl->group = strchr(pl->user, ':');
146   if (pl->group != NULL) {
147     *pl->group = '\0';
148     pl->group++;
149   }
150
151   pl->exec = strdup(ci->values[1].value.string);
152   if (pl->exec == NULL) {
153     ERROR("exec plugin: strdup failed.");
154     sfree(pl->user);
155     sfree(pl);
156     return -1;
157   }
158
159   pl->argv = calloc(ci->values_num, sizeof(*pl->argv));
160   if (pl->argv == NULL) {
161     ERROR("exec plugin: calloc failed.");
162     sfree(pl->exec);
163     sfree(pl->user);
164     sfree(pl);
165     return -1;
166   }
167
168   {
169     char *tmp = strrchr(ci->values[1].value.string, '/');
170     if (tmp == NULL)
171       sstrncpy(buffer, ci->values[1].value.string, sizeof(buffer));
172     else
173       sstrncpy(buffer, tmp + 1, sizeof(buffer));
174   }
175   pl->argv[0] = strdup(buffer);
176   if (pl->argv[0] == NULL) {
177     ERROR("exec plugin: strdup failed.");
178     sfree(pl->argv);
179     sfree(pl->exec);
180     sfree(pl->user);
181     sfree(pl);
182     return -1;
183   }
184
185   for (i = 1; i < (ci->values_num - 1); i++) {
186     if (ci->values[i + 1].type == OCONFIG_TYPE_STRING) {
187       pl->argv[i] = strdup(ci->values[i + 1].value.string);
188     } else {
189       if (ci->values[i + 1].type == OCONFIG_TYPE_NUMBER) {
190         snprintf(buffer, sizeof(buffer), "%lf", ci->values[i + 1].value.number);
191       } else {
192         if (ci->values[i + 1].value.boolean)
193           sstrncpy(buffer, "true", sizeof(buffer));
194         else
195           sstrncpy(buffer, "false", sizeof(buffer));
196       }
197
198       pl->argv[i] = strdup(buffer);
199     }
200
201     if (pl->argv[i] == NULL) {
202       ERROR("exec plugin: strdup failed.");
203       break;
204     }
205   } /* for (i) */
206
207   if (i < (ci->values_num - 1)) {
208     while ((--i) >= 0) {
209       sfree(pl->argv[i]);
210     }
211     sfree(pl->argv);
212     sfree(pl->exec);
213     sfree(pl->user);
214     sfree(pl);
215     return -1;
216   }
217
218   for (i = 0; pl->argv[i] != NULL; i++) {
219     DEBUG("exec plugin: argv[%i] = %s", i, pl->argv[i]);
220   }
221
222   pl->next = pl_head;
223   pl_head = pl;
224
225   return 0;
226 } /* int exec_config_exec }}} */
227
228 static int exec_config(oconfig_item_t *ci) /* {{{ */
229 {
230   for (int i = 0; i < ci->children_num; i++) {
231     oconfig_item_t *child = ci->children + i;
232     if ((strcasecmp("Exec", child->key) == 0) ||
233         (strcasecmp("NotificationExec", child->key) == 0))
234       exec_config_exec(child);
235     else {
236       WARNING("exec plugin: Unknown config option `%s'.", child->key);
237     }
238   } /* for (i) */
239
240   return 0;
241 } /* int exec_config }}} */
242
243 static void set_environment(void) /* {{{ */
244 {
245   char buffer[1024];
246
247 #ifdef HAVE_SETENV
248   snprintf(buffer, sizeof(buffer), "%.3f",
249            CDTIME_T_TO_DOUBLE(plugin_get_interval()));
250   setenv("COLLECTD_INTERVAL", buffer, /* overwrite = */ 1);
251
252   sstrncpy(buffer, hostname_g, sizeof(buffer));
253   setenv("COLLECTD_HOSTNAME", buffer, /* overwrite = */ 1);
254 #else
255   snprintf(buffer, sizeof(buffer), "COLLECTD_INTERVAL=%.3f",
256            CDTIME_T_TO_DOUBLE(plugin_get_interval()));
257   putenv(buffer);
258
259   snprintf(buffer, sizeof(buffer), "COLLECTD_HOSTNAME=%s", hostname_g);
260   putenv(buffer);
261 #endif
262 } /* }}} void set_environment */
263
264 __attribute__((noreturn)) static void exec_child(program_list_t *pl, int uid,
265                                                  int gid, int egid) /* {{{ */
266 {
267   int status;
268
269 #if HAVE_SETGROUPS
270   if (getuid() == 0) {
271     gid_t glist[2];
272     size_t glist_len;
273
274     glist[0] = gid;
275     glist_len = 1;
276
277     if ((gid != egid) && (egid != -1)) {
278       glist[1] = egid;
279       glist_len = 2;
280     }
281
282     setgroups(glist_len, glist);
283   }
284 #endif /* HAVE_SETGROUPS */
285
286   status = setgid(gid);
287   if (status != 0) {
288     ERROR("exec plugin: setgid (%i) failed: %s", gid, STRERRNO);
289     exit(-1);
290   }
291
292   if (egid != -1) {
293     status = setegid(egid);
294     if (status != 0) {
295       ERROR("exec plugin: setegid (%i) failed: %s", egid, STRERRNO);
296       exit(-1);
297     }
298   }
299
300   status = setuid(uid);
301   if (status != 0) {
302     ERROR("exec plugin: setuid (%i) failed: %s", uid, STRERRNO);
303     exit(-1);
304   }
305
306   execvp(pl->exec, pl->argv);
307
308   ERROR("exec plugin: Failed to execute ``%s'': %s", pl->exec, STRERRNO);
309   exit(-1);
310 } /* void exec_child }}} */
311
312 static void reset_signal_mask(void) /* {{{ */
313 {
314   sigset_t ss;
315
316   sigemptyset(&ss);
317   sigprocmask(SIG_SETMASK, &ss, /* old mask = */ NULL);
318 } /* }}} void reset_signal_mask */
319
320 static int create_pipe(int fd_pipe[2]) /* {{{ */
321 {
322   int status;
323
324   status = pipe(fd_pipe);
325   if (status != 0) {
326     ERROR("exec plugin: pipe failed: %s", STRERRNO);
327     return -1;
328   }
329
330   return 0;
331 } /* }}} int create_pipe */
332
333 static void close_pipe(int fd_pipe[2]) /* {{{ */
334 {
335   if (fd_pipe[0] != -1)
336     close(fd_pipe[0]);
337
338   if (fd_pipe[1] != -1)
339     close(fd_pipe[1]);
340 } /* }}} void close_pipe */
341
342 /*
343  * Creates three pipes (one for reading, one for writing and one for errors),
344  * forks a child, sets up the pipes so that fd_in is connected to STDIN of
345  * the child and fd_out is connected to STDOUT and fd_err is connected to STDERR
346  * of the child. Then is calls `exec_child'.
347  */
348 static int fork_child(program_list_t *pl, int *fd_in, int *fd_out,
349                       int *fd_err) /* {{{ */
350 {
351   int fd_pipe_in[2] = {-1, -1};
352   int fd_pipe_out[2] = {-1, -1};
353   int fd_pipe_err[2] = {-1, -1};
354   char errbuf[1024];
355   int status;
356   int pid;
357
358   int uid;
359   int gid;
360   int egid;
361
362   struct passwd *sp_ptr;
363   struct passwd sp;
364
365   if (pl->pid != 0)
366     return -1;
367
368   long int nambuf_size = sysconf(_SC_GETPW_R_SIZE_MAX);
369   if (nambuf_size <= 0)
370     nambuf_size = sysconf(_SC_PAGESIZE);
371   if (nambuf_size <= 0)
372     nambuf_size = 4096;
373   char nambuf[nambuf_size];
374
375   if ((create_pipe(fd_pipe_in) == -1) || (create_pipe(fd_pipe_out) == -1) ||
376       (create_pipe(fd_pipe_err) == -1))
377     goto failed;
378
379   sp_ptr = NULL;
380   status = getpwnam_r(pl->user, &sp, nambuf, sizeof(nambuf), &sp_ptr);
381   if (status != 0) {
382     ERROR("exec plugin: Failed to get user information for user ``%s'': %s",
383           pl->user, sstrerror(status, errbuf, sizeof(errbuf)));
384     goto failed;
385   }
386
387   if (sp_ptr == NULL) {
388     ERROR("exec plugin: No such user: `%s'", pl->user);
389     goto failed;
390   }
391
392   uid = sp.pw_uid;
393   gid = sp.pw_gid;
394   if (uid == 0) {
395     ERROR("exec plugin: Cowardly refusing to exec program as root.");
396     goto failed;
397   }
398
399   /* The group configured in the configfile is set as effective group, because
400    * this way the forked process can (re-)gain the user's primary group. */
401   egid = -1;
402   if (pl->group != NULL) {
403     if (*pl->group != '\0') {
404       struct group *gr_ptr = NULL;
405       struct group gr;
406
407       long int grbuf_size = sysconf(_SC_GETGR_R_SIZE_MAX);
408       if (grbuf_size <= 0)
409         grbuf_size = sysconf(_SC_PAGESIZE);
410       if (grbuf_size <= 0)
411         grbuf_size = 4096;
412       char grbuf[grbuf_size];
413
414       status = getgrnam_r(pl->group, &gr, grbuf, sizeof(grbuf), &gr_ptr);
415       if (status != 0) {
416         ERROR("exec plugin: Failed to get group information "
417               "for group ``%s'': %s",
418               pl->group, sstrerror(status, errbuf, sizeof(errbuf)));
419         goto failed;
420       }
421       if (gr_ptr == NULL) {
422         ERROR("exec plugin: No such group: `%s'", pl->group);
423         goto failed;
424       }
425
426       egid = gr.gr_gid;
427     } else {
428       egid = gid;
429     }
430   } /* if (pl->group == NULL) */
431
432   pid = fork();
433   if (pid < 0) {
434     ERROR("exec plugin: fork failed: %s", STRERRNO);
435     goto failed;
436   } else if (pid == 0) {
437     int fd_num;
438
439     /* Close all file descriptors but the pipe end we need. */
440     fd_num = getdtablesize();
441     for (int fd = 0; fd < fd_num; fd++) {
442       if ((fd == fd_pipe_in[0]) || (fd == fd_pipe_out[1]) ||
443           (fd == fd_pipe_err[1]))
444         continue;
445       close(fd);
446     }
447
448     /* Connect the `in' pipe to STDIN */
449     if (fd_pipe_in[0] != STDIN_FILENO) {
450       dup2(fd_pipe_in[0], STDIN_FILENO);
451       close(fd_pipe_in[0]);
452     }
453
454     /* Now connect the `out' pipe to STDOUT */
455     if (fd_pipe_out[1] != STDOUT_FILENO) {
456       dup2(fd_pipe_out[1], STDOUT_FILENO);
457       close(fd_pipe_out[1]);
458     }
459
460     /* Now connect the `err' pipe to STDERR */
461     if (fd_pipe_err[1] != STDERR_FILENO) {
462       dup2(fd_pipe_err[1], STDERR_FILENO);
463       close(fd_pipe_err[1]);
464     }
465
466     set_environment();
467
468     /* Unblock all signals */
469     reset_signal_mask();
470
471     exec_child(pl, uid, gid, egid);
472     /* does not return */
473   }
474
475   close(fd_pipe_in[0]);
476   close(fd_pipe_out[1]);
477   close(fd_pipe_err[1]);
478
479   if (fd_in != NULL)
480     *fd_in = fd_pipe_in[1];
481   else
482     close(fd_pipe_in[1]);
483
484   if (fd_out != NULL)
485     *fd_out = fd_pipe_out[0];
486   else
487     close(fd_pipe_out[0]);
488
489   if (fd_err != NULL)
490     *fd_err = fd_pipe_err[0];
491   else
492     close(fd_pipe_err[0]);
493
494   return pid;
495
496 failed:
497   close_pipe(fd_pipe_in);
498   close_pipe(fd_pipe_out);
499   close_pipe(fd_pipe_err);
500
501   return -1;
502 } /* int fork_child }}} */
503
504 static int parse_line(char *buffer) /* {{{ */
505 {
506   if (strncasecmp("PUTVAL", buffer, strlen("PUTVAL")) == 0)
507     return cmd_handle_putval(stdout, buffer);
508   else if (strncasecmp("PUTNOTIF", buffer, strlen("PUTNOTIF")) == 0)
509     return handle_putnotif(stdout, buffer);
510   else {
511     ERROR("exec plugin: Unable to parse command, ignoring line: \"%s\"",
512           buffer);
513     return -1;
514   }
515 } /* int parse_line }}} */
516
517 static void *exec_read_one(void *arg) /* {{{ */
518 {
519   program_list_t *pl = (program_list_t *)arg;
520   int fd, fd_err, highest_fd;
521   fd_set fdset, copy;
522   int status;
523   char buffer[1200]; /* if not completely read */
524   char buffer_err[1024];
525   char *pbuffer = buffer;
526   char *pbuffer_err = buffer_err;
527
528   status = fork_child(pl, NULL, &fd, &fd_err);
529   if (status < 0) {
530     /* Reset the "running" flag */
531     pthread_mutex_lock(&pl_lock);
532     pl->flags &= ~PL_RUNNING;
533     pthread_mutex_unlock(&pl_lock);
534     pthread_exit((void *)1);
535   }
536   pl->pid = status;
537
538   assert(pl->pid != 0);
539
540   FD_ZERO(&fdset);
541   FD_SET(fd, &fdset);
542   FD_SET(fd_err, &fdset);
543
544   /* Determine the highest file descriptor */
545   highest_fd = (fd > fd_err) ? fd : fd_err;
546
547   /* We use a copy of fdset, as select modifies it */
548   copy = fdset;
549
550   while (1) {
551     int len;
552
553     status = select(highest_fd + 1, &copy, NULL, NULL, NULL);
554     if (status < 0) {
555       if (errno == EINTR)
556         continue;
557       break;
558     }
559
560     if (FD_ISSET(fd, &copy)) {
561       char *pnl;
562
563       len = read(fd, pbuffer, sizeof(buffer) - 1 - (pbuffer - buffer));
564
565       if (len < 0) {
566         if (errno == EAGAIN || errno == EINTR)
567           continue;
568         break;
569       } else if (len == 0)
570         break; /* We've reached EOF */
571
572       pbuffer[len] = '\0';
573
574       len += pbuffer - buffer;
575       pbuffer = buffer;
576
577       while ((pnl = strchr(pbuffer, '\n'))) {
578         *pnl = '\0';
579         if (*(pnl - 1) == '\r')
580           *(pnl - 1) = '\0';
581
582         parse_line(pbuffer);
583
584         pbuffer = ++pnl;
585       }
586       /* not completely read ? */
587       if (pbuffer - buffer < len) {
588         len -= pbuffer - buffer;
589         memmove(buffer, pbuffer, len);
590         pbuffer = buffer + len;
591       } else
592         pbuffer = buffer;
593     } else if (FD_ISSET(fd_err, &copy)) {
594       char *pnl;
595
596       len = read(fd_err, pbuffer_err,
597                  sizeof(buffer_err) - 1 - (pbuffer_err - buffer_err));
598
599       if (len < 0) {
600         if (errno == EAGAIN || errno == EINTR)
601           continue;
602         break;
603       } else if (len == 0) {
604         /* We've reached EOF */
605         NOTICE("exec plugin: Program `%s' has closed STDERR.", pl->exec);
606
607         /* Remove file descriptor form select() set. */
608         FD_CLR(fd_err, &fdset);
609         copy = fdset;
610         highest_fd = fd;
611
612         /* Clean up file descriptor */
613         close(fd_err);
614         fd_err = -1;
615         continue;
616       }
617
618       pbuffer_err[len] = '\0';
619
620       len += pbuffer_err - buffer_err;
621       pbuffer_err = buffer_err;
622
623       while ((pnl = strchr(pbuffer_err, '\n'))) {
624         *pnl = '\0';
625         if (*(pnl - 1) == '\r')
626           *(pnl - 1) = '\0';
627
628         ERROR("exec plugin: exec_read_one: error = %s", pbuffer_err);
629
630         pbuffer_err = ++pnl;
631       }
632       /* not completely read ? */
633       if (pbuffer_err - buffer_err < len) {
634         len -= pbuffer_err - buffer_err;
635         memmove(buffer_err, pbuffer_err, len);
636         pbuffer_err = buffer_err + len;
637       } else
638         pbuffer_err = buffer_err;
639     }
640     /* reset copy */
641     copy = fdset;
642   }
643
644   DEBUG("exec plugin: exec_read_one: Waiting for `%s' to exit.", pl->exec);
645   if (waitpid(pl->pid, &status, 0) > 0)
646     pl->status = status;
647
648   DEBUG("exec plugin: Child %i exited with status %i.", (int)pl->pid,
649         pl->status);
650
651   pl->pid = 0;
652
653   pthread_mutex_lock(&pl_lock);
654   pl->flags &= ~PL_RUNNING;
655   pthread_mutex_unlock(&pl_lock);
656
657   close(fd);
658   if (fd_err >= 0)
659     close(fd_err);
660
661   pthread_exit((void *)0);
662   return NULL;
663 } /* void *exec_read_one }}} */
664
665 static void *exec_notification_one(void *arg) /* {{{ */
666 {
667   program_list_t *pl = ((program_list_and_notification_t *)arg)->pl;
668   notification_t *n = &((program_list_and_notification_t *)arg)->n;
669   int fd;
670   FILE *fh;
671   int pid;
672   int status;
673   const char *severity;
674
675   pid = fork_child(pl, &fd, NULL, NULL);
676   if (pid < 0) {
677     sfree(arg);
678     pthread_exit((void *)1);
679   }
680
681   fh = fdopen(fd, "w");
682   if (fh == NULL) {
683     ERROR("exec plugin: fdopen (%i) failed: %s", fd, STRERRNO);
684     kill(pid, SIGTERM);
685     close(fd);
686     sfree(arg);
687     pthread_exit((void *)1);
688   }
689
690   severity = "FAILURE";
691   if (n->severity == NOTIF_WARNING)
692     severity = "WARNING";
693   else if (n->severity == NOTIF_OKAY)
694     severity = "OKAY";
695
696   fprintf(fh, "Severity: %s\n"
697               "Time: %.3f\n",
698           severity, CDTIME_T_TO_DOUBLE(n->time));
699
700   /* Print the optional fields */
701   if (strlen(n->host) > 0)
702     fprintf(fh, "Host: %s\n", n->host);
703   if (strlen(n->plugin) > 0)
704     fprintf(fh, "Plugin: %s\n", n->plugin);
705   if (strlen(n->plugin_instance) > 0)
706     fprintf(fh, "PluginInstance: %s\n", n->plugin_instance);
707   if (strlen(n->type) > 0)
708     fprintf(fh, "Type: %s\n", n->type);
709   if (strlen(n->type_instance) > 0)
710     fprintf(fh, "TypeInstance: %s\n", n->type_instance);
711
712   for (notification_meta_t *meta = n->meta; meta != NULL; meta = meta->next) {
713     if (meta->type == NM_TYPE_STRING)
714       fprintf(fh, "%s: %s\n", meta->name, meta->nm_value.nm_string);
715     else if (meta->type == NM_TYPE_SIGNED_INT)
716       fprintf(fh, "%s: %" PRIi64 "\n", meta->name,
717               meta->nm_value.nm_signed_int);
718     else if (meta->type == NM_TYPE_UNSIGNED_INT)
719       fprintf(fh, "%s: %" PRIu64 "\n", meta->name,
720               meta->nm_value.nm_unsigned_int);
721     else if (meta->type == NM_TYPE_DOUBLE)
722       fprintf(fh, "%s: %e\n", meta->name, meta->nm_value.nm_double);
723     else if (meta->type == NM_TYPE_BOOLEAN)
724       fprintf(fh, "%s: %s\n", meta->name,
725               meta->nm_value.nm_boolean ? "true" : "false");
726   }
727
728   fprintf(fh, "\n%s\n", n->message);
729
730   fflush(fh);
731   fclose(fh);
732
733   waitpid(pid, &status, 0);
734
735   DEBUG("exec plugin: Child %i exited with status %i.", pid, status);
736
737   if (n->meta != NULL)
738     plugin_notification_meta_free(n->meta);
739   n->meta = NULL;
740   sfree(arg);
741   pthread_exit((void *)0);
742   return NULL;
743 } /* void *exec_notification_one }}} */
744
745 static int exec_init(void) /* {{{ */
746 {
747   struct sigaction sa = {.sa_handler = sigchld_handler};
748
749   sigaction(SIGCHLD, &sa, NULL);
750
751 #if defined(HAVE_SYS_CAPABILITY_H) && defined(CAP_SETUID) && defined(CAP_SETGID)
752   if ((check_capability(CAP_SETUID) != 0) ||
753       (check_capability(CAP_SETGID) != 0)) {
754     if (getuid() == 0)
755       WARNING(
756           "exec plugin: Running collectd as root, but the CAP_SETUID "
757           "or CAP_SETGID capabilities are missing. The plugin's read function "
758           "will probably fail. Is your init system dropping capabilities?");
759     else
760       WARNING(
761           "exec plugin: collectd doesn't have the CAP_SETUID or "
762           "CAP_SETGID capabilities. If you don't want to run collectd as root, "
763           "try running \"setcap 'cap_setuid=ep cap_setgid=ep'\" on the "
764           "collectd binary.");
765   }
766 #endif
767
768   return 0;
769 } /* int exec_init }}} */
770
771 static int exec_read(void) /* {{{ */
772 {
773   for (program_list_t *pl = pl_head; pl != NULL; pl = pl->next) {
774     pthread_t t;
775     pthread_attr_t attr;
776
777     /* Only execute `normal' style executables here. */
778     if ((pl->flags & PL_NORMAL) == 0)
779       continue;
780
781     pthread_mutex_lock(&pl_lock);
782     /* Skip if a child is already running. */
783     if ((pl->flags & PL_RUNNING) != 0) {
784       pthread_mutex_unlock(&pl_lock);
785       continue;
786     }
787     pl->flags |= PL_RUNNING;
788     pthread_mutex_unlock(&pl_lock);
789
790     pthread_attr_init(&attr);
791     pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED);
792     plugin_thread_create(&t, &attr, exec_read_one, (void *)pl, "exec read");
793     pthread_attr_destroy(&attr);
794   } /* for (pl) */
795
796   return 0;
797 } /* int exec_read }}} */
798
799 static int exec_notification(const notification_t *n, /* {{{ */
800                              user_data_t __attribute__((unused)) * user_data) {
801   program_list_and_notification_t *pln;
802
803   for (program_list_t *pl = pl_head; pl != NULL; pl = pl->next) {
804     pthread_t t;
805     pthread_attr_t attr;
806
807     /* Only execute `notification' style executables here. */
808     if ((pl->flags & PL_NOTIF_ACTION) == 0)
809       continue;
810
811     /* Skip if a child is already running. */
812     if (pl->pid != 0)
813       continue;
814
815     pln = malloc(sizeof(*pln));
816     if (pln == NULL) {
817       ERROR("exec plugin: malloc failed.");
818       continue;
819     }
820
821     pln->pl = pl;
822     memcpy(&pln->n, n, sizeof(notification_t));
823
824     /* Set the `meta' member to NULL, otherwise `plugin_notification_meta_copy'
825      * will run into an endless loop. */
826     pln->n.meta = NULL;
827     plugin_notification_meta_copy(&pln->n, n);
828
829     pthread_attr_init(&attr);
830     pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED);
831     plugin_thread_create(&t, &attr, exec_notification_one, (void *)pln,
832                          "exec notify");
833     pthread_attr_destroy(&attr);
834   } /* for (pl) */
835
836   return 0;
837 } /* }}} int exec_notification */
838
839 static int exec_shutdown(void) /* {{{ */
840 {
841   program_list_t *pl;
842   program_list_t *next;
843
844   pl = pl_head;
845   while (pl != NULL) {
846     next = pl->next;
847
848     if (pl->pid > 0) {
849       kill(pl->pid, SIGTERM);
850       INFO("exec plugin: Sent SIGTERM to %hu", (unsigned short int)pl->pid);
851     }
852
853     sfree(pl->user);
854     sfree(pl);
855
856     pl = next;
857   } /* while (pl) */
858   pl_head = NULL;
859
860   return 0;
861 } /* int exec_shutdown }}} */
862
863 void module_register(void) {
864   plugin_register_complex_config("exec", exec_config);
865   plugin_register_init("exec", exec_init);
866   plugin_register_read("exec", exec_read);
867   plugin_register_notification("exec", exec_notification,
868                                /* user_data = */ NULL);
869   plugin_register_shutdown("exec", exec_shutdown);
870 } /* void module_register */