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, int flags,
  44                                                            char *keylist);
  45 typedef BODY *(*crypt_func_pgp_make_key_attachment_t) (char *tempf);
  46 typedef char *(*crypt_func_findkeys_t) (ADDRESS *to,
  47                                         ADDRESS *cc, ADDRESS *bcc);
  48 typedef BODY *(*crypt_func_sign_message_t) (BODY *a);
  49 typedef BODY *(*crypt_func_pgp_encrypt_message_t) (BODY *a, char *keylist,
  50                                                    int sign);
  51 typedef void (*crypt_func_pgp_invoke_import_t) (const char *fname);
  52 typedef int (*crypt_func_verify_one_t) (BODY *sigbdy, STATE *s,
  53                                         const char *tempf);
  54 typedef void (*crypt_func_pgp_extract_keys_from_attachment_list_t)
  55                                            (FILE *fp, int tag, BODY *top);
  56
  57 typedef int (*crypt_func_send_menu_t) (HEADER *msg, int *redraw);
  58
  59  /* (SMIME) */
  60 typedef void (*crypt_func_smime_getkeys_t) (ENVELOPE *env);
  61 typedef int (*crypt_func_smime_verify_sender_t) (HEADER *h);
  62
  63 typedef BODY *(*crypt_func_smime_build_smime_entity_t) (BODY *a,
  64                                                         char *certlist);
  65
  66 typedef void (*crypt_func_smime_invoke_import_t) (char *infile, char *mailbox);
  67
  68 typedef void (*crypt_func_init_t) (void);
  69
  70
  71 /*
  72    A structure to keep all crypto module fucntions together.
  73  */
  74 typedef struct crypt_module_functions
  75 {
  76   /* Common/General functions.  */
  77   crypt_func_init_t init;
  78   crypt_func_void_passphrase_t void_passphrase;
  79   crypt_func_valid_passphrase_t valid_passphrase;
  80   crypt_func_decrypt_mime_t decrypt_mime;
  81   crypt_func_application_handler_t application_handler;
  82   crypt_func_encrypted_handler_t encrypted_handler;
  83   crypt_func_findkeys_t findkeys;
  84   crypt_func_sign_message_t sign_message;
  85   crypt_func_verify_one_t verify_one;
  86   crypt_func_send_menu_t send_menu;
  87
  88   /* PGP specific functions.  */
  89   crypt_func_pgp_encrypt_message_t pgp_encrypt_message;
  90   crypt_func_pgp_make_key_attachment_t pgp_make_key_attachment;
  91   crypt_func_pgp_check_traditional_t pgp_check_traditional;
  92   crypt_func_pgp_traditional_encryptsign_t pgp_traditional_encryptsign;
  93   crypt_func_pgp_invoke_getkeys_t pgp_invoke_getkeys;
  94   crypt_func_pgp_invoke_import_t pgp_invoke_import;
  95   crypt_func_pgp_extract_keys_from_attachment_list_t
  96                                  pgp_extract_keys_from_attachment_list;
  97
  98   /* S/MIME specific functions.  */
  99
 100   crypt_func_smime_getkeys_t smime_getkeys;
 101   crypt_func_smime_verify_sender_t smime_verify_sender;
 102   crypt_func_smime_build_smime_entity_t smime_build_smime_entity;
 103   crypt_func_smime_invoke_import_t smime_invoke_import;
 104 } crypt_module_functions_t;
 105
 106
 107 /*
 108    A structure to decribe a crypto module.
 109  */
 110 typedef struct crypt_module_specs
 111 {
 112   int identifier;                       /* Identifying bit.  */
 113   crypt_module_functions_t functions;
 114 } *crypt_module_specs_t;
 115
 116
 117
 118 /*
 119    High Level crypto module interface.
 120  */
 121
 122 void crypto_module_register (crypt_module_specs_t specs);
 123 crypt_module_specs_t crypto_module_lookup (int identifier);
 124
 125 /* If the crypto module identifier by IDENTIFIER has been registered,
 126    call its function FUNC.  Do nothing else.  This may be used as an
 127    expression. */
 128 #define CRYPT_MOD_CALL_CHECK(identifier, func) \
 129   (crypto_module_lookup (APPLICATION_ ## identifier) \
 130    && (crypto_module_lookup (APPLICATION_ ## identifier))->functions.func)
 131
 132 /* Call the function FUNC in the crypto module identified by
 133    IDENTIFIER. This may be used as an expression. */
 134 #define CRYPT_MOD_CALL(identifier, func) \
 135   *(crypto_module_lookup (APPLICATION_ ## identifier))->functions.func
 136
 137 #endif