Kullanım
htcacheclean [ -D ] [ -v ] [ -t ] [ -r ] [ -n ] [ -Ryuvarlama ] -pyol [ -lsınır ] [ -Lsınır ]
htcacheclean [ -n ] [ -t ] [ -i ] [ -Ppid_dosyası ] [ -Ryuvarlama ] -daralık -pyol [ -lsınır ] [
-Lsınır ]
htcacheclean [ -v ] [ -Ryuvarlama ] -pyol [ -a ] [ -A ]
htcacheclean [ -D ] [ -v ] [ -t ] [ -Ryuvarlama ] -pyol url
Özet
htcacheclean, mod_cache_disk'in depolama alanının boyutunu belirli bir boyut sınırı veya kullanımda olan inode sınırı içinde tutmak için kullanılır. Bu araç manuel olarak veya arka plan süreci (daemon) modunda çalıştırılabilir. Arka plan süreci modunda çalışırken, arka planda uyur ve silinecek önbelleğe alınmış içerikler için önbellek dizinini düzenli aralıklarla kontrol eder. TERM veya INT sinyali göndererek arka plan sürecini temiz bir şekilde durdurabilirsiniz. Manuel olarak çalıştırıldığında, önbellek dizininde silinecek önbelleğe alınmış içeriklerin tespiti için tek seferlik bir kontrol gerçekleştirilir. Bir veya daha fazla URL belirtilirse, önbellekte mevcut olmaları durumunda her bir URL silinir.
Seçenekler
-daralık Arka plan süreci (daemon) olarak çalıştırır ve önbellek temizliğini her aralık dakikada bir tekrarlar. Bu seçenek -D, -v ve -r seçenekleri ile birbirini dışlar. Arka plan sürecini temiz bir şekilde sonlandırmak için ona bir SIGTERM veya SIGINT göndermeniz yeterlidir.
-D: Bir deneme çalışması (dry run) gerçekleştirir ve hiçbir şeyi silmez. Bu seçenek -d seçeneği ile birbirini dışlar. Deneme çalışması yaparken ve -t ile dizinleri silerken, istatistiklerde silindiği bildirilen inode'lar silinen dizinleri hesaba katamaz ve tahmini olarak işaretlenir.-v: Ayrıntılı bilgi verir ve istatistikleri yazdırır. Bu seçenek -d seçeneği ile birbirini dışlar.-r: Tamamen temizler. Bu seçenek, Apache web sunucusunun çalışmadığını varsayar (aksi takdirde önbellekte çöp veriler oluşabilir). Bu seçenek -d seçeneği ile birbirini dışlar ve -t seçeneğini ima eder.-n: İyi niyetli (nice) davranır. Diğer süreçlerin yararına daha yavaş işlem yapılmasına neden olur. htcacheclean; (a) disk giriş/çıkışının (IO) gecikmesi ve (b) çekirdeğin bu süre zarfında diğer süreçleri zamanlayabilmesi için zaman zaman uyku moduna geçer.-t: Tüm boş dizinleri siler. Varsayılan olarak yalnızca önbellek dosyaları kaldırılır, ancak bazı yapılandırmalarda oluşturulan çok sayıda dizin dikkat gerektirebilir. Yapılandırmanız, inode veya dosya ayırma tablosu (file allocation table) tükenmesinin bir sorun haline gelebileceği noktaya kadar çok sayıda dizin gerektiriyorsa, bu seçeneğin kullanılması önerilir.
-pyol yol yolunu disk önbelleğinin kök dizini olarak belirtir. Bu, CacheRoot yönergesi ile belirtilen değerle aynı olmalıdır.
-Ppid_dosyası Arka plan süreci olarak çalıştırıldığında süreç kimliğinin (PID) yazılacağı dosyanın adı olarak pid_dosyası değerini belirtir.
-Ryuvarlama Disk blok boyutlarını telafi etmek amacıyla boyutların yuvarlanacağı miktar olarak yuvarlama değerini belirtir. Önbellek bölümünün blok boyutuna ayarlayın.
-lsınır Toplam disk önbelleği boyutu sınırı olarak sınır değerini belirtir. Değer varsayılan olarak bayt cinsinden ifade edilir (veya sayının sonuna B eklenerek). Kilobayt için K, Megabayt için M veya Gigabayt için G ekleyin.
-Lsınır Toplam disk önbelleği inode sınırı olarak sınır değerini belirtir. K, M veya G ekleri de kullanılabilir.
-i: Akıllı davranır ve yalnızca disk önbelleğinde bir değişiklik olduğunda çalışır. Bu seçenek yalnızca -d seçeneği ile birlikte kullanılabilir.-a: Şu anda önbellekte depolanan URL'leri listeler. Aynı URL'nin varyasyonları, her varyasyon için bir kez listelenecektir.-A: Şu anda önbellekte depolanan URL'leri, öznitelikleriyle birlikte şu sırayla listeler: url, başlık (header) boyutu, gövde (body) boyutu, durum (status), varlık sürümü (entity version), tarih (date), son kullanma tarihi (expiry), istek zamanı (request time), yanıt zamanı (response time), gövde varlığı (body present), kafa isteği (head request).
Belirli Bir URL'yi Silme
htcacheclean aracına bir veya daha fazla URL geçilirse, her bir URL önbellekten silinir. Bir URL'nin birden fazla varyasyonu varsa, tüm varyasyonlar silinir.
Ters vekil sunucudan (reverse proxy) gelen bir URL silineceğinde, geçerli URL; Host başlığından, bağlantı noktasından (port), yoldan (path) ve sorgudan (query) oluşturulur. Sorgu dizesi olsun ya da olmasın, URL'deki '?' işaretinin her zaman açıkça belirtilmesi gerektiğini unutmayın. Örneğin, localhost sunucusundan / yolunu silme girişiminde bulunulacaksa, silinecek URL http://localhost:80/? olacaktır.
Önbellekteki URL'leri Listeleme
htcacheclean'e -a veya -A seçenekleri geçilerek, önbellek içindeki URL'ler bulundukça satır başına bir URL olacak şekilde listelenir. -A seçeneği, URL'den sonraki tam önbellek girdisini aşağıdaki sırayla alanlar halinde döker:
url Girdinin URL'si.
header size Bayt cinsinden başlık boyutu.
body size Bayt cinsinden gövde boyutu.
status Önbelleğe alınmış yanıtın durumu.
entity version Bu girdinin silinmeden kaç kez yeniden doğrulandığının (revalidated) sayısı.
date Yanıtın tarihi.
expiry Yanıtın son kullanma tarihi.
request time İsteğin başlangıç zamanı.
response time İsteğin bitiş zamanı.
body present 0 ise bu istekle birlikte hiçbir gövde depolanmamıştır, aksi takdirde 1'dir.
head request 1 ise girdi gövdesi olmayan önbelleğe alınmış bir HEAD isteği içerir, aksi takdirde 0'dır.
Çıkış Durumu
htcacheclean, tüm işlemler başarılı olduysa sıfır ("true") durumunu, aksi takdirde 1 döndürür. Bir URL belirtilmişse ve URL önbelleğe alınmış olup başarıyla kaldırıldıysa 0, aksi takdirde 2 döndürülür. URL kaldırma işlemi sırasında bir hata oluştuysa 1 döndürülür.
Apache HTTP Server 2019-08-09 HTCACHECLEAN(8)