udb 0.1.3 → 0.1.5

data/.data/spec/std/isa/isa/globals.isa

@@ -936,6 +936,8 @@ function xlen {
         } else {
           unreachable();
         }
+      } else {
+        unreachable();
       }
     }
   }
@@ -1281,7 +1283,7 @@ function access_check {
     }
 
     # check PMP
-    if (implemented?(ExtensionName::Smpmp)) {
+    if (NUM_PMP_ENTRIES > 0) {
       if (!pmp_check(paddr[PHYS_ADDR_WIDTH-1:0], access_size, type)) {
         raise(fault_type, from_mode, vaddr);
       }

data/.data/spec/std/isa/isa/util.idl

@@ -147,6 +147,28 @@ function count_leading_zeros {
   }
 }
 
+function count_leading_zeros_64 {
+  returns
+    XReg  # Number of leading zeros in +value+
+  arguments
+    U32 N,               # bit width
+    Bits<64> value           # value to count zero in
+  description {
+    Returns the number of leading 0 bits before the most-significant 1 bit of +value+,
+    or N if value is zero.
+  }
+  body {
+    for (U32 i=0; i < N; i++) {
+      if (value[N - 1 - i] == 1) {
+        return i;
+      }
+    }
+
+    # fall-through; value must be zero
+    return N;
+  }
+}
+
 function sext {
   returns XReg
   arguments XReg value, XReg first_extended_bit

data/.data/spec/std/isa/manual_version/isa/20240411/isa_20240411.yaml

@@ -207,8 +207,6 @@ volumes:
       - { name: Smcdeleg, version: "1.0.0" }
       - { name: S, version: "1.12.0" }
       - { name: Sm, version: "1.12.0" }
-      - { name: Smhpm, version: "1.12.0" }
-      - { name: Smpmp, version: "1.12.0" }
       - { name: Sv32, version: "1.12.0" }
       - { name: Sv39, version: "1.12.0" }
       - { name: Sv48, version: "1.12.0" }

data/.data/spec/std/isa/param/HPM_COUNTER_EN.yaml

@@ -11,8 +11,8 @@ description: |
   There is one entry for each hpmcounter.
 
   The first three entries *must* be false (as they correspond to CY, IR, TM in, _e.g._ `mhmpcountinhibit`)
-  Index 3 in HPM_COUNTER_EN corresponds to hpmcounter3.
-  Index 31 in HPM_COUNTER_EN corresponds to hpmcounter31.
+  Index 3 in HPM_COUNTER_EN corresponds to mhpmcounter3.
+  Index 31 in HPM_COUNTER_EN corresponds to mhpmcounter31.
 long_name: TODO
 schema:
   type: array
@@ -26,4 +26,4 @@ schema:
   minItems: 32
 definedBy:
   extension:
-    name: Smhpm
+    name: Sm

data/.data/spec/std/isa/param/HPM_EVENTS.yaml

@@ -6,9 +6,7 @@
 $schema: param_schema.json#
 kind: parameter
 name: HPM_EVENTS
-description: "List of defined event numbers that can be written into hpmeventN
-
-  "
+description: List of defined event numbers that can be written into mhpmeventN
 long_name: TODO
 schema:
   type: array
@@ -19,5 +17,98 @@ schema:
   minItems: 0
   maxItems: 18446744073709551616 # 2**64
 definedBy:
-  extension:
-    name: Smhpm
+  allOf:
+    - extension:
+        name: Sm
+    - param:
+        anyOf:
+          - name: HPM_COUNTER_EN
+            index: 3
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 4
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 4
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 5
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 6
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 7
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 8
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 9
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 10
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 11
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 12
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 13
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 14
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 15
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 16
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 17
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 18
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 19
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 20
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 21
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 22
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 23
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 24
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 25
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 26
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 27
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 28
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 29
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 30
+            equal: true
+          - name: HPM_COUNTER_EN
+            index: 31
+            equal: true

data/.data/spec/std/isa/param/MCOUNTENABLE_EN.yaml

@@ -24,9 +24,9 @@ schema:
   minItems: 32
 definedBy:
   extension:
-    name: U
+    name: Sm
 requirements:
   idl(): |
     for (U32 i=3; i < 32; i++) {
-      MCOUNTENABLE_EN[i] -> !implemented?(ExtensionName::Smhpm) || HPM_COUNTER_EN[i];
+      MCOUNTENABLE_EN[i] -> HPM_COUNTER_EN[i];
     }

data/.data/spec/std/isa/param/NUM_PMP_ENTRIES.yaml

@@ -39,4 +39,4 @@ schema:
   maximum: 64
 definedBy:
   extension:
-    name: Smpmp
+    name: Sm

data/.data/spec/std/isa/param/PMP_GRANULARITY.yaml

@@ -22,4 +22,4 @@ schema:
   maximum: 66
 definedBy:
   extension:
-    name: Smpmp
+    name: Sm

data/.data/spec/std/isa/param/SCOUNTENABLE_EN.yaml

@@ -29,7 +29,7 @@ requirements:
     }
     for (U32 i = 3; i < 32; i++) {
       !implemented?(ExtensionName::Zihpm) -> !SCOUNTENABLE_EN[i];
-      (implemented?(ExtensionName::Smhpm) && !HPM_COUNTER_EN[i]) -> !SCOUNTENABLE_EN[i];
+      (!HPM_COUNTER_EN[i]) -> !SCOUNTENABLE_EN[i];
     }
   reason: |
     Counters 0-2 are defined by Zicntr
@@ -39,8 +39,4 @@ requirements:
     When mhpmcounter[i] does not exist, it cannot be enabled.
 definedBy:
   extension:
-    allOf:
-      - name: S
-      - anyOf:
-          - name: Zicntr
-          - name: Zihpm
+    name: Sm

data/.data/spec/std/isa/proc_cert_model/MC200-32.yaml

@@ -30,9 +30,9 @@ introduction: |
   It supports either a 32-bit (MC200-32) or 64-bit (MC200-64) base ISA.
   The MC200 adds the following mandatory extensions to the MC100:
 
-  * M extension (mandatory)
+  * M extension
   * U extension (User-mode privilege level)
-  * Smpmp extension (M-mode PMP)
+  * Zihpm extension (hardware performance counters)
   * B (Bitfield) extension
   * Zce extension (additional 16-bit instructions suitable for microcontrollers)
   * CLIC extension (if/when ratified)
@@ -56,5 +56,5 @@ extensions:
     presence: mandatory
   U:
     presence: mandatory
-  Smpmp:
+  Zihpm:
     presence: mandatory

data/.data/spec/std/isa/profile/RVB23M64.yaml

@@ -28,9 +28,6 @@ extensions:
   Sm:
     version: "~> 1.13"
     presence: mandatory
-  Smpmp:
-    version: "~> 1.13"
-    presence: mandatory
 
   #########################################################################
   # OPTIONAL LOCALIZED extensions in RVB23M64

data/lib/udb/cfg_arch.rb

@@ -287,7 +287,12 @@ module Udb
 
       explicitly_implemented_extension_versions.each do |ext_ver|
         unless ext_ver.requirements_condition.satisfied_by_cfg_arch?(self) == SatisfiedResult::Yes
-          reasons << "Extension requirement is unmet: #{ext_ver}. Needs: #{ext_ver.requirements_condition.minimize(expand: true).to_s_with_value(self, expand: false)}"
+          failing = ext_ver.requirements_condition.failing_conjuncts(self, expand: false)
+          reasons << "Extension requirement is unmet: #{ext_ver}. " + if failing.empty?
+            "Condition not yet determined: #{ext_ver.requirements_condition.to_s_with_value(self, expand: false)}"
+          else
+            "Failing condition(s):\n" + failing.map { |f| "  - #{f}" }.join("\n")
+          end
         end
       end
 
@@ -295,15 +300,25 @@ module Udb
       config.param_values.each do |param_name, param_value|
         p = T.must(param(param_name))
         unless p.defined_by_condition.satisfied_by_cfg_arch?(self) == SatisfiedResult::Yes
+          failing = p.defined_by_condition.failing_conjuncts(self, expand: false)
           reasons << [
             "Parameter is not defined by this config: '#{param_name}'.",
-            "Needs: #{p.defined_by_condition.minimize(expand: true).to_s_with_value(self, expand: false)}"
+            if failing.empty?
+              "Condition not yet determined: #{p.defined_by_condition.to_s_with_value(self, expand: false)}"
+            else
+              "Failing condition(s):\n" + failing.map { |f| "  - #{f}" }.join("\n")
+            end
           ].join("\n")
         end
         unless p.requirements_condition.satisfied_by_cfg_arch?(self) == SatisfiedResult::Yes
+          failing = p.requirements_condition.failing_conjuncts(self, expand: false)
           reasons << [
             "Parameter requirements not met: '#{param_name}'.",
-            "Needs: #{p.requirements_condition.minimize(expand: true).to_s_with_value(self, expand: false)}"
+            if failing.empty?
+              "Condition not yet determined: #{p.requirements_condition.to_s_with_value(self, expand: false)}"
+            else
+              "Failing condition(s):\n" + failing.map { |f| "  - #{f}" }.join("\n")
+            end
           ].join("\n")
         end
       end
@@ -357,7 +372,12 @@ module Udb
       reasons = []
       mandatory_extension_reqs.each do |ext_req|
         if ext_req.requirements_condition.satisfied_by_cfg_arch?(self) != SatisfiedResult::Yes
-          reasons << "Requirement of #{ext_req} are not met: #{ext_req.requirements_condition.to_s_with_value(self, expand: false)}"
+          failing = ext_req.requirements_condition.failing_conjuncts(self, expand: false)
+          reasons << "Requirement of #{ext_req} are not met:\n" + if failing.empty?
+            "  Condition not yet determined: #{ext_req.requirements_condition.to_s_with_value(self, expand: false)}"
+          else
+            failing.map { |f| "  - #{f}" }.join("\n")
+          end
         end
       end
 
@@ -414,11 +434,27 @@ module Udb
         # check that parameter is defined by the partial config (e.g., is defined by a mandatory
         # extension and/or other param value).
         unless p.defined_by_condition.satisfied_by_cfg_arch?(self) == SatisfiedResult::Yes
-          reasons << "Parameter is not defined by this config: '#{param_name}'. Needs #{p.defined_by_condition}"
+          failing = p.defined_by_condition.failing_conjuncts(self, expand: false)
+          reasons << [
+            "Parameter is not defined by this config: '#{param_name}'.",
+            if failing.empty?
+              "Condition not yet determined: #{p.defined_by_condition.to_s_with_value(self, expand: false)}"
+            else
+              "Failing condition(s):\n" + failing.map { |f| "  - #{f}" }.join("\n")
+            end
+          ].join("\n")
         end
 
         if p.requirements_condition.satisfied_by_cfg_arch?(self) == SatisfiedResult::No
-          reasons << "Parameter requirements cannot be met: '#{param_name}'. Needs: #{p.requirements_condition}"
+          failing = p.requirements_condition.failing_conjuncts(self, expand: false)
+          reasons << [
+            "Parameter requirements cannot be met: '#{param_name}'.",
+            if failing.empty?
+              "Condition not yet determined: #{p.requirements_condition.to_s_with_value(self, expand: false)}"
+            else
+              "Failing condition(s):\n" + failing.map { |f| "  - #{f}" }.join("\n")
+            end
+          ].join("\n")
         end
       end
 

data/lib/udb/cli.rb

@@ -10,6 +10,7 @@ require "pastel"
 require "thor"
 require "terminal-table"
 
+require_relative "global_opts"
 require_relative "resolver"
 
 class SubCommandBase < Thor
@@ -81,9 +82,12 @@ module Udb
       method_option :custom, type: :string, desc: "Path to custom specification directory, if needed", default: Udb.default_custom_isa_path.to_s
       method_option :config_dir, type: :string, desc: "Path to directory with config files", default: Udb.default_cfgs_path.to_s
       method_option :gen, type: :string, desc: "Path to folder used for generation", default: Udb.default_gen_path.to_s
+      method_option :z3parallel, type: :boolean, desc: "Use parallel.enable for Z3", default: true
       def cfg(name_or_path)
         raise ArgumentError, "Spec directory does not exist: #{options[:std]}" unless File.directory?(options[:std])
 
+        Udb.global_options.parallel_z3 = options[:z3parallel]
+
         cfg_file =
           if File.file?(name_or_path)
             Pathname.new(name_or_path)

data/lib/udb/condition.rb

@@ -333,6 +333,10 @@ module Udb
     sig { abstract.params(cfg_arch: ConfiguredArchitecture, expand: T::Boolean).returns(String) }
     def to_s_with_value(cfg_arch, expand:); end
 
+    # returns the failing conjuncts (clauses that are false) for the given cfg_arch
+    sig { abstract.params(cfg_arch: ConfiguredArchitecture, expand: T::Boolean).returns(T::Array[String]) }
+    def failing_conjuncts(cfg_arch, expand:); end
+
     # string representation of condition in Asciidoc
     sig { abstract.returns(String) }
     def to_asciidoc; end
@@ -1151,7 +1155,7 @@ module Udb
         elsif cfg_arch.partially_configured?
           cb = make_cb_proc do |term|
             if term.is_a?(ExtensionTerm)
-              if cfg_arch.mandatory_extension_reqs.any? { |cfg_ext_req| cfg_ext_req.satisfied_by?(term.to_ext_req(cfg_arch)) }
+              if cfg_arch.mandatory_extension_reqs.any? { |cfg_ext_req| term.to_ext_req(cfg_arch).satisfied_by?(cfg_ext_req) }
                 SatisfiedResult::Yes
               elsif cfg_arch.possible_extension_versions.any? { |cfg_ext_ver| term.to_ext_req(cfg_arch).satisfied_by?(cfg_ext_ver) }
                 SatisfiedResult::Maybe
@@ -1273,7 +1277,7 @@ module Udb
               SatisfiedResult::Yes
             end
           elsif cfg_arch.partially_configured?
-            if cfg_arch.mandatory_extension_reqs.any? { |cfg_ext_req| cfg_ext_req.satisfied_by?(term.to_ext_req(cfg_arch)) }
+            if cfg_arch.mandatory_extension_reqs.any? { |cfg_ext_req| term.to_ext_req(cfg_arch).satisfied_by?(cfg_ext_req) }
               SatisfiedResult::Yes
             elsif cfg_arch.possible_extension_versions.any? { |cfg_ext_ver| term.to_ext_req(cfg_arch).satisfied_by?(cfg_ext_ver) }
               SatisfiedResult::Maybe
@@ -1312,6 +1316,60 @@ module Udb
       to_logic_tree(expand:).to_s_with_value(cb, format: LogicNode::LogicSymbolFormat::C)
     end
 
+    sig { override.params(cfg_arch: ConfiguredArchitecture, expand: T::Boolean).returns(T::Array[String]) }
+    def failing_conjuncts(cfg_arch, expand: false)
+      cb = LogicNode.make_eval_cb do |term|
+        case term
+        when ExtensionTerm
+          if cfg_arch.fully_configured?
+            ext_ver = cfg_arch.implemented_extension_version(term.name)
+            if ext_ver.nil? || !term.to_ext_req(cfg_arch).satisfied_by?(ext_ver)
+              SatisfiedResult::No
+            else
+              SatisfiedResult::Yes
+            end
+          elsif cfg_arch.partially_configured?
+            if cfg_arch.mandatory_extension_reqs.any? { |cfg_ext_req| term.to_ext_req(cfg_arch).satisfied_by?(cfg_ext_req) }
+              SatisfiedResult::Yes
+            elsif cfg_arch.possible_extension_versions.any? { |cfg_ext_ver| term.to_ext_req(cfg_arch).satisfied_by?(cfg_ext_ver) }
+              SatisfiedResult::Maybe
+            else
+              SatisfiedResult::No
+            end
+          else
+            SatisfiedResult::Maybe
+          end
+        when ParameterTerm
+          if cfg_arch.fully_configured?
+            if cfg_arch.param_values.key?(term.name)
+              term.eval(cfg_arch)
+            else
+              SatisfiedResult::No
+            end
+          elsif cfg_arch.partially_configured?
+            term.eval(cfg_arch)
+          else
+            SatisfiedResult::Maybe
+          end
+        when XlenTerm
+          if cfg_arch.possible_xlens.include?(term.xlen)
+            if cfg_arch.possible_xlens.size == 1
+              SatisfiedResult::Yes
+            else
+              SatisfiedResult::Maybe
+            end
+          else
+            SatisfiedResult::No
+          end
+        else
+          raise "unexpected term type #{term.class.name}"
+        end
+      end
+      to_logic_tree(expand:).failing_conjuncts(cb).map do |node|
+        node.to_s_with_value(cb, format: LogicNode::LogicSymbolFormat::C)
+      end
+    end
+
     sig { override.returns(String) }
     def to_asciidoc
       to_logic_tree(expand: false).to_asciidoc(include_versions: false)
@@ -1690,6 +1748,9 @@ module Udb
     sig { override.params(cfg_arch: ConfiguredArchitecture, expand: T::Boolean).returns(String) }
     def to_s_with_value(cfg_arch, expand: false) = "true"
 
+    sig { override.params(cfg_arch: ConfiguredArchitecture, expand: T::Boolean).returns(T::Array[String]) }
+    def failing_conjuncts(cfg_arch, expand: false) = []
+
     sig { override.returns(String) }
     def to_asciidoc = "true"
 
@@ -1803,6 +1864,9 @@ module Udb
     sig { override.params(cfg_arch: ConfiguredArchitecture, expand: T::Boolean).returns(String) }
     def to_s_with_value(cfg_arch, expand: false) = "false"
 
+    sig { override.params(cfg_arch: ConfiguredArchitecture, expand: T::Boolean).returns(T::Array[String]) }
+    def failing_conjuncts(cfg_arch, expand: false) = ["false"]
+
     sig { override.returns(String) }
     def to_asciidoc = "false"
 

data/lib/udb/global_opts.rb

@@ -0,0 +1,18 @@
+# Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.
+# SPDX-License-Identifier: BSD-3-Clause-Clear
+
+# typed: true
+# frozen_string_literal: true
+
+require "sorbet-runtime"
+
+module Udb
+  class GlobalOptions < T::Struct
+    # when true, set Z3's parallel.enable param to true
+    prop :parallel_z3, T::Boolean, default: true
+  end
+
+  def self.global_options
+    @global_options ||= GlobalOptions.new
+  end
+end

data/lib/udb/logic.rb

@@ -1058,8 +1058,10 @@ module Udb
           cv <=> T.cast(other_param.comparison_value, String)
         elsif cv.is_a?(Array)
           cv <=> T.cast(other_param.comparison_value, T::Array[T.any(String, T::Boolean, Integer)])
-        else
+        elsif cv.is_a?(Integer)
           T.cast(comparison_value, Integer) <=> T.cast(other_param.comparison_value, Integer)
+        else
+          T.cast(comparison_value, T::Boolean) <=> T.cast(other_param.comparison_value, T::Boolean)
         end
       else
         # these are the same (ignoring reason)
@@ -1689,6 +1691,27 @@ module Udb
       end
     end
 
+    sig { params(eval_cb: EvalCallbackType).returns(T::Array[LogicNode]) }
+    def failing_conjuncts(eval_cb)
+      if @type == LogicNodeType::And
+        # Evaluate each original child independently to find failing conjuncts
+        child_replace_cb = LogicNode.make_replace_cb do |tn|
+          r = eval_cb.call(T.cast(tn.children.fetch(0), TermType))
+          case r
+          when SatisfiedResult::Yes   then LogicNode::True
+          when SatisfiedResult::No    then LogicNode::False
+          when SatisfiedResult::Maybe then tn
+          else T.absurd(r)
+          end
+        end
+        node_children.select do |child|
+          child.replace_terms(child_replace_cb).reduce.type == LogicNodeType::False
+        end
+      else
+        [self]
+      end
+    end
+
     sig { params(callback: EvalCallbackType).returns(SatisfiedResult) }
     def eval_cb(callback)
       case @type
@@ -2696,6 +2719,9 @@ module Udb
           if xor_with_self
             # xor with self if always false
             False
+          elsif reduced.node_children.all? { |c| c.type == LogicNodeType::True || c.type == LogicNodeType::False }
+            # all children are literals: xor is true iff exactly one child is true
+            reduced.node_children.count { |c| c.type == LogicNodeType::True } == 1 ? True : False
           else
             reduced
           end

data/lib/udb/obj/extension.rb

@@ -664,6 +664,9 @@ module Udb
     sig { returns(T.nilable(String)) }
     def ratification_date = @data["ratification_date"]
 
+    sig { returns(T.nilable(String)) }
+    def release_date = @data["release_date"]
+
     sig { returns(T.nilable(T::Array[String])) }
     def changes = @data["changes"].nil? ? [] : T.cast(@data.fetch("changes"), T::Array[String])
 

data/lib/udb/version.rb

@@ -5,5 +5,5 @@
 # frozen_string_literal: true
 
 module Udb
-  def self.version = "0.1.3"
+  def self.version = "0.1.5"
 end

data/lib/udb/yaml/yaml_resolver.rb

@@ -355,7 +355,7 @@ module Udb
         end
 
         if @compile_idl
-          idl_keys = obj.keys.select { |k| k.end_with?(")") }.reject { |k| k == "sail()" }
+          idl_keys = obj.keys.select { |k| k.end_with?(")") }
           idl_keys.each do |key|
             idl_source = obj[key]
 
@@ -677,7 +677,7 @@ module Udb
             key_text = key_node.value
 
             # Check if this is an IDL function key
-            if key_text.is_a?(String) && key_text.end_with?(")") && key_text != "sail()"
+            if key_text.is_a?(String) && key_text.end_with?(")")
               # Validate the value node
               if value_node.is_a?(Psych::Nodes::Scalar)
                 # Check if it's a multiline plain scalar
@@ -735,7 +735,7 @@ module Udb
         when Psych::Nodes::Scalar
           return unless keys.any?
 
-          is_idl_key = keys.last.is_a?(String) && T.must(keys.last).end_with?(")") && keys.last != "sail()"
+          is_idl_key = keys.last.is_a?(String) && T.must(keys.last).end_with?(")")
           marked_offset = cumulative_offsets.fetch(node.start_line) + node.start_column
 
           if is_idl_key

data/lib/udb/z3.rb

@@ -14,6 +14,8 @@
 require "forwardable"
 require "sorbet-runtime"
 require "udb/version_spec"
+
+require_relative "global_opts"
 require_relative "z3_loader"
 
 # Ensure Z3 library is available before requiring the z3 gem
@@ -1057,9 +1059,48 @@ module Udb
     sig { returns(Z3::Solver) }
     attr_reader :solver
 
+    @parallel_enabled = T.let(nil, T.nilable(T::Boolean))
+
+    class << self
+      extend T::Sig
+
+      sig { returns(T.nilable(T::Boolean)) }
+      def parallel_enabled
+        @parallel_enabled
+      end
+
+      sig { params(value: T.nilable(T::Boolean)).void }
+      def parallel_enabled=(value)
+        @parallel_enabled = value
+      end
+
+      sig { params(desired: T::Boolean).void }
+      def configure_parallelization(desired)
+        previous = parallel_enabled
+
+        if !previous.nil? && previous != desired
+          if desired
+            Udb.logger.warn "Z3 parallelization was previously disabled, but is now being enabled"
+          else
+            Udb.logger.warn "Z3 parallelization was previously enabled, but is now being disabled"
+          end
+        end
+
+        Z3.set_param("parallel.enable", desired ? "true" : "false")
+        self.parallel_enabled = desired
+      end
+    end
+
     sig { void }
     def initialize
+      if Udb.global_options.parallel_z3
+        Z3Solver.configure_parallelization(true)
+      else
+        Z3Solver.configure_parallelization(false)
+      end
+
       @solver = T.let(Z3::Solver.new, Z3::Solver)
+
       # Stacks for incremental solving with push/pop
       @ext_vers = T.let([{}], T::Array[T::Hash[String, Z3ExtensionVersion]])
       @ext_reqs = T.let([{}], T::Array[T::Hash[String, Z3ExtensionRequirement]])