allbuildtestrunquerystartup options
--autodetect_server_javabase=<true or false>
When --noautodetect_server_javabase is passed, Bazel does not fall back to the local JDK for running the bazel server and instead exits.
default: "true"
affects outputs
loses incremental_state
--batch=<true or false>
If set, Bazel will be run as just a client process without a server, instead of in the standard client/server mode. This is deprecated and will be removed, please prefer shutting down the server explicitly if you wish to avoid lingering servers.
default: "false"
loses incremental_state
bazel internal_configuration
deprecated
--batch_cpu_scheduling=<true or false>
Only on Linux; use 'batch' CPU scheduling for Blaze. This policy is useful for workloads that are non-interactive, but do not want to lower their nice value. See 'man 2 sched_setscheduler'. If false, then Bazel does not perform a system call.
default: "false"
host machine_resource_optimizations
--bazelrc=<string>
The location of the user .bazelrc file containing default values of Bazel options. /dev/null indicates that all further `--bazelrc`s will be ignored, which is useful to disable the search for a user rc file, e.g. in release builds. This option can also be specified multiple times. E.g. with `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z. rc`, 1) x.rc and y.rc are read. 2) z.rc is ignored due to the prior /dev/null. If unspecified, Bazel uses the first .bazelrc file it finds in the following two locations: the workspace directory, then the user's home directory. Note: command line options will always supersede any option in bazelrc.
default: see description
changes inputs
--block_for_lock=<true or false>
When --noblock_for_lock is passed, Bazel does not wait for a running command to complete, but instead exits immediately.
default: "true"
eagerness to_exit
--client_debug=<true or false>
If true, log debug information from the client to stderr. Changing this option will not cause the server to restart.
default: "false"
affects outputs
bazel monitoring
--connect_timeout_secs=<integer>
The amount of time the client waits for each attempt to connect to the server
default: "30"
bazel internal_configuration
--digest_function=<hash function>
The hash function to use when computing file digests.
default: see description
loses incremental_state
bazel internal_configuration
--expand_configs_in_place=<true or false>
Changed the expansion of --config flags to be done in-place, as opposed to in a fixed point expansion between normal rc options and command-line specified options.
default: "true"
no op
deprecated
--failure_detail_out=<path>
If set, specifies a location to write a failure_detail protobuf message if the server experiences a failure and cannot report it via gRPC, as normal. Otherwise, the location will be ${OUTPUT_BASE}/failure_detail.rawproto.
default: see description
affects outputs
loses incremental_state
--home_rc=<true or false>
Whether or not to look for the home bazelrc file at $HOME/.bazelrc
default: "true"
changes inputs
--host_jvm_args=<string>
Flags to pass to the JVM executing Blaze.
may be used multiple times
--host_jvm_debug
Convenience option to add some additional JVM startup flags, which cause the JVM to wait during startup until you connect from a JDWP-compliant debugger (like Eclipse) to port 5005. Expands to: --host_jvm_args=-Xdebug --host_jvm_args=-Xrunjdwp: transport=dt_socket,server=y,address=5005
--host_jvm_profile=<string>
Convenience option to add some profiler/debugger-specific JVM startup flags. Bazel has a list of known values that it maps to hard-coded JVM startup flags, possibly searching some hardcoded paths for certain files.
default: ""
--idle_server_tasks=<true or false>
Run System.gc() when the server is idle
default: "true"
loses incremental_state
host machine_resource_optimizations
--ignore_all_rc_files=<true or false>
Disables all rc files, regardless of the values of other rc-modifying flags, even if these flags come later in the list of startup options.
default: "false"
changes inputs
--io_nice_level=<integer>
Only on Linux; set a level from 0-7 for best-effort IO scheduling using the sys_ioprio_set system call. 0 is highest priority, 7 is lowest. The anticipatory scheduler may only honor up to priority 4. If set to a negative value, then Bazel does not perform a system call.
default: "-1"
host machine_resource_optimizations
--local_startup_timeout_secs=<integer>
The maximum amount of time the client waits to connect to the server
default: "120"
bazel internal_configuration
--macos_qos_class=<string>
Sets the QoS service class of the bazel server when running on macOS. This flag has no effect on all other platforms but is supported to ensure rc files can be shared among them without changes. Possible values are: user-interactive, user-initiated, default, utility, and background.
default: "default"
host machine_resource_optimizations
--max_idle_secs=<integer>
The number of seconds the build server will wait idling before shutting down. Zero means that the server will never shutdown. This is only read on server-startup, changing this option will not cause the server to restart.
default: "10800"
eagerness to_exit
loses incremental_state
--output_base=<path>
If set, specifies the output location to which all build output will be written. Otherwise, the location will be ${OUTPUT_ROOT}/_blaze_${USER} /${MD5_OF_WORKSPACE_ROOT}. Note: If you specify a different option from one to the next Bazel invocation for this value, you'll likely start up a new, additional Bazel server. Bazel starts exactly one server per specified output base. Typically there is one output base per workspace - however, with this option you may have multiple output bases per workspace and thereby run multiple builds for the same client on the same machine concurrently. See 'bazel help shutdown' on how to shutdown a Bazel server.
default: see description
affects outputs
loses incremental_state
--output_user_root=<path>
The user-specific directory beneath which all build outputs are written; by default, this is a function of $USER, but by specifying a constant, build outputs can be shared between collaborating users.
default: see description
affects outputs
loses incremental_state
--preemptible=<true or false>
If true, the command can be preempted if another command is started.
default: "false"
eagerness to_exit
--server_javabase=<string>
Path to the JVM used to execute Bazel itself.
default: ""
--server_jvm_out=<path>
The location to write the server's JVM's output. If unset then defaults to a location in output_base.
default: see description
affects outputs
loses incremental_state
--shutdown_on_low_sys_mem=<true or false>
If max_idle_secs is set and the build server has been idle for a while, shut down the server when the system is low on free RAM. Linux only.
default: "false"
eagerness to_exit
loses incremental_state
--system_rc=<true or false>
Whether or not to look for the system-wide bazelrc.
default: "true"
changes inputs
--unlimit_coredumps=<true or false>
Raises the soft coredump limit to the hard limit to make coredumps of the server (including the JVM) and the client possible under common conditions. Stick this flag in your bazelrc once and forget about it so that you get coredumps when you actually encounter a condition that triggers them.
default: "false"
bazel internal_configuration
--watchfs=<true or false>
If true, bazel tries to use the operating system's file watch service for local changes instead of scanning every file for a change.
default: "false"
deprecated
--windows_enable_symlinks=<true or false>
If true, real symbolic links will be created on Windows instead of file copying. Requires Windows developer mode to be enabled and Windows 10 version 1703 or greater.
default: "false"
bazel internal_configuration
--workspace_rc=<true or false>
Whether or not to look for the workspace bazelrc file at $workspace/.bazelrc
default: "true"
changes inputs