İçeriğe geç
zeev1.0.0-rc.1

21 — Deterministik IO izi

Depodaki spec/21-deterministik-io-izi.md belgesinden Zee ile üretildi.

Normatif kaynak: RFC-0022, ADR-026. Gerçekleme: yorumlayici/io_izi.rs ve dil iz.

Kayıt (TANIMLI)

IzKaydedenIo, GirdiCikti üzerinden tamamlanan her gözlenebilir IO çağrısını tek küresel sırayla kaydeder. Olay; işlem adı, sıralı argüman alanları ve sıralı sonuç alanları taşır. Host çağrısı tamamlanmadan olay tamamlanmış sayılmaz. K-134 request commit/rollback kancaları bağımsız IO değildir; kayıt sarmalayıcısı bunları olay eklemeden iç adaptöre geçirir.

dil iz kaydet <iz> <program> [argümanlar] gerçek koşuyu çalıştırır ve şema-1 izini atomik yazar. İz üretimi açık opt-in'dir.

Replay (TANIMLI)

IzYenidenOynatici dış IO adaptörü kullanmaz. Her çağrı sıradaki olayın işlem ve argümanlarıyla birebir eşleşmek ZORUNDADIR. Eşleşirse kayıtlı sonuç döner; farkta koşu fail-closed başarısız olur. Başarılı koşu izin tamamını tüketir.

Replay dosya/ağ/web/PostgreSQL/transaction/donanım etkisini yeniden uygulamaz; bu etkilerin aynı protokolle istendiğini doğrular. dil iz oynat kullanıcı çıktısını ancak bütün iz eşleştiğinde gösterir.

Şema-1 byte biçimi (TANIMLI)

  • Başlık: zee-io-izi<TAB>1<LF>.
  • Olay: sıra, işlem, argüman_sayısı, sonuç_sayısı, alanlar; ayraç TAB, bitiş LF'dir.
  • Sıra 1 tabanlı ve kesintisizdir. Sayılar kanonik onluktur.
  • Alanlar, UTF-8 metnin küçük harfli hex yazımıdır. Hex şifreleme değildir.
  • İşlem sözlüğü ve işlem-özel alan/tag şemaları kapalıdır.
  • En çok 64 MiB, 100.000 olay ve olay başına 4.096 alan kabul edilir.
  • Bilinmeyen sürüm/işlem, sıra boşluğu, büyük/bozuk/non-kanonik alan yürütme öncesinde reddedilir.

Şema, işlem sözlüğü veya alan semantiğindeki kırıcı değişiklik yeni başlık sürümü gerektirir.

Gizlilik (TANIMLI)

İz; kullanıcı girdisi, dosya/ağ/veritabanı içeriği, argüman, çerez ve token taşıyabilir; özel artefakttır ve varsayılan olarak Git dışında kalır. Parola ile PHC özeti ham/geri çevrilebilir alan olamaz; yalnız ayrı SHA-256 parmak izleri kaydedilir.

CLI dosya kaydı yalnız sahibine erişimle yayımlanır: Unix 0600, macOS boş genişletilmiş ACL, Windows mirassız owner-rights DACL. Eski hedefin geniş izinleri taşınmaz; symlink hedefi reddedilir. Bu davranış IO olaylarını maskelemez ve gömme API’sinin döndürdüğü metnin saklama politikasını belirlemez.

Sınır

Kaynak program iz içine gömülmez. Derleme/birim yükleme yürütme IO izi değildir. Saat/rastgele tohum ve sanal zaman ilerleme algoritması spec/22'deki zee-io-1 profilidir. Şema-1 profil algoritmasını yeniden çalıştırmaz; gözlenen çağrı, sonuç ve sırayı korur.

Şema-1'in dosya olayları dosya_atomik_tasi, dosya_sil, dosyalari_listele, dosya_sha256 ve (K-333) dosya_ilk_baytlari işlemlerini de kapsar. Argümanlar exact göreli yollar (imza okumasında ayrıca onluk bayt sayısı); sonuçlar başarı etiketiyle sayı/liste/özet/onaltılık imza veya hata mesajıdır. Replay hiçbir fiziksel taşıma, silme, listeleme, hashing ya da okuma yapmaz.

K-337 birincil_surec olayı argümansızdır ve tek 0/1 sonucu taşır; replay yönetici ya da işçi grubu kurmaz, kayıtlı rolü döndürür.

Kaynak: spec/21-deterministik-io-izi.md · Bütün belgeler