LCOV - code coverage report
Current view: top level - src/util - asmap.cpp (source / functions) Coverage Total Hit
Test: total_coverage.info Lines: 91.9 % 123 113
Test Date: 2024-11-04 05:10:19 Functions: 100.0 % 8 8
Branches: 58.8 % 148 87

             Branch data     Line data    Source code
       1                 :             : // Copyright (c) 2019-2022 The Bitcoin Core developers
       2                 :             : // Distributed under the MIT software license, see the accompanying
       3                 :             : // file COPYING or http://www.opensource.org/licenses/mit-license.php.
       4                 :             : 
       5                 :             : #include <util/asmap.h>
       6                 :             : 
       7                 :             : #include <clientversion.h>
       8                 :             : #include <logging.h>
       9                 :             : #include <serialize.h>
      10                 :             : #include <streams.h>
      11                 :             : #include <util/fs.h>
      12                 :             : 
      13                 :             : #include <algorithm>
      14                 :             : #include <bit>
      15                 :             : #include <cassert>
      16                 :             : #include <cstdio>
      17                 :             : #include <utility>
      18                 :             : #include <vector>
      19                 :             : 
      20                 :             : namespace {
      21                 :             : 
      22                 :             : constexpr uint32_t INVALID = 0xFFFFFFFF;
      23                 :             : 
      24                 :      119378 : uint32_t DecodeBits(std::vector<bool>::const_iterator& bitpos, const std::vector<bool>::const_iterator& endpos, uint8_t minval, const std::vector<uint8_t> &bit_sizes)
      25                 :             : {
      26                 :      119378 :     uint32_t val = minval;
      27                 :      119378 :     bool bit;
      28                 :      119378 :     for (std::vector<uint8_t>::const_iterator bit_sizes_it = bit_sizes.begin();
      29         [ +  - ]:      592897 :         bit_sizes_it != bit_sizes.end(); ++bit_sizes_it) {
      30         [ +  + ]:      592897 :         if (bit_sizes_it + 1 != bit_sizes.end()) {
      31         [ -  + ]:      490596 :             if (bitpos == endpos) break;
      32                 :      490596 :             bit = *bitpos;
      33                 :      490596 :             bitpos++;
      34                 :             :         } else {
      35                 :             :             bit = 0;
      36                 :             :         }
      37         [ +  + ]:      592897 :         if (bit) {
      38                 :      473519 :             val += (1 << *bit_sizes_it);
      39                 :             :         } else {
      40         [ +  + ]:      667893 :             for (int b = 0; b < *bit_sizes_it; b++) {
      41         [ -  + ]:      548515 :                 if (bitpos == endpos) return INVALID; // Reached EOF in mantissa
      42                 :      548515 :                 bit = *bitpos;
      43                 :      548515 :                 bitpos++;
      44                 :      548515 :                 val += bit << (*bit_sizes_it - 1 - b);
      45                 :             :             }
      46                 :             :             return val;
      47                 :             :         }
      48                 :             :     }
      49                 :             :     return INVALID; // Reached EOF in exponent
      50                 :             : }
      51                 :             : 
      52                 :             : enum class Instruction : uint32_t
      53                 :             : {
      54                 :             :     RETURN = 0,
      55                 :             :     JUMP = 1,
      56                 :             :     MATCH = 2,
      57                 :             :     DEFAULT = 3,
      58                 :             : };
      59                 :             : 
      60                 :             : const std::vector<uint8_t> TYPE_BIT_SIZES{0, 0, 1};
      61                 :       59689 : Instruction DecodeType(std::vector<bool>::const_iterator& bitpos, const std::vector<bool>::const_iterator& endpos)
      62                 :             : {
      63                 :       59689 :     return Instruction(DecodeBits(bitpos, endpos, 0, TYPE_BIT_SIZES));
      64                 :             : }
      65                 :             : 
      66                 :             : const std::vector<uint8_t> ASN_BIT_SIZES{15, 16, 17, 18, 19, 20, 21, 22, 23, 24};
      67                 :        3776 : uint32_t DecodeASN(std::vector<bool>::const_iterator& bitpos, const std::vector<bool>::const_iterator& endpos)
      68                 :             : {
      69                 :        3776 :     return DecodeBits(bitpos, endpos, 1, ASN_BIT_SIZES);
      70                 :             : }
      71                 :             : 
      72                 :             : 
      73                 :             : const std::vector<uint8_t> MATCH_BIT_SIZES{1, 2, 3, 4, 5, 6, 7, 8};
      74                 :       51324 : uint32_t DecodeMatch(std::vector<bool>::const_iterator& bitpos, const std::vector<bool>::const_iterator& endpos)
      75                 :             : {
      76                 :       51324 :     return DecodeBits(bitpos, endpos, 2, MATCH_BIT_SIZES);
      77                 :             : }
      78                 :             : 
      79                 :             : 
      80                 :             : const std::vector<uint8_t> JUMP_BIT_SIZES{5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30};
      81                 :        4589 : uint32_t DecodeJump(std::vector<bool>::const_iterator& bitpos, const std::vector<bool>::const_iterator& endpos)
      82                 :             : {
      83                 :        4589 :     return DecodeBits(bitpos, endpos, 17, JUMP_BIT_SIZES);
      84                 :             : }
      85                 :             : 
      86                 :             : }
      87                 :             : 
      88                 :        4191 : uint32_t Interpret(const std::vector<bool> &asmap, const std::vector<bool> &ip)
      89                 :             : {
      90                 :        4191 :     std::vector<bool>::const_iterator pos = asmap.begin();
      91                 :        4191 :     const std::vector<bool>::const_iterator endpos = asmap.end();
      92                 :        4191 :     uint8_t bits = ip.size();
      93                 :        4191 :     uint32_t default_asn = 0;
      94                 :        4191 :     uint32_t jump, match, matchlen;
      95                 :        4191 :     Instruction opcode;
      96         [ -  + ]:       59472 :     while (pos != endpos) {
      97                 :       59472 :         opcode = DecodeType(pos, endpos);
      98         [ +  + ]:       59472 :         if (opcode == Instruction::RETURN) {
      99                 :        3713 :             default_asn = DecodeASN(pos, endpos);
     100         [ -  + ]:        3713 :             if (default_asn == INVALID) break; // ASN straddles EOF
     101                 :             :             return default_asn;
     102         [ +  + ]:       55759 :         } else if (opcode == Instruction::JUMP) {
     103                 :        4533 :             jump = DecodeJump(pos, endpos);
     104         [ +  - ]:        4533 :             if (jump == INVALID) break; // Jump offset straddles EOF
     105         [ +  - ]:        4533 :             if (bits == 0) break; // No input bits left
     106   [ -  +  +  - ]:        9066 :             if (int64_t{jump} >= int64_t{endpos - pos}) break; // Jumping past EOF
     107         [ +  + ]:        4533 :             if (ip[ip.size() - bits]) {
     108                 :        3656 :                 pos += jump;
     109                 :             :             }
     110                 :        4533 :             bits--;
     111         [ +  - ]:       51226 :         } else if (opcode == Instruction::MATCH) {
     112                 :       51226 :             match = DecodeMatch(pos, endpos);
     113         [ +  - ]:       51226 :             if (match == INVALID) break; // Match bits straddle EOF
     114         [ +  - ]:       51226 :             matchlen = std::bit_width(match) - 1;
     115         [ +  - ]:       51226 :             if (bits < matchlen) break; // Not enough input bits
     116         [ +  + ]:      458536 :             for (uint32_t bit = 0; bit < matchlen; bit++) {
     117         [ +  + ]:      407788 :                 if ((ip[ip.size() - bits]) != ((match >> (matchlen - 1 - bit)) & 1)) {
     118                 :             :                     return default_asn;
     119                 :             :                 }
     120                 :      407310 :                 bits--;
     121                 :             :             }
     122         [ #  # ]:           0 :         } else if (opcode == Instruction::DEFAULT) {
     123                 :           0 :             default_asn = DecodeASN(pos, endpos);
     124         [ #  # ]:           0 :             if (default_asn == INVALID) break; // ASN straddles EOF
     125                 :             :         } else {
     126                 :             :             break; // Instruction straddles EOF
     127                 :             :         }
     128                 :             :     }
     129                 :           0 :     assert(false); // Reached EOF without RETURN, or aborted (see any of the breaks above) - should have been caught by SanityCheckASMap below
     130                 :             :     return 0; // 0 is not a valid ASN
     131                 :             : }
     132                 :             : 
     133                 :           8 : bool SanityCheckASMap(const std::vector<bool>& asmap, int bits)
     134                 :             : {
     135         [ +  - ]:           8 :     const std::vector<bool>::const_iterator begin = asmap.begin(), endpos = asmap.end();
     136                 :           8 :     std::vector<bool>::const_iterator pos = begin;
     137                 :           8 :     std::vector<std::pair<uint32_t, int>> jumps; // All future positions we may jump to (bit offset in asmap -> bits to consume left)
     138         [ +  - ]:           8 :     jumps.reserve(bits);
     139                 :             :     Instruction prevopcode = Instruction::JUMP;
     140                 :             :     bool had_incomplete_match = false;
     141         [ -  + ]:         218 :     while (pos != endpos) {
     142         [ +  + ]:         217 :         uint32_t offset = pos - begin;
     143   [ +  +  +  - ]:         217 :         if (!jumps.empty() && offset >= jumps.back().first) return false; // There was a jump into the middle of the previous instruction
     144                 :         217 :         Instruction opcode = DecodeType(pos, endpos);
     145         [ +  + ]:         217 :         if (opcode == Instruction::RETURN) {
     146         [ +  - ]:          63 :             if (prevopcode == Instruction::DEFAULT) return false; // There should not be any RETURN immediately after a DEFAULT (could be combined into just RETURN)
     147                 :          63 :             uint32_t asn = DecodeASN(pos, endpos);
     148         [ +  - ]:          63 :             if (asn == INVALID) return false; // ASN straddles EOF
     149         [ +  + ]:          63 :             if (jumps.empty()) {
     150                 :             :                 // Nothing to execute anymore
     151   [ -  +  +  - ]:          14 :                 if (endpos - pos > 7) return false; // Excessive padding
     152         [ -  + ]:          29 :                 while (pos != endpos) {
     153         [ +  - ]:          14 :                     if (*pos) return false; // Nonzero padding bit
     154                 :          14 :                     ++pos;
     155                 :             :                 }
     156                 :             :                 return true; // Sanely reached EOF
     157                 :             :             } else {
     158                 :             :                 // Continue by pretending we jumped to the next instruction
     159         [ -  + ]:          56 :                 offset = pos - begin;
     160         [ +  - ]:          56 :                 if (offset != jumps.back().first) return false; // Unreachable code
     161                 :          56 :                 bits = jumps.back().second; // Restore the number of bits we would have had left after this jump
     162                 :          56 :                 jumps.pop_back();
     163                 :          56 :                 prevopcode = Instruction::JUMP;
     164                 :             :             }
     165         [ +  + ]:         154 :         } else if (opcode == Instruction::JUMP) {
     166                 :          56 :             uint32_t jump = DecodeJump(pos, endpos);
     167         [ +  - ]:          56 :             if (jump == INVALID) return false; // Jump offset straddles EOF
     168   [ -  +  +  - ]:         112 :             if (int64_t{jump} > int64_t{endpos - pos}) return false; // Jump out of range
     169         [ +  - ]:          56 :             if (bits == 0) return false; // Consuming bits past the end of the input
     170                 :          56 :             --bits;
     171         [ +  + ]:          56 :             uint32_t jump_offset = pos - begin + jump;
     172   [ +  +  +  - ]:          56 :             if (!jumps.empty() && jump_offset >= jumps.back().first) return false; // Intersecting jumps
     173         [ +  - ]:          56 :             jumps.emplace_back(jump_offset, bits);
     174                 :             :             prevopcode = Instruction::JUMP;
     175         [ +  - ]:          98 :         } else if (opcode == Instruction::MATCH) {
     176                 :          98 :             uint32_t match = DecodeMatch(pos, endpos);
     177         [ +  - ]:          98 :             if (match == INVALID) return false; // Match bits straddle EOF
     178         [ +  - ]:          98 :             int matchlen = std::bit_width(match) - 1;
     179         [ +  + ]:          98 :             if (prevopcode != Instruction::MATCH) had_incomplete_match = false;
     180         [ +  - ]:          98 :             if (matchlen < 8 && had_incomplete_match) return false; // Within a sequence of matches only at most one should be incomplete
     181                 :          98 :             had_incomplete_match = (matchlen < 8);
     182         [ +  - ]:          98 :             if (bits < matchlen) return false; // Consuming bits past the end of the input
     183                 :          98 :             bits -= matchlen;
     184                 :          98 :             prevopcode = Instruction::MATCH;
     185         [ #  # ]:           0 :         } else if (opcode == Instruction::DEFAULT) {
     186         [ #  # ]:           0 :             if (prevopcode == Instruction::DEFAULT) return false; // There should not be two successive DEFAULTs (they could be combined into one)
     187                 :           0 :             uint32_t asn = DecodeASN(pos, endpos);
     188         [ #  # ]:           0 :             if (asn == INVALID) return false; // ASN straddles EOF
     189                 :             :             prevopcode = Instruction::DEFAULT;
     190                 :             :         } else {
     191                 :             :             return false; // Instruction straddles EOF
     192                 :             :         }
     193                 :             :     }
     194                 :             :     return false; // Reached EOF without RETURN instruction
     195                 :           8 : }
     196                 :             : 
     197                 :           8 : std::vector<bool> DecodeAsmap(fs::path path)
     198                 :             : {
     199                 :           8 :     std::vector<bool> bits;
     200         [ +  - ]:           8 :     FILE *filestr = fsbridge::fopen(path, "rb");
     201         [ +  - ]:           8 :     AutoFile file{filestr};
     202         [ -  + ]:           8 :     if (file.IsNull()) {
     203         [ #  # ]:           0 :         LogPrintf("Failed to open asmap file from disk\n");
     204                 :           0 :         return bits;
     205                 :             :     }
     206         [ +  - ]:           8 :     file.seek(0, SEEK_END);
     207         [ +  - ]:           8 :     int length = file.tell();
     208   [ +  -  +  - ]:          16 :     LogPrintf("Opened asmap file %s (%d bytes) from disk\n", fs::quoted(fs::PathToString(path)), length);
     209         [ +  - ]:           8 :     file.seek(0, SEEK_SET);
     210                 :             :     uint8_t cur_byte;
     211         [ +  + ]:         421 :     for (int i = 0; i < length; ++i) {
     212         [ +  - ]:         413 :         file >> cur_byte;
     213         [ +  + ]:        3717 :         for (int bit = 0; bit < 8; ++bit) {
     214         [ +  - ]:        3304 :             bits.push_back((cur_byte >> bit) & 1);
     215                 :             :         }
     216                 :             :     }
     217   [ +  -  +  + ]:           8 :     if (!SanityCheckASMap(bits, 128)) {
     218   [ +  -  +  - ]:           2 :         LogPrintf("Sanity check of asmap file %s failed\n", fs::quoted(fs::PathToString(path)));
     219                 :           1 :         return {};
     220                 :             :     }
     221                 :           7 :     return bits;
     222                 :           8 : }
     223                 :             : 
        

Generated by: LCOV version 2.0-1