• 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
          • Vl-lint
            • Vl-lintconfig-p
              • Parse-vl-lintconfig
                • Parse-vl-lintconfig-long
                • Parse-vl-lintconfig-aux
                • Parse-vl-lintconfig-bundle
                • Parse-vl-lintconfig-short->long
                • Parse-vl-lintconfig-short->long-list
              • Vl-lintconfig
              • *vl-lintconfig-usage*
              • Make-vl-lintconfig
              • Change-vl-lintconfig
              • Honsed-vl-lintconfig
              • Make-honsed-vl-lintconfig
              • Vl-lintconfig->topmods
              • Vl-lintconfig->strict
              • Vl-lintconfig->stmt-limit
              • Vl-lintconfig->start-files
              • Vl-lintconfig->shell
              • Vl-lintconfig->search-path
              • Vl-lintconfig->search-exts
              • Vl-lintconfig->readme
              • Vl-lintconfig->quiet
              • Vl-lintconfig->post-shell
              • Vl-lintconfig->plusargs
              • Vl-lintconfig->no-typo
              • Vl-lintconfig->no-sv-use-set
              • Vl-lintconfig->no-html
              • Vl-lintconfig->mem
              • Vl-lintconfig->include-dirs
              • Vl-lintconfig->ignore-files
              • Vl-lintconfig->ignore
              • Vl-lintconfig->help
              • Vl-lintconfig->global-packages
              • Vl-lintconfig->elab-limit
              • Vl-lintconfig->edition
              • Vl-lintconfig->dropmods
              • Vl-lintconfig->defines
              • Vl-lintconfig->debug
              • Vl-lintconfig->cclimit
            • Condcheck
            • Lint-warning-suppression
            • Lucid
            • Lvaluecheck
            • Vl-interfacelist-alwaysstyle
            • Truncation-warnings
            • Vl-modulelist-alwaysstyle
            • Skip-detection
            • Vl-lint-report
            • Vl-lintresult
            • Vl::vl-design-sv-use-set
            • Oddexpr-check
            • Leftright-check
            • Duplicate-detect
            • Selfassigns
            • *vl-lint-help*
            • Arith-compare-check
            • Dupeinst-check
            • Qmarksize-check
            • Lint-whole-file-suppression
            • Run-vl-lint-main
            • Logicassign
            • Run-vl-lint
            • Vl-print-certain-warnings
            • Duperhs-check
            • Vl-lint-top
            • Sd-filter-problems
            • Vl-modulelist-add-svbad-warnings
            • Vl-module-add-svbad-warnings
            • Check-case
            • Vl-lint-extra-actions
            • Drop-lint-stubs
            • Vl-lint-print-warnings
            • Drop-user-submodules
            • Check-namespace
            • Vl-lintconfig-loadconfig
            • Vl-lint-design->svex-modalist-wrapper
            • Vl-delete-sd-problems-for-modnames-aux
            • Vl-collect-new-names-from-orignames
            • Vl-lint-print-all-warnings
            • Vl-design-remove-unnecessary-modules
            • Vl-delete-sd-problems-for-modnames
            • Vl-always-check-style
            • Vl-vardecllist-svbad-warnings
            • Vl-vardecl-svbad-warnings
            • Vl-reportcard-remove-suppressed
            • Vl-reportcard-keep-suppressed
            • Vl-alwayslist-check-style
            • Vl-remove-nameless-descriptions
            • Vl-lint-apply-quiet
            • Vl-warninglist-remove-suppressed
            • Vl-warninglist-keep-suppressed
            • Vl-print-eliminated-descs
            • Vl-module-alwaysstyle
            • Vl-jp-reportcard-aux
            • Vl-interface-alwaysstyle
            • Vl-design-alwaysstyle
            • Vl-jp-description-locations
            • Vl-jp-reportcard
            • Vl-pp-stringlist-lines
            • Vl-jp-design-locations
            • Vl-datatype-svbad-p
            • Unpacked-range-check
            • Sd-problem-major-p
            • Vl-alwaysstyle
          • Vl-server
          • Vl-gather
          • Vl-zip
          • Vl-main
          • Split-plusargs
          • Vl-shell
          • Vl-json
        • Mlib
        • Transforms
      • X86isa
      • Svl
      • Rtl
    • Software-verification
    • Math
    • Testing-utilities
  • Vl-lintconfig-p

Parse-vl-lintconfig

Parse arguments from the command line into a vl-lintconfig-p aggregate.

Signature
(parse-vl-lintconfig args &key 
                     (getopt::init '*default-vl-lintconfig*)) 
 
  → 
(mv getopt::errmsg getopt::result getopt::extra)
Arguments
args — The command line arguments to parse, which is typically derived from oslib::argv.
    Guard (string-listp args).
getopt::init — An initial vl-lintconfig-p to start from, which gives the default values for each field.
    Guard (vl-lintconfig-p getopt::init).
Returns
getopt::errmsg — NIL on success, or an error message produced by msg, suitable for printing the fmt directive ~@.
getopt::result — An updated version of init where the command-line arguments have been applied. On any error, this may be only partially updated.
    Type (vl-lintconfig-p getopt::result), given (force (vl-lintconfig-p getopt::init)).
getopt::extra — Any other arguments in args that were not recognized as options. Typically this might include the "main" arguments to a program, e.g., file names, etc., that aren't associated with --options.
    Type (string-listp getopt::extra), given (force (string-listp args)).

This is an ordinary command line parser, automatically produced by getopt.

Definitions and Theorems

Function: parse-vl-lintconfig-fn

(defun parse-vl-lintconfig-fn (args getopt::init)
  (declare (xargs :guard (and (string-listp args)
                              (vl-lintconfig-p getopt::init))))
  (let ((__function__ 'parse-vl-lintconfig))
    (declare (ignorable __function__))
    (parse-vl-lintconfig-aux args getopt::init nil nil)))

Theorem: vl-lintconfig-p-of-parse-vl-lintconfig.result

(defthm vl-lintconfig-p-of-parse-vl-lintconfig.result
  (implies (force (vl-lintconfig-p getopt::init))
           (b* (((mv getopt::?errmsg
                     getopt::?result getopt::?extra)
                 (parse-vl-lintconfig-fn args getopt::init)))
             (vl-lintconfig-p getopt::result)))
  :rule-classes :rewrite)

Theorem: string-listp-of-parse-vl-lintconfig.extra

(defthm string-listp-of-parse-vl-lintconfig.extra
  (implies (force (string-listp args))
           (b* (((mv getopt::?errmsg
                     getopt::?result getopt::?extra)
                 (parse-vl-lintconfig-fn args getopt::init)))
             (string-listp getopt::extra)))
  :rule-classes :rewrite)

Subtopics

Parse-vl-lintconfig-long
Parse-vl-lintconfig-aux
Parse-vl-lintconfig-bundle
Parse-vl-lintconfig-short->long
Parse-vl-lintconfig-short->long-list