3 * $Id: passphrase.c,v 1.3 2000/12/06 20:33:27 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.3 2000/12/06 20:33:27 mdw
34 * Make flags be macros rather than enumerations, to ensure that they're
37 * Revision 1.2 2000/06/17 11:49:37 mdw
38 * New pixie protocol allowing application to request passphrases and send
41 * Revision 1.1 1999/12/22 15:58:20 mdw
42 * Portable interface to reading passphrases.
46 /*----- Header files ------------------------------------------------------*/
55 #include <mLib/dstr.h>
57 #include "passphrase.h"
60 /*----- Static variables --------------------------------------------------*/
63 static unsigned flags
= 0;
67 /*----- Main code ---------------------------------------------------------*/
73 * Returns: Zero if OK, nonzero if it failed
75 * Use: Attempts to connect to the passphrase pixie.
78 static int pconn(void)
84 if ((fd
= pixie_open(0)) < 0) {
91 /* --- @passphrase_read@ --- *
93 * Arguments: @const char *tag@ = pointer to passphrase tag string
94 * @unsigned mode@ = reading mode
95 * @char *buf@ = pointer to destination buffer
96 * @size_t sz@ = size of destination buffer
98 * Returns: Zero if successful, nonzero on failure.
100 * Use: Reads a passphrase from the user, using some system-specific
101 * secure mechanism. The mechanism may keep a cache of
102 * passphrases, so the user may not necessarily be prompted.
105 int passphrase_read(const char *tag
, unsigned mode
, char *buf
, size_t sz
)
110 /* --- Try talking to the pixie --- */
113 rc
= pixie_read(fd
, tag
, mode
, buf
, sz
);
123 /* --- Read from the terminal --- */
125 dstr_putf(&d
, "%s %s: ",
126 mode
== PMODE_READ ?
"Passphrase" : "New passphrase",
128 if (pixie_getpass(d
.buf
, buf
, sz
))
130 if (mode
== PMODE_VERIFY
) {
133 dstr_putf(&d
, "Verify passphrase %s: ", tag
);
134 if (pixie_getpass(d
.buf
, b
, sizeof(b
)) ||
135 strcmp(b
, buf
) != 0) {
136 memset(b
, 0, sizeof(b
));
142 /* --- If the pixie is interested, tell it the new passphrase --- */
145 pixie_set(fd
, tag
, buf
);
148 /* --- Tidy up after a failure --- */
156 /* --- @passphrase_cancel@ --- *
158 * Arguments: @const char *tag@ = pointer to passphrase tag string
162 * Use: Attempts to make the passphrase cache forget about a
163 * particular passphrase. This may be useful if the passphrase
164 * turns out to be wrong, or if the user is attempting to change
168 void passphrase_cancel(const char *tag
)
171 pixie_cancel(fd
, tag
);
174 /*----- That's all, folks -------------------------------------------------*/