legacy-libs/google-proto-files/google/devtools/containeranalysis/v1beta1/package/package.proto

   1 // Copyright 2018 The Grafeas Authors. All rights reserved.
   2 //
   3 // Licensed under the Apache License, Version 2.0 (the "License");
   4 // you may not use this file except in compliance with the License.
   5 // You may obtain a copy of the License at
   6 //
   7 //    http://www.apache.org/licenses/LICENSE-2.0
   8 //
   9 // Unless required by applicable law or agreed to in writing, software
  10 // distributed under the License is distributed on an "AS IS" BASIS,
  11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12 // See the License for the specific language governing permissions and
  13 // limitations under the License.
  14
  15 syntax = "proto3";
  16
  17 package grafeas.v1beta1.package;
  18
  19 option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1beta1/package;package";
  20 option java_multiple_files = true;
  21 option java_package = "io.grafeas.v1beta1.pkg";
  22 option objc_class_prefix = "GRA";
  23
  24 // Instruction set architectures supported by various package managers.
  25 enum Architecture {
  26   // Unknown architecture.
  27   ARCHITECTURE_UNSPECIFIED = 0;
  28   // X86 architecture.
  29   X86 = 1;
  30   // X64 architecture.
  31   X64 = 2;
  32 }
  33
  34 // This represents a particular channel of distribution for a given package.
  35 // E.g., Debian's jessie-backports dpkg mirror.
  36 message Distribution {
  37   // The cpe_uri in [cpe format](https://cpe.mitre.org/specification/)
  38   // denoting the package manager version distributing a package.
  39   string cpe_uri = 1;
  40
  41   // The CPU architecture for which packages in this distribution channel were
  42   // built.
  43   Architecture architecture = 2;
  44
  45   // The latest available version of this package in this distribution
  46   // channel.
  47   Version latest_version = 3;
  48
  49   // A freeform string denoting the maintainer of this package.
  50   string maintainer = 4;
  51
  52   // The distribution channel-specific homepage for this package.
  53   string url = 5;
  54
  55   // The distribution channel-specific description of this package.
  56   string description = 6;
  57 }
  58
  59 // An occurrence of a particular package installation found within a system's
  60 // filesystem. E.g., glibc was found in /var/lib/dpkg/status.
  61 message Location {
  62   // The cpe_uri in [cpe format](https://cpe.mitre.org/specification/)
  63   // denoting the package manager version distributing a package.
  64   string cpe_uri = 1;
  65
  66   // The version installed at this location.
  67   Version version = 2;
  68
  69   // The path from which we gathered that this package/version is installed.
  70   string path = 3;
  71 }
  72
  73 // This represents a particular package that is distributed over various
  74 // channels. E.g., glibc (aka libc6) is distributed by many, at various
  75 // versions.
  76 message Package {
  77   // The name of the package.
  78   string name = 1;
  79
  80   // The various channels by which a package is distributed.
  81   repeated Distribution distribution = 10;
  82 }
  83
  84 // Details of a package occurrence.
  85 message Details {
  86   // Where the package was installed.
  87   Installation installation = 1;
  88 }
  89
  90 // This represents how a particular software package may be installed on a
  91 // system.
  92 message Installation {
  93   // Output only. The name of the installed package.
  94   string name = 1;
  95
  96   // All of the places within the filesystem versions of this package
  97   // have been found.
  98   repeated Location location = 2;
  99 }
 100
 101 // Version contains structured information about the version of a package.
 102 message Version {
 103   // Used to correct mistakes in the version numbering scheme.
 104   int32 epoch = 1;
 105   // The main part of the version name.
 106   string name = 2;
 107   // The iteration of the package build from the above version.
 108   string revision = 3;
 109
 110   // Whether this is an ordinary package version or a sentinel MIN/MAX version.
 111   enum VersionKind {
 112     // Unknown.
 113     VERSION_KIND_UNSPECIFIED = 0;
 114     // A standard package version, defined by the other fields.
 115     NORMAL = 1;
 116     // A special version representing negative infinity, other fields are
 117     // ignored.
 118     MINIMUM = 2;
 119     // A special version representing positive infinity, other fields are
 120     // ignored.
 121     MAXIMUM = 3;
 122   };
 123
 124   // Distinguish between sentinel MIN/MAX versions and normal versions. If
 125   // kind is not NORMAL, then the other fields are ignored.
 126   VersionKind kind = 4;
 127 }