/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: 2008-09-06 16:33:54 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080906163354-x2l238fvbs2xashj
* .bzrignore: Rename "password-request" to "mandos-client".

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-2021 Teddy Hogeborn
6
 
 * Copyright © 2008-2021 Björn Påhlsson
7
 
 * 
8
 
 * This file is part of Mandos.
9
 
 * 
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.
14
 
 * 
15
 
 * Mandos is distributed in the hope that it will be useful, but
 
5
 * Copyright © 2007-2008 Teddy Hogeborn & Björn Påhlsson
 
6
 * 
 
7
 * This program is free software: you can redistribute it and/or
 
8
 * modify it under the terms of the GNU General Public License as
 
9
 * published by the Free Software Foundation, either version 3 of the
 
10
 * License, or (at your option) any later version.
 
11
 * 
 
12
 * This program is distributed in the hope that it will be useful, but
16
13
 * WITHOUT ANY WARRANTY; without even the implied warranty of
17
14
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18
15
 * General Public License for more details.
19
16
 * 
20
17
 * You should have received a copy of the GNU General Public License
21
 
 * along with Mandos.  If not, see <http://www.gnu.org/licenses/>.
 
18
 * along with this program.  If not, see
 
19
 * <http://www.gnu.org/licenses/>.
22
20
 * 
23
 
 * Contact the authors at <mandos@recompile.se>.
 
21
 * Contact the authors at <mandos@fukt.bsnet.se>.
24
22
 */
25
23
 
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,
31
 
                                   struct argp_option,
32
 
                                   struct argp_state, argp_error(),
33
 
                                   ARGP_NO_EXIT, argp_state_help,
34
 
                                   ARGP_HELP_STD_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() */
 
24
#define _GNU_SOURCE             /* TEMP_FAILURE_RETRY(), getline(),
 
25
                                   asprintf() */
42
26
#include <stddef.h>             /* size_t, NULL */
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,
51
 
                                   ENOENT, ESRCH */
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(),
62
 
                                   read(), getpass() */
 
27
#include <stdlib.h>             /* malloc(), exit(), EXIT_FAILURE,
 
28
                                   EXIT_SUCCESS, realloc() */
 
29
#include <stdbool.h>            /* bool, true, false */
 
30
#include <stdio.h>              /* perror, popen(), fileno(),
 
31
                                   fprintf(), stderr, STDOUT_FILENO */
 
32
#include <sys/types.h>          /* DIR, opendir(), stat(), struct
 
33
                                   stat, waitpid(), WIFEXITED(),
 
34
                                   WEXITSTATUS(), wait(), pid_t,
 
35
                                   uid_t, gid_t, getuid(), getgid(),
 
36
                                   dirfd() */
 
37
#include <sys/select.h>         /* fd_set, select(), FD_ZERO(),
 
38
                                   FD_SET(), FD_ISSET(), FD_CLR */
 
39
#include <sys/wait.h>           /* wait(), waitpid(), WIFEXITED(),
 
40
                                   WEXITSTATUS() */
 
41
#include <sys/stat.h>           /* struct stat, stat(), S_ISREG() */
 
42
#include <iso646.h>             /* and, or, not */
 
43
#include <dirent.h>             /* DIR, struct dirent, opendir(),
 
44
                                   readdir(), closedir(), dirfd() */
 
45
#include <unistd.h>             /* struct stat, stat(), S_ISREG(),
 
46
                                   fcntl(), setuid(), setgid(),
 
47
                                   F_GETFD, F_SETFD, FD_CLOEXEC,
 
48
                                   access(), pipe(), fork(), close()
 
49
                                   dup2, STDOUT_FILENO, _exit(),
 
50
                                   execv(), write(), read(),
 
51
                                   close() */
63
52
#include <fcntl.h>              /* fcntl(), F_GETFD, F_SETFD,
64
 
                                   FD_CLOEXEC, open(), O_RDONLY,
65
 
                                   O_CLOEXEC, openat() */
66
 
#include <sys/wait.h>           /* waitpid(), WNOHANG, WIFEXITED(),
67
 
                                   WEXITSTATUS(), WIFSIGNALED(),
68
 
                                   WTERMSIG(), wait() */
69
 
#include <error.h>              /* error() */
70
 
#include <stdio.h>              /* FILE, fprintf(), fopen(),
71
 
                                   getline(), fclose(), EOF,
72
 
                                   asprintf(), stderr */
73
 
#include <dirent.h>             /* struct dirent, scandirat(),
74
 
                                   alphasort() */
75
 
#include <sys/stat.h>           /* struct stat, fstat(), S_ISDIR(),
76
 
                                   lstat(), S_ISREG() */
77
 
#include <sys/select.h>         /* fd_set, FD_ZERO(), FD_SETSIZE,
78
 
                                   FD_SET(), select(), FD_CLR(),
79
 
                                   FD_ISSET() */
80
 
#include <signal.h>             /* struct sigaction, SA_NOCLDSTOP,
81
 
                                   sigemptyset(), sigaddset(),
82
 
                                   SIGCHLD, sigprocmask(), SIG_BLOCK,
83
 
                                   SIG_UNBLOCK, kill(), SIGTERM */
84
 
#include <sysexits.h>           /* EX_OSERR, EX_USAGE, EX_IOERR,
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 */
 
53
                                   FD_CLOEXEC */
 
54
#include <string.h>             /* strsep, strlen(), asprintf() */
 
55
#include <errno.h>              /* errno */
 
56
#include <argp.h>               /* struct argp_option, struct
 
57
                                   argp_state, struct argp,
 
58
                                   argp_parse(), ARGP_ERR_UNKNOWN,
 
59
                                   ARGP_KEY_END, ARGP_KEY_ARG,
 
60
                                   error_t */
 
61
#include <signal.h>             /* struct sigaction, sigemptyset(),
 
62
                                   sigaddset(), sigaction(),
 
63
                                   sigprocmask(), SIG_BLOCK, SIGCHLD,
 
64
                                   SIG_UNBLOCK, kill() */
 
65
#include <errno.h>              /* errno, EBADF */
89
66
 
90
67
#define BUFFER_SIZE 256
91
68
 
92
69
#define PDIR "/lib/mandos/plugins.d"
93
 
#define PHDIR "/lib/mandos/plugin-helpers"
94
70
#define AFILE "/conf/conf.d/mandos/plugin-runner.conf"
95
71
 
96
 
const char *argp_program_version = "plugin-runner " VERSION;
97
 
const char *argp_program_bug_address = "<mandos@recompile.se>";
 
72
const char *argp_program_version = "plugin-runner 1.0";
 
73
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
 
74
 
 
75
struct plugin;
98
76
 
99
77
typedef struct plugin{
100
78
  char *name;                   /* can be NULL or any plugin name */
103
81
  char **environ;
104
82
  int envc;
105
83
  bool disabled;
106
 
  
 
84
 
107
85
  /* Variables used for running processes*/
108
86
  pid_t pid;
109
87
  int fd;
111
89
  size_t buffer_size;
112
90
  size_t buffer_length;
113
91
  bool eof;
114
 
  volatile sig_atomic_t completed;
115
 
  int status;
 
92
  volatile bool completed;
 
93
  volatile int status;
116
94
  struct plugin *next;
117
95
} plugin;
118
96
 
120
98
 
121
99
/* Gets an existing plugin based on name,
122
100
   or if none is found, creates a new one */
123
 
__attribute__((warn_unused_result))
124
101
static plugin *getplugin(char *name){
125
 
  /* Check for existing plugin with that name */
126
 
  for(plugin *p = plugin_list; p != NULL; p = p->next){
127
 
    if((p->name == name)
128
 
       or (p->name and name and (strcmp(p->name, name) == 0))){
 
102
  /* Check for exiting plugin with that name */
 
103
  for (plugin *p = plugin_list; p != NULL; p = p->next){
 
104
    if ((p->name == name)
 
105
        or (p->name and name and (strcmp(p->name, name) == 0))){
129
106
      return p;
130
107
    }
131
108
  }
132
109
  /* Create a new plugin */
133
 
  plugin *new_plugin = NULL;
134
 
  do {
135
 
    new_plugin = malloc(sizeof(plugin));
136
 
  } while(new_plugin == NULL and errno == EINTR);
137
 
  if(new_plugin == NULL){
 
110
  plugin *new_plugin = malloc(sizeof(plugin));
 
111
  if (new_plugin == NULL){
138
112
    return NULL;
139
113
  }
140
114
  char *copy_name = NULL;
141
115
  if(name != NULL){
142
 
    do {
143
 
      copy_name = strdup(name);
144
 
    } while(copy_name == NULL and errno == EINTR);
 
116
    copy_name = strdup(name);
145
117
    if(copy_name == NULL){
146
 
      int e = errno;
147
 
      free(new_plugin);
148
 
      errno = e;
149
118
      return NULL;
150
119
    }
151
120
  }
152
121
  
153
 
  *new_plugin = (plugin){ .name = copy_name,
154
 
                          .argc = 1,
155
 
                          .disabled = false,
156
 
                          .next = plugin_list };
 
122
  *new_plugin = (plugin) { .name = copy_name,
 
123
                           .argc = 1,
 
124
                           .disabled = false,
 
125
                           .next = plugin_list };
157
126
  
158
 
  do {
159
 
    new_plugin->argv = malloc(sizeof(char *) * 2);
160
 
  } while(new_plugin->argv == NULL and errno == EINTR);
161
 
  if(new_plugin->argv == NULL){
162
 
    int e = errno;
 
127
  new_plugin->argv = malloc(sizeof(char *) * 2);
 
128
  if (new_plugin->argv == NULL){
163
129
    free(copy_name);
164
130
    free(new_plugin);
165
 
    errno = e;
166
131
    return NULL;
167
132
  }
168
133
  new_plugin->argv[0] = copy_name;
169
134
  new_plugin->argv[1] = NULL;
170
135
  
171
 
  do {
172
 
    new_plugin->environ = malloc(sizeof(char *));
173
 
  } while(new_plugin->environ == NULL and errno == EINTR);
 
136
  new_plugin->environ = malloc(sizeof(char *));
174
137
  if(new_plugin->environ == NULL){
175
 
    int e = errno;
176
138
    free(copy_name);
177
139
    free(new_plugin->argv);
178
140
    free(new_plugin);
179
 
    errno = e;
180
141
    return NULL;
181
142
  }
182
143
  new_plugin->environ[0] = NULL;
187
148
}
188
149
 
189
150
/* Helper function for add_argument and add_environment */
190
 
__attribute__((nonnull, warn_unused_result))
191
151
static bool add_to_char_array(const char *new, char ***array,
192
152
                              int *len){
193
153
  /* Resize the pointed-to array to hold one more pointer */
194
 
  char **new_array = NULL;
195
 
  do {
196
 
#if defined(__GLIBC_PREREQ) and __GLIBC_PREREQ(2, 26)
197
 
    new_array = reallocarray(*array, (size_t)((*len) + 2),
198
 
                             sizeof(char *));
199
 
#else
200
 
    if(((size_t)((*len) + 2)) > (SIZE_MAX / sizeof(char *))){
201
 
      /* overflow */
202
 
      new_array = NULL;
203
 
      errno = ENOMEM;
204
 
    } else {
205
 
      new_array = realloc(*array, (size_t)((*len) + 2)
206
 
                          * sizeof(char *));
207
 
    }
208
 
#endif
209
 
  } while(new_array == NULL and errno == EINTR);
 
154
  *array = realloc(*array, sizeof(char *)
 
155
                   * (size_t) ((*len) + 2));
210
156
  /* Malloc check */
211
 
  if(new_array == NULL){
 
157
  if(*array == NULL){
212
158
    return false;
213
159
  }
214
 
  *array = new_array;
215
160
  /* Make a copy of the new string */
216
 
  char *copy;
217
 
  do {
218
 
    copy = strdup(new);
219
 
  } while(copy == NULL and errno == EINTR);
 
161
  char *copy = strdup(new);
220
162
  if(copy == NULL){
221
163
    return false;
222
164
  }
229
171
}
230
172
 
231
173
/* Add to a plugin's argument vector */
232
 
__attribute__((nonnull(2), warn_unused_result))
233
174
static bool add_argument(plugin *p, const char *arg){
234
175
  if(p == NULL){
235
176
    return false;
238
179
}
239
180
 
240
181
/* Add to a plugin's environment */
241
 
__attribute__((nonnull(2), warn_unused_result))
242
182
static bool add_environment(plugin *p, const char *def, bool replace){
243
183
  if(p == NULL){
244
184
    return false;
246
186
  /* namelen = length of name of environment variable */
247
187
  size_t namelen = (size_t)(strchrnul(def, '=') - def);
248
188
  /* Search for this environment variable */
249
 
  for(char **envdef = p->environ; *envdef != NULL; envdef++){
250
 
    if(strncmp(*envdef, def, namelen + 1) == 0){
 
189
  for(char **e = p->environ; *e != NULL; e++){
 
190
    if(strncmp(*e, def, namelen + 1) == 0){
251
191
      /* It already exists */
252
192
      if(replace){
253
 
        char *new_envdef;
254
 
        do {
255
 
          new_envdef = realloc(*envdef, strlen(def) + 1);
256
 
        } while(new_envdef == NULL and errno == EINTR);
257
 
        if(new_envdef == NULL){
 
193
        char *new = realloc(*e, strlen(def) + 1);
 
194
        if(new == NULL){
258
195
          return false;
259
196
        }
260
 
        *envdef = new_envdef;
261
 
        strcpy(*envdef, def);
 
197
        *e = new;
 
198
        strcpy(*e, def);
262
199
      }
263
200
      return true;
264
201
    }
266
203
  return add_to_char_array(def, &(p->environ), &(p->envc));
267
204
}
268
205
 
269
 
#ifndef O_CLOEXEC
270
206
/*
271
207
 * Based on the example in the GNU LibC manual chapter 13.13 "File
272
208
 * Descriptor Flags".
273
 
 | [[info:libc:Descriptor%20Flags][File Descriptor Flags]] |
 
209
 * *Note File Descriptor Flags:(libc)Descriptor Flags.
274
210
 */
275
 
__attribute__((warn_unused_result))
276
 
static int set_cloexec_flag(int fd){
277
 
  int ret = (int)TEMP_FAILURE_RETRY(fcntl(fd, F_GETFD, 0));
 
211
static int set_cloexec_flag(int fd)
 
212
{
 
213
  int ret = fcntl(fd, F_GETFD, 0);
278
214
  /* If reading the flags failed, return error indication now. */
279
215
  if(ret < 0){
280
216
    return ret;
281
217
  }
282
218
  /* Store modified flag word in the descriptor. */
283
 
  return (int)TEMP_FAILURE_RETRY(fcntl(fd, F_SETFD,
284
 
                                       ret | FD_CLOEXEC));
 
219
  return fcntl(fd, F_SETFD, ret | FD_CLOEXEC);
285
220
}
286
 
#endif  /* not O_CLOEXEC */
287
221
 
288
222
 
289
223
/* Mark processes as completed when they exit, and save their exit
290
224
   status. */
291
 
static void handle_sigchld(__attribute__((unused)) int sig){
292
 
  int old_errno = errno;
 
225
void handle_sigchld(__attribute__((unused)) int sig){
293
226
  while(true){
294
227
    plugin *proc = plugin_list;
295
228
    int status;
299
232
      break;
300
233
    }
301
234
    if(pid == -1){
302
 
      if(errno == ECHILD){
303
 
        /* No child processes */
304
 
        break;
 
235
      if (errno != ECHILD){
 
236
        perror("waitpid");
305
237
      }
306
 
      error(0, errno, "waitpid");
 
238
      /* No child processes */
 
239
      break;
307
240
    }
308
241
    
309
242
    /* A child exited, find it in process_list */
315
248
      continue;
316
249
    }
317
250
    proc->status = status;
318
 
    proc->completed = 1;
 
251
    proc->completed = true;
319
252
  }
320
 
  errno = old_errno;
321
253
}
322
254
 
323
255
/* Prints out a password to stdout */
324
 
__attribute__((nonnull, warn_unused_result))
325
 
static bool print_out_password(const char *buffer, size_t length){
 
256
bool print_out_password(const char *buffer, size_t length){
326
257
  ssize_t ret;
327
258
  for(size_t written = 0; written < length; written += (size_t)ret){
328
259
    ret = TEMP_FAILURE_RETRY(write(STDOUT_FILENO, buffer + written,
335
266
}
336
267
 
337
268
/* Removes and free a plugin from the plugin list */
338
 
__attribute__((nonnull))
339
269
static void free_plugin(plugin *plugin_node){
340
270
  
341
 
  for(char **arg = (plugin_node->argv)+1; *arg != NULL; arg++){
 
271
  for(char **arg = plugin_node->argv; *arg != NULL; arg++){
342
272
    free(*arg);
343
273
  }
344
 
  free(plugin_node->name);
345
274
  free(plugin_node->argv);
346
275
  for(char **env = plugin_node->environ; *env != NULL; env++){
347
276
    free(*env);
348
277
  }
349
278
  free(plugin_node->environ);
350
279
  free(plugin_node->buffer);
351
 
  
 
280
 
352
281
  /* Removes the plugin from the singly-linked list */
353
282
  if(plugin_node == plugin_list){
354
283
    /* First one - simple */
374
303
 
375
304
int main(int argc, char *argv[]){
376
305
  char *plugindir = NULL;
377
 
  char *pluginhelperdir = NULL;
378
306
  char *argfile = NULL;
379
307
  FILE *conffp;
380
 
  struct dirent **direntries = NULL;
 
308
  size_t d_name_len;
 
309
  DIR *dir = NULL;
 
310
  struct dirent *dirst;
381
311
  struct stat st;
382
312
  fd_set rfds_all;
383
313
  int ret, maxfd = 0;
384
 
  ssize_t sret;
385
314
  uid_t uid = 65534;
386
315
  gid_t gid = 65534;
387
316
  bool debug = false;
391
320
                                      .sa_flags = SA_NOCLDSTOP };
392
321
  char **custom_argv = NULL;
393
322
  int custom_argc = 0;
394
 
  int dir_fd = -1;
395
323
  
396
324
  /* Establish a signal handler */
397
325
  sigemptyset(&sigchld_action.sa_mask);
398
326
  ret = sigaddset(&sigchld_action.sa_mask, SIGCHLD);
399
327
  if(ret == -1){
400
 
    error(0, errno, "sigaddset");
401
 
    exitstatus = EX_OSERR;
 
328
    perror("sigaddset");
 
329
    exitstatus = EXIT_FAILURE;
402
330
    goto fallback;
403
331
  }
404
332
  ret = sigaction(SIGCHLD, &sigchld_action, &old_sigchld_action);
405
333
  if(ret == -1){
406
 
    error(0, errno, "sigaction");
407
 
    exitstatus = EX_OSERR;
 
334
    perror("sigaction");
 
335
    exitstatus = EXIT_FAILURE;
408
336
    goto fallback;
409
337
  }
410
338
  
442
370
      .doc = "Group ID the plugins will run as", .group = 3 },
443
371
    { .name = "debug", .key = 132,
444
372
      .doc = "Debug mode", .group = 4 },
445
 
    { .name = "plugin-helper-dir", .key = 133,
446
 
      .arg = "DIRECTORY",
447
 
      .doc = "Specify a different plugin helper directory",
448
 
      .group = 2 },
449
 
    /*
450
 
     * These reproduce what we would get without ARGP_NO_HELP
451
 
     */
452
 
    { .name = "help", .key = '?',
453
 
      .doc = "Give this help list", .group = -1 },
454
 
    { .name = "usage", .key = -3,
455
 
      .doc = "Give a short usage message", .group = -1 },
456
 
    { .name = "version", .key = 'V',
457
 
      .doc = "Print program version", .group = -1 },
458
373
    { .name = NULL }
459
374
  };
460
375
  
461
 
  __attribute__((nonnull(3)))
462
 
  error_t parse_opt(int key, char *arg, struct argp_state *state){
463
 
    errno = 0;
464
 
    switch(key){
465
 
      char *tmp;
466
 
      intmax_t tmp_id;
 
376
  error_t parse_opt (int key, char *arg, __attribute__((unused))
 
377
                     struct argp_state *state) {
 
378
    switch (key) {
467
379
    case 'g':                   /* --global-options */
468
 
      {
469
 
        char *plugin_option;
470
 
        while((plugin_option = strsep(&arg, ",")) != NULL){
471
 
          if(not add_argument(getplugin(NULL), plugin_option)){
472
 
            break;
 
380
      if (arg != NULL){
 
381
        char *p;
 
382
        while((p = strsep(&arg, ",")) != NULL){
 
383
          if(p[0] == '\0'){
 
384
            continue;
 
385
          }
 
386
          if(not add_argument(getplugin(NULL), p)){
 
387
            perror("add_argument");
 
388
            return ARGP_ERR_UNKNOWN;
473
389
          }
474
390
        }
475
 
        errno = 0;
476
391
      }
477
392
      break;
478
393
    case 'G':                   /* --global-env */
479
 
      if(add_environment(getplugin(NULL), arg, true)){
480
 
        errno = 0;
 
394
      if(arg == NULL){
 
395
        break;
 
396
      }
 
397
      {
 
398
        char *envdef = strdup(arg);
 
399
        if(envdef == NULL){
 
400
          break;
 
401
        }
 
402
        if(not add_environment(getplugin(NULL), envdef, true)){
 
403
          perror("add_environment");
 
404
        }
481
405
      }
482
406
      break;
483
407
    case 'o':                   /* --options-for */
484
 
      {
485
 
        char *option_list = strchr(arg, ':');
486
 
        if(option_list == NULL){
487
 
          argp_error(state, "No colon in \"%s\"", arg);
488
 
          errno = EINVAL;
489
 
          break;
490
 
        }
491
 
        *option_list = '\0';
492
 
        option_list++;
493
 
        if(arg[0] == '\0'){
494
 
          argp_error(state, "Empty plugin name");
495
 
          errno = EINVAL;
496
 
          break;
497
 
        }
498
 
        char *option;
499
 
        while((option = strsep(&option_list, ",")) != NULL){
500
 
          if(not add_argument(getplugin(arg), option)){
501
 
            break;
502
 
          }
503
 
        }
504
 
        errno = 0;
 
408
      if (arg != NULL){
 
409
        char *p_name = strsep(&arg, ":");
 
410
        if(p_name[0] == '\0' or arg == NULL){
 
411
          break;
 
412
        }
 
413
        char *opt = strsep(&arg, ":");
 
414
        if(opt[0] == '\0' or opt == NULL){
 
415
          break;
 
416
        }
 
417
        char *p;
 
418
        while((p = strsep(&opt, ",")) != NULL){
 
419
          if(p[0] == '\0'){
 
420
            continue;
 
421
          }
 
422
          if(not add_argument(getplugin(p_name), p)){
 
423
            perror("add_argument");
 
424
            return ARGP_ERR_UNKNOWN;
 
425
          }
 
426
        }
505
427
      }
506
428
      break;
507
429
    case 'E':                   /* --env-for */
 
430
      if(arg == NULL){
 
431
        break;
 
432
      }
508
433
      {
509
434
        char *envdef = strchr(arg, ':');
510
435
        if(envdef == NULL){
511
 
          argp_error(state, "No colon in \"%s\"", arg);
512
 
          errno = EINVAL;
513
 
          break;
514
 
        }
515
 
        *envdef = '\0';
 
436
          break;
 
437
        }
 
438
        char *p_name = strndup(arg, (size_t) (envdef-arg));
 
439
        if(p_name == NULL){
 
440
          break;
 
441
        }
516
442
        envdef++;
517
 
        if(arg[0] == '\0'){
518
 
          argp_error(state, "Empty plugin name");
519
 
          errno = EINVAL;
520
 
          break;
521
 
        }
522
 
        if(add_environment(getplugin(arg), envdef, true)){
523
 
          errno = 0;
 
443
        if(not add_environment(getplugin(p_name), envdef, true)){
 
444
          perror("add_environment");
524
445
        }
525
446
      }
526
447
      break;
527
448
    case 'd':                   /* --disable */
528
 
      {
 
449
      if (arg != NULL){
529
450
        plugin *p = getplugin(arg);
530
 
        if(p != NULL){
531
 
          p->disabled = true;
532
 
          errno = 0;
 
451
        if(p == NULL){
 
452
          return ARGP_ERR_UNKNOWN;
533
453
        }
 
454
        p->disabled = true;
534
455
      }
535
456
      break;
536
457
    case 'e':                   /* --enable */
537
 
      {
 
458
      if (arg != NULL){
538
459
        plugin *p = getplugin(arg);
539
 
        if(p != NULL){
540
 
          p->disabled = false;
541
 
          errno = 0;
 
460
        if(p == NULL){
 
461
          return ARGP_ERR_UNKNOWN;
542
462
        }
 
463
        p->disabled = false;
543
464
      }
544
465
      break;
545
466
    case 128:                   /* --plugin-dir */
546
 
      free(plugindir);
547
467
      plugindir = strdup(arg);
548
 
      if(plugindir != NULL){
549
 
        errno = 0;
550
 
      }
 
468
      if(plugindir == NULL){
 
469
        perror("strdup");
 
470
      }      
551
471
      break;
552
472
    case 129:                   /* --config-file */
553
473
      /* This is already done by parse_opt_config_file() */
554
474
      break;
555
475
    case 130:                   /* --userid */
556
 
      tmp_id = strtoimax(arg, &tmp, 10);
557
 
      if(errno != 0 or tmp == arg or *tmp != '\0'
558
 
         or tmp_id != (uid_t)tmp_id){
559
 
        argp_error(state, "Bad user ID number: \"%s\", using %"
560
 
                   PRIdMAX, arg, (intmax_t)uid);
561
 
        break;
562
 
      }
563
 
      uid = (uid_t)tmp_id;
564
 
      errno = 0;
 
476
      uid = (uid_t)strtol(arg, NULL, 10);
565
477
      break;
566
478
    case 131:                   /* --groupid */
567
 
      tmp_id = strtoimax(arg, &tmp, 10);
568
 
      if(errno != 0 or tmp == arg or *tmp != '\0'
569
 
         or tmp_id != (gid_t)tmp_id){
570
 
        argp_error(state, "Bad group ID number: \"%s\", using %"
571
 
                   PRIdMAX, arg, (intmax_t)gid);
572
 
        break;
573
 
      }
574
 
      gid = (gid_t)tmp_id;
575
 
      errno = 0;
 
479
      gid = (gid_t)strtol(arg, NULL, 10);
576
480
      break;
577
481
    case 132:                   /* --debug */
578
482
      debug = true;
579
483
      break;
580
 
    case 133:                   /* --plugin-helper-dir */
581
 
      free(pluginhelperdir);
582
 
      pluginhelperdir = strdup(arg);
583
 
      if(pluginhelperdir != NULL){
584
 
        errno = 0;
585
 
      }
586
 
      break;
587
 
      /*
588
 
       * These reproduce what we would get without ARGP_NO_HELP
589
 
       */
590
 
    case '?':                   /* --help */
591
 
      state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
592
 
      argp_state_help(state, state->out_stream, ARGP_HELP_STD_HELP);
593
 
      __builtin_unreachable();
594
 
    case -3:                    /* --usage */
595
 
      state->flags &= ~(unsigned int)ARGP_NO_EXIT; /* force exit */
596
 
      argp_state_help(state, state->out_stream,
597
 
                      ARGP_HELP_USAGE | ARGP_HELP_EXIT_OK);
598
 
      __builtin_unreachable();
599
 
    case 'V':                   /* --version */
600
 
      fprintf(state->out_stream, "%s\n", argp_program_version);
601
 
      exit(EXIT_SUCCESS);
602
 
      break;
603
 
/*
604
 
 * When adding more options before this line, remember to also add a
605
 
 * "case" to the "parse_opt_config_file" function below.
606
 
 */
607
484
    case ARGP_KEY_ARG:
608
 
      /* Cryptsetup always passes an argument, which is an empty
609
 
         string if "none" was specified in /etc/crypttab.  So if
610
 
         argument was empty, we ignore it silently. */
611
 
      if(arg[0] == '\0'){
612
 
        break;
613
 
      }
614
 
#if __GNUC__ >= 7
615
 
      __attribute__((fallthrough));
616
 
#else
617
 
          /* FALLTHROUGH */
618
 
#endif
 
485
      fprintf(stderr, "Ignoring unknown argument \"%s\"\n", arg);
 
486
      break;
 
487
    case ARGP_KEY_END:
 
488
      break;
619
489
    default:
620
490
      return ARGP_ERR_UNKNOWN;
621
491
    }
622
 
    return errno;               /* Set to 0 at start */
 
492
    return 0;
623
493
  }
624
494
  
625
495
  /* This option parser is the same as parse_opt() above, except it
626
496
     ignores everything but the --config-file option. */
627
 
  error_t parse_opt_config_file(int key, char *arg,
628
 
                                __attribute__((unused))
629
 
                                struct argp_state *state){
630
 
    errno = 0;
631
 
    switch(key){
 
497
  error_t parse_opt_config_file (int key, char *arg,
 
498
                                 __attribute__((unused))
 
499
                                 struct argp_state *state) {
 
500
    switch (key) {
632
501
    case 'g':                   /* --global-options */
633
502
    case 'G':                   /* --global-env */
634
503
    case 'o':                   /* --options-for */
638
507
    case 128:                   /* --plugin-dir */
639
508
      break;
640
509
    case 129:                   /* --config-file */
641
 
      free(argfile);
642
510
      argfile = strdup(arg);
643
 
      if(argfile != NULL){
644
 
        errno = 0;
 
511
      if(argfile == NULL){
 
512
        perror("strdup");
645
513
      }
646
 
      break;
 
514
      break;      
647
515
    case 130:                   /* --userid */
648
516
    case 131:                   /* --groupid */
649
517
    case 132:                   /* --debug */
650
 
    case 133:                   /* --plugin-helper-dir */
651
 
    case '?':                   /* --help */
652
 
    case -3:                    /* --usage */
653
 
    case 'V':                   /* --version */
654
518
    case ARGP_KEY_ARG:
 
519
    case ARGP_KEY_END:
655
520
      break;
656
521
    default:
657
522
      return ARGP_ERR_UNKNOWN;
658
523
    }
659
 
    return errno;
 
524
    return 0;
660
525
  }
661
526
  
662
527
  struct argp argp = { .options = options,
664
529
                       .args_doc = "",
665
530
                       .doc = "Mandos plugin runner -- Run plugins" };
666
531
  
667
 
  /* Parse using parse_opt_config_file() in order to get the custom
 
532
  /* Parse using the parse_opt_config_file in order to get the custom
668
533
     config file location, if any. */
669
 
  ret = argp_parse(&argp, argc, argv,
670
 
                   ARGP_IN_ORDER | ARGP_NO_EXIT | ARGP_NO_HELP,
671
 
                   NULL, NULL);
672
 
  switch(ret){
673
 
  case 0:
674
 
    break;
675
 
  case ENOMEM:
676
 
  default:
677
 
    errno = ret;
678
 
    error(0, errno, "argp_parse");
679
 
    exitstatus = EX_OSERR;
680
 
    goto fallback;
681
 
  case EINVAL:
682
 
    exitstatus = EX_USAGE;
 
534
  ret = argp_parse (&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
 
535
  if (ret == ARGP_ERR_UNKNOWN){
 
536
    fprintf(stderr, "Unknown error while parsing arguments\n");
 
537
    exitstatus = EXIT_FAILURE;
683
538
    goto fallback;
684
539
  }
685
540
  
687
542
  argp.parser = parse_opt;
688
543
  
689
544
  /* Open the configfile if available */
690
 
  if(argfile == NULL){
 
545
  if (argfile == NULL){
691
546
    conffp = fopen(AFILE, "r");
692
547
  } else {
693
548
    conffp = fopen(argfile, "r");
694
 
  }
 
549
  }  
695
550
  if(conffp != NULL){
696
551
    char *org_line = NULL;
697
552
    char *p, *arg, *new_arg, *line;
698
553
    size_t size = 0;
 
554
    ssize_t sret;
699
555
    const char whitespace_delims[] = " \r\t\f\v\n";
700
556
    const char comment_delim[] = "#";
701
 
    
 
557
 
702
558
    custom_argc = 1;
703
559
    custom_argv = malloc(sizeof(char*) * 2);
704
560
    if(custom_argv == NULL){
705
 
      error(0, errno, "malloc");
706
 
      exitstatus = EX_OSERR;
 
561
      perror("malloc");
 
562
      exitstatus = EXIT_FAILURE;
707
563
      goto fallback;
708
564
    }
709
565
    custom_argv[0] = argv[0];
710
566
    custom_argv[1] = NULL;
711
 
    
 
567
 
712
568
    /* for each line in the config file, strip whitespace and ignore
713
569
       commented text */
714
570
    while(true){
716
572
      if(sret == -1){
717
573
        break;
718
574
      }
719
 
      
 
575
 
720
576
      line = org_line;
721
577
      arg = strsep(&line, comment_delim);
722
578
      while((p = strsep(&arg, whitespace_delims)) != NULL){
725
581
        }
726
582
        new_arg = strdup(p);
727
583
        if(new_arg == NULL){
728
 
          error(0, errno, "strdup");
729
 
          exitstatus = EX_OSERR;
 
584
          perror("strdup");
 
585
          exitstatus = EXIT_FAILURE;
730
586
          free(org_line);
731
587
          goto fallback;
732
588
        }
733
589
        
734
590
        custom_argc += 1;
735
 
        {
736
 
#if defined(__GLIBC_PREREQ) and __GLIBC_PREREQ(2, 26)
737
 
          char **new_argv = reallocarray(custom_argv, (size_t)custom_argc + 1,
738
 
                                         sizeof(char *));
739
 
#else
740
 
          char **new_argv = NULL;
741
 
          if(((size_t)custom_argc + 1) > (SIZE_MAX / sizeof(char *))){
742
 
            /* overflow */
743
 
            errno = ENOMEM;
744
 
          } else {
745
 
            new_argv = realloc(custom_argv, ((size_t)custom_argc + 1)
746
 
                               * sizeof(char *));
747
 
          }
748
 
#endif
749
 
          if(new_argv == NULL){
750
 
            error(0, errno, "reallocarray");
751
 
            exitstatus = EX_OSERR;
752
 
            free(new_arg);
753
 
            free(org_line);
754
 
            goto fallback;
755
 
          } else {
756
 
            custom_argv = new_argv;
757
 
          }
 
591
        custom_argv = realloc(custom_argv, sizeof(char *)
 
592
                              * ((unsigned int) custom_argc + 1));
 
593
        if(custom_argv == NULL){
 
594
          perror("realloc");
 
595
          exitstatus = EXIT_FAILURE;
 
596
          free(org_line);
 
597
          goto fallback;
758
598
        }
759
599
        custom_argv[custom_argc-1] = new_arg;
760
 
        custom_argv[custom_argc] = NULL;
 
600
        custom_argv[custom_argc] = NULL;        
761
601
      }
762
602
    }
763
 
    do {
764
 
      ret = fclose(conffp);
765
 
    } while(ret == EOF and errno == EINTR);
766
 
    if(ret == EOF){
767
 
      error(0, errno, "fclose");
768
 
      exitstatus = EX_IOERR;
769
 
      goto fallback;
770
 
    }
771
603
    free(org_line);
772
604
  } else {
773
605
    /* Check for harmful errors and go to fallback. Other errors might
774
606
       not affect opening plugins */
775
 
    if(errno == EMFILE or errno == ENFILE or errno == ENOMEM){
776
 
      error(0, errno, "fopen");
777
 
      exitstatus = EX_OSERR;
 
607
    if (errno == EMFILE or errno == ENFILE or errno == ENOMEM){
 
608
      perror("fopen");
 
609
      exitstatus = EXIT_FAILURE;
778
610
      goto fallback;
779
611
    }
780
612
  }
781
 
  /* If there were any arguments from the configuration file, pass
782
 
     them to parser as command line arguments */
 
613
  /* If there was any arguments from configuration file,
 
614
     pass them to parser as command arguments */
783
615
  if(custom_argv != NULL){
784
 
    ret = argp_parse(&argp, custom_argc, custom_argv,
785
 
                     ARGP_IN_ORDER | ARGP_NO_EXIT | ARGP_NO_HELP,
786
 
                     NULL, NULL);
787
 
    switch(ret){
788
 
    case 0:
789
 
      break;
790
 
    case ENOMEM:
791
 
    default:
792
 
      errno = ret;
793
 
      error(0, errno, "argp_parse");
794
 
      exitstatus = EX_OSERR;
795
 
      goto fallback;
796
 
    case EINVAL:
797
 
      exitstatus = EX_CONFIG;
 
616
    ret = argp_parse (&argp, custom_argc, custom_argv, ARGP_IN_ORDER,
 
617
                      0, NULL);
 
618
    if (ret == ARGP_ERR_UNKNOWN){
 
619
      fprintf(stderr, "Unknown error while parsing arguments\n");
 
620
      exitstatus = EXIT_FAILURE;
798
621
      goto fallback;
799
622
    }
800
623
  }
801
624
  
802
625
  /* Parse actual command line arguments, to let them override the
803
626
     config file */
804
 
  ret = argp_parse(&argp, argc, argv,
805
 
                   ARGP_IN_ORDER | ARGP_NO_EXIT | ARGP_NO_HELP,
806
 
                   NULL, NULL);
807
 
  switch(ret){
808
 
  case 0:
809
 
    break;
810
 
  case ENOMEM:
811
 
  default:
812
 
    errno = ret;
813
 
    error(0, errno, "argp_parse");
814
 
    exitstatus = EX_OSERR;
815
 
    goto fallback;
816
 
  case EINVAL:
817
 
    exitstatus = EX_USAGE;
818
 
    goto fallback;
819
 
  }
820
 
  
821
 
  {
822
 
    char *pluginhelperenv;
823
 
    bool bret = true;
824
 
    ret = asprintf(&pluginhelperenv, "MANDOSPLUGINHELPERDIR=%s",
825
 
                   pluginhelperdir != NULL ? pluginhelperdir : PHDIR);
826
 
    if(ret != -1){
827
 
      bret = add_environment(getplugin(NULL), pluginhelperenv, true);
828
 
    }
829
 
    if(ret == -1 or not bret){
830
 
      error(0, errno, "Failed to set MANDOSPLUGINHELPERDIR"
831
 
            " environment variable to \"%s\" for all plugins\n",
832
 
            pluginhelperdir != NULL ? pluginhelperdir : PHDIR);
833
 
    }
834
 
    if(ret != -1){
835
 
      free(pluginhelperenv);
836
 
    }
 
627
  ret = argp_parse (&argp, argc, argv, ARGP_IN_ORDER, 0, NULL);
 
628
  if (ret == ARGP_ERR_UNKNOWN){
 
629
    fprintf(stderr, "Unknown error while parsing arguments\n");
 
630
    exitstatus = EXIT_FAILURE;
 
631
    goto fallback;
837
632
  }
838
633
  
839
634
  if(debug){
840
 
    for(plugin *p = plugin_list; p != NULL; p = p->next){
 
635
    for(plugin *p = plugin_list; p != NULL; p=p->next){
841
636
      fprintf(stderr, "Plugin: %s has %d arguments\n",
842
637
              p->name ? p->name : "Global", p->argc - 1);
843
638
      for(char **a = p->argv; *a != NULL; a++){
844
639
        fprintf(stderr, "\tArg: %s\n", *a);
845
640
      }
846
 
      fprintf(stderr, "...and %d environment variables\n", p->envc);
 
641
      fprintf(stderr, "...and %u environment variables\n", p->envc);
847
642
      for(char **a = p->environ; *a != NULL; a++){
848
643
        fprintf(stderr, "\t%s\n", *a);
849
644
      }
850
645
    }
851
646
  }
852
647
  
853
 
  if(getuid() == 0){
854
 
    /* Work around Debian bug #633582:
855
 
       <https://bugs.debian.org/633582> */
856
 
    int plugindir_fd = open(/* plugindir or */ PDIR, O_RDONLY);
857
 
    if(plugindir_fd == -1){
858
 
      if(errno != ENOENT){
859
 
        error(0, errno, "open(\"" PDIR "\")");
860
 
      }
861
 
    } else {
862
 
      ret = (int)TEMP_FAILURE_RETRY(fstat(plugindir_fd, &st));
863
 
      if(ret == -1){
864
 
        error(0, errno, "fstat");
865
 
      } else {
866
 
        if(S_ISDIR(st.st_mode) and st.st_uid == 0 and st.st_gid == 0){
867
 
          ret = fchown(plugindir_fd, uid, gid);
868
 
          if(ret == -1){
869
 
            error(0, errno, "fchown");
870
 
          }
871
 
        }
872
 
      }
873
 
      close(plugindir_fd);
874
 
    }
875
 
 
876
 
    /* Work around Debian bug #981302
877
 
       <https://bugs.debian.org/981302> */
878
 
    if(lstat("/dev/fd", &st) != 0 and errno == ENOENT){
879
 
      ret = symlink("/proc/self/fd", "/dev/fd");
880
 
      if(ret == -1){
881
 
        error(0, errno, "Failed to create /dev/fd symlink");
882
 
      }
883
 
    }
884
 
  }
885
 
  
886
 
  /* Lower permissions */
887
 
  ret = setgid(gid);
888
 
  if(ret == -1){
889
 
    error(0, errno, "setgid");
890
 
  }
 
648
  /* Strip permissions down to nobody */
891
649
  ret = setuid(uid);
892
 
  if(ret == -1){
893
 
    error(0, errno, "setuid");
894
 
  }
895
 
  
896
 
  /* Open plugin directory with close_on_exec flag */
 
650
  if (ret == -1){
 
651
    perror("setuid");
 
652
  }  
 
653
  setgid(gid);
 
654
  if (ret == -1){
 
655
    perror("setgid");
 
656
  }
 
657
  
 
658
  if (plugindir == NULL){
 
659
    dir = opendir(PDIR);
 
660
  } else {
 
661
    dir = opendir(plugindir);
 
662
  }
 
663
  
 
664
  if(dir == NULL){
 
665
    perror("Could not open plugin dir");
 
666
    exitstatus = EXIT_FAILURE;
 
667
    goto fallback;
 
668
  }
 
669
  
 
670
  /* Set the FD_CLOEXEC flag on the directory, if possible */
897
671
  {
898
 
    dir_fd = open(plugindir != NULL ? plugindir : PDIR, O_RDONLY |
899
 
#ifdef O_CLOEXEC
900
 
                  O_CLOEXEC
901
 
#else  /* not O_CLOEXEC */
902
 
                  0
903
 
#endif  /* not O_CLOEXEC */
904
 
                  );
905
 
    if(dir_fd == -1){
906
 
      error(0, errno, "Could not open plugin dir");
907
 
      exitstatus = EX_UNAVAILABLE;
908
 
      goto fallback;
909
 
    }
910
 
    
911
 
#ifndef O_CLOEXEC
912
 
  /* Set the FD_CLOEXEC flag on the directory */
913
 
    ret = set_cloexec_flag(dir_fd);
914
 
    if(ret < 0){
915
 
      error(0, errno, "set_cloexec_flag");
916
 
      exitstatus = EX_OSERR;
917
 
      goto fallback;
918
 
    }
919
 
#endif  /* O_CLOEXEC */
920
 
  }
921
 
  
922
 
  int good_name(const struct dirent * const dirent){
923
 
    const char * const patterns[] = { ".*", "#*#", "*~", "*.dpkg-new",
924
 
                                      "*.dpkg-old", "*.dpkg-bak",
925
 
                                      "*.dpkg-divert", NULL };
926
 
#ifdef __GNUC__
927
 
#pragma GCC diagnostic push
928
 
#pragma GCC diagnostic ignored "-Wcast-qual"
929
 
#endif
930
 
    for(const char **pat = (const char **)patterns;
931
 
        *pat != NULL; pat++){
932
 
#ifdef __GNUC__
933
 
#pragma GCC diagnostic pop
934
 
#endif
935
 
      if(fnmatch(*pat, dirent->d_name, FNM_FILE_NAME | FNM_PERIOD)
936
 
         != FNM_NOMATCH){
937
 
        if(debug){
938
 
            fprintf(stderr, "Ignoring plugin dir entry \"%s\""
939
 
                    " matching pattern %s\n", dirent->d_name, *pat);
940
 
        }
941
 
        return 0;
 
672
    int dir_fd = dirfd(dir);
 
673
    if(dir_fd >= 0){
 
674
      ret = set_cloexec_flag(dir_fd);
 
675
      if(ret < 0){
 
676
        perror("set_cloexec_flag");
 
677
        exitstatus = EXIT_FAILURE;
 
678
        goto fallback;
942
679
      }
943
680
    }
944
 
    return 1;
945
 
  }
946
 
  
947
 
  int numplugins = scandirat(dir_fd, ".", &direntries, good_name,
948
 
                             alphasort);
949
 
  if(numplugins == -1){
950
 
    error(0, errno, "Could not scan plugin dir");
951
 
    direntries = NULL;
952
 
    exitstatus = EX_OSERR;
953
 
    goto fallback;
954
681
  }
955
682
  
956
683
  FD_ZERO(&rfds_all);
957
684
  
958
685
  /* Read and execute any executable in the plugin directory*/
959
 
  for(int i = 0; i < numplugins; i++){
960
 
    
961
 
    int plugin_fd = openat(dir_fd, direntries[i]->d_name, O_RDONLY);
962
 
    if(plugin_fd == -1){
963
 
      error(0, errno, "Could not open plugin");
964
 
      free(direntries[i]);
965
 
      continue;
966
 
    }
967
 
    ret = (int)TEMP_FAILURE_RETRY(fstat(plugin_fd, &st));
968
 
    if(ret == -1){
969
 
      error(0, errno, "stat");
970
 
      close(plugin_fd);
971
 
      free(direntries[i]);
972
 
      continue;
973
 
    }
974
 
    
 
686
  while(true){
 
687
    dirst = readdir(dir);
 
688
    
 
689
    /* All directory entries have been processed */
 
690
    if(dirst == NULL){
 
691
      if (errno == EBADF){
 
692
        perror("readdir");
 
693
        exitstatus = EXIT_FAILURE;
 
694
        goto fallback;
 
695
      }
 
696
      break;
 
697
    }
 
698
    
 
699
    d_name_len = strlen(dirst->d_name);
 
700
    
 
701
    /* Ignore dotfiles, backup files and other junk */
 
702
    {
 
703
      bool bad_name = false;
 
704
      
 
705
      const char const *bad_prefixes[] = { ".", "#", NULL };
 
706
      
 
707
      const char const *bad_suffixes[] = { "~", "#", ".dpkg-new",
 
708
                                           ".dpkg-old",
 
709
                                           ".dpkg-divert", NULL };
 
710
      for(const char **pre = bad_prefixes; *pre != NULL; pre++){
 
711
        size_t pre_len = strlen(*pre);
 
712
        if((d_name_len >= pre_len)
 
713
           and strncmp((dirst->d_name), *pre, pre_len) == 0){
 
714
          if(debug){
 
715
            fprintf(stderr, "Ignoring plugin dir entry \"%s\""
 
716
                    " with bad prefix %s\n", dirst->d_name, *pre);
 
717
          }
 
718
          bad_name = true;
 
719
          break;
 
720
        }
 
721
      }
 
722
      if(bad_name){
 
723
        continue;
 
724
      }
 
725
      for(const char **suf = bad_suffixes; *suf != NULL; suf++){
 
726
        size_t suf_len = strlen(*suf);
 
727
        if((d_name_len >= suf_len)
 
728
           and (strcmp((dirst->d_name)+d_name_len-suf_len, *suf)
 
729
                == 0)){
 
730
          if(debug){
 
731
            fprintf(stderr, "Ignoring plugin dir entry \"%s\""
 
732
                    " with bad suffix %s\n", dirst->d_name, *suf);
 
733
          }
 
734
          bad_name = true;
 
735
          break;
 
736
        }
 
737
      }
 
738
      
 
739
      if(bad_name){
 
740
        continue;
 
741
      }
 
742
    }
 
743
 
 
744
    char *filename;
 
745
    if(plugindir == NULL){
 
746
      ret = asprintf(&filename, PDIR "/%s", dirst->d_name);
 
747
    } else {
 
748
      ret = asprintf(&filename, "%s/%s", plugindir, dirst->d_name);
 
749
    }
 
750
    if(ret < 0){
 
751
      perror("asprintf");
 
752
      continue;
 
753
    }
 
754
    
 
755
    ret = stat(filename, &st);
 
756
    if (ret == -1){
 
757
      perror("stat");
 
758
      free(filename);
 
759
      continue;
 
760
    }
 
761
 
975
762
    /* Ignore non-executable files */
976
 
    if(not S_ISREG(st.st_mode)
977
 
       or (TEMP_FAILURE_RETRY(faccessat(dir_fd, direntries[i]->d_name,
978
 
                                        X_OK, 0)) != 0)){
 
763
    if (not S_ISREG(st.st_mode) or (access(filename, X_OK) != 0)){
979
764
      if(debug){
980
 
        fprintf(stderr, "Ignoring plugin dir entry \"%s/%s\""
981
 
                " with bad type or mode\n",
982
 
                plugindir != NULL ? plugindir : PDIR,
983
 
                direntries[i]->d_name);
 
765
        fprintf(stderr, "Ignoring plugin dir entry \"%s\""
 
766
                " with bad type or mode\n", filename);
984
767
      }
985
 
      close(plugin_fd);
986
 
      free(direntries[i]);
 
768
      free(filename);
987
769
      continue;
988
770
    }
989
771
    
990
 
    plugin *p = getplugin(direntries[i]->d_name);
 
772
    plugin *p = getplugin(dirst->d_name);
991
773
    if(p == NULL){
992
 
      error(0, errno, "getplugin");
993
 
      close(plugin_fd);
994
 
      free(direntries[i]);
 
774
      perror("getplugin");
 
775
      free(filename);
995
776
      continue;
996
777
    }
997
778
    if(p->disabled){
998
779
      if(debug){
999
780
        fprintf(stderr, "Ignoring disabled plugin \"%s\"\n",
1000
 
                direntries[i]->d_name);
 
781
                dirst->d_name);
1001
782
      }
1002
 
      close(plugin_fd);
1003
 
      free(direntries[i]);
 
783
      free(filename);
1004
784
      continue;
1005
785
    }
1006
786
    {
1009
789
      if(g != NULL){
1010
790
        for(char **a = g->argv + 1; *a != NULL; a++){
1011
791
          if(not add_argument(p, *a)){
1012
 
            error(0, errno, "add_argument");
 
792
            perror("add_argument");
1013
793
          }
1014
794
        }
1015
795
        /* Add global environment variables */
1016
796
        for(char **e = g->environ; *e != NULL; e++){
1017
797
          if(not add_environment(p, *e, false)){
1018
 
            error(0, errno, "add_environment");
 
798
            perror("add_environment");
1019
799
          }
1020
800
        }
1021
801
      }
1022
802
    }
1023
 
    /* If this plugin has any environment variables, we need to
1024
 
       duplicate the environment from this process, too. */
 
803
    /* If this plugin has any environment variables, we will call
 
804
       using execve and need to duplicate the environment from this
 
805
       process, too. */
1025
806
    if(p->environ[0] != NULL){
1026
807
      for(char **e = environ; *e != NULL; e++){
1027
808
        if(not add_environment(p, *e, false)){
1028
 
          error(0, errno, "add_environment");
 
809
          perror("add_environment");
1029
810
        }
1030
811
      }
1031
812
    }
1032
813
    
1033
814
    int pipefd[2];
1034
 
#ifndef O_CLOEXEC
1035
 
    ret = (int)TEMP_FAILURE_RETRY(pipe(pipefd));
1036
 
#else  /* O_CLOEXEC */
1037
 
    ret = (int)TEMP_FAILURE_RETRY(pipe2(pipefd, O_CLOEXEC));
1038
 
#endif  /* O_CLOEXEC */
1039
 
    if(ret == -1){
1040
 
      error(0, errno, "pipe");
1041
 
      exitstatus = EX_OSERR;
1042
 
      free(direntries[i]);
1043
 
      goto fallback;
1044
 
    }
1045
 
    if(pipefd[0] >= FD_SETSIZE){
1046
 
      fprintf(stderr, "pipe()[0] (%d) >= FD_SETSIZE (%d)", pipefd[0],
1047
 
              FD_SETSIZE);
1048
 
      close(pipefd[0]);
1049
 
      close(pipefd[1]);
1050
 
      exitstatus = EX_OSERR;
1051
 
      free(direntries[i]);
1052
 
      goto fallback;
1053
 
    }
1054
 
#ifndef O_CLOEXEC
 
815
    ret = pipe(pipefd);
 
816
    if (ret == -1){
 
817
      perror("pipe");
 
818
      exitstatus = EXIT_FAILURE;
 
819
      goto fallback;
 
820
    }
1055
821
    /* Ask OS to automatic close the pipe on exec */
1056
822
    ret = set_cloexec_flag(pipefd[0]);
1057
823
    if(ret < 0){
1058
 
      error(0, errno, "set_cloexec_flag");
1059
 
      close(pipefd[0]);
1060
 
      close(pipefd[1]);
1061
 
      exitstatus = EX_OSERR;
1062
 
      free(direntries[i]);
 
824
      perror("set_cloexec_flag");
 
825
      exitstatus = EXIT_FAILURE;
1063
826
      goto fallback;
1064
827
    }
1065
828
    ret = set_cloexec_flag(pipefd[1]);
1066
829
    if(ret < 0){
1067
 
      error(0, errno, "set_cloexec_flag");
1068
 
      close(pipefd[0]);
1069
 
      close(pipefd[1]);
1070
 
      exitstatus = EX_OSERR;
1071
 
      free(direntries[i]);
 
830
      perror("set_cloexec_flag");
 
831
      exitstatus = EXIT_FAILURE;
1072
832
      goto fallback;
1073
833
    }
1074
 
#endif  /* not O_CLOEXEC */
1075
834
    /* Block SIGCHLD until process is safely in process list */
1076
 
    ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_BLOCK,
1077
 
                                              &sigchld_action.sa_mask,
1078
 
                                              NULL));
 
835
    ret = sigprocmask (SIG_BLOCK, &sigchld_action.sa_mask, NULL);
1079
836
    if(ret < 0){
1080
 
      error(0, errno, "sigprocmask");
1081
 
      exitstatus = EX_OSERR;
1082
 
      free(direntries[i]);
 
837
      perror("sigprocmask");
 
838
      exitstatus = EXIT_FAILURE;
1083
839
      goto fallback;
1084
840
    }
1085
841
    /* Starting a new process to be watched */
1086
 
    pid_t pid;
1087
 
    do {
1088
 
      pid = fork();
1089
 
    } while(pid == -1 and errno == EINTR);
 
842
    pid_t pid = fork();
1090
843
    if(pid == -1){
1091
 
      error(0, errno, "fork");
1092
 
      TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1093
 
                                     &sigchld_action.sa_mask, NULL));
1094
 
      close(pipefd[0]);
1095
 
      close(pipefd[1]);
1096
 
      exitstatus = EX_OSERR;
1097
 
      free(direntries[i]);
 
844
      perror("fork");
 
845
      exitstatus = EXIT_FAILURE;
1098
846
      goto fallback;
1099
847
    }
1100
848
    if(pid == 0){
1101
849
      /* this is the child process */
1102
850
      ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1103
851
      if(ret < 0){
1104
 
        error(0, errno, "sigaction");
1105
 
        _exit(EX_OSERR);
 
852
        perror("sigaction");
 
853
        _exit(EXIT_FAILURE);
1106
854
      }
1107
 
      ret = sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
 
855
      ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1108
856
      if(ret < 0){
1109
 
        error(0, errno, "sigprocmask");
1110
 
        _exit(EX_OSERR);
 
857
        perror("sigprocmask");
 
858
        _exit(EXIT_FAILURE);
1111
859
      }
1112
 
      
 
860
 
1113
861
      ret = dup2(pipefd[1], STDOUT_FILENO); /* replace our stdout */
1114
862
      if(ret == -1){
1115
 
        error(0, errno, "dup2");
1116
 
        _exit(EX_OSERR);
 
863
        perror("dup2");
 
864
        _exit(EXIT_FAILURE);
1117
865
      }
1118
866
      
1119
 
      if(fexecve(plugin_fd, p->argv,
1120
 
                (p->environ[0] != NULL) ? p->environ : environ) < 0){
1121
 
        error(0, errno, "fexecve for %s/%s",
1122
 
              plugindir != NULL ? plugindir : PDIR,
1123
 
              direntries[i]->d_name);
1124
 
        _exit(EX_OSERR);
 
867
      if(dirfd(dir) < 0){
 
868
        /* If dir has no file descriptor, we could not set FD_CLOEXEC
 
869
           above and must now close it manually here. */
 
870
        closedir(dir);
 
871
      }
 
872
      if(p->environ[0] == NULL){
 
873
        if(execv(filename, p->argv) < 0){
 
874
          perror("execv");
 
875
          _exit(EXIT_FAILURE);
 
876
        }
 
877
      } else {
 
878
        if(execve(filename, p->argv, p->environ) < 0){
 
879
          perror("execve");
 
880
          _exit(EXIT_FAILURE);
 
881
        }
1125
882
      }
1126
883
      /* no return */
1127
884
    }
1128
885
    /* Parent process */
1129
886
    close(pipefd[1]);           /* Close unused write end of pipe */
1130
 
    close(plugin_fd);
1131
 
    plugin *new_plugin = getplugin(direntries[i]->d_name);
1132
 
    if(new_plugin == NULL){
1133
 
      error(0, errno, "getplugin");
1134
 
      ret = (int)(TEMP_FAILURE_RETRY
1135
 
                  (sigprocmask(SIG_UNBLOCK, &sigchld_action.sa_mask,
1136
 
                               NULL)));
 
887
    free(filename);
 
888
    plugin *new_plugin = getplugin(dirst->d_name);
 
889
    if (new_plugin == NULL){
 
890
      perror("getplugin");
 
891
      ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1137
892
      if(ret < 0){
1138
 
        error(0, errno, "sigprocmask");
 
893
        perror("sigprocmask");
1139
894
      }
1140
 
      exitstatus = EX_OSERR;
1141
 
      free(direntries[i]);
 
895
      exitstatus = EXIT_FAILURE;
1142
896
      goto fallback;
1143
897
    }
1144
 
    free(direntries[i]);
1145
898
    
1146
899
    new_plugin->pid = pid;
1147
900
    new_plugin->fd = pipefd[0];
1148
 
 
1149
 
    if(debug){
1150
 
      fprintf(stderr, "Plugin %s started (PID %" PRIdMAX ")\n",
1151
 
              new_plugin->name, (intmax_t) (new_plugin->pid));
1152
 
    }
1153
 
 
 
901
    
1154
902
    /* Unblock SIGCHLD so signal handler can be run if this process
1155
903
       has already completed */
1156
 
    ret = (int)TEMP_FAILURE_RETRY(sigprocmask(SIG_UNBLOCK,
1157
 
                                              &sigchld_action.sa_mask,
1158
 
                                              NULL));
 
904
    ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask, NULL);
1159
905
    if(ret < 0){
1160
 
      error(0, errno, "sigprocmask");
1161
 
      exitstatus = EX_OSERR;
 
906
      perror("sigprocmask");
 
907
      exitstatus = EXIT_FAILURE;
1162
908
      goto fallback;
1163
909
    }
1164
910
    
1165
911
    FD_SET(new_plugin->fd, &rfds_all);
1166
912
    
1167
 
    if(maxfd < new_plugin->fd){
 
913
    if (maxfd < new_plugin->fd){
1168
914
      maxfd = new_plugin->fd;
1169
915
    }
 
916
    
1170
917
  }
1171
918
  
1172
 
  free(direntries);
1173
 
  direntries = NULL;
1174
 
  close(dir_fd);
1175
 
  dir_fd = -1;
1176
 
  free_plugin(getplugin(NULL));
1177
 
  
 
919
  closedir(dir);
 
920
  dir = NULL;
 
921
 
1178
922
  for(plugin *p = plugin_list; p != NULL; p = p->next){
1179
923
    if(p->pid != 0){
1180
924
      break;
1185
929
      free_plugin_list();
1186
930
    }
1187
931
  }
1188
 
  
 
932
 
1189
933
  /* Main loop while running plugins exist */
1190
934
  while(plugin_list){
1191
935
    fd_set rfds = rfds_all;
1192
936
    int select_ret = select(maxfd+1, &rfds, NULL, NULL, NULL);
1193
 
    if(select_ret == -1 and errno != EINTR){
1194
 
      error(0, errno, "select");
1195
 
      exitstatus = EX_OSERR;
 
937
    if (select_ret == -1){
 
938
      perror("select");
 
939
      exitstatus = EXIT_FAILURE;
1196
940
      goto fallback;
1197
941
    }
1198
942
    /* OK, now either a process completed, or something can be read
1199
943
       from one of them */
1200
 
    for(plugin *proc = plugin_list; proc != NULL;){
 
944
    for(plugin *proc = plugin_list; proc != NULL; proc = proc->next){
1201
945
      /* Is this process completely done? */
1202
 
      if(proc->completed and proc->eof){
 
946
      if(proc->eof and proc->completed){
1203
947
        /* Only accept the plugin output if it exited cleanly */
1204
948
        if(not WIFEXITED(proc->status)
1205
949
           or WEXITSTATUS(proc->status) != 0){
1206
950
          /* Bad exit by plugin */
1207
 
          
 
951
 
1208
952
          if(debug){
1209
953
            if(WIFEXITED(proc->status)){
1210
 
              fprintf(stderr, "Plugin %s [%" PRIdMAX "] exited with"
1211
 
                      " status %d\n", proc->name,
1212
 
                      (intmax_t) (proc->pid),
 
954
              fprintf(stderr, "Plugin %u exited with status %d\n",
 
955
                      (unsigned int) (proc->pid),
1213
956
                      WEXITSTATUS(proc->status));
1214
 
            } else if(WIFSIGNALED(proc->status)){
1215
 
              fprintf(stderr, "Plugin %s [%" PRIdMAX "] killed by"
1216
 
                      " signal %d: %s\n", proc->name,
1217
 
                      (intmax_t) (proc->pid),
1218
 
                      WTERMSIG(proc->status),
1219
 
                      strsignal(WTERMSIG(proc->status)));
 
957
            } else if(WIFSIGNALED(proc->status)) {
 
958
              fprintf(stderr, "Plugin %u killed by signal %d\n",
 
959
                      (unsigned int) (proc->pid),
 
960
                      WTERMSIG(proc->status));
 
961
            } else if(WCOREDUMP(proc->status)){
 
962
              fprintf(stderr, "Plugin %d dumped core\n",
 
963
                      (unsigned int) (proc->pid));
1220
964
            }
1221
965
          }
1222
966
          
1223
967
          /* Remove the plugin */
1224
968
          FD_CLR(proc->fd, &rfds_all);
1225
 
          
 
969
 
1226
970
          /* Block signal while modifying process_list */
1227
 
          ret = (int)TEMP_FAILURE_RETRY(sigprocmask
1228
 
                                        (SIG_BLOCK,
1229
 
                                         &sigchld_action.sa_mask,
1230
 
                                         NULL));
 
971
          ret = sigprocmask(SIG_BLOCK, &sigchld_action.sa_mask, NULL);
1231
972
          if(ret < 0){
1232
 
            error(0, errno, "sigprocmask");
1233
 
            exitstatus = EX_OSERR;
 
973
            perror("sigprocmask");
 
974
            exitstatus = EXIT_FAILURE;
1234
975
            goto fallback;
1235
976
          }
1236
 
          
1237
 
          plugin *next_plugin = proc->next;
1238
977
          free_plugin(proc);
1239
 
          proc = next_plugin;
1240
 
          
1241
978
          /* We are done modifying process list, so unblock signal */
1242
 
          ret = (int)(TEMP_FAILURE_RETRY
1243
 
                      (sigprocmask(SIG_UNBLOCK,
1244
 
                                   &sigchld_action.sa_mask, NULL)));
 
979
          ret = sigprocmask (SIG_UNBLOCK, &sigchld_action.sa_mask,
 
980
                             NULL);
1245
981
          if(ret < 0){
1246
 
            error(0, errno, "sigprocmask");
1247
 
            exitstatus = EX_OSERR;
 
982
            perror("sigprocmask");
 
983
            exitstatus = EXIT_FAILURE;
1248
984
            goto fallback;
1249
985
          }
1250
986
          
1251
987
          if(plugin_list == NULL){
1252
988
            break;
1253
989
          }
1254
 
          
1255
990
          continue;
1256
991
        }
1257
992
        
1258
993
        /* This process exited nicely, so print its buffer */
1259
 
        
 
994
 
1260
995
        bool bret = print_out_password(proc->buffer,
1261
996
                                       proc->buffer_length);
1262
997
        if(not bret){
1263
 
          error(0, errno, "print_out_password");
1264
 
          exitstatus = EX_IOERR;
 
998
          perror("print_out_password");
 
999
          exitstatus = EXIT_FAILURE;
1265
1000
        }
1266
1001
        goto fallback;
1267
1002
      }
1269
1004
      /* This process has not completed.  Does it have any output? */
1270
1005
      if(proc->eof or not FD_ISSET(proc->fd, &rfds)){
1271
1006
        /* This process had nothing to say at this time */
1272
 
        proc = proc->next;
1273
1007
        continue;
1274
1008
      }
1275
1009
      /* Before reading, make the process' data buffer large enough */
1276
1010
      if(proc->buffer_length + BUFFER_SIZE > proc->buffer_size){
1277
 
        char *new_buffer = realloc(proc->buffer, proc->buffer_size
1278
 
                                   + (size_t) BUFFER_SIZE);
1279
 
        if(new_buffer == NULL){
1280
 
          error(0, errno, "malloc");
1281
 
          exitstatus = EX_OSERR;
 
1011
        proc->buffer = realloc(proc->buffer, proc->buffer_size
 
1012
                               + (size_t) BUFFER_SIZE);
 
1013
        if (proc->buffer == NULL){
 
1014
          perror("malloc");
 
1015
          exitstatus = EXIT_FAILURE;
1282
1016
          goto fallback;
1283
1017
        }
1284
 
        proc->buffer = new_buffer;
1285
1018
        proc->buffer_size += BUFFER_SIZE;
1286
1019
      }
1287
1020
      /* Read from the process */
1288
 
      sret = TEMP_FAILURE_RETRY(read(proc->fd,
1289
 
                                     proc->buffer
1290
 
                                     + proc->buffer_length,
1291
 
                                     BUFFER_SIZE));
1292
 
      if(sret < 0){
 
1021
      ret = read(proc->fd, proc->buffer + proc->buffer_length,
 
1022
                 BUFFER_SIZE);
 
1023
      if(ret < 0){
1293
1024
        /* Read error from this process; ignore the error */
1294
 
        proc = proc->next;
1295
1025
        continue;
1296
1026
      }
1297
 
      if(sret == 0){
 
1027
      if(ret == 0){
1298
1028
        /* got EOF */
1299
1029
        proc->eof = true;
1300
1030
      } else {
1301
 
        proc->buffer_length += (size_t) sret;
 
1031
        proc->buffer_length += (size_t) ret;
1302
1032
      }
1303
1033
    }
1304
1034
  }
1305
 
  
1306
 
  
 
1035
 
 
1036
 
1307
1037
 fallback:
1308
1038
  
1309
 
  if(plugin_list == NULL or (exitstatus != EXIT_SUCCESS
1310
 
                             and exitstatus != EX_OK)){
 
1039
  if(plugin_list == NULL or exitstatus != EXIT_SUCCESS){
1311
1040
    /* Fallback if all plugins failed, none are found or an error
1312
1041
       occured */
1313
1042
    bool bret;
1321
1050
    }
1322
1051
    bret = print_out_password(passwordbuffer, len);
1323
1052
    if(not bret){
1324
 
      error(0, errno, "print_out_password");
1325
 
      exitstatus = EX_IOERR;
 
1053
      perror("print_out_password");
 
1054
      exitstatus = EXIT_FAILURE;
1326
1055
    }
1327
1056
  }
1328
1057
  
1329
1058
  /* Restore old signal handler */
1330
1059
  ret = sigaction(SIGCHLD, &old_sigchld_action, NULL);
1331
1060
  if(ret == -1){
1332
 
    error(0, errno, "sigaction");
1333
 
    exitstatus = EX_OSERR;
 
1061
    perror("sigaction");
 
1062
    exitstatus = EXIT_FAILURE;
1334
1063
  }
1335
 
  
 
1064
 
1336
1065
  if(custom_argv != NULL){
1337
1066
    for(char **arg = custom_argv+1; *arg != NULL; arg++){
1338
1067
      free(*arg);
1340
1069
    free(custom_argv);
1341
1070
  }
1342
1071
  
1343
 
  free(direntries);
1344
 
  
1345
 
  if(dir_fd != -1){
1346
 
    close(dir_fd);
 
1072
  if(dir != NULL){
 
1073
    closedir(dir);
1347
1074
  }
1348
1075
  
1349
 
  /* Kill the processes */
 
1076
  /* Free the process list and kill the processes */
1350
1077
  for(plugin *p = plugin_list; p != NULL; p = p->next){
1351
1078
    if(p->pid != 0){
1352
1079
      close(p->fd);
1353
1080
      ret = kill(p->pid, SIGTERM);
1354
1081
      if(ret == -1 and errno != ESRCH){
1355
1082
        /* Set-uid proccesses might not get closed */
1356
 
        error(0, errno, "kill");
 
1083
        perror("kill");
1357
1084
      }
1358
1085
    }
1359
1086
  }
1360
1087
  
1361
1088
  /* Wait for any remaining child processes to terminate */
1362
 
  do {
 
1089
  do{
1363
1090
    ret = wait(NULL);
1364
1091
  } while(ret >= 0);
1365
1092
  if(errno != ECHILD){
1366
 
    error(0, errno, "wait");
 
1093
    perror("wait");
1367
1094
  }
1368
 
  
 
1095
 
1369
1096
  free_plugin_list();
1370
1097
  
1371
1098
  free(plugindir);
1372
 
  free(pluginhelperdir);
1373
1099
  free(argfile);
1374
1100
  
1375
1101
  return exitstatus;