Эта страница является переводом man testparm(1) из пакета Samba.

НАЗВАНИЕ

testparm — проверяет правильность оформления настроек в файле smb.conf.

СИНТАКСИС

testparm [-s] [-h] [-v] [-V] [-L <server name>] [-t encoding] {config filename} \

[hostname hostIP] [--parameter-name parametername] \

[--section-name sectionname]

ОПИСАНИЕ

Эта утилита является частью пакета samba(7).

Testparm — это программа-тест для проверки правильности внутреннего оформления конфигурационного файла smbd(8). Если программа сообщает об отсутствии ошибок, то вы можете использовать этот файл не опасаясь ошибок при его загрузке.

Заметьте, что testparm НЕ гарантирует того, что службы, определенные в конфигурационном файле, будут доступны и будут работать именно так, как вы задумали.

Если в командной строке указаны имя и IP хоста, программа-тест проверит службы по списку в smb.conf и сообщит, имеет ли указанный хост доступ к каждой из служб.

Если testparm находит ошибку в файле smb.conf, то возвращает код «1» вызывающей программе, при отсутствии ошибок возвращен будет код «0». Это позволяет использовать testparm в скриптах.

ПАРАМЕТРЫ

-s

Без этого параметра, testparm будет запрашивать у пользователя возврат каретки (Enter) после вывода списка служб, но перед дампом definitions служб.

-h | --help

Выведет сводку о параметрах командной строки.

-V

Выведет версию программы.

-L <server name>

Устанавливает значение server name для макроса %L. Используется для включении в тест файлов, определенных макросом %L.

-v

Если указан данный параметр, то testparm также будет выводить все параметры, не определенные в smb.conf и их значения по-умолчанию.

-t encoding

Выведет данные в заданной кодировке

--parameter-name parametername

Выведет дамп указанного параметра. Если не была указана секция, то областью видимости будет секция [global]. Также возможно дампануть опцию параметра. В этом случае имя опции параметра должно быть отделено от параметра двоеточием.

--section-name sectionname

Выведет дамп указанной секции.

config filename

Имя конфигурационного файла для проверки. Если параметр не указан то будет проверен стандартный smb.conf.

hostname

Если указаны этот и следующий параметры, то testparm будет проверять hosts allow и hosts deny параметры в файле smb.conf, для определения возможности доступа к smbd серверу хоста с заданными именем и IP. Если задан этот параметр, то должен быть задан и параметр hostIP.

hostIP

Указывает IP адрес хоста, определенного в предыдущем параметре.

ФАЙЛЫ

smb.conf, обычно так называется конфигурационный файл smbd(8).

ДИАГНОСТИКА

Программа выдаст сообщение об успешной/не успешной загрузке конфигурационного файла. Перед этим сообщением могут выскочить сообщения об ошибках или предупреждения, если файл не загрузился. В противном случает программа выведет дамп сведений о всех известных службах в stdout.

ВЕРСИЯ

Эта страница мануала верна для пакета Samba версии 3.

СМ. ТАКЖЕ

smb.conf(5), smbd(8)

Автор

Изначально Samba и сопутствующие утилиты были разработаны Эндрю Тридгеллом (Andrew Tridgell). Сейчас Samba разрабатывается Samba Team в качестве Open Source проекта – напоминает то, как разрабатывается ядро Linux.

Изначально страницы man поддерживал Karl Auer. Исходные коды страниц man конвертировались в формат YODL (доступно здесь yodl.sourceforge.net) и обновлялись для релизов Samba 2.0 Jeremy Allison. Переведено в формат DocBook для Samba 2.2 Джерардом Картером (Gerald Carter). Переведено в формат XML 4.2 для Samba 3.0 Александром Боковым.

Перевод на русский язык выполнил Айзятуллен Ренат.

Обсудить данный перевод можно в соответствующей ветке форума.