From 43405eca2af0754194c8b21232283adb36d957be Mon Sep 17 00:00:00 2001 From: Chris Henzie Date: Thu, 4 Mar 2021 14:49:38 -0800 Subject: [PATCH] Single node single/multi writer access modes --- csi.proto | 32 +++ lib/go/csi/csi.pb.go | 529 +++++++++++++++++++++++-------------------- spec.md | 47 +++- 3 files changed, 361 insertions(+), 247 deletions(-) diff --git a/csi.proto b/csi.proto index d173864e..6adfb09b 100644 --- a/csi.proto +++ b/csi.proto @@ -420,6 +420,18 @@ message VolumeCapability { // Can be published as read/write at multiple nodes // simultaneously. MULTI_NODE_MULTI_WRITER = 5; + + // Can only be published once as read/write at a single workload + // on a single node, at any given time. Should be used instead of + // SINGLE_NODE_WRITER for COs using the experimental + // SINGLE_NODE_MULTI_WRITER capability. + SINGLE_NODE_SINGLE_WRITER = 6 [(alpha_enum_value) = true]; + + // Can be published as read/write at multiple workloads on a + // single node simultaneously. Should be used instead of + // SINGLE_NODE_WRITER for COs using the experimental + // SINGLE_NODE_MULTI_WRITER capability. + SINGLE_NODE_MULTI_WRITER = 7 [(alpha_enum_value) = true]; } // This field is REQUIRED. @@ -1044,6 +1056,16 @@ message ControllerServiceCapability { // This enables COs to, for example, fetch per volume // condition after a volume is provisioned. GET_VOLUME = 12 [(alpha_enum_value) = true]; + + // Indicates the SP supports the SINGLE_NODE_SINGLE_WRITER and/or + // SINGLE_NODE_MULTI_WRITER access modes. + // These access modes are intended to replace the + // SINGLE_NODE_WRITER access mode to clarify the number of writers + // for a volume on a single node. Plugins MUST accept and allow + // use of the SINGLE_NODE_WRITER access mode when either + // SINGLE_NODE_SINGLE_WRITER and/or SINGLE_NODE_MULTI_WRITER are + // supported, in order to permit older COs to continue working. + SINGLE_NODE_MULTI_WRITER = 13 [(alpha_enum_value) = true]; } Type type = 1; @@ -1476,6 +1498,16 @@ message NodeServiceCapability { // Note that, for alpha, `VolumeCondition` is intended to be // informative for humans only, not for automation. VOLUME_CONDITION = 4 [(alpha_enum_value) = true]; + // Indicates the SP supports the SINGLE_NODE_SINGLE_WRITER and/or + // SINGLE_NODE_MULTI_WRITER access modes. + // These access modes are intended to replace the + // SINGLE_NODE_WRITER access mode to clarify the number of writers + // for a volume on a single node. Plugins MUST accept and allow + // use of the SINGLE_NODE_WRITER access mode (subject to the + // processing rules for NodePublishVolume), when either + // SINGLE_NODE_SINGLE_WRITER and/or SINGLE_NODE_MULTI_WRITER are + // supported, in order to permit older COs to continue working. + SINGLE_NODE_MULTI_WRITER = 5 [(alpha_enum_value) = true]; } Type type = 1; diff --git a/lib/go/csi/csi.pb.go b/lib/go/csi/csi.pb.go index a214418d..86b73037 100644 --- a/lib/go/csi/csi.pb.go +++ b/lib/go/csi/csi.pb.go @@ -150,6 +150,16 @@ const ( // Can be published as read/write at multiple nodes // simultaneously. VolumeCapability_AccessMode_MULTI_NODE_MULTI_WRITER VolumeCapability_AccessMode_Mode = 5 + // Can only be published once as read/write at a single workload + // on a single node, at any given time. Should be used instead of + // SINGLE_NODE_WRITER for COs using the experimental + // SINGLE_NODE_MULTI_WRITER capability. + VolumeCapability_AccessMode_SINGLE_NODE_SINGLE_WRITER VolumeCapability_AccessMode_Mode = 6 + // Can be published as read/write at multiple workloads on a + // single node simultaneously. Should be used instead of + // SINGLE_NODE_WRITER for COs using the experimental + // SINGLE_NODE_MULTI_WRITER capability. + VolumeCapability_AccessMode_SINGLE_NODE_MULTI_WRITER VolumeCapability_AccessMode_Mode = 7 ) var VolumeCapability_AccessMode_Mode_name = map[int32]string{ @@ -159,15 +169,19 @@ var VolumeCapability_AccessMode_Mode_name = map[int32]string{ 3: "MULTI_NODE_READER_ONLY", 4: "MULTI_NODE_SINGLE_WRITER", 5: "MULTI_NODE_MULTI_WRITER", + 6: "SINGLE_NODE_SINGLE_WRITER", + 7: "SINGLE_NODE_MULTI_WRITER", } var VolumeCapability_AccessMode_Mode_value = map[string]int32{ - "UNKNOWN": 0, - "SINGLE_NODE_WRITER": 1, - "SINGLE_NODE_READER_ONLY": 2, - "MULTI_NODE_READER_ONLY": 3, - "MULTI_NODE_SINGLE_WRITER": 4, - "MULTI_NODE_MULTI_WRITER": 5, + "UNKNOWN": 0, + "SINGLE_NODE_WRITER": 1, + "SINGLE_NODE_READER_ONLY": 2, + "MULTI_NODE_READER_ONLY": 3, + "MULTI_NODE_SINGLE_WRITER": 4, + "MULTI_NODE_MULTI_WRITER": 5, + "SINGLE_NODE_SINGLE_WRITER": 6, + "SINGLE_NODE_MULTI_WRITER": 7, } func (x VolumeCapability_AccessMode_Mode) String() string { @@ -221,6 +235,15 @@ const ( // This enables COs to, for example, fetch per volume // condition after a volume is provisioned. ControllerServiceCapability_RPC_GET_VOLUME ControllerServiceCapability_RPC_Type = 12 + // Indicates the SP supports the SINGLE_NODE_SINGLE_WRITER and/or + // SINGLE_NODE_MULTI_WRITER access modes. + // These access modes are intended to replace the + // SINGLE_NODE_WRITER access mode to clarify the number of writers + // for a volume on a single node. Plugins MUST accept and allow + // use of the SINGLE_NODE_WRITER access mode when either + // SINGLE_NODE_SINGLE_WRITER and/or SINGLE_NODE_MULTI_WRITER are + // supported, in order to permit older COs to continue working. + ControllerServiceCapability_RPC_SINGLE_NODE_MULTI_WRITER ControllerServiceCapability_RPC_Type = 13 ) var ControllerServiceCapability_RPC_Type_name = map[int32]string{ @@ -237,6 +260,7 @@ var ControllerServiceCapability_RPC_Type_name = map[int32]string{ 10: "LIST_VOLUMES_PUBLISHED_NODES", 11: "VOLUME_CONDITION", 12: "GET_VOLUME", + 13: "SINGLE_NODE_MULTI_WRITER", } var ControllerServiceCapability_RPC_Type_value = map[string]int32{ @@ -253,6 +277,7 @@ var ControllerServiceCapability_RPC_Type_value = map[string]int32{ "LIST_VOLUMES_PUBLISHED_NODES": 10, "VOLUME_CONDITION": 11, "GET_VOLUME": 12, + "SINGLE_NODE_MULTI_WRITER": 13, } func (x ControllerServiceCapability_RPC_Type) String() string { @@ -314,6 +339,16 @@ const ( // Note that, for alpha, `VolumeCondition` is intended to be // informative for humans only, not for automation. NodeServiceCapability_RPC_VOLUME_CONDITION NodeServiceCapability_RPC_Type = 4 + // Indicates the SP supports the SINGLE_NODE_SINGLE_WRITER and/or + // SINGLE_NODE_MULTI_WRITER access modes. + // These access modes are intended to replace the + // SINGLE_NODE_WRITER access mode to clarify the number of writers + // for a volume on a single node. Plugins MUST accept and allow + // use of the SINGLE_NODE_WRITER access mode (subject to the + // processing rules for NodePublishVolume), when either + // SINGLE_NODE_SINGLE_WRITER and/or SINGLE_NODE_MULTI_WRITER are + // supported, in order to permit older COs to continue working. + NodeServiceCapability_RPC_SINGLE_NODE_MULTI_WRITER NodeServiceCapability_RPC_Type = 5 ) var NodeServiceCapability_RPC_Type_name = map[int32]string{ @@ -322,14 +357,16 @@ var NodeServiceCapability_RPC_Type_name = map[int32]string{ 2: "GET_VOLUME_STATS", 3: "EXPAND_VOLUME", 4: "VOLUME_CONDITION", + 5: "SINGLE_NODE_MULTI_WRITER", } var NodeServiceCapability_RPC_Type_value = map[string]int32{ - "UNKNOWN": 0, - "STAGE_UNSTAGE_VOLUME": 1, - "GET_VOLUME_STATS": 2, - "EXPAND_VOLUME": 3, - "VOLUME_CONDITION": 4, + "UNKNOWN": 0, + "STAGE_UNSTAGE_VOLUME": 1, + "GET_VOLUME_STATS": 2, + "EXPAND_VOLUME": 3, + "VOLUME_CONDITION": 4, + "SINGLE_NODE_MULTI_WRITER": 5, } func (x NodeServiceCapability_RPC_Type) String() string { @@ -4996,240 +5033,242 @@ func init() { } var fileDescriptor_9cdb00adce470e01 = []byte{ - // 3723 bytes of a gzipped FileDescriptorProto - 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xe4, 0x3b, 0x4b, 0x6c, 0x1b, 0xd7, - 0xb5, 0x1a, 0x7e, 0xf4, 0x39, 0x94, 0x64, 0xfa, 0xea, 0x63, 0x7a, 0x24, 0x59, 0xf2, 0x38, 0x76, - 0x64, 0xc7, 0xa6, 0x13, 0x25, 0x36, 0x5e, 0x64, 0xe7, 0x43, 0x52, 0xb4, 0xc4, 0x98, 0xa6, 0x94, - 0x21, 0x65, 0xc7, 0x7e, 0x2f, 0x98, 0x8c, 0xc8, 0x2b, 0x79, 0x10, 0x72, 0x86, 0x9e, 0x19, 0xea, - 0x49, 0xd9, 0xbc, 0x87, 0xf7, 0xf0, 0x16, 0x0f, 0x45, 0x81, 0xee, 0x92, 0x5d, 0x83, 0xb6, 0xab, - 0x22, 0x41, 0x36, 0x2d, 0xba, 0x2c, 0xd0, 0x65, 0x81, 0x16, 0xdd, 0xb5, 0x68, 0x17, 0xd9, 0x16, - 0x41, 0x0a, 0x64, 0xd5, 0x45, 0x57, 0xc5, 0xdc, 0x7b, 0x67, 0x38, 0x5f, 0x7e, 0x2c, 0x19, 0x59, - 0x74, 0x25, 0xce, 0xb9, 0xe7, 0x9c, 0x7b, 0xee, 0xbd, 0xe7, 0x9c, 0x7b, 0x3e, 0x57, 0x70, 0xeb, - 0x40, 0x31, 0x9f, 0x76, 0xf6, 0xb2, 0x75, 0xad, 0x75, 0xb3, 0xae, 0xa9, 0xa6, 0xac, 0xa8, 0x58, - 0xbf, 0x61, 0x98, 0x9a, 0x2e, 0x1f, 0xe0, 0x1b, 0x8a, 0x6a, 0x62, 0x7d, 0x5f, 0xae, 0xe3, 0x9b, - 0x46, 0x1b, 0xd7, 0x6f, 0xd6, 0x0d, 0x25, 0xdb, 0xd6, 0x35, 0x53, 0x43, 0xa3, 0xd6, 0xcf, 0xc3, - 0xd7, 0xf8, 0x95, 0x03, 0x4d, 0x3b, 0x68, 0xe2, 0x9b, 0x04, 0xba, 0xd7, 0xd9, 0xbf, 0xd9, 0xc0, - 0x46, 0x5d, 0x57, 0xda, 0xa6, 0xa6, 0x53, 0x4c, 0x7e, 0xd9, 0x8f, 0x61, 0x2a, 0x2d, 0x6c, 0x98, - 0x72, 0xab, 0xcd, 0x10, 0x2e, 0xf8, 0x11, 0xfe, 0x53, 0x97, 0xdb, 0x6d, 0xac, 0x1b, 0x74, 0x5c, - 0x98, 0x87, 0xd9, 0x4d, 0x6c, 0xee, 0x34, 0x3b, 0x07, 0x8a, 0x5a, 0x52, 0xf7, 0x35, 0x11, 0x3f, - 0xeb, 0x60, 0xc3, 0x14, 0xfe, 0xc4, 0xc1, 0x9c, 0x6f, 0xc0, 0x68, 0x6b, 0xaa, 0x81, 0x11, 0x82, - 0x84, 0x2a, 0xb7, 0x70, 0x86, 0x5b, 0xe1, 0x56, 0x27, 0x44, 0xf2, 0x1b, 0x5d, 0x86, 0xe9, 0x43, - 0xac, 0x36, 0x34, 0x5d, 0x3a, 0xc4, 0xba, 0xa1, 0x68, 0x6a, 0x26, 0x46, 0x46, 0xa7, 0x28, 0xf4, - 0x21, 0x05, 0xa2, 0x4d, 0x18, 0x6f, 0xc9, 0xaa, 0xb2, 0x8f, 0x0d, 0x33, 0x13, 0x5f, 0x89, 0xaf, - 0xa6, 0xd6, 0x5e, 0xc9, 0xd2, 0xa5, 0x66, 0x43, 0xe7, 0xca, 0x3e, 0x60, 0xd8, 0x45, 0xd5, 0xd4, - 0x8f, 0x45, 0x87, 0x98, 0xbf, 0x03, 0x53, 0x9e, 0x21, 0x94, 0x86, 0xf8, 0xc7, 0xf8, 0x98, 0xc9, - 0x64, 0xfd, 0x44, 0xb3, 0x90, 0x3c, 0x94, 0x9b, 0x1d, 0xcc, 0x24, 0xa1, 0x1f, 0xeb, 0xb1, 0x7f, - 0xe3, 0x84, 0x0b, 0xb0, 0xe8, 0xcc, 0x56, 0x90, 0xdb, 0xf2, 0x9e, 0xd2, 0x54, 0x4c, 0x05, 0x1b, - 0xf6, 0xd2, 0x3f, 0x84, 0xa5, 0x88, 0x71, 0xb6, 0x03, 0x77, 0x61, 0xb2, 0xee, 0x82, 0x67, 0x38, - 0xb2, 0x94, 0x8c, 0xbd, 0x14, 0x1f, 0xe5, 0xb1, 0xe8, 0xc1, 0x16, 0x7e, 0x1f, 0x87, 0xb4, 0x1f, - 0x05, 0xdd, 0x85, 0x31, 0x03, 0xeb, 0x87, 0x4a, 0x9d, 0xee, 0x6b, 0x6a, 0x6d, 0x25, 0x8a, 0x5b, - 0xb6, 0x4a, 0xf1, 0xb6, 0x46, 0x44, 0x9b, 0x04, 0xed, 0x42, 0xfa, 0x50, 0x6b, 0x76, 0x5a, 0x58, - 0xc2, 0x47, 0x6d, 0x59, 0x75, 0x0e, 0x20, 0xb5, 0xb6, 0x1a, 0xc9, 0xe6, 0x21, 0x21, 0x28, 0xda, - 0xf8, 0x5b, 0x23, 0xe2, 0x99, 0x43, 0x2f, 0x88, 0xff, 0x94, 0x83, 0x31, 0x36, 0x1b, 0x7a, 0x13, - 0x12, 0xe6, 0x71, 0x9b, 0x4a, 0x37, 0xbd, 0x76, 0xb9, 0x9f, 0x74, 0xd9, 0xda, 0x71, 0x1b, 0x8b, - 0x84, 0x44, 0x78, 0x1f, 0x12, 0xd6, 0x17, 0x4a, 0xc1, 0xd8, 0x6e, 0xe5, 0x7e, 0x65, 0xfb, 0x51, - 0x25, 0x3d, 0x82, 0xe6, 0x01, 0x15, 0xb6, 0x2b, 0x35, 0x71, 0xbb, 0x5c, 0x2e, 0x8a, 0x52, 0xb5, - 0x28, 0x3e, 0x2c, 0x15, 0x8a, 0x69, 0x0e, 0xbd, 0x04, 0x2b, 0x0f, 0xb7, 0xcb, 0xbb, 0x0f, 0x8a, - 0x52, 0xae, 0x50, 0x28, 0x56, 0xab, 0xa5, 0x7c, 0xa9, 0x5c, 0xaa, 0x3d, 0x96, 0x0a, 0xdb, 0x95, - 0x6a, 0x4d, 0xcc, 0x95, 0x2a, 0xb5, 0x6a, 0x3a, 0xc6, 0xff, 0x0f, 0x07, 0x67, 0x7c, 0x0b, 0x40, - 0x39, 0x8f, 0x84, 0x37, 0x06, 0x5d, 0xb8, 0x5b, 0xd2, 0xeb, 0x61, 0x92, 0x02, 0x8c, 0x6e, 0x57, - 0xca, 0xa5, 0x8a, 0x25, 0x5d, 0x0a, 0xc6, 0xb6, 0xef, 0xdd, 0x23, 0x1f, 0xb1, 0xfc, 0x28, 0x9d, - 0x50, 0x98, 0x86, 0xc9, 0x1d, 0x5d, 0xdb, 0xc3, 0xb6, 0xfe, 0xe4, 0x60, 0x8a, 0x7d, 0x33, 0x7d, - 0x79, 0x15, 0x92, 0x3a, 0x96, 0x1b, 0xc7, 0xec, 0x68, 0xf9, 0x2c, 0xb5, 0xc9, 0xac, 0x6d, 0x93, - 0xd9, 0xbc, 0xa6, 0x35, 0x1f, 0x5a, 0xfa, 0x29, 0x52, 0x44, 0xe1, 0xbb, 0x04, 0xcc, 0x14, 0x74, - 0x2c, 0x9b, 0x98, 0x4a, 0xcb, 0x58, 0x87, 0xda, 0xde, 0x5d, 0x98, 0xb6, 0xf4, 0xab, 0xae, 0x98, - 0xc7, 0x92, 0x2e, 0xab, 0x07, 0x98, 0x1d, 0xfd, 0x9c, 0xbd, 0x03, 0x05, 0x36, 0x2a, 0x5a, 0x83, - 0xe2, 0x54, 0xdd, 0xfd, 0x89, 0x4a, 0x30, 0xc3, 0x54, 0xc7, 0xa3, 0xd2, 0x71, 0xaf, 0x4a, 0x53, - 0x29, 0x5c, 0x2a, 0x8d, 0x0e, 0xbd, 0x10, 0x05, 0x1b, 0xe8, 0x3e, 0x40, 0x5b, 0xd6, 0xe5, 0x16, - 0x36, 0xb1, 0x6e, 0x64, 0x12, 0x5e, 0xfb, 0x0e, 0x59, 0x4d, 0x76, 0xc7, 0xc1, 0xa6, 0xf6, 0xed, - 0x22, 0x47, 0x9b, 0x96, 0x41, 0xd4, 0x75, 0x6c, 0x1a, 0x99, 0x24, 0xe1, 0xb4, 0xda, 0x8b, 0x53, - 0x95, 0xa2, 0x12, 0x36, 0xf9, 0xf8, 0x67, 0x79, 0x4e, 0xb4, 0xa9, 0xd1, 0x36, 0xcc, 0xd9, 0x0b, - 0xd4, 0x54, 0x13, 0xab, 0xa6, 0x64, 0x68, 0x1d, 0xbd, 0x8e, 0x33, 0xa3, 0x64, 0x97, 0x16, 0x7c, - 0x4b, 0xa4, 0x38, 0x55, 0x82, 0x22, 0xb2, 0xad, 0xf1, 0x00, 0xd1, 0x13, 0xe0, 0xe5, 0x7a, 0x1d, - 0x1b, 0x86, 0x42, 0xf7, 0x42, 0xd2, 0xf1, 0xb3, 0x8e, 0xa2, 0xe3, 0x16, 0x56, 0x4d, 0x23, 0x33, - 0xe6, 0xe5, 0x5a, 0xd3, 0xda, 0x5a, 0x53, 0x3b, 0x38, 0x16, 0xbb, 0x38, 0xe2, 0x79, 0x0f, 0xb9, - 0x6b, 0xc4, 0xe0, 0xdf, 0x82, 0x33, 0xbe, 0x4d, 0x19, 0xc6, 0xb3, 0xf1, 0xeb, 0x30, 0xe9, 0xde, - 0x89, 0xa1, 0xbc, 0xe2, 0x0f, 0x62, 0x30, 0x13, 0xb2, 0x07, 0x68, 0x0b, 0xc6, 0x0d, 0x55, 0x6e, - 0x1b, 0x4f, 0x35, 0x93, 0xe9, 0xef, 0xb5, 0x1e, 0x5b, 0x96, 0xad, 0x32, 0x5c, 0xfa, 0xb9, 0x35, - 0x22, 0x3a, 0xd4, 0x28, 0x0f, 0xa3, 0x74, 0x3f, 0xfd, 0xbe, 0x29, 0x8c, 0x0f, 0x85, 0x39, 0x5c, - 0x18, 0x25, 0xff, 0x1a, 0x4c, 0x7b, 0x67, 0x40, 0xcb, 0x90, 0xb2, 0x67, 0x90, 0x94, 0x06, 0x5b, - 0x2b, 0xd8, 0xa0, 0x52, 0x83, 0x7f, 0x05, 0x26, 0xdd, 0xcc, 0xd0, 0x02, 0x4c, 0x30, 0x85, 0x70, - 0xd0, 0xc7, 0x29, 0xa0, 0xd4, 0x70, 0x6c, 0xfa, 0x6d, 0x98, 0xf5, 0xea, 0x19, 0x33, 0xe5, 0x2b, - 0xce, 0x1a, 0xe8, 0x5e, 0x4c, 0x7b, 0xd7, 0x60, 0xcb, 0x29, 0xfc, 0x3c, 0x01, 0x69, 0xbf, 0xd1, - 0xa0, 0xbb, 0x90, 0xdc, 0x6b, 0x6a, 0xf5, 0x8f, 0x19, 0xed, 0x4b, 0x51, 0xd6, 0x95, 0xcd, 0x5b, - 0x58, 0x14, 0xba, 0x35, 0x22, 0x52, 0x22, 0x8b, 0xba, 0xa5, 0x75, 0x54, 0x93, 0xed, 0x5e, 0x34, - 0xf5, 0x03, 0x0b, 0xab, 0x4b, 0x4d, 0x88, 0xd0, 0x06, 0xa4, 0xa8, 0xda, 0x49, 0x2d, 0xad, 0x81, - 0x33, 0x71, 0xc2, 0xe3, 0x52, 0x24, 0x8f, 0x1c, 0xc1, 0x7d, 0xa0, 0x35, 0xb0, 0x08, 0xb2, 0xf3, - 0x9b, 0x9f, 0x82, 0x94, 0x4b, 0x36, 0x7e, 0x13, 0x52, 0xae, 0xc9, 0xd0, 0x39, 0x18, 0xdb, 0x37, - 0x24, 0xc7, 0x09, 0x4f, 0x88, 0xa3, 0xfb, 0x06, 0xf1, 0xa7, 0xcb, 0x90, 0x22, 0x52, 0x48, 0xfb, - 0x4d, 0xf9, 0xc0, 0xc8, 0xc4, 0x56, 0xe2, 0xd6, 0x19, 0x11, 0xd0, 0x3d, 0x0b, 0xc2, 0x7f, 0xcb, - 0x01, 0x74, 0xa7, 0x44, 0x77, 0x21, 0x41, 0xa4, 0xa4, 0xae, 0x7c, 0x75, 0x00, 0x29, 0xb3, 0x44, - 0x54, 0x42, 0x25, 0xfc, 0x98, 0x83, 0x04, 0x61, 0xe3, 0xbf, 0x70, 0xaa, 0xa5, 0xca, 0x66, 0xb9, - 0x28, 0x55, 0xb6, 0x37, 0x8a, 0xd2, 0x23, 0xb1, 0x54, 0x2b, 0x8a, 0x69, 0x0e, 0x2d, 0xc0, 0x39, - 0x37, 0x5c, 0x2c, 0xe6, 0x36, 0x8a, 0xa2, 0xb4, 0x5d, 0x29, 0x3f, 0x4e, 0xc7, 0x10, 0x0f, 0xf3, - 0x0f, 0x76, 0xcb, 0xb5, 0x52, 0x70, 0x2c, 0x8e, 0x16, 0x21, 0xe3, 0x1a, 0x63, 0x3c, 0x18, 0xdb, - 0x84, 0xc5, 0xd6, 0x35, 0x4a, 0x7f, 0xb2, 0xc1, 0x64, 0x7e, 0xca, 0x39, 0x0c, 0xa2, 0x6c, 0x8f, - 0x60, 0xca, 0xe3, 0xa3, 0xad, 0x70, 0x8a, 0x39, 0x95, 0x86, 0xb4, 0x77, 0x6c, 0x92, 0x10, 0x83, - 0x5b, 0x8d, 0x8b, 0x53, 0x36, 0x34, 0x6f, 0x01, 0xad, 0x6d, 0x6d, 0x2a, 0x2d, 0xc5, 0x64, 0x38, - 0x31, 0x82, 0x03, 0x04, 0x44, 0x10, 0x84, 0xaf, 0x63, 0x30, 0xca, 0xce, 0xe6, 0xb2, 0xeb, 0x96, - 0xf0, 0xb0, 0xb4, 0xa1, 0x94, 0xa5, 0xc7, 0x38, 0x62, 0x5e, 0xe3, 0x40, 0x5b, 0x30, 0xed, 0x76, - 0xa5, 0x47, 0x76, 0x10, 0x77, 0xd1, 0x7b, 0x40, 0x6e, 0x7b, 0x3e, 0x62, 0xa1, 0xdb, 0xd4, 0xa1, - 0x1b, 0x86, 0xf2, 0x30, 0xed, 0xf3, 0xc6, 0x89, 0xfe, 0xde, 0x78, 0xaa, 0xee, 0x71, 0x4c, 0x39, - 0x98, 0xb1, 0x1d, 0x69, 0x13, 0x4b, 0x26, 0x73, 0xb4, 0xec, 0xb6, 0x48, 0x07, 0x1c, 0x30, 0xea, - 0x22, 0xdb, 0x30, 0xfe, 0x5d, 0x40, 0x41, 0x59, 0x87, 0xf2, 0x9a, 0x1d, 0x98, 0x09, 0x71, 0xf1, - 0x28, 0x0b, 0x13, 0xe4, 0xa8, 0x0c, 0xc5, 0xc4, 0x2c, 0x3c, 0x0c, 0x4a, 0xd4, 0x45, 0xb1, 0xf0, - 0xdb, 0x3a, 0xde, 0xc7, 0xba, 0x8e, 0x1b, 0xc4, 0x3c, 0x42, 0xf1, 0x1d, 0x14, 0xe1, 0x7f, 0x39, - 0x18, 0xb7, 0xe1, 0x68, 0x1d, 0xc6, 0x0d, 0x7c, 0x40, 0xaf, 0x1f, 0x3a, 0xd7, 0x05, 0x3f, 0x6d, - 0xb6, 0xca, 0x10, 0x58, 0x20, 0x6d, 0xe3, 0x5b, 0x81, 0xb4, 0x67, 0x68, 0xa8, 0xc5, 0xff, 0x8a, - 0x83, 0x99, 0x0d, 0xdc, 0xc4, 0xfe, 0x28, 0xa5, 0x97, 0x87, 0x75, 0x5f, 0xec, 0x31, 0xef, 0xc5, - 0x1e, 0xc2, 0xaa, 0xc7, 0xc5, 0x7e, 0xa2, 0xcb, 0x6e, 0x1e, 0x66, 0xbd, 0xb3, 0x51, 0xf7, 0x2e, - 0xfc, 0x2d, 0x0e, 0x17, 0x2c, 0x5d, 0xd0, 0xb5, 0x66, 0x13, 0xeb, 0x3b, 0x9d, 0xbd, 0xa6, 0x62, - 0x3c, 0x1d, 0x62, 0x71, 0xe7, 0x60, 0x4c, 0xd5, 0x1a, 0x2e, 0xe3, 0x19, 0xb5, 0x3e, 0x4b, 0x0d, - 0x54, 0x84, 0xb3, 0xfe, 0x30, 0xeb, 0x98, 0x39, 0xe1, 0xe8, 0x20, 0x2b, 0x7d, 0xe8, 0xbf, 0x41, - 0x78, 0x18, 0xb7, 0x02, 0x44, 0x4d, 0x6d, 0x1e, 0x13, 0x8b, 0x19, 0x17, 0x9d, 0x6f, 0x24, 0xfa, - 0x23, 0xa6, 0xd7, 0x9d, 0x88, 0xa9, 0xe7, 0x8a, 0x7a, 0x05, 0x4f, 0x1f, 0x05, 0x2c, 0x7e, 0x94, - 0xb0, 0x7e, 0x73, 0x40, 0xd6, 0x7d, 0x3d, 0xc1, 0x49, 0x4e, 0xf1, 0x14, 0xcc, 0xf7, 0xb7, 0x1c, - 0x2c, 0x47, 0x2e, 0x81, 0x5d, 0xf9, 0x0d, 0x38, 0xd3, 0xa6, 0x03, 0xce, 0x26, 0x50, 0x2b, 0xbb, - 0xd3, 0x77, 0x13, 0x58, 0x16, 0xcb, 0xa0, 0x9e, 0x6d, 0x98, 0x6e, 0x7b, 0x80, 0x7c, 0x0e, 0x66, - 0x42, 0xd0, 0x86, 0x5a, 0xcc, 0x37, 0x1c, 0xac, 0x74, 0x45, 0xd9, 0x55, 0xdb, 0xa7, 0xa7, 0xbe, - 0xb5, 0xae, 0x6e, 0x51, 0x97, 0x7f, 0x2b, 0xb8, 0xf6, 0xf0, 0x09, 0x5f, 0x94, 0x05, 0x5f, 0x82, - 0x8b, 0x3d, 0xa6, 0x66, 0xe6, 0xfc, 0x75, 0x02, 0x2e, 0x3e, 0x94, 0x9b, 0x4a, 0xc3, 0x09, 0xe4, - 0x42, 0xf2, 0xfd, 0xde, 0x5b, 0x52, 0x0f, 0x58, 0x00, 0xf5, 0x5a, 0x77, 0x1d, 0xab, 0xed, 0xc7, - 0x7f, 0x80, 0xeb, 0xf0, 0x14, 0x93, 0xb0, 0xc7, 0x21, 0x49, 0xd8, 0x9b, 0x83, 0xcb, 0xda, 0x2b, - 0x25, 0xdb, 0xf5, 0x3b, 0x98, 0xdb, 0x83, 0xf3, 0xed, 0xa1, 0x05, 0x27, 0xb6, 0xe2, 0xef, 0x33, - 0x6b, 0xfa, 0x4d, 0x02, 0x84, 0x5e, 0xab, 0x67, 0x3e, 0x44, 0x84, 0x89, 0xba, 0xa6, 0xee, 0x2b, - 0x7a, 0x0b, 0x37, 0x58, 0xf4, 0xff, 0xc6, 0x20, 0x9b, 0xc7, 0x1c, 0x48, 0xc1, 0xa6, 0x15, 0xbb, - 0x6c, 0x50, 0x06, 0xc6, 0x5a, 0xd8, 0x30, 0xe4, 0x03, 0x5b, 0x2c, 0xfb, 0x93, 0xff, 0x32, 0x0e, - 0x13, 0x0e, 0x09, 0x52, 0x03, 0x1a, 0x4c, 0xdd, 0xd7, 0xe6, 0xf3, 0x08, 0xf0, 0xfc, 0xca, 0x1c, - 0x7b, 0x0e, 0x65, 0x6e, 0x78, 0x94, 0x99, 0x9a, 0xc3, 0xc6, 0x73, 0x89, 0xdd, 0x43, 0xaf, 0xbf, - 0x77, 0x05, 0x14, 0xfe, 0x03, 0x50, 0x59, 0x31, 0x58, 0x16, 0xe5, 0xb8, 0x25, 0x2b, 0x69, 0x92, - 0x8f, 0x24, 0xac, 0x9a, 0xba, 0xc2, 0xc2, 0xf5, 0xa4, 0x08, 0x2d, 0xf9, 0xa8, 0x48, 0x21, 0x56, - 0x48, 0x6f, 0x98, 0xb2, 0x6e, 0x2a, 0xea, 0x81, 0x64, 0x6a, 0x1f, 0x63, 0xa7, 0xe8, 0x6a, 0x43, - 0x6b, 0x16, 0x50, 0xf8, 0x36, 0x06, 0x33, 0x1e, 0xf6, 0x4c, 0x27, 0xef, 0xc0, 0x58, 0x97, 0xb7, - 0x27, 0x8c, 0x0f, 0xc1, 0xce, 0xd2, 0x6d, 0xb3, 0x29, 0xd0, 0x12, 0x80, 0x8a, 0x8f, 0x4c, 0xcf, - 0xbc, 0x13, 0x16, 0x84, 0xcc, 0xc9, 0xff, 0x1f, 0xe7, 0x24, 0xdd, 0xa6, 0x6c, 0x76, 0x0c, 0x74, - 0x1d, 0x10, 0x73, 0xd1, 0xb8, 0x21, 0xb1, 0x3b, 0x86, 0xce, 0x3b, 0x21, 0xa6, 0x9d, 0x91, 0x0a, - 0xb9, 0x6d, 0x0c, 0xb4, 0xe9, 0xd4, 0x33, 0xeb, 0x9a, 0xda, 0x50, 0xcc, 0x6e, 0x3d, 0xf3, 0x5c, - 0x20, 0x41, 0xa0, 0xc3, 0xf9, 0xf8, 0xe7, 0x79, 0xce, 0xae, 0x60, 0x3a, 0x50, 0xfe, 0x19, 0x24, - 0xe9, 0x71, 0x0c, 0x98, 0xb7, 0xa3, 0x77, 0x61, 0xd4, 0x20, 0x12, 0xfb, 0x6b, 0x14, 0x61, 0x7b, - 0xe2, 0x5e, 0xa1, 0xc8, 0xe8, 0x84, 0xb7, 0x81, 0xef, 0x5e, 0x4c, 0x9b, 0xd8, 0x1c, 0xfc, 0xfa, - 0x5d, 0xb7, 0xd6, 0x20, 0x7c, 0x1a, 0x83, 0x85, 0x50, 0x06, 0xc3, 0x55, 0x20, 0xd0, 0x96, 0x6f, - 0x25, 0xaf, 0x06, 0x6f, 0xec, 0x00, 0xf3, 0xd0, 0x15, 0xf1, 0xff, 0x7d, 0xb2, 0xc3, 0xcc, 0x0f, - 0x7d, 0x98, 0x81, 0x73, 0xa4, 0x3b, 0xf3, 0x65, 0x0c, 0xd0, 0x26, 0x36, 0x9d, 0x54, 0x99, 0x6d, - 0x69, 0x84, 0xbf, 0xe1, 0x9e, 0xc3, 0xdf, 0xbc, 0xe7, 0xf1, 0x37, 0xd4, 0x63, 0x5d, 0x73, 0x75, - 0x28, 0x7c, 0x53, 0xf7, 0xbc, 0x2d, 0x23, 0xd2, 0x53, 0x1a, 0xf3, 0x0f, 0x96, 0x9e, 0x9e, 0xd0, - 0xad, 0xfc, 0x95, 0x83, 0x19, 0x8f, 0xd0, 0x4c, 0x83, 0x6e, 0x00, 0x92, 0x0f, 0x65, 0xa5, 0x29, - 0x5b, 0x82, 0xd9, 0xe9, 0x3f, 0x2b, 0x07, 0x9c, 0x75, 0x46, 0x6c, 0x32, 0xb4, 0x03, 0x33, 0x2d, - 0xf9, 0x48, 0x69, 0x75, 0x5a, 0x12, 0xdb, 0x67, 0x43, 0xf9, 0xc4, 0xae, 0xe1, 0x2d, 0x04, 0x6a, - 0xd9, 0x25, 0xd5, 0xbc, 0xfd, 0x06, 0x29, 0x66, 0x53, 0x9b, 0x3c, 0xcb, 0x88, 0x99, 0x06, 0x29, - 0x9f, 0x60, 0xc2, 0x51, 0x51, 0x03, 0x1c, 0xe3, 0x03, 0x73, 0xa4, 0xc4, 0x5d, 0x8e, 0x82, 0xe0, - 0x8e, 0x7c, 0xd9, 0x9a, 0xfd, 0x6d, 0x9d, 0xa6, 0x3b, 0x62, 0x0c, 0xe0, 0xb0, 0xbd, 0xd9, 0x0c, - 0x6d, 0xed, 0x5c, 0x0a, 0xda, 0x0e, 0xeb, 0x73, 0x44, 0x76, 0x79, 0xfe, 0x12, 0x77, 0x9b, 0x71, - 0x00, 0x1b, 0xdd, 0x81, 0xb8, 0xde, 0xae, 0x33, 0x1b, 0x7e, 0x79, 0x00, 0xfe, 0x59, 0x71, 0xa7, - 0xb0, 0x35, 0x22, 0x5a, 0x54, 0xfc, 0xdf, 0x63, 0x10, 0x17, 0x77, 0x0a, 0xe8, 0x5d, 0x4f, 0xcb, - 0xe3, 0xfa, 0x80, 0x5c, 0xdc, 0x1d, 0x8f, 0x2f, 0x62, 0x61, 0x2d, 0x8f, 0x0c, 0xcc, 0x16, 0xc4, - 0x62, 0xae, 0x56, 0x94, 0x36, 0x8a, 0xe5, 0x62, 0xad, 0x28, 0xd1, 0x96, 0x4c, 0x9a, 0x43, 0x8b, - 0x90, 0xd9, 0xd9, 0xcd, 0x97, 0x4b, 0xd5, 0x2d, 0x69, 0xb7, 0x62, 0xff, 0x62, 0xa3, 0x31, 0x94, - 0x86, 0xc9, 0x72, 0xa9, 0x5a, 0x63, 0x80, 0x6a, 0x3a, 0x6e, 0x41, 0x36, 0x8b, 0x35, 0xa9, 0x90, - 0xdb, 0xc9, 0x15, 0x4a, 0xb5, 0xc7, 0xe9, 0x04, 0xe2, 0x61, 0xde, 0xcb, 0xbb, 0x5a, 0xc9, 0xed, - 0x54, 0xb7, 0xb6, 0x6b, 0xe9, 0x24, 0x42, 0x30, 0x4d, 0xe8, 0x6d, 0x50, 0x35, 0x3d, 0x6a, 0x71, - 0x28, 0x94, 0xb7, 0x2b, 0x8e, 0x0c, 0x63, 0x68, 0x16, 0xd2, 0xf6, 0xcc, 0x62, 0x31, 0xb7, 0x41, - 0xca, 0x71, 0xe3, 0xe8, 0x2c, 0x4c, 0x15, 0x3f, 0xd8, 0xc9, 0x55, 0x36, 0x6c, 0xc4, 0x09, 0xb4, - 0x02, 0x8b, 0x6e, 0x71, 0x24, 0x46, 0x55, 0xdc, 0x20, 0x45, 0xb9, 0x6a, 0x1a, 0xd0, 0x79, 0x48, - 0xb3, 0x6e, 0x53, 0x61, 0xbb, 0xb2, 0x51, 0xaa, 0x95, 0xb6, 0x2b, 0xe9, 0x14, 0x6f, 0x69, 0x19, - 0x9a, 0x01, 0xb0, 0x24, 0x67, 0xcc, 0x26, 0x09, 0xd0, 0x29, 0x0f, 0x7f, 0x13, 0x83, 0x39, 0x5a, - 0x1f, 0xb6, 0xab, 0xd1, 0xb6, 0x37, 0x5a, 0x85, 0x34, 0xad, 0x68, 0x49, 0x7e, 0x3f, 0x3f, 0x4d, - 0xe1, 0x0f, 0xed, 0xcc, 0xc2, 0xee, 0xe5, 0xc4, 0x5c, 0xbd, 0x9c, 0x92, 0x3f, 0xcf, 0xba, 0xe6, - 0xed, 0x7a, 0xf8, 0x66, 0xeb, 0x95, 0xba, 0x3f, 0x08, 0x49, 0x04, 0x6e, 0xf4, 0xe6, 0xd6, 0x2b, - 0x48, 0x3a, 0x49, 0x9e, 0x7e, 0x42, 0x3f, 0x76, 0x0f, 0xe6, 0xfd, 0xf2, 0x32, 0x6b, 0xbd, 0x1e, - 0xe8, 0x4d, 0x38, 0x8e, 0xd5, 0xc1, 0x75, 0x30, 0x84, 0x3f, 0x72, 0x30, 0x6e, 0x83, 0xad, 0x00, - 0xc6, 0x72, 0x3a, 0x9e, 0x5a, 0xe8, 0x84, 0x05, 0x71, 0x4a, 0xab, 0xee, 0xae, 0x42, 0xcc, 0xdf, - 0x55, 0x08, 0x3d, 0xe7, 0x78, 0xe8, 0x39, 0xbf, 0x03, 0x53, 0x75, 0x4b, 0x7c, 0x45, 0x53, 0x25, - 0x53, 0x69, 0xd9, 0xa5, 0xce, 0x60, 0x17, 0xb0, 0x66, 0xb7, 0xee, 0xc5, 0x49, 0x9b, 0xc0, 0x02, - 0xa1, 0x15, 0x98, 0x24, 0x5d, 0x41, 0xc9, 0xd4, 0xa4, 0x8e, 0x81, 0x33, 0x49, 0x52, 0xf8, 0x01, - 0x02, 0xab, 0x69, 0xbb, 0x06, 0x16, 0x7e, 0xcd, 0xc1, 0x1c, 0xad, 0x67, 0xf9, 0xd5, 0xb1, 0x5f, - 0x77, 0xc4, 0xad, 0x71, 0xbe, 0xfb, 0x2e, 0x94, 0xe1, 0x8b, 0x4a, 0xe7, 0x33, 0x30, 0xef, 0x9f, - 0x8f, 0xe5, 0xf0, 0x5f, 0xc5, 0x60, 0xd6, 0x0a, 0xbe, 0xec, 0x81, 0xd3, 0x8e, 0x8f, 0x87, 0x38, - 0x49, 0xdf, 0x66, 0x26, 0x02, 0x9b, 0xb9, 0xe5, 0xcf, 0x90, 0xaf, 0xba, 0xc3, 0x47, 0xff, 0x0a, - 0x5e, 0xd4, 0x5e, 0x7e, 0xc1, 0xc1, 0x9c, 0x6f, 0x3e, 0x66, 0x2f, 0x6f, 0xf9, 0x43, 0xfe, 0x4b, - 0x11, 0xf2, 0x3d, 0x57, 0xd0, 0x7f, 0xcb, 0x0e, 0xb6, 0x87, 0x33, 0xcb, 0x3f, 0xc4, 0x60, 0xa9, - 0x7b, 0x63, 0x91, 0xbe, 0x7c, 0x63, 0x88, 0x9a, 0xd5, 0xc9, 0xda, 0xdf, 0xef, 0xfb, 0x1d, 0xee, - 0x5a, 0xf0, 0x12, 0x0d, 0x11, 0xa9, 0x97, 0xe3, 0x0d, 0x2d, 0xf5, 0x26, 0x86, 0x2d, 0xf5, 0x9e, - 0x48, 0x03, 0xfe, 0xcb, 0x5d, 0xc5, 0xf6, 0x8a, 0xcf, 0x34, 0x61, 0xc0, 0x76, 0xd0, 0x6d, 0x38, - 0x47, 0xe2, 0x7b, 0xe7, 0x59, 0x89, 0xdd, 0xec, 0xa6, 0x2e, 0x71, 0x5c, 0x9c, 0xb3, 0x86, 0x9d, - 0xb7, 0x14, 0xac, 0x05, 0xd2, 0x10, 0xbe, 0x4b, 0xc0, 0xbc, 0x15, 0xff, 0x57, 0x4d, 0xf9, 0x60, - 0x98, 0xe6, 0xc0, 0xbf, 0x07, 0x6b, 0xad, 0x31, 0xef, 0xb1, 0x84, 0x73, 0x1d, 0xa4, 0xc4, 0x8a, - 0xb2, 0x30, 0x63, 0x98, 0xf2, 0x01, 0x71, 0x07, 0xb2, 0x7e, 0x80, 0x4d, 0xa9, 0x2d, 0x9b, 0x4f, - 0x99, 0xad, 0x9f, 0x65, 0x43, 0x35, 0x32, 0xb2, 0x23, 0x9b, 0x4f, 0x4f, 0xe9, 0x20, 0xd1, 0x7b, - 0x7e, 0xa7, 0xf0, 0x4a, 0x9f, 0xb5, 0xf4, 0xd0, 0xad, 0x0f, 0x22, 0xea, 0xf1, 0xaf, 0xf5, 0x61, - 0xd9, 0xbf, 0x0e, 0x7f, 0xf2, 0xfa, 0xf3, 0xf7, 0x5c, 0xca, 0x3f, 0x0f, 0xe7, 0x02, 0x8b, 0x67, - 0x57, 0xc8, 0x01, 0x64, 0xac, 0xa1, 0x5d, 0xd5, 0x18, 0x52, 0x1d, 0x23, 0x34, 0x26, 0x16, 0xa1, - 0x31, 0xc2, 0x02, 0x9c, 0x0f, 0x99, 0x88, 0x49, 0xf1, 0xcb, 0x24, 0x15, 0x63, 0xf8, 0xae, 0xd2, - 0x87, 0x51, 0x56, 0xf1, 0x86, 0xfb, 0xd8, 0x43, 0x1b, 0x30, 0x2f, 0xc2, 0x2e, 0x96, 0x21, 0xe5, - 0xc6, 0x63, 0xd7, 0xa0, 0xd9, 0xc7, 0x70, 0x92, 0x27, 0x6a, 0x76, 0x8d, 0xfa, 0x9a, 0x5d, 0xe5, - 0xae, 0x51, 0x8d, 0x79, 0x43, 0xdb, 0xc8, 0xad, 0xe8, 0x61, 0x56, 0x4f, 0x02, 0x66, 0x35, 0xee, - 0xed, 0xa0, 0x45, 0x32, 0xfd, 0x17, 0x30, 0x2c, 0xa6, 0xd4, 0xa1, 0xad, 0x2d, 0xe1, 0x09, 0xf0, - 0x54, 0xe3, 0x87, 0x6f, 0x36, 0xf9, 0xd4, 0x28, 0xe6, 0x57, 0x23, 0x61, 0x09, 0x16, 0x42, 0x79, - 0xb3, 0xa9, 0xff, 0x9f, 0xa3, 0x82, 0x39, 0x55, 0xac, 0xaa, 0x29, 0x9b, 0xc6, 0xa0, 0x53, 0xb3, - 0x41, 0xf7, 0xd4, 0x14, 0x44, 0x34, 0x78, 0x48, 0x93, 0x10, 0x7e, 0xc4, 0xd1, 0x7d, 0xf0, 0xcb, - 0xc2, 0x6e, 0xdb, 0xab, 0x90, 0xec, 0x90, 0x42, 0x3d, 0x8d, 0xba, 0x66, 0xbc, 0x46, 0xb0, 0x6b, - 0x0d, 0x89, 0x14, 0xe3, 0xd4, 0x4a, 0x9f, 0xc2, 0x57, 0x1c, 0xa4, 0x5c, 0xfc, 0xd1, 0x22, 0x4c, - 0x38, 0xb5, 0x1d, 0x3b, 0xdf, 0x71, 0x00, 0xd6, 0xf1, 0x9b, 0x9a, 0x29, 0x37, 0xd9, 0x23, 0x12, - 0xfa, 0x61, 0xa5, 0xa8, 0x1d, 0x03, 0xd3, 0x70, 0x38, 0x2e, 0x92, 0xdf, 0xe8, 0x3a, 0x24, 0x3a, - 0xaa, 0x62, 0x12, 0xb3, 0x9f, 0xf6, 0xdb, 0x33, 0x99, 0x2a, 0xbb, 0xab, 0x2a, 0xa6, 0x48, 0xb0, - 0x84, 0x6b, 0x90, 0xb0, 0xbe, 0xbc, 0xe5, 0x85, 0x09, 0x48, 0xe6, 0x1f, 0xd7, 0x8a, 0xd5, 0x34, - 0x87, 0x00, 0x46, 0x4b, 0x34, 0x19, 0x8f, 0x09, 0x65, 0xfb, 0x4d, 0xa7, 0xb3, 0x08, 0xcb, 0x05, - 0xc8, 0x7b, 0xaa, 0xa6, 0xb7, 0xe4, 0x26, 0x91, 0x79, 0x5c, 0x74, 0xbe, 0xa3, 0xfb, 0x1f, 0xb4, - 0x5a, 0xb8, 0xe8, 0x9c, 0x48, 0x58, 0x31, 0xe8, 0x23, 0xaa, 0x5b, 0x51, 0x65, 0xa0, 0x5c, 0x68, - 0x19, 0x68, 0xc9, 0x73, 0xcb, 0xf6, 0x29, 0x00, 0xfd, 0x30, 0x06, 0x73, 0xa1, 0x78, 0xe8, 0x96, - 0xbb, 0xf4, 0x73, 0xb1, 0x27, 0x4f, 0x77, 0xd1, 0xe7, 0x17, 0x1c, 0x2d, 0xfa, 0xac, 0x7b, 0x8a, - 0x3e, 0x57, 0xfa, 0xd2, 0xbb, 0xcb, 0x3d, 0xcf, 0x22, 0xaa, 0x3d, 0xd5, 0x5a, 0x6e, 0xb3, 0x28, - 0xed, 0x56, 0xe8, 0x5f, 0xa7, 0xda, 0x33, 0x0b, 0xe9, 0x6e, 0x0d, 0x44, 0xaa, 0xd6, 0x72, 0xb5, - 0x6a, 0x3a, 0x16, 0xac, 0xb4, 0xc4, 0x43, 0xeb, 0x28, 0x09, 0x6f, 0xc9, 0x64, 0x16, 0x10, 0xdb, - 0x71, 0xf7, 0x33, 0xf3, 0x9f, 0x70, 0x30, 0xe3, 0x01, 0xb3, 0x03, 0x70, 0x75, 0xa2, 0x39, 0x4f, - 0x27, 0xfa, 0x26, 0xcc, 0x5a, 0x59, 0x1f, 0xd5, 0x76, 0x43, 0x6a, 0x63, 0x9d, 0x54, 0xa0, 0x99, - 0xde, 0x9e, 0x6d, 0xc9, 0x47, 0xac, 0x4a, 0xbf, 0x83, 0x75, 0x8b, 0xf1, 0x29, 0xd4, 0x61, 0x85, - 0xcf, 0xe2, 0x34, 0xb6, 0x18, 0x3a, 0x37, 0xe9, 0xeb, 0x67, 0x82, 0xc9, 0x4b, 0x7c, 0x88, 0xe4, - 0x25, 0xc2, 0x4b, 0x25, 0x86, 0x0a, 0x68, 0x87, 0xbf, 0x97, 0x2b, 0xdd, 0xbb, 0x97, 0x46, 0x9f, - 0xd7, 0xdd, 0x3a, 0xd8, 0x37, 0x5b, 0x1a, 0xfd, 0x2c, 0xcf, 0x7d, 0x7e, 0x5a, 0xb9, 0x6e, 0x8e, - 0xc6, 0x54, 0x27, 0xc8, 0x71, 0xd6, 0xfe, 0xc1, 0xc1, 0x78, 0xa9, 0x81, 0x55, 0x93, 0xae, 0x6d, - 0xca, 0xf3, 0x9f, 0x08, 0x68, 0x31, 0xe2, 0x1f, 0x14, 0xc8, 0xc2, 0xf8, 0xa5, 0x9e, 0xff, 0xbe, - 0x20, 0x8c, 0xa0, 0x7d, 0xd7, 0x7f, 0x51, 0x78, 0x5a, 0x0d, 0x2f, 0x05, 0x28, 0x43, 0xdc, 0x14, - 0x7f, 0xb9, 0x0f, 0x96, 0x33, 0xcf, 0x6d, 0x48, 0x92, 0x37, 0xe7, 0x68, 0xd6, 0x79, 0xf7, 0xee, - 0x7a, 0x92, 0xce, 0xcf, 0xf9, 0xa0, 0x36, 0xdd, 0xda, 0xef, 0x26, 0x00, 0xba, 0xa9, 0x22, 0xba, - 0x0f, 0x93, 0xee, 0x67, 0xaf, 0x68, 0xa1, 0xc7, 0xa3, 0x6b, 0x7e, 0x31, 0x7c, 0xd0, 0x91, 0xe9, - 0x3e, 0x4c, 0xba, 0x1f, 0x59, 0x75, 0x99, 0x85, 0x3c, 0xf4, 0xea, 0x32, 0x0b, 0x7d, 0x97, 0x35, - 0x82, 0x9a, 0x70, 0x2e, 0xe2, 0x99, 0x0d, 0xba, 0x32, 0xd8, 0x63, 0x24, 0xfe, 0xe5, 0x01, 0xdf, - 0xeb, 0x08, 0x23, 0x48, 0x87, 0xf3, 0x91, 0xaf, 0x4b, 0xd0, 0xea, 0xa0, 0x6f, 0x5f, 0xf8, 0xab, - 0x03, 0x60, 0x3a, 0x73, 0x76, 0x80, 0x8f, 0x6e, 0x69, 0xa3, 0xab, 0x03, 0xbf, 0xb5, 0xe0, 0xaf, - 0x0d, 0xde, 0x21, 0x17, 0x46, 0xd0, 0x16, 0xa4, 0x5c, 0xbd, 0x4d, 0xc4, 0x87, 0x36, 0x3c, 0x29, - 0xe3, 0x85, 0x1e, 0xcd, 0x50, 0xca, 0xc9, 0xd5, 0x6e, 0xea, 0x72, 0x0a, 0x36, 0xce, 0xba, 0x9c, - 0x42, 0xfa, 0x53, 0xfe, 0xed, 0xf7, 0xdd, 0xd1, 0x61, 0xdb, 0x1f, 0x7e, 0xc9, 0x87, 0x6d, 0x7f, - 0xc4, 0x85, 0x2f, 0x8c, 0xa0, 0xf7, 0x61, 0xda, 0x5b, 0x65, 0x46, 0x4b, 0x3d, 0xab, 0xe5, 0xfc, - 0x85, 0xa8, 0x61, 0x37, 0x4b, 0x6f, 0x51, 0xb3, 0xcb, 0x32, 0xb4, 0xb8, 0xda, 0x65, 0x19, 0x51, - 0x0b, 0x1d, 0xb1, 0xfc, 0x93, 0xa7, 0x54, 0xd7, 0xf5, 0x4f, 0x61, 0x15, 0xc6, 0xae, 0x7f, 0x0a, - 0xad, 0xef, 0x09, 0x23, 0x48, 0x81, 0xf9, 0xf0, 0x4a, 0x11, 0xba, 0x3c, 0x50, 0x21, 0x8c, 0xbf, - 0xd2, 0x0f, 0xcd, 0x99, 0xaa, 0x0e, 0x33, 0x21, 0xad, 0x67, 0x24, 0xf4, 0xec, 0x4b, 0xd3, 0x49, - 0x2e, 0x0d, 0xd0, 0xbb, 0x16, 0xac, 0x68, 0x63, 0xed, 0xcf, 0x49, 0x48, 0x90, 0x6b, 0xbf, 0x06, - 0x67, 0x7c, 0xe5, 0x00, 0x74, 0xa1, 0x77, 0x91, 0x84, 0x5f, 0x8e, 0x1c, 0x77, 0xd6, 0xf0, 0x04, - 0xce, 0x06, 0x12, 0x7c, 0xb4, 0xe2, 0xa6, 0x0b, 0x2b, 0x32, 0xf0, 0x17, 0x7b, 0x60, 0xf8, 0x79, - 0x7b, 0x7d, 0xdb, 0x4a, 0xbf, 0x0c, 0xd4, 0xcb, 0x3b, 0xca, 0x9f, 0x7d, 0x44, 0xa3, 0x2c, 0xbf, - 0x27, 0x13, 0xbc, 0x72, 0x85, 0xfa, 0xb0, 0x4b, 0x3d, 0x71, 0x9c, 0x19, 0x3e, 0x74, 0xc2, 0x3b, - 0x57, 0x02, 0x84, 0x3c, 0xc2, 0x85, 0x26, 0x6a, 0xbc, 0xd0, 0x0b, 0xc5, 0x61, 0xff, 0x08, 0xd2, - 0xfe, 0x7b, 0x1e, 0x2d, 0xf7, 0x09, 0x3b, 0xf8, 0x95, 0x68, 0x04, 0xff, 0xce, 0xf8, 0x9d, 0x8c, - 0x5f, 0xaa, 0x30, 0xf7, 0x72, 0xa9, 0x27, 0x8e, 0xdb, 0x2d, 0xba, 0x22, 0xdc, 0xae, 0x5b, 0x0c, - 0x46, 0xc3, 0x5d, 0xb7, 0x18, 0x12, 0x12, 0x0b, 0x23, 0xeb, 0x77, 0x01, 0xe4, 0x66, 0xfb, 0xa9, - 0x2c, 0x61, 0xb5, 0xd3, 0x42, 0x8b, 0x81, 0x06, 0x52, 0x51, 0xed, 0xb4, 0xb6, 0xdb, 0x56, 0xe2, - 0x64, 0x64, 0x7e, 0x36, 0x4e, 0xd2, 0xa5, 0x09, 0x42, 0x60, 0x0d, 0xac, 0x97, 0x21, 0xdd, 0xa5, - 0x96, 0x48, 0x08, 0x85, 0x2e, 0x86, 0xf2, 0x20, 0xbd, 0x76, 0x1f, 0xa3, 0x69, 0x87, 0x11, 0x19, - 0x5d, 0x7f, 0x0b, 0xa0, 0x6e, 0x28, 0x12, 0x8d, 0xe1, 0xd0, 0x52, 0x80, 0xcf, 0x3d, 0x05, 0x37, - 0x1b, 0x36, 0x8f, 0x9f, 0x32, 0x61, 0xea, 0x86, 0x42, 0x23, 0xbd, 0xf5, 0x77, 0x20, 0x45, 0x85, - 0xd9, 0xb7, 0xf0, 0xfa, 0xd1, 0x33, 0x19, 0xe8, 0xea, 0xc9, 0xc8, 0x7a, 0x11, 0xa6, 0x28, 0x03, - 0x96, 0xf4, 0xa1, 0xe5, 0x00, 0x8b, 0x07, 0x74, 0xc4, 0xc7, 0x64, 0x92, 0x90, 0xb1, 0xb1, 0xf5, - 0x3c, 0x4c, 0xda, 0x6c, 0xcc, 0xa7, 0x5a, 0x03, 0x5d, 0x08, 0xe1, 0x62, 0x0d, 0xf8, 0x98, 0xa4, - 0x18, 0x13, 0x6b, 0xa8, 0x2b, 0x8a, 0xfd, 0xef, 0x98, 0x41, 0x51, 0x58, 0x62, 0x16, 0x2a, 0x0a, - 0x1b, 0xcb, 0x27, 0x9f, 0xc4, 0xeb, 0x86, 0xb2, 0x37, 0x4a, 0x88, 0x5e, 0xff, 0x67, 0x00, 0x00, - 0x00, 0xff, 0xff, 0x2d, 0xf6, 0x06, 0x63, 0x3b, 0x3c, 0x00, 0x00, + // 3755 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xe4, 0x3b, 0x4b, 0x6c, 0x1c, 0x47, + 0x76, 0xec, 0xf9, 0x91, 0x7c, 0x43, 0x52, 0xa3, 0xe2, 0x47, 0xa3, 0x26, 0x29, 0x52, 0x2d, 0x4b, + 0xa6, 0x64, 0x69, 0x64, 0xd3, 0x96, 0x10, 0x53, 0xf2, 0x67, 0x66, 0x38, 0x22, 0xc7, 0x1a, 0x0d, + 0xe9, 0x9e, 0xa1, 0x64, 0x29, 0x31, 0xda, 0xcd, 0x99, 0x22, 0xd5, 0xf0, 0x4c, 0xf7, 0xb8, 0xbb, + 0x87, 0x21, 0x7d, 0x49, 0x90, 0x20, 0x87, 0x20, 0x97, 0x1c, 0x02, 0xd8, 0xb9, 0x19, 0x49, 0x8e, + 0x31, 0x8c, 0x20, 0x08, 0x72, 0x0c, 0x90, 0xe3, 0x02, 0xfb, 0xb9, 0xad, 0xb1, 0x17, 0xdf, 0x16, + 0x0b, 0x63, 0x17, 0xf0, 0x5e, 0xf7, 0xb0, 0x58, 0x74, 0x55, 0x75, 0x4f, 0x7f, 0xe7, 0x23, 0x52, + 0xf0, 0x61, 0x4f, 0x9c, 0x7e, 0xf5, 0xde, 0xab, 0x57, 0x55, 0xef, 0xbd, 0x7a, 0x9f, 0x22, 0xdc, + 0x39, 0x54, 0xcc, 0xe7, 0xdd, 0xfd, 0x5c, 0x43, 0x6b, 0xdf, 0x6e, 0x68, 0xaa, 0x29, 0x2b, 0x2a, + 0xd6, 0x6f, 0x19, 0xa6, 0xa6, 0xcb, 0x87, 0xf8, 0x96, 0xa2, 0x9a, 0x58, 0x3f, 0x90, 0x1b, 0xf8, + 0xb6, 0xd1, 0xc1, 0x8d, 0xdb, 0x0d, 0x43, 0xc9, 0x75, 0x74, 0xcd, 0xd4, 0x50, 0xca, 0xfa, 0x79, + 0xf4, 0x06, 0xbf, 0x7a, 0xa8, 0x69, 0x87, 0x2d, 0x7c, 0x9b, 0x40, 0xf7, 0xbb, 0x07, 0xb7, 0x9b, + 0xd8, 0x68, 0xe8, 0x4a, 0xc7, 0xd4, 0x74, 0x8a, 0xc9, 0xaf, 0xf8, 0x31, 0x4c, 0xa5, 0x8d, 0x0d, + 0x53, 0x6e, 0x77, 0x18, 0xc2, 0x25, 0x3f, 0xc2, 0x5f, 0xeb, 0x72, 0xa7, 0x83, 0x75, 0x83, 0x8e, + 0x0b, 0x0b, 0x30, 0xb7, 0x85, 0xcd, 0xdd, 0x56, 0xf7, 0x50, 0x51, 0xcb, 0xea, 0x81, 0x26, 0xe2, + 0xcf, 0xba, 0xd8, 0x30, 0x85, 0x6f, 0x39, 0x98, 0xf7, 0x0d, 0x18, 0x1d, 0x4d, 0x35, 0x30, 0x42, + 0x90, 0x50, 0xe5, 0x36, 0xce, 0x72, 0xab, 0xdc, 0xda, 0xa4, 0x48, 0x7e, 0xa3, 0xab, 0x30, 0x73, + 0x84, 0xd5, 0xa6, 0xa6, 0x4b, 0x47, 0x58, 0x37, 0x14, 0x4d, 0xcd, 0xc6, 0xc8, 0xe8, 0x34, 0x85, + 0x3e, 0xa6, 0x40, 0xb4, 0x05, 0x13, 0x6d, 0x59, 0x55, 0x0e, 0xb0, 0x61, 0x66, 0xe3, 0xab, 0xf1, + 0xb5, 0xf4, 0xfa, 0x6b, 0x39, 0xba, 0xd4, 0x5c, 0xe8, 0x5c, 0xb9, 0x47, 0x0c, 0xbb, 0xa4, 0x9a, + 0xfa, 0x89, 0xe8, 0x10, 0xf3, 0xf7, 0x60, 0xda, 0x33, 0x84, 0x32, 0x10, 0xff, 0x14, 0x9f, 0x30, + 0x99, 0xac, 0x9f, 0x68, 0x0e, 0x92, 0x47, 0x72, 0xab, 0x8b, 0x99, 0x24, 0xf4, 0x63, 0x23, 0xf6, + 0x17, 0x9c, 0x70, 0x09, 0x96, 0x9c, 0xd9, 0x8a, 0x72, 0x47, 0xde, 0x57, 0x5a, 0x8a, 0xa9, 0x60, + 0xc3, 0x5e, 0xfa, 0xc7, 0xb0, 0x1c, 0x31, 0xce, 0x76, 0xe0, 0x3e, 0x4c, 0x35, 0x5c, 0xf0, 0x2c, + 0x47, 0x96, 0x92, 0xb5, 0x97, 0xe2, 0xa3, 0x3c, 0x11, 0x3d, 0xd8, 0xc2, 0xcf, 0xe2, 0x90, 0xf1, + 0xa3, 0xa0, 0xfb, 0x30, 0x6e, 0x60, 0xfd, 0x48, 0x69, 0xd0, 0x7d, 0x4d, 0xaf, 0xaf, 0x46, 0x71, + 0xcb, 0xd5, 0x28, 0xde, 0xf6, 0x98, 0x68, 0x93, 0xa0, 0x3d, 0xc8, 0x1c, 0x69, 0xad, 0x6e, 0x1b, + 0x4b, 0xf8, 0xb8, 0x23, 0xab, 0xce, 0x01, 0xa4, 0xd7, 0xd7, 0x22, 0xd9, 0x3c, 0x26, 0x04, 0x25, + 0x1b, 0x7f, 0x7b, 0x4c, 0x3c, 0x77, 0xe4, 0x05, 0xf1, 0x5f, 0x70, 0x30, 0xce, 0x66, 0x43, 0x6f, + 0x43, 0xc2, 0x3c, 0xe9, 0x50, 0xe9, 0x66, 0xd6, 0xaf, 0x0e, 0x92, 0x2e, 0x57, 0x3f, 0xe9, 0x60, + 0x91, 0x90, 0x08, 0x1f, 0x42, 0xc2, 0xfa, 0x42, 0x69, 0x18, 0xdf, 0xab, 0x3e, 0xac, 0xee, 0x3c, + 0xa9, 0x66, 0xc6, 0xd0, 0x02, 0xa0, 0xe2, 0x4e, 0xb5, 0x2e, 0xee, 0x54, 0x2a, 0x25, 0x51, 0xaa, + 0x95, 0xc4, 0xc7, 0xe5, 0x62, 0x29, 0xc3, 0xa1, 0x57, 0x60, 0xf5, 0xf1, 0x4e, 0x65, 0xef, 0x51, + 0x49, 0xca, 0x17, 0x8b, 0xa5, 0x5a, 0xad, 0x5c, 0x28, 0x57, 0xca, 0xf5, 0xa7, 0x52, 0x71, 0xa7, + 0x5a, 0xab, 0x8b, 0xf9, 0x72, 0xb5, 0x5e, 0xcb, 0xc4, 0xf8, 0xbf, 0xe3, 0xe0, 0x9c, 0x6f, 0x01, + 0x28, 0xef, 0x91, 0xf0, 0xd6, 0xb0, 0x0b, 0x77, 0x4b, 0x7a, 0x33, 0x4c, 0x52, 0x80, 0xd4, 0x4e, + 0xb5, 0x52, 0xae, 0x5a, 0xd2, 0xa5, 0x61, 0x7c, 0xe7, 0xc1, 0x03, 0xf2, 0x11, 0x2b, 0xa4, 0xe8, + 0x84, 0xc2, 0x0c, 0x4c, 0xed, 0xea, 0xda, 0x3e, 0xb6, 0xf5, 0x27, 0x0f, 0xd3, 0xec, 0x9b, 0xe9, + 0xcb, 0xeb, 0x90, 0xd4, 0xb1, 0xdc, 0x3c, 0x61, 0x47, 0xcb, 0xe7, 0xa8, 0x4d, 0xe6, 0x6c, 0x9b, + 0xcc, 0x15, 0x34, 0xad, 0xf5, 0xd8, 0xd2, 0x4f, 0x91, 0x22, 0x0a, 0x3f, 0x24, 0x60, 0xb6, 0xa8, + 0x63, 0xd9, 0xc4, 0x54, 0x5a, 0xc6, 0x3a, 0xd4, 0xf6, 0xee, 0xc3, 0x8c, 0xa5, 0x5f, 0x0d, 0xc5, + 0x3c, 0x91, 0x74, 0x59, 0x3d, 0xc4, 0xec, 0xe8, 0xe7, 0xed, 0x1d, 0x28, 0xb2, 0x51, 0xd1, 0x1a, + 0x14, 0xa7, 0x1b, 0xee, 0x4f, 0x54, 0x86, 0x59, 0xa6, 0x3a, 0x1e, 0x95, 0x8e, 0x7b, 0x55, 0x9a, + 0x4a, 0xe1, 0x52, 0x69, 0x74, 0xe4, 0x85, 0x28, 0xd8, 0x40, 0x0f, 0x01, 0x3a, 0xb2, 0x2e, 0xb7, + 0xb1, 0x89, 0x75, 0x23, 0x9b, 0xf0, 0xda, 0x77, 0xc8, 0x6a, 0x72, 0xbb, 0x0e, 0x36, 0xb5, 0x6f, + 0x17, 0x39, 0xda, 0xb2, 0x0c, 0xa2, 0xa1, 0x63, 0xd3, 0xc8, 0x26, 0x09, 0xa7, 0xb5, 0x7e, 0x9c, + 0x6a, 0x14, 0x95, 0xb0, 0x29, 0xc4, 0xbf, 0x2c, 0x70, 0xa2, 0x4d, 0x8d, 0x76, 0x60, 0xde, 0x5e, + 0xa0, 0xa6, 0x9a, 0x58, 0x35, 0x25, 0x43, 0xeb, 0xea, 0x0d, 0x9c, 0x4d, 0x91, 0x5d, 0x5a, 0xf4, + 0x2d, 0x91, 0xe2, 0xd4, 0x08, 0x8a, 0xc8, 0xb6, 0xc6, 0x03, 0x44, 0xcf, 0x80, 0x97, 0x1b, 0x0d, + 0x6c, 0x18, 0x0a, 0xdd, 0x0b, 0x49, 0xc7, 0x9f, 0x75, 0x15, 0x1d, 0xb7, 0xb1, 0x6a, 0x1a, 0xd9, + 0x71, 0x2f, 0xd7, 0xba, 0xd6, 0xd1, 0x5a, 0xda, 0xe1, 0x89, 0xd8, 0xc3, 0x11, 0x2f, 0x7a, 0xc8, + 0x5d, 0x23, 0x06, 0xff, 0x0e, 0x9c, 0xf3, 0x6d, 0xca, 0x28, 0x9e, 0x8d, 0xdf, 0x80, 0x29, 0xf7, + 0x4e, 0x8c, 0xe4, 0x15, 0xff, 0x29, 0x06, 0xb3, 0x21, 0x7b, 0x80, 0xb6, 0x61, 0xc2, 0x50, 0xe5, + 0x8e, 0xf1, 0x5c, 0x33, 0x99, 0xfe, 0xde, 0xe8, 0xb3, 0x65, 0xb9, 0x1a, 0xc3, 0xa5, 0x9f, 0xdb, + 0x63, 0xa2, 0x43, 0x8d, 0x0a, 0x90, 0xa2, 0xfb, 0xe9, 0xf7, 0x4d, 0x61, 0x7c, 0x28, 0xcc, 0xe1, + 0xc2, 0x28, 0xf9, 0x37, 0x60, 0xc6, 0x3b, 0x03, 0x5a, 0x81, 0xb4, 0x3d, 0x83, 0xa4, 0x34, 0xd9, + 0x5a, 0xc1, 0x06, 0x95, 0x9b, 0xfc, 0x6b, 0x30, 0xe5, 0x66, 0x86, 0x16, 0x61, 0x92, 0x29, 0x84, + 0x83, 0x3e, 0x41, 0x01, 0xe5, 0xa6, 0x63, 0xd3, 0xef, 0xc2, 0x9c, 0x57, 0xcf, 0x98, 0x29, 0x5f, + 0x73, 0xd6, 0x40, 0xf7, 0x62, 0xc6, 0xbb, 0x06, 0x5b, 0x4e, 0xe1, 0xf7, 0x09, 0xc8, 0xf8, 0x8d, + 0x06, 0xdd, 0x87, 0xe4, 0x7e, 0x4b, 0x6b, 0x7c, 0xca, 0x68, 0x5f, 0x89, 0xb2, 0xae, 0x5c, 0xc1, + 0xc2, 0xa2, 0xd0, 0xed, 0x31, 0x91, 0x12, 0x59, 0xd4, 0x6d, 0xad, 0xab, 0x9a, 0x6c, 0xf7, 0xa2, + 0xa9, 0x1f, 0x59, 0x58, 0x3d, 0x6a, 0x42, 0x84, 0x36, 0x21, 0x4d, 0xd5, 0x4e, 0x6a, 0x6b, 0x4d, + 0x9c, 0x8d, 0x13, 0x1e, 0x57, 0x22, 0x79, 0xe4, 0x09, 0xee, 0x23, 0xad, 0x89, 0x45, 0x90, 0x9d, + 0xdf, 0xfc, 0x34, 0xa4, 0x5d, 0xb2, 0xf1, 0x5b, 0x90, 0x76, 0x4d, 0x86, 0x2e, 0xc0, 0xf8, 0x81, + 0x21, 0x39, 0x4e, 0x78, 0x52, 0x4c, 0x1d, 0x18, 0xc4, 0x9f, 0xae, 0x40, 0x9a, 0x48, 0x21, 0x1d, + 0xb4, 0xe4, 0x43, 0x23, 0x1b, 0x5b, 0x8d, 0x5b, 0x67, 0x44, 0x40, 0x0f, 0x2c, 0x08, 0xff, 0xdf, + 0x31, 0x80, 0xde, 0x94, 0xe8, 0x3e, 0x24, 0x88, 0x94, 0xd4, 0x95, 0xaf, 0x0d, 0x21, 0x65, 0x8e, + 0x88, 0x4a, 0xa8, 0x84, 0x5f, 0x73, 0x90, 0x20, 0x6c, 0xfc, 0x17, 0x4e, 0xad, 0x5c, 0xdd, 0xaa, + 0x94, 0xa4, 0xea, 0xce, 0x66, 0x49, 0x7a, 0x22, 0x96, 0xeb, 0x25, 0x31, 0xc3, 0xa1, 0x45, 0xb8, + 0xe0, 0x86, 0x8b, 0xa5, 0xfc, 0x66, 0x49, 0x94, 0x76, 0xaa, 0x95, 0xa7, 0x99, 0x18, 0xe2, 0x61, + 0xe1, 0xd1, 0x5e, 0xa5, 0x5e, 0x0e, 0x8e, 0xc5, 0xd1, 0x12, 0x64, 0x5d, 0x63, 0x8c, 0x07, 0x63, + 0x9b, 0xb0, 0xd8, 0xba, 0x46, 0xe9, 0x4f, 0x36, 0x98, 0x44, 0x02, 0x5c, 0x74, 0xcf, 0xe9, 0xa5, + 0x4d, 0xf1, 0xf1, 0xaf, 0x0a, 0x1c, 0xba, 0x0c, 0x59, 0x37, 0x8e, 0x87, 0xc3, 0x38, 0x41, 0x29, + 0x4c, 0x3b, 0x67, 0x4a, 0x74, 0xf6, 0x09, 0x4c, 0x7b, 0x5c, 0xbd, 0x15, 0x95, 0x31, 0xdf, 0xd4, + 0x94, 0xf6, 0x4f, 0x4c, 0x12, 0xa9, 0x70, 0x6b, 0x71, 0x71, 0xda, 0x86, 0x16, 0x2c, 0xa0, 0x75, + 0x3a, 0x2d, 0xa5, 0xad, 0x98, 0x0c, 0x27, 0x46, 0x70, 0x80, 0x80, 0x08, 0x82, 0xf0, 0x5d, 0x0c, + 0x52, 0xec, 0x88, 0xaf, 0xba, 0x2e, 0x1b, 0x0f, 0x4b, 0x1b, 0x4a, 0x59, 0x7a, 0x6c, 0x2c, 0xe6, + 0xb5, 0x31, 0xb4, 0x0d, 0x33, 0x6e, 0x8f, 0x7c, 0x6c, 0xc7, 0x82, 0x97, 0xbd, 0xe7, 0xec, 0x76, + 0x0b, 0xc7, 0x2c, 0x02, 0x9c, 0x3e, 0x72, 0xc3, 0x50, 0x01, 0x66, 0x7c, 0x4e, 0x3d, 0x31, 0xd8, + 0xa9, 0x4f, 0x37, 0x3c, 0xfe, 0x2d, 0x0f, 0xb3, 0xb6, 0x3f, 0x6e, 0x61, 0xc9, 0x64, 0xfe, 0x9a, + 0x5d, 0x3a, 0x99, 0x80, 0x1f, 0x47, 0x3d, 0x64, 0x1b, 0xc6, 0xbf, 0x0f, 0x28, 0x28, 0xeb, 0x48, + 0xce, 0xb7, 0x0b, 0xb3, 0x21, 0x37, 0x05, 0xca, 0xc1, 0x24, 0x39, 0x2a, 0x43, 0x31, 0x31, 0x8b, + 0x32, 0x83, 0x12, 0xf5, 0x50, 0x2c, 0xfc, 0x8e, 0x8e, 0x0f, 0xb0, 0xae, 0xe3, 0x26, 0xb1, 0xb2, + 0x50, 0x7c, 0x07, 0x45, 0xf8, 0x7b, 0x0e, 0x26, 0x6c, 0x38, 0xda, 0x80, 0x09, 0x03, 0x1f, 0xd2, + 0x5b, 0x8c, 0xce, 0x75, 0xc9, 0x4f, 0x9b, 0xab, 0x31, 0x04, 0x16, 0x8f, 0xdb, 0xf8, 0x56, 0x3c, + 0xee, 0x19, 0x1a, 0x69, 0xf1, 0xff, 0xcb, 0xc1, 0xec, 0x26, 0x6e, 0x61, 0x7f, 0xb0, 0xd3, 0xcf, + 0x51, 0xbb, 0xe3, 0x83, 0x98, 0x37, 0x3e, 0x08, 0x61, 0xd5, 0x27, 0x3e, 0x38, 0xd5, 0x9d, 0xb9, + 0x00, 0x73, 0xde, 0xd9, 0xe8, 0x2d, 0x21, 0xfc, 0x2e, 0x0e, 0x97, 0x2c, 0x5d, 0xd0, 0xb5, 0x56, + 0x0b, 0xeb, 0xbb, 0xdd, 0xfd, 0x96, 0x62, 0x3c, 0x1f, 0x61, 0x71, 0x17, 0x60, 0x5c, 0xd5, 0x9a, + 0x2e, 0xe3, 0x49, 0x59, 0x9f, 0xe5, 0x26, 0x2a, 0xc1, 0x79, 0x7f, 0xb4, 0x76, 0xc2, 0x7c, 0x79, + 0x74, 0xac, 0x96, 0x39, 0xf2, 0x5f, 0x44, 0x3c, 0x4c, 0x58, 0x71, 0xa6, 0xa6, 0xb6, 0x4e, 0x88, + 0xc5, 0x4c, 0x88, 0xce, 0x37, 0x12, 0xfd, 0x81, 0xd7, 0x9b, 0x4e, 0xe0, 0xd5, 0x77, 0x45, 0xfd, + 0x62, 0xb0, 0x4f, 0x02, 0x16, 0x9f, 0x22, 0xac, 0xdf, 0x1e, 0x92, 0xf5, 0x40, 0x4f, 0x70, 0x9a, + 0x53, 0x3c, 0x03, 0xf3, 0xfd, 0x09, 0x07, 0x2b, 0x91, 0x4b, 0x60, 0x91, 0x43, 0x13, 0xce, 0x75, + 0xe8, 0x80, 0xb3, 0x09, 0xd4, 0xca, 0xee, 0x0d, 0xdc, 0x04, 0x96, 0x0c, 0x33, 0xa8, 0x67, 0x1b, + 0x66, 0x3a, 0x1e, 0x20, 0x9f, 0x87, 0xd9, 0x10, 0xb4, 0x91, 0x16, 0xf3, 0x3d, 0x07, 0xab, 0x3d, + 0x51, 0xf6, 0xd4, 0xce, 0xd9, 0xa9, 0x6f, 0xbd, 0xa7, 0x5b, 0xd4, 0xe5, 0xdf, 0x09, 0xae, 0x3d, + 0x7c, 0xc2, 0x97, 0x65, 0xc1, 0x57, 0xe0, 0x72, 0x9f, 0xa9, 0x99, 0x39, 0x7f, 0x97, 0x80, 0xcb, + 0x8f, 0xe5, 0x96, 0xd2, 0x74, 0xe2, 0xc1, 0x90, 0xb2, 0x41, 0xff, 0x2d, 0x69, 0x04, 0x2c, 0x80, + 0x7a, 0xad, 0xfb, 0x8e, 0xd5, 0x0e, 0xe2, 0x3f, 0xc4, 0x75, 0x78, 0x86, 0xb9, 0xdc, 0xd3, 0x90, + 0x5c, 0xee, 0xed, 0xe1, 0x65, 0xed, 0x97, 0xd9, 0xed, 0xf9, 0x1d, 0xcc, 0xdd, 0xe1, 0xf9, 0xf6, + 0xd1, 0x82, 0x53, 0x5b, 0xf1, 0x8f, 0x99, 0x7c, 0xfd, 0x7f, 0x02, 0x84, 0x7e, 0xab, 0x67, 0x3e, + 0x44, 0x84, 0xc9, 0x86, 0xa6, 0x1e, 0x28, 0x7a, 0x1b, 0x37, 0x59, 0x12, 0xf1, 0xd6, 0x30, 0x9b, + 0xc7, 0x1c, 0x48, 0xd1, 0xa6, 0x15, 0x7b, 0x6c, 0x50, 0x16, 0xc6, 0xdb, 0xd8, 0x30, 0xe4, 0x43, + 0x5b, 0x2c, 0xfb, 0x93, 0xff, 0x3a, 0x0e, 0x93, 0x0e, 0x09, 0x52, 0x03, 0x1a, 0x4c, 0xdd, 0xd7, + 0xd6, 0x8b, 0x08, 0xf0, 0xe2, 0xca, 0x1c, 0x7b, 0x01, 0x65, 0x6e, 0x7a, 0x94, 0x99, 0x9a, 0xc3, + 0xe6, 0x0b, 0x89, 0xdd, 0x47, 0xaf, 0x7f, 0x74, 0x05, 0x14, 0xfe, 0x0a, 0x50, 0x45, 0x31, 0x58, + 0x32, 0xe6, 0xb8, 0x25, 0x2b, 0xf7, 0x92, 0x8f, 0x25, 0xac, 0x9a, 0xba, 0xc2, 0xc2, 0xf5, 0xa4, + 0x08, 0x6d, 0xf9, 0xb8, 0x44, 0x21, 0x56, 0x48, 0x6f, 0x98, 0xb2, 0x6e, 0x2a, 0xea, 0xa1, 0x64, + 0x6a, 0x9f, 0x62, 0xa7, 0x76, 0x6b, 0x43, 0xeb, 0x16, 0x50, 0xf8, 0x6d, 0x0c, 0x66, 0x3d, 0xec, + 0x99, 0x4e, 0xde, 0x83, 0xf1, 0x1e, 0x6f, 0x4f, 0x18, 0x1f, 0x82, 0x9d, 0xa3, 0xdb, 0x66, 0x53, + 0xa0, 0x65, 0x00, 0x15, 0x1f, 0x9b, 0x9e, 0x79, 0x27, 0x2d, 0x08, 0x99, 0x93, 0xff, 0x07, 0xce, + 0xc9, 0xdd, 0x4d, 0xd9, 0xec, 0x1a, 0xe8, 0x26, 0x20, 0xe6, 0xa2, 0x71, 0x53, 0x62, 0x77, 0x0c, + 0x9d, 0x77, 0x52, 0xcc, 0x38, 0x23, 0x55, 0x72, 0xdb, 0x18, 0x68, 0xcb, 0x29, 0x8b, 0x36, 0x34, + 0xb5, 0xa9, 0x98, 0xbd, 0xb2, 0xe8, 0x85, 0x40, 0x82, 0x40, 0x87, 0x0b, 0x56, 0x5e, 0x65, 0x17, + 0x42, 0x1d, 0x28, 0xff, 0x19, 0x24, 0xe9, 0x71, 0x0c, 0x99, 0xfe, 0xa3, 0xf7, 0x21, 0x65, 0x10, + 0x89, 0xfd, 0xa5, 0x8e, 0xb0, 0x3d, 0x71, 0xaf, 0x50, 0x64, 0x74, 0xc2, 0xbb, 0xc0, 0xf7, 0x2e, + 0xa6, 0x2d, 0x6c, 0x0e, 0x7f, 0xfd, 0x6e, 0x58, 0x6b, 0x10, 0xbe, 0x88, 0xc1, 0x62, 0x28, 0x83, + 0xd1, 0x0a, 0x19, 0x68, 0xdb, 0xb7, 0x92, 0xd7, 0x83, 0x37, 0x76, 0x80, 0x79, 0xe8, 0x8a, 0xf8, + 0xbf, 0x3d, 0xdd, 0x61, 0x16, 0x46, 0x3e, 0xcc, 0xc0, 0x39, 0xd2, 0x9d, 0xf9, 0x3a, 0x06, 0x68, + 0x0b, 0x9b, 0x4e, 0xaa, 0xcc, 0xb6, 0x34, 0xc2, 0xdf, 0x70, 0x2f, 0xe0, 0x6f, 0x3e, 0xf0, 0xf8, + 0x1b, 0xea, 0xb1, 0x6e, 0xb8, 0x1a, 0x1d, 0xbe, 0xa9, 0xfb, 0xde, 0x96, 0x11, 0xe9, 0x29, 0x8d, + 0xf9, 0x87, 0x4b, 0x4f, 0x4f, 0xe9, 0x56, 0x7e, 0xc3, 0xc1, 0xac, 0x47, 0x68, 0xa6, 0x41, 0xb7, + 0x00, 0xc9, 0x47, 0xb2, 0xd2, 0x92, 0x2d, 0xc1, 0xec, 0xf4, 0x9f, 0x95, 0x03, 0xce, 0x3b, 0x23, + 0x36, 0x19, 0xda, 0x85, 0xd9, 0xb6, 0x7c, 0xac, 0xb4, 0xbb, 0x6d, 0x89, 0xed, 0xb3, 0xa1, 0x7c, + 0x6e, 0x97, 0x02, 0x17, 0x03, 0x25, 0xf1, 0xb2, 0x6a, 0xde, 0x7d, 0x8b, 0xd4, 0xc4, 0xa9, 0x4d, + 0x9e, 0x67, 0xc4, 0x4c, 0x83, 0x94, 0xcf, 0x31, 0xe1, 0xa8, 0xa8, 0x01, 0x8e, 0xf1, 0xa1, 0x39, + 0x52, 0xe2, 0x1e, 0x47, 0x41, 0x70, 0x47, 0xbe, 0x6c, 0xcd, 0xfe, 0xee, 0x50, 0xcb, 0x1d, 0x31, + 0x06, 0x70, 0xd8, 0xde, 0x6c, 0x85, 0x76, 0x88, 0xae, 0x04, 0x6d, 0x87, 0xb5, 0x4b, 0x22, 0x9b, + 0x45, 0x7f, 0x8c, 0xbb, 0xcd, 0x38, 0x80, 0x8d, 0xee, 0x41, 0x5c, 0xef, 0x34, 0x98, 0x0d, 0xbf, + 0x3a, 0x04, 0xff, 0x9c, 0xb8, 0x5b, 0xdc, 0x1e, 0x13, 0x2d, 0x2a, 0xfe, 0x5f, 0xe3, 0x10, 0x17, + 0x77, 0x8b, 0xe8, 0x7d, 0x4f, 0xe7, 0xe4, 0xe6, 0x90, 0x5c, 0xdc, 0x8d, 0x93, 0x9f, 0xc7, 0xc2, + 0x3a, 0x27, 0x59, 0x98, 0x2b, 0x8a, 0xa5, 0x7c, 0xbd, 0x24, 0x6d, 0x96, 0x2a, 0xa5, 0x7a, 0x49, + 0xa2, 0x9d, 0x9d, 0x0c, 0x87, 0x96, 0x20, 0xbb, 0xbb, 0x57, 0xa8, 0x94, 0x6b, 0xdb, 0xd2, 0x5e, + 0xd5, 0xfe, 0xc5, 0x46, 0x63, 0x28, 0x03, 0x53, 0x95, 0x72, 0xad, 0xce, 0x00, 0xb5, 0x4c, 0xdc, + 0x82, 0x6c, 0x95, 0xea, 0x52, 0x31, 0xbf, 0x9b, 0x2f, 0x96, 0xeb, 0x4f, 0x33, 0x09, 0xc4, 0xc3, + 0x82, 0x97, 0x77, 0xad, 0x9a, 0xdf, 0xad, 0x6d, 0xef, 0xd4, 0x33, 0x49, 0x84, 0x60, 0x86, 0xd0, + 0xdb, 0xa0, 0x5a, 0x26, 0x65, 0x71, 0x28, 0x56, 0x76, 0xaa, 0x8e, 0x0c, 0xe3, 0x68, 0x0e, 0x32, + 0xf6, 0xcc, 0x62, 0x29, 0xbf, 0x49, 0xaa, 0x7a, 0x13, 0xe8, 0x3c, 0x4c, 0x97, 0x3e, 0xda, 0xcd, + 0x57, 0x37, 0x6d, 0xc4, 0x49, 0xb4, 0x0a, 0x4b, 0x6e, 0x71, 0x24, 0x46, 0x55, 0xda, 0x24, 0x95, + 0xb9, 0x5a, 0x06, 0xd0, 0x45, 0xc8, 0xb0, 0xa6, 0x55, 0x71, 0xa7, 0xba, 0x59, 0xae, 0x97, 0x77, + 0xaa, 0x99, 0x34, 0x2d, 0xe3, 0xcd, 0x02, 0x58, 0x92, 0x33, 0x66, 0x53, 0x83, 0x6b, 0x7b, 0xd3, + 0xb4, 0xb6, 0x67, 0x17, 0xa2, 0xbf, 0x8f, 0xc1, 0x3c, 0xad, 0x44, 0xdb, 0x75, 0x6f, 0xdb, 0x61, + 0xad, 0x41, 0x86, 0x16, 0xbd, 0x24, 0xff, 0x55, 0x30, 0x43, 0xe1, 0x8f, 0xed, 0xe4, 0xc3, 0xee, + 0x1a, 0xc5, 0x5c, 0x5d, 0xa3, 0xb2, 0x3f, 0x15, 0xbb, 0xe1, 0xed, 0xaf, 0xf8, 0x66, 0xeb, 0x97, + 0xdd, 0x3f, 0x0a, 0xc9, 0x15, 0x6e, 0xf5, 0xe7, 0xd6, 0x2f, 0x8e, 0x3a, 0x4d, 0x2a, 0x7f, 0x4a, + 0x57, 0xf7, 0x00, 0x16, 0xfc, 0xf2, 0x32, 0x83, 0xbe, 0x19, 0xe8, 0x82, 0x38, 0xbe, 0xd7, 0xc1, + 0x75, 0x30, 0x84, 0x5f, 0x72, 0x30, 0x61, 0x83, 0xad, 0x18, 0xc7, 0xf2, 0x4b, 0x9e, 0x72, 0xe9, + 0xa4, 0x05, 0x71, 0xaa, 0xaf, 0xee, 0xfe, 0x45, 0xcc, 0xdf, 0xbf, 0x08, 0x3d, 0xe7, 0x78, 0xe8, + 0x39, 0xbf, 0x07, 0xd3, 0x0d, 0x4b, 0x7c, 0x45, 0x53, 0x25, 0x53, 0x69, 0xdb, 0xd5, 0xd0, 0x60, + 0xbf, 0xb1, 0x6e, 0x3f, 0x12, 0x10, 0xa7, 0x6c, 0x02, 0x0b, 0x84, 0x56, 0x61, 0x8a, 0xf4, 0x1f, + 0x25, 0x53, 0x93, 0xba, 0x06, 0xce, 0x26, 0x49, 0x6d, 0x08, 0x08, 0xac, 0xae, 0xed, 0x19, 0x58, + 0xf8, 0x3f, 0x0e, 0xe6, 0x69, 0xc9, 0xcb, 0xaf, 0x8e, 0x83, 0xfa, 0x30, 0x6e, 0x8d, 0xf3, 0x5d, + 0x89, 0xa1, 0x0c, 0x5f, 0x56, 0xc6, 0x9f, 0x85, 0x05, 0xff, 0x7c, 0x2c, 0xcd, 0xff, 0x26, 0x06, + 0x73, 0x56, 0x7c, 0x66, 0x0f, 0x9c, 0x75, 0x08, 0x3d, 0xc2, 0x49, 0xfa, 0x36, 0x33, 0x11, 0xd8, + 0xcc, 0x6d, 0x7f, 0x12, 0x7d, 0xdd, 0x1d, 0x61, 0xfa, 0x57, 0xf0, 0xb2, 0xf6, 0xf2, 0x3f, 0x39, + 0x98, 0xf7, 0xcd, 0xc7, 0xec, 0xe5, 0x1d, 0x7f, 0x56, 0x70, 0x25, 0x42, 0xbe, 0x17, 0xca, 0x0b, + 0xee, 0xd8, 0xf1, 0xf8, 0x68, 0x66, 0xf9, 0x8b, 0x18, 0x2c, 0xf7, 0x2e, 0x35, 0xf2, 0x02, 0xa0, + 0x39, 0x42, 0x59, 0xeb, 0x74, 0x8d, 0xf6, 0x0f, 0xfd, 0x0e, 0x77, 0x3d, 0x78, 0xcf, 0x86, 0x88, + 0xd4, 0xcf, 0xf1, 0x86, 0x56, 0x83, 0x13, 0xa3, 0x56, 0x83, 0x4f, 0xa5, 0x01, 0x7f, 0xe3, 0x2e, + 0x74, 0x7b, 0xc5, 0x67, 0x9a, 0x30, 0x64, 0xc7, 0xe8, 0x2e, 0x5c, 0x20, 0x29, 0x80, 0xf3, 0x80, + 0xc5, 0x6e, 0xab, 0x53, 0x97, 0x38, 0x21, 0xce, 0x5b, 0xc3, 0xce, 0xab, 0x0d, 0xd6, 0x25, 0x69, + 0x0a, 0x3f, 0x24, 0x60, 0xc1, 0x4a, 0x11, 0x6a, 0xa6, 0x7c, 0x38, 0x4a, 0xff, 0xe0, 0x2f, 0x83, + 0xe5, 0xd8, 0x98, 0xf7, 0x58, 0xc2, 0xb9, 0x0e, 0x53, 0x85, 0x45, 0x39, 0x98, 0x35, 0x4c, 0xf9, + 0x90, 0xb8, 0x03, 0x59, 0x3f, 0xc4, 0xa6, 0xd4, 0x91, 0xcd, 0xe7, 0xcc, 0xd6, 0xcf, 0xb3, 0xa1, + 0x3a, 0x19, 0xd9, 0x95, 0xcd, 0xe7, 0x67, 0x74, 0x90, 0xe8, 0x03, 0xbf, 0x53, 0x78, 0x6d, 0xc0, + 0x5a, 0xfa, 0xe8, 0xd6, 0x47, 0x11, 0x25, 0xfb, 0x37, 0x06, 0xb0, 0x1c, 0x5c, 0xaa, 0x3f, 0x7d, + 0x89, 0xfa, 0x47, 0xae, 0xf6, 0x5f, 0x84, 0x0b, 0x81, 0xc5, 0xb3, 0x2b, 0xe4, 0x10, 0xb2, 0xd6, + 0xd0, 0x9e, 0x6a, 0x8c, 0xa8, 0x8e, 0x11, 0x1a, 0x13, 0x8b, 0xd0, 0x18, 0x61, 0x11, 0x2e, 0x86, + 0x4c, 0xc4, 0xa4, 0xf8, 0x9f, 0x24, 0x15, 0x63, 0xf4, 0xc6, 0xd3, 0xc7, 0x51, 0x56, 0xf1, 0x96, + 0xfb, 0xd8, 0x43, 0x7b, 0x34, 0x2f, 0xc3, 0x2e, 0x56, 0x20, 0xed, 0xc6, 0x63, 0xd7, 0xa0, 0x39, + 0xc0, 0x70, 0x92, 0xa7, 0xea, 0x87, 0xa5, 0x7c, 0xfd, 0xb0, 0x4a, 0xcf, 0xa8, 0xc6, 0xbd, 0xa1, + 0x6d, 0xe4, 0x56, 0xf4, 0x31, 0xab, 0x67, 0x01, 0xb3, 0x9a, 0xf0, 0x36, 0xd9, 0x22, 0x99, 0xfe, + 0x19, 0x18, 0x16, 0x53, 0xea, 0xd0, 0xee, 0x97, 0xf0, 0x0c, 0x78, 0xaa, 0xf1, 0xa3, 0xf7, 0xa3, + 0x7c, 0x6a, 0x14, 0xf3, 0xab, 0x91, 0xb0, 0x0c, 0x8b, 0xa1, 0xbc, 0xd9, 0xd4, 0xff, 0xc8, 0x51, + 0xc1, 0x9c, 0x42, 0x57, 0xcd, 0x94, 0x4d, 0x63, 0xd8, 0xa9, 0xd9, 0xa0, 0x7b, 0x6a, 0x0a, 0x22, + 0x1a, 0x3c, 0xa2, 0x49, 0x08, 0xff, 0xcc, 0xd1, 0x7d, 0xf0, 0xcb, 0xc2, 0x6e, 0xdb, 0xeb, 0x90, + 0xec, 0x92, 0x5a, 0x3e, 0x8d, 0xba, 0x66, 0xbd, 0x46, 0xb0, 0x67, 0x0d, 0x89, 0x14, 0xe3, 0xcc, + 0xaa, 0xa3, 0xc2, 0x37, 0x1c, 0xa4, 0x5d, 0xfc, 0xd1, 0x12, 0x4c, 0x3a, 0xe5, 0x1f, 0x3b, 0xdf, + 0x71, 0x00, 0xd6, 0xf1, 0x9b, 0x9a, 0x29, 0xb7, 0xd8, 0x3b, 0x13, 0xfa, 0x61, 0xa5, 0xa8, 0x5d, + 0x03, 0xd3, 0x70, 0x38, 0x2e, 0x92, 0xdf, 0xe8, 0x26, 0x24, 0xba, 0xaa, 0x62, 0x12, 0xb3, 0x9f, + 0xf1, 0xdb, 0x33, 0x99, 0x2a, 0xb7, 0xa7, 0x2a, 0xa6, 0x48, 0xb0, 0x84, 0x1b, 0x90, 0xb0, 0xbe, + 0xbc, 0x15, 0x88, 0x49, 0x48, 0x16, 0x9e, 0xd6, 0x4b, 0xb5, 0x0c, 0x87, 0x00, 0x52, 0x65, 0x9a, + 0xaf, 0xc7, 0x84, 0x8a, 0xfd, 0x7a, 0xd4, 0x59, 0x84, 0xe5, 0x02, 0xe4, 0x7d, 0x55, 0xd3, 0xdb, + 0x72, 0x8b, 0xc8, 0x3c, 0x21, 0x3a, 0xdf, 0xd1, 0x2d, 0x12, 0x5a, 0x50, 0x5c, 0x72, 0x4e, 0x24, + 0xac, 0x5e, 0xf4, 0x09, 0xd5, 0xad, 0xa8, 0x4a, 0x51, 0x3e, 0xb4, 0x52, 0xb4, 0xec, 0xb9, 0x65, + 0x07, 0xd4, 0x88, 0xfe, 0x2b, 0x06, 0xf3, 0xa1, 0x78, 0xe8, 0x8e, 0xbb, 0x3a, 0x74, 0xb9, 0x2f, + 0x4f, 0x77, 0x5d, 0xe8, 0x5b, 0x8e, 0xd6, 0x85, 0x36, 0x3c, 0x75, 0xa1, 0x6b, 0x03, 0xe9, 0xdd, + 0x15, 0xa1, 0x7f, 0xe1, 0x22, 0x2a, 0x42, 0xb5, 0x7a, 0x7e, 0xab, 0x24, 0xed, 0x55, 0xe9, 0x5f, + 0xa7, 0x22, 0x34, 0x07, 0x99, 0x5e, 0x9d, 0x44, 0xaa, 0xd5, 0xf3, 0xf5, 0x5a, 0x26, 0x16, 0xac, + 0xc6, 0xc4, 0x43, 0x6b, 0x2d, 0x89, 0xc1, 0x65, 0x95, 0xa4, 0xb7, 0xac, 0x32, 0x07, 0x88, 0x9d, + 0x8a, 0xfb, 0xd1, 0xfb, 0xbf, 0x71, 0x30, 0xeb, 0x01, 0xb3, 0x43, 0x72, 0x35, 0xb4, 0x39, 0x4f, + 0x43, 0xfb, 0x36, 0xcc, 0x59, 0x99, 0x21, 0xb5, 0x08, 0x43, 0xea, 0x60, 0x9d, 0x14, 0xb2, 0x99, + 0x6e, 0x9f, 0x6f, 0xcb, 0xc7, 0xac, 0xd8, 0xbf, 0x8b, 0x75, 0x8b, 0xf1, 0x19, 0x94, 0x73, 0x85, + 0x2f, 0xe3, 0x34, 0xfe, 0x18, 0x39, 0x7f, 0x19, 0xe8, 0x8b, 0x82, 0x09, 0x4e, 0x7c, 0x84, 0x04, + 0x27, 0xc2, 0x93, 0x25, 0x46, 0x0a, 0x7a, 0x47, 0xbf, 0xbb, 0xab, 0xbd, 0xfb, 0x99, 0x46, 0xa8, + 0x37, 0xdd, 0x7a, 0x3a, 0x30, 0xa3, 0x4a, 0x7d, 0x59, 0xe0, 0xbe, 0x3a, 0xab, 0x7c, 0x38, 0x4f, + 0xe3, 0xae, 0x53, 0xe4, 0x41, 0xeb, 0x7f, 0xe0, 0x60, 0xa2, 0xdc, 0xc4, 0xaa, 0x49, 0xd7, 0x36, + 0xed, 0xf9, 0xbf, 0x08, 0xb4, 0x14, 0xf1, 0xef, 0x12, 0x64, 0x61, 0xfc, 0x72, 0xdf, 0x7f, 0xa6, + 0x10, 0xc6, 0xd0, 0x81, 0xeb, 0x7f, 0x3a, 0x3c, 0x1d, 0x8b, 0x57, 0x02, 0x94, 0x21, 0xae, 0x8c, + 0xbf, 0x3a, 0x00, 0xcb, 0x99, 0xe7, 0x2e, 0x24, 0xc9, 0x0b, 0x78, 0x34, 0xe7, 0xbc, 0xc2, 0x77, + 0x3d, 0x90, 0xe7, 0xe7, 0x7d, 0x50, 0x9b, 0x6e, 0xfd, 0xa7, 0x93, 0x00, 0xbd, 0x74, 0x12, 0x3d, + 0x84, 0x29, 0xf7, 0x23, 0x5c, 0xb4, 0xd8, 0xe7, 0x09, 0x38, 0xbf, 0x14, 0x3e, 0xe8, 0xc8, 0xf4, + 0x10, 0xa6, 0xdc, 0x6f, 0xb5, 0x7a, 0xcc, 0x42, 0xde, 0x8b, 0xf5, 0x98, 0x85, 0x3e, 0xef, 0x1a, + 0x43, 0x2d, 0xb8, 0x10, 0xf1, 0x5a, 0x07, 0x5d, 0x1b, 0xee, 0x4d, 0x13, 0xff, 0xea, 0x90, 0xcf, + 0x7e, 0x84, 0x31, 0xa4, 0xc3, 0xc5, 0xc8, 0x47, 0x2a, 0x68, 0x6d, 0xd8, 0x27, 0x34, 0xfc, 0xf5, + 0x21, 0x30, 0x9d, 0x39, 0xbb, 0xc0, 0x47, 0x77, 0xc6, 0xd1, 0xf5, 0xa1, 0x9f, 0x6c, 0xf0, 0x37, + 0x86, 0x6f, 0xb4, 0x0b, 0x63, 0x68, 0x1b, 0xd2, 0xae, 0x16, 0x29, 0xe2, 0x43, 0xfb, 0xa6, 0x94, + 0xf1, 0x62, 0x9f, 0x9e, 0x2a, 0xe5, 0xe4, 0xea, 0x5a, 0xf5, 0x38, 0x05, 0xfb, 0x6f, 0x3d, 0x4e, + 0x21, 0x6d, 0x2e, 0xff, 0xf6, 0xfb, 0xee, 0xf1, 0xb0, 0xed, 0x0f, 0x0f, 0x04, 0xc2, 0xb6, 0x3f, + 0x22, 0x28, 0x10, 0xc6, 0xd0, 0x87, 0x30, 0xe3, 0xad, 0x44, 0xa3, 0xe5, 0xbe, 0x15, 0x75, 0xfe, + 0x52, 0xd4, 0xb0, 0x9b, 0xa5, 0xb7, 0xf0, 0xd9, 0x63, 0x19, 0x5a, 0x80, 0xed, 0xb1, 0x8c, 0xa8, + 0x97, 0x8e, 0x59, 0xfe, 0xc9, 0x53, 0xce, 0xeb, 0xf9, 0xa7, 0xb0, 0x2a, 0x64, 0xcf, 0x3f, 0x85, + 0xd6, 0x00, 0x85, 0x31, 0xa4, 0xc0, 0x42, 0x78, 0x35, 0x09, 0x5d, 0x1d, 0xaa, 0x58, 0xc6, 0x5f, + 0x1b, 0x84, 0xe6, 0x4c, 0xd5, 0x80, 0xd9, 0x90, 0x0e, 0x36, 0x12, 0xfa, 0xb6, 0xb7, 0xe9, 0x24, + 0x57, 0x86, 0x68, 0x81, 0x0b, 0x56, 0xb4, 0xb1, 0xfe, 0xab, 0x24, 0x24, 0xc8, 0xb5, 0x5f, 0x87, + 0x73, 0xbe, 0x92, 0x01, 0xba, 0xd4, 0xbf, 0x90, 0xc2, 0xaf, 0x44, 0x8e, 0x3b, 0x6b, 0x78, 0x06, + 0xe7, 0x03, 0x45, 0x00, 0xb4, 0xea, 0xa6, 0x0b, 0x2b, 0x44, 0xf0, 0x97, 0xfb, 0x60, 0xf8, 0x79, + 0x7b, 0x7d, 0xdb, 0xea, 0xa0, 0x2c, 0xd5, 0xcb, 0x3b, 0xca, 0x9f, 0x7d, 0x42, 0xa3, 0x2c, 0xbf, + 0x27, 0x13, 0xbc, 0x72, 0x85, 0xfa, 0xb0, 0x2b, 0x7d, 0x71, 0x9c, 0x19, 0x3e, 0x76, 0xc2, 0x3b, + 0x57, 0x92, 0x84, 0x3c, 0xc2, 0x85, 0x26, 0x73, 0xbc, 0xd0, 0x0f, 0xc5, 0x61, 0xff, 0x04, 0x32, + 0xfe, 0x7b, 0x1e, 0xad, 0x0c, 0x08, 0x3b, 0xf8, 0xd5, 0x68, 0x04, 0xff, 0xce, 0xf8, 0x9d, 0x8c, + 0x5f, 0xaa, 0x30, 0xf7, 0x72, 0xa5, 0x2f, 0x8e, 0xdb, 0x2d, 0xba, 0x22, 0xdc, 0x9e, 0x5b, 0x0c, + 0x46, 0xc3, 0x3d, 0xb7, 0x18, 0x12, 0x12, 0x0b, 0x63, 0x1b, 0xf7, 0x01, 0xe4, 0x56, 0xe7, 0xb9, + 0x2c, 0x61, 0xb5, 0xdb, 0x46, 0x4b, 0x81, 0x26, 0x53, 0x49, 0xed, 0xb6, 0x77, 0x3a, 0x56, 0x72, + 0x65, 0x64, 0xff, 0x63, 0x82, 0xa4, 0x54, 0x93, 0x84, 0xc0, 0x1a, 0xd8, 0xa8, 0x40, 0xa6, 0x47, + 0x2d, 0x91, 0x10, 0x0a, 0x5d, 0x0e, 0xe5, 0x41, 0x5a, 0xf6, 0x3e, 0x46, 0x33, 0x0e, 0x23, 0x32, + 0xba, 0xf1, 0x0e, 0x40, 0xc3, 0x50, 0x24, 0x1a, 0xc3, 0xa1, 0xe5, 0x00, 0x9f, 0x07, 0x0a, 0x6e, + 0x35, 0x6d, 0x1e, 0xff, 0xce, 0x84, 0x69, 0x18, 0x0a, 0x8d, 0xf4, 0x36, 0xde, 0x83, 0x34, 0x15, + 0xe6, 0xc0, 0xc2, 0x1b, 0x44, 0xcf, 0x64, 0xa0, 0xab, 0x27, 0x23, 0x1b, 0x25, 0x98, 0xa6, 0x0c, + 0x58, 0x62, 0x88, 0x56, 0x02, 0x2c, 0x1e, 0xd1, 0x11, 0x1f, 0x93, 0x29, 0x42, 0xc6, 0xc6, 0x36, + 0x0a, 0x30, 0x65, 0xb3, 0x31, 0x9f, 0x6b, 0x4d, 0x74, 0x29, 0x84, 0x8b, 0x35, 0xe0, 0x63, 0x92, + 0x66, 0x4c, 0xac, 0xa1, 0x9e, 0x28, 0xf6, 0x3f, 0x87, 0x06, 0x45, 0x61, 0xc9, 0x5b, 0xa8, 0x28, + 0x6c, 0xac, 0x90, 0x7c, 0x16, 0x6f, 0x18, 0xca, 0x7e, 0x8a, 0x10, 0xbd, 0xf9, 0xa7, 0x00, 0x00, + 0x00, 0xff, 0xff, 0x4c, 0xb1, 0xe0, 0x3d, 0xc9, 0x3c, 0x00, 0x00, } // Reference imports to suppress errors if they are not otherwise used. diff --git a/spec.md b/spec.md index 976090a1..69dbacab 100644 --- a/spec.md +++ b/spec.md @@ -887,6 +887,18 @@ message VolumeCapability { // Can be published as read/write at multiple nodes // simultaneously. MULTI_NODE_MULTI_WRITER = 5; + + // Can only be published once as read/write at a single workload + // on a single node, at any given time. Should be used instead of + // SINGLE_NODE_WRITER for COs using the experimental + // SINGLE_NODE_MULTI_WRITER capability. + SINGLE_NODE_SINGLE_WRITER = 6 [(alpha_enum_value) = true]; + + // Can be published as read/write at multiple workloads on a + // single node simultaneously. Should be used instead of + // SINGLE_NODE_WRITER for COs using the experimental + // SINGLE_NODE_MULTI_WRITER capability. + SINGLE_NODE_MULTI_WRITER = 7 [(alpha_enum_value) = true]; } // This field is REQUIRED. @@ -1704,6 +1716,16 @@ message ControllerServiceCapability { // This enables COs to, for example, fetch per volume // condition after a volume is provisioned. GET_VOLUME = 12 [(alpha_enum_value) = true]; + + // Indicates the SP supports the SINGLE_NODE_SINGLE_WRITER and/or + // SINGLE_NODE_MULTI_WRITER access modes. + // These access modes are intended to replace the + // SINGLE_NODE_WRITER access mode to clarify the number of writers + // for a volume on a single node. Plugins MUST accept and allow + // use of the SINGLE_NODE_WRITER access mode when either + // SINGLE_NODE_SINGLE_WRITER and/or SINGLE_NODE_MULTI_WRITER are + // supported, in order to permit older COs to continue working. + SINGLE_NODE_MULTI_WRITER = 13 [(alpha_enum_value) = true]; } Type type = 1; @@ -2224,15 +2246,26 @@ If the volume corresponding to the `volume_id` has already been published at the If this RPC failed, or the CO does not know if it failed or not, it MAY choose to call `NodePublishVolume` again, or choose to call `NodeUnpublishVolume`. -This RPC MAY be called by the CO multiple times on the same node for the same volume with possibly different `target_path` and/or other arguments if the volume has MULTI_NODE capability (i.e., `access_mode` is either `MULTI_NODE_READER_ONLY`, `MULTI_NODE_SINGLE_WRITER` or `MULTI_NODE_MULTI_WRITER`). +This RPC MAY be called by the CO multiple times on the same node for the same volume with possibly different `target_path` and/or other arguments if the volume has MULTI_NODE or SINGLE_NODE_MULTI_WRITER (see second table) access modes. Example MULTI_NODE access modes include `MULTI_NODE_READER_ONLY`, `MULTI_NODE_SINGLE_WRITER` or `MULTI_NODE_MULTI_WRITER`. The following table shows what the Plugin SHOULD return when receiving a second `NodePublishVolume` on the same volume on the same node: +(`Tn`: target path of the n-th `NodePublishVolume`, `Pn`: other arguments of the n-th `NodePublishVolume` except `secrets`) + | | T1=T2, P1=P2 | T1=T2, P1!=P2 | T1!=T2, P1=P2 | T1!=T2, P1!=P2 | |----------------|-----------------|----------------|---------------------|--------------------| | MULTI_NODE | OK (idempotent) | ALREADY_EXISTS | OK | OK | | Non MULTI_NODE | OK (idempotent) | ALREADY_EXISTS | FAILED_PRECONDITION | FAILED_PRECONDITION| -(`Tn`: target path of the n-th `NodePublishVolume`, `Pn`: other arguments of the n-th `NodePublishVolume` except `secrets`) +NOTE: If the Plugin supports the `SINGLE_NODE_MULTI_WRITER` capability, use the following table instead for what the Plugin SHOULD return when receiving a second `NodePublishVolume` on the same volume on the same node: + +| | T1=T2, P1=P2 | T1=T2, P1!=P2 | T1!=T2, P1=P2 | T1!=T2, P1!=P2 | +|---------------------------------------|-----------------|----------------|---------------------|---------------------| +| SINGLE_NODE_SINGLE_WRITER | OK (idempotent) | ALREADY_EXISTS | FAILED_PRECONDITION | FAILED_PRECONDITION | +| SINGLE_NODE_MULTI_WRITER | OK (idempotent) | ALREADY_EXISTS | OK | OK | +| MULTI_NODE | OK (idempotent) | ALREADY_EXISTS | OK | OK | +| Non MULTI_NODE | OK (idempotent) | ALREADY_EXISTS | FAILED_PRECONDITION | FAILED_PRECONDITION | + +The `SINGLE_NODE_SINGLE_WRITER` and `SINGLE_NODE_MULTI_WRITER` access modes are intended to replace the `SINGLE_NODE_WRITER` access mode to clarify the number of writers for a volume on a single node. Plugins MUST accept and allow use of the `SINGLE_NODE_WRITER` access mode (subject to the processing rules above), when either `SINGLE_NODE_SINGLE_WRITER` and/or `SINGLE_NODE_MULTI_WRITER` are supported, in order to permit older COs to continue working. ```protobuf message NodePublishVolumeRequest { @@ -2501,6 +2534,16 @@ message NodeServiceCapability { // Note that, for alpha, `VolumeCondition` is intended to be // informative for humans only, not for automation. VOLUME_CONDITION = 4 [(alpha_enum_value) = true]; + // Indicates the SP supports the SINGLE_NODE_SINGLE_WRITER and/or + // SINGLE_NODE_MULTI_WRITER access modes. + // These access modes are intended to replace the + // SINGLE_NODE_WRITER access mode to clarify the number of writers + // for a volume on a single node. Plugins MUST accept and allow + // use of the SINGLE_NODE_WRITER access mode (subject to the + // processing rules for NodePublishVolume), when either + // SINGLE_NODE_SINGLE_WRITER and/or SINGLE_NODE_MULTI_WRITER are + // supported, in order to permit older COs to continue working. + SINGLE_NODE_MULTI_WRITER = 5 [(alpha_enum_value) = true]; } Type type = 1;