Chế độ giao diện
4.2. Các Phong Cách Kiến Trúc Phổ Biến (Common Architecture Styles)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Không có phong cách kiến trúc nào là "viên đạn bạc" tối thượng; kiến trúc là nghệ thuật quản trị sự đánh đổi (Trade-offs) giữa khả năng mở rộng (Scalability), độ trễ (Latency), độ phức tạp vận hành (Operational Complexity) và chi phí tổ chức (Conway's Law).
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
Ẩn dụ Đời sống: Các Mô Hình Tổ Chức Xã Hội và Nền Kinh Tế
Hãy hình dung các phong cách kiến trúc phần mềm tương tự như các mô hình tổ chức chính trị - kinh tế của xã hội loài người:
- Monolith (Vương quốc Tập quyền): Toàn bộ hoàng gia, quân đội, nông dân và ngân khố tập trung trong một tòa thành kiên cố. Mệnh lệnh truyền đạt tức thì (In-memory latency = nanoseconds), giao dịch tiền tệ nội bộ cực kỳ đơn giản (ACID). Nhưng nếu một bức tường bị sập hoặc dịch bệnh bùng phát, cả vương quốc sụp đổ theo (Single Point of Failure).
- Modular Monolith (Thành trì Phân Khu Độc Lập): Vẫn nằm trong một tòa thành chung, nhưng mỗi khu phố (Thợ rèn, Quân sự, Nông nghiệp) có tường thành riêng, chỉ giao tiếp qua cổng kiểm soát nghiêm ngặt. Rất dễ quản lý và không tốn chi phí xây đường sá liên tỉnh.
- Microservices (Liên Hợp Quốc Các Quốc Gia Độc Lập): Mỗi dịch vụ là một quốc gia có chủ quyền riêng, có luật pháp và ngân khố riêng (Database-per-service). Để giao dịch, các nước phải gửi đại sứ qua đường hàng không hoặc hải cảng (Network hops, HTTP/gRPC). Tự do phát triển và mở rộng dân số, nhưng chi phí ngoại giao, hải quan và rủi ro đứt gãy liên lạc là cực kỳ lớn.
- Event-Driven Architecture (Hãng Thông Tấn Báo Chí Toàn Cầu): Một tòa soạn báo phát hành tin tức (Event). Bất kỳ ai quan tâm đều có thể mua báo đọc mà tòa soạn không cần biết độc giả là ai. Tính tách rời (Decoupling) đạt mức tuyệt đối.
- Space-Based Architecture (Sàn Giao Dịch Chứng Khoán Trên RAM): Không ai đợi thủ thư lục sổ sách dưới hầm (Disk I/O). Mọi giao dịch khớp lệnh diễn ra trực tiếp giữa các nhà môi giới đứng sát nhau trong một căn phòng tràn ngập ánh sáng với tốc độ ánh sáng (In-Memory Data Grid).
graph TD
Styles["Kiến Trúc Phần Mềm (Architecture Styles)"]
Styles --> Monos["1. Monolithic Families"]
Monos --> M1["Monolithic Architecture"]
Monos --> M2["Modular Monolith"]
Monos --> M3["Layered Architecture"]
Styles --> Dist["2. Distributed Families"]
Dist --> D1["Microservices Architecture"]
Dist --> D2["Service-Oriented Architecture (SOA)"]
Dist --> D3["Event-Driven Architecture (EDA)"]
Dist --> D4["Space-Based Architecture (IMDG)"]
Dist --> D5["Shared-Nothing Architecture (SNA)"]
Styles --> Network["3. Network & Compute Topology"]
Network --> N1["Client-Server"]
Network --> N2["Peer-to-Peer (P2P)"]
Network --> N3["Master-Worker"]
Styles --> Patterns["4. Structural & Flow Styles"]
Patterns --> P1["Pipe and Filter"]
Patterns --> P2["Broker Architecture"]
Patterns --> P3["Blackboard Architecture"]
Patterns --> P4["Serverless (FaaS)"]
Patterns --> P5["Plug-in / Microkernel"]
Patterns --> P6["CQRS Architecture"]
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Monolithic Family: Monolith, Modular Monolith & Layered Architecture
1. Monolithic Architecture (Kiến Trúc Khối Đồng Nhất)
- Đặc trưng: Toàn bộ chức năng (Authentication, Payments, Catalog, Notifications) được biên dịch và đóng gói thành một đơn vị triển khai duy nhất (Single Deployment Artifact: 1 file
.war, 1 file nhị phân Go/C++, hoặc 1 Docker Container). - Ưu điểm: Cực kỳ dễ phát triển ban đầu, gỡ lỗi (debugging) đơn giản bằng cách đặt breakpoint trên một tiến trình, kiểm thử E2E trực tiếp, độ trễ giao tiếp giữa các hàm ở mức nano-giây (In-memory calls), giao dịch nhất quán tuyệt đối (ACID DB Transactions).
- Hạn chế: Khi đội ngũ vượt quá 50 kỹ sư, việc merge code xung đột liên tục; triển khai rủi ro cao (sửa một dòng code thông báo cũng phải deploy lại toàn bộ app); khó mở rộng cục bộ (scaling bottlenecks).
2. Modular Monolith (Khối Đồng Nhất Module Hóa)
- Bản chất: Vẫn triển khai dưới dạng một tiến trình duy nhất (Single Binary), nhưng kiến trúc mã nguồn được phân chia thành các Module có ranh giới nghiệp vụ (Bounded Contexts) hoàn toàn độc lập.
- Quy tắc vàng:
- Module
cấm chọc trực tiếp vào Database của Module . - Mọi giao tiếp giữa các Module phải thông qua Public In-Memory Interface (hoặc Domain Events nội bộ).
- Không có chi phí mạng (Zero Network Latency), không cần Kubernetes phức tạp, nhưng duy trì tính tách rời cao, sẵn sàng tách thành Microservices khi cần.
- Module
3. Layered Architecture (Kiến Trúc Phân Tầng)
- Tổ chức theo chiều ngang với các mối quan tâm tách biệt: Presentation
Application Domain Infrastructure / Database. Phù hợp với các hệ thống doanh nghiệp tiêu chuẩn có quy trình xử lý dữ liệu theo luồng.
2.2. Distributed Families: Microservices, SOA & Shared-Nothing Architecture (SNA)
1. Microservices Architecture
- Định nghĩa: Hệ thống gồm nhiều dịch vụ nhỏ, độc lập, loosely coupled, được tổ chức xoay quanh các năng lực nghiệp vụ (Business Capabilities - Bounded Contexts).
- Quy tắc bắt buộc: Database-per-service (Mỗi service sở hữu cơ sở dữ liệu riêng). Dịch vụ này tuyệt đối không được đọc/ghi trực tiếp vào DB của dịch vụ khác. Giao tiếp qua mạng bằng các giao thức nhẹ (gRPC, REST, Kafka).
- Cái giá phải trả:
- Đánh đổi tính nhất quán ACID lấy tính nhất quán sau cùng (Eventual Consistency) qua Saga Pattern.
- Vấn đề Network Latency, Distributed Tracing, Circuit Breaking, Service Mesh.
- Chi phí hạ tầng và vận hành (Kubernetes, Observability) tăng vọt.
2. Service-Oriented Architecture (SOA) vs Microservices
- SOA (Kiến trúc Hướng Dịch Vụ - 2000s): Tập trung vào việc tái sử dụng ứng dụng cấp độ doanh nghiệp lớn thông qua một Enterprise Service Bus (ESB) trung tâm thông minh (Smart Pipes, Dumb Endpoints). Các dịch vụ giao tiếp qua SOAP/XML nặng nề.
- Microservices: Ngược lại hoàn toàn với SOA. Áp dụng triết lý "Smart Endpoints, Dumb Pipes". Bus truyền thông chỉ là message broker thụ động (Kafka/RabbitMQ), toàn bộ logic nghiệp vụ nằm ở biên của các microservices.
3. Shared-Nothing Architecture (SNA)
- Kiến trúc phân tán mà trong đó các nút xử lý (Nodes) hoàn toàn độc lập: Không chia sẻ bộ nhớ RAM (No shared memory), không chia sẻ ổ đĩa cứng (No shared disk), và không có sự phụ thuộc phần cứng tập trung.
- Đây là nền tảng của các hệ thống cơ sở dữ liệu phân tán quy mô hàng ngàn máy chủ (Google Bigtable, Apache Cassandra, Spanner).
2.3. Event-Driven Architecture (EDA) & Space-Based Architecture (IMDG)
1. Event-Driven Architecture (EDA - Kiến Trúc Hướng Sự Kiện)
- Cơ chế: Các thành phần tương tác thông qua việc phát sinh (Produce), phát hiện (Detect), và tiêu thụ (Consume) các Events (sự kiện quá khứ đã diễn ra:
OrderPlaced,PaymentFailed). - Phân loại:
- Broker Topology: Không có bộ điều phối trung tâm. Producers bắn event vào Broker; Consumers tự đăng ký lắng nghe và phản ứng độc lập (Choreography).
- Mediator Topology: Sử dụng một thành phần trung gian (Mediator) để điều phối chuỗi các bước nghiệp vụ phức tạp (Orchestration).
- Ưu điểm: Khả năng mở rộng vô hạn, Loose Coupling tuyệt đối, thông lượng cực cao, phản hồi thời gian thực.
2. Space-Based Architecture (Kiến Trúc Dựa Trên Không Gian Bộ Nhớ)
- Bản chất: Giải quyết triệt để nút thắt cổ chai lớn nhất trong kỹ nghệ phần mềm: Cơ sở dữ liệu tập trung (Central Database).
- Cách thức hoạt động:
- Toàn bộ dữ liệu nghiệp vụ được tải trực tiếp lên một In-Memory Data Grid (IMDG) phân tán (Apache Ignite, Hazelcast, Redis Cluster).
- Các Processing Units (PU) chứa cả logic tính toán lẫn bản sao dữ liệu trong RAM.
- Việc ghi xuống ổ cứng (Database) được tách riêng thành tiến trình phi đồng bộ ở hậu trường (Write-Behind Caching).
- Ứng dụng: Sàn giao dịch chứng khoán Nasdaq/NYSE, hệ thống đặt cược trực tuyến mùa World Cup, hệ thống bán vé hòa nhạc quy mô triệu người.
2.4. Mạng Lưới Phân Phối: Client-Server, Peer-to-Peer (P2P) & Master-Worker
flowchart LR
subgraph ClientServer["Client-Server"]
C1[Client 1] --> Srv[Central Server]
C2[Client 2] --> Srv
end
subgraph P2P["Peer-to-Peer (P2P)"]
P1((Peer A)) <--> P2((Peer B))
P2 <--> P3((Peer C))
P3 <--> P1
end
subgraph MasterWorker["Master-Worker"]
M[Master / Coordinator] --> W1[Worker 1]
M --> W2[Worker 2]
M --> W3[Worker 3]
end
- Client-Server Architecture: Phân định ranh giới giữa nhà cung cấp dịch vụ (Server) và người tiêu dùng (Client). Phù hợp cho 95% các ứng dụng Web/Mobile thông thường.
- Peer-to-Peer Architecture (P2P): Không có máy chủ trung tâm. Mỗi nút tham gia vừa là Client vừa là Server. Có khả năng chịu lỗi tối thượng và chống kiểm duyệt (BitTorrent, Bitcoin, IPFS).
- Master-Worker Architecture: Nút Master chịu trách nhiệm chia nhỏ khối lượng công việc khổng lồ thành các phần độc lập và giao cho các Workers thực thi song song, sau đó thu thập kết quả (MapReduce, Apache Spark, Render Farm đồ họa 3D).
2.5. Structural & Processing Styles: Pipe and Filter, Broker & Blackboard
1. Pipe and Filter Architecture
- Hệ thống chia nhỏ tác vụ xử lý dòng dữ liệu thành một chuỗi các bước độc lập được gọi là Filters, kết nối với nhau qua các đường ống dẫn Pipes.
- Mỗi Filter nhận dữ liệu từ Pipe đầu vào, biến đổi dữ liệu, và đẩy sang Pipe đầu ra.
- Ví dụ kinh điển: Đường ống lệnh UNIX (
cat access.log | grep 404 | awk '{print $1}' | sort | uniq -c), các luồng xử lý video/âm thanh (FFmpeg), và ETL Data Pipelines.
2. Broker Architecture
- Sử dụng một thực thể trung gian (Broker) để kết nối các Clients và Servers một cách gián tiếp. Broker chịu trách nhiệm định tuyến yêu cầu, cân bằng tải, và chuyển đổi giao thức (ví dụ: Apache Kafka, CORBA, MQTT Broker trong IoT).
3. Blackboard Architecture
- Lấy cảm hứng từ một nhóm chuyên gia ngồi trước một bảng đen để cùng giải quyết một bài toán hóc búa:
- Blackboard: Vùng nhớ chia sẻ trung tâm chứa trạng thái bài toán và các giải pháp bộ phận.
- Knowledge Sources (KS): Các module phần mềm chuyên gia độc lập, tự kích hoạt khi thấy dữ liệu trên Blackboard phù hợp với năng lực của mình để giải tiếp.
- Control Component: Bộ điều phối luồng thực thi.
- Ứng dụng: Nhận dạng giọng nói (Speech Recognition), hệ thống AI phân tích tín hiệu radar quân sự, xử lý hình ảnh y tế.
2.6. Modern Application Styles: Serverless (FaaS), Plug-in & CQRS
1. Serverless Architecture (Function-as-a-Service - FaaS)
- Ứng dụng được chia nhỏ thành các hàm không trạng thái (Stateless Functions: AWS Lambda, Cloud Run), chỉ khởi động khi có sự kiện (HTTP Request, File Upload, Cron), tự động co giãn từ 0 lên hàng chục ngàn instances và giảm về 0 khi hết tải.
- Hạn chế: Cold Start latency, phụ thuộc sâu vào nhà cung cấp đám mây (Vendor Lock-in), khó gỡ lỗi cục bộ.
2. Plug-in / Microkernel Architecture
- Hệ thống gồm một Nhân cốt lõi (Core Microkernel) tối giản chỉ chứa các logic tối thiểu, và một tập hợp các Module cắm thêm (Plug-ins) độc lập được đăng ký động để mở rộng tính năng.
- Ví dụ: Trình biên tập mã Visual Studio Code, trình duyệt Google Chrome, Linux Kernel.
3. CQRS Architecture (Command Query Responsibility Segregation)
- Tách đôi hoàn toàn mô hình xử lý hệ thống:
- Command Stack: Tiếp nhận các thao tác ghi/sửa/xóa, tập trung vào bảo vệ tính đúng đắn của Domain Logic và Invariants.
- Query Stack: Tiếp nhận các truy vấn đọc, sử dụng cơ sở dữ liệu phi chuẩn hóa (Read-Optimized Views, Elasticsearch) để trả lời kết quả ở tốc độ cao nhất mà không cần JOIN phức tạp.
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. C++20 Implementation: Asynchronous Multi-Threaded Pipe and Filter Architecture
Chương trình C++20 dưới đây mô phỏng một Data Pipeline theo phong cách Pipe and Filter xử lý luồng dữ liệu song song qua nhiều bước với Bounded Thread-Safe Queues.
cpp
#include <iostream>
#include <vector>
#include <string>
#include <memory>
#include <queue>
#include <mutex>
#include <condition_variable>
#include <thread>
#include <optional>
#include <chrono>
#include <algorithm>
// ============================================================================
// HẠ TẦNG PIPE: HÀNG ĐỢI ĐA LUỒNG AN TOÀN (THREAD-SAFE BOUNDED PIPE)
// ============================================================================
template <typename T>
class Pipe {
private:
std::queue<T> queue_;
mutable std::mutex mtx_;
std::condition_variable cvNotEmpty_;
std::condition_variable cvNotFull_;
size_t capacity_;
bool closed_{false};
public:
explicit Pipe(size_t capacity) : capacity_(capacity) {}
void push(T item) {
std::unique_lock<std::mutex> lock(mtx_);
cvNotFull_.wait(lock, [this]() { return queue_.size() < capacity_ || closed_; });
if (closed_) return;
queue_.push(std::move(item));
cvNotEmpty_.notify_one();
}
std::optional<T> pop() {
std::unique_lock<std::mutex> lock(mtx_);
cvNotEmpty_.wait(lock, [this]() { return !queue_.empty() || closed_; });
if (queue_.empty() && closed_) return std::nullopt;
T item = std::move(queue_.front());
queue_.pop();
cvNotFull_.notify_one();
return item;
}
void close() {
std::lock_guard<std::mutex> lock(mtx_);
closed_ = true;
cvNotEmpty_.notify_all();
cvNotFull_.notify_all();
}
};
// ============================================================================
// MÔ HÌNH HÓA DỮ LIỆU ĐI QUA FILTER
// ============================================================================
struct LogRecord {
uint64_t id;
std::string level;
std::string payload;
};
// ============================================================================
// CÁC FILTERS XỬ LÝ (PROCESSING FILTERS)
// ============================================================================
// Filter 1: Lọc bỏ các bản ghi không phải cảnh báo hoặc lỗi
void errorFilter(Pipe<LogRecord>& inPipe, Pipe<LogRecord>& outPipe) {
while (auto record = inPipe.pop()) {
if (record->level == "WARN" || record->level == "ERROR") {
outPipe.push(*record);
}
}
outPipe.close();
}
// Filter 2: Chuẩn hóa chuỗi payload thành chữ in hoa và gắn timestamp
void transformFilter(Pipe<LogRecord>& inPipe, Pipe<LogRecord>& outPipe) {
while (auto record = inPipe.pop()) {
for (char& c : record->payload) {
c = static_cast<char>(std::toupper(c));
}
record->payload = "[SANITIZED] " + record->payload;
outPipe.push(*record);
}
outPipe.close();
}
int main() {
std::cout << "=== C++20 Multithreaded Pipe and Filter Architecture Demo ===\n";
Pipe<LogRecord> sourcePipe(10);
Pipe<LogRecord> intermediatePipe(10);
Pipe<LogRecord> sinkPipe(10);
// Khởi chạy các Filters trên các luồng OS độc lập
std::thread tFilter1(errorFilter, std::ref(sourcePipe), std::ref(intermediatePipe));
std::thread tFilter2(transformFilter, std::ref(intermediatePipe), std::ref(sinkPipe));
// Bộ phát dữ liệu (Source Producer)
std::vector<LogRecord> rawLogs = {
{1, "INFO", "User logged in"},
{2, "WARN", "Memory usage reached 85%"},
{3, "DEBUG", "Cache hit for key user_101"},
{4, "ERROR", "Database connection pool exhausted"},
{5, "INFO", "Periodic report generated"}
};
std::cout << "[Producer] Feeding " << rawLogs.size() << " log records into Source Pipe...\n";
for (auto& log : rawLogs) {
sourcePipe.push(log);
}
sourcePipe.close();
// Thu nhận kết quả từ Sink Pipe
std::cout << "\n[Sink Output - Filtered & Transformed Logs]:\n";
while (auto processed = sinkPipe.pop()) {
std::cout << " -> Log #" << processed->id
<< " [" << processed->level << "]: "
<< processed->payload << "\n";
}
tFilter1.join();
tFilter2.join();
std::cout << "[Pipeline Execution] Completed cleanly without deadlock!\n";
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
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
Terminal Output Mẫu (C++20):
text
=== C++20 Multithreaded Pipe and Filter Architecture Demo ===
[Producer] Feeding 5 log records into Source Pipe...
[Sink Output - Filtered & Transformed Logs]:
-> Log #2 [WARN]: [SANITIZED] MEMORY USAGE REACHED 85%
-> Log #4 [ERROR]: [SANITIZED] DATABASE CONNECTION POOL EXHAUSTED
[Pipeline Execution] Completed cleanly without deadlock!1
2
3
4
5
6
7
2
3
4
5
6
7
3.2. Python 3.11+ Implementation: Modular Monolith vs Event-Driven Bus Architecture
Script Python 3.11+ dưới đây mô phỏng sự kết hợp giữa Modular Monolith và Event-Driven Architecture (EDA) thông qua một Event Bus nội bộ không đồng bộ, giúp tách rời các phân hệ Orders, Inventory và Notification.
python
from __future__ import annotations
import asyncio
from dataclasses import dataclass, field
from typing import Callable, Coroutine, Any
from datetime import datetime
# ============================================================================
# EVENT DEFINITIONS (IMMUTABLE DOMAIN EVENTS)
# ============================================================================
@dataclass(frozen=True)
class DomainEvent:
occurred_at: datetime = field(default_factory=datetime.utcnow)
@dataclass(frozen=True)
class OrderPlacedEvent(DomainEvent):
order_id: str = ""
customer_id: str = ""
item_sku: str = ""
quantity: int = 0
total_usd: float = 0.0
# ============================================================================
# EVENT-DRIVEN BUS (IN-PROCESS DECOUPLED MESSAGE BROKER)
# ============================================================================
EventHandler = Callable[[Any], Coroutine[Any, Any, None]]
class AsyncEventBus:
def __init__(self):
self._subscribers: dict[type, list[EventHandler]] = {}
def subscribe(self, event_type: type, handler: EventHandler) -> None:
if event_type not in self._subscribers:
self._subscribers[event_type] = []
self._subscribers[event_type].append(handler)
async def publish(self, event: Any) -> None:
event_type = type(event)
handlers = self._subscribers.get(event_type, [])
if not handlers:
return
# Kích hoạt tất cả subscribers bất đồng bộ song song
await asyncio.gather(*(handler(event) for handler in handlers))
# ============================================================================
# MODULE 1: INVENTORY MANAGEMENT MODULE (ISOLATED BOUNDED CONTEXT)
# ============================================================================
class InventoryModule:
def __init__(self, bus: AsyncEventBus):
self.stock: dict[str, int] = {"LAPTOP-M3": 50, "PHONE-15": 100}
bus.subscribe(OrderPlacedEvent, self.on_order_placed)
async def on_order_placed(self, event: OrderPlacedEvent):
# Trừ kho độc lập khi nhận event
await asyncio.sleep(0.01) # Giả lập I/O database
if event.item_sku in self.stock:
self.stock[event.item_sku] -= event.quantity
print(f" [Inventory Module] Deducted {event.quantity} units of {event.item_sku}. "
f"Remaining stock: {self.stock[event.item_sku]}")
# ============================================================================
# MODULE 2: NOTIFICATION MODULE
# ============================================================================
class NotificationModule:
def __init__(self, bus: AsyncEventBus):
bus.subscribe(OrderPlacedEvent, self.on_order_placed)
async def on_order_placed(self, event: OrderPlacedEvent):
await asyncio.sleep(0.02) # Giả lập gửi email qua SMTP
print(f" [Notification Module] Email sent to Customer {event.customer_id}: "
f"Order {event.order_id} confirmed (${event.total_usd:.2f})")
# ============================================================================
# MODULE 3: ORDER SERVICE (PRODUCER)
# ============================================================================
class OrderModule:
def __init__(self, bus: AsyncEventBus):
self.bus = bus
async def place_order(self, order_id: str, customer_id: str, sku: str, qty: int, price: float):
print(f"\n[Order Module] Placing Order {order_id}...")
# 1. Thực hiện lưu trữ đơn hàng nội bộ
# 2. Phát tán Domain Event ra Event Bus
event = OrderPlacedEvent(
order_id=order_id,
customer_id=customer_id,
item_sku=sku,
quantity=qty,
total_usd=price * qty
)
await self.bus.publish(event)
async def main():
print("=== Python 3.11+ Modular Monolith with Event Bus Architecture ===")
event_bus = AsyncEventBus()
# Khởi tạo các Modules độc lập (Loose Coupling)
_inventory = InventoryModule(event_bus)
_notifications = NotificationModule(event_bus)
orders = OrderModule(event_bus)
# Đặt hàng liên tiếp
await orders.place_order("ORD-101", "CUST-A", "LAPTOP-M3", 2, 1999.99)
await orders.place_order("ORD-102", "CUST-B", "PHONE-15", 5, 999.00)
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
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
Terminal Output Mẫu (Python 3.11+):
text
=== Python 3.11+ Modular Monolith with Event Bus Architecture ===
[Order Module] Placing Order ORD-101...
[Inventory Module] Deducted 2 units of LAPTOP-M3. Remaining stock: 48
[Notification Module] Email sent to Customer CUST-A: Order ORD-101 confirmed ($3999.98)
[Order Module] Placing Order ORD-102...
[Inventory Module] Deducted 5 units of PHONE-15. Remaining stock: 95
[Notification Module] Email sent to Customer CUST-B: Order ORD-102 confirmed ($4995.00)1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
4. Systems Engineering & Production Pitfalls
Các Cạm Bẫy Thực Chiến (Gotchas & Production Antipatterns)
Cơn Ác Mộng Khối Đồng Nhất Phân Tán (Distributed Monolith):
- Bản chất: Chia nhỏ hệ thống thành 50 Microservices nhưng các services lại gọi nhau bằng các lệnh HTTP đồng bộ dây chuyền (Chained REST Calls: Service
). Nếu Service bị chậm 2 giây, toàn bộ chuỗi nghẽn mạng; nếu một service deploy phiên bản mới, tất cả 49 services còn lại phải deploy theo vì phụ thuộc chặt chẽ về schema! - Khắc phục: Tách rời bằng Event-Driven phi đồng bộ (EDA) hoặc quay lại với Modular Monolith.
- Bản chất: Chia nhỏ hệ thống thành 50 Microservices nhưng các services lại gọi nhau bằng các lệnh HTTP đồng bộ dây chuyền (Chained REST Calls: Service
Vấn Đề Ghi Kép Dữ Liệu (The Dual-Write Problem):
- Bản chất: Khi một service vừa muốn cập nhật Database của mình vừa muốn gửi một Event lên Kafka. Nếu lưu DB thành công nhưng mạng rớt không gửi được Kafka (hoặc ngược lại), hệ thống phân tán rơi vào trạng thái bất nhất vĩnh viễn.
- Khắc phục: Bắt buộc phải áp dụng Transactional Outbox Pattern kết hợp với Change Data Capture (Debezium) để đảm bảo Event được phát đi một cách nguyên tử.
Cái Bẫy Đứt Gãy Nhất Quán Trong Space-Based Architecture:
- Bản chất: Lưu trữ toàn bộ dữ liệu trên RAM để đạt tốc độ cao. Nếu một sự cố mất điện đột ngột xảy ra trên cụm máy chủ trước khi tiến trình Write-Behind kịp ghi dữ liệu từ RAM xuống Disk, các giao dịch tài chính vừa khớp lệnh sẽ bốc hơi không dấu vết.
- Khắc phục: Sử dụng Non-Volatile Memory (NVDIMM/Optane) hoặc cơ chế đồng bộ RAM Replication qua mạng băng thông rộng RDMA với Quorum tối thiểu trước khi xác nhận giao dịch.
Kỹ Thuật Chẩn Đoán & Giám Sát Kiến Trúc Bằng CLI:
bash# 1. Giám sát độ trễ mạng giữa các Microservices bằng Jaeger CLI / OpenTelemetry jaeger-query --config=telemetry.yaml --trace-id=4bf92f3577b34da6a3ce929d0e0e4736 # 2. Kiểm tra tình trạng kết nối Kafka Broker cho Event-Driven Architecture kafka-consumer-groups.sh --bootstrap-server localhost:9092 --describe --group order-processors # 3. Phân tích tài nguyên RAM và độ trễ của In-Memory Grid (Redis Cluster) redis-cli --cluster info 127.0.0.1:70001
2
3
4
5
6
7
8
5. Bảng So sánh & Decision Matrix
5.1. Ma Trận Đánh Giá Toàn Diện Các Phong Cách Kiến Trúc
| Phong Cách Kiến Trúc | Khả Năng Mở Rộng (Scalability) | Độ Trễ (Latency) | Độ Phức Tạp Vận Hành | Tính Nhất Quán (Consistency) | Ngữ Cảnh Tối Ưu Nhất |
|---|---|---|---|---|---|
| Monolith Cổ Điển | Thấp | Cực thấp ( | Rất thấp | ACID Tuyệt Đối | Sản phẩm mới (MVP), Startup, Tải thấp |
| Modular Monolith | Trung bình - Cao | Cực thấp ( | Thấp | ACID Tuyệt Đối | 90% ứng dụng doanh nghiệp vừa & lớn |
| Microservices | Cực cao | Trung bình - Cao ( | Rất cao | Eventual Consistency | Đội ngũ > 100 kỹ sư, nhiều domain độc lập |
| Event-Driven (EDA) | Vô hạn | Biến thiên (Async) | Cao | Eventual Consistency | Hệ thống phản hồi thời gian thực, IoT, Streaming |
| Space-Based (IMDG) | Cực hạn | Siêu thấp ( | Cực cao | Memory-First / Async Disk | Sàn chứng khoán, đấu giá, game thời gian thực |
| Serverless (FaaS) | Tự động vô hạn | Cao (Cold Starts) | Trung bình | Tùy thuộc Backend DB | Tác vụ định kỳ, xử lý ảnh/video nền, Webhook |
| Pipe and Filter | Cao (Từng stage) | Phụ thuộc ống dẫn | Thấp | Tuần tự theo luồng | Trình biên dịch, mã hóa video, Big Data ETL |
| Plug-in / Kernel | Thấp - TB | Rất thấp | Thấp | Nội tại tiến trình | Desktop Apps (VS Code), Hệ điều hành, CMS |
IyA0LjIuIEPDoWMgUGhvbmcgQ8OhY2ggS2nhur9uIFRyw7pjIFBo4buVIEJp4bq/biAoQ29tbW9uIEFyY2hpdGVjdHVyZSBTdHlsZXMpDQoNCj4gWyFJTVBPUlRBTlRdDQo+ICoqTuG6v3UgYuG6oW4gY2jhu4kgxJHGsOG7o2Mgbmjhu5sgbeG7mXQgxJFp4buBdSBkdXkgbmjhuqV0OioqIEtow7RuZyBjw7MgcGhvbmcgY8OhY2gga2nhur9uIHRyw7pjIG7DoG8gbMOgICJ2acOqbiDEkeG6oW4gYuG6oWMiIHThu5FpIHRoxrDhu6NuZzsga2nhur9uIHRyw7pjIGzDoCBuZ2jhu4cgdGh14bqtdCBxdeG6o24gdHLhu4sgc+G7sSDEkcOhbmggxJHhu5VpIChUcmFkZS1vZmZzKSBnaeG7r2Ega2jhuqMgbsSDbmcgbeG7nyBy4buZbmcgKFNjYWxhYmlsaXR5KSwgxJHhu5kgdHLhu4UgKExhdGVuY3kpLCDEkeG7mSBwaOG7qWMgdOG6oXAgduG6rW4gaMOgbmggKE9wZXJhdGlvbmFsIENvbXBsZXhpdHkpIHbDoCBjaGkgcGjDrSB04buVIGNo4bupYyAoQ29ud2F5J3MgTGF3KS4NCg0KLS0tDQoNCiMjIDEuIEtp4bq/biB0csO6YyBU4buVbmcgcXVhbiAmIE3DtCBow6xuaCBUxrAgZHV5IChNZW50YWwgTW9kZWwpDQoNCiMjIyDhuqhuIGThu6UgxJDhu51pIHPhu5FuZzogQ8OhYyBNw7QgSMOsbmggVOG7lSBDaOG7qWMgWMOjIEjhu5lpIHbDoCBO4buBbiBLaW5oIFThur8NCkjDo3kgaMOsbmggZHVuZyBjw6FjIHBob25nIGPDoWNoIGtp4bq/biB0csO6YyBwaOG6p24gbeG7gW0gdMawxqFuZyB04buxIG5oxrAgY8OhYyBtw7QgaMOsbmggdOG7lSBjaOG7qWMgY2jDrW5oIHRy4buLIC0ga2luaCB04bq/IGPhu6dhIHjDoyBo4buZaSBsb8OgaSBuZ8aw4budaToNCi0gKipNb25vbGl0aCAoVsawxqFuZyBxdeG7kWMgVOG6rXAgcXV54buBbikqKjogVG/DoG4gYuG7mSBob8OgbmcgZ2lhLCBxdcOibiDEkeG7mWksIG7DtG5nIGTDom4gdsOgIG5nw6JuIGto4buRIHThuq1wIHRydW5nIHRyb25nIG3hu5l0IHTDsmEgdGjDoG5oIGtpw6puIGPhu5EuIE3hu4duaCBs4buHbmggdHJ1eeG7gW4gxJHhuqF0IHThu6ljIHRow6wgKEluLW1lbW9yeSBsYXRlbmN5ID0gbmFub3NlY29uZHMpLCBnaWFvIGThu4tjaCB0aeG7gW4gdOG7hyBu4buZaSBi4buZIGPhu7FjIGvhu7MgxJHGoW4gZ2nhuqNuIChBQ0lEKS4gTmjGsG5nIG7hur91IG3hu5l0IGLhu6ljIHTGsOG7nW5nIGLhu4sgc+G6rXAgaG/hurdjIGThu4tjaCBi4buHbmggYsO5bmcgcGjDoXQsIGPhuqMgdsawxqFuZyBxdeG7kWMgc+G7pXAgxJHhu5UgdGhlbyAoU2luZ2xlIFBvaW50IG9mIEZhaWx1cmUpLg0KLSAqKk1vZHVsYXIgTW9ub2xpdGggKFRow6BuaCB0csOsIFBow6JuIEtodSDEkOG7mWMgTOG6rXApKio6IFbhuqtuIG7hurFtIHRyb25nIG3hu5l0IHTDsmEgdGjDoG5oIGNodW5nLCBuaMawbmcgbeG7l2kga2h1IHBo4buRIChUaOG7oyByw6huLCBRdcOibiBz4buxLCBOw7RuZyBuZ2hp4buHcCkgY8OzIHTGsOG7nW5nIHRow6BuaCByacOqbmcsIGNo4buJIGdpYW8gdGnhur9wIHF1YSBj4buVbmcga2nhu4NtIHNvw6F0IG5naGnDqm0gbmfhurd0LiBS4bqldCBk4buFIHF14bqjbiBsw70gdsOgIGtow7RuZyB04buRbiBjaGkgcGjDrSB4w6J5IMSRxrDhu51uZyBzw6EgbGnDqm4gdOG7iW5oLg0KLSAqKk1pY3Jvc2VydmljZXMgKExpw6puIEjhu6NwIFF14buRYyBDw6FjIFF14buRYyBHaWEgxJDhu5ljIEzhuq1wKSoqOiBN4buXaSBk4buLY2ggduG7pSBsw6AgbeG7mXQgcXXhu5FjIGdpYSBjw7MgY2jhu6cgcXV54buBbiByacOqbmcsIGPDsyBsdeG6rXQgcGjDoXAgdsOgIG5nw6JuIGto4buRIHJpw6puZyAoRGF0YWJhc2UtcGVyLXNlcnZpY2UpLiDEkOG7gyBnaWFvIGThu4tjaCwgY8OhYyBuxrDhu5tjIHBo4bqjaSBn4butaSDEkeG6oWkgc+G7qSBxdWEgxJHGsOG7nW5nIGjDoG5nIGtow7RuZyBob+G6t2MgaOG6o2kgY+G6o25nIChOZXR3b3JrIGhvcHMsIEhUVFAvZ1JQQykuIFThu7EgZG8gcGjDoXQgdHJp4buDbiB2w6AgbeG7nyBy4buZbmcgZMOibiBz4buRLCBuaMawbmcgY2hpIHBow60gbmdv4bqhaSBnaWFvLCBo4bqjaSBxdWFuIHbDoCBy4bunaSBybyDEkeG7qXQgZ8OjeSBsacOqbiBs4bqhYyBsw6AgY+G7sWMga+G7syBs4bubbi4NCi0gKipFdmVudC1Ecml2ZW4gQXJjaGl0ZWN0dXJlIChIw6NuZyBUaMO0bmcgVOG6pW4gQsOhbyBDaMOtIFRvw6BuIEPhuqd1KSoqOiBN4buZdCB0w7JhIHNv4bqhbiBiw6FvIHBow6F0IGjDoG5oIHRpbiB04bupYyAoRXZlbnQpLiBC4bqldCBr4buzIGFpIHF1YW4gdMOibSDEkeG7gXUgY8OzIHRo4buDIG11YSBiw6FvIMSR4buNYyBtw6AgdMOyYSBzb+G6oW4ga2jDtG5nIGPhuqduIGJp4bq/dCDEkeG7mWMgZ2nhuqMgbMOgIGFpLiBUw61uaCB0w6FjaCBy4budaSAoRGVjb3VwbGluZykgxJHhuqF0IG3hu6ljIHR1eeG7h3QgxJHhu5FpLg0KLSAqKlNwYWNlLUJhc2VkIEFyY2hpdGVjdHVyZSAoU8OgbiBHaWFvIEThu4tjaCBDaOG7qW5nIEtob8OhbiBUcsOqbiBSQU0pKio6IEtow7RuZyBhaSDEkeG7o2kgdGjhu6cgdGjGsCBs4bulYyBz4buVIHPDoWNoIGTGsOG7m2kgaOG6p20gKERpc2sgSS9PKS4gTeG7jWkgZ2lhbyBk4buLY2gga2jhu5twIGzhu4duaCBkaeG7hW4gcmEgdHLhu7FjIHRp4bq/cCBnaeG7r2EgY8OhYyBuaMOgIG3DtGkgZ2nhu5tpIMSR4bupbmcgc8OhdCBuaGF1IHRyb25nIG3hu5l0IGPEg24gcGjDsm5nIHRyw6BuIG5n4bqtcCDDoW5oIHPDoW5nIHbhu5tpIHThu5FjIMSR4buZIMOhbmggc8OhbmcgKEluLU1lbW9yeSBEYXRhIEdyaWQpLg0KDQpgYGBtZXJtYWlkDQpncmFwaCBURA0KICAgIFN0eWxlc1siS2nhur9uIFRyw7pjIFBo4bqnbiBN4buBbSAoQXJjaGl0ZWN0dXJlIFN0eWxlcykiXQ0KICAgIA0KICAgIFN0eWxlcyAtLT4gTW9ub3NbIjEuIE1vbm9saXRoaWMgRmFtaWxpZXMiXQ0KICAgIE1vbm9zIC0tPiBNMVsiTW9ub2xpdGhpYyBBcmNoaXRlY3R1cmUiXQ0KICAgIE1vbm9zIC0tPiBNMlsiTW9kdWxhciBNb25vbGl0aCJdDQogICAgTW9ub3MgLS0+IE0zWyJMYXllcmVkIEFyY2hpdGVjdHVyZSJdDQogICAgDQogICAgU3R5bGVzIC0tPiBEaXN0WyIyLiBEaXN0cmlidXRlZCBGYW1pbGllcyJdDQogICAgRGlzdCAtLT4gRDFbIk1pY3Jvc2VydmljZXMgQXJjaGl0ZWN0dXJlIl0NCiAgICBEaXN0IC0tPiBEMlsiU2VydmljZS1PcmllbnRlZCBBcmNoaXRlY3R1cmUgKFNPQSkiXQ0KICAgIERpc3QgLS0+IEQzWyJFdmVudC1Ecml2ZW4gQXJjaGl0ZWN0dXJlIChFREEpIl0NCiAgICBEaXN0IC0tPiBENFsiU3BhY2UtQmFzZWQgQXJjaGl0ZWN0dXJlIChJTURHKSJdDQogICAgRGlzdCAtLT4gRDVbIlNoYXJlZC1Ob3RoaW5nIEFyY2hpdGVjdHVyZSAoU05BKSJdDQogICAgDQogICAgU3R5bGVzIC0tPiBOZXR3b3JrWyIzLiBOZXR3b3JrICYgQ29tcHV0ZSBUb3BvbG9neSJdDQogICAgTmV0d29yayAtLT4gTjFbIkNsaWVudC1TZXJ2ZXIiXQ0KICAgIE5ldHdvcmsgLS0+IE4yWyJQZWVyLXRvLVBlZXIgKFAyUCkiXQ0KICAgIE5ldHdvcmsgLS0+IE4zWyJNYXN0ZXItV29ya2VyIl0NCiAgICANCiAgICBTdHlsZXMgLS0+IFBhdHRlcm5zWyI0LiBTdHJ1Y3R1cmFsICYgRmxvdyBTdHlsZXMiXQ0KICAgIFBhdHRlcm5zIC0tPiBQMVsiUGlwZSBhbmQgRmlsdGVyIl0NCiAgICBQYXR0ZXJucyAtLT4gUDJbIkJyb2tlciBBcmNoaXRlY3R1cmUiXQ0KICAgIFBhdHRlcm5zIC0tPiBQM1siQmxhY2tib2FyZCBBcmNoaXRlY3R1cmUiXQ0KICAgIFBhdHRlcm5zIC0tPiBQNFsiU2VydmVybGVzcyAoRmFhUykiXQ0KICAgIFBhdHRlcm5zIC0tPiBQNVsiUGx1Zy1pbiAvIE1pY3Jva2VybmVsIl0NCiAgICBQYXR0ZXJucyAtLT4gUDZbIkNRUlMgQXJjaGl0ZWN0dXJlIl0NCmBgYA0KDQotLS0NCg0KIyMgMi4gQ2hpIHRp4bq/dCB04burbmcgS2V5d29yZCAoVW5kZXItdGhlLUhvb2QgRGVlcCBEaXZlKQ0KDQojIyMgMi4xLiBNb25vbGl0aGljIEZhbWlseTogTW9ub2xpdGgsIE1vZHVsYXIgTW9ub2xpdGggJiBMYXllcmVkIEFyY2hpdGVjdHVyZQ0KDQojIyMjIDEuIE1vbm9saXRoaWMgQXJjaGl0ZWN0dXJlIChLaeG6v24gVHLDumMgS2jhu5FpIMSQ4buTbmcgTmjhuqV0KQ0KLSAqKsSQ4bq3YyB0csawbmcqKjogVG/DoG4gYuG7mSBjaOG7qWMgbsSDbmcgKEF1dGhlbnRpY2F0aW9uLCBQYXltZW50cywgQ2F0YWxvZywgTm90aWZpY2F0aW9ucykgxJHGsOG7o2MgYmnDqm4gZOG7i2NoIHbDoCDEkcOzbmcgZ8OzaSB0aMOgbmggbeG7mXQgxJHGoW4gduG7iyB0cmnhu4NuIGtoYWkgZHV5IG5o4bqldCAoU2luZ2xlIERlcGxveW1lbnQgQXJ0aWZhY3Q6IDEgZmlsZSBgLndhcmAsIDEgZmlsZSBuaOG7iyBwaMOibiBHby9DKyssIGhv4bq3YyAxIERvY2tlciBDb250YWluZXIpLg0KLSAqKsavdSDEkWnhu4NtKio6IEPhu7FjIGvhu7MgZOG7hSBwaMOhdCB0cmnhu4NuIGJhbiDEkeG6p3UsIGfhu6EgbOG7l2kgKGRlYnVnZ2luZykgxJHGoW4gZ2nhuqNuIGLhurFuZyBjw6FjaCDEkeG6t3QgYnJlYWtwb2ludCB0csOqbiBt4buZdCB0aeG6v24gdHLDrG5oLCBraeG7g20gdGjhu60gRTJFIHRy4buxYyB0aeG6v3AsIMSR4buZIHRy4buFIGdpYW8gdGnhur9wIGdp4buvYSBjw6FjIGjDoG0g4bufIG3hu6ljIG5hbm8tZ2nDonkgKEluLW1lbW9yeSBjYWxscyksIGdpYW8gZOG7i2NoIG5o4bqldCBxdcOhbiB0dXnhu4d0IMSR4buRaSAoQUNJRCBEQiBUcmFuc2FjdGlvbnMpLg0KLSAqKkjhuqFuIGNo4bq/Kio6IEtoaSDEkeG7mWkgbmfFqSB2xrDhu6N0IHF1w6EgNTAga+G7uSBzxrAsIHZp4buHYyBtZXJnZSBjb2RlIHh1bmcgxJHhu5l0IGxpw6puIHThu6VjOyB0cmnhu4NuIGtoYWkgcuG7p2kgcm8gY2FvIChz4butYSBt4buZdCBkw7JuZyBjb2RlIHRow7RuZyBiw6FvIGPFqW5nIHBo4bqjaSBkZXBsb3kgbOG6oWkgdG/DoG4gYuG7mSBhcHApOyBraMOzIG3hu58gcuG7mW5nIGPhu6VjIGLhu5kgKHNjYWxpbmcgYm90dGxlbmVja3MpLg0KDQojIyMjIDIuIE1vZHVsYXIgTW9ub2xpdGggKEto4buRaSDEkOG7k25nIE5o4bqldCBNb2R1bGUgSMOzYSkNCi0gKipC4bqjbiBjaOG6pXQqKjogVuG6q24gdHJp4buDbiBraGFpIGTGsOG7m2kgZOG6oW5nIG3hu5l0IHRp4bq/biB0csOsbmggZHV5IG5o4bqldCAoU2luZ2xlIEJpbmFyeSksIG5oxrBuZyBraeG6v24gdHLDumMgbcOjIG5ndeG7k24gxJHGsOG7o2MgcGjDom4gY2hpYSB0aMOgbmggY8OhYyBNb2R1bGUgY8OzIHJhbmggZ2nhu5tpIG5naGnhu4dwIHbhu6UgKEJvdW5kZWQgQ29udGV4dHMpIGhvw6BuIHRvw6BuIMSR4buZYyBs4bqtcC4NCi0gKipRdXkgdOG6r2MgdsOgbmcqKjoNCiAgLSBNb2R1bGUgJEEkIGPhuqVtIGNo4buNYyB0cuG7sWMgdGnhur9wIHbDoG8gRGF0YWJhc2UgY+G7p2EgTW9kdWxlICRCJC4NCiAgLSBN4buNaSBnaWFvIHRp4bq/cCBnaeG7r2EgY8OhYyBNb2R1bGUgcGjhuqNpIHRow7RuZyBxdWEgUHVibGljIEluLU1lbW9yeSBJbnRlcmZhY2UgKGhv4bq3YyBEb21haW4gRXZlbnRzIG7hu5lpIGLhu5kpLg0KICAtIEtow7RuZyBjw7MgY2hpIHBow60gbeG6oW5nIChaZXJvIE5ldHdvcmsgTGF0ZW5jeSksIGtow7RuZyBj4bqnbiBLdWJlcm5ldGVzIHBo4bupYyB04bqhcCwgbmjGsG5nIGR1eSB0csOsIHTDrW5oIHTDoWNoIHLhu51pIGNhbywgc+G6tW4gc8OgbmcgdMOhY2ggdGjDoG5oIE1pY3Jvc2VydmljZXMga2hpIGPhuqduLg0KDQojIyMjIDMuIExheWVyZWQgQXJjaGl0ZWN0dXJlIChLaeG6v24gVHLDumMgUGjDom4gVOG6p25nKQ0KLSBU4buVIGNo4bupYyB0aGVvIGNoaeG7gXUgbmdhbmcgduG7m2kgY8OhYyBt4buRaSBxdWFuIHTDom0gdMOhY2ggYmnhu4d0OiBQcmVzZW50YXRpb24gJFx0byQgQXBwbGljYXRpb24gJFx0byQgRG9tYWluICRcdG8kIEluZnJhc3RydWN0dXJlIC8gRGF0YWJhc2UuIFBow7kgaOG7o3AgduG7m2kgY8OhYyBo4buHIHRo4buRbmcgZG9hbmggbmdoaeG7h3AgdGnDqnUgY2h14bqpbiBjw7MgcXV5IHRyw6xuaCB44butIGzDvSBk4buvIGxp4buHdSB0aGVvIGx14buTbmcuDQoNCi0tLQ0KDQojIyMgMi4yLiBEaXN0cmlidXRlZCBGYW1pbGllczogTWljcm9zZXJ2aWNlcywgU09BICYgU2hhcmVkLU5vdGhpbmcgQXJjaGl0ZWN0dXJlIChTTkEpDQoNCiMjIyMgMS4gTWljcm9zZXJ2aWNlcyBBcmNoaXRlY3R1cmUNCi0gKirEkOG7i25oIG5naMSpYSoqOiBI4buHIHRo4buRbmcgZ+G7k20gbmhp4buBdSBk4buLY2ggduG7pSBuaOG7jywgxJHhu5ljIGzhuq1wLCBsb29zZWx5IGNvdXBsZWQsIMSRxrDhu6NjIHThu5UgY2jhu6ljIHhvYXkgcXVhbmggY8OhYyBuxINuZyBs4buxYyBuZ2hp4buHcCB24bulIChCdXNpbmVzcyBDYXBhYmlsaXRpZXMgLSBCb3VuZGVkIENvbnRleHRzKS4NCi0gKipRdXkgdOG6r2MgYuG6r3QgYnXhu5ljKio6ICoqRGF0YWJhc2UtcGVyLXNlcnZpY2UqKiAoTeG7l2kgc2VydmljZSBz4bufIGjhu691IGPGoSBz4bufIGThu68gbGnhu4d1IHJpw6puZykuIEThu4tjaCB24bulIG7DoHkgdHV54buHdCDEkeG7kWkga2jDtG5nIMSRxrDhu6NjIMSR4buNYy9naGkgdHLhu7FjIHRp4bq/cCB2w6BvIERCIGPhu6dhIGThu4tjaCB24bulIGtow6FjLiBHaWFvIHRp4bq/cCBxdWEgbeG6oW5nIGLhurFuZyBjw6FjIGdpYW8gdGjhu6ljIG5o4bq5IChnUlBDLCBSRVNULCBLYWZrYSkuDQotICoqQ8OhaSBnacOhIHBo4bqjaSB0cuG6oyoqOg0KICAtIMSQw6FuaCDEkeG7lWkgdMOtbmggbmjhuqV0IHF1w6FuIEFDSUQgbOG6pXkgdMOtbmggbmjhuqV0IHF1w6FuIHNhdSBjw7luZyAoRXZlbnR1YWwgQ29uc2lzdGVuY3kpIHF1YSBTYWdhIFBhdHRlcm4uDQogIC0gVuG6pW4gxJHhu4EgTmV0d29yayBMYXRlbmN5LCBEaXN0cmlidXRlZCBUcmFjaW5nLCBDaXJjdWl0IEJyZWFraW5nLCBTZXJ2aWNlIE1lc2guDQogIC0gQ2hpIHBow60gaOG6oSB04bqnbmcgdsOgIHbhuq1uIGjDoG5oIChLdWJlcm5ldGVzLCBPYnNlcnZhYmlsaXR5KSB0xINuZyB24buNdC4NCg0KIyMjIyAyLiBTZXJ2aWNlLU9yaWVudGVkIEFyY2hpdGVjdHVyZSAoU09BKSB2cyBNaWNyb3NlcnZpY2VzDQotICoqU09BIChLaeG6v24gdHLDumMgSMaw4bubbmcgROG7i2NoIFbhu6UgLSAyMDAwcykqKjogVOG6rXAgdHJ1bmcgdsOgbyB2aeG7h2MgdMOhaSBz4butIGThu6VuZyDhu6luZyBk4bulbmcgY+G6pXAgxJHhu5kgZG9hbmggbmdoaeG7h3AgbOG7m24gdGjDtG5nIHF1YSBt4buZdCAqKkVudGVycHJpc2UgU2VydmljZSBCdXMgKEVTQikqKiB0cnVuZyB0w6JtIHRow7RuZyBtaW5oIChTbWFydCBQaXBlcywgRHVtYiBFbmRwb2ludHMpLiBDw6FjIGThu4tjaCB24bulIGdpYW8gdGnhur9wIHF1YSBTT0FQL1hNTCBu4bq3bmcgbuG7gS4NCi0gKipNaWNyb3NlcnZpY2VzKio6IE5nxrDhu6NjIGzhuqFpIGhvw6BuIHRvw6BuIHbhu5tpIFNPQS4gw4FwIGThu6VuZyB0cmnhur90IGzDvSAqIlNtYXJ0IEVuZHBvaW50cywgRHVtYiBQaXBlcyIqLiBCdXMgdHJ1eeG7gW4gdGjDtG5nIGNo4buJIGzDoCBtZXNzYWdlIGJyb2tlciB0aOG7pSDEkeG7mW5nIChLYWZrYS9SYWJiaXRNUSksIHRvw6BuIGLhu5kgbG9naWMgbmdoaeG7h3AgduG7pSBu4bqxbSDhu58gYmnDqm4gY+G7p2EgY8OhYyBtaWNyb3NlcnZpY2VzLg0KDQojIyMjIDMuIFNoYXJlZC1Ob3RoaW5nIEFyY2hpdGVjdHVyZSAoU05BKQ0KLSBLaeG6v24gdHLDumMgcGjDom4gdMOhbiBtw6AgdHJvbmcgxJHDsyBjw6FjIG7DunQgeOG7rSBsw70gKE5vZGVzKSBob8OgbiB0b8OgbiDEkeG7mWMgbOG6rXA6IEtow7RuZyBjaGlhIHPhursgYuG7mSBuaOG7myBSQU0gKE5vIHNoYXJlZCBtZW1vcnkpLCBraMO0bmcgY2hpYSBz4bq7IOG7lSDEkcSpYSBj4bupbmcgKE5vIHNoYXJlZCBkaXNrKSwgdsOgIGtow7RuZyBjw7Mgc+G7sSBwaOG7pSB0aHXhu5ljIHBo4bqnbiBj4bupbmcgdOG6rXAgdHJ1bmcuDQotIMSQw6J5IGzDoCBu4buBbiB04bqjbmcgY+G7p2EgY8OhYyBo4buHIHRo4buRbmcgY8ahIHPhu58gZOG7ryBsaeG7h3UgcGjDom4gdMOhbiBxdXkgbcO0IGjDoG5nIG5nw6BuIG3DoXkgY2jhu6cgKEdvb2dsZSBCaWd0YWJsZSwgQXBhY2hlIENhc3NhbmRyYSwgU3Bhbm5lcikuDQoNCi0tLQ0KDQojIyMgMi4zLiBFdmVudC1Ecml2ZW4gQXJjaGl0ZWN0dXJlIChFREEpICYgU3BhY2UtQmFzZWQgQXJjaGl0ZWN0dXJlIChJTURHKQ0KDQojIyMjIDEuIEV2ZW50LURyaXZlbiBBcmNoaXRlY3R1cmUgKEVEQSAtIEtp4bq/biBUcsO6YyBIxrDhu5tuZyBT4buxIEtp4buHbikNCi0gKipDxqEgY2jhur8qKjogQ8OhYyB0aMOgbmggcGjhuqduIHTGsMahbmcgdMOhYyB0aMO0bmcgcXVhIHZp4buHYyBwaMOhdCBzaW5oIChQcm9kdWNlKSwgcGjDoXQgaGnhu4duIChEZXRlY3QpLCB2w6AgdGnDqnUgdGjhu6UgKENvbnN1bWUpIGPDoWMgKipFdmVudHMqKiAoc+G7sSBraeG7h24gcXXDoSBraOG7qSDEkcOjIGRp4buFbiByYTogYE9yZGVyUGxhY2VkYCwgYFBheW1lbnRGYWlsZWRgKS4NCi0gKipQaMOibiBsb+G6oWkqKjoNCiAgLSAqQnJva2VyIFRvcG9sb2d5KjogS2jDtG5nIGPDsyBi4buZIMSRaeG7gXUgcGjhu5FpIHRydW5nIHTDom0uIFByb2R1Y2VycyBi4bqvbiBldmVudCB2w6BvIEJyb2tlcjsgQ29uc3VtZXJzIHThu7EgxJHEg25nIGvDvSBs4bqvbmcgbmdoZSB2w6AgcGjhuqNuIOG7qW5nIMSR4buZYyBs4bqtcCAoQ2hvcmVvZ3JhcGh5KS4NCiAgLSAqTWVkaWF0b3IgVG9wb2xvZ3kqOiBT4butIGThu6VuZyBt4buZdCB0aMOgbmggcGjhuqduIHRydW5nIGdpYW4gKE1lZGlhdG9yKSDEkeG7gyDEkWnhu4F1IHBo4buRaSBjaHXhu5dpIGPDoWMgYsaw4bubYyBuZ2hp4buHcCB24bulIHBo4bupYyB04bqhcCAoT3JjaGVzdHJhdGlvbikuDQotICoqxq91IMSRaeG7g20qKjogS2jhuqMgbsSDbmcgbeG7nyBy4buZbmcgdsO0IGjhuqFuLCBMb29zZSBDb3VwbGluZyB0dXnhu4d0IMSR4buRaSwgdGjDtG5nIGzGsOG7o25nIGPhu7FjIGNhbywgcGjhuqNuIGjhu5NpIHRo4budaSBnaWFuIHRo4buxYy4NCg0KIyMjIyAyLiBTcGFjZS1CYXNlZCBBcmNoaXRlY3R1cmUgKEtp4bq/biBUcsO6YyBE4buxYSBUcsOqbiBLaMO0bmcgR2lhbiBC4buZIE5o4bubKQ0KLSAqKkLhuqNuIGNo4bqldCoqOiBHaeG6o2kgcXV54bq/dCB0cmnhu4d0IMSR4buDIG7DunQgdGjhuq90IGPhu5UgY2hhaSBs4bubbiBuaOG6pXQgdHJvbmcga+G7uSBuZ2jhu4cgcGjhuqduIG3hu4FtOiAqKkPGoSBz4bufIGThu68gbGnhu4d1IHThuq1wIHRydW5nIChDZW50cmFsIERhdGFiYXNlKSoqLg0KLSAqKkPDoWNoIHRo4bupYyBob+G6oXQgxJHhu5luZyoqOg0KICAtIFRvw6BuIGLhu5kgZOG7ryBsaeG7h3UgbmdoaeG7h3AgduG7pSDEkcaw4bujYyB04bqjaSB0cuG7sWMgdGnhur9wIGzDqm4gbeG7mXQgKipJbi1NZW1vcnkgRGF0YSBHcmlkIChJTURHKSoqIHBow6JuIHTDoW4gKEFwYWNoZSBJZ25pdGUsIEhhemVsY2FzdCwgUmVkaXMgQ2x1c3RlcikuDQogIC0gQ8OhYyBQcm9jZXNzaW5nIFVuaXRzIChQVSkgY2jhu6lhIGPhuqMgbG9naWMgdMOtbmggdG/DoW4gbOG6q24gYuG6o24gc2FvIGThu68gbGnhu4d1IHRyb25nIFJBTS4NCiAgLSBWaeG7h2MgZ2hpIHh14buRbmcg4buVIGPhu6luZyAoRGF0YWJhc2UpIMSRxrDhu6NjIHTDoWNoIHJpw6puZyB0aMOgbmggdGnhur9uIHRyw6xuaCBwaGkgxJHhu5NuZyBi4buZIOG7nyBo4bqtdSB0csaw4budbmcgKFdyaXRlLUJlaGluZCBDYWNoaW5nKS4NCi0gKirhu6huZyBk4bulbmcqKjogU8OgbiBnaWFvIGThu4tjaCBjaOG7qW5nIGtob8OhbiBOYXNkYXEvTllTRSwgaOG7hyB0aOG7kW5nIMSR4bq3dCBjxrDhu6NjIHRy4buxYyB0dXnhur9uIG3DuWEgV29ybGQgQ3VwLCBo4buHIHRo4buRbmcgYsOhbiB2w6kgaMOyYSBuaOG6oWMgcXV5IG3DtCB0cmnhu4d1IG5nxrDhu51pLg0KDQotLS0NCg0KIyMjIDIuNC4gTeG6oW5nIEzGsOG7m2kgUGjDom4gUGjhu5FpOiBDbGllbnQtU2VydmVyLCBQZWVyLXRvLVBlZXIgKFAyUCkgJiBNYXN0ZXItV29ya2VyDQoNCmBgYG1lcm1haWQNCmZsb3djaGFydCBMUg0KICAgIHN1YmdyYXBoIENsaWVudFNlcnZlclsiQ2xpZW50LVNlcnZlciJdDQogICAgICAgIEMxW0NsaWVudCAxXSAtLT4gU3J2W0NlbnRyYWwgU2VydmVyXQ0KICAgICAgICBDMltDbGllbnQgMl0gLS0+IFNydg0KICAgIGVuZA0KICAgIA0KICAgIHN1YmdyYXBoIFAyUFsiUGVlci10by1QZWVyIChQMlApIl0NCiAgICAgICAgUDEoKFBlZXIgQSkpIDwtLT4gUDIoKFBlZXIgQikpDQogICAgICAgIFAyIDwtLT4gUDMoKFBlZXIgQykpDQogICAgICAgIFAzIDwtLT4gUDENCiAgICBlbmQNCiAgICANCiAgICBzdWJncmFwaCBNYXN0ZXJXb3JrZXJbIk1hc3Rlci1Xb3JrZXIiXQ0KICAgICAgICBNW01hc3RlciAvIENvb3JkaW5hdG9yXSAtLT4gVzFbV29ya2VyIDFdDQogICAgICAgIE0gLS0+IFcyW1dvcmtlciAyXQ0KICAgICAgICBNIC0tPiBXM1tXb3JrZXIgM10NCiAgICBlbmQNCmBgYA0KDQotICoqQ2xpZW50LVNlcnZlciBBcmNoaXRlY3R1cmUqKjogUGjDom4gxJHhu4tuaCByYW5oIGdp4bubaSBnaeG7r2EgbmjDoCBjdW5nIGPhuqVwIGThu4tjaCB24bulIChTZXJ2ZXIpIHbDoCBuZ8aw4budaSB0acOqdSBkw7luZyAoQ2xpZW50KS4gUGjDuSBo4bujcCBjaG8gOTUlIGPDoWMg4bupbmcgZOG7pW5nIFdlYi9Nb2JpbGUgdGjDtG5nIHRoxrDhu51uZy4NCi0gKipQZWVyLXRvLVBlZXIgQXJjaGl0ZWN0dXJlIChQMlApKio6IEtow7RuZyBjw7MgbcOheSBjaOG7pyB0cnVuZyB0w6JtLiBN4buXaSBuw7p0IHRoYW0gZ2lhIHbhu6thIGzDoCBDbGllbnQgduG7q2EgbMOgIFNlcnZlci4gQ8OzIGto4bqjIG7Eg25nIGNo4buLdSBs4buXaSB04buRaSB0aMaw4bujbmcgdsOgIGNo4buRbmcga2nhu4NtIGR1eeG7h3QgKEJpdFRvcnJlbnQsIEJpdGNvaW4sIElQRlMpLg0KLSAqKk1hc3Rlci1Xb3JrZXIgQXJjaGl0ZWN0dXJlKio6IE7DunQgTWFzdGVyIGNo4buLdSB0csOhY2ggbmhp4buHbSBjaGlhIG5o4buPIGto4buRaSBsxrDhu6NuZyBjw7RuZyB2aeG7h2Mga2jhu5VuZyBs4buTIHRow6BuaCBjw6FjIHBo4bqnbiDEkeG7mWMgbOG6rXAgdsOgIGdpYW8gY2hvIGPDoWMgV29ya2VycyB0aOG7sWMgdGhpIHNvbmcgc29uZywgc2F1IMSRw7MgdGh1IHRo4bqtcCBr4bq/dCBxdeG6oyAoTWFwUmVkdWNlLCBBcGFjaGUgU3BhcmssIFJlbmRlciBGYXJtIMSR4buTIGjhu41hIDNEKS4NCg0KLS0tDQoNCiMjIyAyLjUuIFN0cnVjdHVyYWwgJiBQcm9jZXNzaW5nIFN0eWxlczogUGlwZSBhbmQgRmlsdGVyLCBCcm9rZXIgJiBCbGFja2JvYXJkDQoNCiMjIyMgMS4gUGlwZSBhbmQgRmlsdGVyIEFyY2hpdGVjdHVyZQ0KLSBI4buHIHRo4buRbmcgY2hpYSBuaOG7jyB0w6FjIHbhu6UgeOG7rSBsw70gZMOybmcgZOG7ryBsaeG7h3UgdGjDoG5oIG3hu5l0IGNodeG7l2kgY8OhYyBixrDhu5tjIMSR4buZYyBs4bqtcCDEkcaw4bujYyBn4buNaSBsw6AgKipGaWx0ZXJzKiosIGvhur90IG7hu5FpIHbhu5tpIG5oYXUgcXVhIGPDoWMgxJHGsOG7nW5nIOG7kW5nIGThuqtuICoqUGlwZXMqKi4NCi0gTeG7l2kgRmlsdGVyIG5o4bqtbiBk4buvIGxp4buHdSB04burIFBpcGUgxJHhuqd1IHbDoG8sIGJp4bq/biDEkeG7lWkgZOG7ryBsaeG7h3UsIHbDoCDEkeG6qXkgc2FuZyBQaXBlIMSR4bqndSByYS4NCi0gKlbDrSBk4bulIGtpbmggxJFp4buDbio6IMSQxrDhu51uZyDhu5FuZyBs4buHbmggVU5JWCAoYGNhdCBhY2Nlc3MubG9nIHwgZ3JlcCA0MDQgfCBhd2sgJ3twcmludCAkMX0nIHwgc29ydCB8IHVuaXEgLWNgKSwgY8OhYyBsdeG7k25nIHjhu60gbMO9IHZpZGVvL8OibSB0aGFuaCAoRkZtcGVnKSwgdsOgIEVUTCBEYXRhIFBpcGVsaW5lcy4NCg0KIyMjIyAyLiBCcm9rZXIgQXJjaGl0ZWN0dXJlDQotIFPhu60gZOG7pW5nIG3hu5l0IHRo4buxYyB0aOG7gyB0cnVuZyBnaWFuIChCcm9rZXIpIMSR4buDIGvhur90IG7hu5FpIGPDoWMgQ2xpZW50cyB2w6AgU2VydmVycyBt4buZdCBjw6FjaCBnacOhbiB0aeG6v3AuIEJyb2tlciBjaOG7i3UgdHLDoWNoIG5oaeG7h20gxJHhu4tuaCB0dXnhur9uIHnDqnUgY+G6p3UsIGPDom4gYuG6sW5nIHThuqNpLCB2w6AgY2h1eeG7g24gxJHhu5VpIGdpYW8gdGjhu6ljICh2w60gZOG7pTogQXBhY2hlIEthZmthLCBDT1JCQSwgTVFUVCBCcm9rZXIgdHJvbmcgSW9UKS4NCg0KIyMjIyAzLiBCbGFja2JvYXJkIEFyY2hpdGVjdHVyZQ0KLSBM4bqleSBj4bqjbSBo4bupbmcgdOG7qyBt4buZdCBuaMOzbSBjaHV5w6puIGdpYSBuZ+G7k2kgdHLGsOG7m2MgbeG7mXQgYuG6o25nIMSRZW4gxJHhu4MgY8O5bmcgZ2nhuqNpIHF1eeG6v3QgbeG7mXQgYsOgaSB0b8OhbiBow7NjIGLDumE6DQogIC0gKipCbGFja2JvYXJkKio6IFbDuW5nIG5o4bubIGNoaWEgc+G6uyB0cnVuZyB0w6JtIGNo4bupYSB0cuG6oW5nIHRow6FpIGLDoGkgdG/DoW4gdsOgIGPDoWMgZ2nhuqNpIHBow6FwIGLhu5kgcGjhuq1uLg0KICAtICoqS25vd2xlZGdlIFNvdXJjZXMgKEtTKSoqOiBDw6FjIG1vZHVsZSBwaOG6p24gbeG7gW0gY2h1ecOqbiBnaWEgxJHhu5ljIGzhuq1wLCB04buxIGvDrWNoIGhv4bqhdCBraGkgdGjhuqV5IGThu68gbGnhu4d1IHRyw6puIEJsYWNrYm9hcmQgcGjDuSBo4bujcCB24bubaSBuxINuZyBs4buxYyBj4bunYSBtw6xuaCDEkeG7gyBnaeG6o2kgdGnhur9wLg0KICAtICoqQ29udHJvbCBDb21wb25lbnQqKjogQuG7mSDEkWnhu4F1IHBo4buRaSBsdeG7k25nIHRo4buxYyB0aGkuDQogIC0gKuG7qG5nIGThu6VuZyo6IE5o4bqtbiBk4bqhbmcgZ2nhu41uZyBuw7NpIChTcGVlY2ggUmVjb2duaXRpb24pLCBo4buHIHRo4buRbmcgQUkgcGjDom4gdMOtY2ggdMOtbiBoaeG7h3UgcmFkYXIgcXXDom4gc+G7sSwgeOG7rSBsw70gaMOsbmgg4bqjbmggeSB04bq/Lg0KDQotLS0NCg0KIyMjIDIuNi4gTW9kZXJuIEFwcGxpY2F0aW9uIFN0eWxlczogU2VydmVybGVzcyAoRmFhUyksIFBsdWctaW4gJiBDUVJTDQoNCiMjIyMgMS4gU2VydmVybGVzcyBBcmNoaXRlY3R1cmUgKEZ1bmN0aW9uLWFzLWEtU2VydmljZSAtIEZhYVMpDQotIOG7qG5nIGThu6VuZyDEkcaw4bujYyBjaGlhIG5o4buPIHRow6BuaCBjw6FjIGjDoG0ga2jDtG5nIHRy4bqhbmcgdGjDoWkgKFN0YXRlbGVzcyBGdW5jdGlvbnM6IEFXUyBMYW1iZGEsIENsb3VkIFJ1biksIGNo4buJIGto4bufaSDEkeG7mW5nIGtoaSBjw7Mgc+G7sSBraeG7h24gKEhUVFAgUmVxdWVzdCwgRmlsZSBVcGxvYWQsIENyb24pLCB04buxIMSR4buZbmcgY28gZ2nDo24gdOG7qyAwIGzDqm4gaMOgbmcgY2jhu6VjIG5nw6BuIGluc3RhbmNlcyB2w6AgZ2nhuqNtIHbhu4EgMCBraGkgaOG6v3QgdOG6o2kuDQotICpI4bqhbiBjaOG6vyo6IENvbGQgU3RhcnQgbGF0ZW5jeSwgcGjhu6UgdGh14buZYyBzw6J1IHbDoG8gbmjDoCBjdW5nIGPhuqVwIMSRw6FtIG3DonkgKFZlbmRvciBMb2NrLWluKSwga2jDsyBn4buhIGzhu5dpIGPhu6VjIGLhu5kuDQoNCiMjIyMgMi4gUGx1Zy1pbiAvIE1pY3Jva2VybmVsIEFyY2hpdGVjdHVyZQ0KLSBI4buHIHRo4buRbmcgZ+G7k20gbeG7mXQgTmjDom4gY+G7kXQgbMO1aSAoQ29yZSBNaWNyb2tlcm5lbCkgdOG7kWkgZ2nhuqNuIGNo4buJIGNo4bupYSBjw6FjIGxvZ2ljIHThu5FpIHRoaeG7g3UsIHbDoCBt4buZdCB04bqtcCBo4bujcCBjw6FjIE1vZHVsZSBj4bqvbSB0aMOqbSAoUGx1Zy1pbnMpIMSR4buZYyBs4bqtcCDEkcaw4bujYyDEkcSDbmcga8O9IMSR4buZbmcgxJHhu4MgbeG7nyBy4buZbmcgdMOtbmggbsSDbmcuDQotICpWw60gZOG7pSo6IFRyw6xuaCBiacOqbiB04bqtcCBtw6MgVmlzdWFsIFN0dWRpbyBDb2RlLCB0csOsbmggZHV54buHdCBHb29nbGUgQ2hyb21lLCBMaW51eCBLZXJuZWwuDQoNCiMjIyMgMy4gQ1FSUyBBcmNoaXRlY3R1cmUgKENvbW1hbmQgUXVlcnkgUmVzcG9uc2liaWxpdHkgU2VncmVnYXRpb24pDQotIFTDoWNoIMSRw7RpIGhvw6BuIHRvw6BuIG3DtCBow6xuaCB44butIGzDvSBo4buHIHRo4buRbmc6DQogIC0gKipDb21tYW5kIFN0YWNrKio6IFRp4bq/cCBuaOG6rW4gY8OhYyB0aGFvIHTDoWMgZ2hpL3Phu61hL3jDs2EsIHThuq1wIHRydW5nIHbDoG8gYuG6o28gduG7hyB0w61uaCDEkcO6bmcgxJHhuq9uIGPhu6dhIERvbWFpbiBMb2dpYyB2w6AgSW52YXJpYW50cy4NCiAgLSAqKlF1ZXJ5IFN0YWNrKio6IFRp4bq/cCBuaOG6rW4gY8OhYyB0cnV5IHbhuqVuIMSR4buNYywgc+G7rSBk4bulbmcgY8ahIHPhu58gZOG7ryBsaeG7h3UgcGhpIGNodeG6qW4gaMOzYSAoUmVhZC1PcHRpbWl6ZWQgVmlld3MsIEVsYXN0aWNzZWFyY2gpIMSR4buDIHRy4bqjIGzhu51pIGvhur90IHF14bqjIOG7nyB04buRYyDEkeG7mSBjYW8gbmjhuqV0IG3DoCBraMO0bmcgY+G6p24gSk9JTiBwaOG7qWMgdOG6oXAuDQoNCi0tLQ0KDQojIyAzLiBUaOG7sWMgdGhpIE3DoyBuZ3Xhu5NuICYgTcO0IHBo4buPbmcgQ2h1ecOqbiBzw6J1IChEdWFsLUVuZ2luZSBJbXBsZW1lbnRhdGlvbikNCg0KIyMjIDMuMS4gQysrMjAgSW1wbGVtZW50YXRpb246IEFzeW5jaHJvbm91cyBNdWx0aS1UaHJlYWRlZCBQaXBlIGFuZCBGaWx0ZXIgQXJjaGl0ZWN0dXJlDQpDaMawxqFuZyB0csOsbmggQysrMjAgZMaw4bubaSDEkcOieSBtw7QgcGjhu49uZyBt4buZdCBEYXRhIFBpcGVsaW5lIHRoZW8gcGhvbmcgY8OhY2ggUGlwZSBhbmQgRmlsdGVyIHjhu60gbMO9IGx14buTbmcgZOG7ryBsaeG7h3Ugc29uZyBzb25nIHF1YSBuaGnhu4F1IGLGsOG7m2MgduG7m2kgQm91bmRlZCBUaHJlYWQtU2FmZSBRdWV1ZXMuDQoNCmBgYGNwcA0KI2luY2x1ZGUgPGlvc3RyZWFtPg0KI2luY2x1ZGUgPHZlY3Rvcj4NCiNpbmNsdWRlIDxzdHJpbmc+DQojaW5jbHVkZSA8bWVtb3J5Pg0KI2luY2x1ZGUgPHF1ZXVlPg0KI2luY2x1ZGUgPG11dGV4Pg0KI2luY2x1ZGUgPGNvbmRpdGlvbl92YXJpYWJsZT4NCiNpbmNsdWRlIDx0aHJlYWQ+DQojaW5jbHVkZSA8b3B0aW9uYWw+DQojaW5jbHVkZSA8Y2hyb25vPg0KI2luY2x1ZGUgPGFsZ29yaXRobT4NCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gSOG6oCBU4bqmTkcgUElQRTogSMOATkcgxJDhu6JJIMSQQSBMVeG7kk5HIEFOIFRPw4BOIChUSFJFQUQtU0FGRSBCT1VOREVEIFBJUEUpDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQp0ZW1wbGF0ZSA8dHlwZW5hbWUgVD4NCmNsYXNzIFBpcGUgew0KcHJpdmF0ZToNCiAgICBzdGQ6OnF1ZXVlPFQ+IHF1ZXVlXzsNCiAgICBtdXRhYmxlIHN0ZDo6bXV0ZXggbXR4XzsNCiAgICBzdGQ6OmNvbmRpdGlvbl92YXJpYWJsZSBjdk5vdEVtcHR5XzsNCiAgICBzdGQ6OmNvbmRpdGlvbl92YXJpYWJsZSBjdk5vdEZ1bGxfOw0KICAgIHNpemVfdCBjYXBhY2l0eV87DQogICAgYm9vbCBjbG9zZWRfe2ZhbHNlfTsNCg0KcHVibGljOg0KICAgIGV4cGxpY2l0IFBpcGUoc2l6ZV90IGNhcGFjaXR5KSA6IGNhcGFjaXR5XyhjYXBhY2l0eSkge30NCg0KICAgIHZvaWQgcHVzaChUIGl0ZW0pIHsNCiAgICAgICAgc3RkOjp1bmlxdWVfbG9jazxzdGQ6Om11dGV4PiBsb2NrKG10eF8pOw0KICAgICAgICBjdk5vdEZ1bGxfLndhaXQobG9jaywgW3RoaXNdKCkgeyByZXR1cm4gcXVldWVfLnNpemUoKSA8IGNhcGFjaXR5XyB8fCBjbG9zZWRfOyB9KTsNCiAgICAgICAgaWYgKGNsb3NlZF8pIHJldHVybjsNCiAgICAgICAgcXVldWVfLnB1c2goc3RkOjptb3ZlKGl0ZW0pKTsNCiAgICAgICAgY3ZOb3RFbXB0eV8ubm90aWZ5X29uZSgpOw0KICAgIH0NCg0KICAgIHN0ZDo6b3B0aW9uYWw8VD4gcG9wKCkgew0KICAgICAgICBzdGQ6OnVuaXF1ZV9sb2NrPHN0ZDo6bXV0ZXg+IGxvY2sobXR4Xyk7DQogICAgICAgIGN2Tm90RW1wdHlfLndhaXQobG9jaywgW3RoaXNdKCkgeyByZXR1cm4gIXF1ZXVlXy5lbXB0eSgpIHx8IGNsb3NlZF87IH0pOw0KICAgICAgICBpZiAocXVldWVfLmVtcHR5KCkgJiYgY2xvc2VkXykgcmV0dXJuIHN0ZDo6bnVsbG9wdDsNCiAgICAgICAgVCBpdGVtID0gc3RkOjptb3ZlKHF1ZXVlXy5mcm9udCgpKTsNCiAgICAgICAgcXVldWVfLnBvcCgpOw0KICAgICAgICBjdk5vdEZ1bGxfLm5vdGlmeV9vbmUoKTsNCiAgICAgICAgcmV0dXJuIGl0ZW07DQogICAgfQ0KDQogICAgdm9pZCBjbG9zZSgpIHsNCiAgICAgICAgc3RkOjpsb2NrX2d1YXJkPHN0ZDo6bXV0ZXg+IGxvY2sobXR4Xyk7DQogICAgICAgIGNsb3NlZF8gPSB0cnVlOw0KICAgICAgICBjdk5vdEVtcHR5Xy5ub3RpZnlfYWxsKCk7DQogICAgICAgIGN2Tm90RnVsbF8ubm90aWZ5X2FsbCgpOw0KICAgIH0NCn07DQoNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi8vIE3DlCBIw4xOSCBIw5NBIEThu64gTEnhu4ZVIMSQSSBRVUEgRklMVEVSDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpzdHJ1Y3QgTG9nUmVjb3JkIHsNCiAgICB1aW50NjRfdCBpZDsNCiAgICBzdGQ6OnN0cmluZyBsZXZlbDsNCiAgICBzdGQ6OnN0cmluZyBwYXlsb2FkOw0KfTsNCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gQ8OBQyBGSUxURVJTIFjhu6wgTMOdIChQUk9DRVNTSU5HIEZJTFRFUlMpDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQoNCi8vIEZpbHRlciAxOiBM4buNYyBi4buPIGPDoWMgYuG6o24gZ2hpIGtow7RuZyBwaOG6o2kgY+G6o25oIGLDoW8gaG/hurdjIGzhu5dpDQp2b2lkIGVycm9yRmlsdGVyKFBpcGU8TG9nUmVjb3JkPiYgaW5QaXBlLCBQaXBlPExvZ1JlY29yZD4mIG91dFBpcGUpIHsNCiAgICB3aGlsZSAoYXV0byByZWNvcmQgPSBpblBpcGUucG9wKCkpIHsNCiAgICAgICAgaWYgKHJlY29yZC0+bGV2ZWwgPT0gIldBUk4iIHx8IHJlY29yZC0+bGV2ZWwgPT0gIkVSUk9SIikgew0KICAgICAgICAgICAgb3V0UGlwZS5wdXNoKCpyZWNvcmQpOw0KICAgICAgICB9DQogICAgfQ0KICAgIG91dFBpcGUuY2xvc2UoKTsNCn0NCg0KLy8gRmlsdGVyIDI6IENodeG6qW4gaMOzYSBjaHXhu5dpIHBheWxvYWQgdGjDoG5oIGNo4buvIGluIGhvYSB2w6AgZ+G6r24gdGltZXN0YW1wDQp2b2lkIHRyYW5zZm9ybUZpbHRlcihQaXBlPExvZ1JlY29yZD4mIGluUGlwZSwgUGlwZTxMb2dSZWNvcmQ+JiBvdXRQaXBlKSB7DQogICAgd2hpbGUgKGF1dG8gcmVjb3JkID0gaW5QaXBlLnBvcCgpKSB7DQogICAgICAgIGZvciAoY2hhciYgYyA6IHJlY29yZC0+cGF5bG9hZCkgew0KICAgICAgICAgICAgYyA9IHN0YXRpY19jYXN0PGNoYXI+KHN0ZDo6dG91cHBlcihjKSk7DQogICAgICAgIH0NCiAgICAgICAgcmVjb3JkLT5wYXlsb2FkID0gIltTQU5JVElaRURdICIgKyByZWNvcmQtPnBheWxvYWQ7DQogICAgICAgIG91dFBpcGUucHVzaCgqcmVjb3JkKTsNCiAgICB9DQogICAgb3V0UGlwZS5jbG9zZSgpOw0KfQ0KDQppbnQgbWFpbigpIHsNCiAgICBzdGQ6OmNvdXQgPDwgIj09PSBDKysyMCBNdWx0aXRocmVhZGVkIFBpcGUgYW5kIEZpbHRlciBBcmNoaXRlY3R1cmUgRGVtbyA9PT1cbiI7DQoNCiAgICBQaXBlPExvZ1JlY29yZD4gc291cmNlUGlwZSgxMCk7DQogICAgUGlwZTxMb2dSZWNvcmQ+IGludGVybWVkaWF0ZVBpcGUoMTApOw0KICAgIFBpcGU8TG9nUmVjb3JkPiBzaW5rUGlwZSgxMCk7DQoNCiAgICAvLyBLaOG7n2kgY2jhuqF5IGPDoWMgRmlsdGVycyB0csOqbiBjw6FjIGx14buTbmcgT1MgxJHhu5ljIGzhuq1wDQogICAgc3RkOjp0aHJlYWQgdEZpbHRlcjEoZXJyb3JGaWx0ZXIsIHN0ZDo6cmVmKHNvdXJjZVBpcGUpLCBzdGQ6OnJlZihpbnRlcm1lZGlhdGVQaXBlKSk7DQogICAgc3RkOjp0aHJlYWQgdEZpbHRlcjIodHJhbnNmb3JtRmlsdGVyLCBzdGQ6OnJlZihpbnRlcm1lZGlhdGVQaXBlKSwgc3RkOjpyZWYoc2lua1BpcGUpKTsNCg0KICAgIC8vIELhu5kgcGjDoXQgZOG7ryBsaeG7h3UgKFNvdXJjZSBQcm9kdWNlcikNCiAgICBzdGQ6OnZlY3RvcjxMb2dSZWNvcmQ+IHJhd0xvZ3MgPSB7DQogICAgICAgIHsxLCAiSU5GTyIsICJVc2VyIGxvZ2dlZCBpbiJ9LA0KICAgICAgICB7MiwgIldBUk4iLCAiTWVtb3J5IHVzYWdlIHJlYWNoZWQgODUlIn0sDQogICAgICAgIHszLCAiREVCVUciLCAiQ2FjaGUgaGl0IGZvciBrZXkgdXNlcl8xMDEifSwNCiAgICAgICAgezQsICJFUlJPUiIsICJEYXRhYmFzZSBjb25uZWN0aW9uIHBvb2wgZXhoYXVzdGVkIn0sDQogICAgICAgIHs1LCAiSU5GTyIsICJQZXJpb2RpYyByZXBvcnQgZ2VuZXJhdGVkIn0NCiAgICB9Ow0KDQogICAgc3RkOjpjb3V0IDw8ICJbUHJvZHVjZXJdIEZlZWRpbmcgIiA8PCByYXdMb2dzLnNpemUoKSA8PCAiIGxvZyByZWNvcmRzIGludG8gU291cmNlIFBpcGUuLi5cbiI7DQogICAgZm9yIChhdXRvJiBsb2cgOiByYXdMb2dzKSB7DQogICAgICAgIHNvdXJjZVBpcGUucHVzaChsb2cpOw0KICAgIH0NCiAgICBzb3VyY2VQaXBlLmNsb3NlKCk7DQoNCiAgICAvLyBUaHUgbmjhuq1uIGvhur90IHF14bqjIHThu6sgU2luayBQaXBlDQogICAgc3RkOjpjb3V0IDw8ICJcbltTaW5rIE91dHB1dCAtIEZpbHRlcmVkICYgVHJhbnNmb3JtZWQgTG9nc106XG4iOw0KICAgIHdoaWxlIChhdXRvIHByb2Nlc3NlZCA9IHNpbmtQaXBlLnBvcCgpKSB7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiICAtPiBMb2cgIyIgPDwgcHJvY2Vzc2VkLT5pZCANCiAgICAgICAgICAgICAgICAgIDw8ICIgWyIgPDwgcHJvY2Vzc2VkLT5sZXZlbCA8PCAiXTogIiANCiAgICAgICAgICAgICAgICAgIDw8IHByb2Nlc3NlZC0+cGF5bG9hZCA8PCAiXG4iOw0KICAgIH0NCg0KICAgIHRGaWx0ZXIxLmpvaW4oKTsNCiAgICB0RmlsdGVyMi5qb2luKCk7DQoNCiAgICBzdGQ6OmNvdXQgPDwgIltQaXBlbGluZSBFeGVjdXRpb25dIENvbXBsZXRlZCBjbGVhbmx5IHdpdGhvdXQgZGVhZGxvY2shXG4iOw0KICAgIHJldHVybiAwOw0KfQ0KYGBgDQoNCiMjIyMgVGVybWluYWwgT3V0cHV0IE3huqt1IChDKysyMCk6DQpgYGB0ZXh0DQo9PT0gQysrMjAgTXVsdGl0aHJlYWRlZCBQaXBlIGFuZCBGaWx0ZXIgQXJjaGl0ZWN0dXJlIERlbW8gPT09DQpbUHJvZHVjZXJdIEZlZWRpbmcgNSBsb2cgcmVjb3JkcyBpbnRvIFNvdXJjZSBQaXBlLi4uDQoNCltTaW5rIE91dHB1dCAtIEZpbHRlcmVkICYgVHJhbnNmb3JtZWQgTG9nc106DQogIC0+IExvZyAjMiBbV0FSTl06IFtTQU5JVElaRURdIE1FTU9SWSBVU0FHRSBSRUFDSEVEIDg1JQ0KICAtPiBMb2cgIzQgW0VSUk9SXTogW1NBTklUSVpFRF0gREFUQUJBU0UgQ09OTkVDVElPTiBQT09MIEVYSEFVU1RFRA0KW1BpcGVsaW5lIEV4ZWN1dGlvbl0gQ29tcGxldGVkIGNsZWFubHkgd2l0aG91dCBkZWFkbG9jayENCmBgYA0KDQotLS0NCg0KIyMjIDMuMi4gUHl0aG9uIDMuMTErIEltcGxlbWVudGF0aW9uOiBNb2R1bGFyIE1vbm9saXRoIHZzIEV2ZW50LURyaXZlbiBCdXMgQXJjaGl0ZWN0dXJlDQpTY3JpcHQgUHl0aG9uIDMuMTErIGTGsOG7m2kgxJHDonkgbcO0IHBo4buPbmcgc+G7sSBr4bq/dCBo4bujcCBnaeG7r2EgKipNb2R1bGFyIE1vbm9saXRoKiogdsOgICoqRXZlbnQtRHJpdmVuIEFyY2hpdGVjdHVyZSAoRURBKSoqIHRow7RuZyBxdWEgbeG7mXQgRXZlbnQgQnVzIG7hu5lpIGLhu5kga2jDtG5nIMSR4buTbmcgYuG7mSwgZ2nDunAgdMOhY2ggcuG7nWkgY8OhYyBwaMOibiBo4buHIE9yZGVycywgSW52ZW50b3J5IHbDoCBOb3RpZmljYXRpb24uDQoNCmBgYHB5dGhvbg0KZnJvbSBfX2Z1dHVyZV9fIGltcG9ydCBhbm5vdGF0aW9ucw0KaW1wb3J0IGFzeW5jaW8NCmZyb20gZGF0YWNsYXNzZXMgaW1wb3J0IGRhdGFjbGFzcywgZmllbGQNCmZyb20gdHlwaW5nIGltcG9ydCBDYWxsYWJsZSwgQ29yb3V0aW5lLCBBbnkNCmZyb20gZGF0ZXRpbWUgaW1wb3J0IGRhdGV0aW1lDQoNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KIyBFVkVOVCBERUZJTklUSU9OUyAoSU1NVVRBQkxFIERPTUFJTiBFVkVOVFMpDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCkBkYXRhY2xhc3MoZnJvemVuPVRydWUpDQpjbGFzcyBEb21haW5FdmVudDoNCiAgICBvY2N1cnJlZF9hdDogZGF0ZXRpbWUgPSBmaWVsZChkZWZhdWx0X2ZhY3Rvcnk9ZGF0ZXRpbWUudXRjbm93KQ0KDQpAZGF0YWNsYXNzKGZyb3plbj1UcnVlKQ0KY2xhc3MgT3JkZXJQbGFjZWRFdmVudChEb21haW5FdmVudCk6DQogICAgb3JkZXJfaWQ6IHN0ciA9ICIiDQogICAgY3VzdG9tZXJfaWQ6IHN0ciA9ICIiDQogICAgaXRlbV9za3U6IHN0ciA9ICIiDQogICAgcXVhbnRpdHk6IGludCA9IDANCiAgICB0b3RhbF91c2Q6IGZsb2F0ID0gMC4wDQoNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KIyBFVkVOVC1EUklWRU4gQlVTIChJTi1QUk9DRVNTIERFQ09VUExFRCBNRVNTQUdFIEJST0tFUikNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KRXZlbnRIYW5kbGVyID0gQ2FsbGFibGVbW0FueV0sIENvcm91dGluZVtBbnksIEFueSwgTm9uZV1dDQoNCmNsYXNzIEFzeW5jRXZlbnRCdXM6DQogICAgZGVmIF9faW5pdF9fKHNlbGYpOg0KICAgICAgICBzZWxmLl9zdWJzY3JpYmVyczogZGljdFt0eXBlLCBsaXN0W0V2ZW50SGFuZGxlcl1dID0ge30NCg0KICAgIGRlZiBzdWJzY3JpYmUoc2VsZiwgZXZlbnRfdHlwZTogdHlwZSwgaGFuZGxlcjogRXZlbnRIYW5kbGVyKSAtPiBOb25lOg0KICAgICAgICBpZiBldmVudF90eXBlIG5vdCBpbiBzZWxmLl9zdWJzY3JpYmVyczoNCiAgICAgICAgICAgIHNlbGYuX3N1YnNjcmliZXJzW2V2ZW50X3R5cGVdID0gW10NCiAgICAgICAgc2VsZi5fc3Vic2NyaWJlcnNbZXZlbnRfdHlwZV0uYXBwZW5kKGhhbmRsZXIpDQoNCiAgICBhc3luYyBkZWYgcHVibGlzaChzZWxmLCBldmVudDogQW55KSAtPiBOb25lOg0KICAgICAgICBldmVudF90eXBlID0gdHlwZShldmVudCkNCiAgICAgICAgaGFuZGxlcnMgPSBzZWxmLl9zdWJzY3JpYmVycy5nZXQoZXZlbnRfdHlwZSwgW10pDQogICAgICAgIGlmIG5vdCBoYW5kbGVyczoNCiAgICAgICAgICAgIHJldHVybg0KICAgICAgICAjIEvDrWNoIGhv4bqhdCB04bqldCBj4bqjIHN1YnNjcmliZXJzIGLhuqV0IMSR4buTbmcgYuG7mSBzb25nIHNvbmcNCiAgICAgICAgYXdhaXQgYXN5bmNpby5nYXRoZXIoKihoYW5kbGVyKGV2ZW50KSBmb3IgaGFuZGxlciBpbiBoYW5kbGVycykpDQoNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KIyBNT0RVTEUgMTogSU5WRU5UT1JZIE1BTkFHRU1FTlQgTU9EVUxFIChJU09MQVRFRCBCT1VOREVEIENPTlRFWFQpDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCmNsYXNzIEludmVudG9yeU1vZHVsZToNCiAgICBkZWYgX19pbml0X18oc2VsZiwgYnVzOiBBc3luY0V2ZW50QnVzKToNCiAgICAgICAgc2VsZi5zdG9jazogZGljdFtzdHIsIGludF0gPSB7IkxBUFRPUC1NMyI6IDUwLCAiUEhPTkUtMTUiOiAxMDB9DQogICAgICAgIGJ1cy5zdWJzY3JpYmUoT3JkZXJQbGFjZWRFdmVudCwgc2VsZi5vbl9vcmRlcl9wbGFjZWQpDQoNCiAgICBhc3luYyBkZWYgb25fb3JkZXJfcGxhY2VkKHNlbGYsIGV2ZW50OiBPcmRlclBsYWNlZEV2ZW50KToNCiAgICAgICAgIyBUcuG7qyBraG8gxJHhu5ljIGzhuq1wIGtoaSBuaOG6rW4gZXZlbnQNCiAgICAgICAgYXdhaXQgYXN5bmNpby5zbGVlcCgwLjAxKSAgIyBHaeG6oyBs4bqtcCBJL08gZGF0YWJhc2UNCiAgICAgICAgaWYgZXZlbnQuaXRlbV9za3UgaW4gc2VsZi5zdG9jazoNCiAgICAgICAgICAgIHNlbGYuc3RvY2tbZXZlbnQuaXRlbV9za3VdIC09IGV2ZW50LnF1YW50aXR5DQogICAgICAgICAgICBwcmludChmIiAgW0ludmVudG9yeSBNb2R1bGVdIERlZHVjdGVkIHtldmVudC5xdWFudGl0eX0gdW5pdHMgb2Yge2V2ZW50Lml0ZW1fc2t1fS4gIg0KICAgICAgICAgICAgICAgICAgZiJSZW1haW5pbmcgc3RvY2s6IHtzZWxmLnN0b2NrW2V2ZW50Lml0ZW1fc2t1XX0iKQ0KDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiMgTU9EVUxFIDI6IE5PVElGSUNBVElPTiBNT0RVTEUNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KY2xhc3MgTm90aWZpY2F0aW9uTW9kdWxlOg0KICAgIGRlZiBfX2luaXRfXyhzZWxmLCBidXM6IEFzeW5jRXZlbnRCdXMpOg0KICAgICAgICBidXMuc3Vic2NyaWJlKE9yZGVyUGxhY2VkRXZlbnQsIHNlbGYub25fb3JkZXJfcGxhY2VkKQ0KDQogICAgYXN5bmMgZGVmIG9uX29yZGVyX3BsYWNlZChzZWxmLCBldmVudDogT3JkZXJQbGFjZWRFdmVudCk6DQogICAgICAgIGF3YWl0IGFzeW5jaW8uc2xlZXAoMC4wMikgICMgR2nhuqMgbOG6rXAgZ+G7rWkgZW1haWwgcXVhIFNNVFANCiAgICAgICAgcHJpbnQoZiIgIFtOb3RpZmljYXRpb24gTW9kdWxlXSBFbWFpbCBzZW50IHRvIEN1c3RvbWVyIHtldmVudC5jdXN0b21lcl9pZH06ICINCiAgICAgICAgICAgICAgZiJPcmRlciB7ZXZlbnQub3JkZXJfaWR9IGNvbmZpcm1lZCAoJHtldmVudC50b3RhbF91c2Q6LjJmfSkiKQ0KDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiMgTU9EVUxFIDM6IE9SREVSIFNFUlZJQ0UgKFBST0RVQ0VSKQ0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpjbGFzcyBPcmRlck1vZHVsZToNCiAgICBkZWYgX19pbml0X18oc2VsZiwgYnVzOiBBc3luY0V2ZW50QnVzKToNCiAgICAgICAgc2VsZi5idXMgPSBidXMNCg0KICAgIGFzeW5jIGRlZiBwbGFjZV9vcmRlcihzZWxmLCBvcmRlcl9pZDogc3RyLCBjdXN0b21lcl9pZDogc3RyLCBza3U6IHN0ciwgcXR5OiBpbnQsIHByaWNlOiBmbG9hdCk6DQogICAgICAgIHByaW50KGYiXG5bT3JkZXIgTW9kdWxlXSBQbGFjaW5nIE9yZGVyIHtvcmRlcl9pZH0uLi4iKQ0KICAgICAgICAjIDEuIFRo4buxYyBoaeG7h24gbMawdSB0cuG7ryDEkcahbiBow6BuZyBu4buZaSBi4buZDQogICAgICAgICMgMi4gUGjDoXQgdMOhbiBEb21haW4gRXZlbnQgcmEgRXZlbnQgQnVzDQogICAgICAgIGV2ZW50ID0gT3JkZXJQbGFjZWRFdmVudCgNCiAgICAgICAgICAgIG9yZGVyX2lkPW9yZGVyX2lkLA0KICAgICAgICAgICAgY3VzdG9tZXJfaWQ9Y3VzdG9tZXJfaWQsDQogICAgICAgICAgICBpdGVtX3NrdT1za3UsDQogICAgICAgICAgICBxdWFudGl0eT1xdHksDQogICAgICAgICAgICB0b3RhbF91c2Q9cHJpY2UgKiBxdHkNCiAgICAgICAgKQ0KICAgICAgICBhd2FpdCBzZWxmLmJ1cy5wdWJsaXNoKGV2ZW50KQ0KDQoNCmFzeW5jIGRlZiBtYWluKCk6DQogICAgcHJpbnQoIj09PSBQeXRob24gMy4xMSsgTW9kdWxhciBNb25vbGl0aCB3aXRoIEV2ZW50IEJ1cyBBcmNoaXRlY3R1cmUgPT09IikNCiAgICBldmVudF9idXMgPSBBc3luY0V2ZW50QnVzKCkNCg0KICAgICMgS2jhu59pIHThuqFvIGPDoWMgTW9kdWxlcyDEkeG7mWMgbOG6rXAgKExvb3NlIENvdXBsaW5nKQ0KICAgIF9pbnZlbnRvcnkgPSBJbnZlbnRvcnlNb2R1bGUoZXZlbnRfYnVzKQ0KICAgIF9ub3RpZmljYXRpb25zID0gTm90aWZpY2F0aW9uTW9kdWxlKGV2ZW50X2J1cykNCiAgICBvcmRlcnMgPSBPcmRlck1vZHVsZShldmVudF9idXMpDQoNCiAgICAjIMSQ4bq3dCBow6BuZyBsacOqbiB0aeG6v3ANCiAgICBhd2FpdCBvcmRlcnMucGxhY2Vfb3JkZXIoIk9SRC0xMDEiLCAiQ1VTVC1BIiwgIkxBUFRPUC1NMyIsIDIsIDE5OTkuOTkpDQogICAgYXdhaXQgb3JkZXJzLnBsYWNlX29yZGVyKCJPUkQtMTAyIiwgIkNVU1QtQiIsICJQSE9ORS0xNSIsIDUsIDk5OS4wMCkNCg0KaWYgX19uYW1lX18gPT0gIl9fbWFpbl9fIjoNCiAgICBhc3luY2lvLnJ1bihtYWluKCkpDQpgYGANCg0KIyMjIyBUZXJtaW5hbCBPdXRwdXQgTeG6q3UgKFB5dGhvbiAzLjExKyk6DQpgYGB0ZXh0DQo9PT0gUHl0aG9uIDMuMTErIE1vZHVsYXIgTW9ub2xpdGggd2l0aCBFdmVudCBCdXMgQXJjaGl0ZWN0dXJlID09PQ0KDQpbT3JkZXIgTW9kdWxlXSBQbGFjaW5nIE9yZGVyIE9SRC0xMDEuLi4NCiAgW0ludmVudG9yeSBNb2R1bGVdIERlZHVjdGVkIDIgdW5pdHMgb2YgTEFQVE9QLU0zLiBSZW1haW5pbmcgc3RvY2s6IDQ4DQogIFtOb3RpZmljYXRpb24gTW9kdWxlXSBFbWFpbCBzZW50IHRvIEN1c3RvbWVyIENVU1QtQTogT3JkZXIgT1JELTEwMSBjb25maXJtZWQgKCQzOTk5Ljk4KQ0KDQpbT3JkZXIgTW9kdWxlXSBQbGFjaW5nIE9yZGVyIE9SRC0xMDIuLi4NCiAgW0ludmVudG9yeSBNb2R1bGVdIERlZHVjdGVkIDUgdW5pdHMgb2YgUEhPTkUtMTUuIFJlbWFpbmluZyBzdG9jazogOTUNCiAgW05vdGlmaWNhdGlvbiBNb2R1bGVdIEVtYWlsIHNlbnQgdG8gQ3VzdG9tZXIgQ1VTVC1COiBPcmRlciBPUkQtMTAyIGNvbmZpcm1lZCAoJDQ5OTUuMDApDQpgYGANCg0KLS0tDQoNCiMjIDQuIFN5c3RlbXMgRW5naW5lZXJpbmcgJiBQcm9kdWN0aW9uIFBpdGZhbGxzDQoNCiMjIyBDw6FjIEPhuqFtIELhuqt5IFRo4buxYyBDaGnhur9uIChHb3RjaGFzICYgUHJvZHVjdGlvbiBBbnRpcGF0dGVybnMpDQoNCjEuICoqQ8ahbiDDgWMgTeG7mW5nIEto4buRaSDEkOG7k25nIE5o4bqldCBQaMOibiBUw6FuIChEaXN0cmlidXRlZCBNb25vbGl0aCkqKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IENoaWEgbmjhu48gaOG7hyB0aOG7kW5nIHRow6BuaCA1MCBNaWNyb3NlcnZpY2VzIG5oxrBuZyBjw6FjIHNlcnZpY2VzIGzhuqFpIGfhu41pIG5oYXUgYuG6sW5nIGPDoWMgbOG7h25oIEhUVFAgxJHhu5NuZyBi4buZIGTDonkgY2h1eeG7gW4gKENoYWluZWQgUkVTVCBDYWxsczogU2VydmljZSAkQSBcdG8gQiBcdG8gQyBcdG8gRCQpLiBO4bq/dSBTZXJ2aWNlICREJCBi4buLIGNo4bqtbSAyIGdpw6J5LCB0b8OgbiBi4buZIGNodeG7l2kgbmdo4bq9biBt4bqhbmc7IG7hur91IG3hu5l0IHNlcnZpY2UgZGVwbG95IHBoacOqbiBi4bqjbiBt4bubaSwgdOG6pXQgY+G6oyA0OSBzZXJ2aWNlcyBjw7JuIGzhuqFpIHBo4bqjaSBkZXBsb3kgdGhlbyB2w6wgcGjhu6UgdGh14buZYyBjaOG6t3QgY2jhur0gduG7gSBzY2hlbWEhDQogICAtICpLaOG6r2MgcGjhu6VjKjogVMOhY2ggcuG7nWkgYuG6sW5nIEV2ZW50LURyaXZlbiBwaGkgxJHhu5NuZyBi4buZIChFREEpIGhv4bq3YyBxdWF5IGzhuqFpIHbhu5tpICoqTW9kdWxhciBNb25vbGl0aCoqLg0KDQoyLiAqKlbhuqVuIMSQ4buBIEdoaSBLw6lwIEThu68gTGnhu4d1IChUaGUgRHVhbC1Xcml0ZSBQcm9ibGVtKSoqOg0KICAgLSAqQuG6o24gY2jhuqV0KjogS2hpIG3hu5l0IHNlcnZpY2UgduG7q2EgbXXhu5FuIGPhuq1wIG5o4bqtdCBEYXRhYmFzZSBj4bunYSBtw6xuaCB24burYSBtdeG7kW4gZ+G7rWkgbeG7mXQgRXZlbnQgbMOqbiBLYWZrYS4gTuG6v3UgbMawdSBEQiB0aMOgbmggY8O0bmcgbmjGsG5nIG3huqFuZyBy4bubdCBraMO0bmcgZ+G7rWkgxJHGsOG7o2MgS2Fma2EgKGhv4bq3YyBuZ8aw4bujYyBs4bqhaSksIGjhu4cgdGjhu5FuZyBwaMOibiB0w6FuIHLGoWkgdsOgbyB0cuG6oW5nIHRow6FpIGLhuqV0IG5o4bqldCB2xKluaCB2aeG7hW4uDQogICAtICpLaOG6r2MgcGjhu6VjKjogQuG6r3QgYnXhu5ljIHBo4bqjaSDDoXAgZOG7pW5nICoqVHJhbnNhY3Rpb25hbCBPdXRib3ggUGF0dGVybioqIGvhur90IGjhu6NwIHbhu5tpIENoYW5nZSBEYXRhIENhcHR1cmUgKERlYmV6aXVtKSDEkeG7gyDEkeG6o20gYuG6o28gRXZlbnQgxJHGsOG7o2MgcGjDoXQgxJFpIG3hu5l0IGPDoWNoIG5ndXnDqm4gdOG7rS4NCg0KMy4gKipDw6FpIELhuqt5IMSQ4bupdCBHw6N5IE5o4bqldCBRdcOhbiBUcm9uZyBTcGFjZS1CYXNlZCBBcmNoaXRlY3R1cmUqKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IEzGsHUgdHLhu68gdG/DoG4gYuG7mSBk4buvIGxp4buHdSB0csOqbiBSQU0gxJHhu4MgxJHhuqF0IHThu5FjIMSR4buZIGNhby4gTuG6v3UgbeG7mXQgc+G7sSBj4buRIG3huqV0IMSRaeG7h24gxJHhu5l0IG5n4buZdCB44bqjeSByYSB0csOqbiBj4bulbSBtw6F5IGNo4bunIHRyxrDhu5tjIGtoaSB0aeG6v24gdHLDrG5oIFdyaXRlLUJlaGluZCBr4buLcCBnaGkgZOG7ryBsaeG7h3UgdOG7qyBSQU0geHXhu5FuZyBEaXNrLCBjw6FjIGdpYW8gZOG7i2NoIHTDoGkgY2jDrW5oIHbhu6thIGto4bubcCBs4buHbmggc+G6vSBi4buRYyBoxqFpIGtow7RuZyBk4bqldSB24bq/dC4NCiAgIC0gKkto4bqvYyBwaOG7pWMqOiBT4butIGThu6VuZyBOb24tVm9sYXRpbGUgTWVtb3J5IChOVkRJTU0vT3B0YW5lKSBob+G6t2MgY8ahIGNo4bq/IMSR4buTbmcgYuG7mSBSQU0gUmVwbGljYXRpb24gcXVhIG3huqFuZyBixINuZyB0aMO0bmcgcuG7mW5nIFJETUEgduG7m2kgUXVvcnVtIHThu5FpIHRoaeG7g3UgdHLGsOG7m2Mga2hpIHjDoWMgbmjhuq1uIGdpYW8gZOG7i2NoLg0KDQo0LiAqKkvhu7kgVGh14bqtdCBDaOG6qW4gxJBvw6FuICYgR2nDoW0gU8OhdCBLaeG6v24gVHLDumMgQuG6sW5nIENMSSoqOg0KICAgYGBgYmFzaA0KICAgIyAxLiBHacOhbSBzw6F0IMSR4buZIHRy4buFIG3huqFuZyBnaeG7r2EgY8OhYyBNaWNyb3NlcnZpY2VzIGLhurFuZyBKYWVnZXIgQ0xJIC8gT3BlblRlbGVtZXRyeQ0KICAgamFlZ2VyLXF1ZXJ5IC0tY29uZmlnPXRlbGVtZXRyeS55YW1sIC0tdHJhY2UtaWQ9NGJmOTJmMzU3N2IzNGRhNmEzY2U5MjlkMGUwZTQ3MzYNCg0KICAgIyAyLiBLaeG7g20gdHJhIHTDrG5oIHRy4bqhbmcga+G6v3QgbuG7kWkgS2Fma2EgQnJva2VyIGNobyBFdmVudC1Ecml2ZW4gQXJjaGl0ZWN0dXJlDQogICBrYWZrYS1jb25zdW1lci1ncm91cHMuc2ggLS1ib290c3RyYXAtc2VydmVyIGxvY2FsaG9zdDo5MDkyIC0tZGVzY3JpYmUgLS1ncm91cCBvcmRlci1wcm9jZXNzb3JzDQoNCiAgICMgMy4gUGjDom4gdMOtY2ggdMOgaSBuZ3V5w6puIFJBTSB2w6AgxJHhu5kgdHLhu4UgY+G7p2EgSW4tTWVtb3J5IEdyaWQgKFJlZGlzIENsdXN0ZXIpDQogICByZWRpcy1jbGkgLS1jbHVzdGVyIGluZm8gMTI3LjAuMC4xOjcwMDANCiAgIGBgYA0KDQotLS0NCg0KIyMgNS4gQuG6o25nIFNvIHPDoW5oICYgRGVjaXNpb24gTWF0cml4DQoNCiMjIyA1LjEuIE1hIFRy4bqtbiDEkMOhbmggR2nDoSBUb8OgbiBEaeG7h24gQ8OhYyBQaG9uZyBDw6FjaCBLaeG6v24gVHLDumMNCg0KfCBQaG9uZyBDw6FjaCBLaeG6v24gVHLDumMgfCBLaOG6oyBOxINuZyBN4bufIFLhu5luZyAoU2NhbGFiaWxpdHkpIHwgxJDhu5kgVHLhu4UgKExhdGVuY3kpIHwgxJDhu5kgUGjhu6ljIFThuqFwIFbhuq1uIEjDoG5oIHwgVMOtbmggTmjhuqV0IFF1w6FuIChDb25zaXN0ZW5jeSkgfCBOZ+G7ryBD4bqjbmggVOG7kWkgxq91IE5o4bqldCB8DQp8IDotLS0gfCA6LS0tOiB8IDotLS06IHwgOi0tLTogfCA6LS0tOiB8IDotLS0gfA0KfCAqKk1vbm9saXRoIEPhu5UgxJBp4buDbioqIHwgVGjhuqVwIHwgQ+G7sWMgdGjhuqVwICgkXHRleHR7bnN9JCkgfCBS4bqldCB0aOG6pXAgfCBBQ0lEIFR1eeG7h3QgxJDhu5FpIHwgU+G6o24gcGjhuqltIG3hu5tpIChNVlApLCBTdGFydHVwLCBU4bqjaSB0aOG6pXAgfA0KfCAqKk1vZHVsYXIgTW9ub2xpdGgqKiB8IFRydW5nIGLDrG5oIC0gQ2FvIHwgQ+G7sWMgdGjhuqVwICgkXHRleHR7bnN9JCkgfCBUaOG6pXAgfCBBQ0lEIFR1eeG7h3QgxJDhu5FpIHwgKio5MCUg4bupbmcgZOG7pW5nIGRvYW5oIG5naGnhu4dwIHbhu6thICYgbOG7m24qKiB8DQp8ICoqTWljcm9zZXJ2aWNlcyoqIHwgQ+G7sWMgY2FvIHwgVHJ1bmcgYsOsbmggLSBDYW8gKCRcdGV4dHttc30kKSB8IFLhuqV0IGNhbyB8IEV2ZW50dWFsIENvbnNpc3RlbmN5IHwgxJDhu5lpIG5nxakgPiAxMDAga+G7uSBzxrAsIG5oaeG7gXUgZG9tYWluIMSR4buZYyBs4bqtcCB8DQp8ICoqRXZlbnQtRHJpdmVuIChFREEpKip8IFbDtCBo4bqhbiB8IEJp4bq/biB0aGnDqm4gKEFzeW5jKSB8IENhbyB8IEV2ZW50dWFsIENvbnNpc3RlbmN5IHwgSOG7hyB0aOG7kW5nIHBo4bqjbiBo4buTaSB0aOG7nWkgZ2lhbiB0aOG7sWMsIElvVCwgU3RyZWFtaW5nIHwNCnwgKipTcGFjZS1CYXNlZCAoSU1ERykqKnwgQ+G7sWMgaOG6oW4gfCBTacOqdSB0aOG6pXAgKCRcbXVcdGV4dHtzfSQpIHwgQ+G7sWMgY2FvIHwgTWVtb3J5LUZpcnN0IC8gQXN5bmMgRGlzayB8IFPDoG4gY2jhu6luZyBraG/DoW4sIMSR4bqldSBnacOhLCBnYW1lIHRo4budaSBnaWFuIHRo4buxYyB8DQp8ICoqU2VydmVybGVzcyAoRmFhUykqKiB8IFThu7EgxJHhu5luZyB2w7QgaOG6oW4gfCBDYW8gKENvbGQgU3RhcnRzKSB8IFRydW5nIGLDrG5oIHwgVMO5eSB0aHXhu5ljIEJhY2tlbmQgREIgfCBUw6FjIHbhu6UgxJHhu4tuaCBr4buzLCB44butIGzDvSDhuqNuaC92aWRlbyBu4buBbiwgV2ViaG9vayB8DQp8ICoqUGlwZSBhbmQgRmlsdGVyKiogfCBDYW8gKFThu6tuZyBzdGFnZSkgfCBQaOG7pSB0aHXhu5ljIOG7kW5nIGThuqtuIHwgVGjhuqVwIHwgVHXhuqduIHThu7EgdGhlbyBsdeG7k25nIHwgVHLDrG5oIGJpw6puIGThu4tjaCwgbcOjIGjDs2EgdmlkZW8sIEJpZyBEYXRhIEVUTCB8DQp8ICoqUGx1Zy1pbiAvIEtlcm5lbCoqIHwgVGjhuqVwIC0gVEIgfCBS4bqldCB0aOG6pXAgfCBUaOG6pXAgfCBO4buZaSB04bqhaSB0aeG6v24gdHLDrG5oIHwgRGVza3RvcCBBcHBzIChWUyBDb2RlKSwgSOG7hyDEkWnhu4F1IGjDoG5oLCBDTVMgfA0K