htcacheclean — Очистка кэш-памяти диска

htcacheclean используется для поддержания размера хранилища mod_cache_disk в заданных пределах или ограничения на используемые индексы. Этот инструмент может работать как вручную, так и в режиме демона. В режиме демона он находится в фоновом режиме и проверяет каталог кэша через регулярные интервалы на наличие кэшированного контента для удаления. Демона можно корректно остановить, отправив ему сигнал TERM или INT. При ручном запуске выполняется разовое сканирование каталога кэша на наличие кэшированного контента для удаления. Если указаны один или несколько URL-адресов, каждый 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, сообщаемые в статистике удалённые индексы не могут учитывать удалённые каталоги и будут обозначены как оценочные.

-v

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

-r

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

-n

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

-t

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

-ppath

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

-Ppidfile

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

-Rround

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

-llimit

Указать limit как предел общего размера кэш-памяти диска. Значение выражается в байтах по умолчанию (или добавлением суффикса B к числу). Добавьте K для Кбайт, M для Мбайт или G для Гбайт.

-Llimit

Указать limit как предел общего количества индексов кэш-памяти диска. Можно также использовать суффикс 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-адрес, и URL-адрес был кэширован и успешно удалён, возвращается 0, 2 в противном случае. Если при удалении URL-адреса произошла ошибка, возвращается 1.