/mandos/release

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/release

« back to all changes in this revision

Viewing changes to plugin-runner.c

  • Committer: Teddy Hogeborn
  • Date: 2009-02-25 01:31:13 UTC
  • Revision ID: teddy@fukt.bsnet.se-20090225013113-mzw86kzgqrhd9rfm
Tags: version-1.0.8-1
* Makefile (version): Changed to "1.0.8".
* NEWS (Version 1.0.8): New entry.
* debian/changelog (1.0.8-1): - '' -

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
/*  -*- coding: utf-8; mode: c; mode: orgtbl -*- */
 
1
/*  -*- coding: utf-8 -*- */
2
2
/*
3
3
 * Mandos plugin runner - Run Mandos plugins
4
4
 *
5
 
 * Copyright © 2008-2013 Teddy Hogeborn
6
 
 * Copyright © 2008-2013 Björn Påhlsson
 
5
 * Copyright © 2008,2009 Teddy Hogeborn
 
6
 * Copyright © 2008,2009 Björn Påhlsson
7
7
 * 
8
8
 * This program is free software: you can redistribute it and/or
9
9
 * modify it under the terms of the GNU General Public License as
19
19
 * along with this program.  If not, see
20
20
 * <http://www.gnu.org/licenses/>.
21
21
 * 
22
 
 * Contact the authors at <mandos@recompile.se>.
 
22
 * Contact the authors at <mandos@fukt.bsnet.se>.
23
23
 */
24
24
 
25
25
#define _GNU_SOURCE             /* TEMP_FAILURE_RETRY(), getline(),
26
 
                                   asprintf(), O_CLOEXEC */
 
26
                                   asprintf() */
27
27
#include <stddef.h>             /* size_t, NULL */
28
 
#include <stdlib.h>             /* malloc(), exit(), EXIT_SUCCESS,
29
 
                                   realloc() */
 
28
#include <stdlib.h>             /* malloc(), exit(), EXIT_FAILURE,
 
29
                                   EXIT_SUCCESS, realloc() */
30
30
#include <stdbool.h>            /* bool, true, false */
31
 
#include <stdio.h>              /* fileno(), fprintf(),
 
31
#include <stdio.h>              /* perror, fileno(), fprintf(),
32
32
                                   stderr, STDOUT_FILENO */
33
 
#include <sys/types.h>          /* DIR, fdopendir(), stat(), struct
 
33
#include <sys/types.h>          /* DIR, opendir(), stat(), struct
34
34
                                   stat, waitpid(), WIFEXITED(),
35
35
                                   WEXITSTATUS(), wait(), pid_t,
36
36
                                   uid_t, gid_t, getuid(), getgid(),
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(),
42
 
                                   WCOREDUMP() */
 
41
                                   WEXITSTATUS() */
43
42
#include <sys/stat.h>           /* struct stat, stat(), S_ISREG() */
44
43
#include <iso646.h>             /* and, or, not */
45
 
#include <dirent.h>             /* DIR, struct dirent, fdopendir(),
 
44
#include <dirent.h>             /* DIR, struct dirent, opendir(),
46
45
                                   readdir(), closedir(), dirfd() */
47
46
#include <unistd.h>             /* struct stat, stat(), S_ISREG(),
48
47
                                   fcntl(), setuid(), setgid(),
53
52
                                   close() */
54
53
#include <fcntl.h>              /* fcntl(), F_GETFD, F_SETFD,
55
54
                                   FD_CLOEXEC */
56
 
#include <string.h>             /* strsep, strlen(), asprintf(),
57
 
                                   strsignal(), strcmp(), strncmp() */
 
55
#include <string.h>             /* strsep, strlen(), asprintf() */
58
56
#include <errno.h>              /* errno */
59
57
#include <argp.h>               /* struct argp_option, struct
60
58
                                   argp_state, struct argp,
68
66
                                */
69
67
#include <errno.h>              /* errno, EBADF */
70
68
#include <inttypes.h>           /* intmax_t, PRIdMAX, strtoimax() */
71
 
#include <sysexits.h>           /* EX_OSERR, EX_USAGE, EX_IOERR,
72
 
                                   EX_CONFIG, EX_UNAVAILABLE, EX_OK */
73
 
#include <errno.h>              /* errno */
74
 
#include <error.h>              /* error() */
75
69
 
76
70
#define BUFFER_SIZE 256
77
71
 
79
73
#define AFILE "/conf/conf.d/mandos/plugin-runner.conf"
80
74
 
81
75
const char *argp_program_version = "plugin-runner " VERSION;
82
 
const char *argp_program_bug_address = "<mandos@recompile.se>";
 
76
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
83
77
 
84
78
typedef struct plugin{
85
79
  char *name;                   /* can be NULL or any plugin name */
106
100
/* Gets an existing plugin based on name,
107
101
   or if none is found, creates a new one */
108
102
static plugin *getplugin(char *name){
109
 
  /* Check for existing plugin with that name */
 
103
  /* Check for exiting plugin with that name */
110
104
  for(plugin *p = plugin_list; p != NULL; p = p->next){
111
105
    if((p->name == name)
112
106
       or (p->name and name and (strcmp(p->name, name) == 0))){
114
108
    }
115
109
  }
116
110
  /* Create a new plugin */
117
 
  plugin *new_plugin = NULL;
118
 
  do {
119
 
    new_plugin = malloc(sizeof(plugin));
120
 
  } while(new_plugin == NULL and errno == EINTR);
 
111
  plugin *new_plugin = malloc(sizeof(plugin));
121
112
  if(new_plugin == NULL){
122
113
    return NULL;
123
114
  }
124
115
  char *copy_name = NULL;
125
116
  if(name != NULL){
126
 
    do {
127
 
      copy_name = strdup(name);
128
 
    } while(copy_name == NULL and errno == EINTR);
 
117
    copy_name = strdup(name);
129
118
    if(copy_name == NULL){
130
 
      int e = errno;
131
119
      free(new_plugin);
132
 
      errno = e;
133
120
      return NULL;
134
121
    }
135
122
  }
139
126
                          .disabled = false,
140
127
                          .next = plugin_list };
141
128
  
142
 
  do {
143
 
    new_plugin->argv = malloc(sizeof(char *) * 2);
144
 
  } while(new_plugin->argv == NULL and errno == EINTR);
 
129
  new_plugin->argv = malloc(sizeof(char *) * 2);
145
130
  if(new_plugin->argv == NULL){
146
 
    int e = errno;
147
131
    free(copy_name);
148
132
    free(new_plugin);
149
 
    errno = e;
150
133
    return NULL;
151
134
  }
152
135
  new_plugin->argv[0] = copy_name;
153
136
  new_plugin->argv[1] = NULL;
154
137
  
155
 
  do {
156
 
    new_plugin->environ = malloc(sizeof(char *));
157
 
  } while(new_plugin->environ == NULL and errno == EINTR);
 
138
  new_plugin->environ = malloc(sizeof(char *));
158
139
  if(new_plugin->environ == NULL){
159
 
    int e = errno;
160
140
    free(copy_name);
161
141
    free(new_plugin->argv);
162
142
    free(new_plugin);
163
 
    errno = e;
164
143
    return NULL;
165
144
  }
166
145
  new_plugin->environ[0] = NULL;
171
150
}
172
151
 
173
152
/* Helper function for add_argument and add_environment */
174
 
__attribute__((nonnull))
175
153
static bool add_to_char_array(const char *new, char ***array,
176
154
                              int *len){
177
155
  /* Resize the pointed-to array to hold one more pointer */
178
 
  do {
179
 
    *array = realloc(*array, sizeof(char *)
180
 
                     * (size_t) ((*len) + 2));
181
 
  } while(*array == NULL and errno == EINTR);
 
156
  *array = realloc(*array, sizeof(char *)
 
157
                   * (size_t) ((*len) + 2));
182
158
  /* Malloc check */
183
159
  if(*array == NULL){
184
160
    return false;
185
161
  }
186
162
  /* Make a copy of the new string */
187
 
  char *copy;
188
 
  do {
189
 
    copy = strdup(new);
190
 
  } while(copy == NULL and errno == EINTR);
 
163
  char *copy = strdup(new);
191
164
  if(copy == NULL){
192
165
    return false;
193
166
  }
200
173
}
201
174
 
202
175
/* Add to a plugin's argument vector */
203
 
__attribute__((nonnull(2)))
204
176
static bool add_argument(plugin *p, const char *arg){
205
177
  if(p == NULL){
206
178
    return false;
209
181
}
210
182
 
211
183
/* Add to a plugin's environment */
212
 
__attribute__((nonnull(2)))
213
184
static bool add_environment(plugin *p, const char *def, bool replace){
214
185
  if(p == NULL){
215
186
    return false;
221
192
    if(strncmp(*e, def, namelen + 1) == 0){
222
193
      /* It already exists */
223
194
      if(replace){
224
 
        char *new;
225
 
        do {
226
 
          new = realloc(*e, strlen(def) + 1);
227
 
        } while(new == NULL and errno == EINTR);
 
195
        char *new = realloc(*e, strlen(def) + 1);
228
196
        if(new == NULL){
229
197
          return false;
230
198
        }
240
208
/*
241
209
 * Based on the example in the GNU LibC manual chapter 13.13 "File
242
210
 * Descriptor Flags".
243
 
 | [[info:libc:Descriptor%20Flags][File Descriptor Flags]] |
 
211
 * *Note File Descriptor Flags:(libc)Descriptor Flags.
244
212
 */
245
213
static int set_cloexec_flag(int fd){
246
 
  int ret = (int)TEMP_FAILURE_RETRY(fcntl(fd, F_GETFD, 0));
 
214
  int ret = fcntl(fd, F_GETFD, 0);
247
215
  /* If reading the flags failed, return error indication now. */
248
216
  if(ret < 0){
249
217
    return ret;
250
218
  }
251
219
  /* Store modified flag word in the descriptor. */
252
 
  return (int)TEMP_FAILURE_RETRY(fcntl(fd, F_SETFD,
253
 
                                       ret | FD_CLOEXEC));
 
220
  return fcntl(fd, F_SETFD, ret | FD_CLOEXEC);
254
221
}
255
222
 
256
223
 
271
238
        /* No child processes */
272
239
        break;
273
240
      }
274
 
      error(0, errno, "waitpid");
 
241
      perror("waitpid");
275
242
    }
276
243
    
277
244
    /* A child exited, find it in process_list */
289
256
}
290
257
 
291
258
/* Prints out a password to stdout */
292
 
__attribute__((nonnull))
293
259
static bool print_out_password(const char *buffer, size_t length){
294
260
  ssize_t ret;
295
261
  for(size_t written = 0; written < length; written += (size_t)ret){
303
269
}
304
270
 
305
271
/* Removes and free a plugin from the plugin list */
306
 
__attribute__((nonnull))
307
272
static void free_plugin(plugin *plugin_node){
308
273
  
309
274
  for(char **arg = plugin_node->argv; *arg != NULL; arg++){
350
315
  fd_set rfds_all;
351
316
  int ret, maxfd = 0;
352
317
  ssize_t sret;
 
318
  intmax_t tmpmax;
353
319
  uid_t uid = 65534;
354
320
  gid_t gid = 65534;
355
321
  bool debug = false;
364
330
  sigemptyset(&sigchld_action.sa_mask);
365
331
  ret = sigaddset(&sigchld_action.sa_mask, SIGCHLD);
366
332
  if(ret == -1){
367
 
    error(0, errno, "sigaddset");
368
 
    exitstatus = EX_OSERR;
 
333
    perror("sigaddset");
 
334
    exitstatus = EXIT_FAILURE;
369
335
    goto fallback;
370
336
  }
371
337
  ret = sigaction(SIGCHLD, &sigchld_action, &old_sigchld_action);
372
338
  if(ret == -1){
373
 
    error(0, errno, "sigaction");
374
 
    exitstatus = EX_OSERR;
 
339
    perror("sigaction");
 
340
    exitstatus = EXIT_FAILURE;
375
341
    goto fallback;
376
342
  }
377
343
  
409
375
      .doc = "Group ID the plugins will run as", .group = 3 },
410
376
    { .name = "debug", .key = 132,
411
377
      .doc = "Debug mode", .group = 4 },
412
 
    /*
413
 
     * These reproduce what we would get without ARGP_NO_HELP
414
 
     */
415
 
    { .name = "help", .key = '?',
416
 
      .doc = "Give this help list", .group = -1 },
417
 
    { .name = "usage", .key = -3,
418
 
      .doc = "Give a short usage message", .group = -1 },
419
 
    { .name = "version", .key = 'V',
420
 
      .doc = "Print program version", .group = -1 },
421
378
    { .name = NULL }
422
379
  };
423
380
  
424
 
  __attribute__((nonnull(3)))
425
 
  error_t parse_opt(int key, char *arg, struct argp_state *state){
426
 
    errno = 0;
 
381
  error_t parse_opt(int key, char *arg, __attribute__((unused))
 
382
                    struct argp_state *state){
 
383
    char *tmp;
427
384
    switch(key){
428
 
      char *tmp;
429
 
      intmax_t tmp_id;
430
385
    case 'g':                   /* --global-options */
431
 
      {
 
386
      if(arg != NULL){
432
387
        char *plugin_option;
433
388
        while((plugin_option = strsep(&arg, ",")) != NULL){
 
389
          if(plugin_option[0] == '\0'){
 
390
            continue;
 
391
          }
434
392
          if(not add_argument(getplugin(NULL), plugin_option)){
435
 
            break;
 
393
            perror("add_argument");
 
394
            return ARGP_ERR_UNKNOWN;
436
395
          }
437
396
        }
438
397
      }
439
398
      break;
440
399
    case 'G':                   /* --global-env */
441
 
      add_environment(getplugin(NULL), arg, true);
 
400
      if(arg == NULL){
 
401
        break;
 
402
      }
 
403
      if(not add_environment(getplugin(NULL), arg, true)){
 
404
        perror("add_environment");
 
405
      }
442
406
      break;
443
407
    case 'o':                   /* --options-for */
444
 
      {
445
 
        char *option_list = strchr(arg, ':');
446
 
        if(option_list == NULL){
447
 
          argp_error(state, "No colon in \"%s\"", arg);
448
 
          errno = EINVAL;
449
 
          break;
450
 
        }
451
 
        *option_list = '\0';
452
 
        option_list++;
453
 
        if(arg[0] == '\0'){
454
 
          argp_error(state, "Empty plugin name");
455
 
          errno = EINVAL;
456
 
          break;
457
 
        }
458
 
        char *option;
459
 
        while((option = strsep(&option_list, ",")) != NULL){
460
 
          if(not add_argument(getplugin(arg), option)){
461
 
            break;
 
408
      if(arg != NULL){
 
409
        char *plugin_name = strsep(&arg, ":");
 
410
        if(plugin_name[0] == '\0'){
 
411
          break;
 
412
        }
 
413
        char *plugin_option;
 
414
        while((plugin_option = strsep(&arg, ",")) != NULL){
 
415
          if(not add_argument(getplugin(plugin_name), plugin_option)){
 
416
            perror("add_argument");
 
417
            return ARGP_ERR_UNKNOWN;
462
418
          }
463
419
        }
464
420
      }
465
421
      break;
466
422
    case 'E':                   /* --env-for */
 
423
      if(arg == NULL){
 
424
        break;
 
425
      }
467
426
      {
468
427
        char *envdef = strchr(arg, ':');
469
428
        if(envdef == NULL){
470
 
          argp_error(state, "No colon in \"%s\"", arg);
471
 
          errno = EINVAL;
472
429
          break;
473
430
        }
474
431
        *envdef = '\0';
475
 
        envdef++;
476
 
        if(arg[0] == '\0'){
477
 
          argp_error(state, "Empty plugin name");
478
 
          errno = EINVAL;
479
 
          break;
 
432
        if(not add_environment(getplugin(arg), envdef+1, true)){
 
433
          perror("add_environment");
480
434
        }
481
 
        add_environment(getplugin(arg), envdef, true);
482
435
      }
483
436
      break;
484
437
    case 'd':                   /* --disable */
485
 
      {
 
438
      if(arg != NULL){
486
439
        plugin *p = getplugin(arg);
487
 
        if(p != NULL){
488
 
          p->disabled = true;
 
440
        if(p == NULL){
 
441
          return ARGP_ERR_UNKNOWN;
489
442
        }
 
443
        p->disabled = true;
490
444
      }
491
445
      break;
492
446
    case 'e':                   /* --enable */
493
 
      {
 
447
      if(arg != NULL){
494
448
        plugin *p = getplugin(arg);
495
 
        if(p != NULL){
496
 
          p->disabled = false;
 
449
        if(p == NULL){
 
450
          return ARGP_ERR_UNKNOWN;
497
451
        }
 
452
        p->disabled = false;
498
453
      }
499
454
      break;
500
455
    case 128:                   /* --plugin-dir */
501
456
      free(plugindir);
502
457
      plugindir = strdup(arg);
 
458
      if(plugindir == NULL){
 
459
        perror("strdup");
 
460
      }      
503
461
      break;
504
462
    case 129:                   /* --config-file */
505
463
      /* This is already done by parse_opt_config_file() */
506
464
      break;
507
465
    case 130:                   /* --userid */
508
 
      tmp_id = strtoimax(arg, &tmp, 10);
 
466
      errno = 0;
 
467
      tmpmax = strtoimax(arg, &tmp, 10);
509
468
      if(errno != 0 or tmp == arg or *tmp != '\0'
510
 
         or tmp_id != (uid_t)tmp_id){
511
 
        argp_error(state, "Bad user ID number: \"%s\", using %"
512
 
                   PRIdMAX, arg, (intmax_t)uid);
513
 
        break;
 
469
         or tmpmax != (uid_t)tmpmax){
 
470
        fprintf(stderr, "Bad user ID number: \"%s\", using %"
 
471
                PRIdMAX "\n", arg, (intmax_t)uid);
 
472
      } else {
 
473
        uid = (uid_t)tmpmax;
514
474
      }
515
 
      uid = (uid_t)tmp_id;
516
475
      break;
517
476
    case 131:                   /* --groupid */
518
 
      tmp_id = strtoimax(arg, &tmp, 10);
 
477
      errno = 0;
 
478
      tmpmax = strtoimax(arg, &tmp, 10);
519
479
      if(errno != 0 or tmp == arg or *tmp != '\0'
520
 
         or tmp_id != (gid_t)tmp_id){
521
 
        argp_error(state, "Bad group ID number: \"%s\", using %"
522
 
                   PRIdMAX, arg, (intmax_t)gid);
523
 
        break;
 
480
         or tmpmax != (gid_t)tmpmax){
 
481
        fprintf(stderr, "Bad group ID number: \"%s\", using %"
 
482
                PRIdMAX "\n", arg, (intmax_t)gid);
 
483
      } else {
 
484
        gid = (gid_t)tmpmax;
524
485
      }
525
 
      gid = (gid_t)tmp_id;
526
486
      break;
527
487
    case 132:                   /* --debug */
528
488
      debug = true;
529
489
      break;
530
 
      /*
531
 
       * These reproduce what we would get without ARGP_NO_HELP
532
 
       */
533
 
    case '?':                   /* --help */
534
 
      state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
535
 
      argp_state_help(state, state->out_stream, ARGP_HELP_STD_HELP);
536
 
    case -3:                    /* --usage */
537
 
      state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
538
 
      argp_state_help(state, state->out_stream,
539
 
                      ARGP_HELP_USAGE | ARGP_HELP_EXIT_OK);
540
 
    case 'V':                   /* --version */
541
 
      fprintf(state->out_stream, "%s\n", argp_program_version);
542
 
      exit(EXIT_SUCCESS);
543
 
      break;
544
490
/*
545
491
 * When adding more options before this line, remember to also add a
546
492
 * "case" to the "parse_opt_config_file" function below.
549
495
      /* Cryptsetup always passes an argument, which is an empty
550
496
         string if "none" was specified in /etc/crypttab.  So if
551
497
         argument was empty, we ignore it silently. */
552
 
      if(arg[0] == '\0'){
553
 
        break;
 
498
      if(arg[0] != '\0'){
 
499
        fprintf(stderr, "Ignoring unknown argument \"%s\"\n", arg);
554
500
      }
 
501
      break;
 
502
    case ARGP_KEY_END:
 
503
      break;
555
504
    default:
556
505
      return ARGP_ERR_UNKNOWN;
557
506
    }
558
 
    return errno;               /* Set to 0 at start */
 
507
    return 0;
559
508
  }
560
509
  
561
510
  /* This option parser is the same as parse_opt() above, except it
563
512
  error_t parse_opt_config_file(int key, char *arg,
564
513
                                __attribute__((unused))
565
514
                                struct argp_state *state){
566
 
    errno = 0;
567
515
    switch(key){
568
516
    case 'g':                   /* --global-options */
569
517
    case 'G':                   /* --global-env */
576
524
    case 129:                   /* --config-file */
577
525
      free(argfile);
578
526
      argfile = strdup(arg);
579
 
      break;
 
527
      if(argfile == NULL){
 
528
        perror("strdup");
 
529
      }
 
530
      break;      
580
531
    case 130:                   /* --userid */
581
532
    case 131:                   /* --groupid */
582
533
    case 132:                   /* --debug */
583
 
    case '?':                   /* --help */
584
 
    case -3:                    /* --usage */
585
 
    case 'V':                   /* --version */
586
534
    case ARGP_KEY_ARG:
 
535
    case ARGP_KEY_END:
587
536
      break;
588
537
    default:
589
538
      return ARGP_ERR_UNKNOWN;
590
539
    }
591
 
    return errno;
 
540
    return 0;
592
541
  }
593
542
  
594
543
  struct argp argp = { .options = options,
598
547
  
599
548
  /* Parse using parse_opt_config_file() in order to get the custom
600
549
     config file location, if any. */
601
 
  ret = argp_parse(&argp, argc, argv,
602
 
                   ARGP_IN_ORDER | ARGP_NO_EXIT | ARGP_NO_HELP,
603
 
                   NULL, NULL);
604
 
  switch(ret){
605
 
  case 0:
606
 
    break;
607
 
  case ENOMEM:
608
 
  default:
609
 
    errno = ret;
610
 
    error(0, errno, "argp_parse");
611
 
    exitstatus = EX_OSERR;
612
 
    goto fallback;
613
 
  case EINVAL:
614
 
    exitstatus = EX_USAGE;
 
550
  ret = argp_parse(&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
 
551
  if(ret == ARGP_ERR_UNKNOWN){
 
552
    fprintf(stderr, "Unknown error while parsing arguments\n");
 
553
    exitstatus = EXIT_FAILURE;
615
554
    goto fallback;
616
555
  }
617
556
  
623
562
    conffp = fopen(AFILE, "r");
624
563
  } else {
625
564
    conffp = fopen(argfile, "r");
626
 
  }
 
565
  }  
627
566
  if(conffp != NULL){
628
567
    char *org_line = NULL;
629
568
    char *p, *arg, *new_arg, *line;
634
573
    custom_argc = 1;
635
574
    custom_argv = malloc(sizeof(char*) * 2);
636
575
    if(custom_argv == NULL){
637
 
      error(0, errno, "malloc");
638
 
      exitstatus = EX_OSERR;
 
576
      perror("malloc");
 
577
      exitstatus = EXIT_FAILURE;
639
578
      goto fallback;
640
579
    }
641
580
    custom_argv[0] = argv[0];
657
596
        }
658
597
        new_arg = strdup(p);
659
598
        if(new_arg == NULL){
660
 
          error(0, errno, "strdup");
661
 
          exitstatus = EX_OSERR;
 
599
          perror("strdup");
 
600
          exitstatus = EXIT_FAILURE;
662
601
          free(org_line);
663
602
          goto fallback;
664
603
        }
667
606
        custom_argv = realloc(custom_argv, sizeof(char *)
668
607
                              * ((unsigned int) custom_argc + 1));
669
608
        if(custom_argv == NULL){
670
 
          error(0, errno, "realloc");
671
 
          exitstatus = EX_OSERR;
 
609
          perror("realloc");
 
610
          exitstatus = EXIT_FAILURE;
672
611
          free(org_line);
673
612
          goto fallback;
674
613
        }
675
614
        custom_argv[custom_argc-1] = new_arg;
676
 
        custom_argv[custom_argc] = NULL;
 
615
        custom_argv[custom_argc] = NULL;        
677
616
      }
678
617
    }
679
 
    do {
680
 
      ret = fclose(conffp);
681
 
    } while(ret == EOF and errno == EINTR);
682
 
    if(ret == EOF){
683
 
      error(0, errno, "fclose");
684
 
      exitstatus = EX_IOERR;
685
 
      goto fallback;
686
 
    }
687
618
    free(org_line);
688
619
  } else {
689
620
    /* Check for harmful errors and go to fallback. Other errors might
690
621
       not affect opening plugins */
691
622
    if(errno == EMFILE or errno == ENFILE or errno == ENOMEM){
692
 
      error(0, errno, "fopen");
693
 
      exitstatus = EX_OSERR;
 
623
      perror("fopen");
 
624
      exitstatus = EXIT_FAILURE;
694
625
      goto fallback;
695
626
    }
696
627
  }
697
 
  /* If there were any arguments from the configuration file, pass
698
 
     them to parser as command line arguments */
 
628
  /* If there was any arguments from configuration file,
 
629
     pass them to parser as command arguments */
699
630
  if(custom_argv != NULL){
700
 
    ret = argp_parse(&argp, custom_argc, custom_argv,
701
 
                     ARGP_IN_ORDER | ARGP_NO_EXIT | ARGP_NO_HELP,
702
 
                     NULL, NULL);
703
 
    switch(ret){
704
 
    case 0:
705
 
      break;
706
 
    case ENOMEM:
707
 
    default:
708
 
      errno = ret;
709
 
      error(0, errno, "argp_parse");
710
 
      exitstatus = EX_OSERR;
711
 
      goto fallback;
712
 
    case EINVAL:
713
 
      exitstatus = EX_CONFIG;
 
631
    ret = argp_parse(&argp, custom_argc, custom_argv, ARGP_IN_ORDER,
 
632
                     0, NULL);
 
633
    if(ret == ARGP_ERR_UNKNOWN){
 
634
      fprintf(stderr, "Unknown error while parsing arguments\n");
 
635
      exitstatus = EXIT_FAILURE;
714
636
      goto fallback;
715
637
    }
716
638
  }
717
639
  
718
640
  /* Parse actual command line arguments, to let them override the
719
641
     config file */
720
 
  ret = argp_parse(&argp, argc, argv,
721
 
                   ARGP_IN_ORDER | ARGP_NO_EXIT | ARGP_NO_HELP,
722
 
                   NULL, NULL);
723
 
  switch(ret){
724
 
  case 0:
725
 
    break;
726
 
  case ENOMEM:
727
 
  default:
728
 
    errno = ret;
729
 
    error(0, errno, "argp_parse");
730
 
    exitstatus = EX_OSERR;
731
 
    goto fallback;
732
 
  case EINVAL:
733
 
    exitstatus = EX_USAGE;
 
642
  ret = argp_parse(&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
 
643
  if(ret == ARGP_ERR_UNKNOWN){
 
644
    fprintf(stderr, "Unknown error while parsing arguments\n");
 
645
    exitstatus = EXIT_FAILURE;
734
646
    goto fallback;
735
647
  }
736
648
  
748
660
    }
749
661
  }
750
662
  
751
 
  if(getuid() == 0){
752
 
    /* Work around Debian bug #633582:
753
 
       <http://bugs.debian.org/633582> */
754
 
    int plugindir_fd = open(/* plugindir or */ PDIR, O_RDONLY);
755
 
    if(plugindir_fd == -1){
756
 
      error(0, errno, "open");
757
 
    } else {
758
 
      ret = (int)TEMP_FAILURE_RETRY(fstat(plugindir_fd, &st));
759
 
      if(ret == -1){
760
 
        error(0, errno, "fstat");
761
 
      } else {
762
 
        if(S_ISDIR(st.st_mode) and st.st_uid == 0 and st.st_gid == 0){
763
 
          ret = fchown(plugindir_fd, uid, gid);
764
 
          if(ret == -1){
765
 
            error(0, errno, "fchown");
766
 
          }
767
 
        }
768
 
      }
769
 
      TEMP_FAILURE_RETRY(close(plugindir_fd));
770
 
    }
771
 
  }
772
 
  
773
 
  /* Lower permissions */
774
 
  ret = setgid(gid);
 
663
  /* Strip permissions down to nobody */
 
664
  setgid(gid);
775
665
  if(ret == -1){
776
 
    error(0, errno, "setgid");
 
666
    perror("setgid");
777
667
  }
778
668
  ret = setuid(uid);
779
669
  if(ret == -1){
780
 
    error(0, errno, "setuid");
781
 
  }
782
 
  
783
 
  /* Open plugin directory with close_on_exec flag */
 
670
    perror("setuid");
 
671
  }
 
672
  
 
673
  if(plugindir == NULL){
 
674
    dir = opendir(PDIR);
 
675
  } else {
 
676
    dir = opendir(plugindir);
 
677
  }
 
678
  
 
679
  if(dir == NULL){
 
680
    perror("Could not open plugin dir");
 
681
    exitstatus = EXIT_FAILURE;
 
682
    goto fallback;
 
683
  }
 
684
  
 
685
  /* Set the FD_CLOEXEC flag on the directory, if possible */
784
686
  {
785
 
    int dir_fd = -1;
786
 
    if(plugindir == NULL){
787
 
      dir_fd = open(PDIR, O_RDONLY |
788
 
#ifdef O_CLOEXEC
789
 
                    O_CLOEXEC
790
 
#else  /* not O_CLOEXEC */
791
 
                    0
792
 
#endif  /* not O_CLOEXEC */
793
 
                    );
794
 
    } else {
795
 
      dir_fd = open(plugindir, O_RDONLY |
796
 
#ifdef O_CLOEXEC
797
 
                    O_CLOEXEC
798
 
#else  /* not O_CLOEXEC */
799
 
                    0
800
 
#endif  /* not O_CLOEXEC */
801
 
                    );
802
 
    }
803
 
    if(dir_fd == -1){
804
 
      error(0, errno, "Could not open plugin dir");
805
 
      exitstatus = EX_UNAVAILABLE;
806
 
      goto fallback;
807
 
    }
808
 
    
809
 
#ifndef O_CLOEXEC
810
 
  /* Set the FD_CLOEXEC flag on the directory */
811
 
    ret = set_cloexec_flag(dir_fd);
812
 
    if(ret < 0){
813
 
      error(0, errno, "set_cloexec_flag");
814
 
      TEMP_FAILURE_RETRY(close(dir_fd));
815
 
      exitstatus = EX_OSERR;
816
 
      goto fallback;
817
 
    }
818
 
#endif  /* O_CLOEXEC */
819
 
    
820
 
    dir = fdopendir(dir_fd);
821
 
    if(dir == NULL){
822
 
      error(0, errno, "Could not open plugin dir");
823
 
      TEMP_FAILURE_RETRY(close(dir_fd));
824
 
      exitstatus = EX_OSERR;
825
 
      goto fallback;
 
687
    int dir_fd = dirfd(dir);
 
688
    if(dir_fd >= 0){
 
689
      ret = set_cloexec_flag(dir_fd);
 
690
      if(ret < 0){
 
691
        perror("set_cloexec_flag");
 
692
        exitstatus = EXIT_FAILURE;
 
693
        goto fallback;
 
694
      }
826
695
    }
827
696
  }
828
697
  
830
699
  
831
700
  /* Read and execute any executable in the plugin directory*/
832
701
  while(true){
833
 
    do {
834
 
      dirst = readdir(dir);
835
 
    } while(dirst == NULL and errno == EINTR);
 
702
    dirst = readdir(dir);
836
703
    
837
704
    /* All directory entries have been processed */
838
705
    if(dirst == NULL){
839
706
      if(errno == EBADF){
840
 
        error(0, errno, "readdir");
841
 
        exitstatus = EX_IOERR;
 
707
        perror("readdir");
 
708
        exitstatus = EXIT_FAILURE;
842
709
        goto fallback;
843
710
      }
844
711
      break;
874
741
      for(const char **suf = bad_suffixes; *suf != NULL; suf++){
875
742
        size_t suf_len = strlen(*suf);
876
743
        if((d_name_len >= suf_len)
877
 
           and (strcmp((dirst->d_name) + d_name_len-suf_len, *suf)
 
744
           and (strcmp((dirst->d_name)+d_name_len-suf_len, *suf)
878
745
                == 0)){
879
746
          if(debug){
880
747
            fprintf(stderr, "Ignoring plugin dir entry \"%s\""
892
759
    
893
760
    char *filename;
894
761
    if(plugindir == NULL){
895
 
      ret = (int)TEMP_FAILURE_RETRY(asprintf(&filename, PDIR "/%s",
896
 
                                             dirst->d_name));
 
762
      ret = asprintf(&filename, PDIR "/%s", dirst->d_name);
897
763
    } else {
898
 
      ret = (int)TEMP_FAILURE_RETRY(asprintf(&filename, "%s/%s",
899
 
                                             plugindir,
900
 
                                             dirst->d_name));
 
764
      ret = asprintf(&filename, "%s/%s", plugindir, dirst->d_name);
901
765
    }
902
766
    if(ret < 0){
903
 
      error(0, errno, "asprintf");
 
767
      perror("asprintf");
904
768
      continue;
905
769
    }
906
770
    
907
 
    ret = (int)TEMP_FAILURE_RETRY(stat(filename, &st));
 
771
    ret = stat(filename, &st);
908
772
    if(ret == -1){
909
 
      error(0, errno, "stat");
 
773
      perror("stat");
910
774
      free(filename);
911
775
      continue;
912
776
    }
913
777
    
914
778
    /* Ignore non-executable files */
915
 
    if(not S_ISREG(st.st_mode)
916
 
       or (TEMP_FAILURE_RETRY(access(filename, X_OK)) != 0)){
 
779
    if(not S_ISREG(st.st_mode) or (access(filename, X_OK) != 0)){
917
780
      if(debug){
918
781
        fprintf(stderr, "Ignoring plugin dir entry \"%s\""
919
782
                " with bad type or mode\n", filename);
924
787
    
925
788
    plugin *p = getplugin(dirst->d_name);
926
789
    if(p == NULL){
927
 
      error(0, errno, "getplugin");
 
790
      perror("getplugin");
928
791
      free(filename);
929
792
      continue;
930
793
    }
942
805
      if(g != NULL){
943
806
        for(char **a = g->argv + 1; *a != NULL; a++){
944
807
          if(not add_argument(p, *a)){
945
 
            error(0, errno, "add_argument");
 
808
            perror("add_argument");
946
809
          }
947
810
        }
948
811
        /* Add global environment variables */
949
812
        for(char **e = g->environ; *e != NULL; e++){
950
813
          if(not add_environment(p, *e, false)){
951
 
            error(0, errno, "add_environment");
 
814
            perror("add_environment");
952
815
          }
953
816
        }
954
817
      }
959
822
    if(p->environ[0] != NULL){
960
823
      for(char **e = environ; *e != NULL; e++){
961
824
        if(not add_environment(p, *e, false)){
962
 
          error(0, errno, "add_environment");
 
825
          perror("add_environment");
963
826
        }
964
827
      }
965
828
    }
966
829
    
967
830
    int pipefd[2];
968
 
    ret = (int)TEMP_FAILURE_RETRY(pipe(pipefd));
 
831
    ret = pipe(pipefd);
969
832
    if(ret == -1){
970
 
      error(0, errno, "pipe");
971
 
      exitstatus = EX_OSERR;
 
833
      perror("pipe");
 
834
      exitstatus = EXIT_FAILURE;
972
835
      goto fallback;
973
836
    }
974
837
    /* Ask OS to automatic close the pipe on exec */
975
838
    ret = set_cloexec_flag(pipefd[0]);
976
839
    if(ret < 0){
977
 
      error(0, errno, "set_cloexec_flag");
978
 
      exitstatus = EX_OSERR;
 
840
      perror("set_cloexec_flag");
 
841
      exitstatus = EXIT_FAILURE;
979
842
      goto fallback;
980
843
    }
981
844
    ret = set_cloexec_flag(pipefd[1]);
982
845
    if(ret < 0){
983
 
      error(0, errno, "set_cloexec_flag");
984
 
      exitstatus = EX_OSERR;
 
846
      perror("set_cloexec_flag");
 
847
      exitstatus = EXIT_FAILURE;
985
848
      goto fallback;
986
849
    }
987
850
    /* Block SIGCHLD until process is safely in process list */
988
 
    ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_BLOCK,
989
 
                                              &sigchld_action.sa_mask,
990
 
                                              NULL));
 
851
    ret = sigprocmask(SIG_BLOCK, &sigchld_action.sa_mask, NULL);
991
852
    if(ret < 0){
992
 
      error(0, errno, "sigprocmask");
993
 
      exitstatus = EX_OSERR;
 
853
      perror("sigprocmask");
 
854
      exitstatus = EXIT_FAILURE;
994
855
      goto fallback;
995
856
    }
996
857
    /* Starting a new process to be watched */
997
 
    pid_t pid;
998
 
    do {
999
 
      pid = fork();
1000
 
    } while(pid == -1 and errno == EINTR);
 
858
    pid_t pid = fork();
1001
859
    if(pid == -1){
1002
 
      error(0, errno, "fork");
1003
 
      exitstatus = EX_OSERR;
 
860
      perror("fork");
 
861
      exitstatus = EXIT_FAILURE;
1004
862
      goto fallback;
1005
863
    }
1006
864
    if(pid == 0){
1007
865
      /* this is the child process */
1008
866
      ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1009
867
      if(ret < 0){
1010
 
        error(0, errno, "sigaction");
1011
 
        _exit(EX_OSERR);
 
868
        perror("sigaction");
 
869
        _exit(EXIT_FAILURE);
1012
870
      }
1013
871
      ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1014
872
      if(ret < 0){
1015
 
        error(0, errno, "sigprocmask");
1016
 
        _exit(EX_OSERR);
 
873
        perror("sigprocmask");
 
874
        _exit(EXIT_FAILURE);
1017
875
      }
1018
876
      
1019
877
      ret = dup2(pipefd[1], STDOUT_FILENO); /* replace our stdout */
1020
878
      if(ret == -1){
1021
 
        error(0, errno, "dup2");
1022
 
        _exit(EX_OSERR);
 
879
        perror("dup2");
 
880
        _exit(EXIT_FAILURE);
1023
881
      }
1024
882
      
1025
883
      if(dirfd(dir) < 0){
1029
887
      }
1030
888
      if(p->environ[0] == NULL){
1031
889
        if(execv(filename, p->argv) < 0){
1032
 
          error(0, errno, "execv for %s", filename);
1033
 
          _exit(EX_OSERR);
 
890
          perror("execv");
 
891
          _exit(EXIT_FAILURE);
1034
892
        }
1035
893
      } else {
1036
894
        if(execve(filename, p->argv, p->environ) < 0){
1037
 
          error(0, errno, "execve for %s", filename);
1038
 
          _exit(EX_OSERR);
 
895
          perror("execve");
 
896
          _exit(EXIT_FAILURE);
1039
897
        }
1040
898
      }
1041
899
      /* no return */
1042
900
    }
1043
901
    /* Parent process */
1044
 
    TEMP_FAILURE_RETRY(close(pipefd[1])); /* Close unused write end of
1045
 
                                             pipe */
 
902
    close(pipefd[1]);           /* Close unused write end of pipe */
1046
903
    free(filename);
1047
904
    plugin *new_plugin = getplugin(dirst->d_name);
1048
905
    if(new_plugin == NULL){
1049
 
      error(0, errno, "getplugin");
1050
 
      ret = (int)(TEMP_FAILURE_RETRY
1051
 
                  (sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask,
1052
 
                               NULL)));
 
906
      perror("getplugin");
 
907
      ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1053
908
      if(ret < 0){
1054
 
        error(0, errno, "sigprocmask");
 
909
        perror("sigprocmask");
1055
910
      }
1056
 
      exitstatus = EX_OSERR;
 
911
      exitstatus = EXIT_FAILURE;
1057
912
      goto fallback;
1058
913
    }
1059
914
    
1062
917
    
1063
918
    /* Unblock SIGCHLD so signal handler can be run if this process
1064
919
       has already completed */
1065
 
    ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1066
 
                                              &sigchld_action.sa_mask,
1067
 
                                              NULL));
 
920
    ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1068
921
    if(ret < 0){
1069
 
      error(0, errno, "sigprocmask");
1070
 
      exitstatus = EX_OSERR;
 
922
      perror("sigprocmask");
 
923
      exitstatus = EXIT_FAILURE;
1071
924
      goto fallback;
1072
925
    }
1073
926
    
1074
 
    FD_SET(new_plugin->fd, &rfds_all); /* Spurious warning from
1075
 
                                          -Wconversion */
 
927
    FD_SET(new_plugin->fd, &rfds_all);
1076
928
    
1077
929
    if(maxfd < new_plugin->fd){
1078
930
      maxfd = new_plugin->fd;
1079
931
    }
1080
932
  }
1081
933
  
1082
 
  TEMP_FAILURE_RETRY(closedir(dir));
 
934
  closedir(dir);
1083
935
  dir = NULL;
1084
936
  free_plugin(getplugin(NULL));
1085
937
  
1098
950
  while(plugin_list){
1099
951
    fd_set rfds = rfds_all;
1100
952
    int select_ret = select(maxfd+1, &rfds, NULL, NULL, NULL);
1101
 
    if(select_ret == -1 and errno != EINTR){
1102
 
      error(0, errno, "select");
1103
 
      exitstatus = EX_OSERR;
 
953
    if(select_ret == -1){
 
954
      perror("select");
 
955
      exitstatus = EXIT_FAILURE;
1104
956
      goto fallback;
1105
957
    }
1106
958
    /* OK, now either a process completed, or something can be read
1121
973
                      WEXITSTATUS(proc->status));
1122
974
            } else if(WIFSIGNALED(proc->status)){
1123
975
              fprintf(stderr, "Plugin %s [%" PRIdMAX "] killed by"
1124
 
                      " signal %d: %s\n", proc->name,
 
976
                      " signal %d\n", proc->name,
1125
977
                      (intmax_t) (proc->pid),
1126
 
                      WTERMSIG(proc->status),
1127
 
                      strsignal(WTERMSIG(proc->status)));
 
978
                      WTERMSIG(proc->status));
1128
979
            } else if(WCOREDUMP(proc->status)){
1129
980
              fprintf(stderr, "Plugin %s [%" PRIdMAX "] dumped"
1130
981
                      " core\n", proc->name, (intmax_t) (proc->pid));
1132
983
          }
1133
984
          
1134
985
          /* Remove the plugin */
1135
 
          FD_CLR(proc->fd, &rfds_all); /* Spurious warning from
1136
 
                                          -Wconversion */
 
986
          FD_CLR(proc->fd, &rfds_all);
1137
987
          
1138
988
          /* Block signal while modifying process_list */
1139
 
          ret = (int)TEMP_FAILURE_RETRY(sigprocmask
1140
 
                                        (SIG_BLOCK,
1141
 
                                         &sigchld_action.sa_mask,
1142
 
                                         NULL));
 
989
          ret = sigprocmask(SIG_BLOCK, &sigchld_action.sa_mask, NULL);
1143
990
          if(ret < 0){
1144
 
            error(0, errno, "sigprocmask");
1145
 
            exitstatus = EX_OSERR;
 
991
            perror("sigprocmask");
 
992
            exitstatus = EXIT_FAILURE;
1146
993
            goto fallback;
1147
994
          }
1148
995
          
1151
998
          proc = next_plugin;
1152
999
          
1153
1000
          /* We are done modifying process list, so unblock signal */
1154
 
          ret = (int)(TEMP_FAILURE_RETRY
1155
 
                      (sigprocmask(SIG_UNBLOCK,
1156
 
                                   &sigchld_action.sa_mask, NULL)));
 
1001
          ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask,
 
1002
                            NULL);
1157
1003
          if(ret < 0){
1158
 
            error(0, errno, "sigprocmask");
1159
 
            exitstatus = EX_OSERR;
 
1004
            perror("sigprocmask");
 
1005
            exitstatus = EXIT_FAILURE;
1160
1006
            goto fallback;
1161
1007
          }
1162
1008
          
1172
1018
        bool bret = print_out_password(proc->buffer,
1173
1019
                                       proc->buffer_length);
1174
1020
        if(not bret){
1175
 
          error(0, errno, "print_out_password");
1176
 
          exitstatus = EX_IOERR;
 
1021
          perror("print_out_password");
 
1022
          exitstatus = EXIT_FAILURE;
1177
1023
        }
1178
1024
        goto fallback;
1179
1025
      }
1180
1026
      
1181
1027
      /* This process has not completed.  Does it have any output? */
1182
 
      if(proc->eof or not FD_ISSET(proc->fd, &rfds)){ /* Spurious
1183
 
                                                         warning from
1184
 
                                                         -Wconversion */
 
1028
      if(proc->eof or not FD_ISSET(proc->fd, &rfds)){
1185
1029
        /* This process had nothing to say at this time */
1186
1030
        proc = proc->next;
1187
1031
        continue;
1191
1035
        proc->buffer = realloc(proc->buffer, proc->buffer_size
1192
1036
                               + (size_t) BUFFER_SIZE);
1193
1037
        if(proc->buffer == NULL){
1194
 
          error(0, errno, "malloc");
1195
 
          exitstatus = EX_OSERR;
 
1038
          perror("malloc");
 
1039
          exitstatus = EXIT_FAILURE;
1196
1040
          goto fallback;
1197
1041
        }
1198
1042
        proc->buffer_size += BUFFER_SIZE;
1199
1043
      }
1200
1044
      /* Read from the process */
1201
 
      sret = TEMP_FAILURE_RETRY(read(proc->fd,
1202
 
                                     proc->buffer
1203
 
                                     + proc->buffer_length,
1204
 
                                     BUFFER_SIZE));
 
1045
      sret = read(proc->fd, proc->buffer + proc->buffer_length,
 
1046
                  BUFFER_SIZE);
1205
1047
      if(sret < 0){
1206
1048
        /* Read error from this process; ignore the error */
1207
1049
        proc = proc->next;
1219
1061
  
1220
1062
 fallback:
1221
1063
  
1222
 
  if(plugin_list == NULL or (exitstatus != EXIT_SUCCESS
1223
 
                             and exitstatus != EX_OK)){
 
1064
  if(plugin_list == NULL or exitstatus != EXIT_SUCCESS){
1224
1065
    /* Fallback if all plugins failed, none are found or an error
1225
1066
       occured */
1226
1067
    bool bret;
1234
1075
    }
1235
1076
    bret = print_out_password(passwordbuffer, len);
1236
1077
    if(not bret){
1237
 
      error(0, errno, "print_out_password");
1238
 
      exitstatus = EX_IOERR;
 
1078
      perror("print_out_password");
 
1079
      exitstatus = EXIT_FAILURE;
1239
1080
    }
1240
1081
  }
1241
1082
  
1242
1083
  /* Restore old signal handler */
1243
1084
  ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1244
1085
  if(ret == -1){
1245
 
    error(0, errno, "sigaction");
1246
 
    exitstatus = EX_OSERR;
 
1086
    perror("sigaction");
 
1087
    exitstatus = EXIT_FAILURE;
1247
1088
  }
1248
1089
  
1249
1090
  if(custom_argv != NULL){
1264
1105
      ret = kill(p->pid, SIGTERM);
1265
1106
      if(ret == -1 and errno != ESRCH){
1266
1107
        /* Set-uid proccesses might not get closed */
1267
 
        error(0, errno, "kill");
 
1108
        perror("kill");
1268
1109
      }
1269
1110
    }
1270
1111
  }
1271
1112
  
1272
1113
  /* Wait for any remaining child processes to terminate */
1273
 
  do {
 
1114
  do{
1274
1115
    ret = wait(NULL);
1275
1116
  } while(ret >= 0);
1276
1117
  if(errno != ECHILD){
1277
 
    error(0, errno, "wait");
 
1118
    perror("wait");
1278
1119
  }
1279
1120
  
1280
1121
  free_plugin_list();