НАЗВАНИЕ

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 Александром Боковым.

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

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

Samba 3 в примерах. От простого к сложному. Пример 1. Простой Samba-сервер. Доступ всем на все.

5. Конфигурирование сервера Samba

Теперь займемся сервером Samba. Конфигурационный файл для сервера Samba-3 находится в папке /etc/samba и называется smb.conf. После установки в нем написано много чего интересного, но мы не будем его править, а создадим свой. Сохраняем файл /etc/samba/smb.conf на память (и на всякий случай, там много чего есть интересного почитать, и вообще заведите себе привычку перед любым изменением любого конфигурационного файла делать его резервную копию):

# mv /etc/samba/smb.conf /etc/samba/smb.conf.default

Примечание: разработчики Samba настоятельно рекомендуют иметь файл smb.conf как можно более меньшего размера, а также не иметь внутри файла комментариев. Также они рекомендуют как можно более тщательно комментировать все изменения, какие вы делаете. Данные противоречивые рекомендации исполняются следующим образом: мы сделаем файл smb.conf.comment, в котором опишем все, что мы делаем, а потом из него получим рабочий файл smb.conf:

# touch /etc/samba/smb.conf.comment

Теперь заполним файл smb.conf.comment примерно таким содержимым:

#Глобальные параметры
[global]
#название рабочей группы, в windows по умолчанию WORKGROUP, если вы имеете домен, укажите имя вашего домена, тогда
#в сетевом окружении windows ваш файл-сервер будет в общей массе компьютеров
workgroup = WORKGROUP
#NetBIOS-имя компьютера в вашей сети, имя, под которым файл-сервер будет отображаться в сетевом окружении
netbios name = ALTSERVER
#режим безопасности
security = SHARE
#то, как будет описываться в сетевом окружении
server string = files and music                                                                                      

#описание наших общих папок
#секция music
[music]
#комментарий, то, как будет подписан наш общий ресурс в сетевом окружении
comment=Наша музыка
#путь к общей папке
path=/mnt/allfiles/sharefolder/music
#данные параметры необязательны, но для чего они потребовались тут, скажу ниже
create mask = 0777
directory mask = 0777
#принуждаем быть владельцем общего ресурса пользователя sambauser
force user=sambauser
#принуждаем быть владельцем общего ресурса группу users
force group=users
#указываем, что можно не только читать, но и записывать
read only=No
#открываем гостевой доступ, по сути всем
guest ok=Yes

[обмен файлами]
comment=файлообмен
path="/mnt/allfiles/sharefolder/обмен файлами"
create mask = 0777
directory mask = 0777
force user=sambauser
force group=users
read only=No
guest ok=Yes

Получим рабочий файл smb.conf, а заодно проверим, нигде ли мы не ошиблись при помощи команды testparm:

# testparm -s smb.conf.comment>smb.conf

Load smb config files from smb.conf.comment
Processing section "[music]"
Processing section "[обмен файлами]"
Loaded services file OK.
WARNING: You have some share names that are longer than 12 characters.
These may not be accessible to some older clients.
(Eg. Windows9x, WindowsMe, and smbclient prior to Samba 3.0.)
Server role: ROLE_STANDALONE

Теперь у вас появился файл smb.conf, причем в нем нет ни одной строки с комментариями. Добейтесь, чтобы не было никаких ошибок, опечаток и т.п. Утилита testparm проверяет в основном опечатки, правильность заданных параметров она почти не контролирует. Например, если вы опечатались, сообщение об ошибке может выглядеть так:

# testparm -s smb.conf.comment>smb.conf

Load smb config files from smb.conf.comment
Unknown parameter encountered: "metbios name"
Ignoring unknown parameter "metbios name"
Processing section "[music]"
ERROR: Badly formed boolean in configuration file: "Yes/t".
lp_bool(Yes/t): value is not boolean!
Processing section "[обмен файлами]"
Loaded services file OK.
WARNING: You have some share names that are longer than 12 characters.
These may not be accessible to some older clients.
(Eg. Windows9x, WindowsMe, and smbclient prior to Samba 3.0.)
Server role: ROLE_STANDALONE

В данном случае опечатка metbios name вместо netbios name, а также ошибочное значение параметра в секции [music]

Примечание: параметр workgroup=WORKGROUP применяется по умолчанию, поэтому если у вас такая рабочая группа, то его можно не писать, а если какая то другая, то смело пишите, например, workgroup=MYNETWORK

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

Итоговый файл smb.conf получился таким:

[global]
        netbios name = ALTSERVER
        server string = files and music
        security = SHARE

[music]
        comment = Наша музыка
        path = /mnt/allfiles/sharefolder/music
        force user = sambauser
        force group = users
        read only = No
        create mask = 0777
        directory mask = 0777
        guest ok = Yes

[обмен файлами]
        comment = файлообмен
        path = "/mnt/allfiles/sharefolder/обмен файлами"
        force user = sambauser
        force group = users
        read only = No
        create mask = 0777
        directory mask = 0777
        guest ok = Yes

Опции: