// Copyright (c) 2014-2022, The Monero Project // // 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 COPYRIGHT HOLDERS AND CONTRIBUTORS "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 COPYRIGHT HOLDER OR CONTRIBUTORS 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. // // Parts of this file are originally copyright (c) 2012-2013 The Cryptonote developers /*! \file binary_archive.h * * Portable (low-endian) binary archive */ #pragma once #include #include #include #include #include #include "common/varint.h" #include "span.h" #include "warnings.h" /* I have no clue what these lines means */ PUSH_WARNINGS DISABLE_VS_WARNINGS(4244) //TODO: fix size_t warning in x32 platform /*! \struct binary_archive_base * * \brief base for the binary archive type * * \detailed It isn't used outside of this file, which its only * purpse is to define the functions used for the binary_archive. Its * a header, basically. I think it was declared simply to save typing... */ template struct binary_archive_base { typedef binary_archive_base base_type; typedef boost::mpl::bool_ is_saving; typedef uint8_t variant_tag_type; explicit binary_archive_base() { } /* definition of standard API functions */ void tag(const char *) { } void begin_object() { } void end_object() { } void begin_variant() { } void end_variant() { } }; /* \struct binary_archive * * \brief the actually binary archive type * * \detailed The boolean template argument /a W is the is_saving * parameter for binary_archive_base. * * The is_saving parameter says whether the archive is being read from * (false) or written to (true) */ template struct binary_archive; template <> struct binary_archive : public binary_archive_base { explicit binary_archive(epee::span s) : base_type(), bytes_(s), begin_(s.begin()), good_(true), varint_bug_backward_compatibility_(false) {} bool good() const noexcept { return good_; } void set_fail() noexcept { good_ = false; } //! If implementing as `std::istream`, reset stream error state after `peek()` call. bool eof() const noexcept { return bytes_.empty(); } std::size_t getpos() const noexcept { return bytes_.begin() - begin_; } template void serialize_int(T &v) { serialize_uint(*(typename boost::make_unsigned::type *)&v); } /*! \fn serialize_uint * * \brief serializes an unsigned integer */ template void serialize_uint(T &v) { const std::size_t actual = bytes_.remove_prefix(sizeof(T)); good_ &= (actual == sizeof(T)); if (actual == sizeof(T)) { std::memcpy(std::addressof(v), bytes_.data() - sizeof(T), sizeof(T)); boost::endian::little_to_native_inplace(v); // epee isn't templated } else v = 0; // ensures initialization } void serialize_blob(void *buf, size_t len, const char *delimiter="") { const std::size_t actual = bytes_.remove_prefix(len); good_ &= (len == actual); std::memcpy(buf, bytes_.data() - actual, actual); } template void serialize_varint(T &v) { serialize_uvarint(*(typename boost::make_unsigned::type *)(&v)); } template void serialize_uvarint(T &v) { auto current = bytes_.cbegin(); auto end = bytes_.cend(); good_ &= (0 <= tools::read_varint(current, end, v)); current = std::min(current, bytes_.cend()); bytes_ = {current, std::size_t(bytes_.cend() - current)}; } void begin_array(size_t &s) { serialize_varint(s); } void begin_array() { } void delimit_array() { } void end_array() { } void begin_string(const char *delimiter /*="\""*/) { } void end_string(const char *delimiter /*="\""*/) { } void read_variant_tag(variant_tag_type &t) { serialize_int(t); } size_t remaining_bytes() const noexcept { return good() ? bytes_.size() : 0; } void enable_varint_bug_backward_compatibility() { varint_bug_backward_compatibility_ = true; } bool varint_bug_backward_compatibility_enabled() const { return varint_bug_backward_compatibility_; } protected: epee::span bytes_; std::uint8_t const* const begin_; bool good_; bool varint_bug_backward_compatibility_; }; template <> struct binary_archive : public binary_archive_base { typedef std::ostream stream_type; explicit binary_archive(stream_type &s) : base_type(), stream_(s) { } bool good() const { return stream_.good(); } void set_fail() { stream_.setstate(std::ios::failbit); } std::streampos getpos() const { return stream_.tellp(); } template void serialize_int(T v) { serialize_uint(static_cast::type>(v)); } template void serialize_uint(T v) { for (size_t i = 0; i < sizeof(T); i++) { stream_.put((char)(v & 0xff)); if (1 < sizeof(T)) v >>= 8; } } void serialize_blob(void *buf, size_t len, const char *delimiter="") { stream_.write((char *)buf, len); } template void serialize_varint(T &v) { serialize_uvarint(*(typename boost::make_unsigned::type *)(&v)); } template void serialize_uvarint(T &v) { typedef std::ostreambuf_iterator it; tools::write_varint(it(stream_), v); } void begin_array(size_t s) { serialize_varint(s); } void begin_array() { } void delimit_array() { } void end_array() { } void begin_string(const char *delimiter="\"") { } void end_string(const char *delimiter="\"") { } void write_variant_tag(variant_tag_type t) { serialize_int(t); } bool varint_bug_backward_compatibility_enabled() const { return false; } protected: stream_type& stream_; }; POP_WARNINGS