3 * $Id: passphrase.c,v 1.4 2001/04/19 18:26:01 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.4 2001/04/19 18:26:01 mdw
34 * Re-request broken passphrases.
36 * Revision 1.3 2000/12/06 20:33:27 mdw
37 * Make flags be macros rather than enumerations, to ensure that they're
40 * Revision 1.2 2000/06/17 11:49:37 mdw
41 * New pixie protocol allowing application to request passphrases and send
44 * Revision 1.1 1999/12/22 15:58:20 mdw
45 * Portable interface to reading passphrases.
49 /*----- Header files ------------------------------------------------------*/
58 #include <mLib/dstr.h>
60 #include "passphrase.h"
63 /*----- Static variables --------------------------------------------------*/
66 static unsigned flags
= 0;
70 /*----- Main code ---------------------------------------------------------*/
76 * Returns: Zero if OK, nonzero if it failed
78 * Use: Attempts to connect to the passphrase pixie.
81 static int pconn(void)
87 if ((fd
= pixie_open(0)) < 0) {
94 /* --- @passphrase_read@ --- *
96 * Arguments: @const char *tag@ = pointer to passphrase tag string
97 * @unsigned mode@ = reading mode
98 * @char *buf@ = pointer to destination buffer
99 * @size_t sz@ = size of destination buffer
101 * Returns: Zero if successful, nonzero on failure.
103 * Use: Reads a passphrase from the user, using some system-specific
104 * secure mechanism. The mechanism may keep a cache of
105 * passphrases, so the user may not necessarily be prompted.
108 int passphrase_read(const char *tag
, unsigned mode
, char *buf
, size_t sz
)
113 /* --- Try talking to the pixie --- */
116 rc
= pixie_read(fd
, tag
, mode
, buf
, sz
);
126 /* --- Read from the terminal --- */
129 dstr_putf(&d
, "%s %s: ",
130 mode
== PMODE_READ ?
"Passphrase" : "New passphrase",
132 if (pixie_getpass(d
.buf
, buf
, sz
))
134 if (mode
== PMODE_VERIFY
) {
137 dstr_putf(&d
, "Verify passphrase %s: ", tag
);
138 if (pixie_getpass(d
.buf
, b
, sizeof(b
)) ||
139 strcmp(b
, buf
) != 0) {
140 memset(b
, 0, sizeof(b
));
145 /* --- If the pixie is interested, tell it the new passphrase --- */
148 pixie_set(fd
, tag
, buf
);
151 /* --- Tidy up after a failure --- */
159 /* --- @passphrase_cancel@ --- *
161 * Arguments: @const char *tag@ = pointer to passphrase tag string
165 * Use: Attempts to make the passphrase cache forget about a
166 * particular passphrase. This may be useful if the passphrase
167 * turns out to be wrong, or if the user is attempting to change
171 void passphrase_cancel(const char *tag
)
174 pixie_cancel(fd
, tag
);
177 /*----- That's all, folks -------------------------------------------------*/