allbuildtestrunquerystartup options
--action_cache=<true or false>
Dump action cache content.
default: "false"
bazel monitoring
--action_graph=<string>
Dump action graph to the specified path.
default: see description
bazel monitoring
--action_graph:include_artifacts=<true or false>
Include inputs and outputs actions in the action graph dump. This option does only apply to --action_graph.
default: "true"
bazel monitoring
--action_graph:include_cmdline=<true or false>
Include command line of actions in the action graph dump. This option does only apply to --action_graph.
default: "false"
bazel monitoring
--action_graph:targets=<comma-separated list of options>
Comma separated list of targets to include in action graph dump. Defaults to all attributes. This option does only apply to --action_graph.
default: "..."
bazel monitoring
--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_bzl_disallow_load_after_statement -- incompatible_depset_is_not_iterable --incompatible_depset_union -- incompatible_disable_deprecated_attr_params -- incompatible_disable_objc_provider_resources -- incompatible_disable_third_party_license_checking -- incompatible_disallow_dict_plus --incompatible_disallow_filetype -- incompatible_disallow_legacy_java_provider -- incompatible_disallow_legacy_javainfo -- incompatible_disallow_load_labels_to_cross_package_boundaries -- incompatible_disallow_native_in_build_file -- incompatible_disallow_old_style_args_add -- incompatible_disallow_struct_provider_syntax -- incompatible_do_not_split_linking_cmdline -- incompatible_expand_directories --incompatible_new_actions_api -- incompatible_no_attr_license --incompatible_no_output_attr_default -- incompatible_no_support_tools_in_action_inputs -- incompatible_no_target_output_group --incompatible_no_transitive_loads -- incompatible_remap_main_repo --incompatible_remove_native_maven_jar -- incompatible_string_join_requires_strings -- incompatible_use_toolchain_providers_in_java_common
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.
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_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_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
--check_third_party_targets_have_licenses=<true or false>
If true, all rules and files under //third_party must declare licenses([])
default: "true"
build file_semantics
--color=<yes, no or auto>
Use terminal controls to colorize output going to stderr.
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 going to stderr.
default: "auto"
--experimental_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
--experimental_build_event_upload_strategy=<string>
Selects how to upload artifacts referenced in the build event protocol.
default: see description
affects outputs
--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_external_repositories=<true or false>
Use external repositories for improved stability and speed when available.
default: "false"
--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.
default: "false"
affects outputs
bazel monitoring
--experimental_json_trace_compression=<true or false>
If enabled, Bazel compresses the JSON-format profile with gzip.
default: "false"
affects outputs
bazel monitoring
--experimental_multi_threaded_digest=<true or false>
Whether to always compute MD5 digests of files with multiple threads. Might improve performance when using an SSD.
default: "false"
--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_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, __inclusion_parse, __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 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_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: "false"
loading and_analysis
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: "false"
loading and_analysis
experimental
--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_workspace_rules_log_file=<string>
Log certain Workspace Rules events into this file as delimited WorkspaceEvent protos.
default: see description
--force_experimental_external_repositories=<true or false>
Forces --experimental_external_repositories.
default: "false"
--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"
--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_is_not_iterable=<true or false>
If set to true, depset type is not iterable. For loops and functions expecting an iterable will reject depset objects. Use the `.to_list` method to explicitly convert to a list.
default: "false"
build file_semantics
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: "false"
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: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disable_objc_provider_resources=<true or false>
If set to true, disallow use of deprecated resource fields on the Objc provider.
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. This overrides -- check_third_party_targets_have_licenses
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disallow_dict_plus=<true or false>
If set to true, the `+` becomes disabled for dicts.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disallow_filetype=<true or false>
If set to true, function `FileType` is not available.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disallow_legacy_java_provider=<true or false>
If set to true, usages of old .java provider are disallowed.
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disallow_legacy_javainfo=<true or false>
If set to true, old-style JavaInfo provider construction is disallowed.
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disallow_load_labels_to_cross_package_boundaries=<true or false>
If set to true, the label argument to 'load' cannot cross a package boundary.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disallow_native_in_build_file=<true or false>
If set to true, the native module is not accessible in BUILD files. Use for example `cc_library` instead of `native.cc_library`.
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_disallow_old_style_args_add=<true or false>
If set to true, vectorized calls to Args#add are disallowed.
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: "false"
loading and_analysis
incompatible change
triggered by_all_incompatible_changes
--incompatible_expand_directories=<true or false>
Controls whether directories are expanded to the list of files under that directory when added to Args, instead of replaced by the path of the directory.
default: "true"
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: "false"
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_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: "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: "false"
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: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_no_transitive_loads=<true or false>
If set to true, only symbols explicitly defined in the file can be loaded; symbols introduced by load are not implicitly re-exported.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_remap_main_repo=<true or false>
If set to true, will treat references to '@<main repo name>' the same as '@'.
default: "false"
loading and_analysis
incompatible change
triggered by_all_incompatible_changes
--incompatible_remove_native_maven_jar=<true or false>
If set to true, the native maven_jar rule is disabled; only the Starlark version will be available
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_string_join_requires_strings=<true or false>
If set to true, the argument of `string.join` must be an iterable whose elements are strings. If set to false, elements are first converted to string. See https://github.com/bazelbuild/bazel/issues/7802
default: "false"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--incompatible_use_toolchain_providers_in_java_common=<true or false>
If set to true, java_common APIs that take a java_toolchain or host_javabase parameter require a JavaTootoolchainInfo or JavaRuntimeInfo instead of a configured target.
default: "true"
build file_semantics
incompatible change
triggered by_all_incompatible_changes
--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
--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
--packages=<true or false>
Dump package cache content.
default: "false"
bazel monitoring
--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
--rule_classes=<true or false>
Dump rule classes.
default: "false"
bazel monitoring
--rules=<true or false>
Dump rules, including counts and memory usage (if memory is tracked).
default: "false"
bazel monitoring
--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"
--skyframe=<off, summary or detailed>
Dump Skyframe graph: 'off', 'summary', or 'detailed'.
default: "off"
bazel monitoring
--skylark_memory=<string>
Dumps a pprof-compatible memory profile to the specified path. To learn more please see <a href=https://github.com/google/pprof>pprof</a>.
default: see description
bazel monitoring
--tls_certificate=<string>
Specify the TLS client certificate to use.
default: see description
--tls_enabled=<true or false>
Specifies whether to use TLS for remote execution/caching and the build event service (BES).
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=<true or false>
Switches to a progress bar that more explicitly shows progress, such as loaded packages and executed actions.
default: "true"
--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"
--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"