dlg_verifycert.c File Reference

Certificate Verification Dialog. More...

#include "config.h"
#include <stdbool.h>
#include <stdio.h>
#include <string.h>
#include "mutt/lib.h"
#include "gui/lib.h"
#include "color/lib.h"
#include "menu/lib.h"
#include "globals.h"
#include "keymap.h"
#include "opcodes.h"
#include "ssl.h"

Include dependency graph for dlg_verifycert.c:

Go to the source code of this file.

Functions
static int	menu_dialog_dokey (struct Menu *menu, int *id)
	Check if there are any menu key events to process. More...
static int	menu_dialog_translate_op (int op)
	Convert menubar movement to scrolling. More...
static void	cert_make_entry (struct Menu *menu, char *buf, size_t buflen, int line)
	Create a string to display in a Menu - Implements Menu::make_entry() -. More...
void	cert_array_clear (struct CertArray *carr)
	Free all memory of a CertArray. More...
int	dlg_verify_certificate (const char *title, struct CertArray *carr, bool allow_always, bool allow_skip)
	Ask the user to validate the certificate. More...

Variables
static const struct Mapping	VerifyHelp []
	Help Bar for the Certificate Verification dialog. More...

Detailed Description

Certificate Verification Dialog.

Authors

• Richard Russon

Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file dlg_verifycert.c.

Function Documentation

menu_dialog_dokey()

static int menu_dialog_dokey ( struct Menu *  menu, int *  id  )

static

Check if there are any menu key events to process.

Parameters

menu	Current Menu
id	KeyEvent ID

Return values

0	An event occurred for the menu, or a timeout
-1	There was an event, but not for menu

Definition at line 82 of file dlg_verifycert.c.

{
  struct KeyEvent ch = mutt_getch_timeout(5000);
 
  if ((ch.op == OP_TIMEOUT) || (ch.op == OP_ABORT))
  {
    *id = ch.op;
    return 0;
  }
 
  struct CertMenuData *mdata = menu->mdata;
  char *p = NULL;
  if ((ch.ch != 0) && (p = strchr(mdata->keys, ch.ch)))
  {
    *id = OP_MAX + (p - mdata->keys + 1);
    return 0;
  }
 
  if (ch.op == OP_NULL)
    mutt_unget_ch(ch.ch);
  else
    mutt_unget_op(ch.op);
  return -1;
}

Here is the call graph for this function:

Here is the caller graph for this function:

menu_dialog_translate_op()

static int menu_dialog_translate_op ( int  op )

static

Convert menubar movement to scrolling.

Parameters

op	Action requested, e.g. OP_NEXT_ENTRY

Return values

num	Action to perform, e.g. OP_NEXT_LINE

Definition at line 112 of file dlg_verifycert.c.

{
  switch (op)
  {
    case OP_NEXT_ENTRY:
      return OP_NEXT_LINE;
    case OP_PREV_ENTRY:
      return OP_PREV_LINE;
    case OP_CURRENT_TOP:
      return OP_TOP_PAGE;
    case OP_CURRENT_BOTTOM:
      return OP_BOTTOM_PAGE;
    case OP_CURRENT_MIDDLE:
      return OP_MIDDLE_PAGE;
  }
 
  return op;
}

Here is the caller graph for this function:

cert_array_clear()

void cert_array_clear

(

struct CertArray *

carr

)

Free all memory of a CertArray.

Parameters

carr	Array of text to clear

Note

Array is emptied, but not freed

Definition at line 156 of file dlg_verifycert.c.

{
  const char **line = NULL;
  ARRAY_FOREACH(line, carr)
  {
    FREE(line);
  }
}

Here is the caller graph for this function:

dlg_verify_certificate()

int dlg_verify_certificate	(	const char *	title,
		struct CertArray *	carr,
		bool	allow_always,
		bool	allow_skip
	)

Ask the user to validate the certificate.

Parameters

title	Menu title
carr	Certificate text to display
allow_always	If true, allow the user to always accept the certificate
allow_skip	If true, allow the user to skip the verification

Return values

1	Reject certificate (or menu aborted)
2	Accept certificate once
3	Accept certificate always/skip (see notes)
4	Accept certificate skip

The possible retvals will depend on the parameters. The options are given in the order: Reject, Once, Always, Skip. The retval represents the chosen option.

Definition at line 180 of file dlg_verifycert.c.

{
  struct MuttWindow *dlg = simple_dialog_new(MENU_GENERIC, WT_DLG_CERTIFICATE, VerifyHelp);
 
  struct CertMenuData mdata = { carr };
 
  struct Menu *menu = dlg->wdata;
  menu->mdata = &mdata;
  menu->mdata_free = NULL; // Menu doesn't own the data
  menu->make_entry = cert_make_entry;
  menu->max = ARRAY_SIZE(carr);
 
  struct MuttWindow *sbar = window_find_child(dlg, WT_STATUS_BAR);
  sbar_set_title(sbar, title);
 
  if (allow_always)
  {
    if (allow_skip)
    {
      mdata.prompt = _("(r)eject, accept (o)nce, (a)ccept always, (s)kip");
      /* L10N: The letters correspond to the choices in the string:
         "(r)eject, accept (o)nce, (a)ccept always, (s)kip"
         This is an interactive certificate confirmation prompt for an SSL connection. */
      mdata.keys = _("roas");
    }
    else
    {
      mdata.prompt = _("(r)eject, accept (o)nce, (a)ccept always");
      /* L10N: The letters correspond to the choices in the string:
         "(r)eject, accept (o)nce, (a)ccept always"
         This is an interactive certificate confirmation prompt for an SSL connection. */
      mdata.keys = _("roa");
    }
  }
  else
  {
    if (allow_skip)
    {
      mdata.prompt = _("(r)eject, accept (o)nce, (s)kip");
      /* L10N: The letters correspond to the choices in the string:
         "(r)eject, accept (o)nce, (s)kip"
         This is an interactive certificate confirmation prompt for an SSL connection. */
      mdata.keys = _("ros");
    }
    else
    {
      mdata.prompt = _("(r)eject, accept (o)nce");
      /* L10N: The letters correspond to the choices in the string:
         "(r)eject, accept (o)nce"
         This is an interactive certificate confirmation prompt for an SSL connection. */
      mdata.keys = _("ro");
    }
  }
  msgwin_set_text(MT_COLOR_PROMPT, mdata.prompt);
 
  bool old_ime = OptIgnoreMacroEvents;
  OptIgnoreMacroEvents = true;
 
  // ---------------------------------------------------------------------------
  // Event Loop
  int choice = 0;
  int op = OP_NULL;
  do
  {
    window_redraw(NULL);
    msgwin_set_text(MT_COLOR_PROMPT, mdata.prompt);
 
    // Try to catch dialog keys before ops
    if (menu_dialog_dokey(menu, &op) != 0)
    {
      struct KeyEvent event = km_dokey_event(MENU_GENERIC);
      if (event.ch == 'q')
        op = OP_EXIT;
      else
        op = event.op;
    }
 
    if (op == OP_TIMEOUT)
      continue;
 
    // Convert menubar movement to scrolling
    op = menu_dialog_translate_op(op);
 
    if (op <= OP_MAX)
      mutt_debug(LL_DEBUG1, "Got op %s (%d)\n", opcodes_get_name(op), op);
    else
      mutt_debug(LL_DEBUG1, "Got choice %d\n", op - OP_MAX);
 
    switch (op)
    {
      case -1:         // Abort: Ctrl-G
      case OP_EXIT:    // Q)uit
      case OP_MAX + 1: // R)eject
        choice = 1;
        break;
      case OP_MAX + 2: // O)nce
        choice = 2;
        break;
      case OP_MAX + 3: // A)lways / S)kip
        choice = 3;
        break;
      case OP_MAX + 4: // S)kip
        choice = 4;
        break;
 
      case OP_JUMP:
      case OP_JUMP_1:
      case OP_JUMP_2:
      case OP_JUMP_3:
      case OP_JUMP_4:
      case OP_JUMP_5:
      case OP_JUMP_6:
      case OP_JUMP_7:
      case OP_JUMP_8:
      case OP_JUMP_9:
        mutt_error(_("Jumping is not implemented for dialogs"));
        continue;
 
      case OP_SEARCH:
      case OP_SEARCH_NEXT:
      case OP_SEARCH_OPPOSITE:
      case OP_SEARCH_REVERSE:
        mutt_error(_("Search is not implemented for this menu"));
        continue;
    }
 
    (void) menu_function_dispatcher(menu->win, op);
  } while (choice == 0);
  // ---------------------------------------------------------------------------
 
  OptIgnoreMacroEvents = old_ime;
 
  simple_dialog_free(&dlg);
 
  return choice;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

VerifyHelp

const struct Mapping VerifyHelp[]

static

Initial value:

= {
  
  { N_("Exit"), OP_EXIT },
  { N_("Help"), OP_HELP },
  { NULL, 0 },
  
}

Help Bar for the Certificate Verification dialog.

Definition at line 67 of file dlg_verifycert.c.