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_allow_tags_propagation --
incompatible_assignment_identifiers_have_local_scope --
incompatible_bzl_disallow_load_after_statement --
incompatible_depset_for_libraries_to_link_getter --
incompatible_depset_is_not_iterable --incompatible_depset_union --
incompatible_disable_deprecated_attr_params --
incompatible_disable_objc_provider_resources --
incompatible_disable_partition_default_parameter --
incompatible_disable_target_provider_fields --
incompatible_disable_third_party_license_checking --
incompatible_disallow_dict_lookup_unhashable_keys --
incompatible_disallow_dict_plus --incompatible_disallow_empty_glob --
incompatible_disallow_hashing_frozen_mutables --
incompatible_disallow_legacy_java_provider --
incompatible_disallow_legacy_javainfo --
incompatible_disallow_old_style_args_add --
incompatible_disallow_rule_execution_platform_constraints_allowed --
incompatible_disallow_split_empty_separator --
incompatible_disallow_struct_provider_syntax --
incompatible_disallow_unverified_http_downloads --
incompatible_do_not_split_linking_cmdline --
incompatible_enable_profile_by_default --incompatible_expand_directories
--incompatible_new_actions_api --incompatible_no_attr_license --
incompatible_no_output_attr_default --incompatible_no_rule_outputs_param
--incompatible_no_support_tools_in_action_inputs --
incompatible_no_target_output_group --incompatible_no_transitive_loads --
incompatible_objc_framework_cleanup --incompatible_remap_main_repo --
incompatible_remove_binary_profile --incompatible_remove_native_maven_jar
--incompatible_restrict_attribute_names --
incompatible_restrict_named_params --incompatible_restrict_string_escapes
--incompatible_run_shell_command_string --
incompatible_string_join_requires_strings --
incompatible_tls_enabled_removed --incompatible_use_native_patch
How to resolve aspect dependencies when the output format is one of {xml,
proto,record}. 'off' means no aspect dependencies are resolved,
'conservative' (the default) means all declared aspect dependencies are
added regardless of whether they are given the rule class of direct
dependencies, 'precise' means that only those aspects are added that are
possibly active given the rule class of the direct dependencies. Note that
precise mode requires loading other packages to evaluate a single target
thus making it slower than the other modes. Also note that even precise
mode is not completely precise: the decision whether to compute an aspect
is decided in the analysis phase, which is not run during 'bazel query'.
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.
Specifies the build event service (BES) backend endpoint as HOST or HOST:
PORT. Disabled by default.
BES best effort upload has been removed. The flag has no more functionality
attached to it and will be removed in a future release.
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.
Specifies whether to publish BES lifecycle events. (defaults to 'true').
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.
Specifies the maximal size of stdout or stderr to be sent to BEP in a
single message.
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.
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.
If non-empty, write a varint delimited binary representation of
representation of the build event protocol to that file.
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
If non-empty, write a JSON serialisation of the build event protocol to
that file.
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
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.
If non-empty, write a textual representation of the build event protocol to
that file
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
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.
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.
Additional places to search for archives before accessing the network to
download them.
This flag will be removed in Bazel 1.0. Please do not use it.
Incremental repository updates feature is now enabled without the flag.
If true, expand Filesets in the BEP when presenting output files.
Selects how to upload artifacts referenced in the build event protocol.
If set to true, enables the APIs required to support the Android Starlark
migration.
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.
If set to true, exposes a number of experimental pieces of Starlark build
API pertaining to Google legacy code.
If true, uses a Query implementation that does not make a copy of the
graph. The new implementation only supports --order_output=no, as well as
only a subset of output formatters.
If enabled, Bazel compresses the JSON-format profile with gzip.
Whether to always compute MD5 digests of files with multiple threads. Might improve performance when using an SSD.
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.
If set to true, enables a number of platform-related Starlark APIs useful
for debugging.
If set, Bazel will post the ProfilerStartedEvent including the path to the
profile.
If set, Bazel will add action counts at the top of the JSON profile.
--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 or unknown>
Specifies additional profile tasks to be included in the profile.
If set, Bazel will measure cpu usage and add it to the JSON profile.
If true, uses a ForkJoinPool instead of a PriorityBlockingQueue for
Skyframe.
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.
If non-empty, specifies a file containing a resolved value, against which
the repository directory hashes should be verified
If non-empty, write a Skylark value with the resolved information of all
Starlark repository rules that were executed.
If non-empty read the specified resolved file instead of the WORKSPACE file
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
Slims down the size of the JSON profile by merging events if the profile
gets too large.
If set to true, enables creation of configuration transition objects (the
`transition()` function) in Starlark.
If set to true, enables use of 'unused_inputs_list' in starlark action.
run().
Make the UI deduplicate messages to have a cleaner scroll-back log.
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.
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.
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.
Log certain Workspace Rules events into this file as delimited WorkspaceEvent protos.
A comma-separated list of Google Cloud authentication scopes.
Specifies the file to get authentication credentials from. See https://cloud.google.com/docs/authentication for details.
Whether to use 'Google Application Default Credentials' for authentication. See https://cloud.google.com/docs/authentication for details. Disabled by default.
The maximum number of condition labels to show. -1 means no truncation and
0 means no annotation. This option is only applicable to --output=graph.
If true, then the graph will be emitted 'factored', i.e. topologically-
equivalent nodes will be merged together and their labels concatenated.
This option is only applicable to --output=graph.
The maximum length of the label string for a graph node in the output.
Longer labels will be truncated; -1 means no truncation. This option is
only applicable to --output=graph.
Query: If disabled, dependencies on 'host configuration' targets will not
be included in the dependency graph over which the query operates. A 'host
configuration' dependency edge, such as the one from any 'proto_library'
rule to the Protocol Compiler, usually points to a tool executed during the
build (on the host machine) rather than a part of the same 'target'
program.
Cquery: If disabled, filters out all configured targets which cross a host
transition from the top-level target that discovered this configured
target. That means if the top-level target is in the target configuration,
only configured targets also in the target configuration will be returned.
If the top-level target is in the host configuration, only host configured
targets will be returned.
If enabled, implicit dependencies will be included in the dependency graph
over which the query operates. An implicit dependency is one that is not
explicitly specified in the BUILD file but added by bazel.
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.
If set to true, LHS identifiers in assignment statements become local to
the the block containing the statement, and mask similarly named variables
in outer scopes.
If set to true, all `load` must be called at the top of .bzl files, before
any other statement.
When true, Bazel no longer returns a list from linking_context.
libraries_to_link but returns a depset instead.
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.
If set to true, depset union using `+`, `|` or `.union` are forbidden. Use
the `depset` constructor instead.
If set to true, disable the deprecated parameters 'single_file' and
'non_empty' on attribute definition methods, such as attr.label().
Unused. Will be removed in future versions of Bazel.
If set to true, the default value `' '` for the parameter `sep` of `string.
partion` and `string.rpartition` will be disabled.
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.
If true, disables all license checking logic
If set to true, dict key lookups using `in` or `dict.get` will fail with
unhashable types.
If set to true, the `+` becomes disabled for dicts.
If set to true, the default value of the `allow_empty` argument of glob()
is False.
If set to true, freezing a mutable object will not make it hashable.
If set to true, usages of old .java provider are disallowed.
If set to true, old-style JavaInfo provider construction is disallowed.
If set to true, vectorized calls to Args#add are disallowed.
If set to true, disallow the use of the
execution_platform_constraints_allowed attribute on rule().
If set to true, `string.split` will fail if `sep` is the empty string.
If set to true, rule implementation functions may not return a struct. They
must instead return a list of provider instances.
If set, disallow downloads via plain http if no checksum is given
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.
If enabled, Bazel will generate a JSON profile by default.
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.
If set to true, the API to create actions is only available on `ctx.
actions`, not on `ctx`.
If set to true, disables the function `attr.license`.
If set to true, disables the `default` parameter of the `attr.output` and
`attr.output_list` attribute definition functions.
If set to true, disables the `outputs` parameter of the `rule()` Starlark
function.
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`.
If set to true, disables the output_group field of the 'Target' Starlark
type.
If set to true, only symbols explicitly defined in the file can be loaded;
symbols introduced by load are not implicitly re-exported.
If enabled, use the post-cleanup mode for prebuilt frameworks. The cleanup
changes the objc provider API pertaining to frameworks. This change is
expected to be transparent to most users unless they write their own
Starlark rules to handle frameworks. See https://github.
com/bazelbuild/bazel/issues/7944 for details.
If set to true, will treat references to '@<main repo name>' the same as
'@'.
If enabled, Bazel will write JSON-format profiles instead of binary
profiles.
If set to true, the native maven_jar rule is disabled; only the Starlark
version will be available
If set to true, restrict rule attribute names to valid identifiers
If set to true, restricts a number of Starlark built-in function parameters
to be only specifiable positionally (and not by keyword).
If set to true, unknown string escapes like `\a` become rejected.
If set to true, the command parameter of actions.run_shell will only accept
string
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
If set to true, bazel will handle --tls_enabled as a not existing flag.See
#8061 for details.
If enabled, Bazel's repository rules use a native implementation of patch,
otherwise Bazel still calls patch command line tool for applying patch
files.
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.
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.
Use this to suppress generation of the legacy important_outputs field in
the TargetComplete event.
Whether each format is terminated with \0 instead of newline.
--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.
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.
If enabled, deps from "nodep" attributes will be included in the dependency
graph over which the query operates. A common example of a "nodep"
attribute is "visibility". Run and parse the output of `info build-
language` to learn about all the "nodep" attributes in the build language.
Output the results in dependency-ordered (default) or unordered fashion.
The unordered output is faster but only supported when --output is not
minrank, maxrank, or graph.
Expands to: --order_output=no
Whether each format is terminated with \0 instead of newline.
Expands to: --line_terminator_null=true
Output the results unordered (no), dependency-ordered (deps), or fully
ordered (full). The default is 'auto', meaning that results are output
either dependency-ordered or fully ordered, depending on the output
formatter (dependency-ordered for proto, minrank, maxrank, and graph, fully
ordered for all others). When output is fully ordered, nodes that would
otherwise be unordered by the output formatter are alphabetized before
output.
Output the results in dependency-ordered (default) or unordered fashion.
The unordered output is faster but only supported when --output is not
minrank, maxrank, or graph.
Expands to: --order_output=auto
The format in which the query results should be printed. Allowed values for
query are: build, graph, label, label_kind, locations, maxrank, minrank,
package, proto, xml.
Overrides a repository with a local directory.
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'.
If set, profile Bazel and write data to the specified file. Use bazel
analyze-profile to analyze the profile.
Show the command progress in the terminal title. Useful to see what bazel is doing when having multiple terminal tabs.
If true, attributes whose value is not explicitly specified in the BUILD
file are included; otherwise they are omitted. This option is applicable to
--output=proto
If enabled, configurable attributes created by select() are flattened. For
list types the flattened representation is a list containing each value of
the select map exactly once. Scalar types are flattened to null.
Comma separated list of attributes to include in output. Defaults to all
attributes. Set to empty string to not output any attribute. This option is
applicable to --output=proto.
Whether or not to populate the rule_input and rule_output fields.
If set, query will read the query from the file named here, rather than on
the command line. It is an error to specify a file here as well as a
command-line query.
If true, the location of BUILD files in xml and proto outputs will be
relative. By default, the location output is an absolute path and will not
be consistent across machines. You can set this option to true to have a
consistent result across machines.
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.
If enabled, causes Bazel to print "Loading package:" messages.
Minimum number of seconds between progress messages in the output.
Display progress messages when tasks complete, not just when they start.
If true, the tests() expression gives an error if it encounters a
test_suite containing non-test targets.
DEPRECATED. Specifies whether to use TLS for remote execution/caching and the build event service (BES). See #8061 for details.
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.
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.
A comma-separated set of target patterns (additive and subtractive). The
query may be performed in the universe defined by the transitive closure of
the specified targets. This option is used for the query and cquery
commands.
For cquery, the input to this option is the targets all answers are built
under and so this option may affect configurations and transitions. If this
option is not specified, the top-level targets are assumed to be the
targets parsed from the query expression. Note: For cquery, not specifying
this option may cause the build to break if targets parsed from the query
expression are not buildable with top-level options.
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.
If true, rule attributes whose value is not explicitly specified in the
BUILD file are printed; otherwise they are omitted.