• Top
    • Documentation
    • Books
    • Boolean-reasoning
    • Projects
    • Debugging
    • Std
    • Community
    • Proof-automation
    • ACL2
    • Macro-libraries
    • Interfacing-tools
    • Hardware-verification
      • Gl
      • Esim
      • Vl2014
      • Sv
      • Fgl
      • Vwsim
      • Vl
        • Syntax
        • Loader
        • Warnings
        • Getting-started
        • Utilities
        • Printer
        • Kit
        • Mlib
        • Transforms
          • Unparameterization
          • Elaborate
          • Addnames
          • Annotate
            • Increment-elim
            • Make-implicit-wires
              • Shadowcheck
                • Vl-shadowcheck-genelement
                • Vl-shadowcheck-reference-name
                • Vl-shadowcheck-declare-name
                • Deltemps
                • Vl-shadowcheck-modelement
                • Vl-lexscope
                • Vl-shadowcheck-reference-scopeexpr
                • Vl-shadowcheck-reference-names
                • Vl-shadowcheck-declare-names
                • Vl-shadowcheck-paramtype
                • Vl-shadowcheck-fun/task-loaditems
                • Vl-shadowcheck-fun/task-loaditem
                • Vl-shadowcheck-fundecl
                • Vl-shadowcheck-declare-typedefs
                • Vl-shadowcheck-blockitemlist
                • Vl-shadowcheck-portdecllist
                • Vl-shadowcheck-paramdecls
                • Vl-shadowcheck-dpiimports
                • Vl-shadowcheck-taskdecls
                • Vl-shadowcheck-taskdecl
                • Vl-shadowcheck-push-scope
                • Vl-shadowcheck-blockitem
                • Vl-shadowcheck-vardecls
                • Vl-shadowcheck-vardecl
                • Vl-shadowcheck-typedef
                • Vl-shadowcheck-portdecl
                • Vl-shadowcheck-paramdecl
                • Vl-shadowcheck-modport
                • Vl-shadowcheck-modinst
                • Vl-shadowcheck-imports
                • Vl-shadowcheck-import
                • Vl-shadowcheck-gateinst
                • Vl-shadowcheck-fundecls
                • Vl-shadowcheck-dpiimport
                • Vl-shadowcheck-ports
                • Vl-shadowcheck-port
                • Vl-shadowcheck-initial
                • Vl-shadowcheck-assign
                • Vl-shadowcheck-always
                • Vl-shadowcheck-final
                • Vl-shadowcheck-alias
                • Vl-shadowcheck-state
                • Vl-shadowcheck-module
                • Vl-shadowcheck-interface
                • Vl-shadowcheck-interfaces
                • Vl-shadowcheck-modules
                • Vl-packagemap-find-packages-for-name
                • Vl-shadowcheck-design
                • Vl-lexscopes
                • Vl-expr->maybe-subtype
                • Vl-shadowcheck-pop-scope
                • Nameclash
                  • Vl-make-nameclash-warnings
                  • Vl-make-nameclash-warning
                  • Vl-nameclash-warning-summary
                    • Vl-scope-nameclash-warnings
                    • Vl-scopeitem->loc
                    • Vl-nameclash-collect-local-decls
                    • Vl-nameclash-collect-import-decls
                    • Vl-strip-locs-from-importresult-alist
                  • Vl-portdecl-or-blockitem
                  • Vl-lexscope-decls
                  • Vl-packagemap
                  • Vl-portdecl-or-blockitem-list
                • Implicit-wires-minutia
                • Implicit-wires-generate-scoping
                • Vl-genbase-make-implicit-wires
                • Vl-expr-names-for-implicit
                • Vl-make-implicit-wires-main
                • Vl-implicitst
                • Vl-make-port-implicit-wires
                • Vl-import-update-implicit
                • Vl-blockitemlist-update-implicit
                • Vl-blockitem-update-implicit
                • Vl-make-ordinary-implicit-wires
                • Vl-remove-declared-wires
                • Vl-implicitsts-restore-fast-alists
                • Vl-genblock-under-cond-make-implicit-wires
                • Vl-collect-exprs-for-implicit-wires-from-namedargs
                • Vl-genblock-make-implicit-wires
                • Vl-collect-exprs-for-implicit-wires-from-portargs
                • Vl-collect-exprs-for-implicit-wires-from-namedarg
                • Vl-gateinst-exprs-for-implicit-wires
                • Vl-modinst-exprs-for-implicit-wires
                • Vl-genelementlist-make-implicit-wires
                • Vl-packagemap-find-name
              • Basic-bind-elim
              • Argresolve
              • Basicsanity
              • Portdecl-sign
              • Enum-names
              • Port-resolve
              • Udp-elim
              • Vl-annotate-design
              • Vl-annotate-module
            • Clean-warnings
            • Eliminitial
            • Custom-transform-hooks
            • Problem-modules
        • X86isa
        • Svl
        • Rtl
      • Software-verification
      • Math
      • Testing-utilities
    • Nameclash

    Vl-nameclash-warning-summary

    Signature
    (vl-nameclash-warning-summary name locals imports) → summary
    Arguments
    name — Guard (stringp name).
    locals — Guard (vl-scopeitem-alist-p locals).
    imports — Guard (vl-importresult-alist-p imports).
    Returns
    summary — Type (stringp summary).

    Definitions and Theorems

    Function: vl-nameclash-warning-summary

    (defun vl-nameclash-warning-summary (name locals imports)
     (declare (xargs :guard (and (stringp name)
                                 (vl-scopeitem-alist-p locals)
                                 (vl-importresult-alist-p imports))))
     (let ((__function__ 'vl-nameclash-warning-summary))
      (declare (ignorable __function__))
      (b*
       ((name (string-fix name))
        (locals (vl-scopeitem-alist-fix locals))
        (imports (vl-importresult-alist-fix imports))
        (localdecls (vl-nameclash-collect-local-decls name locals))
        (importdecls (vl-nameclash-collect-import-decls name imports))
        (clashdecls (append localdecls importdecls))
        ((unless (<= 2 (len clashdecls)))
         (raise "Programming error -- not actually a name clash? ~x0~%"
                name)
         "")
        (decl1 (first clashdecls))
        (decl2 (second clashdecls))
        (decl1.loc (if (eq (tag decl1) :vl-import)
                       (vl-import->loc decl1)
                     (vl-scopeitem->loc decl1)))
        (decl2.loc (if (eq (tag decl2) :vl-import)
                       (vl-import->loc decl2)
                     (vl-scopeitem->loc decl2))))
       (with-local-ps (vl-ps-update-autowrap-col 100)
                      (vl-ps-update-autowrap-ind 10)
                      (vl-print "name clash for ")
                      (vl-print-str name)
                      (vl-println ":")
                      (vl-indent 6)
                      (vl-print "  // From ")
                      (vl-print-loc decl1.loc)
                      (vl-println "")
                      (vl-indent 6)
                      (vl-cw "~a0~%" decl1)
                      (vl-indent 6)
                      (vl-print "  // From ")
                      (vl-print-loc decl2.loc)
                      (vl-println "")
                      (vl-indent 6)
                      (vl-cw "~a0~%" decl2)
                      (if (atom (cddr clashdecls))
                          ps
                        (vl-ps-seq (vl-println "")
                                   (vl-indent 6)
                                   (vl-print "  // And ")
                                   (vl-print-nat (- (len clashdecls) 2))
                                   (vl-print " more (not shown).")))))))

    Theorem: stringp-of-vl-nameclash-warning-summary

    (defthm stringp-of-vl-nameclash-warning-summary
      (b* ((summary (vl-nameclash-warning-summary name locals imports)))
        (stringp summary))
      :rule-classes :type-prescription)

    Theorem: vl-nameclash-warning-summary-of-str-fix-name

    (defthm vl-nameclash-warning-summary-of-str-fix-name
      (equal (vl-nameclash-warning-summary (str-fix name)
                                           locals imports)
             (vl-nameclash-warning-summary name locals imports)))

    Theorem: vl-nameclash-warning-summary-streqv-congruence-on-name

    (defthm vl-nameclash-warning-summary-streqv-congruence-on-name
     (implies
       (streqv name name-equiv)
       (equal (vl-nameclash-warning-summary name locals imports)
              (vl-nameclash-warning-summary name-equiv locals imports)))
     :rule-classes :congruence)

    Theorem: vl-nameclash-warning-summary-of-vl-scopeitem-alist-fix-locals

    (defthm
          vl-nameclash-warning-summary-of-vl-scopeitem-alist-fix-locals
     (equal
      (vl-nameclash-warning-summary name (vl-scopeitem-alist-fix locals)
                                    imports)
      (vl-nameclash-warning-summary name locals imports)))

    Theorem: vl-nameclash-warning-summary-vl-scopeitem-alist-equiv-congruence-on-locals

    (defthm
     vl-nameclash-warning-summary-vl-scopeitem-alist-equiv-congruence-on-locals
     (implies
       (vl-scopeitem-alist-equiv locals locals-equiv)
       (equal (vl-nameclash-warning-summary name locals imports)
              (vl-nameclash-warning-summary name locals-equiv imports)))
     :rule-classes :congruence)

    Theorem: vl-nameclash-warning-summary-of-vl-importresult-alist-fix-imports

    (defthm
      vl-nameclash-warning-summary-of-vl-importresult-alist-fix-imports
     (equal
      (vl-nameclash-warning-summary name locals
                                    (vl-importresult-alist-fix imports))
      (vl-nameclash-warning-summary name locals imports)))

    Theorem: vl-nameclash-warning-summary-vl-importresult-alist-equiv-congruence-on-imports

    (defthm
     vl-nameclash-warning-summary-vl-importresult-alist-equiv-congruence-on-imports
     (implies
       (vl-importresult-alist-equiv imports imports-equiv)
       (equal (vl-nameclash-warning-summary name locals imports)
              (vl-nameclash-warning-summary name locals imports-equiv)))
     :rule-classes :congruence)