testparm — smb.conf ファイル内部の設定の正当性を検証
testparm
[-s] [-h] [-v] [-L <servername>] [-t <encoding>] {config filename} [hostname hostIP]
このプログラムは Samba(7) システムの一部である。
testparm
は smbd
(8) 設定ファイル内部の
正当性を検査するための非常に簡単なテストプログラムである。
このプログラムが問題なしと報告した場合、smbd
による設定ファイルのロードが成功することが確実な形で、
設定ファイルを使用することができる。
ただし、設定ファイルに指定されたサービスが期待通りに動作するか、 有効になるかということは保証されないことに注意されたい。
コマンドラインのオプションでホスト名と IP アドレスが指定されると、 テストプログラムはサービスエントリに対して動作し、 指定したホストが各サービスを利用する権利を持つかどうかを報告する。
testparm
は smb.conf
にエラーを見つけると呼び出したプログラムに 1 を、エラーがなければ 0
の終了コードを返す。これにより、シェル・スクリプトは testparm
からの出力をテストできる。
このオプションが指定されない場合、testparm
はサービス名を表示した後でプロンプトを表示し、
リターンキーが押されると、サービスの定義をダンプする。
コマンドラインオプションの要約を表示する。
プログラムのバージョン番号を表示する。
%L マクロの値を servername
に設定する。これは、%L マクロによって指定される include file
を試験するのに有効である。
このオプションが指定されると、smb.conf(5) の中で指定されていないパラメーターのデフォルト値を 表示する。
指定された encoding でデータを出力する。
指定されたパラメーターをダンプする。セクション名がしていされない場合、表示は 既定値で、グローバルセクションに制限される。 パラメーターオプションをダンプすることも可能である。それゆえ、パラメーター名から、 コロンによって、オプションは分離しなければならない。
指定されたセクションをダンプする。
これはチェックする設定ファイルの名前である。 このパラメーターを指定しないと、デフォルトの smb.conf(5) ファイルがチェックされる。
このパラメーターとそれに続くパラメーターが指定されると、
testparm
は smb.conf
(5) 中の
hosts allow
と hosts deny
パタメータを使って、指定された IP アドレス の hostname が
smbd
サーバーにアクセス可能を許可されているかを判断する。
このパラメーターを指定した場合、次の hostIP パラメーターも指定すること。
これは前のパラメーターで指定したホストの IP アドレスである。このアドレスは、hostname パラメーターを指定した場合 必ず指定すること。
このプログラムは設定ファイルのロードが正常に完了したか否かを報告する。 ファイルがロードされなかった場合、エラーと警告の出力が優先される。 ファイルのロードが完了したら、プログラムは設定されているすべてのサービスの 詳細を標準出力に出力する。
オリジナルの Samba ソフトウェアと関連ユーティリティは、Andrew Tridgell によって作成された。現在 Samba は、Samba Team によって Linux カーネルの開発と同様に、オープンソースプロジェクトとして開発されている。
オリジナルのSambaマニュアルは、Karl Auer によって執筆された。 マニュアルのソースは Jeremy Allison によって YODL 形式に変換され、 Samba 2.0 リリース用に更新された。(YODL はオープンソース・ソフトウエアの 優れた作品である ftp://ftp.icce.rug.nl/pub/unix/より入手可能。) Samba 2.2 における DocBook 形式への変換は Gerald Carterによって 行なわれた。Samba 3.0 における DocBook XML 4.2 形式への変換は Alexander Bokovoy によって行われた。