/mandos/trunk

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

« back to all changes in this revision

Viewing changes to plugins.d/password-prompt.c

  • Committer: Teddy Hogeborn
  • Date: 2009-10-24 19:17:52 UTC
  • Revision ID: teddy@fukt.bsnet.se-20091024191752-7g6xlf6wpp2pdexb
Convert some programs to use the exit codes from <sysexits.h>.  Change
all programs using the "argp" parsing functions to use them correctly;
checking return value, using argp_error() to report parse errors etc.

* plugin-runner.c: Use <sysexits.h> exit codes.  Always use fallback,
                   even on option errors, except for "--help", etc.
  (getplugin): Make sure "errno" is set correctly on return.
  (main): Declare our own "--help", "--usage", and "--version"
          options which do not cause the fallback to be invoked.
          In all other options, use fallback on any error.
  (parse_opt, parse_opt_config_file): Reset errno at start and return
                                      errno.  No need to check "arg"
                                      for NULL.  New "--help",
                                      "--usage", and "--version"
                                      options.
  (parse_opt): Accept empty string as global option.  Do not print
               errors which will be detected and reported later.  Do
               "argp_error()" on parse error or empty plugin names.
* plugins.d/mandos-client.c: Use <sysexits.h> exit codes.  Do not
                             return successful exit code on "--help",
                             etc. since this would give the wrong
                             message to "plugin-runner".
  (main): Declare our own "--help", "--usage", and "--version"
          options which do not return a successful exit code.
  (parse_opt): Reset errno at start and return errno.  Do
               "argp_error()" on parse errors.  New "--help",
               "--usage", and "--version" options.
* plugins.d/password-prompt.c: Use exit codes from <sysexits.h>.  Do
                               not return successful exit code on
                               "--help", etc. since this would give
                               the wrong message to "plugin-runner".
  (main): Declare our own "--help", "--usage", and "--version" options
          which do not return a successful exit code.  Do
          close(STDOUT_FILENO) after writing to check its return code.
  (parse_opt): Reset errno at start and return errno.

Show diffs side-by-side

added added

removed removed

Lines of Context:
plugins.d/password-prompt.c
1
 
/*  -*- coding: utf-8 -*- */
 
1
/*  -*- coding: utf-8; mode: c; mode: orgtbl -*- */
2
2
/*
3
 
 * Passprompt - Read a password from the terminal and print it
4
 
 *
5
 
 * Copyright © 2008 Teddy Hogeborn & Björn Påhlsson
 
3
 * Password-prompt - Read a password from the terminal and print it
 
4
 * 
 
5
 * Copyright © 2008,2009 Teddy Hogeborn
 
6
 * Copyright © 2008,2009 Björn Påhlsson
6
7
 * 
7
8
 * This program is free software: you can redistribute it and/or
8
9
 * modify it under the terms of the GNU General Public License as
18
19
 * along with this program.  If not, see
19
20
 * <http://www.gnu.org/licenses/>.
20
21
 * 
21
 
 * Contact the authors at <https://www.fukt.bsnet.se/~belorn/> and
22
 
 * <https://www.fukt.bsnet.se/~teddy/>.
 
22
 * Contact the authors at <mandos@fukt.bsnet.se>.
23
23
 */
24
24
 
25
25
#define _GNU_SOURCE             /* getline() */
32
32
#include <signal.h>             /* sig_atomic_t, raise(), struct
33
33
                                   sigaction, sigemptyset(),
34
34
                                   sigaction(), sigaddset(), SIGINT,
35
 
                                   SIGQUIT, SIGHUP, SIGTERM */
 
35
                                   SIGQUIT, SIGHUP, SIGTERM,
 
36
                                   raise() */
36
37
#include <stddef.h>             /* NULL, size_t, ssize_t */
37
38
#include <sys/types.h>          /* ssize_t */
38
39
#include <stdlib.h>             /* EXIT_SUCCESS, EXIT_FAILURE,
39
 
                                   getopt_long, getenv() */
 
40
                                   getenv() */
40
41
#include <stdio.h>              /* fprintf(), stderr, getline(),
41
 
                                   stdin, feof(), perror(), fputc(),
42
 
                                   stdout, getopt_long */
43
 
#include <errno.h>              /* errno, EINVAL */
 
42
                                   stdin, feof(), perror(), fputc()
 
43
                                */
 
44
#include <errno.h>              /* errno, EBADF, ENOTTY, EINVAL,
 
45
                                   EFAULT, EFBIG, EIO, ENOSPC, EINTR
 
46
                                */
44
47
#include <iso646.h>             /* or, not */
45
48
#include <stdbool.h>            /* bool, false, true */
46
49
#include <string.h>             /* strlen, rindex, strncmp, strcmp */
49
52
                                   argp_parse(), error_t,
50
53
                                   ARGP_KEY_ARG, ARGP_KEY_END,
51
54
                                   ARGP_ERR_UNKNOWN */
 
55
#include <sysexits.h>           /* EX_SOFTWARE, EX_OSERR,
 
56
                                   EX_UNAVAILABLE, EX_IOERR, EX_OK */
52
57
 
53
 
volatile bool quit_now = false;
 
58
volatile sig_atomic_t quit_now = 0;
 
59
int signal_received;
54
60
bool debug = false;
55
 
const char *argp_program_version = "password-prompt 1.0";
 
61
const char *argp_program_version = "password-prompt " VERSION;
56
62
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
57
63
 
58
 
static void termination_handler(__attribute__((unused))int signum){
59
 
  quit_now = true;
 
64
static void termination_handler(int signum){
 
65
  if(quit_now){
 
66
    return;
 
67
  }
 
68
  quit_now = 1;
 
69
  signal_received = signum;
60
70
}
61
71
 
62
72
int main(int argc, char **argv){
76
86
        .doc = "Prefix shown before the prompt", .group = 2 },
77
87
      { .name = "debug", .key = 128,
78
88
        .doc = "Debug mode", .group = 3 },
 
89
      /*
 
90
       * These reproduce what we would get without ARGP_NO_HELP
 
91
       */
 
92
      { .name = "help", .key = '?',
 
93
        .doc = "Give this help list", .group = -1 },
 
94
      { .name = "usage", .key = -3,
 
95
        .doc = "Give a short usage message", .group = -1 },
 
96
      { .name = "version", .key = 'V',
 
97
        .doc = "Print program version", .group = -1 },
79
98
      { .name = NULL }
80
99
    };
81
 
  
82
 
    error_t parse_opt (int key, char *arg, struct argp_state *state) {
83
 
      /* Get the INPUT argument from `argp_parse', which we know is a
84
 
         pointer to our plugin list pointer. */
85
 
      switch (key) {
 
100
    
 
101
    error_t parse_opt (int key, char *arg, struct argp_state *state){
 
102
      errno = 0;
 
103
      switch (key){
86
104
      case 'p':
87
105
        prefix = arg;
88
106
        break;
89
107
      case 128:
90
108
        debug = true;
91
109
        break;
92
 
      case ARGP_KEY_ARG:
93
 
        argp_usage (state);
94
 
        break;
95
 
      case ARGP_KEY_END:
 
110
        /*
 
111
         * These reproduce what we would get without ARGP_NO_HELP
 
112
         */
 
113
      case '?':                 /* --help */
 
114
        argp_state_help(state, state->out_stream,
 
115
                        (ARGP_HELP_STD_HELP | ARGP_HELP_EXIT_ERR)
 
116
                        & ~(unsigned int)ARGP_HELP_EXIT_OK);
 
117
      case -3:                  /* --usage */
 
118
        argp_state_help(state, state->out_stream,
 
119
                        ARGP_HELP_USAGE | ARGP_HELP_EXIT_ERR);
 
120
      case 'V':                 /* --version */
 
121
        fprintf(state->out_stream, "%s\n", argp_program_version);
 
122
        exit(argp_err_exit_status);
96
123
        break;
97
124
      default:
98
125
        return ARGP_ERR_UNKNOWN;
99
126
      }
100
 
      return 0;
 
127
      return errno;
101
128
    }
102
 
  
 
129
    
103
130
    struct argp argp = { .options = options, .parser = parse_opt,
104
131
                         .args_doc = "",
105
132
                         .doc = "Mandos password-prompt -- Read and"
106
133
                         " output a password" };
107
 
    ret = argp_parse (&argp, argc, argv, 0, 0, NULL);
108
 
    if (ret == ARGP_ERR_UNKNOWN){
109
 
      fprintf(stderr, "Unknown error while parsing arguments\n");
110
 
      return EXIT_FAILURE;
 
134
    ret = argp_parse(&argp, argc, argv,
 
135
                     ARGP_IN_ORDER | ARGP_NO_HELP, NULL, NULL);
 
136
    switch(ret){
 
137
    case 0:
 
138
      break;
 
139
    case ENOMEM:
 
140
    default:
 
141
      errno = ret;
 
142
      perror("argp_parse");
 
143
      return EX_OSERR;
 
144
    case EINVAL:
 
145
      return EX_USAGE;
111
146
    }
112
147
  }
113
 
    
114
 
  if (debug){
 
148
  
 
149
  if(debug){
115
150
    fprintf(stderr, "Starting %s\n", argv[0]);
116
151
  }
117
 
  if (debug){
 
152
  if(debug){
118
153
    fprintf(stderr, "Storing current terminal attributes\n");
119
154
  }
120
155
  
121
 
  if (tcgetattr(STDIN_FILENO, &t_old) != 0){
 
156
  if(tcgetattr(STDIN_FILENO, &t_old) != 0){
 
157
    int e = errno;
122
158
    perror("tcgetattr");
123
 
    return EXIT_FAILURE;
 
159
    switch(e){
 
160
    case EBADF:
 
161
    case ENOTTY:
 
162
      return EX_UNAVAILABLE;
 
163
    default:
 
164
      return EX_OSERR;
 
165
    }
124
166
  }
125
167
  
126
168
  sigemptyset(&new_action.sa_mask);
127
 
  sigaddset(&new_action.sa_mask, SIGINT);
128
 
  sigaddset(&new_action.sa_mask, SIGHUP);
129
 
  sigaddset(&new_action.sa_mask, SIGTERM);
 
169
  ret = sigaddset(&new_action.sa_mask, SIGINT);
 
170
  if(ret == -1){
 
171
    perror("sigaddset");
 
172
    return EX_OSERR;
 
173
  }
 
174
  ret = sigaddset(&new_action.sa_mask, SIGHUP);
 
175
  if(ret == -1){
 
176
    perror("sigaddset");
 
177
    return EX_OSERR;
 
178
  }
 
179
  ret = sigaddset(&new_action.sa_mask, SIGTERM);
 
180
  if(ret == -1){
 
181
    perror("sigaddset");
 
182
    return EX_OSERR;
 
183
  }
 
184
  /* Need to check if the handler is SIG_IGN before handling:
 
185
     | [[info:libc:Initial Signal Actions]] |
 
186
     | [[info:libc:Basic Signal Handling]]  |
 
187
  */
130
188
  ret = sigaction(SIGINT, NULL, &old_action);
131
189
  if(ret == -1){
132
190
    perror("sigaction");
133
 
    return EXIT_FAILURE;
 
191
    return EX_OSERR;
134
192
  }
135
 
  if (old_action.sa_handler != SIG_IGN){
 
193
  if(old_action.sa_handler != SIG_IGN){
136
194
    ret = sigaction(SIGINT, &new_action, NULL);
137
195
    if(ret == -1){
138
196
      perror("sigaction");
139
 
      return EXIT_FAILURE;
 
197
      return EX_OSERR;
140
198
    }
141
199
  }
142
200
  ret = sigaction(SIGHUP, NULL, &old_action);
143
201
  if(ret == -1){
144
202
    perror("sigaction");
145
 
    return EXIT_FAILURE;
 
203
    return EX_OSERR;
146
204
  }
147
 
  if (old_action.sa_handler != SIG_IGN){
 
205
  if(old_action.sa_handler != SIG_IGN){
148
206
    ret = sigaction(SIGHUP, &new_action, NULL);
149
207
    if(ret == -1){
150
208
      perror("sigaction");
151
 
      return EXIT_FAILURE;
 
209
      return EX_OSERR;
152
210
    }
153
211
  }
154
212
  ret = sigaction(SIGTERM, NULL, &old_action);
155
213
  if(ret == -1){
156
214
    perror("sigaction");
157
 
    return EXIT_FAILURE;
 
215
    return EX_OSERR;
158
216
  }
159
 
  if (old_action.sa_handler != SIG_IGN){
 
217
  if(old_action.sa_handler != SIG_IGN){
160
218
    ret = sigaction(SIGTERM, &new_action, NULL);
161
219
    if(ret == -1){
162
220
      perror("sigaction");
163
 
      return EXIT_FAILURE;
 
221
      return EX_OSERR;
164
222
    }
165
223
  }
166
224
  
167
225
  
168
 
  if (debug){
 
226
  if(debug){
169
227
    fprintf(stderr, "Removing echo flag from terminal attributes\n");
170
228
  }
171
229
  
172
230
  t_new = t_old;
173
 
  t_new.c_lflag &= ~ECHO;
174
 
  if (tcsetattr(STDIN_FILENO, TCSAFLUSH, &t_new) != 0){
 
231
  t_new.c_lflag &= ~(tcflag_t)ECHO;
 
232
  if(tcsetattr(STDIN_FILENO, TCSAFLUSH, &t_new) != 0){
 
233
    int e = errno;
175
234
    perror("tcsetattr-echo");
176
 
    return EXIT_FAILURE;
 
235
    switch(e){
 
236
    case EBADF:
 
237
    case ENOTTY:
 
238
      return EX_UNAVAILABLE;
 
239
    case EINVAL:
 
240
    default:
 
241
      return EX_OSERR;
 
242
    }
177
243
  }
178
 
 
179
 
  if (debug){
 
244
  
 
245
  if(debug){
180
246
    fprintf(stderr, "Waiting for input from stdin \n");
181
247
  }
182
248
  while(true){
183
 
    if (quit_now){
 
249
    if(quit_now){
184
250
      if(debug){
185
251
        fprintf(stderr, "Interrupted by signal, exiting.\n");
186
252
      }
212
278
      }
213
279
    }
214
280
    ret = getline(&buffer, &n, stdin);
215
 
    if (ret > 0){
 
281
    if(ret > 0){
216
282
      status = EXIT_SUCCESS;
217
283
      /* Make n = data size instead of allocated buffer size */
218
284
      n = (size_t)ret;
219
285
      /* Strip final newline */
220
 
      if(n>0 and buffer[n-1] == '\n'){
 
286
      if(n > 0 and buffer[n-1] == '\n'){
221
287
        buffer[n-1] = '\0';     /* not strictly necessary */
222
288
        n--;
223
289
      }
225
291
      while(written < n){
226
292
        ret = write(STDOUT_FILENO, buffer + written, n - written);
227
293
        if(ret < 0){
 
294
          int e = errno;
228
295
          perror("write");
229
 
          status = EXIT_FAILURE;
 
296
          switch(e){
 
297
          case EBADF:
 
298
          case EFAULT:
 
299
          case EINVAL:
 
300
          case EFBIG:
 
301
          case EIO:
 
302
          case ENOSPC:
 
303
          default:
 
304
            status = EX_IOERR;
 
305
            break;
 
306
          case EINTR:
 
307
            status = EXIT_FAILURE;
 
308
            break;
 
309
          }
230
310
          break;
231
311
        }
232
312
        written += (size_t)ret;
233
313
      }
 
314
      ret = close(STDOUT_FILENO);
 
315
      if(ret == -1){
 
316
        int e = errno;
 
317
        perror("close");
 
318
        switch(e){
 
319
        case EBADF:
 
320
          status = EX_OSFILE;
 
321
          break;
 
322
        case EIO:
 
323
        default:
 
324
          status = EX_IOERR;
 
325
          break;
 
326
        }
 
327
      }
234
328
      break;
235
329
    }
236
 
    if (ret < 0){
237
 
      if (errno != EINTR and not feof(stdin)){
 
330
    if(ret < 0){
 
331
      int e = errno;
 
332
      if(errno != EINTR and not feof(stdin)){
238
333
        perror("getline");
239
 
        status = EXIT_FAILURE;
 
334
        switch(e){
 
335
        case EBADF:
 
336
          status = EX_UNAVAILABLE;
 
337
        case EIO:
 
338
        case EINVAL:
 
339
        default:
 
340
          status = EX_IOERR;
 
341
          break;
 
342
        }
240
343
        break;
241
344
      }
242
345
    }
244
347
       read from stdin */
245
348
    fputc('\n', stderr);
246
349
    if(debug and not quit_now){
247
 
      /* If quit_now is true, we were interrupted by a signal, and
 
350
      /* If quit_now is nonzero, we were interrupted by a signal, and
248
351
         will print that later, so no need to show this too. */
249
352
      fprintf(stderr, "getline() returned 0, retrying.\n");
250
353
    }
251
354
  }
252
 
 
 
355
  
253
356
  free(buffer);
254
357
  
255
 
  if (debug){
 
358
  if(debug){
256
359
    fprintf(stderr, "Restoring terminal attributes\n");
257
360
  }
258
 
  if (tcsetattr(STDIN_FILENO, TCSAFLUSH, &t_old) != 0){
 
361
  if(tcsetattr(STDIN_FILENO, TCSAFLUSH, &t_old) != 0){
259
362
    perror("tcsetattr+echo");
260
363
  }
261
364
  
262
 
  if (debug){
 
365
  if(quit_now){
 
366
    sigemptyset(&old_action.sa_mask);
 
367
    old_action.sa_handler = SIG_DFL;
 
368
    ret = sigaction(signal_received, &old_action, NULL);
 
369
    if(ret == -1){
 
370
      perror("sigaction");
 
371
    }
 
372
    raise(signal_received);
 
373
  }
 
374
  
 
375
  if(debug){
263
376
    fprintf(stderr, "%s is exiting with status %d\n", argv[0],
264
377
            status);
265
378
  }
266
 
  if(status == EXIT_SUCCESS){
 
379
  if(status == EXIT_SUCCESS or status == EX_OK){
267
380
    fputc('\n', stderr);
268
381
  }
269
382