OS Manuals

/usr/bin/isla-axiomatic

Symbolic execution engine for Sail instruction set architecture specifications

From isla 0.1.0_git20260923-r0 (os), captured 2026-11-05 by running isla-axiomatic --help (exit 0). permalink

Usage: isla-axiomatic [options]

Options:
    -T, --threads <n>   use this many worker threads
    -A, --arch <file>   load architecture file
    -C, --config <file> load custom config for architecture
        --toolchain <name>
                        use specified toolchain from config
    -R, --register <register>=<value>
                        set a register, via the reset_registers builtin
    -I, --initial <register>=<value>
                        set a register in the initial state
    -h, --help          print this help message
        --verbose       print verbose output
    -D, --debug <flags> set debugging flags
        --probe <id>    trace specified function calls or location assignments
                        in debug output
        --probe-all     probe everything (very verbose)
        --probe-function <id>
                        probe everything under the specified function (very
                        verbose)
        --trace-function <id>
                        trace specified function calls in the trace output
        --trace-all     trace everything
    -L, --linearize <id>
                        rewrite function into linear form
    -P, --partial-linearize <id>
                        rewrite function into linear form
    -S, --source <path> directory containing the Sail source used to generate
                        the IR
        --test-linearize
                        test that linearization rewrite has been performed
                        correctly
        --abstract <id> make function abstract
        --debug-id <name id>
                        print the name of an interned identifier (for
                        debugging)
        --reset-constraint <constraint>
                        property to enforce at the reset_registers builtin
        --fork-assertions
                        change assertions into explicit control flow
        --fun-assumption <assumption>
                        add an assumption about the behaviour of a Sail
                        function
        --no-model-reg-init
                        don't use register initializers from the model
        --version       print out version and stop.
        --herd7         Output in a herd7-compatible way
        --isla-litmus <path>
                        Path to isla-litmus binary
        --litmus-translator <path>
                        Path to litmus-translator binary (takes precedence
                        over isla-litmus)
        --footprint-config <file>
                        load custom config for footprint analysis
        --variant <variant>
                        model variants
        --thread-groups <n>
                        number threads per group
        --only-group <n>
                        only perform jobs for one thread group
    -s, --timeout <n>   Add a timeout (in seconds)
        --pc-limit <n>  Limit the number of times each instruction can be
                        visited
        --pc-limit-mode <error|discard>
                        What to do when the pc-limit is exceeded (default
                        error)
        --memory <n>    Add a max memory consumption (in megabytes)
    -m, --model <path>  Memory model in cat format
        --ifetch        Generate ifetch events
        --armv8-page-tables
                        Automatically set up ARMv8 page tables
        --merge-translations
                        Merge consecutive translate events into a single event
        --merge-split-stages
                        Split stages when merging translations
        --remove-uninteresting all/safe
                        Remove uninteresting translate events
    -e, --exhaustive    Attempt to exhaustively enumerate all possible rf
                        combinations
        --extra-smt <file>
                        additional SMT appended to each candidate
        --check-sat-using tactic
                        Use z3 tactic for checking satisfiablity
        --latex <path>  generate latex version of input files in specified
                        directory
        --graph <ascii|dot|none>
                        Draw graphs of executions
        --dot <path>    Place generated graphviz dot files in specified
                        directory
        --temp-dot      Generate graphviz dot files in TMPDIR or /tmp
        --graph-show-forbidden
                        Try draw graph of forbidden executions too
        --graph-debug   Show everything, all trace events and full information
                        in the nodes
        --graph-shows <show,show,...>
                        Overwrite showed relations
        --graph-human-readable
                        Try generate human-readable strings instead of
                        bitvectors where possible
        --graph-padding <iw-left=4,threads-down=2,...,(iw|threads|thread|instr|event)-(up|down|left|right)=value,...>
                        Overwrite default padding
        --graph-force-show-events <ev1,ev2,...>
                        Overwrite hiding of event
        --graph-force-hide-events <ev1,ev2,...>
                        Overwrite hiding of event
        --graph-show-all-reads
                        Always show read events (including translations and
                        ifetches)
        --graph-flatten
                        Flatten the graph, algining all rows and columns
                        across all threads and instructions
        --graph-squash-translation-labels
                        Squash translation event labels from `T s1:pte3(x)`
                        into `Ts1l3` to save space in diagrams
        --view          Open graphviz dot files in default image viewer.
                        Implies --temp-dot unless --dot is set.
        --no-z3-model   do not generate a graph (DEPRECATED, use --graph=none
                        instead)
        --refs <path>   references to compare output with
        --cache <path>  A directory to cache intermediate results. The default
                        is TMPDIR if set, otherwise /tmp
Options (58)
OptionDescriptionSource
-T, --threads nuse this many worker threadshelp
-A, --arch fileload architecture filehelp
--toolchain nameuse specified toolchain from confighelp
-R, --register register>=<valueset a register, via the reset_registers builtinhelp
-I, --initial register>=<valueset a register in the initial statehelp
-h, --helpprint this help messagehelp
--verboseprint verbose outputhelp
--probe idtrace specified function calls or location assignments in debug outputhelp
--probe-allprobe everything (very verbose)help
--probe-function idprobe everything under the specified function (very verbose)help
--trace-function idtrace specified function calls in the trace outputhelp
--trace-alltrace everythinghelp
-L, --linearize idrewrite function into linear formhelp
-P, --partial-linearize idrewrite function into linear formhelp
--test-linearizetest that linearization rewrite has been performed correctlyhelp
--reset-constraint constraintproperty to enforce at the reset_registers builtinhelp
--fork-assertionschange assertions into explicit control flowhelp
--fun-assumption assumptionadd an assumption about the behaviour of a Sail functionhelp
--no-model-reg-initdon't use register initializers from the modelhelp
--versionprint out version and stop.help
--herd7Output in a herd7-compatible wayhelp
--isla-litmus pathPath to isla-litmus binaryhelp
--litmus-translator pathPath to litmus-translator binary (takes precedence over isla-litmus)help
--footprint-config fileload custom config for footprint analysishelp
--variant variantmodel variantshelp
--thread-groups nnumber threads per grouphelp
--only-group nonly perform jobs for one thread grouphelp
-s, --timeout nAdd a timeout (in seconds)help
--pc-limit nLimit the number of times each instruction can be visitedhelp
--pc-limit-mode error|discardWhat to do when the pc-limit is exceeded (default error)help
--memory nAdd a max memory consumption (in megabytes)help
-m, --model pathMemory model in cat formathelp
--ifetchGenerate ifetch eventshelp
--armv8-page-tablesAutomatically set up ARMv8 page tableshelp
--merge-translationsMerge consecutive translate events into a single eventhelp
--merge-split-stagesSplit stages when merging translationshelp
--remove-uninteresting all/safeRemove uninteresting translate eventshelp
-e, --exhaustiveAttempt to exhaustively enumerate all possible rf combinationshelp
--extra-smt fileadditional SMT appended to each candidatehelp
--check-sat-using tacticUse z3 tactic for checking satisfiablityhelp
--latex pathgenerate latex version of input files in specified directoryhelp
--graph ascii|dot|noneDraw graphs of executionshelp
--dot pathPlace generated graphviz dot files in specified directoryhelp
--temp-dotGenerate graphviz dot files in TMPDIR or /tmphelp
--graph-show-forbiddenTry draw graph of forbidden executions toohelp
--graph-debugShow everything, all trace events and full information in the nodeshelp
--graph-shows showOverwrite showed relationshelp
--graph-human-readableTry generate human-readable strings instead of bitvectors where possiblehelp
--graph-padding iw-left=4Overwrite default paddinghelp
--graph-force-show-events ev1Overwrite hiding of eventhelp
--graph-force-hide-events ev1Overwrite hiding of eventhelp
--graph-show-all-readsAlways show read events (including translations and ifetches)help
--graph-flattenFlatten the graph, algining all rows and columns across all threads and instructionshelp
--graph-squash-translation-labelsSquash translation event labels from `T s1:pte3(x)` into `Ts1l3` to save space in diagramshelp
--viewOpen graphviz dot files in default image viewer.help
--no-z3-modeldo not generate a graph (DEPRECATED, use --graph=none instead)help
--refs pathreferences to compare output withhelp
--cache pathA directory to cache intermediate results.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.