/* * Copyright (c) 2016, Intel Corporation * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * 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. * * Neither the name of Intel Corporation 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 OWNER 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. */ /** * \file * \brief Rose build: code for constructing literal tables. */ #include "rose_build_matchers.h" #include "rose_build_impl.h" #include "rose_build_width.h" #include "hwlm/hwlm_build.h" #include "hwlm/hwlm_literal.h" #include "nfa/castlecompile.h" #include "util/charreach_util.h" #include "util/compile_context.h" #include "util/compile_error.h" #include "util/dump_charclass.h" #include "util/report.h" #include "util/report_manager.h" #include "ue2common.h" #include #include #include using namespace std; using boost::adaptors::map_values; namespace ue2 { #ifdef DEBUG static UNUSED string dumpMask(const vector &v) { ostringstream oss; for (u8 e : v) { oss << setfill('0') << setw(2) << hex << (unsigned int)e; } return oss.str(); } #endif static bool maskFromLeftGraph(const LeftEngInfo &left, vector &msk, vector &cmp) { const u32 lag = left.lag; const ReportID report = left.leftfix_report; DEBUG_PRINTF("leftfix with lag %u, report %u\n", lag, report); assert(left.graph); const NGHolder &h = *left.graph; assert(in_degree(h.acceptEod, h) == 1); // no eod reports // Start with the set of reporter vertices for this leftfix. set curr; for (auto u : inv_adjacent_vertices_range(h.accept, h)) { if (contains(h[u].reports, report)) { curr.insert(u); } } assert(!curr.empty()); size_t i = HWLM_MASKLEN - lag - 1; do { if (curr.empty() || contains(curr, h.start) || contains(curr, h.startDs)) { DEBUG_PRINTF("end of the road\n"); break; } set next; CharReach cr; for (NFAVertex v : curr) { const auto &v_cr = h[v].char_reach; DEBUG_PRINTF("vertex %u, reach %s\n", h[v].index, describeClass(v_cr).c_str()); cr |= v_cr; insert(&next, inv_adjacent_vertices(v, h)); } make_and_cmp_mask(cr, &msk.at(i), &cmp.at(i)); DEBUG_PRINTF("%zu: reach=%s, msk=%u, cmp=%u\n", i, describeClass(cr).c_str(), msk[i], cmp[i]); curr.swap(next); } while (i-- > 0); return true; } static bool maskFromLeftCastle(const LeftEngInfo &left, vector &msk, vector &cmp) { const u32 lag = left.lag; const ReportID report = left.leftfix_report; DEBUG_PRINTF("leftfix with lag %u, report %u\n", lag, report); assert(left.castle); const CastleProto &c = *left.castle; depth min_width(depth::infinity()); for (const PureRepeat &repeat : c.repeats | map_values) { if (contains(repeat.reports, report)) { min_width = min(min_width, repeat.bounds.min); } } DEBUG_PRINTF("castle min width for this report is %s\n", min_width.str().c_str()); if (!min_width.is_finite() || min_width == depth(0)) { DEBUG_PRINTF("bad min width\n"); return false; } u32 len = min_width; u32 end = HWLM_MASKLEN - lag; for (u32 i = end; i > end - min(end, len); i--) { make_and_cmp_mask(c.reach(), &msk.at(i - 1), &cmp.at(i - 1)); } return true; } static bool maskFromLeft(const LeftEngInfo &left, vector &msk, vector &cmp) { if (left.lag >= HWLM_MASKLEN) { DEBUG_PRINTF("too much lag\n"); return false; } if (left.graph) { return maskFromLeftGraph(left, msk, cmp); } else if (left.castle) { return maskFromLeftCastle(left, msk, cmp); } return false; } static bool maskFromPreds(const RoseBuildImpl &build, const rose_literal_id &id, const RoseVertex v, vector &msk, vector &cmp) { const RoseGraph &g = build.g; // For right now, wuss out and only handle cases with one pred. if (in_degree(v, g) != 1) { return false; } // Root successors have no literal before them. if (build.isRootSuccessor(v)) { return false; } // If we have a single predecessor with a short bound, we may be able to // fill out a mask with the trailing bytes of the previous literal. This // allows us to improve literals like the 'bar' in 'fo.bar'. RoseEdge e = *(in_edges(v, g).first); u32 bound = g[e].maxBound; if (bound != g[e].minBound || bound >= HWLM_MASKLEN) { return false; } bound += id.s.length(); if (bound >= HWLM_MASKLEN) { return false; } DEBUG_PRINTF("bound %u\n", bound); RoseVertex u = source(e, g); if (g[u].literals.size() != 1) { DEBUG_PRINTF("u has %zu literals\n", g[u].literals.size()); return false; } u32 u_lit_id = *(g[u].literals.begin()); const rose_literal_id &u_id = build.literals.right.at(u_lit_id); DEBUG_PRINTF("u has lit: %s\n", escapeString(u_id.s).c_str()); // Number of characters to take from the back of u's literal. size_t u_len = u_id.s.length(); size_t u_sublen = min(u_len, (size_t)HWLM_MASKLEN - bound); size_t i = HWLM_MASKLEN - (bound + u_sublen); ue2_literal::const_iterator it, ite; for (it = u_id.s.begin() + (u_len - u_sublen), ite = u_id.s.end(); it != ite; ++it) { make_and_cmp_mask(*it, &msk.at(i), &cmp.at(i)); ++i; } return true; } static bool findHamsterMask(const RoseBuildImpl &build, const rose_literal_id &id, const rose_literal_info &info, const RoseVertex v, vector &msk, vector &cmp) { // Start with zero masks. msk.assign(HWLM_MASKLEN, 0); cmp.assign(HWLM_MASKLEN, 0); // Masks can come from literal benefits (for mixed-case literals). if (info.requires_benefits) { assert(mixed_sensitivity(id.s)); size_t j = 0; for (ue2_literal::const_reverse_iterator it = id.s.rbegin(), ite = id.s.rend(); it != ite && j < HWLM_MASKLEN; ++it, ++j) { size_t offset = HWLM_MASKLEN - j - 1; const CharReach &cr = *it; make_and_cmp_mask(cr, &msk[offset], &cmp[offset]); } return true; } const LeftEngInfo &left = build.g[v].left; if (left && left.lag < HWLM_MASKLEN) { if (maskFromLeft(left, msk, cmp)) { DEBUG_PRINTF("mask from a leftfix!\n"); return true; } } if (id.s.length() < HWLM_MASKLEN) { if (maskFromPreds(build, id, v, msk, cmp)) { DEBUG_PRINTF("mask from preds!\n"); return true; } } return false; } static bool hamsterMaskCombine(vector &msk, vector &cmp, const vector &v_msk, const vector &v_cmp) { assert(msk.size() == HWLM_MASKLEN && cmp.size() == HWLM_MASKLEN); assert(v_msk.size() == HWLM_MASKLEN && v_cmp.size() == HWLM_MASKLEN); u8 all_masks = 0; for (size_t i = 0; i < HWLM_MASKLEN; i++) { u8 filter = ~(cmp[i] ^ v_cmp[i]); msk[i] &= v_msk[i]; msk[i] &= filter; cmp[i] &= filter; all_masks |= msk[i]; } // Return false if we have no bits on in any mask elements. return all_masks != 0; } static bool findHamsterMask(const RoseBuildImpl &build, const rose_literal_id &id, const rose_literal_info &info, vector &msk, vector &cmp) { if (!build.cc.grey.roseHamsterMasks) { return false; } if (!info.delayed_ids.empty()) { // Not safe to add masks to delayed literals at this late stage. return false; } size_t num = 0; vector v_msk, v_cmp; for (RoseVertex v : info.vertices) { if (!findHamsterMask(build, id, info, v, v_msk, v_cmp)) { DEBUG_PRINTF("no mask\n"); return false; } if (!num++) { // First (or only) vertex, this becomes the mask/cmp pair. msk = v_msk; cmp = v_cmp; } else { // Multiple vertices with potentially different masks. We combine // them into an 'advisory' mask. if (!hamsterMaskCombine(msk, cmp, v_msk, v_cmp)) { DEBUG_PRINTF("mask went to zero\n"); return false; } } } normaliseLiteralMask(id.s, msk, cmp); if (msk.empty()) { DEBUG_PRINTF("no mask\n"); return false; } DEBUG_PRINTF("msk=%s, cmp=%s\n", dumpMask(msk).c_str(), dumpMask(cmp).c_str()); return true; } void findMoreLiteralMasks(RoseBuildImpl &build) { if (!build.cc.grey.roseHamsterMasks) { return; } vector candidates; for (const auto &e : build.literals.right) { const u32 id = e.first; const auto &lit = e.second; // This pass takes place before final IDs are assigned to literals. assert(!build.hasFinalId(id)); if (lit.delay || build.isDelayed(id)) { continue; } // Literal masks are only allowed for literals that will end up in an // HWLM table. switch (lit.table) { case ROSE_FLOATING: case ROSE_EOD_ANCHORED: case ROSE_ANCHORED_SMALL_BLOCK: break; default: continue; } if (!lit.msk.empty()) { continue; } const auto &lit_info = build.literal_info.at(id); if (lit_info.requires_benefits) { continue; } candidates.push_back(id); } for (const u32 &id : candidates) { const auto &lit = build.literals.right.at(id); auto &lit_info = build.literal_info.at(id); vector msk, cmp; if (!findHamsterMask(build, lit, lit_info, msk, cmp)) { continue; } assert(!msk.empty()); DEBUG_PRINTF("found advisory mask for lit_id=%u\n", id); u32 new_id = build.getLiteralId(lit.s, msk, cmp, lit.delay, lit.table); assert(new_id != id); DEBUG_PRINTF("replacing with new lit_id=%u\n", new_id); // Note that our new literal may already exist and have vertices, etc. // We assume that this transform is happening prior to group assignment. assert(lit_info.group_mask == 0); auto &new_info = build.literal_info.at(new_id); new_info.vertices.insert(begin(lit_info.vertices), end(lit_info.vertices)); for (auto v : lit_info.vertices) { build.g[v].literals.erase(id); build.g[v].literals.insert(new_id); } lit_info.vertices.clear(); } } static bool isDirectHighlander(const RoseBuildImpl &build, const u32 id, const rose_literal_info &info) { if (!build.isDirectReport(id)) { return false; } auto is_simple_exhaustible = [&build](ReportID id) { const Report &report = build.rm.getReport(id); return isSimpleExhaustible(report); }; assert(!info.vertices.empty()); for (const auto &v : info.vertices) { const auto &reports = build.g[v].reports; assert(!reports.empty()); if (!all_of(begin(reports), end(reports), is_simple_exhaustible)) { return false; } } return true; } // Called by isNoRunsLiteral below. static bool isNoRunsVertex(const RoseBuildImpl &build, RoseVertex u) { const RoseGraph &g = build.g; if (!g[u].isBoring()) { DEBUG_PRINTF("u=%zu is not boring\n", g[u].idx); return false; } if (!g[u].reports.empty()) { DEBUG_PRINTF("u=%zu has accept\n", g[u].idx); return false; } /* TODO: handle non-root roles as well. It can't be that difficult... */ if (!in_degree_equal_to(u, g, 1)) { DEBUG_PRINTF("u=%zu is not a root role\n", g[u].idx); return false; } RoseEdge e; bool exists; tie(e, exists) = edge_by_target(build.root, u, g); if (!exists) { DEBUG_PRINTF("u=%zu is not a root role\n", g[u].idx); return false; } if (g[e].minBound != 0 || g[e].maxBound != ROSE_BOUND_INF) { DEBUG_PRINTF("u=%zu has bounds from root\n", g[u].idx); return false; } for (const auto &oe : out_edges_range(u, g)) { RoseVertex v = target(oe, g); if (g[oe].maxBound != ROSE_BOUND_INF) { DEBUG_PRINTF("edge (%zu,%zu) has max bound\n", g[u].idx, g[target(oe, g)].idx); return false; } if (g[v].left) { DEBUG_PRINTF("v=%zu has rose prefix\n", g[v].idx); return false; } } return true; } static bool isNoRunsLiteral(const RoseBuildImpl &build, const u32 id, const rose_literal_info &info) { DEBUG_PRINTF("lit id %u\n", id); if (info.requires_benefits) { DEBUG_PRINTF("requires benefits\n"); // which would need confirm return false; } if (isDirectHighlander(build, id, info)) { DEBUG_PRINTF("highlander direct report\n"); return true; } // Undelayed vertices. for (RoseVertex v : info.vertices) { if (!isNoRunsVertex(build, v)) { return false; } } // Delayed vertices. for (u32 d : info.delayed_ids) { assert(d < build.literal_info.size()); const rose_literal_info &delayed_info = build.literal_info.at(d); assert(delayed_info.undelayed_id == id); for (RoseVertex v : delayed_info.vertices) { if (!isNoRunsVertex(build, v)) { return false; } } } DEBUG_PRINTF("is no-runs literal\n"); return true; } vector fillHamsterLiteralList(const RoseBuildImpl &build, rose_literal_table table) { vector lits; for (const auto &e : build.literals.right) { const u32 id = e.first; if (!build.hasFinalId(id)) { continue; } if (e.second.delay) { continue; /* delay id's are virtual-ish */ } if (e.second.table != table) { continue; /* wrong table */ } assert(id < build.literal_info.size()); const rose_literal_info &info = build.literal_info[id]; u32 final_id = info.final_id; rose_group groups = info.group_mask; /* Note: requires_benefits are handled in the literal entries */ const ue2_literal &lit = e.second.s; DEBUG_PRINTF("lit='%s'\n", escapeString(lit).c_str()); const vector &msk = e.second.msk; const vector &cmp = e.second.cmp; bool noruns = isNoRunsLiteral(build, id, info); if (info.requires_explode) { DEBUG_PRINTF("exploding lit\n"); const vector empty_msk; // msk/cmp will be empty case_iter cit = caseIterateBegin(lit); case_iter cite = caseIterateEnd(); for (; cit != cite; ++cit) { DEBUG_PRINTF("id=%u, s='%s', nocase=%d, noruns=%d msk=%s, " "cmp=%s (exploded)\n", final_id, escapeString(lit.get_string()).c_str(), 0, noruns, dumpMask(msk).c_str(), dumpMask(cmp).c_str()); lits.emplace_back(*cit, false, noruns, final_id, groups, empty_msk, empty_msk); } } else { const std::string &s = lit.get_string(); const bool nocase = lit.any_nocase(); DEBUG_PRINTF("id=%u, s='%s', nocase=%d, noruns=%d, msk=%s, " "cmp=%s\n", final_id, escapeString(s).c_str(), (int)nocase, noruns, dumpMask(msk).c_str(), dumpMask(cmp).c_str()); if (!maskIsConsistent(s, nocase, msk, cmp)) { DEBUG_PRINTF("msk/cmp for literal can't match, skipping\n"); continue; } lits.emplace_back(s, nocase, noruns, final_id, groups, msk, cmp); } } return lits; } aligned_unique_ptr buildFloatingMatcher(const RoseBuildImpl &build, rose_group *fgroups, size_t *fsize, size_t *historyRequired, size_t *streamStateRequired) { *fsize = 0; *fgroups = 0; auto fl = fillHamsterLiteralList(build, ROSE_FLOATING); if (fl.empty()) { DEBUG_PRINTF("empty floating matcher\n"); return nullptr; } for (const hwlmLiteral &hlit : fl) { *fgroups |= hlit.groups; } hwlmStreamingControl ctl; hwlmStreamingControl *ctlp; if (build.cc.streaming) { ctl.history_max = build.cc.grey.maxHistoryAvailable; ctl.history_min = MAX(*historyRequired, build.cc.grey.minHistoryAvailable); DEBUG_PRINTF("streaming control, history max=%zu, min=%zu\n", ctl.history_max, ctl.history_min); ctlp = &ctl; } else { ctlp = nullptr; // Null for non-streaming. } aligned_unique_ptr ftable = hwlmBuild(fl, ctlp, false, build.cc, build.getInitialGroups()); if (!ftable) { throw CompileError("Unable to generate bytecode."); } if (build.cc.streaming) { DEBUG_PRINTF("literal_history_required=%zu\n", ctl.literal_history_required); DEBUG_PRINTF("literal_stream_state_required=%zu\n", ctl.literal_stream_state_required); assert(ctl.literal_history_required <= build.cc.grey.maxHistoryAvailable); *historyRequired = max(*historyRequired, ctl.literal_history_required); *streamStateRequired = ctl.literal_stream_state_required; } *fsize = hwlmSize(ftable.get()); assert(*fsize); DEBUG_PRINTF("built floating literal table size %zu bytes\n", *fsize); return ftable; } aligned_unique_ptr buildSmallBlockMatcher(const RoseBuildImpl &build, size_t *sbsize) { *sbsize = 0; if (build.cc.streaming) { DEBUG_PRINTF("streaming mode\n"); return nullptr; } u32 float_min = findMinWidth(build, ROSE_FLOATING); if (float_min > ROSE_SMALL_BLOCK_LEN) { DEBUG_PRINTF("floating table has large min width %u, fail\n", float_min); return nullptr; } auto lits = fillHamsterLiteralList(build, ROSE_FLOATING); if (lits.empty()) { DEBUG_PRINTF("no floating table\n"); return nullptr; } else if (lits.size() == 1) { DEBUG_PRINTF("single floating literal, noodle will be fast enough\n"); return nullptr; } auto anchored_lits = fillHamsterLiteralList(build, ROSE_ANCHORED_SMALL_BLOCK); if (anchored_lits.empty()) { DEBUG_PRINTF("no small-block anchored literals\n"); return nullptr; } lits.insert(lits.end(), anchored_lits.begin(), anchored_lits.end()); // Remove literals that are longer than our small block length, as they can // never match. TODO: improve by removing literals that have a min match // offset greater than ROSE_SMALL_BLOCK_LEN, which will catch anchored cases // with preceding dots that put them over the limit. auto longer_than_limit = [](const hwlmLiteral &lit) { return lit.s.length() > ROSE_SMALL_BLOCK_LEN; }; lits.erase(remove_if(lits.begin(), lits.end(), longer_than_limit), lits.end()); if (lits.empty()) { DEBUG_PRINTF("no literals shorter than small block len\n"); return nullptr; } aligned_unique_ptr hwlm = hwlmBuild(lits, nullptr, true, build.cc, build.getInitialGroups()); if (!hwlm) { throw CompileError("Unable to generate bytecode."); } *sbsize = hwlmSize(hwlm.get()); assert(*sbsize); DEBUG_PRINTF("built small block literal table size %zu bytes\n", *sbsize); return hwlm; } aligned_unique_ptr buildEodAnchoredMatcher(const RoseBuildImpl &build, size_t *esize) { *esize = 0; auto el = fillHamsterLiteralList(build, ROSE_EOD_ANCHORED); if (el.empty()) { DEBUG_PRINTF("no eod anchored literals\n"); assert(!build.ematcher_region_size); return nullptr; } assert(build.ematcher_region_size); hwlmStreamingControl *ctlp = nullptr; // not a streaming case aligned_unique_ptr etable = hwlmBuild(el, ctlp, true, build.cc, build.getInitialGroups()); if (!etable) { throw CompileError("Unable to generate bytecode."); } *esize = hwlmSize(etable.get()); assert(*esize); DEBUG_PRINTF("built eod-anchored literal table size %zu bytes\n", *esize); return etable; } } // namespace ue2