- Durum: kabul
- Tarih: 3 Eylül 2026
- İş: K-163/F030
Karar
HTTP framing/content-length/timeout ve temp spool native web adaptörünün; atomik publish/delete kalıcı dosya çekirdeğinin; tür/etki/yetkinlik intrinsic kaydının; metadata durum makinesi ve uzlaştırma ise ürünün sahibidir.
Yorumlayıcı IO trait'i binary buffer taşımaz. Rota yalnız proje-kökü göreli temp yolunu, hash'i ve boyutu görür. Böylece dil heap zarfı yükleme boyutuna bağlanmaz, binary payload string'e dönüştürülmez ve ürün DB dışı yan etkiyi açık saga olarak yönetir.
ToplayanIo ayrı modüle çıkarılarak kök yorumlayıcı bütçesi korunur. Yeni işlemler deterministik adaptör, capability sargısı ve IO trace/replay boyunca aynı sözleşmeyle taşınır. Genel bir dosya sistemi API'si veya gizli DB+dosya transaction'ı açılmaz.
Ek — K-329: aygıtlar arası taşıma (21 Ekim 2026)
Atomik taşıma yalnız rename(2) kullanıyordu. Üretim unit'leri ProtectSystem=strict ile ReadWritePaths=…/kaynak/.zee …/kaynak/medya … yollarını ayrı bind mount ettiği için aynı disk üzerinde bile rename EXDEV (errno 18) veriyor, panel yüklemeleri ve eski medyanın taşınması dosya atomik taşınamadı: Invalid cross-device link ile başarısız oluyordu (zee-cekirdek talebi W5).
- Karar. Talebin (a) seçeneği:
kalici_dosya::atomik_tasirenameErrorKind::CrossesDevices(UnixEXDEV, WindowsERROR_NOT_SAME_DEVICE) döndürürse aynı hedef klasörü kilidi altında hedef klasöründe geçici dosyaya akışla kopyalar, replace yolunun metadata sözleşmesiyle (mod, sahip, ACL/xattr) kaynağın bilgisini uygular, fsync eder, aynı klasörde atomik adlandırır, klasörü fsync eder ve en son kaynağı siler. Görünürlük atomik kalır, no-clobber sözü ve EXDEV dışındaki hata yolları değişmez; tanı kodu, grammar vedil::api::v1aynıdır. - Hata yolu. Yayından önce her arıza geçiciyi siler, kaynağa dokunmaz. Hedef klasörü eşzamanlanamaz ya da kaynak silinemezse yayımlanan hedef geri çekilir; iki kopya ya da yarım dosya kalmaz. Kaynak silindikten sonra kaynak klasörünün fsync arızası rename yolundaki gibi hata döner, veri hedefte bütündür.
- Açılış öz-sınaması reddedildi. Geri düşüş doğruluğu sağladığı için “aynı dosya sistemi” önkoşulu yalnız performans konusudur (yükleme başına ≤ 16 MiB kopya). Açılışta
.zee/yuklemeler→ hedef sınaması üretim dizinlerine yazar, yeni bir CLI uyarı yüzeyi (K-167 uyumluluk yüzeyi) açar ve rotaların seçtiği keyfi hedef klasörlerini kapsayamaz. Ürünün kendiExecStartPreöz-sınaması ürün sahipliğinde kalır. - Reddedilen: (b) ayrı hata türü/
nedenialanı (kullanıcıya çözüm yerine dağıtım bilgisi yükler), hard link ile yayın (bazı dosya sistemlerinde yok), Linux'a özelcopy_file_range/renameat2yolu (io::copyzaten uygun çekirdek kopyasını seçer). - Kanıt:
kalici_dosya::yasam_dongusubirim testleri (EXDEV enjeksiyonu, yayın arızasında temizlik, EXDEV dışı hata değişmez, Linux/dev/shmgerçek aygıt sınırı), regressionruntime/aygitlar-arasi-tasima(native-dosya-exdevkipi: gerçekdilsüreci,medyatmpfs'e bağ; düzeltme öncesitaşıma reddedildi).
Ek — K-332: geçici yükleme dosyası isteğe aittir (12 Kasım 2026)
zee-cekirdek 1.18.0 ziyaretçiye açık CV yükleme rotası (/basvuru-yukle) ekledi; uçtan uca sınamada CSRF'siz octet-stream isteğinin 403 almasına rağmen tam gövdeli .parca bıraktığı görüldü. Doğrulamada beş yol da dosya bırakıyordu: CSRF/oturum yok, sahte oturum, 404, kısa gövde, rotanın dosyayı taşımadan 200 vermesi. Gövde, rota ve güvenlik denetimi yorumlayıcıda koşmadan önce diske aktığı için oturumsuz istemci istek başına 16 MiB yetim dosya bırakarak diski doldurabiliyordu; temizlik yalnız ürünün açılış süpürgesine kalmıştı (GB-129, yüksek).
- Karar. Temp spool'un sahibi native adaptör olduğu için silme sözü de onundur.
AkanYuklemedüşerken kısmi dosyayı siler;tamamlabirIstekYuklemesikoruması döndürür, adaptör onu istek boyunca tutar veistek_islemini_tamamla/istek_islemini_geri_al(yedek: sonrakiistek_al) onu düşürür. Rota dosyayı aynı istekte taşıdıysa yol boştur ve silme etkisizdir; eylem geri alması dosyayı geri getirdiyse silinir. - Ön kapı. Yorumlayıcı güvenli olmayan her yöntemde CSRF ve oturum ister (
!guvenli()), bu yüzdenGET/HEADdışındaki binary yükleme tek ve boş olmayanX-Zee-CSRFile oturum çerezi taşımıyorsa adaptör gövdeyi okumadan 403 döner. Belirtecin oturumla karşılaştırılması rota denetiminde kalır; sahte belirteçli istek akar ve istek sonunda silinir. Gözlenebilir fark: böyle bir istek var olmayan adreste 404 yerine 403 alır. - Reddedilen: rota tablosunu ve oturum deposunu gövdeden önce native katmanda çözmek (yorumlayıcı rota yolu ifadelerini istek anında değerlendirir; güvenlik transaction'ını gövde okumasından önce açmak her okuma hatasında ayrıca geri alma ister), geçici yolu istekler arası tutmak (bilinen tüketici yok; disk sınırı ölçülemez kalır), yalnız açılış süpürgesine güvenmek.
- Açık sınır (18 Kasım 2026 ekiyle kapandı). Süreç istek ortasında ölürse (ölümcül tanı, sinyal) kalan dosya restart uzlaştırıcısına kalıyordu; aşağıdaki yaş tabanlı süpürme bunu runtime'a alır. Eşzamanlı akan yükleme sayısı bağlantı izni sınırıyla zaten sınırlıdır.
- Kanıt:
web_yuklemevemain.rsbirim testleri, regressionsecurity/reddedilen-yukleme-parcasi(native-web-yuklemekipi: gerçekdilworker'ı, altı senaryo; düzeltme öncesicsrf-yok400 veparça 5).
Ek — K-332: süreç ölümünden kalan yetim .parca süpürmesi (18 Kasım 2026)
Drop koruması süreç istek ortasında öldüğünde koşmaz; dosya yalnız ürünün açılış uzlaştırıcısına kalıyordu. Bu iki yönden zayıftı: (1) supervisor ölen worker'ı hemen yeniden başlattığından ürün süpürgesi ya yetimi göremez ya da — yaş bakmadan sildiği için — eşzamanlı başka worker'ın o an akan yüklemesini silebilir (zee-cekirdek W4); RFC-0038 açılış birincilliğinde yeniden başlayan worker ikincil olduğundan ürün süpürgesi ölen işçinin yetimini bir sonraki tam yeniden başlatmaya kadar hiç görmez. (2) Ürün süpürgesi olmayan zee web uygulamalarında yetimler diskte birikir (istek başına en çok 16 MiB).
- Karar. Spool'un sahibi olan native adaptör kendi adlandırmasındaki yetimleri de süpürür:
sunucu başlatdinleyiciyi kurduktan sonra ve çalışırken en sıkYETIM_SUPURME_ARALIGI(5 dk) aralıklaistek_albaşında,.zee/yuklemeleraltında yalnız<64 küçük hex>.parcaadlı, sembolik bağ olmayan, son değişikliğiYETIM_PARCA_YASI'ndan (15 dk) eski normal dosyalar silinir. Tur başına en çok 10 000 girdi incelenir. - Neden kilit yok. Canlı bir
.parca'nın son yazımından sonraki ömrü gövde okuma son tarihi (10 sn), rota çalıştırma bütçesi (30 sn) ve yanıt yazım zaman aşımıyla (10 sn) sınırlıdır; eşik bunun en az on katı olmak zorundadır ve sınırlar büyürse derleme zamanıassert!kırılır. Dolayısıyla eşzamanlı worker'ların canlı dosyası yaşla korunur; iki worker aynı turda süpürürse ikincisiNotFound'u yok sayar. Bu tasarım RFC-0038 tek-açılış/birincillik profilinden bağımsızdır: birincil/ikincil ayrımına, dosya ya da PG kilidine ihtiyaç duymaz, onunla çakışmaz. - Dokunulmayanlar. Ürünün kendi adlandırdığı dosyalar (ör. medya hazırlık dosyaları), alt dizinler, bağlar (bağ hedefi dahil) ve gelecek tarihli dosyalar (saat geri alındı) silinmez. Ürün uzlaştırıcısının
.parcadosyalarını yaş bakmadan silmesi ayrı bir ürün düzeltmesidir; runtime süpürmesi devreye girdiğinde ürün.parca'yı kendi taramasından çıkarabilir. - Reddedilen: açılışta tek sefer süpürme (yeniden başlatma anında yetim henüz genç, eşik altında kalır), worker kimliği/PID taşıyan ad ya da kilit dosyası (PID yeniden kullanımı ve çok host; yeni durum dosyası),
flockile canlılık (Windows'ta farklı anlam; yaş sözü yeterli), dil yüzeyine süpürme kalıbı açmak (core freeze; runtime'ın kendi geçici dosyası). - Açık sınır. Yetim, eşik dolup bir sonraki süpürme turuna kadar (en çok ~20 dk, boşta worker'da ilk isteğe kadar) diskte kalır. Boşta worker yeni yetim de üretmez.
- Kanıt:
web_yuklemebirim testleri (yetim_supurme_yalniz_yasli_runtime_parcasini_siler,canli_akan_yukleme_supurmeden_etkilenmez), regressionsecurity/yetim-yukleme-parcasi(native-web-yuklemekipi: gerçekdilworker'ı açılışta 16 dk'lık yetimi siler, 1 dk'lık canlıyı ve ürün adlı dosyayı korur; düzeltme öncesiyetim kaldı). GB-132.
Kaynak: adr/061-binary-yukleme-sahipligi.md · Bütün belgeler