Home / Docs / Command line

una obligations

Release v0.4.0

List every proof obligation with its status.

text
una obligations [OPTIONS] [PATH]

Examples

sh
una obligations .

List every proof obligation of the package with its status.

Arguments

Argument What it does Default
[PATH] The package directory, or a single file .

Options

Option What it does Default
--json Print machine output as JSON on stdout, and nothing else on stdout
--solver-wallclock <SECONDS> Stop a solver query after this many seconds; the obligation is then unknown 60
--color <WHEN> When to use colors in human output. Values: never: Never use colors; auto: Use colors when the output is a terminal; always: Always use colors. auto
--solver-memory <MIB> The memory limit of each solver query in MiB, from 256 to 1048576 4096

Specification

The normative rules, from spec/13 §5:

Command Meaning
una obligations [path] List obligations with status

una obligations [path] prints one line per obligation, <status> <id> <kind> <file>:<line>:<col> <goal>, with (cached) for a cached result, and exits with code 1 when an obligation is not proven (ADR 0033).

Help text

As una obligations --help prints it at v0.4.0:

text
List every proof obligation with its status

Usage: una obligations [OPTIONS] [PATH]

Arguments:
  [PATH]
          The package directory, or a single file

          [default: .]

Options:
      --json
          Print machine output as JSON on stdout, and nothing else on stdout

      --solver-wallclock <SECONDS>
          Stop a solver query after this many seconds; the obligation is then unknown

          [default: 60]

      --color <WHEN>
          When to use colors in human output

          Possible values:
          - never:  Never use colors
          - auto:   Use colors when the output is a terminal
          - always: Always use colors

          [default: auto]

      --solver-memory <MIB>
          The memory limit of each solver query in MiB, from 256 to 1048576 (ADR 0124)

          [default: 4096]

  -h, --help
          Print help (see a summary with '-h')
View the Markdown