diff --git a/csi.proto b/csi.proto index 5306eb2e..b5d2b703 100644 --- a/csi.proto +++ b/csi.proto @@ -763,8 +763,18 @@ message ControllerUnpublishVolumeRequest { // This field is OPTIONAL. Refer to the `Secrets Requirements` // section on how to use this field. map secrets = 3 [(csi_secret) = true]; -} + // Indicates SP MUST make the volume inacessible to the node or nodes + // it is being unpublished from. Any attempt to read or write data + // to a volume from a node that has been fenced MUST NOT succeed, + // even if the volume remains staged and/or published on the node. + // CO MUST NOT set this field to true unless SP has the + // UNPUBLISH_FENCE controller capability. + // The SP MAY make the volume inaccessible even when this field is + // false. + // This is an OPTIONAL field. + bool fence = 4; +} message ControllerUnpublishVolumeResponse { // Intentionally empty. } @@ -1044,6 +1054,10 @@ 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 ControllerUnpublishVolume.fence + // field. + UNPUBLISH_FENCE = 13; } Type type = 1; @@ -1281,6 +1295,13 @@ message NodeUnstageVolumeRequest { // system/filesystem, but, at a minimum, SP MUST accept a max path // length of at least 128 bytes. string staging_target_path = 2; + + // Indicates that the SP should prefer to successfully unstage the + // volume, even if data loss would occur as a result. + // CO MUST NOT set this field to true unless SP has the + // FORCE_UNPUBLISH node capability. + // This in an OPTIONAL field. + bool force = 3; } message NodeUnstageVolumeResponse { @@ -1365,6 +1386,13 @@ message NodeUnpublishVolumeRequest { // system/filesystem, but, at a minimum, SP MUST accept a max path // length of at least 128 bytes. string target_path = 2; + + // Indicates that the SP should prefer to successfully unpublish the + // volume, even if data loss would occur as a result. + // CO MUST NOT set this field to true unless SP has the + // FORCE_UNPUBLISH node capability. + // This in an OPTIONAL field. + bool force = 3; } message NodeUnpublishVolumeResponse { @@ -1476,6 +1504,11 @@ 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 that the node supports the NodeUnpublishVolume.force + // field. Also indicates that the node supports the + // NodeUnstageVolume.force field if it also has the + // STAGE_UNSTAGE_VOLUME capability. + FORCE_UNPUBLISH = 5; } Type type = 1; diff --git a/lib/go/csi/csi.pb.go b/lib/go/csi/csi.pb.go index 974ee91c..a4649c8e 100644 --- a/lib/go/csi/csi.pb.go +++ b/lib/go/csi/csi.pb.go @@ -221,6 +221,9 @@ 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 ControllerUnpublishVolume.fence + // field. + ControllerServiceCapability_RPC_UNPUBLISH_FENCE ControllerServiceCapability_RPC_Type = 13 ) var ControllerServiceCapability_RPC_Type_name = map[int32]string{ @@ -237,6 +240,7 @@ var ControllerServiceCapability_RPC_Type_name = map[int32]string{ 10: "LIST_VOLUMES_PUBLISHED_NODES", 11: "VOLUME_CONDITION", 12: "GET_VOLUME", + 13: "UNPUBLISH_FENCE", } var ControllerServiceCapability_RPC_Type_value = map[string]int32{ @@ -253,6 +257,7 @@ var ControllerServiceCapability_RPC_Type_value = map[string]int32{ "LIST_VOLUMES_PUBLISHED_NODES": 10, "VOLUME_CONDITION": 11, "GET_VOLUME": 12, + "UNPUBLISH_FENCE": 13, } func (x ControllerServiceCapability_RPC_Type) String() string { @@ -314,6 +319,11 @@ 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 that the node supports the NodeUnpublishVolume.force + // field. Also indicates that the node supports the + // NodeUnstageVolume.force field if it also has the + // STAGE_UNSTAGE_VOLUME capability. + NodeServiceCapability_RPC_FORCE_UNPUBLISH NodeServiceCapability_RPC_Type = 5 ) var NodeServiceCapability_RPC_Type_name = map[int32]string{ @@ -322,6 +332,7 @@ var NodeServiceCapability_RPC_Type_name = map[int32]string{ 2: "GET_VOLUME_STATS", 3: "EXPAND_VOLUME", 4: "VOLUME_CONDITION", + 5: "FORCE_UNPUBLISH", } var NodeServiceCapability_RPC_Type_value = map[string]int32{ @@ -330,6 +341,7 @@ var NodeServiceCapability_RPC_Type_value = map[string]int32{ "GET_VOLUME_STATS": 2, "EXPAND_VOLUME": 3, "VOLUME_CONDITION": 4, + "FORCE_UNPUBLISH": 5, } func (x NodeServiceCapability_RPC_Type) String() string { @@ -2008,10 +2020,20 @@ type ControllerUnpublishVolumeRequest struct { // ControllerPublishVolume call for the specified volume. // This field is OPTIONAL. Refer to the `Secrets Requirements` // section on how to use this field. - Secrets map[string]string `protobuf:"bytes,3,rep,name=secrets,proto3" json:"secrets,omitempty" protobuf_key:"bytes,1,opt,name=key,proto3" protobuf_val:"bytes,2,opt,name=value,proto3"` - XXX_NoUnkeyedLiteral struct{} `json:"-"` - XXX_unrecognized []byte `json:"-"` - XXX_sizecache int32 `json:"-"` + Secrets map[string]string `protobuf:"bytes,3,rep,name=secrets,proto3" json:"secrets,omitempty" protobuf_key:"bytes,1,opt,name=key,proto3" protobuf_val:"bytes,2,opt,name=value,proto3"` + // Indicates SP MUST make the volume inacessible to the node or nodes + // it is being unpublished from. Any attempt to read or write data + // to a volume from a node that has been fenced MUST NOT succeed, + // even if the volume remains staged and/or published on the node. + // CO MUST NOT set this field to true unless SP has the + // UNPUBLISH_FENCE controller capability. + // The SP MAY make the volume inaccessible even when this field is + // false. + // This is an OPTIONAL field. + Fence bool `protobuf:"varint,4,opt,name=fence,proto3" json:"fence,omitempty"` + XXX_NoUnkeyedLiteral struct{} `json:"-"` + XXX_unrecognized []byte `json:"-"` + XXX_sizecache int32 `json:"-"` } func (m *ControllerUnpublishVolumeRequest) Reset() { *m = ControllerUnpublishVolumeRequest{} } @@ -2060,6 +2082,13 @@ func (m *ControllerUnpublishVolumeRequest) GetSecrets() map[string]string { return nil } +func (m *ControllerUnpublishVolumeRequest) GetFence() bool { + if m != nil { + return m.Fence + } + return false +} + type ControllerUnpublishVolumeResponse struct { XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` @@ -3778,7 +3807,13 @@ type NodeUnstageVolumeRequest struct { // SP SHOULD support the maximum path length allowed by the operating // system/filesystem, but, at a minimum, SP MUST accept a max path // length of at least 128 bytes. - StagingTargetPath string `protobuf:"bytes,2,opt,name=staging_target_path,json=stagingTargetPath,proto3" json:"staging_target_path,omitempty"` + StagingTargetPath string `protobuf:"bytes,2,opt,name=staging_target_path,json=stagingTargetPath,proto3" json:"staging_target_path,omitempty"` + // Indicates that the SP should prefer to successfully unstage the + // volume, even if data loss would occur as a result. + // CO MUST NOT set this field to true unless SP has the + // FORCE_UNPUBLISH node capability. + // This in an OPTIONAL field. + Force bool `protobuf:"varint,3,opt,name=force,proto3" json:"force,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` @@ -3823,6 +3858,13 @@ func (m *NodeUnstageVolumeRequest) GetStagingTargetPath() string { return "" } +func (m *NodeUnstageVolumeRequest) GetForce() bool { + if m != nil { + return m.Force + } + return false +} + type NodeUnstageVolumeResponse struct { XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` @@ -4036,7 +4078,13 @@ type NodeUnpublishVolumeRequest struct { // SP SHOULD support the maximum path length allowed by the operating // system/filesystem, but, at a minimum, SP MUST accept a max path // length of at least 128 bytes. - TargetPath string `protobuf:"bytes,2,opt,name=target_path,json=targetPath,proto3" json:"target_path,omitempty"` + TargetPath string `protobuf:"bytes,2,opt,name=target_path,json=targetPath,proto3" json:"target_path,omitempty"` + // Indicates that the SP should prefer to successfully unpublish the + // volume, even if data loss would occur as a result. + // CO MUST NOT set this field to true unless SP has the + // FORCE_UNPUBLISH node capability. + // This in an OPTIONAL field. + Force bool `protobuf:"varint,3,opt,name=force,proto3" json:"force,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` @@ -4081,6 +4129,13 @@ func (m *NodeUnpublishVolumeRequest) GetTargetPath() string { return "" } +func (m *NodeUnpublishVolumeRequest) GetForce() bool { + if m != nil { + return m.Force + } + return false +} + type NodeUnpublishVolumeResponse struct { XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` @@ -4996,240 +5051,243 @@ 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, + // 3767 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xe4, 0x3b, 0x4d, 0x6c, 0x1b, 0x47, + 0x77, 0x5a, 0xfe, 0x48, 0xd4, 0xa3, 0x24, 0xd3, 0xa3, 0x1f, 0xd3, 0x2b, 0xc9, 0x92, 0xd7, 0xb1, + 0x3f, 0xd9, 0xb1, 0xe9, 0x44, 0x89, 0x8d, 0x46, 0x76, 0x7e, 0x48, 0x8a, 0x96, 0x18, 0xd3, 0xa4, + 0xb2, 0xa4, 0xec, 0xd8, 0x6d, 0xb0, 0x59, 0x91, 0x23, 0x79, 0x11, 0x72, 0x97, 0xd9, 0x5d, 0xaa, + 0x52, 0x80, 0xa2, 0x41, 0x8b, 0x16, 0x28, 0x72, 0xe9, 0x2d, 0xb9, 0x35, 0x68, 0x7a, 0x2a, 0x1a, + 0xe4, 0x54, 0xf4, 0x58, 0xb4, 0xc7, 0x00, 0x2d, 0x7a, 0x6b, 0xd1, 0x4b, 0xae, 0x45, 0x91, 0x02, + 0x39, 0xf7, 0x54, 0xec, 0xcc, 0xec, 0x72, 0x7f, 0xf9, 0x63, 0x29, 0xc8, 0xa1, 0x27, 0x71, 0xdf, + 0xbc, 0xf7, 0xe6, 0xcd, 0xcc, 0x7b, 0x6f, 0xde, 0xcf, 0x08, 0xee, 0x1d, 0x29, 0xe6, 0xcb, 0xde, + 0x41, 0xae, 0xa9, 0x75, 0xee, 0x36, 0x35, 0xd5, 0x94, 0x15, 0x15, 0xeb, 0x77, 0x0c, 0x53, 0xd3, + 0xe5, 0x23, 0x7c, 0x47, 0x51, 0x4d, 0xac, 0x1f, 0xca, 0x4d, 0x7c, 0xd7, 0xe8, 0xe2, 0xe6, 0xdd, + 0xa6, 0xa1, 0xe4, 0xba, 0xba, 0x66, 0x6a, 0x68, 0xd2, 0xfa, 0x79, 0xfc, 0x26, 0xbf, 0x7e, 0xa4, + 0x69, 0x47, 0x6d, 0x7c, 0x97, 0x40, 0x0f, 0x7a, 0x87, 0x77, 0x5b, 0xd8, 0x68, 0xea, 0x4a, 0xd7, + 0xd4, 0x74, 0x8a, 0xc9, 0xaf, 0xf9, 0x31, 0x4c, 0xa5, 0x83, 0x0d, 0x53, 0xee, 0x74, 0x19, 0xc2, + 0x15, 0x3f, 0xc2, 0x1f, 0xea, 0x72, 0xb7, 0x8b, 0x75, 0x83, 0x8e, 0x0b, 0x4b, 0xb0, 0xb0, 0x83, + 0xcd, 0xbd, 0x76, 0xef, 0x48, 0x51, 0xcb, 0xea, 0xa1, 0x26, 0xe2, 0xcf, 0x7b, 0xd8, 0x30, 0x85, + 0xff, 0xe0, 0x60, 0xd1, 0x37, 0x60, 0x74, 0x35, 0xd5, 0xc0, 0x08, 0x41, 0x42, 0x95, 0x3b, 0x38, + 0xcb, 0xad, 0x73, 0x1b, 0xd3, 0x22, 0xf9, 0x8d, 0xae, 0xc3, 0xdc, 0x31, 0x56, 0x5b, 0x9a, 0x2e, + 0x1d, 0x63, 0xdd, 0x50, 0x34, 0x35, 0x1b, 0x23, 0xa3, 0xb3, 0x14, 0xfa, 0x94, 0x02, 0xd1, 0x0e, + 0xa4, 0x3a, 0xb2, 0xaa, 0x1c, 0x62, 0xc3, 0xcc, 0xc6, 0xd7, 0xe3, 0x1b, 0xe9, 0xcd, 0xd7, 0x73, + 0x74, 0xa9, 0xb9, 0xd0, 0xb9, 0x72, 0x4f, 0x18, 0x76, 0x49, 0x35, 0xf5, 0x53, 0xd1, 0x21, 0xe6, + 0x1f, 0xc0, 0xac, 0x67, 0x08, 0x65, 0x20, 0xfe, 0x19, 0x3e, 0x65, 0x32, 0x59, 0x3f, 0xd1, 0x02, + 0x24, 0x8f, 0xe5, 0x76, 0x0f, 0x33, 0x49, 0xe8, 0xc7, 0x56, 0xec, 0xf7, 0x38, 0xe1, 0x0a, 0xac, + 0x38, 0xb3, 0x15, 0xe5, 0xae, 0x7c, 0xa0, 0xb4, 0x15, 0x53, 0xc1, 0x86, 0xbd, 0xf4, 0x4f, 0x60, + 0x35, 0x62, 0x9c, 0xed, 0xc0, 0x43, 0x98, 0x69, 0xba, 0xe0, 0x59, 0x8e, 0x2c, 0x25, 0x6b, 0x2f, + 0xc5, 0x47, 0x79, 0x2a, 0x7a, 0xb0, 0x85, 0x7f, 0x8d, 0x43, 0xc6, 0x8f, 0x82, 0x1e, 0xc2, 0x94, + 0x81, 0xf5, 0x63, 0xa5, 0x49, 0xf7, 0x35, 0xbd, 0xb9, 0x1e, 0xc5, 0x2d, 0x57, 0xa7, 0x78, 0xbb, + 0x13, 0xa2, 0x4d, 0x82, 0xf6, 0x21, 0x73, 0xac, 0xb5, 0x7b, 0x1d, 0x2c, 0xe1, 0x93, 0xae, 0xac, + 0x3a, 0x07, 0x90, 0xde, 0xdc, 0x88, 0x64, 0xf3, 0x94, 0x10, 0x94, 0x6c, 0xfc, 0xdd, 0x09, 0xf1, + 0xc2, 0xb1, 0x17, 0xc4, 0x7f, 0xcd, 0xc1, 0x14, 0x9b, 0x0d, 0xbd, 0x03, 0x09, 0xf3, 0xb4, 0x4b, + 0xa5, 0x9b, 0xdb, 0xbc, 0x3e, 0x4c, 0xba, 0x5c, 0xe3, 0xb4, 0x8b, 0x45, 0x42, 0x22, 0x7c, 0x04, + 0x09, 0xeb, 0x0b, 0xa5, 0x61, 0x6a, 0xbf, 0xfa, 0xb8, 0x5a, 0x7b, 0x56, 0xcd, 0x4c, 0xa0, 0x25, + 0x40, 0xc5, 0x5a, 0xb5, 0x21, 0xd6, 0x2a, 0x95, 0x92, 0x28, 0xd5, 0x4b, 0xe2, 0xd3, 0x72, 0xb1, + 0x94, 0xe1, 0xd0, 0x6b, 0xb0, 0xfe, 0xb4, 0x56, 0xd9, 0x7f, 0x52, 0x92, 0xf2, 0xc5, 0x62, 0xa9, + 0x5e, 0x2f, 0x17, 0xca, 0x95, 0x72, 0xe3, 0xb9, 0x54, 0xac, 0x55, 0xeb, 0x0d, 0x31, 0x5f, 0xae, + 0x36, 0xea, 0x99, 0x18, 0xff, 0x27, 0x1c, 0x5c, 0xf0, 0x2d, 0x00, 0xe5, 0x3d, 0x12, 0xde, 0x19, + 0x75, 0xe1, 0x6e, 0x49, 0x6f, 0x87, 0x49, 0x0a, 0x30, 0x59, 0xab, 0x56, 0xca, 0x55, 0x4b, 0xba, + 0x34, 0x4c, 0xd5, 0x1e, 0x3d, 0x22, 0x1f, 0xb1, 0xc2, 0x24, 0x9d, 0x50, 0x98, 0x83, 0x99, 0x3d, + 0x5d, 0x3b, 0xc0, 0xb6, 0xfe, 0xe4, 0x61, 0x96, 0x7d, 0x33, 0x7d, 0x79, 0x03, 0x92, 0x3a, 0x96, + 0x5b, 0xa7, 0xec, 0x68, 0xf9, 0x1c, 0xb5, 0xc9, 0x9c, 0x6d, 0x93, 0xb9, 0x82, 0xa6, 0xb5, 0x9f, + 0x5a, 0xfa, 0x29, 0x52, 0x44, 0xe1, 0x97, 0x04, 0xcc, 0x17, 0x75, 0x2c, 0x9b, 0x98, 0x4a, 0xcb, + 0x58, 0x87, 0xda, 0xde, 0x43, 0x98, 0xb3, 0xf4, 0xab, 0xa9, 0x98, 0xa7, 0x92, 0x2e, 0xab, 0x47, + 0x98, 0x1d, 0xfd, 0xa2, 0xbd, 0x03, 0x45, 0x36, 0x2a, 0x5a, 0x83, 0xe2, 0x6c, 0xd3, 0xfd, 0x89, + 0xca, 0x30, 0xcf, 0x54, 0xc7, 0xa3, 0xd2, 0x71, 0xaf, 0x4a, 0x53, 0x29, 0x5c, 0x2a, 0x8d, 0x8e, + 0xbd, 0x10, 0x05, 0x1b, 0xe8, 0x31, 0x40, 0x57, 0xd6, 0xe5, 0x0e, 0x36, 0xb1, 0x6e, 0x64, 0x13, + 0x5e, 0xfb, 0x0e, 0x59, 0x4d, 0x6e, 0xcf, 0xc1, 0xa6, 0xf6, 0xed, 0x22, 0x47, 0x3b, 0x96, 0x41, + 0x34, 0x75, 0x6c, 0x1a, 0xd9, 0x24, 0xe1, 0xb4, 0x31, 0x88, 0x53, 0x9d, 0xa2, 0x12, 0x36, 0x85, + 0xf8, 0x37, 0x05, 0x4e, 0xb4, 0xa9, 0x51, 0x0d, 0x16, 0xed, 0x05, 0x6a, 0xaa, 0x89, 0x55, 0x53, + 0x32, 0xb4, 0x9e, 0xde, 0xc4, 0xd9, 0x49, 0xb2, 0x4b, 0xcb, 0xbe, 0x25, 0x52, 0x9c, 0x3a, 0x41, + 0x11, 0xd9, 0xd6, 0x78, 0x80, 0xe8, 0x05, 0xf0, 0x72, 0xb3, 0x89, 0x0d, 0x43, 0xa1, 0x7b, 0x21, + 0xe9, 0xf8, 0xf3, 0x9e, 0xa2, 0xe3, 0x0e, 0x56, 0x4d, 0x23, 0x3b, 0xe5, 0xe5, 0xda, 0xd0, 0xba, + 0x5a, 0x5b, 0x3b, 0x3a, 0x15, 0xfb, 0x38, 0xe2, 0x65, 0x0f, 0xb9, 0x6b, 0xc4, 0xe0, 0xdf, 0x85, + 0x0b, 0xbe, 0x4d, 0x19, 0xc7, 0xb3, 0xf1, 0x5b, 0x30, 0xe3, 0xde, 0x89, 0xb1, 0xbc, 0xe2, 0x57, + 0x31, 0x98, 0x0f, 0xd9, 0x03, 0xb4, 0x0b, 0x29, 0x43, 0x95, 0xbb, 0xc6, 0x4b, 0xcd, 0x64, 0xfa, + 0x7b, 0x6b, 0xc0, 0x96, 0xe5, 0xea, 0x0c, 0x97, 0x7e, 0xee, 0x4e, 0x88, 0x0e, 0x35, 0x2a, 0xc0, + 0x24, 0xdd, 0x4f, 0xbf, 0x6f, 0x0a, 0xe3, 0x43, 0x61, 0x0e, 0x17, 0x46, 0xc9, 0xbf, 0x09, 0x73, + 0xde, 0x19, 0xd0, 0x1a, 0xa4, 0xed, 0x19, 0x24, 0xa5, 0xc5, 0xd6, 0x0a, 0x36, 0xa8, 0xdc, 0xe2, + 0x5f, 0x87, 0x19, 0x37, 0x33, 0xb4, 0x0c, 0xd3, 0x4c, 0x21, 0x1c, 0xf4, 0x14, 0x05, 0x94, 0x5b, + 0x8e, 0x4d, 0xbf, 0x07, 0x0b, 0x5e, 0x3d, 0x63, 0xa6, 0x7c, 0xc3, 0x59, 0x03, 0xdd, 0x8b, 0x39, + 0xef, 0x1a, 0x6c, 0x39, 0x85, 0xbf, 0x4d, 0x40, 0xc6, 0x6f, 0x34, 0xe8, 0x21, 0x24, 0x0f, 0xda, + 0x5a, 0xf3, 0x33, 0x46, 0xfb, 0x5a, 0x94, 0x75, 0xe5, 0x0a, 0x16, 0x16, 0x85, 0xee, 0x4e, 0x88, + 0x94, 0xc8, 0xa2, 0xee, 0x68, 0x3d, 0xd5, 0x64, 0xbb, 0x17, 0x4d, 0xfd, 0xc4, 0xc2, 0xea, 0x53, + 0x13, 0x22, 0xb4, 0x0d, 0x69, 0xaa, 0x76, 0x52, 0x47, 0x6b, 0xe1, 0x6c, 0x9c, 0xf0, 0xb8, 0x16, + 0xc9, 0x23, 0x4f, 0x70, 0x9f, 0x68, 0x2d, 0x2c, 0x82, 0xec, 0xfc, 0xe6, 0x67, 0x21, 0xed, 0x92, + 0x8d, 0xdf, 0x81, 0xb4, 0x6b, 0x32, 0x74, 0x09, 0xa6, 0x0e, 0x0d, 0xc9, 0x71, 0xc2, 0xd3, 0xe2, + 0xe4, 0xa1, 0x41, 0xfc, 0xe9, 0x1a, 0xa4, 0x89, 0x14, 0xd2, 0x61, 0x5b, 0x3e, 0x32, 0xb2, 0xb1, + 0xf5, 0xb8, 0x75, 0x46, 0x04, 0xf4, 0xc8, 0x82, 0xf0, 0x3f, 0x73, 0x00, 0xfd, 0x29, 0xd1, 0x43, + 0x48, 0x10, 0x29, 0xa9, 0x2b, 0xdf, 0x18, 0x41, 0xca, 0x1c, 0x11, 0x95, 0x50, 0x09, 0x7f, 0xc5, + 0x41, 0x82, 0xb0, 0xf1, 0x5f, 0x38, 0xf5, 0x72, 0x75, 0xa7, 0x52, 0x92, 0xaa, 0xb5, 0xed, 0x92, + 0xf4, 0x4c, 0x2c, 0x37, 0x4a, 0x62, 0x86, 0x43, 0xcb, 0x70, 0xc9, 0x0d, 0x17, 0x4b, 0xf9, 0xed, + 0x92, 0x28, 0xd5, 0xaa, 0x95, 0xe7, 0x99, 0x18, 0xe2, 0x61, 0xe9, 0xc9, 0x7e, 0xa5, 0x51, 0x0e, + 0x8e, 0xc5, 0xd1, 0x0a, 0x64, 0x5d, 0x63, 0x8c, 0x07, 0x63, 0x9b, 0xb0, 0xd8, 0xba, 0x46, 0xe9, + 0x4f, 0x36, 0x98, 0x2c, 0xcc, 0x3a, 0x87, 0x41, 0x94, 0xed, 0x19, 0xcc, 0x7a, 0x7c, 0xb4, 0x15, + 0x4e, 0x31, 0xa7, 0xd2, 0x92, 0x0e, 0x4e, 0x4d, 0x12, 0x62, 0x70, 0x1b, 0x71, 0x71, 0xd6, 0x86, + 0x16, 0x2c, 0xa0, 0xb5, 0xad, 0x6d, 0xa5, 0xa3, 0x98, 0x0c, 0x27, 0x46, 0x70, 0x80, 0x80, 0x08, + 0x82, 0xf0, 0x53, 0x0c, 0x26, 0xd9, 0xd9, 0x5c, 0x77, 0xdd, 0x12, 0x1e, 0x96, 0x36, 0x94, 0xb2, + 0xf4, 0x18, 0x47, 0xcc, 0x6b, 0x1c, 0x68, 0x17, 0xe6, 0xdc, 0xae, 0xf4, 0xc4, 0x0e, 0xe2, 0xae, + 0x7a, 0x0f, 0xc8, 0x6d, 0xcf, 0x27, 0x2c, 0x74, 0x9b, 0x3d, 0x76, 0xc3, 0x50, 0x01, 0xe6, 0x7c, + 0xde, 0x38, 0x31, 0xdc, 0x1b, 0xcf, 0x36, 0x3d, 0x8e, 0x29, 0x0f, 0xf3, 0xb6, 0x23, 0x6d, 0x63, + 0xc9, 0x64, 0x8e, 0x96, 0xdd, 0x16, 0x99, 0x80, 0x03, 0x46, 0x7d, 0x64, 0x1b, 0xc6, 0x7f, 0x00, + 0x28, 0x28, 0xeb, 0x58, 0x5e, 0xb3, 0x07, 0xf3, 0x21, 0x2e, 0x1e, 0xe5, 0x60, 0x9a, 0x1c, 0x95, + 0xa1, 0x98, 0x98, 0x85, 0x87, 0x41, 0x89, 0xfa, 0x28, 0x16, 0x7e, 0x57, 0xc7, 0x87, 0x58, 0xd7, + 0x71, 0x8b, 0x98, 0x47, 0x28, 0xbe, 0x83, 0x22, 0xfc, 0x29, 0x07, 0x29, 0x1b, 0x8e, 0xb6, 0x20, + 0x65, 0xe0, 0x23, 0x7a, 0xfd, 0xd0, 0xb9, 0xae, 0xf8, 0x69, 0x73, 0x75, 0x86, 0xc0, 0x02, 0x69, + 0x1b, 0xdf, 0x0a, 0xa4, 0x3d, 0x43, 0x63, 0x2d, 0xfe, 0x1f, 0x38, 0x98, 0xdf, 0xc6, 0x6d, 0xec, + 0x8f, 0x52, 0x06, 0x79, 0x58, 0xf7, 0xc5, 0x1e, 0xf3, 0x5e, 0xec, 0x21, 0xac, 0x06, 0x5c, 0xec, + 0x67, 0xba, 0xec, 0x96, 0x60, 0xc1, 0x3b, 0x1b, 0x75, 0xef, 0xc2, 0xff, 0xc4, 0xe1, 0x8a, 0xa5, + 0x0b, 0xba, 0xd6, 0x6e, 0x63, 0x7d, 0xaf, 0x77, 0xd0, 0x56, 0x8c, 0x97, 0x63, 0x2c, 0xee, 0x12, + 0x4c, 0xa9, 0x5a, 0xcb, 0x65, 0x3c, 0x93, 0xd6, 0x67, 0xb9, 0x85, 0x4a, 0x70, 0xd1, 0x1f, 0x66, + 0x9d, 0x32, 0x27, 0x1c, 0x1d, 0x64, 0x65, 0x8e, 0xfd, 0x37, 0x08, 0x0f, 0x29, 0x2b, 0x40, 0xd4, + 0xd4, 0xf6, 0x29, 0xb1, 0x98, 0x94, 0xe8, 0x7c, 0x23, 0xd1, 0x1f, 0x31, 0xbd, 0xe5, 0x44, 0x4c, + 0x03, 0x57, 0x34, 0x28, 0x78, 0xfa, 0x34, 0x60, 0xf1, 0x93, 0x84, 0xf5, 0x3b, 0x23, 0xb2, 0x1e, + 0xea, 0x09, 0xce, 0x72, 0x8a, 0xe7, 0x60, 0xbe, 0x3f, 0x72, 0xb0, 0x16, 0xb9, 0x04, 0x76, 0xe5, + 0xb7, 0xe0, 0x42, 0x97, 0x0e, 0x38, 0x9b, 0x40, 0xad, 0xec, 0xc1, 0xd0, 0x4d, 0x60, 0x59, 0x2c, + 0x83, 0x7a, 0xb6, 0x61, 0xae, 0xeb, 0x01, 0xf2, 0x79, 0x98, 0x0f, 0x41, 0x1b, 0x6b, 0x31, 0x5f, + 0xc6, 0x60, 0xbd, 0x2f, 0xca, 0xbe, 0xda, 0x3d, 0x3f, 0xf5, 0x6d, 0xf4, 0x75, 0x8b, 0xba, 0xfc, + 0x7b, 0xc1, 0xb5, 0x87, 0x4f, 0x38, 0x48, 0xbb, 0x16, 0x20, 0x79, 0x88, 0x55, 0xe6, 0xfc, 0x53, + 0x22, 0xfd, 0x38, 0x93, 0x5d, 0x5f, 0x83, 0xab, 0x03, 0x04, 0x62, 0x46, 0xfe, 0x53, 0x02, 0xae, + 0x3e, 0x95, 0xdb, 0x4a, 0xcb, 0x09, 0xef, 0x42, 0xaa, 0x00, 0x83, 0x37, 0xaa, 0x19, 0xb0, 0x0b, + 0xea, 0xcb, 0x1e, 0x3a, 0xb6, 0x3c, 0x8c, 0xff, 0x08, 0x97, 0xe4, 0x39, 0xa6, 0x66, 0xcf, 0x43, + 0x52, 0xb3, 0x77, 0x46, 0x97, 0x75, 0x50, 0xa2, 0xb6, 0xef, 0x77, 0x3b, 0xf7, 0x47, 0xe7, 0x3b, + 0xc0, 0xbb, 0x9f, 0xd9, 0xb6, 0x7f, 0xcb, 0x5c, 0xea, 0x9f, 0x13, 0x20, 0x0c, 0x5a, 0x3d, 0xf3, + 0x2c, 0x22, 0x4c, 0x37, 0x35, 0xf5, 0x50, 0xd1, 0x3b, 0xb8, 0xc5, 0x72, 0x82, 0xb7, 0x47, 0xd9, + 0x3c, 0xe6, 0x56, 0x8a, 0x36, 0xad, 0xd8, 0x67, 0x83, 0xb2, 0x30, 0xd5, 0xc1, 0x86, 0x21, 0x1f, + 0xd9, 0x62, 0xd9, 0x9f, 0xfc, 0xf7, 0x71, 0x98, 0x76, 0x48, 0x90, 0x1a, 0xd0, 0x60, 0xea, 0xd4, + 0x76, 0x5e, 0x45, 0x80, 0x57, 0x57, 0xe6, 0xd8, 0x2b, 0x28, 0x73, 0xcb, 0xa3, 0xcc, 0xd4, 0x1c, + 0xb6, 0x5f, 0x49, 0xec, 0x01, 0x7a, 0xfd, 0x9b, 0x2b, 0xa0, 0xf0, 0x07, 0x80, 0x2a, 0x8a, 0xc1, + 0x72, 0x2b, 0xc7, 0x2d, 0x59, 0xa9, 0x94, 0x7c, 0x22, 0x61, 0xd5, 0xd4, 0x15, 0x16, 0xc4, 0x27, + 0x45, 0xe8, 0xc8, 0x27, 0x25, 0x0a, 0xb1, 0x02, 0x7d, 0xc3, 0x94, 0x75, 0x53, 0x51, 0x8f, 0x24, + 0x53, 0xfb, 0x0c, 0x3b, 0xa5, 0x58, 0x1b, 0xda, 0xb0, 0x80, 0xc2, 0xcf, 0x31, 0x98, 0xf7, 0xb0, + 0x67, 0x3a, 0xf9, 0x00, 0xa6, 0xfa, 0xbc, 0x3d, 0xc1, 0x7d, 0x08, 0x76, 0x8e, 0x6e, 0x9b, 0x4d, + 0x81, 0x56, 0x01, 0x54, 0x7c, 0x62, 0x7a, 0xe6, 0x9d, 0xb6, 0x20, 0x64, 0x4e, 0xfe, 0xcf, 0x38, + 0x27, 0x15, 0x37, 0x65, 0xb3, 0x67, 0xa0, 0xdb, 0x80, 0x98, 0x8b, 0xc6, 0x2d, 0x89, 0xdd, 0x3c, + 0x74, 0xde, 0x69, 0x31, 0xe3, 0x8c, 0x54, 0xc9, 0x1d, 0x64, 0xa0, 0x1d, 0xa7, 0xca, 0xd9, 0xd4, + 0xd4, 0x96, 0x62, 0xf6, 0xab, 0x9c, 0x97, 0x02, 0x69, 0x03, 0x1d, 0x2e, 0xc4, 0xbf, 0x2d, 0x70, + 0x76, 0x5d, 0xd3, 0x81, 0xf2, 0x9f, 0x43, 0x92, 0x1e, 0xc7, 0x88, 0xd9, 0x3c, 0xfa, 0x00, 0x26, + 0x0d, 0x22, 0xb1, 0xbf, 0x72, 0x11, 0xb6, 0x27, 0xee, 0x15, 0x8a, 0x8c, 0x4e, 0x78, 0x0f, 0xf8, + 0xfe, 0xc5, 0xb4, 0x83, 0xcd, 0xd1, 0x2f, 0xe5, 0x2d, 0x6b, 0x0d, 0xc2, 0xd7, 0x31, 0x58, 0x0e, + 0x65, 0x30, 0x5e, 0x5d, 0x02, 0xed, 0xfa, 0x56, 0xf2, 0x46, 0xf0, 0x1e, 0x0f, 0x30, 0x0f, 0x5d, + 0x11, 0xff, 0xe5, 0xd9, 0x0e, 0xb3, 0x30, 0xf6, 0x61, 0x06, 0xce, 0x91, 0xee, 0xcc, 0xf7, 0x31, + 0x40, 0x3b, 0xd8, 0x74, 0x12, 0x68, 0xb6, 0xa5, 0x11, 0xfe, 0x86, 0x7b, 0x05, 0x7f, 0xf3, 0xa1, + 0xc7, 0xdf, 0x50, 0x8f, 0x75, 0xcb, 0xd5, 0xb7, 0xf0, 0x4d, 0x3d, 0xf0, 0xb6, 0x8c, 0x48, 0x5a, + 0x69, 0x26, 0x30, 0x5a, 0xd2, 0x7a, 0x46, 0xb7, 0xf2, 0x5f, 0x1c, 0xcc, 0x7b, 0x84, 0x66, 0x1a, + 0x74, 0x07, 0x90, 0x7c, 0x2c, 0x2b, 0x6d, 0xd9, 0x12, 0xcc, 0x2e, 0x0a, 0xb0, 0x22, 0xc1, 0x45, + 0x67, 0xc4, 0x26, 0x43, 0x7b, 0x30, 0xdf, 0x91, 0x4f, 0x94, 0x4e, 0xaf, 0x23, 0xb1, 0x7d, 0x36, + 0x94, 0x2f, 0xec, 0xca, 0xde, 0x72, 0xa0, 0xc2, 0x5d, 0x56, 0xcd, 0xfb, 0x6f, 0x93, 0x12, 0x37, + 0xb5, 0xc9, 0x8b, 0x8c, 0x98, 0x69, 0x90, 0xf2, 0x05, 0x26, 0x1c, 0x15, 0x35, 0xc0, 0x31, 0x3e, + 0x32, 0x47, 0x4a, 0xdc, 0xe7, 0x28, 0x08, 0xee, 0x78, 0x98, 0xad, 0xd9, 0xdf, 0xec, 0x69, 0xbb, + 0x23, 0xc6, 0x00, 0x0e, 0xdb, 0x9b, 0x9d, 0xd0, 0x86, 0xcf, 0xb5, 0xa0, 0xed, 0xb0, 0xee, 0x47, + 0x64, 0xef, 0xe7, 0x97, 0xb8, 0xdb, 0x8c, 0x03, 0xd8, 0xe8, 0x01, 0xc4, 0xf5, 0x6e, 0x93, 0xd9, + 0xf0, 0xef, 0x46, 0xe0, 0x9f, 0x13, 0xf7, 0x8a, 0xbb, 0x13, 0xa2, 0x45, 0xc5, 0x7f, 0x15, 0x87, + 0xb8, 0xb8, 0x57, 0x44, 0x1f, 0x78, 0x1a, 0x21, 0xb7, 0x47, 0xe4, 0xe2, 0xee, 0x83, 0xfc, 0x53, + 0x2c, 0xac, 0x11, 0x92, 0x85, 0x85, 0xa2, 0x58, 0xca, 0x37, 0x4a, 0xd2, 0x76, 0xa9, 0x52, 0x6a, + 0x94, 0x24, 0xda, 0xa8, 0xc9, 0x70, 0x68, 0x05, 0xb2, 0x7b, 0xfb, 0x85, 0x4a, 0xb9, 0xbe, 0x2b, + 0xed, 0x57, 0xed, 0x5f, 0x6c, 0x34, 0x86, 0x32, 0x30, 0x53, 0x29, 0xd7, 0x1b, 0x0c, 0x50, 0xcf, + 0xc4, 0x2d, 0xc8, 0x4e, 0xa9, 0x21, 0x15, 0xf3, 0x7b, 0xf9, 0x62, 0xb9, 0xf1, 0x3c, 0x93, 0x40, + 0x3c, 0x2c, 0x79, 0x79, 0xd7, 0xab, 0xf9, 0xbd, 0xfa, 0x6e, 0xad, 0x91, 0x49, 0x22, 0x04, 0x73, + 0x84, 0xde, 0x06, 0xd5, 0x33, 0x93, 0x16, 0x87, 0x62, 0xa5, 0x56, 0x75, 0x64, 0x98, 0x42, 0x0b, + 0x90, 0xb1, 0x67, 0x16, 0x4b, 0xf9, 0x6d, 0x52, 0xa4, 0x4b, 0xa1, 0x8b, 0x30, 0x5b, 0xfa, 0x78, + 0x2f, 0x5f, 0xdd, 0xb6, 0x11, 0xa7, 0xd1, 0x3a, 0xac, 0xb8, 0xc5, 0x91, 0x18, 0x55, 0x69, 0x9b, + 0x94, 0xea, 0xea, 0x19, 0x40, 0x97, 0x21, 0xc3, 0x7a, 0x50, 0xc5, 0x5a, 0x75, 0xbb, 0xdc, 0x28, + 0xd7, 0xaa, 0x99, 0x34, 0x6f, 0x69, 0x19, 0x9a, 0x07, 0xb0, 0x24, 0x67, 0xcc, 0x66, 0x6c, 0xe0, + 0x85, 0xfe, 0xb2, 0x1f, 0x95, 0xaa, 0xc5, 0x52, 0x66, 0xd6, 0xa9, 0x24, 0xff, 0x77, 0x0c, 0x16, + 0x69, 0x29, 0xd9, 0x2e, 0x5c, 0xdb, 0x2e, 0x6a, 0x03, 0x32, 0xb4, 0xf8, 0x25, 0xf9, 0x9d, 0xff, + 0x1c, 0x85, 0x3f, 0xb5, 0xd3, 0x0d, 0xbb, 0xed, 0x13, 0x73, 0xb5, 0x7d, 0xca, 0xfe, 0x94, 0xec, + 0x96, 0xb7, 0x41, 0xe2, 0x9b, 0x6d, 0x50, 0x1e, 0xf6, 0x24, 0x24, 0x3b, 0xb8, 0x33, 0x98, 0xdb, + 0xa0, 0xc8, 0xe9, 0x2c, 0x29, 0xfd, 0x19, 0x9d, 0xdb, 0x23, 0x58, 0xf2, 0xcb, 0xcb, 0x4c, 0xf8, + 0x76, 0xa0, 0x8d, 0xe1, 0x78, 0x5b, 0x07, 0xd7, 0xc1, 0x10, 0xfe, 0x9d, 0x83, 0x94, 0x0d, 0xb6, + 0xa2, 0x1a, 0xcb, 0x13, 0x79, 0xca, 0xa6, 0xd3, 0x16, 0xc4, 0xa9, 0xc2, 0xba, 0x1b, 0x10, 0x31, + 0x7f, 0x03, 0x22, 0xf4, 0x9c, 0xe3, 0xa1, 0xe7, 0xfc, 0x3e, 0xcc, 0x36, 0x2d, 0xf1, 0x15, 0x4d, + 0x95, 0x4c, 0xa5, 0x63, 0x57, 0x45, 0x83, 0x0d, 0xc3, 0x86, 0xdd, 0xe5, 0x17, 0x67, 0x6c, 0x02, + 0x0b, 0x84, 0xd6, 0x61, 0x86, 0x34, 0x10, 0x25, 0x53, 0x93, 0x7a, 0x06, 0xce, 0x26, 0x49, 0x62, + 0x0d, 0x04, 0xd6, 0xd0, 0xf6, 0x0d, 0x2c, 0xfc, 0x23, 0x07, 0x8b, 0xb4, 0xf4, 0xe5, 0x57, 0xc7, + 0x61, 0x8d, 0x14, 0xb7, 0xc6, 0xf9, 0x2e, 0xc1, 0x50, 0x86, 0xbf, 0x56, 0xed, 0x2e, 0x0b, 0x4b, + 0xfe, 0xf9, 0x58, 0x62, 0xff, 0x43, 0x0c, 0x16, 0xac, 0x88, 0xcc, 0x1e, 0x38, 0xef, 0xa0, 0x79, + 0x8c, 0x93, 0xf4, 0x6d, 0x66, 0x22, 0xb0, 0x99, 0xbb, 0xfe, 0xb4, 0xf9, 0xa6, 0x3b, 0xa6, 0xf4, + 0xaf, 0xe0, 0xd7, 0xda, 0xcb, 0xbf, 0xe3, 0x60, 0xd1, 0x37, 0x1f, 0xb3, 0x97, 0x77, 0xfd, 0x79, + 0xc0, 0xb5, 0x08, 0xf9, 0x5e, 0x29, 0x13, 0xb8, 0x67, 0x47, 0xe0, 0xe3, 0x99, 0xe5, 0xbf, 0xc5, + 0x60, 0xb5, 0x7f, 0x8d, 0x91, 0x16, 0x7e, 0x6b, 0x8c, 0xf2, 0xd6, 0xd9, 0x3a, 0xe5, 0x1f, 0xf9, + 0x1d, 0xee, 0x66, 0xf0, 0x66, 0x0d, 0x11, 0x69, 0x90, 0xe3, 0x0d, 0xad, 0x0a, 0x27, 0xc6, 0xad, + 0x0a, 0x9f, 0x49, 0x03, 0xfe, 0xd8, 0x5d, 0xf0, 0xf6, 0x8a, 0xcf, 0x34, 0x61, 0xc4, 0xce, 0xd1, + 0x7d, 0xb8, 0x44, 0x82, 0x7e, 0xe7, 0x05, 0x8a, 0xdd, 0x17, 0xa7, 0x2e, 0x31, 0x25, 0x2e, 0x5a, + 0xc3, 0xce, 0xb3, 0x0b, 0xd6, 0x2d, 0x69, 0x09, 0xbf, 0x24, 0x60, 0xc9, 0x4a, 0x0a, 0xea, 0xa6, + 0x7c, 0x34, 0x4e, 0x1f, 0xe1, 0xf7, 0x83, 0x65, 0xd9, 0x98, 0xf7, 0x58, 0xc2, 0xb9, 0x8e, 0x52, + 0x8d, 0x45, 0x39, 0x98, 0x37, 0x4c, 0xf9, 0x88, 0xb8, 0x03, 0x59, 0x3f, 0xc2, 0xa6, 0xd4, 0x95, + 0xcd, 0x97, 0xcc, 0xd6, 0x2f, 0xb2, 0xa1, 0x06, 0x19, 0xd9, 0x93, 0xcd, 0x97, 0xe7, 0x74, 0x90, + 0xe8, 0x43, 0xbf, 0x53, 0x78, 0x7d, 0xc8, 0x5a, 0x06, 0xe8, 0xd6, 0xc7, 0x11, 0xa5, 0xfb, 0x37, + 0x87, 0xb0, 0x1c, 0x5e, 0xb2, 0x3f, 0x7b, 0xa9, 0xfa, 0x37, 0xae, 0xfa, 0x5f, 0x86, 0x4b, 0x81, + 0xc5, 0xb3, 0x2b, 0xe4, 0x8f, 0x20, 0x6b, 0x0d, 0xed, 0xab, 0xc6, 0x98, 0xea, 0x18, 0xa1, 0x31, + 0xb1, 0x28, 0x8d, 0x59, 0x80, 0xe4, 0xa1, 0xa6, 0x37, 0x69, 0x7e, 0x93, 0x12, 0xe9, 0x87, 0xb0, + 0x0c, 0x97, 0x43, 0xa6, 0x67, 0xb2, 0xfd, 0x7d, 0x92, 0x0a, 0x37, 0x7e, 0x5b, 0xea, 0x93, 0x28, + 0x5b, 0x79, 0xdb, 0xad, 0x0c, 0xa1, 0x1d, 0x9c, 0x5f, 0xc3, 0x5a, 0xd6, 0x20, 0xed, 0xc6, 0x63, + 0x97, 0xa3, 0x39, 0xc4, 0x9c, 0x92, 0x67, 0xea, 0x96, 0x4d, 0xfa, 0xba, 0x65, 0x95, 0xbe, 0xa9, + 0x4d, 0x79, 0x03, 0xde, 0xc8, 0xad, 0x18, 0x60, 0x6c, 0x2f, 0x02, 0xc6, 0x96, 0xf2, 0xb6, 0xe0, + 0x22, 0x99, 0xfe, 0x3f, 0x30, 0x37, 0xa6, 0xd4, 0xa1, 0xbd, 0x31, 0xa1, 0x0b, 0x3c, 0xd5, 0xf8, + 0xf1, 0xbb, 0x55, 0x3e, 0x35, 0x8a, 0x05, 0xd4, 0x28, 0xdc, 0xc6, 0x56, 0x61, 0x39, 0x74, 0x46, + 0x26, 0xd0, 0x5f, 0x70, 0x54, 0x5c, 0xa7, 0x0c, 0x56, 0x37, 0x65, 0xd3, 0x18, 0x55, 0x20, 0x36, + 0xe8, 0x16, 0x88, 0x82, 0x88, 0x40, 0x63, 0x1a, 0x8a, 0xf0, 0x97, 0x1c, 0xdd, 0x1d, 0xbf, 0x2c, + 0xec, 0x66, 0xbe, 0x09, 0xc9, 0x1e, 0xa9, 0xf4, 0xd3, 0x08, 0x6d, 0xde, 0x6b, 0x1a, 0xfb, 0xd6, + 0x90, 0x48, 0x31, 0xce, 0xad, 0x76, 0x2a, 0xfc, 0xc0, 0x41, 0xda, 0xc5, 0x1f, 0xad, 0xc0, 0xb4, + 0x53, 0x1c, 0xb2, 0x73, 0x23, 0x07, 0x60, 0x9d, 0x80, 0xa9, 0x99, 0x72, 0x9b, 0xbd, 0x4d, 0xa1, + 0x1f, 0x56, 0x3a, 0xdb, 0x33, 0x30, 0x0d, 0x9d, 0xe3, 0x22, 0xf9, 0x8d, 0x6e, 0x43, 0xa2, 0xa7, + 0x2a, 0x26, 0x71, 0x06, 0x73, 0x7e, 0x2b, 0x27, 0x53, 0xe5, 0xf6, 0x55, 0xc5, 0x14, 0x09, 0x96, + 0x70, 0x0b, 0x12, 0xd6, 0x97, 0xb7, 0x3e, 0x31, 0x0d, 0xc9, 0xc2, 0xf3, 0x46, 0xa9, 0x9e, 0xe1, + 0x10, 0xc0, 0x64, 0x99, 0x66, 0xf3, 0x31, 0xa1, 0x62, 0x3f, 0x15, 0x75, 0x16, 0x61, 0x39, 0x06, + 0xf9, 0x40, 0xd5, 0xf4, 0x8e, 0xdc, 0x26, 0x32, 0xa7, 0x44, 0xe7, 0x3b, 0xba, 0x81, 0x42, 0xcb, + 0x8d, 0x2b, 0xce, 0x89, 0x84, 0x55, 0x93, 0x3e, 0xa5, 0xba, 0x15, 0x55, 0x47, 0xca, 0x87, 0xd6, + 0x91, 0x56, 0x3d, 0x37, 0xf2, 0x90, 0x0a, 0xd2, 0x77, 0x31, 0x58, 0x0c, 0xc5, 0x43, 0xf7, 0xdc, + 0xb5, 0xa3, 0xab, 0x03, 0x79, 0xba, 0xab, 0x46, 0x3f, 0x72, 0xb4, 0x6a, 0xb4, 0xe5, 0xa9, 0x1a, + 0xdd, 0x18, 0x4a, 0xef, 0xae, 0x17, 0xfd, 0x39, 0x17, 0x51, 0x2f, 0xaa, 0x37, 0xf2, 0x3b, 0x25, + 0x69, 0xbf, 0x4a, 0xff, 0x3a, 0xf5, 0xa2, 0x05, 0xc8, 0xf4, 0xab, 0x28, 0x52, 0xbd, 0x91, 0x6f, + 0xd4, 0x33, 0xb1, 0x60, 0xad, 0x26, 0x1e, 0x5a, 0x89, 0x49, 0x38, 0x45, 0x97, 0x47, 0x35, 0xb1, + 0x58, 0xea, 0x57, 0x9c, 0x32, 0x49, 0xa7, 0xe8, 0xb2, 0x00, 0x88, 0x9d, 0x83, 0xfb, 0x4d, 0xfb, + 0x5f, 0x73, 0x30, 0xef, 0x01, 0xb3, 0x63, 0x71, 0xb5, 0xbd, 0x39, 0x4f, 0xdb, 0xfb, 0x2e, 0x2c, + 0x58, 0x79, 0x23, 0xb5, 0x01, 0x43, 0xea, 0x62, 0x9d, 0x14, 0xb6, 0x99, 0x36, 0x5f, 0xec, 0xc8, + 0x27, 0xac, 0xf8, 0xbf, 0x87, 0x75, 0x8b, 0xf1, 0x39, 0x94, 0x77, 0x85, 0x6f, 0xe2, 0x34, 0x3a, + 0x19, 0x3b, 0xbb, 0x19, 0xea, 0x7d, 0x82, 0xe9, 0x4f, 0x7c, 0x8c, 0xf4, 0x27, 0xc2, 0x77, 0x25, + 0xc6, 0x0a, 0x89, 0xc7, 0xbf, 0xc3, 0xab, 0xfd, 0x7b, 0x9a, 0xc6, 0xaf, 0xb7, 0xdd, 0x9a, 0x39, + 0x34, 0xdf, 0x9a, 0xfc, 0xa6, 0xc0, 0x7d, 0x7b, 0x5e, 0xd9, 0x72, 0x9e, 0xc6, 0x5f, 0x67, 0xc8, + 0x92, 0x36, 0xff, 0x97, 0x83, 0x54, 0xb9, 0x85, 0x55, 0x93, 0xae, 0x6d, 0xd6, 0xf3, 0x6f, 0x0f, + 0x68, 0x25, 0xe2, 0xbf, 0x21, 0xc8, 0xc2, 0xf8, 0xd5, 0x81, 0xff, 0x2b, 0x21, 0x4c, 0xa0, 0x43, + 0xd7, 0xbf, 0x6c, 0x78, 0x3a, 0x18, 0xaf, 0x05, 0x28, 0x43, 0x9c, 0x17, 0x7f, 0x7d, 0x08, 0x96, + 0x33, 0xcf, 0x7d, 0x48, 0x92, 0x07, 0xee, 0x68, 0xc1, 0x79, 0x64, 0xef, 0x7a, 0xff, 0xce, 0x2f, + 0xfa, 0xa0, 0x36, 0xdd, 0xe6, 0xbf, 0x4c, 0x03, 0xf4, 0x93, 0x4d, 0xf4, 0x18, 0x66, 0xdc, 0x6f, + 0x6c, 0xd1, 0xf2, 0x80, 0x17, 0xde, 0xfc, 0x4a, 0xf8, 0xa0, 0x23, 0xd3, 0x63, 0x98, 0x71, 0xbf, + 0xe8, 0xea, 0x33, 0x0b, 0x79, 0x55, 0xd6, 0x67, 0x16, 0xfa, 0x08, 0x6c, 0x02, 0xb5, 0xe1, 0x52, + 0xc4, 0x9b, 0x1e, 0x74, 0x63, 0xb4, 0x97, 0x4f, 0xfc, 0xef, 0x46, 0x7c, 0x1c, 0x24, 0x4c, 0x20, + 0x1d, 0x2e, 0x47, 0x3e, 0x5a, 0x41, 0x1b, 0xa3, 0x3e, 0xb4, 0xe1, 0x6f, 0x8e, 0x80, 0xe9, 0xcc, + 0xd9, 0x03, 0x3e, 0xba, 0x53, 0x8e, 0x6e, 0x8e, 0xfc, 0x84, 0x83, 0xbf, 0x35, 0x7a, 0xe3, 0x5d, + 0x98, 0x40, 0xbb, 0x90, 0x76, 0xb5, 0x4c, 0x11, 0x1f, 0xda, 0x47, 0xa5, 0x8c, 0x97, 0x07, 0xf4, + 0x58, 0x29, 0x27, 0x57, 0x17, 0xab, 0xcf, 0x29, 0xd8, 0x8f, 0xeb, 0x73, 0x0a, 0x69, 0x7b, 0xf9, + 0xb7, 0xdf, 0x77, 0x73, 0x87, 0x6d, 0x7f, 0xf8, 0xd5, 0x1f, 0xb6, 0xfd, 0x11, 0x61, 0x80, 0x30, + 0x81, 0x3e, 0x82, 0x39, 0x6f, 0x9d, 0x1a, 0xad, 0x0e, 0xac, 0xb7, 0xf3, 0x57, 0xa2, 0x86, 0xdd, + 0x2c, 0xbd, 0x65, 0xd1, 0x3e, 0xcb, 0xd0, 0xf2, 0x6c, 0x9f, 0x65, 0x44, 0x35, 0x75, 0xc2, 0xf2, + 0x4f, 0x9e, 0x62, 0x5f, 0xdf, 0x3f, 0x85, 0xd5, 0x28, 0xfb, 0xfe, 0x29, 0xb4, 0x42, 0x28, 0x4c, + 0x20, 0x05, 0x96, 0xc2, 0x6b, 0x4d, 0xe8, 0xfa, 0x48, 0xa5, 0x34, 0xfe, 0xc6, 0x30, 0x34, 0x67, + 0xaa, 0x26, 0xcc, 0x87, 0x74, 0xb4, 0x91, 0x30, 0xb0, 0xdd, 0x4d, 0x27, 0xb9, 0x36, 0x42, 0x4b, + 0x5c, 0xb0, 0x42, 0x90, 0xcd, 0xff, 0x4c, 0x42, 0x82, 0x5c, 0xfb, 0x0d, 0xb8, 0xe0, 0x2b, 0x28, + 0xa0, 0x2b, 0x83, 0xcb, 0x2c, 0xfc, 0x5a, 0xe4, 0xb8, 0xb3, 0x86, 0x17, 0x70, 0x31, 0x50, 0x0c, + 0x40, 0xeb, 0x6e, 0xba, 0xb0, 0x32, 0x05, 0x7f, 0x75, 0x00, 0x86, 0x9f, 0xb7, 0xd7, 0xb7, 0xad, + 0x0f, 0xcb, 0x56, 0xbd, 0xbc, 0xa3, 0xfc, 0xd9, 0xa7, 0x34, 0xca, 0xf2, 0x7b, 0x32, 0xc1, 0x2b, + 0x57, 0xa8, 0x0f, 0xbb, 0x36, 0x10, 0xc7, 0x99, 0xe1, 0x13, 0x27, 0xbc, 0x73, 0xa5, 0x45, 0xc8, + 0x23, 0x5c, 0x68, 0xfa, 0xc6, 0x0b, 0x83, 0x50, 0x1c, 0xf6, 0xcf, 0x20, 0xe3, 0xbf, 0xe7, 0xd1, + 0xda, 0x90, 0xb0, 0x83, 0x5f, 0x8f, 0x46, 0xf0, 0xef, 0x8c, 0xdf, 0xc9, 0xf8, 0xa5, 0x0a, 0x73, + 0x2f, 0xd7, 0x06, 0xe2, 0xb8, 0xdd, 0xa2, 0x2b, 0xc2, 0xed, 0xbb, 0xc5, 0x60, 0x34, 0xdc, 0x77, + 0x8b, 0x21, 0x21, 0xb1, 0x30, 0xb1, 0xf5, 0x10, 0x40, 0x6e, 0x77, 0x5f, 0xca, 0x12, 0x56, 0x7b, + 0x1d, 0xb4, 0x12, 0x68, 0x41, 0x95, 0xd4, 0x5e, 0xa7, 0xd6, 0xb5, 0xd2, 0x29, 0x23, 0xfb, 0x37, + 0x29, 0x92, 0x44, 0x4d, 0x13, 0x02, 0x6b, 0x60, 0xab, 0x02, 0x99, 0x3e, 0xb5, 0x44, 0x42, 0x28, + 0x74, 0x35, 0x94, 0x07, 0x69, 0xe1, 0xfb, 0x18, 0xcd, 0x39, 0x8c, 0xc8, 0xe8, 0xd6, 0xbb, 0x00, + 0x4d, 0x43, 0x91, 0x68, 0x0c, 0x87, 0x56, 0x03, 0x7c, 0x1e, 0x29, 0xb8, 0xdd, 0xb2, 0x79, 0x7c, + 0xc7, 0x84, 0x69, 0x1a, 0x0a, 0x8d, 0xf4, 0xb6, 0xde, 0x87, 0x34, 0x15, 0xe6, 0xd0, 0xc2, 0x1b, + 0x46, 0xcf, 0x64, 0xa0, 0xab, 0x27, 0x23, 0x5b, 0x25, 0x98, 0xa5, 0x0c, 0x58, 0x2a, 0x88, 0xd6, + 0x02, 0x2c, 0x9e, 0xd0, 0x11, 0x1f, 0x93, 0x19, 0x42, 0xc6, 0xc6, 0xb6, 0x0a, 0x30, 0x63, 0xb3, + 0x31, 0x5f, 0x6a, 0x2d, 0x74, 0x25, 0x84, 0x8b, 0x35, 0xe0, 0x63, 0x92, 0x66, 0x4c, 0xac, 0xa1, + 0xbe, 0x28, 0xf6, 0xff, 0x7e, 0x06, 0x45, 0x61, 0xe9, 0x5a, 0xa8, 0x28, 0x6c, 0xac, 0x90, 0x7c, + 0x11, 0x6f, 0x1a, 0xca, 0xc1, 0x24, 0x21, 0x7a, 0xeb, 0xff, 0x02, 0x00, 0x00, 0xff, 0xff, 0x4f, + 0x40, 0xf2, 0xcc, 0xa8, 0x3c, 0x00, 0x00, } // Reference imports to suppress errors if they are not otherwise used. diff --git a/spec.md b/spec.md index ce415da7..6d442813 100644 --- a/spec.md +++ b/spec.md @@ -164,48 +164,52 @@ capability. ### Volume Lifecycle ``` - CreateVolume +------------+ DeleteVolume - +------------->| CREATED +--------------+ - | +---+----^---+ | - | Controller | | Controller v -+++ Publish | | Unpublish +++ -|X| Volume | | Volume | | -+-+ +---v----+---+ +-+ - | NODE_READY | - +---+----^---+ - Node | | Node - Publish | | Unpublish - Volume | | Volume - +---v----+---+ - | PUBLISHED | - +------------+ + CreateVolume +------------+ DeleteVolume + +------------->| CREATED +------------------------+ + | | +<-----------+ | + | +---+----^---+ | | + | Controller | | Controller | v ++++ Publish | | Unpublish | +++ +|X| Volume | | Volume | | | ++-+ +---v----+---+ | +-+ + | NODE_READY | | + +---+----^---+ | Node + Node | | Node | Unpublish + Publish | | Unpublish | Volume + Volume | | Volume | (forced) + +---v----+---+ +----+--------+ + | PUBLISHED +------>| QUARANTINED | + +------------+ +-------------+ + ControllerUnpublishVolume(fenced) Figure 5: The lifecycle of a dynamically provisioned volume, from creation to destruction. ``` ``` - CreateVolume +------------+ DeleteVolume - +------------->| CREATED +--------------+ - | +---+----^---+ | - | Controller | | Controller v -+++ Publish | | Unpublish +++ -|X| Volume | | Volume | | -+-+ +---v----+---+ +-+ - | NODE_READY | - +---+----^---+ - Node | | Node - Stage | | Unstage - Volume | | Volume - +---v----+---+ - | VOL_READY | - +---+----^---+ - Node | | Node - Publish | | Unpublish - Volume | | Volume - +---v----+---+ - | PUBLISHED | - +------------+ + CreateVolume +------------+ DeleteVolume + +------------->| CREATED +--------------------------+ + | | +<-----------+ | + | +---+----^---+ | | + | Controller | | Controller | v ++++ Publish | | Unpublish | +++ +|X| Volume | | Volume | | | ++-+ +---v----+---+ | +-+ + | NODE_READY | | Node + +---+----^---+ | Unstage + Node | | Node | Volume + Stage | | Unstage | (forced) + Volume | | Volume +--------------+ + +---v----+---+ | QUARANTINED2 | + | VOL_READY | +---^----------+ + +---+----^---+ | Node + Node | | Node | Unpublish + Publish | | Unpublish | Volume + Volume | | Volume | (forced) + +---v----+---+ +----+---------+ + | PUBLISHED +------>| QUARANTINED3 | + +------------+ +--------------+ + ControllerUnpublishVolume(fenced) Figure 6: The lifecycle of a dynamically provisioned volume, from creation to destruction, when the Node Plugin advertises the @@ -1293,10 +1297,15 @@ The CO MUST implement the specified error recovery behavior when it encounters t Controller Plugin MUST implement this RPC call if it has `PUBLISH_UNPUBLISH_VOLUME` controller capability. This RPC is a reverse operation of `ControllerPublishVolume`. -It MUST be called after all `NodeUnstageVolume` and `NodeUnpublishVolume` on the volume are called and succeed. +It MUST be called after all `NodeUnstageVolume` and `NodeUnpublishVolume` on the volume are called and succeed unless the plugin has the `UNPUBLISH_FENCE` capability. The Plugin SHOULD perform the work that is necessary for making the volume ready to be consumed by a different node. The Plugin MUST NOT assume that this RPC will be executed on the node where the volume was previously used. +If the plugin has the `UNPUBLISH_FENCE` capability, the CO MAY specify `fence` as `true`, in which case the SP MUST ensure that the node may no longer access the volume before returning a successful response. +This results in a transition into one of the `QUARANTINE` states where the node must be cleaned up without being able to access the volume like usual. +This is intended cut off an unreachable node from accessing volumes so those volumes may be safely published to another node. +Once in one of the `QUARANTINE` states the volume MAY NOT be published to that node again until appropriate cleanup has happened using `NodeUnpublishVolume` and `NodeUnstageVolume` (if applicable). + This RPC is typically called by the CO when the workload using the volume is being moved to a different node, or all the workload using the volume on a node has finished. This operation MUST be idempotent. @@ -1322,6 +1331,17 @@ message ControllerUnpublishVolumeRequest { // This field is OPTIONAL. Refer to the `Secrets Requirements` // section on how to use this field. map secrets = 3 [(csi_secret) = true]; + + // Indicates SP MUST make the volume inacessible to the node or nodes + // it is being unpublished from. Any attempt to read or write data + // to a volume from a node that has been fenced MUST NOT succeed, + // even if the volume remains staged and/or published on the node. + // CO MUST NOT set this field to true unless SP has the + // UNPUBLISH_FENCE controller capability. + // The SP MAY make the volume inaccessible even when this field is + // false. + // This is an OPTIONAL field. + bool fence = 4; } message ControllerUnpublishVolumeResponse { @@ -2161,9 +2181,13 @@ This RPC is a reverse operation of `NodeStageVolume`. This RPC MUST undo the work by the corresponding `NodeStageVolume`. This RPC SHALL be called by the CO once for each `staging_target_path` that was successfully setup via `NodeStageVolume`. -If the corresponding Controller Plugin has `PUBLISH_UNPUBLISH_VOLUME` controller capability and the Node Plugin has `STAGE_UNSTAGE_VOLUME` capability, the CO MUST guarantee that this RPC is called and returns success before calling `ControllerUnpublishVolume` for the given node and the given volume. +If the corresponding Controller Plugin has `PUBLISH_UNPUBLISH_VOLUME` controller capability and the Node Plugin has `STAGE_UNSTAGE_VOLUME` capability, the CO MUST guarantee that this RPC is called and returns success before calling `ControllerUnpublishVolume` for the given node and the given volume, unless the Controller Plugin has `UNPUBLISH_FENCE` capability and the Node Plugin has the `FORCE_UNPUBLISH` capability and the `force` flag is `true`. The CO MUST guarantee that this RPC is called after all `NodeUnpublishVolume` have been called and returned success for the given volume on the given node. +If the Node Plugin has the `FORCE_UNPUBLISH` capability, the CO MAY specify `force` as `true` in which case the Node Plugin MUST support unstaging volumes even when access has been revoked with `ControllerUnpublishVolume`. +Because data loss is inevitable in such circumstances, the `force` flag is an indication that success is desired even it if means losing data. +It is essential that after a successful call to `NodeUnstageVolume` that there be no buffered data on the node related to the volume which might result in unintetional modification of the volume if it were to be subsequently re-staged to that node. + The Plugin SHALL assume that this RPC will be executed on the node where the volume is being used. This RPC MAY be called by the CO when the workload using the volume is being moved to a different node, or all the workloads using the volume on a node have finished. @@ -2186,6 +2210,13 @@ message NodeUnstageVolumeRequest { // system/filesystem, but, at a minimum, SP MUST accept a max path // length of at least 128 bytes. string staging_target_path = 2; + + // Indicates that the SP should prefer to successfully unstage the + // volume, even if data loss would occur as a result. + // CO MUST NOT set this field to true unless SP has the + // FORCE_UNPUBLISH node capability. + // This in an OPTIONAL field. + bool force = 3; } message NodeUnstageVolumeResponse { @@ -2323,9 +2354,13 @@ A Node Plugin MUST implement this RPC call. This RPC is a reverse operation of `NodePublishVolume`. This RPC MUST undo the work by the corresponding `NodePublishVolume`. This RPC SHALL be called by the CO at least once for each `target_path` that was successfully setup via `NodePublishVolume`. -If the corresponding Controller Plugin has `PUBLISH_UNPUBLISH_VOLUME` controller capability, the CO SHOULD issue all `NodeUnpublishVolume` (as specified above) before calling `ControllerUnpublishVolume` for the given node and the given volume. +If the corresponding Controller Plugin has `PUBLISH_UNPUBLISH_VOLUME` controller capability, the CO SHOULD issue all `NodeUnpublishVolume` (as specified above) before calling `ControllerUnpublishVolume` for the given node and the given volume, unless the Controller Plugin has `UNPUBLISH_FENCE` capability and the Node Plugin has the `FORCE_UNPUBLISH` capability and the `force` flag is `true`. The Plugin SHALL assume that this RPC will be executed on the node where the volume is being used. +If the Node Plugin has the `FORCE_UNPUBLISH` capability, the CO MAY specify `force` as `true` in which case the Node Plugin MUST support unpublishing volumes even when access has been revoked with `ControllerUnpublishVolume`. +Because data loss is inevitable in such circumstances, the `force` flag is an indication that success is desired even it if means losing data. +It is essential that after a successful call to `NodeUnpublishVolume` that there be no buffered data on the node related to the volume which might result in unintetional modification of the volume if it were to be subsequently re-published to that node. + This RPC is typically called by the CO when the workload using the volume is being moved to a different node, or all the workload using the volume on a node has finished. This operation MUST be idempotent. @@ -2345,6 +2380,13 @@ message NodeUnpublishVolumeRequest { // system/filesystem, but, at a minimum, SP MUST accept a max path // length of at least 128 bytes. string target_path = 2; + + // Indicates that the SP should prefer to successfully unpublish the + // volume, even if data loss would occur as a result. + // CO MUST NOT set this field to true unless SP has the + // FORCE_UNPUBLISH node capability. + // This in an OPTIONAL field. + bool force = 3; } message NodeUnpublishVolumeResponse {