/mandos/trunk

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

  • Committer: Teddy Hogeborn
  • Date: 2008-09-30 03:19:39 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080930031939-t72se4dhr632o9ct
* Makefile: Add HTML rules for manual pages.
  (DOCBOOKTOHTML, HTMLPOST): New commands.
  (htmldocs): New file list.
  (html, install-html): New targets.
  (.PHONY, clean): Added "html".

* README (The Plugin System): New section; describe plugin system.

* debian/control (Uploaders): New field.

* mandos-options.xml (servicename): Improve wording.

* plugins.d/mandos-client.xml (SECURITY): Improve wording.

Show diffs side-by-side

added added

removed removed

Lines of Context:
plugin-runner.c
2
2
/*
3
3
 * Mandos plugin runner - Run Mandos plugins
4
4
 *
5
 
 * Copyright © 2008,2009 Teddy Hogeborn
6
 
 * Copyright © 2008,2009 Björn Påhlsson
 
5
 * Copyright © 2008 Teddy Hogeborn & Björn Påhlsson
7
6
 * 
8
7
 * This program is free software: you can redistribute it and/or
9
8
 * modify it under the terms of the GNU General Public License as
62
61
#include <signal.h>             /* struct sigaction, sigemptyset(),
63
62
                                   sigaddset(), sigaction(),
64
63
                                   sigprocmask(), SIG_BLOCK, SIGCHLD,
65
 
                                   SIG_UNBLOCK, kill(), sig_atomic_t
66
 
                                */
 
64
                                   SIG_UNBLOCK, kill() */
67
65
#include <errno.h>              /* errno, EBADF */
68
 
#include <inttypes.h>           /* intmax_t, SCNdMAX, PRIdMAX,  */
69
66
 
70
67
#define BUFFER_SIZE 256
71
68
 
72
69
#define PDIR "/lib/mandos/plugins.d"
73
70
#define AFILE "/conf/conf.d/mandos/plugin-runner.conf"
74
71
 
75
 
const char *argp_program_version = "plugin-runner " VERSION;
 
72
const char *argp_program_version = "plugin-runner 1.0";
76
73
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
77
74
 
78
75
typedef struct plugin{
90
87
  size_t buffer_size;
91
88
  size_t buffer_length;
92
89
  bool eof;
93
 
  volatile sig_atomic_t completed;
94
 
  int status;
 
90
  volatile bool completed;
 
91
  volatile int status;
95
92
  struct plugin *next;
96
93
} plugin;
97
94
 
101
98
   or if none is found, creates a new one */
102
99
static plugin *getplugin(char *name){
103
100
  /* Check for exiting plugin with that name */
104
 
  for(plugin *p = plugin_list; p != NULL; p = p->next){
105
 
    if((p->name == name)
106
 
       or (p->name and name and (strcmp(p->name, name) == 0))){
 
101
  for (plugin *p = plugin_list; p != NULL; p = p->next){
 
102
    if ((p->name == name)
 
103
        or (p->name and name and (strcmp(p->name, name) == 0))){
107
104
      return p;
108
105
    }
109
106
  }
110
107
  /* Create a new plugin */
111
108
  plugin *new_plugin = malloc(sizeof(plugin));
112
 
  if(new_plugin == NULL){
 
109
  if (new_plugin == NULL){
113
110
    return NULL;
114
111
  }
115
112
  char *copy_name = NULL;
116
113
  if(name != NULL){
117
114
    copy_name = strdup(name);
118
115
    if(copy_name == NULL){
119
 
      free(new_plugin);
120
116
      return NULL;
121
117
    }
122
118
  }
123
119
  
124
 
  *new_plugin = (plugin){ .name = copy_name,
125
 
                          .argc = 1,
126
 
                          .disabled = false,
127
 
                          .next = plugin_list };
 
120
  *new_plugin = (plugin) { .name = copy_name,
 
121
                           .argc = 1,
 
122
                           .disabled = false,
 
123
                           .next = plugin_list };
128
124
  
129
125
  new_plugin->argv = malloc(sizeof(char *) * 2);
130
 
  if(new_plugin->argv == NULL){
 
126
  if (new_plugin->argv == NULL){
131
127
    free(copy_name);
132
128
    free(new_plugin);
133
129
    return NULL;
224
220
/* Mark processes as completed when they exit, and save their exit
225
221
   status. */
226
222
static void handle_sigchld(__attribute__((unused)) int sig){
227
 
  int old_errno = errno;
228
223
  while(true){
229
224
    plugin *proc = plugin_list;
230
225
    int status;
234
229
      break;
235
230
    }
236
231
    if(pid == -1){
237
 
      if(errno == ECHILD){
238
 
        /* No child processes */
239
 
        break;
 
232
      if (errno != ECHILD){
 
233
        perror("waitpid");
240
234
      }
241
 
      perror("waitpid");
 
235
      /* No child processes */
 
236
      break;
242
237
    }
243
238
    
244
239
    /* A child exited, find it in process_list */
250
245
      continue;
251
246
    }
252
247
    proc->status = status;
253
 
    proc->completed = 1;
 
248
    proc->completed = true;
254
249
  }
255
 
  errno = old_errno;
256
250
}
257
251
 
258
252
/* Prints out a password to stdout */
313
307
  struct dirent *dirst;
314
308
  struct stat st;
315
309
  fd_set rfds_all;
316
 
  int ret, numchars, maxfd = 0;
317
 
  ssize_t sret;
318
 
  intmax_t tmpmax;
 
310
  int ret, maxfd = 0;
319
311
  uid_t uid = 65534;
320
312
  gid_t gid = 65534;
321
313
  bool debug = false;
378
370
    { .name = NULL }
379
371
  };
380
372
  
381
 
  error_t parse_opt(int key, char *arg, __attribute__((unused))
382
 
                    struct argp_state *state){
383
 
    switch(key){
 
373
  error_t parse_opt (int key, char *arg, __attribute__((unused))
 
374
                     struct argp_state *state) {
 
375
    switch (key) {
384
376
    case 'g':                   /* --global-options */
385
 
      if(arg != NULL){
386
 
        char *plugin_option;
387
 
        while((plugin_option = strsep(&arg, ",")) != NULL){
388
 
          if(plugin_option[0] == '\0'){
 
377
      if (arg != NULL){
 
378
        char *p;
 
379
        while((p = strsep(&arg, ",")) != NULL){
 
380
          if(p[0] == '\0'){
389
381
            continue;
390
382
          }
391
 
          if(not add_argument(getplugin(NULL), plugin_option)){
 
383
          if(not add_argument(getplugin(NULL), p)){
392
384
            perror("add_argument");
393
385
            return ARGP_ERR_UNKNOWN;
394
386
          }
404
396
      }
405
397
      break;
406
398
    case 'o':                   /* --options-for */
407
 
      if(arg != NULL){
408
 
        char *plugin_name = strsep(&arg, ":");
409
 
        if(plugin_name[0] == '\0'){
410
 
          break;
411
 
        }
412
 
        char *plugin_option;
413
 
        while((plugin_option = strsep(&arg, ",")) != NULL){
414
 
          if(not add_argument(getplugin(plugin_name), plugin_option)){
 
399
      if (arg != NULL){
 
400
        char *p_name = strsep(&arg, ":");
 
401
        if(p_name[0] == '\0' or arg == NULL){
 
402
          break;
 
403
        }
 
404
        char *opt = strsep(&arg, ":");
 
405
        if(opt[0] == '\0' or opt == NULL){
 
406
          break;
 
407
        }
 
408
        char *p;
 
409
        while((p = strsep(&opt, ",")) != NULL){
 
410
          if(p[0] == '\0'){
 
411
            continue;
 
412
          }
 
413
          if(not add_argument(getplugin(p_name), p)){
415
414
            perror("add_argument");
416
415
            return ARGP_ERR_UNKNOWN;
417
416
          }
434
433
      }
435
434
      break;
436
435
    case 'd':                   /* --disable */
437
 
      if(arg != NULL){
 
436
      if (arg != NULL){
438
437
        plugin *p = getplugin(arg);
439
438
        if(p == NULL){
440
439
          return ARGP_ERR_UNKNOWN;
443
442
      }
444
443
      break;
445
444
    case 'e':                   /* --enable */
446
 
      if(arg != NULL){
 
445
      if (arg != NULL){
447
446
        plugin *p = getplugin(arg);
448
447
        if(p == NULL){
449
448
          return ARGP_ERR_UNKNOWN;
462
461
      /* This is already done by parse_opt_config_file() */
463
462
      break;
464
463
    case 130:                   /* --userid */
465
 
      ret = sscanf(arg, "%" SCNdMAX "%n", &tmpmax, &numchars);
466
 
      if(ret < 1 or tmpmax != (uid_t)tmpmax
467
 
         or arg[numchars] != '\0'){
468
 
        fprintf(stderr, "Bad user ID number: \"%s\", using %"
469
 
                PRIdMAX "\n", arg, (intmax_t)uid);
470
 
      } else {
471
 
        uid = (uid_t)tmpmax;
472
 
      }
 
464
      uid = (uid_t)strtol(arg, NULL, 10);
473
465
      break;
474
466
    case 131:                   /* --groupid */
475
 
      ret = sscanf(arg, "%" SCNdMAX "%n", &tmpmax, &numchars);
476
 
      if(ret < 1 or tmpmax != (gid_t)tmpmax
477
 
         or arg[numchars] != '\0'){
478
 
        fprintf(stderr, "Bad group ID number: \"%s\", using %"
479
 
                PRIdMAX "\n", arg, (intmax_t)gid);
480
 
      } else {
481
 
        gid = (gid_t)tmpmax;
482
 
      }
 
467
      gid = (gid_t)strtol(arg, NULL, 10);
483
468
      break;
484
469
    case 132:                   /* --debug */
485
470
      debug = true;
486
471
      break;
487
 
/*
488
 
 * When adding more options before this line, remember to also add a
489
 
 * "case" to the "parse_opt_config_file" function below.
490
 
 */
491
472
    case ARGP_KEY_ARG:
492
473
      /* Cryptsetup always passes an argument, which is an empty
493
474
         string if "none" was specified in /etc/crypttab.  So if
506
487
  
507
488
  /* This option parser is the same as parse_opt() above, except it
508
489
     ignores everything but the --config-file option. */
509
 
  error_t parse_opt_config_file(int key, char *arg,
510
 
                                __attribute__((unused))
511
 
                                struct argp_state *state){
512
 
    switch(key){
 
490
  error_t parse_opt_config_file (int key, char *arg,
 
491
                                 __attribute__((unused))
 
492
                                 struct argp_state *state) {
 
493
    switch (key) {
513
494
    case 'g':                   /* --global-options */
514
495
    case 'G':                   /* --global-env */
515
496
    case 'o':                   /* --options-for */
542
523
                       .args_doc = "",
543
524
                       .doc = "Mandos plugin runner -- Run plugins" };
544
525
  
545
 
  /* Parse using parse_opt_config_file() in order to get the custom
 
526
  /* Parse using the parse_opt_config_file in order to get the custom
546
527
     config file location, if any. */
547
 
  ret = argp_parse(&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
548
 
  if(ret == ARGP_ERR_UNKNOWN){
 
528
  ret = argp_parse (&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
 
529
  if (ret == ARGP_ERR_UNKNOWN){
549
530
    fprintf(stderr, "Unknown error while parsing arguments\n");
550
531
    exitstatus = EXIT_FAILURE;
551
532
    goto fallback;
555
536
  argp.parser = parse_opt;
556
537
  
557
538
  /* Open the configfile if available */
558
 
  if(argfile == NULL){
 
539
  if (argfile == NULL){
559
540
    conffp = fopen(AFILE, "r");
560
541
  } else {
561
542
    conffp = fopen(argfile, "r");
564
545
    char *org_line = NULL;
565
546
    char *p, *arg, *new_arg, *line;
566
547
    size_t size = 0;
 
548
    ssize_t sret;
567
549
    const char whitespace_delims[] = " \r\t\f\v\n";
568
550
    const char comment_delim[] = "#";
569
551
 
616
598
  } else {
617
599
    /* Check for harmful errors and go to fallback. Other errors might
618
600
       not affect opening plugins */
619
 
    if(errno == EMFILE or errno == ENFILE or errno == ENOMEM){
 
601
    if (errno == EMFILE or errno == ENFILE or errno == ENOMEM){
620
602
      perror("fopen");
621
603
      exitstatus = EXIT_FAILURE;
622
604
      goto fallback;
625
607
  /* If there was any arguments from configuration file,
626
608
     pass them to parser as command arguments */
627
609
  if(custom_argv != NULL){
628
 
    ret = argp_parse(&argp, custom_argc, custom_argv, ARGP_IN_ORDER,
629
 
                     0, NULL);
630
 
    if(ret == ARGP_ERR_UNKNOWN){
 
610
    ret = argp_parse (&argp, custom_argc, custom_argv, ARGP_IN_ORDER,
 
611
                      0, NULL);
 
612
    if (ret == ARGP_ERR_UNKNOWN){
631
613
      fprintf(stderr, "Unknown error while parsing arguments\n");
632
614
      exitstatus = EXIT_FAILURE;
633
615
      goto fallback;
636
618
  
637
619
  /* Parse actual command line arguments, to let them override the
638
620
     config file */
639
 
  ret = argp_parse(&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
640
 
  if(ret == ARGP_ERR_UNKNOWN){
 
621
  ret = argp_parse (&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
 
622
  if (ret == ARGP_ERR_UNKNOWN){
641
623
    fprintf(stderr, "Unknown error while parsing arguments\n");
642
624
    exitstatus = EXIT_FAILURE;
643
625
    goto fallback;
650
632
      for(char **a = p->argv; *a != NULL; a++){
651
633
        fprintf(stderr, "\tArg: %s\n", *a);
652
634
      }
653
 
      fprintf(stderr, "...and %d environment variables\n", p->envc);
 
635
      fprintf(stderr, "...and %u environment variables\n", p->envc);
654
636
      for(char **a = p->environ; *a != NULL; a++){
655
637
        fprintf(stderr, "\t%s\n", *a);
656
638
      }
658
640
  }
659
641
  
660
642
  /* Strip permissions down to nobody */
 
643
  ret = setuid(uid);
 
644
  if (ret == -1){
 
645
    perror("setuid");
 
646
  }  
661
647
  setgid(gid);
662
 
  if(ret == -1){
 
648
  if (ret == -1){
663
649
    perror("setgid");
664
650
  }
665
 
  ret = setuid(uid);
666
 
  if(ret == -1){
667
 
    perror("setuid");
668
 
  }
669
651
  
670
 
  if(plugindir == NULL){
 
652
  if (plugindir == NULL){
671
653
    dir = opendir(PDIR);
672
654
  } else {
673
655
    dir = opendir(plugindir);
700
682
    
701
683
    /* All directory entries have been processed */
702
684
    if(dirst == NULL){
703
 
      if(errno == EBADF){
 
685
      if (errno == EBADF){
704
686
        perror("readdir");
705
687
        exitstatus = EXIT_FAILURE;
706
688
        goto fallback;
718
700
      
719
701
      const char const *bad_suffixes[] = { "~", "#", ".dpkg-new",
720
702
                                           ".dpkg-old",
721
 
                                           ".dpkg-bak",
722
703
                                           ".dpkg-divert", NULL };
723
704
      for(const char **pre = bad_prefixes; *pre != NULL; pre++){
724
705
        size_t pre_len = strlen(*pre);
766
747
    }
767
748
    
768
749
    ret = stat(filename, &st);
769
 
    if(ret == -1){
 
750
    if (ret == -1){
770
751
      perror("stat");
771
752
      free(filename);
772
753
      continue;
773
754
    }
774
755
 
775
756
    /* Ignore non-executable files */
776
 
    if(not S_ISREG(st.st_mode) or (access(filename, X_OK) != 0)){
 
757
    if (not S_ISREG(st.st_mode) or (access(filename, X_OK) != 0)){
777
758
      if(debug){
778
759
        fprintf(stderr, "Ignoring plugin dir entry \"%s\""
779
760
                " with bad type or mode\n", filename);
826
807
    
827
808
    int pipefd[2];
828
809
    ret = pipe(pipefd);
829
 
    if(ret == -1){
 
810
    if (ret == -1){
830
811
      perror("pipe");
831
812
      exitstatus = EXIT_FAILURE;
832
813
      goto fallback;
845
826
      goto fallback;
846
827
    }
847
828
    /* Block SIGCHLD until process is safely in process list */
848
 
    ret = sigprocmask(SIG_BLOCK, &sigchld_action.sa_mask, NULL);
 
829
    ret = sigprocmask (SIG_BLOCK, &sigchld_action.sa_mask, NULL);
849
830
    if(ret < 0){
850
831
      perror("sigprocmask");
851
832
      exitstatus = EXIT_FAILURE;
899
880
    close(pipefd[1]);           /* Close unused write end of pipe */
900
881
    free(filename);
901
882
    plugin *new_plugin = getplugin(dirst->d_name);
902
 
    if(new_plugin == NULL){
 
883
    if (new_plugin == NULL){
903
884
      perror("getplugin");
904
 
      ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
 
885
      ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
905
886
      if(ret < 0){
906
887
        perror("sigprocmask");
907
888
      }
914
895
    
915
896
    /* Unblock SIGCHLD so signal handler can be run if this process
916
897
       has already completed */
917
 
    ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
 
898
    ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
918
899
    if(ret < 0){
919
900
      perror("sigprocmask");
920
901
      exitstatus = EXIT_FAILURE;
923
904
    
924
905
    FD_SET(new_plugin->fd, &rfds_all);
925
906
    
926
 
    if(maxfd < new_plugin->fd){
 
907
    if (maxfd < new_plugin->fd){
927
908
      maxfd = new_plugin->fd;
928
909
    }
929
910
  }
930
911
  
931
912
  closedir(dir);
932
913
  dir = NULL;
933
 
  free_plugin(getplugin(NULL));
934
914
  
935
915
  for(plugin *p = plugin_list; p != NULL; p = p->next){
936
916
    if(p->pid != 0){
947
927
  while(plugin_list){
948
928
    fd_set rfds = rfds_all;
949
929
    int select_ret = select(maxfd+1, &rfds, NULL, NULL, NULL);
950
 
    if(select_ret == -1){
 
930
    if (select_ret == -1){
951
931
      perror("select");
952
932
      exitstatus = EXIT_FAILURE;
953
933
      goto fallback;
956
936
       from one of them */
957
937
    for(plugin *proc = plugin_list; proc != NULL;){
958
938
      /* Is this process completely done? */
959
 
      if(proc->completed and proc->eof){
 
939
      if(proc->eof and proc->completed){
960
940
        /* Only accept the plugin output if it exited cleanly */
961
941
        if(not WIFEXITED(proc->status)
962
942
           or WEXITSTATUS(proc->status) != 0){
964
944
 
965
945
          if(debug){
966
946
            if(WIFEXITED(proc->status)){
967
 
              fprintf(stderr, "Plugin %s [%" PRIdMAX "] exited with"
968
 
                      " status %d\n", proc->name,
969
 
                      (intmax_t) (proc->pid),
 
947
              fprintf(stderr, "Plugin %u exited with status %d\n",
 
948
                      (unsigned int) (proc->pid),
970
949
                      WEXITSTATUS(proc->status));
971
 
            } else if(WIFSIGNALED(proc->status)){
972
 
              fprintf(stderr, "Plugin %s [%" PRIdMAX "] killed by"
973
 
                      " signal %d\n", proc->name,
974
 
                      (intmax_t) (proc->pid),
 
950
            } else if(WIFSIGNALED(proc->status)) {
 
951
              fprintf(stderr, "Plugin %u killed by signal %d\n",
 
952
                      (unsigned int) (proc->pid),
975
953
                      WTERMSIG(proc->status));
976
954
            } else if(WCOREDUMP(proc->status)){
977
 
              fprintf(stderr, "Plugin %s [%" PRIdMAX "] dumped"
978
 
                      " core\n", proc->name, (intmax_t) (proc->pid));
 
955
              fprintf(stderr, "Plugin %d dumped core\n",
 
956
                      (unsigned int) (proc->pid));
979
957
            }
980
958
          }
981
959
          
995
973
          proc = next_plugin;
996
974
          
997
975
          /* We are done modifying process list, so unblock signal */
998
 
          ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask,
999
 
                            NULL);
 
976
          ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask,
 
977
                             NULL);
1000
978
          if(ret < 0){
1001
979
            perror("sigprocmask");
1002
980
            exitstatus = EXIT_FAILURE;
1031
1009
      if(proc->buffer_length + BUFFER_SIZE > proc->buffer_size){
1032
1010
        proc->buffer = realloc(proc->buffer, proc->buffer_size
1033
1011
                               + (size_t) BUFFER_SIZE);
1034
 
        if(proc->buffer == NULL){
 
1012
        if (proc->buffer == NULL){
1035
1013
          perror("malloc");
1036
1014
          exitstatus = EXIT_FAILURE;
1037
1015
          goto fallback;
1039
1017
        proc->buffer_size += BUFFER_SIZE;
1040
1018
      }
1041
1019
      /* Read from the process */
1042
 
      sret = read(proc->fd, proc->buffer + proc->buffer_length,
1043
 
                  BUFFER_SIZE);
1044
 
      if(sret < 0){
 
1020
      ret = read(proc->fd, proc->buffer + proc->buffer_length,
 
1021
                 BUFFER_SIZE);
 
1022
      if(ret < 0){
1045
1023
        /* Read error from this process; ignore the error */
1046
1024
        proc = proc->next;
1047
1025
        continue;
1048
1026
      }
1049
 
      if(sret == 0){
 
1027
      if(ret == 0){
1050
1028
        /* got EOF */
1051
1029
        proc->eof = true;
1052
1030
      } else {
1053
 
        proc->buffer_length += (size_t) sret;
 
1031
        proc->buffer_length += (size_t) ret;
1054
1032
      }
1055
1033
    }
1056
1034
  }