crypt-mod.h

   1 /*
   2  * Copyright (C) 2004 g10 Code GmbH
   3  *
   4  *     This program is free software; you can redistribute it and/or modify
   5  *     it under the terms of the GNU General Public License as published by
   6  *     the Free Software Foundation; either version 2 of the License, or
   7  *     (at your option) any later version.
   8  *
   9  *     This program is distributed in the hope that it will be useful,
  10  *     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  *     GNU General Public License for more details.
  13  *
  14  *     You should have received a copy of the GNU General Public License
  15  *     along with this program; if not, write to the Free Software
  16  *     Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  17  */
  18
  19 #ifndef CRYPTOGRAPHY_H
  20 #define CRYPTOGRAPHY_H
  21
  22 #include "mutt.h"
  23 #include "mutt_crypt.h"
  24
  25 #define CRYPTO_SUPPORT(identifier) (WithCrypto & APPLICATION_ ## identifier)
  26
  27
  28 /*
  29     Type defintions for crypto module functions.
  30  */
  31 typedef void (*crypt_func_void_passphrase_t) (void);
  32 typedef int (*crypt_func_valid_passphrase_t) (void);
  33
  34 typedef int (*crypt_func_decrypt_mime_t) (FILE * a, FILE ** b,
  35                                           BODY * c, BODY ** d);
  36
  37 typedef void (*crypt_func_application_handler_t) (BODY * m, STATE * s);
  38 typedef void (*crypt_func_encrypted_handler_t) (BODY * m, STATE * s);
  39
  40 typedef void (*crypt_func_pgp_invoke_getkeys_t) (ADDRESS * addr);
  41 typedef int (*crypt_func_pgp_check_traditional_t) (FILE * fp, BODY * b,
  42                                                    int tagged_only);
  43 typedef BODY *(*crypt_func_pgp_traditional_encryptsign_t) (BODY * a,
  44                                                            int flags,
  45                                                            char *keylist);
  46 typedef BODY *(*crypt_func_pgp_make_key_attachment_t) (char *tempf);
  47 typedef char *(*crypt_func_findkeys_t) (ADDRESS * to,
  48                                         ADDRESS * cc, ADDRESS * bcc);
  49 typedef BODY *(*crypt_func_sign_message_t) (BODY * a);
  50 typedef BODY *(*crypt_func_pgp_encrypt_message_t) (BODY * a, char *keylist,
  51                                                    int sign);
  52 typedef void (*crypt_func_pgp_invoke_import_t) (const char *fname);
  53 typedef int (*crypt_func_verify_one_t) (BODY * sigbdy, STATE * s,
  54                                         const char *tempf);
  55 typedef void (*crypt_func_pgp_extract_keys_from_attachment_list_t)
  56      (FILE * fp, int tag, BODY * top);
  57
  58 typedef int (*crypt_func_send_menu_t) (HEADER * msg, int *redraw);
  59
  60  /* (SMIME) */
  61 typedef void (*crypt_func_smime_getkeys_t) (ENVELOPE * env);
  62 typedef int (*crypt_func_smime_verify_sender_t) (HEADER * h);
  63
  64 typedef BODY *(*crypt_func_smime_build_smime_entity_t) (BODY * a,
  65                                                         char *certlist);
  66
  67 typedef void (*crypt_func_smime_invoke_import_t) (char *infile,
  68                                                   char *mailbox);
  69
  70 typedef void (*crypt_func_init_t) (void);
  71
  72
  73 /*
  74    A structure to keep all crypto module fucntions together.
  75  */
  76 typedef struct crypt_module_functions {
  77   /* Common/General functions.  */
  78   crypt_func_init_t init;
  79   crypt_func_void_passphrase_t void_passphrase;
  80   crypt_func_valid_passphrase_t valid_passphrase;
  81   crypt_func_decrypt_mime_t decrypt_mime;
  82   crypt_func_application_handler_t application_handler;
  83   crypt_func_encrypted_handler_t encrypted_handler;
  84   crypt_func_findkeys_t findkeys;
  85   crypt_func_sign_message_t sign_message;
  86   crypt_func_verify_one_t verify_one;
  87   crypt_func_send_menu_t send_menu;
  88
  89   /* PGP specific functions.  */
  90   crypt_func_pgp_encrypt_message_t pgp_encrypt_message;
  91   crypt_func_pgp_make_key_attachment_t pgp_make_key_attachment;
  92   crypt_func_pgp_check_traditional_t pgp_check_traditional;
  93   crypt_func_pgp_traditional_encryptsign_t pgp_traditional_encryptsign;
  94   crypt_func_pgp_invoke_getkeys_t pgp_invoke_getkeys;
  95   crypt_func_pgp_invoke_import_t pgp_invoke_import;
  96
  97
  98
  99
 100
 101
 102
 103
 104
 105
 106
 107
 108
 109
 110      crypt_func_pgp_extract_keys_from_attachment_list_t
 111     pgp_extract_keys_from_attachment_list;
 112
 113   /* S/MIME specific functions.  */
 114
 115   crypt_func_smime_getkeys_t smime_getkeys;
 116   crypt_func_smime_verify_sender_t smime_verify_sender;
 117   crypt_func_smime_build_smime_entity_t smime_build_smime_entity;
 118   crypt_func_smime_invoke_import_t smime_invoke_import;
 119 } crypt_module_functions_t;
 120
 121
 122 /*
 123    A structure to decribe a crypto module.
 124  */
 125 typedef struct crypt_module_specs {
 126   int identifier;               /* Identifying bit.  */
 127   crypt_module_functions_t functions;
 128 }                 *crypt_module_specs_t;
 129
 130
 131
 132 /*
 133    High Level crypto module interface.
 134  */
 135
 136 void crypto_module_register (crypt_module_specs_t specs);
 137 crypt_module_specs_t crypto_module_lookup (int identifier);
 138
 139 /* If the crypto module identifier by IDENTIFIER has been registered,
 140    call its function FUNC.  Do nothing else.  This may be used as an
 141    expression. */
 142 #define CRYPT_MOD_CALL_CHECK(identifier, func) \
 143   (crypto_module_lookup (APPLICATION_ ## identifier) \
 144    && (crypto_module_lookup (APPLICATION_ ## identifier))->functions.func)
 145
 146 /* Call the function FUNC in the crypto module identified by
 147    IDENTIFIER. This may be used as an expression. */
 148 #define CRYPT_MOD_CALL(identifier, func) \
 149   *(crypto_module_lookup (APPLICATION_ ## identifier))->functions.func
 150
 151 #endif