summaryrefslogtreecommitdiff
path: root/src/mongo/db/commands/feature_compatibility_version_document.idl
blob: bf4fc87bc36bcb80fd0a88e8b5982e9f3fb96c39 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
#Copyright(C) 2020 - present MongoDB, Inc.
#
#This program is free software : you can redistribute it and / or modify
#it under the terms of the Server Side Public License, version 1,
#as published by MongoDB, Inc.
#
#This program is distributed in the hope that it will be useful,
#but WITHOUT ANY WARRANTY; without even the implied warranty of
#MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the
#Server Side Public License for more details.
#
#You should have received a copy of the Server Side Public License
#along with this program.If not, see
# <http: //www.mongodb.com/licensing/server-side-public-license>.
#
#As a special exception, the copyright holders give permission to link the
#code of portions of this program with the OpenSSL library under certain
#conditions as described in each individual source file and distribute
#linked combinations including the program with the OpenSSL library.You
#must comply with the Server Side Public License in all respects for
#all of the code used other than as permitted herein.If you modify file(s)
#with this exception, you may extend this exception to your version of the
#file(s), but you are not obligated to do so.If you do not wish to do so,
#delete this exception statement from your version.If you delete this
#exception statement from all source files in the program, then also delete
#it in the license file.
#
global:
  cpp_namespace: "mongo"
  cpp_includes:
    - "mongo/db/commands/feature_compatibility_version_parser.h"


imports:
  - "mongo/idl/basic_types.idl"

types:
  version_string:
    bson_serialization_type: string
    description: >-
      Ensures that the version strings in featureCompatibilityVersion documents
      serialize/deserialize to a fixed set of string values
    cpp_type: "ServerGlobalParams::FeatureCompatibility::Version"
    serializer: "::mongo::FeatureCompatibilityVersionParser::serializeVersion"
    deserializer: "mongo::FeatureCompatibilityVersionParser::parseVersion"

structs:
  featureCompatibilityVersionDocument:
    description: "featureCompatibilityVersion on-disk document format"
    fields:
      _id:
        type: string
        description: "Key of the featureCompatibilityVersion state singleton document"
        default: '"featureCompatibilityVersion"'
      version:
        description: "Effective featureCompatibilityVersion"
        type: version_string
      targetVersion:
        description: "Target featureCompatibilityVersion for upgrade/downgrade"
        type: version_string
        optional: true
      previousVersion:
        description: >-
          Previous featureCompatibilityVersion for downgrading states, will always be kLatest when
          present
        type: version_string
        optional: true
        validator:
          callback: "FeatureCompatibilityVersionParser::validatePreviousVersionField"