OS Manuals

/usr/bin/isla-footprint

Symbolic execution engine for Sail instruction set architecture specifications

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

Required option 'instruction' missing
Usage: isla-footprint [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.
    -i, --instruction <instruction>
                        display footprint of instruction
    -e, --endianness big/little
                        instruction encoding endianness (default: little)
        --elf <file>    load an elf file, and use instructions from it
    -d, --dependency    view instruction dependency info
    -x, --hex           parse instruction as hexadecimal opcode, rather than
                        assembly
    -s, --simplify      simplify instruction footprint
        --simplify-registers
                        simplify register accesses in traces
        --hide          hide uninteresting trace elements
    -t, --tree          combine traces into tree
    -f, --function <identifer>
                        use a custom footprint function
    -c, --continue-on-error
                        continue generating traces upon encountering an error
        --armv8-page-tables <constraints>
                        set up page tables with provided constraints
        --zero-memory   treat all memory as being zero
        --partial       parse instruction as binary with unknown bits
        --from-file <file>
                        parse instruction from opcodes file
        --instruction-constraint <constraint>
                        add constraint on variables in a partial instruction
        --eval-carefully
                        during simplification check the results of symbolic
                        evaluation
    -k, --kill-at <function name[, function_name]>
                        stop executions early and discard if they reach this
                        function (with optional context)
        --stop-at <function name[, function_name]>
                        stop executions early and keep trace if they reach
                        this function (with optional context)
        --pessimistic   fail on any assertion that is not necessarily true
        --timeout <n>   Add a timeout (in seconds)
        --executable    make trace executable
Options (40)
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
-i, --instruction instructiondisplay footprint of instructionhelp
-e, --endianness big/littleinstruction encoding endianness (default: little)help
--elf fileload an elf file, and use instructions from ithelp
-d, --dependencyview instruction dependency infohelp
-x, --hexparse instruction as hexadecimal opcode, rather than assemblyhelp
-s, --simplifysimplify instruction footprinthelp
--simplify-registerssimplify register accesses in traceshelp
--hidehide uninteresting trace elementshelp
-t, --treecombine traces into treehelp
-f, --function identiferuse a custom footprint functionhelp
-c, --continue-on-errorcontinue generating traces upon encountering an errorhelp
--armv8-page-tables constraintsset up page tables with provided constraintshelp
--zero-memorytreat all memory as being zerohelp
--partialparse instruction as binary with unknown bitshelp
--from-file fileparse instruction from opcodes filehelp
--instruction-constraint constraintadd constraint on variables in a partial instructionhelp
--eval-carefullyduring simplification check the results of symbolic evaluationhelp
--pessimisticfail on any assertion that is not necessarily truehelp
--timeout nAdd a timeout (in seconds)help
--executablemake trace executablehelp

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