Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



   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)