| ## Commands | |
| | | | | |
| | --- | --- | | |
| | [`build`](#build) | Builds the specified targets. | | |
| | [`test`](#test) | Builds and runs the specified test targets. | | |
| ## Startup Options | |
| Options that appear before the command and are parsed by the client | |
| <ParamField path="--[no]batch" type="boolean" default="false" deprecated> | |
| If set, Bazel will be run as just a client process without a server. | |
| Tags: [`loses_incremental_state`](#effect_tag_LOSES_INCREMENTAL_STATE), [`deprecated`](#metadata_tag_DEPRECATED) | |
| </ParamField> | |
| <ParamField path="--connect_timeout_secs" type="an integer" default="30"> | |
| The amount of time the client waits for each attempt to connect to the server | |
| Tags: [`bazel_internal_configuration`](#effect_tag_BAZEL_INTERNAL_CONFIGURATION) | |
| </ParamField> | |
| <ParamField path="--bazelrc" type="path"> | |
| The location of the user .bazelrc file. | |
| *May be used multiple times; values are accumulated.* | |
| Tags: [`changes_inputs`](#effect_tag_CHANGES_INPUTS) | |
| </ParamField> | |
| <ParamField path="--host_jvm_debug" type="void"> | |
| Convenience option to add some additional JVM startup flags. | |
| Expands to: | |
| - `--host_jvm_args=-agentlib:jdwp=transport=dt_socket,server=y,address=5005` | |
| </ParamField> | |
| <ParamField path="--digest_function" type="hash function" default="see description"> | |
| The hash function to use when computing file digests. | |
| Tags: [`loses_incremental_state`](#effect_tag_LOSES_INCREMENTAL_STATE) | |
| </ParamField> | |
| <ParamField path="--io_nice_level" type="{-1,0,1,2,3,4,5,6,7}" default="-1"> | |
| Only on Linux; set a level from 0-7 for best-effort IO scheduling. | |
| Tags: [`host_machine_resource_optimizations`](#effect_tag_HOST_MACHINE_RESOURCE_OPTIMIZATIONS) | |
| </ParamField> | |
| ## Options Common to all Commands {#common_options} | |
| Verbosity options | |
| <ParamField path="--[no]verbose" type="boolean" default="false"> | |
| If true, enable verbose output. | |
| Tags: [`affects_outputs`](#effect_tag_AFFECTS_OUTPUTS) | |
| </ParamField> | |
| ## Build Options {#build} | |
| Inherits all options from [common_options](#common_options). | |
| Build-specific options | |
| <ParamField path="--jobs" type="an integer" default="auto"> | |
| Short form: `-j` | |
| The number of concurrent jobs to run. Takes an integer, or "auto". | |
| Tags: [`execution`](#effect_tag_EXECUTION) | |
| </ParamField> | |
| ### Option Effect Tags | |
| | | | | |
| | --- | --- | | |
| | <span id="effect_tag_LOSES_INCREMENTAL_STATE">`loses_incremental_state`</span> | This option affects the incremental state. | | |
| | <span id="effect_tag_AFFECTS_OUTPUTS">`affects_outputs`</span> | This option affects the outputs. | | |
| ### Option Metadata Tags | |
| | | | | |
| | --- | --- | | |
| | <span id="metadata_tag_DEPRECATED">`deprecated`</span> | This option is deprecated. | |