• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
    • Sv
    • Fgl
    • Vwsim
    • Vl
      • Syntax
      • Loader
      • Warnings
      • Getting-started
      • Utilities
      • Printer
      • Kit
      • Mlib
      • Transforms
        • Unparameterization
          • Vl-unparameterize-flow
          • Vl-unparam-inst
          • Vl-unparam-add-to-ledger
          • Vl-scopeinfo-resolve-params
          • Vl-scope-finalize-params
          • Vl-create-unparameterized-interface
          • Vl-create-unparameterized-module
          • Vl-unparam-actualkeys
          • Vl-make-paramdecloverrides
          • Vl-unparam-class
          • Vl-unparam-instlist
          • Vl-create-unparameterized-class
          • Vl-add-lost-interface-warnings
          • Vl-add-lost-module-warnings
          • Vl-unparam-classlist
          • Vl-interfacelist->orignames
          • Vl-user-signature
          • Vl-interfaceport-default-signature
          • Vl-modulelist->orignames
          • Vl-plainarglist-update-ifports
          • Vl-portlist-interface-signatures
          • Vl-user-signatures
          • Vl-plainarg-update-ifports
          • Vl-unparam-inst->instkey
          • Vl-toplevel-signatures
          • Vl-unparam-basename
          • Vl-genblob-resolve-rejoin-scopeitems
          • Vl-gencase-some-match
          • Vl-gencase-match
          • Vl-package-elaborate
          • Vl-unparam-signature
          • Vl-unparam-ledger
          • Vl-packagelist-elaborate
          • Vl-design-elaborate
          • Vl-unparam-actualkey
          • Vl-make-paramdecloverrides-named
          • Vl-unparameterize-main
          • Vl-recover-modules-lost-from-elaboration
          • Vl-finish-unparameterized-interface
          • Vl-paramdecl-set-default
          • Vl-genblob-rejoin-scopeitems
          • Vl-finish-unparameterized-interfaces
          • Vl-unparam-instkey
          • Vl-finish-unparameterized-module
          • Vl-finish-unparameterized-class
          • Vl-finish-unparameterized-modules
          • Vl-finish-unparameterized-classes
          • Vl-genblob-split-scopeitems
          • Vl-user-paramsettings-for-top-names
          • Vl-string/int-alist-to-namedargs
          • Vl-add-lost-interface-warning
          • Vl-unparam-basename-exprstring
          • Vl-add-lost-module-warning
          • Vl-paramdecllist-remove-defaults
          • Vl-ifport-alist
          • Vl-paramdecl-remove-default
          • Vl-ifportexpr->name
          • Vl-paramdecllist-all-localp
          • Vl-unparam-instkeymap
          • Vl-unparam-donelist
          • Vl-unparam-instkeylist
        • Elaborate
        • Addnames
        • Annotate
        • Clean-warnings
        • Eliminitial
        • Custom-transform-hooks
        • Problem-modules
    • X86isa
    • Svl
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Unparameterization

Vl-toplevel-signatures

Signature

(vl-toplevel-signatures top-names warnings 
                        elabindex ledger &key (config 'config)) 
 
  → 
(mv instkeys warnings new-elabindex ledger)

Arguments

top-names — Guard (string-listp top-names).

warnings — Guard (vl-warninglist-p warnings).

elabindex — design level.

ledger — Guard (vl-unparam-ledger-p ledger).

config — Guard (vl-simpconfig-p config).

Returns

instkeys — Type (vl-unparam-instkeylist-p instkeys).

warnings — Type (vl-warninglist-p warnings).

ledger — Type (vl-unparam-ledger-p ledger).

Definitions and Theorems

Function: vl-toplevel-signatures-fn

(defun vl-toplevel-signatures-fn
       (top-names warnings elabindex ledger config)
 (declare (xargs :stobjs (elabindex)))
 (declare (xargs :guard (and (string-listp top-names)
                             (vl-warninglist-p warnings)
                             (vl-unparam-ledger-p ledger)
                             (vl-simpconfig-p config))))
 (let ((__function__ 'vl-toplevel-signatures))
  (declare (ignorable __function__))
  (b*
   (((vl-simpconfig config))
    (top-names
       (case config.user-paramsettings-mode
             (:default (set-difference-equal
                            (string-list-fix top-names)
                            (alist-keys config.user-paramsettings)))
             (:include-toplevel (string-list-fix top-names))
             (otherwise nil)))
    ((mv instkeys-user warnings elabindex ledger)
     (vl-user-signatures config.user-paramsettings
                         t warnings elabindex ledger))
    ((mv instkeys-top warnings elabindex ledger)
     (vl-user-signatures
          (vl-user-paramsettings-for-top-names top-names)
          nil warnings elabindex ledger)))
   (mv (append-without-guard instkeys-user instkeys-top)
       warnings elabindex ledger))))

Theorem: vl-unparam-instkeylist-p-of-vl-toplevel-signatures.instkeys

(defthm vl-unparam-instkeylist-p-of-vl-toplevel-signatures.instkeys
  (b*
    (((mv ?instkeys
          ?warnings ?new-elabindex ?ledger)
      (vl-toplevel-signatures-fn top-names
                                 warnings elabindex ledger config)))
    (vl-unparam-instkeylist-p instkeys))
  :rule-classes :rewrite)

Theorem: vl-warninglist-p-of-vl-toplevel-signatures.warnings

(defthm vl-warninglist-p-of-vl-toplevel-signatures.warnings
  (b*
    (((mv ?instkeys
          ?warnings ?new-elabindex ?ledger)
      (vl-toplevel-signatures-fn top-names
                                 warnings elabindex ledger config)))
    (vl-warninglist-p warnings))
  :rule-classes :rewrite)

Theorem: vl-unparam-ledger-p-of-vl-toplevel-signatures.ledger

(defthm vl-unparam-ledger-p-of-vl-toplevel-signatures.ledger
  (b*
    (((mv ?instkeys
          ?warnings ?new-elabindex ?ledger)
      (vl-toplevel-signatures-fn top-names
                                 warnings elabindex ledger config)))
    (vl-unparam-ledger-p ledger))
  :rule-classes :rewrite)

Theorem: vl-toplevel-signatures-fn-of-string-list-fix-top-names

(defthm vl-toplevel-signatures-fn-of-string-list-fix-top-names
 (equal
      (vl-toplevel-signatures-fn (string-list-fix top-names)
                                 warnings elabindex ledger config)
      (vl-toplevel-signatures-fn top-names
                                 warnings elabindex ledger config)))

Theorem: vl-toplevel-signatures-fn-string-list-equiv-congruence-on-top-names

(defthm
 vl-toplevel-signatures-fn-string-list-equiv-congruence-on-top-names
 (implies
  (str::string-list-equiv top-names top-names-equiv)
  (equal
      (vl-toplevel-signatures-fn top-names
                                 warnings elabindex ledger config)
      (vl-toplevel-signatures-fn top-names-equiv
                                 warnings elabindex ledger config)))
 :rule-classes :congruence)

Theorem: vl-toplevel-signatures-fn-of-vl-warninglist-fix-warnings

(defthm vl-toplevel-signatures-fn-of-vl-warninglist-fix-warnings
 (equal
  (vl-toplevel-signatures-fn top-names (vl-warninglist-fix warnings)
                             elabindex ledger config)
  (vl-toplevel-signatures-fn top-names
                             warnings elabindex ledger config)))

Theorem: vl-toplevel-signatures-fn-vl-warninglist-equiv-congruence-on-warnings

(defthm
 vl-toplevel-signatures-fn-vl-warninglist-equiv-congruence-on-warnings
 (implies
   (vl-warninglist-equiv warnings warnings-equiv)
   (equal
        (vl-toplevel-signatures-fn top-names
                                   warnings elabindex ledger config)
        (vl-toplevel-signatures-fn top-names warnings-equiv
                                   elabindex ledger config)))
 :rule-classes :congruence)

Theorem: vl-toplevel-signatures-fn-of-vl-unparam-ledger-fix-ledger

(defthm vl-toplevel-signatures-fn-of-vl-unparam-ledger-fix-ledger
 (equal
      (vl-toplevel-signatures-fn
           top-names warnings
           elabindex (vl-unparam-ledger-fix ledger)
           config)
      (vl-toplevel-signatures-fn top-names
                                 warnings elabindex ledger config)))

Theorem: vl-toplevel-signatures-fn-vl-unparam-ledger-equiv-congruence-on-ledger

(defthm
 vl-toplevel-signatures-fn-vl-unparam-ledger-equiv-congruence-on-ledger
 (implies
   (vl-unparam-ledger-equiv ledger ledger-equiv)
   (equal
        (vl-toplevel-signatures-fn top-names
                                   warnings elabindex ledger config)
        (vl-toplevel-signatures-fn top-names warnings
                                   elabindex ledger-equiv config)))
 :rule-classes :congruence)

Theorem: vl-toplevel-signatures-fn-of-vl-simpconfig-fix-config

(defthm vl-toplevel-signatures-fn-of-vl-simpconfig-fix-config
 (equal
      (vl-toplevel-signatures-fn top-names warnings elabindex
                                 ledger (vl-simpconfig-fix config))
      (vl-toplevel-signatures-fn top-names
                                 warnings elabindex ledger config)))

Theorem: vl-toplevel-signatures-fn-vl-simpconfig-equiv-congruence-on-config

(defthm
 vl-toplevel-signatures-fn-vl-simpconfig-equiv-congruence-on-config
 (implies
   (vl-simpconfig-equiv config config-equiv)
   (equal
        (vl-toplevel-signatures-fn top-names
                                   warnings elabindex ledger config)
        (vl-toplevel-signatures-fn top-names warnings
                                   elabindex ledger config-equiv)))
 :rule-classes :congruence)