PDNSD-CTL(8)

НАЗВАНИЕ
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 Rombouts) <p.a.rombouts@home.nl> (для версий 1.1.8b1-par и позже)

Последняя пересмотр: 04 сентября 2008, Пол Ромбаутс (Paul Rombouts)

АВТОР ПЕРЕВОДА
Перевод на русский язык выполнил Владимир Ступин <wheel69@yandex.ru>.

СМОТРИ ТАКЖЕ

pdnsd(8), pdnsd.conf(5)