htcacheclean - 清空磁碟快取

概要

htcacheclean [ -D ] [ -v ] [ -t ] [ -r ] [ -n ] [ -R回合 ] -p路徑 [ -l限制 ] [ -L限制 ]

htcacheclean [ -n ] [ -t ] [ -i ] [ -Ppid 檔案 ] [ -R回合 ] -d間隔 -p路徑 [ -l限制 ] [ -L限制 ]

htcacheclean [ -v ] [ -R回合 ] -p路徑 [ -a ] [ -A ]

htcacheclean [ -D ] [ -v ] [ -t ] [ -R回合 ] -p路徑 網址

選項

-dinterval

每隔 間隔 分鐘執行守護程序並重複清空快取。此選項與 -D、-v 和 -r 選項互斥。要淨空地關閉守護程序，只要傳送 SIGTERM 或 SIGINT 即可。

-D

進行模擬運算，且不刪除任何項目。此選項與 -d 選項互斥。當進行模擬運算並使用 -t 刪除目錄時，統計資料中所報告的已刪除索引節點可能無法考量已刪除的目錄，且將標示為估計。

-v

詳細說明並印出統計資料。此選項與 -d 選項互斥。

-r

徹底清除。此操作假設 Apache 網路伺服器未執行（否則快取中可能會出現垃圾）。此選項與 -d 選項互斥，並暗示 -t 選項。

-n

友善一點。讓其他程序優先執行，並減緩處理速度。htcacheclean 會不時暫停，以便 (a) 磁碟 I/O 會延遲，以及 (b) 核心可以在此同時排程其他程序。

-t

刪除所有空的目錄。預設情況只會移除快取檔案，但是某些組態中的大量目錄可能需要注意。如果您的組態需要非常大量的目錄，而索引節點或檔案配置表耗盡這個問題可能就會浮現，建議您使用此選項。

-ppath

指定 path 為磁碟快取的根目錄。這應該與 CacheRoot 指令指定的數值相同。

-Ppidfile

當執行守護程序時，指定 pidfile 為要寫入程序識別碼的檔案名稱。

-Rround

指定 round 為四捨五入到最近值的數量，以彌補磁碟區塊大小。設定為快取分割區的區塊大小。

-llimit

指定 limit 為磁碟快取的總大小限制。此數值預設以位元組表示（或於數字後面加上 B）。加上 K 表示千位元組，M 表示百萬位元組，或 G 表示十億位元組。

-Llimit

指定 limit 為磁碟快取的總索引節點限制。也可以使用 K、M 或 G 字尾。

-i

判斷並僅在磁碟快取有修改時執行。此選項僅可與 -d 選項搭配使用。

-a

列出快取中目前已儲存的網址。相同網址的不同變體將會依每個變體列出一筆。

-A

列出快取中目前已儲存的網址，以及其屬性，順序如下：網址、標頭大小、主體大小、狀態、實體版本、日期、過期、要求時間、回應時間、內文是否已存在、標頭要求。

刪除特定網址

如果傳遞一個或多個網址給 htcacheclean，每個網址都會從快取中刪除。如果存在某個網址的多個變體，則所有變體都會被刪除。

當反向代理的 URL 即將刪除時，將從 Host 標頭、port、path 和 query 建立有效的 URL。請注意，無論是否存在查詢字串，必須始終明確指定 URL 中的「?」符號。例如，嘗試從伺服器 localhost 刪除路徑 /，則待刪除的 URL 為 https://127.0.0.1:80/?。

快取中的 URL 清單

藉由將 -a 或 -A 選項傳遞至 htcacheclean，快取中的 URL 會在找到時列出，每行一個 URL。-A 選項會在 URL 後傾印出完整的快取條目，其中欄位的順序如下：

網址

條目的 URL

標頭大小

以位元組為單位的標頭大小。

主體大小

以位元組為單位的本體大小。

狀態

快取回應的狀態。

實體版本

這個條目未被刪除而重新驗證的次數。

日期

回應的日期。

到期

回應的到期日。

要求時間

請求開始的時間。

回應時間

請求結束的時間。

存在主體

如果為 0，則沒有儲存任何主體與此請求，否則為 1。

HEAD 請求

如果為 1，則條目包含不帶任何主體的快取 HEAD 請求，否則為 0。

結束狀態

如果所有作業成功，htcacheclean 會回傳零狀態（「true」），否則會回傳 1。如果指定了一個 URL，且 URL 已快取並成功移除，會回傳 0，否則會回傳 2。如果在移除 URL 期間發生錯誤，會回傳 1。