test_Help

Summary

Status:

✅ Passed

Duration:

00:00:00.270

Testsuite:

CommonOptions

Standard Output

--------------------------------- Captured Log ---------------------------------

--------------------------------- Captured Out ---------------------------------

Usage: nvc [OPTION]... COMMAND [OPTION]...

Global options are placed before COMMAND, and command-specific options are placed afterwards. Multiple commands can be given and will be performed in order.

Commands:
 -a [OPTION]... FILE...       Analyse FILEs into work 
                              library
 -e [OPTION]... TOP           Elaborate design unit TOP
 -r [OPTION]... TOP           Execute previously 
                              elaborated TOP
 -i [TOP]                     Launch interactive TCL shell
 --cover-export FILE...       Export coverage database to 
                              external format
 --cover-report FILE...       Generate HTML report from 
                              coverage database
 --cover-merge FILE...        Merge multiple coverage 
                              databases
 --do [TOP] FILE...           Evaluate TCL script
 --init                       Initialise work library 
                              directory
 --install PKG                Install third-party packages
 --list                       Print all units in the 
                              library
 --preprocess FILE...         Expand FILEs with Verilog 
                              preprocessor
 --print-deps [UNIT]...       Print dependencies in 
                              Makefile format

Global options:
 -h, --help         Display this message and exit
 -H SIZE            Set the maximum heap size to SIZE bytes
     --ieee-warnings={on,off,off-at-0} 
                    Enable or disable warnings from IEEE 
                    packages
     --ignore-time  Skip source file timestamp check
     --load=PLUGIN  Load VHPI plugin at startup
 -L PATH            Add PATH to library search paths
 -M SIZE            Limit design unit heap space to SIZE 
                    bytes
     --map=LIB:PATH Map library LIB to PATH
     --messages={full,compact} 
                    Diagnostic message style, compact is 
                    less verbose
     --seed=N       Seed for random number generation
     --std={1993,..,2019} 
                    VHDL standard revision to use
     --stderr={note,warning,error,failure,none} 
                    Print messages of this severity level 
                    or higher to stderr
 -v, --version      Display version and copyright 
                    information
     --vhpi-debug   Report VHPI errors as diagnostic 
                    messages
     --vhpi-trace   Trace VHPI calls and events
     --work=NAME    Use NAME as the work library

Analysis options:
     --bootstrap    Allow compilation of STANDARD package
     --check-synthesis 
                    Warn on common synthesis mistakes
 -D, --define NAME=VALUE 
                    Set preprocessor symbol NAME to VALUE
     --error-limit=NUM 
                    Stop after NUM errors
 -f, --files=LIST   Read files to analyse from LIST
 -I DIR             Add DIR to list of Verilog include 
                    directories
     --keywords=VERSION 
                    Use keywords from specified Verilog 
                    version
     --no-save      Do not save analysed design units
     --preserve-case 
                    Preserve the original case of VHDL 
                    identifiers
     --psl          Enable parsing of PSL directives in 
                    comments
     --relative=DIR Store paths relative to DIR
     --relaxed      Disable certain pedantic rule checks
     --single-unit  Treat all Verilog files as a single 
                    compilation unit
 -Werror            Treat all analysis warnings as errors

Elaboration options:
     --cover[={statement,branch,expression,toggle,...}] 
                    Enable code coverage collection
     --cover-file=FILE 
                    Set the file name of the coverage 
                    database
     --cover-spec=FILE 
                    Fine-grained coverage collection 
                    specification, see the manual for 
                    details
 -g NAME=VALUE      Set top level generic NAME to VALUE
 -j, --jit          Enable just-in-time compilation during 
                    simulation
 -O0, -O1, -O2, -O3 Set optimisation level (default is -O2)
     --no-collapse  Do not collapse multiple signals into 
                    one
     --no-save      Do not save the elaborated design to 
                    disk
     --stats        Print statistics about instantiated 
                    design units
 -V, --verbose      Print resource usage at each step

Run options:
     --dump-arrays[=N] 
                    Include nested arrays with up to N 
                    elements in waveform dump
     --exclude=GLOB Exclude signals matching GLOB from 
                    waveform dump
     --exit-severity={note,warning,error,failure} 
                    Exit after an assertion failure of 
                    this severity
     --format={fst,vcd} 
                    Waveform dump format
     --include=GLOB Include signals matching GLOB in 
                    waveform dump
     --shuffle      Run processes in random order
     --stats        Print time and memory usage at end of 
                    run
     --stop-delta=N Stop after N delta cycles (default 
                    10000)
     --stop-time=T  Stop after simulation time T (e.g. 5ns)
     --trace        Trace simulation events
 -w, --wave[=FILE]  Write waveform dump to FILE

Coverage report options:
 -o, --output=dir   Output directory for HTML report
     --exclude-file=FILE 
                    Apply exclude file when generating 
                    report, see manual for syntax
     --dont-print={covered,uncovered,excluded} 
                    Exclude specified items from coverage 
                    report
     --item-limit=LIMIT 
                    Display at most LIMIT items in a 
                    single report file (default 5000)
     --per-file     Create source file code coverage 
                    report.

Coverage merge options:
     --merge-mode={union,intersect} 
                    Merge hierarchies by union or 
                    intersection, default is union
 -o, --output=FILE  Output database file name

Coverage export options:
     --format=FMT   File format (must be 'cobertura')
 -o, --output=FILE  Output file name
     --relative=PATH 
                    Report file names relative to PATH

Install options:
     --dest=DIR     Compile libraries into directory DIR

Library search paths:
  /home/runner/.nvc/lib
  /usr/lib/x86_64-linux-gnu/nvc

The full manual can be read with man 1 nvc and contains detailed explanations of the commands and options above as well as examples.

Report bugs at https://github.com/nickg/nvc/issues

Standard Error

--------------------------------- Captured Err ---------------------------------