allbuildtestrunquerystartup options
--all_incompatible_changes
Enables all options of the form --incompatible_*. Use this option to find places where your build may break in the future due to deprecations or other changes. Expands to: --incompatible_always_check_depset_elements -- incompatible_applicable_licenses -- incompatible_bzl_disallow_load_after_statement -- incompatible_depset_for_libraries_to_link_getter -- incompatible_depset_union --incompatible_disable_deprecated_attr_params -- incompatible_disable_depset_items -- incompatible_disable_target_provider_fields -- incompatible_disable_third_party_license_checking -- incompatible_disallow_empty_glob --incompatible_disallow_legacy_javainfo --incompatible_disallow_struct_provider_syntax -- incompatible_do_not_split_linking_cmdline -- incompatible_enable_profile_by_default --incompatible_new_actions_api -- incompatible_no_attr_license --incompatible_no_implicit_file_export -- incompatible_no_output_attr_default --incompatible_no_rule_outputs_param --incompatible_no_support_tools_in_action_inputs -- incompatible_no_target_output_group -- incompatible_remote_results_ignore_disk --incompatible_remote_symlinks -- incompatible_remove_binary_profile -- incompatible_remove_enabled_toolchain_types -- incompatible_require_linker_input_cc_api -- incompatible_restrict_named_params --incompatible_restrict_string_escapes --incompatible_run_shell_command_string -- incompatible_tls_enabled_removed -- incompatible_use_cc_configure_from_rules_cc -- incompatible_visibility_private_attributes_at_definition
incompatible change
--announce_rc=<true or false>
Whether to announce rc options.
default: "false"
affects outputs
--attempt_to_print_relative_paths=<true or false>
When printing the location part of messages, attempt to use a path relative to the workspace directory or one of the directories specified by -- package_path.
default: "false"
terminal output
--bes_backend=<string>
Specifies the build event service (BES) backend endpoint as HOST or HOST: PORT. Disabled by default.The supported schemas are grpc and grpcs (grpc with TLS enabled). If no schema is provided bazel'll default to grpcs. Specify grpc:// schema to disable TLS.
default: ""
affects outputs
--bes_best_effort=<true or false>
BES best effort upload has been removed. The flag has no more functionality attached to it and will be removed in a future release.
default: "false"
affects outputs
--bes_keywords=<comma-separated list of options>
Specifies a list of notification keywords to be added the default set of keywords published to BES ("command_name=<command_name> ", "protocol_name=BEP"). Defaults to none.
may be used multiple times
affects outputs
--bes_lifecycle_events=<true or false>
Specifies whether to publish BES lifecycle events. (defaults to 'true').
default: "true"
affects outputs
--bes_outerr_buffer_size=<integer>
Specifies the maximal size of stdout or stderr to be buffered in BEP, before it is reported as a progress event. Individual writes are still reported in a single event, even if larger than the specified value up to -- bes_outerr_chunk_size.
default: "10240"
affects outputs
--bes_outerr_chunk_size=<integer>
Specifies the maximal size of stdout or stderr to be sent to BEP in a single message.
default: "1048576"
affects outputs
--bes_proxy=<string>
Connect to the Build Event Service through a proxy. Currently this flag can only be used to configure a Unix domain socket (unix:/path/to/socket).
default: see description
--bes_results_url=<string>
Specifies the base URL where a user can view the information streamed to the BES backend. Bazel will output the URL appended by the invocation id to the terminal.
default: ""
terminal output
--bes_timeout=<An immutable length of time.>
Specifies how long bazel should wait for the BES/BEP upload to complete after the build and tests have finished. A valid timeout is a natural number followed by a unit: Days (d), hours (h), minutes (m), seconds (s), and milliseconds (ms). The default value is '0' which means that there is no timeout.
default: "0s"
affects outputs
--build_event_binary_file=<string>
If non-empty, write a varint delimited binary representation of representation of the build event protocol to that file.
default: ""
affects outputs
--build_event_binary_file_path_conversion=<true or false>
Convert paths in the binary file representation of the build event protocol to more globally valid URIs whenever possible; if disabled, the file:// uri scheme will always be used
default: "true"
affects outputs
--build_event_json_file=<string>
If non-empty, write a JSON serialisation of the build event protocol to that file.
default: ""
affects outputs
--build_event_json_file_path_conversion=<true or false>
Convert paths in the json file representation of the build event protocol to more globally valid URIs whenever possible; if disabled, the file:// uri scheme will always be used
default: "true"
affects outputs
--build_event_max_named_set_of_file_entries=<integer>
The maximum number of entries for a single named_set_of_files event; values smaller than 2 are ignored and no event splitting is performed. This is intended for limiting the maximum event size in the build event protocol, although it does not directly control event size. The total event size is a function of the structure of the set as well as the file and uri lengths, which may in turn depend on the hash function.
default: "-1"
affects outputs
--build_event_publish_all_actions=<true or false>
Whether all actions should be published.
default: "false"
affects outputs
--build_event_text_file=<string>
If non-empty, write a textual representation of the build event protocol to that file
default: ""
affects outputs
--build_event_text_file_path_conversion=<true or false>
Convert paths in the text file representation of the build event protocol to more globally valid URIs whenever possible; if disabled, the file:// uri scheme will always be used
default: "true"
affects outputs
--build_metadata=<'name=value' assignment>
Custom key-value string pairs to supply in a build event.
may be used multiple times
terminal output
--color=<yes, no or auto>
Use terminal controls to colorize output.
default: "auto"
--config=<string>
Selects additional config sections from the rc files; for every <command>, it also pulls in the options from <command>:<config> if such a section exists; if this section doesn't exist in any .rc file, Blaze fails with an error. The config sections and flag combinations they are equivalent to are located in the tools/*.blazerc config files.
may be used multiple times
--curses=<yes, no or auto>
Use terminal cursor controls to minimize scrolling output.
default: "auto"
--debug_depset_depth=<true or false>
Enables an expensive additional check that causes depset construction to fail fast if the depset's depth would exceed the limit specified by `-- nested_set_depth_limit`. Ordinarily this failure occurs only when the depset is flattened, which may be far from its point of creation.
default: "false"
build file_semantics
--deleted_packages=<comma-separated list of package names>
A comma-separated list of names of packages which the build system will consider non-existent, even if they are visible somewhere on the package path.Use this option when deleting a subpackage 'x/y' of an existing package 'x'. For example, after deleting x/y/BUILD in your client, the build system may complain if it encounters a label '//x:y/z' if that is still provided by another package_path entry. Specifying --deleted_packages x/y avoids this problem.
default: ""
--disk_cache=<path>
A path to a directory where Bazel can read and write actions and action outputs. If the directory does not exist, it will be created.
default: see description
--distdir=<path>
Additional places to search for archives before accessing the network to download them.
may be used multiple times
bazel internal_configuration
--enable_platform_specific_config=<true or false>
If true, Bazel picks up host-OS-specific config lines from bazelrc files. For example, if the host OS is Linux and you run bazel build, Bazel picks up lines starting with build:linux. Supported OS identifiers are linux, macos, windows, freebsd, and openbsd. Enabling this flag is equivalent to using --config=linux on Linux, --config=windows on Windows, etc.
default: "false"
--experimental_action_args=<true or false>
If set to true, Action objects support an `args` field: a frozen Args object which contains all action arguments.
default: "false"
bazel internal_configuration
experimental
--experimental_allow_incremental_repository_updates=<true or false>
This flag will be removed in Bazel 1.0. Please do not use it. Incremental repository updates feature is now enabled without the flag.
default: "true"
bazel internal_configuration
experimental
--experimental_allow_tags_propagation=<true or false>
If set to true, tags will be propagated from a target to the actions' execution requirements; otherwise tags are not propagated. See https: //github.com/bazelbuild/bazel/issues/8830 for details.
default: "false"
build file_semantics
experimental
--experimental_announce_profile_path=<true or false>
If enabled, adds the JSON profile path to the log.
default: "false"
affects outputs
bazel monitoring
--experimental_aspect_output_propagation=<true or false>
If set to true, allows Starlark aspects to be defined with `apply_to_generating_rules`, which will enable them to propagate through output file target nodes.
default: "false"
loading and_analysis
experimental
--experimental_build_event_expand_filesets=<true or false>
If true, expand Filesets in the BEP when presenting output files.
default: "false"
affects outputs
--experimental_build_event_upload_strategy=<string>
Selects how to upload artifacts referenced in the build event protocol.
default: see description
affects outputs
--experimental_cc_shared_library=<true or false>
If set to true, rule attributes and Starlark API methods needed for the rule cc_shared_library will be available
default: "false"
build file_semantics
loading and_analysis
experimental
--experimental_disable_external_package=<true or false>
If set to true, the auto-generated //external package will not be available anymore. Bazel will still be unable to parse the file 'external/BUILD', but globs reaching into external/ from the unnamed package will work.
default: "false"
loading and_analysis
loses incremental_state
experimental
--experimental_enable_android_migration_apis=<true or false>
If set to true, enables the APIs required to support the Android Starlark migration.
default: "false"
build file_semantics
--experimental_generate_json_trace_profile=<true or false>
If enabled, Bazel profiles the build and writes a JSON-format profile into a file in the output base. View profile by loading into chrome://tracing.
default: "false"
affects outputs
bazel monitoring
--experimental_google_legacy_api=<true or false>
If set to true, exposes a number of experimental pieces of Starlark build API pertaining to Google legacy code.
default: "false"
loading and_analysis
experimental
--experimental_guard_against_concurrent_changes=<true or false>
Turn this off to disable checking the ctime of input files of an action before uploading it to a remote cache. There may be cases where the Linux kernel delays writing of files, which could cause false positives.
default: "false"
--experimental_include_primary_output=<true or false>
Includes the extra "out" attribute in action events that contains the exec path to the action's primary output.
default: "false"
affects outputs
bazel monitoring
--experimental_multi_threaded_digest=<true or false>
Whether to always compute digests of files with multiple threads. Setting this to false may improve performance when using a spinning platter.
default: "true"
--experimental_ninja_actions=<true or false>
If set to true, enables Ninja execution functionality.
default: "false"
bazel internal_configuration
experimental
--experimental_oom_more_eagerly_threshold=<integer>
If this flag is set to a value less than 100, Bazel will OOM if, after two full GC's, more than this percentage of the (old gen) heap is still occupied.
default: "100"
host machine_resource_optimizations
--experimental_platforms_api=<true or false>
If set to true, enables a number of platform-related Starlark APIs useful for debugging.
default: "false"
loading and_analysis
experimental
--experimental_post_profile_started_event=<true or false>
If set, Bazel will post the ProfilerStartedEvent including the path to the profile.
default: "false"
affects outputs
bazel monitoring
--experimental_profile_action_counts=<true or false>
If set, Bazel will add action counts at the top of the JSON profile.
default: "false"
affects outputs
bazel monitoring
--experimental_profile_additional_tasks=<phase, action, __action_builder, __action_submit, action_check, __action_execute, action_lock, action_release, __action_graph, action_update, action_complete, info, __exception, create_package, __package_validity_check, __spawn, remote_execution, local_execution, scanner, local_parse, upload_time, process_time, remote_queue, remote_setup, fetch, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, __configured_target, thread_name, __test, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, local_cpu_usage, action_counts, __process_scan, __loop_output_artifacts, __locate_relative, __construct_include_paths, __parse_and_hints_results, __process_results_and_enqueue, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, action_fs_staging, remote_cache_check, remote_download, remote_network or unknown>
Specifies additional profile tasks to be included in the profile.
may be used multiple times
affects outputs
bazel monitoring
--experimental_profile_cpu_usage=<true or false>
If set, Bazel will measure cpu usage and add it to the JSON profile.
default: "false"
affects outputs
bazel monitoring
--experimental_remote_downloader=<string>
A URI of a remote downloader endpoint. The supported schemas are grpc and grpcs (grpc with TLS enabled). If no schema is provided bazel will default to grpcs. Specify grpc:// schema to disable TLS.
default: see description
--experimental_remote_grpc_log=<path>
If specified, a path to a file to log gRPC call related details. This log consists of a sequence of serialized com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs with each message prefixed by a varint denoting the size of the following serialized protobuf message, as performed by the method LogEntry.writeDelimitedTo(OutputStream).
default: see description
--experimental_repo_remote_exec=<true or false>
If set to true, repository_rule gains some remote execution capabilities.
default: "false"
build file_semantics
loading and_analysis
experimental
--experimental_repository_cache_hardlinks=<true or false>
If set, the repository cache will hardlink the file in case of a cache hit, rather than copying. This is inteded to save disk space.
default: "false"
bazel internal_configuration
--experimental_repository_hash_file=<string>
If non-empty, specifies a file containing a resolved value, against which the repository directory hashes should be verified
default: ""
affects outputs
experimental
--experimental_repository_resolved_file=<string>
If non-empty, write a Skylark value with the resolved information of all Starlark repository rules that were executed.
default: ""
affects outputs
--experimental_resolved_file_instead_of_workspace=<string>
If non-empty read the specified resolved file instead of the WORKSPACE file
default: ""
changes inputs
--experimental_scale_timeouts=<double>
Scale all timeouts in Starlark repository rules by this factor. In this way, external repositories can be made working on machines that are slower than the rule author expected, without changing the source code
default: "1.0"
bazel internal_configuration
experimental
--experimental_sibling_repository_layout=<true or false>
If set to true, non-main repositories are planted as symlinks to the main repository in the execution root. That is, all repositories are direct children of the $output_base/execution_root directory. This has the side effect of freeing up $output_base/execution_root/__main__/external for the real top-level 'external' directory.
default: "false"
action command_lines
bazel internal_configuration
loading and_analysis
loses incremental_state
experimental
--experimental_slim_json_profile=<true or false>
Slims down the size of the JSON profile by merging events if the profile gets too large.
default: "false"
affects outputs
bazel monitoring
--experimental_starlark_config_transitions=<true or false>
If set to true, enables creation of configuration transition objects (the `transition()` function) in Starlark.
default: "true"
loading and_analysis
experimental
--experimental_starlark_unused_inputs_list=<true or false>
If set to true, enables use of 'unused_inputs_list' in starlark action. run().
default: "true"
changes inputs
experimental
--experimental_stream_log_file_uploads=<true or false>
Stream log file uploads directly to the remote storage rather than writing them to disk.
default: "false"
affects outputs
--experimental_ui_deduplicate=<true or false>
Make the UI deduplicate messages to have a cleaner scroll-back log.
default: "false"
terminal output
--experimental_ui_limit_console_output=<integer>
Number of bytes to which the UI will limit its output (non-positive values indicate unlimited). Once the limit is approaching, the UI will try hard to limit in a meaningful way, but will ultimately just drop all output.
default: "0"
--experimental_ui_mode=<oldest_actions or mnemonic_histogram>
Determines what kind of data is shown in the detailed progress bar. By default, it is set to show the oldest actions and their running time. The underlying data source is usually sampled in a mode-dependend way to fit within the number of lines given by --ui_actions_shown.
default: "oldest_actions"
terminal output
--experimental_verify_repository_rules=<string>
If list of repository rules for which the hash of the output directory should be verified, provided a file is specified by -- experimental_repository_hash_file.
may be used multiple times
affects outputs
experimental
--experimental_workspace_rules_log_file=<path>
Log certain Workspace Rules events into this file as delimited WorkspaceEvent protos.
default: see description
--google_auth_scopes=<comma-separated list of options>
A comma-separated list of Google Cloud authentication scopes.
default: "https://www.googleapis.com/auth/cloud-platform"
--google_credentials=<string>
Specifies the file to get authentication credentials from. See https://cloud.google.com/docs/authentication for details.
default: see description
--google_default_credentials=<true or false>
Whether to use 'Google Application Default Credentials' for authentication. See https://cloud.google.com/docs/authentication for details. Disabled by default.
default: "false"
--http_timeout_scaling=<double>
Scale all timeouts related to http downloads by the given factor
default: "1.0"
bazel internal_configuration
--incompatible_always_check_depset_elements=<true or false>
Check the validity of elements added to depsets, in all constructors. Elements must be immutable, but historically the depset(direct=...) constructor forgot to check. Use tuples instead of lists in depset elements. See https://github.com/bazelbuild/bazel/issues/10313 for details.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_bzl_disallow_load_after_statement=<true or false>
If set to true, all `load` must be called at the top of .bzl files, before any other statement.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_depset_for_libraries_to_link_getter=<true or false>
When true, Bazel no longer returns a list from linking_context. libraries_to_link but returns a depset instead.
default: "true"
loading and_analysis
incompatible change
triggered by_all_incompatible_changes
--incompatible_depset_union=<true or false>
If set to true, depset union using `+`, `|` or `.union` are forbidden. Use the `depset` constructor instead.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disable_deprecated_attr_params=<true or false>
If set to true, disable the deprecated parameters 'single_file' and 'non_empty' on attribute definition methods, such as attr.label().
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disable_depset_items=<true or false>
If set to true, disable the 'items' parameter of the depset constructor. Use the 'transitive' and 'direct' parameters instead.
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disable_target_provider_fields=<true or false>
If set to true, disable the ability to access providers on 'target' objects via field syntax. Use provider-key syntax instead. For example, instead of using `ctx.attr.dep.my_info` to access `my_info` from inside a rule implementation function, use `ctx.attr.dep[MyInfo]`. See https://github. com/bazelbuild/bazel/issues/9014 for details.
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disable_third_party_license_checking=<true or false>
If true, disables all license checking logic
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disallow_empty_glob=<true or false>
If set to true, the default value of the `allow_empty` argument of glob() is False.
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disallow_legacy_javainfo=<true or false>
Deprecated. No-op.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disallow_struct_provider_syntax=<true or false>
If set to true, rule implementation functions may not return a struct. They must instead return a list of provider instances.
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_do_not_split_linking_cmdline=<true or false>
When true, Bazel no longer modifies command line flags used for linking, and also doesn't selectively decide which flags go to the param file and which don't. See https://github.com/bazelbuild/bazel/issues/7670 for details.
default: "true"
loading and_analysis
incompatible change
triggered by_all_incompatible_changes
--incompatible_enable_profile_by_default=<true or false>
If enabled, Bazel will generate a JSON profile by default.
default: "true"
affects outputs
bazel monitoring
incompatible change
triggered by_all_incompatible_changes
--incompatible_new_actions_api=<true or false>
If set to true, the API to create actions is only available on `ctx. actions`, not on `ctx`.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_no_attr_license=<true or false>
If set to true, disables the function `attr.license`.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_no_implicit_file_export=<true or false>
If set, (used) source files are are package private unless exported explicitly. See https://github. com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_no_output_attr_default=<true or false>
If set to true, disables the `default` parameter of the `attr.output` and `attr.output_list` attribute definition functions.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_no_rule_outputs_param=<true or false>
If set to true, disables the `outputs` parameter of the `rule()` Starlark function.
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_no_support_tools_in_action_inputs=<true or false>
If set to true, tools should be passed to `ctx.actions.run()` and `ctx. actions.run_shell()` using the `tools` parameter instead of the `inputs` parameter. Furthermore, if this flag is set and a `tools` parameter is not passed to the action, it is an error for any tools to appear in the `inputs`.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_no_target_output_group=<true or false>
If set to true, disables the output_group field of the 'Target' Starlark type.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_remote_results_ignore_disk=<true or false>
If set to true, --noremote_upload_local_results and -- noremote_accept_cached will not apply to the disk cache. If a combined cache is used: --noremote_upload_local_results will cause results to be written to the disk cache, but not uploaded to the remote cache. --noremote_accept_cached will result in Bazel checking for results in the disk cache, but not in the remote cache. See #8216 for details.
default: "false"
incompatible change
triggered by_all_incompatible_changes
--incompatible_remote_symlinks=<true or false>
If set to true, Bazel will represent symlinks in action outputs in the remote caching/execution protocol as such. The current behavior is for remote caches/executors to follow symlinks and represent them as files. See #6631 for details.
default: "true"
execution
incompatible change
triggered by_all_incompatible_changes
--incompatible_remove_binary_profile=<true or false>
If enabled, Bazel will write JSON-format profiles instead of binary profiles.
default: "true"
affects outputs
bazel monitoring
incompatible change
triggered by_all_incompatible_changes
--incompatible_remove_enabled_toolchain_types=<true or false>
If set to true, the platform configuration fragment cannot access the (deprecated) list of enabled toolchain types.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_require_linker_input_cc_api=<true or false>
If set to true, rule create_linking_context will require linker_inputs instead of libraries_to_link. The old getters of linking_context will also be disabled and just linker_inputs will be available.
default: "false"
build file_semantics
loading and_analysis
incompatible change
triggered by_all_incompatible_changes
--incompatible_restrict_named_params=<true or false>
If set to true, restricts a number of Starlark built-in function parameters to be only specifiable positionally (and not by keyword).
default: "true"
loading and_analysis
incompatible change
triggered by_all_incompatible_changes
--incompatible_restrict_string_escapes=<true or false>
If set to true, unknown string escapes like `\a` become rejected.
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_run_shell_command_string=<true or false>
If set to true, the command parameter of actions.run_shell will only accept string
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_tls_enabled_removed=<true or false>
No-op. See #8061 for details.
default: "true"
incompatible change
triggered by_all_incompatible_changes
--incompatible_use_cc_configure_from_rules_cc=<true or false>
When true, Bazel will no longer allow using cc_configure from @bazel_tools. Please see https://github.com/bazelbuild/bazel/issues/10134 for details and migration instructions.
default: "false"
loading and_analysis
incompatible change
triggered by_all_incompatible_changes
--incompatible_visibility_private_attributes_at_definition=<true or false>
If set to true, the visibility of private rule attributes is checked with respect to the rule definition, rather than the rule usage.
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--json_trace_compression=<tri-state (auto, yes, no)>
If enabled, Bazel compresses the JSON-format profile with gzip. By default, this is decided based on the extension of the file specified in --profile.
default: "auto"
affects outputs
bazel monitoring
--keep_going=<true or false>
Continue as much as possible after an error. While the target that failed and those that depend on it cannot be analyzed, other prerequisites of these targets can be.
default: "false"
eagerness to_exit
--keep_state_after_build=<true or false>
If false, Blaze will discard the inmemory state from this build when the build finishes. Subsequent builds will not have any incrementality with respect to this one.
default: "true"
loses incremental_state
--legacy_important_outputs=<true or false>
Use this to suppress generation of the legacy important_outputs field in the TargetComplete event.
default: "true"
affects outputs
--loading_phase_threads=<integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
Number of parallel threads to use for the loading/analysis phase.Takes an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5". "auto" sets a reasonable default based onhost resources. Must be at least 1.
default: "auto"
bazel internal_configuration
--logging=<0 <= an integer <= 6>
The logging level.
default: "3"
affects outputs
--memory_profile_stable_heap_parameters=<two integers, separated by a comma>
Tune memory profile's computation of stable heap at end of build. Should be two integers separated by a comma. First parameter is the number of GCs to perform. Second parameter is the number of seconds to wait between GCs.
default: "1,0"
bazel monitoring
--nested_set_depth_limit=<integer>
Limit on the depth of NestedSet, which is the internal data structure used to implement `depset` in Starlark. If a depset is flattened during evaluation of Starlark code or a NestedSet is flattened internally, and that data structure has a depth exceeding this limit, then the Bazel invocation will fail.
default: "3500"
loading and_analysis
--override_repository=<equals-separated mapping of repository name to path>
Overrides a repository with a local directory.
may be used multiple times
--package_path=<colon-separated list of options>
A colon-separated list of where to look for packages. Elements beginning with '%workspace%' are relative to the enclosing workspace. If omitted or empty, the default is the output of 'bazel info default-package-path'.
default: "%workspace%"
--profile=<path>
If set, profile Bazel and write data to the specified file. Use bazel analyze-profile to analyze the profile.
default: see description
affects outputs
bazel monitoring
--progress_in_terminal_title=<true or false>
Show the command progress in the terminal title. Useful to see what bazel is doing when having multiple terminal tabs.
default: "false"
--project_id=<string>
Specifies the BES project identifier. Defaults to null.
default: see description
affects outputs
--remote_accept_cached=<true or false>
Whether to accept remotely cached action results.
default: "true"
--remote_allow_symlink_upload=<true or false>
If true, upload action symlink outputs to the remote cache. If this option is not enabled, cachable actions that output symlinks will fail.
default: "true"
execution
--remote_cache=<string>
A URI of a caching endpoint. The supported schemas are http, https, grpc and grpcs (grpc with TLS enabled). If no schema is provided bazel will default to grpcs. Specify grpc:// or http:// schema to disable TLS.See https://docs.bazel.build/versions/master/remote-caching.html
default: see description
--remote_cache_header=<'name=value' assignment>
Specify a header that will be included in cache requests: --remote_cache_header=Name=Value. Multiple headers can be passed by specifying the flag multiple times. Multiple values for the same name will be converted to a comma-separated list.
may be used multiple times
--remote_default_exec_properties=<'name=value' assignment>
Set the default exec properties to be used as the remote execution platform if an execution platform does not already set exec_properties.
may be used multiple times
affects outputs
--remote_default_platform_properties=<string>
Set the default platform properties to be set for the remote execution API, if the execution platform does not already set remote_execution_properties. This value will also be used if the host platform is selected as the execution platform for remote execution.
default: ""
--remote_download_minimal
Does not download any remote build outputs to the local machine. This flag is a shortcut for three flags: --experimental_inmemory_jdeps_files, -- experimental_inmemory_dotd_files and -- experimental_remote_download_outputs=minimal. Expands to: --nobuild_runfile_links --experimental_inmemory_jdeps_files -- experimental_inmemory_dotd_files -- experimental_remote_download_outputs=minimal
affects outputs
--remote_download_outputs=<all, minimal or toplevel>
If set to 'minimal' doesn't download any remote build outputs to the local machine, except the ones required by local actions. If set to 'toplevel' behaves like'minimal' except that it also downloads outputs of top level targets to the local machine. Both options can significantly reduce build times if network bandwidth is a bottleneck.
default: "all"
affects outputs
--remote_download_toplevel
Only downloads remote outputs of top level targets to the local machine. This flag is a shortcut for three flags: -- experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files and -- experimental_remote_download_outputs=toplevel. Expands to: --experimental_inmemory_jdeps_files -- experimental_inmemory_dotd_files -- experimental_remote_download_outputs=toplevel
affects outputs
--remote_downloader_header=<'name=value' assignment>
Specify a header that will be included in remote downloader requests: --remote_downloader_header=Name=Value. Multiple headers can be passed by specifying the flag multiple times. Multiple values for the same name will be converted to a comma-separated list.
may be used multiple times
--remote_exec_header=<'name=value' assignment>
Specify a header that will be included in execution requests: --remote_exec_header=Name=Value. Multiple headers can be passed by specifying the flag multiple times. Multiple values for the same name will be converted to a comma-separated list.
may be used multiple times
--remote_execution_priority=<integer>
The relative priority of actions to be executed remotely. The semantics of the particular priority values are server-dependent.
default: "0"
--remote_executor=<string>
HOST or HOST:PORT of a remote execution endpoint.The supported schemas are grpc and grpcs (grpc with TLS enabled). If no schema is provided bazel'll default to grpcs. Specify grpc:// schema to disable TLS.
default: see description
--remote_header=<'name=value' assignment>
Specify a header that will be included in requests: --remote_header=Name=Value. Multiple headers can be passed by specifying the flag multiple times. Multiple values for the same name will be converted to a comma-separated list.
may be used multiple times
--remote_instance_name=<string>
Value to pass as instance_name in the remote execution API.
default: ""
--remote_local_fallback=<true or false>
Whether to fall back to standalone local execution strategy if remote execution fails.
default: "false"
--remote_local_fallback_strategy=<string>
No-op, deprecated. See https://github.com/bazelbuild/bazel/issues/7480 for details.
default: "local"
--remote_max_connections=<integer>
The max. number of concurrent network connections to the remote cache/executor. By default Bazel limits the number of TCP connections to 100. Setting this flag to 0 will make Bazel choose the number of connections automatically.
default: "100"
host machine_resource_optimizations
--remote_proxy=<string>
Connect to the remote cache through a proxy. Currently this flag can only be used to configure a Unix domain socket (unix:/path/to/socket).
default: see description
--remote_result_cache_priority=<integer>
The relative priority of remote actions to be stored in remote cache. The semantics of the particular priority values are server-dependent.
default: "0"
--remote_retries=<integer>
The maximum number of attempts to retry a transient error. If set to 0, retries are disabled.
default: "5"
--remote_timeout=<integer>
The maximum number of seconds to wait for remote execution and cache calls. For the REST cache, this is both the connect and the read timeout.
default: "60"
--remote_upload_local_results=<true or false>
Whether to upload locally executed action results to the remote cache.
default: "true"
--remote_verify_downloads=<true or false>
If set to true, Bazel will compute the hash sum of all remote downloads and discard the remotely cached values if they don't match the expected value.
default: "true"
--repository_cache=<path>
Specifies the cache location of the downloaded values obtained during the fetching of external repositories. An empty string as argument requests the cache to be disabled.
default: see description
bazel internal_configuration
--show_loading_progress=<true or false>
If enabled, causes Bazel to print "Loading package:" messages.
default: "true"
--show_progress=<true or false>
Display progress messages during a build.
default: "true"
--show_progress_rate_limit=<double>
Minimum number of seconds between progress messages in the output.
default: "0.2"
--show_task_finish=<true or false>
Display progress messages when tasks complete, not just when they start.
default: "false"
--show_timestamps=<true or false>
Include timestamps in messages
default: "false"
--starlark_cpu_profile=<string>
Writes into the specified file a pprof profile of CPU usage by all Starlark threads.
default: ""
bazel monitoring
--tls_certificate=<string>
Specify the TLS client certificate to use.
default: see description
--tls_enabled=<true or false>
No-op. See #8061 for details.
default: "false"
--tool_tag=<string>
A tool name to attribute this Bazel invocation to.
default: ""
affects outputs
bazel monitoring
--track_incremental_state=<true or false>
If false, Blaze will not persist data that allows for invalidation and re- evaluation on incremental builds in order to save memory on this build. Subsequent builds will not have any incrementality with respect to this one. Usually you will want to specify --batch when setting this to false.
default: "true"
loses incremental_state
--ui_actions_shown=<integer>
Number of concurrent actions shown in the detailed progress bar; each action is shown on a separate line. The progress bar always shows at least one one, all numbers less than 1 are mapped to 1. This option has no effect if --noui is set.
default: "8"
terminal output
--watchfs=<true or false>
On Linux/macOS: If true, bazel tries to use the operating system's file watch service for local changes instead of scanning every file for a change. On Windows: this flag is a non-op.
default: "false"