diff --git a/AES128_8cpp_source.html b/AES128_8cpp_source.html index ba3576e4..e9e6b728 100644 --- a/AES128_8cpp_source.html +++ b/AES128_8cpp_source.html @@ -175,7 +175,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/AES192_8cpp_source.html b/AES192_8cpp_source.html index 3195b686..9eff8209 100644 --- a/AES192_8cpp_source.html +++ b/AES192_8cpp_source.html @@ -175,7 +175,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/AES256_8cpp_source.html b/AES256_8cpp_source.html index b74e6209..65bca129 100644 --- a/AES256_8cpp_source.html +++ b/AES256_8cpp_source.html @@ -182,7 +182,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/AESCommon_8cpp_source.html b/AESCommon_8cpp_source.html index 0cea2abd..6058ed1a 100644 --- a/AESCommon_8cpp_source.html +++ b/AESCommon_8cpp_source.html @@ -415,7 +415,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/AES_8h_source.html b/AES_8h_source.html index d068be49..970d4957 100644 --- a/AES_8h_source.html +++ b/AES_8h_source.html @@ -206,7 +206,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/AuthenticatedCipher_8cpp_source.html b/AuthenticatedCipher_8cpp_source.html new file mode 100644 index 00000000..1c2e0d6c --- /dev/null +++ b/AuthenticatedCipher_8cpp_source.html @@ -0,0 +1,133 @@ + + + + + + +ArduinoLibs: AuthenticatedCipher.cpp Source File + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ + +
+
+
+
AuthenticatedCipher.cpp
+
+
+
1 /*
+
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
+
3  *
+
4  * Permission is hereby granted, free of charge, to any person obtaining a
+
5  * copy of this software and associated documentation files (the "Software"),
+
6  * to deal in the Software without restriction, including without limitation
+
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+
8  * and/or sell copies of the Software, and to permit persons to whom the
+
9  * Software is furnished to do so, subject to the following conditions:
+
10  *
+
11  * The above copyright notice and this permission notice shall be included
+
12  * in all copies or substantial portions of the Software.
+
13  *
+
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+
20  * DEALINGS IN THE SOFTWARE.
+
21  */
+
22 
+
23 #include "AuthenticatedCipher.h"
+
24 
+
54 AuthenticatedCipher::AuthenticatedCipher()
+
55 {
+
56 }
+
57 
+
61 AuthenticatedCipher::~AuthenticatedCipher()
+
62 {
+
63 }
+
64 
+
AuthenticatedCipher::~AuthenticatedCipher
virtual ~AuthenticatedCipher()
Destroys this authenticated cipher.
Definition: AuthenticatedCipher.cpp:61
+
AuthenticatedCipher::AuthenticatedCipher
AuthenticatedCipher()
Constructs a new authenticated cipher.
Definition: AuthenticatedCipher.cpp:54
+
+ +
+Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/AuthenticatedCipher_8h_source.html b/AuthenticatedCipher_8h_source.html new file mode 100644 index 00000000..f41c2302 --- /dev/null +++ b/AuthenticatedCipher_8h_source.html @@ -0,0 +1,149 @@ + + + + + + +ArduinoLibs: AuthenticatedCipher.h Source File + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ + +
+
+
+
AuthenticatedCipher.h
+
+
+
1 /*
+
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
+
3  *
+
4  * Permission is hereby granted, free of charge, to any person obtaining a
+
5  * copy of this software and associated documentation files (the "Software"),
+
6  * to deal in the Software without restriction, including without limitation
+
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+
8  * and/or sell copies of the Software, and to permit persons to whom the
+
9  * Software is furnished to do so, subject to the following conditions:
+
10  *
+
11  * The above copyright notice and this permission notice shall be included
+
12  * in all copies or substantial portions of the Software.
+
13  *
+
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+
20  * DEALINGS IN THE SOFTWARE.
+
21  */
+
22 
+
23 #ifndef CRYPTO_AUTHENTICATEDCIPHER_h
+
24 #define CRYPTO_AUTHENTICATEDCIPHER_h
+
25 
+
26 #include "Cipher.h"
+
27 
+
28 class AuthenticatedCipher : public Cipher
+
29 {
+
30 public:
+
31  AuthenticatedCipher();
+
32  virtual ~AuthenticatedCipher();
+
33 
+
34  virtual size_t tagSize() const = 0;
+
35 
+
36  virtual void addAuthData(const void *data, size_t len) = 0;
+
37 
+
38  virtual void computeTag(void *tag, size_t len) = 0;
+
39  virtual bool checkTag(const void *tag, size_t len) = 0;
+
40 };
+
41 
+
42 #endif
+
Cipher
Abstract base class for stream ciphers.
Definition: Cipher.h:29
+
AuthenticatedCipher::checkTag
virtual bool checkTag(const void *tag, size_t len)=0
Finalizes the decryption process and checks the authentication tag.
+
AuthenticatedCipher::~AuthenticatedCipher
virtual ~AuthenticatedCipher()
Destroys this authenticated cipher.
Definition: AuthenticatedCipher.cpp:61
+
AuthenticatedCipher
Abstract base class for authenticated ciphers.
Definition: AuthenticatedCipher.h:28
+
AuthenticatedCipher::tagSize
virtual size_t tagSize() const =0
Returns the size of the authentication tag.
+
AuthenticatedCipher::computeTag
virtual void computeTag(void *tag, size_t len)=0
Finalizes the encryption process and computes the authentication tag.
+
AuthenticatedCipher::addAuthData
virtual void addAuthData(const void *data, size_t len)=0
Adds extra data that will be authenticated but not encrypted.
+
AuthenticatedCipher::AuthenticatedCipher
AuthenticatedCipher()
Constructs a new authenticated cipher.
Definition: AuthenticatedCipher.cpp:54
+
+ +
+Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/BLAKE2b_8cpp_source.html b/BLAKE2b_8cpp_source.html index 68b16d08..12a8fbab 100644 --- a/BLAKE2b_8cpp_source.html +++ b/BLAKE2b_8cpp_source.html @@ -330,7 +330,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/BLAKE2b_8h_source.html b/BLAKE2b_8h_source.html index 54426b1e..34a2fa62 100644 --- a/BLAKE2b_8h_source.html +++ b/BLAKE2b_8h_source.html @@ -163,7 +163,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/BLAKE2s_8cpp_source.html b/BLAKE2s_8cpp_source.html index 71a3bd1a..4d5ddb05 100644 --- a/BLAKE2s_8cpp_source.html +++ b/BLAKE2s_8cpp_source.html @@ -322,7 +322,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/BLAKE2s_8h_source.html b/BLAKE2s_8h_source.html index 4a675b57..7a591dc7 100644 --- a/BLAKE2s_8h_source.html +++ b/BLAKE2s_8h_source.html @@ -162,7 +162,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/BigNumberUtil_8h_source.html b/BigNumberUtil_8h_source.html new file mode 100644 index 00000000..49432d3a --- /dev/null +++ b/BigNumberUtil_8h_source.html @@ -0,0 +1,150 @@ + + + + + + +ArduinoLibs: BigNumberUtil.h Source File + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ + +
+
+
+
BigNumberUtil.h
+
+
+
1 /*
+
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
+
3  *
+
4  * Permission is hereby granted, free of charge, to any person obtaining a
+
5  * copy of this software and associated documentation files (the "Software"),
+
6  * to deal in the Software without restriction, including without limitation
+
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+
8  * and/or sell copies of the Software, and to permit persons to whom the
+
9  * Software is furnished to do so, subject to the following conditions:
+
10  *
+
11  * The above copyright notice and this permission notice shall be included
+
12  * in all copies or substantial portions of the Software.
+
13  *
+
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+
20  * DEALINGS IN THE SOFTWARE.
+
21  */
+
22 
+
23 #ifndef CRYPTO_BIGNUMBERUTIL_h
+
24 #define CRYPTO_BIGNUMBERUTIL_h
+
25 
+
26 #include <inttypes.h>
+
27 
+
28 // Define exactly one of these to 1 to set the size of the basic limb type.
+
29 // 16-bit limbs seem to give the best performance on 8-bit AVR micros.
+
30 #define BIGNUMBER_LIMB_8BIT 0
+
31 #define BIGNUMBER_LIMB_16BIT 1
+
32 #define BIGNUMBER_LIMB_32BIT 0
+
33 
+
34 // Define the limb types to use on this platform.
+
35 #if BIGNUMBER_LIMB_8BIT
+
36 typedef uint8_t limb_t;
+
37 typedef int8_t slimb_t;
+
38 typedef uint16_t dlimb_t;
+
39 #elif BIGNUMBER_LIMB_16BIT
+
40 typedef uint16_t limb_t;
+
41 typedef int16_t slimb_t;
+
42 typedef uint32_t dlimb_t;
+
43 #elif BIGNUMBER_LIMB_32BIT
+
44 typedef uint32_t limb_t;
+
45 typedef int32_t slimb_t;
+
46 typedef uint64_t dlimb_t;
+
47 #else
+
48 #error "limb_t must be 8, 16, or 32 bits in size"
+
49 #endif
+
50 
+
51 #endif
+
+ +
+Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/Bitmap_8cpp_source.html b/Bitmap_8cpp_source.html index a620e45e..f0b222bc 100644 --- a/Bitmap_8cpp_source.html +++ b/Bitmap_8cpp_source.html @@ -694,7 +694,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Bitmap_8h_source.html b/Bitmap_8h_source.html index bb395881..2dbdcb97 100644 --- a/Bitmap_8h_source.html +++ b/Bitmap_8h_source.html @@ -271,7 +271,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/BlinkLED_8cpp_source.html b/BlinkLED_8cpp_source.html index db448774..6f5ea165 100644 --- a/BlinkLED_8cpp_source.html +++ b/BlinkLED_8cpp_source.html @@ -196,7 +196,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/BlinkLED_8h_source.html b/BlinkLED_8h_source.html index d8254cd5..7a5270f3 100644 --- a/BlinkLED_8h_source.html +++ b/BlinkLED_8h_source.html @@ -157,7 +157,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/BlockCipher_8cpp_source.html b/BlockCipher_8cpp_source.html index b8ab6afe..ff6f35cc 100644 --- a/BlockCipher_8cpp_source.html +++ b/BlockCipher_8cpp_source.html @@ -125,7 +125,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/BlockCipher_8h_source.html b/BlockCipher_8h_source.html index 1e4b0d48..fd30d940 100644 --- a/BlockCipher_8h_source.html +++ b/BlockCipher_8h_source.html @@ -146,7 +146,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/BoolField_8cpp_source.html b/BoolField_8cpp_source.html index eff165b5..d6307f93 100644 --- a/BoolField_8cpp_source.html +++ b/BoolField_8cpp_source.html @@ -202,7 +202,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/BoolField_8h_source.html b/BoolField_8h_source.html index 4c824cf6..20fcaf90 100644 --- a/BoolField_8h_source.html +++ b/BoolField_8h_source.html @@ -160,7 +160,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/CBC_8cpp_source.html b/CBC_8cpp_source.html index 3fefdb1a..dd51ab1b 100644 --- a/CBC_8cpp_source.html +++ b/CBC_8cpp_source.html @@ -208,7 +208,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/CBC_8h_source.html b/CBC_8h_source.html index 6b9afb27..7f9b3eff 100644 --- a/CBC_8h_source.html +++ b/CBC_8h_source.html @@ -172,7 +172,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/CFB_8cpp_source.html b/CFB_8cpp_source.html index 05c34b7f..962e2e83 100644 --- a/CFB_8cpp_source.html +++ b/CFB_8cpp_source.html @@ -233,7 +233,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/CFB_8h_source.html b/CFB_8h_source.html index 23e7b2a4..e15822c1 100644 --- a/CFB_8h_source.html +++ b/CFB_8h_source.html @@ -171,7 +171,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/CTR_8cpp_source.html b/CTR_8cpp_source.html index e4638bfe..4048f2bd 100644 --- a/CTR_8cpp_source.html +++ b/CTR_8cpp_source.html @@ -228,7 +228,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/CTR_8h_source.html b/CTR_8h_source.html index b80913ce..5f9c66a9 100644 --- a/CTR_8h_source.html +++ b/CTR_8h_source.html @@ -175,7 +175,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/ChaChaPoly_8cpp_source.html b/ChaChaPoly_8cpp_source.html new file mode 100644 index 00000000..f46de203 --- /dev/null +++ b/ChaChaPoly_8cpp_source.html @@ -0,0 +1,270 @@ + + + + + + +ArduinoLibs: ChaChaPoly.cpp Source File + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ + +
+
+
+
ChaChaPoly.cpp
+
+
+
1 /*
+
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
+
3  *
+
4  * Permission is hereby granted, free of charge, to any person obtaining a
+
5  * copy of this software and associated documentation files (the "Software"),
+
6  * to deal in the Software without restriction, including without limitation
+
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+
8  * and/or sell copies of the Software, and to permit persons to whom the
+
9  * Software is furnished to do so, subject to the following conditions:
+
10  *
+
11  * The above copyright notice and this permission notice shall be included
+
12  * in all copies or substantial portions of the Software.
+
13  *
+
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+
20  * DEALINGS IN THE SOFTWARE.
+
21  */
+
22 
+
23 #include "ChaChaPoly.h"
+
24 #include "Crypto.h"
+
25 #include "utility/EndianUtil.h"
+
26 #include <string.h>
+
27 
+
45 ChaChaPoly::ChaChaPoly()
+
46 {
+
47  state.authSize = 0;
+
48  state.dataSize = 0;
+
49  state.dataStarted = false;
+
50  state.ivSize = 8;
+
51 }
+
52 
+
56 ChaChaPoly::~ChaChaPoly()
+
57 {
+
58  clean(state);
+
59 }
+
60 
+
61 size_t ChaChaPoly::keySize() const
+
62 {
+
63  // Default key size is 256-bit, but any key size is allowed.
+
64  return 32;
+
65 }
+
66 
+
67 size_t ChaChaPoly::ivSize() const
+
68 {
+
69  // Return 8 but we also support 12-byte nonces in setIV().
+
70  return 8;
+
71 }
+
72 
+
73 size_t ChaChaPoly::tagSize() const
+
74 {
+
75  // Any tag size between 1 and 16 is supported.
+
76  return 16;
+
77 }
+
78 
+
79 bool ChaChaPoly::setKey(const uint8_t *key, size_t len)
+
80 {
+
81  return chacha.setKey(key, len);
+
82 }
+
83 
+
84 bool ChaChaPoly::setIV(const uint8_t *iv, size_t len)
+
85 {
+
86  // ChaCha::setIV() supports both 64-bit and 96-bit nonces.
+
87  if (!chacha.setIV(iv, len))
+
88  return false;
+
89 
+
90  // Generate the key and nonce to use for Poly1305.
+
91  uint32_t data[16];
+
92  chacha.keystreamBlock(data);
+
93  poly1305.reset(data);
+
94  memcpy(state.nonce, data + 4, 16);
+
95  clean(data);
+
96 
+
97  // Reset the size counters for the auth data and payload.
+
98  state.authSize = 0;
+
99  state.dataSize = 0;
+
100  state.dataStarted = false;
+
101  state.ivSize = len;
+
102 }
+
103 
+
104 void ChaChaPoly::encrypt(uint8_t *output, const uint8_t *input, size_t len)
+
105 {
+
106  if (!state.dataStarted) {
+
107  poly1305.pad();
+
108  state.dataStarted = true;
+
109  }
+
110  chacha.encrypt(output, input, len);
+
111  poly1305.update(output, len);
+
112  state.dataSize += len;
+
113 }
+
114 
+
115 void ChaChaPoly::decrypt(uint8_t *output, const uint8_t *input, size_t len)
+
116 {
+
117  if (!state.dataStarted) {
+
118  poly1305.pad();
+
119  state.dataStarted = true;
+
120  }
+
121  poly1305.update(input, len);
+
122  chacha.encrypt(output, input, len); // encrypt() is the same as decrypt()
+
123  state.dataSize += len;
+
124 }
+
125 
+
126 void ChaChaPoly::addAuthData(const void *data, size_t len)
+
127 {
+
128  if (!state.dataStarted) {
+
129  poly1305.update(data, len);
+
130  state.authSize += len;
+
131  }
+
132 }
+
133 
+
134 void ChaChaPoly::computeTag(void *tag, size_t len)
+
135 {
+
136  uint64_t sizes[2];
+
137 
+
138  // Pad the final Poly1305 block and then hash the sizes.
+
139  poly1305.pad();
+
140  sizes[0] = htole64(state.authSize);
+
141  sizes[1] = htole64(state.dataSize);
+
142  poly1305.update(sizes, sizeof(sizes));
+
143 
+
144  // Compute the tag and copy it to the return buffer.
+
145  poly1305.finalize(state.nonce, tag, len);
+
146  clean(sizes);
+
147 }
+
148 
+
149 bool ChaChaPoly::checkTag(const void *tag, size_t len)
+
150 {
+
151  // Can never match if the expected tag length is too long.
+
152  if (len > 16)
+
153  return false;
+
154 
+
155  // Compute the tag and check it.
+
156  uint8_t temp[16];
+
157  computeTag(temp, len);
+
158  bool equal = secure_compare(temp, tag, len);
+
159  clean(temp);
+
160  return equal;
+
161 }
+
162 
+
163 void ChaChaPoly::clear()
+
164 {
+
165  chacha.clear();
+
166  poly1305.clear();
+
167  clean(state);
+
168  state.ivSize = 8;
+
169 }
+
Poly1305::finalize
void finalize(const void *nonce, void *token, size_t len)
Finalizes the authentication process and returns the token.
Definition: Poly1305.cpp:180
+
Poly1305::reset
void reset(const void *key)
Resets the Poly1305 message authenticator for a new session.
Definition: Poly1305.cpp:111
+
ChaCha::setKey
bool setKey(const uint8_t *key, size_t len)
Sets the key to use for future encryption and decryption operations.
Definition: ChaCha.cpp:87
+
ChaChaPoly::~ChaChaPoly
virtual ~ChaChaPoly()
Destroys this ChaChaPoly authenticated cipher.
Definition: ChaChaPoly.cpp:56
+
ChaChaPoly::tagSize
size_t tagSize() const
Returns the size of the authentication tag.
Definition: ChaChaPoly.cpp:73
+
ChaCha::setIV
bool setIV(const uint8_t *iv, size_t len)
Sets the initialization vector to use for future encryption and decryption operations.
Definition: ChaCha.cpp:111
+
ChaChaPoly::setIV
bool setIV(const uint8_t *iv, size_t len)
Sets the initialization vector to use for future encryption and decryption operations.
Definition: ChaChaPoly.cpp:84
+
ChaChaPoly::keySize
size_t keySize() const
Default size of the key for this cipher, in bytes.
Definition: ChaChaPoly.cpp:61
+
ChaChaPoly::computeTag
void computeTag(void *tag, size_t len)
Finalizes the encryption process and computes the authentication tag.
Definition: ChaChaPoly.cpp:134
+
ChaChaPoly::ChaChaPoly
ChaChaPoly()
Constructs a new ChaChaPoly authenticated cipher.
Definition: ChaChaPoly.cpp:45
+
ChaCha::encrypt
void encrypt(uint8_t *output, const uint8_t *input, size_t len)
Encrypts an input buffer and writes the ciphertext to an output buffer.
Definition: ChaCha.cpp:158
+
ChaChaPoly::addAuthData
void addAuthData(const void *data, size_t len)
Adds extra data that will be authenticated but not encrypted.
Definition: ChaChaPoly.cpp:126
+
ChaChaPoly::encrypt
void encrypt(uint8_t *output, const uint8_t *input, size_t len)
Encrypts an input buffer and writes the ciphertext to an output buffer.
Definition: ChaChaPoly.cpp:104
+
ChaChaPoly::ivSize
size_t ivSize() const
Size of the initialization vector for this cipher, in bytes.
+
Poly1305::update
void update(const void *data, size_t len)
Updates the message authenticator with more data.
Definition: Poly1305.cpp:143
+
ChaCha::clear
void clear()
Clears all security-sensitive state from this cipher.
Definition: ChaCha.cpp:218
+
ChaChaPoly::clear
void clear()
Clears all security-sensitive state from this cipher.
Definition: ChaChaPoly.cpp:163
+
ChaChaPoly::decrypt
void decrypt(uint8_t *output, const uint8_t *input, size_t len)
Decrypts an input buffer and writes the plaintext to an output buffer.
Definition: ChaChaPoly.cpp:115
+
Poly1305::pad
void pad()
Pads the input stream with zero bytes to a multiple of 16.
Definition: Poly1305.cpp:251
+
Poly1305::clear
void clear()
Clears the authenticator's state, removing all sensitive data.
Definition: Poly1305.cpp:265
+
ChaChaPoly::setKey
bool setKey(const uint8_t *key, size_t len)
Sets the key to use for future encryption and decryption operations.
Definition: ChaChaPoly.cpp:79
+
ChaChaPoly::checkTag
bool checkTag(const void *tag, size_t len)
Finalizes the decryption process and checks the authentication tag.
Definition: ChaChaPoly.cpp:149
+
+ +
+Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/ChaChaPoly_8h_source.html b/ChaChaPoly_8h_source.html new file mode 100644 index 00000000..f14eea2f --- /dev/null +++ b/ChaChaPoly_8h_source.html @@ -0,0 +1,181 @@ + + + + + + +ArduinoLibs: ChaChaPoly.h Source File + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ + +
+
+
+
ChaChaPoly.h
+
+
+
1 /*
+
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
+
3  *
+
4  * Permission is hereby granted, free of charge, to any person obtaining a
+
5  * copy of this software and associated documentation files (the "Software"),
+
6  * to deal in the Software without restriction, including without limitation
+
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+
8  * and/or sell copies of the Software, and to permit persons to whom the
+
9  * Software is furnished to do so, subject to the following conditions:
+
10  *
+
11  * The above copyright notice and this permission notice shall be included
+
12  * in all copies or substantial portions of the Software.
+
13  *
+
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+
20  * DEALINGS IN THE SOFTWARE.
+
21  */
+
22 
+
23 #ifndef CRYPTO_CHACHAPOLY_H
+
24 #define CRYPTO_CHACHAPOLY_H
+
25 
+
26 #include "AuthenticatedCipher.h"
+
27 #include "ChaCha.h"
+
28 #include "Poly1305.h"
+
29 
+
30 class ChaChaPoly : public AuthenticatedCipher
+
31 {
+
32 public:
+
33  ChaChaPoly();
+
34  virtual ~ChaChaPoly();
+
35 
+
36  size_t keySize() const;
+
37  size_t ivSize() const;
+
38  size_t tagSize() const;
+
39 
+
40  bool setKey(const uint8_t *key, size_t len);
+
41  bool setIV(const uint8_t *iv, size_t len);
+
42 
+
43  void encrypt(uint8_t *output, const uint8_t *input, size_t len);
+
44  void decrypt(uint8_t *output, const uint8_t *input, size_t len);
+
45 
+
46  void addAuthData(const void *data, size_t len);
+
47 
+
48  void computeTag(void *tag, size_t len);
+
49  bool checkTag(const void *tag, size_t len);
+
50 
+
51  void clear();
+
52 
+
53 private:
+
54  ChaCha chacha;
+
55  Poly1305 poly1305;
+
56  struct {
+
57  uint8_t nonce[16];
+
58  uint64_t authSize;
+
59  uint64_t dataSize;
+
60  bool dataStarted;
+
61  uint8_t ivSize;
+
62  } state;
+
63 };
+
64 
+
65 #endif
+
Poly1305
Poly1305 message authenticator.
Definition: Poly1305.h:29
+
ChaChaPoly
Authenticated cipher based on ChaCha and Poly1305.
Definition: ChaChaPoly.h:30
+
ChaCha
ChaCha stream cipher.
Definition: ChaCha.h:30
+
ChaChaPoly::~ChaChaPoly
virtual ~ChaChaPoly()
Destroys this ChaChaPoly authenticated cipher.
Definition: ChaChaPoly.cpp:56
+
ChaChaPoly::tagSize
size_t tagSize() const
Returns the size of the authentication tag.
Definition: ChaChaPoly.cpp:73
+
AuthenticatedCipher
Abstract base class for authenticated ciphers.
Definition: AuthenticatedCipher.h:28
+
ChaChaPoly::setIV
bool setIV(const uint8_t *iv, size_t len)
Sets the initialization vector to use for future encryption and decryption operations.
Definition: ChaChaPoly.cpp:84
+
ChaChaPoly::keySize
size_t keySize() const
Default size of the key for this cipher, in bytes.
Definition: ChaChaPoly.cpp:61
+
ChaChaPoly::computeTag
void computeTag(void *tag, size_t len)
Finalizes the encryption process and computes the authentication tag.
Definition: ChaChaPoly.cpp:134
+
ChaChaPoly::ChaChaPoly
ChaChaPoly()
Constructs a new ChaChaPoly authenticated cipher.
Definition: ChaChaPoly.cpp:45
+
ChaChaPoly::addAuthData
void addAuthData(const void *data, size_t len)
Adds extra data that will be authenticated but not encrypted.
Definition: ChaChaPoly.cpp:126
+
ChaChaPoly::encrypt
void encrypt(uint8_t *output, const uint8_t *input, size_t len)
Encrypts an input buffer and writes the ciphertext to an output buffer.
Definition: ChaChaPoly.cpp:104
+
ChaChaPoly::ivSize
size_t ivSize() const
Size of the initialization vector for this cipher, in bytes.
+
ChaChaPoly::clear
void clear()
Clears all security-sensitive state from this cipher.
Definition: ChaChaPoly.cpp:163
+
ChaChaPoly::decrypt
void decrypt(uint8_t *output, const uint8_t *input, size_t len)
Decrypts an input buffer and writes the plaintext to an output buffer.
Definition: ChaChaPoly.cpp:115
+
ChaChaPoly::setKey
bool setKey(const uint8_t *key, size_t len)
Sets the key to use for future encryption and decryption operations.
Definition: ChaChaPoly.cpp:79
+
ChaChaPoly::checkTag
bool checkTag(const void *tag, size_t len)
Finalizes the decryption process and checks the authentication tag.
Definition: ChaChaPoly.cpp:149
+
+ +
+Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/ChaCha_8cpp_source.html b/ChaCha_8cpp_source.html index 89695b7d..5fbb47ee 100644 --- a/ChaCha_8cpp_source.html +++ b/ChaCha_8cpp_source.html @@ -167,7 +167,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
110 
111 bool ChaCha::setIV(const uint8_t *iv, size_t len)
112 {
-
113  // From draft-nir-cfrg-chacha20-poly1305-04.txt, we can use either
+
113  // From draft-nir-cfrg-chacha20-poly1305-10.txt, we can use either
114  // 64-bit or 96-bit nonces. The 96-bit nonce consists of the high
115  // word of the counter prepended to a regular 64-bit nonce for ChaCha.
116  if (len == 8) {
@@ -235,58 +235,69 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
192  encrypt(output, input, len);
193 }
194 
-
195 void ChaCha::clear()
-
196 {
-
197  clean(block);
-
198  clean(stream);
-
199  posn = 64;
-
200 }
-
201 
-
202 // Perform a ChaCha quarter round operation.
-
203 #define quarterRound(a, b, c, d) \
-
204  do { \
-
205  uint32_t _b = (b); \
-
206  uint32_t _a = (a) + _b; \
-
207  uint32_t _d = leftRotate((d) ^ _a, 16); \
-
208  uint32_t _c = (c) + _d; \
-
209  _b = leftRotate12(_b ^ _c); \
-
210  _a += _b; \
-
211  (d) = _d = leftRotate(_d ^ _a, 8); \
-
212  _c += _d; \
-
213  (a) = _a; \
-
214  (b) = leftRotate7(_b ^ _c); \
-
215  (c) = _c; \
-
216  } while (0)
-
217 
-
230 void ChaCha::hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds)
-
231 {
-
232  uint8_t posn;
-
233 
-
234  // Copy the input buffer to the output prior to the first round
-
235  // and convert from little-endian to host byte order.
-
236  for (posn = 0; posn < 16; ++posn)
-
237  output[posn] = le32toh(input[posn]);
-
238 
-
239  // Perform the ChaCha rounds in sets of two.
-
240  for (; rounds >= 2; rounds -= 2) {
-
241  // Column round.
-
242  quarterRound(output[0], output[4], output[8], output[12]);
-
243  quarterRound(output[1], output[5], output[9], output[13]);
-
244  quarterRound(output[2], output[6], output[10], output[14]);
-
245  quarterRound(output[3], output[7], output[11], output[15]);
-
246 
-
247  // Diagonal round.
-
248  quarterRound(output[0], output[5], output[10], output[15]);
-
249  quarterRound(output[1], output[6], output[11], output[12]);
-
250  quarterRound(output[2], output[7], output[8], output[13]);
-
251  quarterRound(output[3], output[4], output[9], output[14]);
-
252  }
-
253 
-
254  // Add the original input to the final output, convert back to
-
255  // little-endian, and return the result.
-
256  for (posn = 0; posn < 16; ++posn)
-
257  output[posn] = htole32(output[posn] + le32toh(input[posn]));
-
258 }
+
207 void ChaCha::keystreamBlock(uint32_t *output)
+
208 {
+
209  // Generate the hash output directly into the caller-supplied buffer.
+
210  hashCore(output, (const uint32_t *)block, rounds);
+
211  posn = 64;
+
212 
+
213  // Increment the lowest counter byte. We are assuming that the caller
+
214  // is ChaChaPoly::setKey() and that the previous counter value was zero.
+
215  block[48] = 1;
+
216 }
+
217 
+
218 void ChaCha::clear()
+
219 {
+
220  clean(block);
+
221  clean(stream);
+
222  posn = 64;
+
223 }
+
224 
+
225 // Perform a ChaCha quarter round operation.
+
226 #define quarterRound(a, b, c, d) \
+
227  do { \
+
228  uint32_t _b = (b); \
+
229  uint32_t _a = (a) + _b; \
+
230  uint32_t _d = leftRotate((d) ^ _a, 16); \
+
231  uint32_t _c = (c) + _d; \
+
232  _b = leftRotate12(_b ^ _c); \
+
233  _a += _b; \
+
234  (d) = _d = leftRotate(_d ^ _a, 8); \
+
235  _c += _d; \
+
236  (a) = _a; \
+
237  (b) = leftRotate7(_b ^ _c); \
+
238  (c) = _c; \
+
239  } while (0)
+
240 
+
253 void ChaCha::hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds)
+
254 {
+
255  uint8_t posn;
+
256 
+
257  // Copy the input buffer to the output prior to the first round
+
258  // and convert from little-endian to host byte order.
+
259  for (posn = 0; posn < 16; ++posn)
+
260  output[posn] = le32toh(input[posn]);
+
261 
+
262  // Perform the ChaCha rounds in sets of two.
+
263  for (; rounds >= 2; rounds -= 2) {
+
264  // Column round.
+
265  quarterRound(output[0], output[4], output[8], output[12]);
+
266  quarterRound(output[1], output[5], output[9], output[13]);
+
267  quarterRound(output[2], output[6], output[10], output[14]);
+
268  quarterRound(output[3], output[7], output[11], output[15]);
+
269 
+
270  // Diagonal round.
+
271  quarterRound(output[0], output[5], output[10], output[15]);
+
272  quarterRound(output[1], output[6], output[11], output[12]);
+
273  quarterRound(output[2], output[7], output[8], output[13]);
+
274  quarterRound(output[3], output[4], output[9], output[14]);
+
275  }
+
276 
+
277  // Add the original input to the final output, convert back to
+
278  // little-endian, and return the result.
+
279  for (posn = 0; posn < 16; ++posn)
+
280  output[posn] = htole32(output[posn] + le32toh(input[posn]));
+
281 }
ChaCha::ivSize
size_t ivSize() const
Size of the initialization vector for this cipher, in bytes.
Definition: ChaCha.cpp:65
ChaCha::setKey
bool setKey(const uint8_t *key, size_t len)
Sets the key to use for future encryption and decryption operations.
Definition: ChaCha.cpp:87
ChaCha::keySize
size_t keySize() const
Default size of the key for this cipher, in bytes.
Definition: ChaCha.cpp:59
@@ -295,12 +306,12 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
ChaCha::ChaCha
ChaCha(uint8_t numRounds=20)
Constructs a new ChaCha stream cipher.
Definition: ChaCha.cpp:47
ChaCha::decrypt
void decrypt(uint8_t *output, const uint8_t *input, size_t len)
Decrypts an input buffer and writes the plaintext to an output buffer.
Definition: ChaCha.cpp:190
ChaCha::encrypt
void encrypt(uint8_t *output, const uint8_t *input, size_t len)
Encrypts an input buffer and writes the ciphertext to an output buffer.
Definition: ChaCha.cpp:158
-
ChaCha::clear
void clear()
Clears all security-sensitive state from this cipher.
Definition: ChaCha.cpp:195
-
ChaCha::hashCore
static void hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds)
Executes the ChaCha hash core on an input memory block.
Definition: ChaCha.cpp:230
+
ChaCha::clear
void clear()
Clears all security-sensitive state from this cipher.
Definition: ChaCha.cpp:218
+
ChaCha::hashCore
static void hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds)
Executes the ChaCha hash core on an input memory block.
Definition: ChaCha.cpp:253
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/ChaCha_8h_source.html b/ChaCha_8h_source.html index 816fcb8a..f1f7c22a 100644 --- a/ChaCha_8h_source.html +++ b/ChaCha_8h_source.html @@ -115,55 +115,62 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
25 
26 #include "Cipher.h"
27 
-
28 class ChaCha : public Cipher
-
29 {
-
30 public:
-
31  explicit ChaCha(uint8_t numRounds = 20);
-
32  virtual ~ChaCha();
-
33 
-
34  size_t keySize() const;
-
35  size_t ivSize() const;
-
36 
-
37  uint8_t numRounds() const { return rounds; }
-
38  void setNumRounds(uint8_t numRounds) { rounds = numRounds; }
-
39 
-
40  bool setKey(const uint8_t *key, size_t len);
-
41  bool setIV(const uint8_t *iv, size_t len);
-
42  bool setCounter(const uint8_t *counter, size_t len);
-
43 
-
44  void encrypt(uint8_t *output, const uint8_t *input, size_t len);
-
45  void decrypt(uint8_t *output, const uint8_t *input, size_t len);
-
46 
-
47  void clear();
+
28 class ChaChaPoly;
+
29 
+
30 class ChaCha : public Cipher
+
31 {
+
32 public:
+
33  explicit ChaCha(uint8_t numRounds = 20);
+
34  virtual ~ChaCha();
+
35 
+
36  size_t keySize() const;
+
37  size_t ivSize() const;
+
38 
+
39  uint8_t numRounds() const { return rounds; }
+
40  void setNumRounds(uint8_t numRounds) { rounds = numRounds; }
+
41 
+
42  bool setKey(const uint8_t *key, size_t len);
+
43  bool setIV(const uint8_t *iv, size_t len);
+
44  bool setCounter(const uint8_t *counter, size_t len);
+
45 
+
46  void encrypt(uint8_t *output, const uint8_t *input, size_t len);
+
47  void decrypt(uint8_t *output, const uint8_t *input, size_t len);
48 
-
49  static void hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds);
+
49  void clear();
50 
-
51 private:
-
52  uint8_t block[64];
-
53  uint8_t stream[64];
-
54  uint8_t rounds;
-
55  uint8_t posn;
-
56 };
-
57 
-
58 #endif
+
51  static void hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds);
+
52 
+
53 private:
+
54  uint8_t block[64];
+
55  uint8_t stream[64];
+
56  uint8_t rounds;
+
57  uint8_t posn;
+
58 
+
59  void keystreamBlock(uint32_t *output);
+
60 
+
61  friend class ChaChaPoly;
+
62 };
+
63 
+
64 #endif
Cipher
Abstract base class for stream ciphers.
Definition: Cipher.h:29
ChaCha::ivSize
size_t ivSize() const
Size of the initialization vector for this cipher, in bytes.
Definition: ChaCha.cpp:65
+
ChaChaPoly
Authenticated cipher based on ChaCha and Poly1305.
Definition: ChaChaPoly.h:30
ChaCha::setKey
bool setKey(const uint8_t *key, size_t len)
Sets the key to use for future encryption and decryption operations.
Definition: ChaCha.cpp:87
-
ChaCha
ChaCha stream cipher.
Definition: ChaCha.h:28
+
ChaCha
ChaCha stream cipher.
Definition: ChaCha.h:30
ChaCha::keySize
size_t keySize() const
Default size of the key for this cipher, in bytes.
Definition: ChaCha.cpp:59
ChaCha::setIV
bool setIV(const uint8_t *iv, size_t len)
Sets the initialization vector to use for future encryption and decryption operations.
Definition: ChaCha.cpp:111
ChaCha::setCounter
bool setCounter(const uint8_t *counter, size_t len)
Sets the starting counter for encryption.
Definition: ChaCha.cpp:145
ChaCha::ChaCha
ChaCha(uint8_t numRounds=20)
Constructs a new ChaCha stream cipher.
Definition: ChaCha.cpp:47
ChaCha::decrypt
void decrypt(uint8_t *output, const uint8_t *input, size_t len)
Decrypts an input buffer and writes the plaintext to an output buffer.
Definition: ChaCha.cpp:190
ChaCha::encrypt
void encrypt(uint8_t *output, const uint8_t *input, size_t len)
Encrypts an input buffer and writes the ciphertext to an output buffer.
Definition: ChaCha.cpp:158
-
ChaCha::clear
void clear()
Clears all security-sensitive state from this cipher.
Definition: ChaCha.cpp:195
-
ChaCha::numRounds
uint8_t numRounds() const
Returns the number of encryption rounds; usually 8, 12, or 20.
Definition: ChaCha.h:37
-
ChaCha::setNumRounds
void setNumRounds(uint8_t numRounds)
Sets the number of encryption rounds.
Definition: ChaCha.h:38
-
ChaCha::hashCore
static void hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds)
Executes the ChaCha hash core on an input memory block.
Definition: ChaCha.cpp:230
+
ChaCha::clear
void clear()
Clears all security-sensitive state from this cipher.
Definition: ChaCha.cpp:218
+
ChaCha::numRounds
uint8_t numRounds() const
Returns the number of encryption rounds; usually 8, 12, or 20.
Definition: ChaCha.h:39
+
ChaCha::setNumRounds
void setNumRounds(uint8_t numRounds)
Sets the number of encryption rounds.
Definition: ChaCha.h:40
+
ChaCha::hashCore
static void hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds)
Executes the ChaCha hash core on an input memory block.
Definition: ChaCha.cpp:253
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Charlieplex_8cpp_source.html b/Charlieplex_8cpp_source.html index 1a194c1d..51028988 100644 --- a/Charlieplex_8cpp_source.html +++ b/Charlieplex_8cpp_source.html @@ -232,7 +232,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Charlieplex_8h_source.html b/Charlieplex_8h_source.html index 7bb95ee5..bcf4a749 100644 --- a/Charlieplex_8h_source.html +++ b/Charlieplex_8h_source.html @@ -162,7 +162,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/ChaseLEDs_8cpp_source.html b/ChaseLEDs_8cpp_source.html index 741dc1e6..c347ea17 100644 --- a/ChaseLEDs_8cpp_source.html +++ b/ChaseLEDs_8cpp_source.html @@ -160,7 +160,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/ChaseLEDs_8h_source.html b/ChaseLEDs_8h_source.html index 47502fd5..ae950a44 100644 --- a/ChaseLEDs_8h_source.html +++ b/ChaseLEDs_8h_source.html @@ -149,7 +149,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Cipher_8cpp_source.html b/Cipher_8cpp_source.html index 12b88722..007fdadb 100644 --- a/Cipher_8cpp_source.html +++ b/Cipher_8cpp_source.html @@ -125,7 +125,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Cipher_8h_source.html b/Cipher_8h_source.html index ca4be790..3bc1ff82 100644 --- a/Cipher_8h_source.html +++ b/Cipher_8h_source.html @@ -148,7 +148,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Crypto_8cpp_source.html b/Crypto_8cpp_source.html index 04e25b1c..1d23e9c5 100644 --- a/Crypto_8cpp_source.html +++ b/Crypto_8cpp_source.html @@ -124,10 +124,21 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
43  }
44 }
45 
+
69 bool secure_compare(const void *data1, const void *data2, size_t len)
+
70 {
+
71  uint8_t result = 0;
+
72  const uint8_t *d1 = (const uint8_t *)data1;
+
73  const uint8_t *d2 = (const uint8_t *)data2;
+
74  while (len > 0) {
+
75  result |= (*d1++ ^ *d2++);
+
76  --len;
+
77  }
+
78  return (bool)((((uint16_t)0x0100) - result) >> 8);
+
79 }
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Crypto_8h_source.html b/Crypto_8h_source.html index 65778d76..18372f24 100644 --- a/Crypto_8h_source.html +++ b/Crypto_8h_source.html @@ -124,11 +124,13 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
34  clean(&var, sizeof(T));
35 }
36 
-
37 #endif
+
37 bool secure_compare(const void *data1, const void *data2, size_t len);
+
38 
+
39 #endif
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:09 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Curve25519_8cpp_source.html b/Curve25519_8cpp_source.html index 2f39397a..a52e6431 100644 --- a/Curve25519_8cpp_source.html +++ b/Curve25519_8cpp_source.html @@ -436,7 +436,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
455  }
456 }
457 
-
471 Curve25519::limb_t Curve25519::reduceQuick(limb_t *x)
+
471 limb_t Curve25519::reduceQuick(limb_t *x)
472 {
473  limb_t temp[NUM_LIMBS];
474  dlimb_t carry;
@@ -509,13 +509,13 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
570 void Curve25519::mulA24(limb_t *result, const limb_t *x)
571 {
572  // The constant a24 = 121665 (0x1DB41) as a limb array.
-
573 #if CURVE25519_LIMB_8BIT
+
573 #if BIGNUMBER_LIMB_8BIT
574  static limb_t const a24[3] PROGMEM = {0x41, 0xDB, 0x01};
575  #define pgm_read_a24(index) (pgm_read_byte(&(a24[(index)])))
-
576 #elif CURVE25519_LIMB_16BIT
+
576 #elif BIGNUMBER_LIMB_16BIT
577  static limb_t const a24[2] PROGMEM = {0xDB41, 0x0001};
578  #define pgm_read_a24(index) (pgm_read_word(&(a24[(index)])))
-
579 #elif CURVE25519_LIMB_32BIT
+
579 #elif BIGNUMBER_LIMB_32BIT
580  static limb_t const a24[1] PROGMEM = {0x0001DB41};
581  #define pgm_read_a24(index) (pgm_read_dword(&(a24[(index)])))
582 #else
@@ -671,15 +671,15 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
769 
782 void Curve25519::unpack(limb_t *result, const uint8_t *x)
783 {
-
784 #if CURVE25519_LIMB_8BIT
+
784 #if BIGNUMBER_LIMB_8BIT
785  memcpy(result, x, 32);
786  result[31] &= 0x7F;
-
787 #elif CURVE25519_LIMB_16BIT
+
787 #elif BIGNUMBER_LIMB_16BIT
788  for (uint8_t posn = 0; posn < 16; ++posn) {
789  result[posn] = ((limb_t)x[posn * 2]) | (((limb_t)x[posn * 2 + 1]) << 8);
790  }
791  result[15] &= 0x7FFF;
-
792 #elif CURVE25519_LIMB_32BIT
+
792 #elif BIGNUMBER_LIMB_32BIT
793  for (uint8_t posn = 0; posn < 8; ++posn) {
794  result[posn] = ((limb_t)x[posn * 4]) |
795  (((limb_t)x[posn * 4 + 1]) << 8) |
@@ -692,15 +692,15 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
802 
812 void Curve25519::pack(uint8_t *result, const limb_t *x)
813 {
-
814 #if CURVE25519_LIMB_8BIT
+
814 #if BIGNUMBER_LIMB_8BIT
815  memcpy(result, x, 32);
-
816 #elif CURVE25519_LIMB_16BIT
+
816 #elif BIGNUMBER_LIMB_16BIT
817  for (uint8_t posn = 0; posn < 16; ++posn) {
818  limb_t value = x[posn];
819  result[posn * 2] = (uint8_t)value;
820  result[posn * 2 + 1] = (uint8_t)(value >> 8);
821  }
-
822 #elif CURVE25519_LIMB_32BIT
+
822 #elif BIGNUMBER_LIMB_32BIT
823  for (uint8_t posn = 0; posn < 8; ++posn) {
824  limb_t value = x[posn];
825  result[posn * 4] = (uint8_t)value;
@@ -717,7 +717,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Curve25519_8h_source.html b/Curve25519_8h_source.html index 666d9963..c0d68bb4 100644 --- a/Curve25519_8h_source.html +++ b/Curve25519_8h_source.html @@ -113,82 +113,59 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
23 #ifndef CRYPTO_CURVE15519_h
24 #define CRYPTO_CURVE15519_h
25 
-
26 #include <inttypes.h>
+
26 #include "BigNumberUtil.h"
27 #include <stddef.h>
28 
-
29 // Define exactly one of these to 1 to set the size of the basic limb type.
-
30 // 16-bit limbs seems to give the best performance on 8-bit AVR micros.
-
31 #define CURVE25519_LIMB_8BIT 0
-
32 #define CURVE25519_LIMB_16BIT 1
-
33 #define CURVE25519_LIMB_32BIT 0
-
34 
-
35 class Curve25519
-
36 {
-
37 public:
-
38  static bool eval(uint8_t result[32], const uint8_t s[32], const uint8_t x[32]);
-
39 
-
40  static void dh1(uint8_t k[32], uint8_t f[32]);
-
41  static bool dh2(uint8_t k[32], uint8_t f[32]);
-
42 
-
43 #if defined(TEST_CURVE25519_FIELD_OPS)
-
44 public:
-
45 #else
-
46 private:
-
47 #endif
-
48  // Define the limb types to use on this platform.
-
49  #if CURVE25519_LIMB_8BIT
-
50  typedef uint8_t limb_t;
-
51  typedef int8_t slimb_t;
-
52  typedef uint16_t dlimb_t;
-
53  #elif CURVE25519_LIMB_16BIT
-
54  typedef uint16_t limb_t;
-
55  typedef int16_t slimb_t;
-
56  typedef uint32_t dlimb_t;
-
57  #elif CURVE25519_LIMB_32BIT
-
58  typedef uint32_t limb_t;
-
59  typedef int32_t slimb_t;
-
60  typedef uint64_t dlimb_t;
-
61  #else
-
62  #error "limb_t must be 8, 16, or 32 bits in size"
-
63  #endif
-
64 
-
65  static uint8_t isWeakPoint(const uint8_t k[32]);
-
66 
-
67  static void reduce(limb_t *result, limb_t *x, uint8_t size);
-
68  static limb_t reduceQuick(limb_t *x);
+
29 class Curve25519
+
30 {
+
31 public:
+
32  static bool eval(uint8_t result[32], const uint8_t s[32], const uint8_t x[32]);
+
33 
+
34  static void dh1(uint8_t k[32], uint8_t f[32]);
+
35  static bool dh2(uint8_t k[32], uint8_t f[32]);
+
36 
+
37 #if defined(TEST_CURVE25519_FIELD_OPS)
+
38 public:
+
39 #else
+
40 private:
+
41 #endif
+
42  static uint8_t isWeakPoint(const uint8_t k[32]);
+
43 
+
44  static void reduce(limb_t *result, limb_t *x, uint8_t size);
+
45  static limb_t reduceQuick(limb_t *x);
+
46 
+
47  static void mul(limb_t *result, const limb_t *x, const limb_t *y);
+
48  static void square(limb_t *result, const limb_t *x)
+
49  {
+
50  mul(result, x, x);
+
51  }
+
52 
+
53  static void mulA24(limb_t *result, const limb_t *x);
+
54 
+
55  static void add(limb_t *result, const limb_t *x, const limb_t *y);
+
56  static void sub(limb_t *result, const limb_t *x, const limb_t *y);
+
57 
+
58  static void cswap(uint8_t select, limb_t *x, limb_t *y);
+
59 
+
60  static void recip(limb_t *result, const limb_t *x);
+
61 
+
62  static void unpack(limb_t *result, const uint8_t *x);
+
63  static void pack(uint8_t *result, const limb_t *x);
+
64 
+
65  // Constructor and destructor are private - cannot instantiate this class.
+
66  Curve25519() {}
+
67  ~Curve25519() {}
+
68 };
69 
-
70  static void mul(limb_t *result, const limb_t *x, const limb_t *y);
-
71  static void square(limb_t *result, const limb_t *x)
-
72  {
-
73  mul(result, x, x);
-
74  }
-
75 
-
76  static void mulA24(limb_t *result, const limb_t *x);
-
77 
-
78  static void add(limb_t *result, const limb_t *x, const limb_t *y);
-
79  static void sub(limb_t *result, const limb_t *x, const limb_t *y);
-
80 
-
81  static void cswap(uint8_t select, limb_t *x, limb_t *y);
-
82 
-
83  static void recip(limb_t *result, const limb_t *x);
-
84 
-
85  static void unpack(limb_t *result, const uint8_t *x);
-
86  static void pack(uint8_t *result, const limb_t *x);
-
87 
-
88  // Constructor and destructor are private - cannot instantiate this class.
-
89  Curve25519() {}
-
90  ~Curve25519() {}
-
91 };
-
92 
-
93 #endif
-
Curve25519
Diffie-Hellman key agreement based on the elliptic curve modulo 2^255 - 19.
Definition: Curve25519.h:35
+
70 #endif
+
Curve25519
Diffie-Hellman key agreement based on the elliptic curve modulo 2^255 - 19.
Definition: Curve25519.h:29
Curve25519::eval
static bool eval(uint8_t result[32], const uint8_t s[32], const uint8_t x[32])
Evaluates the raw Curve25519 function.
Definition: Curve25519.cpp:68
Curve25519::dh1
static void dh1(uint8_t k[32], uint8_t f[32])
Performs phase 1 of a Diffie-Hellman key exchange using Curve25519.
Definition: Curve25519.cpp:231
Curve25519::dh2
static bool dh2(uint8_t k[32], uint8_t f[32])
Performs phase 2 of a Diffie-Hellman key exchange using Curve25519.
Definition: Curve25519.cpp:269
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/DMD_8cpp_source.html b/DMD_8cpp_source.html index 2e162aad..6fdc0c8c 100644 --- a/DMD_8cpp_source.html +++ b/DMD_8cpp_source.html @@ -456,7 +456,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/DMD_8h_source.html b/DMD_8h_source.html index 69d377a8..d5453676 100644 --- a/DMD_8h_source.html +++ b/DMD_8h_source.html @@ -170,7 +170,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/DS1307RTC_8cpp_source.html b/DS1307RTC_8cpp_source.html index ca0c5dd4..021e3f9e 100644 --- a/DS1307RTC_8cpp_source.html +++ b/DS1307RTC_8cpp_source.html @@ -415,7 +415,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/DS1307RTC_8h_source.html b/DS1307RTC_8h_source.html index 9f11a390..83a7f1ce 100644 --- a/DS1307RTC_8h_source.html +++ b/DS1307RTC_8h_source.html @@ -172,7 +172,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/DS3231RTC_8cpp_source.html b/DS3231RTC_8cpp_source.html index 6338b3b1..2e685b0c 100644 --- a/DS3231RTC_8cpp_source.html +++ b/DS3231RTC_8cpp_source.html @@ -657,7 +657,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/DS3231RTC_8h_source.html b/DS3231RTC_8h_source.html index 7fd6f5c6..b3461ed4 100644 --- a/DS3231RTC_8h_source.html +++ b/DS3231RTC_8h_source.html @@ -202,7 +202,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/DS3232RTC_8cpp_source.html b/DS3232RTC_8cpp_source.html index 3bc62781..6871235d 100644 --- a/DS3232RTC_8cpp_source.html +++ b/DS3232RTC_8cpp_source.html @@ -575,7 +575,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/DS3232RTC_8h_source.html b/DS3232RTC_8h_source.html index 7395d5ac..2c0c6b96 100644 --- a/DS3232RTC_8h_source.html +++ b/DS3232RTC_8h_source.html @@ -190,7 +190,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/DejaVuSans9_8h_source.html b/DejaVuSans9_8h_source.html index 07aebb04..d3944077 100644 --- a/DejaVuSans9_8h_source.html +++ b/DejaVuSans9_8h_source.html @@ -257,7 +257,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/DejaVuSansBold9_8h_source.html b/DejaVuSansBold9_8h_source.html index 58d86e1e..0a1f2de6 100644 --- a/DejaVuSansBold9_8h_source.html +++ b/DejaVuSansBold9_8h_source.html @@ -257,7 +257,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/DejaVuSansItalic9_8h_source.html b/DejaVuSansItalic9_8h_source.html index 86e48a07..48a75b56 100644 --- a/DejaVuSansItalic9_8h_source.html +++ b/DejaVuSansItalic9_8h_source.html @@ -257,7 +257,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/EEPROM24_8cpp_source.html b/EEPROM24_8cpp_source.html index 55769a06..5c310cc8 100644 --- a/EEPROM24_8cpp_source.html +++ b/EEPROM24_8cpp_source.html @@ -282,7 +282,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/EEPROM24_8h_source.html b/EEPROM24_8h_source.html index b392e559..bdfb2e1a 100644 --- a/EEPROM24_8h_source.html +++ b/EEPROM24_8h_source.html @@ -186,7 +186,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Field_8cpp_source.html b/Field_8cpp_source.html index 5e4c2163..45c45368 100644 --- a/Field_8cpp_source.html +++ b/Field_8cpp_source.html @@ -196,7 +196,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Field_8h_source.html b/Field_8h_source.html index d4371255..99cf098c 100644 --- a/Field_8h_source.html +++ b/Field_8h_source.html @@ -164,7 +164,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Form_8cpp_source.html b/Form_8cpp_source.html index 277e056f..e7124f45 100644 --- a/Form_8cpp_source.html +++ b/Form_8cpp_source.html @@ -278,7 +278,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Form_8h_source.html b/Form_8h_source.html index db308ea9..79e59a1d 100644 --- a/Form_8h_source.html +++ b/Form_8h_source.html @@ -172,7 +172,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/GCM_8cpp_source.html b/GCM_8cpp_source.html new file mode 100644 index 00000000..1bcbe7ea --- /dev/null +++ b/GCM_8cpp_source.html @@ -0,0 +1,360 @@ + + + + + + +ArduinoLibs: GCM.cpp Source File + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ + +
+
+
+
GCM.cpp
+
+
+
1 /*
+
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
+
3  *
+
4  * Permission is hereby granted, free of charge, to any person obtaining a
+
5  * copy of this software and associated documentation files (the "Software"),
+
6  * to deal in the Software without restriction, including without limitation
+
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+
8  * and/or sell copies of the Software, and to permit persons to whom the
+
9  * Software is furnished to do so, subject to the following conditions:
+
10  *
+
11  * The above copyright notice and this permission notice shall be included
+
12  * in all copies or substantial portions of the Software.
+
13  *
+
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+
20  * DEALINGS IN THE SOFTWARE.
+
21  */
+
22 
+
23 #include "GCM.h"
+
24 #include "Crypto.h"
+
25 #include "utility/EndianUtil.h"
+
26 #include <string.h>
+
27 
+
44 GCMCommon::GCMCommon()
+
45  : blockCipher(0)
+
46 {
+
47  state.authSize = 0;
+
48  state.dataSize = 0;
+
49  state.dataStarted = false;
+
50  state.posn = 16;
+
51 }
+
52 
+
56 GCMCommon::~GCMCommon()
+
57 {
+
58  clean(state);
+
59 }
+
60 
+
61 size_t GCMCommon::keySize() const
+
62 {
+
63  return blockCipher->keySize();
+
64 }
+
65 
+
66 size_t GCMCommon::ivSize() const
+
67 {
+
68  return 16;
+
69 }
+
70 
+
71 size_t GCMCommon::tagSize() const
+
72 {
+
73  // The GCM specification recommends an IV size of 96 bits.
+
74  return 12;
+
75 }
+
76 
+
77 bool GCMCommon::setKey(const uint8_t *key, size_t len)
+
78 {
+
79  // Set the encryption key for the block cipher.
+
80  if (!blockCipher->setKey(key, len))
+
81  return false;
+
82 
+
83  // Construct the hashing key by encrypting a zero block.
+
84  memset(state.nonce, 0, 16);
+
85  blockCipher->encryptBlock(state.nonce, state.nonce);
+
86  ghash.reset(state.nonce);
+
87  return true;
+
88 }
+
89 
+
90 bool GCMCommon::setIV(const uint8_t *iv, size_t len)
+
91 {
+
92  // Note: We assume that setKey() has already been called to
+
93  // set the hashing key in the "ghash" object and that the
+
94  // hashing key itself is still stored in "state.nonce".
+
95 
+
96  // Format the counter block from the IV.
+
97  if (len == 12) {
+
98  // IV's of exactly 96 bits are used directly as the counter block.
+
99  memcpy(state.counter, iv, 12);
+
100  state.counter[12] = 0;
+
101  state.counter[13] = 0;
+
102  state.counter[14] = 0;
+
103  state.counter[15] = 1;
+
104  } else {
+
105  // IV's of other sizes are hashed to produce the counter block.
+
106  ghash.update(iv, len);
+
107  ghash.pad();
+
108  uint64_t sizes[2] = {0, htobe64(((uint64_t)len) * 8)};
+
109  ghash.update(sizes, sizeof(sizes));
+
110  clean(sizes);
+
111  ghash.finalize(state.counter, 16);
+
112  ghash.reset(state.nonce);
+
113  }
+
114 
+
115  // Reset the GCM object ready to process auth or payload data.
+
116  state.authSize = 0;
+
117  state.dataSize = 0;
+
118  state.dataStarted = false;
+
119  state.posn = 16;
+
120 
+
121  // Replace the hash key in "nonce" with the encrypted counter.
+
122  // This value will be XOR'ed with the final authentication hash
+
123  // value in computeTag().
+
124  blockCipher->encryptBlock(state.nonce, state.counter);
+
125 }
+
126 
+
132 static inline void increment(uint8_t counter[16])
+
133 {
+
134  uint16_t carry = 1;
+
135  carry += counter[15];
+
136  counter[15] = (uint8_t)carry;
+
137  carry = (carry >> 8) + counter[14];
+
138  counter[14] = (uint8_t)carry;
+
139  carry = (carry >> 8) + counter[13];
+
140  counter[13] = (uint8_t)carry;
+
141  carry = (carry >> 8) + counter[12];
+
142  counter[12] = (uint8_t)carry;
+
143 }
+
144 
+
145 void GCMCommon::encrypt(uint8_t *output, const uint8_t *input, size_t len)
+
146 {
+
147  // Finalize the authenticated data if necessary.
+
148  if (!state.dataStarted) {
+
149  ghash.pad();
+
150  state.dataStarted = true;
+
151  }
+
152 
+
153  // Encrypt the plaintext using the block cipher in counter mode.
+
154  uint8_t *out = output;
+
155  size_t size = len;
+
156  while (size > 0) {
+
157  // Create a new keystream block if necessary.
+
158  if (state.posn >= 16) {
+
159  increment(state.counter);
+
160  blockCipher->encryptBlock(state.stream, state.counter);
+
161  state.posn = 0;
+
162  }
+
163 
+
164  // Encrypt as many bytes as we can using the keystream block.
+
165  uint8_t temp = 16 - state.posn;
+
166  if (temp > size)
+
167  temp = size;
+
168  uint8_t *stream = state.stream + state.posn;
+
169  state.posn += temp;
+
170  size -= temp;
+
171  while (temp > 0) {
+
172  *out++ = *input++ ^ *stream++;
+
173  --temp;
+
174  }
+
175  }
+
176 
+
177  // Feed the ciphertext into the hash.
+
178  ghash.update(output, len);
+
179  state.dataSize += len;
+
180 }
+
181 
+
182 void GCMCommon::decrypt(uint8_t *output, const uint8_t *input, size_t len)
+
183 {
+
184  // Finalize the authenticated data if necessary.
+
185  if (!state.dataStarted) {
+
186  ghash.pad();
+
187  state.dataStarted = true;
+
188  }
+
189 
+
190  // Feed the ciphertext into the hash before we decrypt it.
+
191  ghash.update(input, len);
+
192  state.dataSize += len;
+
193 
+
194  // Decrypt the plaintext using the block cipher in counter mode.
+
195  while (len > 0) {
+
196  // Create a new keystream block if necessary.
+
197  if (state.posn >= 16) {
+
198  increment(state.counter);
+
199  blockCipher->encryptBlock(state.stream, state.counter);
+
200  state.posn = 0;
+
201  }
+
202 
+
203  // Decrypt as many bytes as we can using the keystream block.
+
204  uint8_t temp = 16 - state.posn;
+
205  if (temp > len)
+
206  temp = len;
+
207  uint8_t *stream = state.stream + state.posn;
+
208  state.posn += temp;
+
209  len -= temp;
+
210  while (temp > 0) {
+
211  *output++ = *input++ ^ *stream++;
+
212  --temp;
+
213  }
+
214  }
+
215 }
+
216 
+
217 void GCMCommon::addAuthData(const void *data, size_t len)
+
218 {
+
219  if (!state.dataStarted) {
+
220  ghash.update(data, len);
+
221  state.authSize += len;
+
222  }
+
223 }
+
224 
+
225 void GCMCommon::computeTag(void *tag, size_t len)
+
226 {
+
227  // Pad the hashed data and add the sizes.
+
228  ghash.pad();
+
229  uint64_t sizes[2] = {
+
230  htobe64(state.authSize * 8),
+
231  htobe64(state.dataSize * 8)
+
232  };
+
233  ghash.update(sizes, sizeof(sizes));
+
234  clean(sizes);
+
235 
+
236  // Get the finalized hash, encrypt it with the nonce, and return the tag.
+
237  ghash.finalize(state.stream, 16);
+
238  for (uint8_t posn = 0; posn < 16; ++posn)
+
239  state.stream[posn] ^= state.nonce[posn];
+
240  if (len > 16)
+
241  len = 16;
+
242  memcpy(tag, state.stream, len);
+
243 }
+
244 
+
245 bool GCMCommon::checkTag(const void *tag, size_t len)
+
246 {
+
247  // Can never match if the expected tag length is too long.
+
248  if (len > 16)
+
249  return false;
+
250 
+
251  // Compute the tag and check it.
+
252  computeTag(state.counter, 16);
+
253  return secure_compare(state.counter, tag, len);
+
254 }
+
255 
+
256 void GCMCommon::clear()
+
257 {
+
258  blockCipher->clear();
+
259  ghash.clear();
+
260  clean(state);
+
261  state.posn = 16;
+
262 }
+
263 
+
GCMCommon::computeTag
void computeTag(void *tag, size_t len)
Finalizes the encryption process and computes the authentication tag.
Definition: GCM.cpp:225
+
GCMCommon::setKey
bool setKey(const uint8_t *key, size_t len)
Sets the key to use for future encryption and decryption operations.
Definition: GCM.cpp:77
+
GCMCommon::tagSize
size_t tagSize() const
Returns the size of the authentication tag.
Definition: GCM.cpp:71
+
GCMCommon::encrypt
void encrypt(uint8_t *output, const uint8_t *input, size_t len)
Encrypts an input buffer and writes the ciphertext to an output buffer.
Definition: GCM.cpp:145
+
GCMCommon::clear
void clear()
Clears all security-sensitive state from this cipher.
Definition: GCM.cpp:256
+
GCMCommon::checkTag
bool checkTag(const void *tag, size_t len)
Finalizes the decryption process and checks the authentication tag.
Definition: GCM.cpp:245
+
GCMCommon::ivSize
size_t ivSize() const
Size of the initialization vector for this cipher, in bytes.
Definition: GCM.cpp:66
+
GHASH::finalize
void finalize(void *token, size_t len)
Finalizes the authentication process and returns the token.
Definition: GHASH.cpp:130
+
GCMCommon::addAuthData
void addAuthData(const void *data, size_t len)
Adds extra data that will be authenticated but not encrypted.
Definition: GCM.cpp:217
+
GHASH::update
void update(const void *data, size_t len)
Updates the message authenticator with more data.
Definition: GHASH.cpp:94
+
BlockCipher::encryptBlock
virtual void encryptBlock(uint8_t *output, const uint8_t *input)=0
Encrypts a single block using this cipher.
+
GCMCommon::decrypt
void decrypt(uint8_t *output, const uint8_t *input, size_t len)
Decrypts an input buffer and writes the plaintext to an output buffer.
Definition: GCM.cpp:182
+
BlockCipher::setKey
virtual bool setKey(const uint8_t *key, size_t len)=0
Sets the key to use for future encryption and decryption operations.
+
GCMCommon::GCMCommon
GCMCommon()
Constructs a new cipher in GCM mode.
Definition: GCM.cpp:44
+
GHASH::pad
void pad()
Pads the input stream with zero bytes to a multiple of 16.
Definition: GHASH.cpp:146
+
BlockCipher::clear
virtual void clear()=0
Clears all security-sensitive state from this block cipher.
+
GHASH::clear
void clear()
Clears the authenticator's state, removing all sensitive data.
Definition: GHASH.cpp:159
+
GCMCommon::~GCMCommon
virtual ~GCMCommon()
Destroys this cipher object after clearing sensitive information.
Definition: GCM.cpp:56
+
GCMCommon::setIV
bool setIV(const uint8_t *iv, size_t len)
Sets the initialization vector to use for future encryption and decryption operations.
Definition: GCM.cpp:90
+
BlockCipher::keySize
virtual size_t keySize() const =0
Default size of the key for this block cipher, in bytes.
+
GCMCommon::keySize
size_t keySize() const
Default size of the key for this cipher, in bytes.
Definition: GCM.cpp:61
+
GHASH::reset
void reset(const void *key)
Resets the GHASH message authenticator for a new session.
Definition: GHASH.cpp:67
+
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/GCM_8h_source.html b/GCM_8h_source.html new file mode 100644 index 00000000..d0b48d12 --- /dev/null +++ b/GCM_8h_source.html @@ -0,0 +1,199 @@ + + + + + + +ArduinoLibs: GCM.h Source File + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ + +
+
+
+
GCM.h
+
+
+
1 /*
+
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
+
3  *
+
4  * Permission is hereby granted, free of charge, to any person obtaining a
+
5  * copy of this software and associated documentation files (the "Software"),
+
6  * to deal in the Software without restriction, including without limitation
+
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+
8  * and/or sell copies of the Software, and to permit persons to whom the
+
9  * Software is furnished to do so, subject to the following conditions:
+
10  *
+
11  * The above copyright notice and this permission notice shall be included
+
12  * in all copies or substantial portions of the Software.
+
13  *
+
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+
20  * DEALINGS IN THE SOFTWARE.
+
21  */
+
22 
+
23 #ifndef CRYPTO_GCM_h
+
24 #define CRYPTO_GCM_h
+
25 
+
26 #include "AuthenticatedCipher.h"
+
27 #include "BlockCipher.h"
+
28 #include "GHASH.h"
+
29 
+
30 class GCMCommon : public AuthenticatedCipher
+
31 {
+
32 public:
+
33  virtual ~GCMCommon();
+
34 
+
35  size_t keySize() const;
+
36  size_t ivSize() const;
+
37  size_t tagSize() const;
+
38 
+
39  bool setKey(const uint8_t *key, size_t len);
+
40  bool setIV(const uint8_t *iv, size_t len);
+
41 
+
42  void encrypt(uint8_t *output, const uint8_t *input, size_t len);
+
43  void decrypt(uint8_t *output, const uint8_t *input, size_t len);
+
44 
+
45  void addAuthData(const void *data, size_t len);
+
46 
+
47  void computeTag(void *tag, size_t len);
+
48  bool checkTag(const void *tag, size_t len);
+
49 
+
50  void clear();
+
51 
+
52 protected:
+
53  GCMCommon();
+
54  void setBlockCipher(BlockCipher *cipher) { blockCipher = cipher; }
+
55 
+
56 private:
+
57  BlockCipher *blockCipher;
+
58  GHASH ghash;
+
59  struct {
+
60  uint8_t counter[16];
+
61  uint8_t stream[16];
+
62  uint8_t nonce[16];
+
63  uint64_t authSize;
+
64  uint64_t dataSize;
+
65  bool dataStarted;
+
66  uint8_t posn;
+
67  } state;
+
68 };
+
69 
+
70 template <typename T>
+
71 class GCM : public GCMCommon
+
72 {
+
73 public:
+
74  GCM() { setBlockCipher(&cipher); }
+
75 
+
76 private:
+
77  T cipher;
+
78 };
+
79 
+
80 #endif
+
GCMCommon::computeTag
void computeTag(void *tag, size_t len)
Finalizes the encryption process and computes the authentication tag.
Definition: GCM.cpp:225
+
GCM
Implementation of the Galois Counter Mode (GCM).
Definition: GCM.h:71
+
GCMCommon::setKey
bool setKey(const uint8_t *key, size_t len)
Sets the key to use for future encryption and decryption operations.
Definition: GCM.cpp:77
+
GCMCommon::tagSize
size_t tagSize() const
Returns the size of the authentication tag.
Definition: GCM.cpp:71
+
GCMCommon::encrypt
void encrypt(uint8_t *output, const uint8_t *input, size_t len)
Encrypts an input buffer and writes the ciphertext to an output buffer.
Definition: GCM.cpp:145
+
BlockCipher
Abstract base class for block ciphers.
Definition: BlockCipher.h:29
+
GCM::GCM
GCM()
Constructs a new GCM object for the block cipher T.
Definition: GCM.h:74
+
AuthenticatedCipher
Abstract base class for authenticated ciphers.
Definition: AuthenticatedCipher.h:28
+
GCMCommon
Concrete base class to assist with implementing GCM for 128-bit block ciphers.
Definition: GCM.h:30
+
GCMCommon::clear
void clear()
Clears all security-sensitive state from this cipher.
Definition: GCM.cpp:256
+
GCMCommon::checkTag
bool checkTag(const void *tag, size_t len)
Finalizes the decryption process and checks the authentication tag.
Definition: GCM.cpp:245
+
GCMCommon::ivSize
size_t ivSize() const
Size of the initialization vector for this cipher, in bytes.
Definition: GCM.cpp:66
+
GCMCommon::addAuthData
void addAuthData(const void *data, size_t len)
Adds extra data that will be authenticated but not encrypted.
Definition: GCM.cpp:217
+
GCMCommon::decrypt
void decrypt(uint8_t *output, const uint8_t *input, size_t len)
Decrypts an input buffer and writes the plaintext to an output buffer.
Definition: GCM.cpp:182
+
GCMCommon::GCMCommon
GCMCommon()
Constructs a new cipher in GCM mode.
Definition: GCM.cpp:44
+
GCMCommon::setBlockCipher
void setBlockCipher(BlockCipher *cipher)
Sets the block cipher to use for this GCM object.
Definition: GCM.h:54
+
GHASH
Implementation of the GHASH message authenticator.
Definition: GHASH.h:29
+
GCMCommon::~GCMCommon
virtual ~GCMCommon()
Destroys this cipher object after clearing sensitive information.
Definition: GCM.cpp:56
+
GCMCommon::setIV
bool setIV(const uint8_t *iv, size_t len)
Sets the initialization vector to use for future encryption and decryption operations.
Definition: GCM.cpp:90
+
GCMCommon::keySize
size_t keySize() const
Default size of the key for this cipher, in bytes.
Definition: GCM.cpp:61
+
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/GHASH_8cpp_source.html b/GHASH_8cpp_source.html new file mode 100644 index 00000000..0508115a --- /dev/null +++ b/GHASH_8cpp_source.html @@ -0,0 +1,247 @@ + + + + + + +ArduinoLibs: GHASH.cpp Source File + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ + +
+
+
+
GHASH.cpp
+
+
+
1 /*
+
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
+
3  *
+
4  * Permission is hereby granted, free of charge, to any person obtaining a
+
5  * copy of this software and associated documentation files (the "Software"),
+
6  * to deal in the Software without restriction, including without limitation
+
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+
8  * and/or sell copies of the Software, and to permit persons to whom the
+
9  * Software is furnished to do so, subject to the following conditions:
+
10  *
+
11  * The above copyright notice and this permission notice shall be included
+
12  * in all copies or substantial portions of the Software.
+
13  *
+
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+
20  * DEALINGS IN THE SOFTWARE.
+
21  */
+
22 
+
23 #include "GHASH.h"
+
24 #include "Crypto.h"
+
25 #include "utility/EndianUtil.h"
+
26 #include <string.h>
+
27 
+
47 GHASH::GHASH()
+
48 {
+
49  state.posn = 0;
+
50 }
+
51 
+
55 GHASH::~GHASH()
+
56 {
+
57  clean(state);
+
58 }
+
59 
+
67 void GHASH::reset(const void *key)
+
68 {
+
69  // Copy the key into H and convert from big endian to host order.
+
70  memcpy(state.H, key, 16);
+
71 #if defined(CRYPTO_LITTLE_ENDIAN)
+
72  state.H[0] = be32toh(state.H[0]);
+
73  state.H[1] = be32toh(state.H[1]);
+
74  state.H[2] = be32toh(state.H[2]);
+
75  state.H[3] = be32toh(state.H[3]);
+
76 #endif
+
77 
+
78  // Reset the hash.
+
79  memset(state.Y, 0, sizeof(state.Y));
+
80  state.posn = 0;
+
81 }
+
82 
+
94 void GHASH::update(const void *data, size_t len)
+
95 {
+
96  // XOR the input with state.Y in 128-bit chunks and process them.
+
97  const uint8_t *d = (const uint8_t *)data;
+
98  while (len > 0) {
+
99  uint8_t size = 16 - state.posn;
+
100  if (size > len)
+
101  size = len;
+
102  uint8_t *y = ((uint8_t *)state.Y) + state.posn;
+
103  for (uint8_t i = 0; i < size; ++i)
+
104  y[i] ^= d[i];
+
105  state.posn += size;
+
106  len -= size;
+
107  d += size;
+
108  if (state.posn == 16) {
+
109  processChunk();
+
110  state.posn = 0;
+
111  }
+
112  }
+
113 }
+
114 
+
130 void GHASH::finalize(void *token, size_t len)
+
131 {
+
132  // Pad with zeroes to a multiple of 16 bytes.
+
133  pad();
+
134 
+
135  // The token is the current value of Y.
+
136  if (len > 16)
+
137  len = 16;
+
138  memcpy(token, state.Y, len);
+
139 }
+
140 
+
146 void GHASH::pad()
+
147 {
+
148  if (state.posn != 0) {
+
149  // Padding involves XOR'ing the rest of state.Y with zeroes,
+
150  // which does nothing. Immediately process the next chunk.
+
151  processChunk();
+
152  state.posn = 0;
+
153  }
+
154 }
+
155 
+
159 void GHASH::clear()
+
160 {
+
161  clean(state);
+
162 }
+
163 
+
164 void GHASH::processChunk()
+
165 {
+
166  uint32_t Z0 = 0; // Z = 0
+
167  uint32_t Z1 = 0;
+
168  uint32_t Z2 = 0;
+
169  uint32_t Z3 = 0;
+
170  uint32_t V0 = state.H[0]; // V = H
+
171  uint32_t V1 = state.H[1];
+
172  uint32_t V2 = state.H[2];
+
173  uint32_t V3 = state.H[3];
+
174 
+
175  // Multiply Z by V for the set bits in Y, starting at the top.
+
176  // This is a very simple bit by bit version that may not be very
+
177  // fast but it should be resistant to cache timing attacks.
+
178  for (uint8_t posn = 0; posn < 16; ++posn) {
+
179  uint8_t value = ((const uint8_t *)state.Y)[posn];
+
180  for (uint8_t bit = 0; bit < 8; ++bit, value <<= 1) {
+
181  // Extract the high bit of "value" and turn it into a mask.
+
182  uint32_t mask = (~((uint32_t)(value >> 7))) + 1;
+
183 
+
184  // XOR V with Z if the bit is 1.
+
185  Z0 ^= (V0 & mask);
+
186  Z1 ^= (V1 & mask);
+
187  Z2 ^= (V2 & mask);
+
188  Z3 ^= (V3 & mask);
+
189 
+
190  // Rotate V right by 1 bit.
+
191  mask = ((~(V3 & 0x01)) + 1) & 0xE1000000;
+
192  V3 = (V3 >> 1) | (V2 << 31);
+
193  V2 = (V2 >> 1) | (V1 << 31);
+
194  V1 = (V1 >> 1) | (V0 << 31);
+
195  V0 = (V0 >> 1) ^ mask;
+
196  }
+
197  }
+
198 
+
199  // We have finished the block so copy Z into Y and byte-swap.
+
200  state.Y[0] = htobe32(Z0);
+
201  state.Y[1] = htobe32(Z1);
+
202  state.Y[2] = htobe32(Z2);
+
203  state.Y[3] = htobe32(Z3);
+
204 }
+
GHASH::finalize
void finalize(void *token, size_t len)
Finalizes the authentication process and returns the token.
Definition: GHASH.cpp:130
+
GHASH::update
void update(const void *data, size_t len)
Updates the message authenticator with more data.
Definition: GHASH.cpp:94
+
GHASH::~GHASH
~GHASH()
Destroys this GHASH message authenticator.
Definition: GHASH.cpp:55
+
GHASH::pad
void pad()
Pads the input stream with zero bytes to a multiple of 16.
Definition: GHASH.cpp:146
+
GHASH::clear
void clear()
Clears the authenticator's state, removing all sensitive data.
Definition: GHASH.cpp:159
+
GHASH::GHASH
GHASH()
Constructs a new GHASH message authenticator.
Definition: GHASH.cpp:47
+
GHASH::reset
void reset(const void *key)
Resets the GHASH message authenticator for a new session.
Definition: GHASH.cpp:67
+
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/GHASH_8h_source.html b/GHASH_8h_source.html new file mode 100644 index 00000000..659a815f --- /dev/null +++ b/GHASH_8h_source.html @@ -0,0 +1,160 @@ + + + + + + +ArduinoLibs: GHASH.h Source File + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ + +
+
+
+
GHASH.h
+
+
+
1 /*
+
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
+
3  *
+
4  * Permission is hereby granted, free of charge, to any person obtaining a
+
5  * copy of this software and associated documentation files (the "Software"),
+
6  * to deal in the Software without restriction, including without limitation
+
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+
8  * and/or sell copies of the Software, and to permit persons to whom the
+
9  * Software is furnished to do so, subject to the following conditions:
+
10  *
+
11  * The above copyright notice and this permission notice shall be included
+
12  * in all copies or substantial portions of the Software.
+
13  *
+
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+
20  * DEALINGS IN THE SOFTWARE.
+
21  */
+
22 
+
23 #ifndef CRYPTO_GHASH_h
+
24 #define CRYPTO_GHASH_h
+
25 
+
26 #include <inttypes.h>
+
27 #include <stddef.h>
+
28 
+
29 class GHASH
+
30 {
+
31 public:
+
32  GHASH();
+
33  ~GHASH();
+
34 
+
35  void reset(const void *key);
+
36  void update(const void *data, size_t len);
+
37  void finalize(void *token, size_t len);
+
38 
+
39  void pad();
+
40 
+
41  void clear();
+
42 
+
43 private:
+
44  struct {
+
45  uint32_t H[4];
+
46  uint32_t Y[4];
+
47  uint8_t posn;
+
48  } state;
+
49 
+
50  void processChunk();
+
51 };
+
52 
+
53 #endif
+
GHASH::finalize
void finalize(void *token, size_t len)
Finalizes the authentication process and returns the token.
Definition: GHASH.cpp:130
+
GHASH::update
void update(const void *data, size_t len)
Updates the message authenticator with more data.
Definition: GHASH.cpp:94
+
GHASH::~GHASH
~GHASH()
Destroys this GHASH message authenticator.
Definition: GHASH.cpp:55
+
GHASH::pad
void pad()
Pads the input stream with zero bytes to a multiple of 16.
Definition: GHASH.cpp:146
+
GHASH
Implementation of the GHASH message authenticator.
Definition: GHASH.h:29
+
GHASH::clear
void clear()
Clears the authenticator's state, removing all sensitive data.
Definition: GHASH.cpp:159
+
GHASH::GHASH
GHASH()
Constructs a new GHASH message authenticator.
Definition: GHASH.cpp:47
+
GHASH::reset
void reset(const void *key)
Resets the GHASH message authenticator for a new session.
Definition: GHASH.cpp:67
+
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/Hash_8cpp_source.html b/Hash_8cpp_source.html index 8b2ddb60..ae1a42c9 100644 --- a/Hash_8cpp_source.html +++ b/Hash_8cpp_source.html @@ -151,7 +151,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Hash_8h_source.html b/Hash_8h_source.html index 20ac38f9..da525750 100644 --- a/Hash_8h_source.html +++ b/Hash_8h_source.html @@ -154,7 +154,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/I2CMaster_8cpp_source.html b/I2CMaster_8cpp_source.html index 216f2ec9..b15f4cc0 100644 --- a/I2CMaster_8cpp_source.html +++ b/I2CMaster_8cpp_source.html @@ -115,7 +115,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/I2CMaster_8h_source.html b/I2CMaster_8h_source.html index 59aa5943..fc2a43c6 100644 --- a/I2CMaster_8h_source.html +++ b/I2CMaster_8h_source.html @@ -140,7 +140,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/IRreceiver_8cpp_source.html b/IRreceiver_8cpp_source.html index 63c48845..dd6590b5 100644 --- a/IRreceiver_8cpp_source.html +++ b/IRreceiver_8cpp_source.html @@ -261,7 +261,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/IRreceiver_8h_source.html b/IRreceiver_8h_source.html index 988413c7..47218df1 100644 --- a/IRreceiver_8h_source.html +++ b/IRreceiver_8h_source.html @@ -157,7 +157,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/IntField_8cpp_source.html b/IntField_8cpp_source.html index f3c32805..bf23e2de 100644 --- a/IntField_8cpp_source.html +++ b/IntField_8cpp_source.html @@ -208,7 +208,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/IntField_8h_source.html b/IntField_8h_source.html index 4fcee9f9..02eea73b 100644 --- a/IntField_8h_source.html +++ b/IntField_8h_source.html @@ -173,7 +173,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/KeccakCore_8cpp_source.html b/KeccakCore_8cpp_source.html index 56c53a18..959ff56e 100644 --- a/KeccakCore_8cpp_source.html +++ b/KeccakCore_8cpp_source.html @@ -358,7 +358,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/KeccakCore_8h_source.html b/KeccakCore_8h_source.html index ac3959bc..45ba767b 100644 --- a/KeccakCore_8h_source.html +++ b/KeccakCore_8h_source.html @@ -166,7 +166,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/LCD_8cpp_source.html b/LCD_8cpp_source.html index ffb4b2d9..63da2d40 100644 --- a/LCD_8cpp_source.html +++ b/LCD_8cpp_source.html @@ -290,7 +290,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/LCD_8h_source.html b/LCD_8h_source.html index aa64a5b5..3c5d87ac 100644 --- a/LCD_8h_source.html +++ b/LCD_8h_source.html @@ -202,7 +202,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/ListField_8cpp_source.html b/ListField_8cpp_source.html index ffff232d..d1e1e14a 100644 --- a/ListField_8cpp_source.html +++ b/ListField_8cpp_source.html @@ -221,7 +221,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/ListField_8h_source.html b/ListField_8h_source.html index 81f42fd5..0233881d 100644 --- a/ListField_8h_source.html +++ b/ListField_8h_source.html @@ -159,7 +159,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Melody_8cpp_source.html b/Melody_8cpp_source.html index 1ea56e8f..f7952c21 100644 --- a/Melody_8cpp_source.html +++ b/Melody_8cpp_source.html @@ -215,7 +215,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Melody_8h_source.html b/Melody_8h_source.html index 59b1f132..3e4ba437 100644 --- a/Melody_8h_source.html +++ b/Melody_8h_source.html @@ -258,7 +258,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Mono5x7_8h_source.html b/Mono5x7_8h_source.html index d55b863a..9ecae910 100644 --- a/Mono5x7_8h_source.html +++ b/Mono5x7_8h_source.html @@ -246,7 +246,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/NoiseSource_8cpp_source.html b/NoiseSource_8cpp_source.html index a1fe11f4..e93e8980 100644 --- a/NoiseSource_8cpp_source.html +++ b/NoiseSource_8cpp_source.html @@ -132,7 +132,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/NoiseSource_8h_source.html b/NoiseSource_8h_source.html index e0b2569f..72ac10ab 100644 --- a/NoiseSource_8h_source.html +++ b/NoiseSource_8h_source.html @@ -139,7 +139,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/OFB_8cpp_source.html b/OFB_8cpp_source.html index 394bac26..65518f97 100644 --- a/OFB_8cpp_source.html +++ b/OFB_8cpp_source.html @@ -206,7 +206,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/OFB_8h_source.html b/OFB_8h_source.html index 5d1c4684..9b52e341 100644 --- a/OFB_8h_source.html +++ b/OFB_8h_source.html @@ -171,7 +171,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/Poly1305_8cpp_source.html b/Poly1305_8cpp_source.html new file mode 100644 index 00000000..db9dbb5a --- /dev/null +++ b/Poly1305_8cpp_source.html @@ -0,0 +1,361 @@ + + + + + + +ArduinoLibs: Poly1305.cpp Source File + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ + +
+
+
+
Poly1305.cpp
+
+
+
1 /*
+
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
+
3  *
+
4  * Permission is hereby granted, free of charge, to any person obtaining a
+
5  * copy of this software and associated documentation files (the "Software"),
+
6  * to deal in the Software without restriction, including without limitation
+
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+
8  * and/or sell copies of the Software, and to permit persons to whom the
+
9  * Software is furnished to do so, subject to the following conditions:
+
10  *
+
11  * The above copyright notice and this permission notice shall be included
+
12  * in all copies or substantial portions of the Software.
+
13  *
+
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+
20  * DEALINGS IN THE SOFTWARE.
+
21  */
+
22 
+
23 #include "Poly1305.h"
+
24 #include "Crypto.h"
+
25 #include "utility/EndianUtil.h"
+
26 #include <string.h>
+
27 
+
61 // Useful sizes for limb array and word manipulation.
+
62 #define NUM_LIMBS_128BIT (16 / sizeof(limb_t))
+
63 #define NUM_LIMBS_130BIT ((16 / sizeof(limb_t)) + 1)
+
64 #define LIMB_BITS (sizeof(limb_t) * 8)
+
65 
+
66 // Endian helper macros for limbs and arrays of limbs.
+
67 #if BIGNUMBER_LIMB_8BIT
+
68 #define lelimbtoh(x) (x)
+
69 #define htolelimb(x) (x)
+
70 #elif BIGNUMBER_LIMB_16BIT
+
71 #define lelimbtoh(x) (le16toh((x)))
+
72 #define htolelimb(x) (htole16((x)))
+
73 #elif BIGNUMBER_LIMB_32BIT
+
74 #define lelimbtoh(x) (le32toh((x)))
+
75 #define htolelimb(x) (htole32((x)))
+
76 #endif
+
77 #if defined(CRYPTO_LITTLE_ENDIAN)
+
78 #define littleToHost(r,size) do { ; } while (0)
+
79 #else
+
80 #define littleToHost(r,size) \
+
81  do { \
+
82  for (uint8_t i = 0; i < (size); ++i) \
+
83  (r)[i] = lelimbtoh((r)[i]); \
+
84  } while (0)
+
85 #endif
+
86 
+
90 Poly1305::Poly1305()
+
91 {
+
92  state.chunkSize = 0;
+
93 }
+
94 
+
99 Poly1305::~Poly1305()
+
100 {
+
101  clean(state);
+
102 }
+
103 
+
111 void Poly1305::reset(const void *key)
+
112 {
+
113  // Copy the key into place and clear the bits we don't need.
+
114  uint8_t *r = (uint8_t *)state.r;
+
115  memcpy(r, key, 16);
+
116  r[3] &= 0x0F;
+
117  r[4] &= 0xFC;
+
118  r[7] &= 0x0F;
+
119  r[8] &= 0xFC;
+
120  r[11] &= 0x0F;
+
121  r[12] &= 0xFC;
+
122  r[15] &= 0x0F;
+
123 
+
124  // Convert into little-endian if necessary.
+
125  littleToHost(state.r, NUM_LIMBS_128BIT);
+
126 
+
127  // Reset the hashing process.
+
128  state.chunkSize = 0;
+
129  memset(state.h, 0, sizeof(state.h));
+
130 }
+
131 
+
143 void Poly1305::update(const void *data, size_t len)
+
144 {
+
145  // Break the input up into 128-bit chunks and process each in turn.
+
146  const uint8_t *d = (const uint8_t *)data;
+
147  while (len > 0) {
+
148  uint8_t size = 16 - state.chunkSize;
+
149  if (size > len)
+
150  size = len;
+
151  memcpy(((uint8_t *)state.c) + state.chunkSize, d, size);
+
152  state.chunkSize += size;
+
153  len -= size;
+
154  d += size;
+
155  if (state.chunkSize == 16) {
+
156  littleToHost(state.c, NUM_LIMBS_128BIT);
+
157  state.c[NUM_LIMBS_128BIT] = 1;
+
158  processChunk();
+
159  state.chunkSize = 0;
+
160  }
+
161  }
+
162 }
+
163 
+
180 void Poly1305::finalize(const void *nonce, void *token, size_t len)
+
181 {
+
182  dlimb_t carry;
+
183  uint8_t i;
+
184 
+
185  // Pad and flush the final chunk.
+
186  if (state.chunkSize > 0) {
+
187  uint8_t *c = (uint8_t *)state.c;
+
188  c[state.chunkSize] = 1;
+
189  memset(c + state.chunkSize + 1, 0, 16 - state.chunkSize - 1);
+
190  littleToHost(state.c, NUM_LIMBS_128BIT);
+
191  state.c[NUM_LIMBS_128BIT] = 0;
+
192  processChunk();
+
193  }
+
194 
+
195  // At this point, processChunk() has left h as a partially reduced
+
196  // result that is less than (2^130 - 5) * 6. Perform one more
+
197  // reduction and a trial subtraction to produce the final result.
+
198 
+
199  // Multiply the high bits of h by 5 and add them to the 130 low bits.
+
200  carry = (dlimb_t)((state.h[NUM_LIMBS_128BIT] >> 2) +
+
201  (state.h[NUM_LIMBS_128BIT] & ~((limb_t)3)));
+
202  state.h[NUM_LIMBS_128BIT] &= 0x0003;
+
203  for (i = 0; i < NUM_LIMBS_128BIT; ++i) {
+
204  carry += state.h[i];
+
205  state.h[i] = (limb_t)carry;
+
206  carry >>= LIMB_BITS;
+
207  }
+
208  state.h[i] += (limb_t)carry;
+
209 
+
210  // Subtract (2^130 - 5) from h by computing t = h + 5 - 2^130.
+
211  // The "minus 2^130" step is implicit.
+
212  carry = 5;
+
213  for (i = 0; i < NUM_LIMBS_130BIT; ++i) {
+
214  carry += state.h[i];
+
215  state.t[i] = (limb_t)carry;
+
216  carry >>= LIMB_BITS;
+
217  }
+
218 
+
219  // Borrow occurs if bit 2^130 of the previous t result is zero.
+
220  // Carefully turn this into a selection mask so we can select either
+
221  // h or t as the final result. We don't care about the highest word
+
222  // of the result because we are about to drop it in the next step.
+
223  // We have to do it this way to avoid giving away any information
+
224  // about the value of h in the instruction timing.
+
225  limb_t mask = (~((state.t[NUM_LIMBS_128BIT] >> 2) & 1)) + 1;
+
226  limb_t nmask = ~mask;
+
227  for (i = 0; i < NUM_LIMBS_128BIT; ++i) {
+
228  state.h[i] = (state.h[i] & nmask) | (state.t[i] & mask);
+
229  }
+
230 
+
231  // Add the encrypted nonce and format the final hash.
+
232  memcpy(state.c, nonce, 16);
+
233  littleToHost(state.c, NUM_LIMBS_128BIT);
+
234  carry = 0;
+
235  for (i = 0; i < NUM_LIMBS_128BIT; ++i) {
+
236  carry += state.h[i];
+
237  carry += state.c[i];
+
238  state.h[i] = htolelimb((limb_t)carry);
+
239  carry >>= LIMB_BITS;
+
240  }
+
241  if (len > 16)
+
242  len = 16;
+
243  memcpy(token, state.h, len);
+
244 }
+
245 
+
251 void Poly1305::pad()
+
252 {
+
253  if (state.chunkSize != 0) {
+
254  memset(((uint8_t *)state.c) + state.chunkSize, 0, 16 - state.chunkSize);
+
255  littleToHost(state.c, NUM_LIMBS_128BIT);
+
256  state.c[NUM_LIMBS_128BIT] = 1;
+
257  processChunk();
+
258  state.chunkSize = 0;
+
259  }
+
260 }
+
261 
+
265 void Poly1305::clear()
+
266 {
+
267  clean(state);
+
268 }
+
269 
+
273 void Poly1305::processChunk()
+
274 {
+
275  // Compute h = ((h + c) * r) mod (2^130 - 5).
+
276 
+
277  // Start with h += c. We assume that h is less than (2^130 - 5) * 6
+
278  // and that c is less than 2^129, so the result will be less than 2^133.
+
279  dlimb_t carry = 0;
+
280  uint8_t i, j;
+
281  for (i = 0; i < NUM_LIMBS_130BIT; ++i) {
+
282  carry += state.h[i];
+
283  carry += state.c[i];
+
284  state.h[i] = (limb_t)carry;
+
285  carry >>= LIMB_BITS;
+
286  }
+
287 
+
288  // Multiply h by r. We know that r is less than 2^124 because the
+
289  // top 4 bits were AND-ed off by reset(). That makes h * r less
+
290  // than 2^257. Which is less than the (2^130 - 6)^2 we want for
+
291  // the modulo reduction step that follows.
+
292  carry = 0;
+
293  limb_t word = state.r[0];
+
294  for (i = 0; i < NUM_LIMBS_130BIT; ++i) {
+
295  carry += ((dlimb_t)(state.h[i])) * word;
+
296  state.t[i] = (limb_t)carry;
+
297  carry >>= LIMB_BITS;
+
298  }
+
299  state.t[NUM_LIMBS_130BIT] = (limb_t)carry;
+
300  for (i = 1; i < NUM_LIMBS_128BIT; ++i) {
+
301  word = state.r[i];
+
302  carry = 0;
+
303  for (j = 0; j < NUM_LIMBS_130BIT; ++j) {
+
304  carry += ((dlimb_t)(state.h[j])) * word;
+
305  carry += state.t[i + j];
+
306  state.t[i + j] = (limb_t)carry;
+
307  carry >>= LIMB_BITS;
+
308  }
+
309  state.t[i + NUM_LIMBS_130BIT] = (limb_t)carry;
+
310  }
+
311 
+
312  // Reduce h * r modulo (2^130 - 5) by multiplying the high 130 bits by 5
+
313  // and adding them to the low 130 bits. See the explaination in the
+
314  // comments for Curve25519::reduce() for a description of how this works.
+
315  carry = ((dlimb_t)(state.t[NUM_LIMBS_128BIT] >> 2)) +
+
316  (state.t[NUM_LIMBS_128BIT] & ~((limb_t)3));
+
317  state.t[NUM_LIMBS_128BIT] &= 0x0003;
+
318  for (i = 0; i < NUM_LIMBS_128BIT; ++i) {
+
319  // Shift the next word of t up by (LIMB_BITS - 2) bits and then
+
320  // multiply it by 5. Breaking it down, we can add the results
+
321  // of shifting up by LIMB_BITS and shifting up by (LIMB_BITS - 2).
+
322  // The main wrinkle here is that this can result in an intermediate
+
323  // carry that is (LIMB_BITS * 2 + 1) bits in size which doesn't
+
324  // fit within a dlimb_t variable. However, we can defer adding
+
325  // (word << LIMB_BITS) until after the "carry >>= LIMB_BITS" step
+
326  // because it won't affect the low bits of the carry.
+
327  word = state.t[i + NUM_LIMBS_130BIT];
+
328  carry += ((dlimb_t)word) << (LIMB_BITS - 2);
+
329  carry += state.t[i];
+
330  state.h[i] = (limb_t)carry;
+
331  carry >>= LIMB_BITS;
+
332  carry += word;
+
333  }
+
334  state.h[i] = (limb_t)(carry + state.t[NUM_LIMBS_128BIT]);
+
335 
+
336  // At this point, h is either the answer of reducing modulo (2^130 - 5)
+
337  // or it is at most 5 subtractions away from the answer we want.
+
338  // Leave it as-is for now with h less than (2^130 - 5) * 6. It is
+
339  // still within a range where the next h * r step will not overflow.
+
340 }
+
Poly1305::finalize
void finalize(const void *nonce, void *token, size_t len)
Finalizes the authentication process and returns the token.
Definition: Poly1305.cpp:180
+
Poly1305::reset
void reset(const void *key)
Resets the Poly1305 message authenticator for a new session.
Definition: Poly1305.cpp:111
+
Poly1305::update
void update(const void *data, size_t len)
Updates the message authenticator with more data.
Definition: Poly1305.cpp:143
+
Poly1305::pad
void pad()
Pads the input stream with zero bytes to a multiple of 16.
Definition: Poly1305.cpp:251
+
Poly1305::~Poly1305
~Poly1305()
Destroys this Poly1305 message authenticator after clearing all sensitive information.
Definition: Poly1305.cpp:99
+
Poly1305::Poly1305
Poly1305()
Constructs a new Poly1305 message authenticator.
Definition: Poly1305.cpp:90
+
Poly1305::clear
void clear()
Clears the authenticator's state, removing all sensitive data.
Definition: Poly1305.cpp:265
+
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/Poly1305_8h_source.html b/Poly1305_8h_source.html new file mode 100644 index 00000000..23b021ff --- /dev/null +++ b/Poly1305_8h_source.html @@ -0,0 +1,162 @@ + + + + + + +ArduinoLibs: Poly1305.h Source File + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ + +
+
+
+
Poly1305.h
+
+
+
1 /*
+
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
+
3  *
+
4  * Permission is hereby granted, free of charge, to any person obtaining a
+
5  * copy of this software and associated documentation files (the "Software"),
+
6  * to deal in the Software without restriction, including without limitation
+
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+
8  * and/or sell copies of the Software, and to permit persons to whom the
+
9  * Software is furnished to do so, subject to the following conditions:
+
10  *
+
11  * The above copyright notice and this permission notice shall be included
+
12  * in all copies or substantial portions of the Software.
+
13  *
+
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+
20  * DEALINGS IN THE SOFTWARE.
+
21  */
+
22 
+
23 #ifndef CRYPTO_POLY1305_h
+
24 #define CRYPTO_POLY1305_h
+
25 
+
26 #include "BigNumberUtil.h"
+
27 #include <stddef.h>
+
28 
+
29 class Poly1305
+
30 {
+
31 public:
+
32  Poly1305();
+
33  ~Poly1305();
+
34 
+
35  void reset(const void *key);
+
36  void update(const void *data, size_t len);
+
37  void finalize(const void *nonce, void *token, size_t len);
+
38 
+
39  void pad();
+
40 
+
41  void clear();
+
42 
+
43 private:
+
44  struct {
+
45  limb_t h[(16 / sizeof(limb_t)) + 1];
+
46  limb_t c[(16 / sizeof(limb_t)) + 1];
+
47  limb_t r[(16 / sizeof(limb_t))];
+
48  limb_t t[(32 / sizeof(limb_t)) + 1];
+
49  uint8_t chunkSize;
+
50  } state;
+
51 
+
52  void processChunk();
+
53 };
+
54 
+
55 #endif
+
Poly1305
Poly1305 message authenticator.
Definition: Poly1305.h:29
+
Poly1305::finalize
void finalize(const void *nonce, void *token, size_t len)
Finalizes the authentication process and returns the token.
Definition: Poly1305.cpp:180
+
Poly1305::reset
void reset(const void *key)
Resets the Poly1305 message authenticator for a new session.
Definition: Poly1305.cpp:111
+
Poly1305::update
void update(const void *data, size_t len)
Updates the message authenticator with more data.
Definition: Poly1305.cpp:143
+
Poly1305::pad
void pad()
Pads the input stream with zero bytes to a multiple of 16.
Definition: Poly1305.cpp:251
+
Poly1305::~Poly1305
~Poly1305()
Destroys this Poly1305 message authenticator after clearing all sensitive information.
Definition: Poly1305.cpp:99
+
Poly1305::Poly1305
Poly1305()
Constructs a new Poly1305 message authenticator.
Definition: Poly1305.cpp:90
+
Poly1305::clear
void clear()
Clears the authenticator's state, removing all sensitive data.
Definition: Poly1305.cpp:265
+
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/PowerSave_8cpp_source.html b/PowerSave_8cpp_source.html index 7cd2467c..2f8af1e3 100644 --- a/PowerSave_8cpp_source.html +++ b/PowerSave_8cpp_source.html @@ -155,7 +155,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/PowerSave_8h_source.html b/PowerSave_8h_source.html index 481fdd5f..0c064daa 100644 --- a/PowerSave_8h_source.html +++ b/PowerSave_8h_source.html @@ -158,7 +158,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/RC5_8h_source.html b/RC5_8h_source.html index c8ff9269..5d42b95a 100644 --- a/RC5_8h_source.html +++ b/RC5_8h_source.html @@ -435,7 +435,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/RNG_8cpp_source.html b/RNG_8cpp_source.html index 3f4be017..f6448b91 100644 --- a/RNG_8cpp_source.html +++ b/RNG_8cpp_source.html @@ -366,13 +366,13 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
RNGClass::loop
void loop()
Run periodic housekeeping tasks on the random number generator.
Definition: RNG.cpp:493
RNGClass
Pseudo random number generator suitable for cryptography.
Definition: RNG.h:31
RNGClass::SEED_SIZE
static const int SEED_SIZE
Size of a saved random number seed in EEPROM space.
Definition: RNG.h:53
-
ChaCha::hashCore
static void hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds)
Executes the ChaCha hash core on an input memory block.
Definition: ChaCha.cpp:230
+
ChaCha::hashCore
static void hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds)
Executes the ChaCha hash core on an input memory block.
Definition: ChaCha.cpp:253
RNGClass::stir
void stir(const uint8_t *data, size_t len, unsigned int credit=0)
Stirs additional entropy data into the random pool.
Definition: RNG.cpp:406
RNGClass::setAutoSaveTime
void setAutoSaveTime(uint16_t minutes)
Sets the amount of time between automatic seed saves.
Definition: RNG.cpp:272
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/RNG_8h_source.html b/RNG_8h_source.html index 38eeb55a..fe8c9b83 100644 --- a/RNG_8h_source.html +++ b/RNG_8h_source.html @@ -176,7 +176,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/RTC_8cpp_source.html b/RTC_8cpp_source.html index 83343adc..039443ab 100644 --- a/RTC_8cpp_source.html +++ b/RTC_8cpp_source.html @@ -380,7 +380,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/RTC_8h_source.html b/RTC_8h_source.html index 48fd84fc..850f59df 100644 --- a/RTC_8h_source.html +++ b/RTC_8h_source.html @@ -237,7 +237,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/RingOscillatorNoiseSource_8cpp_source.html b/RingOscillatorNoiseSource_8cpp_source.html index d7c59680..cd8ccc0f 100644 --- a/RingOscillatorNoiseSource_8cpp_source.html +++ b/RingOscillatorNoiseSource_8cpp_source.html @@ -285,7 +285,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/RingOscillatorNoiseSource_8h_source.html b/RingOscillatorNoiseSource_8h_source.html index 9925c451..47326469 100644 --- a/RingOscillatorNoiseSource_8h_source.html +++ b/RingOscillatorNoiseSource_8h_source.html @@ -145,7 +145,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/SHA1_8cpp_source.html b/SHA1_8cpp_source.html index f89abaad..a4da4cb4 100644 --- a/SHA1_8cpp_source.html +++ b/SHA1_8cpp_source.html @@ -323,7 +323,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/SHA1_8h_source.html b/SHA1_8h_source.html index 06b20691..79e74f14 100644 --- a/SHA1_8h_source.html +++ b/SHA1_8h_source.html @@ -160,7 +160,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/SHA256_8cpp_source.html b/SHA256_8cpp_source.html index 73bac9de..6edca6aa 100644 --- a/SHA256_8cpp_source.html +++ b/SHA256_8cpp_source.html @@ -339,7 +339,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/SHA256_8h_source.html b/SHA256_8h_source.html index 594e954d..923d58be 100644 --- a/SHA256_8h_source.html +++ b/SHA256_8h_source.html @@ -160,7 +160,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/SHA3_8cpp_source.html b/SHA3_8cpp_source.html index 53b4d7c5..d83d95ed 100644 --- a/SHA3_8cpp_source.html +++ b/SHA3_8cpp_source.html @@ -257,7 +257,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/SHA3_8h_source.html b/SHA3_8h_source.html index 7cad9e90..7c52eaad 100644 --- a/SHA3_8h_source.html +++ b/SHA3_8h_source.html @@ -188,7 +188,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/SHA512_8cpp_source.html b/SHA512_8cpp_source.html index 91672256..63ba87a0 100644 --- a/SHA512_8cpp_source.html +++ b/SHA512_8cpp_source.html @@ -355,7 +355,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/SHA512_8h_source.html b/SHA512_8h_source.html index 44f66d0f..d1f27ed0 100644 --- a/SHA512_8h_source.html +++ b/SHA512_8h_source.html @@ -161,7 +161,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/SoftI2C_8cpp_source.html b/SoftI2C_8cpp_source.html index d94fe127..07dc4a3e 100644 --- a/SoftI2C_8cpp_source.html +++ b/SoftI2C_8cpp_source.html @@ -283,7 +283,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/SoftI2C_8h_source.html b/SoftI2C_8h_source.html index ea12fc27..2f507c93 100644 --- a/SoftI2C_8h_source.html +++ b/SoftI2C_8h_source.html @@ -157,7 +157,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/TextField_8cpp_source.html b/TextField_8cpp_source.html index a8c03bf2..7afcd1c7 100644 --- a/TextField_8cpp_source.html +++ b/TextField_8cpp_source.html @@ -156,7 +156,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/TextField_8h_source.html b/TextField_8h_source.html index b25fcb45..3eee93c4 100644 --- a/TextField_8h_source.html +++ b/TextField_8h_source.html @@ -142,7 +142,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/TimeField_8cpp_source.html b/TimeField_8cpp_source.html index 1b866f48..4db6da8f 100644 --- a/TimeField_8cpp_source.html +++ b/TimeField_8cpp_source.html @@ -325,7 +325,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/TimeField_8h_source.html b/TimeField_8h_source.html index 44b0b131..4f053cf5 100644 --- a/TimeField_8h_source.html +++ b/TimeField_8h_source.html @@ -167,7 +167,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/TransistorNoiseSource_8cpp_source.html b/TransistorNoiseSource_8cpp_source.html index ff4d01f1..3ad719f7 100644 --- a/TransistorNoiseSource_8cpp_source.html +++ b/TransistorNoiseSource_8cpp_source.html @@ -295,7 +295,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/TransistorNoiseSource_8h_source.html b/TransistorNoiseSource_8h_source.html index c0bf95ac..0d42071a 100644 --- a/TransistorNoiseSource_8h_source.html +++ b/TransistorNoiseSource_8h_source.html @@ -151,7 +151,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/alarm-clock_8dox.html b/alarm-clock_8dox.html index 00c51ea8..2d84e5c4 100644 --- a/alarm-clock_8dox.html +++ b/alarm-clock_8dox.html @@ -87,7 +87,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/alarm_clock.html b/alarm_clock.html index 6834f30b..a2917798 100644 --- a/alarm_clock.html +++ b/alarm_clock.html @@ -140,7 +140,7 @@ Completed Clock
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/annotated.html b/annotated.html index 5613cb36..723d9f63 100644 --- a/annotated.html +++ b/annotated.html @@ -93,62 +93,68 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); oCAES192AES block cipher with 192-bit keys oCAES256AES block cipher with 256-bit keys oCAESCommonAbstract base class for AES block ciphers -oCBitmapRepresents a monochrome bitmap within main memory -oCBLAKE2bBLAKE2b hash algorithm -oCBLAKE2sBLAKE2s hash algorithm -oCBlinkLEDBlink a LED on a digital output pin -oCBlockCipherAbstract base class for block ciphers -oCBoolFieldField that manages the input of a boolean value -oCCBCImplementation of the Cipher Block Chaining (CBC) mode for 128-bit block ciphers -oCCBCCommonConcrete base class to assist with implementing CBC for 128-bit block ciphers -oCCFBImplementation of the Cipher Feedback (CFB) mode for 128-bit block ciphers -oCCFBCommonConcrete base class to assist with implementing CFB for 128-bit block ciphers -oCChaChaChaCha stream cipher -oCCharlieplexManage an array of LED's in a charlieplexed arrangement -oCChaseLEDsChase LED's on output pins in a defined sequence -oCCipherAbstract base class for stream ciphers -oCCTRImplementation of the Counter (CTR) mode for 128-bit block ciphers -oCCTRCommonConcrete base class to assist with implementing CTR mode for 128-bit block ciphers -oCCurve25519Diffie-Hellman key agreement based on the elliptic curve modulo 2^255 - 19 -oCDMDHandle large dot matrix displays composed of LED's -oCDS1307RTCCommunicates with a DS1307 realtime clock chip via I2C -oCDS3231RTCCommunicates with a DS3231 realtime clock chip via I2C -oCDS3232RTCCommunicates with a DS3232 realtime clock chip via I2C -oCEEPROM24Reading and writing EEPROM's from the 24LCXX family -oCFieldManages a single data input/output field within a Form -oCFormManager for a form containing data input/output fields -oCHashAbstract base class for cryptographic hash algorithms -oCI2CMasterAbstract base class for I2C master implementations -oCIntFieldField that manages the input of an integer value -oCIRreceiverManages the reception of RC-5 commands from an infrared remote control -oCKeccakCoreKeccak core sponge function -oCLCDEnhanced library for Freetronics 16x2 LCD shields -oCListFieldField that manages selection from a static list of items -oCMelodyPlays a melody on a digital output pin using tone() -oCNoiseSourceAbstract base class for random noise sources -oCOFBImplementation of the Output Feedback (OFB) mode for 128-bit block ciphers -oCOFBCommonConcrete base class to assist with implementing OFB for 128-bit block ciphers -oCRingOscillatorNoiseSourceProcesses the signal from a ring oscillator based noise source -oCRNGClassPseudo random number generator suitable for cryptography -oCRTCBase class for realtime clock handlers -oCRTCAlarmStores alarm information from a realtime clock chip -oCRTCDateStores date information from a realtime clock chip -oCRTCTimeStores time information from a realtime clock chip -oCSHA1SHA-1 hash algorithm -oCSHA256SHA-256 hash algorithm -oCSHA3_256SHA3-256 hash algorithm -oCSHA3_512SHA3-512 hash algorithm -oCSHA512SHA-512 hash algorithm -oCSoftI2CBit-banged implementation of an I2C master -oCTextFieldField that displays a read-only text value -oCTimeFieldField that manages the display and editing of a time value -\CTransistorNoiseSourceProcesses the signal from a transistor-based noise source +oCAuthenticatedCipherAbstract base class for authenticated ciphers +oCBitmapRepresents a monochrome bitmap within main memory +oCBLAKE2bBLAKE2b hash algorithm +oCBLAKE2sBLAKE2s hash algorithm +oCBlinkLEDBlink a LED on a digital output pin +oCBlockCipherAbstract base class for block ciphers +oCBoolFieldField that manages the input of a boolean value +oCCBCImplementation of the Cipher Block Chaining (CBC) mode for 128-bit block ciphers +oCCBCCommonConcrete base class to assist with implementing CBC for 128-bit block ciphers +oCCFBImplementation of the Cipher Feedback (CFB) mode for 128-bit block ciphers +oCCFBCommonConcrete base class to assist with implementing CFB for 128-bit block ciphers +oCChaChaChaCha stream cipher +oCChaChaPolyAuthenticated cipher based on ChaCha and Poly1305 +oCCharlieplexManage an array of LED's in a charlieplexed arrangement +oCChaseLEDsChase LED's on output pins in a defined sequence +oCCipherAbstract base class for stream ciphers +oCCTRImplementation of the Counter (CTR) mode for 128-bit block ciphers +oCCTRCommonConcrete base class to assist with implementing CTR mode for 128-bit block ciphers +oCCurve25519Diffie-Hellman key agreement based on the elliptic curve modulo 2^255 - 19 +oCDMDHandle large dot matrix displays composed of LED's +oCDS1307RTCCommunicates with a DS1307 realtime clock chip via I2C +oCDS3231RTCCommunicates with a DS3231 realtime clock chip via I2C +oCDS3232RTCCommunicates with a DS3232 realtime clock chip via I2C +oCEEPROM24Reading and writing EEPROM's from the 24LCXX family +oCFieldManages a single data input/output field within a Form +oCFormManager for a form containing data input/output fields +oCGCMImplementation of the Galois Counter Mode (GCM) +oCGCMCommonConcrete base class to assist with implementing GCM for 128-bit block ciphers +oCGHASHImplementation of the GHASH message authenticator +oCHashAbstract base class for cryptographic hash algorithms +oCI2CMasterAbstract base class for I2C master implementations +oCIntFieldField that manages the input of an integer value +oCIRreceiverManages the reception of RC-5 commands from an infrared remote control +oCKeccakCoreKeccak core sponge function +oCLCDEnhanced library for Freetronics 16x2 LCD shields +oCListFieldField that manages selection from a static list of items +oCMelodyPlays a melody on a digital output pin using tone() +oCNoiseSourceAbstract base class for random noise sources +oCOFBImplementation of the Output Feedback (OFB) mode for 128-bit block ciphers +oCOFBCommonConcrete base class to assist with implementing OFB for 128-bit block ciphers +oCPoly1305Poly1305 message authenticator +oCRingOscillatorNoiseSourceProcesses the signal from a ring oscillator based noise source +oCRNGClassPseudo random number generator suitable for cryptography +oCRTCBase class for realtime clock handlers +oCRTCAlarmStores alarm information from a realtime clock chip +oCRTCDateStores date information from a realtime clock chip +oCRTCTimeStores time information from a realtime clock chip +oCSHA1SHA-1 hash algorithm +oCSHA256SHA-256 hash algorithm +oCSHA3_256SHA3-256 hash algorithm +oCSHA3_512SHA3-512 hash algorithm +oCSHA512SHA-512 hash algorithm +oCSoftI2CBit-banged implementation of an I2C master +oCTextFieldField that displays a read-only text value +oCTimeFieldField that manages the display and editing of a time value +\CTransistorNoiseSourceProcesses the signal from a transistor-based noise source
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/blink-blink_8dox.html b/blink-blink_8dox.html index 01c3a7b8..e2fe3365 100644 --- a/blink-blink_8dox.html +++ b/blink-blink_8dox.html @@ -87,7 +87,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/blink-charlieplex_8dox.html b/blink-charlieplex_8dox.html index 377150de..ba25126c 100644 --- a/blink-charlieplex_8dox.html +++ b/blink-charlieplex_8dox.html @@ -87,7 +87,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/blink-cylon_8dox.html b/blink-cylon_8dox.html index 90953799..9ce0bdc2 100644 --- a/blink-cylon_8dox.html +++ b/blink-cylon_8dox.html @@ -87,7 +87,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/blink-startrek_8dox.html b/blink-startrek_8dox.html index 03a3d125..0f894590 100644 --- a/blink-startrek_8dox.html +++ b/blink-startrek_8dox.html @@ -87,7 +87,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/blink_blink.html b/blink_blink.html index 5f79d6ce..f1ed064d 100644 --- a/blink_blink.html +++ b/blink_blink.html @@ -120,7 +120,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/blink_charlieplex.html b/blink_charlieplex.html index 57177cd1..bd75c052 100644 --- a/blink_charlieplex.html +++ b/blink_charlieplex.html @@ -160,7 +160,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/blink_cylon.html b/blink_cylon.html index 849d1bfb..1793b5e7 100644 --- a/blink_cylon.html +++ b/blink_cylon.html @@ -171,7 +171,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/blink_startrek.html b/blink_startrek.html index 0fe407fd..8277d7c3 100644 --- a/blink_startrek.html +++ b/blink_startrek.html @@ -237,7 +237,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classAES128-members.html b/classAES128-members.html index 28f256cd..6fee3a29 100644 --- a/classAES128-members.html +++ b/classAES128-members.html @@ -105,7 +105,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classAES128.html b/classAES128.html index cc8ec213..1e25c3c1 100644 --- a/classAES128.html +++ b/classAES128.html @@ -265,7 +265,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classAES192-members.html b/classAES192-members.html index fbfd8edb..fbabc9e8 100644 --- a/classAES192-members.html +++ b/classAES192-members.html @@ -105,7 +105,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classAES192.html b/classAES192.html index d53b18a3..8aa6f214 100644 --- a/classAES192.html +++ b/classAES192.html @@ -265,7 +265,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classAES256-members.html b/classAES256-members.html index 8431b8de..23173d74 100644 --- a/classAES256-members.html +++ b/classAES256-members.html @@ -105,7 +105,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classAES256.html b/classAES256.html index 4e246bea..d4171d5b 100644 --- a/classAES256.html +++ b/classAES256.html @@ -265,7 +265,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classAESCommon-members.html b/classAESCommon-members.html index 63999532..d9350f13 100644 --- a/classAESCommon-members.html +++ b/classAESCommon-members.html @@ -103,7 +103,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classAESCommon.html b/classAESCommon.html index 4632aeb5..cced77f9 100644 --- a/classAESCommon.html +++ b/classAESCommon.html @@ -322,7 +322,7 @@ Protected Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classAuthenticatedCipher-members.html b/classAuthenticatedCipher-members.html new file mode 100644 index 00000000..bc497f85 --- /dev/null +++ b/classAuthenticatedCipher-members.html @@ -0,0 +1,116 @@ + + + + + + +ArduinoLibs: Member List + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ +
+
+
+
AuthenticatedCipher Member List
+
+
+ +

This is the complete list of members for AuthenticatedCipher, including all inherited members.

+ + + + + + + + + + + + + + + + +
addAuthData(const void *data, size_t len)=0AuthenticatedCipherpure virtual
AuthenticatedCipher()AuthenticatedCipher
checkTag(const void *tag, size_t len)=0AuthenticatedCipherpure virtual
Cipher()Cipher
clear()=0Cipherpure virtual
computeTag(void *tag, size_t len)=0AuthenticatedCipherpure virtual
decrypt(uint8_t *output, const uint8_t *input, size_t len)=0Cipherpure virtual
encrypt(uint8_t *output, const uint8_t *input, size_t len)=0Cipherpure virtual
ivSize() const =0Cipherpure virtual
keySize() const =0Cipherpure virtual
setIV(const uint8_t *iv, size_t len)=0Cipherpure virtual
setKey(const uint8_t *key, size_t len)=0Cipherpure virtual
tagSize() const =0AuthenticatedCipherpure virtual
~AuthenticatedCipher()AuthenticatedCiphervirtual
~Cipher()Ciphervirtual
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classAuthenticatedCipher.html b/classAuthenticatedCipher.html new file mode 100644 index 00000000..f67ee4e5 --- /dev/null +++ b/classAuthenticatedCipher.html @@ -0,0 +1,357 @@ + + + + + + +ArduinoLibs: AuthenticatedCipher Class Reference + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ +
+
+
+Public Member Functions | +List of all members
+
+
AuthenticatedCipher Class Referenceabstract
+
+
+ +

Abstract base class for authenticated ciphers. + More...

+ +

#include <AuthenticatedCipher.h>

+
+Inheritance diagram for AuthenticatedCipher:
+
+
+ + +Cipher +ChaChaPoly +GCMCommon +GCM< T > + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Public Member Functions

+ AuthenticatedCipher ()
 Constructs a new authenticated cipher.
 
+virtual ~AuthenticatedCipher ()
 Destroys this authenticated cipher.
 
virtual size_t tagSize () const =0
 Returns the size of the authentication tag. More...
 
virtual void addAuthData (const void *data, size_t len)=0
 Adds extra data that will be authenticated but not encrypted. More...
 
virtual void computeTag (void *tag, size_t len)=0
 Finalizes the encryption process and computes the authentication tag. More...
 
virtual bool checkTag (const void *tag, size_t len)=0
 Finalizes the decryption process and checks the authentication tag. More...
 
- Public Member Functions inherited from Cipher
+ Cipher ()
 Constructs a new cipher object.
 
virtual ~Cipher ()
 Destroys this cipher object. More...
 
virtual size_t keySize () const =0
 Default size of the key for this cipher, in bytes. More...
 
virtual size_t ivSize () const =0
 Size of the initialization vector for this cipher, in bytes. More...
 
virtual bool setKey (const uint8_t *key, size_t len)=0
 Sets the key to use for future encryption and decryption operations. More...
 
virtual bool setIV (const uint8_t *iv, size_t len)=0
 Sets the initialization vector to use for future encryption and decryption operations. More...
 
virtual void encrypt (uint8_t *output, const uint8_t *input, size_t len)=0
 Encrypts an input buffer and writes the ciphertext to an output buffer. More...
 
virtual void decrypt (uint8_t *output, const uint8_t *input, size_t len)=0
 Decrypts an input buffer and writes the plaintext to an output buffer. More...
 
virtual void clear ()=0
 Clears all security-sensitive state from this cipher. More...
 
+

Detailed Description

+

Abstract base class for authenticated ciphers.

+

This class abstracts the details of algorithms that provide Authenticated Encryption with Associated Data (AEAD). Such algorithms combine encryption with message authentication to provide a single primitive.

+

Authenticated ciphers have four parameters: the secret key, an initialization vector (called a "nonce" in the literature), the plaintext, and some associated data which is to be authenticated with the plaintext but not encrypted. Associated data might be sequence numbers, IP addresses, protocol versions, or other information that is not secret but is important and unique to the session.

+

Subclasses encrypt the plaintext content and output the ciphertext. Once all plaintext has been processed, the caller should invoke computeTag() to obtain the authentication tag to transmit with the ciphertext. When the ciphertext is later decrypted, the checkTag() function can be used to check that the data is authentic.

+

Reference: RFC 5116

+
See Also
Cipher
+ +

Definition at line 28 of file AuthenticatedCipher.h.

+

Member Function Documentation

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
void AuthenticatedCipher::addAuthData (const void * data,
size_t len 
)
+ 		+pure virtual
+
+ +

Adds extra data that will be authenticated but not encrypted.

+
Parameters
+ + + +
dataThe extra data to be authenticated.
lenThe number of bytes of extra data to be authenticated.
+
+
+

This function must be called before the first call to encrypt() or decrypt(). That is, it is assumed that all extra data for authentication is available before the first payload data block and that it will be prepended to the payload for authentication. If the subclass needs to process the extra data after the payload, then it is responsible for saving data away until it is needed during computeTag() or checkTag().

+

This function can be called multiple times with separate extra data blocks for authentication. All such data will be concatenated into a single block for authentication purposes.

+ +

Implemented in ChaChaPoly, and GCMCommon.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
bool AuthenticatedCipher::checkTag (const void * tag,
size_t len 
)
+ 		+pure virtual
+
+ +

Finalizes the decryption process and checks the authentication tag.

+
Parameters
+ + + +
tagThe tag value from the incoming ciphertext to be checked.
lenThe length of the tag value in bytes, which may be less than tagSize().
+
+
+
Returns
Returns true if the tag is identical to the first len bytes of the authentication tag that was calculated during the decryption process. Returns false otherwise.
+

This function must be called after the final block of ciphertext is passed to decrypt() to determine if the data could be authenticated.

+
Note
Authenticated cipher modes usually require that if the tag could not be verified, then all of the data that was previously decrypted must be discarded. It is unwise to use the decrypted data for any purpose before it can be verified. Callers are responsible for ensuring that any data returned via previous calls to decrypt() is discarded if checkTag() returns false.
+
See Also
computeTag()
+ +

Implemented in ChaChaPoly, and GCMCommon.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
void AuthenticatedCipher::computeTag (void * tag,
size_t len 
)
+ 		+pure virtual
+
+ +

Finalizes the encryption process and computes the authentication tag.

+
Parameters
+ + + +
tagPoints to the buffer to write the tag to.
lenThe length of the tag, which may be less than tagSize() to truncate the tag to the first len bytes.
+
+
+
See Also
checkTag()
+ +

Implemented in ChaChaPoly, and GCMCommon.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + +
size_t AuthenticatedCipher::tagSize () const
+ 		+pure virtual
+
+ +

Returns the size of the authentication tag.

+
Returns
The size of the authentication tag in bytes.
+

By default this function should return the largest tag size supported by the authenticated cipher.

+
See Also
computeTag()
+ +

Implemented in ChaChaPoly, and GCMCommon.

+ +
+
+
The documentation for this class was generated from the following files: +
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classAuthenticatedCipher.png b/classAuthenticatedCipher.png new file mode 100644 index 00000000..8dc80439 Binary files /dev/null and b/classAuthenticatedCipher.png differ diff --git a/classBLAKE2b-members.html b/classBLAKE2b-members.html index 2245aae3..cee17619 100644 --- a/classBLAKE2b-members.html +++ b/classBLAKE2b-members.html @@ -113,7 +113,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classBLAKE2b.html b/classBLAKE2b.html index 01d9746c..d7940087 100644 --- a/classBLAKE2b.html +++ b/classBLAKE2b.html @@ -536,7 +536,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classBLAKE2s-members.html b/classBLAKE2s-members.html index 29370c11..89a651c0 100644 --- a/classBLAKE2s-members.html +++ b/classBLAKE2s-members.html @@ -112,7 +112,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classBLAKE2s.html b/classBLAKE2s.html index e99bcd40..3aa4ae2c 100644 --- a/classBLAKE2s.html +++ b/classBLAKE2s.html @@ -536,7 +536,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classBitmap-members.html b/classBitmap-members.html index 35e337b1..de47aa5d 100644 --- a/classBitmap-members.html +++ b/classBitmap-members.html @@ -138,7 +138,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classBitmap.html b/classBitmap.html index 5bade799..2f22a284 100644 --- a/classBitmap.html +++ b/classBitmap.html @@ -1745,7 +1745,7 @@ class DMD
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classBlinkLED-members.html b/classBlinkLED-members.html index 5ff2078b..b987659b 100644 --- a/classBlinkLED-members.html +++ b/classBlinkLED-members.html @@ -103,7 +103,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classBlinkLED.html b/classBlinkLED.html index 53e8adbd..43bf09fc 100644 --- a/classBlinkLED.html +++ b/classBlinkLED.html @@ -428,7 +428,7 @@ Public Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classBlockCipher-members.html b/classBlockCipher-members.html index 6e6d95c2..4bcc01f3 100644 --- a/classBlockCipher-members.html +++ b/classBlockCipher-members.html @@ -101,7 +101,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classBlockCipher.html b/classBlockCipher.html index ae86fe50..c27e5fa2 100644 --- a/classBlockCipher.html +++ b/classBlockCipher.html @@ -407,7 +407,7 @@ Public Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classBoolField-members.html b/classBoolField-members.html index f91603c4..606decae 100644 --- a/classBoolField-members.html +++ b/classBoolField-members.html @@ -113,7 +113,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classBoolField.html b/classBoolField.html index 85f6e781..bf5724c8 100644 --- a/classBoolField.html +++ b/classBoolField.html @@ -506,7 +506,7 @@ LiquidCrystal * 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCBC-members.html b/classCBC-members.html index 77d1a70f..346132b9 100644 --- a/classCBC-members.html +++ b/classCBC-members.html @@ -106,7 +106,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCBC.html b/classCBC.html index a4ab5aef..4608f899 100644 --- a/classCBC.html +++ b/classCBC.html @@ -185,7 +185,7 @@ class CBC< T >
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCBCCommon-members.html b/classCBCCommon-members.html index 45410fdf..16e6184c 100644 --- a/classCBCCommon-members.html +++ b/classCBCCommon-members.html @@ -105,7 +105,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCBCCommon.html b/classCBCCommon.html index 591ecffb..b2b2f437 100644 --- a/classCBCCommon.html +++ b/classCBCCommon.html @@ -534,7 +534,7 @@ Protected Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCFB-members.html b/classCFB-members.html index 15c7c77c..db1f26bd 100644 --- a/classCFB-members.html +++ b/classCFB-members.html @@ -106,7 +106,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCFB.html b/classCFB.html index 42e6c942..9638eeb0 100644 --- a/classCFB.html +++ b/classCFB.html @@ -185,7 +185,7 @@ class CFB< T >
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCFBCommon-members.html b/classCFBCommon-members.html index 6ecf5eaf..d2212f44 100644 --- a/classCFBCommon-members.html +++ b/classCFBCommon-members.html @@ -105,7 +105,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCFBCommon.html b/classCFBCommon.html index 8e80da1e..ba99df62 100644 --- a/classCFBCommon.html +++ b/classCFBCommon.html @@ -534,7 +534,7 @@ Protected Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCTR-members.html b/classCTR-members.html index e34c4a11..40974bda 100644 --- a/classCTR-members.html +++ b/classCTR-members.html @@ -107,7 +107,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCTR.html b/classCTR.html index c2325235..81b510cd 100644 --- a/classCTR.html +++ b/classCTR.html @@ -181,7 +181,7 @@ class CTR< T >
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCTRCommon-members.html b/classCTRCommon-members.html index 434d55bb..15027563 100644 --- a/classCTRCommon-members.html +++ b/classCTRCommon-members.html @@ -106,7 +106,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCTRCommon.html b/classCTRCommon.html index 0f288557..66d07c6f 100644 --- a/classCTRCommon.html +++ b/classCTRCommon.html @@ -563,7 +563,7 @@ Protected Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classChaCha-members.html b/classChaCha-members.html index 273d030d..9a7108e7 100644 --- a/classChaCha-members.html +++ b/classChaCha-members.html @@ -91,24 +91,25 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');

This is the complete list of members for ChaCha, including all inherited members.

- - - - - - - - - - - - - - + + + + + + + + + + + + + + +
ChaCha(uint8_t numRounds=20)ChaChaexplicit
Cipher()Cipher
clear()ChaChavirtual
decrypt(uint8_t *output, const uint8_t *input, size_t len)ChaChavirtual
encrypt(uint8_t *output, const uint8_t *input, size_t len)ChaChavirtual
hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds)ChaChastatic
ivSize() const ChaChavirtual
keySize() const ChaChavirtual
numRounds() const ChaChainline
setCounter(const uint8_t *counter, size_t len)ChaCha
setIV(const uint8_t *iv, size_t len)ChaChavirtual
setKey(const uint8_t *key, size_t len)ChaChavirtual
setNumRounds(uint8_t numRounds)ChaChainline
~ChaCha() (defined in ChaCha)ChaChavirtual
~Cipher()Ciphervirtual
ChaChaPoly (defined in ChaCha)ChaChafriend
Cipher()Cipher
clear()ChaChavirtual
decrypt(uint8_t *output, const uint8_t *input, size_t len)ChaChavirtual
encrypt(uint8_t *output, const uint8_t *input, size_t len)ChaChavirtual
hashCore(uint32_t *output, const uint32_t *input, uint8_t rounds)ChaChastatic
ivSize() const ChaChavirtual
keySize() const ChaChavirtual
numRounds() const ChaChainline
setCounter(const uint8_t *counter, size_t len)ChaCha
setIV(const uint8_t *iv, size_t len)ChaChavirtual
setKey(const uint8_t *key, size_t len)ChaChavirtual
setNumRounds(uint8_t numRounds)ChaChainline
~ChaCha() (defined in ChaCha)ChaChavirtual
~Cipher()Ciphervirtual
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classChaCha.html b/classChaCha.html index 328ef30d..0a985663 100644 --- a/classChaCha.html +++ b/classChaCha.html @@ -86,6 +86,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
Public Member Functions | Static Public Member Functions | +Friends | List of all members
ChaCha Class Reference
@@ -155,13 +156,19 @@ Static Public Member Functions static void hashCore (uint32_t *output, const uint32_t *input, uint8_t rounds)  Executes the ChaCha hash core on an input memory block. More...
  + + + +

+Friends

+class ChaChaPoly
 

Detailed Description

ChaCha stream cipher.

ChaCha is a stream cipher that takes a key, an 8-byte nonce/IV, and a counter and hashes them to generate a keystream to XOR with the plaintext. Variations on the ChaCha cipher use 8, 12, or 20 rounds of hashing operations with either 128-bit or 256-bit keys.

Reference: http://cr.yp.to/chacha.html

-

Definition at line 28 of file ChaCha.h.

+

Definition at line 30 of file ChaCha.h.

Constructor & Destructor Documentation

@@ -224,7 +231,7 @@ Static Public Member Functions

Implements Cipher.

-

Definition at line 195 of file ChaCha.cpp.

+

Definition at line 218 of file ChaCha.cpp.

@@ -389,7 +396,7 @@ Static Public Member Functions

This function is provided for the convenience of applications that need access to the ChaCha hash core without the higher-level processing that turns the core into a stream cipher.

-

Definition at line 230 of file ChaCha.cpp.

+

Definition at line 253 of file ChaCha.cpp.

@@ -478,7 +485,7 @@ Static Public Member Functions

Returns the number of encryption rounds; usually 8, 12, or 20.

See Also
setNumRounds()
-

Definition at line 37 of file ChaCha.h.

+

Definition at line 39 of file ChaCha.h.

@@ -655,7 +662,7 @@ Static Public Member Functions
See Also
numRounds()
-

Definition at line 38 of file ChaCha.h.

+

Definition at line 40 of file ChaCha.h.

@@ -666,7 +673,7 @@ Static Public Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classChaChaPoly-members.html b/classChaChaPoly-members.html new file mode 100644 index 00000000..a3b8d44b --- /dev/null +++ b/classChaChaPoly-members.html @@ -0,0 +1,123 @@ + + + + + + +ArduinoLibs: Member List + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ +
+
+
+
ChaChaPoly Member List
+
+
+ +

This is the complete list of members for ChaChaPoly, including all inherited members.

+ + + + + + + + + + + + + + + + + + + + + + + +
addAuthData(const void *data, size_t len)ChaChaPolyvirtual
AuthenticatedCipher()AuthenticatedCipher
authSize (defined in ChaChaPoly)ChaChaPoly
ChaChaPoly()ChaChaPoly
checkTag(const void *tag, size_t len)ChaChaPolyvirtual
Cipher()Cipher
clear()ChaChaPolyvirtual
computeTag(void *tag, size_t len)ChaChaPolyvirtual
dataSize (defined in ChaChaPoly)ChaChaPoly
dataStarted (defined in ChaChaPoly)ChaChaPoly
decrypt(uint8_t *output, const uint8_t *input, size_t len)ChaChaPolyvirtual
encrypt(uint8_t *output, const uint8_t *input, size_t len)ChaChaPolyvirtual
ivSize (defined in ChaChaPoly)ChaChaPoly
ivSize() const ChaChaPolyvirtual
keySize() const ChaChaPolyvirtual
nonce (defined in ChaChaPoly)ChaChaPoly
setIV(const uint8_t *iv, size_t len)ChaChaPolyvirtual
setKey(const uint8_t *key, size_t len)ChaChaPolyvirtual
tagSize() const ChaChaPolyvirtual
~AuthenticatedCipher()AuthenticatedCiphervirtual
~ChaChaPoly()ChaChaPolyvirtual
~Cipher()Ciphervirtual
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classChaChaPoly.html b/classChaChaPoly.html new file mode 100644 index 00000000..6096b5f2 --- /dev/null +++ b/classChaChaPoly.html @@ -0,0 +1,673 @@ + + + + + + +ArduinoLibs: ChaChaPoly Class Reference + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ +
+
+
+Public Member Functions | +List of all members
+
+
ChaChaPoly Class Reference
+
+
+ +

Authenticated cipher based on ChaCha and Poly1305. + More...

+ +

#include <ChaChaPoly.h>

+
+Inheritance diagram for ChaChaPoly:
+
+
+ + +AuthenticatedCipher +Cipher + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Public Member Functions

+ ChaChaPoly ()
 Constructs a new ChaChaPoly authenticated cipher.
 
+virtual ~ChaChaPoly ()
 Destroys this ChaChaPoly authenticated cipher.
 
size_t keySize () const
 Default size of the key for this cipher, in bytes. More...
 
size_t ivSize () const
 Size of the initialization vector for this cipher, in bytes. More...
 
size_t tagSize () const
 Returns the size of the authentication tag. More...
 
bool setKey (const uint8_t *key, size_t len)
 Sets the key to use for future encryption and decryption operations. More...
 
bool setIV (const uint8_t *iv, size_t len)
 Sets the initialization vector to use for future encryption and decryption operations. More...
 
void encrypt (uint8_t *output, const uint8_t *input, size_t len)
 Encrypts an input buffer and writes the ciphertext to an output buffer. More...
 
void decrypt (uint8_t *output, const uint8_t *input, size_t len)
 Decrypts an input buffer and writes the plaintext to an output buffer. More...
 
void addAuthData (const void *data, size_t len)
 Adds extra data that will be authenticated but not encrypted. More...
 
void computeTag (void *tag, size_t len)
 Finalizes the encryption process and computes the authentication tag. More...
 
bool checkTag (const void *tag, size_t len)
 Finalizes the decryption process and checks the authentication tag. More...
 
void clear ()
 Clears all security-sensitive state from this cipher. More...
 
- Public Member Functions inherited from AuthenticatedCipher
+ AuthenticatedCipher ()
 Constructs a new authenticated cipher.
 
+virtual ~AuthenticatedCipher ()
 Destroys this authenticated cipher.
 
- Public Member Functions inherited from Cipher
+ Cipher ()
 Constructs a new cipher object.
 
virtual ~Cipher ()
 Destroys this cipher object. More...
 
+

Detailed Description

+

Authenticated cipher based on ChaCha and Poly1305.

+

ChaChaPoly is an authenticated cipher based on a combination of ChaCha with 20 rounds for encryption and Poly1305 for authentication. The resulting cipher has a 256-bit key, a 64-bit or 96-bit initialization vector, and a 128-bit authentication tag.

+

Reference: https://tools.ietf.org/html/draft-irtf-cfrg-chacha20-poly1305-10

+
See Also
ChaCha, Poly1305, AuthenticatedCipher
+ +

Definition at line 30 of file ChaChaPoly.h.

+

Member Function Documentation

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
void ChaChaPoly::addAuthData (const void * data,
size_t len 
)
+ 		+virtual
+
+ +

Adds extra data that will be authenticated but not encrypted.

+
Parameters
+ + + +
dataThe extra data to be authenticated.
lenThe number of bytes of extra data to be authenticated.
+
+
+

This function must be called before the first call to encrypt() or decrypt(). That is, it is assumed that all extra data for authentication is available before the first payload data block and that it will be prepended to the payload for authentication. If the subclass needs to process the extra data after the payload, then it is responsible for saving data away until it is needed during computeTag() or checkTag().

+

This function can be called multiple times with separate extra data blocks for authentication. All such data will be concatenated into a single block for authentication purposes.

+ +

Implements AuthenticatedCipher.

+ +

Definition at line 126 of file ChaChaPoly.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
bool ChaChaPoly::checkTag (const void * tag,
size_t len 
)
+ 		+virtual
+
+ +

Finalizes the decryption process and checks the authentication tag.

+
Parameters
+ + + +
tagThe tag value from the incoming ciphertext to be checked.
lenThe length of the tag value in bytes, which may be less than tagSize().
+
+
+
Returns
Returns true if the tag is identical to the first len bytes of the authentication tag that was calculated during the decryption process. Returns false otherwise.
+

This function must be called after the final block of ciphertext is passed to decrypt() to determine if the data could be authenticated.

+
Note
Authenticated cipher modes usually require that if the tag could not be verified, then all of the data that was previously decrypted must be discarded. It is unwise to use the decrypted data for any purpose before it can be verified. Callers are responsible for ensuring that any data returned via previous calls to decrypt() is discarded if checkTag() returns false.
+
See Also
computeTag()
+ +

Implements AuthenticatedCipher.

+ +

Definition at line 149 of file ChaChaPoly.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + +
void ChaChaPoly::clear ()
+ 		+virtual
+
+ +

Clears all security-sensitive state from this cipher.

+

Security-sensitive information includes key schedules, initialization vectors, and any temporary state that is used by encrypt() or decrypt() which is stored in the cipher itself.

+ +

Implements Cipher.

+ +

Definition at line 163 of file ChaChaPoly.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
void ChaChaPoly::computeTag (void * tag,
size_t len 
)
+ 		+virtual
+
+ +

Finalizes the encryption process and computes the authentication tag.

+
Parameters
+ + + +
tagPoints to the buffer to write the tag to.
lenThe length of the tag, which may be less than tagSize() to truncate the tag to the first len bytes.
+
+
+
See Also
checkTag()
+ +

Implements AuthenticatedCipher.

+ +

Definition at line 134 of file ChaChaPoly.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
void ChaChaPoly::decrypt (uint8_t * output,
const uint8_t * input,
size_t len 
)
+ 		+virtual
+
+ +

Decrypts an input buffer and writes the plaintext to an output buffer.

+
Parameters
+ + + + +
outputThe output buffer to write to, which may be the same buffer as input. The output buffer must have at least as many bytes as the input buffer.
inputThe input buffer to read from.
lenThe number of bytes to decrypt.
+
+
+

The decrypt() function can be called multiple times with different regions of the ciphertext data.

+
See Also
encrypt()
+ +

Implements Cipher.

+ +

Definition at line 115 of file ChaChaPoly.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
void ChaChaPoly::encrypt (uint8_t * output,
const uint8_t * input,
size_t len 
)
+ 		+virtual
+
+ +

Encrypts an input buffer and writes the ciphertext to an output buffer.

+
Parameters
+ + + + +
outputThe output buffer to write to, which may be the same buffer as input. The output buffer must have at least as many bytes as the input buffer.
inputThe input buffer to read from.
lenThe number of bytes to encrypt.
+
+
+

The encrypt() function can be called multiple times with different regions of the plaintext data.

+
See Also
decrypt()
+ +

Implements Cipher.

+ +

Definition at line 104 of file ChaChaPoly.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + +
size_t ChaChaPoly::ivSize () const
+ 		+virtual
+
+ +

Size of the initialization vector for this cipher, in bytes.

+

If the cipher does not need an initialization vector, this function will return zero.

+ +

Implements Cipher.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + +
size_t ChaChaPoly::keySize () const
+ 		+virtual
+
+ +

Default size of the key for this cipher, in bytes.

+

If the cipher supports variable-sized keys, keySize() indicates the default or recommended key size. The cipher may support other key sizes.

+
See Also
setKey(), ivSize()
+ +

Implements Cipher.

+ +

Definition at line 61 of file ChaChaPoly.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
bool ChaChaPoly::setIV (const uint8_t * iv,
size_t len 
)
+ 		+virtual
+
+ +

Sets the initialization vector to use for future encryption and decryption operations.

+
Parameters
+ + + +
ivThe initialization vector to use.
lenThe length of the initialization vector in bytes.
+
+
+
Returns
Returns false if the length is not supported.
+

Initialization vectors should be set before the first call to encrypt() or decrypt() after a setKey() call. If the initialization vector is changed after encryption or decryption begins, then the behaviour is undefined.

+
Note
The IV is not encoded into the output stream by encrypt(). The caller is responsible for communicating the IV to the other party.
+
See Also
ivSize()
+ +

Implements Cipher.

+ +

Definition at line 84 of file ChaChaPoly.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
bool ChaChaPoly::setKey (const uint8_t * key,
size_t len 
)
+ 		+virtual
+
+ +

Sets the key to use for future encryption and decryption operations.

+
Parameters
+ + + +
keyThe key to use.
lenThe length of the key in bytes.
+
+
+
Returns
Returns false if the key length is not supported, or the key is somehow "weak" and unusable by this cipher.
+

Use clear() or the destructor to remove the key and any other sensitive data from the object once encryption or decryption is complete.

+

Calling setKey() resets the cipher. Any temporary data that was being retained for encrypting partial blocks will be abandoned.

+
See Also
keySize(), clear()
+ +

Implements Cipher.

+ +

Definition at line 79 of file ChaChaPoly.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + +
size_t ChaChaPoly::tagSize () const
+ 		+virtual
+
+ +

Returns the size of the authentication tag.

+
Returns
The size of the authentication tag in bytes.
+

By default this function should return the largest tag size supported by the authenticated cipher.

+
See Also
computeTag()
+ +

Implements AuthenticatedCipher.

+ +

Definition at line 73 of file ChaChaPoly.cpp.

+ +
+
+
The documentation for this class was generated from the following files: +
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classChaChaPoly.png b/classChaChaPoly.png new file mode 100644 index 00000000..7a4de2d5 Binary files /dev/null and b/classChaChaPoly.png differ diff --git a/classCharlieplex-members.html b/classCharlieplex-members.html index 291ae424..9f9d43a2 100644 --- a/classCharlieplex-members.html +++ b/classCharlieplex-members.html @@ -104,7 +104,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCharlieplex.html b/classCharlieplex.html index d26f5f24..2c5cbd92 100644 --- a/classCharlieplex.html +++ b/classCharlieplex.html @@ -538,7 +538,7 @@ Public Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classChaseLEDs-members.html b/classChaseLEDs-members.html index fc57a0cf..1a187408 100644 --- a/classChaseLEDs-members.html +++ b/classChaseLEDs-members.html @@ -99,7 +99,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classChaseLEDs.html b/classChaseLEDs.html index 491be03f..41e8393d 100644 --- a/classChaseLEDs.html +++ b/classChaseLEDs.html @@ -347,7 +347,7 @@ Protected Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCipher-members.html b/classCipher-members.html index f004bff5..f8ca2ae8 100644 --- a/classCipher-members.html +++ b/classCipher-members.html @@ -102,7 +102,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCipher.html b/classCipher.html index 167cc853..c98bda9e 100644 --- a/classCipher.html +++ b/classCipher.html @@ -101,15 +101,19 @@ Inheritance diagram for Cipher:
-CBCCommon -CFBCommon -ChaCha -CTRCommon -OFBCommon -CBC< T > -CFB< T > -CTR< T > -OFB< T > +AuthenticatedCipher +CBCCommon +CFBCommon +ChaCha +CTRCommon +OFBCommon +ChaChaPoly +GCMCommon +CBC< T > +CFB< T > +CTR< T > +OFB< T > +GCM< T >
@@ -205,7 +209,7 @@ Public Member Functions

Clears all security-sensitive state from this cipher.

Security-sensitive information includes key schedules, initialization vectors, and any temporary state that is used by encrypt() or decrypt() which is stored in the cipher itself.

-

Implemented in ChaCha, CTRCommon, CBCCommon, CFBCommon, and OFBCommon.

+

Implemented in ChaChaPoly, GCMCommon, ChaCha, CTRCommon, CBCCommon, CFBCommon, and OFBCommon.

@@ -259,7 +263,7 @@ Public Member Functions

The decrypt() function can be called multiple times with different regions of the ciphertext data.

See Also
encrypt()
-

Implemented in ChaCha, CTRCommon, CBCCommon, CFBCommon, and OFBCommon.

+

Implemented in ChaCha, ChaChaPoly, CTRCommon, GCMCommon, CBCCommon, CFBCommon, and OFBCommon.

@@ -313,7 +317,7 @@ Public Member Functions

The encrypt() function can be called multiple times with different regions of the plaintext data.

See Also
decrypt()
-

Implemented in ChaCha, CTRCommon, CBCCommon, CFBCommon, and OFBCommon.

+

Implemented in ChaCha, ChaChaPoly, CTRCommon, GCMCommon, CBCCommon, CFBCommon, and OFBCommon.

@@ -341,7 +345,7 @@ Public Member Functions

Size of the initialization vector for this cipher, in bytes.

If the cipher does not need an initialization vector, this function will return zero.

-

Implemented in CBCCommon, CFBCommon, ChaCha, CTRCommon, and OFBCommon.

+

Implemented in ChaCha, ChaChaPoly, GCMCommon, CBCCommon, CFBCommon, CTRCommon, and OFBCommon.

@@ -370,7 +374,7 @@ Public Member Functions

If the cipher supports variable-sized keys, keySize() indicates the default or recommended key size. The cipher may support other key sizes.

See Also
setKey(), ivSize()
-

Implemented in CBCCommon, CFBCommon, ChaCha, CTRCommon, and OFBCommon.

+

Implemented in ChaCha, ChaChaPoly, GCMCommon, CBCCommon, CFBCommon, CTRCommon, and OFBCommon.

@@ -419,7 +423,7 @@ Public Member Functions
Note
The IV is not encoded into the output stream by encrypt(). The caller is responsible for communicating the IV to the other party.
See Also
ivSize()
-

Implemented in ChaCha, CTRCommon, CBCCommon, CFBCommon, and OFBCommon.

+

Implemented in ChaCha, ChaChaPoly, CTRCommon, GCMCommon, CBCCommon, CFBCommon, and OFBCommon.

@@ -468,7 +472,7 @@ Public Member Functions

Calling setKey() resets the cipher. Any temporary data that was being retained for encrypting partial blocks will be abandoned.

See Also
keySize(), clear()
-

Implemented in ChaCha, CTRCommon, CBCCommon, CFBCommon, and OFBCommon.

+

Implemented in ChaCha, ChaChaPoly, CTRCommon, GCMCommon, CBCCommon, CFBCommon, and OFBCommon.

@@ -479,7 +483,7 @@ Public Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCipher.png b/classCipher.png index 3a1ad03b..51c89007 100644 Binary files a/classCipher.png and b/classCipher.png differ diff --git a/classCurve25519-members.html b/classCurve25519-members.html index 2c3e6bd5..e548d0f1 100644 --- a/classCurve25519-members.html +++ b/classCurve25519-members.html @@ -96,7 +96,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classCurve25519.html b/classCurve25519.html index b37e4611..4da5d901 100644 --- a/classCurve25519.html +++ b/classCurve25519.html @@ -113,7 +113,7 @@ Static Public Member Functions
Note
This public functions in this class need a substantial amount of stack space to store intermediate results while the curve function is being evaluated. About 1k of free stack space is recommended for safety.

References: http://cr.yp.to/ecdh.html https://tools.ietf.org/html/draft-irtf-cfrg-curves-02

-

Definition at line 35 of file Curve25519.h.

+

Definition at line 29 of file Curve25519.h.

Member Function Documentation

@@ -295,7 +295,7 @@ Static Public Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classDMD-members.html b/classDMD-members.html index 60d9cfa9..ede876f0 100644 --- a/classDMD-members.html +++ b/classDMD-members.html @@ -150,7 +150,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classDMD.html b/classDMD.html index 8d1e3513..d01eae3a 100644 --- a/classDMD.html +++ b/classDMD.html @@ -755,7 +755,7 @@ Multiple panels
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classDS1307RTC-members.html b/classDS1307RTC-members.html index 314d39b7..25d3557a 100644 --- a/classDS1307RTC-members.html +++ b/classDS1307RTC-members.html @@ -125,7 +125,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classDS1307RTC.html b/classDS1307RTC.html index 63fc4f8b..5c68a471 100644 --- a/classDS1307RTC.html +++ b/classDS1307RTC.html @@ -598,7 +598,7 @@ static const uint8_t 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classDS3231RTC-members.html b/classDS3231RTC-members.html index 13b08c6d..d8a7adee 100644 --- a/classDS3231RTC-members.html +++ b/classDS3231RTC-members.html @@ -133,7 +133,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classDS3231RTC.html b/classDS3231RTC.html index 0e8d1c34..df71475c 100644 --- a/classDS3231RTC.html +++ b/classDS3231RTC.html @@ -713,7 +713,7 @@ static const uint8_t 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classDS3232RTC-members.html b/classDS3232RTC-members.html index 4567b376..63ceeb88 100644 --- a/classDS3232RTC-members.html +++ b/classDS3232RTC-members.html @@ -130,7 +130,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classDS3232RTC.html b/classDS3232RTC.html index 9e4a90a7..2936bfc7 100644 --- a/classDS3232RTC.html +++ b/classDS3232RTC.html @@ -750,7 +750,7 @@ static const uint8_t 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classEEPROM24-members.html b/classEEPROM24-members.html index 935ed035..02fe8d5d 100644 --- a/classEEPROM24-members.html +++ b/classEEPROM24-members.html @@ -101,7 +101,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classEEPROM24.html b/classEEPROM24.html index 54350ab1..ace5e935 100644 --- a/classEEPROM24.html +++ b/classEEPROM24.html @@ -431,7 +431,7 @@ Public Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classField-members.html b/classField-members.html index 2a0f2c50..ed2bfc60 100644 --- a/classField-members.html +++ b/classField-members.html @@ -106,7 +106,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classField.html b/classField.html index 692b958a..0741c0bc 100644 --- a/classField.html +++ b/classField.html @@ -424,7 +424,7 @@ class Form
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classForm-members.html b/classForm-members.html index bfd42e65..5474b9d3 100644 --- a/classForm-members.html +++ b/classForm-members.html @@ -108,7 +108,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classForm.html b/classForm.html index dac6c529..cadcec31 100644 --- a/classForm.html +++ b/classForm.html @@ -485,7 +485,7 @@ class Field
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classGCM-members.html b/classGCM-members.html new file mode 100644 index 00000000..5895e95a --- /dev/null +++ b/classGCM-members.html @@ -0,0 +1,127 @@ + + + + + + +ArduinoLibs: Member List + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ +
+
+
+
GCM< T > Member List
+
+
+ +

This is the complete list of members for GCM< T >, including all inherited members.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
addAuthData(const void *data, size_t len)GCMCommonvirtual
AuthenticatedCipher()AuthenticatedCipher
authSize (defined in GCMCommon)GCMCommon
checkTag(const void *tag, size_t len)GCMCommonvirtual
Cipher()Cipher
clear()GCMCommonvirtual
computeTag(void *tag, size_t len)GCMCommonvirtual
counter (defined in GCMCommon)GCMCommon
dataSize (defined in GCMCommon)GCMCommon
dataStarted (defined in GCMCommon)GCMCommon
decrypt(uint8_t *output, const uint8_t *input, size_t len)GCMCommonvirtual
encrypt(uint8_t *output, const uint8_t *input, size_t len)GCMCommonvirtual
GCM()GCM< T >inline
GCMCommon()GCMCommonprotected
ivSize() const GCMCommonvirtual
keySize() const GCMCommonvirtual
nonce (defined in GCMCommon)GCMCommon
posn (defined in GCMCommon)GCMCommon
setBlockCipher(BlockCipher *cipher)GCMCommoninlineprotected
setIV(const uint8_t *iv, size_t len)GCMCommonvirtual
setKey(const uint8_t *key, size_t len)GCMCommonvirtual
stream (defined in GCMCommon)GCMCommon
tagSize() const GCMCommonvirtual
~AuthenticatedCipher()AuthenticatedCiphervirtual
~Cipher()Ciphervirtual
~GCMCommon()GCMCommonvirtual
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classGCM.html b/classGCM.html new file mode 100644 index 00000000..36971fc8 --- /dev/null +++ b/classGCM.html @@ -0,0 +1,231 @@ + + + + + + +ArduinoLibs: GCM< T > Class Template Reference + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ +
+
+
+Public Member Functions | +List of all members
+
+
GCM< T > Class Template Reference
+
+
+ +

Implementation of the Galois Counter Mode (GCM). + More...

+ +

#include <GCM.h>

+
+Inheritance diagram for GCM< T >:
+
+
+ + +GCMCommon +AuthenticatedCipher +Cipher + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Public Member Functions

+ GCM ()
 Constructs a new GCM object for the block cipher T.
 
- Public Member Functions inherited from GCMCommon
+virtual ~GCMCommon ()
 Destroys this cipher object after clearing sensitive information.
 
size_t keySize () const
 Default size of the key for this cipher, in bytes. More...
 
size_t ivSize () const
 Size of the initialization vector for this cipher, in bytes. More...
 
size_t tagSize () const
 Returns the size of the authentication tag. More...
 
bool setKey (const uint8_t *key, size_t len)
 Sets the key to use for future encryption and decryption operations. More...
 
bool setIV (const uint8_t *iv, size_t len)
 Sets the initialization vector to use for future encryption and decryption operations. More...
 
void encrypt (uint8_t *output, const uint8_t *input, size_t len)
 Encrypts an input buffer and writes the ciphertext to an output buffer. More...
 
void decrypt (uint8_t *output, const uint8_t *input, size_t len)
 Decrypts an input buffer and writes the plaintext to an output buffer. More...
 
void addAuthData (const void *data, size_t len)
 Adds extra data that will be authenticated but not encrypted. More...
 
void computeTag (void *tag, size_t len)
 Finalizes the encryption process and computes the authentication tag. More...
 
bool checkTag (const void *tag, size_t len)
 Finalizes the decryption process and checks the authentication tag. More...
 
void clear ()
 Clears all security-sensitive state from this cipher. More...
 
- Public Member Functions inherited from AuthenticatedCipher
+ AuthenticatedCipher ()
 Constructs a new authenticated cipher.
 
+virtual ~AuthenticatedCipher ()
 Destroys this authenticated cipher.
 
- Public Member Functions inherited from Cipher
+ Cipher ()
 Constructs a new cipher object.
 
virtual ~Cipher ()
 Destroys this cipher object. More...
 
+ + + + + + + + +

+Additional Inherited Members

- Protected Member Functions inherited from GCMCommon
 GCMCommon ()
 Constructs a new cipher in GCM mode. More...
 
void setBlockCipher (BlockCipher *cipher)
 Sets the block cipher to use for this GCM object. More...
 
+

Detailed Description

+

template<typename T>
+class GCM< T >

+ +

Implementation of the Galois Counter Mode (GCM).

+

GCM mode converts a block cipher into an authenticated cipher that uses the block cipher T to encrypt and GHASH to authenticate.

+

The size of the key is determined by the underlying block cipher T. The IV is recommended to be 96 bits (12 bytes) in length, but other lengths are supported as well. The default tagSize() is 128 bits (16 bytes) but the GCM specification does allow other tag sizes: 32, 64, 96, 104, 112, 120, or 128 bits (4, 8, 12, 13, 14, 15, or 16 bytes).

+

The template parameter T must be a concrete subclass of BlockCipher indicating the specific block cipher to use. The block cipher must have a block size of 128 bits. For example, the following creates a GCM object using AES256 as the underlying cipher and then uses it to encrypt and authenticate a plaintext block:

+
GCM<AES256> gcm;
+
gcm.setKey(key, sizeof(key));
+
gcm.setIV(iv, sizeof(iv));
+
gcm.addAuthData(adata, sizeof(adata));
+
gcm.encrypt(ciphertext, plaintext, sizeof(plaintext));
+
gcm.computeTag(tag, sizeof(tag));
+

The decryption process is almost identical to convert a ciphertext and tag back into plaintext and then check the tag:

+
GCM<AES256> gcm;
+
gcm.setKey(key, sizeof(key));
+
gcm.setIV(iv, sizeof(iv));
+
gcm.addAuthData(adata, sizeof(adata));
+
gcm.decrypt(ciphertext, plaintext, sizeof(plaintext));
+
if (!gcm.checkTag(tag, sizeof(tag))) {
+
// The data was invalid - do not use it.
+
...
+
}
+

The GCM class can also be used to implement GMAC message authentication by omitting the plaintext:

+
GCM<AES256> gcm;
+
gcm.setKey(key, sizeof(key));
+
gcm.setIV(iv, sizeof(iv));
+
gcm.addAuthData(adata1, sizeof(adata1));
+
gcm.addAuthData(adata2, sizeof(adata1));
+
...
+
gcm.addAuthData(adataN, sizeof(adataN));
+
gcm.computeTag(tag, sizeof(tag));
+

References: NIST SP 800-38D, http://en.wikipedia.org/wiki/Galois/Counter_Mode

+
See Also
GCMCommon, GHASH
+ +

Definition at line 71 of file GCM.h.

+
The documentation for this class was generated from the following files: +
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classGCM.png b/classGCM.png new file mode 100644 index 00000000..17936529 Binary files /dev/null and b/classGCM.png differ diff --git a/classGCMCommon-members.html b/classGCMCommon-members.html new file mode 100644 index 00000000..3d184ce3 --- /dev/null +++ b/classGCMCommon-members.html @@ -0,0 +1,126 @@ + + + + + + +ArduinoLibs: Member List + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ +
+
+
+
GCMCommon Member List
+
+
+ +

This is the complete list of members for GCMCommon, including all inherited members.

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
addAuthData(const void *data, size_t len)GCMCommonvirtual
AuthenticatedCipher()AuthenticatedCipher
authSize (defined in GCMCommon)GCMCommon
checkTag(const void *tag, size_t len)GCMCommonvirtual
Cipher()Cipher
clear()GCMCommonvirtual
computeTag(void *tag, size_t len)GCMCommonvirtual
counter (defined in GCMCommon)GCMCommon
dataSize (defined in GCMCommon)GCMCommon
dataStarted (defined in GCMCommon)GCMCommon
decrypt(uint8_t *output, const uint8_t *input, size_t len)GCMCommonvirtual
encrypt(uint8_t *output, const uint8_t *input, size_t len)GCMCommonvirtual
GCMCommon()GCMCommonprotected
ivSize() const GCMCommonvirtual
keySize() const GCMCommonvirtual
nonce (defined in GCMCommon)GCMCommon
posn (defined in GCMCommon)GCMCommon
setBlockCipher(BlockCipher *cipher)GCMCommoninlineprotected
setIV(const uint8_t *iv, size_t len)GCMCommonvirtual
setKey(const uint8_t *key, size_t len)GCMCommonvirtual
stream (defined in GCMCommon)GCMCommon
tagSize() const GCMCommonvirtual
~AuthenticatedCipher()AuthenticatedCiphervirtual
~Cipher()Ciphervirtual
~GCMCommon()GCMCommonvirtual
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classGCMCommon.html b/classGCMCommon.html new file mode 100644 index 00000000..36e6018b --- /dev/null +++ b/classGCMCommon.html @@ -0,0 +1,744 @@ + + + + + + +ArduinoLibs: GCMCommon Class Reference + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ +
+
+
+Public Member Functions | +Protected Member Functions | +List of all members
+
+
GCMCommon Class Reference
+
+
+ +

Concrete base class to assist with implementing GCM for 128-bit block ciphers. + More...

+ +

#include <GCM.h>

+
+Inheritance diagram for GCMCommon:
+
+
+ + +AuthenticatedCipher +Cipher +GCM< T > + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Public Member Functions

+virtual ~GCMCommon ()
 Destroys this cipher object after clearing sensitive information.
 
size_t keySize () const
 Default size of the key for this cipher, in bytes. More...
 
size_t ivSize () const
 Size of the initialization vector for this cipher, in bytes. More...
 
size_t tagSize () const
 Returns the size of the authentication tag. More...
 
bool setKey (const uint8_t *key, size_t len)
 Sets the key to use for future encryption and decryption operations. More...
 
bool setIV (const uint8_t *iv, size_t len)
 Sets the initialization vector to use for future encryption and decryption operations. More...
 
void encrypt (uint8_t *output, const uint8_t *input, size_t len)
 Encrypts an input buffer and writes the ciphertext to an output buffer. More...
 
void decrypt (uint8_t *output, const uint8_t *input, size_t len)
 Decrypts an input buffer and writes the plaintext to an output buffer. More...
 
void addAuthData (const void *data, size_t len)
 Adds extra data that will be authenticated but not encrypted. More...
 
void computeTag (void *tag, size_t len)
 Finalizes the encryption process and computes the authentication tag. More...
 
bool checkTag (const void *tag, size_t len)
 Finalizes the decryption process and checks the authentication tag. More...
 
void clear ()
 Clears all security-sensitive state from this cipher. More...
 
- Public Member Functions inherited from AuthenticatedCipher
+ AuthenticatedCipher ()
 Constructs a new authenticated cipher.
 
+virtual ~AuthenticatedCipher ()
 Destroys this authenticated cipher.
 
- Public Member Functions inherited from Cipher
+ Cipher ()
 Constructs a new cipher object.
 
virtual ~Cipher ()
 Destroys this cipher object. More...
 
+ + + + + + + +

+Protected Member Functions

 GCMCommon ()
 Constructs a new cipher in GCM mode. More...
 
void setBlockCipher (BlockCipher *cipher)
 Sets the block cipher to use for this GCM object. More...
 
+

Detailed Description

+

Concrete base class to assist with implementing GCM for 128-bit block ciphers.

+

References: NIST SP 800-38D, http://en.wikipedia.org/wiki/Galois/Counter_Mode

+
See Also
GCM
+ +

Definition at line 30 of file GCM.h.

+

Constructor & Destructor Documentation

+ +
+
+ + + + + +
+ + + + + + + +
GCMCommon::GCMCommon ()
+ 		+protected
+
+ +

Constructs a new cipher in GCM mode.

+

This constructor must be followed by a call to setBlockCipher().

+ +

Definition at line 44 of file GCM.cpp.

+ +
+
+

Member Function Documentation

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
void GCMCommon::addAuthData (const void * data,
size_t len 
)
+ 		+virtual
+
+ +

Adds extra data that will be authenticated but not encrypted.

+
Parameters
+ + + +
dataThe extra data to be authenticated.
lenThe number of bytes of extra data to be authenticated.
+
+
+

This function must be called before the first call to encrypt() or decrypt(). That is, it is assumed that all extra data for authentication is available before the first payload data block and that it will be prepended to the payload for authentication. If the subclass needs to process the extra data after the payload, then it is responsible for saving data away until it is needed during computeTag() or checkTag().

+

This function can be called multiple times with separate extra data blocks for authentication. All such data will be concatenated into a single block for authentication purposes.

+ +

Implements AuthenticatedCipher.

+ +

Definition at line 217 of file GCM.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
bool GCMCommon::checkTag (const void * tag,
size_t len 
)
+ 		+virtual
+
+ +

Finalizes the decryption process and checks the authentication tag.

+
Parameters
+ + + +
tagThe tag value from the incoming ciphertext to be checked.
lenThe length of the tag value in bytes, which may be less than tagSize().
+
+
+
Returns
Returns true if the tag is identical to the first len bytes of the authentication tag that was calculated during the decryption process. Returns false otherwise.
+

This function must be called after the final block of ciphertext is passed to decrypt() to determine if the data could be authenticated.

+
Note
Authenticated cipher modes usually require that if the tag could not be verified, then all of the data that was previously decrypted must be discarded. It is unwise to use the decrypted data for any purpose before it can be verified. Callers are responsible for ensuring that any data returned via previous calls to decrypt() is discarded if checkTag() returns false.
+
See Also
computeTag()
+ +

Implements AuthenticatedCipher.

+ +

Definition at line 245 of file GCM.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + +
void GCMCommon::clear ()
+ 		+virtual
+
+ +

Clears all security-sensitive state from this cipher.

+

Security-sensitive information includes key schedules, initialization vectors, and any temporary state that is used by encrypt() or decrypt() which is stored in the cipher itself.

+ +

Implements Cipher.

+ +

Definition at line 256 of file GCM.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
void GCMCommon::computeTag (void * tag,
size_t len 
)
+ 		+virtual
+
+ +

Finalizes the encryption process and computes the authentication tag.

+
Parameters
+ + + +
tagPoints to the buffer to write the tag to.
lenThe length of the tag, which may be less than tagSize() to truncate the tag to the first len bytes.
+
+
+
See Also
checkTag()
+ +

Implements AuthenticatedCipher.

+ +

Definition at line 225 of file GCM.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
void GCMCommon::decrypt (uint8_t * output,
const uint8_t * input,
size_t len 
)
+ 		+virtual
+
+ +

Decrypts an input buffer and writes the plaintext to an output buffer.

+
Parameters
+ + + + +
outputThe output buffer to write to, which may be the same buffer as input. The output buffer must have at least as many bytes as the input buffer.
inputThe input buffer to read from.
lenThe number of bytes to decrypt.
+
+
+

The decrypt() function can be called multiple times with different regions of the ciphertext data.

+
See Also
encrypt()
+ +

Implements Cipher.

+ +

Definition at line 182 of file GCM.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
void GCMCommon::encrypt (uint8_t * output,
const uint8_t * input,
size_t len 
)
+ 		+virtual
+
+ +

Encrypts an input buffer and writes the ciphertext to an output buffer.

+
Parameters
+ + + + +
outputThe output buffer to write to, which may be the same buffer as input. The output buffer must have at least as many bytes as the input buffer.
inputThe input buffer to read from.
lenThe number of bytes to encrypt.
+
+
+

The encrypt() function can be called multiple times with different regions of the plaintext data.

+
See Also
decrypt()
+ +

Implements Cipher.

+ +

Definition at line 145 of file GCM.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + +
size_t GCMCommon::ivSize () const
+ 		+virtual
+
+ +

Size of the initialization vector for this cipher, in bytes.

+

If the cipher does not need an initialization vector, this function will return zero.

+ +

Implements Cipher.

+ +

Definition at line 66 of file GCM.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + +
size_t GCMCommon::keySize () const
+ 		+virtual
+
+ +

Default size of the key for this cipher, in bytes.

+

If the cipher supports variable-sized keys, keySize() indicates the default or recommended key size. The cipher may support other key sizes.

+
See Also
setKey(), ivSize()
+ +

Implements Cipher.

+ +

Definition at line 61 of file GCM.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
void GCMCommon::setBlockCipher (BlockCipher * cipher)
+ 		+inlineprotected
+
+ +

Sets the block cipher to use for this GCM object.

+
Parameters
+ + +
cipherThe block cipher to use to implement GCM mode. This object must have a block size of 128 bits (16 bytes).
+
+
+ +

Definition at line 54 of file GCM.h.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
bool GCMCommon::setIV (const uint8_t * iv,
size_t len 
)
+ 		+virtual
+
+ +

Sets the initialization vector to use for future encryption and decryption operations.

+
Parameters
+ + + +
ivThe initialization vector to use.
lenThe length of the initialization vector in bytes.
+
+
+
Returns
Returns false if the length is not supported.
+

Initialization vectors should be set before the first call to encrypt() or decrypt() after a setKey() call. If the initialization vector is changed after encryption or decryption begins, then the behaviour is undefined.

+
Note
The IV is not encoded into the output stream by encrypt(). The caller is responsible for communicating the IV to the other party.
+
See Also
ivSize()
+ +

Implements Cipher.

+ +

Definition at line 90 of file GCM.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
bool GCMCommon::setKey (const uint8_t * key,
size_t len 
)
+ 		+virtual
+
+ +

Sets the key to use for future encryption and decryption operations.

+
Parameters
+ + + +
keyThe key to use.
lenThe length of the key in bytes.
+
+
+
Returns
Returns false if the key length is not supported, or the key is somehow "weak" and unusable by this cipher.
+

Use clear() or the destructor to remove the key and any other sensitive data from the object once encryption or decryption is complete.

+

Calling setKey() resets the cipher. Any temporary data that was being retained for encrypting partial blocks will be abandoned.

+
See Also
keySize(), clear()
+ +

Implements Cipher.

+ +

Definition at line 77 of file GCM.cpp.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + +
size_t GCMCommon::tagSize () const
+ 		+virtual
+
+ +

Returns the size of the authentication tag.

+
Returns
The size of the authentication tag in bytes.
+

By default this function should return the largest tag size supported by the authenticated cipher.

+
See Also
computeTag()
+ +

Implements AuthenticatedCipher.

+ +

Definition at line 71 of file GCM.cpp.

+ +
+
+
The documentation for this class was generated from the following files: +
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classGCMCommon.png b/classGCMCommon.png new file mode 100644 index 00000000..d2e01ee8 Binary files /dev/null and b/classGCMCommon.png differ diff --git a/classGHASH-members.html b/classGHASH-members.html new file mode 100644 index 00000000..5c0bd70a --- /dev/null +++ b/classGHASH-members.html @@ -0,0 +1,111 @@ + + + + + + +ArduinoLibs: Member List + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ +
+
+
+
GHASH Member List
+
+
+ +

This is the complete list of members for GHASH, including all inherited members.

+ + + + + + + + + + + +
clear()GHASH
finalize(void *token, size_t len)GHASH
GHASH()GHASH
H (defined in GHASH)GHASH
pad()GHASH
posn (defined in GHASH)GHASH
reset(const void *key)GHASH
update(const void *data, size_t len)GHASH
Y (defined in GHASH)GHASH
~GHASH()GHASH
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classGHASH.html b/classGHASH.html new file mode 100644 index 00000000..2454ca79 --- /dev/null +++ b/classGHASH.html @@ -0,0 +1,273 @@ + + + + + + +ArduinoLibs: GHASH Class Reference + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + +
+ All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
+ + +
+ +
+ +
+
+
+Public Member Functions | +List of all members
+
+
GHASH Class Reference
+
+
+ +

Implementation of the GHASH message authenticator. + More...

+ +

#include <GHASH.h>

+ + + + + + + + + + + + + + + + + + + + + + + +

+Public Member Functions

+ GHASH ()
 Constructs a new GHASH message authenticator.
 
+ ~GHASH ()
 Destroys this GHASH message authenticator.
 
void reset (const void *key)
 Resets the GHASH message authenticator for a new session. More...
 
void update (const void *data, size_t len)
 Updates the message authenticator with more data. More...
 
void finalize (void *token, size_t len)
 Finalizes the authentication process and returns the token. More...
 
void pad ()
 Pads the input stream with zero bytes to a multiple of 16. More...
 
+void clear ()
 Clears the authenticator's state, removing all sensitive data.
 
+

Detailed Description

+

Implementation of the GHASH message authenticator.

+

GHASH is the message authentication part of Galois Counter Mode (GCM).

+
Note
GHASH is not the same as GMAC. GHASH implements the low level hashing primitive that is used by both GCM and GMAC. GMAC can be simulated using GCM and an empty plaintext/ciphertext.
+

References: NIST SP 800-38D, http://en.wikipedia.org/wiki/Galois/Counter_Mode

+
See Also
GCM
+ +

Definition at line 29 of file GHASH.h.

+

Member Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + +
void GHASH::finalize (void * token,
size_t len 
)
+
+ +

Finalizes the authentication process and returns the token.

+
Parameters
+ + + +
tokenThe buffer to return the token value in.
lenThe length of the token buffer between 0 and 16.
+
+
+

If len is less than 16, then the token value will be truncated to the first len bytes. If len is greater than 16, then the remaining bytes will left unchanged.

+

If finalize() is called again, then the returned token value is undefined. Call reset() first to start a new authentication process.

+
See Also
reset(), update()
+ +

Definition at line 130 of file GHASH.cpp.

+ +
+
+ +
+
+ + + + + + + +
void GHASH::pad ()
+
+ +

Pads the input stream with zero bytes to a multiple of 16.

+
See Also
update()
+ +

Definition at line 146 of file GHASH.cpp.

+ +
+
+ +
+
+ + + + + + + + +
void GHASH::reset (const void * key)
+
+ +

Resets the GHASH message authenticator for a new session.

+
Parameters
+ + +
keyPoints to the 16 byte authentication key.
+
+
+
See Also
update(), finalize()
+ +

Definition at line 67 of file GHASH.cpp.

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
void GHASH::update (const void * data,
size_t len 
)
+
+ +

Updates the message authenticator with more data.

+
Parameters
+ + + +
dataData to be hashed.
lenNumber of bytes of data to be hashed.
+
+
+

If finalize() has already been called, then the behavior of update() will be undefined. Call reset() first to start a new authentication process.

+
See Also
pad(), reset(), finalize()
+ +

Definition at line 94 of file GHASH.cpp.

+ +
+
+
The documentation for this class was generated from the following files: +
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classHash-members.html b/classHash-members.html index 0ee9ba82..c7954e43 100644 --- a/classHash-members.html +++ b/classHash-members.html @@ -104,7 +104,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classHash.html b/classHash.html index 99a1878b..43e39e81 100644 --- a/classHash.html +++ b/classHash.html @@ -576,7 +576,7 @@ Protected Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classI2CMaster-members.html b/classI2CMaster-members.html index f9ffa15a..6d8194d1 100644 --- a/classI2CMaster-members.html +++ b/classI2CMaster-members.html @@ -100,7 +100,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classI2CMaster.html b/classI2CMaster.html index 07523ad8..c1d4a5c8 100644 --- a/classI2CMaster.html +++ b/classI2CMaster.html @@ -328,7 +328,7 @@ virtual unsigned int 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classIRreceiver-members.html b/classIRreceiver-members.html index 91e656dd..402f4b79 100644 --- a/classIRreceiver-members.html +++ b/classIRreceiver-members.html @@ -100,7 +100,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classIRreceiver.html b/classIRreceiver.html index b4af25b4..817aedda 100644 --- a/classIRreceiver.html +++ b/classIRreceiver.html @@ -328,7 +328,7 @@ void _IR_receive_interrupt
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classIntField-members.html b/classIntField-members.html index f8538a1e..dd1e255a 100644 --- a/classIntField-members.html +++ b/classIntField-members.html @@ -118,7 +118,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classIntField.html b/classIntField.html index 4873c695..d738985c 100644 --- a/classIntField.html +++ b/classIntField.html @@ -647,7 +647,7 @@ LiquidCrystal * 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classKeccakCore-members.html b/classKeccakCore-members.html index 8dfa69f0..a8ba0e4f 100644 --- a/classKeccakCore-members.html +++ b/classKeccakCore-members.html @@ -108,7 +108,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classKeccakCore.html b/classKeccakCore.html index 9ddc03ec..cd1eddd6 100644 --- a/classKeccakCore.html +++ b/classKeccakCore.html @@ -425,7 +425,7 @@ void 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classLCD-members.html b/classLCD-members.html index 904d1010..66833cad 100644 --- a/classLCD-members.html +++ b/classLCD-members.html @@ -110,7 +110,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classLCD.html b/classLCD.html index d69ac219..31683fd7 100644 --- a/classLCD.html +++ b/classLCD.html @@ -592,7 +592,7 @@ Support for DFRobot LCD Shield
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classListField-members.html b/classListField-members.html index ee3dd34d..d869b196 100644 --- a/classListField-members.html +++ b/classListField-members.html @@ -111,7 +111,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classListField.html b/classListField.html index c6c8e59b..c920ca9d 100644 --- a/classListField.html +++ b/classListField.html @@ -411,7 +411,7 @@ LiquidCrystal * 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classMelody-members.html b/classMelody-members.html index 1d167d55..c84be0e3 100644 --- a/classMelody-members.html +++ b/classMelody-members.html @@ -103,7 +103,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classMelody.html b/classMelody.html index 88820fdc..e5fbf2ee 100644 --- a/classMelody.html +++ b/classMelody.html @@ -371,7 +371,7 @@ bool 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classNoiseSource-members.html b/classNoiseSource-members.html index e288f1e0..7283f700 100644 --- a/classNoiseSource-members.html +++ b/classNoiseSource-members.html @@ -98,7 +98,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classNoiseSource.html b/classNoiseSource.html index ab6006d8..a9a64c8c 100644 --- a/classNoiseSource.html +++ b/classNoiseSource.html @@ -258,7 +258,7 @@ Protected Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classOFB-members.html b/classOFB-members.html index ded87fd1..499e9e17 100644 --- a/classOFB-members.html +++ b/classOFB-members.html @@ -106,7 +106,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classOFB.html b/classOFB.html index 7a7ffba4..e943b85f 100644 --- a/classOFB.html +++ b/classOFB.html @@ -181,7 +181,7 @@ class OFB< T >
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classOFBCommon-members.html b/classOFBCommon-members.html index f6cc1081..6b6b4eab 100644 --- a/classOFBCommon-members.html +++ b/classOFBCommon-members.html @@ -105,7 +105,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classOFBCommon.html b/classOFBCommon.html index 12ae4c99..b1999d26 100644 --- a/classOFBCommon.html +++ b/classOFBCommon.html @@ -534,7 +534,7 @@ Protected Member Functions
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classPoly1305-members.html b/classPoly1305-members.html new file mode 100644 index 00000000..9f23f8db --- /dev/null +++ b/classPoly1305-members.html @@ -0,0 +1,113 @@ + + + + + + +ArduinoLibs: Member List + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + + + + +
+ +
+ +
+
+
+
Poly1305 Member List
+
+
+ +

This is the complete list of members for Poly1305, including all inherited members.

+ + + + + + + + + + + + + +
c (defined in Poly1305)Poly1305
chunkSize (defined in Poly1305)Poly1305
clear()Poly1305
finalize(const void *nonce, void *token, size_t len)Poly1305
h (defined in Poly1305)Poly1305
pad()Poly1305
Poly1305()Poly1305
r (defined in Poly1305)Poly1305
reset(const void *key)Poly1305
t (defined in Poly1305)Poly1305
update(const void *data, size_t len)Poly1305
~Poly1305()Poly1305
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classPoly1305.html b/classPoly1305.html new file mode 100644 index 00000000..13606129 --- /dev/null +++ b/classPoly1305.html @@ -0,0 +1,288 @@ + + + + + + +ArduinoLibs: Poly1305 Class Reference + + + + + + + + + +
+
+ + + + + + +
+
ArduinoLibs +
+
+
+ + + + + + + + + +
+ +
+ +
+
+
+Public Member Functions | +List of all members
+
+
Poly1305 Class Reference
+
+
+ +

Poly1305 message authenticator. + More...

+ +

#include <Poly1305.h>

+ + + + + + + + + + + + + + + + + + + + + + + +

+Public Member Functions

+ Poly1305 ()
 Constructs a new Poly1305 message authenticator.
 
+ ~Poly1305 ()
 Destroys this Poly1305 message authenticator after clearing all sensitive information.
 
void reset (const void *key)
 Resets the Poly1305 message authenticator for a new session. More...
 
void update (const void *data, size_t len)
 Updates the message authenticator with more data. More...
 
void finalize (const void *nonce, void *token, size_t len)
 Finalizes the authentication process and returns the token. More...
 
void pad ()
 Pads the input stream with zero bytes to a multiple of 16. More...
 
+void clear ()
 Clears the authenticator's state, removing all sensitive data.
 
+

Detailed Description

+

Poly1305 message authenticator.

+

Poly1305 is a message authenticator designed by Daniel J. Bernstein. An arbitrary-length message is broken up into 16-byte chunks and fed into a polynomial mod 2130 - 5 based on the 16-byte authentication key. The final polynomial value is then combined with a 16-byte nonce to create the authentication token.

+

The following example demonstrates how to compute an authentication token for a message made up of several blocks under a specific key and nonce:

+
Poly1305 poly1305;
+
uint8_t token[16];
+
poly1305.reset(key);
+
poly1305.update(block1, sizeof(block1));
+
poly1305.update(block2, sizeof(block2));
+
...
+
poly1305.update(blockN, sizeof(blockN));
+
poly1305.finalize(nonce, token, sizeof(token));
+

In the original Poly1305 specification, the nonce was encrypted with AES and a second 16-byte key. Since then, common practice has been for the caller to encrypt the nonce which gives the caller more flexibility as to how to derive and/or encrypt the nonce.

+

References: http://en.wikipedia.org/wiki/Poly1305-AES, http://cr.yp.to/mac.html

+ +

Definition at line 29 of file Poly1305.h.

+

Member Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void Poly1305::finalize (const void * nonce,
void * token,
size_t len 
)
+
+ +

Finalizes the authentication process and returns the token.

+
Parameters
+ + + + +
noncePoints to the 16-bit nonce to combine with the token.
tokenThe buffer to return the token value in.
lenThe length of the token buffer between 0 and 16.
+
+
+

If len is less than 16, then the token value will be truncated to the first len bytes. If len is greater than 16, then the remaining bytes will left unchanged.

+

If finalize() is called again, then the returned token value is undefined. Call reset() first to start a new authentication process.

+
See Also
reset(), update()
+ +

Definition at line 180 of file Poly1305.cpp.

+ +
+
+ +
+
+ + + + + + + +
void Poly1305::pad ()
+
+ +

Pads the input stream with zero bytes to a multiple of 16.

+
See Also
update()
+ +

Definition at line 251 of file Poly1305.cpp.

+ +
+
+ +
+
+ + + + + + + + +
void Poly1305::reset (const void * key)
+
+ +

Resets the Poly1305 message authenticator for a new session.

+
Parameters
+ + +
keyPoints to the 16 byte authentication key.
+
+
+
See Also
update(), finalize()
+ +

Definition at line 111 of file Poly1305.cpp.

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
void Poly1305::update (const void * data,
size_t len 
)
+
+ +

Updates the message authenticator with more data.

+
Parameters
+ + + +
dataData to be hashed.
lenNumber of bytes of data to be hashed.
+
+
+

If finalize() has already been called, then the behavior of update() will be undefined. Call reset() first to start a new authentication process.

+
See Also
pad(), reset(), finalize()
+ +

Definition at line 143 of file Poly1305.cpp.

+ +
+
+
The documentation for this class was generated from the following files: +
+ +
+Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   +doxygen + 1.8.6 +
+ + diff --git a/classRNGClass-members.html b/classRNGClass-members.html index 1ca6ed50..0cc4eb22 100644 --- a/classRNGClass-members.html +++ b/classRNGClass-members.html @@ -105,7 +105,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classRNGClass.html b/classRNGClass.html index 35efd6a6..87679ec4 100644 --- a/classRNGClass.html +++ b/classRNGClass.html @@ -517,7 +517,7 @@ static const int 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classRTC-members.html b/classRTC-members.html index b42d5b81..5483eed2 100644 --- a/classRTC-members.html +++ b/classRTC-members.html @@ -123,7 +123,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classRTC.html b/classRTC.html index 45c0e9f0..6de9ba45 100644 --- a/classRTC.html +++ b/classRTC.html @@ -779,7 +779,7 @@ static const uint8_t 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classRTCAlarm-members.html b/classRTCAlarm-members.html index 808ba527..524805b7 100644 --- a/classRTCAlarm-members.html +++ b/classRTCAlarm-members.html @@ -99,7 +99,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classRTCDate-members.html b/classRTCDate-members.html index 112b849f..2824966f 100644 --- a/classRTCDate-members.html +++ b/classRTCDate-members.html @@ -96,7 +96,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classRTCTime-members.html b/classRTCTime-members.html index 5d20166d..48ee2c2b 100644 --- a/classRTCTime-members.html +++ b/classRTCTime-members.html @@ -96,7 +96,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classRingOscillatorNoiseSource-members.html b/classRingOscillatorNoiseSource-members.html index 053ab272..10c755b7 100644 --- a/classRingOscillatorNoiseSource-members.html +++ b/classRingOscillatorNoiseSource-members.html @@ -100,7 +100,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classRingOscillatorNoiseSource.html b/classRingOscillatorNoiseSource.html index 65566412..4cc36cd0 100644 --- a/classRingOscillatorNoiseSource.html +++ b/classRingOscillatorNoiseSource.html @@ -250,7 +250,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSHA1-members.html b/classSHA1-members.html index 46b9245c..4a83a4dd 100644 --- a/classSHA1-members.html +++ b/classSHA1-members.html @@ -110,7 +110,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSHA1.html b/classSHA1.html index 7a95905f..22fd48fa 100644 --- a/classSHA1.html +++ b/classSHA1.html @@ -506,7 +506,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSHA256-members.html b/classSHA256-members.html index b5f26c13..6fc35cb1 100644 --- a/classSHA256-members.html +++ b/classSHA256-members.html @@ -110,7 +110,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSHA256.html b/classSHA256.html index e21d2bca..588fb275 100644 --- a/classSHA256.html +++ b/classSHA256.html @@ -506,7 +506,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSHA3__256-members.html b/classSHA3__256-members.html index c7c01fd5..d1e7a4e4 100644 --- a/classSHA3__256-members.html +++ b/classSHA3__256-members.html @@ -106,7 +106,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSHA3__256.html b/classSHA3__256.html index af0eaa14..9071ec25 100644 --- a/classSHA3__256.html +++ b/classSHA3__256.html @@ -506,7 +506,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSHA3__512-members.html b/classSHA3__512-members.html index 6250621d..fc01907b 100644 --- a/classSHA3__512-members.html +++ b/classSHA3__512-members.html @@ -106,7 +106,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSHA3__512.html b/classSHA3__512.html index 92a39cda..4a7061c9 100644 --- a/classSHA3__512.html +++ b/classSHA3__512.html @@ -506,7 +506,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSHA512-members.html b/classSHA512-members.html index d89fa586..a4c3bfaf 100644 --- a/classSHA512-members.html +++ b/classSHA512-members.html @@ -111,7 +111,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSHA512.html b/classSHA512.html index c0a8cf33..d84294f9 100644 --- a/classSHA512.html +++ b/classSHA512.html @@ -506,7 +506,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSoftI2C-members.html b/classSoftI2C-members.html index c605dcc3..2ada6123 100644 --- a/classSoftI2C-members.html +++ b/classSoftI2C-members.html @@ -101,7 +101,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classSoftI2C.html b/classSoftI2C.html index 5b2d7281..fd746fed 100644 --- a/classSoftI2C.html +++ b/classSoftI2C.html @@ -346,7 +346,7 @@ unsigned int 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classTextField-members.html b/classTextField-members.html index f3ce5433..05933c6b 100644 --- a/classTextField-members.html +++ b/classTextField-members.html @@ -109,7 +109,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classTextField.html b/classTextField.html index 1d7582a1..16e033cc 100644 --- a/classTextField.html +++ b/classTextField.html @@ -343,7 +343,7 @@ LiquidCrystal * 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classTimeField-members.html b/classTimeField-members.html index cf11b00e..4bdb7379 100644 --- a/classTimeField-members.html +++ b/classTimeField-members.html @@ -113,7 +113,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classTimeField.html b/classTimeField.html index 21d65f57..63660ac6 100644 --- a/classTimeField.html +++ b/classTimeField.html @@ -541,7 +541,7 @@ LiquidCrystal * 
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classTransistorNoiseSource-members.html b/classTransistorNoiseSource-members.html index bdbe601e..35c3c53f 100644 --- a/classTransistorNoiseSource-members.html +++ b/classTransistorNoiseSource-members.html @@ -100,7 +100,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classTransistorNoiseSource.html b/classTransistorNoiseSource.html index e483f80d..4bb92852 100644 --- a/classTransistorNoiseSource.html +++ b/classTransistorNoiseSource.html @@ -277,7 +277,7 @@ Additional Inherited Members
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/classes.html b/classes.html index 50eda519..0de10c4e 100644 --- a/classes.html +++ b/classes.html @@ -87,49 +87,54 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
Class Index
-
A | B | C | D | E | F | H | I | K | L | M | N | O | R | S | T
+
A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | R | S | T
- + + - - - - + + + + - - - + + + - - - - + + + + - + + + - - + +
  A  
-		CFB   
  F  
-		ListField   RTCTime   
CFBCommon   
  M  
-
  S  
+		CFBCommon   Form   ListField   RTCDate   
ChaCha   
  G  
+
  M  
+		RTCTime   
AES128   ChaChaPoly   
  S  
AES128   ChaCha   Field   
AES192   Charlieplex   Form   Melody   SHA1   
AES256   ChaseLEDs   
  H  
-
  N  
-		SHA256   
AESCommon   Cipher   SHA3_256   
AES192   Charlieplex   GCM   Melody   
AES256   ChaseLEDs   GCMCommon   
  N  
+		SHA1   
AESCommon   Cipher   GHASH   SHA256   
AuthenticatedCipher   CTR   
  H  
+		NoiseSource   SHA3_256   
  B  
-		CTR   Hash   NoiseSource   SHA3_512   
CTRCommon   
  I  
-
  O  
-		SHA512   
Bitmap   Curve25519   SoftI2C   
BLAKE2b   
  D  
-		I2CMaster   OFB   
  T  
+		CTRCommon   
  O  
+		SHA3_512   
Curve25519   Hash   SHA512   
Bitmap   
  D  
+
  I  
+		OFB   SoftI2C   
BLAKE2b   OFBCommon   
  T  
BLAKE2s   IntField   OFBCommon   
BlinkLED   DMD   IRreceiver   
  R  
-		TextField   
BlockCipher   DS1307RTC   
  K  
-		TimeField   
BoolField   DS3231RTC   RingOscillatorNoiseSource   TransistorNoiseSource   
BLAKE2s   DMD   I2CMaster   
  P  
+
BlinkLED   DS1307RTC   IntField   TextField   
BlockCipher   DS3231RTC   IRreceiver   Poly1305   TimeField   
BoolField   DS3232RTC   
  K  
+
  R  
+		TransistorNoiseSource   
  C  
-		DS3232RTC   KeccakCore   RNGClass   
  E  
-
  L  
+
  E  
+
KeccakCore   RingOscillatorNoiseSource   
CBC   EEPROM24   
  L  
+		RNGClass   
CBCCommon   
  F  
RTC   
CBC   RTCAlarm   
CBCCommon   EEPROM24   LCD   RTCDate   
CFB   LCD   RTCAlarm   
Field   
-
A | B | C | D | E | F | H | I | K | L | M | N | O | R | S | T
+
A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | R | S | T
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/crypto-rng-ring_8dox.html b/crypto-rng-ring_8dox.html index 1f9bc249..7eece088 100644 --- a/crypto-rng-ring_8dox.html +++ b/crypto-rng-ring_8dox.html @@ -87,7 +87,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/crypto-rng_8dox.html b/crypto-rng_8dox.html index 171b4ddb..a1504143 100644 --- a/crypto-rng_8dox.html +++ b/crypto-rng_8dox.html @@ -87,7 +87,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/crypto.html b/crypto.html index b0c1fd48..dfbf0e9d 100644 --- a/crypto.html +++ b/crypto.html @@ -83,9 +83,11 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); Supported Algorithms @@ -102,33 +104,53 @@ Performance

All figures are for the Arduino Uno running at 16 MHz. Figures for the Ardunino Mega 2560 running at 16 MHz are similar:

- + - + - + - + - + - + - + - + - + - + - + - + - + - + + + + + + + + + + + + + + + + + + + + +
AlgorithmEncryption / Hashing (per byte)Decryption (per byte)Key SetupState Size (bytes)
Encryption AlgorithmEncryption (per byte)Decryption (per byte)Key SetupState Size (bytes)
AES128 (ECB mode)36.90us66.48us160.00us208
AES128 (ECB mode)36.90us66.48us160.00us213
AES192 (ECB mode)44.20us80.35us166.54us240
AES192 (ECB mode)44.20us80.35us166.54us245
AES256 (ECB mode)51.50us94.22us227.97us272
AES256 (ECB mode)51.50us94.22us227.97us277
ChaCha (20 rounds)14.87us14.88us43.74us130
ChaCha (20 rounds)14.87us14.88us43.74us132
ChaCha (12 rounds)10.38us10.38us43.74us130
ChaCha (12 rounds)10.38us10.38us43.74us132
ChaCha (8 rounds)8.13us8.14us43.74us130
ChaCha (8 rounds)8.13us8.14us43.74us132
SHA121.90us93
SHA25643.85us105
AEAD AlgorithmEncryption (per byte)Decryption (per byte)Key SetupState Size (bytes)
SHA512123.24us209
ChaChaPoly41.23us41.23us902.55us255
SHA3_256121.69us403
GCM<AES128>186.47us186.42us1388.43us316
SHA3_512229.12us403
GCM<AES192>194.17us193.72us1628.67us348
BLAKE2s18.54us169
GCM<AES256>201.47us201.02us1923.78us380
BLAKE2b50.58us337
Hash AlgorithmHashing (per byte)FinalizationKey SetupState Size (bytes)
SHA121.90us95
SHA25643.85us107
SHA512123.24us211
SHA3_256121.69us405
SHA3_512229.12us405
BLAKE2s18.54us171
BLAKE2b50.58us339
Poly130526.29us87
GHASH148.14us33

Where a cipher supports more than one key size (such as ChaCha), the values are typically almost identical for 128-bit and 256-bit keys so only the maximum is shown above.

Public key algorithms have the following results on an Arduino Uno:

@@ -145,7 +167,7 @@ Performance
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/crypto_8dox.html b/crypto_8dox.html index f019c86f..90792c05 100644 --- a/crypto_8dox.html +++ b/crypto_8dox.html @@ -87,7 +87,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/crypto_rng.html b/crypto_rng.html index f9051d30..7aa4acfc 100644 --- a/crypto_rng.html +++ b/crypto_rng.html @@ -182,7 +182,7 @@ Destroying secret data
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/crypto_rng_ring.html b/crypto_rng_ring.html index 946ad738..eb761745 100644 --- a/crypto_rng_ring.html +++ b/crypto_rng_ring.html @@ -151,7 +151,7 @@ Connecting to the Arduino
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dir_1586d320a3b1e622174530fde769cda9.html b/dir_1586d320a3b1e622174530fde769cda9.html index 6d6b7e94..0508d2bb 100644 --- a/dir_1586d320a3b1e622174530fde769cda9.html +++ b/dir_1586d320a3b1e622174530fde769cda9.html @@ -102,7 +102,7 @@ Files
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dir_48f64e79f12bd77ba047e9e436ec978c.html b/dir_48f64e79f12bd77ba047e9e436ec978c.html index c0c28026..dd7490c4 100644 --- a/dir_48f64e79f12bd77ba047e9e436ec978c.html +++ b/dir_48f64e79f12bd77ba047e9e436ec978c.html @@ -122,7 +122,7 @@ Files
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dir_5e87a7229a108582288ef7eda1233dc3.html b/dir_5e87a7229a108582288ef7eda1233dc3.html index ed6058fe..a62fa9a0 100644 --- a/dir_5e87a7229a108582288ef7eda1233dc3.html +++ b/dir_5e87a7229a108582288ef7eda1233dc3.html @@ -94,7 +94,7 @@ Files
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dir_6591a2127a29f6cea3994dcb5b0596d1.html b/dir_6591a2127a29f6cea3994dcb5b0596d1.html index 6fdf4541..99c11c33 100644 --- a/dir_6591a2127a29f6cea3994dcb5b0596d1.html +++ b/dir_6591a2127a29f6cea3994dcb5b0596d1.html @@ -106,7 +106,7 @@ Files
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dir_9a34040863d1190c0e01b23e6b44de01.html b/dir_9a34040863d1190c0e01b23e6b44de01.html index eb8fada6..b4332a40 100644 --- a/dir_9a34040863d1190c0e01b23e6b44de01.html +++ b/dir_9a34040863d1190c0e01b23e6b44de01.html @@ -96,7 +96,7 @@ Files
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dir_bc0718b08fb2015b8e59c47b2805f60c.html b/dir_bc0718b08fb2015b8e59c47b2805f60c.html index 41a5ad21..59672634 100644 --- a/dir_bc0718b08fb2015b8e59c47b2805f60c.html +++ b/dir_bc0718b08fb2015b8e59c47b2805f60c.html @@ -108,7 +108,7 @@ Directories
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dir_be059bf9978ae156837504b1b8a7568c.html b/dir_be059bf9978ae156837504b1b8a7568c.html index 672ab798..54fcc17a 100644 --- a/dir_be059bf9978ae156837504b1b8a7568c.html +++ b/dir_be059bf9978ae156837504b1b8a7568c.html @@ -94,7 +94,7 @@ Files
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dir_e2ce51835550ba18edf07a8311722290.html b/dir_e2ce51835550ba18edf07a8311722290.html index 730f0780..e79c421d 100644 --- a/dir_e2ce51835550ba18edf07a8311722290.html +++ b/dir_e2ce51835550ba18edf07a8311722290.html @@ -96,6 +96,12 @@ Files   file  AESCommon.cpp [code]   +file  AuthenticatedCipher.cpp [code] +  +file  AuthenticatedCipher.h [code] +  +file  BigNumberUtil.h [code] +  file  BLAKE2b.cpp [code]   file  BLAKE2b.h [code] @@ -120,6 +126,10 @@ Files   file  ChaCha.h [code]   +file  ChaChaPoly.cpp [code] +  +file  ChaChaPoly.h [code] +  file  Cipher.cpp [code]   file  Cipher.h [code] @@ -136,6 +146,14 @@ Files   file  Curve25519.h [code]   +file  GCM.cpp [code] +  +file  GCM.h [code] +  +file  GHASH.cpp [code] +  +file  GHASH.h [code] +  file  Hash.cpp [code]   file  Hash.h [code] @@ -152,6 +170,10 @@ Files   file  OFB.h [code]   +file  Poly1305.cpp [code] +  +file  Poly1305.h [code] +  file  RingOscillatorNoiseSource.cpp [code]   file  RingOscillatorNoiseSource.h [code] @@ -184,7 +206,7 @@ Files
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dir_f34881fcf60f680b800190d5274dfaea.html b/dir_f34881fcf60f680b800190d5274dfaea.html index 0f54db8a..622b233a 100644 --- a/dir_f34881fcf60f680b800190d5274dfaea.html +++ b/dir_f34881fcf60f680b800190d5274dfaea.html @@ -106,7 +106,7 @@ Files
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dir_f9b96888882c2691b8eeaeafd1b9501d.html b/dir_f9b96888882c2691b8eeaeafd1b9501d.html index 05ffe78e..8d4e8104 100644 --- a/dir_f9b96888882c2691b8eeaeafd1b9501d.html +++ b/dir_f9b96888882c2691b8eeaeafd1b9501d.html @@ -102,7 +102,7 @@ Files
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dmd-demo_8dox.html b/dmd-demo_8dox.html index 16e0a7ef..e2c20904 100644 --- a/dmd-demo_8dox.html +++ b/dmd-demo_8dox.html @@ -87,7 +87,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dmd-running-figure_8dox.html b/dmd-running-figure_8dox.html index f36944a0..e3dd8987 100644 --- a/dmd-running-figure_8dox.html +++ b/dmd-running-figure_8dox.html @@ -87,7 +87,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dmd_demo.html b/dmd_demo.html index 1ac4b869..87d3afe8 100644 --- a/dmd_demo.html +++ b/dmd_demo.html @@ -236,7 +236,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/dmd_running_figure.html b/dmd_running_figure.html index 704a536b..5df74471 100644 --- a/dmd_running_figure.html +++ b/dmd_running_figure.html @@ -430,7 +430,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/files.html b/files.html index 938978f7..18f224c6 100644 --- a/files.html +++ b/files.html @@ -91,105 +91,116 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); o*AES192.cpp o*AES256.cpp o*AESCommon.cpp -o*Bitmap.cpp -o*Bitmap.h -o*BLAKE2b.cpp -o*BLAKE2b.h -o*BLAKE2s.cpp -o*BLAKE2s.h -o*BlinkLED.cpp -o*BlinkLED.h -o*BlockCipher.cpp -o*BlockCipher.h -o*BoolField.cpp -o*BoolField.h -o*CBC.cpp -o*CBC.h -o*CFB.cpp -o*CFB.h -o*ChaCha.cpp -o*ChaCha.h -o*Charlieplex.cpp -o*Charlieplex.h -o*ChaseLEDs.cpp -o*ChaseLEDs.h -o*Cipher.cpp -o*Cipher.h -o*Crypto.cpp -o*Crypto.h -o*CTR.cpp -o*CTR.h -o*Curve25519.cpp -o*Curve25519.h -o*DejaVuSans9.h -o*DejaVuSansBold9.h -o*DejaVuSansItalic9.h -o*DMD.cpp -o*DMD.h -o*DS1307RTC.cpp -o*DS1307RTC.h -o*DS3231RTC.cpp -o*DS3231RTC.h -o*DS3232RTC.cpp -o*DS3232RTC.h -o*EEPROM24.cpp -o*EEPROM24.h -o*Field.cpp -o*Field.h -o*Form.cpp -o*Form.h -o*Hash.cpp -o*Hash.h -o*I2CMaster.cpp -o*I2CMaster.h -o*IntField.cpp -o*IntField.h -o*IRreceiver.cpp -o*IRreceiver.h -o*KeccakCore.cpp -o*KeccakCore.h -o*LCD.cpp -o*LCD.h -o*ListField.cpp -o*ListField.h -o*Melody.cpp -o*Melody.h -o*Mono5x7.h -o*NoiseSource.cpp -o*NoiseSource.h -o*OFB.cpp -o*OFB.h -o*PowerSave.cpp -o*PowerSave.h -o*RC5.h -o*RingOscillatorNoiseSource.cpp -o*RingOscillatorNoiseSource.h -o*RNG.cpp -o*RNG.h -o*RTC.cpp -o*RTC.h -o*SHA1.cpp -o*SHA1.h -o*SHA256.cpp -o*SHA256.h -o*SHA3.cpp -o*SHA3.h -o*SHA512.cpp -o*SHA512.h -o*SoftI2C.cpp -o*SoftI2C.h -o*TextField.cpp -o*TextField.h -o*TimeField.cpp -o*TimeField.h -o*TransistorNoiseSource.cpp -\*TransistorNoiseSource.h +o*AuthenticatedCipher.cpp +o*AuthenticatedCipher.h +o*BigNumberUtil.h +o*Bitmap.cpp +o*Bitmap.h +o*BLAKE2b.cpp +o*BLAKE2b.h +o*BLAKE2s.cpp +o*BLAKE2s.h +o*BlinkLED.cpp +o*BlinkLED.h +o*BlockCipher.cpp +o*BlockCipher.h +o*BoolField.cpp +o*BoolField.h +o*CBC.cpp +o*CBC.h +o*CFB.cpp +o*CFB.h +o*ChaCha.cpp +o*ChaCha.h +o*ChaChaPoly.cpp +o*ChaChaPoly.h +o*Charlieplex.cpp +o*Charlieplex.h +o*ChaseLEDs.cpp +o*ChaseLEDs.h +o*Cipher.cpp +o*Cipher.h +o*Crypto.cpp +o*Crypto.h +o*CTR.cpp +o*CTR.h +o*Curve25519.cpp +o*Curve25519.h +o*DejaVuSans9.h +o*DejaVuSansBold9.h +o*DejaVuSansItalic9.h +o*DMD.cpp +o*DMD.h +o*DS1307RTC.cpp +o*DS1307RTC.h +o*DS3231RTC.cpp +o*DS3231RTC.h +o*DS3232RTC.cpp +o*DS3232RTC.h +o*EEPROM24.cpp +o*EEPROM24.h +o*Field.cpp +o*Field.h +o*Form.cpp +o*Form.h +o*GCM.cpp +o*GCM.h +o*GHASH.cpp +o*GHASH.h +o*Hash.cpp +o*Hash.h +o*I2CMaster.cpp +o*I2CMaster.h +o*IntField.cpp +o*IntField.h +o*IRreceiver.cpp +o*IRreceiver.h +o*KeccakCore.cpp +o*KeccakCore.h +o*LCD.cpp +o*LCD.h +o*ListField.cpp +o*ListField.h +o*Melody.cpp +o*Melody.h +o*Mono5x7.h +o*NoiseSource.cpp +o*NoiseSource.h +o*OFB.cpp +o*OFB.h +o*Poly1305.cpp +o*Poly1305.h +o*PowerSave.cpp +o*PowerSave.h +o*RC5.h +o*RingOscillatorNoiseSource.cpp +o*RingOscillatorNoiseSource.h +o*RNG.cpp +o*RNG.h +o*RTC.cpp +o*RTC.h +o*SHA1.cpp +o*SHA1.h +o*SHA256.cpp +o*SHA256.h +o*SHA3.cpp +o*SHA3.h +o*SHA512.cpp +o*SHA512.h +o*SoftI2C.cpp +o*SoftI2C.h +o*TextField.cpp +o*TextField.h +o*TimeField.cpp +o*TimeField.h +o*TransistorNoiseSource.cpp +\*TransistorNoiseSource.h
-Generated on Sun Mar 29 2015 08:30:14 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/functions.html b/functions.html index 3a542917..856aeeeb 100644 --- a/functions.html +++ b/functions.html @@ -123,6 +123,11 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
Here is a list of all documented class members with links to the class documentation for each member:

- a -

-Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
diff --git a/functions_func_l.html b/functions_func_l.html index f8e16f1c..9c5e24cf 100644 --- a/functions_func_l.html +++ b/functions_func_l.html @@ -129,7 +129,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); : Field
  • LCD() -: LCD +: LCD
  • led() : Charlieplex @@ -151,7 +151,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
    -Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
    diff --git a/functions_func_m.html b/functions_func_m.html index a5ef2b3f..f36b755f 100644 --- a/functions_func_m.html +++ b/functions_func_m.html @@ -142,7 +142,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
    -Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
    diff --git a/functions_func_n.html b/functions_func_n.html index 0a26e918..4eb24be5 100644 --- a/functions_func_n.html +++ b/functions_func_n.html @@ -138,7 +138,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
    -Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
    diff --git a/functions_func_o.html b/functions_func_o.html index 9f71ab9d..ad774ebe 100644 --- a/functions_func_o.html +++ b/functions_func_o.html @@ -141,7 +141,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
    -Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
    diff --git a/functions_func_p.html b/functions_func_p.html index 452ad531..63d0da43 100644 --- a/functions_func_p.html +++ b/functions_func_p.html @@ -123,7 +123,9 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');

    - p -

    -Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
    diff --git a/functions_l.html b/functions_l.html index 2d8ca2a6..6e46530c 100644 --- a/functions_l.html +++ b/functions_l.html @@ -130,7 +130,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); : Field
  • LCD() -: LCD +: LCD
  • led() : Charlieplex @@ -152,7 +152,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
    -Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
    diff --git a/functions_m.html b/functions_m.html index e6c1a508..38859503 100644 --- a/functions_m.html +++ b/functions_m.html @@ -150,7 +150,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
    -Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
    diff --git a/functions_n.html b/functions_n.html index fb662768..ae135254 100644 --- a/functions_n.html +++ b/functions_n.html @@ -145,7 +145,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
    -Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
    diff --git a/functions_o.html b/functions_o.html index 6abbf5e0..eca58d71 100644 --- a/functions_o.html +++ b/functions_o.html @@ -142,7 +142,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
    -Generated on Sun Mar 29 2015 08:30:13 for ArduinoLibs by   +Generated on Wed Apr 1 2015 16:36:10 for ArduinoLibs by   doxygen 1.8.6
    diff --git a/functions_p.html b/functions_p.html index 645ea309..250e580c 100644 --- a/functions_p.html +++ b/functions_p.html @@ -124,7 +124,9 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');

    - p -