virgil-crypto 2.0.2b0

data/ext/native/src/lib/include/virgil/crypto/internal/utils.h

@@ -0,0 +1,58 @@
+/**
+ * Copyright (C) 2015-2016 Virgil Security Inc.
+ *
+ * Lead Maintainer: Virgil Security Inc. <support@virgilsecurity.com>
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     (1) Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *     (2) Redistributions in binary form must reproduce the above copyright
+ *     notice, this list of conditions and the following disclaimer in
+ *     the documentation and/or other materials provided with the
+ *     distribution.
+ *
+ *     (3) Neither the name of the copyright holder nor the names of its
+ *     contributors may be used to endorse or promote products derived from
+ *     this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ''AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef VIRGIL_CRYPTO_INTERNAL_UTILS_H
+#define VIRGIL_CRYPTO_INTERNAL_UTILS_H
+
+#define VIRGIL_STR(var) #var
+
+// Define custom implemetation of std::make_unique() function
+#if !defined(__cpp_lib_make_unique)
+#if !defined(_MSC_VER) || _MSC_VER < 1800
+
+#include <memory>
+
+namespace std {
+template<typename T, typename... Args>
+std::unique_ptr<T> make_unique(Args&& ... args) {
+    return std::unique_ptr<T>(new T(std::forward<Args>(args)...));
+}
+}
+
+#endif // !defined(_MSC_VER) || _MSC_VER < 1800
+#endif // __cpp_lib_make_unique
+
+#endif // VIRGIL_CRYPTO_INTERNAL_UTILS_H

data/ext/native/src/lib/include/virgil/crypto/stream/VirgilBytesDataSink.h

@@ -0,0 +1,84 @@
+/**
+ * Copyright (C) 2015-2016 Virgil Security Inc.
+ *
+ * Lead Maintainer: Virgil Security Inc. <support@virgilsecurity.com>
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     (1) Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *     (2) Redistributions in binary form must reproduce the above copyright
+ *     notice, this list of conditions and the following disclaimer in
+ *     the documentation and/or other materials provided with the
+ *     distribution.
+ *
+ *     (3) Neither the name of the copyright holder nor the names of its
+ *     contributors may be used to endorse or promote products derived from
+ *     this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ''AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef VIRGIL_CRYPTO_VIRGIL_BYTES_DATA_SINK_H
+#define VIRGIL_CRYPTO_VIRGIL_BYTES_DATA_SINK_H
+
+#include <virgil/crypto/VirgilDataSink.h>
+
+namespace virgil { namespace crypto { namespace stream {
+
+/**
+ * @brief C++ Byte Array implementation of the VirgilDataSink class.
+ *
+ * @note This class CAN not be used in wrappers.
+ */
+class VirgilBytesDataSink : public virgil::crypto::VirgilDataSink {
+public:
+    /**
+     * @brief Creates data sink based on byte array.
+     */
+    explicit VirgilBytesDataSink(virgil::crypto::VirgilByteArray& out);
+
+    /**
+     * @brief Polymorphic destructor.
+     */
+    virtual ~VirgilBytesDataSink() noexcept;
+
+    /**
+     * @brief Overriding of @link VirgilDataSink::isGood() @endlink method.
+     */
+    virtual bool isGood();
+
+    /**
+     * @brief Overriding of @link VirgilDataSink::write() @endlink method.
+     */
+    virtual void write(const virgil::crypto::VirgilByteArray& data);
+
+    /**
+     * @brief Reset internal state to initial.
+     *
+     * Erase all data from the output byte array.
+     */
+    virtual void reset();
+
+private:
+    virgil::crypto::VirgilByteArray& out_;
+};
+
+}}}
+
+#endif /* VIRGIL_CRYPTO_VIRGIL_BYTES_DATA_SINK_H */

data/ext/native/src/lib/include/virgil/crypto/stream/VirgilBytesDataSource.h

@@ -0,0 +1,90 @@
+/**
+ * Copyright (C) 2015-2016 Virgil Security Inc.
+ *
+ * Lead Maintainer: Virgil Security Inc. <support@virgilsecurity.com>
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     (1) Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *     (2) Redistributions in binary form must reproduce the above copyright
+ *     notice, this list of conditions and the following disclaimer in
+ *     the documentation and/or other materials provided with the
+ *     distribution.
+ *
+ *     (3) Neither the name of the copyright holder nor the names of its
+ *     contributors may be used to endorse or promote products derived from
+ *     this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ''AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef VIRGIL_CRYPTO_VIRGIL_BYTES_DATA_SOURCE_H
+#define VIRGIL_CRYPTO_VIRGIL_BYTES_DATA_SOURCE_H
+
+#include <virgil/crypto/VirgilByteArray.h>
+#include <virgil/crypto/VirgilDataSource.h>
+
+namespace virgil { namespace crypto { namespace stream {
+
+/**
+ * @brief C++ Byte Array implementation of the VirgilDataSource class.
+ *
+ * @note This class CAN not be used in wrappers.
+ */
+class VirgilBytesDataSource : public virgil::crypto::VirgilDataSource {
+public:
+    /**
+     * @brief Creates data sink based on byte array.
+     * @param in - byte array.
+     * @param chunkSize - size of the data that will be returned by @link read() @endlink method.
+     *                    Note, the real value may be different from the given value, it is only recommendation.
+     */
+    explicit VirgilBytesDataSource(const virgil::crypto::VirgilByteArray& in, size_t chunkSize = 1);
+
+    /**
+     * @brief Polymorphic destructor.
+     */
+    virtual ~VirgilBytesDataSource() noexcept;
+
+    /**
+     * @brief Overriding of @link VirgilDataSource::hasData() @endlink method.
+     */
+    virtual bool hasData();
+
+    /**
+     * @brief Overriding of @link VirgilDataSource::read() @endlink method.
+     */
+    virtual virgil::crypto::VirgilByteArray read();
+
+    /**
+     * @brief Reset internal state to initial.
+     *
+     * This method can used for secondary data reading.
+     */
+    virtual void reset();
+
+private:
+    const virgil::crypto::VirgilByteArray& in_;
+    const size_t chunkSize_;
+    size_t leftBytes_;
+};
+
+}}}
+
+#endif /* VIRGIL_CRYPTO_VIRGIL_BYTES_DATA_SOURCE_H */

data/ext/native/src/lib/include/virgil/crypto/stream/VirgilStreamDataSink.h

@@ -0,0 +1,79 @@
+/**
+ * Copyright (C) 2015-2016 Virgil Security Inc.
+ *
+ * Lead Maintainer: Virgil Security Inc. <support@virgilsecurity.com>
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     (1) Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *     (2) Redistributions in binary form must reproduce the above copyright
+ *     notice, this list of conditions and the following disclaimer in
+ *     the documentation and/or other materials provided with the
+ *     distribution.
+ *
+ *     (3) Neither the name of the copyright holder nor the names of its
+ *     contributors may be used to endorse or promote products derived from
+ *     this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ''AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef VIRGIL_CRYPTO_VIRGIL_STREAM_DATA_SINK_H
+#define VIRGIL_CRYPTO_VIRGIL_STREAM_DATA_SINK_H
+
+#include <ostream>
+
+#include <virgil/crypto/VirgilDataSink.h>
+
+namespace virgil { namespace crypto { namespace stream {
+
+/**
+ * @brief C++ stream implementation of the VirgilDataSink class.
+ *
+ * @note This class CAN not be used in wrappers.
+ */
+class VirgilStreamDataSink : public virgil::crypto::VirgilDataSink {
+public:
+    /**
+     * @brief Creates data sink based on std::ostream object.
+     */
+    explicit VirgilStreamDataSink(std::ostream& out);
+
+    /**
+     * @brief Polymorphic destructor.
+     */
+    virtual ~VirgilStreamDataSink() noexcept;
+
+    /**
+     * @brief Overriding of @link VirgilDataSink::isGood() @endlink method.
+     */
+    virtual bool isGood();
+
+    /**
+     * @brief Overriding of @link VirgilDataSink::write() @endlink method.
+     */
+    virtual void write(const virgil::crypto::VirgilByteArray& data);
+
+private:
+    std::ostream& out_;
+};
+
+}}}
+
+#endif /* VIRGIL_CRYPTO_VIRGIL_STREAM_DATA_SINK_H */

data/ext/native/src/lib/include/virgil/crypto/stream/VirgilStreamDataSource.h

@@ -0,0 +1,84 @@
+/**
+ * Copyright (C) 2015-2016 Virgil Security Inc.
+ *
+ * Lead Maintainer: Virgil Security Inc. <support@virgilsecurity.com>
+ *
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *     (1) Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ *
+ *     (2) Redistributions in binary form must reproduce the above copyright
+ *     notice, this list of conditions and the following disclaimer in
+ *     the documentation and/or other materials provided with the
+ *     distribution.
+ *
+ *     (3) Neither the name of the copyright holder nor the names of its
+ *     contributors may be used to endorse or promote products derived from
+ *     this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ''AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef VIRGIL_CRYPTO_VIRGIL_STREAM_DATA_SOURCE_H
+#define VIRGIL_CRYPTO_VIRGIL_STREAM_DATA_SOURCE_H
+
+#include <istream>
+
+#include <virgil/crypto/VirgilByteArray.h>
+#include <virgil/crypto/VirgilDataSource.h>
+
+namespace virgil { namespace crypto { namespace stream {
+
+/**
+ * @brief C++ stream implementation of the VirgilDataSource class.
+ *
+ * @note This class CAN not be used in wrappers.
+ */
+class VirgilStreamDataSource : public virgil::crypto::VirgilDataSource {
+public:
+    /**
+     * @brief Creates data sink based on std::istream object.
+     * @param in - input stream.
+     * @param chunkSize - size of the data that will be returned by @link read() @endlink method.
+     *                    Note, the real value may be different from the given value, it is only recommendation.
+     */
+    explicit VirgilStreamDataSource(std::istream& in, size_t chunkSize = 4096);
+
+    /**
+     * @brief Polymorphic destructor.
+     */
+    virtual ~VirgilStreamDataSource() noexcept;
+
+    /**
+     * @brief Overriding of @link VirgilDataSource::hasData() @endlink method.
+     */
+    virtual bool hasData();
+
+    /**
+     * @brief Overriding of @link VirgilDataSource::read() @endlink method.
+     */
+    virtual virgil::crypto::VirgilByteArray read();
+
+private:
+    std::istream& in_;
+    size_t chunkSize_;
+};
+
+}}}
+
+#endif /* VIRGIL_CRYPTO_VIRGIL_STREAM_DATA_SOURCE_H */

data/ext/native/src/lib/mainpage.dox

@@ -0,0 +1,60 @@
+/**
+ * @mainpage Virgil Security Crypto library
+ *
+ * The Virgil Security Crypto library offers set of methods that allow encrypt, decrypt, sign and verify data.
+ */
+
+/**
+ * @namespace virgil
+ * @brief Root namespace for all Virgil Security libraries.
+ */
+
+/**
+ * @namespace virgil::crypto
+ * @brief This namespace contains interfaces for high-level crypto operations,
+ *     i.e. generate key pair, encrypt and decrypt data, sign and verify data.
+ */
+
+/**
+ * @namespace virgil::crypto::foundation
+ * @brief This namespace contains interfaces for low-level crypto operations.
+ */
+
+/**
+ * @namespace virgil::crypto::foundation::asn1
+ * @brief This namespace contains interfaces for ASN.1 data manipulation.
+ */
+
+/**
+ * @namespace virgil::crypto::foundation::cms
+ * @brief This namespace contains interfaces for CMS data manipulation.
+ */
+
+/**
+ * @namespace virgil::crypto::stream
+ * @brief This namespace contains interfaces for stream data processing in crypto algorithms.
+ */
+
+/**
+ * @defgroup Error
+ *
+ * @brief This group contains interfaces for error handling mechanism that is used in the library.
+ */
+
+/**
+ * @defgroup Hash
+ *
+ * @brief This group contains interfaces for producing cryptographic hashes.
+ */
+
+/**
+ * @defgroup KDF
+ *
+ * @brief This group contains interfaces to Key Derivation Function algorithms.
+ */
+
+/**
+ * @defgroup Cipher
+ *
+ * @brief This group contains interfaces to encryption and to decryption algorithms.
+ */