このツールは Samba スイートの一部である。
swat は、 Samba 管理者が Web ブラウザを使って複雑な smb.conf(5) の設定を行うことを可能にする。 加えて、swat の設定ページには、 smb.conf 中で設定可能な全てのオプションへのリンクがあり、 管理者が設定変更の影響を簡単に調べられるようになっている。
swat は inetd から実行される。
デフォルトの設定ファイルのパスは、 コンパイル時に設定される。 設定ファイルには、 smbd に必要な詳細な設定が記述される。 このファイルが swat によって修正されるファイルである。 ファイルには、 そのサーバが提供する全てのサービスの記述に加え、 printcap ファイルの位置のようなサーバ固有の情報も含まれる。 詳細情報については、 smb.conf を参照のこと。
このオプションは、 認証機能を無効にし、swat をデモモードにする。 このモードでは、 誰でも smb.conf ファイルを修正する事ができてしまう。
運用中のサーバでは、このオプションを絶対に有効にしないこと。
swatのバイナリと 多数のヘルプファイルやイメージファイルをインストールするため、 SWATのコンパイル後にmake install の実行が 必要である。 デフォルトのインストール位置は以下の通り:
/usr/local/samba/bin/swat
/usr/local/samba/swat/images/*
/usr/local/samba/swat/help/*
SWAT を inetd 経由で起動するには、 /etc/inetd.conf と /etc/services の編集が必要である。
/etc/services については、 以下のような行を追加すること:
swat 901/tcp
NIS/YP ユーザへの注意: ローカルな /etc/services ファイルの代わりに、 NIS サービスマップを再構築する必要があるかも知れない。
ポート番号は、1024 以下のポートで 現在使用中でないものであればなんでも良い (1024 より大きいポートを用いる事は、 inetd デーモンの実装の詳細によっては、 セキュリティホールを提供してしまう)。
/etc/inetd.conf については、 以下のような行を追加すること:
swat stream tcp nowait.400 root /usr/local/samba/bin/swat swat
/etc/services と /etc/inetd.conf を編集したら、 inetd に HUP シグナルを送ること。 それには kill -1 PID のように入力する。 ここでPIDは inetd デーモンのプロセスIDを示す。
このファイルには、 メタデーモンのための適切な起動情報が含まれている。
このファイルにはサービス名(例: swat)と サービスポート(例: 901)との対応情報と、 プロトコル種類(例: TCP)が含まれている。
これはswatによって設定される設定ファイル smb.conf(5) のデフォルトの位置になる。 その他の一般的な位置は、 /usr/samba/lib/smb.conf や /etc/smb.conf である。 このファイルには、 サーバがクライアントに提供する全てのサービスが記述されている。
swat は smb.conf ファイルを書き直してしまう。 エントリは再配置され、コメントや include= および copy=" オプションは削除されてしまう。 既に念入りに手をかけて作成した smb.conf を持っている場合は、 事前にバックアップしておくか、swat を使わないこと!
オリジナルの Samba ソフトウェアと関連するユーティリティは、 Andrew Tridgell によって作成された。現在 Samba は Samba Team によって、 Linux カーネルの開発と同様の オープンソースプロジェクトとして開発が行なわれている。
オリジナルの Samba マニュアルページは Karl Auer によって作成された。 マニュアルページは YODL 形式( ftp://ftp.icce.rug.nl/pub/unix/ で入手可能な優れたオープンソースソフトウェア) に変換され、 Samba 2.0 リリースに伴い、Jeremy Allison によって更新された。 Samba 2.2 における DocBook 形式への変換は、 Gerald Carter によって行なわれた。