From 5e753cc0d740ff0f640ae63670219484e72baf63 Mon Sep 17 00:00:00 2001 From: Akash Jain Date: Fri, 23 Oct 2020 13:09:40 +0530 Subject: [PATCH] feat(Dgraph): Online restores allows to restore a specific backup. (#6411) (#6742) Currently online restores will restore the entire backup series. This PR allows to restore the backup series up to a specific backup. Fixes DGRAPH-1648 Co-authored-by: Martin Martinez Rivera --- graphql/admin/endpoints_ee.go | 12 +- graphql/admin/restore.go | 14 +- protos/pb.proto | 2 + protos/pb/pb.pb.go | 624 ++++++++++-------- systest/online-restore/online_restore_test.go | 95 ++- testutil/json.go | 6 +- worker/backup_handler.go | 68 +- worker/file_handler.go | 29 +- worker/online_restore_ee.go | 8 +- worker/restore.go | 2 +- worker/s3_handler.go | 29 +- 11 files changed, 515 insertions(+), 374 deletions(-) diff --git a/graphql/admin/endpoints_ee.go b/graphql/admin/endpoints_ee.go index 5880e5277b5..843461db1a5 100644 --- a/graphql/admin/endpoints_ee.go +++ b/graphql/admin/endpoints_ee.go @@ -69,6 +69,12 @@ const adminTypes = ` """ backupId: String + """ + Number of the backup within the backup series to be restored. Backups with a greater value + will be ignored. If the value is missing, the entire series will be restored. + """ + backupNum: Int + """ Path to the key file needed to decrypt the backup. This file should be accessible by all alphas in the group. The backup will be written using the encryption key @@ -114,17 +120,17 @@ const adminTypes = ` """ Secret key credential for the destination. - """ + """ secretKey: String """ AWS session token, if required. - """ + """ sessionToken: String """ Set to true to allow backing up to S3 or Minio bucket that requires no credentials. - """ + """ anonymous: Boolean } diff --git a/graphql/admin/restore.go b/graphql/admin/restore.go index f21941ad141..8ecfde5cc91 100644 --- a/graphql/admin/restore.go +++ b/graphql/admin/restore.go @@ -24,11 +24,13 @@ import ( "github.com/dgraph-io/dgraph/graphql/schema" "github.com/dgraph-io/dgraph/protos/pb" "github.com/dgraph-io/dgraph/worker" + "github.com/pkg/errors" ) type restoreInput struct { Location string BackupId string + BackupNum int EncryptionKeyFile string AccessKey string SecretKey string @@ -51,6 +53,7 @@ func resolveRestore(ctx context.Context, m schema.Mutation) (*resolve.Resolved, req := pb.RestoreRequest{ Location: input.Location, BackupId: input.BackupId, + BackupNum: uint64(input.BackupNum), EncryptionKeyFile: input.EncryptionKeyFile, AccessKey: input.AccessKey, SecretKey: input.SecretKey, @@ -93,6 +96,13 @@ func getRestoreInput(m schema.Mutation) (*restoreInput, error) { } var input restoreInput - err = json.Unmarshal(inputByts, &input) - return &input, schema.GQLWrapf(err, "couldn't get input argument") + if err := json.Unmarshal(inputByts, &input); err != nil { + return nil, schema.GQLWrapf(err, "couldn't get input argument") + } + + if input.BackupNum < 0 { + err := errors.Errorf("backupNum value should be equal or greater than zero") + return nil, schema.GQLWrapf(err, "couldn't get input argument") + } + return &input, nil } diff --git a/protos/pb.proto b/protos/pb.proto index 5b3a05e9ce6..db19b5940f1 100644 --- a/protos/pb.proto +++ b/protos/pb.proto @@ -287,6 +287,8 @@ message RestoreRequest { string vault_path = 13; string vault_field = 14; string vault_format = 15; + + uint64 backup_num = 16; } message Proposal { diff --git a/protos/pb/pb.pb.go b/protos/pb/pb.pb.go index 506fd8b77e1..68f752d21ff 100644 --- a/protos/pb/pb.pb.go +++ b/protos/pb/pb.pb.go @@ -2160,6 +2160,7 @@ type RestoreRequest struct { VaultPath string `protobuf:"bytes,13,opt,name=vault_path,json=vaultPath,proto3" json:"vault_path,omitempty"` VaultField string `protobuf:"bytes,14,opt,name=vault_field,json=vaultField,proto3" json:"vault_field,omitempty"` VaultFormat string `protobuf:"bytes,15,opt,name=vault_format,json=vaultFormat,proto3" json:"vault_format,omitempty"` + BackupNum uint64 `protobuf:"varint,16,opt,name=backup_num,json=backupNum,proto3" json:"backup_num,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` @@ -2303,6 +2304,13 @@ func (m *RestoreRequest) GetVaultFormat() string { return "" } +func (m *RestoreRequest) GetBackupNum() uint64 { + if m != nil { + return m.BackupNum + } + return 0 +} + type Proposal struct { Mutations *Mutations `protobuf:"bytes,2,opt,name=mutations,proto3" json:"mutations,omitempty"` Kv []*pb.KV `protobuf:"bytes,4,rep,name=kv,proto3" json:"kv,omitempty"` @@ -5029,299 +5037,300 @@ func init() { func init() { proto.RegisterFile("pb.proto", fileDescriptor_f80abaa17e25ccc8) } var fileDescriptor_f80abaa17e25ccc8 = []byte{ - // 4667 bytes of a gzipped FileDescriptorProto - 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xd4, 0x3a, 0x4d, 0x6f, 0x1c, 0x47, - 0x76, 0x9a, 0x9e, 0xcf, 0x7e, 0xf3, 0xa1, 0x51, 0x49, 0xab, 0x9d, 0x1d, 0xd9, 0x22, 0xdd, 0xb6, - 0x6c, 0xda, 0xb2, 0x28, 0x99, 0xde, 0x20, 0x6b, 0x2f, 0x02, 0x84, 0x14, 0x87, 0x32, 0x2d, 0x8a, - 0xa4, 0x7b, 0x86, 0xf2, 0xae, 0x0f, 0x19, 0xd4, 0x74, 0x17, 0xc9, 0x5e, 0xf6, 0x74, 0xf7, 0x76, - 0xf7, 0x70, 0x87, 0x3e, 0x25, 0x08, 0x92, 0x53, 0x72, 0x49, 0x10, 0x64, 0x4f, 0x49, 0xfe, 0x41, - 0x80, 0x9c, 0x82, 0x9c, 0x83, 0x20, 0xc8, 0x21, 0xc8, 0x2f, 0x50, 0x02, 0x27, 0x27, 0x01, 0x39, - 0x04, 0x01, 0x72, 0x0c, 0x82, 0xf7, 0xaa, 0xfa, 0x6b, 0x38, 0x94, 0xec, 0x05, 0xf6, 0x90, 0x53, - 0xd7, 0x7b, 0xaf, 0x3e, 0x5f, 0xbd, 0xef, 0x6a, 0x68, 0x04, 0x93, 0xf5, 0x20, 0xf4, 0x63, 0x9f, - 0x69, 0xc1, 0xa4, 0xaf, 0xf3, 0xc0, 0x91, 0x60, 0xff, 0x83, 0x13, 0x27, 0x3e, 0x9d, 0x4d, 0xd6, - 0x2d, 0x7f, 0xfa, 0xd0, 0x3e, 0x09, 0x79, 0x70, 0xfa, 0xc0, 0xf1, 0x1f, 0x4e, 0xb8, 0x7d, 0x22, - 0xc2, 0x87, 0xe7, 0x1b, 0x0f, 0x83, 0xc9, 0xc3, 0x64, 0x68, 0xff, 0x41, 0xae, 0xef, 0x89, 0x7f, - 0xe2, 0x3f, 0x24, 0xf4, 0x64, 0x76, 0x4c, 0x10, 0x01, 0xd4, 0x92, 0xdd, 0x8d, 0x3e, 0x54, 0xf6, - 0x9c, 0x28, 0x66, 0x0c, 0x2a, 0x33, 0xc7, 0x8e, 0x7a, 0xa5, 0xd5, 0xf2, 0x5a, 0xcd, 0xa4, 0xb6, - 0xf1, 0x0c, 0xf4, 0x11, 0x8f, 0xce, 0x9e, 0x73, 0x77, 0x26, 0x58, 0x17, 0xca, 0xe7, 0xdc, 0xed, - 0x95, 0x56, 0x4b, 0x6b, 0x2d, 0x13, 0x9b, 0x6c, 0x1d, 0x1a, 0xe7, 0xdc, 0x1d, 0xc7, 0x17, 0x81, - 0xe8, 0x69, 0xab, 0xa5, 0xb5, 0xce, 0xc6, 0xcd, 0xf5, 0x60, 0xb2, 0x7e, 0xe8, 0x47, 0xb1, 0xe3, - 0x9d, 0xac, 0x3f, 0xe7, 0xee, 0xe8, 0x22, 0x10, 0x66, 0xfd, 0x5c, 0x36, 0x8c, 0x03, 0x68, 0x0e, - 0x43, 0x6b, 0x67, 0xe6, 0x59, 0xb1, 0xe3, 0x7b, 0xb8, 0xa2, 0xc7, 0xa7, 0x82, 0x66, 0xd4, 0x4d, - 0x6a, 0x23, 0x8e, 0x87, 0x27, 0x51, 0xaf, 0xbc, 0x5a, 0x46, 0x1c, 0xb6, 0x59, 0x0f, 0xea, 0x4e, - 0xf4, 0xd8, 0x9f, 0x79, 0x71, 0xaf, 0xb2, 0x5a, 0x5a, 0x6b, 0x98, 0x09, 0x68, 0xfc, 0x65, 0x19, - 0xaa, 0x5f, 0xcc, 0x44, 0x78, 0x41, 0xe3, 0xe2, 0x38, 0x4c, 0xe6, 0xc2, 0x36, 0xbb, 0x05, 0x55, - 0x97, 0x7b, 0x27, 0x51, 0x4f, 0xa3, 0xc9, 0x24, 0xc0, 0xee, 0x80, 0xce, 0x8f, 0x63, 0x11, 0x8e, - 0x67, 0x8e, 0xdd, 0x2b, 0xaf, 0x96, 0xd6, 0x6a, 0x66, 0x83, 0x10, 0x47, 0x8e, 0xcd, 0x7e, 0x00, - 0x0d, 0xdb, 0x1f, 0x5b, 0xf9, 0xb5, 0x6c, 0x9f, 0xd6, 0x62, 0x6f, 0x43, 0x63, 0xe6, 0xd8, 0x63, - 0xd7, 0x89, 0xe2, 0x5e, 0x75, 0xb5, 0xb4, 0xd6, 0xdc, 0x68, 0xe0, 0x61, 0x91, 0x77, 0x66, 0x7d, - 0xe6, 0xd8, 0xc4, 0xc4, 0x0f, 0xa0, 0x11, 0x85, 0xd6, 0xf8, 0x78, 0xe6, 0x59, 0xbd, 0x1a, 0x75, - 0xba, 0x8e, 0x9d, 0x72, 0xa7, 0x36, 0xeb, 0x91, 0x04, 0xf0, 0x58, 0xa1, 0x38, 0x17, 0x61, 0x24, - 0x7a, 0x75, 0xb9, 0x94, 0x02, 0xd9, 0x23, 0x68, 0x1e, 0x73, 0x4b, 0xc4, 0xe3, 0x80, 0x87, 0x7c, - 0xda, 0x6b, 0x64, 0x13, 0xed, 0x20, 0xfa, 0x10, 0xb1, 0x91, 0x09, 0xc7, 0x29, 0xc0, 0x3e, 0x86, - 0x36, 0x41, 0xd1, 0xf8, 0xd8, 0x71, 0x63, 0x11, 0xf6, 0x74, 0x1a, 0xd3, 0xa1, 0x31, 0x84, 0x19, - 0x85, 0x42, 0x98, 0x2d, 0xd9, 0x49, 0x62, 0xd8, 0x9b, 0x00, 0x62, 0x1e, 0x70, 0xcf, 0x1e, 0x73, - 0xd7, 0xed, 0x01, 0xed, 0x41, 0x97, 0x98, 0x4d, 0xd7, 0x65, 0xdf, 0xc7, 0xfd, 0x71, 0x7b, 0x1c, - 0x47, 0xbd, 0xf6, 0x6a, 0x69, 0xad, 0x62, 0xd6, 0x10, 0x1c, 0x45, 0xc8, 0x57, 0x8b, 0x5b, 0xa7, - 0xa2, 0xd7, 0x59, 0x2d, 0xad, 0x55, 0x4d, 0x09, 0x20, 0xf6, 0xd8, 0x09, 0xa3, 0xb8, 0x77, 0x5d, - 0x62, 0x09, 0x30, 0x36, 0x40, 0x27, 0xe9, 0x21, 0xee, 0xdc, 0x83, 0xda, 0x39, 0x02, 0x52, 0xc8, - 0x9a, 0x1b, 0x6d, 0xdc, 0x5e, 0x2a, 0x60, 0xa6, 0x22, 0x1a, 0x77, 0xa1, 0xb1, 0xc7, 0xbd, 0x93, - 0x44, 0x2a, 0xf1, 0xda, 0x68, 0x80, 0x6e, 0x52, 0xdb, 0xf8, 0xa5, 0x06, 0x35, 0x53, 0x44, 0x33, - 0x37, 0x66, 0xef, 0x01, 0xe0, 0xa5, 0x4c, 0x79, 0x1c, 0x3a, 0x73, 0x35, 0x6b, 0x76, 0x2d, 0xfa, - 0xcc, 0xb1, 0x9f, 0x11, 0x89, 0x3d, 0x82, 0x16, 0xcd, 0x9e, 0x74, 0xd5, 0xb2, 0x0d, 0xa4, 0xfb, - 0x33, 0x9b, 0xd4, 0x45, 0x8d, 0xb8, 0x0d, 0x35, 0x92, 0x03, 0x29, 0x8b, 0x6d, 0x53, 0x41, 0xec, - 0x1e, 0x74, 0x1c, 0x2f, 0xc6, 0x7b, 0xb2, 0xe2, 0xb1, 0x2d, 0xa2, 0x44, 0x50, 0xda, 0x29, 0x76, - 0x5b, 0x44, 0x31, 0xfb, 0x08, 0x24, 0xb3, 0x93, 0x05, 0xab, 0xb4, 0x60, 0x27, 0xbd, 0xc4, 0x48, - 0xae, 0x48, 0x7d, 0xd4, 0x8a, 0x0f, 0xa0, 0x89, 0xe7, 0x4b, 0x46, 0xd4, 0x68, 0x44, 0x8b, 0x4e, - 0xa3, 0xd8, 0x61, 0x02, 0x76, 0x50, 0xdd, 0x91, 0x35, 0x28, 0x8c, 0x52, 0x78, 0xa8, 0x6d, 0x0c, - 0xa0, 0x7a, 0x10, 0xda, 0x22, 0x5c, 0xaa, 0x0f, 0x0c, 0x2a, 0xb6, 0x88, 0x2c, 0x52, 0xd5, 0x86, - 0x49, 0xed, 0x4c, 0x47, 0xca, 0x39, 0x1d, 0x31, 0xfe, 0xa2, 0x04, 0xcd, 0xa1, 0x1f, 0xc6, 0xcf, - 0x44, 0x14, 0xf1, 0x13, 0xc1, 0x56, 0xa0, 0xea, 0xe3, 0xb4, 0x8a, 0xc3, 0x3a, 0xee, 0x89, 0xd6, - 0x31, 0x25, 0x7e, 0xe1, 0x1e, 0xb4, 0xab, 0xef, 0x01, 0x65, 0x87, 0xb4, 0xab, 0xac, 0x64, 0x87, - 0x74, 0xeb, 0x36, 0xd4, 0xfc, 0xe3, 0xe3, 0x48, 0x48, 0x5e, 0x56, 0x4d, 0x05, 0x5d, 0x29, 0x82, - 0xc6, 0x6f, 0x00, 0xe0, 0xfe, 0xbe, 0xa3, 0x14, 0x18, 0xa7, 0xd0, 0x34, 0xf9, 0x71, 0xfc, 0xd8, - 0xf7, 0x62, 0x31, 0x8f, 0x59, 0x07, 0x34, 0xc7, 0x26, 0x16, 0xd5, 0x4c, 0xcd, 0xb1, 0x71, 0x73, - 0x27, 0xa1, 0x3f, 0x0b, 0x88, 0x43, 0x6d, 0x53, 0x02, 0xc4, 0x4a, 0xdb, 0x0e, 0x69, 0xc7, 0xc8, - 0x4a, 0xdb, 0x0e, 0xd9, 0x0a, 0x34, 0x23, 0x8f, 0x07, 0xd1, 0xa9, 0x1f, 0xe3, 0xe6, 0x2a, 0xb4, - 0x39, 0x48, 0x50, 0xa3, 0xc8, 0xf8, 0x4f, 0x0d, 0x6a, 0xcf, 0xc4, 0x74, 0x22, 0xc2, 0x4b, 0xab, - 0x3c, 0x82, 0x06, 0x4d, 0x3c, 0x76, 0x6c, 0xb9, 0xd0, 0xd6, 0xf7, 0x5e, 0xbe, 0x58, 0xb9, 0x41, - 0xb8, 0x5d, 0xfb, 0x43, 0x7f, 0xea, 0xc4, 0x62, 0x1a, 0xc4, 0x17, 0x66, 0x5d, 0xa1, 0x96, 0xee, - 0xe0, 0x36, 0xd4, 0x5c, 0xc1, 0xf1, 0x4e, 0xa4, 0xf8, 0x29, 0x88, 0x3d, 0x80, 0x3a, 0x9f, 0x8e, - 0x6d, 0xc1, 0x6d, 0xb2, 0x52, 0x8d, 0xad, 0x5b, 0x2f, 0x5f, 0xac, 0x74, 0xf9, 0x74, 0x5b, 0xf0, - 0xfc, 0xdc, 0x35, 0x89, 0x61, 0x9f, 0xa0, 0xcc, 0x45, 0xf1, 0x78, 0x16, 0xd8, 0x3c, 0x16, 0x64, - 0xb3, 0x2a, 0x5b, 0xbd, 0x97, 0x2f, 0x56, 0x6e, 0x21, 0xfa, 0x88, 0xb0, 0xb9, 0x61, 0x90, 0x61, - 0xd9, 0x2e, 0xdc, 0xb0, 0xdc, 0x59, 0x84, 0xa6, 0xd4, 0xf1, 0x8e, 0xfd, 0xb1, 0xef, 0xb9, 0x17, - 0x74, 0x4d, 0x8d, 0xad, 0x37, 0x5f, 0xbe, 0x58, 0xf9, 0x81, 0x22, 0xee, 0x7a, 0xc7, 0xfe, 0x81, - 0xe7, 0x5e, 0xe4, 0x66, 0xb9, 0xbe, 0x40, 0x62, 0xbf, 0x0d, 0x9d, 0x63, 0x3f, 0xb4, 0xc4, 0x38, - 0x65, 0x4c, 0x87, 0xe6, 0xe9, 0xbf, 0x7c, 0xb1, 0x72, 0x9b, 0x28, 0x4f, 0x2e, 0x71, 0xa7, 0x95, - 0xc7, 0x1b, 0x7f, 0xab, 0x41, 0x95, 0xda, 0xec, 0x11, 0xd4, 0xa7, 0xc4, 0xf8, 0xc4, 0xca, 0xdc, - 0x46, 0x49, 0x20, 0xda, 0xba, 0xbc, 0x91, 0x68, 0xe0, 0xc5, 0xe1, 0x85, 0x99, 0x74, 0xc3, 0x11, - 0x31, 0x9f, 0xb8, 0x22, 0x8e, 0x94, 0xe4, 0xe6, 0x46, 0x8c, 0x24, 0x41, 0x8d, 0x50, 0xdd, 0x16, - 0xaf, 0xbf, 0xbc, 0x78, 0xfd, 0xac, 0x0f, 0x0d, 0xeb, 0x54, 0x58, 0x67, 0xd1, 0x6c, 0xaa, 0x84, - 0x23, 0x85, 0xfb, 0x3b, 0xd0, 0xca, 0xef, 0x03, 0xfd, 0xea, 0x99, 0xb8, 0x20, 0x01, 0xa9, 0x98, - 0xd8, 0x64, 0xab, 0x50, 0x25, 0x4b, 0x44, 0xe2, 0xd1, 0xdc, 0x00, 0xdc, 0x8e, 0x1c, 0x62, 0x4a, - 0xc2, 0xa7, 0xda, 0x8f, 0x4a, 0x38, 0x4f, 0x7e, 0x77, 0xf9, 0x79, 0xf4, 0xab, 0xe7, 0x91, 0x43, - 0x72, 0xf3, 0x18, 0x3e, 0xd4, 0xf7, 0x1c, 0x4b, 0x78, 0x11, 0x79, 0xdf, 0x59, 0x24, 0x52, 0xab, - 0x81, 0x6d, 0x3c, 0xca, 0x94, 0xcf, 0xf7, 0x7d, 0x5b, 0x44, 0x34, 0x4f, 0xc5, 0x4c, 0x61, 0xa4, - 0x89, 0x79, 0xe0, 0x84, 0x17, 0x23, 0xc9, 0x84, 0xb2, 0x99, 0xc2, 0xe8, 0xde, 0x84, 0x87, 0x8b, - 0xd9, 0x89, 0x27, 0x55, 0xa0, 0xf1, 0x57, 0x65, 0x68, 0x7d, 0x25, 0x42, 0xff, 0x30, 0xf4, 0x03, - 0x3f, 0xe2, 0x2e, 0xdb, 0x2c, 0xb2, 0x53, 0x5e, 0xdb, 0x2a, 0xee, 0x36, 0xdf, 0x6d, 0x7d, 0x98, - 0xf2, 0x57, 0x5e, 0x47, 0x9e, 0xe1, 0x06, 0xd4, 0xe4, 0x75, 0x2e, 0xe1, 0x99, 0xa2, 0x60, 0x1f, - 0x79, 0x81, 0xb4, 0xd7, 0x22, 0x3f, 0x14, 0x85, 0xdd, 0x05, 0x98, 0xf2, 0xf9, 0x9e, 0xe0, 0x91, - 0xd8, 0xb5, 0x13, 0xbd, 0xce, 0x30, 0x8a, 0x1b, 0xa3, 0xb9, 0x37, 0x8a, 0x48, 0xbf, 0x24, 0x37, - 0x08, 0x66, 0x6f, 0x80, 0x3e, 0xe5, 0x73, 0x34, 0x30, 0xbb, 0xb6, 0xd4, 0x24, 0x33, 0x43, 0xb0, - 0xb7, 0xa0, 0x1c, 0xcf, 0x3d, 0xb2, 0xd6, 0xe8, 0xcc, 0x31, 0xb6, 0x1b, 0xcd, 0x3d, 0x65, 0x8a, - 0x4c, 0xa4, 0x25, 0x37, 0xd8, 0xc8, 0x6e, 0xb0, 0x0b, 0x65, 0xcb, 0xb1, 0xc9, 0x9b, 0xeb, 0x26, - 0x36, 0xd9, 0x3d, 0xa8, 0xbb, 0xf2, 0xb6, 0xc8, 0x63, 0x37, 0x37, 0x9a, 0xd2, 0xd0, 0x11, 0xca, - 0x4c, 0x68, 0xfd, 0xdf, 0x82, 0xeb, 0x0b, 0xec, 0xca, 0xcb, 0x47, 0x5b, 0xce, 0x7e, 0x2b, 0x2f, - 0x1f, 0x95, 0xbc, 0x4c, 0xfc, 0x6b, 0x19, 0xae, 0x2b, 0x21, 0x3d, 0x75, 0x82, 0x61, 0x8c, 0xfa, - 0xde, 0x83, 0x3a, 0x59, 0x6b, 0x25, 0x1f, 0x15, 0x33, 0x01, 0xd9, 0x6f, 0x42, 0x8d, 0x14, 0x37, - 0xd1, 0x9f, 0x95, 0x8c, 0xf9, 0xe9, 0x70, 0xa9, 0x4f, 0xea, 0xe6, 0x54, 0x77, 0xf6, 0x43, 0xa8, - 0x7e, 0x2d, 0x42, 0x5f, 0x7a, 0x9f, 0xe6, 0xc6, 0xdd, 0x65, 0xe3, 0x50, 0x04, 0xd4, 0x30, 0xd9, - 0xf9, 0xd7, 0x78, 0x47, 0xef, 0xa0, 0xbf, 0x99, 0xfa, 0xe7, 0xc2, 0xee, 0xd5, 0x69, 0x47, 0x79, - 0x31, 0x4a, 0x48, 0xc9, 0xa5, 0x34, 0x96, 0x5e, 0x8a, 0xfe, 0x8a, 0x4b, 0xd9, 0x86, 0x66, 0x8e, - 0x0b, 0x4b, 0x2e, 0x64, 0xa5, 0xa8, 0xb0, 0x7a, 0x6a, 0x87, 0xf2, 0x7a, 0xbf, 0x0d, 0x90, 0xf1, - 0xe4, 0x57, 0xb5, 0x1e, 0xc6, 0xef, 0x95, 0xe0, 0xfa, 0x63, 0xdf, 0xf3, 0x04, 0x45, 0xa5, 0xf2, - 0x86, 0x33, 0x25, 0x2a, 0x5d, 0xa9, 0x44, 0xef, 0x43, 0x35, 0xc2, 0xce, 0x6a, 0xf6, 0x9b, 0x4b, - 0xae, 0xcc, 0x94, 0x3d, 0xd0, 0x4a, 0x4e, 0xf9, 0x7c, 0x1c, 0x08, 0xcf, 0x76, 0xbc, 0x93, 0xc4, - 0x4a, 0x4e, 0xf9, 0xfc, 0x50, 0x62, 0x8c, 0x3f, 0xd3, 0x00, 0x3e, 0x13, 0xdc, 0x8d, 0x4f, 0xd1, - 0x13, 0xe0, 0xbd, 0x39, 0x5e, 0x14, 0x73, 0xcf, 0x4a, 0x72, 0x82, 0x14, 0x46, 0xe1, 0x43, 0xb7, - 0x27, 0x22, 0x69, 0x84, 0x74, 0x33, 0x01, 0xd1, 0x11, 0xe2, 0x72, 0xb3, 0x48, 0xb9, 0x47, 0x05, - 0x65, 0xce, 0xbc, 0x42, 0x68, 0xe5, 0xcc, 0x7b, 0x50, 0xc7, 0x18, 0xdb, 0xf1, 0x3d, 0x12, 0x0d, - 0xdd, 0x4c, 0x40, 0x9c, 0x67, 0x16, 0xc4, 0xce, 0x54, 0x3a, 0xc1, 0xb2, 0xa9, 0x20, 0xdc, 0x15, - 0x3a, 0xbd, 0x81, 0x75, 0xea, 0x93, 0xf2, 0x96, 0xcd, 0x14, 0xc6, 0xd9, 0x7c, 0xef, 0xc4, 0xc7, - 0xd3, 0x35, 0x28, 0x7e, 0x4a, 0x40, 0x79, 0x16, 0x5b, 0xcc, 0x91, 0xa4, 0x13, 0x29, 0x85, 0x91, - 0x2f, 0x42, 0x8c, 0x8f, 0x05, 0x8f, 0x67, 0xa1, 0x88, 0x7a, 0x40, 0x64, 0x10, 0x62, 0x47, 0x61, - 0x8c, 0xdf, 0xd5, 0xa0, 0x26, 0xed, 0x52, 0x21, 0x58, 0x28, 0x7d, 0xab, 0x60, 0xe1, 0x0d, 0xd0, - 0x83, 0x50, 0xd8, 0x8e, 0x95, 0x5c, 0x92, 0x6e, 0x66, 0x08, 0x8a, 0xd2, 0xd1, 0x6f, 0x12, 0xb3, - 0x1a, 0xa6, 0x04, 0x10, 0x1b, 0x05, 0xdc, 0x12, 0xea, 0x80, 0x12, 0x40, 0x8e, 0x48, 0x91, 0x27, - 0x51, 0x6f, 0x98, 0x0a, 0x62, 0x1f, 0x83, 0x4e, 0x51, 0x19, 0x39, 0x7c, 0x9d, 0x1c, 0xf5, 0xed, - 0x97, 0x2f, 0x56, 0x18, 0x22, 0x17, 0x3c, 0x7d, 0x23, 0xc1, 0x61, 0x5c, 0x82, 0x83, 0xd1, 0xbe, - 0x03, 0x05, 0x19, 0x14, 0x97, 0x20, 0x6a, 0x14, 0xe5, 0xe3, 0x12, 0x89, 0x31, 0xfe, 0x59, 0x83, - 0xd6, 0xb6, 0x13, 0x0a, 0x2b, 0x16, 0xf6, 0xc0, 0x3e, 0xa1, 0xcd, 0x08, 0x2f, 0x76, 0xe2, 0x0b, - 0x15, 0x49, 0x29, 0x28, 0x0d, 0x74, 0xb5, 0x62, 0xe2, 0x27, 0x35, 0xa0, 0x4c, 0xb9, 0xaa, 0x04, - 0xd8, 0x06, 0x80, 0x4c, 0x01, 0x28, 0x5f, 0xad, 0x5c, 0x9d, 0xaf, 0xea, 0xd4, 0x0d, 0x9b, 0x98, - 0x0f, 0xca, 0x31, 0x8e, 0x0c, 0xa7, 0x6a, 0x94, 0xcc, 0xce, 0xd0, 0xca, 0x50, 0xe4, 0x3c, 0x11, - 0x2e, 0x89, 0x0b, 0x45, 0xce, 0x13, 0xe1, 0xa6, 0xf9, 0x4a, 0x5d, 0x6e, 0x07, 0xdb, 0xec, 0x6d, - 0xd0, 0xfc, 0x80, 0x78, 0xa8, 0x16, 0xcc, 0x1f, 0x6c, 0xfd, 0x20, 0x30, 0x35, 0x3f, 0x40, 0xdd, - 0x93, 0xc9, 0x19, 0x89, 0x0b, 0xea, 0x1e, 0x7a, 0x08, 0x4a, 0x15, 0x4c, 0x45, 0x61, 0x06, 0xb4, - 0xb8, 0xeb, 0xfa, 0xbf, 0x10, 0xf6, 0x61, 0x28, 0xec, 0x44, 0x72, 0x0a, 0x38, 0xe3, 0x36, 0x68, - 0x07, 0x01, 0xab, 0x43, 0x79, 0x38, 0x18, 0x75, 0xaf, 0x61, 0x63, 0x7b, 0xb0, 0xd7, 0x2d, 0x19, - 0xdf, 0x68, 0xa0, 0x3f, 0x9b, 0xc5, 0x1c, 0xb5, 0x3d, 0xc2, 0x73, 0x15, 0xc5, 0x2a, 0x93, 0x9f, - 0x1f, 0x40, 0x23, 0x8a, 0x79, 0x48, 0x9e, 0x58, 0xfa, 0x85, 0x3a, 0xc1, 0xa3, 0x88, 0xbd, 0x0b, - 0x55, 0x61, 0x9f, 0x88, 0xc4, 0x5c, 0x77, 0x17, 0xcf, 0x62, 0x4a, 0x32, 0x5b, 0x83, 0x5a, 0x64, - 0x9d, 0x8a, 0x29, 0xef, 0x55, 0xb2, 0x8e, 0x43, 0xc2, 0xc8, 0xd8, 0xd1, 0x54, 0x74, 0xf6, 0x0e, - 0x54, 0xf1, 0x36, 0x22, 0x95, 0xec, 0x50, 0x7a, 0x84, 0x8c, 0x57, 0xdd, 0x24, 0x11, 0x65, 0xc7, - 0x0e, 0xfd, 0x60, 0xec, 0x07, 0xc4, 0xd7, 0xce, 0xc6, 0x2d, 0xb2, 0x3a, 0xc9, 0x69, 0xd6, 0xb7, - 0x43, 0x3f, 0x38, 0x08, 0xcc, 0x9a, 0x4d, 0x5f, 0xcc, 0x6b, 0xa9, 0xbb, 0x94, 0x01, 0x69, 0xa6, - 0x75, 0xc4, 0xc8, 0x3a, 0xc6, 0x1a, 0x34, 0xa6, 0x22, 0xe6, 0x36, 0x8f, 0xb9, 0xb2, 0xd6, 0x2d, - 0x69, 0xc4, 0x24, 0xce, 0x4c, 0xa9, 0xc6, 0x43, 0xa8, 0xc9, 0xa9, 0x59, 0x03, 0x2a, 0xfb, 0x07, - 0xfb, 0x03, 0xc9, 0xd0, 0xcd, 0xbd, 0xbd, 0x6e, 0x09, 0x51, 0xdb, 0x9b, 0xa3, 0xcd, 0xae, 0x86, - 0xad, 0xd1, 0x4f, 0x0f, 0x07, 0xdd, 0xb2, 0xf1, 0x4f, 0x25, 0x68, 0x24, 0xf3, 0xb0, 0x4f, 0x01, - 0x50, 0xef, 0xc6, 0xa7, 0x8e, 0x97, 0x06, 0x35, 0x77, 0xf2, 0x2b, 0xad, 0xe3, 0x8d, 0x7d, 0x86, - 0x54, 0xe9, 0xde, 0x48, 0x4d, 0x09, 0xee, 0x0f, 0xa1, 0x53, 0x24, 0x2e, 0x89, 0xee, 0xee, 0xe7, - 0xed, 0x7c, 0x67, 0xe3, 0x7b, 0x85, 0xa9, 0x71, 0x24, 0x09, 0x73, 0xce, 0xe4, 0x3f, 0x80, 0x46, - 0x82, 0x66, 0x4d, 0xa8, 0x6f, 0x0f, 0x76, 0x36, 0x8f, 0xf6, 0x50, 0x48, 0x00, 0x6a, 0xc3, 0xdd, - 0xfd, 0x27, 0x7b, 0x03, 0x79, 0xac, 0xbd, 0xdd, 0xe1, 0xa8, 0xab, 0x19, 0x7f, 0x5a, 0x82, 0x46, - 0x12, 0x43, 0xb0, 0xf7, 0xd1, 0xf9, 0x53, 0xa8, 0xa2, 0x7c, 0x03, 0x95, 0x23, 0x72, 0xc9, 0x94, - 0x99, 0xd0, 0x51, 0x31, 0xc8, 0xd4, 0x25, 0x51, 0x05, 0x01, 0xf9, 0x54, 0xae, 0x5c, 0xa8, 0x26, - 0x60, 0x56, 0xea, 0x7b, 0x42, 0x05, 0x89, 0xd4, 0x26, 0x19, 0x74, 0x3c, 0x8b, 0xac, 0x45, 0x55, - 0xc9, 0x20, 0xc2, 0xa3, 0xc8, 0xf8, 0x93, 0x0a, 0x74, 0x4c, 0x11, 0xc5, 0x7e, 0x28, 0x4c, 0xf1, - 0xf3, 0x19, 0xa6, 0xda, 0xaf, 0x10, 0xe6, 0x37, 0x01, 0x42, 0xd9, 0x39, 0x13, 0x67, 0x5d, 0x61, - 0x64, 0x98, 0xee, 0xfa, 0x16, 0x49, 0x91, 0xf2, 0x1e, 0x29, 0xcc, 0xee, 0x80, 0x3e, 0xe1, 0xd6, - 0x99, 0x9c, 0x56, 0xfa, 0x90, 0x86, 0x44, 0xc8, 0x79, 0xb9, 0x65, 0x89, 0x28, 0x1a, 0xe3, 0xa5, - 0x48, 0x4f, 0xa2, 0x4b, 0xcc, 0x53, 0x71, 0x81, 0xe4, 0x48, 0x58, 0xa1, 0x88, 0x89, 0x2c, 0x0d, - 0x84, 0x2e, 0x31, 0x48, 0x7e, 0x1b, 0xda, 0x91, 0x88, 0xd0, 0xeb, 0x8c, 0x63, 0xff, 0x4c, 0x78, - 0xca, 0x5a, 0xb4, 0x14, 0x72, 0x84, 0x38, 0xb4, 0xe3, 0xdc, 0xf3, 0xbd, 0x8b, 0xa9, 0x3f, 0x8b, - 0x94, 0x01, 0xce, 0x10, 0x6c, 0x1d, 0x6e, 0x0a, 0xcf, 0x0a, 0x2f, 0x02, 0xdc, 0x2b, 0xae, 0x32, - 0x3e, 0x76, 0x5c, 0xa1, 0x02, 0xc5, 0x1b, 0x19, 0xe9, 0xa9, 0xb8, 0xd8, 0x71, 0x5c, 0x81, 0x3b, - 0x3a, 0xe7, 0x33, 0x37, 0x1e, 0x53, 0x22, 0x09, 0x72, 0x47, 0x84, 0xd9, 0xc4, 0x6c, 0xf2, 0x03, - 0xb8, 0x21, 0xc9, 0xa1, 0xef, 0x0a, 0xc7, 0x96, 0x93, 0x35, 0xa9, 0xd7, 0x75, 0x22, 0x98, 0x84, - 0xa7, 0xa9, 0xd6, 0xe1, 0xa6, 0xec, 0x2b, 0x0f, 0x94, 0xf4, 0x6e, 0xc9, 0xa5, 0x89, 0x34, 0x54, - 0x94, 0xe2, 0xd2, 0x01, 0x8f, 0x4f, 0x29, 0x41, 0x4c, 0x96, 0x3e, 0xe4, 0xf1, 0x29, 0x7a, 0x43, - 0x49, 0x3e, 0x76, 0x84, 0x2b, 0x13, 0x3f, 0xdd, 0x94, 0x23, 0x76, 0x10, 0xc3, 0xde, 0x82, 0x96, - 0xea, 0xe0, 0x87, 0x53, 0x2e, 0xeb, 0x4b, 0xba, 0x29, 0x07, 0xed, 0x10, 0xca, 0xf8, 0x5f, 0x0d, - 0x1a, 0x69, 0x36, 0x71, 0x1f, 0xf4, 0x69, 0x62, 0x1a, 0x54, 0x94, 0xd2, 0x2e, 0xd8, 0x0b, 0x33, - 0xa3, 0xb3, 0x37, 0x41, 0x3b, 0x3b, 0x57, 0x66, 0xaa, 0xbd, 0x2e, 0x0b, 0xaa, 0xc1, 0x64, 0x63, - 0xfd, 0xe9, 0x73, 0x53, 0x3b, 0x3b, 0xcf, 0xa2, 0x9d, 0xea, 0x6b, 0xa3, 0x9d, 0xf7, 0xe0, 0xba, - 0xe5, 0x0a, 0xee, 0x8d, 0x33, 0xef, 0x2b, 0x2f, 0xbe, 0x43, 0xe8, 0xc3, 0xd4, 0x05, 0x2b, 0x4d, - 0xae, 0x67, 0x9a, 0x7c, 0x0f, 0xaa, 0xb6, 0x70, 0x63, 0x9e, 0xaf, 0xf4, 0x1d, 0x84, 0xdc, 0x72, - 0xc5, 0x36, 0xa2, 0x4d, 0x49, 0x45, 0xc3, 0x95, 0x64, 0x3c, 0x79, 0xc3, 0x95, 0xe8, 0xa8, 0x99, - 0x52, 0x33, 0x15, 0x84, 0xbc, 0x0a, 0xde, 0x87, 0x1b, 0x62, 0x1e, 0x90, 0xb5, 0x1e, 0xa7, 0xd9, - 0x69, 0x93, 0x7a, 0x74, 0x13, 0xc2, 0x63, 0x85, 0x67, 0x1f, 0xa2, 0xbe, 0x92, 0x9e, 0xd0, 0xcd, - 0x36, 0x37, 0x18, 0x29, 0x7c, 0x41, 0xf3, 0xcc, 0xa4, 0x8b, 0xe1, 0x41, 0xf9, 0xe9, 0xf3, 0xa1, - 0xe2, 0x66, 0xe9, 0x2a, 0x6e, 0x26, 0xaa, 0xae, 0xe5, 0x54, 0xfd, 0xae, 0xb4, 0x92, 0xc4, 0x9a, - 0xa4, 0x0a, 0x95, 0xc3, 0xe0, 0x51, 0xa4, 0x87, 0xa8, 0xc8, 0x02, 0x15, 0x01, 0xc6, 0xff, 0x94, - 0xa1, 0xae, 0xdc, 0x36, 0xf2, 0x73, 0x96, 0x16, 0x58, 0xb0, 0x59, 0xcc, 0x6b, 0x52, 0xff, 0x9f, - 0xaf, 0x56, 0x97, 0x5f, 0x5f, 0xad, 0x66, 0x9f, 0x42, 0x2b, 0x90, 0xb4, 0x7c, 0xc4, 0xf0, 0xfd, - 0xfc, 0x18, 0xf5, 0xa5, 0x71, 0xcd, 0x20, 0x03, 0xd0, 0x24, 0x51, 0x29, 0x2f, 0xe6, 0x27, 0x24, - 0x3a, 0x2d, 0xb3, 0x8e, 0xf0, 0x88, 0x9f, 0x5c, 0x11, 0x37, 0x7c, 0x1b, 0xf7, 0xdf, 0xa1, 0x38, - 0xa2, 0x45, 0x16, 0x0e, 0x43, 0x86, 0xbc, 0xa7, 0x6e, 0x17, 0x3d, 0xf5, 0x1d, 0xd0, 0x2d, 0x7f, - 0x3a, 0x75, 0x88, 0xd6, 0x51, 0x05, 0x08, 0x42, 0x8c, 0x22, 0xe3, 0x0f, 0x4b, 0x50, 0x57, 0xa7, - 0xbd, 0xe4, 0x07, 0xb6, 0x76, 0xf7, 0x37, 0xcd, 0x9f, 0x76, 0x4b, 0xe8, 0xe7, 0x76, 0xf7, 0x47, - 0x5d, 0x8d, 0xe9, 0x50, 0xdd, 0xd9, 0x3b, 0xd8, 0x1c, 0x75, 0xcb, 0xe8, 0x1b, 0xb6, 0x0e, 0x0e, - 0xf6, 0xba, 0x15, 0xd6, 0x82, 0xc6, 0xf6, 0xe6, 0x68, 0x30, 0xda, 0x7d, 0x36, 0xe8, 0x56, 0xb1, - 0xef, 0x93, 0xc1, 0x41, 0xb7, 0x86, 0x8d, 0xa3, 0xdd, 0xed, 0x6e, 0x1d, 0xe9, 0x87, 0x9b, 0xc3, - 0xe1, 0x97, 0x07, 0xe6, 0x76, 0xb7, 0x41, 0xfe, 0x65, 0x64, 0xee, 0xee, 0x3f, 0xe9, 0xea, 0xd8, - 0x3e, 0xd8, 0xfa, 0x7c, 0xf0, 0x78, 0xd4, 0x05, 0xe3, 0x23, 0x68, 0xe6, 0x38, 0x88, 0xa3, 0xcd, - 0xc1, 0x4e, 0xf7, 0x1a, 0x2e, 0xf9, 0x7c, 0x73, 0xef, 0x08, 0xdd, 0x51, 0x07, 0x80, 0x9a, 0xe3, - 0xbd, 0xcd, 0xfd, 0x27, 0x5d, 0xcd, 0xf8, 0x02, 0x1a, 0x47, 0x8e, 0xbd, 0xe5, 0xfa, 0xd6, 0x19, - 0x8a, 0xd3, 0x84, 0x47, 0x42, 0xe5, 0x3e, 0xd4, 0xc6, 0x30, 0x91, 0x94, 0x25, 0x52, 0x77, 0xaf, - 0x20, 0xe4, 0x95, 0x37, 0x9b, 0x8e, 0xe9, 0x85, 0xa3, 0x2c, 0x7d, 0x84, 0x37, 0x9b, 0x1e, 0x39, - 0x76, 0x64, 0xec, 0x43, 0xfd, 0xc8, 0xb1, 0x0f, 0xb9, 0x75, 0x86, 0xa6, 0x6a, 0x82, 0x53, 0x8f, - 0x23, 0xe7, 0x6b, 0xa1, 0x7c, 0x89, 0x4e, 0x98, 0xa1, 0xf3, 0xb5, 0x60, 0xef, 0x40, 0x8d, 0x80, - 0x24, 0xcf, 0x25, 0xf5, 0x4b, 0xb6, 0x63, 0x2a, 0x9a, 0xf1, 0x47, 0xa5, 0xf4, 0x58, 0x54, 0xc2, - 0x5e, 0x81, 0x4a, 0xc0, 0xad, 0x33, 0xe5, 0x37, 0x9b, 0x6a, 0x0c, 0xae, 0x67, 0x12, 0x81, 0xbd, - 0x07, 0x0d, 0x25, 0x3b, 0xc9, 0xc4, 0xcd, 0x9c, 0x90, 0x99, 0x29, 0xb1, 0x78, 0xab, 0xe5, 0xe2, - 0xad, 0x52, 0x1e, 0x14, 0xb8, 0x4e, 0x2c, 0x35, 0xa5, 0x62, 0x2a, 0xc8, 0xf8, 0x21, 0x40, 0xf6, - 0x6a, 0xb0, 0x24, 0x8c, 0xb8, 0x05, 0x55, 0xee, 0x3a, 0x3c, 0xc9, 0xab, 0x24, 0x60, 0xec, 0x43, - 0x33, 0xf7, 0xd6, 0x80, 0xec, 0xe3, 0xae, 0x8b, 0x7e, 0x26, 0xa2, 0xb1, 0x0d, 0xb3, 0xce, 0x5d, - 0xf7, 0xa9, 0xb8, 0x88, 0x30, 0x84, 0x93, 0xcf, 0x14, 0xda, 0x42, 0x85, 0x9b, 0x86, 0x9a, 0x92, - 0x68, 0x7c, 0x08, 0xb5, 0x9d, 0x24, 0x88, 0x4d, 0x24, 0xbd, 0x74, 0x95, 0xa4, 0x1b, 0x9f, 0xa8, - 0x3d, 0x53, 0x91, 0x9c, 0xdd, 0x57, 0xcf, 0x21, 0x91, 0x7c, 0x7c, 0x29, 0x65, 0x99, 0xb9, 0xec, - 0xa4, 0x5e, 0x42, 0xa8, 0xb3, 0xb1, 0x0d, 0x8d, 0x57, 0x3e, 0x30, 0x29, 0x06, 0x68, 0x19, 0x03, - 0x96, 0x3c, 0x39, 0x19, 0x3f, 0x03, 0xc8, 0x9e, 0x4d, 0x94, 0xe2, 0xc9, 0x59, 0x50, 0xf1, 0x3e, - 0x80, 0x86, 0x75, 0xea, 0xb8, 0x76, 0x28, 0xbc, 0xc2, 0xa9, 0xb3, 0x87, 0x96, 0x94, 0xce, 0x56, - 0xa1, 0x42, 0xaf, 0x41, 0xe5, 0xcc, 0x60, 0xa7, 0x4f, 0x41, 0x44, 0x31, 0xe6, 0xd0, 0x96, 0xb1, - 0xf1, 0xb7, 0x88, 0x67, 0x8a, 0xd6, 0x52, 0xbb, 0x64, 0x2d, 0x6f, 0x43, 0x8d, 0xdc, 0x68, 0x72, - 0x1a, 0x05, 0x5d, 0x61, 0x45, 0x7f, 0x5f, 0x03, 0x90, 0x4b, 0xef, 0xfb, 0xb6, 0x28, 0x66, 0x8e, - 0xa5, 0xc5, 0xcc, 0x91, 0x41, 0x25, 0x7d, 0xe8, 0xd3, 0x4d, 0x6a, 0x67, 0x7e, 0x46, 0x65, 0x93, - 0xd2, 0xcf, 0xbc, 0x01, 0x3a, 0x85, 0x35, 0xce, 0xd7, 0x54, 0x9d, 0xc6, 0x05, 0x33, 0x44, 0xfe, - 0xd9, 0xab, 0x5a, 0x7c, 0xf6, 0x4a, 0xdf, 0x06, 0x6a, 0x72, 0x36, 0xf9, 0x36, 0xb0, 0xe4, 0x99, - 0x43, 0xe6, 0xea, 0x91, 0x08, 0xe3, 0x24, 0x33, 0x95, 0x50, 0x9a, 0x7d, 0xe9, 0xaa, 0x2f, 0x97, - 0xd9, 0xb6, 0xe7, 0x8f, 0x2d, 0xdf, 0x3b, 0x76, 0x1d, 0x2b, 0x56, 0xcf, 0x5c, 0xe0, 0xf9, 0x8f, - 0x15, 0xc6, 0xf8, 0x14, 0x5a, 0x09, 0xff, 0xe9, 0x35, 0xe1, 0x83, 0x34, 0x7b, 0x29, 0x65, 0x77, - 0x9b, 0xb1, 0x69, 0x4b, 0xeb, 0x95, 0x92, 0xfc, 0xc5, 0xf8, 0xef, 0x72, 0x32, 0x58, 0x15, 0xc5, - 0x5f, 0xcd, 0xc3, 0x62, 0x0a, 0xaa, 0x7d, 0xab, 0x14, 0xf4, 0x47, 0xa0, 0xdb, 0x94, 0x63, 0x39, - 0xe7, 0x89, 0xdf, 0xea, 0x2f, 0xe6, 0x53, 0x2a, 0x0b, 0x73, 0xce, 0x85, 0x99, 0x75, 0x7e, 0xcd, - 0x3d, 0xa4, 0xdc, 0xae, 0x2e, 0xe3, 0x76, 0xed, 0x57, 0xe4, 0xf6, 0x5b, 0xd0, 0xf2, 0x7c, 0x6f, - 0xec, 0xcd, 0x5c, 0x97, 0x4f, 0x5c, 0xa1, 0xd8, 0xdd, 0xf4, 0x7c, 0x6f, 0x5f, 0xa1, 0x30, 0xd6, - 0xcc, 0x77, 0x91, 0x4a, 0xdd, 0xa4, 0x7e, 0xd7, 0x73, 0xfd, 0x48, 0xf5, 0xd7, 0xa0, 0xeb, 0x4f, - 0x7e, 0x26, 0xac, 0x98, 0x38, 0x36, 0x26, 0x6d, 0x96, 0x81, 0x66, 0x47, 0xe2, 0x91, 0x45, 0xfb, - 0xa8, 0xd7, 0x0b, 0xd7, 0xdc, 0xbe, 0x74, 0xcd, 0x9f, 0x80, 0x9e, 0x72, 0x29, 0x97, 0xcf, 0xe9, - 0x50, 0xdd, 0xdd, 0xdf, 0x1e, 0xfc, 0xa4, 0x5b, 0x42, 0x5f, 0x68, 0x0e, 0x9e, 0x0f, 0xcc, 0xe1, - 0xa0, 0xab, 0xa1, 0x9f, 0xda, 0x1e, 0xec, 0x0d, 0x46, 0x83, 0x6e, 0xf9, 0xf3, 0x4a, 0xa3, 0xde, - 0x6d, 0x50, 0x69, 0xdb, 0x75, 0x2c, 0x27, 0x36, 0x86, 0x00, 0x59, 0x92, 0x8a, 0x56, 0x39, 0xdb, - 0x9c, 0xaa, 0x5b, 0xc5, 0xc9, 0xb6, 0xd6, 0x52, 0x85, 0xd4, 0xae, 0x4a, 0x85, 0x25, 0xdd, 0xd8, - 0x00, 0xfd, 0x19, 0x0f, 0x3e, 0x93, 0xaf, 0x38, 0xf7, 0xa0, 0x13, 0xf0, 0x30, 0x76, 0x92, 0xe8, - 0x5e, 0x1a, 0xcb, 0x96, 0xd9, 0x4e, 0xb1, 0x68, 0x7b, 0x8d, 0x23, 0x68, 0x3c, 0xe3, 0xc1, 0xa5, - 0x04, 0xb1, 0x95, 0x16, 0x8f, 0x67, 0xea, 0x8d, 0x49, 0x05, 0x46, 0xf7, 0xa0, 0xae, 0x9c, 0x89, - 0xb2, 0x47, 0x05, 0x47, 0x93, 0xd0, 0x8c, 0xbf, 0x29, 0xc1, 0xad, 0x67, 0xfe, 0xb9, 0x48, 0x63, - 0xd6, 0x43, 0x7e, 0xe1, 0xfa, 0xdc, 0x7e, 0x8d, 0x74, 0x63, 0xd6, 0xe3, 0xcf, 0xe8, 0x19, 0x27, - 0x79, 0xda, 0x32, 0x75, 0x89, 0x79, 0xa2, 0xde, 0xd6, 0x45, 0x14, 0x13, 0x51, 0xb9, 0x60, 0x84, - 0x91, 0xf4, 0x3d, 0xa8, 0xc5, 0x73, 0x2f, 0x7b, 0x49, 0xab, 0xc6, 0x54, 0xac, 0x5d, 0x1a, 0xb0, - 0x56, 0x97, 0x07, 0xac, 0xc6, 0x63, 0xd0, 0x47, 0x73, 0x2a, 0x64, 0xce, 0xa2, 0x42, 0x68, 0x54, - 0x7a, 0x45, 0x68, 0xa4, 0x2d, 0x84, 0x46, 0xff, 0x51, 0x82, 0x66, 0x2e, 0xf2, 0x66, 0x6f, 0x41, - 0x25, 0x9e, 0x7b, 0xc5, 0xf7, 0xea, 0x64, 0x11, 0x93, 0x48, 0x28, 0xf1, 0x53, 0x3e, 0x1f, 0xf3, - 0x28, 0x72, 0x4e, 0x3c, 0x61, 0xab, 0x29, 0x9b, 0x53, 0x3e, 0xdf, 0x54, 0x28, 0xb6, 0x07, 0xd7, - 0xa5, 0x41, 0x4f, 0x0e, 0x91, 0x54, 0x50, 0xde, 0x5e, 0x88, 0xf4, 0x65, 0xb1, 0x37, 0x39, 0x92, - 0x2a, 0x0b, 0x74, 0x4e, 0x0a, 0xc8, 0xfe, 0x26, 0xdc, 0x5c, 0xd2, 0xed, 0x3b, 0x95, 0xf7, 0x57, - 0xa0, 0x3d, 0x9a, 0x7b, 0x23, 0x67, 0x2a, 0xa2, 0x98, 0x4f, 0x03, 0x0a, 0x2d, 0x95, 0x43, 0xae, - 0x98, 0x5a, 0x1c, 0x19, 0xef, 0x42, 0xeb, 0x50, 0x88, 0xd0, 0x14, 0x51, 0xe0, 0x7b, 0x32, 0xac, - 0x52, 0x45, 0x56, 0xe9, 0xfd, 0x15, 0x64, 0xfc, 0x0e, 0xe8, 0x26, 0x3f, 0x8e, 0xb7, 0x78, 0x6c, - 0x9d, 0x7e, 0x97, 0x1a, 0xc1, 0xbb, 0x50, 0x0f, 0xa4, 0x4c, 0xa9, 0x0c, 0xad, 0x45, 0x51, 0x80, - 0x92, 0x33, 0x33, 0x21, 0x1a, 0x1f, 0xc1, 0xcd, 0xe1, 0x6c, 0x12, 0x59, 0xa1, 0x43, 0xd9, 0x6c, - 0xe2, 0x21, 0xfb, 0xd0, 0x08, 0x42, 0x71, 0xec, 0xcc, 0x45, 0xa2, 0x18, 0x29, 0x6c, 0xfc, 0x18, - 0x6e, 0x15, 0x87, 0xa8, 0x23, 0xbc, 0x0d, 0xe5, 0xb3, 0xf3, 0x48, 0xed, 0xec, 0x46, 0x21, 0x39, - 0xa1, 0x67, 0x62, 0xa4, 0x1a, 0x26, 0x94, 0xf7, 0x67, 0xd3, 0xfc, 0xaf, 0x2e, 0x15, 0xf9, 0xab, - 0xcb, 0x9d, 0x7c, 0xcd, 0x53, 0xe6, 0x2f, 0x59, 0x6d, 0xf3, 0x0d, 0xd0, 0x8f, 0xfd, 0xf0, 0x17, - 0x3c, 0xb4, 0x85, 0xad, 0x5c, 0x61, 0x86, 0x30, 0xbe, 0x82, 0x66, 0x22, 0x09, 0xbb, 0x36, 0xbd, - 0x8b, 0x91, 0x28, 0xee, 0xda, 0x05, 0xc9, 0x94, 0x15, 0x45, 0xe1, 0xd9, 0xbb, 0x89, 0x08, 0x49, - 0xa0, 0xb8, 0xb2, 0x7a, 0xce, 0x48, 0x56, 0x36, 0x76, 0xa0, 0x95, 0xa4, 0x7f, 0xcf, 0x44, 0xcc, - 0x49, 0xb8, 0x5d, 0x47, 0x78, 0x39, 0xc1, 0x6f, 0x48, 0xc4, 0xa8, 0x58, 0xf4, 0xd3, 0x0a, 0x71, - 0x85, 0xb1, 0x0e, 0x35, 0xa5, 0x39, 0x0c, 0x2a, 0x96, 0x6f, 0x4b, 0xed, 0xae, 0x9a, 0xd4, 0x46, - 0x76, 0x4c, 0xa3, 0x93, 0x24, 0x66, 0x9a, 0x46, 0x27, 0xc6, 0xdf, 0x69, 0xd0, 0xde, 0xa2, 0x62, - 0x48, 0x72, 0x25, 0xb9, 0xfa, 0x4e, 0xa9, 0x50, 0xdf, 0xc9, 0xd7, 0x72, 0xb4, 0x42, 0x2d, 0xa7, - 0xb0, 0xa1, 0x72, 0x31, 0xd0, 0xf9, 0x3e, 0xd4, 0x67, 0x9e, 0x33, 0x4f, 0x4c, 0x82, 0x6e, 0xd6, - 0x10, 0x1c, 0x45, 0x6c, 0x15, 0x9a, 0x68, 0x35, 0x1c, 0x4f, 0x56, 0x6d, 0x64, 0xe9, 0x25, 0x8f, - 0x5a, 0xa8, 0xcd, 0xd4, 0x5e, 0x5d, 0x9b, 0xa9, 0xbf, 0xb6, 0x36, 0xd3, 0x78, 0x5d, 0x6d, 0x46, - 0x5f, 0xac, 0xcd, 0x14, 0x83, 0x34, 0x58, 0x0c, 0xd2, 0x8c, 0x3f, 0xd7, 0xa0, 0x3d, 0x98, 0x07, - 0xf4, 0xff, 0xc2, 0x6b, 0x23, 0xbe, 0x1c, 0x5f, 0xb5, 0x02, 0x5f, 0x73, 0x1c, 0x2a, 0xab, 0x07, - 0x0b, 0xc9, 0x21, 0x8c, 0x01, 0x65, 0xa5, 0x44, 0x71, 0x4e, 0x42, 0xff, 0x0f, 0x38, 0x67, 0xec, - 0x41, 0x27, 0x61, 0x8c, 0xd2, 0xda, 0x6f, 0x25, 0x8e, 0xf2, 0xdf, 0x23, 0x37, 0xad, 0x1f, 0x48, - 0xc0, 0xf8, 0x63, 0x0d, 0x74, 0x29, 0xa4, 0xb8, 0xbd, 0xf7, 0x55, 0xfc, 0x5a, 0xca, 0xaa, 0xa5, - 0x29, 0x71, 0xfd, 0xa9, 0xb8, 0xa0, 0xb8, 0x4b, 0x86, 0xb5, 0xcb, 0xde, 0x14, 0x94, 0x33, 0x95, - 0x59, 0x17, 0x39, 0xd3, 0x3b, 0xa0, 0x4b, 0x1f, 0x33, 0x73, 0x92, 0x57, 0x48, 0xe9, 0x74, 0x8e, - 0x1c, 0xfa, 0x65, 0x23, 0x16, 0xe1, 0x54, 0x71, 0x99, 0xda, 0xc5, 0xf8, 0xb6, 0xad, 0x22, 0x2e, - 0xe3, 0x14, 0xea, 0x6a, 0x75, 0x0c, 0x40, 0x8e, 0xf6, 0x9f, 0xee, 0x1f, 0x7c, 0xb9, 0xdf, 0xbd, - 0x96, 0xd6, 0x97, 0x4b, 0x59, 0x88, 0xa2, 0xe5, 0x43, 0x94, 0x32, 0xe2, 0x1f, 0x1f, 0x1c, 0xed, - 0x8f, 0xba, 0x15, 0xd6, 0x06, 0x9d, 0x9a, 0x63, 0x73, 0xf0, 0xbc, 0x5b, 0xa5, 0x84, 0xfb, 0xf1, - 0x67, 0x83, 0x67, 0x9b, 0xdd, 0x5a, 0x5a, 0x9d, 0xae, 0x1b, 0x7f, 0x50, 0x82, 0x1b, 0xf2, 0xc8, - 0xf9, 0xf4, 0x34, 0xff, 0xdf, 0x5f, 0x45, 0xfe, 0xf7, 0xf7, 0x6b, 0xce, 0x48, 0xff, 0xa1, 0x04, - 0x7d, 0x19, 0xfc, 0x3c, 0x09, 0x79, 0x70, 0xfa, 0xc5, 0xde, 0xa5, 0xf4, 0xe7, 0x2a, 0xdf, 0x7d, - 0x0f, 0x3a, 0xf4, 0xf3, 0xe3, 0xcf, 0xdd, 0xb1, 0x0a, 0xd1, 0xe5, 0x15, 0xb5, 0x15, 0x56, 0x4e, - 0xc4, 0x3e, 0x86, 0x96, 0xfc, 0x49, 0x92, 0x6a, 0x71, 0x85, 0xe7, 0x8a, 0x42, 0xe8, 0xd5, 0x94, - 0xbd, 0xe8, 0xe1, 0x84, 0x7d, 0x94, 0x0e, 0xca, 0x32, 0xa5, 0xcb, 0x2f, 0x12, 0x6a, 0xc8, 0x88, - 0xf2, 0xa7, 0x87, 0x70, 0x67, 0xe9, 0x39, 0x94, 0xec, 0xe6, 0x0a, 0x53, 0x52, 0x64, 0x36, 0xfe, - 0xbe, 0x04, 0x15, 0xf4, 0x87, 0xec, 0x01, 0xe8, 0x9f, 0x09, 0x1e, 0xc6, 0x13, 0xc1, 0x63, 0x56, - 0xf0, 0x7d, 0x7d, 0x5a, 0x31, 0x7b, 0x15, 0x35, 0xae, 0x3d, 0x2a, 0xb1, 0x75, 0xf9, 0xdf, 0x52, - 0xf2, 0x3b, 0x56, 0x3b, 0xf1, 0xab, 0xe4, 0x77, 0xfb, 0x85, 0xf1, 0xc6, 0xb5, 0x35, 0xea, 0xff, - 0xb9, 0xef, 0x78, 0x8f, 0xe5, 0x6f, 0x36, 0x6c, 0xd1, 0x0f, 0x2f, 0x8e, 0x60, 0x0f, 0xa0, 0xb6, - 0x1b, 0xa1, 0xc3, 0xbf, 0xdc, 0x95, 0xb8, 0x96, 0x8f, 0x05, 0x8c, 0x6b, 0x1b, 0x7f, 0x5d, 0x86, - 0xca, 0x57, 0x22, 0xf4, 0xd9, 0x87, 0x50, 0x57, 0x6f, 0xc8, 0x2c, 0xf7, 0x56, 0xdc, 0xa7, 0x94, - 0x66, 0xe1, 0x71, 0x99, 0x56, 0xe9, 0x4a, 0x76, 0x65, 0x15, 0x54, 0x96, 0x3d, 0x71, 0x5f, 0xda, - 0xd4, 0x27, 0xd0, 0x1d, 0xc6, 0xa1, 0xe0, 0xd3, 0x5c, 0xf7, 0x22, 0xab, 0x96, 0x95, 0x63, 0x89, - 0x5f, 0xf7, 0xa1, 0x26, 0xa3, 0xaa, 0x85, 0x01, 0x8b, 0x95, 0x55, 0xea, 0xfc, 0x1e, 0x34, 0x87, - 0xa7, 0xfe, 0xcc, 0xb5, 0x87, 0x22, 0x3c, 0x17, 0x2c, 0xf7, 0x57, 0x48, 0x3f, 0xd7, 0x36, 0xae, - 0xb1, 0x35, 0x00, 0xe9, 0xc8, 0x8f, 0x50, 0x47, 0xea, 0x48, 0xdb, 0x9f, 0x4d, 0xe5, 0xa4, 0x39, - 0x0f, 0x2f, 0x7b, 0xe6, 0x82, 0xab, 0x57, 0xf5, 0xfc, 0x18, 0xda, 0x8f, 0x49, 0x5f, 0x0e, 0xc2, - 0xcd, 0x89, 0x1f, 0xc6, 0x6c, 0xf1, 0xcf, 0x90, 0xfe, 0x22, 0xc2, 0xb8, 0xc6, 0x1e, 0x41, 0x63, - 0x14, 0x5e, 0xc8, 0xfe, 0x37, 0x54, 0x4c, 0x9a, 0xad, 0xb7, 0xe4, 0x94, 0x1b, 0xff, 0x55, 0x81, - 0xda, 0x97, 0x7e, 0x78, 0x26, 0x42, 0x4c, 0x6f, 0xa9, 0x12, 0xae, 0xc4, 0x28, 0xad, 0x8a, 0x2f, - 0x5b, 0xe8, 0x1d, 0xd0, 0x89, 0x29, 0x23, 0x1e, 0x9d, 0xc9, 0xab, 0xa2, 0xbf, 0x6d, 0x25, 0x5f, - 0x64, 0xba, 0x4c, 0xf7, 0xda, 0x91, 0x17, 0x95, 0xbe, 0x16, 0x15, 0xea, 0xd2, 0x7d, 0x3a, 0xff, - 0xd3, 0xe7, 0x43, 0x14, 0xcd, 0x47, 0x25, 0x34, 0xc4, 0x43, 0x79, 0x52, 0xec, 0x94, 0xfd, 0x65, - 0x28, 0x25, 0x3f, 0xfb, 0xad, 0xcf, 0xb8, 0xc6, 0x1e, 0x42, 0x4d, 0xa9, 0xf4, 0x8d, 0x4c, 0x79, - 0x95, 0x9d, 0xe8, 0x77, 0xf3, 0x28, 0x35, 0xe0, 0x7d, 0xa8, 0x49, 0x0b, 0x27, 0x07, 0x14, 0x42, - 0x14, 0xb9, 0x6b, 0x19, 0xe6, 0x18, 0xd7, 0xd8, 0x7d, 0xa8, 0xab, 0x6a, 0x36, 0x5b, 0x52, 0xda, - 0x5e, 0xe8, 0xfc, 0x11, 0xd4, 0xa4, 0x63, 0x92, 0xf3, 0x16, 0xbc, 0x77, 0x9f, 0xe5, 0x51, 0x89, - 0x92, 0xa0, 0xb4, 0x9b, 0xc2, 0x12, 0x4e, 0x2e, 0x8d, 0x62, 0x09, 0x27, 0x96, 0xa8, 0xec, 0x27, - 0xd0, 0x2e, 0xa4, 0x5c, 0xac, 0x47, 0xb7, 0xb3, 0x24, 0x0b, 0xbb, 0xa4, 0x28, 0x3f, 0x06, 0x5d, - 0x45, 0xbc, 0x13, 0xc1, 0xa8, 0x3e, 0xbd, 0x24, 0x66, 0xee, 0x5f, 0x0e, 0x79, 0x49, 0xfa, 0x7f, - 0x02, 0x37, 0x97, 0xd8, 0x30, 0x46, 0xbf, 0xe2, 0x5c, 0x6d, 0xa4, 0xfb, 0x2b, 0x57, 0xd2, 0x13, - 0x06, 0x6c, 0x75, 0xff, 0xf1, 0x9b, 0xbb, 0xa5, 0x7f, 0xf9, 0xe6, 0x6e, 0xe9, 0xdf, 0xbe, 0xb9, - 0x5b, 0xfa, 0xe5, 0xbf, 0xdf, 0xbd, 0x36, 0xa9, 0xd1, 0x1f, 0xe7, 0x1f, 0xff, 0x5f, 0x00, 0x00, - 0x00, 0xff, 0xff, 0x50, 0xfd, 0x11, 0x9e, 0xe7, 0x2e, 0x00, 0x00, + // 4679 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0xd4, 0x3a, 0x4d, 0x8f, 0x24, 0x47, + 0x56, 0x53, 0x59, 0x9f, 0xf9, 0xea, 0x63, 0x6a, 0x62, 0x66, 0x67, 0x6b, 0x6b, 0xec, 0xe9, 0x76, + 0xda, 0x63, 0xb7, 0x3d, 0x9e, 0x9e, 0x71, 0x7b, 0x11, 0x6b, 0xaf, 0x90, 0xe8, 0x8f, 0xea, 0x71, + 0x7b, 0xfa, 0xcb, 0x59, 0xd5, 0xe3, 0x5d, 0x1f, 0x28, 0x45, 0x67, 0x46, 0x77, 0xe7, 0x76, 0x56, + 0x66, 0x6e, 0x66, 0x56, 0x6f, 0xb5, 0x4f, 0x20, 0x04, 0x27, 0x38, 0x21, 0xc4, 0x9e, 0x80, 0x7f, + 0x80, 0xe0, 0x84, 0x38, 0x23, 0x84, 0x38, 0x20, 0x7e, 0xc1, 0x80, 0x0c, 0xa7, 0x91, 0x38, 0x20, + 0x24, 0x8e, 0x08, 0xbd, 0x17, 0x91, 0x5f, 0xd5, 0xd5, 0x33, 0xf6, 0x4a, 0x7b, 0xe0, 0x94, 0xf1, + 0xde, 0x8b, 0xcf, 0x17, 0xef, 0x3b, 0x12, 0x1a, 0xc1, 0xf1, 0x6a, 0x10, 0xfa, 0xb1, 0xcf, 0xb4, + 0xe0, 0xb8, 0xaf, 0xf3, 0xc0, 0x91, 0x60, 0xff, 0x83, 0x53, 0x27, 0x3e, 0x9b, 0x1e, 0xaf, 0x5a, + 0xfe, 0xe4, 0xb1, 0x7d, 0x1a, 0xf2, 0xe0, 0xec, 0x91, 0xe3, 0x3f, 0x3e, 0xe6, 0xf6, 0xa9, 0x08, + 0x1f, 0x5f, 0xac, 0x3d, 0x0e, 0x8e, 0x1f, 0x27, 0x43, 0xfb, 0x8f, 0x72, 0x7d, 0x4f, 0xfd, 0x53, + 0xff, 0x31, 0xa1, 0x8f, 0xa7, 0x27, 0x04, 0x11, 0x40, 0x2d, 0xd9, 0xdd, 0xe8, 0x43, 0x65, 0xd7, + 0x89, 0x62, 0xc6, 0xa0, 0x32, 0x75, 0xec, 0xa8, 0x57, 0x5a, 0x2e, 0xaf, 0xd4, 0x4c, 0x6a, 0x1b, + 0x7b, 0xa0, 0x8f, 0x78, 0x74, 0xfe, 0x9c, 0xbb, 0x53, 0xc1, 0xba, 0x50, 0xbe, 0xe0, 0x6e, 0xaf, + 0xb4, 0x5c, 0x5a, 0x69, 0x99, 0xd8, 0x64, 0xab, 0xd0, 0xb8, 0xe0, 0xee, 0x38, 0xbe, 0x0c, 0x44, + 0x4f, 0x5b, 0x2e, 0xad, 0x74, 0xd6, 0x6e, 0xaf, 0x06, 0xc7, 0xab, 0x87, 0x7e, 0x14, 0x3b, 0xde, + 0xe9, 0xea, 0x73, 0xee, 0x8e, 0x2e, 0x03, 0x61, 0xd6, 0x2f, 0x64, 0xc3, 0x38, 0x80, 0xe6, 0x30, + 0xb4, 0xb6, 0xa7, 0x9e, 0x15, 0x3b, 0xbe, 0x87, 0x2b, 0x7a, 0x7c, 0x22, 0x68, 0x46, 0xdd, 0xa4, + 0x36, 0xe2, 0x78, 0x78, 0x1a, 0xf5, 0xca, 0xcb, 0x65, 0xc4, 0x61, 0x9b, 0xf5, 0xa0, 0xee, 0x44, + 0x9b, 0xfe, 0xd4, 0x8b, 0x7b, 0x95, 0xe5, 0xd2, 0x4a, 0xc3, 0x4c, 0x40, 0xe3, 0x2f, 0xca, 0x50, + 0xfd, 0x62, 0x2a, 0xc2, 0x4b, 0x1a, 0x17, 0xc7, 0x61, 0x32, 0x17, 0xb6, 0xd9, 0x1d, 0xa8, 0xba, + 0xdc, 0x3b, 0x8d, 0x7a, 0x1a, 0x4d, 0x26, 0x01, 0x76, 0x0f, 0x74, 0x7e, 0x12, 0x8b, 0x70, 0x3c, + 0x75, 0xec, 0x5e, 0x79, 0xb9, 0xb4, 0x52, 0x33, 0x1b, 0x84, 0x38, 0x72, 0x6c, 0xf6, 0x03, 0x68, + 0xd8, 0xfe, 0xd8, 0xca, 0xaf, 0x65, 0xfb, 0xb4, 0x16, 0x7b, 0x1b, 0x1a, 0x53, 0xc7, 0x1e, 0xbb, + 0x4e, 0x14, 0xf7, 0xaa, 0xcb, 0xa5, 0x95, 0xe6, 0x5a, 0x03, 0x0f, 0x8b, 0xbc, 0x33, 0xeb, 0x53, + 0xc7, 0x26, 0x26, 0x7e, 0x00, 0x8d, 0x28, 0xb4, 0xc6, 0x27, 0x53, 0xcf, 0xea, 0xd5, 0xa8, 0xd3, + 0x4d, 0xec, 0x94, 0x3b, 0xb5, 0x59, 0x8f, 0x24, 0x80, 0xc7, 0x0a, 0xc5, 0x85, 0x08, 0x23, 0xd1, + 0xab, 0xcb, 0xa5, 0x14, 0xc8, 0x9e, 0x40, 0xf3, 0x84, 0x5b, 0x22, 0x1e, 0x07, 0x3c, 0xe4, 0x93, + 0x5e, 0x23, 0x9b, 0x68, 0x1b, 0xd1, 0x87, 0x88, 0x8d, 0x4c, 0x38, 0x49, 0x01, 0xf6, 0x31, 0xb4, + 0x09, 0x8a, 0xc6, 0x27, 0x8e, 0x1b, 0x8b, 0xb0, 0xa7, 0xd3, 0x98, 0x0e, 0x8d, 0x21, 0xcc, 0x28, + 0x14, 0xc2, 0x6c, 0xc9, 0x4e, 0x12, 0xc3, 0xde, 0x04, 0x10, 0xb3, 0x80, 0x7b, 0xf6, 0x98, 0xbb, + 0x6e, 0x0f, 0x68, 0x0f, 0xba, 0xc4, 0xac, 0xbb, 0x2e, 0xfb, 0x3e, 0xee, 0x8f, 0xdb, 0xe3, 0x38, + 0xea, 0xb5, 0x97, 0x4b, 0x2b, 0x15, 0xb3, 0x86, 0xe0, 0x28, 0x42, 0xbe, 0x5a, 0xdc, 0x3a, 0x13, + 0xbd, 0xce, 0x72, 0x69, 0xa5, 0x6a, 0x4a, 0x00, 0xb1, 0x27, 0x4e, 0x18, 0xc5, 0xbd, 0x9b, 0x12, + 0x4b, 0x80, 0xb1, 0x06, 0x3a, 0x49, 0x0f, 0x71, 0xe7, 0x01, 0xd4, 0x2e, 0x10, 0x90, 0x42, 0xd6, + 0x5c, 0x6b, 0xe3, 0xf6, 0x52, 0x01, 0x33, 0x15, 0xd1, 0xb8, 0x0f, 0x8d, 0x5d, 0xee, 0x9d, 0x26, + 0x52, 0x89, 0xd7, 0x46, 0x03, 0x74, 0x93, 0xda, 0xc6, 0x2f, 0x35, 0xa8, 0x99, 0x22, 0x9a, 0xba, + 0x31, 0x7b, 0x0f, 0x00, 0x2f, 0x65, 0xc2, 0xe3, 0xd0, 0x99, 0xa9, 0x59, 0xb3, 0x6b, 0xd1, 0xa7, + 0x8e, 0xbd, 0x47, 0x24, 0xf6, 0x04, 0x5a, 0x34, 0x7b, 0xd2, 0x55, 0xcb, 0x36, 0x90, 0xee, 0xcf, + 0x6c, 0x52, 0x17, 0x35, 0xe2, 0x2e, 0xd4, 0x48, 0x0e, 0xa4, 0x2c, 0xb6, 0x4d, 0x05, 0xb1, 0x07, + 0xd0, 0x71, 0xbc, 0x18, 0xef, 0xc9, 0x8a, 0xc7, 0xb6, 0x88, 0x12, 0x41, 0x69, 0xa7, 0xd8, 0x2d, + 0x11, 0xc5, 0xec, 0x23, 0x90, 0xcc, 0x4e, 0x16, 0xac, 0xd2, 0x82, 0x9d, 0xf4, 0x12, 0x23, 0xb9, + 0x22, 0xf5, 0x51, 0x2b, 0x3e, 0x82, 0x26, 0x9e, 0x2f, 0x19, 0x51, 0xa3, 0x11, 0x2d, 0x3a, 0x8d, + 0x62, 0x87, 0x09, 0xd8, 0x41, 0x75, 0x47, 0xd6, 0xa0, 0x30, 0x4a, 0xe1, 0xa1, 0xb6, 0x31, 0x80, + 0xea, 0x41, 0x68, 0x8b, 0x70, 0xa1, 0x3e, 0x30, 0xa8, 0xd8, 0x22, 0xb2, 0x48, 0x55, 0x1b, 0x26, + 0xb5, 0x33, 0x1d, 0x29, 0xe7, 0x74, 0xc4, 0xf8, 0xf3, 0x12, 0x34, 0x87, 0x7e, 0x18, 0xef, 0x89, + 0x28, 0xe2, 0xa7, 0x82, 0x2d, 0x41, 0xd5, 0xc7, 0x69, 0x15, 0x87, 0x75, 0xdc, 0x13, 0xad, 0x63, + 0x4a, 0xfc, 0xdc, 0x3d, 0x68, 0xd7, 0xdf, 0x03, 0xca, 0x0e, 0x69, 0x57, 0x59, 0xc9, 0x0e, 0xe9, + 0xd6, 0x5d, 0xa8, 0xf9, 0x27, 0x27, 0x91, 0x90, 0xbc, 0xac, 0x9a, 0x0a, 0xba, 0x56, 0x04, 0x8d, + 0xdf, 0x00, 0xc0, 0xfd, 0x7d, 0x47, 0x29, 0x30, 0xce, 0xa0, 0x69, 0xf2, 0x93, 0x78, 0xd3, 0xf7, + 0x62, 0x31, 0x8b, 0x59, 0x07, 0x34, 0xc7, 0x26, 0x16, 0xd5, 0x4c, 0xcd, 0xb1, 0x71, 0x73, 0xa7, + 0xa1, 0x3f, 0x0d, 0x88, 0x43, 0x6d, 0x53, 0x02, 0xc4, 0x4a, 0xdb, 0x0e, 0x69, 0xc7, 0xc8, 0x4a, + 0xdb, 0x0e, 0xd9, 0x12, 0x34, 0x23, 0x8f, 0x07, 0xd1, 0x99, 0x1f, 0xe3, 0xe6, 0x2a, 0xb4, 0x39, + 0x48, 0x50, 0xa3, 0xc8, 0xf8, 0x4f, 0x0d, 0x6a, 0x7b, 0x62, 0x72, 0x2c, 0xc2, 0x2b, 0xab, 0x3c, + 0x81, 0x06, 0x4d, 0x3c, 0x76, 0x6c, 0xb9, 0xd0, 0xc6, 0xf7, 0x5e, 0xbe, 0x58, 0xba, 0x45, 0xb8, + 0x1d, 0xfb, 0x43, 0x7f, 0xe2, 0xc4, 0x62, 0x12, 0xc4, 0x97, 0x66, 0x5d, 0xa1, 0x16, 0xee, 0xe0, + 0x2e, 0xd4, 0x5c, 0xc1, 0xf1, 0x4e, 0xa4, 0xf8, 0x29, 0x88, 0x3d, 0x82, 0x3a, 0x9f, 0x8c, 0x6d, + 0xc1, 0x6d, 0xb2, 0x52, 0x8d, 0x8d, 0x3b, 0x2f, 0x5f, 0x2c, 0x75, 0xf9, 0x64, 0x4b, 0xf0, 0xfc, + 0xdc, 0x35, 0x89, 0x61, 0x9f, 0xa0, 0xcc, 0x45, 0xf1, 0x78, 0x1a, 0xd8, 0x3c, 0x16, 0x64, 0xb3, + 0x2a, 0x1b, 0xbd, 0x97, 0x2f, 0x96, 0xee, 0x20, 0xfa, 0x88, 0xb0, 0xb9, 0x61, 0x90, 0x61, 0xd9, + 0x0e, 0xdc, 0xb2, 0xdc, 0x69, 0x84, 0xa6, 0xd4, 0xf1, 0x4e, 0xfc, 0xb1, 0xef, 0xb9, 0x97, 0x74, + 0x4d, 0x8d, 0x8d, 0x37, 0x5f, 0xbe, 0x58, 0xfa, 0x81, 0x22, 0xee, 0x78, 0x27, 0xfe, 0x81, 0xe7, + 0x5e, 0xe6, 0x66, 0xb9, 0x39, 0x47, 0x62, 0xbf, 0x0d, 0x9d, 0x13, 0x3f, 0xb4, 0xc4, 0x38, 0x65, + 0x4c, 0x87, 0xe6, 0xe9, 0xbf, 0x7c, 0xb1, 0x74, 0x97, 0x28, 0x4f, 0xaf, 0x70, 0xa7, 0x95, 0xc7, + 0x1b, 0x7f, 0xab, 0x41, 0x95, 0xda, 0xec, 0x09, 0xd4, 0x27, 0xc4, 0xf8, 0xc4, 0xca, 0xdc, 0x45, + 0x49, 0x20, 0xda, 0xaa, 0xbc, 0x91, 0x68, 0xe0, 0xc5, 0xe1, 0xa5, 0x99, 0x74, 0xc3, 0x11, 0x31, + 0x3f, 0x76, 0x45, 0x1c, 0x29, 0xc9, 0xcd, 0x8d, 0x18, 0x49, 0x82, 0x1a, 0xa1, 0xba, 0xcd, 0x5f, + 0x7f, 0x79, 0xfe, 0xfa, 0x59, 0x1f, 0x1a, 0xd6, 0x99, 0xb0, 0xce, 0xa3, 0xe9, 0x44, 0x09, 0x47, + 0x0a, 0xf7, 0xb7, 0xa1, 0x95, 0xdf, 0x07, 0xfa, 0xd5, 0x73, 0x71, 0x49, 0x02, 0x52, 0x31, 0xb1, + 0xc9, 0x96, 0xa1, 0x4a, 0x96, 0x88, 0xc4, 0xa3, 0xb9, 0x06, 0xb8, 0x1d, 0x39, 0xc4, 0x94, 0x84, + 0x4f, 0xb5, 0x1f, 0x95, 0x70, 0x9e, 0xfc, 0xee, 0xf2, 0xf3, 0xe8, 0xd7, 0xcf, 0x23, 0x87, 0xe4, + 0xe6, 0x31, 0x7c, 0xa8, 0xef, 0x3a, 0x96, 0xf0, 0x22, 0xf2, 0xbe, 0xd3, 0x48, 0xa4, 0x56, 0x03, + 0xdb, 0x78, 0x94, 0x09, 0x9f, 0xed, 0xfb, 0xb6, 0x88, 0x68, 0x9e, 0x8a, 0x99, 0xc2, 0x48, 0x13, + 0xb3, 0xc0, 0x09, 0x2f, 0x47, 0x92, 0x09, 0x65, 0x33, 0x85, 0xd1, 0xbd, 0x09, 0x0f, 0x17, 0xb3, + 0x13, 0x4f, 0xaa, 0x40, 0xe3, 0x2f, 0xcb, 0xd0, 0xfa, 0x4a, 0x84, 0xfe, 0x61, 0xe8, 0x07, 0x7e, + 0xc4, 0x5d, 0xb6, 0x5e, 0x64, 0xa7, 0xbc, 0xb6, 0x65, 0xdc, 0x6d, 0xbe, 0xdb, 0xea, 0x30, 0xe5, + 0xaf, 0xbc, 0x8e, 0x3c, 0xc3, 0x0d, 0xa8, 0xc9, 0xeb, 0x5c, 0xc0, 0x33, 0x45, 0xc1, 0x3e, 0xf2, + 0x02, 0x69, 0xaf, 0x45, 0x7e, 0x28, 0x0a, 0xbb, 0x0f, 0x30, 0xe1, 0xb3, 0x5d, 0xc1, 0x23, 0xb1, + 0x63, 0x27, 0x7a, 0x9d, 0x61, 0x14, 0x37, 0x46, 0x33, 0x6f, 0x14, 0x91, 0x7e, 0x49, 0x6e, 0x10, + 0xcc, 0xde, 0x00, 0x7d, 0xc2, 0x67, 0x68, 0x60, 0x76, 0x6c, 0xa9, 0x49, 0x66, 0x86, 0x60, 0x6f, + 0x41, 0x39, 0x9e, 0x79, 0x64, 0xad, 0xd1, 0x99, 0x63, 0x6c, 0x37, 0x9a, 0x79, 0xca, 0x14, 0x99, + 0x48, 0x4b, 0x6e, 0xb0, 0x91, 0xdd, 0x60, 0x17, 0xca, 0x96, 0x63, 0x93, 0x37, 0xd7, 0x4d, 0x6c, + 0xb2, 0x07, 0x50, 0x77, 0xe5, 0x6d, 0x91, 0xc7, 0x6e, 0xae, 0x35, 0xa5, 0xa1, 0x23, 0x94, 0x99, + 0xd0, 0xfa, 0xbf, 0x05, 0x37, 0xe7, 0xd8, 0x95, 0x97, 0x8f, 0xb6, 0x9c, 0xfd, 0x4e, 0x5e, 0x3e, + 0x2a, 0x79, 0x99, 0xf8, 0xd7, 0x32, 0xdc, 0x54, 0x42, 0x7a, 0xe6, 0x04, 0xc3, 0x18, 0xf5, 0xbd, + 0x07, 0x75, 0xb2, 0xd6, 0x4a, 0x3e, 0x2a, 0x66, 0x02, 0xb2, 0xdf, 0x84, 0x1a, 0x29, 0x6e, 0xa2, + 0x3f, 0x4b, 0x19, 0xf3, 0xd3, 0xe1, 0x52, 0x9f, 0xd4, 0xcd, 0xa9, 0xee, 0xec, 0x87, 0x50, 0xfd, + 0x5a, 0x84, 0xbe, 0xf4, 0x3e, 0xcd, 0xb5, 0xfb, 0x8b, 0xc6, 0xa1, 0x08, 0xa8, 0x61, 0xb2, 0xf3, + 0xaf, 0xf1, 0x8e, 0xde, 0x41, 0x7f, 0x33, 0xf1, 0x2f, 0x84, 0xdd, 0xab, 0xd3, 0x8e, 0xf2, 0x62, + 0x94, 0x90, 0x92, 0x4b, 0x69, 0x2c, 0xbc, 0x14, 0xfd, 0x15, 0x97, 0xb2, 0x05, 0xcd, 0x1c, 0x17, + 0x16, 0x5c, 0xc8, 0x52, 0x51, 0x61, 0xf5, 0xd4, 0x0e, 0xe5, 0xf5, 0x7e, 0x0b, 0x20, 0xe3, 0xc9, + 0xaf, 0x6a, 0x3d, 0x8c, 0xdf, 0x2b, 0xc1, 0xcd, 0x4d, 0xdf, 0xf3, 0x04, 0x45, 0xa5, 0xf2, 0x86, + 0x33, 0x25, 0x2a, 0x5d, 0xab, 0x44, 0xef, 0x43, 0x35, 0xc2, 0xce, 0x6a, 0xf6, 0xdb, 0x0b, 0xae, + 0xcc, 0x94, 0x3d, 0xd0, 0x4a, 0x4e, 0xf8, 0x6c, 0x1c, 0x08, 0xcf, 0x76, 0xbc, 0xd3, 0xc4, 0x4a, + 0x4e, 0xf8, 0xec, 0x50, 0x62, 0x8c, 0x3f, 0xd5, 0x00, 0x3e, 0x13, 0xdc, 0x8d, 0xcf, 0xd0, 0x13, + 0xe0, 0xbd, 0x39, 0x5e, 0x14, 0x73, 0xcf, 0x4a, 0x72, 0x82, 0x14, 0x46, 0xe1, 0x43, 0xb7, 0x27, + 0x22, 0x69, 0x84, 0x74, 0x33, 0x01, 0xd1, 0x11, 0xe2, 0x72, 0xd3, 0x48, 0xb9, 0x47, 0x05, 0x65, + 0xce, 0xbc, 0x42, 0x68, 0xe5, 0xcc, 0x7b, 0x50, 0xc7, 0x18, 0xdb, 0xf1, 0x3d, 0x12, 0x0d, 0xdd, + 0x4c, 0x40, 0x9c, 0x67, 0x1a, 0xc4, 0xce, 0x44, 0x3a, 0xc1, 0xb2, 0xa9, 0x20, 0xdc, 0x15, 0x3a, + 0xbd, 0x81, 0x75, 0xe6, 0x93, 0xf2, 0x96, 0xcd, 0x14, 0xc6, 0xd9, 0x7c, 0xef, 0xd4, 0xc7, 0xd3, + 0x35, 0x28, 0x7e, 0x4a, 0x40, 0x79, 0x16, 0x5b, 0xcc, 0x90, 0xa4, 0x13, 0x29, 0x85, 0x91, 0x2f, + 0x42, 0x8c, 0x4f, 0x04, 0x8f, 0xa7, 0xa1, 0x88, 0x7a, 0x40, 0x64, 0x10, 0x62, 0x5b, 0x61, 0x8c, + 0xdf, 0xd5, 0xa0, 0x26, 0xed, 0x52, 0x21, 0x58, 0x28, 0x7d, 0xab, 0x60, 0xe1, 0x0d, 0xd0, 0x83, + 0x50, 0xd8, 0x8e, 0x95, 0x5c, 0x92, 0x6e, 0x66, 0x08, 0x8a, 0xd2, 0xd1, 0x6f, 0x12, 0xb3, 0x1a, + 0xa6, 0x04, 0x10, 0x1b, 0x05, 0xdc, 0x12, 0xea, 0x80, 0x12, 0x40, 0x8e, 0x48, 0x91, 0x27, 0x51, + 0x6f, 0x98, 0x0a, 0x62, 0x1f, 0x83, 0x4e, 0x51, 0x19, 0x39, 0x7c, 0x9d, 0x1c, 0xf5, 0xdd, 0x97, + 0x2f, 0x96, 0x18, 0x22, 0xe7, 0x3c, 0x7d, 0x23, 0xc1, 0x61, 0x5c, 0x82, 0x83, 0xd1, 0xbe, 0x03, + 0x05, 0x19, 0x14, 0x97, 0x20, 0x6a, 0x14, 0xe5, 0xe3, 0x12, 0x89, 0x31, 0xfe, 0x59, 0x83, 0xd6, + 0x96, 0x13, 0x0a, 0x2b, 0x16, 0xf6, 0xc0, 0x3e, 0xa5, 0xcd, 0x08, 0x2f, 0x76, 0xe2, 0x4b, 0x15, + 0x49, 0x29, 0x28, 0x0d, 0x74, 0xb5, 0x62, 0xe2, 0x27, 0x35, 0xa0, 0x4c, 0xb9, 0xaa, 0x04, 0xd8, + 0x1a, 0x80, 0x4c, 0x01, 0x28, 0x5f, 0xad, 0x5c, 0x9f, 0xaf, 0xea, 0xd4, 0x0d, 0x9b, 0x98, 0x0f, + 0xca, 0x31, 0x8e, 0x0c, 0xa7, 0x6a, 0x94, 0xcc, 0x4e, 0xd1, 0xca, 0x50, 0xe4, 0x7c, 0x2c, 0x5c, + 0x12, 0x17, 0x8a, 0x9c, 0x8f, 0x85, 0x9b, 0xe6, 0x2b, 0x75, 0xb9, 0x1d, 0x6c, 0xb3, 0xb7, 0x41, + 0xf3, 0x03, 0xe2, 0xa1, 0x5a, 0x30, 0x7f, 0xb0, 0xd5, 0x83, 0xc0, 0xd4, 0xfc, 0x00, 0x75, 0x4f, + 0x26, 0x67, 0x24, 0x2e, 0xa8, 0x7b, 0xe8, 0x21, 0x28, 0x55, 0x30, 0x15, 0x85, 0x19, 0xd0, 0xe2, + 0xae, 0xeb, 0xff, 0x42, 0xd8, 0x87, 0xa1, 0xb0, 0x13, 0xc9, 0x29, 0xe0, 0x8c, 0xbb, 0xa0, 0x1d, + 0x04, 0xac, 0x0e, 0xe5, 0xe1, 0x60, 0xd4, 0xbd, 0x81, 0x8d, 0xad, 0xc1, 0x6e, 0xb7, 0x64, 0x7c, + 0xa3, 0x81, 0xbe, 0x37, 0x8d, 0x39, 0x6a, 0x7b, 0x84, 0xe7, 0x2a, 0x8a, 0x55, 0x26, 0x3f, 0x3f, + 0x80, 0x46, 0x14, 0xf3, 0x90, 0x3c, 0xb1, 0xf4, 0x0b, 0x75, 0x82, 0x47, 0x11, 0x7b, 0x17, 0xaa, + 0xc2, 0x3e, 0x15, 0x89, 0xb9, 0xee, 0xce, 0x9f, 0xc5, 0x94, 0x64, 0xb6, 0x02, 0xb5, 0xc8, 0x3a, + 0x13, 0x13, 0xde, 0xab, 0x64, 0x1d, 0x87, 0x84, 0x91, 0xb1, 0xa3, 0xa9, 0xe8, 0xec, 0x1d, 0xa8, + 0xe2, 0x6d, 0x44, 0x2a, 0xd9, 0xa1, 0xf4, 0x08, 0x19, 0xaf, 0xba, 0x49, 0x22, 0xca, 0x8e, 0x1d, + 0xfa, 0xc1, 0xd8, 0x0f, 0x88, 0xaf, 0x9d, 0xb5, 0x3b, 0x64, 0x75, 0x92, 0xd3, 0xac, 0x6e, 0x85, + 0x7e, 0x70, 0x10, 0x98, 0x35, 0x9b, 0xbe, 0x98, 0xd7, 0x52, 0x77, 0x29, 0x03, 0xd2, 0x4c, 0xeb, + 0x88, 0x91, 0x75, 0x8c, 0x15, 0x68, 0x4c, 0x44, 0xcc, 0x6d, 0x1e, 0x73, 0x65, 0xad, 0x5b, 0xd2, + 0x88, 0x49, 0x9c, 0x99, 0x52, 0x8d, 0xc7, 0x50, 0x93, 0x53, 0xb3, 0x06, 0x54, 0xf6, 0x0f, 0xf6, + 0x07, 0x92, 0xa1, 0xeb, 0xbb, 0xbb, 0xdd, 0x12, 0xa2, 0xb6, 0xd6, 0x47, 0xeb, 0x5d, 0x0d, 0x5b, + 0xa3, 0x9f, 0x1e, 0x0e, 0xba, 0x65, 0xe3, 0x9f, 0x4a, 0xd0, 0x48, 0xe6, 0x61, 0x9f, 0x02, 0xa0, + 0xde, 0x8d, 0xcf, 0x1c, 0x2f, 0x0d, 0x6a, 0xee, 0xe5, 0x57, 0x5a, 0xc5, 0x1b, 0xfb, 0x0c, 0xa9, + 0xd2, 0xbd, 0x91, 0x9a, 0x12, 0xdc, 0x1f, 0x42, 0xa7, 0x48, 0x5c, 0x10, 0xdd, 0x3d, 0xcc, 0xdb, + 0xf9, 0xce, 0xda, 0xf7, 0x0a, 0x53, 0xe3, 0x48, 0x12, 0xe6, 0x9c, 0xc9, 0x7f, 0x04, 0x8d, 0x04, + 0xcd, 0x9a, 0x50, 0xdf, 0x1a, 0x6c, 0xaf, 0x1f, 0xed, 0xa2, 0x90, 0x00, 0xd4, 0x86, 0x3b, 0xfb, + 0x4f, 0x77, 0x07, 0xf2, 0x58, 0xbb, 0x3b, 0xc3, 0x51, 0x57, 0x33, 0xfe, 0xa4, 0x04, 0x8d, 0x24, + 0x86, 0x60, 0xef, 0xa3, 0xf3, 0xa7, 0x50, 0x45, 0xf9, 0x06, 0x2a, 0x47, 0xe4, 0x92, 0x29, 0x33, + 0xa1, 0xa3, 0x62, 0x90, 0xa9, 0x4b, 0xa2, 0x0a, 0x02, 0xf2, 0xa9, 0x5c, 0xb9, 0x50, 0x4d, 0xc0, + 0xac, 0xd4, 0xf7, 0x84, 0x0a, 0x12, 0xa9, 0x4d, 0x32, 0xe8, 0x78, 0x16, 0x59, 0x8b, 0xaa, 0x92, + 0x41, 0x84, 0x47, 0x91, 0xf1, 0xd7, 0x15, 0xe8, 0x98, 0x22, 0x8a, 0xfd, 0x50, 0x98, 0xe2, 0xe7, + 0x53, 0x4c, 0xb5, 0x5f, 0x21, 0xcc, 0x6f, 0x02, 0x84, 0xb2, 0x73, 0x26, 0xce, 0xba, 0xc2, 0xc8, + 0x30, 0xdd, 0xf5, 0x2d, 0x92, 0x22, 0xe5, 0x3d, 0x52, 0x98, 0xdd, 0x03, 0xfd, 0x98, 0x5b, 0xe7, + 0x72, 0x5a, 0xe9, 0x43, 0x1a, 0x12, 0x21, 0xe7, 0xe5, 0x96, 0x25, 0xa2, 0x68, 0x8c, 0x97, 0x22, + 0x3d, 0x89, 0x2e, 0x31, 0xcf, 0xc4, 0x25, 0x92, 0x23, 0x61, 0x85, 0x22, 0x26, 0xb2, 0x34, 0x10, + 0xba, 0xc4, 0x20, 0xf9, 0x6d, 0x68, 0x47, 0x22, 0x42, 0xaf, 0x33, 0x8e, 0xfd, 0x73, 0xe1, 0x29, + 0x6b, 0xd1, 0x52, 0xc8, 0x11, 0xe2, 0xd0, 0x8e, 0x73, 0xcf, 0xf7, 0x2e, 0x27, 0xfe, 0x34, 0x52, + 0x06, 0x38, 0x43, 0xb0, 0x55, 0xb8, 0x2d, 0x3c, 0x2b, 0xbc, 0x0c, 0x70, 0xaf, 0xb8, 0xca, 0xf8, + 0xc4, 0x71, 0x85, 0x0a, 0x14, 0x6f, 0x65, 0xa4, 0x67, 0xe2, 0x72, 0xdb, 0x71, 0x05, 0xee, 0xe8, + 0x82, 0x4f, 0xdd, 0x78, 0x4c, 0x89, 0x24, 0xc8, 0x1d, 0x11, 0x66, 0x1d, 0xb3, 0xc9, 0x0f, 0xe0, + 0x96, 0x24, 0x87, 0xbe, 0x2b, 0x1c, 0x5b, 0x4e, 0xd6, 0xa4, 0x5e, 0x37, 0x89, 0x60, 0x12, 0x9e, + 0xa6, 0x5a, 0x85, 0xdb, 0xb2, 0xaf, 0x3c, 0x50, 0xd2, 0xbb, 0x25, 0x97, 0x26, 0xd2, 0x50, 0x51, + 0x8a, 0x4b, 0x07, 0x3c, 0x3e, 0xa3, 0x04, 0x31, 0x59, 0xfa, 0x90, 0xc7, 0x67, 0xe8, 0x0d, 0x25, + 0xf9, 0xc4, 0x11, 0xae, 0x4c, 0xfc, 0x74, 0x53, 0x8e, 0xd8, 0x46, 0x0c, 0x7b, 0x0b, 0x5a, 0xaa, + 0x83, 0x1f, 0x4e, 0xb8, 0xac, 0x2f, 0xe9, 0xa6, 0x1c, 0xb4, 0x4d, 0x28, 0x5c, 0x42, 0xdd, 0x95, + 0x37, 0x9d, 0xf4, 0xba, 0xf2, 0x9a, 0x25, 0x66, 0x7f, 0x3a, 0x31, 0xfe, 0x57, 0x83, 0x46, 0x9a, + 0x6c, 0x3c, 0x04, 0x7d, 0x92, 0x58, 0x0e, 0x15, 0xc4, 0xb4, 0x0b, 0xe6, 0xc4, 0xcc, 0xe8, 0xec, + 0x4d, 0xd0, 0xce, 0x2f, 0x94, 0x15, 0x6b, 0xaf, 0xca, 0x7a, 0x6b, 0x70, 0xbc, 0xb6, 0xfa, 0xec, + 0xb9, 0xa9, 0x9d, 0x5f, 0x64, 0xc1, 0x50, 0xf5, 0xb5, 0xc1, 0xd0, 0x7b, 0x70, 0xd3, 0x72, 0x05, + 0xf7, 0xc6, 0x99, 0x73, 0x96, 0x72, 0xd1, 0x21, 0xf4, 0x61, 0xea, 0xa1, 0x95, 0xa2, 0xd7, 0x33, + 0x45, 0x7f, 0x00, 0x55, 0x5b, 0xb8, 0x31, 0xcf, 0x17, 0x02, 0x0f, 0x42, 0x6e, 0xb9, 0x62, 0x0b, + 0xd1, 0xa6, 0xa4, 0xa2, 0x5d, 0x4b, 0x12, 0xa2, 0xbc, 0x5d, 0x4b, 0x54, 0xd8, 0x4c, 0xa9, 0x99, + 0x86, 0x42, 0x5e, 0x43, 0x1f, 0xc2, 0x2d, 0x31, 0x0b, 0xc8, 0x98, 0x8f, 0xd3, 0xe4, 0xb5, 0x49, + 0x3d, 0xba, 0x09, 0x61, 0x53, 0xe1, 0xd9, 0x87, 0xa8, 0xce, 0xa4, 0x46, 0x74, 0xf1, 0xcd, 0x35, + 0x46, 0xf6, 0xa0, 0xa0, 0x98, 0x66, 0xd2, 0xc5, 0xf0, 0xa0, 0xfc, 0xec, 0xf9, 0x50, 0x71, 0xb3, + 0x74, 0x1d, 0x37, 0x13, 0x4b, 0xa0, 0xe5, 0x2c, 0xc1, 0x7d, 0x69, 0x44, 0x89, 0x35, 0x49, 0x91, + 0x2a, 0x87, 0xc1, 0xa3, 0x48, 0x07, 0x52, 0x91, 0xf5, 0x2b, 0x02, 0x8c, 0xff, 0x29, 0x43, 0x5d, + 0x79, 0x75, 0xe4, 0xe7, 0x34, 0xad, 0xbf, 0x60, 0xb3, 0x98, 0xf6, 0xa4, 0xe1, 0x41, 0xbe, 0x98, + 0x5d, 0x7e, 0x7d, 0x31, 0x9b, 0x7d, 0x0a, 0xad, 0x40, 0xd2, 0xf2, 0x01, 0xc5, 0xf7, 0xf3, 0x63, + 0xd4, 0x97, 0xc6, 0x35, 0x83, 0x0c, 0x40, 0x8b, 0x45, 0x95, 0xbe, 0x98, 0x9f, 0x92, 0xe8, 0xb4, + 0xcc, 0x3a, 0xc2, 0x23, 0x7e, 0x7a, 0x4d, 0x58, 0xf1, 0x6d, 0xa2, 0x83, 0x0e, 0x85, 0x19, 0x2d, + 0x32, 0x80, 0x18, 0x51, 0xe4, 0x1d, 0x79, 0xbb, 0xe8, 0xc8, 0xef, 0x81, 0x6e, 0xf9, 0x93, 0x89, + 0x43, 0xb4, 0x8e, 0xaa, 0x4f, 0x10, 0x62, 0x14, 0x19, 0x7f, 0x58, 0x82, 0xba, 0x3a, 0xed, 0x15, + 0x37, 0xb1, 0xb1, 0xb3, 0xbf, 0x6e, 0xfe, 0xb4, 0x5b, 0x42, 0x37, 0xb8, 0xb3, 0x3f, 0xea, 0x6a, + 0x4c, 0x87, 0xea, 0xf6, 0xee, 0xc1, 0xfa, 0xa8, 0x5b, 0x46, 0xd7, 0xb1, 0x71, 0x70, 0xb0, 0xdb, + 0xad, 0xb0, 0x16, 0x34, 0xb6, 0xd6, 0x47, 0x83, 0xd1, 0xce, 0xde, 0xa0, 0x5b, 0xc5, 0xbe, 0x4f, + 0x07, 0x07, 0xdd, 0x1a, 0x36, 0x8e, 0x76, 0xb6, 0xba, 0x75, 0xa4, 0x1f, 0xae, 0x0f, 0x87, 0x5f, + 0x1e, 0x98, 0x5b, 0xdd, 0x06, 0xb9, 0x9f, 0x91, 0xb9, 0xb3, 0xff, 0xb4, 0xab, 0x63, 0xfb, 0x60, + 0xe3, 0xf3, 0xc1, 0xe6, 0xa8, 0x0b, 0xc6, 0x47, 0xd0, 0xcc, 0x71, 0x10, 0x47, 0x9b, 0x83, 0xed, + 0xee, 0x0d, 0x5c, 0xf2, 0xf9, 0xfa, 0xee, 0x11, 0x7a, 0xab, 0x0e, 0x00, 0x35, 0xc7, 0xbb, 0xeb, + 0xfb, 0x4f, 0xbb, 0x9a, 0xf1, 0x05, 0x34, 0x8e, 0x1c, 0x7b, 0xc3, 0xf5, 0xad, 0x73, 0x14, 0xa7, + 0x63, 0x1e, 0x09, 0x95, 0x1a, 0x51, 0x1b, 0xa3, 0x48, 0x52, 0x96, 0x48, 0xdd, 0xbd, 0x82, 0x90, + 0x57, 0xde, 0x74, 0x32, 0xa6, 0x07, 0x90, 0xb2, 0x74, 0x21, 0xde, 0x74, 0x72, 0xe4, 0xd8, 0x91, + 0xb1, 0x0f, 0xf5, 0x23, 0xc7, 0x3e, 0xe4, 0xd6, 0x39, 0x99, 0x19, 0x9c, 0x7a, 0x1c, 0x39, 0x5f, + 0x0b, 0xe5, 0x6a, 0x74, 0xc2, 0x0c, 0x9d, 0xaf, 0x05, 0x7b, 0x07, 0x6a, 0x04, 0x24, 0x69, 0x30, + 0xa9, 0x5f, 0xb2, 0x1d, 0x53, 0xd1, 0x8c, 0x3f, 0x2a, 0xa5, 0xc7, 0xa2, 0x0a, 0xf7, 0x12, 0x54, + 0x02, 0x6e, 0x9d, 0x2b, 0xb7, 0xda, 0x54, 0x63, 0x70, 0x3d, 0x93, 0x08, 0xec, 0x3d, 0x68, 0x28, + 0xd9, 0x49, 0x26, 0x6e, 0xe6, 0x84, 0xcc, 0x4c, 0x89, 0xc5, 0x5b, 0x2d, 0x17, 0x6f, 0x95, 0xd2, + 0xa4, 0xc0, 0x75, 0x62, 0xa9, 0x29, 0x15, 0x53, 0x41, 0xc6, 0x0f, 0x01, 0xb2, 0x47, 0x85, 0x05, + 0x51, 0xc6, 0x1d, 0xa8, 0x72, 0xd7, 0xe1, 0x49, 0xda, 0x25, 0x01, 0x63, 0x1f, 0x9a, 0xb9, 0xa7, + 0x08, 0x64, 0x1f, 0x77, 0x5d, 0x74, 0x43, 0x11, 0x8d, 0x6d, 0x98, 0x75, 0xee, 0xba, 0xcf, 0xc4, + 0x65, 0x84, 0x11, 0x9e, 0x7c, 0xc5, 0xd0, 0xe6, 0x0a, 0xe0, 0x34, 0xd4, 0x94, 0x44, 0xe3, 0x43, + 0xa8, 0x6d, 0x27, 0x31, 0x6e, 0x22, 0xe9, 0xa5, 0xeb, 0x24, 0xdd, 0xf8, 0x44, 0xed, 0x99, 0x6a, + 0xe8, 0xec, 0xa1, 0x7a, 0x2d, 0x89, 0xe4, 0xdb, 0x4c, 0x29, 0x4b, 0xdc, 0x65, 0x27, 0xf5, 0x50, + 0x42, 0x9d, 0x8d, 0x2d, 0x68, 0xbc, 0xf2, 0xfd, 0x49, 0x31, 0x40, 0xcb, 0x18, 0xb0, 0xe0, 0x45, + 0xca, 0xf8, 0x19, 0x40, 0xf6, 0xaa, 0xa2, 0x14, 0x4f, 0xce, 0x82, 0x8a, 0xf7, 0x01, 0x34, 0xac, + 0x33, 0xc7, 0xb5, 0x43, 0xe1, 0x15, 0x4e, 0x9d, 0xbd, 0xc3, 0xa4, 0x74, 0xb6, 0x0c, 0x15, 0x7a, + 0x2c, 0x2a, 0x67, 0x06, 0x3b, 0x7d, 0x29, 0x22, 0x8a, 0x31, 0x83, 0xb6, 0x0c, 0x9d, 0xbf, 0x45, + 0xb8, 0x53, 0xb4, 0x96, 0xda, 0x15, 0x6b, 0x79, 0x17, 0x6a, 0xe4, 0x65, 0x93, 0xd3, 0x28, 0xe8, + 0x1a, 0x2b, 0xfa, 0xfb, 0x1a, 0x80, 0x5c, 0x7a, 0xdf, 0xb7, 0x45, 0x31, 0xb1, 0x2c, 0xcd, 0x27, + 0x96, 0x0c, 0x2a, 0xe9, 0x3b, 0xa0, 0x6e, 0x52, 0x3b, 0xf3, 0x33, 0x2a, 0xd9, 0x94, 0x7e, 0xe6, + 0x0d, 0xd0, 0x29, 0xea, 0x71, 0xbe, 0xa6, 0xe2, 0x35, 0x2e, 0x98, 0x21, 0xf2, 0xaf, 0x62, 0xd5, + 0xe2, 0xab, 0x58, 0xfa, 0x74, 0x50, 0x93, 0xb3, 0xc9, 0xa7, 0x83, 0x05, 0xaf, 0x20, 0x32, 0x95, + 0x8f, 0x44, 0x18, 0x27, 0x89, 0xab, 0x84, 0xd2, 0xe4, 0x4c, 0x57, 0x7d, 0xb9, 0x4c, 0xc6, 0x3d, + 0x7f, 0x6c, 0xf9, 0xde, 0x89, 0xeb, 0x58, 0xb1, 0x7a, 0x05, 0x03, 0xcf, 0xdf, 0x54, 0x18, 0xe3, + 0x53, 0x68, 0x25, 0xfc, 0xa7, 0xc7, 0x86, 0x0f, 0xd2, 0xe4, 0xa6, 0x94, 0xdd, 0x6d, 0xc6, 0xa6, + 0x0d, 0xad, 0x57, 0x4a, 0xd2, 0x1b, 0xe3, 0xbf, 0xcb, 0xc9, 0x60, 0x55, 0x33, 0x7f, 0x35, 0x0f, + 0x8b, 0x19, 0xaa, 0xf6, 0xad, 0x32, 0xd4, 0x1f, 0x81, 0x6e, 0x53, 0x0a, 0xe6, 0x5c, 0x24, 0x7e, + 0xab, 0x3f, 0x9f, 0x6e, 0xa9, 0x24, 0xcd, 0xb9, 0x10, 0x66, 0xd6, 0xf9, 0x35, 0xf7, 0x90, 0x72, + 0xbb, 0xba, 0x88, 0xdb, 0xb5, 0x5f, 0x91, 0xdb, 0x6f, 0x41, 0xcb, 0xf3, 0xbd, 0xb1, 0x37, 0x75, + 0x5d, 0x7e, 0xec, 0x0a, 0xc5, 0xee, 0xa6, 0xe7, 0x7b, 0xfb, 0x0a, 0x85, 0xa1, 0x68, 0xbe, 0x8b, + 0x54, 0xea, 0x26, 0xf5, 0xbb, 0x99, 0xeb, 0x47, 0xaa, 0xbf, 0x02, 0x5d, 0xff, 0xf8, 0x67, 0xc2, + 0x8a, 0x89, 0x63, 0x63, 0xd2, 0x66, 0x19, 0x87, 0x76, 0x24, 0x1e, 0x59, 0xb4, 0x8f, 0x7a, 0x3d, + 0x77, 0xcd, 0xed, 0x2b, 0xd7, 0xfc, 0x09, 0xe8, 0x29, 0x97, 0x72, 0xe9, 0x9e, 0x0e, 0xd5, 0x9d, + 0xfd, 0xad, 0xc1, 0x4f, 0xba, 0x25, 0xf4, 0x85, 0xe6, 0xe0, 0xf9, 0xc0, 0x1c, 0x0e, 0xba, 0x1a, + 0xfa, 0xa9, 0xad, 0xc1, 0xee, 0x60, 0x34, 0xe8, 0x96, 0x3f, 0xaf, 0x34, 0xea, 0xdd, 0x06, 0x55, + 0xbe, 0x5d, 0xc7, 0x72, 0x62, 0x63, 0x08, 0x90, 0xe5, 0xb0, 0x68, 0x95, 0xb3, 0xcd, 0xa9, 0xb2, + 0x56, 0x9c, 0x6c, 0x6b, 0x25, 0x55, 0x48, 0xed, 0xba, 0x4c, 0x59, 0xd2, 0x8d, 0x35, 0xd0, 0xf7, + 0x78, 0xf0, 0x99, 0x7c, 0xe4, 0x79, 0x00, 0x9d, 0x80, 0x87, 0xb1, 0x93, 0x04, 0xff, 0xd2, 0x58, + 0xb6, 0xcc, 0x76, 0x8a, 0x45, 0xdb, 0x6b, 0x1c, 0x41, 0x63, 0x8f, 0x07, 0x57, 0xf2, 0xc7, 0x56, + 0x5a, 0x5b, 0x9e, 0xaa, 0x27, 0x28, 0x15, 0x18, 0x3d, 0x80, 0xba, 0x72, 0x26, 0xca, 0x1e, 0x15, + 0x1c, 0x4d, 0x42, 0x33, 0xfe, 0xa6, 0x04, 0x77, 0xf6, 0xfc, 0x0b, 0x91, 0xc6, 0xac, 0x87, 0xfc, + 0xd2, 0xf5, 0xb9, 0xfd, 0x1a, 0xe9, 0xc6, 0xa4, 0xc8, 0x9f, 0xd2, 0x2b, 0x4f, 0xf2, 0xf2, 0x65, + 0xea, 0x12, 0xf3, 0x54, 0x3d, 0xbd, 0x8b, 0x28, 0x26, 0xa2, 0x72, 0xc1, 0x08, 0x23, 0xe9, 0x7b, + 0x50, 0x8b, 0x67, 0x5e, 0xf6, 0xd0, 0x56, 0x8d, 0xa9, 0x96, 0xbb, 0x30, 0x60, 0xad, 0x2e, 0x0e, + 0x58, 0x8d, 0x4d, 0xd0, 0x47, 0x33, 0xaa, 0x73, 0x4e, 0xa3, 0x42, 0x68, 0x54, 0x7a, 0x45, 0x68, + 0xa4, 0xcd, 0x85, 0x46, 0xff, 0x51, 0x82, 0x66, 0x2e, 0xf2, 0x66, 0x6f, 0x41, 0x25, 0x9e, 0x79, + 0xc5, 0xe7, 0xec, 0x64, 0x11, 0x93, 0x48, 0x28, 0xf1, 0x13, 0x3e, 0x1b, 0xf3, 0x28, 0x72, 0x4e, + 0x3d, 0x61, 0xab, 0x29, 0x9b, 0x13, 0x3e, 0x5b, 0x57, 0x28, 0xb6, 0x0b, 0x37, 0xa5, 0x41, 0x4f, + 0x0e, 0x91, 0x14, 0x58, 0xde, 0x9e, 0x8b, 0xf4, 0x65, 0x2d, 0x38, 0x39, 0x92, 0xaa, 0x1a, 0x74, + 0x4e, 0x0b, 0xc8, 0xfe, 0x3a, 0xdc, 0x5e, 0xd0, 0xed, 0x3b, 0x55, 0xff, 0x97, 0xa0, 0x3d, 0x9a, + 0x79, 0x23, 0x67, 0x22, 0xa2, 0x98, 0x4f, 0x02, 0x0a, 0x2d, 0x95, 0x43, 0xae, 0x98, 0x5a, 0x1c, + 0x19, 0xef, 0x42, 0xeb, 0x50, 0x88, 0xd0, 0x14, 0x51, 0xe0, 0x7b, 0x32, 0xac, 0x52, 0x35, 0x58, + 0xe9, 0xfd, 0x15, 0x64, 0xfc, 0x0e, 0xe8, 0x26, 0x3f, 0x89, 0x37, 0x78, 0x6c, 0x9d, 0x7d, 0x97, + 0x12, 0xc2, 0xbb, 0x50, 0x0f, 0xa4, 0x4c, 0xa9, 0x0c, 0xad, 0x45, 0x51, 0x80, 0x92, 0x33, 0x33, + 0x21, 0x1a, 0x1f, 0xc1, 0xed, 0xe1, 0xf4, 0x38, 0xb2, 0x42, 0x87, 0x92, 0xdd, 0xc4, 0x43, 0xf6, + 0xa1, 0x11, 0x84, 0xe2, 0xc4, 0x99, 0x89, 0x44, 0x31, 0x52, 0xd8, 0xf8, 0x31, 0xdc, 0x29, 0x0e, + 0x51, 0x47, 0x78, 0x1b, 0xca, 0xe7, 0x17, 0x91, 0xda, 0xd9, 0xad, 0x42, 0x72, 0x42, 0xaf, 0xc8, + 0x48, 0x35, 0x4c, 0x28, 0xef, 0x4f, 0x27, 0xf9, 0x3f, 0x61, 0x2a, 0xf2, 0x4f, 0x98, 0x7b, 0xf9, + 0x92, 0xa8, 0xcc, 0x5f, 0xb2, 0xd2, 0xe7, 0x1b, 0xa0, 0x9f, 0xf8, 0xe1, 0x2f, 0x78, 0x68, 0x0b, + 0x5b, 0xb9, 0xc2, 0x0c, 0x61, 0x7c, 0x05, 0xcd, 0x44, 0x12, 0x76, 0x6c, 0x7a, 0x36, 0x23, 0x51, + 0xdc, 0xb1, 0x0b, 0x92, 0x29, 0x0b, 0x8e, 0xc2, 0xb3, 0x77, 0x12, 0x11, 0x92, 0x40, 0x71, 0x65, + 0xf5, 0xda, 0x91, 0xac, 0x6c, 0x6c, 0x43, 0x2b, 0x49, 0xff, 0xf6, 0x44, 0xcc, 0x49, 0xb8, 0x5d, + 0x47, 0x78, 0x39, 0xc1, 0x6f, 0x48, 0xc4, 0xa8, 0x58, 0x13, 0xd4, 0x0a, 0x71, 0x85, 0xb1, 0x0a, + 0x35, 0xa5, 0x39, 0x0c, 0x2a, 0x96, 0x6f, 0x4b, 0xed, 0xae, 0x9a, 0xd4, 0x46, 0x76, 0x4c, 0xa2, + 0xd3, 0x24, 0x66, 0x9a, 0x44, 0xa7, 0xc6, 0xdf, 0x69, 0xd0, 0xde, 0xa0, 0xf4, 0x3b, 0xb9, 0x92, + 0x5c, 0xf9, 0xa7, 0x54, 0x28, 0xff, 0xe4, 0x4b, 0x3d, 0x5a, 0xa1, 0xd4, 0x53, 0xd8, 0x50, 0xb9, + 0x18, 0xe8, 0x7c, 0x1f, 0xea, 0x53, 0xcf, 0x99, 0x25, 0x26, 0x41, 0x37, 0x6b, 0x08, 0x8e, 0x22, + 0xb6, 0x0c, 0x4d, 0xb4, 0x1a, 0x8e, 0x27, 0x8b, 0x3a, 0xb2, 0x32, 0x93, 0x47, 0xcd, 0x95, 0x6e, + 0x6a, 0xaf, 0x2e, 0xdd, 0xd4, 0x5f, 0x5b, 0xba, 0x69, 0xbc, 0xae, 0x74, 0xa3, 0xcf, 0x97, 0x6e, + 0x8a, 0x41, 0x1a, 0xcc, 0x07, 0x69, 0xc6, 0x9f, 0x69, 0xd0, 0x1e, 0xcc, 0x02, 0xfa, 0xbd, 0xe1, + 0xb5, 0x11, 0x5f, 0x8e, 0xaf, 0x5a, 0x81, 0xaf, 0x39, 0x0e, 0x95, 0xd5, 0x7b, 0x86, 0xe4, 0x10, + 0xc6, 0x80, 0xb2, 0x90, 0xa2, 0x38, 0x27, 0xa1, 0xff, 0x07, 0x9c, 0x33, 0x76, 0xa1, 0x93, 0x30, + 0x46, 0x69, 0xed, 0xb7, 0x12, 0x47, 0xf9, 0x6b, 0x92, 0x9b, 0xd6, 0x0f, 0x24, 0x60, 0xfc, 0xb1, + 0x06, 0xba, 0x14, 0x52, 0xdc, 0xde, 0xfb, 0x2a, 0x7e, 0x2d, 0x65, 0xc5, 0xd4, 0x94, 0xb8, 0xfa, + 0x4c, 0x5c, 0x52, 0xdc, 0x25, 0xc3, 0xda, 0x45, 0x4f, 0x0e, 0xca, 0x99, 0xca, 0xac, 0x8b, 0x9c, + 0xe9, 0x3d, 0xd0, 0xa5, 0x8f, 0x99, 0x3a, 0xc9, 0x23, 0xa5, 0x74, 0x3a, 0x47, 0x0e, 0xfd, 0xd1, + 0x11, 0x8b, 0x70, 0xa2, 0xb8, 0x4c, 0xed, 0x62, 0x7c, 0xdb, 0x56, 0x11, 0x97, 0x71, 0x06, 0x75, + 0xb5, 0x3a, 0x06, 0x20, 0x47, 0xfb, 0xcf, 0xf6, 0x0f, 0xbe, 0xdc, 0xef, 0xde, 0x48, 0xcb, 0xcf, + 0xa5, 0x2c, 0x44, 0xd1, 0xf2, 0x21, 0x4a, 0x19, 0xf1, 0x9b, 0x07, 0x47, 0xfb, 0xa3, 0x6e, 0x85, + 0xb5, 0x41, 0xa7, 0xe6, 0xd8, 0x1c, 0x3c, 0xef, 0x56, 0x29, 0xe1, 0xde, 0xfc, 0x6c, 0xb0, 0xb7, + 0xde, 0xad, 0xa5, 0xc5, 0xeb, 0xba, 0xf1, 0x07, 0x25, 0xb8, 0x25, 0x8f, 0x9c, 0x4f, 0x4f, 0xf3, + 0xbf, 0x05, 0x56, 0xe4, 0x6f, 0x81, 0xbf, 0xe6, 0x8c, 0xf4, 0x1f, 0x4a, 0xd0, 0x97, 0xc1, 0xcf, + 0xd3, 0x90, 0x07, 0x67, 0x5f, 0xec, 0x5e, 0x49, 0x7f, 0xae, 0xf3, 0xdd, 0x0f, 0xa0, 0x43, 0xff, + 0x46, 0xfe, 0xdc, 0x1d, 0xab, 0x10, 0x5d, 0x5e, 0x51, 0x5b, 0x61, 0xe5, 0x44, 0xec, 0x63, 0x68, + 0xc9, 0x7f, 0x28, 0xa9, 0x16, 0x57, 0x78, 0xcd, 0x28, 0x84, 0x5e, 0x4d, 0xd9, 0x8b, 0xde, 0x55, + 0xd8, 0x47, 0xe9, 0xa0, 0x2c, 0x53, 0xba, 0xfa, 0x60, 0xa1, 0x86, 0x8c, 0x28, 0x7f, 0x7a, 0x0c, + 0xf7, 0x16, 0x9e, 0x43, 0xc9, 0x6e, 0xae, 0x30, 0x25, 0x45, 0x66, 0xed, 0xef, 0x4b, 0x50, 0x41, + 0x7f, 0xc8, 0x1e, 0x81, 0xfe, 0x99, 0xe0, 0x61, 0x7c, 0x2c, 0x78, 0xcc, 0x0a, 0xbe, 0xaf, 0x4f, + 0x2b, 0x66, 0x8f, 0xa6, 0xc6, 0x8d, 0x27, 0x25, 0xb6, 0x2a, 0x7f, 0x6b, 0x4a, 0xfe, 0xd6, 0x6a, + 0x27, 0x7e, 0x95, 0xfc, 0x6e, 0xbf, 0x30, 0xde, 0xb8, 0xb1, 0x42, 0xfd, 0x3f, 0xf7, 0x1d, 0x6f, + 0x53, 0xfe, 0x85, 0xc3, 0xe6, 0xfd, 0xf0, 0xfc, 0x08, 0xf6, 0x08, 0x6a, 0x3b, 0x11, 0x3a, 0xfc, + 0xab, 0x5d, 0x89, 0x6b, 0xf9, 0x58, 0xc0, 0xb8, 0xb1, 0xf6, 0x57, 0x65, 0xa8, 0x7c, 0x25, 0x42, + 0x9f, 0x7d, 0x08, 0x75, 0xf5, 0xc4, 0xcc, 0x72, 0x4f, 0xc9, 0x7d, 0x4a, 0x69, 0xe6, 0xde, 0x9e, + 0x69, 0x95, 0xae, 0x64, 0x57, 0x56, 0x41, 0x65, 0xd9, 0x0b, 0xf8, 0x95, 0x4d, 0x7d, 0x02, 0xdd, + 0x61, 0x1c, 0x0a, 0x3e, 0xc9, 0x75, 0x2f, 0xb2, 0x6a, 0x51, 0x39, 0x96, 0xf8, 0xf5, 0x10, 0x6a, + 0x32, 0xaa, 0x9a, 0x1b, 0x30, 0x5f, 0x59, 0xa5, 0xce, 0xef, 0x41, 0x73, 0x78, 0xe6, 0x4f, 0x5d, + 0x7b, 0x28, 0xc2, 0x0b, 0xc1, 0x72, 0x3f, 0x8d, 0xf4, 0x73, 0x6d, 0xe3, 0x06, 0x5b, 0x01, 0x90, + 0x8e, 0xfc, 0x08, 0x75, 0xa4, 0x8e, 0xb4, 0xfd, 0xe9, 0x44, 0x4e, 0x9a, 0xf3, 0xf0, 0xb2, 0x67, + 0x2e, 0xb8, 0x7a, 0x55, 0xcf, 0x8f, 0xa1, 0xbd, 0x49, 0xfa, 0x72, 0x10, 0xae, 0x1f, 0xfb, 0x61, + 0xcc, 0xe6, 0x7f, 0x1c, 0xe9, 0xcf, 0x23, 0x8c, 0x1b, 0xec, 0x09, 0x34, 0x46, 0xe1, 0xa5, 0xec, + 0x7f, 0x4b, 0xc5, 0xa4, 0xd9, 0x7a, 0x0b, 0x4e, 0xb9, 0xf6, 0x5f, 0x15, 0xa8, 0x7d, 0xe9, 0x87, + 0xe7, 0x22, 0xc4, 0xf4, 0x96, 0x2a, 0xe1, 0x4a, 0x8c, 0xd2, 0xaa, 0xf8, 0xa2, 0x85, 0xde, 0x01, + 0x9d, 0x98, 0x32, 0xe2, 0xd1, 0xb9, 0xbc, 0x2a, 0xfa, 0x19, 0x57, 0xf2, 0x45, 0xa6, 0xcb, 0x74, + 0xaf, 0x1d, 0x79, 0x51, 0xe9, 0x63, 0x52, 0xa1, 0x2e, 0xdd, 0xa7, 0xf3, 0x3f, 0x7b, 0x3e, 0x44, + 0xd1, 0x7c, 0x52, 0x42, 0x43, 0x3c, 0x94, 0x27, 0xc5, 0x4e, 0xd9, 0x4f, 0x88, 0x52, 0xf2, 0xb3, + 0xbf, 0xfe, 0x8c, 0x1b, 0xec, 0x31, 0xd4, 0x94, 0x4a, 0xdf, 0xca, 0x94, 0x57, 0xd9, 0x89, 0x7e, + 0x37, 0x8f, 0x52, 0x03, 0xde, 0x87, 0x9a, 0xb4, 0x70, 0x72, 0x40, 0x21, 0x44, 0x91, 0xbb, 0x96, + 0x61, 0x8e, 0x71, 0x83, 0x3d, 0x84, 0xba, 0xaa, 0x66, 0xb3, 0x05, 0xa5, 0xed, 0xb9, 0xce, 0x1f, + 0x41, 0x4d, 0x3a, 0x26, 0x39, 0x6f, 0xc1, 0x7b, 0xf7, 0x59, 0x1e, 0x95, 0x28, 0x09, 0x4a, 0xbb, + 0x29, 0x2c, 0xe1, 0xe4, 0xd2, 0x28, 0x96, 0x70, 0x62, 0x81, 0xca, 0x7e, 0x02, 0xed, 0x42, 0xca, + 0xc5, 0x7a, 0x74, 0x3b, 0x0b, 0xb2, 0xb0, 0x2b, 0x8a, 0xf2, 0x63, 0xd0, 0x55, 0xc4, 0x7b, 0x2c, + 0x18, 0xd5, 0xa7, 0x17, 0xc4, 0xcc, 0xfd, 0xab, 0x21, 0x2f, 0x49, 0xff, 0x4f, 0xe0, 0xf6, 0x02, + 0x1b, 0xc6, 0xe8, 0x4f, 0x9d, 0xeb, 0x8d, 0x74, 0x7f, 0xe9, 0x5a, 0x7a, 0xc2, 0x80, 0x8d, 0xee, + 0x3f, 0x7e, 0x73, 0xbf, 0xf4, 0x2f, 0xdf, 0xdc, 0x2f, 0xfd, 0xdb, 0x37, 0xf7, 0x4b, 0xbf, 0xfc, + 0xf7, 0xfb, 0x37, 0x8e, 0x6b, 0xf4, 0x43, 0xfa, 0xc7, 0xff, 0x17, 0x00, 0x00, 0xff, 0xff, 0x70, + 0xcf, 0x75, 0xe4, 0x06, 0x2f, 0x00, 0x00, } // Reference imports to suppress errors if they are not otherwise used. @@ -8284,6 +8293,13 @@ func (m *RestoreRequest) MarshalToSizedBuffer(dAtA []byte) (int, error) { i -= len(m.XXX_unrecognized) copy(dAtA[i:], m.XXX_unrecognized) } + if m.BackupNum != 0 { + i = encodeVarintPb(dAtA, i, uint64(m.BackupNum)) + i-- + dAtA[i] = 0x1 + i-- + dAtA[i] = 0x80 + } if len(m.VaultFormat) > 0 { i -= len(m.VaultFormat) copy(dAtA[i:], m.VaultFormat) @@ -11478,6 +11494,9 @@ func (m *RestoreRequest) Size() (n int) { if l > 0 { n += 1 + l + sovPb(uint64(l)) } + if m.BackupNum != 0 { + n += 2 + sovPb(uint64(m.BackupNum)) + } if m.XXX_unrecognized != nil { n += len(m.XXX_unrecognized) } @@ -17938,6 +17957,25 @@ func (m *RestoreRequest) Unmarshal(dAtA []byte) error { } m.VaultFormat = string(dAtA[iNdEx:postIndex]) iNdEx = postIndex + case 16: + if wireType != 0 { + return fmt.Errorf("proto: wrong wireType = %d for field BackupNum", wireType) + } + m.BackupNum = 0 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowPb + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := dAtA[iNdEx] + iNdEx++ + m.BackupNum |= uint64(b&0x7F) << shift + if b < 0x80 { + break + } + } default: iNdEx = preIndex skippy, err := skipPb(dAtA[iNdEx:]) diff --git a/systest/online-restore/online_restore_test.go b/systest/online-restore/online_restore_test.go index 3459cab51f9..2dcfd2821cd 100644 --- a/systest/online-restore/online_restore_test.go +++ b/systest/online-restore/online_restore_test.go @@ -37,15 +37,15 @@ import ( "github.com/dgraph-io/dgraph/testutil" ) -func sendRestoreRequest(t *testing.T, backupId string) int { +func sendRestoreRequest(t *testing.T, backupId string, backupNum int) int { restoreRequest := fmt.Sprintf(`mutation restore() { - restore(input: {location: "/data/backup", backupId: "%s", + restore(input: {location: "/data/backup", backupId: "%s", backupNum: %d, encryptionKeyFile: "/data/keys/enc_key"}) { code message restoreId } - }`, backupId) + }`, backupId, backupNum) adminUrl := "http://localhost:8180/admin" params := testutil.GraphQLParams{ @@ -171,7 +171,10 @@ func runQueries(t *testing.T, dg *dgo.Dgraph, shouldFail bool) { resp, err := dg.NewTxn().Query(context.Background(), bodies[0]) if shouldFail { - require.Error(t, err) + if err != nil { + continue + } + require.False(t, testutil.EqualJSON(t, bodies[1], string(resp.GetJson()), "", true)) } else { require.NoError(t, err) require.True(t, testutil.EqualJSON(t, bodies[1], string(resp.GetJson()), "", true)) @@ -226,12 +229,88 @@ func TestBasicRestore(t *testing.T) { ctx := context.Background() require.NoError(t, dg.Alter(ctx, &api.Operation{DropAll: true})) - restoreId := sendRestoreRequest(t, "youthful_rhodes3") + restoreId := sendRestoreRequest(t, "youthful_rhodes3", 0) waitForRestore(t, restoreId, dg) runQueries(t, dg, false) runMutations(t, dg) } +func TestRestoreBackupNum(t *testing.T) { + disableDraining(t) + + conn, err := grpc.Dial(testutil.SockAddr, grpc.WithInsecure()) + require.NoError(t, err) + dg := dgo.NewDgraphClient(api.NewDgraphClient(conn)) + + ctx := context.Background() + require.NoError(t, dg.Alter(ctx, &api.Operation{DropAll: true})) + runQueries(t, dg, true) + + restoreId := sendRestoreRequest(t, "youthful_rhodes3", 1) + waitForRestore(t, restoreId, dg) + runQueries(t, dg, true) + runMutations(t, dg) +} + +func TestRestoreBackupNumInvalid(t *testing.T) { + disableDraining(t) + + conn, err := grpc.Dial(testutil.SockAddr, grpc.WithInsecure()) + require.NoError(t, err) + dg := dgo.NewDgraphClient(api.NewDgraphClient(conn)) + + ctx := context.Background() + require.NoError(t, dg.Alter(ctx, &api.Operation{DropAll: true})) + runQueries(t, dg, true) + + // Send a request with a backupNum greater than the number of manifests. + adminUrl := "http://localhost:8180/admin" + restoreRequest := fmt.Sprintf(`mutation restore() { + restore(input: {location: "/data/backup", backupId: "%s", backupNum: %d, + encryptionKeyFile: "/data/keys/enc_key"}) { + code + message + restoreId + } + }`, "youthful_rhodes3", 1000) + + params := testutil.GraphQLParams{ + Query: restoreRequest, + } + b, err := json.Marshal(params) + require.NoError(t, err) + + resp, err := http.Post(adminUrl, "application/json", bytes.NewBuffer(b)) + require.NoError(t, err) + buf, err := ioutil.ReadAll(resp.Body) + bufString := string(buf) + require.NoError(t, err) + require.Contains(t, bufString, "not enough backups") + + // Send a request with a negative backupNum value. + restoreRequest = fmt.Sprintf(`mutation restore() { + restore(input: {location: "/data/backup", backupId: "%s", backupNum: %d, + encryptionKeyFile: "/data/keys/enc_key"}) { + code + message + restoreId + } + }`, "youthful_rhodes3", -1) + + params = testutil.GraphQLParams{ + Query: restoreRequest, + } + b, err = json.Marshal(params) + require.NoError(t, err) + + resp, err = http.Post(adminUrl, "application/json", bytes.NewBuffer(b)) + require.NoError(t, err) + buf, err = ioutil.ReadAll(resp.Body) + bufString = string(buf) + require.NoError(t, err) + require.Contains(t, bufString, "backupNum value should be equal or greater than zero") +} + func TestMoveTablets(t *testing.T) { disableDraining(t) @@ -242,13 +321,13 @@ func TestMoveTablets(t *testing.T) { ctx := context.Background() require.NoError(t, dg.Alter(ctx, &api.Operation{DropAll: true})) - restoreId := sendRestoreRequest(t, "youthful_rhodes3") + restoreId := sendRestoreRequest(t, "youthful_rhodes3", 0) waitForRestore(t, restoreId, dg) runQueries(t, dg, false) // Send another restore request with a different backup. This backup has some of the // same predicates as the previous one but they are stored in different groups. - restoreId = sendRestoreRequest(t, "blissful_hermann1") + restoreId = sendRestoreRequest(t, "blissful_hermann1", 0) waitForRestore(t, restoreId, dg) resp, err := dg.NewTxn().Query(context.Background(), `{ @@ -304,7 +383,7 @@ func TestListBackups(t *testing.T) { encrypted groups { groupId - predicates + predicates } path since diff --git a/testutil/json.go b/testutil/json.go index d1635a450dc..6a83d10a765 100644 --- a/testutil/json.go +++ b/testutil/json.go @@ -76,8 +76,10 @@ func DiffJSONMaps(t *testing.T, wantMap, gotMap map[string]interface{}, if err != nil { t.Error("Could not marshal JSON:", err) } - t.Errorf("Expected JSON and actual JSON differ:\n%s", - sdiffJSON(wantBuf, gotBuf, savepath, quiet)) + if !quiet { + t.Errorf("Expected JSON and actual JSON differ:\n%s", + sdiffJSON(wantBuf, gotBuf, savepath, quiet)) + } return false } diff --git a/worker/backup_handler.go b/worker/backup_handler.go index 230dde75d0b..492192a58f2 100644 --- a/worker/backup_handler.go +++ b/worker/backup_handler.go @@ -16,6 +16,7 @@ import ( "fmt" "io" "net/url" + "sort" "github.com/dgraph-io/dgraph/protos/pb" @@ -59,9 +60,11 @@ type UriHandler interface { // These function calls are used by both Create and Load. io.WriteCloser - // GetManfiest returns the list of manfiests for the given backup series ID - // at the specified location. - GetManifests(*url.URL, string) ([]*Manifest, error) + // GetManifests returns the list of manfiests for the given backup series ID + // and backup number at the specified location. If backupNum is set to zero, + // all the manifests for the backup series will be returned. If it's greater + // than zero, manifests from one to backupNum will be returned. + GetManifests(*url.URL, string, uint64) ([]*Manifest, error) // GetLatestManifest reads the manifests at the given URL and returns the // latest manifest. @@ -78,12 +81,12 @@ type UriHandler interface { // created after will be ignored. // Objects implementing this function will be used for retrieving (dowload) backup files // and loading the data into a DB. The restore CLI command uses this call. - Load(*url.URL, string, loadFn) LoadResult + Load(*url.URL, string, uint64, loadFn) LoadResult // Verify checks that the specified backup can be restored to a cluster with the // given groups. The last manifest of that backup should have the same number of // groups as given list of groups. - Verify(*url.URL, string, []uint32) error + Verify(*url.URL, *pb.RestoreRequest, []uint32) error // ListManifests will scan the provided URI and return the paths to the manifests stored // in that location. @@ -148,7 +151,8 @@ type loadFn func(reader io.Reader, groupId uint32, preds predicateSet) (uint64, // LoadBackup will scan location l for backup files in the given backup series and load them // sequentially. Returns the maximum Since value on success, otherwise an error. -func LoadBackup(location, backupId string, creds *Credentials, fn loadFn) LoadResult { +func LoadBackup(location, backupId string, backupNum uint64, creds *Credentials, + fn loadFn) LoadResult { uri, err := url.Parse(location) if err != nil { return LoadResult{0, 0, err} @@ -159,13 +163,13 @@ func LoadBackup(location, backupId string, creds *Credentials, fn loadFn) LoadRe return LoadResult{0, 0, errors.Errorf("Unsupported URI: %v", uri)} } - return h.Load(uri, backupId, fn) + return h.Load(uri, backupId, backupNum, fn) } // VerifyBackup will access the backup location and verify that the specified backup can // be restored to the cluster. -func VerifyBackup(location, backupId string, creds *Credentials, currentGroups []uint32) error { - uri, err := url.Parse(location) +func VerifyBackup(req *pb.RestoreRequest, creds *Credentials, currentGroups []uint32) error { + uri, err := url.Parse(req.GetLocation()) if err != nil { return err } @@ -175,7 +179,7 @@ func VerifyBackup(location, backupId string, creds *Credentials, currentGroups [ return errors.Errorf("Unsupported URI: %v", uri) } - return h.Verify(uri, backupId, currentGroups) + return h.Verify(uri, req, currentGroups) } // ListBackupManifests scans location l for backup files and returns the list of manifests. @@ -272,18 +276,18 @@ func backupName(since uint64, groupId uint32) string { return fmt.Sprintf(backupNameFmt, since, groupId) } -// verifyGroupsInBackup checks that the groups in the last manifest match the groups in -// the current cluster. If they don't match, the backup cannot be restored to the cluster. -func verifyGroupsInBackup(manifests []*Manifest, currentGroups []uint32) error { - var maxBackupNum uint64 - var lastManifest *Manifest - for _, manifest := range manifests { - if manifest.BackupNum > maxBackupNum { - lastManifest = manifest - maxBackupNum = manifest.BackupNum - } +// verifyRequest verifies the manifests satisfy the requirements to process the given +// restore request. +func verifyRequest(req *pb.RestoreRequest, manifests []*Manifest, currentGroups []uint32) error { + if len(manifests) == 0 { + return errors.Errorf("No backups with the specified backup ID %s", req.GetBackupId()) } + if err := verifyManifests(manifests); err != nil { + return err + } + + lastManifest := manifests[len(manifests)-1] if len(currentGroups) != len(lastManifest.Groups) { return errors.Errorf("groups in cluster and latest backup manifest differ") } @@ -295,3 +299,27 @@ func verifyGroupsInBackup(manifests []*Manifest, currentGroups []uint32) error { } return nil } + +func getManifests(manifests []*Manifest, backupId string, + backupNum uint64) ([]*Manifest, error) { + + manifests, err := filterManifests(manifests, backupId) + if err != nil { + return nil, err + } + + // Sort manifests in the ascending order of their BackupNum so that the first + // manifest corresponds to the first full backup and so on. + sort.Slice(manifests, func(i, j int) bool { + return manifests[i].BackupNum < manifests[j].BackupNum + }) + + if backupNum > 0 { + if len(manifests) < int(backupNum) { + return nil, errors.Errorf("not enough backups to restore manifest with backupNum %d", + backupNum) + } + manifests = manifests[:backupNum] + } + return manifests, nil +} diff --git a/worker/file_handler.go b/worker/file_handler.go index fec2cb4650e..b394daf61fc 100644 --- a/worker/file_handler.go +++ b/worker/file_handler.go @@ -123,7 +123,8 @@ func (h *fileHandler) CreateManifest(uri *url.URL, req *pb.BackupRequest) error return h.createFiles(uri, req, backupManifest) } -func (h *fileHandler) GetManifests(uri *url.URL, backupId string) ([]*Manifest, error) { +func (h *fileHandler) GetManifests(uri *url.URL, backupId string, + backupNum uint64) ([]*Manifest, error) { if !pathExist(uri.Path) { return nil, errors.Errorf("The path %q does not exist or it is inaccessible.", uri.Path) } @@ -148,23 +149,14 @@ func (h *fileHandler) GetManifests(uri *url.URL, backupId string) ([]*Manifest, m.Path = path manifests = append(manifests, &m) } - manifests, err := filterManifests(manifests, backupId) - if err != nil { - return nil, err - } - // Sort manifests in the ascending order of their BackupNum so that the first - // manifest corresponds to the first full backup and so on. - sort.Slice(manifests, func(i, j int) bool { - return manifests[i].BackupNum < manifests[j].BackupNum - }) - return manifests, nil + return getManifests(manifests, backupId, backupNum) } // Load uses tries to load any backup files found. // Returns the maximum value of Since on success, error otherwise. -func (h *fileHandler) Load(uri *url.URL, backupId string, fn loadFn) LoadResult { - manifests, err := h.GetManifests(uri, backupId) +func (h *fileHandler) Load(uri *url.URL, backupId string, backupNum uint64, fn loadFn) LoadResult { + manifests, err := h.GetManifests(uri, backupId, backupNum) if err != nil { return LoadResult{0, 0, errors.Wrapf(err, "cannot retrieve manifests")} } @@ -208,17 +200,12 @@ func (h *fileHandler) Load(uri *url.URL, backupId string, fn loadFn) LoadResult // Verify performs basic checks to decide whether the specified backup can be restored // to a live cluster. -func (h *fileHandler) Verify(uri *url.URL, backupId string, currentGroups []uint32) error { - manifests, err := h.GetManifests(uri, backupId) +func (h *fileHandler) Verify(uri *url.URL, req *pb.RestoreRequest, currentGroups []uint32) error { + manifests, err := h.GetManifests(uri, req.GetBackupId(), req.GetBackupNum()) if err != nil { return errors.Wrapf(err, "while retrieving manifests") } - - if len(manifests) == 0 { - return errors.Errorf("No backups with the specified backup ID %s", backupId) - } - - return verifyGroupsInBackup(manifests, currentGroups) + return verifyRequest(req, manifests, currentGroups) } // ListManifests loads the manifests in the locations and returns them. diff --git a/worker/online_restore_ee.go b/worker/online_restore_ee.go index 7616431b5aa..b081dfd26e9 100644 --- a/worker/online_restore_ee.go +++ b/worker/online_restore_ee.go @@ -59,7 +59,7 @@ func ProcessRestoreRequest(ctx context.Context, req *pb.RestoreRequest) (int, er SessionToken: req.SessionToken, Anonymous: req.Anonymous, } - if err := VerifyBackup(req.Location, req.BackupId, &creds, currentGroups); err != nil { + if err := VerifyBackup(req, &creds, currentGroups); err != nil { return 0, errors.Wrapf(err, "failed to verify backup") } @@ -209,13 +209,14 @@ func handleRestoreProposal(ctx context.Context, req *pb.RestoreRequest) error { return errors.Wrapf(err, "cannot create backup handler") } - manifests, err := handler.GetManifests(uri, req.BackupId) + manifests, err := handler.GetManifests(uri, req.BackupId, req.BackupNum) if err != nil { return errors.Wrapf(err, "cannot get backup manifests") } if len(manifests) == 0 { return errors.Errorf("no backup manifests found at location %s", req.Location) } + lastManifest := manifests[len(manifests)-1] preds, ok := lastManifest.Groups[req.GroupId] if !ok { @@ -295,7 +296,8 @@ func getCredentialsFromRestoreRequest(req *pb.RestoreRequest) *Credentials { } func writeBackup(ctx context.Context, req *pb.RestoreRequest) error { - res := LoadBackup(req.Location, req.BackupId, getCredentialsFromRestoreRequest(req), + res := LoadBackup(req.Location, req.BackupId, req.BackupNum, + getCredentialsFromRestoreRequest(req), func(r io.Reader, groupId uint32, preds predicateSet) (uint64, error) { if groupId != req.GroupId { // LoadBackup will try to call the backup function for every group. diff --git a/worker/restore.go b/worker/restore.go index 6bbb7129c8a..78bf2c31722 100644 --- a/worker/restore.go +++ b/worker/restore.go @@ -43,7 +43,7 @@ func RunRestore(pdir, location, backupId string, key x.SensitiveByteSlice) LoadR // Scan location for backup files and load them. Each file represents a node group, // and we create a new p dir for each. - return LoadBackup(location, backupId, nil, + return LoadBackup(location, backupId, 0, nil, func(r io.Reader, groupId uint32, preds predicateSet) (uint64, error) { dir := filepath.Join(pdir, fmt.Sprintf("p%d", groupId)) diff --git a/worker/s3_handler.go b/worker/s3_handler.go index 76714022dd5..ce56990e976 100644 --- a/worker/s3_handler.go +++ b/worker/s3_handler.go @@ -166,7 +166,8 @@ func (h *s3Handler) readManifest(mc *minio.Client, object string, m *Manifest) e return json.NewDecoder(reader).Decode(m) } -func (h *s3Handler) GetManifests(uri *url.URL, backupId string) ([]*Manifest, error) { +func (h *s3Handler) GetManifests(uri *url.URL, backupId string, + backupNum uint64) ([]*Manifest, error) { mc, err := h.setup(uri) if err != nil { return nil, err @@ -198,24 +199,15 @@ func (h *s3Handler) GetManifests(uri *url.URL, backupId string) ([]*Manifest, er m.Path = path manifests = append(manifests, &m) } - manifests, err = filterManifests(manifests, backupId) - if err != nil { - return nil, err - } - // Sort manifests in the ascending order of their BackupNum so that the first - // manifest corresponds to the first full backup and so on. - sort.Slice(manifests, func(i, j int) bool { - return manifests[i].BackupNum < manifests[j].BackupNum - }) - return manifests, nil + return getManifests(manifests, backupId, backupNum) } // Load creates a new session, scans for backup objects in a bucket, then tries to // load any backup objects found. // Returns nil and the maximum Since value on success, error otherwise. -func (h *s3Handler) Load(uri *url.URL, backupId string, fn loadFn) LoadResult { - manifests, err := h.GetManifests(uri, backupId) +func (h *s3Handler) Load(uri *url.URL, backupId string, backupNum uint64, fn loadFn) LoadResult { + manifests, err := h.GetManifests(uri, backupId, backupNum) if err != nil { return LoadResult{0, 0, errors.Wrapf(err, "while retrieving manifests")} } @@ -275,17 +267,12 @@ func (h *s3Handler) Load(uri *url.URL, backupId string, fn loadFn) LoadResult { // Verify performs basic checks to decide whether the specified backup can be restored // to a live cluster. -func (h *s3Handler) Verify(uri *url.URL, backupId string, currentGroups []uint32) error { - manifests, err := h.GetManifests(uri, backupId) +func (h *s3Handler) Verify(uri *url.URL, req *pb.RestoreRequest, currentGroups []uint32) error { + manifests, err := h.GetManifests(uri, req.GetBackupId(), req.GetBackupNum()) if err != nil { return errors.Wrapf(err, "while retrieving manifests") } - - if len(manifests) == 0 { - return errors.Errorf("No backups with the specified backup ID %s", backupId) - } - - return verifyGroupsInBackup(manifests, currentGroups) + return verifyRequest(req, manifests, currentGroups) } // ListManifests loads the manifests in the locations and returns them.