1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
/**
* @file
* Register crypto modules
*
* @authors
* Copyright (C) 2017-2018 Pietro Cerutti <gahr@gahr.ch>
* Copyright (C) 2017-2023 Richard Russon <rich@flatcap.org>
*
* @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/>.
*/
/**
* @page crypt_crypt_mod Register crypto modules
*
* Register crypto modules
*/
#include "config.h"
#include "mutt/lib.h"
#include "crypt_mod.h"
#include "lib.h"
/**
* struct CryptModule - A crypto plugin module
*
* A type of a variable to keep track of registered crypto modules.
*/
struct CryptModule
{
const struct CryptModuleSpecs *specs; ///< Crypto module definition
STAILQ_ENTRY(CryptModule) entries; ///< Linked list
};
STAILQ_HEAD(CryptModuleList, CryptModule);
/// Linked list of crypto modules, e.g. #CryptModSmimeClassic, #CryptModPgpGpgme
static struct CryptModuleList CryptModules = STAILQ_HEAD_INITIALIZER(CryptModules);
/**
* crypto_module_register - Register a new crypto module
* @param specs API functions
*/
void crypto_module_register(const struct CryptModuleSpecs *specs)
{
struct CryptModule *module = MUTT_MEM_CALLOC(1, struct CryptModule);
module->specs = specs;
STAILQ_INSERT_HEAD(&CryptModules, module, entries);
}
/**
* crypto_module_lookup - Lookup a crypto module by name
* @param identifier Name, e.g. #APPLICATION_PGP
* @retval ptr Crypto module
*
* This function is usually used via the CRYPT_MOD_CALL[_CHECK] macros.
*/
const struct CryptModuleSpecs *crypto_module_lookup(int identifier)
{
const struct CryptModule *module = NULL;
STAILQ_FOREACH(module, &CryptModules, entries)
{
if (module->specs->identifier == identifier)
{
return module->specs;
}
}
return NULL;
}
/**
* crypto_module_cleanup - Clean up the crypto modules
*/
void crypto_module_cleanup(void)
{
struct CryptModule *np = NULL, *tmp = NULL;
STAILQ_FOREACH_SAFE(np, &CryptModules, entries, tmp)
{
STAILQ_REMOVE(&CryptModules, np, CryptModule, entries);
FREE(&np);
}
}
|
