2 * Copyright notice from original mutt:
3 * Copyright (C) 2003 Werner Koch <wk@gnupg.org>
4 * Copyright (C) 2004 g10code GmbH
6 * This file is part of mutt-ng, see http://www.muttng.org/.
7 * It's licensed under the GNU General Public License,
8 * please see the file GPL in the top level source directory.
12 Common definitions and prototypes for the crypt functions. They are
13 all defined in crypt.c and cryptglue.c
19 #include <lib-mime/mime.h>
22 /* FIXME: They should be pointer to anonymous structures for better
23 information hiding. */
26 #define ENCRYPT (1 << 0)
28 #define GOODSIGN (1 << 2)
29 #define BADSIGN (1 << 3)
30 #define PARTSIGN (1 << 4)
31 #define SIGNOPAQUE (1 << 5)
32 #define KEYBLOCK (1 << 6) /* KEY too generic? */
33 #define INLINE (1 << 7)
35 #define APPLICATION_PGP (1 << 8)
36 #define APPLICATION_SMIME (1 << 9)
38 #define PGP_TRADITIONAL_CHECKED (1 << 10)
40 #define PGPENCRYPT (APPLICATION_PGP | ENCRYPT)
41 #define PGPSIGN (APPLICATION_PGP | SIGN)
42 #define PGPGOODSIGN (APPLICATION_PGP | GOODSIGN)
43 #define PGPKEY (APPLICATION_PGP | KEYBLOCK)
44 #define PGPINLINE (APPLICATION_PGP | INLINE)
46 #define SMIMEENCRYPT (APPLICATION_SMIME | ENCRYPT)
47 #define SMIMESIGN (APPLICATION_SMIME | SIGN)
48 #define SMIMEGOODSIGN (APPLICATION_SMIME | GOODSIGN)
49 #define SMIMEBADSIGN (APPLICATION_SMIME | BADSIGN)
50 #define SMIMEOPAQUE (APPLICATION_SMIME | SIGNOPAQUE)
52 #define KEYFLAG_CANSIGN (1 << 0)
53 #define KEYFLAG_CANENCRYPT (1 << 1)
54 #define KEYFLAG_ISX509 (1 << 2)
55 #define KEYFLAG_SECRET (1 << 7)
56 #define KEYFLAG_EXPIRED (1 << 8)
57 #define KEYFLAG_REVOKED (1 << 9)
58 #define KEYFLAG_DISABLED (1 << 10)
59 #define KEYFLAG_SUBKEY (1 << 11)
60 #define KEYFLAG_CRITICAL (1 << 12)
61 #define KEYFLAG_PREFER_ENCRYPTION (1 << 13)
62 #define KEYFLAG_PREFER_SIGNING (1 << 14)
64 #define KEYFLAG_CANTUSE (KEYFLAG_DISABLED|KEYFLAG_REVOKED|KEYFLAG_EXPIRED)
65 #define KEYFLAG_RESTRICTIONS (KEYFLAG_CANTUSE|KEYFLAG_CRITICAL)
67 #define KEYFLAG_ABILITIES (KEYFLAG_CANSIGN|KEYFLAG_CANENCRYPT|KEYFLAG_PREFER_ENCRYPTION|KEYFLAG_PREFER_SIGNING)
73 typedef enum pgp_ring pgp_ring_t;
77 typedef struct pgp_keyinfo *pgp_key_t;
81 /* Some prototypes -- old crypt.h. */
83 int mutt_protect (HEADER *, char *);
85 int mutt_signed_handler (BODY *, STATE *);
87 int mutt_parse_crypt_hdr (char *, int);
89 void convert_to_7bit (BODY *);
94 void crypt_invoke_import(FILE *stream, int smime);
95 int crypt_send_menu(HEADER *msg, int *redraw, int smime);
96 int crypt_verify_one(BODY *, STATE *s, FILE *fp, int smime);
101 /* Check out the type of encryption used and set the cached status
102 values if there are any. */
103 int crypt_query (BODY * m);
105 /* Fixme: To be documented. */
106 void crypt_extract_keys_from_messages (HEADER * h);
108 /* Do a quick check to make sure that we can find all of the
109 encryption keys if the user has requested this service.
110 Return the list of keys in KEYLIST. */
111 int crypt_get_keys (HEADER * msg, char **keylist);
113 /* Forget a passphrase and display a message. */
114 void crypt_forget_passphrase (void);
116 /* Check that we have a usable passphrase, ask if not. */
117 int crypt_valid_passphrase (int);
120 /*-- cryptglue.c --*/
122 /* Show a message that a backend will be invoked. */
123 void crypt_invoke_message (int type);
125 /* Decrypt a PGP/MIME message. */
126 int crypt_pgp_decrypt_mime (FILE * a, FILE ** b, BODY * c, BODY ** d);
128 /* MIME handler for the application/pgp content-type. */
129 int crypt_pgp_application_pgp_handler (BODY * m, STATE * s);
131 /* MIME handler for an PGP/MIME encrypted message. */
132 int crypt_pgp_encrypted_handler (BODY * a, STATE * s);
134 /* fixme: needs documentation. */
135 void crypt_pgp_invoke_getkeys (address_t * addr);
137 /* Ask for a PGP key. */
138 pgp_key_t crypt_pgp_ask_for_key (char *tag, char *whatfor,
139 short abilities, pgp_ring_t keyring);
141 /* Check for a traditional PGP message in body B. */
142 int crypt_pgp_check_traditional (FILE * fp, BODY * b, int tagged_only);
144 /* Release the PGP key KPP (note, that we pass a pointer to it). */
145 void crypt_pgp_free_key (pgp_key_t * kpp);
147 /* Generate a PGP public key attachment. */
148 BODY *crypt_pgp_make_key_attachment (char *tempf);
150 /* Create a new body with a PGP signed message from A. */
151 BODY *crypt_pgp_sign_message (BODY * a);
153 /* Warning: A is no longer freed in this routine, you need to free it
154 later. This is necessary for $fcc_attach. */
155 BODY *crypt_pgp_encrypt_message (BODY * a, char *keylist, int sign);
157 /* Access the keyID in K. */
158 char *crypt_pgp_keyid (pgp_key_t k);
160 /* fixme: needs documentation */
161 void crypt_pgp_extract_keys_from_attachment_list (FILE * fp, int tag,
165 /* Decrypt an S/MIME message. */
166 int crypt_smime_decrypt_mime (FILE * a, FILE ** b, BODY * c, BODY ** d);
168 /* MIME handler for the application/smime content-type. */
169 int crypt_smime_application_smime_handler (BODY * m, STATE * s);
171 /* fixme: Needs documentation. */
172 void crypt_smime_getkeys (ENVELOPE * env);
174 /* Check that the sender matches. */
175 int crypt_smime_verify_sender (HEADER * h);
177 /* Ask for an SMIME key. */
178 char *crypt_smime_ask_for_key (char *prompt, char *mailbox, short public);
180 /* fixme: Needs documentation. */
181 BODY *crypt_smime_sign_message (BODY * a);
183 /* fixme: needs documentation. */
184 BODY *crypt_smime_build_smime_entity (BODY * a, char *certlist);
186 #endif /*MUTT_CRYPT_H */