• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
    • Sv
    • Vwsim
    • Fgl
    • Vl
      • Syntax
      • Loader
        • Preprocessor
        • Vl-loadconfig
        • Vl-loadstate
        • Lexer
        • Parser
        • Vl-load-merge-descriptions
        • Vl-find-basename/extension
        • Vl-load-file
        • Vl-loadresult
        • Scope-of-defines
        • Vl-find-file
        • Vl-flush-out-descriptions
        • Vl-description
        • Vl-read-file
        • Vl-includeskips-report-gather
        • Vl-load-main
        • Extended-characters
        • Vl-load
        • Vl-load-description
        • Vl-descriptions-left-to-load
        • Inject-warnings
        • Vl-preprocess-debug
        • Vl-write-preprocessor-debug-file
        • Vl-read-file-report-gather
        • Vl-load-descriptions
        • Vl-load-files
        • Translate-off
        • Vl-load-read-file-hook
        • Vl-read-file-report
        • Vl-loadstate-pad
        • Vl-load-summary
        • Vl-collect-modules-from-descriptions
        • Vl-loadstate->warnings
        • Vl-iskips-report
        • Vl-descriptionlist
      • Warnings
      • Getting-started
      • Utilities
      • Printer
      • Kit
      • Mlib
      • Transforms
    • X86isa
    • Svl
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Loader

Vl-preprocess-debug

Signature

(vl-preprocess-debug filename preprocessed st state) 
  → 
(mv preprocessed state)

Arguments

filename — Guard (stringp filename).

preprocessed — Guard (vl-echarlist-p preprocessed).

st — Guard (vl-loadstate-p st).

Returns

preprocessed — Type (vl-echarlist-p preprocessed).

state — Type (state-p1 state), given (force (state-p1 state)).

Definitions and Theorems

Function: vl-preprocess-debug

(defun vl-preprocess-debug (filename preprocessed st state)
 (declare (xargs :stobjs (state)))
 (declare (xargs :guard (and (stringp filename)
                             (vl-echarlist-p preprocessed)
                             (vl-loadstate-p st))))
 (let ((__function__ 'vl-preprocess-debug))
  (declare (ignorable __function__))
  (b*
   (((vl-loadstate st))
    ((vl-loadconfig st.config))
    (preprocessed (vl-echarlist-fix preprocessed))
    ((unless st.config.debugp)
     (mv preprocessed state))
    ((mv debug-filename state)
     (time$
      (vl-write-preprocessor-debug-file filename preprocessed state)
      :msg
      "; ~s0: write preprocessor debug file: ~st sec, ~sa bytes~%"
      :args (list filename)
      :mintime st.config.mintime))
    ((unless debug-filename)
     (mv preprocessed state))
    ((mv okp contents ?len state)
     (time$
      (vl-read-file debug-filename)
      :msg
      "; ~s0: re-read preprocessor debug file: ~st sec, ~sa bytes~%"
      :args (list filename)
      :mintime st.config.mintime))
    ((unless okp)
     (cw "Error: reading debug-file failed: ~s0~%"
         debug-filename)
     (mv preprocessed state))
    ((unless (equal (vl-echarlist->string preprocessed)
                    (vl-echarlist->string contents)))
     (cw "Error: wrong contents in debug-file: ~s0~%"
         debug-filename)
     (mv preprocessed state)))
   (mv contents state))))

Theorem: vl-echarlist-p-of-vl-preprocess-debug.preprocessed

(defthm vl-echarlist-p-of-vl-preprocess-debug.preprocessed
  (b* (((mv ?preprocessed acl2::?state)
        (vl-preprocess-debug filename preprocessed st state)))
    (vl-echarlist-p preprocessed))
  :rule-classes :rewrite)

Theorem: state-p1-of-vl-preprocess-debug.state

(defthm state-p1-of-vl-preprocess-debug.state
  (implies
       (force (state-p1 state))
       (b* (((mv ?preprocessed acl2::?state)
             (vl-preprocess-debug filename preprocessed st state)))
         (state-p1 state)))
  :rule-classes :rewrite)