Name

testparm — smb.conf ファイル内部の設定の正当性を検証

Synopsis

testparm [-s] [-h] [-v] [-L <servername>] [-t <encoding>] {config filename} [hostname hostIP]

説明

このプログラムは Samba(7) システムの一部である。

testparmsmbd (8) 設定ファイル内部の 正当性を検査するための非常に簡単なテストプログラムである。 このプログラムが問題なしと報告した場合、smbd による設定ファイルのロードが成功することが確実な形で、 設定ファイルを使用することができる。

ただし、設定ファイルに指定されたサービスが期待通りに動作するか、 有効になるかということは保証されないことに注意されたい。

コマンドラインのオプションでホスト名と IP アドレスが指定されると、 テストプログラムはサービスエントリに対して動作し、 指定したホストが各サービスを利用する権利を持つかどうかを報告する。

testparmsmb.conf にエラーを見つけると呼び出したプログラムに 1 を、エラーがなければ 0 の終了コードを返す。これにより、シェル・スクリプトは testparm からの出力をテストできる。

オプション

-s

このオプションが指定されない場合、testparm はサービス名を表示した後でプロンプトを表示し、 リターンキーが押されると、サービスの定義をダンプする。

-h|--help

コマンドラインオプションの要約を表示する。

-V

プログラムのバージョン番号を表示する。

-L servername

%L マクロの値を servername に設定する。これは、%L マクロによって指定される include file を試験するのに有効である。

-v

このオプションが指定されると、smb.conf(5) の中で指定されていないパラメーターのデフォルト値を 表示する。

-t encoding

指定された encoding でデータを出力する。

--parameter-name parametername

指定されたパラメーターをダンプする。セクション名がしていされない場合、表示は 既定値で、グローバルセクションに制限される。 パラメーターオプションをダンプすることも可能である。それゆえ、パラメーター名から、 コロンによって、オプションは分離しなければならない。

--section-name sectionname

指定されたセクションをダンプする。

configfilename

これはチェックする設定ファイルの名前である。 このパラメーターを指定しないと、デフォルトの smb.conf(5) ファイルがチェックされる。

hostname

このパラメーターとそれに続くパラメーターが指定されると、 testparmsmb.conf (5) 中の hosts allowhosts deny パタメータを使って、指定された IP アドレス の hostname が smbd サーバーにアクセス可能を許可されているかを判断する。 このパラメーターを指定した場合、次の hostIP パラメーターも指定すること。

hostIP

これは前のパラメーターで指定したホストの IP アドレスである。このアドレスは、hostname パラメーターを指定した場合 必ず指定すること。

関連ファイル

smb.conf(5)

これは通常 smbd (8) が使用する設定ファイルの名前である。

診断

このプログラムは設定ファイルのロードが正常に完了したか否かを報告する。 ファイルがロードされなかった場合、エラーと警告の出力が優先される。 ファイルのロードが完了したら、プログラムは設定されているすべてのサービスの 詳細を標準出力に出力する。

バージョン

このマニュアルページSambaバージョン3用である。

関連項目

smb.conf(5), smbd(8)

著者

オリジナルの 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 によって行われた。

日本語訳

このマニュアルページは Samba 3.2.4 - 3.5.20 対応のものである。

このドキュメントの Samba 3.0.0 対応の翻訳は

  • はせがわようすけ

  • 高橋 基信 (monyo@samba.gr.jp)

  • 佐藤 文優

  • 山田 史朗 (shiro@miraclelinux.com)

によって行なわれた。

このドキュメントの Samba 3.2.4 - 3.5.20 対応の翻訳は 太田俊哉(ribbon@samba.gr.jp)によって行われた。