Coverage Report

Created: 2026-03-12 06:25

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/Botan-3.4.0/src/lib/modes/cipher_mode.cpp
Line
Count
Source
1
/*
2
* Cipher Modes
3
* (C) 2015 Jack Lloyd
4
*
5
* Botan is released under the Simplified BSD License (see license.txt)
6
*/
7
8
#include <botan/cipher_mode.h>
9
10
#include <botan/internal/parsing.h>
11
#include <botan/internal/scan_name.h>
12
#include <botan/internal/stream_mode.h>
13
#include <sstream>
14
15
#if defined(BOTAN_HAS_BLOCK_CIPHER)
16
   #include <botan/block_cipher.h>
17
#endif
18
19
#if defined(BOTAN_HAS_AEAD_MODES)
20
   #include <botan/aead.h>
21
#endif
22
23
#if defined(BOTAN_HAS_MODE_CBC)
24
   #include <botan/internal/cbc.h>
25
#endif
26
27
#if defined(BOTAN_HAS_MODE_CFB)
28
   #include <botan/internal/cfb.h>
29
#endif
30
31
#if defined(BOTAN_HAS_MODE_XTS)
32
   #include <botan/internal/xts.h>
33
#endif
34
35
#if defined(BOTAN_HAS_COMMONCRYPTO)
36
   #include <botan/internal/commoncrypto.h>
37
#endif
38
39
namespace Botan {
40
41
std::unique_ptr<Cipher_Mode> Cipher_Mode::create_or_throw(std::string_view algo,
42
                                                          Cipher_Dir direction,
43
0
                                                          std::string_view provider) {
44
0
   if(auto mode = Cipher_Mode::create(algo, direction, provider)) {
45
0
      return mode;
46
0
   }
47
48
0
   throw Lookup_Error("Cipher mode", algo, provider);
49
0
}
50
51
std::unique_ptr<Cipher_Mode> Cipher_Mode::create(std::string_view algo,
52
                                                 Cipher_Dir direction,
53
0
                                                 std::string_view provider) {
54
#if defined(BOTAN_HAS_COMMONCRYPTO)
55
   if(provider.empty() || provider == "commoncrypto") {
56
      if(auto cm = make_commoncrypto_cipher_mode(algo, direction))
57
         return cm;
58
59
      if(!provider.empty())
60
         return nullptr;
61
   }
62
#endif
63
64
0
#if defined(BOTAN_HAS_STREAM_CIPHER)
65
0
   if(auto sc = StreamCipher::create(algo)) {
66
0
      return std::make_unique<Stream_Cipher_Mode>(std::move(sc));
67
0
   }
68
0
#endif
69
70
0
#if defined(BOTAN_HAS_AEAD_MODES)
71
0
   if(auto aead = AEAD_Mode::create(algo, direction)) {
72
0
      return aead;
73
0
   }
74
0
#endif
75
76
0
   if(algo.find('/') != std::string::npos) {
77
0
      const std::vector<std::string> algo_parts = split_on(algo, '/');
78
0
      std::string_view cipher_name = algo_parts[0];
79
0
      const std::vector<std::string> mode_info = parse_algorithm_name(algo_parts[1]);
80
81
0
      if(mode_info.empty()) {
82
0
         return std::unique_ptr<Cipher_Mode>();
83
0
      }
84
85
0
      std::ostringstream mode_name;
86
87
0
      mode_name << mode_info[0] << '(' << cipher_name;
88
0
      for(size_t i = 1; i < mode_info.size(); ++i) {
89
0
         mode_name << ',' << mode_info[i];
90
0
      }
91
0
      for(size_t i = 2; i < algo_parts.size(); ++i) {
92
0
         mode_name << ',' << algo_parts[i];
93
0
      }
94
0
      mode_name << ')';
95
96
0
      return Cipher_Mode::create(mode_name.str(), direction, provider);
97
0
   }
98
99
0
#if defined(BOTAN_HAS_BLOCK_CIPHER)
100
101
0
   SCAN_Name spec(algo);
102
103
0
   if(spec.arg_count() == 0) {
104
0
      return std::unique_ptr<Cipher_Mode>();
105
0
   }
106
107
0
   auto bc = BlockCipher::create(spec.arg(0), provider);
108
109
0
   if(!bc) {
110
0
      return std::unique_ptr<Cipher_Mode>();
111
0
   }
112
113
0
   #if defined(BOTAN_HAS_MODE_CBC)
114
0
   if(spec.algo_name() == "CBC") {
115
0
      const std::string padding = spec.arg(1, "PKCS7");
116
117
0
      if(padding == "CTS") {
118
0
         if(direction == Cipher_Dir::Encryption) {
119
0
            return std::make_unique<CTS_Encryption>(std::move(bc));
120
0
         } else {
121
0
            return std::make_unique<CTS_Decryption>(std::move(bc));
122
0
         }
123
0
      } else {
124
0
         auto pad = BlockCipherModePaddingMethod::create(padding);
125
126
0
         if(pad) {
127
0
            if(direction == Cipher_Dir::Encryption) {
128
0
               return std::make_unique<CBC_Encryption>(std::move(bc), std::move(pad));
129
0
            } else {
130
0
               return std::make_unique<CBC_Decryption>(std::move(bc), std::move(pad));
131
0
            }
132
0
         }
133
0
      }
134
0
   }
135
0
   #endif
136
137
   #if defined(BOTAN_HAS_MODE_XTS)
138
   if(spec.algo_name() == "XTS") {
139
      if(direction == Cipher_Dir::Encryption) {
140
         return std::make_unique<XTS_Encryption>(std::move(bc));
141
      } else {
142
         return std::make_unique<XTS_Decryption>(std::move(bc));
143
      }
144
   }
145
   #endif
146
147
0
   #if defined(BOTAN_HAS_MODE_CFB)
148
0
   if(spec.algo_name() == "CFB") {
149
0
      const size_t feedback_bits = spec.arg_as_integer(1, 8 * bc->block_size());
150
0
      if(direction == Cipher_Dir::Encryption) {
151
0
         return std::make_unique<CFB_Encryption>(std::move(bc), feedback_bits);
152
0
      } else {
153
0
         return std::make_unique<CFB_Decryption>(std::move(bc), feedback_bits);
154
0
      }
155
0
   }
156
0
   #endif
157
158
0
#endif
159
160
0
   return std::unique_ptr<Cipher_Mode>();
161
0
}
162
163
//static
164
0
std::vector<std::string> Cipher_Mode::providers(std::string_view algo_spec) {
165
0
   const std::vector<std::string>& possible = {"base", "commoncrypto"};
166
0
   std::vector<std::string> providers;
167
0
   for(auto&& prov : possible) {
168
0
      auto mode = Cipher_Mode::create(algo_spec, Cipher_Dir::Encryption, prov);
169
0
      if(mode) {
170
0
         providers.push_back(prov);  // available
171
0
      }
172
0
   }
173
0
   return providers;
174
0
}
175
176
}  // namespace Botan