pdnsd-ctl - управление pdnsd
НАЗВАНИЕ
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)
