3 * $Id: passphrase.c,v 1.2 2000/06/17 11:49:37 mdw Exp $
5 * Reading of passphrases (Unix-specific)
7 * (c) 1999 Straylight/Edgeware
10 /*----- Licensing notice --------------------------------------------------*
12 * This file is part of Catacomb.
14 * Catacomb is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU Library General Public License as
16 * published by the Free Software Foundation; either version 2 of the
17 * License, or (at your option) any later version.
19 * Catacomb is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU Library General Public License for more details.
24 * You should have received a copy of the GNU Library General Public
25 * License along with Catacomb; if not, write to the Free
26 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
30 /*----- Revision history --------------------------------------------------*
32 * $Log: passphrase.c,v $
33 * Revision 1.2 2000/06/17 11:49:37 mdw
34 * New pixie protocol allowing application to request passphrases and send
37 * Revision 1.1 1999/12/22 15:58:20 mdw
38 * Portable interface to reading passphrases.
42 /*----- Header files ------------------------------------------------------*/
51 #include <mLib/dstr.h>
53 #include "passphrase.h"
56 /*----- Static variables --------------------------------------------------*/
59 static unsigned flags
= 0;
65 /*----- Main code ---------------------------------------------------------*/
71 * Returns: Zero if OK, nonzero if it failed
73 * Use: Attempts to connect to the passphrase pixie.
76 static int pconn(void)
82 if ((fd
= pixie_open(0)) < 0) {
89 /* --- @passphrase_read@ --- *
91 * Arguments: @const char *tag@ = pointer to passphrase tag string
92 * @unsigned mode@ = reading mode
93 * @char *buf@ = pointer to destination buffer
94 * @size_t sz@ = size of destination buffer
96 * Returns: Zero if successful, nonzero on failure.
98 * Use: Reads a passphrase from the user, using some system-specific
99 * secure mechanism. The mechanism may keep a cache of
100 * passphrases, so the user may not necessarily be prompted.
103 int passphrase_read(const char *tag
, unsigned mode
, char *buf
, size_t sz
)
108 /* --- Try talking to the pixie --- */
111 rc
= pixie_read(fd
, tag
, mode
, buf
, sz
);
121 /* --- Read from the terminal --- */
123 dstr_putf(&d
, "%s %s: ",
124 mode
== PMODE_READ ?
"Passphrase" : "New passphrase",
126 if (pixie_getpass(d
.buf
, buf
, sz
))
128 if (mode
== PMODE_VERIFY
) {
131 dstr_putf(&d
, "Verify passphrase %s: ", tag
);
132 if (pixie_getpass(d
.buf
, b
, sizeof(b
)) ||
133 strcmp(b
, buf
) != 0) {
134 memset(b
, 0, sizeof(b
));
140 /* --- If the pixie is interested, tell it the new passphrase --- */
143 pixie_set(fd
, tag
, buf
);
146 /* --- Tidy up after a failure --- */
154 /* --- @passphrase_cancel@ --- *
156 * Arguments: @const char *tag@ = pointer to passphrase tag string
160 * Use: Attempts to make the passphrase cache forget about a
161 * particular passphrase. This may be useful if the passphrase
162 * turns out to be wrong, or if the user is attempting to change
166 void passphrase_cancel(const char *tag
)
169 pixie_cancel(fd
, tag
);
172 /*----- That's all, folks -------------------------------------------------*/