/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: 2019-07-29 16:35:53 UTC
  • Revision ID: teddy@recompile.se-20190729163553-1i442i2cbx64c537
Make tests and man page examples match

Make the tests test_manual_page_example[1-5] match exactly what is
written in the manual page, and add comments to manual page as
reminders to keep tests and manual page examples in sync.

* mandos-ctl (Test_commands_from_options.test_manual_page_example_1):
  Remove "--verbose" option, since the manual does not have it as the
  first example, and change assertion to match.
* mandos-ctl.xml (EXAMPLE): Add comments to all examples documenting
  which test function they correspond to.  Also remove unnecessary
  quotes from option arguments in fourth example, and clarify language
  slightly in fifth example.

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
/*
3
3
 * Password-prompt - Read a password from the terminal and print it
4
4
 * 
5
 
 * Copyright © 2008-2010 Teddy Hogeborn
6
 
 * Copyright © 2008-2010 Björn Påhlsson
7
 
 * 
8
 
 * This program is free software: you can redistribute it and/or
9
 
 * modify it under the terms of the GNU General Public License as
10
 
 * published by the Free Software Foundation, either version 3 of the
11
 
 * License, or (at your option) any later version.
12
 
 * 
13
 
 * This program is distributed in the hope that it will be useful, but
 
5
 * Copyright © 2008-2019 Teddy Hogeborn
 
6
 * Copyright © 2008-2019 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
14
16
 * WITHOUT ANY WARRANTY; without even the implied warranty of
15
17
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16
18
 * General Public License for more details.
17
19
 * 
18
20
 * You should have received a copy of the GNU General Public License
19
 
 * along with this program.  If not, see
20
 
 * <http://www.gnu.org/licenses/>.
 
21
 * along with Mandos.  If not, see <http://www.gnu.org/licenses/>.
21
22
 * 
22
 
 * Contact the authors at <mandos@fukt.bsnet.se>.
 
23
 * Contact the authors at <mandos@recompile.se>.
23
24
 */
24
25
 
25
26
#define _GNU_SOURCE             /* getline(), asprintf() */
26
27
 
27
28
#include <termios.h>            /* struct termios, tcsetattr(),
28
29
                                   TCSAFLUSH, tcgetattr(), ECHO */
29
 
#include <unistd.h>             /* struct termios, tcsetattr(),
30
 
                                   STDIN_FILENO, TCSAFLUSH,
31
 
                                   tcgetattr(), ECHO, readlink() */
 
30
#include <unistd.h>             /* access(), struct termios,
 
31
                                   tcsetattr(), STDIN_FILENO,
 
32
                                   TCSAFLUSH, tcgetattr(), ECHO,
 
33
                                   readlink() */
32
34
#include <signal.h>             /* sig_atomic_t, raise(), struct
33
35
                                   sigaction, sigemptyset(),
34
36
                                   sigaction(), sigaddset(), SIGINT,
41
43
                                   getenv(), free() */
42
44
#include <dirent.h>             /* scandir(), alphasort() */
43
45
#include <stdio.h>              /* fprintf(), stderr, getline(),
44
 
                                   stdin, feof(), fputc()
45
 
                                */
 
46
                                   stdin, feof(), fputc(), vfprintf(),
 
47
                                   vasprintf() */
46
48
#include <errno.h>              /* errno, EBADF, ENOTTY, EINVAL,
47
49
                                   EFAULT, EFBIG, EIO, ENOSPC, EINTR
48
50
                                */
51
53
#include <stdbool.h>            /* bool, false, true */
52
54
#include <inttypes.h>           /* strtoumax() */
53
55
#include <sys/stat.h>           /* struct stat, lstat(), open() */
54
 
#include <string.h>             /* strlen, rindex, memcmp */
 
56
#include <string.h>             /* strlen, rindex, memcmp, strerror()
 
57
                                 */
55
58
#include <argp.h>               /* struct argp_option, struct
56
59
                                   argp_state, struct argp,
57
60
                                   argp_parse(), error_t,
60
63
#include <sysexits.h>           /* EX_SOFTWARE, EX_OSERR,
61
64
                                   EX_UNAVAILABLE, EX_IOERR, EX_OK */
62
65
#include <fcntl.h>              /* open() */
 
66
#include <stdarg.h>             /* va_list, va_start(), ... */
63
67
 
64
68
volatile sig_atomic_t quit_now = 0;
65
69
int signal_received;
66
70
bool debug = false;
67
71
const char *argp_program_version = "password-prompt " VERSION;
68
 
const char *argp_program_bug_address = "<mandos@fukt.bsnet.se>";
 
72
const char *argp_program_bug_address = "<mandos@recompile.se>";
69
73
 
70
74
/* Needed for conflict resolution */
71
75
const char plymouth_name[] = "plymouthd";
72
76
 
 
77
/* Function to use when printing errors */
 
78
__attribute__((format (gnu_printf, 3, 4)))
 
79
void error_plus(int status, int errnum, const char *formatstring,
 
80
                ...){
 
81
  va_list ap;
 
82
  char *text;
 
83
  int ret;
 
84
  
 
85
  va_start(ap, formatstring);
 
86
  ret = vasprintf(&text, formatstring, ap);
 
87
  if(ret == -1){
 
88
    fprintf(stderr, "Mandos plugin %s: ",
 
89
            program_invocation_short_name);
 
90
    vfprintf(stderr, formatstring, ap);
 
91
    fprintf(stderr, ": %s\n", strerror(errnum));
 
92
    error(status, errno, "vasprintf while printing error");
 
93
    return;
 
94
  }
 
95
  fprintf(stderr, "Mandos plugin ");
 
96
  error(status, errnum, "%s", text);
 
97
  free(text);
 
98
}
 
99
 
73
100
static void termination_handler(int signum){
74
101
  if(quit_now){
75
102
    return;
84
111
     from the terminal.  Password-prompt will exit if it detects
85
112
     plymouth since plymouth performs the same functionality.
86
113
   */
 
114
  if(access("/run/plymouth/pid", R_OK) == 0){
 
115
    return true;
 
116
  }
 
117
  
 
118
  __attribute__((nonnull))
87
119
  int is_plymouth(const struct dirent *proc_entry){
88
120
    int ret;
89
121
    int cl_fd;
90
122
    {
91
 
      uintmax_t maxvalue;
 
123
      uintmax_t proc_id;
92
124
      char *tmp;
93
125
      errno = 0;
94
 
      maxvalue = strtoumax(proc_entry->d_name, &tmp, 10);
 
126
      proc_id = strtoumax(proc_entry->d_name, &tmp, 10);
95
127
      
96
128
      if(errno != 0 or *tmp != '\0'
97
 
         or maxvalue != (uintmax_t)((pid_t)maxvalue)){
 
129
         or proc_id != (uintmax_t)((pid_t)proc_id)){
98
130
        return 0;
99
131
      }
100
132
    }
103
135
    ret = asprintf(&cmdline_filename, "/proc/%s/cmdline",
104
136
                   proc_entry->d_name);
105
137
    if(ret == -1){
106
 
      error(0, errno, "asprintf");
 
138
      error_plus(0, errno, "asprintf");
107
139
      return 0;
108
140
    }
109
141
    
112
144
    free(cmdline_filename);
113
145
    if(cl_fd == -1){
114
146
      if(errno != ENOENT){
115
 
        error(0, errno, "open");
 
147
        error_plus(0, errno, "open");
116
148
      }
117
149
      return 0;
118
150
    }
129
161
        if(cmdline_len + blocksize + 1 > cmdline_allocated){
130
162
          tmp = realloc(cmdline, cmdline_allocated + blocksize + 1);
131
163
          if(tmp == NULL){
132
 
            error(0, errno, "realloc");
 
164
            error_plus(0, errno, "realloc");
133
165
            free(cmdline);
134
166
            close(cl_fd);
135
167
            return 0;
142
174
        sret = read(cl_fd, cmdline + cmdline_len,
143
175
                    cmdline_allocated - cmdline_len);
144
176
        if(sret == -1){
145
 
          error(0, errno, "read");
 
177
          error_plus(0, errno, "read");
146
178
          free(cmdline);
147
179
          close(cl_fd);
148
180
          return 0;
151
183
      } while(sret != 0);
152
184
      ret = close(cl_fd);
153
185
      if(ret == -1){
154
 
        error(0, errno, "close");
 
186
        error_plus(0, errno, "close");
155
187
        free(cmdline);
156
188
        return 0;
157
189
      }
183
215
    return 1;
184
216
  }
185
217
  
186
 
  struct dirent **direntries;
 
218
  struct dirent **direntries = NULL;
187
219
  int ret;
188
220
  ret = scandir("/proc", &direntries, is_plymouth, alphasort);
189
 
  if (ret == -1){
190
 
    error(1, errno, "scandir");
191
 
  }
 
221
  if(ret == -1){
 
222
    error_plus(1, errno, "scandir");
 
223
  }
 
224
  {
 
225
    int i = ret;
 
226
    while(i--){
 
227
      free(direntries[i]);
 
228
    }
 
229
  }
 
230
  free(direntries);
192
231
  return ret > 0;
193
232
}
194
233
 
200
239
  struct termios t_new, t_old;
201
240
  char *buffer = NULL;
202
241
  char *prefix = NULL;
 
242
  char *prompt = NULL;
203
243
  int status = EXIT_SUCCESS;
204
244
  struct sigaction old_action,
205
245
    new_action = { .sa_handler = termination_handler,
209
249
      { .name = "prefix", .key = 'p',
210
250
        .arg = "PREFIX", .flags = 0,
211
251
        .doc = "Prefix shown before the prompt", .group = 2 },
 
252
      { .name = "prompt", .key = 129,
 
253
        .arg = "PROMPT", .flags = 0,
 
254
        .doc = "The prompt to show", .group = 2 },
212
255
      { .name = "debug", .key = 128,
213
256
        .doc = "Debug mode", .group = 3 },
214
257
      /*
223
266
      { .name = NULL }
224
267
    };
225
268
    
 
269
    __attribute__((nonnull(3)))
226
270
    error_t parse_opt (int key, char *arg, struct argp_state *state){
227
271
      errno = 0;
228
272
      switch (key){
229
 
      case 'p':
 
273
      case 'p':                 /* --prefix */
230
274
        prefix = arg;
231
275
        break;
232
 
      case 128:
 
276
      case 128:                 /* --debug */
233
277
        debug = true;
234
278
        break;
 
279
      case 129:                 /* --prompt */
 
280
        prompt = arg;
 
281
        break;
235
282
        /*
236
283
         * These reproduce what we would get without ARGP_NO_HELP
237
284
         */
239
286
        argp_state_help(state, state->out_stream,
240
287
                        (ARGP_HELP_STD_HELP | ARGP_HELP_EXIT_ERR)
241
288
                        & ~(unsigned int)ARGP_HELP_EXIT_OK);
 
289
        __builtin_unreachable();
242
290
      case -3:                  /* --usage */
243
291
        argp_state_help(state, state->out_stream,
244
292
                        ARGP_HELP_USAGE | ARGP_HELP_EXIT_ERR);
 
293
        __builtin_unreachable();
245
294
      case 'V':                 /* --version */
246
295
        fprintf(state->out_stream, "%s\n", argp_program_version);
247
296
        exit(argp_err_exit_status);
264
313
    case ENOMEM:
265
314
    default:
266
315
      errno = ret;
267
 
      error(0, errno, "argp_parse");
 
316
      error_plus(0, errno, "argp_parse");
268
317
      return EX_OSERR;
269
318
    case EINVAL:
270
319
      return EX_USAGE;
275
324
    fprintf(stderr, "Starting %s\n", argv[0]);
276
325
  }
277
326
 
278
 
  if (conflict_detection()){
 
327
  if(conflict_detection()){
279
328
    if(debug){
280
329
      fprintf(stderr, "Stopping %s because of conflict\n", argv[0]);
281
330
    }
288
337
  
289
338
  if(tcgetattr(STDIN_FILENO, &t_old) != 0){
290
339
    int e = errno;
291
 
    error(0, errno, "tcgetattr");
 
340
    error_plus(0, errno, "tcgetattr");
292
341
    switch(e){
293
342
    case EBADF:
294
343
    case ENOTTY:
301
350
  sigemptyset(&new_action.sa_mask);
302
351
  ret = sigaddset(&new_action.sa_mask, SIGINT);
303
352
  if(ret == -1){
304
 
    error(0, errno, "sigaddset");
 
353
    error_plus(0, errno, "sigaddset");
305
354
    return EX_OSERR;
306
355
  }
307
356
  ret = sigaddset(&new_action.sa_mask, SIGHUP);
308
357
  if(ret == -1){
309
 
    error(0, errno, "sigaddset");
 
358
    error_plus(0, errno, "sigaddset");
310
359
    return EX_OSERR;
311
360
  }
312
361
  ret = sigaddset(&new_action.sa_mask, SIGTERM);
313
362
  if(ret == -1){
314
 
    error(0, errno, "sigaddset");
 
363
    error_plus(0, errno, "sigaddset");
315
364
    return EX_OSERR;
316
365
  }
317
366
  /* Need to check if the handler is SIG_IGN before handling:
320
369
  */
321
370
  ret = sigaction(SIGINT, NULL, &old_action);
322
371
  if(ret == -1){
323
 
    error(0, errno, "sigaction");
 
372
    error_plus(0, errno, "sigaction");
324
373
    return EX_OSERR;
325
374
  }
326
375
  if(old_action.sa_handler != SIG_IGN){
327
376
    ret = sigaction(SIGINT, &new_action, NULL);
328
377
    if(ret == -1){
329
 
      error(0, errno, "sigaction");
 
378
      error_plus(0, errno, "sigaction");
330
379
      return EX_OSERR;
331
380
    }
332
381
  }
333
382
  ret = sigaction(SIGHUP, NULL, &old_action);
334
383
  if(ret == -1){
335
 
    error(0, errno, "sigaction");
 
384
    error_plus(0, errno, "sigaction");
336
385
    return EX_OSERR;
337
386
  }
338
387
  if(old_action.sa_handler != SIG_IGN){
339
388
    ret = sigaction(SIGHUP, &new_action, NULL);
340
389
    if(ret == -1){
341
 
      error(0, errno, "sigaction");
 
390
      error_plus(0, errno, "sigaction");
342
391
      return EX_OSERR;
343
392
    }
344
393
  }
345
394
  ret = sigaction(SIGTERM, NULL, &old_action);
346
395
  if(ret == -1){
347
 
    error(0, errno, "sigaction");
 
396
    error_plus(0, errno, "sigaction");
348
397
    return EX_OSERR;
349
398
  }
350
399
  if(old_action.sa_handler != SIG_IGN){
351
400
    ret = sigaction(SIGTERM, &new_action, NULL);
352
401
    if(ret == -1){
353
 
      error(0, errno, "sigaction");
 
402
      error_plus(0, errno, "sigaction");
354
403
      return EX_OSERR;
355
404
    }
356
405
  }
364
413
  t_new.c_lflag &= ~(tcflag_t)ECHO;
365
414
  if(tcsetattr(STDIN_FILENO, TCSAFLUSH, &t_new) != 0){
366
415
    int e = errno;
367
 
    error(0, errno, "tcsetattr-echo");
 
416
    error_plus(0, errno, "tcsetattr-echo");
368
417
    switch(e){
369
418
    case EBADF:
370
419
    case ENOTTY:
390
439
    if(prefix){
391
440
      fprintf(stderr, "%s ", prefix);
392
441
    }
393
 
    {
 
442
    if(prompt != NULL){
 
443
      fprintf(stderr, "%s: ", prompt);
 
444
    } else {
394
445
      const char *cryptsource = getenv("CRYPTTAB_SOURCE");
395
446
      const char *crypttarget = getenv("CRYPTTAB_NAME");
396
447
      /* Before cryptsetup 1.1.0~rc2 */
434
485
        sret = write(STDOUT_FILENO, buffer + written, n - written);
435
486
        if(sret < 0){
436
487
          int e = errno;
437
 
          error(0, errno, "write");
 
488
          error_plus(0, errno, "write");
438
489
          switch(e){
439
490
          case EBADF:
440
491
          case EFAULT:
456
507
      sret = close(STDOUT_FILENO);
457
508
      if(sret == -1){
458
509
        int e = errno;
459
 
        error(0, errno, "close");
 
510
        error_plus(0, errno, "close");
460
511
        switch(e){
461
512
        case EBADF:
462
513
          status = EX_OSFILE;
471
522
    }
472
523
    if(sret < 0){
473
524
      int e = errno;
474
 
      if(errno != EINTR and not feof(stdin)){
475
 
        error(0, errno, "getline");
476
 
        switch(e){
477
 
        case EBADF:
478
 
          status = EX_UNAVAILABLE;
479
 
        case EIO:
480
 
        case EINVAL:
481
 
        default:
482
 
          status = EX_IOERR;
 
525
      if(errno != EINTR){
 
526
        if(not feof(stdin)){
 
527
          error_plus(0, errno, "getline");
 
528
          switch(e){
 
529
          case EBADF:
 
530
            status = EX_UNAVAILABLE;
 
531
            break;
 
532
          case EIO:
 
533
          case EINVAL:
 
534
          default:
 
535
            status = EX_IOERR;
 
536
            break;
 
537
          }
483
538
          break;
 
539
        } else {
 
540
          clearerr(stdin);
484
541
        }
485
 
        break;
486
542
      }
487
543
    }
488
544
    /* if(sret == 0), then the only sensible thing to do is to retry
501
557
    fprintf(stderr, "Restoring terminal attributes\n");
502
558
  }
503
559
  if(tcsetattr(STDIN_FILENO, TCSAFLUSH, &t_old) != 0){
504
 
    error(0, errno, "tcsetattr+echo");
 
560
    error_plus(0, errno, "tcsetattr+echo");
505
561
  }
506
562
  
507
563
  if(quit_now){
509
565
    old_action.sa_handler = SIG_DFL;
510
566
    ret = sigaction(signal_received, &old_action, NULL);
511
567
    if(ret == -1){
512
 
      error(0, errno, "sigaction");
 
568
      error_plus(0, errno, "sigaction");
513
569
    }
514
570
    raise(signal_received);
515
571
  }