pdnsd−ctl − управление pdnsd
pdnsd−ctl [−c каталог_кэша] [−q] команда [аргументы]
pdnsd−ctl управляет pdnsd − прокси DNS−сервером с постоянным кэшем. Отметим, что для использования
pdnsd−ctl должен быть включен сокет управления состоянием (указанием опции в командной строке pdnsd или в файле конфигурации).
−c каталог_кэша
Устанавливает каталог кэша (должен совпадать с настройками pdnsd). Это необходимо только если каталог отличается от каталога, заданного по умолчанию при компиляции.
|
−q |
Подавление сообщений об ошибках, если указанная команда или что−то другое идёт неправильно. |
help [аргументы отсутствуют]
Вывести краткую справку о команде.
version [аргументы отсутствуют]
Вывести информацию о версии и лицензии.
status [аргументы отсутствуют]
Вывести описание состояния кэша pdnsd, нити статуса и настройки. Также показывает, какие удалённые серверы имён считаются доступными.
server (индекс|метка) (up|down|retest) [dns1[,dns2[,...]]]
Задаёт состояние серверов с заданным индексом или меткой для включения, выключения или принудительного перезапуска проверки. Индекс назначается по порядку определения в pdnsd.conf и начинается с 0. Используйте команду status, чтобы увидеть индексы. Вы можете указать all вместо индекса, чтобы произвести действие над всеми серверами, имеющимися у pdnsd.
Необязательный третий аргумент может задавать последовательнй список IP−адресов, разделённых запятыми или пробелами. Этот список заменит адреса серверов имён, используемых pdnsd в заданной секции server. Эта возможность полезна для настройки pdnsd во время работы, для динамического учёта данных DNS в сценариях, вызванных ppp или DHCP−клиентами. Последний аргумент может также быть пустой строкой, что вызовет удаление существующих IP−адресов и соответственно вызовет переход секции server в неактивное состояние.
record имя (delete|invalidate)
Удаляет или аннулирует записи с заданным доменным именем, если они присутствуют в кэше. Аннулирование означает, что записи будут помечены как устаревшие, и при возможности будут перезагружены. Для локальных записей (то есть записей, которые были заданы в конфигурационном файле в секции rr, записи, прочитанные из файлов в стиле hosts и записи, добавленные с использованием pdnsd−ctl) аннулирование не действует. Однако сработает удаление.
source имя_файла владелец [время_жизни] [(on|off)] [noauth]
Загрузка файл в стиле hosts. Работает подобно использованию секции source pdnsd. Владелец и время жизни используются аналогично их использованию в секции source. Время жизни по умолчанию − 900 секунд (указывать его не обязательно). Следующий аргумент задаёт опцию server_aliases, по умолчанию она отключена. noauth используется для того, чтобы сделать домены не полномочными (это то же самое, что и установка опции authrec=off в конфигурационном файле, ознакомьтесь со страницей руководства pdnsd.conf(5), чтобы узнать что это означает). имя_файла − это имя того файла, который должен быть прочитан pdnsd.
add a адрес имя [время_жизни] [noauth]
add aaaa адрес имя [время_жизни] [noauth]
add ptr узел имя [время_жизни] [noauth]
add cname узел имя [время_жизни] [noauth]
add mx узел имя приоритет [время_жизни] [noauth]
Добавляет запись заданного типа в кэш pdnsd, замещая существующие записи с тем же именем и типом. Второй аргумет используется как значение опции в секции rr, совпадающей по имени с первым аргументом. Аргумент addr может быть списком IP−адресов, разделённых запятыми или пробелами. Время_жизни опционально, по умолчанию − 900 секунд. noauth используется для того, чтобы сделать домены не полномочными (действует как authrec=off в файле конфигурации, обратитесь к странице руководства pdnsd.conf(5) чтобы узнать, что это означает). Если вы хотите, что бы не было других записей, кроме только что добавленных в кэш, выполните pdnsd−ctl record имя delete перед добавлением записей.
neg имя [тип] [время_жизни]
Добавляет отрицательно кэшированные записи в кэш pdnsd, замещая существующие записи с тем же именем и типом. Если не задан тип, весь домен будет закэширован отрицательно. Для отрицательно кэшированных записей будет немедленно возвращён ответ об ошибке, без предварительного запроса других серверов. Время_жизни опционально, по умолчанию − 900 секунд.
config имя_файла
Перезагружает конфигурационный файл pdnsd.
Конфигурационный файл должен принадлежать пользователю, от имени которого будет запущен pdsnd, и быть доступным для чтения тому пользователю, uid которого
указан в опции run_as. Если не указано имя файла, будет перезагружен конфигурационный файл, использованный при запуске. Отметим, что некоторые изменения в
конфигурации, такие как порт или IP−адрес, которые прослушивает pdnsd, не могут быть выполнены таким образом и приведут к появлению сообщения об ошибке. В этих
случаях нужно перезапустить pdnsd.
include имя_файла
Обработать включаемый файл.
Включаемые файлы могут содержать те же типы секций, что и конфигурационный файл, за исключением секций global и server, которые недоступны. Эта команда может
использоваться для добавления данных к кэшу без переконфигурирования pdnsd.
eval строка
Обработать строку, как если бы она являлась частью включаемого файла.
Строка должна содержать одну или более полностью настроенных секций, за исключением секций global и server, которые недоступны. Если задано несколько строк,
они будут объединены через символ новой строки и обработаны совместно.
empty−cache [[+|−]имя ...]
Удалить все элементы кэша, совпадающие с правилами включений/исключений.
Если не были указаны аргументы, кэш полностью очищается, при этом из него удаляются все существующие записи. Заметим, что команда также удалит локальные
записи, определённые в конфигурационном файле. Для восстановления локальных записей сразу после этого запустите "pdnsd−ctl config".
Если указан один или более аргументов, они интерпретируются как имена включений/исключений. Если аргумент начинается с ’+’ имя будет включено. Если аргумент
начинается с ’−’, оно будет исключено. Если аргумент не начинается с ’+’ или ’−’, подразумевается ’+’. Если доменное имя записи в кэше оканчивается одним из
имён в списке, применяется первое совпадение. Если совпададение включающее, запись в кэше удаляется, иначе − она остаётся. Если совпадений не найдено, действие
по умолчанию − не удалять.
dump [имя]
Выводит об имени информацию, хранящуюся в кэше. Если имя начинается с точки и это не корневой домен, будет напечатана информация об именах в кэше оканчивающихся заданным именем (включая имя без ведущей точки). Если имя не указано, будет выведена информация обо всех именах в кэше.
list−rrtypes [аргументы отсутствуют]
Список доступных типов ресурсных записей для команды neg. Отметим, что они могут использоваться только в команде neg, но не в add!
Если вы перенаправляете вывод команды dump на вход программы, которая читает только часть вывода и
блокируется (как more или less), нити pdnsd, пытающиеся добавить новые записи к кэшу, будут приостановлены до закрытия канала. В таком случае предпочтительно
захватывать вывод в файл.
Сообщайте о любых других ошибках авторам.
Томас Мёстль (Thomas Moestl) <tmoestl@gmx.net>
Пол Э. Ромбаутс (Paul A. Rombouts) <p.a.rombouts@home.nl> (для версии 1.1.8b1−par и более поздних).
Последний пересмотр: 04 сентября 2008, Пол Э. Ромбаутс (Paul A. Rombouts)
Перевод на русский язык выполнил Владимир Ступин <vladimir@stupin.su>.
pdnsd(8), pdnsd.conf(5)