Chế độ giao diện
3.4. Thiết Kế Theo Hợp Đồng và An Toàn Ngoại Lệ (Design by Contract & Exception Safety)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Design by Contract (DbC) biến các giả định ngầm thành các ràng buộc pháp lý tường minh giữa bên gọi (Caller) và bên thực thi (Callee), trong khi Exception Safety đảm bảo rằng ngay cả khi thảm họa xảy ra giữa chừng, hệ thống vẫn duy trì tính toàn vẹn bộ nhớ và không bao giờ để rò rỉ tài nguyên hay rơi vào trạng thái bất định (undefined state).
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
Ẩn dụ Đời sống: Hợp Đồng Ngoại Thương và Cơ Chế Ký Quỹ Escrow
Hãy hình dung mối quan hệ giữa hai module phần mềm như một thương vụ mua bán hàng hóa quốc tế có bảo lãnh ngân hàng:
- Precondition (Tiền điều kiện): Người mua phải chuyển đủ tiền vào tài khoản ký quỹ (Escrow) trước 17h00 ngày ký. Nếu người mua không chuyển tiền, người bán hoàn toàn không có nghĩa vụ xuất kho hàng hóa. Lỗi thuộc về bên mua.
- Postcondition (Hậu điều kiện): Sau khi nhận đủ tiền, người bán cam kết giao đúng
tấn thép tiêu chuẩn ASTM đến cảng đích. Nếu hàng giao thiếu hoặc sai chuẩn, bên bán vi phạm hợp đồng và phải chịu phạt. - Class Invariant (Bất biến lớp): Tổng số tiền trong két sắt của ngân hàng bảo lãnh cộng với nợ xấu không bao giờ được nhỏ hơn vốn điều lệ bắt buộc. Trạng thái này phải đúng trước giờ mở cửa và sau khi đóng cửa giao dịch mỗi ngày.
- Strong Exception Safety (Copy-and-Swap): Khi bốc xếp hàng lên tàu, nếu gặp bão lớn giữa chừng, toàn bộ hàng hóa được cẩu trả lại nguyên vẹn kho bãi cũ; tiền cọc trả về cho người mua như thể giao dịch chưa từng diễn ra (All-or-Nothing / Rollback semantics).
flowchart TD
subgraph Client["Bên Gọi (Caller / Client)"]
A["Chuẩn bị Input Data"] --> B{"Kiểm tra Preconditions<br/>(require)"}
end
subgraph Service["Bên Thực Thi (Callee / Class Method)"]
B -- "Thỏa mãn Precondition" --> C["Kiểm tra Class Invariants<br/>(Trước khi thực thi)"]
B -- "Vi phạm Precondition" --> ERR1["Bug phía Caller!<br/>Fail-Fast: Assert / Throw"]
C --> D["Clone State: Tạo bản sao Temp<br/>(Allocation & Preparation)"]
D --> E{"Biến đổi dữ liệu trên Temp<br/>(Có xảy ra Exception?)"}
E -- "Exception xảy ra!" --> ROLL["Discard Temp (Rollback)<br/>State gốc nguyên vẹn (Strong Safety)"]
E -- "Thành công trọn vẹn" --> F["noexcept swap(*this, Temp)<br/>Commit O(1) con trỏ bộ nhớ"]
F --> G{"Kiểm tra Postconditions<br/>(ensure) & Invariants"}
G -- "Thỏa mãn" --> H["Trả về kết quả cho Caller"]
G -- "Vi phạm" --> ERR2["Bug phía Callee!<br/>State Inconsistent Alert"]
end
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Trụ Cột của Design by Contract: Preconditions, Postconditions & Class Invariants
Phương pháp luận Design by Contract (DbC) do Bertrand Meyer sáng tạo trong ngôn ngữ Eiffel xác lập 3 trụ cột toán học:
Preconditions (Tiền điều kiện -
require):- Định nghĩa nghĩa vụ của Bên gọi (Caller) và quyền lợi của Bên thực thi (Callee).
- Thể hiện các điều kiện tiên quyết mà dữ liệu đầu vào và trạng thái hệ thống phải đáp ứng trước khi hàm được kích hoạt.
- Nguyên tắc thiết kế: Nếu Precondition bị vi phạm, Callee không có nghĩa vụ phải phục hồi hay xử lý khoan nhượng; hệ thống áp dụng cơ chế Fail-Fast (ném exception hoặc panic) vì đây là lỗi logic (bug) của lập trình viên phía Caller.
Postconditions (Hậu điều kiện -
ensure):- Định nghĩa quyền lợi của Caller và nghĩa vụ của Callee.
- Cam kết trạng thái của hệ thống và giá trị trả về sau khi phương thức hoàn thành bình thường.
- Callee phải chịu trách nhiệm hoàn toàn nếu Postcondition không được đáp ứng dù Precondition đã hợp lệ.
Class Invariants (Bất biến của Lớp):
- Các thuộc tính chân lý định lượng về tính toàn vẹn của đối tượng luôn luôn có giá trị
truetrong suốt vòng đời của nó. - Invariant có thể bị phá vỡ tạm thời bên trong thân phương thức trong quá trình biến đổi trạng thái, nhưng bắt buộc phải được khôi phục nguyên vẹn trước khi phương thức trả quyền điều khiển về cho thế giới bên ngoài.
- Được kiểm tra tự động tại 2 thời điểm cốt lõi:
- Ngay sau khi Constructor hoàn tất khởi tạo.
- Trước khi bắt đầu và sau khi kết thúc mọi phương thức
public.
- Các thuộc tính chân lý định lượng về tính toàn vẹn của đối tượng luôn luôn có giá trị
sequenceDiagram
autonumber
participant C as Caller (Client)
participant O as Object Instance
Note over O: Constructor completes -> Check Invariant
C->>O: Invoke publicMethod(args)
activate O
Note over O: 1. Check Preconditions (Caller Obligation)
Note over O: 2. Check Entry Invariant
Note over O: 3. Execute State Transformation (Invariant temporarily broken)
Note over O: 4. Check Exit Invariant
Note over O: 5. Check Postconditions (Callee Obligation)
O-->>C: Return Result
deactivate O
2.2. Subcontracting và Nguyên lý Thay thế Liskov (LSP Enforcement)
Khi áp dụng tính kế thừa trong lập trình hướng đối tượng, DbC cung cấp quy tắc toán học khắt khe để kiểm soát đa hình (Polymorphism), trực tiếp thực thi Nguyên lý Thay thế Liskov (Liskov Substitution Principle - LSP):
- Không bao giờ đòi hỏi nhiều hơn lớp cha: Lớp con không được quyền từ chối các đối số mà lớp cha chấp nhận. Nếu lớp cha nhận mọi số nguyên
, lớp con không thể đặt precondition . - Luôn luôn cam kết nhiều hơn hoặc bằng lớp cha: Nếu lớp cha hứa trả về danh sách được sắp xếp, lớp con không thể trả về danh sách xáo trộn.
2.3. Defensive Programming vs Design by Contract & Fail-Fast
Trong kỹ nghệ phần mềm hiện đại, có sự phân định ranh giới rõ rệt giữa hai trường phái:
| Đặc tính | Defensive Programming | Design by Contract (DbC) |
|---|---|---|
| Triết lý cốt lõi | Không tin tưởng bất kỳ module nào; giả định mọi thứ đều có thể sai. | Ranh giới trách nhiệm rõ ràng; coi vi phạm tiền điều kiện là bug logic. |
| Xử lý khi Input sai | Cố gắng che giấu: Trả về null, chuỗi rỗng "", hoặc giá trị mặc định. | Fail-Fast: Ném exception lập tức hoặc dừng chương trình để lộ bug. |
| Chi phí mã nguồn | Mã nguồn bị phình to (Bloated) bởi các tầng kiểm tra if (ptr == nullptr) trùng lặp. | Tinh gọn; chỉ kiểm tra tại ranh giới công khai (API Boundary) hoặc qua assertions. |
| Môi trường phù hợp | Ranh giới công cộng không tin cậy (Public REST APIs, Input từ người dùng). | Ranh giới nội bộ giữa các tầng kiến trúc (Internal Domain Services, Core Engine). |
2.4. The 4 Levels of Exception Safety (Bốn Cấp Độ An Toàn Ngoại Lệ)
Được chuẩn hóa bởi Bjarne Stroustrup và David Abrahams, an toàn ngoại lệ phân định 4 cấp độ cam kết bảo vệ trạng thái bộ nhớ:
graph TD
subgraph Levels["Các Cấp Độ An Toàn Ngoại Lệ (Exception Safety Spectrum)"]
L0["0. No Exception Safety<br/>(CẤM DÙNG: Rò rỉ tài nguyên, Memory Corruption)"]
L1["1. Basic Exception Safety<br/>(Bắt buộc tối thiểu: Không leak, đối tượng hợp lệ nhưng data biến đổi)"]
L2["2. Strong Exception Safety<br/>(Commit-or-Rollback: Thành công trọn vẹn hoặc giữ nguyên trạng thái cũ)"]
L3["3. No-throw / Nothrow Guarantee<br/>(Cam kết 100% không throw: noexcept, RAII cleanup, swap, move)"]
end
L0 -->|Áp dụng RAII & Smart Pointers| L1
L1 -->|Áp dụng Copy-and-Swap| L2
L2 -->|Áp dụng noexcept primitives| L3
- No Exception Safety (Không an toàn - Mức 0):
- Khi có exception xảy ra giữa chừng, tài nguyên (bộ nhớ heap, file handle, socket, database connection) bị rò rỉ vĩnh viễn. Con trỏ có thể bị trỏ vào vùng nhớ rác (Dangling Pointer), dẫn đến Crash hoặc lỗ hổng bảo mật.
- Basic Exception Safety (Cam kết Cơ bản - Mức 1 - Tối thiểu bắt buộc):
- Đảm bảo không có rò rỉ tài nguyên nhờ cơ chế RAII (Resource Acquisition Is Initialization).
- Mọi đối tượng vẫn duy trì trạng thái hợp lệ (Class Invariants được bảo tồn), nhưng dữ liệu có thể đã bị thay đổi một phần và không thể dự đoán chính xác giá trị cũ.
- Strong Exception Safety (Cam kết Mạnh - Mức 2 - Commit/Rollback):
- Hoạt động theo ngữ nghĩa giao dịch nguyên tử (Atomic Transaction): Nếu thao tác thành công, trạng thái mới được commit; nếu thao tác thất bại do exception, trạng thái hệ thống được phục hồi nguyên vẹn như trước khi hàm được gọi.
- No-throw / Nothrow Guarantee (Cam kết Không ném ngoại lệ - Mức 3 - Tuyệt đối):
- Phương thức cam kết thành công
và không bao giờ để bất kỳ ngoại lệ nào thoát ra ngoài. - Bắt buộc phải có cho: Destructors, Move Constructors, Move Assignment Operators, và các hàm hoán đổi
swap(). Trong C++, điều này được chỉ định bằng từ khóanoexcept.
- Phương thức cam kết thành công
2.5. Thành ngữ Copy-and-Swap và Cam kết Strong Exception Safety
Kỹ thuật chuẩn mực nhất để đạt được Strong Exception Safety mà không cần viết các khối try/catch cồng kềnh là Copy-and-Swap Idiom:
- Bước Copy (Có thể throw): Khởi tạo một đối tượng tạm thời
tempbằng cách sao chép trạng thái hiện tại của*this. Nếu việc cấp phát bộ nhớ bị lỗi (std::bad_alloc), exception lập tức bắn ra, đối tượng gốc*thishoàn toàn chưa bị chạm tới. - Bước Biến đổi (Có thể throw): Tiến hành toàn bộ các phép toán, cấp phát, thêm bớt trên đối tượng tạm
temp. Nếu có bất kỳ bước nào ném lỗi,temptự động bị hủy theo cơ chế RAII,*thisvẫn nguyên vẹn. - Bước Swap (Cam kết noexcept): Thực hiện hoán đổi con trỏ bộ nhớ giữa
*thisvàtempbằng hàm swap không bao giờ ném ngoại lệ. Quá trình swap diễn ra ở độ phức tạp . - Bước Hủy: Khi hàm kết thúc,
temp(hiện đang giữ tài nguyên cũ của*this) bị hủy bình thường.
2.6. No-throw Guarantee và Tầm quan trọng của noexcept
Tại sao Destructor và Move Constructor bắt buộc phải là noexcept?
- Destructor throwing: Nếu một ngoại lệ đang trong quá trình giải phóng ngăn xếp (Stack Unwinding) mà một Destructor của đối tượng trên stack lại ném tiếp một ngoại lệ thứ hai, runtime C++ không thể xử lý đồng thời 2 exception và buộc phải kích hoạt
std::terminate(), làm sập toàn bộ tiến trình ngay lập tức. - Move operations: Chuẩn C++ (
std::vector::push_backhoặcresize) sẽ kiểm trastd::is_nothrow_move_constructible<T>::value. Nếu move constructor không được đánh dấunoexcept, vector sẽ lùi về dùng copy constructor để đảm bảo Strong Exception Safety, làm suy giảm hiệu năng nghiêm trọng.
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. C++20 Implementation: Enterprise Resilient Ledger with Copy-and-Swap & DbC
Chương trình dưới đây minh họa hệ thống quản lý số dư tài khoản ngân hàng đáp ứng đầy đủ DbC, Class Invariants, và Strong Exception Safety thông qua Copy-and-Swap Idiom.
cpp
#include <iostream>
#include <vector>
#include <string>
#include <stdexcept>
#include <cassert>
#include <utility>
#include <memory>
#include <sstream>
// Custom Exception biểu thị lỗi hệ thống khi phân bổ
class LedgerStorageException : public std::runtime_error {
public:
explicit LedgerStorageException(const std::string& msg) : std::runtime_error(msg) {}
};
// Mô phỏng cấu trúc mục kế toán
struct LedgerEntry {
uint64_t transactionId;
int64_t amountCents;
std::string description;
};
// Class thực hiện DbC và Strong Exception Safety
class ResilientAccount {
private:
uint64_t accountId_{0};
int64_t balanceCents_{0};
std::vector<LedgerEntry> auditTrail_;
// CLASS INVARIANT: Số dư không bao giờ được âm, accountId > 0
void verifyInvariant() const noexcept {
assert(accountId_ > 0 && "Invariant Violated: Account ID must be positive!");
assert(balanceCents_ >= 0 && "Invariant Violated: Balance cannot be negative!");
}
public:
// Constructor có kiểm tra Precondition và Invariant
ResilientAccount(uint64_t id, int64_t initialBalanceCents)
: accountId_(id), balanceCents_(initialBalanceCents) {
// Precondition
if (id == 0) {
throw std::invalid_argument("Precondition Failed: ID must be non-zero");
}
if (initialBalanceCents < 0) {
throw std::invalid_argument("Precondition Failed: Initial balance cannot be negative");
}
verifyInvariant();
}
// Copy Constructor (Có thể throw std::bad_alloc)
ResilientAccount(const ResilientAccount& other)
: accountId_(other.accountId_),
balanceCents_(other.balanceCents_),
auditTrail_(other.auditTrail_) {
verifyInvariant();
}
// Move Constructor (Cam kết noexcept)
ResilientAccount(ResilientAccount&& other) noexcept
: accountId_(std::exchange(other.accountId_, 0)),
balanceCents_(std::exchange(other.balanceCents_, 0)),
auditTrail_(std::move(other.auditTrail_)) {
}
// Destructor (Cam kết noexcept tuyệt đối)
~ResilientAccount() noexcept = default;
// NO-THROW SWAP: Hoán đổi con trỏ bộ nhớ nội tại ở O(1)
void swap(ResilientAccount& other) noexcept {
using std::swap;
swap(accountId_, other.accountId_);
swap(balanceCents_, other.balanceCents_);
swap(auditTrail_, other.auditTrail_);
}
// Copy Assignment Operator sử dụng Copy-and-Swap (Strong Exception Safety)
ResilientAccount& operator=(ResilientAccount other) noexcept {
this->swap(other);
return *this;
}
// STRONG EXCEPTION SAFETY METHOD: Nạp tiền / Giao dịch nguyên tử
void applyTransaction(uint64_t txId, int64_t amountCents, const std::string& desc, bool simulateFailure = false) {
// 1. PRECONDITION ENFORCEMENT
if (txId == 0) {
throw std::invalid_argument("Precondition Failed: Transaction ID must be > 0");
}
if (amountCents == 0) {
throw std::invalid_argument("Precondition Failed: Transaction amount cannot be zero");
}
if (balanceCents_ + amountCents < 0) {
throw std::domain_error("Precondition Failed: Insufficient funds for withdrawal");
}
// 2. COPY STEP: Sao chép trạng thái hiện tại sang bản sao tạm thời
ResilientAccount tempSnapshot(*this);
// 3. TRANSFORM STEP TRÊN BẢN SAO TẠM
tempSnapshot.balanceCents_ += amountCents;
tempSnapshot.auditTrail_.push_back(LedgerEntry{txId, amountCents, desc});
// Giả lập lỗi I/O hoặc lỗi Disk Full xảy ra giữa chừng
if (simulateFailure) {
throw LedgerStorageException("Disk I/O failure while writing audit entry!");
}
// Kiểm tra Invariant trên bản sao tạm trước khi commit
tempSnapshot.verifyInvariant();
// 4. COMMIT STEP QUA NOEXCEPT SWAP: O(1)
this->swap(tempSnapshot);
// 5. POSTCONDITION VERIFICATION
verifyInvariant();
assert(balanceCents_ >= 0 && "Postcondition Violated: Balance is corrupt!");
}
[[nodiscard]] int64_t balanceCents() const noexcept { return balanceCents_; }
[[nodiscard]] size_t auditCount() const noexcept { return auditTrail_.size(); }
};
int main() {
std::cout << "=== C++20 Design by Contract & Strong Exception Safety Demo ===\n";
try {
ResilientAccount account(1001, 50'000); // $500.00
std::cout << "[Init] Account 1001 initialized with balance: " << account.balanceCents() << " cents\n";
// Giao dịch 1: Thành công
account.applyTransaction(1, 25'000, "Salary Deposit");
std::cout << "[Tx 1 Success] Balance after deposit: " << account.balanceCents()
<< " cents | Audits: " << account.auditCount() << "\n";
// Giao dịch 2: Rút tiền quá số dư (Vi phạm Precondition)
try {
std::cout << "\n[Tx 2 Test] Attempting withdrawal exceeding balance...\n";
account.applyTransaction(2, -100'000, "Luxury Watch Purchase");
} catch (const std::exception& ex) {
std::cout << " -> Caught Precondition Error: " << ex.what() << "\n";
std::cout << " -> Account State Untouched: " << account.balanceCents() << " cents\n";
}
// Giao dịch 3: Mô phỏng lỗi hệ thống phần cứng (Strong Exception Safety Rollback)
try {
std::cout << "\n[Tx 3 Test] Attempting deposit with Simulated Hardware Crash...\n";
account.applyTransaction(3, 10'000, "Bonus", /*simulateFailure=*/true);
} catch (const LedgerStorageException& ex) {
std::cout << " -> Caught Critical Hardware Error: " << ex.what() << "\n";
std::cout << " -> State preserved via Copy-and-Swap! Balance: "
<< account.balanceCents() << " cents | Audits: " << account.auditCount() << "\n";
}
} catch (const std::exception& ex) {
std::cerr << "Fatal unexpected error: " << ex.what() << "\n";
return 1;
}
return 0;
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
Terminal Output Mẫu (C++20):
text
=== C++20 Design by Contract & Strong Exception Safety Demo ===
[Init] Account 1001 initialized with balance: 50000 cents
[Tx 1 Success] Balance after deposit: 75000 cents | Audits: 1
[Tx 2 Test] Attempting withdrawal exceeding balance...
-> Caught Precondition Error: Precondition Failed: Insufficient funds for withdrawal
-> Account State Untouched: 75000 cents
[Tx 3 Test] Attempting deposit with Simulated Hardware Crash...
-> Caught Critical Hardware Error: Disk I/O failure while writing audit entry!
-> State preserved via Copy-and-Swap! Balance: 75000 cents | Audits: 11
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
3.2. Python 3.11+ Implementation: Contract Decorators & Transactional State Manager
Chương trình dưới đây sử dụng Higher-Order Decorators để bắt buộc thực thi Preconditions, Postconditions và Class Invariants trong Python 3.11+, kết hợp Context Manager mô phỏng ngữ nghĩa Strong Exception Safety.
python
from __future__ import annotations
import copy
import functools
from typing import Callable, Any, TypeVar
F = TypeVar("F", bound=Callable[..., Any])
class ContractViolationError(RuntimeError):
"""Ném ra khi có vi phạm hợp đồng (DbC)."""
pass
class PreconditionError(ContractViolationError):
"""Lỗi vi phạm trách nhiệm bên gọi (Caller)."""
pass
class PostconditionError(ContractViolationError):
"""Lỗi vi phạm cam kết bên thực thi (Callee)."""
pass
class InvariantError(ContractViolationError):
"""Lỗi làm hỏng bất biến của thực thể."""
pass
def require(predicate: Callable[..., bool], error_msg: str) -> Callable[[F], F]:
"""Decorator kiểm tra Tiền điều kiện (Precondition)."""
def decorator(func: F) -> F:
@functools.wraps(func)
def wrapper(*args, **kwargs):
if not predicate(*args, **kwargs):
raise PreconditionError(f"Precondition Failed in '{func.__name__}': {error_msg}")
return func(*args, **kwargs)
return wrapper # type: ignore
return decorator
def ensure(predicate: Callable[..., bool], error_msg: str) -> Callable[[F], F]:
"""Decorator kiểm tra Hậu điều kiện (Postcondition)."""
def decorator(func: F) -> F:
@functools.wraps(func)
def wrapper(*args, **kwargs):
result = func(*args, **kwargs)
if not predicate(result, *args, **kwargs):
raise PostconditionError(f"Postcondition Failed in '{func.__name__}': {error_msg}")
return result
return wrapper # type: ignore
return decorator
class TransactionalContext:
"""
Context Manager hỗ trợ Strong Exception Safety (Rollback Semantics).
Nếu có exception xảy ra trong block 'with', trạng thái đối tượng tự động rollback.
"""
def __init__(self, target_instance: Any):
self._target = target_instance
self._backup_state = None
def __enter__(self):
# Deepcopy trạng thái ban đầu trước khi biến đổi
self._backup_state = copy.deepcopy(self._target.__dict__)
return self._target
def __exit__(self, exc_type, exc_val, exc_tb):
if exc_type is not None:
# Xảy ra lỗi -> Rollback nguyên trạng
self._target.__dict__.clear()
self._target.__dict__.update(self._backup_state)
print(f" [TransactionalContext] Rollback triggered! Reverted state for {self._target}")
# Trả về False để exception tiếp tục lan truyền
return False
return True
class SecureWallet:
def __init__(self, owner: str, initial_balance: float):
if initial_balance < 0.0:
raise PreconditionError("Initial balance cannot be negative")
self.owner = owner
self.balance = initial_balance
self.transaction_history: list[str] = []
self._verify_invariant()
def _verify_invariant(self) -> None:
"""Class Invariant: Số dư ví không bao giờ được nhỏ hơn 0."""
if self.balance < 0.0:
raise InvariantError(f"Invariant Violated: Balance {self.balance} is negative!")
@require(lambda self, amount: amount > 0, "Deposit amount must be strictly positive")
@ensure(lambda result, self, amount: result == self.balance, "Return value must match current balance")
def deposit(self, amount: float) -> float:
self.balance += amount
self.transaction_history.append(f"Deposit: +${amount:.2f}")
self._verify_invariant()
return self.balance
@require(lambda self, amount: amount > 0, "Withdrawal amount must be positive")
def withdraw_atomic(self, amount: float, simulate_network_drop: bool = False) -> float:
# Sử dụng ngữ nghĩa Strong Exception Safety
with TransactionalContext(self):
if amount > self.balance:
raise PreconditionError(f"Insufficient balance ({self.balance}) for withdrawal of {amount}")
self.balance -= amount
self.transaction_history.append(f"Withdraw: -${amount:.2f}")
if simulate_network_drop:
raise ConnectionResetError("Connection lost while notifying Payment Gateway!")
self._verify_invariant()
return self.balance
def __repr__(self) -> str:
return f"SecureWallet(owner='{self.owner}', balance=${self.balance:.2f}, txs={len(self.transaction_history)})"
if __name__ == "__main__":
print("=== Python 3.11+ Design by Contract & Transactional Safety Demo ===")
wallet = SecureWallet("Alice", 1000.0)
print(f"[Init] {wallet}")
# Case 1: Thao tác bình thường
wallet.deposit(500.0)
print(f"[Deposit Success] {wallet}")
# Case 2: Vi phạm Precondition
try:
print("\n[Test Precondition] Attempting negative deposit...")
wallet.deposit(-200.0)
except PreconditionError as pe:
print(f" -> Caught Expected Precondition Error: {pe}")
# Case 3: Thất bại giữa chừng với Atomic Rollback (Strong Safety)
try:
print("\n[Test Atomic Rollback] Attempting $300 withdrawal with network error...")
wallet.withdraw_atomic(300.0, simulate_network_drop=True)
except ConnectionResetError as ce:
print(f" -> Caught Network Error: {ce}")
print(f" -> Final Wallet State Untouched: {wallet}")1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
Terminal Output Mẫu (Python 3.11+):
text
=== Python 3.11+ Design by Contract & Transactional Safety Demo ===
[Init] SecureWallet(owner='Alice', balance=$1000.00, txs=0)
[Deposit Success] SecureWallet(owner='Alice', balance=$1500.00, txs=1)
[Test Precondition] Attempting negative deposit...
-> Caught Expected Precondition Error: Precondition Failed in 'deposit': Deposit amount must be strictly positive
[Test Atomic Rollback] Attempting $300 withdrawal with network error...
[TransactionalContext] Rollback triggered! Reverted state for SecureWallet(owner='Alice', balance=$1200.00, txs=2)
-> Caught Network Error: Connection lost while notifying Payment Gateway!
-> Final Wallet State Untouched: SecureWallet(owner='Alice', balance=$1500.00, txs=1)1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
4. Systems Engineering & Production Pitfalls
Các Cạm Bẫy Thực Chiến (Gotchas & Production Antipatterns)
Exception Thrown inside Destructor causing
std::terminate:- Bản chất: Trong C++, nếu một exception nảy sinh trong hàm hủy (destructor) trong khi đang diễn ra quá trình unwinding stack của một exception khác, runtime sẽ gọi ngay lập tức
std::terminate(). Toàn bộ ứng dụng chết ngay lập tức mà không ghi được log. - Khắc phục: Mọi destructor mặc định là
noexcept(true). Nếu destructor cần đóng tài nguyên có nguy cơ lỗi (nhưfclosehoặcsocket.close()), phải tự bắt và nuốt exception hoặc ghi log tại chỗ bên trong destructor.
- Bản chất: Trong C++, nếu một exception nảy sinh trong hàm hủy (destructor) trong khi đang diễn ra quá trình unwinding stack của một exception khác, runtime sẽ gọi ngay lập tức
Sự đánh đổi về chi phí bộ nhớ của Copy-and-Swap:
- Bản chất: Để đạt được Strong Exception Safety, kỹ thuật Copy-and-Swap bắt buộc phải cấp phát một bản sao độc lập của đối tượng. Nếu đối tượng đang nắm giữ
bộ nhớ đệm trong RAM, việc tạo bản sao sẽ tiêu tốn thêm RAM tạm thời và gây áp lực lên Garbage Collector hoặc CPU Memory Bus. - Khắc phục: Với các cấu trúc dữ liệu khổng lồ, sử dụng Persistent Data Structures (như Finger Trees, HAMT) hoặc kỹ thuật Write-Ahead Logging (WAL) và Undo Log tương tự cơ sở dữ liệu thay vì sao chép toàn bộ thực thể.
- Bản chất: Để đạt được Strong Exception Safety, kỹ thuật Copy-and-Swap bắt buộc phải cấp phát một bản sao độc lập của đối tượng. Nếu đối tượng đang nắm giữ
Lạm dụng Assertions thay cho Input Validation ở Public Boundaries:
- Bản chất: Lập trình viên nhầm lẫn giữa kiểm tra Precondition trong DbC và kiểm tra dữ liệu đầu vào từ người dùng (Input Validation). Lệnh
assert()thường bị loại bỏ khi compile ở cờ-O3hoặcNDEBUG. Nếu dùngassertđể kiểm tra request payload từ REST API, khi lên môi trường Production, hệ thống sẽ bỏ qua toàn bộ việc kiểm tra, dẫn đến SQL Injection hoặc Remote Code Execution. - Khắc phục: Phân chia rõ ràng: Dùng Input Validation (throw
InvalidArgumentExceptionhoặc trả vềHTTP 400) tại API Gateway/Controller; chỉ dùngassertcho các bất biến nội bộ và hàm private của Domain Logic.
- Bản chất: Lập trình viên nhầm lẫn giữa kiểm tra Precondition trong DbC và kiểm tra dữ liệu đầu vào từ người dùng (Input Validation). Lệnh
Kỹ thuật Chẩn đoán & Debugging bằng CLI:
bash# 1. Phát hiện Memory Leak và rò rỉ tài nguyên khi có Exception ném ra bằng Valgrind valgrind --leak-check=full --show-leak-kinds=all --track-origins=yes ./resilient_service # 2. Truy vết điểm kích hoạt std::terminate khi ném exception trong destructor bằng GDB gdb ./resilient_service (gdb) catch throw (gdb) catch terminate (gdb) run (gdb) bt full # 3. Kiểm tra các hàm vi phạm cam kết noexcept bằng Clang-Tidy clang-tidy src/resilient_account.cpp -checks="bugprone-exception-escape,modernize-use-noexcept" -- -std=c++201
2
3
4
5
6
7
8
9
10
11
12
5. Bảng So sánh & Decision Matrix
5.1. Ma trận Các Cấp độ An toàn Ngoại lệ (Exception Safety Spectrum)
| Tiêu chí | No Safety | Basic Guarantee | Strong Guarantee | No-throw (Nothrow) |
|---|---|---|---|---|
| Rò rỉ Tài nguyên (Leaks) | Có thể xảy ra | Tuyệt đối không | Tuyệt đối không | Tuyệt đối không |
| Tính hợp lệ của Đối tượng | Bị hư hỏng (Corrupted) | Luôn hợp lệ (Valid state) | Luôn hợp lệ (Valid state) | Luôn hợp lệ (Valid state) |
| Dữ liệu khi gặp lỗi | Không xác định | Có thể bị thay đổi dở dang | Giữ nguyên trạng 100% | Không bao giờ xảy ra lỗi |
| Chi phí Thực thi (Overhead) | Thấp nhất | Thấp (chỉ cần RAII) | Trung bình / Cao (Copy state) | Thấp nhất (Không có code unwinding) |
| Cơ chế Kỹ thuật | Con trỏ thô, manual delete | Smart Pointers (std::unique_ptr), RAII | Copy-and-Swap, Transactions | noexcept, std::move, swap |
| Trường hợp Áp dụng | Mã legacy cũ (Cấm dùng) | Mọi hàm mặc định trong hệ thống | Giao dịch tài chính, chuyển khoản, DB | Destructors, Swaps, Move Ctors |
5.2. So sánh Triết lý: DbC vs Defensive vs Tolerant Reader
| Đặc trưng | Design by Contract (DbC) | Defensive Programming | Tolerant Reader Pattern |
|---|---|---|---|
| Khẩu hiệu | "Tin tưởng theo hợp đồng, sai là phạt" | "Không tin bất kỳ ai, tự bảo vệ mình" | "Nhận vào dễ dãi, xuất ra khắt khe" |
| Mục tiêu chính | Phát hiện bug nhanh nhất (Fail-Fast) | Giữ tiến trình không bị crash | Tương thích ngược phiên bản dữ liệu |
| Vị trí lý tưởng | Lõi nghiệp vụ (Domain Layer), Shared Libraries | Public API Gateway, Network Deserializer | Message Queue Consumers, Microservice Events |
| Nhược điểm | Đòi hỏi tư duy thiết kế khắt khe ban đầu | Che giấu bug tiềm ẩn, sinh ra zombie state | Có thể bỏ sót các trường dữ liệu sai lệch |
IyAzLjQuIFRoaeG6v3QgS+G6vyBUaGVvIEjhu6NwIMSQ4buTbmcgdsOgIEFuIFRvw6BuIE5nb+G6oWkgTOG7hyAoRGVzaWduIGJ5IENvbnRyYWN0ICYgRXhjZXB0aW9uIFNhZmV0eSkNCg0KPiBbIUlNUE9SVEFOVF0NCj4gKipO4bq/dSBi4bqhbiBjaOG7iSDEkcaw4bujYyBuaOG7myBt4buZdCDEkWnhu4F1IGR1eSBuaOG6pXQ6KiogRGVzaWduIGJ5IENvbnRyYWN0IChEYkMpIGJp4bq/biBjw6FjIGdp4bqjIMSR4buLbmggbmfhuqdtIHRow6BuaCBjw6FjIHLDoG5nIGJ14buZYyBwaMOhcCBsw70gdMaw4budbmcgbWluaCBnaeG7r2EgYsOqbiBn4buNaSAoQ2FsbGVyKSB2w6AgYsOqbiB0aOG7sWMgdGhpIChDYWxsZWUpLCB0cm9uZyBraGkgRXhjZXB0aW9uIFNhZmV0eSDEkeG6o20gYuG6o28gcuG6sW5nIG5nYXkgY+G6oyBraGkgdGjhuqNtIGjhu41hIHjhuqN5IHJhIGdp4buvYSBjaOG7q25nLCBo4buHIHRo4buRbmcgduG6q24gZHV5IHRyw6wgdMOtbmggdG/DoG4gduG6uW4gYuG7mSBuaOG7myB2w6Aga2jDtG5nIGJhbyBnaeG7nSDEkeG7gyByw7IgcuG7iSB0w6BpIG5ndXnDqm4gaGF5IHLGoWkgdsOgbyB0cuG6oW5nIHRow6FpIGLhuqV0IMSR4buLbmggKHVuZGVmaW5lZCBzdGF0ZSkuDQoNCi0tLQ0KDQojIyAxLiBLaeG6v24gdHLDumMgVOG7lW5nIHF1YW4gJiBNw7QgaMOsbmggVMawIGR1eSAoTWVudGFsIE1vZGVsKQ0KDQojIyMg4bqobiBk4bulIMSQ4budaSBz4buRbmc6IEjhu6NwIMSQ4buTbmcgTmdv4bqhaSBUaMawxqFuZyB2w6AgQ8ahIENo4bq/IEvDvSBRdeG7uSBFc2Nyb3cNCkjDo3kgaMOsbmggZHVuZyBt4buRaSBxdWFuIGjhu4cgZ2nhu69hIGhhaSBtb2R1bGUgcGjhuqduIG3hu4FtIG5oxrAgbeG7mXQgdGjGsMahbmcgduG7pSBtdWEgYsOhbiBow6BuZyBow7NhIHF14buRYyB04bq/IGPDsyBi4bqjbyBsw6NuaCBuZ8OibiBow6BuZzoNCi0gKipQcmVjb25kaXRpb24gKFRp4buBbiDEkWnhu4F1IGtp4buHbikqKjogTmfGsOG7nWkgbXVhIHBo4bqjaSBjaHV54buDbiDEkeG7pyB0aeG7gW4gdsOgbyB0w6BpIGtob+G6o24ga8O9IHF14bu5IChFc2Nyb3cpIHRyxrDhu5tjIDE3aDAwIG5nw6B5IGvDvS4gTuG6v3UgbmfGsOG7nWkgbXVhIGtow7RuZyBjaHV54buDbiB0aeG7gW4sIG5nxrDhu51pIGLDoW4gaG/DoG4gdG/DoG4ga2jDtG5nIGPDsyBuZ2jEqWEgduG7pSB4deG6pXQga2hvIGjDoG5nIGjDs2EuIEzhu5dpIHRodeG7mWMgduG7gSBiw6puIG11YS4NCi0gKipQb3N0Y29uZGl0aW9uIChI4bqtdSDEkWnhu4F1IGtp4buHbikqKjogU2F1IGtoaSBuaOG6rW4gxJHhu6cgdGnhu4FuLCBuZ8aw4budaSBiw6FuIGNhbSBr4bq/dCBnaWFvIMSRw7puZyAkMTAuMDAwJCB04bqlbiB0aMOpcCB0acOqdSBjaHXhuqluIEFTVE0gxJHhur9uIGPhuqNuZyDEkcOtY2guIE7hur91IGjDoG5nIGdpYW8gdGhp4bq/dSBob+G6t2Mgc2FpIGNodeG6qW4sIGLDqm4gYsOhbiB2aSBwaOG6oW0gaOG7o3AgxJHhu5NuZyB2w6AgcGjhuqNpIGNo4buLdSBwaOG6oXQuDQotICoqQ2xhc3MgSW52YXJpYW50IChC4bqldCBiaeG6v24gbOG7m3ApKio6IFThu5VuZyBz4buRIHRp4buBbiB0cm9uZyBrw6l0IHPhuq90IGPhu6dhIG5nw6JuIGjDoG5nIGLhuqNvIGzDo25oIGPhu5luZyB24bubaSBu4bujIHjhuqV1IGtow7RuZyBiYW8gZ2nhu50gxJHGsOG7o2Mgbmjhu48gaMahbiB24buRbiDEkWnhu4F1IGzhu4cgYuG6r3QgYnXhu5ljLiBUcuG6oW5nIHRow6FpIG7DoHkgcGjhuqNpIMSRw7puZyB0csaw4bubYyBnaeG7nSBt4bufIGPhu61hIHbDoCBzYXUga2hpIMSRw7NuZyBj4butYSBnaWFvIGThu4tjaCBt4buXaSBuZ8OgeS4NCi0gKipTdHJvbmcgRXhjZXB0aW9uIFNhZmV0eSAoQ29weS1hbmQtU3dhcCkqKjogS2hpIGLhu5FjIHjhur9wIGjDoG5nIGzDqm4gdMOgdSwgbuG6v3UgZ+G6t3AgYsOjbyBs4bubbiBnaeG7r2EgY2jhu6tuZywgdG/DoG4gYuG7mSBow6BuZyBow7NhIMSRxrDhu6NjIGPhuql1IHRy4bqjIGzhuqFpIG5ndXnDqm4gduG6uW4ga2hvIGLDo2kgY8WpOyB0aeG7gW4gY+G7jWMgdHLhuqMgduG7gSBjaG8gbmfGsOG7nWkgbXVhIG5oxrAgdGjhu4MgZ2lhbyBk4buLY2ggY2jGsGEgdOG7q25nIGRp4buFbiByYSAoQWxsLW9yLU5vdGhpbmcgLyBSb2xsYmFjayBzZW1hbnRpY3MpLg0KDQpgYGBtZXJtYWlkDQpmbG93Y2hhcnQgVEQNCiAgICBzdWJncmFwaCBDbGllbnRbIkLDqm4gR+G7jWkgKENhbGxlciAvIENsaWVudCkiXQ0KICAgICAgICBBWyJDaHXhuqluIGLhu4sgSW5wdXQgRGF0YSJdIC0tPiBCeyJLaeG7g20gdHJhIFByZWNvbmRpdGlvbnM8YnIvPihyZXF1aXJlKSJ9DQogICAgZW5kDQoNCiAgICBzdWJncmFwaCBTZXJ2aWNlWyJCw6puIFRo4buxYyBUaGkgKENhbGxlZSAvIENsYXNzIE1ldGhvZCkiXQ0KICAgICAgICBCIC0tICJUaOG7j2EgbcOjbiBQcmVjb25kaXRpb24iIC0tPiBDWyJLaeG7g20gdHJhIENsYXNzIEludmFyaWFudHM8YnIvPihUcsaw4bubYyBraGkgdGjhu7FjIHRoaSkiXQ0KICAgICAgICBCIC0tICJWaSBwaOG6oW0gUHJlY29uZGl0aW9uIiAtLT4gRVJSMVsiQnVnIHBow61hIENhbGxlciE8YnIvPkZhaWwtRmFzdDogQXNzZXJ0IC8gVGhyb3ciXQ0KICAgICAgICANCiAgICAgICAgQyAtLT4gRFsiQ2xvbmUgU3RhdGU6IFThuqFvIGLhuqNuIHNhbyBUZW1wPGJyLz4oQWxsb2NhdGlvbiAmIFByZXBhcmF0aW9uKSJdDQogICAgICAgIEQgLS0+IEV7IkJp4bq/biDEkeG7lWkgZOG7ryBsaeG7h3UgdHLDqm4gVGVtcDxici8+KEPDsyB44bqjeSByYSBFeGNlcHRpb24/KSJ9DQogICAgICAgIA0KICAgICAgICBFIC0tICJFeGNlcHRpb24geOG6o3kgcmEhIiAtLT4gUk9MTFsiRGlzY2FyZCBUZW1wIChSb2xsYmFjayk8YnIvPlN0YXRlIGfhu5FjIG5ndXnDqm4gduG6uW4gKFN0cm9uZyBTYWZldHkpIl0NCiAgICAgICAgRSAtLSAiVGjDoG5oIGPDtG5nIHRy4buNbiB24bq5biIgLS0+IEZbIm5vZXhjZXB0IHN3YXAoKnRoaXMsIFRlbXApPGJyLz5Db21taXQgTygxKSBjb24gdHLhu48gYuG7mSBuaOG7myJdDQogICAgICAgIA0KICAgICAgICBGIC0tPiBHeyJLaeG7g20gdHJhIFBvc3Rjb25kaXRpb25zPGJyLz4oZW5zdXJlKSAmIEludmFyaWFudHMifQ0KICAgICAgICBHIC0tICJUaOG7j2EgbcOjbiIgLS0+IEhbIlRy4bqjIHbhu4Ega+G6v3QgcXXhuqMgY2hvIENhbGxlciJdDQogICAgICAgIEcgLS0gIlZpIHBo4bqhbSIgLS0+IEVSUjJbIkJ1ZyBwaMOtYSBDYWxsZWUhPGJyLz5TdGF0ZSBJbmNvbnNpc3RlbnQgQWxlcnQiXQ0KICAgIGVuZA0KYGBgDQoNCi0tLQ0KDQojIyAyLiBDaGkgdGnhur90IHThu6tuZyBLZXl3b3JkIChVbmRlci10aGUtSG9vZCBEZWVwIERpdmUpDQoNCiMjIyAyLjEuIFRy4bulIEPhu5l0IGPhu6dhIERlc2lnbiBieSBDb250cmFjdDogUHJlY29uZGl0aW9ucywgUG9zdGNvbmRpdGlvbnMgJiBDbGFzcyBJbnZhcmlhbnRzDQpQaMawxqFuZyBwaMOhcCBsdeG6rW4gRGVzaWduIGJ5IENvbnRyYWN0IChEYkMpIGRvIEJlcnRyYW5kIE1leWVyIHPDoW5nIHThuqFvIHRyb25nIG5nw7RuIG5n4buvIEVpZmZlbCB4w6FjIGzhuq1wIDMgdHLhu6UgY+G7mXQgdG/DoW4gaOG7jWM6DQoNCjEuICoqUHJlY29uZGl0aW9ucyAoVGnhu4FuIMSRaeG7gXUga2nhu4duIC0gYHJlcXVpcmVgKSoqOg0KICAgLSDEkOG7i25oIG5naMSpYSBuZ2jEqWEgduG7pSBj4bunYSAqKkLDqm4gZ+G7jWkgKENhbGxlcikqKiB2w6AgcXV54buBbiBs4bujaSBj4bunYSAqKkLDqm4gdGjhu7FjIHRoaSAoQ2FsbGVlKSoqLg0KICAgLSBUaOG7gyBoaeG7h24gY8OhYyDEkWnhu4F1IGtp4buHbiB0acOqbiBxdXnhur90IG3DoCBk4buvIGxp4buHdSDEkeG6p3UgdsOgbyB2w6AgdHLhuqFuZyB0aMOhaSBo4buHIHRo4buRbmcgcGjhuqNpIMSRw6FwIOG7qW5nIHRyxrDhu5tjIGtoaSBow6BtIMSRxrDhu6NjIGvDrWNoIGhv4bqhdC4NCiAgIC0gKk5ndXnDqm4gdOG6r2MgdGhp4bq/dCBr4bq/KjogTuG6v3UgUHJlY29uZGl0aW9uIGLhu4sgdmkgcGjhuqFtLCBDYWxsZWUgKipraMO0bmcgY8OzIG5naMSpYSB24bulKiogcGjhuqNpIHBo4bulYyBo4buTaSBoYXkgeOG7rSBsw70ga2hvYW4gbmjGsOG7o25nOyBo4buHIHRo4buRbmcgw6FwIGThu6VuZyBjxqEgY2jhur8gRmFpbC1GYXN0IChuw6ltIGV4Y2VwdGlvbiBob+G6t2MgcGFuaWMpIHbDrCDEkcOieSBsw6AgbOG7l2kgbG9naWMgKGJ1ZykgY+G7p2EgbOG6rXAgdHLDrG5oIHZpw6puIHBow61hIENhbGxlci4NCg0KMi4gKipQb3N0Y29uZGl0aW9ucyAoSOG6rXUgxJFp4buBdSBraeG7h24gLSBgZW5zdXJlYCkqKjoNCiAgIC0gxJDhu4tuaCBuZ2jEqWEgcXV54buBbiBs4bujaSBj4bunYSBDYWxsZXIgdsOgIG5naMSpYSB24bulIGPhu6dhIENhbGxlZS4NCiAgIC0gQ2FtIGvhur90IHRy4bqhbmcgdGjDoWkgY+G7p2EgaOG7hyB0aOG7kW5nIHbDoCBnacOhIHRy4buLIHRy4bqjIHbhu4Egc2F1IGtoaSBwaMawxqFuZyB0aOG7qWMgaG/DoG4gdGjDoG5oIGLDrG5oIHRoxrDhu51uZy4NCiAgIC0gQ2FsbGVlIHBo4bqjaSBjaOG7i3UgdHLDoWNoIG5oaeG7h20gaG/DoG4gdG/DoG4gbuG6v3UgUG9zdGNvbmRpdGlvbiBraMO0bmcgxJHGsOG7o2MgxJHDoXAg4bupbmcgZMO5IFByZWNvbmRpdGlvbiDEkcOjIGjhu6NwIGzhu4cuDQoNCjMuICoqQ2xhc3MgSW52YXJpYW50cyAoQuG6pXQgYmnhur9uIGPhu6dhIEzhu5twKSoqOg0KICAgLSBDw6FjIHRodeG7mWMgdMOtbmggY2jDom4gbMO9IMSR4buLbmggbMaw4bujbmcgduG7gSB0w61uaCB0b8OgbiB24bq5biBj4bunYSDEkeG7kWkgdMaw4bujbmcgbHXDtG4gbHXDtG4gY8OzIGdpw6EgdHLhu4sgYHRydWVgIHRyb25nIHN14buRdCB2w7JuZyDEkeG7nWkgY+G7p2EgbsOzLg0KICAgLSBJbnZhcmlhbnQgY8OzIHRo4buDIGLhu4sgcGjDoSB24buhIHThuqFtIHRo4budaSAqKmLDqm4gdHJvbmcqKiB0aMOibiBwaMawxqFuZyB0aOG7qWMgdHJvbmcgcXXDoSB0csOsbmggYmnhur9uIMSR4buVaSB0cuG6oW5nIHRow6FpLCBuaMawbmcgYuG6r3QgYnXhu5ljIHBo4bqjaSDEkcaw4bujYyBraMO0aSBwaOG7pWMgbmd1ecOqbiB24bq5biB0csaw4bubYyBraGkgcGjGsMahbmcgdGjhu6ljIHRy4bqjIHF1eeG7gW4gxJFp4buBdSBraGnhu4NuIHbhu4EgY2hvIHRo4bq/IGdp4bubaSBiw6puIG5nb8OgaS4NCiAgIC0gxJDGsOG7o2Mga2nhu4NtIHRyYSB04buxIMSR4buZbmcgdOG6oWkgMiB0aOG7nWkgxJFp4buDbSBj4buRdCBsw7VpOg0KICAgICAtIE5nYXkgc2F1IGtoaSBDb25zdHJ1Y3RvciBob8OgbiB04bqldCBraOG7n2kgdOG6oW8uDQogICAgIC0gVHLGsOG7m2Mga2hpIGLhuq90IMSR4bqndSB2w6Agc2F1IGtoaSBr4bq/dCB0aMO6YyBt4buNaSBwaMawxqFuZyB0aOG7qWMgYHB1YmxpY2AuDQoNCmBgYG1lcm1haWQNCnNlcXVlbmNlRGlhZ3JhbQ0KICAgIGF1dG9udW1iZXINCiAgICBwYXJ0aWNpcGFudCBDIGFzIENhbGxlciAoQ2xpZW50KQ0KICAgIHBhcnRpY2lwYW50IE8gYXMgT2JqZWN0IEluc3RhbmNlDQogICAgTm90ZSBvdmVyIE86IENvbnN0cnVjdG9yIGNvbXBsZXRlcyAtPiBDaGVjayBJbnZhcmlhbnQNCg0KICAgIEMtPj5POiBJbnZva2UgcHVibGljTWV0aG9kKGFyZ3MpDQogICAgYWN0aXZhdGUgTw0KICAgIE5vdGUgb3ZlciBPOiAxLiBDaGVjayBQcmVjb25kaXRpb25zIChDYWxsZXIgT2JsaWdhdGlvbikNCiAgICBOb3RlIG92ZXIgTzogMi4gQ2hlY2sgRW50cnkgSW52YXJpYW50DQogICAgTm90ZSBvdmVyIE86IDMuIEV4ZWN1dGUgU3RhdGUgVHJhbnNmb3JtYXRpb24gKEludmFyaWFudCB0ZW1wb3JhcmlseSBicm9rZW4pDQogICAgTm90ZSBvdmVyIE86IDQuIENoZWNrIEV4aXQgSW52YXJpYW50DQogICAgTm90ZSBvdmVyIE86IDUuIENoZWNrIFBvc3Rjb25kaXRpb25zIChDYWxsZWUgT2JsaWdhdGlvbikNCiAgICBPLS0+PkM6IFJldHVybiBSZXN1bHQNCiAgICBkZWFjdGl2YXRlIE8NCmBgYA0KDQotLS0NCg0KIyMjIDIuMi4gU3ViY29udHJhY3RpbmcgdsOgIE5ndXnDqm4gbMO9IFRoYXkgdGjhur8gTGlza292IChMU1AgRW5mb3JjZW1lbnQpDQpLaGkgw6FwIGThu6VuZyB0w61uaCBr4bq/IHRo4burYSB0cm9uZyBs4bqtcCB0csOsbmggaMaw4bubbmcgxJHhu5FpIHTGsOG7o25nLCBEYkMgY3VuZyBj4bqlcCBxdXkgdOG6r2MgdG/DoW4gaOG7jWMga2jhuq90IGtoZSDEkeG7gyBraeG7g20gc2/DoXQgxJFhIGjDrG5oIChQb2x5bW9ycGhpc20pLCB0cuG7sWMgdGnhur9wIHRo4buxYyB0aGkgKipOZ3V5w6puIGzDvSBUaGF5IHRo4bq/IExpc2tvdiAoTGlza292IFN1YnN0aXR1dGlvbiBQcmluY2lwbGUgLSBMU1ApKio6DQoNCiQkXHRleHR7UHJlfV97XHRleHR7ZGVyaXZlZH19IFxMZWZ0YXJyb3cgXHRleHR7UHJlfV97XHRleHR7YmFzZX19IFxxdWFkIChcdGV4dHtDb250cmF2YXJpYW5jZTogVGnhu4FuIMSRaeG7gXUga2nhu4duIGNo4buJIMSRxrDhu6NjIG7hu5tpIGzhu49uZyBob+G6t2MgZ2nhu68gbmd1ecOqbn0pJCQNCiQkXHRleHR7UG9zdH1fe1x0ZXh0e2Rlcml2ZWR9fSBcUmlnaHRhcnJvdyBcdGV4dHtQb3N0fV97XHRleHR7YmFzZX19IFxxdWFkIChcdGV4dHtDb3ZhcmlhbmNlOiBI4bqtdSDEkWnhu4F1IGtp4buHbiBjaOG7iSDEkcaw4bujYyB0aOG6r3QgY2jhurd0IGhv4bq3YyBnaeG7ryBuZ3V5w6pufSkkJA0KJCRcdGV4dHtJbnZhcmlhbnR9X3tcdGV4dHtkZXJpdmVkfX0gXFJpZ2h0YXJyb3cgXHRleHR7SW52YXJpYW50fV97XHRleHR7YmFzZX19IFxxdWFkIChcdGV4dHtC4bqldCBiaeG6v24gbOG7m3AgY29uIGJhbyBow6BtIHRvw6BuIGLhu5kgYuG6pXQgYmnhur9uIGzhu5twIGNoYX0pJCQNCg0KLSAqKktow7RuZyBiYW8gZ2nhu50gxJHDsmkgaOG7j2kgbmhp4buBdSBoxqFuIGzhu5twIGNoYSoqOiBM4bubcCBjb24ga2jDtG5nIMSRxrDhu6NjIHF1eeG7gW4gdOG7qyBjaOG7kWkgY8OhYyDEkeG7kWkgc+G7kSBtw6AgbOG7m3AgY2hhIGNo4bqlcCBuaOG6rW4uIE7hur91IGzhu5twIGNoYSBuaOG6rW4gbeG7jWkgc+G7kSBuZ3V5w6puICR4IFxpbiBcbWF0aGJie1J9JCwgbOG7m3AgY29uIGtow7RuZyB0aOG7gyDEkeG6t3QgcHJlY29uZGl0aW9uICR4ID4gMCQuDQotICoqTHXDtG4gbHXDtG4gY2FtIGvhur90IG5oaeG7gXUgaMahbiBob+G6t2MgYuG6sW5nIGzhu5twIGNoYSoqOiBO4bq/dSBs4bubcCBjaGEgaOG7qWEgdHLhuqMgduG7gSBkYW5oIHPDoWNoIMSRxrDhu6NjIHPhuq9wIHjhur9wLCBs4bubcCBjb24ga2jDtG5nIHRo4buDIHRy4bqjIHbhu4EgZGFuaCBzw6FjaCB4w6FvIHRy4buZbi4NCg0KLS0tDQoNCiMjIyAyLjMuIERlZmVuc2l2ZSBQcm9ncmFtbWluZyB2cyBEZXNpZ24gYnkgQ29udHJhY3QgJiBGYWlsLUZhc3QNClRyb25nIGvhu7kgbmdo4buHIHBo4bqnbiBt4buBbSBoaeG7h24gxJHhuqFpLCBjw7Mgc+G7sSBwaMOibiDEkeG7i25oIHJhbmggZ2nhu5tpIHLDtSBy4buHdCBnaeG7r2EgaGFpIHRyxrDhu51uZyBwaMOhaToNCg0KfCDEkOG6t2MgdMOtbmggfCBEZWZlbnNpdmUgUHJvZ3JhbW1pbmcgfCBEZXNpZ24gYnkgQ29udHJhY3QgKERiQykgfA0KfCA6LS0tIHwgOi0tLSB8IDotLS0gfA0KfCAqKlRyaeG6v3QgbMO9IGPhu5F0IGzDtWkqKiB8IEtow7RuZyB0aW4gdMaw4bufbmcgYuG6pXQga+G7syBtb2R1bGUgbsOgbzsgZ2nhuqMgxJHhu4tuaCBt4buNaSB0aOG7qSDEkeG7gXUgY8OzIHRo4buDIHNhaS4gfCBSYW5oIGdp4bubaSB0csOhY2ggbmhp4buHbSByw7UgcsOgbmc7IGNvaSB2aSBwaOG6oW0gdGnhu4FuIMSRaeG7gXUga2nhu4duIGzDoCBidWcgbG9naWMuIHwNCnwgKipY4butIGzDvSBraGkgSW5wdXQgc2FpKiogfCBD4buRIGfhuq9uZyBjaGUgZ2nhuqV1OiBUcuG6oyB24buBIGBudWxsYCwgY2h14buXaSBy4buXbmcgYCIiYCwgaG/hurdjIGdpw6EgdHLhu4sgbeG6t2MgxJHhu4tuaC4gfCAqKkZhaWwtRmFzdCoqOiBOw6ltIGV4Y2VwdGlvbiBs4bqtcCB04bupYyBob+G6t2MgZOG7q25nIGNoxrDGoW5nIHRyw6xuaCDEkeG7gyBs4buZIGJ1Zy4gfA0KfCAqKkNoaSBwaMOtIG3DoyBuZ3Xhu5NuKiogfCBNw6Mgbmd14buTbiBi4buLIHBow6xuaCB0byAoQmxvYXRlZCkgYuG7n2kgY8OhYyB04bqnbmcga2nhu4NtIHRyYSBgaWYgKHB0ciA9PSBudWxscHRyKWAgdHLDuW5nIGzhurdwLiB8IFRpbmggZ+G7jW47IGNo4buJIGtp4buDbSB0cmEgdOG6oWkgcmFuaCBnaeG7m2kgY8O0bmcga2hhaSAoQVBJIEJvdW5kYXJ5KSBob+G6t2MgcXVhIGFzc2VydGlvbnMuIHwNCnwgKipNw7RpIHRyxrDhu51uZyBwaMO5IGjhu6NwKiogfCBSYW5oIGdp4bubaSBjw7RuZyBj4buZbmcga2jDtG5nIHRpbiBj4bqteSAoUHVibGljIFJFU1QgQVBJcywgSW5wdXQgdOG7qyBuZ8aw4budaSBkw7luZykuIHwgUmFuaCBnaeG7m2kgbuG7mWkgYuG7mSBnaeG7r2EgY8OhYyB04bqnbmcga2nhur9uIHRyw7pjIChJbnRlcm5hbCBEb21haW4gU2VydmljZXMsIENvcmUgRW5naW5lKS4gfA0KDQotLS0NCg0KIyMjIDIuNC4gVGhlIDQgTGV2ZWxzIG9mIEV4Y2VwdGlvbiBTYWZldHkgKELhu5FuIEPhuqVwIMSQ4buZIEFuIFRvw6BuIE5nb+G6oWkgTOG7hykNCsSQxrDhu6NjIGNodeG6qW4gaMOzYSBi4bufaSBCamFybmUgU3Ryb3VzdHJ1cCB2w6AgRGF2aWQgQWJyYWhhbXMsIGFuIHRvw6BuIG5nb+G6oWkgbOG7hyBwaMOibiDEkeG7i25oIDQgY+G6pXAgxJHhu5kgY2FtIGvhur90IGLhuqNvIHbhu4cgdHLhuqFuZyB0aMOhaSBi4buZIG5o4bubOg0KDQpgYGBtZXJtYWlkDQpncmFwaCBURA0KICAgIHN1YmdyYXBoIExldmVsc1siQ8OhYyBD4bqlcCDEkOG7mSBBbiBUb8OgbiBOZ2/huqFpIEzhu4cgKEV4Y2VwdGlvbiBTYWZldHkgU3BlY3RydW0pIl0NCiAgICAgICAgTDBbIjAuIE5vIEV4Y2VwdGlvbiBTYWZldHk8YnIvPihD4bqkTSBEw5lORzogUsOyIHLhu4kgdMOgaSBuZ3V5w6puLCBNZW1vcnkgQ29ycnVwdGlvbikiXQ0KICAgICAgICBMMVsiMS4gQmFzaWMgRXhjZXB0aW9uIFNhZmV0eTxici8+KELhuq90IGJ14buZYyB04buRaSB0aGnhu4N1OiBLaMO0bmcgbGVhaywgxJHhu5FpIHTGsOG7o25nIGjhu6NwIGzhu4cgbmjGsG5nIGRhdGEgYmnhur9uIMSR4buVaSkiXQ0KICAgICAgICBMMlsiMi4gU3Ryb25nIEV4Y2VwdGlvbiBTYWZldHk8YnIvPihDb21taXQtb3ItUm9sbGJhY2s6IFRow6BuaCBjw7RuZyB0cuG7jW4gduG6uW4gaG/hurdjIGdp4buvIG5ndXnDqm4gdHLhuqFuZyB0aMOhaSBjxakpIl0NCiAgICAgICAgTDNbIjMuIE5vLXRocm93IC8gTm90aHJvdyBHdWFyYW50ZWU8YnIvPihDYW0ga+G6v3QgMTAwJSBraMO0bmcgdGhyb3c6IG5vZXhjZXB0LCBSQUlJIGNsZWFudXAsIHN3YXAsIG1vdmUpIl0NCiAgICBlbmQNCiAgICBMMCAtLT58w4FwIGThu6VuZyBSQUlJICYgU21hcnQgUG9pbnRlcnN8IEwxDQogICAgTDEgLS0+fMOBcCBk4bulbmcgQ29weS1hbmQtU3dhcHwgTDINCiAgICBMMiAtLT58w4FwIGThu6VuZyBub2V4Y2VwdCBwcmltaXRpdmVzfCBMMw0KYGBgDQoNCjEuICoqTm8gRXhjZXB0aW9uIFNhZmV0eSAoS2jDtG5nIGFuIHRvw6BuIC0gTeG7qWMgMCkqKjoNCiAgIC0gS2hpIGPDsyBleGNlcHRpb24geOG6o3kgcmEgZ2nhu69hIGNo4burbmcsIHTDoGkgbmd1ecOqbiAoYuG7mSBuaOG7myBoZWFwLCBmaWxlIGhhbmRsZSwgc29ja2V0LCBkYXRhYmFzZSBjb25uZWN0aW9uKSBi4buLIHLDsiBy4buJIHbEqW5oIHZp4buFbi4gQ29uIHRy4buPIGPDsyB0aOG7gyBi4buLIHRy4buPIHbDoG8gdsO5bmcgbmjhu5sgcsOhYyAoRGFuZ2xpbmcgUG9pbnRlciksIGThuqtuIMSR4bq/biBDcmFzaCBob+G6t2MgbOG7lyBo4buVbmcgYuG6o28gbeG6rXQuDQoyLiAqKkJhc2ljIEV4Y2VwdGlvbiBTYWZldHkgKENhbSBr4bq/dCBDxqEgYuG6o24gLSBN4bupYyAxIC0gVOG7kWkgdGhp4buDdSBi4bqvdCBideG7mWMpKio6DQogICAtIMSQ4bqjbSBi4bqjbyAqKmtow7RuZyBjw7MgcsOyIHLhu4kgdMOgaSBuZ3V5w6puKiogbmjhu50gY8ahIGNo4bq/IFJBSUkgKFJlc291cmNlIEFjcXVpc2l0aW9uIElzIEluaXRpYWxpemF0aW9uKS4NCiAgIC0gTeG7jWkgxJHhu5FpIHTGsOG7o25nIHbhuqtuIGR1eSB0csOsIHRy4bqhbmcgdGjDoWkgaOG7o3AgbOG7hyAoQ2xhc3MgSW52YXJpYW50cyDEkcaw4bujYyBi4bqjbyB04buTbiksIG5oxrBuZyBk4buvIGxp4buHdSBjw7MgdGjhu4MgxJHDoyBi4buLIHRoYXkgxJHhu5VpIG3hu5l0IHBo4bqnbiB2w6Aga2jDtG5nIHRo4buDIGThu7EgxJFvw6FuIGNow61uaCB4w6FjIGdpw6EgdHLhu4sgY8WpLg0KMy4gKipTdHJvbmcgRXhjZXB0aW9uIFNhZmV0eSAoQ2FtIGvhur90IE3huqFuaCAtIE3hu6ljIDIgLSBDb21taXQvUm9sbGJhY2spKio6DQogICAtIEhv4bqhdCDEkeG7mW5nIHRoZW8gbmfhu68gbmdoxKlhIGdpYW8gZOG7i2NoIG5ndXnDqm4gdOG7rSAoQXRvbWljIFRyYW5zYWN0aW9uKTogTuG6v3UgdGhhbyB0w6FjIHRow6BuaCBjw7RuZywgdHLhuqFuZyB0aMOhaSBt4bubaSDEkcaw4bujYyBjb21taXQ7IG7hur91IHRoYW8gdMOhYyB0aOG6pXQgYuG6oWkgZG8gZXhjZXB0aW9uLCB0cuG6oW5nIHRow6FpIGjhu4cgdGjhu5FuZyDEkcaw4bujYyBwaOG7pWMgaOG7k2kgbmd1ecOqbiB24bq5biBuaMawIHRyxrDhu5tjIGtoaSBow6BtIMSRxrDhu6NjIGfhu41pLg0KNC4gKipOby10aHJvdyAvIE5vdGhyb3cgR3VhcmFudGVlIChDYW0ga+G6v3QgS2jDtG5nIG7DqW0gbmdv4bqhaSBs4buHIC0gTeG7qWMgMyAtIFR1eeG7h3QgxJHhu5FpKSoqOg0KICAgLSBQaMawxqFuZyB0aOG7qWMgY2FtIGvhur90IHRow6BuaCBjw7RuZyAkMTAwXCUkIHbDoCBraMO0bmcgYmFvIGdp4budIMSR4buDIGLhuqV0IGvhu7Mgbmdv4bqhaSBs4buHIG7DoG8gdGhvw6F0IHJhIG5nb8OgaS4NCiAgIC0gQuG6r3QgYnXhu5ljIHBo4bqjaSBjw7MgY2hvOiAqKkRlc3RydWN0b3JzKiosICoqTW92ZSBDb25zdHJ1Y3RvcnMqKiwgKipNb3ZlIEFzc2lnbm1lbnQgT3BlcmF0b3JzKiosIHbDoCBjw6FjIGjDoG0gaG/DoW4gxJHhu5VpICoqYHN3YXAoKWAqKi4gVHJvbmcgQysrLCDEkWnhu4F1IG7DoHkgxJHGsOG7o2MgY2jhu4kgxJHhu4tuaCBi4bqxbmcgdOG7qyBraMOzYSBgbm9leGNlcHRgLg0KDQotLS0NCg0KIyMjIDIuNS4gVGjDoG5oIG5n4buvIENvcHktYW5kLVN3YXAgdsOgIENhbSBr4bq/dCBTdHJvbmcgRXhjZXB0aW9uIFNhZmV0eQ0KS+G7uSB0aHXhuq10IGNodeG6qW4gbeG7sWMgbmjhuqV0IMSR4buDIMSR4bqhdCDEkcaw4bujYyBTdHJvbmcgRXhjZXB0aW9uIFNhZmV0eSBtw6Aga2jDtG5nIGPhuqduIHZp4bq/dCBjw6FjIGto4buRaSBgdHJ5L2NhdGNoYCBj4buTbmcga+G7gW5oIGzDoCAqKkNvcHktYW5kLVN3YXAgSWRpb20qKjoNCg0KMS4gKipCxrDhu5tjIENvcHkgKEPDsyB0aOG7gyB0aHJvdykqKjogS2jhu59pIHThuqFvIG3hu5l0IMSR4buRaSB0xrDhu6NuZyB04bqhbSB0aOG7nWkgYHRlbXBgIGLhurFuZyBjw6FjaCBzYW8gY2jDqXAgdHLhuqFuZyB0aMOhaSBoaeG7h24gdOG6oWkgY+G7p2EgYCp0aGlzYC4gTuG6v3Ugdmnhu4djIGPhuqVwIHBow6F0IGLhu5kgbmjhu5sgYuG7iyBs4buXaSAoYHN0ZDo6YmFkX2FsbG9jYCksIGV4Y2VwdGlvbiBs4bqtcCB04bupYyBi4bqvbiByYSwgxJHhu5FpIHTGsOG7o25nIGfhu5FjIGAqdGhpc2AgaG/DoG4gdG/DoG4gY2jGsGEgYuG7iyBjaOG6oW0gdOG7m2kuDQoyLiAqKkLGsOG7m2MgQmnhur9uIMSR4buVaSAoQ8OzIHRo4buDIHRocm93KSoqOiBUaeG6v24gaMOgbmggdG/DoG4gYuG7mSBjw6FjIHBow6lwIHRvw6FuLCBj4bqlcCBwaMOhdCwgdGjDqm0gYuG7m3QgdHLDqm4gxJHhu5FpIHTGsOG7o25nIHThuqFtIGB0ZW1wYC4gTuG6v3UgY8OzIGLhuqV0IGvhu7MgYsaw4bubYyBuw6BvIG7DqW0gbOG7l2ksIGB0ZW1wYCB04buxIMSR4buZbmcgYuG7iyBo4buneSB0aGVvIGPGoSBjaOG6vyBSQUlJLCBgKnRoaXNgIHbhuqtuIG5ndXnDqm4gduG6uW4uDQozLiAqKkLGsOG7m2MgU3dhcCAoQ2FtIGvhur90IG5vZXhjZXB0KSoqOiBUaOG7sWMgaGnhu4duIGhvw6FuIMSR4buVaSBjb24gdHLhu48gYuG7mSBuaOG7myBnaeG7r2EgYCp0aGlzYCB2w6AgYHRlbXBgIGLhurFuZyBow6BtIHN3YXAga2jDtG5nIGJhbyBnaeG7nSBuw6ltIG5nb+G6oWkgbOG7hy4gUXXDoSB0csOsbmggc3dhcCBkaeG7hW4gcmEg4bufIMSR4buZIHBo4bupYyB04bqhcCAkTygxKSQuDQo0LiAqKkLGsOG7m2MgSOG7p3kqKjogS2hpIGjDoG0ga+G6v3QgdGjDumMsIGB0ZW1wYCAoaGnhu4duIMSRYW5nIGdp4buvIHTDoGkgbmd1ecOqbiBjxakgY+G7p2EgYCp0aGlzYCkgYuG7iyBo4buneSBiw6xuaCB0aMaw4budbmcuDQoNCi0tLQ0KDQojIyMgMi42LiBOby10aHJvdyBHdWFyYW50ZWUgdsOgIFThuqdtIHF1YW4gdHLhu41uZyBj4bunYSBgbm9leGNlcHRgDQpU4bqhaSBzYW8gRGVzdHJ1Y3RvciB2w6AgTW92ZSBDb25zdHJ1Y3RvciBi4bqvdCBideG7mWMgcGjhuqNpIGzDoCBgbm9leGNlcHRgPw0KLSAqKkRlc3RydWN0b3IgdGhyb3dpbmcqKjogTuG6v3UgbeG7mXQgbmdv4bqhaSBs4buHIMSRYW5nIHRyb25nIHF1w6EgdHLDrG5oIGdp4bqjaSBwaMOzbmcgbmfEg24geOG6v3AgKFN0YWNrIFVud2luZGluZykgbcOgIG3hu5l0IERlc3RydWN0b3IgY+G7p2EgxJHhu5FpIHTGsOG7o25nIHRyw6puIHN0YWNrIGzhuqFpIG7DqW0gdGnhur9wIG3hu5l0IG5nb+G6oWkgbOG7hyB0aOG7qSBoYWksIHJ1bnRpbWUgQysrIGtow7RuZyB0aOG7gyB44butIGzDvSDEkeG7k25nIHRo4budaSAyIGV4Y2VwdGlvbiB2w6AgYnXhu5ljIHBo4bqjaSBrw61jaCBob+G6oXQgYHN0ZDo6dGVybWluYXRlKClgLCBsw6BtIHPhuq1wIHRvw6BuIGLhu5kgdGnhur9uIHRyw6xuaCBuZ2F5IGzhuq1wIHThu6ljLg0KLSAqKk1vdmUgb3BlcmF0aW9ucyoqOiBDaHXhuqluIEMrKyAoYHN0ZDo6dmVjdG9yOjpwdXNoX2JhY2tgIGhv4bq3YyBgcmVzaXplYCkgc+G6vSBraeG7g20gdHJhIGBzdGQ6OmlzX25vdGhyb3dfbW92ZV9jb25zdHJ1Y3RpYmxlPFQ+Ojp2YWx1ZWAuIE7hur91IG1vdmUgY29uc3RydWN0b3Iga2jDtG5nIMSRxrDhu6NjIMSRw6FuaCBk4bqldSBgbm9leGNlcHRgLCB2ZWN0b3Igc+G6vSBsw7lpIHbhu4EgZMO5bmcgY29weSBjb25zdHJ1Y3RvciDEkeG7gyDEkeG6o20gYuG6o28gU3Ryb25nIEV4Y2VwdGlvbiBTYWZldHksIGzDoG0gc3V5IGdp4bqjbSBoaeG7h3UgbsSDbmcgbmdoacOqbSB0cuG7jW5nLg0KDQotLS0NCg0KIyMgMy4gVGjhu7FjIHRoaSBNw6Mgbmd14buTbiAmIE3DtCBwaOG7j25nIENodXnDqm4gc8OidSAoRHVhbC1FbmdpbmUgSW1wbGVtZW50YXRpb24pDQoNCiMjIyAzLjEuIEMrKzIwIEltcGxlbWVudGF0aW9uOiBFbnRlcnByaXNlIFJlc2lsaWVudCBMZWRnZXIgd2l0aCBDb3B5LWFuZC1Td2FwICYgRGJDDQpDaMawxqFuZyB0csOsbmggZMaw4bubaSDEkcOieSBtaW5oIGjhu41hIGjhu4cgdGjhu5FuZyBxdeG6o24gbMO9IHPhu5EgZMawIHTDoGkga2hv4bqjbiBuZ8OibiBow6BuZyDEkcOhcCDhu6luZyDEkeG6p3kgxJHhu6cgRGJDLCBDbGFzcyBJbnZhcmlhbnRzLCB2w6AgU3Ryb25nIEV4Y2VwdGlvbiBTYWZldHkgdGjDtG5nIHF1YSBDb3B5LWFuZC1Td2FwIElkaW9tLg0KDQpgYGBjcHANCiNpbmNsdWRlIDxpb3N0cmVhbT4NCiNpbmNsdWRlIDx2ZWN0b3I+DQojaW5jbHVkZSA8c3RyaW5nPg0KI2luY2x1ZGUgPHN0ZGV4Y2VwdD4NCiNpbmNsdWRlIDxjYXNzZXJ0Pg0KI2luY2x1ZGUgPHV0aWxpdHk+DQojaW5jbHVkZSA8bWVtb3J5Pg0KI2luY2x1ZGUgPHNzdHJlYW0+DQoNCi8vIEN1c3RvbSBFeGNlcHRpb24gYmnhu4N1IHRo4buLIGzhu5dpIGjhu4cgdGjhu5FuZyBraGkgcGjDom4gYuG7lQ0KY2xhc3MgTGVkZ2VyU3RvcmFnZUV4Y2VwdGlvbiA6IHB1YmxpYyBzdGQ6OnJ1bnRpbWVfZXJyb3Igew0KcHVibGljOg0KICAgIGV4cGxpY2l0IExlZGdlclN0b3JhZ2VFeGNlcHRpb24oY29uc3Qgc3RkOjpzdHJpbmcmIG1zZykgOiBzdGQ6OnJ1bnRpbWVfZXJyb3IobXNnKSB7fQ0KfTsNCg0KLy8gTcO0IHBo4buPbmcgY+G6pXUgdHLDumMgbeG7pWMga+G6vyB0b8Ohbg0Kc3RydWN0IExlZGdlckVudHJ5IHsNCiAgICB1aW50NjRfdCB0cmFuc2FjdGlvbklkOw0KICAgIGludDY0X3QgYW1vdW50Q2VudHM7DQogICAgc3RkOjpzdHJpbmcgZGVzY3JpcHRpb247DQp9Ow0KDQovLyBDbGFzcyB0aOG7sWMgaGnhu4duIERiQyB2w6AgU3Ryb25nIEV4Y2VwdGlvbiBTYWZldHkNCmNsYXNzIFJlc2lsaWVudEFjY291bnQgew0KcHJpdmF0ZToNCiAgICB1aW50NjRfdCBhY2NvdW50SWRfezB9Ow0KICAgIGludDY0X3QgYmFsYW5jZUNlbnRzX3swfTsNCiAgICBzdGQ6OnZlY3RvcjxMZWRnZXJFbnRyeT4gYXVkaXRUcmFpbF87DQoNCiAgICAvLyBDTEFTUyBJTlZBUklBTlQ6IFPhu5EgZMawIGtow7RuZyBiYW8gZ2nhu50gxJHGsOG7o2Mgw6JtLCBhY2NvdW50SWQgPiAwDQogICAgdm9pZCB2ZXJpZnlJbnZhcmlhbnQoKSBjb25zdCBub2V4Y2VwdCB7DQogICAgICAgIGFzc2VydChhY2NvdW50SWRfID4gMCAmJiAiSW52YXJpYW50IFZpb2xhdGVkOiBBY2NvdW50IElEIG11c3QgYmUgcG9zaXRpdmUhIik7DQogICAgICAgIGFzc2VydChiYWxhbmNlQ2VudHNfID49IDAgJiYgIkludmFyaWFudCBWaW9sYXRlZDogQmFsYW5jZSBjYW5ub3QgYmUgbmVnYXRpdmUhIik7DQogICAgfQ0KDQpwdWJsaWM6DQogICAgLy8gQ29uc3RydWN0b3IgY8OzIGtp4buDbSB0cmEgUHJlY29uZGl0aW9uIHbDoCBJbnZhcmlhbnQNCiAgICBSZXNpbGllbnRBY2NvdW50KHVpbnQ2NF90IGlkLCBpbnQ2NF90IGluaXRpYWxCYWxhbmNlQ2VudHMpDQogICAgICAgIDogYWNjb3VudElkXyhpZCksIGJhbGFuY2VDZW50c18oaW5pdGlhbEJhbGFuY2VDZW50cykgew0KICAgICAgICAvLyBQcmVjb25kaXRpb24NCiAgICAgICAgaWYgKGlkID09IDApIHsNCiAgICAgICAgICAgIHRocm93IHN0ZDo6aW52YWxpZF9hcmd1bWVudCgiUHJlY29uZGl0aW9uIEZhaWxlZDogSUQgbXVzdCBiZSBub24temVybyIpOw0KICAgICAgICB9DQogICAgICAgIGlmIChpbml0aWFsQmFsYW5jZUNlbnRzIDwgMCkgew0KICAgICAgICAgICAgdGhyb3cgc3RkOjppbnZhbGlkX2FyZ3VtZW50KCJQcmVjb25kaXRpb24gRmFpbGVkOiBJbml0aWFsIGJhbGFuY2UgY2Fubm90IGJlIG5lZ2F0aXZlIik7DQogICAgICAgIH0NCiAgICAgICAgdmVyaWZ5SW52YXJpYW50KCk7DQogICAgfQ0KDQogICAgLy8gQ29weSBDb25zdHJ1Y3RvciAoQ8OzIHRo4buDIHRocm93IHN0ZDo6YmFkX2FsbG9jKQ0KICAgIFJlc2lsaWVudEFjY291bnQoY29uc3QgUmVzaWxpZW50QWNjb3VudCYgb3RoZXIpDQogICAgICAgIDogYWNjb3VudElkXyhvdGhlci5hY2NvdW50SWRfKSwNCiAgICAgICAgICBiYWxhbmNlQ2VudHNfKG90aGVyLmJhbGFuY2VDZW50c18pLA0KICAgICAgICAgIGF1ZGl0VHJhaWxfKG90aGVyLmF1ZGl0VHJhaWxfKSB7DQogICAgICAgIHZlcmlmeUludmFyaWFudCgpOw0KICAgIH0NCg0KICAgIC8vIE1vdmUgQ29uc3RydWN0b3IgKENhbSBr4bq/dCBub2V4Y2VwdCkNCiAgICBSZXNpbGllbnRBY2NvdW50KFJlc2lsaWVudEFjY291bnQmJiBvdGhlcikgbm9leGNlcHQNCiAgICAgICAgOiBhY2NvdW50SWRfKHN0ZDo6ZXhjaGFuZ2Uob3RoZXIuYWNjb3VudElkXywgMCkpLA0KICAgICAgICAgIGJhbGFuY2VDZW50c18oc3RkOjpleGNoYW5nZShvdGhlci5iYWxhbmNlQ2VudHNfLCAwKSksDQogICAgICAgICAgYXVkaXRUcmFpbF8oc3RkOjptb3ZlKG90aGVyLmF1ZGl0VHJhaWxfKSkgew0KICAgIH0NCg0KICAgIC8vIERlc3RydWN0b3IgKENhbSBr4bq/dCBub2V4Y2VwdCB0dXnhu4d0IMSR4buRaSkNCiAgICB+UmVzaWxpZW50QWNjb3VudCgpIG5vZXhjZXB0ID0gZGVmYXVsdDsNCg0KICAgIC8vIE5PLVRIUk9XIFNXQVA6IEhvw6FuIMSR4buVaSBjb24gdHLhu48gYuG7mSBuaOG7myBu4buZaSB04bqhaSDhu58gTygxKQ0KICAgIHZvaWQgc3dhcChSZXNpbGllbnRBY2NvdW50JiBvdGhlcikgbm9leGNlcHQgew0KICAgICAgICB1c2luZyBzdGQ6OnN3YXA7DQogICAgICAgIHN3YXAoYWNjb3VudElkXywgb3RoZXIuYWNjb3VudElkXyk7DQogICAgICAgIHN3YXAoYmFsYW5jZUNlbnRzXywgb3RoZXIuYmFsYW5jZUNlbnRzXyk7DQogICAgICAgIHN3YXAoYXVkaXRUcmFpbF8sIG90aGVyLmF1ZGl0VHJhaWxfKTsNCiAgICB9DQoNCiAgICAvLyBDb3B5IEFzc2lnbm1lbnQgT3BlcmF0b3Igc+G7rSBk4bulbmcgQ29weS1hbmQtU3dhcCAoU3Ryb25nIEV4Y2VwdGlvbiBTYWZldHkpDQogICAgUmVzaWxpZW50QWNjb3VudCYgb3BlcmF0b3I9KFJlc2lsaWVudEFjY291bnQgb3RoZXIpIG5vZXhjZXB0IHsNCiAgICAgICAgdGhpcy0+c3dhcChvdGhlcik7DQogICAgICAgIHJldHVybiAqdGhpczsNCiAgICB9DQoNCiAgICAvLyBTVFJPTkcgRVhDRVBUSU9OIFNBRkVUWSBNRVRIT0Q6IE7huqFwIHRp4buBbiAvIEdpYW8gZOG7i2NoIG5ndXnDqm4gdOG7rQ0KICAgIHZvaWQgYXBwbHlUcmFuc2FjdGlvbih1aW50NjRfdCB0eElkLCBpbnQ2NF90IGFtb3VudENlbnRzLCBjb25zdCBzdGQ6OnN0cmluZyYgZGVzYywgYm9vbCBzaW11bGF0ZUZhaWx1cmUgPSBmYWxzZSkgew0KICAgICAgICAvLyAxLiBQUkVDT05ESVRJT04gRU5GT1JDRU1FTlQNCiAgICAgICAgaWYgKHR4SWQgPT0gMCkgew0KICAgICAgICAgICAgdGhyb3cgc3RkOjppbnZhbGlkX2FyZ3VtZW50KCJQcmVjb25kaXRpb24gRmFpbGVkOiBUcmFuc2FjdGlvbiBJRCBtdXN0IGJlID4gMCIpOw0KICAgICAgICB9DQogICAgICAgIGlmIChhbW91bnRDZW50cyA9PSAwKSB7DQogICAgICAgICAgICB0aHJvdyBzdGQ6OmludmFsaWRfYXJndW1lbnQoIlByZWNvbmRpdGlvbiBGYWlsZWQ6IFRyYW5zYWN0aW9uIGFtb3VudCBjYW5ub3QgYmUgemVybyIpOw0KICAgICAgICB9DQogICAgICAgIGlmIChiYWxhbmNlQ2VudHNfICsgYW1vdW50Q2VudHMgPCAwKSB7DQogICAgICAgICAgICB0aHJvdyBzdGQ6OmRvbWFpbl9lcnJvcigiUHJlY29uZGl0aW9uIEZhaWxlZDogSW5zdWZmaWNpZW50IGZ1bmRzIGZvciB3aXRoZHJhd2FsIik7DQogICAgICAgIH0NCg0KICAgICAgICAvLyAyLiBDT1BZIFNURVA6IFNhbyBjaMOpcCB0cuG6oW5nIHRow6FpIGhp4buHbiB04bqhaSBzYW5nIGLhuqNuIHNhbyB04bqhbSB0aOG7nWkNCiAgICAgICAgUmVzaWxpZW50QWNjb3VudCB0ZW1wU25hcHNob3QoKnRoaXMpOw0KDQogICAgICAgIC8vIDMuIFRSQU5TRk9STSBTVEVQIFRSw4pOIELhuqJOIFNBTyBU4bqgTQ0KICAgICAgICB0ZW1wU25hcHNob3QuYmFsYW5jZUNlbnRzXyArPSBhbW91bnRDZW50czsNCiAgICAgICAgdGVtcFNuYXBzaG90LmF1ZGl0VHJhaWxfLnB1c2hfYmFjayhMZWRnZXJFbnRyeXt0eElkLCBhbW91bnRDZW50cywgZGVzY30pOw0KDQogICAgICAgIC8vIEdp4bqjIGzhuq1wIGzhu5dpIEkvTyBob+G6t2MgbOG7l2kgRGlzayBGdWxsIHjhuqN5IHJhIGdp4buvYSBjaOG7q25nDQogICAgICAgIGlmIChzaW11bGF0ZUZhaWx1cmUpIHsNCiAgICAgICAgICAgIHRocm93IExlZGdlclN0b3JhZ2VFeGNlcHRpb24oIkRpc2sgSS9PIGZhaWx1cmUgd2hpbGUgd3JpdGluZyBhdWRpdCBlbnRyeSEiKTsNCiAgICAgICAgfQ0KDQogICAgICAgIC8vIEtp4buDbSB0cmEgSW52YXJpYW50IHRyw6puIGLhuqNuIHNhbyB04bqhbSB0csaw4bubYyBraGkgY29tbWl0DQogICAgICAgIHRlbXBTbmFwc2hvdC52ZXJpZnlJbnZhcmlhbnQoKTsNCg0KICAgICAgICAvLyA0LiBDT01NSVQgU1RFUCBRVUEgTk9FWENFUFQgU1dBUDogTygxKQ0KICAgICAgICB0aGlzLT5zd2FwKHRlbXBTbmFwc2hvdCk7DQoNCiAgICAgICAgLy8gNS4gUE9TVENPTkRJVElPTiBWRVJJRklDQVRJT04NCiAgICAgICAgdmVyaWZ5SW52YXJpYW50KCk7DQogICAgICAgIGFzc2VydChiYWxhbmNlQ2VudHNfID49IDAgJiYgIlBvc3Rjb25kaXRpb24gVmlvbGF0ZWQ6IEJhbGFuY2UgaXMgY29ycnVwdCEiKTsNCiAgICB9DQoNCiAgICBbW25vZGlzY2FyZF1dIGludDY0X3QgYmFsYW5jZUNlbnRzKCkgY29uc3Qgbm9leGNlcHQgeyByZXR1cm4gYmFsYW5jZUNlbnRzXzsgfQ0KICAgIFtbbm9kaXNjYXJkXV0gc2l6ZV90IGF1ZGl0Q291bnQoKSBjb25zdCBub2V4Y2VwdCB7IHJldHVybiBhdWRpdFRyYWlsXy5zaXplKCk7IH0NCn07DQoNCmludCBtYWluKCkgew0KICAgIHN0ZDo6Y291dCA8PCAiPT09IEMrKzIwIERlc2lnbiBieSBDb250cmFjdCAmIFN0cm9uZyBFeGNlcHRpb24gU2FmZXR5IERlbW8gPT09XG4iOw0KDQogICAgdHJ5IHsNCiAgICAgICAgUmVzaWxpZW50QWNjb3VudCBhY2NvdW50KDEwMDEsIDUwJzAwMCk7IC8vICQ1MDAuMDANCiAgICAgICAgc3RkOjpjb3V0IDw8ICJbSW5pdF0gQWNjb3VudCAxMDAxIGluaXRpYWxpemVkIHdpdGggYmFsYW5jZTogIiA8PCBhY2NvdW50LmJhbGFuY2VDZW50cygpIDw8ICIgY2VudHNcbiI7DQoNCiAgICAgICAgLy8gR2lhbyBk4buLY2ggMTogVGjDoG5oIGPDtG5nDQogICAgICAgIGFjY291bnQuYXBwbHlUcmFuc2FjdGlvbigxLCAyNScwMDAsICJTYWxhcnkgRGVwb3NpdCIpOw0KICAgICAgICBzdGQ6OmNvdXQgPDwgIltUeCAxIFN1Y2Nlc3NdIEJhbGFuY2UgYWZ0ZXIgZGVwb3NpdDogIiA8PCBhY2NvdW50LmJhbGFuY2VDZW50cygpIA0KICAgICAgICAgICAgICAgICAgPDwgIiBjZW50cyB8IEF1ZGl0czogIiA8PCBhY2NvdW50LmF1ZGl0Q291bnQoKSA8PCAiXG4iOw0KDQogICAgICAgIC8vIEdpYW8gZOG7i2NoIDI6IFLDunQgdGnhu4FuIHF1w6Egc+G7kSBkxrAgKFZpIHBo4bqhbSBQcmVjb25kaXRpb24pDQogICAgICAgIHRyeSB7DQogICAgICAgICAgICBzdGQ6OmNvdXQgPDwgIlxuW1R4IDIgVGVzdF0gQXR0ZW1wdGluZyB3aXRoZHJhd2FsIGV4Y2VlZGluZyBiYWxhbmNlLi4uXG4iOw0KICAgICAgICAgICAgYWNjb3VudC5hcHBseVRyYW5zYWN0aW9uKDIsIC0xMDAnMDAwLCAiTHV4dXJ5IFdhdGNoIFB1cmNoYXNlIik7DQogICAgICAgIH0gY2F0Y2ggKGNvbnN0IHN0ZDo6ZXhjZXB0aW9uJiBleCkgew0KICAgICAgICAgICAgc3RkOjpjb3V0IDw8ICIgIC0+IENhdWdodCBQcmVjb25kaXRpb24gRXJyb3I6ICIgPDwgZXgud2hhdCgpIDw8ICJcbiI7DQogICAgICAgICAgICBzdGQ6OmNvdXQgPDwgIiAgLT4gQWNjb3VudCBTdGF0ZSBVbnRvdWNoZWQ6ICIgPDwgYWNjb3VudC5iYWxhbmNlQ2VudHMoKSA8PCAiIGNlbnRzXG4iOw0KICAgICAgICB9DQoNCiAgICAgICAgLy8gR2lhbyBk4buLY2ggMzogTcO0IHBo4buPbmcgbOG7l2kgaOG7hyB0aOG7kW5nIHBo4bqnbiBj4bupbmcgKFN0cm9uZyBFeGNlcHRpb24gU2FmZXR5IFJvbGxiYWNrKQ0KICAgICAgICB0cnkgew0KICAgICAgICAgICAgc3RkOjpjb3V0IDw8ICJcbltUeCAzIFRlc3RdIEF0dGVtcHRpbmcgZGVwb3NpdCB3aXRoIFNpbXVsYXRlZCBIYXJkd2FyZSBDcmFzaC4uLlxuIjsNCiAgICAgICAgICAgIGFjY291bnQuYXBwbHlUcmFuc2FjdGlvbigzLCAxMCcwMDAsICJCb251cyIsIC8qc2ltdWxhdGVGYWlsdXJlPSovdHJ1ZSk7DQogICAgICAgIH0gY2F0Y2ggKGNvbnN0IExlZGdlclN0b3JhZ2VFeGNlcHRpb24mIGV4KSB7DQogICAgICAgICAgICBzdGQ6OmNvdXQgPDwgIiAgLT4gQ2F1Z2h0IENyaXRpY2FsIEhhcmR3YXJlIEVycm9yOiAiIDw8IGV4LndoYXQoKSA8PCAiXG4iOw0KICAgICAgICAgICAgc3RkOjpjb3V0IDw8ICIgIC0+IFN0YXRlIHByZXNlcnZlZCB2aWEgQ29weS1hbmQtU3dhcCEgQmFsYW5jZTogIiANCiAgICAgICAgICAgICAgICAgICAgICA8PCBhY2NvdW50LmJhbGFuY2VDZW50cygpIDw8ICIgY2VudHMgfCBBdWRpdHM6ICIgPDwgYWNjb3VudC5hdWRpdENvdW50KCkgPDwgIlxuIjsNCiAgICAgICAgfQ0KDQogICAgfSBjYXRjaCAoY29uc3Qgc3RkOjpleGNlcHRpb24mIGV4KSB7DQogICAgICAgIHN0ZDo6Y2VyciA8PCAiRmF0YWwgdW5leHBlY3RlZCBlcnJvcjogIiA8PCBleC53aGF0KCkgPDwgIlxuIjsNCiAgICAgICAgcmV0dXJuIDE7DQogICAgfQ0KDQogICAgcmV0dXJuIDA7DQp9DQpgYGANCg0KIyMjIyBUZXJtaW5hbCBPdXRwdXQgTeG6q3UgKEMrKzIwKToNCmBgYHRleHQNCj09PSBDKysyMCBEZXNpZ24gYnkgQ29udHJhY3QgJiBTdHJvbmcgRXhjZXB0aW9uIFNhZmV0eSBEZW1vID09PQ0KW0luaXRdIEFjY291bnQgMTAwMSBpbml0aWFsaXplZCB3aXRoIGJhbGFuY2U6IDUwMDAwIGNlbnRzDQpbVHggMSBTdWNjZXNzXSBCYWxhbmNlIGFmdGVyIGRlcG9zaXQ6IDc1MDAwIGNlbnRzIHwgQXVkaXRzOiAxDQoNCltUeCAyIFRlc3RdIEF0dGVtcHRpbmcgd2l0aGRyYXdhbCBleGNlZWRpbmcgYmFsYW5jZS4uLg0KICAtPiBDYXVnaHQgUHJlY29uZGl0aW9uIEVycm9yOiBQcmVjb25kaXRpb24gRmFpbGVkOiBJbnN1ZmZpY2llbnQgZnVuZHMgZm9yIHdpdGhkcmF3YWwNCiAgLT4gQWNjb3VudCBTdGF0ZSBVbnRvdWNoZWQ6IDc1MDAwIGNlbnRzDQoNCltUeCAzIFRlc3RdIEF0dGVtcHRpbmcgZGVwb3NpdCB3aXRoIFNpbXVsYXRlZCBIYXJkd2FyZSBDcmFzaC4uLg0KICAtPiBDYXVnaHQgQ3JpdGljYWwgSGFyZHdhcmUgRXJyb3I6IERpc2sgSS9PIGZhaWx1cmUgd2hpbGUgd3JpdGluZyBhdWRpdCBlbnRyeSENCiAgLT4gU3RhdGUgcHJlc2VydmVkIHZpYSBDb3B5LWFuZC1Td2FwISBCYWxhbmNlOiA3NTAwMCBjZW50cyB8IEF1ZGl0czogMQ0KYGBgDQoNCi0tLQ0KDQojIyMgMy4yLiBQeXRob24gMy4xMSsgSW1wbGVtZW50YXRpb246IENvbnRyYWN0IERlY29yYXRvcnMgJiBUcmFuc2FjdGlvbmFsIFN0YXRlIE1hbmFnZXINCkNoxrDGoW5nIHRyw6xuaCBkxrDhu5tpIMSRw6J5IHPhu60gZOG7pW5nIEhpZ2hlci1PcmRlciBEZWNvcmF0b3JzIMSR4buDIGLhuq90IGJ14buZYyB0aOG7sWMgdGhpIFByZWNvbmRpdGlvbnMsIFBvc3Rjb25kaXRpb25zIHbDoCBDbGFzcyBJbnZhcmlhbnRzIHRyb25nIFB5dGhvbiAzLjExKywga+G6v3QgaOG7o3AgQ29udGV4dCBNYW5hZ2VyIG3DtCBwaOG7j25nIG5n4buvIG5naMSpYSBTdHJvbmcgRXhjZXB0aW9uIFNhZmV0eS4NCg0KYGBgcHl0aG9uDQpmcm9tIF9fZnV0dXJlX18gaW1wb3J0IGFubm90YXRpb25zDQppbXBvcnQgY29weQ0KaW1wb3J0IGZ1bmN0b29scw0KZnJvbSB0eXBpbmcgaW1wb3J0IENhbGxhYmxlLCBBbnksIFR5cGVWYXINCg0KRiA9IFR5cGVWYXIoIkYiLCBib3VuZD1DYWxsYWJsZVsuLi4sIEFueV0pDQoNCmNsYXNzIENvbnRyYWN0VmlvbGF0aW9uRXJyb3IoUnVudGltZUVycm9yKToNCiAgICAiIiJOw6ltIHJhIGtoaSBjw7MgdmkgcGjhuqFtIGjhu6NwIMSR4buTbmcgKERiQykuIiIiDQogICAgcGFzcw0KDQpjbGFzcyBQcmVjb25kaXRpb25FcnJvcihDb250cmFjdFZpb2xhdGlvbkVycm9yKToNCiAgICAiIiJM4buXaSB2aSBwaOG6oW0gdHLDoWNoIG5oaeG7h20gYsOqbiBn4buNaSAoQ2FsbGVyKS4iIiINCiAgICBwYXNzDQoNCmNsYXNzIFBvc3Rjb25kaXRpb25FcnJvcihDb250cmFjdFZpb2xhdGlvbkVycm9yKToNCiAgICAiIiJM4buXaSB2aSBwaOG6oW0gY2FtIGvhur90IGLDqm4gdGjhu7FjIHRoaSAoQ2FsbGVlKS4iIiINCiAgICBwYXNzDQoNCmNsYXNzIEludmFyaWFudEVycm9yKENvbnRyYWN0VmlvbGF0aW9uRXJyb3IpOg0KICAgICIiIkzhu5dpIGzDoG0gaOG7j25nIGLhuqV0IGJp4bq/biBj4bunYSB0aOG7sWMgdGjhu4MuIiIiDQogICAgcGFzcw0KDQoNCmRlZiByZXF1aXJlKHByZWRpY2F0ZTogQ2FsbGFibGVbLi4uLCBib29sXSwgZXJyb3JfbXNnOiBzdHIpIC0+IENhbGxhYmxlW1tGXSwgRl06DQogICAgIiIiRGVjb3JhdG9yIGtp4buDbSB0cmEgVGnhu4FuIMSRaeG7gXUga2nhu4duIChQcmVjb25kaXRpb24pLiIiIg0KICAgIGRlZiBkZWNvcmF0b3IoZnVuYzogRikgLT4gRjoNCiAgICAgICAgQGZ1bmN0b29scy53cmFwcyhmdW5jKQ0KICAgICAgICBkZWYgd3JhcHBlcigqYXJncywgKiprd2FyZ3MpOg0KICAgICAgICAgICAgaWYgbm90IHByZWRpY2F0ZSgqYXJncywgKiprd2FyZ3MpOg0KICAgICAgICAgICAgICAgIHJhaXNlIFByZWNvbmRpdGlvbkVycm9yKGYiUHJlY29uZGl0aW9uIEZhaWxlZCBpbiAne2Z1bmMuX19uYW1lX199Jzoge2Vycm9yX21zZ30iKQ0KICAgICAgICAgICAgcmV0dXJuIGZ1bmMoKmFyZ3MsICoqa3dhcmdzKQ0KICAgICAgICByZXR1cm4gd3JhcHBlciAgIyB0eXBlOiBpZ25vcmUNCiAgICByZXR1cm4gZGVjb3JhdG9yDQoNCg0KZGVmIGVuc3VyZShwcmVkaWNhdGU6IENhbGxhYmxlWy4uLiwgYm9vbF0sIGVycm9yX21zZzogc3RyKSAtPiBDYWxsYWJsZVtbRl0sIEZdOg0KICAgICIiIkRlY29yYXRvciBraeG7g20gdHJhIEjhuq11IMSRaeG7gXUga2nhu4duIChQb3N0Y29uZGl0aW9uKS4iIiINCiAgICBkZWYgZGVjb3JhdG9yKGZ1bmM6IEYpIC0+IEY6DQogICAgICAgIEBmdW5jdG9vbHMud3JhcHMoZnVuYykNCiAgICAgICAgZGVmIHdyYXBwZXIoKmFyZ3MsICoqa3dhcmdzKToNCiAgICAgICAgICAgIHJlc3VsdCA9IGZ1bmMoKmFyZ3MsICoqa3dhcmdzKQ0KICAgICAgICAgICAgaWYgbm90IHByZWRpY2F0ZShyZXN1bHQsICphcmdzLCAqKmt3YXJncyk6DQogICAgICAgICAgICAgICAgcmFpc2UgUG9zdGNvbmRpdGlvbkVycm9yKGYiUG9zdGNvbmRpdGlvbiBGYWlsZWQgaW4gJ3tmdW5jLl9fbmFtZV9ffSc6IHtlcnJvcl9tc2d9IikNCiAgICAgICAgICAgIHJldHVybiByZXN1bHQNCiAgICAgICAgcmV0dXJuIHdyYXBwZXIgICMgdHlwZTogaWdub3JlDQogICAgcmV0dXJuIGRlY29yYXRvcg0KDQoNCmNsYXNzIFRyYW5zYWN0aW9uYWxDb250ZXh0Og0KICAgICIiIg0KICAgIENvbnRleHQgTWFuYWdlciBo4buXIHRy4bujIFN0cm9uZyBFeGNlcHRpb24gU2FmZXR5IChSb2xsYmFjayBTZW1hbnRpY3MpLg0KICAgIE7hur91IGPDsyBleGNlcHRpb24geOG6o3kgcmEgdHJvbmcgYmxvY2sgJ3dpdGgnLCB0cuG6oW5nIHRow6FpIMSR4buRaSB0xrDhu6NuZyB04buxIMSR4buZbmcgcm9sbGJhY2suDQogICAgIiIiDQogICAgZGVmIF9faW5pdF9fKHNlbGYsIHRhcmdldF9pbnN0YW5jZTogQW55KToNCiAgICAgICAgc2VsZi5fdGFyZ2V0ID0gdGFyZ2V0X2luc3RhbmNlDQogICAgICAgIHNlbGYuX2JhY2t1cF9zdGF0ZSA9IE5vbmUNCg0KICAgIGRlZiBfX2VudGVyX18oc2VsZik6DQogICAgICAgICMgRGVlcGNvcHkgdHLhuqFuZyB0aMOhaSBiYW4gxJHhuqd1IHRyxrDhu5tjIGtoaSBiaeG6v24gxJHhu5VpDQogICAgICAgIHNlbGYuX2JhY2t1cF9zdGF0ZSA9IGNvcHkuZGVlcGNvcHkoc2VsZi5fdGFyZ2V0Ll9fZGljdF9fKQ0KICAgICAgICByZXR1cm4gc2VsZi5fdGFyZ2V0DQoNCiAgICBkZWYgX19leGl0X18oc2VsZiwgZXhjX3R5cGUsIGV4Y192YWwsIGV4Y190Yik6DQogICAgICAgIGlmIGV4Y190eXBlIGlzIG5vdCBOb25lOg0KICAgICAgICAgICAgIyBY4bqjeSByYSBs4buXaSAtPiBSb2xsYmFjayBuZ3V5w6puIHRy4bqhbmcNCiAgICAgICAgICAgIHNlbGYuX3RhcmdldC5fX2RpY3RfXy5jbGVhcigpDQogICAgICAgICAgICBzZWxmLl90YXJnZXQuX19kaWN0X18udXBkYXRlKHNlbGYuX2JhY2t1cF9zdGF0ZSkNCiAgICAgICAgICAgIHByaW50KGYiICBbVHJhbnNhY3Rpb25hbENvbnRleHRdIFJvbGxiYWNrIHRyaWdnZXJlZCEgUmV2ZXJ0ZWQgc3RhdGUgZm9yIHtzZWxmLl90YXJnZXR9IikNCiAgICAgICAgICAgICMgVHLhuqMgduG7gSBGYWxzZSDEkeG7gyBleGNlcHRpb24gdGnhur9wIHThu6VjIGxhbiB0cnV54buBbg0KICAgICAgICAgICAgcmV0dXJuIEZhbHNlDQogICAgICAgIHJldHVybiBUcnVlDQoNCg0KY2xhc3MgU2VjdXJlV2FsbGV0Og0KICAgIGRlZiBfX2luaXRfXyhzZWxmLCBvd25lcjogc3RyLCBpbml0aWFsX2JhbGFuY2U6IGZsb2F0KToNCiAgICAgICAgaWYgaW5pdGlhbF9iYWxhbmNlIDwgMC4wOg0KICAgICAgICAgICAgcmFpc2UgUHJlY29uZGl0aW9uRXJyb3IoIkluaXRpYWwgYmFsYW5jZSBjYW5ub3QgYmUgbmVnYXRpdmUiKQ0KICAgICAgICBzZWxmLm93bmVyID0gb3duZXINCiAgICAgICAgc2VsZi5iYWxhbmNlID0gaW5pdGlhbF9iYWxhbmNlDQogICAgICAgIHNlbGYudHJhbnNhY3Rpb25faGlzdG9yeTogbGlzdFtzdHJdID0gW10NCiAgICAgICAgc2VsZi5fdmVyaWZ5X2ludmFyaWFudCgpDQoNCiAgICBkZWYgX3ZlcmlmeV9pbnZhcmlhbnQoc2VsZikgLT4gTm9uZToNCiAgICAgICAgIiIiQ2xhc3MgSW52YXJpYW50OiBT4buRIGTGsCB2w60ga2jDtG5nIGJhbyBnaeG7nSDEkcaw4bujYyBuaOG7jyBoxqFuIDAuIiIiDQogICAgICAgIGlmIHNlbGYuYmFsYW5jZSA8IDAuMDoNCiAgICAgICAgICAgIHJhaXNlIEludmFyaWFudEVycm9yKGYiSW52YXJpYW50IFZpb2xhdGVkOiBCYWxhbmNlIHtzZWxmLmJhbGFuY2V9IGlzIG5lZ2F0aXZlISIpDQoNCiAgICBAcmVxdWlyZShsYW1iZGEgc2VsZiwgYW1vdW50OiBhbW91bnQgPiAwLCAiRGVwb3NpdCBhbW91bnQgbXVzdCBiZSBzdHJpY3RseSBwb3NpdGl2ZSIpDQogICAgQGVuc3VyZShsYW1iZGEgcmVzdWx0LCBzZWxmLCBhbW91bnQ6IHJlc3VsdCA9PSBzZWxmLmJhbGFuY2UsICJSZXR1cm4gdmFsdWUgbXVzdCBtYXRjaCBjdXJyZW50IGJhbGFuY2UiKQ0KICAgIGRlZiBkZXBvc2l0KHNlbGYsIGFtb3VudDogZmxvYXQpIC0+IGZsb2F0Og0KICAgICAgICBzZWxmLmJhbGFuY2UgKz0gYW1vdW50DQogICAgICAgIHNlbGYudHJhbnNhY3Rpb25faGlzdG9yeS5hcHBlbmQoZiJEZXBvc2l0OiArJHthbW91bnQ6LjJmfSIpDQogICAgICAgIHNlbGYuX3ZlcmlmeV9pbnZhcmlhbnQoKQ0KICAgICAgICByZXR1cm4gc2VsZi5iYWxhbmNlDQoNCiAgICBAcmVxdWlyZShsYW1iZGEgc2VsZiwgYW1vdW50OiBhbW91bnQgPiAwLCAiV2l0aGRyYXdhbCBhbW91bnQgbXVzdCBiZSBwb3NpdGl2ZSIpDQogICAgZGVmIHdpdGhkcmF3X2F0b21pYyhzZWxmLCBhbW91bnQ6IGZsb2F0LCBzaW11bGF0ZV9uZXR3b3JrX2Ryb3A6IGJvb2wgPSBGYWxzZSkgLT4gZmxvYXQ6DQogICAgICAgICMgU+G7rSBk4bulbmcgbmfhu68gbmdoxKlhIFN0cm9uZyBFeGNlcHRpb24gU2FmZXR5DQogICAgICAgIHdpdGggVHJhbnNhY3Rpb25hbENvbnRleHQoc2VsZik6DQogICAgICAgICAgICBpZiBhbW91bnQgPiBzZWxmLmJhbGFuY2U6DQogICAgICAgICAgICAgICAgcmFpc2UgUHJlY29uZGl0aW9uRXJyb3IoZiJJbnN1ZmZpY2llbnQgYmFsYW5jZSAoe3NlbGYuYmFsYW5jZX0pIGZvciB3aXRoZHJhd2FsIG9mIHthbW91bnR9IikNCiAgICAgICAgICAgIA0KICAgICAgICAgICAgc2VsZi5iYWxhbmNlIC09IGFtb3VudA0KICAgICAgICAgICAgc2VsZi50cmFuc2FjdGlvbl9oaXN0b3J5LmFwcGVuZChmIldpdGhkcmF3OiAtJHthbW91bnQ6LjJmfSIpDQoNCiAgICAgICAgICAgIGlmIHNpbXVsYXRlX25ldHdvcmtfZHJvcDoNCiAgICAgICAgICAgICAgICByYWlzZSBDb25uZWN0aW9uUmVzZXRFcnJvcigiQ29ubmVjdGlvbiBsb3N0IHdoaWxlIG5vdGlmeWluZyBQYXltZW50IEdhdGV3YXkhIikNCg0KICAgICAgICAgICAgc2VsZi5fdmVyaWZ5X2ludmFyaWFudCgpDQogICAgICAgICAgICByZXR1cm4gc2VsZi5iYWxhbmNlDQoNCiAgICBkZWYgX19yZXByX18oc2VsZikgLT4gc3RyOg0KICAgICAgICByZXR1cm4gZiJTZWN1cmVXYWxsZXQob3duZXI9J3tzZWxmLm93bmVyfScsIGJhbGFuY2U9JHtzZWxmLmJhbGFuY2U6LjJmfSwgdHhzPXtsZW4oc2VsZi50cmFuc2FjdGlvbl9oaXN0b3J5KX0pIg0KDQoNCmlmIF9fbmFtZV9fID09ICJfX21haW5fXyI6DQogICAgcHJpbnQoIj09PSBQeXRob24gMy4xMSsgRGVzaWduIGJ5IENvbnRyYWN0ICYgVHJhbnNhY3Rpb25hbCBTYWZldHkgRGVtbyA9PT0iKQ0KICAgIHdhbGxldCA9IFNlY3VyZVdhbGxldCgiQWxpY2UiLCAxMDAwLjApDQogICAgcHJpbnQoZiJbSW5pdF0ge3dhbGxldH0iKQ0KDQogICAgIyBDYXNlIDE6IFRoYW8gdMOhYyBiw6xuaCB0aMaw4budbmcNCiAgICB3YWxsZXQuZGVwb3NpdCg1MDAuMCkNCiAgICBwcmludChmIltEZXBvc2l0IFN1Y2Nlc3NdIHt3YWxsZXR9IikNCg0KICAgICMgQ2FzZSAyOiBWaSBwaOG6oW0gUHJlY29uZGl0aW9uDQogICAgdHJ5Og0KICAgICAgICBwcmludCgiXG5bVGVzdCBQcmVjb25kaXRpb25dIEF0dGVtcHRpbmcgbmVnYXRpdmUgZGVwb3NpdC4uLiIpDQogICAgICAgIHdhbGxldC5kZXBvc2l0KC0yMDAuMCkNCiAgICBleGNlcHQgUHJlY29uZGl0aW9uRXJyb3IgYXMgcGU6DQogICAgICAgIHByaW50KGYiICAtPiBDYXVnaHQgRXhwZWN0ZWQgUHJlY29uZGl0aW9uIEVycm9yOiB7cGV9IikNCg0KICAgICMgQ2FzZSAzOiBUaOG6pXQgYuG6oWkgZ2nhu69hIGNo4burbmcgduG7m2kgQXRvbWljIFJvbGxiYWNrIChTdHJvbmcgU2FmZXR5KQ0KICAgIHRyeToNCiAgICAgICAgcHJpbnQoIlxuW1Rlc3QgQXRvbWljIFJvbGxiYWNrXSBBdHRlbXB0aW5nICQzMDAgd2l0aGRyYXdhbCB3aXRoIG5ldHdvcmsgZXJyb3IuLi4iKQ0KICAgICAgICB3YWxsZXQud2l0aGRyYXdfYXRvbWljKDMwMC4wLCBzaW11bGF0ZV9uZXR3b3JrX2Ryb3A9VHJ1ZSkNCiAgICBleGNlcHQgQ29ubmVjdGlvblJlc2V0RXJyb3IgYXMgY2U6DQogICAgICAgIHByaW50KGYiICAtPiBDYXVnaHQgTmV0d29yayBFcnJvcjoge2NlfSIpDQogICAgICAgIHByaW50KGYiICAtPiBGaW5hbCBXYWxsZXQgU3RhdGUgVW50b3VjaGVkOiB7d2FsbGV0fSIpDQpgYGANCg0KIyMjIyBUZXJtaW5hbCBPdXRwdXQgTeG6q3UgKFB5dGhvbiAzLjExKyk6DQpgYGB0ZXh0DQo9PT0gUHl0aG9uIDMuMTErIERlc2lnbiBieSBDb250cmFjdCAmIFRyYW5zYWN0aW9uYWwgU2FmZXR5IERlbW8gPT09DQpbSW5pdF0gU2VjdXJlV2FsbGV0KG93bmVyPSdBbGljZScsIGJhbGFuY2U9JDEwMDAuMDAsIHR4cz0wKQ0KW0RlcG9zaXQgU3VjY2Vzc10gU2VjdXJlV2FsbGV0KG93bmVyPSdBbGljZScsIGJhbGFuY2U9JDE1MDAuMDAsIHR4cz0xKQ0KDQpbVGVzdCBQcmVjb25kaXRpb25dIEF0dGVtcHRpbmcgbmVnYXRpdmUgZGVwb3NpdC4uLg0KICAtPiBDYXVnaHQgRXhwZWN0ZWQgUHJlY29uZGl0aW9uIEVycm9yOiBQcmVjb25kaXRpb24gRmFpbGVkIGluICdkZXBvc2l0JzogRGVwb3NpdCBhbW91bnQgbXVzdCBiZSBzdHJpY3RseSBwb3NpdGl2ZQ0KDQpbVGVzdCBBdG9taWMgUm9sbGJhY2tdIEF0dGVtcHRpbmcgJDMwMCB3aXRoZHJhd2FsIHdpdGggbmV0d29yayBlcnJvci4uLg0KICBbVHJhbnNhY3Rpb25hbENvbnRleHRdIFJvbGxiYWNrIHRyaWdnZXJlZCEgUmV2ZXJ0ZWQgc3RhdGUgZm9yIFNlY3VyZVdhbGxldChvd25lcj0nQWxpY2UnLCBiYWxhbmNlPSQxMjAwLjAwLCB0eHM9MikNCiAgLT4gQ2F1Z2h0IE5ldHdvcmsgRXJyb3I6IENvbm5lY3Rpb24gbG9zdCB3aGlsZSBub3RpZnlpbmcgUGF5bWVudCBHYXRld2F5IQ0KICAtPiBGaW5hbCBXYWxsZXQgU3RhdGUgVW50b3VjaGVkOiBTZWN1cmVXYWxsZXQob3duZXI9J0FsaWNlJywgYmFsYW5jZT0kMTUwMC4wMCwgdHhzPTEpDQpgYGANCg0KLS0tDQoNCiMjIDQuIFN5c3RlbXMgRW5naW5lZXJpbmcgJiBQcm9kdWN0aW9uIFBpdGZhbGxzDQoNCiMjIyBDw6FjIEPhuqFtIELhuqt5IFRo4buxYyBDaGnhur9uIChHb3RjaGFzICYgUHJvZHVjdGlvbiBBbnRpcGF0dGVybnMpDQoNCjEuICoqRXhjZXB0aW9uIFRocm93biBpbnNpZGUgRGVzdHJ1Y3RvciBjYXVzaW5nIGBzdGQ6OnRlcm1pbmF0ZWAqKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IFRyb25nIEMrKywgbuG6v3UgbeG7mXQgZXhjZXB0aW9uIG7huqN5IHNpbmggdHJvbmcgaMOgbSBo4buneSAoZGVzdHJ1Y3RvcikgdHJvbmcga2hpIMSRYW5nIGRp4buFbiByYSBxdcOhIHRyw6xuaCB1bndpbmRpbmcgc3RhY2sgY+G7p2EgbeG7mXQgZXhjZXB0aW9uIGtow6FjLCBydW50aW1lIHPhur0gZ+G7jWkgbmdheSBs4bqtcCB04bupYyBgc3RkOjp0ZXJtaW5hdGUoKWAuIFRvw6BuIGLhu5kg4bupbmcgZOG7pW5nIGNo4bq/dCBuZ2F5IGzhuq1wIHThu6ljIG3DoCBraMO0bmcgZ2hpIMSRxrDhu6NjIGxvZy4NCiAgIC0gKkto4bqvYyBwaOG7pWMqOiBN4buNaSBkZXN0cnVjdG9yIG3hurdjIMSR4buLbmggbMOgIGBub2V4Y2VwdCh0cnVlKWAuIE7hur91IGRlc3RydWN0b3IgY+G6p24gxJHDs25nIHTDoGkgbmd1ecOqbiBjw7Mgbmd1eSBjxqEgbOG7l2kgKG5oxrAgYGZjbG9zZWAgaG/hurdjIGBzb2NrZXQuY2xvc2UoKWApLCBwaOG6o2kgdOG7sSBi4bqvdCB2w6AgbnXhu5F0IGV4Y2VwdGlvbiBob+G6t2MgZ2hpIGxvZyB04bqhaSBjaOG7lyBiw6puIHRyb25nIGRlc3RydWN0b3IuDQoNCjIuICoqU+G7sSDEkcOhbmggxJHhu5VpIHbhu4EgY2hpIHBow60gYuG7mSBuaOG7myBj4bunYSBDb3B5LWFuZC1Td2FwKio6DQogICAtICpC4bqjbiBjaOG6pXQqOiDEkOG7gyDEkeG6oXQgxJHGsOG7o2MgU3Ryb25nIEV4Y2VwdGlvbiBTYWZldHksIGvhu7kgdGh14bqtdCBDb3B5LWFuZC1Td2FwIGLhuq90IGJ14buZYyBwaOG6o2kgY+G6pXAgcGjDoXQgbeG7mXQgYuG6o24gc2FvIMSR4buZYyBs4bqtcCBj4bunYSDEkeG7kWkgdMaw4bujbmcuIE7hur91IMSR4buRaSB0xrDhu6NuZyDEkWFuZyBu4bqvbSBnaeG7ryAkMlwsXHRleHR7R0J9JCBi4buZIG5o4bubIMSR4buHbSB0cm9uZyBSQU0sIHZp4buHYyB04bqhbyBi4bqjbiBzYW8gc+G6vSB0acOqdSB04buRbiB0aMOqbSAkMlwsXHRleHR7R0J9JCBSQU0gdOG6oW0gdGjhu51pIHbDoCBnw6J5IMOhcCBs4buxYyBsw6puIEdhcmJhZ2UgQ29sbGVjdG9yIGhv4bq3YyBDUFUgTWVtb3J5IEJ1cy4NCiAgIC0gKkto4bqvYyBwaOG7pWMqOiBW4bubaSBjw6FjIGPhuqV1IHRyw7pjIGThu68gbGnhu4d1IGto4buVbmcgbOG7kywgc+G7rSBk4bulbmcgKipQZXJzaXN0ZW50IERhdGEgU3RydWN0dXJlcyoqIChuaMawIEZpbmdlciBUcmVlcywgSEFNVCkgaG/hurdjIGvhu7kgdGh14bqtdCAqKldyaXRlLUFoZWFkIExvZ2dpbmcgKFdBTCkqKiB2w6AgKipVbmRvIExvZyoqIHTGsMahbmcgdOG7sSBjxqEgc+G7nyBk4buvIGxp4buHdSB0aGF5IHbDrCBzYW8gY2jDqXAgdG/DoG4gYuG7mSB0aOG7sWMgdGjhu4MuDQoNCjMuICoqTOG6oW0gZOG7pW5nIEFzc2VydGlvbnMgdGhheSBjaG8gSW5wdXQgVmFsaWRhdGlvbiDhu58gUHVibGljIEJvdW5kYXJpZXMqKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IEzhuq1wIHRyw6xuaCB2acOqbiBuaOG6p20gbOG6q24gZ2nhu69hIGtp4buDbSB0cmEgUHJlY29uZGl0aW9uIHRyb25nIERiQyB2w6Aga2nhu4NtIHRyYSBk4buvIGxp4buHdSDEkeG6p3UgdsOgbyB04burIG5nxrDhu51pIGTDuW5nIChJbnB1dCBWYWxpZGF0aW9uKS4gTOG7h25oIGBhc3NlcnQoKWAgdGjGsOG7nW5nIGLhu4sgbG/huqFpIGLhu48ga2hpIGNvbXBpbGUg4bufIGPhu50gYC1PM2AgaG/hurdjIGBOREVCVUdgLiBO4bq/dSBkw7luZyBgYXNzZXJ0YCDEkeG7gyBraeG7g20gdHJhIHJlcXVlc3QgcGF5bG9hZCB04burIFJFU1QgQVBJLCBraGkgbMOqbiBtw7RpIHRyxrDhu51uZyBQcm9kdWN0aW9uLCBo4buHIHRo4buRbmcgc+G6vSBi4buPIHF1YSB0b8OgbiBi4buZIHZp4buHYyBraeG7g20gdHJhLCBk4bqrbiDEkeG6v24gU1FMIEluamVjdGlvbiBob+G6t2MgUmVtb3RlIENvZGUgRXhlY3V0aW9uLg0KICAgLSAqS2jhuq9jIHBo4bulYyo6IFBow6JuIGNoaWEgcsO1IHLDoG5nOiBEw7luZyBJbnB1dCBWYWxpZGF0aW9uICh0aHJvdyBgSW52YWxpZEFyZ3VtZW50RXhjZXB0aW9uYCBob+G6t2MgdHLhuqMgduG7gSBgSFRUUCA0MDBgKSB04bqhaSBBUEkgR2F0ZXdheS9Db250cm9sbGVyOyBjaOG7iSBkw7luZyBgYXNzZXJ0YCBjaG8gY8OhYyBi4bqldCBiaeG6v24gbuG7mWkgYuG7mSB2w6AgaMOgbSBwcml2YXRlIGPhu6dhIERvbWFpbiBMb2dpYy4NCg0KNC4gKipL4bu5IHRodeG6rXQgQ2jhuqluIMSRb8OhbiAmIERlYnVnZ2luZyBi4bqxbmcgQ0xJKio6DQogICBgYGBiYXNoDQogICAjIDEuIFBow6F0IGhp4buHbiBNZW1vcnkgTGVhayB2w6AgcsOyIHLhu4kgdMOgaSBuZ3V5w6puIGtoaSBjw7MgRXhjZXB0aW9uIG7DqW0gcmEgYuG6sW5nIFZhbGdyaW5kDQogICB2YWxncmluZCAtLWxlYWstY2hlY2s9ZnVsbCAtLXNob3ctbGVhay1raW5kcz1hbGwgLS10cmFjay1vcmlnaW5zPXllcyAuL3Jlc2lsaWVudF9zZXJ2aWNlDQoNCiAgICMgMi4gVHJ1eSB24bq/dCDEkWnhu4NtIGvDrWNoIGhv4bqhdCBzdGQ6OnRlcm1pbmF0ZSBraGkgbsOpbSBleGNlcHRpb24gdHJvbmcgZGVzdHJ1Y3RvciBi4bqxbmcgR0RCDQogICBnZGIgLi9yZXNpbGllbnRfc2VydmljZQ0KICAgKGdkYikgY2F0Y2ggdGhyb3cNCiAgIChnZGIpIGNhdGNoIHRlcm1pbmF0ZQ0KICAgKGdkYikgcnVuDQogICAoZ2RiKSBidCBmdWxsDQoNCiAgICMgMy4gS2nhu4NtIHRyYSBjw6FjIGjDoG0gdmkgcGjhuqFtIGNhbSBr4bq/dCBub2V4Y2VwdCBi4bqxbmcgQ2xhbmctVGlkeQ0KICAgY2xhbmctdGlkeSBzcmMvcmVzaWxpZW50X2FjY291bnQuY3BwIC1jaGVja3M9ImJ1Z3Byb25lLWV4Y2VwdGlvbi1lc2NhcGUsbW9kZXJuaXplLXVzZS1ub2V4Y2VwdCIgLS0gLXN0ZD1jKysyMA0KICAgYGBgDQoNCi0tLQ0KDQojIyA1LiBC4bqjbmcgU28gc8OhbmggJiBEZWNpc2lvbiBNYXRyaXgNCg0KIyMjIDUuMS4gTWEgdHLhuq1uIEPDoWMgQ+G6pXAgxJHhu5kgQW4gdG/DoG4gTmdv4bqhaSBs4buHIChFeGNlcHRpb24gU2FmZXR5IFNwZWN0cnVtKQ0KDQp8IFRpw6p1IGNow60gfCBObyBTYWZldHkgfCBCYXNpYyBHdWFyYW50ZWUgfCBTdHJvbmcgR3VhcmFudGVlIHwgTm8tdGhyb3cgKE5vdGhyb3cpIHwNCnwgOi0tLSB8IDotLS0gfCA6LS0tIHwgOi0tLSB8IDotLS0gfA0KfCAqKlLDsiBy4buJIFTDoGkgbmd1ecOqbiAoTGVha3MpKiogfCBDw7MgdGjhu4MgeOG6o3kgcmEgfCAqKlR1eeG7h3QgxJHhu5FpIGtow7RuZyoqIHwgKipUdXnhu4d0IMSR4buRaSBraMO0bmcqKiB8ICoqVHV54buHdCDEkeG7kWkga2jDtG5nKiogfA0KfCAqKlTDrW5oIGjhu6NwIGzhu4cgY+G7p2EgxJDhu5FpIHTGsOG7o25nKiogfCBC4buLIGjGsCBo4buPbmcgKENvcnJ1cHRlZCkgfCBMdcO0biBo4bujcCBs4buHIChWYWxpZCBzdGF0ZSkgfCBMdcO0biBo4bujcCBs4buHIChWYWxpZCBzdGF0ZSkgfCBMdcO0biBo4bujcCBs4buHIChWYWxpZCBzdGF0ZSkgfA0KfCAqKkThu68gbGnhu4d1IGtoaSBn4bq3cCBs4buXaSoqIHwgS2jDtG5nIHjDoWMgxJHhu4tuaCB8IEPDsyB0aOG7gyBi4buLIHRoYXkgxJHhu5VpIGThu58gZGFuZyB8IEdp4buvIG5ndXnDqm4gdHLhuqFuZyAxMDAlIHwgS2jDtG5nIGJhbyBnaeG7nSB44bqjeSByYSBs4buXaSB8DQp8ICoqQ2hpIHBow60gVGjhu7FjIHRoaSAoT3ZlcmhlYWQpKiogfCBUaOG6pXAgbmjhuqV0IHwgVGjhuqVwIChjaOG7iSBj4bqnbiBSQUlJKSB8IFRydW5nIGLDrG5oIC8gQ2FvIChDb3B5IHN0YXRlKSB8IFRo4bqlcCBuaOG6pXQgKEtow7RuZyBjw7MgY29kZSB1bndpbmRpbmcpIHwNCnwgKipDxqEgY2jhur8gS+G7uSB0aHXhuq10KiogfCBDb24gdHLhu48gdGjDtCwgbWFudWFsIGRlbGV0ZSB8IFNtYXJ0IFBvaW50ZXJzIChgc3RkOjp1bmlxdWVfcHRyYCksIFJBSUkgfCBDb3B5LWFuZC1Td2FwLCBUcmFuc2FjdGlvbnMgfCBgbm9leGNlcHRgLCBgc3RkOjptb3ZlYCwgYHN3YXBgIHwNCnwgKipUcsaw4budbmcgaOG7o3Agw4FwIGThu6VuZyoqIHwgTcOjIGxlZ2FjeSBjxakgKEPhuqVtIGTDuW5nKSB8IE3hu41pIGjDoG0gbeG6t2MgxJHhu4tuaCB0cm9uZyBo4buHIHRo4buRbmcgfCBHaWFvIGThu4tjaCB0w6BpIGNow61uaCwgY2h1eeG7g24ga2hv4bqjbiwgREIgfCBEZXN0cnVjdG9ycywgU3dhcHMsIE1vdmUgQ3RvcnMgfA0KDQojIyMgNS4yLiBTbyBzw6FuaCBUcmnhur90IGzDvTogRGJDIHZzIERlZmVuc2l2ZSB2cyBUb2xlcmFudCBSZWFkZXINCg0KfCDEkOG6t2MgdHLGsG5nIHwgRGVzaWduIGJ5IENvbnRyYWN0IChEYkMpIHwgRGVmZW5zaXZlIFByb2dyYW1taW5nIHwgVG9sZXJhbnQgUmVhZGVyIFBhdHRlcm4gfA0KfCA6LS0tIHwgOi0tLSB8IDotLS0gfCA6LS0tIHwNCnwgKipLaOG6qXUgaGnhu4d1KiogfCAiVGluIHTGsOG7n25nIHRoZW8gaOG7o3AgxJHhu5NuZywgc2FpIGzDoCBwaOG6oXQiIHwgIktow7RuZyB0aW4gYuG6pXQga+G7syBhaSwgdOG7sSBi4bqjbyB24buHIG3DrG5oIiB8ICJOaOG6rW4gdsOgbyBk4buFIGTDo2ksIHh14bqldCByYSBraOG6r3Qga2hlIiB8DQp8ICoqTeG7pWMgdGnDqnUgY2jDrW5oKiogfCBQaMOhdCBoaeG7h24gYnVnIG5oYW5oIG5o4bqldCAoRmFpbC1GYXN0KSB8IEdp4buvIHRp4bq/biB0csOsbmgga2jDtG5nIGLhu4sgY3Jhc2ggfCBUxrDGoW5nIHRow61jaCBuZ8aw4bujYyBwaGnDqm4gYuG6o24gZOG7ryBsaeG7h3UgfA0KfCAqKlbhu4sgdHLDrSBsw70gdMaw4bufbmcqKiB8IEzDtWkgbmdoaeG7h3AgduG7pSAoRG9tYWluIExheWVyKSwgU2hhcmVkIExpYnJhcmllcyB8IFB1YmxpYyBBUEkgR2F0ZXdheSwgTmV0d29yayBEZXNlcmlhbGl6ZXIgfCBNZXNzYWdlIFF1ZXVlIENvbnN1bWVycywgTWljcm9zZXJ2aWNlIEV2ZW50cyB8DQp8ICoqTmjGsOG7o2MgxJFp4buDbSoqIHwgxJDDsmkgaOG7j2kgdMawIGR1eSB0aGnhur90IGvhur8ga2jhuq90IGtoZSBiYW4gxJHhuqd1IHwgQ2hlIGdp4bqldSBidWcgdGnhu4FtIOG6qW4sIHNpbmggcmEgem9tYmllIHN0YXRlIHwgQ8OzIHRo4buDIGLhu48gc8OzdCBjw6FjIHRyxrDhu51uZyBk4buvIGxp4buHdSBzYWkgbOG7h2NoIHwNCg==