testparm — smb.conf ファイル内部の設定の正当性を検証
testparm [-s|--suppress-prompt] [--help] [-v|--verbose] {config filename} [hostname hostIP]
このプログラムは Samba(7) システムの一部である。
testparm は smbd
(8) 設定ファイル内部の
正当性を検査するための非常に簡単なテストプログラムである。
このプログラムが問題なしと報告した場合、smbd
による設定ファイルのロードが成功することが確実な形で、
設定ファイルを使用することができる。
ただし、設定ファイルに指定されたサービスが期待通りに動作するか、 有効になるかということは保証されないことに注意されたい。
コマンドラインのオプションでホスト名と IP アドレスが指定されると、 テストプログラムはサービスエントリーに対して動作し、 指定したホストが各サービスを利用する権利を持つかどうかを報告する。
testparm は smb.conf
にエラーを見つけると呼び出したプログラムに 1 を、エラーがなければ 0
の終了コードを返す。これにより、シェル・スクリプトは testparm
からの出力をテストできる。
このオプションが指定されない場合、testparm
はサービス名を表示した後でプロンプトを表示し、
リターンキーが押されると、サービスの定義をダンプする。
プログラムのバージョン番号を表示する。
コマンドラインから smb.conf(5) オプション "<name>" に値 "<value>" を設定。 これはコンパイル時の既定値と設定ファイルから読み込まれたオプションを上書きする。
コマンドラインオプションの要約を表示する。
簡単な使用法を表示する。
level は0から10までの整数値である。
既定値の値は、パラメーターが設定されていなければ1である。
この値を大きくするほど、サーバーの動作に関するより詳細な情報が ログファイルに記録される。レベル 0 では、致命的なエラーと重大な警告 のみが記録される。レベル 1 は日々の運用に適しており、少量の稼働状況 に関する情報を生成する。
1 より上のレベルは大量のログが生成されるので、問題解決の時にのみ 使用すべきである。 3 より上のレベルは開発者だけが利用するように設計されて おり、莫大な量のログデータが生成される。そのほとんどは非常に謎めいた内容 となっている
このパラメーターの指定は、smb.confファイル中の、
log level パラメーターの
指定よりも優先する事に注意。
このオプションが指定されると、smb.conf(5) の中で指定されていないパラメーターのデフォルト値を 表示する。
指定されたパラメーターをダンプする。セクション名がしていされない場合、表示は 既定値で、グローバルセクションに制限される。 パラメーターオプションをダンプすることも可能である。それゆえ、パラメーター名から、 コロンによって、オプションは分離しなければならない。
指定されたセクションをダンプする。
パラメータ、タイプ、設定可能な値を表示する。
グローバルでのチェックを行わない
これはチェックする設定ファイルの名前である。 このパラメーターを指定しないと、デフォルトの smb.conf(5) ファイルがチェックされる。
このパラメーターとそれに続くパラメーターが指定されると、
testparm は smb.conf
(5) 中の
hosts allow と hosts deny
パタメータを使って、指定された IP アドレス の hostname が
smbd サーバーにアクセス可能を許可されているかを判断する。
このパラメーターを指定した場合、次の hostIP パラメーターも指定すること。
これは前のパラメーターで指定したホストの IP アドレスである。このアドレスは、hostname パラメーターを指定した場合 必ず指定すること。
このプログラムは設定ファイルのロードが正常に完了したか否かを報告する。 ファイルがロードされなかった場合、エラーと警告の出力が優先される。 ファイルのロードが完了したら、プログラムは設定されているすべてのサービスの 詳細を標準出力に出力する。