Coverage Report

Created: 2025-11-01 06:06

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/hpn-ssh/readpass.c
Line
Count
Source
1
/* $OpenBSD: readpass.c,v 1.72 2025/06/11 13:24:05 dtucker Exp $ */
2
/*
3
 * Copyright (c) 2001 Markus Friedl.  All rights reserved.
4
 *
5
 * Redistribution and use in source and binary forms, with or without
6
 * modification, are permitted provided that the following conditions
7
 * are met:
8
 * 1. Redistributions of source code must retain the above copyright
9
 *    notice, this list of conditions and the following disclaimer.
10
 * 2. Redistributions in binary form must reproduce the above copyright
11
 *    notice, this list of conditions and the following disclaimer in the
12
 *    documentation and/or other materials provided with the distribution.
13
 *
14
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
19
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
20
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
21
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24
 */
25
26
#include "includes.h"
27
28
#include <sys/types.h>
29
#include <sys/wait.h>
30
31
#include <errno.h>
32
#include <fcntl.h>
33
#include <paths.h>
34
#include <signal.h>
35
#include <stdarg.h>
36
#include <stdio.h>
37
#include <stdlib.h>
38
#include <string.h>
39
#include <unistd.h>
40
41
#include "xmalloc.h"
42
#include "misc.h"
43
#include "pathnames.h"
44
#include "log.h"
45
#include "ssh.h"
46
#include "uidswap.h"
47
48
static char *
49
ssh_askpass(char *askpass, const char *msg, const char *env_hint)
50
0
{
51
0
  pid_t pid, ret;
52
0
  size_t len;
53
0
  char *pass;
54
0
  int p[2], status;
55
0
  char buf[1024];
56
0
  void (*osigchld)(int);
57
58
0
  if (fflush(stdout) != 0)
59
0
    error_f("fflush: %s", strerror(errno));
60
0
  if (askpass == NULL)
61
0
    fatal("internal error: askpass undefined");
62
0
  if (pipe(p) == -1) {
63
0
    error_f("pipe: %s", strerror(errno));
64
0
    return NULL;
65
0
  }
66
0
  osigchld = ssh_signal(SIGCHLD, SIG_DFL);
67
0
  if ((pid = fork()) == -1) {
68
0
    error_f("fork: %s", strerror(errno));
69
0
    ssh_signal(SIGCHLD, osigchld);
70
0
    return NULL;
71
0
  }
72
0
  if (pid == 0) {
73
0
    close(p[0]);
74
0
    if (dup2(p[1], STDOUT_FILENO) == -1)
75
0
      fatal_f("dup2: %s", strerror(errno));
76
0
    if (env_hint != NULL)
77
0
      setenv("SSH_ASKPASS_PROMPT", env_hint, 1);
78
0
    execlp(askpass, askpass, msg, (char *)NULL);
79
0
    fatal_f("exec(%s): %s", askpass, strerror(errno));
80
0
  }
81
0
  close(p[1]);
82
83
0
  len = 0;
84
0
  do {
85
0
    ssize_t r = read(p[0], buf + len, sizeof(buf) - 1 - len);
86
87
0
    if (r == -1 && errno == EINTR)
88
0
      continue;
89
0
    if (r <= 0)
90
0
      break;
91
0
    len += r;
92
0
  } while (len < sizeof(buf) - 1);
93
0
  buf[len] = '\0';
94
95
0
  close(p[0]);
96
0
  while ((ret = waitpid(pid, &status, 0)) == -1)
97
0
    if (errno != EINTR)
98
0
      break;
99
0
  ssh_signal(SIGCHLD, osigchld);
100
0
  if (ret == -1 || !WIFEXITED(status) || WEXITSTATUS(status) != 0) {
101
0
    explicit_bzero(buf, sizeof(buf));
102
0
    return NULL;
103
0
  }
104
105
0
  buf[strcspn(buf, "\r\n")] = '\0';
106
0
  pass = xstrdup(buf);
107
0
  explicit_bzero(buf, sizeof(buf));
108
0
  return pass;
109
0
}
110
111
/* private/internal read_passphrase flags */
112
0
#define RP_ASK_PERMISSION 0x8000 /* pass hint to askpass for confirm UI */
113
114
/*
115
 * Reads a passphrase from /dev/tty with echo turned off/on.  Returns the
116
 * passphrase (allocated with xmalloc).  Exits if EOF is encountered. If
117
 * RP_ALLOW_STDIN is set, the passphrase will be read from stdin if no
118
 * tty is or askpass program is available
119
 */
120
char *
121
read_passphrase(const char *prompt, int flags)
122
0
{
123
0
  char cr = '\r', *askpass = NULL, *ret, buf[1024];
124
0
  int rppflags, ttyfd, use_askpass = 0, allow_askpass = 0;
125
0
  const char *askpass_hint = NULL;
126
0
  const char *s;
127
128
0
  if (((s = getenv("DISPLAY")) != NULL && *s != '\0') ||
129
0
      ((s = getenv("WAYLAND_DISPLAY")) != NULL && *s != '\0'))
130
0
    allow_askpass = 1;
131
0
  if ((s = getenv(SSH_ASKPASS_REQUIRE_ENV)) != NULL) {
132
0
    if (strcasecmp(s, "force") == 0) {
133
0
      use_askpass = 1;
134
0
      allow_askpass = 1;
135
0
    } else if (strcasecmp(s, "prefer") == 0)
136
0
      use_askpass = allow_askpass;
137
0
    else if (strcasecmp(s, "never") == 0)
138
0
      allow_askpass = 0;
139
0
  }
140
141
0
  rppflags = (flags & RP_ECHO) ? RPP_ECHO_ON : RPP_ECHO_OFF;
142
0
  if (use_askpass)
143
0
    debug_f("requested to askpass");
144
0
  else if (flags & RP_USE_ASKPASS)
145
0
    use_askpass = 1;
146
0
  else if (flags & RP_ALLOW_STDIN) {
147
0
    if (!isatty(STDIN_FILENO)) {
148
0
      debug_f("stdin is not a tty");
149
0
      use_askpass = 1;
150
0
    }
151
0
  } else {
152
0
    rppflags |= RPP_REQUIRE_TTY;
153
0
    ttyfd = open(_PATH_TTY, O_RDWR);
154
0
    if (ttyfd >= 0) {
155
      /*
156
       * If we're on a tty, ensure that show the prompt at
157
       * the beginning of the line. This will hopefully
158
       * clobber any password characters the user has
159
       * optimistically typed before echo is disabled.
160
       */
161
0
      (void)write(ttyfd, &cr, 1);
162
0
      close(ttyfd);
163
0
    } else {
164
0
      debug_f("can't open %s: %s", _PATH_TTY,
165
0
          strerror(errno));
166
0
      use_askpass = 1;
167
0
    }
168
0
  }
169
170
0
  if ((flags & RP_USE_ASKPASS) && !allow_askpass)
171
0
    return (flags & RP_ALLOW_EOF) ? NULL : xstrdup("");
172
173
0
  if (use_askpass && allow_askpass) {
174
0
    if (getenv(SSH_ASKPASS_ENV))
175
0
      askpass = getenv(SSH_ASKPASS_ENV);
176
0
    else
177
0
      askpass = _PATH_SSH_ASKPASS_DEFAULT;
178
0
    if ((flags & RP_ASK_PERMISSION) != 0)
179
0
      askpass_hint = "confirm";
180
0
    if ((ret = ssh_askpass(askpass, prompt, askpass_hint)) == NULL)
181
0
      if (!(flags & RP_ALLOW_EOF))
182
0
        return xstrdup("");
183
0
    return ret;
184
0
  }
185
186
0
  if (readpassphrase(prompt, buf, sizeof buf, rppflags) == NULL) {
187
0
    if (flags & RP_ALLOW_EOF)
188
0
      return NULL;
189
0
    return xstrdup("");
190
0
  }
191
192
0
  ret = xstrdup(buf);
193
0
  explicit_bzero(buf, sizeof(buf));
194
0
  return ret;
195
0
}
196
197
int
198
ask_permission(const char *fmt, ...)
199
0
{
200
0
  va_list args;
201
0
  char *p, prompt[1024];
202
0
  int allowed = 0;
203
204
0
  va_start(args, fmt);
205
0
  vsnprintf(prompt, sizeof(prompt), fmt, args);
206
0
  va_end(args);
207
208
0
  p = read_passphrase(prompt,
209
0
      RP_USE_ASKPASS|RP_ALLOW_EOF|RP_ASK_PERMISSION);
210
0
  if (p != NULL) {
211
    /*
212
     * Accept empty responses and responses consisting
213
     * of the word "yes" as affirmative.
214
     */
215
0
    if (*p == '\0' || *p == '\n' ||
216
0
        strcasecmp(p, "yes") == 0)
217
0
      allowed = 1;
218
0
    free(p);
219
0
  }
220
221
0
  return (allowed);
222
0
}
223
224
static void
225
writemsg(const char *msg)
226
0
{
227
0
  (void)write(STDERR_FILENO, "\r", 1);
228
0
  (void)write(STDERR_FILENO, msg, strlen(msg));
229
0
  (void)write(STDERR_FILENO, "\r\n", 2);
230
0
}
231
232
struct notifier_ctx {
233
  pid_t pid;
234
  void (*osigchld)(int);
235
};
236
237
struct notifier_ctx *
238
notify_start(int force_askpass, const char *fmt, ...)
239
0
{
240
0
  va_list args;
241
0
  char *prompt = NULL;
242
0
  pid_t pid = -1;
243
0
  void (*osigchld)(int) = NULL;
244
0
  const char *askpass, *s;
245
0
  struct notifier_ctx *ret = NULL;
246
247
0
  va_start(args, fmt);
248
0
  xvasprintf(&prompt, fmt, args);
249
0
  va_end(args);
250
251
0
  if (fflush(NULL) != 0)
252
0
    error_f("fflush: %s", strerror(errno));
253
0
  if (!force_askpass && isatty(STDERR_FILENO)) {
254
0
    writemsg(prompt);
255
0
    goto out_ctx;
256
0
  }
257
0
  if ((askpass = getenv("SSH_ASKPASS")) == NULL)
258
0
    askpass = _PATH_SSH_ASKPASS_DEFAULT;
259
0
  if (*askpass == '\0') {
260
0
    debug3_f("cannot notify: no askpass");
261
0
    goto out;
262
0
  }
263
0
  if (getenv("DISPLAY") == NULL && getenv("WAYLAND_DISPLAY") == NULL &&
264
0
      ((s = getenv(SSH_ASKPASS_REQUIRE_ENV)) == NULL ||
265
0
      strcmp(s, "force") != 0)) {
266
0
    debug3_f("cannot notify: no display");
267
0
    goto out;
268
0
  }
269
0
  osigchld = ssh_signal(SIGCHLD, SIG_DFL);
270
0
  if ((pid = fork()) == -1) {
271
0
    error_f("fork: %s", strerror(errno));
272
0
    ssh_signal(SIGCHLD, osigchld);
273
0
    free(prompt);
274
0
    return NULL;
275
0
  }
276
0
  if (pid == 0) {
277
0
    if (stdfd_devnull(1, 1, 0) == -1)
278
0
      fatal_f("stdfd_devnull failed");
279
0
    closefrom(STDERR_FILENO + 1);
280
0
    setenv("SSH_ASKPASS_PROMPT", "none", 1); /* hint to UI */
281
0
    execlp(askpass, askpass, prompt, (char *)NULL);
282
0
    error_f("exec(%s): %s", askpass, strerror(errno));
283
0
    _exit(1);
284
    /* NOTREACHED */
285
0
  }
286
0
 out_ctx:
287
0
  if ((ret = calloc(1, sizeof(*ret))) == NULL) {
288
0
    if (pid != -1)
289
0
      kill(pid, SIGTERM);
290
0
    fatal_f("calloc failed");
291
0
  }
292
0
  ret->pid = pid;
293
0
  ret->osigchld = osigchld;
294
0
 out:
295
0
  free(prompt);
296
0
  return ret;
297
0
}
298
299
void
300
notify_complete(struct notifier_ctx *ctx, const char *fmt, ...)
301
3
{
302
3
  int ret;
303
3
  char *msg = NULL;
304
3
  va_list args;
305
306
3
  if (ctx != NULL && fmt != NULL && ctx->pid == -1) {
307
    /*
308
     * notify_start wrote to stderr, so send conclusion message
309
     * there too
310
    */
311
0
    va_start(args, fmt);
312
0
    xvasprintf(&msg, fmt, args);
313
0
    va_end(args);
314
0
    writemsg(msg);
315
0
    free(msg);
316
0
  }
317
318
3
  if (ctx == NULL || ctx->pid <= 0) {
319
3
    free(ctx);
320
3
    return;
321
3
  }
322
0
  kill(ctx->pid, SIGTERM);
323
0
  while ((ret = waitpid(ctx->pid, NULL, 0)) == -1) {
324
0
    if (errno != EINTR)
325
0
      break;
326
0
  }
327
0
  if (ret == -1)
328
0
    fatal_f("waitpid: %s", strerror(errno));
329
0
  ssh_signal(SIGCHLD, ctx->osigchld);
330
0
  free(ctx);
331
0
}