NeoMutt  2025-12-11-435-g4ac674
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
pgp_functions.c
Go to the documentation of this file.
1
22
28
29#include "config.h"
30#include <stdio.h>
31#include <sys/types.h>
32#include <unistd.h>
33#include "mutt/lib.h"
34#include "config/lib.h"
35#include "core/lib.h"
36#include "gui/lib.h"
37#include "pgp_functions.h"
38#include "lib.h"
39#include "key/lib.h"
40#include "menu/lib.h"
41#include "pager/lib.h"
42#include "question/lib.h"
43#include "globals.h"
44#include "mutt_logging.h"
45#include "pgp.h"
46#include "pgpinvoke.h"
47#include "pgpkey.h"
48#include "pgplib.h"
49
53static int op_exit(struct PgpData *pd, const struct KeyEvent *event)
54{
55 pd->done = true;
56 return FR_SUCCESS;
57}
58
62static int op_generic_select_entry(struct PgpData *pd, const struct KeyEvent *event)
63{
64 /* XXX make error reporting more verbose */
65
66 const int index = menu_get_index(pd->menu);
67 struct PgpUid **pkey = ARRAY_GET(pd->key_table, index);
68 if (!pkey)
69 return FR_ERROR;
70
72 {
73 if (!pgp_key_is_valid((*pkey)->parent))
74 {
75 mutt_error(_("This key can't be used: expired/disabled/revoked"));
76 return FR_ERROR;
77 }
78 }
79
80 if (OptPgpCheckTrust && (!pgp_id_is_valid((*pkey)) || !pgp_id_is_strong((*pkey))))
81 {
82 const char *str = "";
83 char buf2[1024] = { 0 };
84
85 if ((*pkey)->flags & KEYFLAG_CANTUSE)
86 {
87 str = _("ID is expired/disabled/revoked. Do you really want to use the key?");
88 }
89 else
90 {
91 switch ((*pkey)->trust & 0x03)
92 {
93 case 0:
94 str = _("ID has undefined validity. Do you really want to use the key?");
95 break;
96 case 1:
97 str = _("ID is not valid. Do you really want to use the key?");
98 break;
99 case 2:
100 str = _("ID is only marginally valid. Do you really want to use the key?");
101 break;
102 }
103 }
104
105 snprintf(buf2, sizeof(buf2), "%s", str);
106
107 if (query_yesorno(buf2, MUTT_NO) != MUTT_YES)
108 {
110 return FR_NO_ACTION;
111 }
112 }
113
114 pd->key = (*pkey)->parent;
115 pd->done = true;
116 return FR_SUCCESS;
117}
118
122static int op_verify_key(struct PgpData *pd, const struct KeyEvent *event)
123{
124 FILE *fp_null = mutt_file_fopen("/dev/null", "w");
125 if (!fp_null)
126 {
127 mutt_perror(_("Can't open /dev/null"));
128 return FR_ERROR;
129 }
130 struct Buffer *tempfile = NULL;
131 tempfile = buf_pool_get();
132 buf_mktemp(tempfile);
133 FILE *fp_tmp = mutt_file_fopen(buf_string(tempfile), "w");
134 if (!fp_tmp)
135 {
136 mutt_perror(_("Can't create temporary file"));
137 mutt_file_fclose(&fp_null);
138 buf_pool_release(&tempfile);
139 return FR_ERROR;
140 }
141
142 mutt_message(_("Invoking PGP..."));
143
144 const int index = menu_get_index(pd->menu);
145 struct PgpUid **pkey = ARRAY_GET(pd->key_table, index);
146 if (!pkey)
147 {
148 mutt_file_fclose(&fp_tmp);
149 mutt_file_fclose(&fp_null);
150 return FR_ERROR;
151 }
152
153 char tmpbuf[256] = { 0 };
154 snprintf(tmpbuf, sizeof(tmpbuf), "0x%s",
155 pgp_fpr_or_lkeyid(pgp_principal_key((*pkey)->parent)));
156
157 pid_t pid = pgp_invoke_verify_key(NULL, NULL, NULL, -1, fileno(fp_tmp),
158 fileno(fp_null), tmpbuf);
159 if (pid == -1)
160 {
161 mutt_perror(_("Can't create filter"));
162 unlink(buf_string(tempfile));
163 mutt_file_fclose(&fp_tmp);
164 mutt_file_fclose(&fp_null);
165 }
166
167 filter_wait(pid);
168 mutt_file_fclose(&fp_tmp);
169 mutt_file_fclose(&fp_null);
171 char title[1024] = { 0 };
172 snprintf(title, sizeof(title), _("Key ID: 0x%s"),
173 pgp_keyid(pgp_principal_key((*pkey)->parent)));
174
175 struct PagerData pdata = { 0 };
176 struct PagerView pview = { &pdata };
177
178 pdata.fname = buf_string(tempfile);
179
180 pview.banner = title;
182 pview.mode = PAGER_MODE_OTHER;
183
184 mutt_do_pager(&pview, NULL);
185 buf_pool_release(&tempfile);
187 return FR_SUCCESS;
188}
189
193static int op_view_id(struct PgpData *pd, const struct KeyEvent *event)
194{
195 const int index = menu_get_index(pd->menu);
196 struct PgpUid **pkey = ARRAY_GET(pd->key_table, index);
197 if (!pkey)
198 return FR_ERROR;
199
200 mutt_message("%s", NONULL((*pkey)->addr));
201 return FR_SUCCESS;
202}
203
204// -----------------------------------------------------------------------------
205
209static const struct PgpFunction PgpFunctions[] = {
210 // clang-format off
211 { OP_EXIT, op_exit },
212 { OP_GENERIC_SELECT_ENTRY, op_generic_select_entry },
213 { OP_VERIFY_KEY, op_verify_key },
214 { OP_VIEW_ID, op_view_id },
215 { 0, NULL },
216 // clang-format on
217};
218
222int pgp_function_dispatcher(struct MuttWindow *win, const struct KeyEvent *event)
223{
224 // The Dispatcher may be called on any Window in the Dialog
225 struct MuttWindow *dlg = dialog_find(win);
226 if (!event || !dlg || !dlg->wdata)
227 return FR_ERROR;
228
229 const int op = event->op;
230 struct Menu *menu = dlg->wdata;
231 struct PgpData *pd = menu->mdata;
232 if (!pd)
233 return FR_ERROR;
234
235 int rc = FR_UNKNOWN;
236 for (size_t i = 0; PgpFunctions[i].op != OP_NULL; i++)
237 {
238 const struct PgpFunction *fn = &PgpFunctions[i];
239 if (fn->op == op)
240 {
241 rc = fn->function(pd, event);
242 break;
243 }
244 }
245
246 if (rc == FR_UNKNOWN) // Not our function
247 return rc;
248
249 const char *result = dispatcher_get_retval_name(rc);
250 mutt_debug(LL_DEBUG1, "Handled %s (%d) -> %s\n", opcodes_get_name(op), op, NONULL(result));
251
252 return rc;
253}
#define ARRAY_GET(head, idx)
Return the element at index.
Definition array.h:109
static const char * buf_string(const struct Buffer *buf)
Convert a buffer to a const char * "string".
Definition buffer.h:96
Convenience wrapper for the config headers.
Convenience wrapper for the core headers.
struct MuttWindow * dialog_find(struct MuttWindow *win)
Find the parent Dialog of a Window.
Definition dialog.c:89
const char * dispatcher_get_retval_name(int rv)
Get the name of a return value.
Definition dispatcher.c:54
@ FR_SUCCESS
Valid function - successfully performed.
Definition dispatcher.h:40
@ FR_UNKNOWN
Unknown function.
Definition dispatcher.h:34
@ FR_ERROR
Valid function - error occurred.
Definition dispatcher.h:39
@ FR_NO_ACTION
Valid function - no action performed.
Definition dispatcher.h:38
int mutt_do_pager(struct PagerView *pview, struct Email *e)
Display some page-able text to the user (help or attachment)
Definition do_pager.c:122
#define mutt_file_fclose(FP)
Definition file.h:139
#define mutt_file_fopen(PATH, MODE)
Definition file.h:138
bool OptPgpCheckTrust
(pseudo) used by dlg_pgp()
Definition globals.c:55
Global variables.
static int op_generic_select_entry(struct AliasMenuData *mdata, const struct KeyEvent *event)
select the current entry - Implements alias_function_t -
Definition functions.c:248
static int op_exit(struct AliasMenuData *mdata, const struct KeyEvent *event)
exit this menu - Implements alias_function_t -
Definition functions.c:234
int pgp_function_dispatcher(struct MuttWindow *win, const struct KeyEvent *event)
Perform a Pgp function - Implements function_dispatcher_t -.
static int op_verify_key(struct GpgmeData *gd, const struct KeyEvent *event)
Verify a PGP public key - Implements gpgme_function_t -.
static int op_view_id(struct GpgmeData *gd, const struct KeyEvent *event)
View the key's user id - Implements gpgme_function_t -.
#define mutt_error(...)
Definition logging2.h:94
#define mutt_message(...)
Definition logging2.h:93
#define mutt_debug(LEVEL,...)
Definition logging2.h:91
#define mutt_perror(...)
Definition logging2.h:95
static int op_verify_key(struct PgpData *pd, const struct KeyEvent *event)
Verify a PGP public key - Implements pgp_function_t -.
static int op_generic_select_entry(struct PgpData *pd, const struct KeyEvent *event)
Select the current entry - Implements pgp_function_t -.
static int op_exit(struct PgpData *pd, const struct KeyEvent *event)
Exit this menu - Implements pgp_function_t -.
static int op_view_id(struct PgpData *pd, const struct KeyEvent *event)
View the key's user id - Implements pgp_function_t -.
Convenience wrapper for the gui headers.
Manage keymappings.
@ LL_DEBUG1
Log at debug level 1.
Definition logging2.h:45
GUI present the user with a selectable list.
#define MENU_REDRAW_FULL
Redraw everything.
Definition lib.h:60
void menu_queue_redraw(struct Menu *menu, MenuRedrawFlags redraw)
Queue a request for a redraw.
Definition menu.c:188
int menu_get_index(struct Menu *menu)
Get the current selection in the Menu.
Definition menu.c:164
int filter_wait(pid_t pid)
Wait for the exit of a process and return its status.
Definition filter.c:220
Convenience wrapper for the library headers.
#define _(a)
Definition message.h:28
void mutt_clear_error(void)
Clear the message line (bottom line of screen)
NeoMutt Logging.
API for encryption/signing of emails.
#define KEYFLAG_CANTUSE
Definition lib.h:147
const char * opcodes_get_name(int op)
Get the name of an opcode.
Definition opcodes.c:48
GUI display a file/email/help in a viewport with paging.
#define MUTT_PAGER_NO_FLAGS
No flags are set.
Definition lib.h:62
@ PAGER_MODE_OTHER
Pager is invoked via 3rd path. Non-email content is likely to be shown.
Definition lib.h:142
char * pgp_keyid(struct PgpKeyInfo *k)
Get the ID of the main (parent) key.
Definition pgp.c:203
char * pgp_fpr_or_lkeyid(struct PgpKeyInfo *k)
Get the fingerprint or long keyid.
Definition pgp.c:233
PGP sign, encrypt, check routines.
static const struct PgpFunction PgpFunctions[]
All the NeoMutt functions that the Pgp supports.
Pgp functions.
pid_t pgp_invoke_verify_key(FILE **fp_pgp_in, FILE **fp_pgp_out, FILE **fp_pgp_err, int fd_pgp_in, int fd_pgp_out, int fd_pgp_err, const char *uids)
Use PGP to verify a key.
Definition pgpinvoke.c:397
Wrapper around calls to external PGP program.
bool pgp_id_is_valid(struct PgpUid *uid)
Is a PGP key valid.
Definition pgpkey.c:148
bool pgp_id_is_strong(struct PgpUid *uid)
Is a PGP key strong?
Definition pgpkey.c:135
bool pgp_key_is_valid(struct PgpKeyInfo *k)
Is a PGP key valid?
Definition pgpkey.c:103
struct PgpKeyInfo * pgp_principal_key(struct PgpKeyInfo *key)
Get the main (parent) PGP key.
Definition pgpkey.c:91
PGP key management routines.
Misc PGP helper routines.
struct Buffer * buf_pool_get(void)
Get a Buffer from the pool.
Definition pool.c:91
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
Definition pool.c:111
@ MUTT_NO
User answered 'No', or assume 'No'.
Definition quad.h:38
@ MUTT_YES
User answered 'Yes', or assume 'Yes'.
Definition quad.h:39
Ask the user a question.
enum QuadOption query_yesorno(const char *prompt, enum QuadOption def)
Ask the user a Yes/No question.
Definition question.c:326
#define NONULL(x)
Definition string2.h:44
String manipulation buffer.
Definition buffer.h:36
An event such as a keypress.
Definition get.h:50
Definition lib.h:80
void * mdata
Private data.
Definition lib.h:149
void * wdata
Private data.
Data to be displayed by PagerView.
Definition lib.h:161
const char * fname
Name of the file to read.
Definition lib.h:165
Paged view into some data.
Definition lib.h:172
struct PagerData * pdata
Data that pager displays. NOTNULL.
Definition lib.h:173
enum PagerMode mode
Pager mode.
Definition lib.h:174
PagerFlags flags
Additional settings to tweak pager's function.
Definition lib.h:175
const char * banner
Title to display in status bar.
Definition lib.h:176
Data to pass to the Pgp Functions.
struct Menu * menu
Pgp Menu.
bool done
Should we close the Dialog?
struct PgpUidArray * key_table
Array of Keys.
struct PgpKeyInfo * key
Selected Key.
A NeoMutt function.
int op
Op code, e.g. OP_GENERIC_SELECT_ENTRY.
pgp_function_t function
Function to call.
struct PgpKeyInfo * parent
Parent key.
Definition pgplib.h:58
PGP User ID.
Definition pgplib.h:36
#define buf_mktemp(buf)
Definition tmp.h:33