fix: decode bazel event from bep (#50)
* fix: decode bazel event from bep
Signed-off-by: Thulio Ferraz Assis <3149049+f0rmiga@users.noreply.github.com>
* refactor: simplify BEPEventCallback
Signed-off-by: Thulio Ferraz Assis <3149049+f0rmiga@users.noreply.github.com>
* feat: original bazel BEP protos
Signed-off-by: Thulio Ferraz Assis <3149049+f0rmiga@users.noreply.github.com>
* feat: use gazelle to manage third-party protos
Signed-off-by: Thulio Ferraz Assis <3149049+f0rmiga@users.noreply.github.com>
* fix: remove io_bazel
Signed-off-by: Thulio Ferraz Assis <3149049+f0rmiga@users.noreply.github.com>
* fix: make go tooling happy again
Signed-off-by: Thulio Ferraz Assis <3149049+f0rmiga@users.noreply.github.com>
diff --git a/bazel/buildeventstream/proto/BUILD.bazel b/bazel/buildeventstream/proto/BUILD.bazel
new file mode 100644
index 0000000..137d8b9
--- /dev/null
+++ b/bazel/buildeventstream/proto/BUILD.bazel
@@ -0,0 +1 @@
+# gazelle:exclude dummy.go
diff --git a/bazel/buildeventstream/proto/dummy.go b/bazel/buildeventstream/proto/dummy.go
new file mode 100644
index 0000000..6e412bf
--- /dev/null
+++ b/bazel/buildeventstream/proto/dummy.go
@@ -0,0 +1,3 @@
+// This file exists to make the go tooling happy. This package is generated by
+// bazel in //third-party/github.com/bazelbuild/bazel/...
+package proto
diff --git a/pkg/aspect/build/BUILD.bazel b/pkg/aspect/build/BUILD.bazel
index fe73fd8..f0f3e75 100644
--- a/pkg/aspect/build/BUILD.bazel
+++ b/pkg/aspect/build/BUILD.bazel
@@ -11,8 +11,8 @@
"//pkg/bazel",
"//pkg/hooks",
"//pkg/ioutils",
+ "//third-party/github.com/bazelbuild/bazel/src/main/java/com/google/devtools/build/lib/buildeventstream/proto",
"@com_github_spf13_cobra//:cobra",
- "@go_googleapis//google/devtools/build/v1:build_go_proto",
],
)
diff --git a/pkg/aspect/build/bep/BUILD.bazel b/pkg/aspect/build/bep/BUILD.bazel
index 980e801..3b9feb7 100644
--- a/pkg/aspect/build/bep/BUILD.bazel
+++ b/pkg/aspect/build/bep/BUILD.bazel
@@ -8,6 +8,7 @@
deps = [
"//pkg/aspecterrors",
"//pkg/aspectgrpc",
+ "//third-party/github.com/bazelbuild/bazel/src/main/java/com/google/devtools/build/lib/buildeventstream/proto",
"@go_googleapis//google/devtools/build/v1:build_go_proto",
"@io_bazel_rules_go//proto/wkt:empty_go_proto",
"@org_golang_google_grpc//:go_default_library",
@@ -22,8 +23,10 @@
"//pkg/aspecterrors",
"//pkg/aspectgrpc/mock",
"//pkg/stdlib/mock",
+ "//third-party/github.com/bazelbuild/bazel/src/main/java/com/google/devtools/build/lib/buildeventstream/proto",
"@com_github_golang_mock//gomock",
"@com_github_onsi_gomega//:gomega",
"@go_googleapis//google/devtools/build/v1:build_go_proto",
+ "@org_golang_google_protobuf//types/known/anypb",
],
)
diff --git a/pkg/aspect/build/bep/bes_backend.go b/pkg/aspect/build/bep/bes_backend.go
index dfb37e1..75d8784 100644
--- a/pkg/aspect/build/bep/bes_backend.go
+++ b/pkg/aspect/build/bep/bes_backend.go
@@ -17,6 +17,7 @@
buildv1 "google.golang.org/genproto/googleapis/devtools/build/v1"
"google.golang.org/grpc"
+ buildeventstream "aspect.build/cli/bazel/buildeventstream/proto"
"aspect.build/cli/pkg/aspecterrors"
"aspect.build/cli/pkg/aspectgrpc"
)
@@ -118,7 +119,7 @@
// CallbackFn is the signature for the callback function used by the subscribers
// of the Build Event Protocol events.
-type CallbackFn func(*buildv1.BuildEvent) error
+type CallbackFn func(*buildeventstream.BuildEvent) error
// RegisterSubscriber registers a new subscriber callback function to the
// Build Event Protocol events.
@@ -149,12 +150,20 @@
}
event := req.OrderedBuildEvent.Event
if event != nil {
- s := bb.subscribers.head
- for s != nil {
- if err := s.callback(event); err != nil {
- bb.errors.Insert(err)
+ bazelEvent := event.GetBazelEvent()
+ if bazelEvent != nil {
+ var buildEvent buildeventstream.BuildEvent
+ if err := bazelEvent.UnmarshalTo(&buildEvent); err != nil {
+ return err
}
- s = s.next
+
+ s := bb.subscribers.head
+ for s != nil {
+ if err := s.callback(&buildEvent); err != nil {
+ bb.errors.Insert(err)
+ }
+ s = s.next
+ }
}
}
res := &buildv1.PublishBuildToolEventStreamResponse{
diff --git a/pkg/aspect/build/bep/bes_backend_test.go b/pkg/aspect/build/bep/bes_backend_test.go
index c633176..c527c7b 100644
--- a/pkg/aspect/build/bep/bes_backend_test.go
+++ b/pkg/aspect/build/bep/bes_backend_test.go
@@ -16,7 +16,9 @@
"github.com/golang/mock/gomock"
. "github.com/onsi/gomega"
buildv1 "google.golang.org/genproto/googleapis/devtools/build/v1"
+ "google.golang.org/protobuf/types/known/anypb"
+ buildeventstream "aspect.build/cli/bazel/buildeventstream/proto"
"aspect.build/cli/pkg/aspecterrors"
grpc_mock "aspect.build/cli/pkg/aspectgrpc/mock"
stdlib_mock "aspect.build/cli/pkg/stdlib/mock"
@@ -310,7 +312,10 @@
defer ctrl.Finish()
eventStream := grpc_mock.NewMockPublishBuildEvent_PublishBuildToolEventStreamServer(ctrl)
- event := &buildv1.BuildEvent{}
+ buildEvent := &buildeventstream.BuildEvent{}
+ var anyBuildEvent anypb.Any
+ anyBuildEvent.MarshalFrom(buildEvent)
+ event := &buildv1.BuildEvent{Event: &buildv1.BuildEvent_BazelEvent{BazelEvent: &anyBuildEvent}}
streamId := &buildv1.StreamId{BuildId: "1"}
orderedBuildEvent := &buildv1.OrderedBuildEvent{
StreamId: streamId,
@@ -345,20 +350,20 @@
errors: &aspecterrors.ErrorList{},
}
var calledSubscriber1, calledSubscriber2, calledSubscriber3 bool
- besBackend.RegisterSubscriber(func(evt *buildv1.BuildEvent) error {
- g.Expect(evt).To(Equal(event))
+ besBackend.RegisterSubscriber(func(evt *buildeventstream.BuildEvent) error {
+ g.Expect(evt).To(Equal(buildEvent))
calledSubscriber1 = true
return nil
})
expectedSubscriber2Err := fmt.Errorf("error from subscriber 2")
- besBackend.RegisterSubscriber(func(evt *buildv1.BuildEvent) error {
- g.Expect(evt).To(Equal(event))
+ besBackend.RegisterSubscriber(func(evt *buildeventstream.BuildEvent) error {
+ g.Expect(evt).To(Equal(buildEvent))
calledSubscriber2 = true
return expectedSubscriber2Err
})
expectedSubscriber3Err := fmt.Errorf("error from subscriber 3")
- besBackend.RegisterSubscriber(func(evt *buildv1.BuildEvent) error {
- g.Expect(evt).To(Equal(event))
+ besBackend.RegisterSubscriber(func(evt *buildeventstream.BuildEvent) error {
+ g.Expect(evt).To(Equal(buildEvent))
calledSubscriber3 = true
return expectedSubscriber3Err
})
diff --git a/pkg/aspect/build/build.go b/pkg/aspect/build/build.go
index 2118226..fa45e9b 100644
--- a/pkg/aspect/build/build.go
+++ b/pkg/aspect/build/build.go
@@ -13,8 +13,8 @@
"time"
"github.com/spf13/cobra"
- buildv1 "google.golang.org/genproto/googleapis/devtools/build/v1"
+ buildeventstream "aspect.build/cli/bazel/buildeventstream/proto"
"aspect.build/cli/pkg/aspect/build/bep"
"aspect.build/cli/pkg/aspecterrors"
"aspect.build/cli/pkg/bazel"
@@ -100,7 +100,7 @@
type Plugin interface {
// BEPEventsSubscriber is used to verify whether an Aspect plugin registers
// itself to receive the Build Event Protocol events.
- BEPEventCallback(event *buildv1.BuildEvent) error
+ BEPEventCallback(event *buildeventstream.BuildEvent) error
// TODO(f0rmiga): test the build hooks after implementing the plugin system.
PostBuildHook() error
}
diff --git a/pkg/plugins/fix_visibility/BUILD.bazel b/pkg/plugins/fix_visibility/BUILD.bazel
index 9366e2a..460857b 100644
--- a/pkg/plugins/fix_visibility/BUILD.bazel
+++ b/pkg/plugins/fix_visibility/BUILD.bazel
@@ -6,10 +6,10 @@
importpath = "aspect.build/cli/pkg/plugins/fix_visibility",
visibility = ["//cmd/aspect/build:__pkg__"],
deps = [
+ "//third-party/github.com/bazelbuild/bazel/src/main/java/com/google/devtools/build/lib/buildeventstream/proto",
"@bazel_gazelle//label:go_default_library",
"@com_github_bazelbuild_buildtools//edit:go_default_library",
"@com_github_manifoldco_promptui//:promptui",
"@com_github_mattn_go_isatty//:go-isatty",
- "@go_googleapis//google/devtools/build/v1:build_go_proto",
],
)
diff --git a/pkg/plugins/fix_visibility/plugin.go b/pkg/plugins/fix_visibility/plugin.go
index 90f549a..8085c57 100644
--- a/pkg/plugins/fix_visibility/plugin.go
+++ b/pkg/plugins/fix_visibility/plugin.go
@@ -18,7 +18,8 @@
"github.com/bazelbuild/buildtools/edit"
"github.com/manifoldco/promptui"
isatty "github.com/mattn/go-isatty"
- buildv1 "google.golang.org/genproto/googleapis/devtools/build/v1"
+
+ buildeventstream "aspect.build/cli/bazel/buildeventstream/proto"
)
type FixVisibilityPlugin struct {
@@ -54,19 +55,18 @@
}
var visibilityIssueRegex = regexp.MustCompile(`.*target '(.*)' is not visible from target '(.*)'.*`)
-var visibilityIssueSubstring = []byte("is not visible from target")
-func (plugin *FixVisibilityPlugin) BEPEventCallback(event *buildv1.BuildEvent) error {
- bazelEvent := event.GetBazelEvent()
- if bazelEvent != nil {
- if !bytes.Contains(bazelEvent.Value, visibilityIssueSubstring) {
- return nil
+const visibilityIssueSubstring = "is not visible from target"
+
+func (plugin *FixVisibilityPlugin) BEPEventCallback(event *buildeventstream.BuildEvent) error {
+ aborted := event.GetAborted()
+ if aborted != nil &&
+ aborted.Reason == buildeventstream.Aborted_ANALYSIS_FAILURE &&
+ strings.Contains(aborted.Description, visibilityIssueSubstring) {
+ matches := visibilityIssueRegex.FindStringSubmatch(aborted.Description)
+ if len(matches) == 3 {
+ plugin.targetsToFix.insert(matches[1], matches[2])
}
- matches := visibilityIssueRegex.FindSubmatch(bazelEvent.Value)
- if len(matches) != 3 {
- return nil
- }
- plugin.targetsToFix.insert(string(matches[1]), string(matches[2]))
}
return nil
}
diff --git a/third-party/github.com/bazelbuild/bazel/README.md b/third-party/github.com/bazelbuild/bazel/README.md
new file mode 100644
index 0000000..d33af69
--- /dev/null
+++ b/third-party/github.com/bazelbuild/bazel/README.md
@@ -0,0 +1,4 @@
+# bazel
+
+This is a partial clone of the `github.com/bazelbuild/bazel` repository. The
+vendored files here avoid a full clone of the original repository, which is big.
diff --git a/third-party/github.com/bazelbuild/bazel/src/main/java/com/google/devtools/build/lib/buildeventstream/proto/BUILD.bazel b/third-party/github.com/bazelbuild/bazel/src/main/java/com/google/devtools/build/lib/buildeventstream/proto/BUILD.bazel
new file mode 100644
index 0000000..352c8f2
--- /dev/null
+++ b/third-party/github.com/bazelbuild/bazel/src/main/java/com/google/devtools/build/lib/buildeventstream/proto/BUILD.bazel
@@ -0,0 +1,33 @@
+load("@io_bazel_rules_go//go:def.bzl", "go_library")
+load("@io_bazel_rules_go//proto:def.bzl", "go_proto_library")
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+ name = "proto_proto",
+ srcs = ["build_event_stream.proto"],
+ visibility = ["//visibility:public"],
+ deps = [
+ "//third-party/github.com/bazelbuild/bazel/src/main/protobuf/command_line:command_line_proto",
+ "//third-party/github.com/bazelbuild/bazel/src/main/protobuf/failure_details:failure_details_proto",
+ "//third-party/github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy:invocation_policy_proto",
+ ],
+)
+
+go_proto_library(
+ name = "proto_go_proto",
+ importpath = "aspect.build/cli/bazel/buildeventstream/proto",
+ proto = ":proto_proto",
+ visibility = ["//visibility:public"],
+ deps = [
+ "//third-party/github.com/bazelbuild/bazel/src/main/protobuf/command_line",
+ "//third-party/github.com/bazelbuild/bazel/src/main/protobuf/failure_details",
+ "//third-party/github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy",
+ ],
+)
+
+go_library(
+ name = "proto",
+ embed = [":proto_go_proto"],
+ importpath = "aspect.build/cli/bazel/buildeventstream/proto",
+ visibility = ["//visibility:public"],
+)
diff --git a/third-party/github.com/bazelbuild/bazel/src/main/java/com/google/devtools/build/lib/buildeventstream/proto/build_event_stream.proto b/third-party/github.com/bazelbuild/bazel/src/main/java/com/google/devtools/build/lib/buildeventstream/proto/build_event_stream.proto
new file mode 100644
index 0000000..eab85d4
--- /dev/null
+++ b/third-party/github.com/bazelbuild/bazel/src/main/java/com/google/devtools/build/lib/buildeventstream/proto/build_event_stream.proto
@@ -0,0 +1,827 @@
+// Copyright 2016 The Bazel Authors. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package build_event_stream;
+
+import "third-party/github.com/bazelbuild/bazel/src/main/protobuf/command_line/command_line.proto";
+import "third-party/github.com/bazelbuild/bazel/src/main/protobuf/failure_details/failure_details.proto";
+import "third-party/github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy/invocation_policy.proto";
+
+option go_package = "aspect.build/cli/bazel/buildeventstream/proto";
+
+// Identifier for a build event. It is deliberately structured to also provide
+// information about which build target etc the event is related to.
+//
+// Events are chained via the event id as follows: each event has an id and a
+// set of ids of children events such that apart from the initial event each
+// event has an id that is mentioned as child id in an earlier event and a build
+// invocation is complete if and only if all direct and indirect children of the
+// initial event have been posted.
+message BuildEventId {
+ // Generic identifier for a build event. This is the default type of
+ // BuildEventId, but should not be used outside testing; nevertheless,
+ // tools should handle build events with this kind of id gracefully.
+ message UnknownBuildEventId {
+ string details = 1;
+ }
+
+ // Identifier of an event reporting progress. Those events are also used to
+ // chain in events that come early.
+ message ProgressId {
+ // Unique identifier. No assumption should be made about how the ids are
+ // assigned; the only meaningful operation on this field is test for
+ // equality.
+ int32 opaque_count = 1;
+ }
+
+ // Identifier of an event indicating the beginning of a build; this will
+ // normally be the first event.
+ message BuildStartedId {}
+
+ // Identifier on an event indicating the original commandline received by
+ // the bazel server.
+ message UnstructuredCommandLineId {}
+
+ // Identifier on an event describing the commandline received by Bazel.
+ message StructuredCommandLineId {
+ // A title for this command line value, as there may be multiple.
+ // For example, a single invocation may wish to report both the literal and
+ // canonical command lines, and this label would be used to differentiate
+ // between both versions.
+ string command_line_label = 1;
+ }
+
+ // Identifier of an event indicating the workspace status.
+ message WorkspaceStatusId {}
+
+ // Identifier on an event reporting on the options included in the command
+ // line, both explicitly and implicitly.
+ message OptionsParsedId {}
+
+ // Identifier of an event reporting that an external resource was fetched
+ // from.
+ message FetchId {
+ // The external resource that was fetched from.
+ string url = 1;
+ }
+
+ // Identifier of an event indicating that a target pattern has been expanded
+ // further.
+ // Messages of this shape are also used to describe parts of a pattern that
+ // have been skipped for some reason, if the actual expansion was still
+ // carried out (e.g., if keep_going is set). In this case, the
+ // pattern_skipped choice in the id field is to be made.
+ message PatternExpandedId {
+ repeated string pattern = 1;
+ }
+
+ message WorkspaceConfigId {}
+
+ message BuildMetadataId {}
+
+ // Identifier of an event indicating that a target has been expanded by
+ // identifying for which configurations it should be build.
+ message TargetConfiguredId {
+ string label = 1;
+
+ // If not empty, the id refers to the expansion of the target for a given
+ // aspect.
+ string aspect = 2;
+ }
+
+ // Identifier of an event introducing a named set of files (usually artifacts)
+ // to be referred to in later messages.
+ message NamedSetOfFilesId {
+ // Identifier of the file set; this is an opaque string valid only for the
+ // particular instance of the event stream.
+ string id = 1;
+ }
+
+ // Identifier of an event introducing a configuration.
+ message ConfigurationId {
+ // Identifier of the configuration; users of the protocol should not make
+ // any assumptions about it having any structure, or equality of the
+ // identifier between different streams.
+ string id = 1;
+ }
+
+ // Identifier of an event indicating that a target was built completely; this
+ // does not include running the test if the target is a test target.
+ message TargetCompletedId {
+ string label = 1;
+
+ // The configuration for which the target was built.
+ ConfigurationId configuration = 3;
+
+ // If not empty, the id refers to the completion of the target for a given
+ // aspect.
+ string aspect = 2;
+ }
+
+ // Identifier of an event reporting that an action was completed (not all
+ // actions are reported, only the ones that can be considered important;
+ // this includes all failed actions).
+ message ActionCompletedId {
+ string primary_output = 1;
+ // Optional, the label of the owner of the action, for reference.
+ string label = 2;
+ // Optional, the id of the configuration of the action owner.
+ ConfigurationId configuration = 3;
+ }
+
+ // Identifier of an event reporting an event associated with an unconfigured
+ // label. Usually, this indicates a failure due to a missing input file. In
+ // any case, it will report some form of error (i.e., the payload will be an
+ // Aborted event); there are no regular events using this identifier. The
+ // purpose of those events is to serve as the root cause of a failed target.
+ message UnconfiguredLabelId {
+ string label = 1;
+ }
+
+ // Identifier of an event reporting an event associated with a configured
+ // label, usually a visibility error. In any case, an event with such an
+ // id will always report some form of error (i.e., the payload will be an
+ // Aborted event); there are no regular events using this identifier.
+ message ConfiguredLabelId {
+ string label = 1;
+ ConfigurationId configuration = 2;
+ }
+
+ // Identifier of an event reporting on an individual test run. The label
+ // identifies the test that is reported about, the remaining fields are
+ // in such a way as to uniquely identify the action within a build. In fact,
+ // attempts for the same test, run, shard triple are counted sequentially,
+ // starting with 1.
+ message TestResultId {
+ string label = 1;
+ ConfigurationId configuration = 5;
+ int32 run = 2;
+ int32 shard = 3;
+ int32 attempt = 4;
+ }
+
+ // Identifier of an event reporting the summary of a test.
+ message TestSummaryId {
+ string label = 1;
+ ConfigurationId configuration = 2;
+ }
+
+ // Identifier of the BuildFinished event, indicating the end of a build.
+ message BuildFinishedId {}
+
+ // Identifier of an event providing additional logs/statistics after
+ // completion of the build.
+ message BuildToolLogsId {}
+
+ // Identifier of an event providing build metrics after completion
+ // of the build.
+ message BuildMetricsId {}
+
+ // Identifier of an event providing convenience symlinks information.
+ message ConvenienceSymlinksIdentifiedId {}
+
+ oneof id {
+ UnknownBuildEventId unknown = 1;
+ ProgressId progress = 2;
+ BuildStartedId started = 3;
+ UnstructuredCommandLineId unstructured_command_line = 11;
+ StructuredCommandLineId structured_command_line = 18;
+ WorkspaceStatusId workspace_status = 14;
+ OptionsParsedId options_parsed = 12;
+ FetchId fetch = 17;
+ ConfigurationId configuration = 15;
+ TargetConfiguredId target_configured = 16;
+ PatternExpandedId pattern = 4;
+ PatternExpandedId pattern_skipped = 10;
+ NamedSetOfFilesId named_set = 13;
+ TargetCompletedId target_completed = 5;
+ ActionCompletedId action_completed = 6;
+ UnconfiguredLabelId unconfigured_label = 19;
+ ConfiguredLabelId configured_label = 21;
+ TestResultId test_result = 8;
+ TestSummaryId test_summary = 7;
+ BuildFinishedId build_finished = 9;
+ BuildToolLogsId build_tool_logs = 20;
+ BuildMetricsId build_metrics = 22;
+ WorkspaceConfigId workspace = 23;
+ BuildMetadataId build_metadata = 24;
+ ConvenienceSymlinksIdentifiedId convenience_symlinks_identified = 25;
+ }
+}
+
+// Payload of an event summarizing the progress of the build so far. Those
+// events are also used to be parents of events where the more logical parent
+// event cannot be posted yet as the needed information is not yet complete.
+message Progress {
+ // The next chunk of stdout that bazel produced since the last progress event
+ // or the beginning of the build.
+ string stdout = 1;
+
+ // The next chunk of stderr that bazel produced since the last progress event
+ // or the beginning of the build.
+ string stderr = 2;
+}
+
+// Payload of an event indicating that an expected event will not come, as
+// the build is aborted prematurely for some reason.
+message Aborted {
+ enum AbortReason {
+ UNKNOWN = 0;
+
+ // The user requested the build to be aborted (e.g., by hitting Ctl-C).
+ USER_INTERRUPTED = 1;
+
+ // The user requested that no analysis be performed.
+ NO_ANALYZE = 8;
+
+ // The user requested that no build be carried out.
+ NO_BUILD = 9;
+
+ // The build or target was aborted as a timeout was exceeded.
+ TIME_OUT = 2;
+
+ // The build or target was aborted as some remote environment (e.g., for
+ // remote execution of actions) was not available in the expected way.
+ REMOTE_ENVIRONMENT_FAILURE = 3;
+
+ // Failure due to reasons entirely internal to the build tool, i.e. an
+ // unexpected crash due to programmer error.
+ INTERNAL = 4;
+
+ // A Failure occurred in the loading phase of a target.
+ LOADING_FAILURE = 5;
+
+ // A Failure occurred in the analysis phase of a target.
+ ANALYSIS_FAILURE = 6;
+
+ // Target build was skipped (e.g. due to incompatible CPU constraints).
+ SKIPPED = 7;
+
+ // Build incomplete due to an earlier build failure (e.g. --keep_going was
+ // set to false causing the build be ended upon failure).
+ INCOMPLETE = 10;
+
+ // The build tool ran out of memory and crashed. Not yet used. OOMs are
+ // currently reported as INTERNAL.
+ // TODO(b/170643206): Use this reason for OOMs after updating consumers.
+ OUT_OF_MEMORY = 11;
+ }
+ AbortReason reason = 1;
+
+ // A human readable description with more details about there reason, where
+ // available and useful.
+ string description = 2;
+}
+
+// Payload of an event indicating the beginning of a new build. Usually, events
+// of those type start a new build-event stream. The target pattern requested
+// to be build is contained in one of the announced child events; it is an
+// invariant that precisely one of the announced child events has a non-empty
+// target pattern.
+message BuildStarted {
+ string uuid = 1;
+
+ // Start of the build in ms since the epoch.
+ // TODO(buchgr): Use google.protobuf.TimeStamp once bazel's protoc supports
+ // it.
+ int64 start_time_millis = 2;
+
+ // Version of the build tool that is running.
+ string build_tool_version = 3;
+
+ // A human-readable description of all the non-default option settings
+ string options_description = 4;
+
+ // The name of the command that the user invoked.
+ string command = 5;
+
+ // The working directory from which the build tool was invoked.
+ string working_directory = 6;
+
+ // The directory of the workspace.
+ string workspace_directory = 7;
+
+ // The process ID of the Bazel server.
+ int64 server_pid = 8;
+}
+
+// Configuration related to the blaze workspace and output tree.
+message WorkspaceConfig {
+ // The root of the local blaze exec root. All output files live underneath
+ // this at "blaze-out/".
+ string local_exec_root = 1;
+}
+
+// Payload of an event reporting the command-line of the invocation as
+// originally received by the server. Note that this is not the command-line
+// given by the user, as the client adds information about the invocation,
+// like name and relevant entries of rc-files and client environment variables.
+// However, it does contain enough information to reproduce the build
+// invocation.
+message UnstructuredCommandLine {
+ repeated string args = 1;
+}
+
+// Payload of an event reporting on the parsed options, grouped in various ways.
+message OptionsParsed {
+ repeated string startup_options = 1;
+ repeated string explicit_startup_options = 2;
+ repeated string cmd_line = 3;
+ repeated string explicit_cmd_line = 4;
+ blaze.invocation_policy.InvocationPolicy invocation_policy = 5;
+ string tool_tag = 6;
+}
+
+// Payload of an event indicating that an external resource was fetched. This
+// event will only occur in streams where an actual fetch happened, not in ones
+// where a cached copy of the entity to be fetched was used.
+message Fetch {
+ bool success = 1;
+}
+
+// Payload of an event reporting the workspace status. Key-value pairs can be
+// provided by specifying the workspace_status_command to an executable that
+// returns one key-value pair per line of output (key and value separated by a
+// space).
+message WorkspaceStatus {
+ message Item {
+ string key = 1;
+ string value = 2;
+ }
+ repeated Item item = 1;
+}
+
+// Payload of an event reporting custom key-value metadata associated with the
+// build.
+message BuildMetadata {
+ // Custom metadata for the build.
+ map<string, string> metadata = 1;
+}
+
+// Payload of an event reporting details of a given configuration.
+message Configuration {
+ string mnemonic = 1;
+ string platform_name = 2;
+ string cpu = 3;
+ map<string, string> make_variable = 4;
+}
+
+// Payload of the event indicating the expansion of a target pattern.
+// The main information is in the chaining part: the id will contain the
+// target pattern that was expanded and the children id will contain the
+// target or target pattern it was expanded to.
+message PatternExpanded {}
+
+// Enumeration type characterizing the size of a test, as specified by the
+// test rule.
+enum TestSize {
+ UNKNOWN = 0;
+ SMALL = 1;
+ MEDIUM = 2;
+ LARGE = 3;
+ ENORMOUS = 4;
+}
+
+// Payload of the event indicating that the configurations for a target have
+// been identified. As with pattern expansion the main information is in the
+// chaining part: the id will contain the target that was configured and the
+// children id will contain the configured targets it was configured to.
+message TargetConfigured {
+ // The kind of target (e.g., e.g. "cc_library rule", "source file",
+ // "generated file") where the completion is reported.
+ string target_kind = 1;
+
+ // The size of the test, if the target is a test target. Unset otherwise.
+ TestSize test_size = 2;
+
+ // List of all tags associated with this target (for all possible
+ // configurations).
+ repeated string tag = 3;
+}
+
+message File {
+ // A sequence of prefixes to apply to the file name to construct a full path.
+ // In most but not all cases, there will be 3 entries:
+ // 1. A root output directory, eg "bazel-out"
+ // 2. A configuration mnemonic, eg "k8-fastbuild"
+ // 3. An output category, eg "genfiles"
+ repeated string path_prefix = 4;
+
+ // identifier indicating the nature of the file (e.g., "stdout", "stderr")
+ string name = 1;
+
+ oneof file {
+ // A location where the contents of the file can be found. The string is
+ // encoded according to RFC2396.
+ string uri = 2;
+ // The contents of the file, if they are guaranteed to be short.
+ bytes contents = 3;
+ }
+}
+
+// Payload of a message to describe a set of files, usually build artifacts, to
+// be referred to later by their name. In this way, files that occur identically
+// as outputs of several targets have to be named only once.
+message NamedSetOfFiles {
+ // Files that belong to this named set of files.
+ repeated File files = 1;
+
+ // Other named sets whose members also belong to this set.
+ repeated BuildEventId.NamedSetOfFilesId file_sets = 2;
+}
+
+// Payload of the event indicating the completion of an action. The main purpose
+// of posting those events is to provide details on the root cause for a target
+// failing; however, consumers of the build-event protocol must not assume
+// that only failed actions are posted.
+message ActionExecuted {
+ bool success = 1;
+
+ // The mnemonic of the action that was executed
+ string type = 8;
+
+ // The exit code of the action, if it is available.
+ int32 exit_code = 2;
+
+ // Location where to find the standard output of the action
+ // (e.g., a file path).
+ File stdout = 3;
+
+ // Location where to find the standard error of the action
+ // (e.g., a file path).
+ File stderr = 4;
+
+ // Deprecated. This field is now present on ActionCompletedId.
+ string label = 5 [deprecated = true];
+
+ // Deprecated. This field is now present on ActionCompletedId.
+ BuildEventId.ConfigurationId configuration = 7 [deprecated = true];
+
+ // Primary output; only provided for successful actions.
+ File primary_output = 6;
+
+ // The command-line of the action, if the action is a command.
+ repeated string command_line = 9;
+
+ // List of paths to log files
+ repeated File action_metadata_logs = 10;
+
+ // Only populated if success = false, and sometimes not even then.
+ failure_details.FailureDetail failure_detail = 11;
+}
+
+// Collection of all output files belonging to that output group.
+message OutputGroup {
+ // Ids of fields that have been removed.
+ reserved 2;
+
+ // Name of the output group
+ string name = 1;
+
+ // List of file sets that belong to this output group as well.
+ repeated BuildEventId.NamedSetOfFilesId file_sets = 3;
+}
+
+// Payload of the event indicating the completion of a target. The target is
+// specified in the id. If the target failed the root causes are provided as
+// children events.
+message TargetComplete {
+ bool success = 1;
+
+ // The kind of target (e.g., e.g. "cc_library rule", "source file",
+ // "generated file") where the completion is reported.
+ // Deprecated: use the target_kind field in TargetConfigured instead.
+ string target_kind = 5 [deprecated = true];
+
+ // The size of the test, if the target is a test target. Unset otherwise.
+ // Deprecated: use the test_size field in TargetConfigured instead.
+ TestSize test_size = 6 [deprecated = true];
+
+ // The output files are arranged by their output group. If an output file
+ // is part of multiple output groups, it appears once in each output
+ // group.
+ repeated OutputGroup output_group = 2;
+
+ // Temporarily, also report the important outputs directly. This is only to
+ // allow existing clients help transition to the deduplicated representation;
+ // new clients should not use it.
+ repeated File important_output = 4 [deprecated = true];
+
+ // Report output artifacts (referenced transitively via output_group) which
+ // emit directories instead of singleton files. These directory_output entries
+ // will never include a uri.
+ repeated File directory_output = 8;
+
+ // List of tags associated with this configured target.
+ repeated string tag = 3;
+
+ // The timeout specified for test actions under this configured target.
+ int64 test_timeout_seconds = 7;
+
+ // Failure information about the target, only populated if success is false,
+ // and sometimes not even then. Equal to one of the ActionExecuted
+ // failure_detail fields for one of the root cause ActionExecuted events.
+ failure_details.FailureDetail failure_detail = 9;
+}
+
+enum TestStatus {
+ NO_STATUS = 0;
+ PASSED = 1;
+ FLAKY = 2;
+ TIMEOUT = 3;
+ FAILED = 4;
+ INCOMPLETE = 5;
+ REMOTE_FAILURE = 6;
+ FAILED_TO_BUILD = 7;
+ TOOL_HALTED_BEFORE_TESTING = 8;
+}
+
+// Payload on events reporting about individual test action.
+message TestResult {
+ reserved 1;
+
+ // The status of this test.
+ TestStatus status = 5;
+
+ // Additional details about the status of the test. This is intended for
+ // user display and must not be parsed.
+ string status_details = 9;
+
+ // True, if the reported attempt is taken from the tool's local cache.
+ bool cached_locally = 4;
+
+ // Time in milliseconds since the epoch at which the test attempt was started.
+ // Note: for cached test results, this is time can be before the start of the
+ // build.
+ int64 test_attempt_start_millis_epoch = 6;
+
+ // Time the test took to run. For locally cached results, this is the time
+ // the cached invocation took when it was invoked.
+ int64 test_attempt_duration_millis = 3;
+
+ // Files (logs, test.xml, undeclared outputs, etc) generated by that test
+ // action.
+ repeated File test_action_output = 2;
+
+ // Warnings generated by that test action.
+ repeated string warning = 7;
+
+ // Message providing optional meta data on the execution of the test action,
+ // if available.
+ message ExecutionInfo {
+ // Deprecated, use TargetComplete.test_timeout_seconds instead.
+ int32 timeout_seconds = 1 [deprecated = true];
+
+ // Name of the strategy to execute this test action (e.g., "local",
+ // "remote")
+ string strategy = 2;
+
+ // True, if the reported attempt was a cache hit in a remote cache.
+ bool cached_remotely = 6;
+
+ // The exit code of the test action.
+ int32 exit_code = 7;
+
+ // The hostname of the machine where the test action was executed (in case
+ // of remote execution), if known.
+ string hostname = 3;
+
+ // Represents a hierarchical timing breakdown of an activity.
+ // The top level time should be the total time of the activity.
+ // Invariant: time_millis >= sum of time_millis of all direct children.
+ message TimingBreakdown {
+ repeated TimingBreakdown child = 1;
+ string name = 2;
+ int64 time_millis = 3;
+ }
+ TimingBreakdown timing_breakdown = 4;
+
+ message ResourceUsage {
+ string name = 1;
+ int64 value = 2;
+ }
+ repeated ResourceUsage resource_usage = 5;
+ }
+ ExecutionInfo execution_info = 8;
+}
+
+// Payload of the event summarizing a test.
+message TestSummary {
+ // Wrapper around BlazeTestStatus to support importing that enum to proto3.
+ // Overall status of test, accumulated over all runs, shards, and attempts.
+ TestStatus overall_status = 5;
+
+ // Total number of runs
+ int32 total_run_count = 1;
+
+ // Number of runs.
+ int32 run_count = 10;
+
+ // Number of shards.
+ int32 shard_count = 11;
+
+ // Path to logs of passed runs.
+ repeated File passed = 3;
+
+ // Path to logs of failed runs;
+ repeated File failed = 4;
+
+ // Total number of cached test actions
+ int32 total_num_cached = 6;
+
+ // When the test first started running.
+ int64 first_start_time_millis = 7;
+
+ // When the last test action completed.
+ int64 last_stop_time_millis = 8;
+
+ // The total runtime of the test.
+ int64 total_run_duration_millis = 9;
+}
+
+// Event indicating the end of a build.
+message BuildFinished {
+ // Exit code of a build. The possible values correspond to the predefined
+ // codes in bazel's lib.ExitCode class, as well as any custom exit code a
+ // module might define. The predefined exit codes are subject to change (but
+ // rarely do) and are not part of the public API.
+ //
+ // A build was successful iff ExitCode.code equals 0.
+ message ExitCode {
+ // The name of the exit code.
+ string name = 1;
+
+ // The exit code.
+ int32 code = 2;
+ }
+
+ // Things that happened during the build that could be of interest.
+ message AnomalyReport {
+ // Was the build suspended at any time during the build.
+ // Examples of suspensions are SIGSTOP, or the hardware being put to sleep.
+ // If was_suspended is true, then most of the timings for this build are
+ // suspect.
+ bool was_suspended = 1;
+ }
+
+ // If the build succeeded or failed.
+ bool overall_success = 1 [deprecated = true];
+
+ // The overall status of the build. A build was successful iff
+ // ExitCode.code equals 0.
+ ExitCode exit_code = 3;
+
+ // Time in milliseconds since the epoch.
+ // TODO(buchgr): Use google.protobuf.Timestamp once bazel's protoc supports
+ // it.
+ int64 finish_time_millis = 2;
+
+ AnomalyReport anomaly_report = 4;
+}
+
+message BuildMetrics {
+ message ActionSummary {
+ // The total number of actions created and registered during the build.
+ // This includes unused actions that were constructed but
+ // not executed during this build.
+ int64 actions_created = 1;
+
+ // The total number of actions executed during the build.
+ // This includes any remote cache hits, but excludes
+ // local action cache hits.
+ int64 actions_executed = 2;
+ }
+ ActionSummary action_summary = 1;
+
+ message MemoryMetrics {
+ // Size of the JVM heap post build in bytes. This is only collected if
+ // --bep_publish_used_heap_size_post_build is set,
+ // since it forces a full GC.
+ int64 used_heap_size_post_build = 1;
+
+ // Size of the peak JVM heap size in bytes post GC. Note that this reports 0
+ // if there was no major GC during the build.
+ int64 peak_post_gc_heap_size = 2;
+ }
+ MemoryMetrics memory_metrics = 2;
+
+ message TargetMetrics {
+ // Number of targets loaded during this build.
+ int64 targets_loaded = 1;
+
+ // Number of targets configured during this build. This can
+ // be greater than targets_loaded if the same target is configured
+ // multiple times.
+ int64 targets_configured = 2;
+ }
+ TargetMetrics target_metrics = 3;
+
+ message PackageMetrics {
+ // Number of BUILD files (aka packages) loaded during this build.
+ int64 packages_loaded = 1;
+ }
+ PackageMetrics package_metrics = 4;
+
+ message TimingMetrics {
+ // The CPU time in milliseconds consumed during this build.
+ int64 cpu_time_in_ms = 1;
+ // The elapsed wall time in milliseconds during this build.
+ int64 wall_time_in_ms = 2;
+ }
+ TimingMetrics timing_metrics = 5;
+}
+
+// Event providing additional statistics/logs after completion of the build.
+message BuildToolLogs {
+ repeated File log = 1;
+}
+
+// Event describing all convenience symlinks (i.e., workspace symlinks) to be
+// created or deleted once the execution phase has begun. Note that this event
+// does not say anything about whether or not the build tool actually executed
+// these filesystem operations; it only says what logical operations should be
+// performed. This event is emitted exactly once per build; if no symlinks are
+// to be modified, the event is still emitted with empty contents.
+message ConvenienceSymlinksIdentified {
+ repeated ConvenienceSymlink convenience_symlinks = 1;
+}
+
+// The message that contains what type of action to perform on a given path and
+// target of a symlink.
+message ConvenienceSymlink {
+ enum Action {
+ UNKNOWN = 0;
+
+ // Indicates a symlink should be created, or overwritten if it already
+ // exists.
+ CREATE = 1;
+
+ // Indicates a symlink should be deleted if it already exists.
+ DELETE = 2;
+ }
+
+ // The path of the symlink to be created or deleted, absolute or relative to
+ // the workspace, creating any directories necessary. If a symlink already
+ // exists at that location, then it should be replaced by a symlink pointing
+ // to the new target.
+ string path = 1;
+
+ // The operation we are performing on the symlink.
+ Action action = 2;
+
+ // If action is CREATE, this is the target path that the symlink should point
+ // to. If the path points underneath the output base, it is relative to the
+ // output base; otherwise it is absolute.
+ //
+ // If action is DELETE, this field is not set.
+ string target = 3;
+}
+
+// Message describing a build event. Events will have an identifier that
+// is unique within a given build invocation; they also announce follow-up
+// events as children. More details, which are specific to the kind of event
+// that is observed, is provided in the payload. More options for the payload
+// might be added in the future.
+message BuildEvent {
+ reserved 11, 19;
+ BuildEventId id = 1;
+ repeated BuildEventId children = 2;
+ bool last_message = 20;
+ oneof payload {
+ Progress progress = 3;
+ Aborted aborted = 4;
+ BuildStarted started = 5;
+ UnstructuredCommandLine unstructured_command_line = 12;
+ command_line.CommandLine structured_command_line = 22;
+ OptionsParsed options_parsed = 13;
+ WorkspaceStatus workspace_status = 16;
+ Fetch fetch = 21;
+ Configuration configuration = 17;
+ PatternExpanded expanded = 6;
+ TargetConfigured configured = 18;
+ ActionExecuted action = 7;
+ NamedSetOfFiles named_set_of_files = 15;
+ TargetComplete completed = 8;
+ TestResult test_result = 10;
+ TestSummary test_summary = 9;
+ BuildFinished finished = 14;
+ BuildToolLogs build_tool_logs = 23;
+ BuildMetrics build_metrics = 24;
+ WorkspaceConfig workspace_info = 25;
+ BuildMetadata build_metadata = 26;
+ ConvenienceSymlinksIdentified convenience_symlinks_identified = 27;
+ }
+}
diff --git a/third-party/github.com/bazelbuild/bazel/src/main/protobuf/command_line/BUILD.bazel b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/command_line/BUILD.bazel
new file mode 100644
index 0000000..e0fa42c
--- /dev/null
+++ b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/command_line/BUILD.bazel
@@ -0,0 +1,25 @@
+load("@io_bazel_rules_go//go:def.bzl", "go_library")
+load("@io_bazel_rules_go//proto:def.bzl", "go_proto_library")
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+ name = "command_line_proto",
+ srcs = ["command_line.proto"],
+ visibility = ["//visibility:public"],
+ deps = ["//third-party/github.com/bazelbuild/bazel/src/main/protobuf/options:options_proto"],
+)
+
+go_proto_library(
+ name = "command_line_go_proto",
+ importpath = "github.com/bazelbuild/bazel/src/main/protobuf/command_line",
+ proto = ":command_line_proto",
+ visibility = ["//visibility:public"],
+ deps = ["//third-party/github.com/bazelbuild/bazel/src/main/protobuf/options"],
+)
+
+go_library(
+ name = "command_line",
+ embed = [":command_line_go_proto"],
+ importpath = "github.com/bazelbuild/bazel/src/main/protobuf/command_line",
+ visibility = ["//visibility:public"],
+)
diff --git a/third-party/github.com/bazelbuild/bazel/src/main/protobuf/command_line/command_line.proto b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/command_line/command_line.proto
new file mode 100644
index 0000000..acad31c
--- /dev/null
+++ b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/command_line/command_line.proto
@@ -0,0 +1,101 @@
+// Copyright 2017 The Bazel Authors. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+package command_line;
+
+option go_package = "github.com/bazelbuild/bazel/src/main/protobuf/command_line";
+
+import "third-party/github.com/bazelbuild/bazel/src/main/protobuf/options/option_filters.proto";
+
+// Representation of a Bazel command line.
+message CommandLine {
+ // A title for this command line value, to differentiate it from others.
+ // In particular, a single invocation may wish to report both the literal and
+ // canonical command lines, and this label would be used to differentiate
+ // between both versions. This is a string for flexibility.
+ string command_line_label = 1;
+
+ // A Bazel command line is made of distinct parts. For example,
+ // `bazel --nomaster_bazelrc test --nocache_test_results //foo:aTest`
+ // has the executable "bazel", a startup flag, a command "test", a command
+ // flag, and a test target. There could be many more flags and targets, or
+ // none (`bazel info` for example), but the basic structure is there. The
+ // command line should be broken down into these logical sections here.
+ repeated CommandLineSection sections = 2;
+}
+
+// A section of the Bazel command line.
+message CommandLineSection {
+ // The name of this section, such as "startup_option" or "command".
+ string section_label = 1;
+
+ oneof section_type {
+ // Sections with non-options, such as the list of targets or the command,
+ // should use simple string chunks.
+ ChunkList chunk_list = 2;
+
+ // Startup and command options are lists of options and belong here.
+ OptionList option_list = 3;
+ }
+}
+
+// Wrapper to allow a list of strings in the "oneof" section_type.
+message ChunkList {
+ repeated string chunk = 1;
+}
+
+// Wrapper to allow a list of options in the "oneof" section_type.
+message OptionList {
+ repeated Option option = 1;
+}
+
+// A single command line option.
+//
+// This represents the option itself, but does not take into account the type of
+// option or how the parser interpreted it. If this option is part of a command
+// line that represents the actual input that Bazel received, it would, for
+// example, include expansion flags as they are. However, if this option
+// represents the canonical form of the command line, with the values as Bazel
+// understands them, then the expansion flag, which has no value, would not
+// appear, and the flags it expands to would.
+message Option {
+ // How the option looks with the option and its value combined. Depending on
+ // the purpose of this command line report, this could be the canonical
+ // form, or the way that the flag was set.
+ //
+ // Some examples: this might be `--foo=bar` form, or `--foo bar` with a space;
+ // for boolean flags, `--nobaz` is accepted on top of `--baz=false` and other
+ // negating values, or for a positive value, the unqualified `--baz` form
+ // is also accepted. This could also be a short `-b`, if the flag has an
+ // abbreviated form.
+ string combined_form = 1;
+
+ // The canonical name of the option, without the preceding dashes.
+ string option_name = 2;
+
+ // The value of the flag, or unset for flags that do not take values.
+ // Especially for boolean flags, this should be in canonical form, the
+ // combined_form field above gives room for showing the flag as it was set
+ // if that is preferred.
+ string option_value = 3;
+
+ // This flag's tagged effects. See OptionEffectTag's java documentation for
+ // details.
+ repeated options.OptionEffectTag effect_tags = 4;
+
+ // Metadata about the flag. See OptionMetadataTag's java documentation for
+ // details.
+ repeated options.OptionMetadataTag metadata_tags = 5;
+}
diff --git a/third-party/github.com/bazelbuild/bazel/src/main/protobuf/failure_details/BUILD.bazel b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/failure_details/BUILD.bazel
new file mode 100644
index 0000000..9a5031d
--- /dev/null
+++ b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/failure_details/BUILD.bazel
@@ -0,0 +1,24 @@
+load("@io_bazel_rules_go//go:def.bzl", "go_library")
+load("@io_bazel_rules_go//proto:def.bzl", "go_proto_library")
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+ name = "failure_details_proto",
+ srcs = ["failure_details.proto"],
+ visibility = ["//visibility:public"],
+ deps = ["@com_google_protobuf//:descriptor_proto"],
+)
+
+go_proto_library(
+ name = "failure_details_go_proto",
+ importpath = "aspect.build/cli/third-party/github.com/bazelbuild/bazel/src/main/protobuf/failure_details",
+ proto = ":failure_details_proto",
+ visibility = ["//visibility:public"],
+)
+
+go_library(
+ name = "failure_details",
+ embed = [":failure_details_go_proto"],
+ importpath = "aspect.build/cli/third-party/github.com/bazelbuild/bazel/src/main/protobuf/failure_details",
+ visibility = ["//visibility:public"],
+)
diff --git a/third-party/github.com/bazelbuild/bazel/src/main/protobuf/failure_details/failure_details.proto b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/failure_details/failure_details.proto
new file mode 100644
index 0000000..61afcd4
--- /dev/null
+++ b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/failure_details/failure_details.proto
@@ -0,0 +1,1225 @@
+// Copyright 2020 The Bazel Authors. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// This file's messages describe any failure(s) that occurred during Bazel's
+// handling of a request. The intent is to provide more detail to a Bazel client
+// than is conveyed with an exit code, to help those clients decide how to
+// respond to, or classify, a failure.
+
+syntax = "proto3";
+
+package failure_details;
+
+import "google/protobuf/descriptor.proto";
+
+message FailureDetailMetadata {
+ uint32 exit_code = 1;
+}
+
+ extend google.protobuf.EnumValueOptions {
+ FailureDetailMetadata metadata = 1078;
+}
+
+// The FailureDetail message type is designed such that consumers can extract a
+// basic classification of a FailureDetail message even if the consumer was
+// built with a stale definition. This forward compatibility is implemented via
+// conventions on FailureDetail and its submessage types, as follows.
+//
+// *** FailureDetail field numbers
+//
+// Field numbers 1 through 100 (inclusive) are reserved for generally applicable
+// values. Any number of these fields may be set on a FailureDetail message.
+//
+// Field numbers 101 through 10,000 (inclusive) are reserved for use inside the
+// "oneof" structure. Only one of these values should be set on a FailureDetail
+// message.
+//
+// Additional fields numbers are unlikely to be needed, but, for extreme future-
+// proofing purposes, field numbers 10,001 through 1,000,000 (inclusive;
+// excluding protobuf's reserved range 19000 through 19999) are reserved for
+// additional generally applicable values.
+//
+// *** FailureDetail's "oneof" submessages
+//
+// Each field in the "oneof" structure is a submessage corresponding to a
+// category of failure.
+//
+// In each of these submessage types, field number 1 is an enum whose values
+// correspond to a subcategory of the failure. Generally, the enum's constant
+// which maps to 0 should be interpreted as "unspecified", though this is not
+// required.
+//
+// *** Recommended forward compatibility strategy
+//
+// The recommended forward compatibility strategy is to reduce a FailureDetail
+// message to a pair of integers.
+//
+// The first integer corresponds to the field number of the submessage set
+// inside FailureDetail's "oneof", which corresponds with the failure's
+// category.
+//
+// The second integer corresponds to the value of the enum at field number 1
+// within that submessage, which corresponds with the failure's subcategory.
+//
+// WARNING: This functionality is experimental and should not be relied on at
+// this time.
+// TODO(mschaller): remove experimental warning
+message FailureDetail {
+ // A short human-readable message describing the failure, for debugging.
+ //
+ // This value is *not* intended to be used algorithmically.
+ string message = 1;
+
+ // Reserved for future generally applicable values. Any of these may be set.
+ reserved 2 to 100;
+
+ oneof category {
+ Interrupted interrupted = 101;
+ ExternalRepository external_repository = 103;
+ BuildProgress build_progress = 104;
+ RemoteOptions remote_options = 106;
+ ClientEnvironment client_environment = 107;
+ Crash crash = 108;
+ SymlinkForest symlink_forest = 110;
+ PackageOptions package_options = 114;
+ RemoteExecution remote_execution = 115;
+ Execution execution = 116;
+ Workspaces workspaces = 117;
+ CrashOptions crash_options = 118;
+ Filesystem filesystem = 119;
+ ExecutionOptions execution_options = 121;
+ Command command = 122;
+ Spawn spawn = 123;
+ GrpcServer grpc_server = 124;
+ CanonicalizeFlags canonicalize_flags = 125;
+ BuildConfiguration build_configuration = 126;
+ InfoCommand info_command = 127;
+ MemoryOptions memory_options = 129;
+ Query query = 130;
+ LocalExecution local_execution = 132;
+ ActionCache action_cache = 134;
+ FetchCommand fetch_command = 135;
+ SyncCommand sync_command = 136;
+ Sandbox sandbox = 137;
+ IncludeScanning include_scanning = 139;
+ TestCommand test_command = 140;
+ ActionQuery action_query = 141;
+ TargetPatterns target_patterns = 142;
+ CleanCommand clean_command = 144;
+ ConfigCommand config_command = 145;
+ ConfigurableQuery configurable_query = 146;
+ DumpCommand dump_command = 147;
+ HelpCommand help_command = 148;
+ MobileInstall mobile_install = 150;
+ ProfileCommand profile_command = 151;
+ RunCommand run_command = 152;
+ VersionCommand version_command = 153;
+ PrintActionCommand print_action_command = 154;
+ WorkspaceStatus workspace_status = 158;
+ JavaCompile java_compile = 159;
+ ActionRewinding action_rewinding = 160;
+ CppCompile cpp_compile = 161;
+ StarlarkAction starlark_action = 162;
+ NinjaAction ninja_action = 163;
+ DynamicExecution dynamic_execution = 164;
+ FailAction fail_action = 166;
+ SymlinkAction symlink_action = 167;
+ CppLink cpp_link = 168;
+ LtoAction lto_action = 169;
+ TestAction test_action = 172;
+ Worker worker = 173;
+ Analysis analysis = 174;
+ PackageLoading package_loading = 175;
+ Toolchain toolchain = 177;
+ StarlarkLoading starlark_loading = 179;
+ }
+
+ reserved 102; // For internal use
+ reserved 105; // For internal use
+ reserved 109; // For internal use
+ reserved 111 to 113; // For internal use
+ reserved 120; // For internal use
+ reserved 128; // For internal use
+ reserved 131; // For internal use
+ reserved 133; // For internal use
+ reserved 138; // For internal use
+ reserved 143; // For internal use
+ reserved 149; // For internal use
+ reserved 155 to 157; // For internal use
+ reserved 165; // For internal use
+ reserved 170 to 171; // For internal use
+ reserved 176; // For internal use
+ reserved 178; // For internal use
+}
+
+message Interrupted {
+ enum Code {
+ // Unknown interrupt. Avoid using this code, instead use INTERRUPTED.
+ INTERRUPTED_UNKNOWN = 0 [(metadata) = { exit_code: 8 }];
+
+ // Command was interrupted (cancelled).
+ INTERRUPTED = 28 [(metadata) = { exit_code: 8 }];
+
+ // The following more specific interrupt codes have been deprecated and
+ // consolidated into INTERRUPTED.
+ DEPRECATED_BUILD = 4 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_BUILD_COMPLETION = 5 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_PACKAGE_LOADING_SYNC = 6 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_EXECUTOR_COMPLETION = 7 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_COMMAND_DISPATCH = 8 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_INFO_ITEM = 9 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_AFTER_QUERY = 10 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_FETCH_COMMAND = 17 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_SYNC_COMMAND = 18 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_CLEAN_COMMAND = 20 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_MOBILE_INSTALL_COMMAND = 21 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_QUERY = 22 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_RUN_COMMAND = 23 [(metadata) = { exit_code: 8 }];
+ DEPRECATED_OPTIONS_PARSING = 27 [(metadata) = { exit_code: 8 }];
+
+ reserved 1 to 3; // For internal use
+ reserved 11 to 16; // For internal use
+ reserved 19; // For internal use
+ reserved 24 to 26; // For internal use
+ }
+
+ Code code = 1;
+}
+
+message Spawn {
+ enum Code {
+ SPAWN_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ // See the SpawnResult.Status Java enum for definitions of the following
+ // Spawn failure codes.
+ NON_ZERO_EXIT = 1 [(metadata) = { exit_code: 1 }];
+ TIMEOUT = 2 [(metadata) = { exit_code: 1 }];
+ // Note: Spawn OUT_OF_MEMORY leads to a BUILD_FAILURE exit_code because the
+ // build tool itself did not run out of memory.
+ OUT_OF_MEMORY = 3 [(metadata) = { exit_code: 1 }];
+ EXECUTION_FAILED = 4 [(metadata) = { exit_code: 34 }];
+ EXECUTION_DENIED = 5 [(metadata) = { exit_code: 1 }];
+ REMOTE_CACHE_FAILED = 6 [(metadata) = { exit_code: 34 }];
+ COMMAND_LINE_EXPANSION_FAILURE = 7 [(metadata) = { exit_code: 1 }];
+ EXEC_IO_EXCEPTION = 8 [(metadata) = { exit_code: 36 }];
+ INVALID_TIMEOUT = 9 [(metadata) = { exit_code: 1 }];
+ INVALID_REMOTE_EXECUTION_PROPERTIES = 10 [(metadata) = { exit_code: 1 }];
+ NO_USABLE_STRATEGY_FOUND = 11 [(metadata) = { exit_code: 1 }];
+ // TODO(b/138456686): this code should be deprecated when SpawnResult is
+ // refactored to prohibit undetailed failures
+ UNSPECIFIED_EXECUTION_FAILURE = 12 [(metadata) = { exit_code: 1 }];
+ }
+ Code code = 1;
+
+ // For Codes describing generic failure to spawn (eg. EXECUTION_FAILED and
+ // EXECUTION_DENIED) the `catastrophic` field may be set to true indicating a
+ // failure that immediately terminated the entire build tool.
+ bool catastrophic = 2;
+
+ // If Code is NON_ZERO_EXIT, the `spawn_exit_code` field may be set to the
+ // non-zero exit code returned by the spawned process to the OS.
+ //
+ // NOTE: This field must not be confused with the build tool's overall
+ // exit code.
+ int32 spawn_exit_code = 3;
+}
+
+message ExternalRepository {
+ enum Code {
+ EXTERNAL_REPOSITORY_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ OVERRIDE_DISALLOWED_MANAGED_DIRECTORIES = 1 [(metadata) = { exit_code: 2 }];
+ BAD_DOWNLOADER_CONFIG = 2 [(metadata) = { exit_code: 2 }];
+ }
+ Code code = 1;
+ // Additional data could include external repository names.
+}
+
+message BuildProgress {
+ enum Code {
+ BUILD_PROGRESS_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ OUTPUT_INITIALIZATION = 3 [(metadata) = { exit_code: 36 }];
+ BES_RUNS_PER_TEST_LIMIT_UNSUPPORTED = 4 [(metadata) = { exit_code: 2 }];
+ BES_LOCAL_WRITE_ERROR = 5 [(metadata) = { exit_code: 36 }];
+ BES_INITIALIZATION_ERROR = 6 [(metadata) = { exit_code: 36 }];
+ BES_UPLOAD_TIMEOUT_ERROR = 7 [(metadata) = { exit_code: 38 }];
+ BES_FILE_WRITE_TIMEOUT = 8 [(metadata) = { exit_code: 38 }];
+ BES_FILE_WRITE_IO_ERROR = 9 [(metadata) = { exit_code: 38 }];
+ BES_FILE_WRITE_INTERRUPTED = 10 [(metadata) = { exit_code: 38 }];
+ BES_FILE_WRITE_CANCELED = 11 [(metadata) = { exit_code: 38 }];
+ BES_FILE_WRITE_UNKNOWN_ERROR = 12 [(metadata) = { exit_code: 38 }];
+ BES_UPLOAD_LOCAL_FILE_ERROR = 13 [(metadata) = { exit_code: 38 }];
+ BES_STREAM_NOT_RETRYING_FAILURE = 14 [(metadata) = { exit_code: 45 }];
+ BES_STREAM_COMPLETED_WITH_UNACK_EVENTS_ERROR = 15
+ [(metadata) = { exit_code: 45 }];
+ BES_STREAM_COMPLETED_WITH_UNSENT_EVENTS_ERROR = 16
+ [(metadata) = { exit_code: 45 }];
+ BES_UPLOAD_RETRY_LIMIT_EXCEEDED_FAILURE = 17
+ [(metadata) = { exit_code: 38 }];
+ reserved 1, 2; // For internal use
+ }
+ Code code = 1;
+ // Additional data could include the build progress upload endpoint.
+}
+
+message RemoteOptions {
+ enum Code {
+ REMOTE_OPTIONS_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ REMOTE_DEFAULT_EXEC_PROPERTIES_LOGIC_ERROR = 1
+ [(metadata) = { exit_code: 2 }];
+ // Credentials could not be read from the requested file/socket/process/etc.
+ CREDENTIALS_READ_FAILURE = 2 [(metadata) = { exit_code: 36 }];
+ // Credentials could not be written to a shared, temporary file.
+ CREDENTIALS_WRITE_FAILURE = 3 [(metadata) = { exit_code: 36 }];
+ DOWNLOADER_WITHOUT_GRPC_CACHE = 4 [(metadata) = { exit_code: 2 }];
+ EXECUTION_WITH_INVALID_CACHE = 5 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message ClientEnvironment {
+ enum Code {
+ CLIENT_ENVIRONMENT_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ CLIENT_CWD_MALFORMED = 1 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message Crash {
+ enum Code {
+ CRASH_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ CRASH_OOM = 1 [(metadata) = { exit_code: 33 }];
+ }
+
+ Code code = 1;
+
+ // The cause chain of the crash, with the outermost throwable first. Limited
+ // to the outermost exception and at most 4 nested causes (so, max size of 5).
+ repeated Throwable causes = 2;
+}
+
+message Throwable {
+ // The class name of the java.lang.Throwable.
+ string throwable_class = 1;
+ // The throwable's message.
+ string message = 2;
+ // The result of calling toString on the deepest (i.e. closest to the
+ // throwable's construction site) 1000 (or fewer) StackTraceElements.
+ // Unstructured to simplify string matching.
+ repeated string stack_trace = 3;
+}
+
+message SymlinkForest {
+ enum Code {
+ SYMLINK_FOREST_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ TOPLEVEL_OUTDIR_PACKAGE_PATH_CONFLICT = 1 [(metadata) = { exit_code: 2 }];
+ TOPLEVEL_OUTDIR_USED_AS_SOURCE = 2 [(metadata) = { exit_code: 2 }];
+ CREATION_FAILED = 3 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message PackageOptions {
+ enum Code {
+ reserved 2, 3; // For internal use
+
+ PACKAGE_OPTIONS_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ PACKAGE_PATH_INVALID = 1 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message RemoteExecution {
+ // The association of some of these options with exit code 2, "command line
+ // error", seems sketchy. Especially worth reconsidering are the channel init
+ // failure modes, which can correspond to failures occurring in gRPC setup.
+ // These all correspond with current Bazel behavior.
+ enum Code {
+ REMOTE_EXECUTION_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ CAPABILITIES_QUERY_FAILURE = 1 [(metadata) = { exit_code: 34 }];
+ CREDENTIALS_INIT_FAILURE = 2 [(metadata) = { exit_code: 2 }];
+ CACHE_INIT_FAILURE = 3 [(metadata) = { exit_code: 2 }];
+ RPC_LOG_FAILURE = 4 [(metadata) = { exit_code: 2 }];
+ EXEC_CHANNEL_INIT_FAILURE = 5 [(metadata) = { exit_code: 2 }];
+ CACHE_CHANNEL_INIT_FAILURE = 6 [(metadata) = { exit_code: 2 }];
+ DOWNLOADER_CHANNEL_INIT_FAILURE = 7 [(metadata) = { exit_code: 2 }];
+ LOG_DIR_CLEANUP_FAILURE = 8 [(metadata) = { exit_code: 36 }];
+ CLIENT_SERVER_INCOMPATIBLE = 9 [(metadata) = { exit_code: 34 }];
+ DOWNLOADED_INPUTS_DELETION_FAILURE = 10 [(metadata) = { exit_code: 34 }];
+ REMOTE_DOWNLOAD_OUTPUTS_MINIMAL_WITHOUT_INMEMORY_DOTD = 11
+ [(metadata) = { exit_code: 2 }];
+ REMOTE_DOWNLOAD_OUTPUTS_MINIMAL_WITHOUT_INMEMORY_JDEPS = 12
+ [(metadata) = { exit_code: 2 }];
+ INCOMPLETE_OUTPUT_DOWNLOAD_CLEANUP_FAILURE = 13
+ [(metadata) = { exit_code: 36 }];
+ REMOTE_DEFAULT_PLATFORM_PROPERTIES_PARSE_FAILURE = 14
+ [(metadata) = { exit_code: 1 }];
+ ILLEGAL_OUTPUT = 15 [(metadata) = { exit_code: 1 }];
+ INVALID_EXEC_AND_PLATFORM_PROPERTIES = 16 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message Execution {
+ enum Code {
+ EXECUTION_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ EXECUTION_LOG_INITIALIZATION_FAILURE = 1 [(metadata) = { exit_code: 2 }];
+ EXECUTION_LOG_WRITE_FAILURE = 2 [(metadata) = { exit_code: 36 }];
+ EXECROOT_CREATION_FAILURE = 3 [(metadata) = { exit_code: 36 }];
+ TEMP_ACTION_OUTPUT_DIRECTORY_DELETION_FAILURE = 4
+ [(metadata) = { exit_code: 36 }];
+ TEMP_ACTION_OUTPUT_DIRECTORY_CREATION_FAILURE = 5
+ [(metadata) = { exit_code: 36 }];
+ PERSISTENT_ACTION_OUTPUT_DIRECTORY_CREATION_FAILURE = 6
+ [(metadata) = { exit_code: 36 }];
+ LOCAL_OUTPUT_DIRECTORY_SYMLINK_FAILURE = 7 [(metadata) = { exit_code: 36 }];
+ reserved 8; // was ACTION_INPUT_FILES_MISSING, now mostly
+ // SOURCE_INPUT_MISSING
+ LOCAL_TEMPLATE_EXPANSION_FAILURE = 9 [(metadata) = { exit_code: 36 }];
+ INPUT_DIRECTORY_CHECK_IO_EXCEPTION = 10 [(metadata) = { exit_code: 36 }];
+ EXTRA_ACTION_OUTPUT_CREATION_FAILURE = 11 [(metadata) = { exit_code: 36 }];
+ TEST_RUNNER_IO_EXCEPTION = 12 [(metadata) = { exit_code: 36 }];
+ FILE_WRITE_IO_EXCEPTION = 13 [(metadata) = { exit_code: 36 }];
+ TEST_OUT_ERR_IO_EXCEPTION = 14 [(metadata) = { exit_code: 36 }];
+ SYMLINK_TREE_MANIFEST_COPY_IO_EXCEPTION = 15
+ [(metadata) = { exit_code: 36 }];
+ SYMLINK_TREE_MANIFEST_LINK_IO_EXCEPTION = 16
+ [(metadata) = { exit_code: 36 }];
+ SYMLINK_TREE_CREATION_IO_EXCEPTION = 17 [(metadata) = { exit_code: 36 }];
+ SYMLINK_TREE_CREATION_COMMAND_EXCEPTION = 18
+ [(metadata) = { exit_code: 36 }];
+ ACTION_INPUT_READ_IO_EXCEPTION = 19 [(metadata) = { exit_code: 36 }];
+ ACTION_NOT_UP_TO_DATE = 20 [(metadata) = { exit_code: 1 }];
+ PSEUDO_ACTION_EXECUTION_PROHIBITED = 21 [(metadata) = { exit_code: 1 }];
+ DISCOVERED_INPUT_DOES_NOT_EXIST = 22 [(metadata) = { exit_code: 1 }];
+ ACTION_OUTPUTS_DELETION_FAILURE = 23 [(metadata) = { exit_code: 1 }];
+ ACTION_OUTPUTS_NOT_CREATED = 24 [(metadata) = { exit_code: 1 }];
+ ACTION_FINALIZATION_FAILURE = 25 [(metadata) = { exit_code: 1 }];
+ ACTION_INPUT_LOST = 26 [(metadata) = { exit_code: 1 }];
+ FILESYSTEM_CONTEXT_UPDATE_FAILURE = 27 [(metadata) = { exit_code: 1 }];
+ ACTION_OUTPUT_CLOSE_FAILURE = 28 [(metadata) = { exit_code: 1 }];
+ INPUT_DISCOVERY_IO_EXCEPTION = 29 [(metadata) = { exit_code: 1 }];
+ TREE_ARTIFACT_DIRECTORY_CREATION_FAILURE = 30
+ [(metadata) = { exit_code: 1 }];
+ ACTION_OUTPUT_DIRECTORY_CREATION_FAILURE = 31
+ [(metadata) = { exit_code: 1 }];
+ ACTION_FS_OUTPUT_DIRECTORY_CREATION_FAILURE = 32
+ [(metadata) = { exit_code: 1 }];
+ ACTION_FS_OUT_ERR_DIRECTORY_CREATION_FAILURE = 33
+ [(metadata) = { exit_code: 1 }];
+ NON_ACTION_EXECUTION_FAILURE = 34 [(metadata) = { exit_code: 1 }];
+ CYCLE = 35 [(metadata) = { exit_code: 1 }];
+ SOURCE_INPUT_MISSING = 36 [(metadata) = { exit_code: 1 }];
+ UNEXPECTED_EXCEPTION = 37 [(metadata) = { exit_code: 1 }];
+ reserved 38;
+ SOURCE_INPUT_IO_EXCEPTION = 39 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+// Failure details about Bazel's WORKSPACE features.
+message Workspaces {
+ enum Code {
+ WORKSPACES_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ WORKSPACES_LOG_INITIALIZATION_FAILURE = 1 [(metadata) = { exit_code: 2 }];
+ WORKSPACES_LOG_WRITE_FAILURE = 2 [(metadata) = { exit_code: 36 }];
+
+ // See `managed_directories` in
+ // https://docs.bazel.build/versions/master/skylark/lib/globals.html#workspace.
+ ILLEGAL_WORKSPACE_FILE_SYMLINK_WITH_MANAGED_DIRECTORIES = 3
+ [(metadata) = { exit_code: 1 }];
+ WORKSPACE_FILE_READ_FAILURE_WITH_MANAGED_DIRECTORIES = 4
+ [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message CrashOptions {
+ enum Code {
+ CRASH_OPTIONS_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ reserved 1; // For internal use
+ }
+
+ Code code = 1;
+}
+
+message Filesystem {
+ enum Code {
+ FILESYSTEM_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ reserved 1;
+ reserved 2;
+ EMBEDDED_BINARIES_ENUMERATION_FAILURE = 3 [(metadata) = { exit_code: 36 }];
+ SERVER_PID_TXT_FILE_READ_FAILURE = 4 [(metadata) = { exit_code: 1 }];
+ SERVER_FILE_WRITE_FAILURE = 5 [(metadata) = { exit_code: 1 }];
+ DEFAULT_DIGEST_HASH_FUNCTION_INVALID_VALUE = 6
+ [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message ExecutionOptions {
+ // All numerical exit code associations correspond to pre-existing Bazel
+ // behavior. These associations are suspicious:
+ // - REQUESTED_STRATEGY_INCOMPATIBLE_WITH_SANDBOXING (instead: 2?)
+ // - DEPRECATED_LOCAL_RESOURCES_USED (instead: 2?)
+ // TODO(b/138456686): Revise these after the (intentionally non-breaking)
+ // initial rollout of FailureDetail-based encoding.
+ enum Code {
+ EXECUTION_OPTIONS_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ INVALID_STRATEGY = 3 [(metadata) = { exit_code: 2 }];
+ REQUESTED_STRATEGY_INCOMPATIBLE_WITH_SANDBOXING = 4
+ [(metadata) = { exit_code: 36 }];
+ DEPRECATED_LOCAL_RESOURCES_USED = 5 [(metadata) = { exit_code: 36 }];
+ INVALID_CYCLIC_DYNAMIC_STRATEGY = 6 [(metadata) = { exit_code: 36 }];
+ RESTRICTION_UNMATCHED_TO_ACTION_CONTEXT = 7 [(metadata) = { exit_code: 2 }];
+ REMOTE_FALLBACK_STRATEGY_NOT_ABSTRACT_SPAWN = 8
+ [(metadata) = { exit_code: 2 }];
+ STRATEGY_NOT_FOUND = 9 [(metadata) = { exit_code: 2 }];
+ DYNAMIC_STRATEGY_NOT_SANDBOXED = 10 [(metadata) = { exit_code: 2 }];
+
+ reserved 1, 2; // For internal use
+ }
+
+ Code code = 1;
+}
+
+message Command {
+ enum Code {
+ // The name "COMMAND_UNKNOWN" might reasonably be interpreted as "command
+ // not found". The enum's default value should represent a lack of knowledge
+ // about the failure instead.
+ COMMAND_FAILURE_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ COMMAND_NOT_FOUND = 1 [(metadata) = { exit_code: 2 }];
+ ANOTHER_COMMAND_RUNNING = 2 [(metadata) = { exit_code: 9 }];
+ PREVIOUSLY_SHUTDOWN = 3 [(metadata) = { exit_code: 36 }];
+ STARLARK_CPU_PROFILE_FILE_INITIALIZATION_FAILURE = 4
+ [(metadata) = { exit_code: 36 }];
+ STARLARK_CPU_PROFILING_INITIALIZATION_FAILURE = 5
+ [(metadata) = { exit_code: 36 }];
+ STARLARK_CPU_PROFILE_FILE_WRITE_FAILURE = 6
+ [(metadata) = { exit_code: 36 }];
+ INVOCATION_POLICY_PARSE_FAILURE = 7 [(metadata) = { exit_code: 2 }];
+ INVOCATION_POLICY_INVALID = 8 [(metadata) = { exit_code: 2 }];
+ OPTIONS_PARSE_FAILURE = 9 [(metadata) = { exit_code: 2 }];
+ STARLARK_OPTIONS_PARSE_FAILURE = 10 [(metadata) = { exit_code: 2 }];
+ ARGUMENTS_NOT_RECOGNIZED = 11 [(metadata) = { exit_code: 2 }];
+ NOT_IN_WORKSPACE = 12 [(metadata) = { exit_code: 2 }];
+ SPACES_IN_WORKSPACE_PATH = 13 [(metadata) = { exit_code: 36 }];
+ IN_OUTPUT_DIRECTORY = 14 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message GrpcServer {
+ enum Code {
+ GRPC_SERVER_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ GRPC_SERVER_NOT_COMPILED_IN = 1 [(metadata) = { exit_code: 37 }];
+ SERVER_BIND_FAILURE = 2 [(metadata) = { exit_code: 1 }];
+ BAD_COOKIE = 3 [(metadata) = { exit_code: 36 }];
+ NO_CLIENT_DESCRIPTION = 4 [(metadata) = { exit_code: 36 }];
+ reserved 5; // For internal use
+ }
+
+ Code code = 1;
+}
+
+message CanonicalizeFlags {
+ enum Code {
+ CANONICALIZE_FLAGS_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ FOR_COMMAND_INVALID = 1 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+// Failure modes described by this category pertain to the Bazel invocation
+// configuration consumed by Bazel's analysis phase. This category is not
+// intended as a grab-bag for all Bazel flag value constraint violations, which
+// instead generally belong in the category for the subsystem whose flag values
+// participate in the constraint.
+message BuildConfiguration {
+ enum Code {
+ BUILD_CONFIGURATION_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ PLATFORM_MAPPING_EVALUATION_FAILURE = 1 [(metadata) = { exit_code: 2 }];
+ PLATFORM_MAPPINGS_FILE_IS_DIRECTORY = 2 [(metadata) = { exit_code: 1 }];
+ PLATFORM_MAPPINGS_FILE_NOT_FOUND = 3 [(metadata) = { exit_code: 1 }];
+ TOP_LEVEL_CONFIGURATION_CREATION_FAILURE = 4
+ [(metadata) = { exit_code: 1 }];
+ INVALID_CONFIGURATION = 5 [(metadata) = { exit_code: 2 }];
+ INVALID_BUILD_OPTIONS = 6 [(metadata) = { exit_code: 2 }];
+ MULTI_CPU_PREREQ_UNMET = 7 [(metadata) = { exit_code: 2 }];
+ HEURISTIC_INSTRUMENTATION_FILTER_INVALID = 8
+ [(metadata) = { exit_code: 2 }];
+ CYCLE = 9 [(metadata) = { exit_code: 2 }];
+ CONFLICTING_CONFIGURATIONS = 10 [(metadata) = { exit_code: 2 }];
+ // This can come from either an invalid user-specified option or a
+ // configuration transition. There's no sure-fire way to distinguish the two
+ // possibilities in Bazel, so we go with the more straightforward
+ // command-line error exit code 2.
+ INVALID_OUTPUT_DIRECTORY_MNEMONIC = 11 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message InfoCommand {
+ // The distinction between a failure to write a single info item and a failure
+ // to write them all seems sketchy. Why do they have different exit codes?
+ // This reflects current Bazel behavior, but deserves more thought.
+ enum Code {
+ INFO_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ TOO_MANY_KEYS = 1 [(metadata) = { exit_code: 2 }];
+ KEY_NOT_RECOGNIZED = 2 [(metadata) = { exit_code: 2 }];
+ INFO_BLOCK_WRITE_FAILURE = 3 [(metadata) = { exit_code: 7 }];
+ ALL_INFO_WRITE_FAILURE = 4 [(metadata) = { exit_code: 36 }];
+ }
+
+ Code code = 1;
+}
+
+message MemoryOptions {
+ enum Code {
+ MEMORY_OPTIONS_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ EXPERIMENTAL_OOM_MORE_EAGERLY_THRESHOLD_INVALID_VALUE = 1
+ [(metadata) = { exit_code: 2 }];
+ EXPERIMENTAL_OOM_MORE_EAGERLY_NO_TENURED_COLLECTORS_FOUND = 2
+ [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message Query {
+ enum Code {
+ QUERY_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ QUERY_FILE_WITH_COMMAND_LINE_EXPRESSION = 1 [(metadata) = { exit_code: 2 }];
+ QUERY_FILE_READ_FAILURE = 2 [(metadata) = { exit_code: 2 }];
+ COMMAND_LINE_EXPRESSION_MISSING = 3 [(metadata) = { exit_code: 2 }];
+ OUTPUT_FORMAT_INVALID = 4 [(metadata) = { exit_code: 2 }];
+ GRAPHLESS_PREREQ_UNMET = 5 [(metadata) = { exit_code: 2 }];
+ QUERY_OUTPUT_WRITE_FAILURE = 6 [(metadata) = { exit_code: 36 }];
+ QUERY_STDOUT_FLUSH_FAILURE = 13 [(metadata) = { exit_code: 36 }];
+ ANALYSIS_QUERY_PREREQ_UNMET = 14 [(metadata) = { exit_code: 2 }];
+ QUERY_RESULTS_FLUSH_FAILURE = 15 [(metadata) = { exit_code: 36 }];
+ // Deprecated - folded into SYNTAX_ERROR.
+ DEPRECATED_UNCLOSED_QUOTATION_EXPRESSION_ERROR = 16
+ [(metadata) = { exit_code: 2 }];
+ VARIABLE_NAME_INVALID = 17 [(metadata) = { exit_code: 7 }];
+ VARIABLE_UNDEFINED = 18 [(metadata) = { exit_code: 7 }];
+ BUILDFILES_AND_LOADFILES_CANNOT_USE_OUTPUT_LOCATION_ERROR = 19
+ [(metadata) = { exit_code: 2 }];
+ BUILD_FILE_ERROR = 20 [(metadata) = { exit_code: 7 }];
+ CYCLE = 21 [(metadata) = { exit_code: 7 }];
+ UNIQUE_SKYKEY_THRESHOLD_EXCEEDED = 22 [(metadata) = { exit_code: 7 }];
+ TARGET_NOT_IN_UNIVERSE_SCOPE = 23 [(metadata) = { exit_code: 2 }];
+ INVALID_FULL_UNIVERSE_EXPRESSION = 24 [(metadata) = { exit_code: 7 }];
+ UNIVERSE_SCOPE_LIMIT_EXCEEDED = 25 [(metadata) = { exit_code: 7 }];
+ INVALIDATION_LIMIT_EXCEEDED = 26 [(metadata) = { exit_code: 7 }];
+ OUTPUT_FORMAT_PREREQ_UNMET = 27 [(metadata) = { exit_code: 2 }];
+ ARGUMENTS_MISSING = 28 [(metadata) = { exit_code: 7 }];
+ RBUILDFILES_FUNCTION_REQUIRES_SKYQUERY = 29 [(metadata) = { exit_code: 7 }];
+ FULL_TARGETS_NOT_SUPPORTED = 30 [(metadata) = { exit_code: 7 }];
+ // Deprecated - folded into SYNTAX_ERROR.
+ DEPRECATED_UNEXPECTED_TOKEN_ERROR = 31 [(metadata) = { exit_code: 2 }];
+ // Deprecated - folded into SYNTAX_ERROR.
+ DEPRECATED_INTEGER_LITERAL_MISSING = 32 [(metadata) = { exit_code: 2 }];
+ // Deprecated - folded into SYNTAX_ERROR.
+ DEPRECATED_INVALID_STARTING_CHARACTER_ERROR = 33
+ [(metadata) = { exit_code: 2 }];
+ // Deprecated - folded into SYNTAX_ERROR.
+ DEPRECATED_PREMATURE_END_OF_INPUT_ERROR = 34
+ [(metadata) = { exit_code: 2 }];
+ // Indicates the user specified invalid query syntax.
+ SYNTAX_ERROR = 35 [(metadata) = { exit_code: 2 }];
+ OUTPUT_FORMATTER_IO_EXCEPTION = 36 [(metadata) = { exit_code: 36 }];
+ SKYQUERY_TRANSITIVE_TARGET_ERROR = 37 [(metadata) = { exit_code: 7 }];
+ SKYQUERY_TARGET_EXCEPTION = 38 [(metadata) = { exit_code: 7 }];
+ INVALID_LABEL_IN_TEST_SUITE = 39 [(metadata) = { exit_code: 7 }];
+ // Indicates any usage of flags that must not be combined.
+ ILLEGAL_FLAG_COMBINATION = 40 [(metadata) = { exit_code: 2 }];
+
+ reserved 7 to 12; // For internal use
+ }
+
+ Code code = 1;
+}
+
+message LocalExecution {
+ enum Code {
+ LOCAL_EXECUTION_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ LOCKFREE_OUTPUT_PREREQ_UNMET = 1 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message ActionCache {
+ enum Code {
+ ACTION_CACHE_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ INITIALIZATION_FAILURE = 1 [(metadata) = { exit_code: 36 }];
+ }
+
+ Code code = 1;
+}
+
+message FetchCommand {
+ enum Code {
+ FETCH_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ EXPRESSION_MISSING = 1 [(metadata) = { exit_code: 2 }];
+ OPTIONS_INVALID = 2 [(metadata) = { exit_code: 2 }];
+ QUERY_PARSE_ERROR = 3 [(metadata) = { exit_code: 2 }];
+ QUERY_EVALUATION_ERROR = 4 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message SyncCommand {
+ enum Code {
+ SYNC_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ PACKAGE_LOOKUP_ERROR = 1 [(metadata) = { exit_code: 7 }];
+ WORKSPACE_EVALUATION_ERROR = 2 [(metadata) = { exit_code: 7 }];
+ REPOSITORY_FETCH_ERRORS = 3 [(metadata) = { exit_code: 7 }];
+ REPOSITORY_NAME_INVALID = 4 [(metadata) = { exit_code: 7 }];
+ }
+
+ Code code = 1;
+}
+
+message Sandbox {
+ enum Code {
+ SANDBOX_FAILURE_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ INITIALIZATION_FAILURE = 1 [(metadata) = { exit_code: 36 }];
+ EXECUTION_IO_EXCEPTION = 2 [(metadata) = { exit_code: 1 }];
+ DOCKER_COMMAND_FAILURE = 3 [(metadata) = { exit_code: 1 }];
+ NO_DOCKER_IMAGE = 4 [(metadata) = { exit_code: 1 }];
+ DOCKER_IMAGE_PREPARATION_FAILURE = 5 [(metadata) = { exit_code: 1 }];
+ BIND_MOUNT_ANALYSIS_FAILURE = 6 [(metadata) = { exit_code: 1 }];
+ MOUNT_SOURCE_DOES_NOT_EXIST = 7 [(metadata) = { exit_code: 1 }];
+ MOUNT_SOURCE_TARGET_TYPE_MISMATCH = 8 [(metadata) = { exit_code: 1 }];
+ MOUNT_TARGET_DOES_NOT_EXIST = 9 [(metadata) = { exit_code: 1 }];
+ SUBPROCESS_START_FAILED = 10 [(metadata) = { exit_code: 36 }];
+ }
+
+ Code code = 1;
+}
+
+message IncludeScanning {
+ enum Code {
+ INCLUDE_SCANNING_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ INITIALIZE_INCLUDE_HINTS_ERROR = 1 [(metadata) = { exit_code: 36 }];
+ SCANNING_IO_EXCEPTION = 2 [(metadata) = { exit_code: 36 }];
+ INCLUDE_HINTS_FILE_NOT_IN_PACKAGE = 3 [(metadata) = { exit_code: 36 }];
+ INCLUDE_HINTS_READ_FAILURE = 4 [(metadata) = { exit_code: 36 }];
+ ILLEGAL_ABSOLUTE_PATH = 5 [(metadata) = { exit_code: 1 }];
+ // TODO(b/138456686): this code should be deprecated in favor of more finely
+ // resolved loading-phase codes.
+ PACKAGE_LOAD_FAILURE = 6 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message TestCommand {
+ enum Code {
+ TEST_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ NO_TEST_TARGETS = 1 [(metadata) = { exit_code: 4 }];
+ TEST_WITH_NOANALYZE = 2 [(metadata) = { exit_code: 1 }];
+ TESTS_FAILED = 3 [(metadata) = { exit_code: 3 }];
+ }
+
+ Code code = 1;
+}
+
+message ActionQuery {
+ // All numerical exit code associations correspond to pre-existing Bazel
+ // behavior. These associations are suspicious:
+ // - COMMAND_LINE_EXPANSION_FAILURE: this is associated with 2, the numerical
+ // exit code for "bad Bazel command line", but is generated when an
+ // action's command line fails to expand, which sounds similar but is
+ // completely different.
+ // - OUTPUT_FAILURE: this is associated with 6, an undocumented exit code.
+ // - INVALID_AQUERY_EXPRESSION: this is associate with 1, which is not
+ // documented for (a)query.
+ // TODO(b/138456686): Revise these after the (intentionally non-breaking)
+ // initial rollout of FailureDetail-based encoding.
+ enum Code {
+ ACTION_QUERY_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ COMMAND_LINE_EXPANSION_FAILURE = 1 [(metadata) = { exit_code: 2 }];
+ OUTPUT_FAILURE = 2 [(metadata) = { exit_code: 6 }];
+ COMMAND_LINE_EXPRESSION_MISSING = 3 [(metadata) = { exit_code: 2 }];
+ EXPRESSION_PARSE_FAILURE = 4 [(metadata) = { exit_code: 2 }];
+ SKYFRAME_STATE_WITH_COMMAND_LINE_EXPRESSION = 5
+ [(metadata) = { exit_code: 2 }];
+ INVALID_AQUERY_EXPRESSION = 6 [(metadata) = { exit_code: 1 }];
+ SKYFRAME_STATE_PREREQ_UNMET = 7 [(metadata) = { exit_code: 2 }];
+ AQUERY_OUTPUT_TOO_BIG = 8 [(metadata) = { exit_code: 7 }];
+ ILLEGAL_PATTERN_SYNTAX = 9 [(metadata) = { exit_code: 2 }];
+ INCORRECT_ARGUMENTS = 10 [(metadata) = { exit_code: 2 }];
+ TOP_LEVEL_TARGETS_WITH_SKYFRAME_STATE_NOT_SUPPORTED = 11
+ [(metadata) = { exit_code: 2 }];
+ SKYFRAME_STATE_AFTER_EXECUTION = 12 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message TargetPatterns {
+ enum Code {
+ TARGET_PATTERNS_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ TARGET_PATTERN_FILE_WITH_COMMAND_LINE_PATTERN = 1
+ [(metadata) = { exit_code: 2 }];
+ TARGET_PATTERN_FILE_READ_FAILURE = 2 [(metadata) = { exit_code: 2 }];
+ TARGET_PATTERN_PARSE_FAILURE = 3 [(metadata) = { exit_code: 1 }];
+ PACKAGE_NOT_FOUND = 4 [(metadata) = { exit_code: 1 }];
+ TARGET_FORMAT_INVALID = 5 [(metadata) = { exit_code: 1 }];
+ ABSOLUTE_TARGET_PATTERN_INVALID = 6 [(metadata) = { exit_code: 1 }];
+ CANNOT_DETERMINE_TARGET_FROM_FILENAME = 7 [(metadata) = { exit_code: 1 }];
+ LABEL_SYNTAX_ERROR = 8 [(metadata) = { exit_code: 1 }];
+ TARGET_CANNOT_BE_EMPTY_STRING = 9 [(metadata) = { exit_code: 1 }];
+ PACKAGE_PART_CANNOT_END_IN_SLASH = 10 [(metadata) = { exit_code: 1 }];
+ CYCLE = 11 [(metadata) = { exit_code: 1 }];
+ CANNOT_PRELOAD_TARGET = 12 [(metadata) = { exit_code: 1 }];
+ TARGETS_MISSING = 13 [(metadata) = { exit_code: 1 }];
+ RECURSIVE_TARGET_PATTERNS_NOT_ALLOWED = 14 [(metadata) = { exit_code: 1 }];
+ UP_LEVEL_REFERENCES_NOT_ALLOWED = 15 [(metadata) = { exit_code: 1 }];
+ NEGATIVE_TARGET_PATTERN_NOT_ALLOWED = 16 [(metadata) = { exit_code: 1 }];
+ TARGET_MUST_BE_A_FILE = 17 [(metadata) = { exit_code: 1 }];
+ DEPENDENCY_NOT_FOUND = 18 [(metadata) = { exit_code: 1 }];
+ PACKAGE_NAME_INVALID = 19 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message CleanCommand {
+ enum Code {
+ CLEAN_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ OUTPUT_SERVICE_CLEAN_FAILURE = 1 [(metadata) = { exit_code: 6 }];
+ ACTION_CACHE_CLEAN_FAILURE = 2 [(metadata) = { exit_code: 36 }];
+ OUT_ERR_CLOSE_FAILURE = 3 [(metadata) = { exit_code: 36 }];
+ OUTPUT_BASE_DELETE_FAILURE = 4 [(metadata) = { exit_code: 36 }];
+ OUTPUT_BASE_TEMP_MOVE_FAILURE = 5 [(metadata) = { exit_code: 36 }];
+ ASYNC_OUTPUT_BASE_DELETE_FAILURE = 6 [(metadata) = { exit_code: 6 }];
+ EXECROOT_DELETE_FAILURE = 7 [(metadata) = { exit_code: 36 }];
+ EXECROOT_TEMP_MOVE_FAILURE = 8 [(metadata) = { exit_code: 36 }];
+ ASYNC_EXECROOT_DELETE_FAILURE = 9 [(metadata) = { exit_code: 6 }];
+ ARGUMENTS_NOT_RECOGNIZED = 10 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message ConfigCommand {
+ enum Code {
+ CONFIG_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ TOO_MANY_CONFIG_IDS = 1 [(metadata) = { exit_code: 2 }];
+ CONFIGURATION_NOT_FOUND = 2 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message ConfigurableQuery {
+ enum Code {
+ CONFIGURABLE_QUERY_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ COMMAND_LINE_EXPRESSION_MISSING = 1 [(metadata) = { exit_code: 2 }];
+ EXPRESSION_PARSE_FAILURE = 2 [(metadata) = { exit_code: 2 }];
+ FILTERS_NOT_SUPPORTED = 3 [(metadata) = { exit_code: 2 }];
+ BUILDFILES_FUNCTION_NOT_SUPPORTED = 4 [(metadata) = { exit_code: 2 }];
+ SIBLINGS_FUNCTION_NOT_SUPPORTED = 5 [(metadata) = { exit_code: 2 }];
+ VISIBLE_FUNCTION_NOT_SUPPORTED = 6 [(metadata) = { exit_code: 2 }];
+ ATTRIBUTE_MISSING = 7 [(metadata) = { exit_code: 2 }];
+ INCORRECT_CONFIG_ARGUMENT_ERROR = 8 [(metadata) = { exit_code: 2 }];
+ TARGET_MISSING = 9 [(metadata) = { exit_code: 2 }];
+ STARLARK_SYNTAX_ERROR = 10 [(metadata) = { exit_code: 2 }];
+ STARLARK_EVAL_ERROR = 11 [(metadata) = { exit_code: 2 }];
+ // Indicates failure to correctly define a format function
+ FORMAT_FUNCTION_ERROR = 12 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message DumpCommand {
+ enum Code {
+ DUMP_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ NO_OUTPUT_SPECIFIED = 1 [(metadata) = { exit_code: 7 }];
+ ACTION_CACHE_DUMP_FAILED = 2 [(metadata) = { exit_code: 7 }];
+ COMMAND_LINE_EXPANSION_FAILURE = 3 [(metadata) = { exit_code: 7 }];
+ ACTION_GRAPH_DUMP_FAILED = 4 [(metadata) = { exit_code: 7 }];
+ STARLARK_HEAP_DUMP_FAILED = 5 [(metadata) = { exit_code: 8 }];
+ }
+
+ Code code = 1;
+}
+
+message HelpCommand {
+ enum Code {
+ HELP_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ MISSING_ARGUMENT = 1 [(metadata) = { exit_code: 2 }];
+ COMMAND_NOT_FOUND = 2 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message MobileInstall {
+ enum Code {
+ MOBILE_INSTALL_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ CLASSIC_UNSUPPORTED = 1 [(metadata) = { exit_code: 2 }];
+ NO_TARGET_SPECIFIED = 2 [(metadata) = { exit_code: 2 }];
+ MULTIPLE_TARGETS_SPECIFIED = 3 [(metadata) = { exit_code: 2 }];
+ TARGET_TYPE_INVALID = 4 [(metadata) = { exit_code: 6 }];
+ NON_ZERO_EXIT = 5 [(metadata) = { exit_code: 6 }];
+ ERROR_RUNNING_PROGRAM = 6 [(metadata) = { exit_code: 6 }];
+ }
+
+ Code code = 1;
+}
+
+message ProfileCommand {
+ enum Code {
+ PROFILE_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ OLD_BINARY_FORMAT_UNSUPPORTED = 1 [(metadata) = { exit_code: 1 }];
+ FILE_READ_FAILURE = 2 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message RunCommand {
+ enum Code {
+ RUN_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ NO_TARGET_SPECIFIED = 1 [(metadata) = { exit_code: 2 }];
+ TOO_MANY_TARGETS_SPECIFIED = 2 [(metadata) = { exit_code: 2 }];
+ TARGET_NOT_EXECUTABLE = 3 [(metadata) = { exit_code: 2 }];
+ TARGET_BUILT_BUT_PATH_NOT_EXECUTABLE = 4 [(metadata) = { exit_code: 37 }];
+ TARGET_BUILT_BUT_PATH_VALIDATION_FAILED = 5
+ [(metadata) = { exit_code: 36 }];
+ RUN_UNDER_TARGET_NOT_BUILT = 6 [(metadata) = { exit_code: 2 }];
+ RUN_PREREQ_UNMET = 7 [(metadata) = { exit_code: 2 }];
+ TOO_MANY_TEST_SHARDS_OR_RUNS = 8 [(metadata) = { exit_code: 2 }];
+ TEST_ENVIRONMENT_SETUP_FAILURE = 9 [(metadata) = { exit_code: 36 }];
+ COMMAND_LINE_EXPANSION_FAILURE = 10 [(metadata) = { exit_code: 36 }];
+ NO_SHELL_SPECIFIED = 11 [(metadata) = { exit_code: 2 }];
+ SCRIPT_WRITE_FAILURE = 12 [(metadata) = { exit_code: 6 }];
+ RUNFILES_DIRECTORIES_CREATION_FAILURE = 13 [(metadata) = { exit_code: 36 }];
+ RUNFILES_SYMLINKS_CREATION_FAILURE = 14 [(metadata) = { exit_code: 36 }];
+ TEST_ENVIRONMENT_SETUP_INTERRUPTED = 15 [(metadata) = { exit_code: 8 }];
+ }
+
+ Code code = 1;
+}
+
+message VersionCommand {
+ enum Code {
+ VERSION_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ NOT_AVAILABLE = 1 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message PrintActionCommand {
+ enum Code {
+ PRINT_ACTION_COMMAND_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ TARGET_NOT_FOUND = 1 [(metadata) = { exit_code: 1 }];
+ COMMAND_LINE_EXPANSION_FAILURE = 2 [(metadata) = { exit_code: 1 }];
+ TARGET_KIND_UNSUPPORTED = 3 [(metadata) = { exit_code: 1 }];
+ ACTIONS_NOT_FOUND = 4 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message WorkspaceStatus {
+ enum Code {
+ WORKSPACE_STATUS_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ NON_ZERO_EXIT = 1 [(metadata) = { exit_code: 1 }];
+ ABNORMAL_TERMINATION = 2 [(metadata) = { exit_code: 1 }];
+ EXEC_FAILED = 3 [(metadata) = { exit_code: 1 }];
+ PARSE_FAILURE = 4 [(metadata) = { exit_code: 36 }];
+ VALIDATION_FAILURE = 5 [(metadata) = { exit_code: 1 }];
+ CONTENT_UPDATE_IO_EXCEPTION = 6 [(metadata) = { exit_code: 1 }];
+ STDERR_IO_EXCEPTION = 7 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message JavaCompile {
+ enum Code {
+ JAVA_COMPILE_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ REDUCED_CLASSPATH_FAILURE = 1 [(metadata) = { exit_code: 1 }];
+ COMMAND_LINE_EXPANSION_FAILURE = 2 [(metadata) = { exit_code: 1 }];
+ JDEPS_READ_IO_EXCEPTION = 3 [(metadata) = { exit_code: 36 }];
+ REDUCED_CLASSPATH_FALLBACK_CLEANUP_FAILURE = 4
+ [(metadata) = { exit_code: 36 }];
+ }
+
+ Code code = 1;
+}
+
+message ActionRewinding {
+ enum Code {
+ ACTION_REWINDING_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ LOST_INPUT_TOO_MANY_TIMES = 1 [(metadata) = { exit_code: 1 }];
+ LOST_INPUT_IS_SOURCE = 2 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message CppCompile {
+ enum Code {
+ CPP_COMPILE_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ FIND_USED_HEADERS_IO_EXCEPTION = 1 [(metadata) = { exit_code: 36 }];
+ COPY_OUT_ERR_FAILURE = 2 [(metadata) = { exit_code: 36 }];
+ D_FILE_READ_FAILURE = 3 [(metadata) = { exit_code: 36 }];
+ COMMAND_GENERATION_FAILURE = 4 [(metadata) = { exit_code: 1 }];
+ MODULE_EXPANSION_TIMEOUT = 5 [(metadata) = { exit_code: 1 }];
+ INCLUDE_PATH_OUTSIDE_EXEC_ROOT = 6 [(metadata) = { exit_code: 1 }];
+ FAKE_COMMAND_GENERATION_FAILURE = 7 [(metadata) = { exit_code: 1 }];
+ UNDECLARED_INCLUSIONS = 8 [(metadata) = { exit_code: 1 }];
+ D_FILE_PARSE_FAILURE = 9 [(metadata) = { exit_code: 1 }];
+ COVERAGE_NOTES_CREATION_FAILURE = 10 [(metadata) = { exit_code: 1 }];
+ MODULE_EXPANSION_MISSING_DATA = 11 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message StarlarkAction {
+ enum Code {
+ STARLARK_ACTION_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ UNUSED_INPUT_LIST_READ_FAILURE = 1 [(metadata) = { exit_code: 36 }];
+ UNUSED_INPUT_LIST_FILE_NOT_FOUND = 2 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message NinjaAction {
+ enum Code {
+ NINJA_ACTION_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ INVALID_DEPFILE_DECLARED_DEPENDENCY = 1 [(metadata) = { exit_code: 36 }];
+ D_FILE_PARSE_FAILURE = 2 [(metadata) = { exit_code: 36 }];
+ }
+
+ Code code = 1;
+}
+
+message DynamicExecution {
+ enum Code {
+ DYNAMIC_EXECUTION_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ XCODE_RELATED_PREREQ_UNMET = 1 [(metadata) = { exit_code: 36 }];
+ ACTION_LOG_MOVE_FAILURE = 2 [(metadata) = { exit_code: 1 }];
+ RUN_FAILURE = 3 [(metadata) = { exit_code: 1 }];
+ NO_USABLE_STRATEGY_FOUND = 4 [(metadata) = { exit_code: 2 }];
+ }
+
+ Code code = 1;
+}
+
+message FailAction {
+ enum Code {
+ FAIL_ACTION_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ INTENTIONAL_FAILURE = 1 [(metadata) = { exit_code: 1 }];
+ INCORRECT_PYTHON_VERSION = 2 [(metadata) = { exit_code: 1 }];
+ PROGUARD_SPECS_MISSING = 3 [(metadata) = { exit_code: 1 }];
+ DYNAMIC_LINKING_NOT_SUPPORTED = 4 [(metadata) = { exit_code: 1 }];
+ SOURCE_FILES_MISSING = 5 [(metadata) = { exit_code: 1 }];
+ INCORRECT_TOOLCHAIN = 6 [(metadata) = { exit_code: 1 }];
+ FRAGMENT_CLASS_MISSING = 7 [(metadata) = { exit_code: 1 }];
+ reserved 8, 9; // For internal use
+ CANT_BUILD_INCOMPATIBLE_TARGET = 10 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message SymlinkAction {
+ enum Code {
+ SYMLINK_ACTION_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ EXECUTABLE_INPUT_NOT_FILE = 1 [(metadata) = { exit_code: 1 }];
+ EXECUTABLE_INPUT_IS_NOT = 2 [(metadata) = { exit_code: 1 }];
+ EXECUTABLE_INPUT_CHECK_IO_EXCEPTION = 3 [(metadata) = { exit_code: 1 }];
+ LINK_CREATION_IO_EXCEPTION = 4 [(metadata) = { exit_code: 1 }];
+ LINK_TOUCH_IO_EXCEPTION = 5 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message CppLink {
+ enum Code {
+ CPP_LINK_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ COMMAND_GENERATION_FAILURE = 1 [(metadata) = { exit_code: 1 }];
+ FAKE_COMMAND_GENERATION_FAILURE = 2 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message LtoAction {
+ enum Code {
+ LTO_ACTION_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ INVALID_ABSOLUTE_PATH_IN_IMPORTS = 1 [(metadata) = { exit_code: 1 }];
+ MISSING_BITCODE_FILES = 2 [(metadata) = { exit_code: 1 }];
+ IMPORTS_READ_IO_EXCEPTION = 3 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message TestAction {
+ enum Code {
+ TEST_ACTION_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ NO_KEEP_GOING_TEST_FAILURE = 1 [(metadata) = { exit_code: 1 }];
+ LOCAL_TEST_PREREQ_UNMET = 2 [(metadata) = { exit_code: 1 }];
+ COMMAND_LINE_EXPANSION_FAILURE = 3 [(metadata) = { exit_code: 1 }];
+ DUPLICATE_CPU_TAGS = 4 [(metadata) = { exit_code: 1 }];
+ INVALID_CPU_TAG = 5 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message Worker {
+ enum Code {
+ WORKER_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ MULTIPLEXER_INSTANCE_REMOVAL_FAILURE = 1 [(metadata) = { exit_code: 1 }];
+ MULTIPLEXER_DOES_NOT_EXIST = 2 [(metadata) = { exit_code: 1 }];
+ NO_TOOLS = 3 [(metadata) = { exit_code: 1 }];
+ NO_FLAGFILE = 4 [(metadata) = { exit_code: 1 }];
+ VIRTUAL_INPUT_MATERIALIZATION_FAILURE = 5 [(metadata) = { exit_code: 1 }];
+ BORROW_FAILURE = 6 [(metadata) = { exit_code: 1 }];
+ PREFETCH_FAILURE = 7 [(metadata) = { exit_code: 1 }];
+ PREPARE_FAILURE = 8 [(metadata) = { exit_code: 1 }];
+ REQUEST_FAILURE = 9 [(metadata) = { exit_code: 1 }];
+ PARSE_RESPONSE_FAILURE = 10 [(metadata) = { exit_code: 1 }];
+ NO_RESPONSE = 11 [(metadata) = { exit_code: 1 }];
+ FINISH_FAILURE = 12 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message Analysis {
+ enum Code {
+ ANALYSIS_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ LOAD_FAILURE = 1 [(metadata) = { exit_code: 1 }];
+ // TODO(b/138456686): this code should be deprecated in favor of more finely
+ // resolved loading-phase codes.
+ GENERIC_LOADING_PHASE_FAILURE = 2 [(metadata) = { exit_code: 1 }];
+ NOT_ALL_TARGETS_ANALYZED = 3 [(metadata) = { exit_code: 1 }];
+ CYCLE = 4 [(metadata) = { exit_code: 1 }];
+ PARAMETERIZED_TOP_LEVEL_ASPECT_INVALID = 5 [(metadata) = { exit_code: 1 }];
+ ASPECT_LABEL_SYNTAX_ERROR = 6 [(metadata) = { exit_code: 1 }];
+ ASPECT_PREREQ_UNMET = 7 [(metadata) = { exit_code: 1 }];
+ ASPECT_NOT_FOUND = 8 [(metadata) = { exit_code: 1 }];
+ ACTION_CONFLICT = 9 [(metadata) = { exit_code: 1 }];
+ ARTIFACT_PREFIX_CONFLICT = 10 [(metadata) = { exit_code: 1 }];
+ UNEXPECTED_ANALYSIS_EXCEPTION = 11 [(metadata) = { exit_code: 1 }];
+ TARGETS_MISSING_ENVIRONMENTS = 12 [(metadata) = { exit_code: 1 }];
+ INVALID_ENVIRONMENT = 13 [(metadata) = { exit_code: 1 }];
+ ENVIRONMENT_MISSING_FROM_GROUPS = 14 [(metadata) = { exit_code: 1 }];
+ EXEC_GROUP_MISSING = 15 [(metadata) = { exit_code: 1 }];
+ INVALID_EXECUTION_PLATFORM = 16 [(metadata) = { exit_code: 1 }];
+ ASPECT_CREATION_FAILED = 17 [(metadata) = { exit_code: 1 }];
+ CONFIGURED_VALUE_CREATION_FAILED = 18 [(metadata) = { exit_code: 1 }];
+ INCOMPATIBLE_TARGET_REQUESTED = 19 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message PackageLoading {
+ enum Code {
+ PACKAGE_LOADING_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ WORKSPACE_FILE_ERROR = 1 [(metadata) = { exit_code: 1 }];
+ MAX_COMPUTATION_STEPS_EXCEEDED = 2 [(metadata) = { exit_code: 1 }];
+ BUILD_FILE_MISSING = 3 [(metadata) = { exit_code: 1 }];
+ REPOSITORY_MISSING = 4 [(metadata) = { exit_code: 1 }];
+ PERSISTENT_INCONSISTENT_FILESYSTEM_ERROR = 5
+ [(metadata) = { exit_code: 1 }];
+ TRANSIENT_INCONSISTENT_FILESYSTEM_ERROR = 6 [(metadata) = { exit_code: 1 }];
+ INVALID_NAME = 7 [(metadata) = { exit_code: 1 }];
+ // was: PRELUDE_FILE_READ_ERROR. Replaced by IMPORT_STARLARK_FILE_ERROR
+ // when the prelude was changed to be loaded as a Starlark module.
+ reserved 8;
+ EVAL_GLOBS_SYMLINK_ERROR = 9 [(metadata) = { exit_code: 1 }];
+ IMPORT_STARLARK_FILE_ERROR = 10 [(metadata) = { exit_code: 1 }];
+ PACKAGE_MISSING = 11 [(metadata) = { exit_code: 1 }];
+ TARGET_MISSING = 12 [(metadata) = { exit_code: 1 }];
+ NO_SUCH_THING = 13 [(metadata) = { exit_code: 1 }];
+ GLOB_IO_EXCEPTION = 14 [(metadata) = { exit_code: 1 }];
+ DUPLICATE_LABEL = 15 [(metadata) = { exit_code: 1 }];
+ INVALID_PACKAGE_SPECIFICATION = 16 [(metadata) = { exit_code: 1 }];
+ SYNTAX_ERROR = 17 [(metadata) = { exit_code: 1 }];
+ ENVIRONMENT_IN_DIFFERENT_PACKAGE = 18 [(metadata) = { exit_code: 1 }];
+ DEFAULT_ENVIRONMENT_UNDECLARED = 19 [(metadata) = { exit_code: 1 }];
+ ENVIRONMENT_IN_MULTIPLE_GROUPS = 20 [(metadata) = { exit_code: 1 }];
+ ENVIRONMENT_DOES_NOT_EXIST = 21 [(metadata) = { exit_code: 1 }];
+ ENVIRONMENT_INVALID = 22 [(metadata) = { exit_code: 1 }];
+ ENVIRONMENT_NOT_IN_GROUP = 23 [(metadata) = { exit_code: 1 }];
+ PACKAGE_NAME_INVALID = 24 [(metadata) = { exit_code: 1 }];
+ STARLARK_EVAL_ERROR = 25 [(metadata) = { exit_code: 1 }];
+ LICENSE_PARSE_FAILURE = 26 [(metadata) = { exit_code: 1 }];
+ DISTRIBUTIONS_PARSE_FAILURE = 27 [(metadata) = { exit_code: 1 }];
+ LABEL_CROSSES_PACKAGE_BOUNDARY = 28 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message Toolchain {
+ enum Code {
+ TOOLCHAIN_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ MISSING_PROVIDER = 1 [(metadata) = { exit_code: 1 }];
+ INVALID_CONSTRAINT_VALUE = 2 [(metadata) = { exit_code: 1 }];
+ INVALID_PLATFORM_VALUE = 3 [(metadata) = { exit_code: 1 }];
+ INVALID_TOOLCHAIN = 4 [(metadata) = { exit_code: 1 }];
+ NO_MATCHING_EXECUTION_PLATFORM = 5 [(metadata) = { exit_code: 1 }];
+ NO_MATCHING_TOOLCHAIN = 6 [(metadata) = { exit_code: 1 }];
+ INVALID_TOOLCHAIN_TYPE = 7 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
+
+message StarlarkLoading {
+ enum Code {
+ STARLARK_LOADING_UNKNOWN = 0 [(metadata) = { exit_code: 37 }];
+ CYCLE = 1 [(metadata) = { exit_code: 1 }];
+ COMPILE_ERROR = 2 [(metadata) = { exit_code: 1 }];
+ PARSE_ERROR = 3 [(metadata) = { exit_code: 1 }];
+ EVAL_ERROR = 4 [(metadata) = { exit_code: 1 }];
+ CONTAINING_PACKAGE_NOT_FOUND = 5 [(metadata) = { exit_code: 1 }];
+ PACKAGE_NOT_FOUND = 6 [(metadata) = { exit_code: 1 }];
+ IO_ERROR = 7 [(metadata) = { exit_code: 1 }];
+ LABEL_CROSSES_PACKAGE_BOUNDARY = 8 [(metadata) = { exit_code: 1 }];
+ BUILTINS_ERROR = 9 [(metadata) = { exit_code: 1 }];
+ }
+
+ Code code = 1;
+}
diff --git a/third-party/github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy/BUILD.bazel b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy/BUILD.bazel
new file mode 100644
index 0000000..7bd04ed
--- /dev/null
+++ b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy/BUILD.bazel
@@ -0,0 +1,23 @@
+load("@io_bazel_rules_go//go:def.bzl", "go_library")
+load("@io_bazel_rules_go//proto:def.bzl", "go_proto_library")
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+ name = "invocation_policy_proto",
+ srcs = ["invocation_policy.proto"],
+ visibility = ["//visibility:public"],
+)
+
+go_proto_library(
+ name = "invocation_policy_go_proto",
+ importpath = "github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy",
+ proto = ":invocation_policy_proto",
+ visibility = ["//visibility:public"],
+)
+
+go_library(
+ name = "invocation_policy",
+ embed = [":invocation_policy_go_proto"],
+ importpath = "github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy",
+ visibility = ["//visibility:public"],
+)
diff --git a/third-party/github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy/invocation_policy.proto b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy/invocation_policy.proto
new file mode 100644
index 0000000..31fbf6f
--- /dev/null
+++ b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy/invocation_policy.proto
@@ -0,0 +1,190 @@
+// Copyright 2015 The Bazel Authors. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto2";
+package blaze.invocation_policy;
+
+// option java_api_version = 2;
+option go_package = "github.com/bazelbuild/bazel/src/main/protobuf/invocation_policy";
+
+// The --invocation_policy flag takes a base64-encoded binary-serialized or text
+// formatted InvocationPolicy message.
+message InvocationPolicy {
+ // Order matters.
+ // After expanding policies on expansion flags or flags with implicit
+ // requirements, only the final policy on a specific flag will be enforced
+ // onto the user's command line.
+ repeated FlagPolicy flag_policies = 1;
+}
+
+// A policy for controlling the value of a flag.
+message FlagPolicy {
+ // The name of the flag to enforce this policy on.
+ //
+ // Note that this should be the full name of the flag, not the abbreviated
+ // name of the flag. If the user specifies the abbreviated name of a flag,
+ // that flag will be matched using its full name.
+ //
+ // The "no" prefix will not be parsed, so for boolean flags, use
+ // the flag's full name and explicitly set it to true or false.
+ optional string flag_name = 1;
+
+ // If set, this flag policy is applied only if one of the given commands or a
+ // command that inherits from one of the given commands is being run. For
+ // instance, if "build" is one of the commands here, then this policy will
+ // apply to any command that inherits from build, such as info, coverage, or
+ // test. If empty, this flag policy is applied for all commands. This allows
+ // the policy setter to add all policies to the proto without having to
+ // determine which Bazel command the user is actually running. Additionally,
+ // Bazel allows multiple flags to be defined by the same name, and the
+ // specific flag definition is determined by the command.
+ repeated string commands = 2;
+
+ oneof operation {
+ SetValue set_value = 3;
+ UseDefault use_default = 4;
+ DisallowValues disallow_values = 5;
+ AllowValues allow_values = 6;
+ }
+}
+
+message SetValue {
+ // Use this value for the specified flag, overriding any default or user-set
+ // value (unless append is set to true for repeatable flags).
+ //
+ // This field is repeated for repeatable flags. It is an error to set
+ // multiple values for a flag that is not actually a repeatable flag.
+ // This requires at least 1 value, if even the empty string.
+ //
+ // If the flag allows multiple values, all of its values are replaced with the
+ // value or values from the policy (i.e., no diffing or merging is performed),
+ // unless the append field (see below) is set to true.
+ //
+ // Note that some flags are tricky. For example, some flags look like boolean
+ // flags, but are actually Void expansion flags that expand into other flags.
+ // The Bazel flag parser will accept "--void_flag=false", but because
+ // the flag is Void, the "=false" is ignored. It can get even trickier, like
+ // "--novoid_flag" which is also an expansion flag with the type Void whose
+ // name is explicitly "novoid_flag" and which expands into other flags that
+ // are the opposite of "--void_flag". For expansion flags, it's best to
+ // explicitly override the flags they expand into.
+ //
+ // Other flags may be differently tricky: A flag could have a converter that
+ // converts some string to a list of values, but that flag may not itself have
+ // allowMultiple set to true.
+ //
+ // An example is "--test_tag_filters": this flag sets its converter to
+ // CommaSeparatedOptionListConverter, but does not set allowMultiple to true.
+ // So "--test_tag_filters=foo,bar" results in ["foo", "bar"], however
+ // "--test_tag_filters=foo --test_tag_filters=bar" results in just ["bar"]
+ // since the 2nd value overrides the 1st.
+ //
+ // Similarly, "--test_tag_filters=foo,bar --test_tag_filters=baz,qux" results
+ // in ["baz", "qux"]. For flags like these, the policy should specify
+ // "foo,bar" instead of separately specifying "foo" and "bar" so that the
+ // converter is appropriately invoked.
+ //
+ // Note that the opposite is not necessarily
+ // true: for a flag that specifies allowMultiple=true, "--flag=foo,bar"
+ // may fail to parse or result in an unexpected value.
+ repeated string flag_value = 1;
+
+ // Whether to allow this policy to be overridden by user-specified values.
+ // When set, if the user specified a value for this flag, use the value
+ // from the user, otherwise use the value specified in this policy.
+ optional bool overridable = 2;
+
+ // If true, and if the flag named in the policy is a repeatable flag, then
+ // the values listed in flag_value do not replace all the user-set or default
+ // values of the flag, but instead append to them. If the flag is not
+ // repeatable, then this has no effect.
+ optional bool append = 3;
+}
+
+message UseDefault {
+ // Use the default value of the flag, as defined by Bazel (or equivalently, do
+ // not allow the user to set this flag).
+ //
+ // Note on implementation: UseDefault sets the default by clearing the flag,
+ // so that when the value is requested and no flag is found, the flag parser
+ // returns the default. This is mostly relevant for expansion flags: it will
+ // erase user values in *all* flags that the expansion flag expands to. Only
+ // use this on expansion flags if this is acceptable behavior. Since the last
+ // policy wins, later policies on this same flag will still remove the
+ // expanded UseDefault, so there is a way around, but it's really best not to
+ // use this on expansion flags at all.
+}
+
+message DisallowValues {
+ // Obsolete new_default_value field.
+ reserved 2;
+
+ // It is an error for the user to use any of these values (that is, the Bazel
+ // command will fail), unless new_value or use_default is set.
+ //
+ // For repeatable flags, if any one of the values in the flag matches a value
+ // in the list of disallowed values, an error is thrown.
+ //
+ // Care must be taken for flags with complicated converters. For example,
+ // it's possible for a repeated flag to be of type List<List<T>>, so that
+ // "--foo=a,b --foo=c,d" results in foo=[["a","b"], ["c", "d"]]. In this case,
+ // it is not possible to disallow just "b", nor will ["b", "a"] match, nor
+ // will ["b", "c"] (but ["a", "b"] will still match).
+ repeated string disallowed_values = 1;
+
+ oneof replacement_value {
+ // If set and if the value of the flag is disallowed (including the default
+ // value of the flag if the user doesn't specify a value), use this value as
+ // the value of the flag instead of raising an error. This does not apply to
+ // repeatable flags and is ignored if the flag is a repeatable flag.
+ string new_value = 3;
+
+ // If set and if the value of the flag is disallowed, use the default value
+ // of the flag instead of raising an error. Unlike new_value, this works for
+ // repeatable flags, but note that the default value for repeatable flags is
+ // always empty.
+ //
+ // Note that it is an error to disallow the default value of the flag and
+ // to set use_default, unless the flag is a repeatable flag where the
+ // default value is always the empty list.
+ UseDefault use_default = 4;
+ }
+}
+
+message AllowValues {
+ // Obsolete new_default_value field.
+ reserved 2;
+
+ // It is an error for the user to use any value not in this list, unless
+ // new_value or use_default is set.
+ repeated string allowed_values = 1;
+
+ oneof replacement_value {
+ // If set and if the value of the flag is disallowed (including the default
+ // value of the flag if the user doesn't specify a value), use this value as
+ // the value of the flag instead of raising an error. This does not apply to
+ // repeatable flags and is ignored if the flag is a repeatable flag.
+ string new_value = 3;
+
+ // If set and if the value of the flag is disallowed, use the default value
+ // of the flag instead of raising an error. Unlike new_value, this works for
+ // repeatable flags, but note that the default value for repeatable flags is
+ // always empty.
+ //
+ // Note that it is an error to disallow the default value of the flag and
+ // to set use_default, unless the flag is a repeatable flag where the
+ // default value is always the empty list.
+ UseDefault use_default = 4;
+ }
+}
diff --git a/third-party/github.com/bazelbuild/bazel/src/main/protobuf/options/BUILD.bazel b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/options/BUILD.bazel
new file mode 100644
index 0000000..3da9293
--- /dev/null
+++ b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/options/BUILD.bazel
@@ -0,0 +1,23 @@
+load("@io_bazel_rules_go//go:def.bzl", "go_library")
+load("@io_bazel_rules_go//proto:def.bzl", "go_proto_library")
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+ name = "options_proto",
+ srcs = ["option_filters.proto"],
+ visibility = ["//visibility:public"],
+)
+
+go_proto_library(
+ name = "options_go_proto",
+ importpath = "github.com/bazelbuild/bazel/src/main/protobuf/options",
+ proto = ":options_proto",
+ visibility = ["//visibility:public"],
+)
+
+go_library(
+ name = "options",
+ embed = [":options_go_proto"],
+ importpath = "github.com/bazelbuild/bazel/src/main/protobuf/options",
+ visibility = ["//visibility:public"],
+)
diff --git a/third-party/github.com/bazelbuild/bazel/src/main/protobuf/options/option_filters.proto b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/options/option_filters.proto
new file mode 100644
index 0000000..0bc6b42
--- /dev/null
+++ b/third-party/github.com/bazelbuild/bazel/src/main/protobuf/options/option_filters.proto
@@ -0,0 +1,56 @@
+// Copyright 2017 The Bazel Authors. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+syntax = "proto3";
+package options;
+
+// option java_api_version = 2;
+option go_package = "github.com/bazelbuild/bazel/src/main/protobuf/options";
+
+// IMPORTANT NOTE: These two enums must be kept in sync with their Java
+// equivalents in src/main/java/com/google/devtools/common/options.
+// Changing this proto has specific compatibility requirements, please see the
+// Java documentation for details.
+
+// Docs in java enum.
+enum OptionEffectTag {
+ // This option's effect or intent is unknown.
+ UNKNOWN = 0;
+
+ // This flag has literally no effect.
+ NO_OP = 1;
+
+ LOSES_INCREMENTAL_STATE = 2;
+ CHANGES_INPUTS = 3;
+ AFFECTS_OUTPUTS = 4;
+ BUILD_FILE_SEMANTICS = 5;
+ BAZEL_INTERNAL_CONFIGURATION = 6;
+ LOADING_AND_ANALYSIS = 7;
+ EXECUTION = 8;
+ HOST_MACHINE_RESOURCE_OPTIMIZATIONS = 9;
+ EAGERNESS_TO_EXIT = 10;
+ BAZEL_MONITORING = 11;
+ TERMINAL_OUTPUT = 12;
+ ACTION_COMMAND_LINES = 13;
+ TEST_RUNNER = 14;
+}
+
+// Docs in java enum.
+enum OptionMetadataTag {
+ EXPERIMENTAL = 0;
+ INCOMPATIBLE_CHANGE = 1;
+ DEPRECATED = 2;
+ HIDDEN = 3;
+ INTERNAL = 4;
+ TRIGGERED_BY_ALL_INCOMPATIBLE_CHANGES = 5;
+}
