/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
 
3
 * Password-prompt - Read a password from the terminal and print it
4
4
 * 
5
5
 * Copyright © 2008,2009 Teddy Hogeborn
6
6
 * Copyright © 2008,2009 Björn Påhlsson
19
19
 * along with this program.  If not, see
20
20
 * <http://www.gnu.org/licenses/>.
21
21
 * 
22
 
 * Contact the authors at <https://www.fukt.bsnet.se/~belorn/> and
23
 
 * <https://www.fukt.bsnet.se/~teddy/>.
 
22
 * Contact the authors at <mandos@fukt.bsnet.se>.
24
23
 */
25
24
 
26
25
#define _GNU_SOURCE             /* getline() */
33
32
#include <signal.h>             /* sig_atomic_t, raise(), struct
34
33
                                   sigaction, sigemptyset(),
35
34
                                   sigaction(), sigaddset(), SIGINT,
36
 
                                   SIGQUIT, SIGHUP, SIGTERM */
 
35
                                   SIGQUIT, SIGHUP, SIGTERM,
 
36
                                   raise() */
37
37
#include <stddef.h>             /* NULL, size_t, ssize_t */
38
38
#include <sys/types.h>          /* ssize_t */
39
39
#include <stdlib.h>             /* EXIT_SUCCESS, EXIT_FAILURE,
40
 
                                   getopt_long, getenv() */
 
40
                                   getenv() */
41
41
#include <stdio.h>              /* fprintf(), stderr, getline(),
42
 
                                   stdin, feof(), perror(), fputc(),
43
 
                                   stdout, getopt_long */
44
 
#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
                                */
45
47
#include <iso646.h>             /* or, not */
46
48
#include <stdbool.h>            /* bool, false, true */
47
49
#include <string.h>             /* strlen, rindex, strncmp, strcmp */
50
52
                                   argp_parse(), error_t,
51
53
                                   ARGP_KEY_ARG, ARGP_KEY_END,
52
54
                                   ARGP_ERR_UNKNOWN */
 
55
#include <sysexits.h>           /* EX_SOFTWARE, EX_OSERR,
 
56
                                   EX_UNAVAILABLE, EX_IOERR, EX_OK */
53
57
 
54
 
volatile bool quit_now = false;
 
58
volatile sig_atomic_t quit_now = 0;
 
59
int signal_received;
55
60
bool debug = false;
56
61
const char *argp_program_version = "password-prompt " VERSION;
57
62
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
58
63
 
59
 
static void termination_handler(__attribute__((unused))int signum){
60
 
  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;
61
70
}
62
71
 
63
72
int main(int argc, char **argv){
77
86
        .doc = "Prefix shown before the prompt", .group = 2 },
78
87
      { .name = "debug", .key = 128,
79
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 },
80
98
      { .name = NULL }
81
99
    };
82
 
  
83
 
    error_t parse_opt (int key, char *arg, struct argp_state *state) {
84
 
      /* Get the INPUT argument from `argp_parse', which we know is a
85
 
         pointer to our plugin list pointer. */
86
 
      switch (key) {
 
100
    
 
101
    error_t parse_opt (int key, char *arg, struct argp_state *state){
 
102
      errno = 0;
 
103
      switch (key){
87
104
      case 'p':
88
105
        prefix = arg;
89
106
        break;
90
107
      case 128:
91
108
        debug = true;
92
109
        break;
93
 
      case ARGP_KEY_ARG:
94
 
        argp_usage (state);
95
 
        break;
96
 
      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);
97
123
        break;
98
124
      default:
99
125
        return ARGP_ERR_UNKNOWN;
100
126
      }
101
 
      return 0;
 
127
      return errno;
102
128
    }
103
 
  
 
129
    
104
130
    struct argp argp = { .options = options, .parser = parse_opt,
105
131
                         .args_doc = "",
106
132
                         .doc = "Mandos password-prompt -- Read and"
107
133
                         " output a password" };
108
 
    ret = argp_parse (&argp, argc, argv, 0, 0, NULL);
109
 
    if (ret == ARGP_ERR_UNKNOWN){
110
 
      fprintf(stderr, "Unknown error while parsing arguments\n");
111
 
      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;
112
146
    }
113
147
  }
114
 
    
115
 
  if (debug){
 
148
  
 
149
  if(debug){
116
150
    fprintf(stderr, "Starting %s\n", argv[0]);
117
151
  }
118
 
  if (debug){
 
152
  if(debug){
119
153
    fprintf(stderr, "Storing current terminal attributes\n");
120
154
  }
121
155
  
122
 
  if (tcgetattr(STDIN_FILENO, &t_old) != 0){
 
156
  if(tcgetattr(STDIN_FILENO, &t_old) != 0){
 
157
    int e = errno;
123
158
    perror("tcgetattr");
124
 
    return EXIT_FAILURE;
 
159
    switch(e){
 
160
    case EBADF:
 
161
    case ENOTTY:
 
162
      return EX_UNAVAILABLE;
 
163
    default:
 
164
      return EX_OSERR;
 
165
    }
125
166
  }
126
167
  
127
168
  sigemptyset(&new_action.sa_mask);
128
 
  sigaddset(&new_action.sa_mask, SIGINT);
129
 
  sigaddset(&new_action.sa_mask, SIGHUP);
130
 
  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
  */
131
188
  ret = sigaction(SIGINT, NULL, &old_action);
132
189
  if(ret == -1){
133
190
    perror("sigaction");
134
 
    return EXIT_FAILURE;
 
191
    return EX_OSERR;
135
192
  }
136
 
  if (old_action.sa_handler != SIG_IGN){
 
193
  if(old_action.sa_handler != SIG_IGN){
137
194
    ret = sigaction(SIGINT, &new_action, NULL);
138
195
    if(ret == -1){
139
196
      perror("sigaction");
140
 
      return EXIT_FAILURE;
 
197
      return EX_OSERR;
141
198
    }
142
199
  }
143
200
  ret = sigaction(SIGHUP, NULL, &old_action);
144
201
  if(ret == -1){
145
202
    perror("sigaction");
146
 
    return EXIT_FAILURE;
 
203
    return EX_OSERR;
147
204
  }
148
 
  if (old_action.sa_handler != SIG_IGN){
 
205
  if(old_action.sa_handler != SIG_IGN){
149
206
    ret = sigaction(SIGHUP, &new_action, NULL);
150
207
    if(ret == -1){
151
208
      perror("sigaction");
152
 
      return EXIT_FAILURE;
 
209
      return EX_OSERR;
153
210
    }
154
211
  }
155
212
  ret = sigaction(SIGTERM, NULL, &old_action);
156
213
  if(ret == -1){
157
214
    perror("sigaction");
158
 
    return EXIT_FAILURE;
 
215
    return EX_OSERR;
159
216
  }
160
 
  if (old_action.sa_handler != SIG_IGN){
 
217
  if(old_action.sa_handler != SIG_IGN){
161
218
    ret = sigaction(SIGTERM, &new_action, NULL);
162
219
    if(ret == -1){
163
220
      perror("sigaction");
164
 
      return EXIT_FAILURE;
 
221
      return EX_OSERR;
165
222
    }
166
223
  }
167
224
  
168
225
  
169
 
  if (debug){
 
226
  if(debug){
170
227
    fprintf(stderr, "Removing echo flag from terminal attributes\n");
171
228
  }
172
229
  
173
230
  t_new = t_old;
174
 
  t_new.c_lflag &= ~ECHO;
175
 
  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;
176
234
    perror("tcsetattr-echo");
177
 
    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
    }
178
243
  }
179
 
 
180
 
  if (debug){
 
244
  
 
245
  if(debug){
181
246
    fprintf(stderr, "Waiting for input from stdin \n");
182
247
  }
183
248
  while(true){
184
 
    if (quit_now){
 
249
    if(quit_now){
185
250
      if(debug){
186
251
        fprintf(stderr, "Interrupted by signal, exiting.\n");
187
252
      }
213
278
      }
214
279
    }
215
280
    ret = getline(&buffer, &n, stdin);
216
 
    if (ret > 0){
 
281
    if(ret > 0){
217
282
      status = EXIT_SUCCESS;
218
283
      /* Make n = data size instead of allocated buffer size */
219
284
      n = (size_t)ret;
220
285
      /* Strip final newline */
221
 
      if(n>0 and buffer[n-1] == '\n'){
 
286
      if(n > 0 and buffer[n-1] == '\n'){
222
287
        buffer[n-1] = '\0';     /* not strictly necessary */
223
288
        n--;
224
289
      }
226
291
      while(written < n){
227
292
        ret = write(STDOUT_FILENO, buffer + written, n - written);
228
293
        if(ret < 0){
 
294
          int e = errno;
229
295
          perror("write");
230
 
          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
          }
231
310
          break;
232
311
        }
233
312
        written += (size_t)ret;
234
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
      }
235
328
      break;
236
329
    }
237
 
    if (ret < 0){
238
 
      if (errno != EINTR and not feof(stdin)){
 
330
    if(ret < 0){
 
331
      int e = errno;
 
332
      if(errno != EINTR and not feof(stdin)){
239
333
        perror("getline");
240
 
        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
        }
241
343
        break;
242
344
      }
243
345
    }
245
347
       read from stdin */
246
348
    fputc('\n', stderr);
247
349
    if(debug and not quit_now){
248
 
      /* 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
249
351
         will print that later, so no need to show this too. */
250
352
      fprintf(stderr, "getline() returned 0, retrying.\n");
251
353
    }
252
354
  }
253
 
 
 
355
  
254
356
  free(buffer);
255
357
  
256
 
  if (debug){
 
358
  if(debug){
257
359
    fprintf(stderr, "Restoring terminal attributes\n");
258
360
  }
259
 
  if (tcsetattr(STDIN_FILENO, TCSAFLUSH, &t_old) != 0){
 
361
  if(tcsetattr(STDIN_FILENO, TCSAFLUSH, &t_old) != 0){
260
362
    perror("tcsetattr+echo");
261
363
  }
262
364
  
263
 
  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){
264
376
    fprintf(stderr, "%s is exiting with status %d\n", argv[0],
265
377
            status);
266
378
  }
267
 
  if(status == EXIT_SUCCESS){
 
379
  if(status == EXIT_SUCCESS or status == EX_OK){
268
380
    fputc('\n', stderr);
269
381
  }
270
382