github.com/cockroachdb/cockroachdb-parser@v0.23.3-0.20240213214944-911057d40c9a/pkg/build/info.proto (about)

     1  // Copyright 2016 The Cockroach Authors.
     2  //
     3  // Use of this software is governed by the Business Source License
     4  // included in the file licenses/BSL.txt.
     5  //
     6  // As of the Change Date specified in that file, in accordance with
     7  // the Business Source License, use of this software will be governed
     8  // by the Apache License, Version 2.0, included in the file
     9  // licenses/APL.txt.
    10  
    11  syntax = "proto2";
    12  package cockroach.build;
    13  option go_package = "github.com/cockroachdb/cockroach/pkg/build";
    14  
    15  import "gogoproto/gogo.proto";
    16  
    17  // Info describes build information for this CockroachDB binary.
    18  message Info {
    19    // go_version is the version of the Go toolchain used to compile this executable.
    20    optional string go_version = 1 [(gogoproto.nullable) = false];
    21    // tag is the binary version for the revision of the source code for
    22    // this executable.  This used to be the git tag for the build, but
    23    // has since moved to the contents of the `version.txt` file.
    24    optional string tag = 2 [(gogoproto.nullable) = false];
    25    // time is the time at which the build started.
    26    optional string time = 3 [(gogoproto.nullable) = false];
    27    // revision is the git commit identifier for the source code of this executable.
    28    optional string revision = 4 [(gogoproto.nullable) = false];
    29    // cgo_compiler is the C/C++ compiler used to build non-go dependencies.
    30    optional string cgo_compiler = 5 [(gogoproto.nullable) = false];
    31    // cgo_target_triple is the platform identifier that identifies the cross-compilation target for C/C++ components.
    32    optional string cgo_target_triple = 10 [(gogoproto.nullable) = false];
    33    // platform is the platform identifiers that identifies the cross-compilation target for Go code.
    34    optional string platform = 6 [(gogoproto.nullable) = false];
    35    // distribution indicates which licensing conditions apply (OSS: full open source; CCL: includes CCL code).
    36    optional string distribution = 7 [(gogoproto.nullable) = false];
    37    // type indicates whether this is a development or release build.
    38    optional string type = 8 [(gogoproto.nullable) = false];
    39    // channel identifies through which product channel the executable was released.
    40    optional string channel = 9 [(gogoproto.nullable) = false];
    41    // env_channel identifies the product channel as overridden by the COCKROACH_CHANNEL environment variable.
    42    optional string env_channel = 11 [(gogoproto.nullable) = false];
    43    // enabled_assertions returns the value of 'CrdbTestBuild' (true iff compiled with 'crdb_test' tag)
    44    optional bool enabled_assertions = 12 [(gogoproto.nullable) = false];
    45  
    46    // dependencies exists to allow tests that run against old clusters
    47    // to unmarshal JSON containing this field. The tag is unimportant,
    48    // but the field name must remain unchanged.
    49    //
    50    // alternatively, we could set jsonpb.Unmarshaler.AllowUnknownFields
    51    // to true in httputil.doJSONRequest, but that comes at the expense
    52    // of run-time type checking, which is nice to have.
    53    optional string dependencies = 10000;
    54  }