htcacheclean — очистка дискового кэша

htcacheclean используется для поддержания размера хранилища mod_cache_disk в пределах заданного ограничения или ограничения на количество используемых inode. Эта утилита может работать как вручную, так и в режиме демона. В режиме демона она работает в фоновом режиме и через регулярные интервалы проверяет каталог кэша на наличие кэшированного содержимого для удаления. Чтобы корректно остановить демон, отправьте ему сигнал TERM или INT. При ручном запуске каталог кэша однократно проверяется на наличие кэшированного содержимого для удаления. Если указаны один или несколько URL, каждый из них будет удалён из кэша, если он там присутствует.

Синтаксис

htcacheclean [ -D ] [ -v ] [ -t ] [ -r ] [ -n ] [ -Rround ] -ppath [ -llimit ] [ -Llimit ]

htcacheclean [ -n ] [ -t ] [ -i ] [ -Ppidfile ] [ -Rround ] -dinterval -ppath [ -llimit ] [ -Llimit ]

htcacheclean [ -v ] [ -Rround ] -ppath [ -a ] [ -A ]

htcacheclean [ -D ] [ -v ] [ -t ] [ -Rround ] -ppath url

Параметры

-dinterval

Запустить в режиме демона и повторять очистку кэша каждые interval минут. Этот параметр несовместим с параметрами -D, -v и -r. Чтобы корректно остановить демон, отправьте ему сигнал SIGTERM или SIGINT.

-D

Выполнить пробный запуск, ничего не удаляя. Этот параметр несовместим с параметром -d. При пробном запуске с удалением каталогов с помощью -t количество inode, указанное в статистике как удалённое, не учитывает удалённые каталоги и будет помечено как оценочное.

-v

Включить подробный вывод и печатать статистику. Этот параметр несовместим с параметром -d.

-r

Выполнить тщательную очистку. Предполагается, что веб-сервер Apache не запущен (иначе в кэш могут попасть некорректные данные). Этот параметр несовместим с параметром -d и подразумевает использование параметра -t.

-n

Работать с низким приоритетом. Это замедляет обработку, чтобы дать преимущество другим процессам. htcacheclean будет время от времени приостанавливать работу, чтобы (а) отложить операции ввода-вывода на диске и (б) дать ядру возможность в это время запланировать выполнение других процессов.

-t

Удалить все пустые каталоги. По умолчанию удаляются только файлы кэша, однако при некоторых конфигурациях большое количество созданных каталогов может потребовать внимания. Если конфигурация предполагает очень большое количество каталогов, из-за чего может возникнуть нехватка inode или записей в таблице размещения файлов, рекомендуется использовать этот параметр.

-ppath

Указать path в качестве корневого каталога дискового кэша. Это значение должно совпадать со значением, указанным в директиве CacheRoot.

-Ppidfile

Указать pidfile в качестве имени файла, в который будет записан идентификатор процесса при запуске в режиме демона.

-Rround

Указать round в качестве значения округления размеров вверх для учёта размеров блоков диска. Задайте размер блока раздела кэша.

-llimit

Указать limit в качестве общего ограничения размера дискового кэша. По умолчанию значение задаётся в байтах (или с добавлением B к числу). Добавьте K для килобайт, M для мегабайт или G для гигабайт.

-Llimit

Указать limit в качестве общего ограничения на количество inode дискового кэша. Также можно использовать суффикс K, M или G.

-i

Работать в интеллектуальном режиме и запускаться только при наличии изменений в дисковом кэше. Этот параметр можно использовать только вместе с параметром -d.

-a

Вывести список URL, хранящихся в кэше. Различные варианты одного URL будут выведены по одному разу для каждого варианта.

-A

Вывести список URL, хранящихся в кэше, вместе с их атрибутами в следующем порядке: URL, размер заголовка, размер тела, статус, версия сущности, дата, срок действия, время запроса, время ответа, наличие тела, HEAD-запрос.

Удаление указанного URL

Если htcacheclean переданы один или несколько URL, каждый URL будет удалён из кэша. Если для URL существуют несколько вариантов, будут удалены все варианты.

При удалении URL обратного прокси итоговый URL формируется из заголовка Host, порта, пути и строки запроса. Обратите внимание: символ '?' в URL необходимо указывать явно, независимо от наличия строки запроса. Например, при попытке удалить путь / на сервере localhost следует указать URL http://localhost:80/?.

Вывод списка URL в кэше

При передаче параметров -a или -A утилите htcacheclean URL из кэша будут выводиться по мере обнаружения, по одному URL в строке. Параметр -A выводит после URL полную запись кэша со следующими полями в указанном порядке:

URL

URL записи.

размер заголовка

Размер заголовка в байтах.

размер тела

Размер тела в байтах.

статус

Статус кэшированного ответа.

версия сущности

Количество повторных проверок актуальности этой записи без её удаления.

дата

Дата ответа.

срок действия

Дата окончания срока действия ответа.

время запроса

Время начала запроса.

время ответа

Время завершения запроса.

наличие тела

Если значение равно 0, тело запроса не сохранено; в противном случае — 1.

HEAD-запрос

Если значение равно 1, запись содержит кэшированный HEAD-запрос без тела; в противном случае — 0.

Код завершения

htcacheclean возвращает нулевой код ("true"), если все операции выполнены успешно, и 1 в противном случае. Если указан URL, он был кэширован и успешно удалён, возвращается 0, в противном случае — 2. Если при удалении URL произошла ошибка, возвращается 1.