Chế độ giao diện
13.1. Kỹ Nghệ Xử Lý Lỗi và Mô Hình Lan Truyền Lỗi (Error Handling Models & Propagation)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Lỗi trong hệ thống phần mềm không phải là một sự kiện ngoại lệ bất thường mà là một phần tất yếu của luồng nghiệp vụ; một hệ thống phần mềm đẳng cấp là hệ thống buộc lỗi phải hiển thị tường minh trong hợp đồng hàm (Result/Expected Types), bảo toàn chuỗi ngữ cảnh nguyên nhân gốc rễ (Root Cause Preservation), và thiết lập các Ranh giới cô lập lỗi (Error Boundaries) để lỗi tại một thành phần không bao giờ có thể đánh sập toàn bộ tiến trình.
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
1.1. Phép loại suy thực tế: Vách Ngăn Kín Nước Tàu Ngầm và Quy Trình Sơ Tán Tòa Nhà
Để hình dung rõ nét cách một hệ thống phân tán đối phó với lỗi, hãy quan sát hai hình ảnh thực tế:
Vách ngăn kín nước của Tàu ngầm Hải quân (Error Boundaries):
- Một chiếc tàu ngầm quân sự khi lặn dưới đáy biển sâu hàng nghìn mét không bao giờ giả định rằng vỏ tàu sẽ vĩnh viễn không bị thủng. Thay vào đó, thân tàu được chia thành hàng chục khoang độc lập ngăn cách bởi các cửa thép thủy lực kín nước (Watertight Bulkheads / Error Boundaries).
- Nếu ngư lôi bắn thủng khoang máy số 3, cảm biến phát hiện nước tràn và lập tức sập cửa thép khoang đó lại. Khoang số 3 bị hy sinh (cô lập lỗi), nhưng nước không thể tràn sang khoang chỉ huy và khoang động cơ. Con tàu vẫn giữ được sức nổi và đưa thủy thủ đoàn trở về căn cứ an toàn.
- Trong phần mềm, nếu một request phân tích ảnh AI của một người dùng bị lỗi tràn bộ đệm (Out-of-memory), Error Boundary sẽ bắt lấy lỗi đó, trả về mã lỗi
500cho riêng người dùng đó, và để hàng triệu người dùng khác tiếp tục giao dịch bình thường.
Quy trình Sơ tán Tòa nhà Báo cháy (Graceful Shutdown):
- Khi có chuông báo cháy reo trong một tòa tháp văn phòng, bảo vệ không lập tức cắt điện toàn bộ tòa nhà và khóa chặt cửa thoát hiểm (đó là hành vi của
SIGKILL). - Thay vào đó, hệ thống kích hoạt chế độ sơ tán êm dịu (Graceful Shutdown -
SIGTERM):- Ngừng tiếp nhận khách mới vào sảnh (Ngắt Pod khỏi Service Endpoints của Load Balancer).
- Phát loa hướng dẫn những người đang ở bên trong bình tĩnh di chuyển ra cửa thoát hiểm (Xử lý dở các HTTP request đang dang dở - Inflight Requests).
- Các thang máy tự động di chuyển về tầng trệt, mở cửa và khóa lại (Đóng an toàn Database Connection Pools và File Sockets).
- Chỉ khi toàn bộ người đã ra ngoài hoặc hết thời gian chờ khẩn cấp (
), điện tòa nhà mới chính thức được ngắt hoàn toàn.
- Khi có chuông báo cháy reo trong một tòa tháp văn phòng, bảo vệ không lập tức cắt điện toàn bộ tòa nhà và khóa chặt cửa thoát hiểm (đó là hành vi của
sequenceDiagram
autonumber
participant K8s as Kubernetes Control Plane
participant LB as Ingress / Cloud Load Balancer
participant Pod as Application Pod (Worker)
participant DB as PostgreSQL Database Pool
Note over K8s,Pod: BẮT ĐẦU QUY TRÌNH GRACEFUL SHUTDOWN
K8s->>Pod: 1. Gửi tín hiệu OS: SIGTERM
K8s->>LB: 2. Gỡ bỏ IP Pod khỏi Service Endpoints
LB-->>LB: 3. Ngừng điều phối Request mới vào Pod
Note over Pod: Pod chuyển sang trạng thái DRAINING
Pod->>Pod: 4. Chờ hoàn tất các Request đang xử lý (Inflight Requests)
Pod-->>LB: 5. Trả kết quả thành công cho các Inflight Requests cuối cùng
Note over Pod,DB: ĐÓNG CÁC KẾT NỐI HẠ TẦNG
Pod->>DB: 6. Flush bộ đệm ghi và đóng Connection Pool
DB-->>Pod: 7. Xác nhận Connection Pool đã đóng an toàn
alt Pod hoàn tất trước thời hạn (ví dụ: mất 5s)
Pod->>K8s: 8a. Tiến trình tự thoát an toàn: Exit 0
else Vượt quá terminationGracePeriodSeconds (ví dụ: 30s)
K8s->>Pod: 8b. Cưỡng chế tiêu diệt ngay lập tức: SIGKILL (Exit 137)
end
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Error Models: Exceptions vs Result Types vs Panic/Recover
Trong lịch sử khoa học máy tính và kỹ nghệ phần mềm hiện đại, có 3 mô hình xử lý lỗi chính:
- Exception Handling (Ném và Bắt ngoại lệ -
try/catch/throw):- Ngôn ngữ tiêu biểu: Java, C++, C#, Python.
- Bản chất cơ học: Khi một ngoại lệ được
throw, luồng điều khiển nhảy cóc phi tuần tự (Non-local Jump) xuyên qua hàng chục khung ngăn xếp (Stack Frames) để tìm khốicatchphù hợp. Quá trình này đòi hỏi cơ chế Stack Unwinding, đọc các bảng bảng ngoại lệ DWARF/RTTI trong bộ nhớ, làm tiêu hao tài nguyên CPU cực lớn. - Vấn đề kiến trúc: Tạo ra "luồng điều khiển vô hình" (Hidden Control Flow). Đọc chữ ký hàm
User getUser(id)không cho ta biết hàm này có thể ném ra những lỗi gì, dẫn đến việc lập trình viên quên bắt lỗi và làm sập ứng dụng.
- Result / Expected Types (C++23
std::expected<T, E>, RustResult<T, E>):- Bản chất: Lỗi được xem là một giá trị trả về bình thường (Value-based Error). Hàm không ném ra cái gì cả, mà trả về một kiểu dữ liệu Union chứa hoặc là dữ liệu thành công (
), hoặc là đối tượng lỗi ( ). - Ưu điểm tuyệt đối:
- Không tiêu tốn tài nguyên (Zero-Overhead): Không có Stack Unwinding, hiệu năng tương đương việc trả về một struct thông thường.
- Bắt buộc lúc biên dịch (Compile-time Enforcement): Lập trình viên không thể truy cập vào dữ liệu
nếu chưa viết code kiểm tra trường hợp lỗi . - Monadic Chaining: Hỗ trợ các toán tử biến đổi hàm mượt mà (
and_then,or_else,map).
- Bản chất: Lỗi được xem là một giá trị trả về bình thường (Value-based Error). Hàm không ném ra cái gì cả, mà trả về một kiểu dữ liệu Union chứa hoặc là dữ liệu thành công (
- Panic and Recover (Go / Erlang):
- Triết lý Erlang / Joe Armstrong: "Let it crash" (Hãy để nó sụp đổ). Đừng cố gắng viết hàng nghìn dòng code để phòng thủ mọi lỗi ngớ ngẩn. Nếu xảy ra lỗi nghiêm trọng vi phạm bộ nhớ, hãy để tiến trình nhẹ (Actor/Goroutine) đó chết ngay lập tức, và một bộ giám sát (Supervisor Tree) sẽ khởi động lại nó từ trạng thái sạch.
- Go model:
panicchỉ dùng cho các lỗi lập trình bất khả kháng (Programming Bugs như chia cho 0, truy cập mảng ngoài giới hạn), còn các lỗi nghiệp vụ thông thường (Network timeout, File not found) bắt buộc phải trả về giá trịerror.
2.2. Structured Errors (Lỗi có cấu trúc & Chuẩn RFC 7807)
- Bản chất: Lỗi trong hệ thống phân tán không bao giờ được phép là một chuỗi ký tự mơ hồ (như
"Something went wrong"). Lỗi phải được cấu trúc hóa dưới dạng đối tượng có thể phân tích cú pháp bằng máy (Machine-Readable). - Chuẩn công nghiệp: RFC 7807 - Problem Details for HTTP APIs:
- Khi một API gặp sự cố, nó trả về mã phản hồi HTTP cùng với Payload JSON chuẩn tắc:json
{ "type": "https://api.example.com/errors/insufficient-funds", "title": "Insufficient Funds in Account", "status": 402, "detail": "Your balance of $12.50 is lower than the transaction amount of $45.00.", "instance": "/accounts/acc_9921/transfers/txn_004", "code": "ERR_PAYMENT_BALANCE_TOO_LOW", "trace_id": "c4b8e8f2a10d9c4e" }1
2
3
4
5
6
7
8
9 - Lợi ích: Giúp các hệ thống Frontend, API Gateway và máy chủ giám sát Log tự động nhận diện và phân loại mã lỗi mà không cần phải dùng biểu thức chính quy (Regex) quét chữ trong thông báo.
- Khi một API gặp sự cố, nó trả về mã phản hồi HTTP cùng với Payload JSON chuẩn tắc:
2.3. Error Propagation & Context Wrapping (Lan truyền và Bọc ngữ cảnh)
- Bản chất bài toán: Khi một lỗi xảy ra ở tầng sâu nhất (ví dụ: Hàm mở kết nối socket TCP của Database ném ra lỗi
connection refused), làm thế nào để khi lỗi nổi lên tới tầng API Controller của người dùng, chúng ta vẫn biết chính xác ngữ cảnh nghiệp vụ mà không làm mất dấu vết kỹ thuật ban đầu? - Kỹ thuật Bọc chuỗi lỗi (Causal Error Chains / Error Wrapping):
- Mỗi tầng kiến trúc khi bắt được lỗi cấp dưới sẽ bọc (wrap) nó trong một ngữ cảnh nghiệp vụ mới:
- Tầng Repository:
DbConnectError: connection refused - Tầng Service:
UserServiceError: failed to fetch user 99 -> DbConnectError: connection refused - Tầng Controller:
CheckoutError: cannot complete payment -> UserServiceError -> DbConnectError
- Tầng Repository:
- Chuỗi nguyên nhân gốc rễ (Root Cause) luôn được bảo toàn nguyên vẹn để kỹ sư điều tra trong log, trong khi tầng giao diện người dùng chỉ nhận được thông báo ngắn gọn thân thiện.
- Mỗi tầng kiến trúc khi bắt được lỗi cấp dưới sẽ bọc (wrap) nó trong một ngữ cảnh nghiệp vụ mới:
2.4. Error Boundaries (Ranh giới cô lập lỗi)
- Bản chất kiến trúc: Là một hàng rào phòng thủ được dựng lên tại các nút giao thông quan trọng của phần mềm nhằm chặn đứng sự lây lan của lỗi.
- Ứng dụng thực chiến:
- Trong Background Worker / Message Queue Consumer: Một consumer đọc tin nhắn từ RabbitMQ hoặc Kafka. Nếu tin nhắn bị lỗi cú pháp gây crash mã nguồn, Error Boundary sẽ bắt lấy ngoại lệ, ghi log, đẩy tin nhắn lỗi đó sang Dead Letter Queue (DLQ) để xử lý sau, và tiếp tục đọc tin nhắn tiếp theo mà không làm tê liệt toàn bộ worker.
- Trong Web UI (React Error Boundaries): Nếu một widget quảng cáo bên góc phải màn hình bị lỗi crash JavaScript, Error Boundary sẽ chỉ thay thế widget đó bằng một khung trống, toàn bộ trang thương mại điện tử và nút bấm "Thanh Toán" vẫn hoạt động bình thường.
2.5. Graceful Shutdown (Tắt máy êm dịu chuẩn OS & Kubernetes)
- Các tín hiệu hệ điều hành (POSIX Signals):
SIGINT(Signal Interrupt - Mã 2): Kích hoạt khi người dùng gõCtrl + Ctrên bàn phím.SIGTERM(Signal Terminate - Mã 15): Tín hiệu chuẩn do Kubernetes / Docker gửi tới tiến trình để yêu cầu tắt máy có trật tự. Tiến trình có thể bắt và xử lý tín hiệu này.SIGKILL(Signal Kill - Mã 9): Tín hiệu cưỡng chế tức thì từ hạt nhân Linux (Kernel). Tiến trình bị tiêu diệt ngay lập tức mà không có cơ hội chạy bất kỳ dòng code dọn dẹp nào.
- Quy trình Graceful Shutdown chuẩn mực:
- Đăng ký hàm lắng nghe tín hiệu
SIGTERM. - Khi nhận tín hiệu, ngừng ngay lập tức việc nhận các kết nối mạng mới (
server.close()). - Cấp một khoảng thời gian chờ tối đa (Draining Timeout - ví dụ:
) để các yêu cầu đang thực thi (Inflight Requests) kịp hoàn tất và trả phản hồi về cho khách hàng. - Đóng an toàn các tài nguyên ngoại vi: Ngắt các consumer của Message Queue, đóng kết nối Redis, flush toàn bộ dữ liệu ghi đệm của cơ sở dữ liệu.
- Gọi hàm thoát tiến trình
exit(0).
- Đăng ký hàm lắng nghe tín hiệu
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. Động cơ C++20: Zero-Overhead Result/Expected Monadic Error Engine
Chương trình C++20 dưới đây xây dựng một hệ thống Xử lý Lỗi Hướng Giá Trị (Value-Based Error Handling) tương tự như std::expected (C++23) hoặc Result<T, E> trong Rust:
- Đảm bảo Zero Dynamic Memory Allocation khi xử lý lỗi.
- Hỗ trợ chuỗi biến đổi hàm Monadic (
and_then). - Cấu trúc lỗi mang mã định danh (Error Code), thông điệp và nhãn thời gian chi tiết.
cpp
#include <iostream>
#include <string>
#include <variant>
#include <functional>
#include <optional>
#include <iomanip>
namespace core_error {
// Định nghĩa mã lỗi định danh chuẩn hệ thống
enum class ErrorCode {
NONE = 0,
VALIDATION_FAILED,
RESOURCE_NOT_FOUND,
INSUFFICIENT_FUNDS,
DOWNSTREAM_TIMEOUT
};
struct AppError {
ErrorCode code;
std::string message;
std::string context;
void log() const {
std::cerr << "\033[31m[ERROR LOG]\033[0m Code: " << static_cast<int>(code)
<< " | Msg: " << message
<< " | Context: " << context << "\n";
}
};
// C++20 Value-based Result Container (Tương tự std::expected)
template <typename T>
class Result {
private:
std::variant<T, AppError> storage_;
public:
// Khởi tạo trạng thái Thành công
Result(T value) : storage_(std::move(value)) {}
// Khởi tạo trạng thái Thất bại
Result(AppError error) : storage_(std::move(error)) {}
bool has_value() const {
return std::holds_alternative<T>(storage_);
}
const T& value() const {
return std::get<T>(storage_);
}
const AppError& error() const {
return std::get<AppError>(storage_);
}
// Monadic Chaining Operator: and_then
template <typename Func>
auto and_then(Func&& func) -> decltype(func(std::declval<T>())) {
using ReturnType = decltype(func(std::declval<T>()));
if (has_value()) {
return func(value());
} else {
return ReturnType(error());
}
}
};
// Các đối tượng thực thể nghiệp vụ
struct Account {
int64_t id;
double balance;
};
struct TransferReceipt {
std::string transaction_id;
int64_t from_id;
int64_t to_id;
double amount;
};
// Pipeline xử lý nghiệp vụ qua chuỗi Result Monadic
class BankTransferService {
public:
static Result<Account> findAccount(int64_t account_id) {
std::cout << " -> Step 1: Querying account " << account_id << "...\n";
if (account_id == 404) {
return AppError{ErrorCode::RESOURCE_NOT_FOUND, "Account does not exist", "id=404"};
}
return Account{account_id, 150.0}; // Số dư giả lập $150
}
static Result<Account> verifySufficientBalance(Account acc, double amount) {
std::cout << " -> Step 2: Verifying balance for account " << acc.id << " (Amount: $" << amount << ")...\n";
if (acc.balance < amount) {
return AppError{
ErrorCode::INSUFFICIENT_FUNDS,
"Current balance $" + std::to_string(acc.balance) + " is less than required $" + std::to_string(amount),
"accountId=" + std::to_string(acc.id)
};
}
return acc;
}
static Result<TransferReceipt> executeTransfer(Account from_acc, int64_t to_id, double amount) {
std::cout << " -> Step 3: Executing ledger deduction...\n";
return TransferReceipt{"TXN_2026_ABCD99", from_acc.id, to_id, amount};
}
};
} // namespace core_error
int main() {
using namespace core_error;
std::cout << "=======================================================\n";
std::cout << ">>> 1. VALUE-BASED ERROR HANDLING (HAPPY PATH) <<<\n";
std::cout << "=======================================================\n";
// Thực thi chuỗi Monadic mượt mà: find -> verify -> transfer
auto transfer_result = BankTransferService::findAccount(101)
.and_then([](Account acc) {
return BankTransferService::verifySufficientBalance(acc, 50.0);
})
.and_then([](Account acc) {
return BankTransferService::executeTransfer(acc, 202, 50.0);
});
if (transfer_result.has_value()) {
const auto& receipt = transfer_result.value();
std::cout << "\033[32m[TRANSFER SUCCESS]\033[0m Transaction ID: " << receipt.transaction_id
<< " | Transferred $" << receipt.amount << " from " << receipt.from_id
<< " to " << receipt.to_id << "\n";
} else {
transfer_result.error().log();
}
std::cout << "\n=======================================================\n";
std::cout << ">>> 2. VALUE-BASED ERROR HANDLING (FAILURE PATH) <<<\n";
std::cout << "=======================================================\n";
// Thực thi với số tiền vượt quá số dư ($500 > $150)
auto failed_result = BankTransferService::findAccount(101)
.and_then([](Account acc) {
return BankTransferService::verifySufficientBalance(acc, 500.0); // Thất bại ở đây
})
.and_then([](Account acc) {
return BankTransferService::executeTransfer(acc, 202, 500.0); // Bước này tự động bị bỏ qua
});
if (failed_result.has_value()) {
std::cout << "Success!\n";
} else {
std::cout << "Pipeline aborted safely without throwing exceptions.\n";
failed_result.error().log();
}
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
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
3.2. Động cơ Python 3.11+: Production Graceful Shutdown Coordinator & RFC 7807 Engine
Chương trình Python 3.11+ dưới đây mô phỏng một Tiến trình Dịch vụ Production có khả năng:
- Đăng ký và xử lý tín hiệu hệ điều hành
SIGINTvàSIGTERM. - Chuyển sang trạng thái "Draining": Từ chối request mới nhưng xử lý xong toàn bộ các request đang nằm trong hàng đợi.
- Chuẩn hóa và sinh phản hồi lỗi theo đặc tả RFC 7807 Problem Details.
python
#!/usr/bin/env python3
"""
Production Graceful Shutdown & RFC 7807 Problem Details Engine (Python 3.11+)
Bảo đảm tính toàn vẹn của kết nối hạ tầng khi Kubernetes xóa Pod.
"""
from __future__ import annotations
import asyncio
import dataclasses
import json
import signal
import sys
import time
from typing import Dict, Any, Optional, Set
@dataclasses.dataclass(frozen=True)
class RFC7807ProblemDetail:
type_uri: str
title: str
status: int
detail: str
instance: str
error_code: str
trace_id: str
def to_json(self) -> str:
return json.dumps({
"type": self.type_uri,
"title": self.title,
"status": self.status,
"detail": self.detail,
"instance": self.instance,
"code": self.error_code,
"trace_id": self.trace_id,
"timestamp": time.time()
}, indent=2)
class ResilientHttpServer:
def __init__(self, port: int = 8080, shutdown_timeout_sec: float = 5.0):
self.port = port
self.shutdown_timeout_sec = shutdown_timeout_sec
self.is_accepting_traffic = True
self.active_tasks: Set[asyncio.Task] = set()
self.shutdown_event = asyncio.Event()
def setup_signal_handlers(self) -> None:
loop = asyncio.get_running_loop()
for sig in (signal.SIGTERM, signal.SIGINT):
loop.add_signal_handler(sig, lambda s=sig: asyncio.create_task(self.handle_shutdown_signal(s)))
async def handle_shutdown_signal(self, sig: signal.Signals) -> None:
print(f"\n\033[33m[SIGNAL RECEIVED]\033[0m Caught signal {sig.name} ({sig.value}). Starting Graceful Shutdown...")
# 1. Ngừng chấp nhận request mới ngay lập tức
self.is_accepting_traffic = False
print(" 🚫 Stopped accepting new incoming HTTP requests (Load Balancer draining initiated).")
# 2. Chờ các inflight requests hoàn thành
print(f" ⏳ Waiting for {len(self.active_tasks)} active inflight tasks to finish (Timeout: {self.shutdown_timeout_sec}s)...")
start_wait = time.monotonic()
while self.active_tasks:
elapsed = time.monotonic() - start_wait
if elapsed >= self.shutdown_timeout_sec:
print(f" \033[31m[TIMEOUT]\033[0m Exceeded {self.shutdown_timeout_sec}s! Cancelling remaining {len(self.active_tasks)} tasks.")
for t in self.active_tasks:
t.cancel()
break
await asyncio.sleep(0.1)
# 3. Đóng các tài nguyên hạ tầng
print(" 🔌 Closing Database Connection Pool and Redis Cache sockets...")
await asyncio.sleep(0.2) # Giả lập đóng DB connection pool
print("\033[32m[SHUTDOWN COMPLETE]\033[0m All resources safely liberated. Exiting cleanly with code 0.")
self.shutdown_event.set()
async def handle_mock_request(self, req_id: str, client_ip: str, duration_sec: float) -> str:
if not self.is_accepting_traffic:
# Nếu đang trong quá trình shutdown, từ chối và trả về HTTP 503
problem = RFC7807ProblemDetail(
type_uri="https://api.system.internal/errors/service-unavailable",
title="Service Undergoing Graceful Shutdown",
status=503,
detail="Server is draining connections in preparation for pod termination.",
instance=f"/orders/{req_id}",
error_code="ERR_SERVER_DRAINING",
trace_id="trc_9981a2b"
)
return problem.to_json()
# Đăng ký task vào tập hợp các tác vụ đang chạy
current_task = asyncio.current_task()
self.active_tasks.add(current_task)
try:
print(f" [HTTP REQ START] Processing Request {req_id} ({duration_sec}s)...")
await asyncio.sleep(duration_sec)
print(f" \033[32m[HTTP REQ DONE]\033[0m Finished Request {req_id} successfully.")
return json.dumps({"status": "SUCCESS", "request_id": req_id})
except asyncio.CancelledError:
print(f" \033[31m[HTTP REQ ABORTED]\033[0m Request {req_id} was forcefully cancelled due to shutdown timeout.")
raise
finally:
self.active_tasks.discard(current_task)
async def main():
server = ResilientHttpServer(shutdown_timeout_sec=2.0)
server.setup_signal_handlers()
print("===========================================================================")
print(f"🚀 HTTP SERVER ACTIVE ON PORT {server.port} | PID: {signal.os.getpid()}")
print("===========================================================================")
# Giả lập luồng request gửi đến
task1 = asyncio.create_task(server.handle_mock_request("REQ-001", "192.168.1.10", 0.5))
task2 = asyncio.create_task(server.handle_mock_request("REQ-002", "192.168.1.11", 1.2))
# Đợi 0.3s rồi giả lập tín hiệu SIGTERM từ Kubernetes
await asyncio.sleep(0.3)
await server.handle_shutdown_signal(signal.SIGTERM)
# Thử gửi 1 request mới khi đang shutdown -> Bị từ chối bằng RFC 7807 payload
rejected_response = await server.handle_mock_request("REQ-003-LATE", "192.168.1.99", 0.5)
print("\n--- REJECTED RESPONSE PAYLOAD (RFC 7807) ---")
print(rejected_response)
await asyncio.gather(task1, task2, return_exceptions=True)
if __name__ == "__main__":
asyncio.run(main())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
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
3.3. Terminal Output Thực Tế Giả Lập
text
===========================================================================
🚀 HTTP SERVER ACTIVE ON PORT 8080 | PID: 48921
===========================================================================
[HTTP REQ START] Processing Request REQ-001 (0.5s)...
[HTTP REQ START] Processing Request REQ-002 (1.2s)...
[SIGNAL RECEIVED] Caught signal SIGTERM (15). Starting Graceful Shutdown...
🚫 Stopped accepting new incoming HTTP requests (Load Balancer draining initiated).
⏳ Waiting for 2 active inflight tasks to finish (Timeout: 2.0s)...
[HTTP REQ DONE] Finished Request REQ-001 successfully.
[HTTP REQ DONE] Finished Request REQ-002 successfully.
🔌 Closing Database Connection Pool and Redis Cache sockets...
[SHUTDOWN COMPLETE] All resources safely liberated. Exiting cleanly with code 0.
--- REJECTED RESPONSE PAYLOAD (RFC 7807) ---
{
"type": "https://api.system.internal/errors/service-unavailable",
"title": "Service Undergoing Graceful Shutdown",
"status": 503,
"detail": "Server is draining connections in preparation for pod termination.",
"instance": "/orders/REQ-003-LATE",
"code": "ERR_SERVER_DRAINING",
"trace_id": "trc_9981a2b",
"timestamp": 1731728400.12
}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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
4. Systems Engineering & Production Pitfalls
4.1. Production Failure Modes trong Kỹ nghệ Xử Lý Lỗi
Pokemon Exception Handling (Nuốt lỗi bằng
catch (Exception e) {}):- Bản chất: Lập trình viên viết khối
try ... catch(Exception e)chung chung nhưng để trống phần thân hoặc chỉ in ra dòng logSystem.out.println("Error"). - Hậu quả: Ngoại lệ bị nuốt chửng hoàn toàn, che giấu các lỗi nghiêm trọng như cạn kiệt bộ nhớ hoặc gãy kết nối mạng. Hệ thống tiếp tục chạy trong trạng thái dữ liệu bị hỏng (Corrupted State), tạo ra những lỗi dữ liệu cực kỳ khó debug.
- Biện pháp: Luôn định danh rõ ngoại lệ cụ thể, và nếu không xử lý được thì bắt buộc phải bọc lỗi và re-throw hoặc trả về Result Error.
- Bản chất: Lập trình viên viết khối
Log Injection qua Unescaped Error Messages:
- Bản chất: Lấy trực tiếp dữ liệu đầu vào của người dùng (ví dụ: tên đăng nhập chứa ký tự ngắt dòng
\n\r) và in thẳng vào thông báo lỗi:logger.error("User " + username + " failed to login"). - Rủi ro an ninh: Kẻ tấn công có thể chèn các dòng log giả mạo để đánh lừa kỹ sư điều tra hoặc thao túng các công cụ phân tích SIEM tự động.
- Bản chất: Lấy trực tiếp dữ liệu đầu vào của người dùng (ví dụ: tên đăng nhập chứa ký tự ngắt dòng
Kubernetes
SIGKILLTàn Sát Dữ Liệu do Thiếu Graceful Shutdown:- Bản chất: Ứng dụng không khai báo trình xử lý
SIGTERMhoặc thời gian dọn dẹp vượt quá giá trịterminationGracePeriodSeconds(mặc định ). - Hậu quả: Kubernetes bắn
SIGKILL(Mã 137). Tiến trình bị tiêu diệt ngay lập tức giữa lúc đang ghi dở file hoặc đang thực hiện dở giao dịch thanh toán ngân hàng, để lại các bản ghi mồ côi (Orphan Records) trong database.
- Bản chất: Ứng dụng không khai báo trình xử lý
5. Bảng So sánh & Decision Matrix
5.1. Bảng so sánh 3 triết lý xử lý lỗi
| Tiêu Chí So Sánh | Ném Ngoại Lệ (Exceptions) | Kiểu Dữ Liệu Result (Result/Expected) | Let-it-Crash (Panic/Supervision) |
|---|---|---|---|
| Chi phí thực thi | Rất cao (Stack Unwinding) | Bằng 0 (Zero-Overhead) | Thấp khi chạy bình thường |
| Tính tường minh trong code | Thấp (ẩn giấu trong hàm) | Tối đa (nằm trong chữ ký hàm) | Trung bình |
| Bảo đảm của Trình biên dịch | Không (hoặc phiền phức như Java) | Bắt buộc xử lý trước khi lấy giá trị | Bắt buộc thông qua phục hồi |
| Dòng điều khiển | Nhảy cóc phi tuyến tính | Tuần tự, có thể xâu chuỗi Monadic | Ngắt tiến trình |
| Ngôn ngữ tiêu biểu | Java, C#, Python | Rust, C++23, Swift, Haskell | Erlang, Elixir, Go |
5.2. Decision Matrix: Khi nào nên sử dụng mô hình nào?
flowchart TD
ErrorNature{Bản chất của sự cố là gì?}
ErrorNature -->|Lỗi lập trình nghiêm trọng: Nil Pointer, Mảng ngoài biên| Panic[Panic / Let-it-crash: Dừng ngay để tránh hỏng dữ liệu]
ErrorNature -->|Lỗi nghiệp vụ dự kiến: Sai mật khẩu, Hết tiền, Không tìm thấy| Expected[Result / Expected Pattern: Zero-Overhead, định kiểu chặt chẽ]
ErrorNature -->|Giao tiếp qua HTTP REST / gRPC API| RFC[Chuẩn hóa Payload theo RFC 7807 Problem Details]
ErrorNature -->|Nhận tín hiệu dừng từ Hệ điều hành SIGTERM| Graceful[Graceful Shutdown: Draining connections trong 30s]
IyAxMy4xLiBL4bu5IE5naOG7hyBY4butIEzDvSBM4buXaSB2w6AgTcO0IEjDrG5oIExhbiBUcnV54buBbiBM4buXaSAoRXJyb3IgSGFuZGxpbmcgTW9kZWxzICYgUHJvcGFnYXRpb24pDQoNCj4gWyFJTVBPUlRBTlRdDQo+ICoqTuG6v3UgYuG6oW4gY2jhu4kgxJHGsOG7o2Mgbmjhu5sgbeG7mXQgxJFp4buBdSBkdXkgbmjhuqV0OioqIEzhu5dpIHRyb25nIGjhu4cgdGjhu5FuZyBwaOG6p24gbeG7gW0ga2jDtG5nIHBo4bqjaSBsw6AgbeG7mXQgc+G7sSBraeG7h24gbmdv4bqhaSBs4buHIGLhuqV0IHRoxrDhu51uZyBtw6AgbMOgICoqbeG7mXQgcGjhuqduIHThuqV0IHnhur91IGPhu6dhIGx14buTbmcgbmdoaeG7h3AgduG7pSoqOyBt4buZdCBo4buHIHRo4buRbmcgcGjhuqduIG3hu4FtIMSR4bqzbmcgY+G6pXAgbMOgIGjhu4cgdGjhu5FuZyAqKmJ14buZYyBs4buXaSBwaOG6o2kgaGnhu4NuIHRo4buLIHTGsOG7nW5nIG1pbmggdHJvbmcgaOG7o3AgxJHhu5NuZyBow6BtIChSZXN1bHQvRXhwZWN0ZWQgVHlwZXMpKiosIGLhuqNvIHRvw6BuIGNodeG7l2kgbmfhu68gY+G6o25oIG5ndXnDqm4gbmjDom4gZ+G7kWMgcuG7hSAoUm9vdCBDYXVzZSBQcmVzZXJ2YXRpb24pLCB2w6AgdGhp4bq/dCBs4bqtcCBjw6FjICoqUmFuaCBnaeG7m2kgY8O0IGzhuq1wIGzhu5dpIChFcnJvciBCb3VuZGFyaWVzKSoqIMSR4buDIGzhu5dpIHThuqFpIG3hu5l0IHRow6BuaCBwaOG6p24ga2jDtG5nIGJhbyBnaeG7nSBjw7MgdGjhu4MgxJHDoW5oIHPhuq1wIHRvw6BuIGLhu5kgdGnhur9uIHRyw6xuaC4NCg0KLS0tDQoNCiMjIDEuIEtp4bq/biB0csO6YyBU4buVbmcgcXVhbiAmIE3DtCBow6xuaCBUxrAgZHV5IChNZW50YWwgTW9kZWwpDQoNCiMjIyAxLjEuIFBow6lwIGxv4bqhaSBzdXkgdGjhu7FjIHThur86IFbDoWNoIE5nxINuIEvDrW4gTsaw4bubYyBUw6B1IE5n4bqnbSB2w6AgUXV5IFRyw6xuaCBTxqEgVMOhbiBUw7JhIE5ow6ANCsSQ4buDIGjDrG5oIGR1bmcgcsO1IG7DqXQgY8OhY2ggbeG7mXQgaOG7hyB0aOG7kW5nIHBow6JuIHTDoW4gxJHhu5FpIHBow7MgduG7m2kgbOG7l2ksIGjDo3kgcXVhbiBzw6F0IGhhaSBow6xuaCDhuqNuaCB0aOG7sWMgdOG6vzoNCg0KMS4gKipWw6FjaCBuZ8SDbiBrw61uIG7GsOG7m2MgY+G7p2EgVMOgdSBuZ+G6p20gSOG6o2kgcXXDom4gKEVycm9yIEJvdW5kYXJpZXMpKio6DQogICAtIE3hu5l0IGNoaeG6v2MgdMOgdSBuZ+G6p20gcXXDom4gc+G7sSBraGkgbOG6t24gZMaw4bubaSDEkcOheSBiaeG7g24gc8OidSBow6BuZyBuZ2jDrG4gbcOpdCBraMO0bmcgYmFvIGdp4budIGdp4bqjIMSR4buLbmggcuG6sW5nIHbhu48gdMOgdSBz4bq9IHbEqW5oIHZp4buFbiBraMO0bmcgYuG7iyB0aOG7p25nLiBUaGF5IHbDoG8gxJHDsywgdGjDom4gdMOgdSDEkcaw4bujYyBjaGlhIHRow6BuaCBow6BuZyBjaOG7pWMga2hvYW5nIMSR4buZYyBs4bqtcCBuZ8SDbiBjw6FjaCBi4bufaSBjw6FjIGPhu61hIHRow6lwIHRo4buneSBs4buxYyBrw61uIG7GsOG7m2MgKCoqV2F0ZXJ0aWdodCBCdWxraGVhZHMgLyBFcnJvciBCb3VuZGFyaWVzKiopLg0KICAgLSBO4bq/dSBuZ8awIGzDtGkgYuG6r24gdGjhu6duZyBraG9hbmcgbcOheSBz4buRIDMsIGPhuqNtIGJp4bq/biBwaMOhdCBoaeG7h24gbsaw4bubYyB0csOgbiB2w6AgbOG6rXAgdOG7qWMgc+G6rXAgY+G7rWEgdGjDqXAga2hvYW5nIMSRw7MgbOG6oWkuIEtob2FuZyBz4buRIDMgYuG7iyBoeSBzaW5oIChjw7QgbOG6rXAgbOG7l2kpLCBuaMawbmcgbsaw4bubYyBraMO0bmcgdGjhu4MgdHLDoG4gc2FuZyBraG9hbmcgY2jhu4kgaHV5IHbDoCBraG9hbmcgxJHhu5luZyBjxqEuIENvbiB0w6B1IHbhuqtuIGdp4buvIMSRxrDhu6NjIHPhu6ljIG7hu5VpIHbDoCDEkcawYSB0aOG7p3kgdGjhu6cgxJFvw6BuIHRy4bufIHbhu4EgY8SDbiBj4bupIGFuIHRvw6BuLg0KICAgLSBUcm9uZyBwaOG6p24gbeG7gW0sIG7hur91IG3hu5l0IHJlcXVlc3QgcGjDom4gdMOtY2gg4bqjbmggQUkgY+G7p2EgbeG7mXQgbmfGsOG7nWkgZMO5bmcgYuG7iyBs4buXaSB0csOgbiBi4buZIMSR4buHbSAoT3V0LW9mLW1lbW9yeSksIEVycm9yIEJvdW5kYXJ5IHPhur0gYuG6r3QgbOG6pXkgbOG7l2kgxJHDsywgdHLhuqMgduG7gSBtw6MgbOG7l2kgYDUwMGAgY2hvIHJpw6puZyBuZ8aw4budaSBkw7luZyDEkcOzLCB2w6AgxJHhu4MgaMOgbmcgdHJp4buHdSBuZ8aw4budaSBkw7luZyBraMOhYyB0aeG6v3AgdOG7pWMgZ2lhbyBk4buLY2ggYsOsbmggdGjGsOG7nW5nLg0KDQoyLiAqKlF1eSB0csOsbmggU8ahIHTDoW4gVMOyYSBuaMOgIELDoW8gY2jDoXkgKEdyYWNlZnVsIFNodXRkb3duKSoqOg0KICAgLSBLaGkgY8OzIGNodcO0bmcgYsOhbyBjaMOheSByZW8gdHJvbmcgbeG7mXQgdMOyYSB0aMOhcCB2xINuIHBow7JuZywgYuG6o28gduG7hyBraMO0bmcgbOG6rXAgdOG7qWMgY+G6r3QgxJFp4buHbiB0b8OgbiBi4buZIHTDsmEgbmjDoCB2w6Aga2jDs2EgY2jhurd0IGPhu61hIHRob8OhdCBoaeG7g20gKMSRw7MgbMOgIGjDoG5oIHZpIGPhu6dhIGBTSUdLSUxMYCkuDQogICAtIFRoYXkgdsOgbyDEkcOzLCBo4buHIHRo4buRbmcga8OtY2ggaG/huqF0IGNo4bq/IMSR4buZIHPGoSB0w6FuIMOqbSBk4buLdSAoKipHcmFjZWZ1bCBTaHV0ZG93biAtIGBTSUdURVJNYCoqKToNCiAgICAgLSBOZ+G7q25nIHRp4bq/cCBuaOG6rW4ga2jDoWNoIG3hu5tpIHbDoG8gc+G6o25oIChOZ+G6r3QgUG9kIGto4buPaSBTZXJ2aWNlIEVuZHBvaW50cyBj4bunYSBMb2FkIEJhbGFuY2VyKS4NCiAgICAgLSBQaMOhdCBsb2EgaMaw4bubbmcgZOG6q24gbmjhu69uZyBuZ8aw4budaSDEkWFuZyDhu58gYsOqbiB0cm9uZyBiw6xuaCB0xKluaCBkaSBjaHV54buDbiByYSBj4butYSB0aG/DoXQgaGnhu4NtIChY4butIGzDvSBk4bufIGPDoWMgSFRUUCByZXF1ZXN0IMSRYW5nIGRhbmcgZOG7nyAtIEluZmxpZ2h0IFJlcXVlc3RzKS4NCiAgICAgLSBDw6FjIHRoYW5nIG3DoXkgdOG7sSDEkeG7mW5nIGRpIGNodXnhu4NuIHbhu4EgdOG6p25nIHRy4buHdCwgbeG7nyBj4butYSB2w6Aga2jDs2EgbOG6oWkgKMSQw7NuZyBhbiB0b8OgbiBEYXRhYmFzZSBDb25uZWN0aW9uIFBvb2xzIHbDoCBGaWxlIFNvY2tldHMpLg0KICAgICAtIENo4buJIGtoaSB0b8OgbiBi4buZIG5nxrDhu51pIMSRw6MgcmEgbmdvw6BpIGhv4bq3YyBo4bq/dCB0aOG7nWkgZ2lhbiBjaOG7nSBraOG6qW4gY+G6pXAgKCQzMFx0ZXh0eyBnacOieX0kKSwgxJFp4buHbiB0w7JhIG5ow6AgbeG7m2kgY2jDrW5oIHRo4bupYyDEkcaw4bujYyBuZ+G6r3QgaG/DoG4gdG/DoG4uDQoNCmBgYG1lcm1haWQNCnNlcXVlbmNlRGlhZ3JhbQ0KICAgIGF1dG9udW1iZXINCiAgICBwYXJ0aWNpcGFudCBLOHMgYXMgS3ViZXJuZXRlcyBDb250cm9sIFBsYW5lDQogICAgcGFydGljaXBhbnQgTEIgYXMgSW5ncmVzcyAvIENsb3VkIExvYWQgQmFsYW5jZXINCiAgICBwYXJ0aWNpcGFudCBQb2QgYXMgQXBwbGljYXRpb24gUG9kIChXb3JrZXIpDQogICAgcGFydGljaXBhbnQgREIgYXMgUG9zdGdyZVNRTCBEYXRhYmFzZSBQb29sDQoNCiAgICBOb3RlIG92ZXIgSzhzLFBvZDogQuG6rlQgxJDhuqZVIFFVWSBUUsOMTkggR1JBQ0VGVUwgU0hVVERPV04NCiAgICBLOHMtPj5Qb2Q6IDEuIEfhu61pIHTDrW4gaGnhu4d1IE9TOiBTSUdURVJNDQogICAgSzhzLT4+TEI6IDIuIEfhu6EgYuG7jyBJUCBQb2Qga2jhu49pIFNlcnZpY2UgRW5kcG9pbnRzDQogICAgTEItLT4+TEI6IDMuIE5n4burbmcgxJFp4buBdSBwaOG7kWkgUmVxdWVzdCBt4bubaSB2w6BvIFBvZA0KDQogICAgTm90ZSBvdmVyIFBvZDogUG9kIGNodXnhu4NuIHNhbmcgdHLhuqFuZyB0aMOhaSBEUkFJTklORw0KICAgIFBvZC0+PlBvZDogNC4gQ2jhu50gaG/DoG4gdOG6pXQgY8OhYyBSZXF1ZXN0IMSRYW5nIHjhu60gbMO9IChJbmZsaWdodCBSZXF1ZXN0cykNCiAgICBQb2QtLT4+TEI6IDUuIFRy4bqjIGvhur90IHF14bqjIHRow6BuaCBjw7RuZyBjaG8gY8OhYyBJbmZsaWdodCBSZXF1ZXN0cyBjdeG7kWkgY8O5bmcNCg0KICAgIE5vdGUgb3ZlciBQb2QsREI6IMSQw5NORyBDw4FDIEvhur5UIE7hu5BJIEjhuqAgVOG6pk5HDQogICAgUG9kLT4+REI6IDYuIEZsdXNoIGLhu5kgxJHhu4dtIGdoaSB2w6AgxJHDs25nIENvbm5lY3Rpb24gUG9vbA0KICAgIERCLS0+PlBvZDogNy4gWMOhYyBuaOG6rW4gQ29ubmVjdGlvbiBQb29sIMSRw6MgxJHDs25nIGFuIHRvw6BuDQoNCiAgICBhbHQgUG9kIGhvw6BuIHThuqV0IHRyxrDhu5tjIHRo4budaSBo4bqhbiAodsOtIGThu6U6IG3huqV0IDVzKQ0KICAgICAgICBQb2QtPj5LOHM6IDhhLiBUaeG6v24gdHLDrG5oIHThu7EgdGhvw6F0IGFuIHRvw6BuOiBFeGl0IDANCiAgICBlbHNlIFbGsOG7o3QgcXXDoSB0ZXJtaW5hdGlvbkdyYWNlUGVyaW9kU2Vjb25kcyAodsOtIGThu6U6IDMwcykNCiAgICAgICAgSzhzLT4+UG9kOiA4Yi4gQ8aw4buhbmcgY2jhur8gdGnDqnUgZGnhu4d0IG5nYXkgbOG6rXAgdOG7qWM6IFNJR0tJTEwgKEV4aXQgMTM3KQ0KICAgIGVuZA0KYGBgDQoNCi0tLQ0KDQojIyAyLiBDaGkgdGnhur90IHThu6tuZyBLZXl3b3JkIChVbmRlci10aGUtSG9vZCBEZWVwIERpdmUpDQoNCiMjIyAyLjEuIEVycm9yIE1vZGVsczogRXhjZXB0aW9ucyB2cyBSZXN1bHQgVHlwZXMgdnMgUGFuaWMvUmVjb3Zlcg0KVHJvbmcgbOG7i2NoIHPhu60ga2hvYSBo4buNYyBtw6F5IHTDrW5oIHbDoCBr4bu5IG5naOG7hyBwaOG6p24gbeG7gW0gaGnhu4duIMSR4bqhaSwgY8OzIDMgbcO0IGjDrG5oIHjhu60gbMO9IGzhu5dpIGNow61uaDoNCg0KMS4gKipFeGNlcHRpb24gSGFuZGxpbmcgKE7DqW0gdsOgIELhuq90IG5nb+G6oWkgbOG7hyAtIGB0cnkvY2F0Y2gvdGhyb3dgKSoqOg0KICAgLSAqTmfDtG4gbmfhu68gdGnDqnUgYmnhu4N1KjogSmF2YSwgQysrLCBDIywgUHl0aG9uLg0KICAgLSAqQuG6o24gY2jhuqV0IGPGoSBo4buNYyo6IEtoaSBt4buZdCBuZ2/huqFpIGzhu4cgxJHGsOG7o2MgYHRocm93YCwgbHXhu5NuZyDEkWnhu4F1IGtoaeG7g24gbmjhuqN5IGPDs2MgcGhpIHR14bqnbiB04buxICgqKk5vbi1sb2NhbCBKdW1wKiopIHh1ecOqbiBxdWEgaMOgbmcgY2jhu6VjIGtodW5nIG5nxINuIHjhur9wIChTdGFjayBGcmFtZXMpIMSR4buDIHTDrG0ga2jhu5FpIGBjYXRjaGAgcGjDuSBo4bujcC4gUXXDoSB0csOsbmggbsOgeSDEkcOyaSBo4buPaSBjxqEgY2jhur8gKipTdGFjayBVbndpbmRpbmcqKiwgxJHhu41jIGPDoWMgYuG6o25nIGLhuqNuZyBuZ2/huqFpIGzhu4cgRFdBUkYvUlRUSSB0cm9uZyBi4buZIG5o4bubLCBsw6BtIHRpw6p1IGhhbyB0w6BpIG5ndXnDqm4gQ1BVIGPhu7FjIGzhu5tuLg0KICAgLSAqVuG6pW4gxJHhu4Ega2nhur9uIHRyw7pjKjogVOG6oW8gcmEgImx14buTbmcgxJFp4buBdSBraGnhu4NuIHbDtCBow6xuaCIgKEhpZGRlbiBDb250cm9sIEZsb3cpLiDEkOG7jWMgY2jhu68ga8O9IGjDoG0gYFVzZXIgZ2V0VXNlcihpZClgIGtow7RuZyBjaG8gdGEgYmnhur90IGjDoG0gbsOgeSBjw7MgdGjhu4MgbsOpbSByYSBuaOG7r25nIGzhu5dpIGfDrCwgZOG6q24gxJHhur9uIHZp4buHYyBs4bqtcCB0csOsbmggdmnDqm4gcXXDqm4gYuG6r3QgbOG7l2kgdsOgIGzDoG0gc+G6rXAg4bupbmcgZOG7pW5nLg0KMi4gKipSZXN1bHQgLyBFeHBlY3RlZCBUeXBlcyAoQysrMjMgYHN0ZDo6ZXhwZWN0ZWQ8VCwgRT5gLCBSdXN0IGBSZXN1bHQ8VCwgRT5gKSoqOg0KICAgLSAqQuG6o24gY2jhuqV0KjogTOG7l2kgxJHGsOG7o2MgeGVtIGzDoCBt4buZdCAqKmdpw6EgdHLhu4sgdHLhuqMgduG7gSBiw6xuaCB0aMaw4budbmcgKFZhbHVlLWJhc2VkIEVycm9yKSoqLiBIw6BtIGtow7RuZyBuw6ltIHJhIGPDoWkgZ8OsIGPhuqMsIG3DoCB0cuG6oyB24buBIG3hu5l0IGtp4buDdSBk4buvIGxp4buHdSBVbmlvbiBjaOG7qWEgaG/hurdjIGzDoCBk4buvIGxp4buHdSB0aMOgbmggY8O0bmcgKCRUJCksIGhv4bq3YyBsw6AgxJHhu5FpIHTGsOG7o25nIGzhu5dpICgkRSQpLg0KICAgLSAqxq91IMSRaeG7g20gdHV54buHdCDEkeG7kWkqOg0KICAgICAtICoqS2jDtG5nIHRpw6p1IHThu5FuIHTDoGkgbmd1ecOqbiAoWmVyby1PdmVyaGVhZCkqKjogS2jDtG5nIGPDsyBTdGFjayBVbndpbmRpbmcsIGhp4buHdSBuxINuZyB0xrDGoW5nIMSRxrDGoW5nIHZp4buHYyB0cuG6oyB24buBIG3hu5l0IHN0cnVjdCB0aMO0bmcgdGjGsOG7nW5nLg0KICAgICAtICoqQuG6r3QgYnXhu5ljIGzDumMgYmnDqm4gZOG7i2NoIChDb21waWxlLXRpbWUgRW5mb3JjZW1lbnQpKio6IEzhuq1wIHRyw6xuaCB2acOqbiBraMO0bmcgdGjhu4MgdHJ1eSBj4bqtcCB2w6BvIGThu68gbGnhu4d1ICRUJCBu4bq/dSBjaMawYSB2aeG6v3QgY29kZSBraeG7g20gdHJhIHRyxrDhu51uZyBo4bujcCBs4buXaSAkRSQuDQogICAgIC0gKipNb25hZGljIENoYWluaW5nKio6IEjhu5cgdHLhu6MgY8OhYyB0b8OhbiB04butIGJp4bq/biDEkeG7lWkgaMOgbSBtxrDhu6N0IG3DoCAoYGFuZF90aGVuYCwgYG9yX2Vsc2VgLCBgbWFwYCkuDQozLiAqKlBhbmljIGFuZCBSZWNvdmVyIChHbyAvIEVybGFuZykqKjoNCiAgIC0gKlRyaeG6v3QgbMO9IEVybGFuZyAvIEpvZSBBcm1zdHJvbmcqOiAqKiJMZXQgaXQgY3Jhc2giKiogKEjDo3kgxJHhu4MgbsOzIHPhu6VwIMSR4buVKS4gxJDhu6tuZyBj4buRIGfhuq9uZyB2aeG6v3QgaMOgbmcgbmdow6xuIGTDsm5nIGNvZGUgxJHhu4MgcGjDsm5nIHRo4bunIG3hu41pIGzhu5dpIG5n4bubIG5n4bqpbi4gTuG6v3UgeOG6o3kgcmEgbOG7l2kgbmdoacOqbSB0cuG7jW5nIHZpIHBo4bqhbSBi4buZIG5o4bubLCBow6N5IMSR4buDIHRp4bq/biB0csOsbmggbmjhurkgKEFjdG9yL0dvcm91dGluZSkgxJHDsyBjaOG6v3QgbmdheSBs4bqtcCB04bupYywgdsOgIG3hu5l0IGLhu5kgZ2nDoW0gc8OhdCAoKipTdXBlcnZpc29yIFRyZWUqKikgc+G6vSBraOG7n2kgxJHhu5luZyBs4bqhaSBuw7MgdOG7qyB0cuG6oW5nIHRow6FpIHPhuqFjaC4NCiAgIC0gKkdvIG1vZGVsKjogYHBhbmljYCBjaOG7iSBkw7luZyBjaG8gY8OhYyBs4buXaSBs4bqtcCB0csOsbmggYuG6pXQga2jhuqMga2jDoW5nIChQcm9ncmFtbWluZyBCdWdzIG5oxrAgY2hpYSBjaG8gMCwgdHJ1eSBj4bqtcCBt4bqjbmcgbmdvw6BpIGdp4bubaSBo4bqhbiksIGPDsm4gY8OhYyBs4buXaSBuZ2hp4buHcCB24bulIHRow7RuZyB0aMaw4budbmcgKE5ldHdvcmsgdGltZW91dCwgRmlsZSBub3QgZm91bmQpIGLhuq90IGJ14buZYyBwaOG6o2kgdHLhuqMgduG7gSBnacOhIHRy4buLIGBlcnJvcmAuDQoNCiMjIyAyLjIuIFN0cnVjdHVyZWQgRXJyb3JzIChM4buXaSBjw7MgY+G6pXUgdHLDumMgJiBDaHXhuqluIFJGQyA3ODA3KQ0KLSAqKkLhuqNuIGNo4bqldCoqOiBM4buXaSB0cm9uZyBo4buHIHRo4buRbmcgcGjDom4gdMOhbiBraMO0bmcgYmFvIGdp4budIMSRxrDhu6NjIHBow6lwIGzDoCBt4buZdCBjaHXhu5dpIGvDvSB04buxIG3GoSBo4buTIChuaMawIGAiU29tZXRoaW5nIHdlbnQgd3JvbmciYCkuIEzhu5dpIHBo4bqjaSDEkcaw4bujYyBj4bqldSB0csO6YyBow7NhIGTGsOG7m2kgZOG6oW5nIMSR4buRaSB0xrDhu6NuZyBjw7MgdGjhu4MgcGjDom4gdMOtY2ggY8O6IHBow6FwIGLhurFuZyBtw6F5IChNYWNoaW5lLVJlYWRhYmxlKS4NCi0gKipDaHXhuqluIGPDtG5nIG5naGnhu4dwOiBSRkMgNzgwNyAtIFByb2JsZW0gRGV0YWlscyBmb3IgSFRUUCBBUElzKio6DQogIC0gS2hpIG3hu5l0IEFQSSBn4bq3cCBz4buxIGPhu5EsIG7DsyB0cuG6oyB24buBIG3DoyBwaOG6o24gaOG7k2kgSFRUUCBjw7luZyB24bubaSBQYXlsb2FkIEpTT04gY2h14bqpbiB04bqvYzoNCiAgICBgYGBqc29uDQogICAgew0KICAgICAgInR5cGUiOiAiaHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vZXJyb3JzL2luc3VmZmljaWVudC1mdW5kcyIsDQogICAgICAidGl0bGUiOiAiSW5zdWZmaWNpZW50IEZ1bmRzIGluIEFjY291bnQiLA0KICAgICAgInN0YXR1cyI6IDQwMiwNCiAgICAgICJkZXRhaWwiOiAiWW91ciBiYWxhbmNlIG9mICQxMi41MCBpcyBsb3dlciB0aGFuIHRoZSB0cmFuc2FjdGlvbiBhbW91bnQgb2YgJDQ1LjAwLiIsDQogICAgICAiaW5zdGFuY2UiOiAiL2FjY291bnRzL2FjY185OTIxL3RyYW5zZmVycy90eG5fMDA0IiwNCiAgICAgICJjb2RlIjogIkVSUl9QQVlNRU5UX0JBTEFOQ0VfVE9PX0xPVyIsDQogICAgICAidHJhY2VfaWQiOiAiYzRiOGU4ZjJhMTBkOWM0ZSINCiAgICB9DQogICAgYGBgDQogIC0gKipM4bujaSDDrWNoKio6IEdpw7pwIGPDoWMgaOG7hyB0aOG7kW5nIEZyb250ZW5kLCBBUEkgR2F0ZXdheSB2w6AgbcOheSBjaOG7pyBnacOhbSBzw6F0IExvZyB04buxIMSR4buZbmcgbmjhuq1uIGRp4buHbiB2w6AgcGjDom4gbG/huqFpIG3DoyBs4buXaSBtw6Aga2jDtG5nIGPhuqduIHBo4bqjaSBkw7luZyBiaeG7g3UgdGjhu6ljIGNow61uaCBxdXkgKFJlZ2V4KSBxdcOpdCBjaOG7ryB0cm9uZyB0aMO0bmcgYsOhby4NCg0KIyMjIDIuMy4gRXJyb3IgUHJvcGFnYXRpb24gJiBDb250ZXh0IFdyYXBwaW5nIChMYW4gdHJ1eeG7gW4gdsOgIELhu41jIG5n4buvIGPhuqNuaCkNCi0gKipC4bqjbiBjaOG6pXQgYsOgaSB0b8OhbioqOiBLaGkgbeG7mXQgbOG7l2kgeOG6o3kgcmEg4bufIHThuqduZyBzw6J1IG5o4bqldCAodsOtIGThu6U6IEjDoG0gbeG7nyBr4bq/dCBu4buRaSBzb2NrZXQgVENQIGPhu6dhIERhdGFiYXNlIG7DqW0gcmEgbOG7l2kgYGNvbm5lY3Rpb24gcmVmdXNlZGApLCBsw6BtIHRo4bq/IG7DoG8gxJHhu4Mga2hpIGzhu5dpIG7hu5VpIGzDqm4gdOG7m2kgdOG6p25nIEFQSSBDb250cm9sbGVyIGPhu6dhIG5nxrDhu51pIGTDuW5nLCBjaMO6bmcgdGEgduG6q24gYmnhur90IGNow61uaCB4w6FjIG5n4buvIGPhuqNuaCBuZ2hp4buHcCB24bulIG3DoCBraMO0bmcgbMOgbSBt4bqldCBk4bqldSB24bq/dCBr4bu5IHRodeG6rXQgYmFuIMSR4bqndT8NCi0gKipL4bu5IHRodeG6rXQgQuG7jWMgY2h14buXaSBs4buXaSAoQ2F1c2FsIEVycm9yIENoYWlucyAvIEVycm9yIFdyYXBwaW5nKSoqOg0KICAtIE3hu5dpIHThuqduZyBraeG6v24gdHLDumMga2hpIGLhuq90IMSRxrDhu6NjIGzhu5dpIGPhuqVwIGTGsOG7m2kgc+G6vSAqKmLhu41jICh3cmFwKSBuw7MgdHJvbmcgbeG7mXQgbmfhu68gY+G6o25oIG5naGnhu4dwIHbhu6UgbeG7m2kqKjoNCiAgICAtIFThuqduZyBSZXBvc2l0b3J5OiBgRGJDb25uZWN0RXJyb3I6IGNvbm5lY3Rpb24gcmVmdXNlZGANCiAgICAtIFThuqduZyBTZXJ2aWNlOiBgVXNlclNlcnZpY2VFcnJvcjogZmFpbGVkIHRvIGZldGNoIHVzZXIgOTkgLT4gRGJDb25uZWN0RXJyb3I6IGNvbm5lY3Rpb24gcmVmdXNlZGANCiAgICAtIFThuqduZyBDb250cm9sbGVyOiBgQ2hlY2tvdXRFcnJvcjogY2Fubm90IGNvbXBsZXRlIHBheW1lbnQgLT4gVXNlclNlcnZpY2VFcnJvciAtPiBEYkNvbm5lY3RFcnJvcmANCiAgLSBDaHXhu5dpIG5ndXnDqm4gbmjDom4gZ+G7kWMgcuG7hSAoKipSb290IENhdXNlKiopIGx1w7RuIMSRxrDhu6NjIGLhuqNvIHRvw6BuIG5ndXnDqm4gduG6uW4gxJHhu4Mga+G7uSBzxrAgxJFp4buBdSB0cmEgdHJvbmcgbG9nLCB0cm9uZyBraGkgdOG6p25nIGdpYW8gZGnhu4duIG5nxrDhu51pIGTDuW5nIGNo4buJIG5o4bqtbiDEkcaw4bujYyB0aMO0bmcgYsOhbyBuZ+G6r24gZ+G7jW4gdGjDom4gdGhp4buHbi4NCg0KIyMjIDIuNC4gRXJyb3IgQm91bmRhcmllcyAoUmFuaCBnaeG7m2kgY8O0IGzhuq1wIGzhu5dpKQ0KLSAqKkLhuqNuIGNo4bqldCBraeG6v24gdHLDumMqKjogTMOgIG3hu5l0IGjDoG5nIHLDoG8gcGjDsm5nIHRo4bunIMSRxrDhu6NjIGThu7FuZyBsw6puIHThuqFpIGPDoWMgbsO6dCBnaWFvIHRow7RuZyBxdWFuIHRy4buNbmcgY+G7p2EgcGjhuqduIG3hu4FtIG5o4bqxbSBjaOG6t24gxJHhu6luZyBz4buxIGzDonkgbGFuIGPhu6dhIGzhu5dpLg0KLSAqKuG7qG5nIGThu6VuZyB0aOG7sWMgY2hp4bq/bioqOg0KICAtICpUcm9uZyBCYWNrZ3JvdW5kIFdvcmtlciAvIE1lc3NhZ2UgUXVldWUgQ29uc3VtZXIqOiBN4buZdCBjb25zdW1lciDEkeG7jWMgdGluIG5o4bqvbiB04burIFJhYmJpdE1RIGhv4bq3YyBLYWZrYS4gTuG6v3UgdGluIG5o4bqvbiBi4buLIGzhu5dpIGPDuiBwaMOhcCBnw6J5IGNyYXNoIG3DoyBuZ3Xhu5NuLCBFcnJvciBCb3VuZGFyeSBz4bq9IGLhuq90IGzhuqV5IG5nb+G6oWkgbOG7hywgZ2hpIGxvZywgxJHhuql5IHRpbiBuaOG6r24gbOG7l2kgxJHDsyBzYW5nICoqRGVhZCBMZXR0ZXIgUXVldWUgKERMUSkqKiDEkeG7gyB44butIGzDvSBzYXUsIHbDoCB0aeG6v3AgdOG7pWMgxJHhu41jIHRpbiBuaOG6r24gdGnhur9wIHRoZW8gbcOgIGtow7RuZyBsw6BtIHTDqiBsaeG7h3QgdG/DoG4gYuG7mSB3b3JrZXIuDQogIC0gKlRyb25nIFdlYiBVSSAoUmVhY3QgRXJyb3IgQm91bmRhcmllcykqOiBO4bq/dSBt4buZdCB3aWRnZXQgcXXhuqNuZyBjw6FvIGLDqm4gZ8OzYyBwaOG6o2kgbcOgbiBow6xuaCBi4buLIGzhu5dpIGNyYXNoIEphdmFTY3JpcHQsIEVycm9yIEJvdW5kYXJ5IHPhur0gY2jhu4kgdGhheSB0aOG6vyB3aWRnZXQgxJHDsyBi4bqxbmcgbeG7mXQga2h1bmcgdHLhu5FuZywgdG/DoG4gYuG7mSB0cmFuZyB0aMawxqFuZyBt4bqhaSDEkWnhu4duIHThu60gdsOgIG7DunQgYuG6pW0gIlRoYW5oIFRvw6FuIiB24bqrbiBob+G6oXQgxJHhu5luZyBiw6xuaCB0aMaw4budbmcuDQoNCiMjIyAyLjUuIEdyYWNlZnVsIFNodXRkb3duIChU4bqvdCBtw6F5IMOqbSBk4buLdSBjaHXhuqluIE9TICYgS3ViZXJuZXRlcykNCi0gKipDw6FjIHTDrW4gaGnhu4d1IGjhu4cgxJFp4buBdSBow6BuaCAoUE9TSVggU2lnbmFscykqKjoNCiAgLSBgU0lHSU5UYCAoU2lnbmFsIEludGVycnVwdCAtIE3DoyAyKTogS8OtY2ggaG/huqF0IGtoaSBuZ8aw4budaSBkw7luZyBnw7UgYEN0cmwgKyBDYCB0csOqbiBiw6BuIHBow61tLg0KICAtIGBTSUdURVJNYCAoU2lnbmFsIFRlcm1pbmF0ZSAtIE3DoyAxNSk6IFTDrW4gaGnhu4d1IGNodeG6qW4gZG8gS3ViZXJuZXRlcyAvIERvY2tlciBn4butaSB04bubaSB0aeG6v24gdHLDrG5oIMSR4buDIHnDqnUgY+G6p3UgdOG6r3QgbcOheSBjw7MgdHLhuq10IHThu7EuIFRp4bq/biB0csOsbmggY8OzIHRo4buDIGLhuq90IHbDoCB44butIGzDvSB0w61uIGhp4buHdSBuw6B5Lg0KICAtIGBTSUdLSUxMYCAoU2lnbmFsIEtpbGwgLSBNw6MgOSk6IFTDrW4gaGnhu4d1IGPGsOG7oW5nIGNo4bq/IHThu6ljIHRow6wgdOG7qyBo4bqhdCBuaMOibiBMaW51eCAoS2VybmVsKS4gVGnhur9uIHRyw6xuaCBi4buLIHRpw6p1IGRp4buHdCBuZ2F5IGzhuq1wIHThu6ljIG3DoCBraMO0bmcgY8OzIGPGoSBo4buZaSBjaOG6oXkgYuG6pXQga+G7syBkw7JuZyBjb2RlIGThu41uIGThurlwIG7DoG8uDQotICoqUXV5IHRyw6xuaCBHcmFjZWZ1bCBTaHV0ZG93biBjaHXhuqluIG3hu7FjKio6DQogIDEuIMSQxINuZyBrw70gaMOgbSBs4bqvbmcgbmdoZSB0w61uIGhp4buHdSBgU0lHVEVSTWAuDQogIDIuIEtoaSBuaOG6rW4gdMOtbiBoaeG7h3UsIG5n4burbmcgbmdheSBs4bqtcCB04bupYyB2aeG7h2Mgbmjhuq1uIGPDoWMga+G6v3QgbuG7kWkgbeG6oW5nIG3hu5tpIChgc2VydmVyLmNsb3NlKClgKS4NCiAgMy4gQ+G6pXAgbeG7mXQga2hv4bqjbmcgdGjhu51pIGdpYW4gY2jhu50gdOG7kWkgxJFhIChEcmFpbmluZyBUaW1lb3V0IC0gdsOtIGThu6U6ICQxMFx0ZXh0eyBnacOieX0kKSDEkeG7gyBjw6FjIHnDqnUgY+G6p3UgxJFhbmcgdGjhu7FjIHRoaSAoSW5mbGlnaHQgUmVxdWVzdHMpIGvhu4twIGhvw6BuIHThuqV0IHbDoCB0cuG6oyBwaOG6o24gaOG7k2kgduG7gSBjaG8ga2jDoWNoIGjDoG5nLg0KICA0LiDEkMOzbmcgYW4gdG/DoG4gY8OhYyB0w6BpIG5ndXnDqm4gbmdv4bqhaSB2aTogTmfhuq90IGPDoWMgY29uc3VtZXIgY+G7p2EgTWVzc2FnZSBRdWV1ZSwgxJHDs25nIGvhur90IG7hu5FpIFJlZGlzLCBmbHVzaCB0b8OgbiBi4buZIGThu68gbGnhu4d1IGdoaSDEkeG7h20gY+G7p2EgY8ahIHPhu58gZOG7ryBsaeG7h3UuDQogIDUuIEfhu41pIGjDoG0gdGhvw6F0IHRp4bq/biB0csOsbmggYGV4aXQoMClgLg0KDQotLS0NCg0KIyMgMy4gVGjhu7FjIHRoaSBNw6Mgbmd14buTbiAmIE3DtCBwaOG7j25nIENodXnDqm4gc8OidSAoRHVhbC1FbmdpbmUgSW1wbGVtZW50YXRpb24pDQoNCiMjIyAzLjEuIMSQ4buZbmcgY8ahIEMrKzIwOiBaZXJvLU92ZXJoZWFkIFJlc3VsdC9FeHBlY3RlZCBNb25hZGljIEVycm9yIEVuZ2luZQ0KDQpDaMawxqFuZyB0csOsbmggQysrMjAgZMaw4bubaSDEkcOieSB4w6J5IGThu7FuZyBt4buZdCBo4buHIHRo4buRbmcgKipY4butIGzDvSBM4buXaSBIxrDhu5tuZyBHacOhIFRy4buLIChWYWx1ZS1CYXNlZCBFcnJvciBIYW5kbGluZykqKiB0xrDGoW5nIHThu7EgbmjGsCBgc3RkOjpleHBlY3RlZGAgKEMrKzIzKSBob+G6t2MgYFJlc3VsdDxULCBFPmAgdHJvbmcgUnVzdDoNCi0gxJDhuqNtIGLhuqNvIFplcm8gRHluYW1pYyBNZW1vcnkgQWxsb2NhdGlvbiBraGkgeOG7rSBsw70gbOG7l2kuDQotIEjhu5cgdHLhu6MgY2h14buXaSBiaeG6v24gxJHhu5VpIGjDoG0gTW9uYWRpYyAoYGFuZF90aGVuYCkuDQotIEPhuqV1IHRyw7pjIGzhu5dpIG1hbmcgbcOjIMSR4buLbmggZGFuaCAoRXJyb3IgQ29kZSksIHRow7RuZyDEkWnhu4dwIHbDoCBuaMOjbiB0aOG7nWkgZ2lhbiBjaGkgdGnhur90Lg0KDQpgYGBjcHANCiNpbmNsdWRlIDxpb3N0cmVhbT4NCiNpbmNsdWRlIDxzdHJpbmc+DQojaW5jbHVkZSA8dmFyaWFudD4NCiNpbmNsdWRlIDxmdW5jdGlvbmFsPg0KI2luY2x1ZGUgPG9wdGlvbmFsPg0KI2luY2x1ZGUgPGlvbWFuaXA+DQoNCm5hbWVzcGFjZSBjb3JlX2Vycm9yIHsNCg0KLy8gxJDhu4tuaCBuZ2jEqWEgbcOjIGzhu5dpIMSR4buLbmggZGFuaCBjaHXhuqluIGjhu4cgdGjhu5FuZw0KZW51bSBjbGFzcyBFcnJvckNvZGUgew0KICAgIE5PTkUgPSAwLA0KICAgIFZBTElEQVRJT05fRkFJTEVELA0KICAgIFJFU09VUkNFX05PVF9GT1VORCwNCiAgICBJTlNVRkZJQ0lFTlRfRlVORFMsDQogICAgRE9XTlNUUkVBTV9USU1FT1VUDQp9Ow0KDQpzdHJ1Y3QgQXBwRXJyb3Igew0KICAgIEVycm9yQ29kZSBjb2RlOw0KICAgIHN0ZDo6c3RyaW5nIG1lc3NhZ2U7DQogICAgc3RkOjpzdHJpbmcgY29udGV4dDsNCg0KICAgIHZvaWQgbG9nKCkgY29uc3Qgew0KICAgICAgICBzdGQ6OmNlcnIgPDwgIlwwMzNbMzFtW0VSUk9SIExPR11cMDMzWzBtIENvZGU6ICIgPDwgc3RhdGljX2Nhc3Q8aW50Pihjb2RlKQ0KICAgICAgICAgICAgICAgICAgPDwgIiB8IE1zZzogIiA8PCBtZXNzYWdlIA0KICAgICAgICAgICAgICAgICAgPDwgIiB8IENvbnRleHQ6ICIgPDwgY29udGV4dCA8PCAiXG4iOw0KICAgIH0NCn07DQoNCi8vIEMrKzIwIFZhbHVlLWJhc2VkIFJlc3VsdCBDb250YWluZXIgKFTGsMahbmcgdOG7sSBzdGQ6OmV4cGVjdGVkKQ0KdGVtcGxhdGUgPHR5cGVuYW1lIFQ+DQpjbGFzcyBSZXN1bHQgew0KcHJpdmF0ZToNCiAgICBzdGQ6OnZhcmlhbnQ8VCwgQXBwRXJyb3I+IHN0b3JhZ2VfOw0KDQpwdWJsaWM6DQogICAgLy8gS2jhu59pIHThuqFvIHRy4bqhbmcgdGjDoWkgVGjDoG5oIGPDtG5nDQogICAgUmVzdWx0KFQgdmFsdWUpIDogc3RvcmFnZV8oc3RkOjptb3ZlKHZhbHVlKSkge30NCg0KICAgIC8vIEto4bufaSB04bqhbyB0cuG6oW5nIHRow6FpIFRo4bqldCBi4bqhaQ0KICAgIFJlc3VsdChBcHBFcnJvciBlcnJvcikgOiBzdG9yYWdlXyhzdGQ6Om1vdmUoZXJyb3IpKSB7fQ0KDQogICAgYm9vbCBoYXNfdmFsdWUoKSBjb25zdCB7DQogICAgICAgIHJldHVybiBzdGQ6OmhvbGRzX2FsdGVybmF0aXZlPFQ+KHN0b3JhZ2VfKTsNCiAgICB9DQoNCiAgICBjb25zdCBUJiB2YWx1ZSgpIGNvbnN0IHsNCiAgICAgICAgcmV0dXJuIHN0ZDo6Z2V0PFQ+KHN0b3JhZ2VfKTsNCiAgICB9DQoNCiAgICBjb25zdCBBcHBFcnJvciYgZXJyb3IoKSBjb25zdCB7DQogICAgICAgIHJldHVybiBzdGQ6OmdldDxBcHBFcnJvcj4oc3RvcmFnZV8pOw0KICAgIH0NCg0KICAgIC8vIE1vbmFkaWMgQ2hhaW5pbmcgT3BlcmF0b3I6IGFuZF90aGVuDQogICAgdGVtcGxhdGUgPHR5cGVuYW1lIEZ1bmM+DQogICAgYXV0byBhbmRfdGhlbihGdW5jJiYgZnVuYykgLT4gZGVjbHR5cGUoZnVuYyhzdGQ6OmRlY2x2YWw8VD4oKSkpIHsNCiAgICAgICAgdXNpbmcgUmV0dXJuVHlwZSA9IGRlY2x0eXBlKGZ1bmMoc3RkOjpkZWNsdmFsPFQ+KCkpKTsNCiAgICAgICAgaWYgKGhhc192YWx1ZSgpKSB7DQogICAgICAgICAgICByZXR1cm4gZnVuYyh2YWx1ZSgpKTsNCiAgICAgICAgfSBlbHNlIHsNCiAgICAgICAgICAgIHJldHVybiBSZXR1cm5UeXBlKGVycm9yKCkpOw0KICAgICAgICB9DQogICAgfQ0KfTsNCg0KLy8gQ8OhYyDEkeG7kWkgdMaw4bujbmcgdGjhu7FjIHRo4buDIG5naGnhu4dwIHbhu6UNCnN0cnVjdCBBY2NvdW50IHsNCiAgICBpbnQ2NF90IGlkOw0KICAgIGRvdWJsZSBiYWxhbmNlOw0KfTsNCg0Kc3RydWN0IFRyYW5zZmVyUmVjZWlwdCB7DQogICAgc3RkOjpzdHJpbmcgdHJhbnNhY3Rpb25faWQ7DQogICAgaW50NjRfdCBmcm9tX2lkOw0KICAgIGludDY0X3QgdG9faWQ7DQogICAgZG91YmxlIGFtb3VudDsNCn07DQoNCi8vIFBpcGVsaW5lIHjhu60gbMO9IG5naGnhu4dwIHbhu6UgcXVhIGNodeG7l2kgUmVzdWx0IE1vbmFkaWMNCmNsYXNzIEJhbmtUcmFuc2ZlclNlcnZpY2Ugew0KcHVibGljOg0KICAgIHN0YXRpYyBSZXN1bHQ8QWNjb3VudD4gZmluZEFjY291bnQoaW50NjRfdCBhY2NvdW50X2lkKSB7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiICAtPiBTdGVwIDE6IFF1ZXJ5aW5nIGFjY291bnQgIiA8PCBhY2NvdW50X2lkIDw8ICIuLi5cbiI7DQogICAgICAgIGlmIChhY2NvdW50X2lkID09IDQwNCkgew0KICAgICAgICAgICAgcmV0dXJuIEFwcEVycm9ye0Vycm9yQ29kZTo6UkVTT1VSQ0VfTk9UX0ZPVU5ELCAiQWNjb3VudCBkb2VzIG5vdCBleGlzdCIsICJpZD00MDQifTsNCiAgICAgICAgfQ0KICAgICAgICByZXR1cm4gQWNjb3VudHthY2NvdW50X2lkLCAxNTAuMH07IC8vIFPhu5EgZMawIGdp4bqjIGzhuq1wICQxNTANCiAgICB9DQoNCiAgICBzdGF0aWMgUmVzdWx0PEFjY291bnQ+IHZlcmlmeVN1ZmZpY2llbnRCYWxhbmNlKEFjY291bnQgYWNjLCBkb3VibGUgYW1vdW50KSB7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiICAtPiBTdGVwIDI6IFZlcmlmeWluZyBiYWxhbmNlIGZvciBhY2NvdW50ICIgPDwgYWNjLmlkIDw8ICIgKEFtb3VudDogJCIgPDwgYW1vdW50IDw8ICIpLi4uXG4iOw0KICAgICAgICBpZiAoYWNjLmJhbGFuY2UgPCBhbW91bnQpIHsNCiAgICAgICAgICAgIHJldHVybiBBcHBFcnJvcnsNCiAgICAgICAgICAgICAgICBFcnJvckNvZGU6OklOU1VGRklDSUVOVF9GVU5EUywNCiAgICAgICAgICAgICAgICAiQ3VycmVudCBiYWxhbmNlICQiICsgc3RkOjp0b19zdHJpbmcoYWNjLmJhbGFuY2UpICsgIiBpcyBsZXNzIHRoYW4gcmVxdWlyZWQgJCIgKyBzdGQ6OnRvX3N0cmluZyhhbW91bnQpLA0KICAgICAgICAgICAgICAgICJhY2NvdW50SWQ9IiArIHN0ZDo6dG9fc3RyaW5nKGFjYy5pZCkNCiAgICAgICAgICAgIH07DQogICAgICAgIH0NCiAgICAgICAgcmV0dXJuIGFjYzsNCiAgICB9DQoNCiAgICBzdGF0aWMgUmVzdWx0PFRyYW5zZmVyUmVjZWlwdD4gZXhlY3V0ZVRyYW5zZmVyKEFjY291bnQgZnJvbV9hY2MsIGludDY0X3QgdG9faWQsIGRvdWJsZSBhbW91bnQpIHsNCiAgICAgICAgc3RkOjpjb3V0IDw8ICIgIC0+IFN0ZXAgMzogRXhlY3V0aW5nIGxlZGdlciBkZWR1Y3Rpb24uLi5cbiI7DQogICAgICAgIHJldHVybiBUcmFuc2ZlclJlY2VpcHR7IlRYTl8yMDI2X0FCQ0Q5OSIsIGZyb21fYWNjLmlkLCB0b19pZCwgYW1vdW50fTsNCiAgICB9DQp9Ow0KDQp9IC8vIG5hbWVzcGFjZSBjb3JlX2Vycm9yDQoNCmludCBtYWluKCkgew0KICAgIHVzaW5nIG5hbWVzcGFjZSBjb3JlX2Vycm9yOw0KDQogICAgc3RkOjpjb3V0IDw8ICI9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4iOw0KICAgIHN0ZDo6Y291dCA8PCAiPj4+IDEuIFZBTFVFLUJBU0VEIEVSUk9SIEhBTkRMSU5HIChIQVBQWSBQQVRIKSA8PDxcbiI7DQogICAgc3RkOjpjb3V0IDw8ICI9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4iOw0KDQogICAgLy8gVGjhu7FjIHRoaSBjaHXhu5dpIE1vbmFkaWMgbcaw4bujdCBtw6A6IGZpbmQgLT4gdmVyaWZ5IC0+IHRyYW5zZmVyDQogICAgYXV0byB0cmFuc2Zlcl9yZXN1bHQgPSBCYW5rVHJhbnNmZXJTZXJ2aWNlOjpmaW5kQWNjb3VudCgxMDEpDQogICAgICAgIC5hbmRfdGhlbihbXShBY2NvdW50IGFjYykgew0KICAgICAgICAgICAgcmV0dXJuIEJhbmtUcmFuc2ZlclNlcnZpY2U6OnZlcmlmeVN1ZmZpY2llbnRCYWxhbmNlKGFjYywgNTAuMCk7DQogICAgICAgIH0pDQogICAgICAgIC5hbmRfdGhlbihbXShBY2NvdW50IGFjYykgew0KICAgICAgICAgICAgcmV0dXJuIEJhbmtUcmFuc2ZlclNlcnZpY2U6OmV4ZWN1dGVUcmFuc2ZlcihhY2MsIDIwMiwgNTAuMCk7DQogICAgICAgIH0pOw0KDQogICAgaWYgKHRyYW5zZmVyX3Jlc3VsdC5oYXNfdmFsdWUoKSkgew0KICAgICAgICBjb25zdCBhdXRvJiByZWNlaXB0ID0gdHJhbnNmZXJfcmVzdWx0LnZhbHVlKCk7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiXDAzM1szMm1bVFJBTlNGRVIgU1VDQ0VTU11cMDMzWzBtIFRyYW5zYWN0aW9uIElEOiAiIDw8IHJlY2VpcHQudHJhbnNhY3Rpb25faWQgDQogICAgICAgICAgICAgICAgICA8PCAiIHwgVHJhbnNmZXJyZWQgJCIgPDwgcmVjZWlwdC5hbW91bnQgPDwgIiBmcm9tICIgPDwgcmVjZWlwdC5mcm9tX2lkIA0KICAgICAgICAgICAgICAgICAgPDwgIiB0byAiIDw8IHJlY2VpcHQudG9faWQgPDwgIlxuIjsNCiAgICB9IGVsc2Ugew0KICAgICAgICB0cmFuc2Zlcl9yZXN1bHQuZXJyb3IoKS5sb2coKTsNCiAgICB9DQoNCiAgICBzdGQ6OmNvdXQgPDwgIlxuPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuIjsNCiAgICBzdGQ6OmNvdXQgPDwgIj4+PiAyLiBWQUxVRS1CQVNFRCBFUlJPUiBIQU5ETElORyAoRkFJTFVSRSBQQVRIKSA8PDxcbiI7DQogICAgc3RkOjpjb3V0IDw8ICI9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4iOw0KDQogICAgLy8gVGjhu7FjIHRoaSB24bubaSBz4buRIHRp4buBbiB2xrDhu6N0IHF1w6Egc+G7kSBkxrAgKCQ1MDAgPiAkMTUwKQ0KICAgIGF1dG8gZmFpbGVkX3Jlc3VsdCA9IEJhbmtUcmFuc2ZlclNlcnZpY2U6OmZpbmRBY2NvdW50KDEwMSkNCiAgICAgICAgLmFuZF90aGVuKFtdKEFjY291bnQgYWNjKSB7DQogICAgICAgICAgICByZXR1cm4gQmFua1RyYW5zZmVyU2VydmljZTo6dmVyaWZ5U3VmZmljaWVudEJhbGFuY2UoYWNjLCA1MDAuMCk7IC8vIFRo4bqldCBi4bqhaSDhu58gxJHDonkNCiAgICAgICAgfSkNCiAgICAgICAgLmFuZF90aGVuKFtdKEFjY291bnQgYWNjKSB7DQogICAgICAgICAgICByZXR1cm4gQmFua1RyYW5zZmVyU2VydmljZTo6ZXhlY3V0ZVRyYW5zZmVyKGFjYywgMjAyLCA1MDAuMCk7IC8vIELGsOG7m2MgbsOgeSB04buxIMSR4buZbmcgYuG7iyBi4buPIHF1YQ0KICAgICAgICB9KTsNCg0KICAgIGlmIChmYWlsZWRfcmVzdWx0Lmhhc192YWx1ZSgpKSB7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiU3VjY2VzcyFcbiI7DQogICAgfSBlbHNlIHsNCiAgICAgICAgc3RkOjpjb3V0IDw8ICJQaXBlbGluZSBhYm9ydGVkIHNhZmVseSB3aXRob3V0IHRocm93aW5nIGV4Y2VwdGlvbnMuXG4iOw0KICAgICAgICBmYWlsZWRfcmVzdWx0LmVycm9yKCkubG9nKCk7DQogICAgfQ0KDQogICAgcmV0dXJuIDA7DQp9DQpgYGANCg0KLS0tDQoNCiMjIyAzLjIuIMSQ4buZbmcgY8ahIFB5dGhvbiAzLjExKzogUHJvZHVjdGlvbiBHcmFjZWZ1bCBTaHV0ZG93biBDb29yZGluYXRvciAmIFJGQyA3ODA3IEVuZ2luZQ0KDQpDaMawxqFuZyB0csOsbmggUHl0aG9uIDMuMTErIGTGsOG7m2kgxJHDonkgbcO0IHBo4buPbmcgbeG7mXQgKipUaeG6v24gdHLDrG5oIEThu4tjaCB24bulIFByb2R1Y3Rpb24gY8OzIGto4bqjIG7Eg25nKio6DQoxLiDEkMSDbmcga8O9IHbDoCB44butIGzDvSB0w61uIGhp4buHdSBo4buHIMSRaeG7gXUgaMOgbmggYFNJR0lOVGAgdsOgIGBTSUdURVJNYC4NCjIuIENodXnhu4NuIHNhbmcgdHLhuqFuZyB0aMOhaSAiRHJhaW5pbmciOiBU4burIGNo4buRaSByZXF1ZXN0IG3hu5tpIG5oxrBuZyB44butIGzDvSB4b25nIHRvw6BuIGLhu5kgY8OhYyByZXF1ZXN0IMSRYW5nIG7hurFtIHRyb25nIGjDoG5nIMSR4bujaS4NCjMuIENodeG6qW4gaMOzYSB2w6Agc2luaCBwaOG6o24gaOG7k2kgbOG7l2kgdGhlbyDEkeG6t2MgdOG6oyAqKlJGQyA3ODA3IFByb2JsZW0gRGV0YWlscyoqLg0KDQpgYGBweXRob24NCiMhL3Vzci9iaW4vZW52IHB5dGhvbjMNCiIiIg0KUHJvZHVjdGlvbiBHcmFjZWZ1bCBTaHV0ZG93biAmIFJGQyA3ODA3IFByb2JsZW0gRGV0YWlscyBFbmdpbmUgKFB5dGhvbiAzLjExKykNCkLhuqNvIMSR4bqjbSB0w61uaCB0b8OgbiB24bq5biBj4bunYSBr4bq/dCBu4buRaSBo4bqhIHThuqduZyBraGkgS3ViZXJuZXRlcyB4w7NhIFBvZC4NCiIiIg0KDQpmcm9tIF9fZnV0dXJlX18gaW1wb3J0IGFubm90YXRpb25zDQppbXBvcnQgYXN5bmNpbw0KaW1wb3J0IGRhdGFjbGFzc2VzDQppbXBvcnQganNvbg0KaW1wb3J0IHNpZ25hbA0KaW1wb3J0IHN5cw0KaW1wb3J0IHRpbWUNCmZyb20gdHlwaW5nIGltcG9ydCBEaWN0LCBBbnksIE9wdGlvbmFsLCBTZXQNCg0KDQpAZGF0YWNsYXNzZXMuZGF0YWNsYXNzKGZyb3plbj1UcnVlKQ0KY2xhc3MgUkZDNzgwN1Byb2JsZW1EZXRhaWw6DQogICAgdHlwZV91cmk6IHN0cg0KICAgIHRpdGxlOiBzdHINCiAgICBzdGF0dXM6IGludA0KICAgIGRldGFpbDogc3RyDQogICAgaW5zdGFuY2U6IHN0cg0KICAgIGVycm9yX2NvZGU6IHN0cg0KICAgIHRyYWNlX2lkOiBzdHINCg0KICAgIGRlZiB0b19qc29uKHNlbGYpIC0+IHN0cjoNCiAgICAgICAgcmV0dXJuIGpzb24uZHVtcHMoew0KICAgICAgICAgICAgInR5cGUiOiBzZWxmLnR5cGVfdXJpLA0KICAgICAgICAgICAgInRpdGxlIjogc2VsZi50aXRsZSwNCiAgICAgICAgICAgICJzdGF0dXMiOiBzZWxmLnN0YXR1cywNCiAgICAgICAgICAgICJkZXRhaWwiOiBzZWxmLmRldGFpbCwNCiAgICAgICAgICAgICJpbnN0YW5jZSI6IHNlbGYuaW5zdGFuY2UsDQogICAgICAgICAgICAiY29kZSI6IHNlbGYuZXJyb3JfY29kZSwNCiAgICAgICAgICAgICJ0cmFjZV9pZCI6IHNlbGYudHJhY2VfaWQsDQogICAgICAgICAgICAidGltZXN0YW1wIjogdGltZS50aW1lKCkNCiAgICAgICAgfSwgaW5kZW50PTIpDQoNCg0KY2xhc3MgUmVzaWxpZW50SHR0cFNlcnZlcjoNCiAgICBkZWYgX19pbml0X18oc2VsZiwgcG9ydDogaW50ID0gODA4MCwgc2h1dGRvd25fdGltZW91dF9zZWM6IGZsb2F0ID0gNS4wKToNCiAgICAgICAgc2VsZi5wb3J0ID0gcG9ydA0KICAgICAgICBzZWxmLnNodXRkb3duX3RpbWVvdXRfc2VjID0gc2h1dGRvd25fdGltZW91dF9zZWMNCiAgICAgICAgc2VsZi5pc19hY2NlcHRpbmdfdHJhZmZpYyA9IFRydWUNCiAgICAgICAgc2VsZi5hY3RpdmVfdGFza3M6IFNldFthc3luY2lvLlRhc2tdID0gc2V0KCkNCiAgICAgICAgc2VsZi5zaHV0ZG93bl9ldmVudCA9IGFzeW5jaW8uRXZlbnQoKQ0KDQogICAgZGVmIHNldHVwX3NpZ25hbF9oYW5kbGVycyhzZWxmKSAtPiBOb25lOg0KICAgICAgICBsb29wID0gYXN5bmNpby5nZXRfcnVubmluZ19sb29wKCkNCiAgICAgICAgZm9yIHNpZyBpbiAoc2lnbmFsLlNJR1RFUk0sIHNpZ25hbC5TSUdJTlQpOg0KICAgICAgICAgICAgbG9vcC5hZGRfc2lnbmFsX2hhbmRsZXIoc2lnLCBsYW1iZGEgcz1zaWc6IGFzeW5jaW8uY3JlYXRlX3Rhc2soc2VsZi5oYW5kbGVfc2h1dGRvd25fc2lnbmFsKHMpKSkNCg0KICAgIGFzeW5jIGRlZiBoYW5kbGVfc2h1dGRvd25fc2lnbmFsKHNlbGYsIHNpZzogc2lnbmFsLlNpZ25hbHMpIC0+IE5vbmU6DQogICAgICAgIHByaW50KGYiXG5cMDMzWzMzbVtTSUdOQUwgUkVDRUlWRURdXDAzM1swbSBDYXVnaHQgc2lnbmFsIHtzaWcubmFtZX0gKHtzaWcudmFsdWV9KS4gU3RhcnRpbmcgR3JhY2VmdWwgU2h1dGRvd24uLi4iKQ0KICAgICAgICANCiAgICAgICAgIyAxLiBOZ+G7q25nIGNo4bqlcCBuaOG6rW4gcmVxdWVzdCBt4bubaSBuZ2F5IGzhuq1wIHThu6ljDQogICAgICAgIHNlbGYuaXNfYWNjZXB0aW5nX3RyYWZmaWMgPSBGYWxzZQ0KICAgICAgICBwcmludCgiICDwn5qrIFN0b3BwZWQgYWNjZXB0aW5nIG5ldyBpbmNvbWluZyBIVFRQIHJlcXVlc3RzIChMb2FkIEJhbGFuY2VyIGRyYWluaW5nIGluaXRpYXRlZCkuIikNCg0KICAgICAgICAjIDIuIENo4budIGPDoWMgaW5mbGlnaHQgcmVxdWVzdHMgaG/DoG4gdGjDoG5oDQogICAgICAgIHByaW50KGYiICDij7MgV2FpdGluZyBmb3Ige2xlbihzZWxmLmFjdGl2ZV90YXNrcyl9IGFjdGl2ZSBpbmZsaWdodCB0YXNrcyB0byBmaW5pc2ggKFRpbWVvdXQ6IHtzZWxmLnNodXRkb3duX3RpbWVvdXRfc2VjfXMpLi4uIikNCiAgICAgICAgDQogICAgICAgIHN0YXJ0X3dhaXQgPSB0aW1lLm1vbm90b25pYygpDQogICAgICAgIHdoaWxlIHNlbGYuYWN0aXZlX3Rhc2tzOg0KICAgICAgICAgICAgZWxhcHNlZCA9IHRpbWUubW9ub3RvbmljKCkgLSBzdGFydF93YWl0DQogICAgICAgICAgICBpZiBlbGFwc2VkID49IHNlbGYuc2h1dGRvd25fdGltZW91dF9zZWM6DQogICAgICAgICAgICAgICAgcHJpbnQoZiIgIFwwMzNbMzFtW1RJTUVPVVRdXDAzM1swbSBFeGNlZWRlZCB7c2VsZi5zaHV0ZG93bl90aW1lb3V0X3NlY31zISBDYW5jZWxsaW5nIHJlbWFpbmluZyB7bGVuKHNlbGYuYWN0aXZlX3Rhc2tzKX0gdGFza3MuIikNCiAgICAgICAgICAgICAgICBmb3IgdCBpbiBzZWxmLmFjdGl2ZV90YXNrczoNCiAgICAgICAgICAgICAgICAgICAgdC5jYW5jZWwoKQ0KICAgICAgICAgICAgICAgIGJyZWFrDQogICAgICAgICAgICBhd2FpdCBhc3luY2lvLnNsZWVwKDAuMSkNCg0KICAgICAgICAjIDMuIMSQw7NuZyBjw6FjIHTDoGkgbmd1ecOqbiBo4bqhIHThuqduZw0KICAgICAgICBwcmludCgiICDwn5SMIENsb3NpbmcgRGF0YWJhc2UgQ29ubmVjdGlvbiBQb29sIGFuZCBSZWRpcyBDYWNoZSBzb2NrZXRzLi4uIikNCiAgICAgICAgYXdhaXQgYXN5bmNpby5zbGVlcCgwLjIpICMgR2nhuqMgbOG6rXAgxJHDs25nIERCIGNvbm5lY3Rpb24gcG9vbA0KDQogICAgICAgIHByaW50KCJcMDMzWzMybVtTSFVURE9XTiBDT01QTEVURV1cMDMzWzBtIEFsbCByZXNvdXJjZXMgc2FmZWx5IGxpYmVyYXRlZC4gRXhpdGluZyBjbGVhbmx5IHdpdGggY29kZSAwLiIpDQogICAgICAgIHNlbGYuc2h1dGRvd25fZXZlbnQuc2V0KCkNCg0KICAgIGFzeW5jIGRlZiBoYW5kbGVfbW9ja19yZXF1ZXN0KHNlbGYsIHJlcV9pZDogc3RyLCBjbGllbnRfaXA6IHN0ciwgZHVyYXRpb25fc2VjOiBmbG9hdCkgLT4gc3RyOg0KICAgICAgICBpZiBub3Qgc2VsZi5pc19hY2NlcHRpbmdfdHJhZmZpYzoNCiAgICAgICAgICAgICMgTuG6v3UgxJFhbmcgdHJvbmcgcXXDoSB0csOsbmggc2h1dGRvd24sIHThu6sgY2jhu5FpIHbDoCB0cuG6oyB24buBIEhUVFAgNTAzDQogICAgICAgICAgICBwcm9ibGVtID0gUkZDNzgwN1Byb2JsZW1EZXRhaWwoDQogICAgICAgICAgICAgICAgdHlwZV91cmk9Imh0dHBzOi8vYXBpLnN5c3RlbS5pbnRlcm5hbC9lcnJvcnMvc2VydmljZS11bmF2YWlsYWJsZSIsDQogICAgICAgICAgICAgICAgdGl0bGU9IlNlcnZpY2UgVW5kZXJnb2luZyBHcmFjZWZ1bCBTaHV0ZG93biIsDQogICAgICAgICAgICAgICAgc3RhdHVzPTUwMywNCiAgICAgICAgICAgICAgICBkZXRhaWw9IlNlcnZlciBpcyBkcmFpbmluZyBjb25uZWN0aW9ucyBpbiBwcmVwYXJhdGlvbiBmb3IgcG9kIHRlcm1pbmF0aW9uLiIsDQogICAgICAgICAgICAgICAgaW5zdGFuY2U9ZiIvb3JkZXJzL3tyZXFfaWR9IiwNCiAgICAgICAgICAgICAgICBlcnJvcl9jb2RlPSJFUlJfU0VSVkVSX0RSQUlOSU5HIiwNCiAgICAgICAgICAgICAgICB0cmFjZV9pZD0idHJjXzk5ODFhMmIiDQogICAgICAgICAgICApDQogICAgICAgICAgICByZXR1cm4gcHJvYmxlbS50b19qc29uKCkNCg0KICAgICAgICAjIMSQxINuZyBrw70gdGFzayB2w6BvIHThuq1wIGjhu6NwIGPDoWMgdMOhYyB24bulIMSRYW5nIGNo4bqheQ0KICAgICAgICBjdXJyZW50X3Rhc2sgPSBhc3luY2lvLmN1cnJlbnRfdGFzaygpDQogICAgICAgIHNlbGYuYWN0aXZlX3Rhc2tzLmFkZChjdXJyZW50X3Rhc2spDQogICAgICAgIA0KICAgICAgICB0cnk6DQogICAgICAgICAgICBwcmludChmIiAgW0hUVFAgUkVRIFNUQVJUXSBQcm9jZXNzaW5nIFJlcXVlc3Qge3JlcV9pZH0gKHtkdXJhdGlvbl9zZWN9cykuLi4iKQ0KICAgICAgICAgICAgYXdhaXQgYXN5bmNpby5zbGVlcChkdXJhdGlvbl9zZWMpDQogICAgICAgICAgICBwcmludChmIiAgXDAzM1szMm1bSFRUUCBSRVEgRE9ORV1cMDMzWzBtIEZpbmlzaGVkIFJlcXVlc3Qge3JlcV9pZH0gc3VjY2Vzc2Z1bGx5LiIpDQogICAgICAgICAgICByZXR1cm4ganNvbi5kdW1wcyh7InN0YXR1cyI6ICJTVUNDRVNTIiwgInJlcXVlc3RfaWQiOiByZXFfaWR9KQ0KICAgICAgICBleGNlcHQgYXN5bmNpby5DYW5jZWxsZWRFcnJvcjoNCiAgICAgICAgICAgIHByaW50KGYiICBcMDMzWzMxbVtIVFRQIFJFUSBBQk9SVEVEXVwwMzNbMG0gUmVxdWVzdCB7cmVxX2lkfSB3YXMgZm9yY2VmdWxseSBjYW5jZWxsZWQgZHVlIHRvIHNodXRkb3duIHRpbWVvdXQuIikNCiAgICAgICAgICAgIHJhaXNlDQogICAgICAgIGZpbmFsbHk6DQogICAgICAgICAgICBzZWxmLmFjdGl2ZV90YXNrcy5kaXNjYXJkKGN1cnJlbnRfdGFzaykNCg0KDQphc3luYyBkZWYgbWFpbigpOg0KICAgIHNlcnZlciA9IFJlc2lsaWVudEh0dHBTZXJ2ZXIoc2h1dGRvd25fdGltZW91dF9zZWM9Mi4wKQ0KICAgIHNlcnZlci5zZXR1cF9zaWduYWxfaGFuZGxlcnMoKQ0KDQogICAgcHJpbnQoIj09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PSIpDQogICAgcHJpbnQoZiLwn5qAIEhUVFAgU0VSVkVSIEFDVElWRSBPTiBQT1JUIHtzZXJ2ZXIucG9ydH0gfCBQSUQ6IHtzaWduYWwub3MuZ2V0cGlkKCl9IikNCiAgICBwcmludCgiPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09IikNCg0KICAgICMgR2nhuqMgbOG6rXAgbHXhu5NuZyByZXF1ZXN0IGfhu61pIMSR4bq/bg0KICAgIHRhc2sxID0gYXN5bmNpby5jcmVhdGVfdGFzayhzZXJ2ZXIuaGFuZGxlX21vY2tfcmVxdWVzdCgiUkVRLTAwMSIsICIxOTIuMTY4LjEuMTAiLCAwLjUpKQ0KICAgIHRhc2syID0gYXN5bmNpby5jcmVhdGVfdGFzayhzZXJ2ZXIuaGFuZGxlX21vY2tfcmVxdWVzdCgiUkVRLTAwMiIsICIxOTIuMTY4LjEuMTEiLCAxLjIpKQ0KDQogICAgIyDEkOG7o2kgMC4zcyBy4buTaSBnaeG6oyBs4bqtcCB0w61uIGhp4buHdSBTSUdURVJNIHThu6sgS3ViZXJuZXRlcw0KICAgIGF3YWl0IGFzeW5jaW8uc2xlZXAoMC4zKQ0KICAgIGF3YWl0IHNlcnZlci5oYW5kbGVfc2h1dGRvd25fc2lnbmFsKHNpZ25hbC5TSUdURVJNKQ0KDQogICAgIyBUaOG7rSBn4butaSAxIHJlcXVlc3QgbeG7m2kga2hpIMSRYW5nIHNodXRkb3duIC0+IELhu4sgdOG7qyBjaOG7kWkgYuG6sW5nIFJGQyA3ODA3IHBheWxvYWQNCiAgICByZWplY3RlZF9yZXNwb25zZSA9IGF3YWl0IHNlcnZlci5oYW5kbGVfbW9ja19yZXF1ZXN0KCJSRVEtMDAzLUxBVEUiLCAiMTkyLjE2OC4xLjk5IiwgMC41KQ0KICAgIHByaW50KCJcbi0tLSBSRUpFQ1RFRCBSRVNQT05TRSBQQVlMT0FEIChSRkMgNzgwNykgLS0tIikNCiAgICBwcmludChyZWplY3RlZF9yZXNwb25zZSkNCg0KICAgIGF3YWl0IGFzeW5jaW8uZ2F0aGVyKHRhc2sxLCB0YXNrMiwgcmV0dXJuX2V4Y2VwdGlvbnM9VHJ1ZSkNCg0KDQppZiBfX25hbWVfXyA9PSAiX19tYWluX18iOg0KICAgIGFzeW5jaW8ucnVuKG1haW4oKSkNCmBgYA0KDQotLS0NCg0KIyMjIDMuMy4gVGVybWluYWwgT3V0cHV0IFRo4buxYyBU4bq/IEdp4bqjIEzhuq1wDQoNCmBgYHRleHQNCj09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0K8J+agCBIVFRQIFNFUlZFUiBBQ1RJVkUgT04gUE9SVCA4MDgwIHwgUElEOiA0ODkyMQ0KPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQogIFtIVFRQIFJFUSBTVEFSVF0gUHJvY2Vzc2luZyBSZXF1ZXN0IFJFUS0wMDEgKDAuNXMpLi4uDQogIFtIVFRQIFJFUSBTVEFSVF0gUHJvY2Vzc2luZyBSZXF1ZXN0IFJFUS0wMDIgKDEuMnMpLi4uDQoNCltTSUdOQUwgUkVDRUlWRURdIENhdWdodCBzaWduYWwgU0lHVEVSTSAoMTUpLiBTdGFydGluZyBHcmFjZWZ1bCBTaHV0ZG93bi4uLg0KICDwn5qrIFN0b3BwZWQgYWNjZXB0aW5nIG5ldyBpbmNvbWluZyBIVFRQIHJlcXVlc3RzIChMb2FkIEJhbGFuY2VyIGRyYWluaW5nIGluaXRpYXRlZCkuDQogIOKPsyBXYWl0aW5nIGZvciAyIGFjdGl2ZSBpbmZsaWdodCB0YXNrcyB0byBmaW5pc2ggKFRpbWVvdXQ6IDIuMHMpLi4uDQogIFtIVFRQIFJFUSBET05FXSBGaW5pc2hlZCBSZXF1ZXN0IFJFUS0wMDEgc3VjY2Vzc2Z1bGx5Lg0KICBbSFRUUCBSRVEgRE9ORV0gRmluaXNoZWQgUmVxdWVzdCBSRVEtMDAyIHN1Y2Nlc3NmdWxseS4NCiAg8J+UjCBDbG9zaW5nIERhdGFiYXNlIENvbm5lY3Rpb24gUG9vbCBhbmQgUmVkaXMgQ2FjaGUgc29ja2V0cy4uLg0KW1NIVVRET1dOIENPTVBMRVRFXSBBbGwgcmVzb3VyY2VzIHNhZmVseSBsaWJlcmF0ZWQuIEV4aXRpbmcgY2xlYW5seSB3aXRoIGNvZGUgMC4NCg0KLS0tIFJFSkVDVEVEIFJFU1BPTlNFIFBBWUxPQUQgKFJGQyA3ODA3KSAtLS0NCnsNCiAgInR5cGUiOiAiaHR0cHM6Ly9hcGkuc3lzdGVtLmludGVybmFsL2Vycm9ycy9zZXJ2aWNlLXVuYXZhaWxhYmxlIiwNCiAgInRpdGxlIjogIlNlcnZpY2UgVW5kZXJnb2luZyBHcmFjZWZ1bCBTaHV0ZG93biIsDQogICJzdGF0dXMiOiA1MDMsDQogICJkZXRhaWwiOiAiU2VydmVyIGlzIGRyYWluaW5nIGNvbm5lY3Rpb25zIGluIHByZXBhcmF0aW9uIGZvciBwb2QgdGVybWluYXRpb24uIiwNCiAgImluc3RhbmNlIjogIi9vcmRlcnMvUkVRLTAwMy1MQVRFIiwNCiAgImNvZGUiOiAiRVJSX1NFUlZFUl9EUkFJTklORyIsDQogICJ0cmFjZV9pZCI6ICJ0cmNfOTk4MWEyYiIsDQogICJ0aW1lc3RhbXAiOiAxNzMxNzI4NDAwLjEyDQp9DQpgYGANCg0KLS0tDQoNCiMjIDQuIFN5c3RlbXMgRW5naW5lZXJpbmcgJiBQcm9kdWN0aW9uIFBpdGZhbGxzDQoNCiMjIyA0LjEuIFByb2R1Y3Rpb24gRmFpbHVyZSBNb2RlcyB0cm9uZyBL4bu5IG5naOG7hyBY4butIEzDvSBM4buXaQ0KDQoxLiAqKlBva2Vtb24gRXhjZXB0aW9uIEhhbmRsaW5nIChOdeG7kXQgbOG7l2kgYuG6sW5nIGBjYXRjaCAoRXhjZXB0aW9uIGUpIHt9YCkqKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IEzhuq1wIHRyw6xuaCB2acOqbiB2aeG6v3Qga2jhu5FpIGB0cnkgLi4uIGNhdGNoKEV4Y2VwdGlvbiBlKWAgY2h1bmcgY2h1bmcgbmjGsG5nIMSR4buDIHRy4buRbmcgcGjhuqduIHRow6JuIGhv4bq3YyBjaOG7iSBpbiByYSBkw7JuZyBsb2cgYFN5c3RlbS5vdXQucHJpbnRsbigiRXJyb3IiKWAuDQogICAtICpI4bqtdSBxdeG6oyo6IE5nb+G6oWkgbOG7hyBi4buLIG514buRdCBjaOG7rW5nIGhvw6BuIHRvw6BuLCBjaGUgZ2nhuqV1IGPDoWMgbOG7l2kgbmdoacOqbSB0cuG7jW5nIG5oxrAgY+G6oW4ga2nhu4d0IGLhu5kgbmjhu5sgaG/hurdjIGfDo3kga+G6v3QgbuG7kWkgbeG6oW5nLiBI4buHIHRo4buRbmcgdGnhur9wIHThu6VjIGNo4bqheSB0cm9uZyB0cuG6oW5nIHRow6FpIGThu68gbGnhu4d1IGLhu4sgaOG7j25nIChDb3JydXB0ZWQgU3RhdGUpLCB04bqhbyByYSBuaOG7r25nIGzhu5dpIGThu68gbGnhu4d1IGPhu7FjIGvhu7Mga2jDsyBkZWJ1Zy4NCiAgIC0gKkJp4buHbiBwaMOhcCo6IEx1w7RuIMSR4buLbmggZGFuaCByw7Ugbmdv4bqhaSBs4buHIGPhu6UgdGjhu4MsIHbDoCBu4bq/dSBraMO0bmcgeOG7rSBsw70gxJHGsOG7o2MgdGjDrCBi4bqvdCBideG7mWMgcGjhuqNpIGLhu41jIGzhu5dpIHbDoCByZS10aHJvdyBob+G6t2MgdHLhuqMgduG7gSBSZXN1bHQgRXJyb3IuDQoNCjIuICoqTG9nIEluamVjdGlvbiBxdWEgVW5lc2NhcGVkIEVycm9yIE1lc3NhZ2VzKio6DQogICAtICpC4bqjbiBjaOG6pXQqOiBM4bqleSB0cuG7sWMgdGnhur9wIGThu68gbGnhu4d1IMSR4bqndSB2w6BvIGPhu6dhIG5nxrDhu51pIGTDuW5nICh2w60gZOG7pTogdMOqbiDEkcSDbmcgbmjhuq1wIGNo4bupYSBrw70gdOG7sSBuZ+G6r3QgZMOybmcgYFxuXHJgKSB2w6AgaW4gdGjhurNuZyB2w6BvIHRow7RuZyBiw6FvIGzhu5dpOiBgbG9nZ2VyLmVycm9yKCJVc2VyICIgKyB1c2VybmFtZSArICIgZmFpbGVkIHRvIGxvZ2luIilgLg0KICAgLSAqUuG7p2kgcm8gYW4gbmluaCo6IEvhursgdOG6pW4gY8O0bmcgY8OzIHRo4buDIGNow6huIGPDoWMgZMOybmcgbG9nIGdp4bqjIG3huqFvIMSR4buDIMSRw6FuaCBs4burYSBr4bu5IHPGsCDEkWnhu4F1IHRyYSBob+G6t2MgdGhhbyB0w7puZyBjw6FjIGPDtG5nIGPhu6UgcGjDom4gdMOtY2ggU0lFTSB04buxIMSR4buZbmcuDQoNCjMuICoqS3ViZXJuZXRlcyBgU0lHS0lMTGAgVMOgbiBTw6F0IEThu68gTGnhu4d1IGRvIFRoaeG6v3UgR3JhY2VmdWwgU2h1dGRvd24qKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IOG7qG5nIGThu6VuZyBraMO0bmcga2hhaSBiw6FvIHRyw6xuaCB44butIGzDvSBgU0lHVEVSTWAgaG/hurdjIHRo4budaSBnaWFuIGThu41uIGThurlwIHbGsOG7o3QgcXXDoSBnacOhIHRy4buLIGB0ZXJtaW5hdGlvbkdyYWNlUGVyaW9kU2Vjb25kc2AgKG3hurdjIMSR4buLbmggJDMwXHRleHR7IGdpw6J5fSQpLg0KICAgLSAqSOG6rXUgcXXhuqMqOiBLdWJlcm5ldGVzIGLhuq9uIGBTSUdLSUxMYCAoTcOjIDEzNykuIFRp4bq/biB0csOsbmggYuG7iyB0acOqdSBkaeG7h3QgbmdheSBs4bqtcCB04bupYyBnaeG7r2EgbMO6YyDEkWFuZyBnaGkgZOG7nyBmaWxlIGhv4bq3YyDEkWFuZyB0aOG7sWMgaGnhu4duIGThu58gZ2lhbyBk4buLY2ggdGhhbmggdG/DoW4gbmfDom4gaMOgbmcsIMSR4buDIGzhuqFpIGPDoWMgYuG6o24gZ2hpIG3hu5MgY8O0aSAoT3JwaGFuIFJlY29yZHMpIHRyb25nIGRhdGFiYXNlLg0KDQotLS0NCg0KIyMgNS4gQuG6o25nIFNvIHPDoW5oICYgRGVjaXNpb24gTWF0cml4DQoNCiMjIyA1LjEuIELhuqNuZyBzbyBzw6FuaCAzIHRyaeG6v3QgbMO9IHjhu60gbMO9IGzhu5dpDQoNCnwgVGnDqnUgQ2jDrSBTbyBTw6FuaCB8IE7DqW0gTmdv4bqhaSBM4buHIChFeGNlcHRpb25zKSB8IEtp4buDdSBE4buvIExp4buHdSBSZXN1bHQgKFJlc3VsdC9FeHBlY3RlZCkgfCBMZXQtaXQtQ3Jhc2ggKFBhbmljL1N1cGVydmlzaW9uKSB8DQp8IDotLS0gfCA6LS0tIHwgOi0tLSB8IDotLS0gfA0KfCAqKkNoaSBwaMOtIHRo4buxYyB0aGkqKiB8IFLhuqV0IGNhbyAoU3RhY2sgVW53aW5kaW5nKSB8ICoqQuG6sW5nIDAgKFplcm8tT3ZlcmhlYWQpKiogfCBUaOG6pXAga2hpIGNo4bqheSBiw6xuaCB0aMaw4budbmcgfA0KfCAqKlTDrW5oIHTGsOG7nW5nIG1pbmggdHJvbmcgY29kZSoqIHwgVGjhuqVwICjhuqluIGdp4bqldSB0cm9uZyBow6BtKSB8ICoqVOG7kWkgxJFhIChu4bqxbSB0cm9uZyBjaOG7ryBrw70gaMOgbSkqKiB8IFRydW5nIGLDrG5oIHwNCnwgKipC4bqjbyDEkeG6o20gY+G7p2EgVHLDrG5oIGJpw6puIGThu4tjaCoqIHwgS2jDtG5nIChob+G6t2MgcGhp4buBbiBwaOG7qWMgbmjGsCBKYXZhKSB8ICoqQuG6r3QgYnXhu5ljIHjhu60gbMO9IHRyxrDhu5tjIGtoaSBs4bqleSBnacOhIHRy4buLKiogfCBC4bqvdCBideG7mWMgdGjDtG5nIHF1YSBwaOG7pWMgaOG7k2kgfA0KfCAqKkTDsm5nIMSRaeG7gXUga2hp4buDbioqIHwgTmjhuqN5IGPDs2MgcGhpIHR1eeG6v24gdMOtbmggfCBUdeG6p24gdOG7sSwgY8OzIHRo4buDIHjDonUgY2h14buXaSBNb25hZGljIHwgTmfhuq90IHRp4bq/biB0csOsbmggfA0KfCAqKk5nw7RuIG5n4buvIHRpw6p1IGJp4buDdSoqIHwgSmF2YSwgQyMsIFB5dGhvbiB8IFJ1c3QsIEMrKzIzLCBTd2lmdCwgSGFza2VsbCB8IEVybGFuZywgRWxpeGlyLCBHbyB8DQoNCiMjIyA1LjIuIERlY2lzaW9uIE1hdHJpeDogS2hpIG7DoG8gbsOqbiBz4butIGThu6VuZyBtw7QgaMOsbmggbsOgbz8NCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IFREDQogICAgRXJyb3JOYXR1cmV7QuG6o24gY2jhuqV0IGPhu6dhIHPhu7EgY+G7kSBsw6AgZ8OsP30NCiAgICBFcnJvck5hdHVyZSAtLT58TOG7l2kgbOG6rXAgdHLDrG5oIG5naGnDqm0gdHLhu41uZzogTmlsIFBvaW50ZXIsIE3huqNuZyBuZ2/DoGkgYmnDqm58IFBhbmljW1BhbmljIC8gTGV0LWl0LWNyYXNoOiBE4burbmcgbmdheSDEkeG7gyB0csOhbmggaOG7j25nIGThu68gbGnhu4d1XQ0KICAgIEVycm9yTmF0dXJlIC0tPnxM4buXaSBuZ2hp4buHcCB24bulIGThu7Ega2nhur9uOiBTYWkgbeG6rXQga2jhuql1LCBI4bq/dCB0aeG7gW4sIEtow7RuZyB0w6xtIHRo4bqleXwgRXhwZWN0ZWRbUmVzdWx0IC8gRXhwZWN0ZWQgUGF0dGVybjogWmVyby1PdmVyaGVhZCwgxJHhu4tuaCBraeG7g3UgY2jhurd0IGNo4bq9XQ0KICAgIEVycm9yTmF0dXJlIC0tPnxHaWFvIHRp4bq/cCBxdWEgSFRUUCBSRVNUIC8gZ1JQQyBBUEl8IFJGQ1tDaHXhuqluIGjDs2EgUGF5bG9hZCB0aGVvIFJGQyA3ODA3IFByb2JsZW0gRGV0YWlsc10NCiAgICBFcnJvck5hdHVyZSAtLT58Tmjhuq1uIHTDrW4gaGnhu4d1IGThu6tuZyB04burIEjhu4cgxJFp4buBdSBow6BuaCBTSUdURVJNfCBHcmFjZWZ1bFtHcmFjZWZ1bCBTaHV0ZG93bjogRHJhaW5pbmcgY29ubmVjdGlvbnMgdHJvbmcgMzBzXQ0KYGBgDQo=