Skip to content

Launch_parameters

FoelliX edited this page Nov 26, 2021 · 4 revisions

Launch Parameters

BREW can be launched with the parameters mentioned in the table below.

Parameter Meaning
-help, -h, -?, -man, -manpage Outputs a very brief manual, which contains a list of all available parameters
-config "X", -cfg "X", -c "X" By default the config.xml file in the tool's directory is used as configuration. With this parameter a different configuration file can be chosen. X has to reference the path to and the configuration file itself.
-rules "X" By default the rule-set in rules.xml file is loaded. With this parameter a different rule file can be chosen. X has to reference the path to and the rule file itself.
-output "X", -out "X", -o "X" The answer to a query is automatically saved in the answers directory. This parameter can be used to store it in a second directory. X has to define this directory including its path.
-timeout "X"s/m/h, -t "X"s/m/h With this parameter the maximum execution time of each tool can be set. If it expires the tool's execution is aborted. X refers to this time in seconds (e.g. 10s), minutes or hours.
-debug "X", -d "X" The output generated during the execution of this tool can be set to different levels. X may be set to: error, warning, normal, debug, detailed (ascending precision from left to right). Additionally it can be set to short, the output will then be equal to normal but shorter at some points. By default it is set to normal.
-df "X", -dtf "X", -debugToFile "X" Sets the log level (X) that should be logged to file (into log.txt). The default value is important.
-nogui If this parameter is added, the GUI will not be launched. Instead the currently stored benchmark in data/data.ser is directly executed. (Or use -ns, -noSplash to skip the splashscreen.)
-backup, -bak, -b To backup previously computed results on startup add one of these parameters.
-reset, -re, -r To reset BREW on startup add one of these parameters.
--from "X", --to "X" If only some benchmark cases shall be executed these parameters can be used to set the limits.
-taintbench "X", -tb "X" To attach associated TaintBench (findings) directory.
-taintbenchapps "X", -tba "X" To attach associated TaintBench (apps) directory.
-taintbench-writeback, -tbwb Enables writing (back) additional information (Jimple statements) to TaintBench's findings.
-l, -libs, -libraries To not exclude library classes while finding sources and sinks.

Further Options

More options can be configured in config.properties. If the file does not exist, it will be created when you run BREW for the first time.