Пункт 70. Страница руководства: 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
- Демонизируйте и повторяйте очистку кеша каждые несколько минут. Этот параметр является взаимоисключающим с параметрами
-D
, -v
и -r
. Чтобы завершить работу демона, просто отправьте ему файл SIGTERM
или SIGINT
.
-
-D
- Сделайте пробный прогон и ничего не удаляйте. Эта опция является взаимоисключающей с
-d
опцией. При выполнении пробного прогона и удалении каталогов с помощью -t
, индексные дескрипторы, которые сообщаются как удаленные в статистике, не могут учитывать удаленные каталоги и будут помечены как оценка.
-
-v
- Будьте многословны и печатайте статистику. Эта опция является взаимоисключающей с
-d
опцией.
-
-r
- Тщательно очистите. Это предполагает, что веб-сервер Apache не запущен (иначе вы можете получить мусор в кеше). Эта опция является взаимоисключающей с
-d
опцией и подразумевает -t
опцию.
-
-n
- Будьте милы. Это приводит к замедлению обработки в пользу других процессов.
htcacheclean
будет время от времени засыпать, так что (а) дисковый ввод-вывод будет отложен, и (б) ядро может запланировать другие процессы в это время.
-
-t
- Удалите все пустые каталоги. По умолчанию удаляются только файлы кеша, однако в некоторых конфигурациях большое количество созданных каталогов может потребовать внимания. Если ваша конфигурация требует очень большого количества каталогов, до такой степени, что исчерпание индексного дескриптора или таблицы размещения файлов может стать проблемой, рекомендуется использовать этот параметр.
-
-ppath
- Укажите путь в качестве корневого каталога дискового кеша. Это должно быть то же значение, что указано в
CacheRoot
директиве.
-
-Ppidfile
- Укажите pidfile в качестве имени файла, в который будет записываться идентификатор процесса при демонизации.
-
-Rround
- Укажите округление как количество, до которого нужно округлить размеры, чтобы компенсировать размеры дисковых блоков. Установите размер блока раздела кеша.
-
-llimit
- Укажите limit как ограничение общего размера дискового кэша. По умолчанию значение выражается в байтах (или прибавляется
B
к числу). Прикрепить K
за Кбайты или M
за Мбайты.
-
-Llimit
- Укажите limit в качестве общего лимита инодов дискового кэша.
-
-i
- Будьте умнее и запускайте только тогда, когда произошла модификация дискового кеша. Эта опция возможна только вместе с
-d
опцией.
-
-a
- Список URL-адресов, которые в настоящее время хранятся в кеше. Варианты одного и того же URL будут перечислены один раз для каждого варианта.
-
-A
- Перечислите URL-адреса, которые в настоящее время хранятся в кеше, вместе с их атрибутами в следующем порядке: URL-адрес, размер заголовка, размер тела, статус, версия объекта, дата, срок действия, время запроса, время ответа, наличие тела, запрос заголовка.
Удаление определенного URL-адреса
Если htcacheclean
передается один или несколько URL-адресов, каждый URL-адрес будет удален из кеша. Если существует несколько вариантов URL, все варианты будут удалены.
Когда URL-адрес с обратным прокси-сервером должен быть удален, эффективный URL-адрес создается из заголовка узла ,
порта , пути и
запроса . Обратите внимание '?' в URL-адресе всегда должно указываться явно, независимо от того, присутствует строка запроса или нет. Например, при попытке удалить путь / с сервера
localhost URL-адрес для удаления будет
http://localhost:80/? .
Список URL-адресов в кеше
При передаче параметров
-a
или URL-адреса в кеше будут перечислены по мере их обнаружения, по одному URL-адресу в строке. Опция выводит полную запись кэша после URL-адреса с полями в следующем порядке: -A
htcacheclean
-A
- URL
- URL-адрес записи.
- размер заголовка
- Размер заголовка в байтах.
- размер тела
- Размер тела в байтах.
- положение дел
- Статус кэшированного ответа.
- версия сущности
- Количество раз, когда эта запись подвергалась повторной проверке без удаления.
- дата
- Дата ответа.
- истечение срока
- Срок действия ответа.
- время запроса
- Время начала запроса.
- время отклика
- Время окончания запроса.
- настоящее тело
- Если 0, тело с этим запросом не сохраняется, иначе 1.
- главный запрос
- Если 1, запись содержит кэшированный запрос HEAD без тела, 0 в противном случае.
Выход из состояния
htcacheclean
возвращает нулевой статус ("true"), если все операции были успешными, 1
в противном случае. Если URL-адрес указан, и URL-адрес был кэширован и успешно удален,
0
возвращается, 2
в противном случае. Если при удалении URL произошла ошибка, 1
возвращается.