📄️ بخش ۱: نمای کلی و مدل ذهنی
مدل runtime، اشیای اصلی، جهت callbackها و چرخهی عمر تونل که باید پیش از تغییر هر تونل WaterWall بشناسید.
📄️ بخش ۲: line و طول عمر
چرخهی عمر اتصال، خطرهای re-entrancy، نگهداشتن reference برای line و الگوهای Finish صحیح که جلوی خطاهای use-after-free را در تونلهای WaterWall میگیرند.
📄️ بخش ۳: buffer و padding
مدل buffer sbuf_t، buffer poolهای هر worker، بودجهٔ padding سمت چپ و روش افزودن header پروتکل بدون مختلکردن ترکیبپذیری chain.
📄️ بخش ۴: تونلهای packet
معنای packet line، تونلهای packet خالص، پلهای packet/stream، مقداردهی packet line و قواعد جهت در تونلهای جفت برای کارهای layer 3.
📄️ بخش ۵: ساختار و روند کار
ساختار فایلهای یک تونل WaterWall، مسئولیت هر فایل، metadata در node.c، الگوهای ساخت و line state، محدودیتهای HTTP و روند پیادهسازی.
📄️ بخش ۶: build، تست و review
presetهای CMake، build یک target، اجرای integration testها، نکات محیط build، چکلیست review و قالب گزارش coding agentها.
📄️ بخش ۷: shutdown برنامه
shutdown controller، پروتکل quiescence برای workerها، مراحل lifecycle-v2 اجزا، تعیین تکلیف taskها، signalها، deviceها و ترتیب آزادسازی منابع.
🗃️ API
2 مورد