.\"Generated by db2man.xsl. Don't modify this, modify the source. .de Sh \" Subsection .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Ip \" List item .br .ie \\n(.$>=3 .ne \\$3 .el .ne 3 .IP "\\$1" \\$2 .. .TH "SMB.CONF" 5 "" "" "" .SH "NAME" smb.conf - Samba の設定ファイル .SH "SYNOPSIS" .PP \fIsmb\.conf\fR ファイルは Samba システムの設定ファイルである。\fIsmb\.conf \fR には、Samba システムの各プログラムが実行時に参照する設定情報が記述される。 \fIsmb\.conf\fR ファイルは、\fBswat\fR(8) プログラムによって設定、 管理されるように設計されている。 以下参照目的で、ファイルの形式と設定可能なパラメータに関して網羅的に記述する。 .SH "ファイルの形式" .PP ファイルはセクションとパラメータから構成される。セクションは、 “[” と “]” 文字で囲まれたセクション名で始まり、次のセクションが始まるまで 続く。セクション内には以下の形式でパラメータが記述される: .sp .nf \fIパラメータ名（パラメータ）\fR = \fIパラメータ値（値）\fR .fi .PP ファイルは行を基本単位とし、改行で終了する各行は、コメント、 セクション名、パラメータのいずれかを表す。 .PP セクション名およびパラメータ名は大文字と小文字を区別しない。 .PP パラメータを示す行では、最初の 「=」 文字に重要な意味がある。 最初の 「=」 文字の前後の空白文字は破棄される。 セクション名およびパラメータ名の先頭、 途中、末尾にある空白文字は 無視される。パラメータ値の先頭と末尾にある空白文字も無視される。 ただし、パラメータ値の途中にある空白文字はそのまま意味を持つ。 .PP セミコロン (“:”)、シャープ (“#”) で始まる行や、空白のみの行は 無視される。 .PP “\e” 文字で終わる行は、UNIX の慣習通り次の行へ継続する。 .PP 「=」文字に続くパラメータ値には、文字列 (引用符で囲む必要はない)、または真偽値を表す、yes/no、0/1、true/false のいずれかを記述する。真偽値の場合、大文字と小文字は同じ意味だが、 記述されたとおりの文字列が保存される。 create mask など、幾つかのパラメータ値は数値となる。 .SH "セクションの説明" .PP 設定ファイル中の ([global] セクションを除く) 各セクションでは、 共有リソース (単に“共有”とも呼ぶ (訳注: 「サービス」とも呼ばれる)) の設定が行なわれる。 セクション名は共有リソース名となり、 セクション内のパラメータは共有の設定に利用される。 .PP [global]、[homes]、[printers] という 3 つの特殊なセクションに ついては、\fB特殊なセクション\fR で説明する。 以下の説明は、通常のセクションについてのものである。 .PP 共有の設定としては、大きくアクセスを許可するディレクトリの設定と それを利用するユーザに対するアクセス許可の設定とがある。 その他いくつかの補助的なオプションの指定も可能である。 .PP セクションは、ファイル共有サービス (クライアントからファイルシステムの延長として利用される) とプリントサービス (クライアントからサーバ上で動作している 印刷サービスにアクセスするために利用される) のいずれかに分類される。 .PP セクションは、パスワードなしでアクセスできる \fBゲスト\fR サービスとして構成することもできる。 この場合、UNIX 側で指定された\fBゲストアカウント\fRの権限でアクセスが 行なわれる。 .PP ゲストサービス以外のセクションにアクセスするにはパスワードが 必要である。通常クライアントからはユーザ名も提供されるが、 年代物のクライアントはパスワードのみでユーザ名を提供しないため、 “user =” パラメータで指定したユーザのリストを用いてパスワードの検証を 行なうことも可能である。Windows 95/98/Me/NT/2000 のような最近の クライアントでは、このパラメータは不要である。 .PP Samba より与えられたアクセス権は、システムより UNIX ユーザ (またはゲストユーザ) に与えられたアクセス権によって制限されることに注意して欲しい。 Samba はシステムが許可する以上のアクセス権を許可することはできない。 .PP 以下の簡単なセクションは、ファイル共有を定義するものである。 ユーザは \fI/home/bar\fR に対して書き込みができる。 共有は、foo という共有名でアクセス可能である: .sp .nf \fI[foo]\fR path = /home/bar read only = no .fi .PP 以下の簡単なセクションは印刷サービスを定義するものである。 共有は読み取りのみであるが、印刷可能である。これは、 スプールファイルのオープン、書き込み、クローズという作業についてのみ書き込みが許可されるということである。\fBguest ok\fR パラメータは、(別途定義された) デフォルトのゲストユーザとしてアクセスが許可されていることを意味する: .sp .nf \fI[aprinter]\fR path = /usr/spool/public read only = yes printable = yes guest ok = yes .fi .SH "特殊なセクション" .SS "[global] セクション" .PP このセクション中のパラメータは、サーバ全体に対して、 もしくは各セクションで項目が定義していないときの既定値として 適用される。詳細な情報はパラメータ(PARAMETERS)の節を参照のこと。 .SS "[homes] セクション" .PP homes セクションが設定ファイル中にあると、 接続してきたユーザのホームディレクトリを共有するサービスが 必要時にサーバによって作成されるようになる。 .PP 接続の要求が行なわれると、存在するセクションが検索される。 要求に合致するセクションが見つかった場合はそのセクションが 利用される。見つからなかった場合は、 要求されたセクション名をユーザ名とみなしてローカルのパスワードファイルが検索される。 ファイル中に名前が存在して、パスワードが適切だった場合、 [homes] セクションの設定を引き継ぐ形で共有が作成される。 .PP 新しく作成される共有に対しては、 幾つかの変更が行なわれる: .sp .RS 4 \h'-04'?\h'+03'共有名は、homes からユーザ名に変更される。 .RE .sp .RS 4 \h'-04'?\h'+03'path パラメータが設定されていなかった場合、 ディレクトリのパスはユーザのホームディレクトリに設定される。 .RE .PP \fBpath = \fR 行を [homes] セクションに記述した場合、"%S" マクロを用いると便利になる 場合があるかも知れない。以下に一例を示す: .PP \fBpath = /data/pchome/%S\fR .PP これは、UNIX からのアクセスと PC からのアクセスとでホームディレクトリが異なる場合に便利である。 .PP これは多数のクライアントに対するホームディレクトリの 提供を最小の手間で素早く簡単に実現する方法である。 .PP 要求されたセクション名が “homes” の場合にも同様の処理が行われるが、共有名が要求したユーザの 名前に変更されることはない。 [homes] セクションを使用する 方法は、複数のユーザがクライアント PC を共有する場合に 便利である。 .PP [homes] セクションでは、通常のサービスで指定可能な すべてのパラメータを指定できるが、幾つかのものは他の セクションと少し違った意味になる。以下は典型的な [homes] セクションの例である: .sp .nf \fI[homes]\fR read only = no .fi .PP 重要な点として、[homes] セクションでゲストアクセスを許可した場合、 全てのホームディレクトリが全てのクライアントから \fBパスワードなしで\fR アクセス可能になるという点が挙げられる。 ほとんどあり得ないと思うが、もしこの設定を実際に行なうのであれば、\fB読み取り専用\fR アクセスの設定にしておくことが好ましいであろう。 .PP 自動的に作成されるホームディレクトリの \fBbrowseable\fR パラメータの値は、[homes] セクションの browseable パラメータからではなく、[global] セクションの browseable パラメータより継承される。これは、 [homes] セクションで \fBbrowseable = no\fR を指定して [homes] 共有を不可視にしても、自動的に作成されるホームディレクトリを表示させるようにするための仕様である。 .SS "[printers] セクション" .PP このセクションは、プリンタ用の [homes] セクションに 相当する。 .PP [printers] セクションが設定されていると、ユーザは、 ローカルホストの printcap ファイルで設定されている各プリンタに接続することが可能となる。 .PP 接続の要求が行なわれると、存在するセクションが検索される。 要求に合致するセクションが見つかった場合はそのセクションが利用される。 見つからなかった場合、[homes] セクションがあれば前述した処理が行なわれる。 それでも要求が解決できない場合は、 要求されたセクション名をプリンタ名とみなし、 適切な pritcap ファイルが検索され、 要求されたセクション名をプリンタ共有名とみなすかどうかの 確認が行なわれる。ファイル中に名前が存在した場合は、 [printers] セクションの設定を引き継ぐ形でプリンタ共有が 作成される。 .PP 新しく作成される共有に対しては、 幾つかの変更が行なわれる: .sp .RS 4 \h'-04'?\h'+03'共有名には、実際のプリンタ名が設定される。 .RE .sp .RS 4 \h'-04'?\h'+03'プリンタ名が設定されていない場合、 プリンタ名として実際のプリンタ名が設定される。 .RE .sp .RS 4 \h'-04'?\h'+03'共有がゲストアクセスを許可しておらず、 username パラメータも指定されていない場合、username に実際のプリンタ名が設定される。 .RE .PP [printers] サービスは、必ず printable にすること。 それ以外の設定を行なうと、サーバが設定ファイルの読み取りを 拒否してしまう。 .PP 通常指定されるパスは、sticky ビットが設定され、 誰でも書き込み可能になっているスプールディレクトリである。 典型的な [printers] のエントリは次のようになる: .sp .nf \fI[printers]\fR path = /usr/spool/public guest ok = yes printable = yes .fi .PP printcap ファイル中で定義されているすべてのプリンタの エイリアス(別名)は、プリンタ名として認識される。 印刷システムが printcap ファイルのような機構を使用して いないのであれば、仮の printcap ファイルを設定する必要がある。 このファイルは以下のような形式の行で構成される: .sp .nf alias|alias|alias|alias\.\.\. .fi .PP 各エイリアスは、印刷システムが処理可能なプリンタ名で ある必要がある。[global] セクションで、別のファイルを printcap ファイルとして指定することで、仮想的な printcap ファイル中にある名前のみがサーバに認識される。 もちろんこのファイル中には任意のエイリアスを記述することが 可能である。このテクニックは、ローカルプリンタの一部のみに アクセスを制限する機能を簡単に実現するためにも利用できる。 .PP なお、エイリアスとは printcap ファイル中の各レコードの 最初のエントリに続く各要素をさす。 各レコードは改行コードで区切られ、各要素は (複数個存在する場合) 縦棒 (|) で区切られる。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note .PP lpstat コマンドによりシステムで定義されている プリンタの一覧を取得可能な SYSV 系のシステムでは、 printcap name = lpstat とすることで、 プリンタの一覧を取得することが可能である。 詳細は、printcap name オプションを参照のこと。 .SH "ユーザ定義共有" .PP Samba 3\.0\.23 より、root 以外のユーザが共有の追加、修正、削除を行なうことを可能とする機能が追加された。 この機能を \fBユーザ定義共有(usershares)\fR と呼び、 smb\.conf の セクションで定義される一連のパラメータによって制御される。 関連するパラメータを以下に示す : .PP usershare allow guests .RS 4 ユーザ定義共有でゲストアクセスを許可するかどうかを制御する。 .RE .PP usershare max shares .RS 4 作成を許可するユーザ定義共有の最大数を制御する。 .RE .PP usershare owner only .RS 4 有効にすると、ユーザが所有しているディレクトリのみが共有可能となる。 .RE .PP usershare path .RS 4 ユーザ定義共有を作成可能なディレクトリを指定する。 実際にユーザ定義共有を作成可能かどうかは、ファイルシステム上のディレクトリのパーミッションに依存する。 .RE .PP usershare prefix allow list .RS 4 共有を許可するディレクトリの絶対パス名をコンマで区切って列挙する。 ここで指定されたパス名から始まるディレクトリのみが共有を許可される。 .RE .PP usershare prefix deny list .RS 4 共有を拒否するディレクトリの絶対パス名をコンマで区切って列挙する。 ここで指定されたパス名から始まるディレクトリは共有を拒否される。 .RE .PP usershare template share .RS 4 新しいユーザ定義共有を作成する際のテンプレートとなる既存の共有を指定する。 ユーザ定義共有の定義時に指定されなかったすべての共有に関するパラメータは、この共有のものが用いられる。 .RE .PP UNIX グループ foo のメンバにユーザ定義共有の作成を許可したい場合は、 共有の定義ファイルを格納するディレクトリを以下のように作成する: .PP root 権限で以下を実施: .sp .nf mkdir /usr/local/samba/lib/usershares chgrp foo /usr/local/samba/lib/usershares chmod 1770 /usr/local/samba/lib/usershares .fi .PP ついで、以下のパラメータ .sp .nf usershare path = /usr/local/samba/lib/usershares usershare max shares = 10 # (もしくは必要な共有数) .fi .PP を \fIsmb\.conf\fRの global セクションに追加。 これにより foo グループのメンバは、以下のコマンドでユーザ定義共有を作成することが可能となる。 .PP net usershare add sharename path [comment] [acl] [guest_ok=[y|n]] .RS 4 これにより、ユーザ定義共有を作成もしくは修正(上書き)する。 .RE .PP net usershare delete sharename .RS 4 ユーザ定義共有を削除する。 .RE .PP net usershare list wildcard\-sharename .RS 4 ユーザ定義共有を一覧する。 .RE .PP net usershare info wildcard\-sharename .RS 4 ユーザ定義共有の情報を表示する。 .RE .SH "パラメータ" .PP パラメータはセクションの属性を定義するものである。 .PP 幾つかのパラメータ (\fBsecurity\fR など) は、 [global] セクションで指定する。また幾つかのパラメータ (\fBcreate mask\fR など) は、すべてのセクションで 利用可能である。それ以外のパラメータは、通常のセクションでのみ 利用できる。以下の説明では、[homes] と [printers] セクションを "通常の" セクションとして扱う。(\fBG\fR) がついたパラメータは、 [global] セクションでのみ指定できる。(\fBS\fR) がついたパラメータは、個々のサービスを表すセクションで指定できる。 ただし、(\fBS\fR) がついたパラメータは、[global] セクション中で指定することも可能である。この場合、それらはすべての サービスに対するデフォルト値として機能する。 .PP パラメータはアルファベット順に説明されている。 最良の順序とはいえないが、少なくとも目的のパラメータを見つけることは できるだろう。同義語がある場合は、主として用いるべき表記の部分で 説明が行なわれ、他はその表記への参照になっている。 .SH "変数による置換" .PP 設定ファイルに記述可能な文字列の多くには、変数による置換を利用できる。 たとえば、“path = /tmp/%u” は、john というユーザ名でユーザが 接続すると、“path = /tmp/john” として解釈される。 .PP これら置換の詳細については、各々のパラメータの説明にて 解説するが、どのパラメータに対しても適用される共通の変数置換もいくつか 存在する。それらを以下に記載する: .PP %U .RS 4 セッションのユーザ名 (クライアントが接続時に 送信したものであるが、実際に接続したユーザ名と同じであるとは 限らない)。 .RE .PP %G .RS 4 %U のプライマリグループ。 .RE .PP %h .RS 4 Samba が動作しているマシンの インターネットホスト名。 .RE .PP %m .RS 4 クライアントマシンの NetBIOS 名 (とても便利)。 .sp Samba がポート 445 で待機している場合、クライアントがこの情報を送信しないため、この変数は利用できない。 Samba がドメインコントローラであるドメインで include パラメータにおいてこの変数を用いている場合などは、 [global] セクションで \fIsmb ports = 139\fR の設定を行なうこと。 これにより Samba はポート 445 で待機しなくなり、Samba 2\.X で実現していた include 機能が利用できる。 .RE .PP %L .RS 4 サーバの NetBIOS 名。これを用いることで、 クライアントから呼ばれた名前に応じて設定を変更することが 可能となる。これによりサーバは “二つの顔” を持つことができる。 .RE .PP %M .RS 4 クライアントマシンのインターネットホスト名。 .RE .PP %R .RS 4 プロトコルのネゴシエーションを経て選択された プロトコルレベル。これは CORE、COREPLUS、LANMAN1、LANMAN2、NT1 のいずれかの値をとる。 .RE .PP %d .RS 4 サーバプロセスのプロセス ID。 .RE .PP %a .RS 4 リモートマシンのアーキテクチャ。 現在認識できるのは Samba (\fBSamba\fR)、 Linux の CIFS ファイルシステム (\fBCIFSFS\fR)、 OS/2 (\fBOS2\fR)、 Windows for Workgroups (\fBWfWg\fR)、 Windows 9x/Me (\fBWin95\fR)、 Windows NT (\fBWinNT\fR)、 Windows 2000 (\fBWin2K\fR)、 Windows XP (\fBWinXP\fR)、 Windows Server 2003 (\fBWin2K3\fR) である。 それ以外のものは “UNKNOWN” となる。 .RE .PP %I .RS 4 クライアントマシンの IP アドレス。 .RE .PP %i .RS 4 クライアントが接続してきたサーバの IP アドレス。 .RE .PP %T .RS 4 現在の日付と時間。 .RE .PP %D .RS 4 現ユーザが所属するドメインかワークグループ名。 .RE .PP %w .RS 4 Winbind のセパレータ .RE .PP %$(\fIenvvar\fR) .RS 4 環境変数\fIenvvar\fRの値。 .RE .PP 以下の置換マクロは (すでに接続が確立されている場合に) いくつかの 設定オプションに対して有効なものである: .PP %S .RS 4 現在のサービス名 (存在する場合)。 .RE .PP %P .RS 4 現在のサービスのトップディレクトリ (存在する場合)。 .RE .PP %u .RS 4 現在のサービスのユーザ名 (存在する場合)。 .RE .PP %g .RS 4 %u のプライマリグループ。 .RE .PP %H .RS 4 %u で指定されたユーザのホームディレクトリ。 .RE .PP %N .RS 4 NIS のホームディレクトリサーバの名前。 これは NIS の auto\.map エントリから取得される。Samba が \fB\-\-with\-automount\fR オプションをつけて コンパイルされていない場合、このオプションは %L と同じになる。 .RE .PP %p .RS 4 NIS auto\.map エントリから取得された サーバの ホームディレクトリのパス。NIS auto\.map エントリは %N:%p のように分割されている。 .RE .PP これらの置換操作とその他の \fIsmb\.conf\fR のパラメータを組み合わせると、非常に凝った動作を設定できる。 .SH "名前の短縮(NAME MANGLING)" .PP Samba は、DOS や Windows クライアントが 8\.3 形式に準拠しない 名前のファイルを扱うことができるように “名前の短縮” 機能を提供している。この機能により、8\.3 形式のファイル名についても 文字の case (大文字、小文字) を調整可能である。 .PP 短縮時の動作を制御するパラメータが幾つか存在しており、 それらは個々に解説を行なわず、ここでまとめて説明を行なう。 デフォルト値は testparm コマンドの出力を参照のこと。 .PP 以下のオプションは、すべて共有毎に設定できる (もちろん全体に対しても設定できる)。 .PP オプションは以下の通りである: .PP case sensitive = yes/no/auto .RS 4 ファイル名の case を識別するかどうかを制御する。 識別を行なわない場合、Samba は指定された名前に合致する ファイル名の有無を検索することが必要になる。デフォルトは \fBauto\fR であり、ファイル名の case を識別するクライアント(現在のところ Linux CIFSVFS や Samba 3\.0\.5 以降の smbclient) に対しては、case を識別する(UNIX の case を識別する挙動に準拠する) ファイルシステム上の Samba サーバにアクセスしているものとして通知する。 Windows および DOS システムでは case を識別するファイル名はサポートされておらず、このパラメータを auto に設定した場合、no の設定で動作する。 デフォルトは \fBauto\fR である。 .RE .PP default case = upper/lower .RS 4 新しく作成されるファイル(現在ファイルシステム上に存在していないファイル)のファイル名のデフォルトの case を制御する。 デフォルトは \fBlower\fR である。 重要: case sensitive = yes、 preserve case = No、 short preserve case = No の場合、このオプションにより、新しく作られるファイル名だけではなく、クライアントから渡される \fBすべての\fR ファイル名の case が変更されることに注意。 非常に多くのファイルを格納するディレクトリの最適化作業の一貫として、この設定変更が必要となる。 .RE .PP preserve case = yes/no .RS 4 新しく作成されるファイル(現在ファイルシステム上に存在していないファイル)のファイル名について、クライアントから 渡された case で作成するか、デフォルトの case で作成するかを制御する。 デフォルトは \fByes\fRである。 .RE .PP short preserve case = yes/no .RS 4 すべて大文字で適切な長さの 8\.3 形式に 準拠した新しく作成されるファイル(現在ファイルシステム上に存在していないファイル)のファイル名について、大文字で作成するか、 デフォルト の case で作成するかを制御する。 このオプションにより、preserve case = yes で長いファイル名が case を保持する設定の時であっても、 短いファイル名は小文字で作成するといったことが可能になる。 デフォルトは \fByes\fR である。 .RE .PP Samba 3\.0 のデフォルトは、Windows NT のサーバと同様に動作する。 すなわち、case を識別しないが case は保持する。 ただし、大量のファイルが存在するディレクトリにおいては、case 関連のパラメータを "case sensitive = yes"、"case preserve = no"、"short preserve case = no" に設定するとよいであろう。 これにより、"default case" パラメータが有効になり、クライアントから送信されるすべてのファイル名が変更される。 (訳注: 上記設定は、case sensitive = yes によりファイル名の検索を抑止することで、パフォーマンスを向上させようとする意図だと思われる) .SH "ユーザ名とパスワード認証についての注意" .PP ユーザがサービスに接続するための方法は幾つかある。サーバは、 以下のステップを踏みサービスに対して接続を許可するかどうかを確認する。 すべてのステップが失敗した場合、接続要求は拒否される。 いずれかのステップで成功した場合、それ以降のステップは行なわれない。 .PP サービスが “guest only = yes” となっており、 サーバが共有レベルのセキュリティ (“security = share”) で構成されている場合、ステップ 1 から 5 は省かれる。 .sp .RS 4 \h'-04' 1.\h'+02'クライアントからユーザ名とパスワードが 提供されており、それが UNIX システムのパスワード機構によって 認証された場合、そのユーザ名を使った接続が行なわれる。この ステップは \e\eserver\eservice%\fIusername\fR 形式でユーザ名が提供された場合にも行なわれることに注意。 .RE .sp .RS 4 \h'-04' 2.\h'+02'クライアントからシステムに登録されている ユーザ名が提供された場合、そのユーザ名に対する適切な パスワードが提供されれば、接続が許可される。 .RE .sp .RS 4 \h'-04' 3.\h'+02'クライアントの NetBIOS 名および以前に使われた ユーザ名について提供されたパスワードとの確認が行なわれ、 合致すれば、対応するユーザ名を使った接続が許可される。 .RE .sp .RS 4 \h'-04' 4.\h'+02'クライアントが既にユーザ名とパスワードを 提供してサーバに認証されており、その際の認証トークンが 提示された場合、そのユーザ名が使われる。 .RE .sp .RS 4 \h'-04' 5.\h'+02'user = フィールドが \fIsmb\.conf\fR ファイルで 該当サービスに対して設定されており、クライアントから提供された パスワードが (UNIX システムのパスワード認証により) user = 行に記述されたユーザ名のいずれかのものと 合致した場合、接続は、user = 行で設定された ユーザ名で行なわれる。user = リスト中のユーザ名の 中に @ ではじまるものがあった場合、それはその名前の グループに所属するユーザ名のリストに展開される。 .RE .sp .RS 4 \h'-04' 6.\h'+02'サービスがゲストサービスの場合、 提供されたパスワードがなんであっても、そのサービスの guest account = で指定されたユーザ名で接続が 行なわれる。 .RE .SH "各パラメータの説明" .PP abort shutdown script (G) .RS 4 このパラメータは、 \fBsmbd\fR(8) が呼び出すことで、 shutdown script によって実行されたシャットダウン処理を停止させるスクリプトのフルパス名である。 .sp 接続しているユーザが \fBSeRemoteShutdownPrivilege\fR 権限を保持している場合、このコマンドはユーザ権限で呼び出される。 .sp デフォルト値: \fB\fIabort shutdown script\fR = \fR .sp 設定例: \fB\fIabort shutdown script\fR = /sbin/shutdown \-c \fR .RE .PP acl check permissions (S) .RS 4 この真偽値パラメータは、 \fBsmbd\fR(8) が Windows クライアントから「open for delete」というプロトコル要求を受けとった際の挙動を制御する。 Windows クライアントにファイル削除のパーミッションがない場合は、オープン時に失敗することが想定される挙動である。しかし、POSIX システムでは、実際にファイルやディレクトリを削除しようとした段階で、初めて削除のパーミッション確認が行なわれる。 Windows クライアントは「delete on close」ビットを外すことで、削除のリクエストを「取り止める」ことが可能である。 このため、Samba が「open for delete」リクエストが行なわれた時点で該当のファイルを削除してみるといった方策も、 一度削除されたファイルを復活させることはできないため難しい。 このパラメータが true (デフォルト) の場合、smbd は「open for delete」リクエストの際にファイルシステムのパーミッションを直接チェックし、 ファイルシステムのパーミッション上削除できないと考えられる場合、該当のリクエストを拒否するようになる。 これは完全な方法ではなく、Samba がパーミッションを適切に確認できない場合に、ユーザがファイルを削除できてしまう可能性があるが、 大半の場合は Windows と同様の挙動となるであろう。 通常 Samba は POSIX ACL の挙動を適切に確認できるはずである。 .sp このパラメータを「false」に設定した場合、Samba は「open for delete」リクエストの際にパーミッションの確認を行なわずにオープンを許可する。 ユーザにファイルを削除するアクセス許可がない場合は、クローズする時までわからない。 Windows 上のツールにとって、クローズ時点でこれが判明しても遅過ぎるため、ユーザにエラーメッセージが表示されるだろう。 また、削除したように見えたファイルが Windows 側のエクスプローラで再表示すると「魔法のように」復活するといった現象も発生するであろう。 これは非常に高度なプロトコルに関するパラメータであり、通常変更する必要はないはずである。 このパラメータは Samba 3\.0\.21 で現在の形となったが、現在とは若干挙動が異なる古い版は Samba 3\.0\.20 で導入された。古い版の挙動について、ここでは言及していない。 .sp デフォルト値: \fB\fIacl check permissions\fR = True \fR .RE .PP acl compatibility (S) .RS 4 このパラメータはどの OS の ACL の挙動と互換性をとるかを指定する。 設定可能な値は、Windows NT 4\.0 互換の \fBwinnt\fR か、 Windows 2000 以上と互換の \fBwin2k\fR もしくは \fBauto\fR である。 \fBauto\fR に設定した場合、パラメータの値はクライアントのバージョンによって変更される。 このパラメータをデフォルトから変更する必要はないだろう。 .sp デフォルト値: \fB\fIacl compatibility\fR = Auto \fR .sp 設定例: \fB\fIacl compatibility\fR = win2k \fR .RE .PP acl group control (S) .RS 4 POSIX ファイルシステムでは、ファイルまたはディレクトリの所有者とスーパーユーザのみがファイルのパーミッションや ACL を修正できる。 このパラメータを有効にすると、Samba はこの制約を無視して、 ファイルやディレクトリの \fBプライマリグループ所有者\fR が、 ファイルのパーミッションや ACL を修正することを可能とする。 .sp Windows サーバでは、グループがファイルやディレクトリの所有者となることができるため、 そのグループに所属する誰もがパーミッションを修正することができる。 これにより、ディレクトリのグループ所有者が、ファイルシステムのある地点以下のセキュリティ管理を委任することが可能となり、 その配下に作成されるファイルやディレクトリについても、そのグループが所有者となる。 ACL を変更する権限を複数名が保持しているため、管理性が向上する。 .sp このパラメータにより、公開されたディレクトリ階層内で Samba が Windows と類似した制御の制御を行なうことを可能とする。 これは、UNIX グループのメンバ全員がグループ所有者となっているファイルやディレクトリのパーミッション制御を行なうことが可能となることを意味する。 .sp このパラメータは、inherit owner パラメータが有効で、 ディレクトリに UNIX の \fBsetgid ビット\fR が設定された共有で用いるのが最適であり、 共有内に作成される新しいファイルやディレクトリに、 親ディレクトリのグループ所有者を継承させることが可能となる。 .sp このパラメータは、Samba 3\.0\.23 において、廃止予定の(deprecated)パラメータとなった。 現在は \fIdos filemode\fR パラメータで、同じ挙動が実装されている。 .sp デフォルト値: \fB\fIacl group control\fR = no \fR .RE .PP acl map full control (S) .RS 4 この真偽値パラメータは、 \fBsmbd\fR(8) が POSIX の ACE エントリでは最大のアクセス権を許可した状態である「rwx(read/write/execute)」を Windows 側の ACL の「フルコントロール」に対応づけるかどうかを制御する。 このパラメータを true に設定した場合、POSIX ACE で「rwx」のエントリに対して、Windows 側の ACL としては「フルコントロール」が返却される。 このパラメータが false に設定された場合、POSIX ACE で「rwx」のエントリに対して、 Windows 側の ACL としては read/write/execute を表すビットを設定したエントリが返却される。 .sp デフォルト値: \fB\fIacl map full control\fR = True \fR .RE .PP add group script (G) .RS 4 このパラメータは、新しいグループの作成が要求された際に、 \fBsmbd\fR(8) によって \fBROOT 権限で\fR 実行されるスクリプトのフルパス名である。 \fI%g\fR はグループ名に展開される。 スクリプトは Windows NT のドメイン管理ツールを使用して設定を行なう際にのみ有効である。 このスクリプトでは、UNIX側のグループ名の制約に捕らわれず、任意の名前のグループを作成することができる。 ただし、その場合スクリプトは標準出力に作成されたグループの gid の数値を表示する必要がある。 .sp \fBデフォルト値なし\fR .RE .PP add machine script (G) .RS 4 このパラメータは、管理者のユーザ名とパスワードを指定する方式によってマシンがドメインに追加された際に、 \fBsmbd\fR(8) によって実行されるスクリプトのフルパス名である。 .sp このオプションは、 smbpasswd のように SAM バックエンドの RID の計算方式が UNIX の UID に関連づけられている場合にのみ必要とされる。 このオプションは Samba 3\.0 でのみ利用可能である。 .sp デフォルト値: \fB\fIadd machine script\fR = \fR .sp 設定例: \fB\fIadd machine script\fR = /usr/sbin/adduser \-n \-g machines \-c Machine \-d /var/lib/nobody \-s /bin/false %u \fR .RE .PP add port command (G) .RS 4 Samba 3\.0\.23 では、Windows の「Add Standard TCP/IP Port ウィザード」によるリモートからのプリンタポートの追加がサポートされた。 このオプションは、smbd がシステムに対する新しいポートの追加要求を受信した際に、 実行される外部のコマンドを定義する。 スクリプトは以下の 2 つのパラメータをとる。 .sp .RS 4 \h'-04'?\h'+03'\fIポートの名称\fR .RE .sp .RS 4 \h'-04'?\h'+03'\fIdevice URI\fR .RE .IP "" 4 deviceURI は socket://[:] もしくは lpd:/// のように指定する。 .sp デフォルト値: \fB\fIadd port command\fR = \fR .sp 設定例: \fB\fIadd port command\fR = /etc/samba/scripts/addport\.sh \fR .RE .PP add printer command (G) .RS 4 Samba 2\.2における Windows NT/2000 クライアントに対応した MS\-RPC ベースの印刷サポートの実装にともない、 共有の一覧に表示される"Printers\.\.\. " フォルダ中の 「プリンタの追加」ウィザード(Add Printer Wizard (APW))アイコンを利用することが可能になった。 APWにより、SambaやWindows NT/ 2000プリンタサーバに別のマシンからのプリンタ追加が可能となった。 .sp Sambaホストの場合、これは、下位レイヤの印刷システムにプリンタを物理的に追加できる必要があるということである。 \fIadd printer command\fR は、 印刷システムにプリンタを追加するとともに、 \fIsmb\.conf\fR ファイルに対して、 \fBsmbd\fR(8) によって共有が行なわれるサービスのエントリを適切に追加するのに必要な処理を行なうスクリプトを設定する。 .sp \fIadd printer command\fR は 以下のパラメータを(順番に)付加して自動的に実行される: .sp .RS 4 \h'-04'?\h'+03'\fIprinter name\fR .RE .sp .RS 4 \h'-04'?\h'+03'\fIshare name\fR .RE .sp .RS 4 \h'-04'?\h'+03'\fIport name\fR .RE .sp .RS 4 \h'-04'?\h'+03'\fIdriver name\fR .RE .sp .RS 4 \h'-04'?\h'+03'\fIlocation\fR .RE .sp .RS 4 \h'-04'?\h'+03'\fIWindows 9x driver location\fR .RE .IP "" 4 すべてのパラメータは、一つの例外を除き、 Windows NT/2000 クライアントから送信される PRINTER_INFO_2 構造体から取得される。 「Windows 9x driver location」パラメータは、下位互換性を保つためにのみ提供される。 それ以外の構造体のフィールドは、APWの質問に対する回答から生成される。 .sp \fIadd printer command\fR が実行されると、 \fBsmbd\fR は、 \fIsmb\.conf\fR を再度読み込んで、 APWで設定された共有がすでに存在していないかを確認する。 共有名が不正な場合、\fBsmbd\fR は、 クライアントに対して ACCESS_DENIED エラーを返却する。 .sp 「add printer command」は Samba が新しいプリンタが接続するポートとして設定した文字列からなる1行を返却する。 返却されない場合、Samba は印刷共有の再読み込みを行なわない。 .sp デフォルト値: \fB\fIadd printer command\fR = \fR .sp 設定例: \fB\fIadd printer command\fR = /usr/bin/addprinter \fR .RE .PP add share command (G) .RS 4 Samba 2\.2\.0 では、 Windows NT 4\.0 のサーバーマネージャーを用いて動的に共有を追加したり削除したりする機能が追加された。 \fIadd share command\fR は、 新しいサービスの設定を \fIsmb\.conf\fR に追加する外部のプログラム、もしくはスクリプトを設定するためのパラメータである。 \fIadd share command\fR を実行するため、管理者は \fBsmbd\fR に対して root アカウント(uid = 0)を利用して接続する必要がある。 .sp (訳注: SeDiskOperatorPrivilege 権限のあるアカウントでも可能) .sp コマンド実行時に、\fBsmbd\fR は自動的に以下の 5 つの引数を付加して \fIadd share command\fRを実行する。 .sp .RS 4 \h'-04'?\h'+03'\fIconfigFile\fR \- \fIsmb\.conf\fRファイルの場所 .RE .sp .RS 4 \h'-04'?\h'+03'\fIshareName\fR \- 新しい共有名 .RE .sp .RS 4 \h'-04'?\h'+03'\fIpathName\fR \- ディスク上に「存在している」ディレクトリへのパス名 .RE .sp .RS 4 \h'-04'?\h'+03'\fIcomment\fR \- 新しい共有に対するコメント文字列 .RE .sp .RS 4 \h'-04'?\h'+03'\fImax connections\fR 共有への最大同時接続数。 .RE .IP "" 4 このパラメータは、ファイル共有の追加にのみ使われる。 印刷共有の追加については、 addprinter command を参照のこと。 .sp デフォルト値: \fB\fIadd share command\fR = \fR .sp 設定例: \fB\fIadd share command\fR = /usr/local/bin/addshare \fR .RE .PP add user script (G) .RS 4 このパラメータは、以下に記述する特別な条件下において、 \fBsmbd\fR(8) によって \fBROOT 権限で\fR 実行されるスクリプトのフルパス名である。 .sp 通常、Samba サーバでは、サーバ上のファイルにアクセスするすべてのユーザに対して対応する UNIX ユーザが存在している必要がある。しかし、Windows NT のアカウントデータベースをユーザデータベースのマスタとして使うサイトでは、 Samba サーバ上のユーザの作成や保守を Windows NT の PDC と同期して行なうのは骨の折れる作業である。このオプションにより、Samba サーバに対してユーザがアクセスした時点で smbd が UNIX のユーザを \fB必要に応じて\fR 作成することが可能になる。 .sp このオプションを使う場合、 \fBsmbd\fR(8) は \fB決して\fR security = share で構成されていてはならず、 add user script には、 作成される UNIX のユーザ名を表す \fI%u\fR を引数にとり、 UNIX ユーザを作成するスクリプトのフルパス名が設定されている必要がある。 .sp Windows のユーザが Samba サーバにアクセスしようとして、 ログイン(SMB プロトコルの session setup) を行なう時に、 \fBsmbd\fR(8) は、送信されたユーザ名とパスワードを認証するために、 password server と通信を行なう。 認証が成功すると、 \fBsmbd\fR は UNIX 上のパスワードデータベース中から対応する UNIX のユーザを検索して Windows のユーザに対応づけようとする。この検索が失敗し、 add user script が設定されていると、 \fBsmbd\fR は、 \fI%u\fR 引数を作成すべきユーザ名に展開した上で、 設定されたスクリプトを \fBROOT 権限で\fR 呼び出す。 .sp スクリプトがユーザの作成に成功すると、 \fBsmbd \fR は、その UNIX ユーザがすでに存在していたかのようにして処理を継続する。このようにして、存在する Windows NT のアカウントに対応する UNIX のユーザが動的に作成される。 .sp (訳注: この他に、Samba のドメイン環境において add user script はリモートからの要求によりユーザを作成するという重要な役割がある。) .sp security, password server, delete user script も参照のこと。 .sp デフォルト値: \fB\fIadd user script\fR = \fR .sp 設定例: \fB\fIadd user script\fR = /usr/local/samba/bin/add_user %u \fR .RE .PP add user to group script (G) .RS 4 このパラメータは、 Windows NT のドメイン管理ツールによってユーザにグループが追加された際に実行されるスクリプトのフルパス名である。 これは \fBsmbd\fR(8) によって \fBROOT 権限で\fR 呼び出される。 \fI%g\fR はグループ名に置換され、 \fI%u\fR はユーザ名に置換される。 .sp \fBadduser\fR コマンドは、すべてのシステムにおいて、 以下の例で用いた構文をサポートしているわけではないことに注意。 .sp デフォルト値: \fB\fIadd user to group script\fR = \fR .sp 設定例: \fB\fIadd user to group script\fR = /usr/sbin/adduser %u %g \fR .RE .PP admin users (S) .RS 4 このパラメータは、共有上で管理者権限が与えられるユーザのリストである。 指定されたユーザは、すべてのファイル操作をスーパーユーザ (root) として実行できる。 .sp このリストに登録されているユーザは、 ファイルのパーミッションに関係なくあらゆる操作を行うことができてしまうため、 このオプションは十分に注意して使用すべきである。 .sp このパラメータは、 Samba 3\.0 における security = share 環境では動作しない。 これは仕様である。 .sp デフォルト値: \fB\fIadmin users\fR = \fR .sp 設定例: \fB\fIadmin users\fR = jason \fR .RE .PP afs share (S) .RS 4 このパラメータは、共有に対して AFS 特有の機能を有効にするかどうかを指定する。 もし有効な場合、\fIpath\fR パラメータでエクスポートされているディレクトリをローカルの AFS インポートとして扱う。 特殊な AFS の機能というのは、もし configure 時に \-\-with\-fake\-kaserver オプションを有効にした場合に、 AFS トークンを作成しようとする機能などが含まれる。 .sp デフォルト値: \fB\fIafs share\fR = no \fR .RE .PP afs username map (G) .RS 4 ダミーの kaserver の AFS 機能を使用している場合、 作成するトークンのユーザ名を指定したい場合もあるだろう。 たとえば、AFS Protection Database に複数のドメインのユーザが混在している場合などが挙げられる。 一つの解決策は、winbind と同じように + をセパレータとして DOMAIN+User と指定することである。 .sp マップされたユーザ名はログインするためのセル名を含んでいる必要がある。 そのため、このパラメータが指定されていない場合、トークンは使用されない。 .sp (訳注: AFSに関する知識不足のため、訳の正確性については担保できない) .sp デフォルト値: \fB\fIafs username map\fR = \fR .sp 設定例: \fB\fIafs username map\fR = %u@afs\.samba\.org \fR .RE .PP algorithmic rid base (G) .RS 4 このパラメータにより、 Samba が UID や GID を NT セキュリティ識別子(訳注:SID)の構築に必要な RID に機械的に対応づける際の RID の値が設定される。 .sp Windows NT/2000 から移行を行なうサイトでは、存在しているユーザやグループの RID がシステムのユーザと競合してしまうことを防ぐため、この値を大きい値にすることが有用な場合もあるだろう。 .sp サーバ上の ACL が正しく機能する上では、すべての UID および GID が SID に変換できることが必須である。 このため、機械的な対応づけを無効にせずに、一定の範囲を対象領域から除外することが、 問題を避ける上で必要である。 RID の競合に対応したパスワード機構において、ユーザおよびグループには、 「小さな」 RID が割り当てられる。 .sp デフォルト値: \fB\fIalgorithmic rid base\fR = 1000 \fR .sp 設定例: \fB\fIalgorithmic rid base\fR = 100000 \fR .RE .PP allocation roundup size (S) .RS 4 このパラメータにより、管理者が Windows クライアントから見たアロケーションサイズを切り上げることが可能となる。 デフォルトのサイズである 1MB にすることで、通常 Windows クライアントのパフォーマンスは向上する。 ただし、Visual Studio のように、 アロケーションサイズを切り上げることで問題が発生するアプリケーションもある。 Visual Studio のコンパイラーが内部エラーでクラッシュしてしまうような場合は、 該当の共有でこのパラメータを 0 に設定すること。 .sp このパラメータには、切り上げるサイズをバイト単位の整数値で指定する。 .sp デフォルト値: \fB\fIallocation roundup size\fR = 1048576 \fR .sp 設定例: \fB\fIallocation roundup size\fR = 0 # (to disable roundups) \fR .RE .PP allow trusted domains (G) .RS 4 このパラメータは、security パラメータが \fBserver\fR、 \fBdomain\fR もしくは \fBads\fR に設定されている時のみ有効である。 no に設定されている場合、 smbd が動作しているドメインもしくはワークグループ外からのリソースへの接続要求は、失敗する。 これは、たとえそのドメインが認証を行なうサーバによって信頼されている場合であっても同様である。 .sp このオプションは、 Samba サーバが所属するドメインのユーザのみにリソースを提供させたい場合に便利である。 一例として DOMA と DOMB という 2 つのドメインがあって、 DOMA は Samba サーバを含み、DOMB を信頼している場合を想定する。 通常の条件では、DOMB中にアカウントを持つユーザは、 Samba サーバに同じ名前の UNIX アカウントがあれば、 DOMA にアカウントがなくてもリソースにアクセスできるため、 セキュリティ境界の区分けが困難である。 .sp デフォルト値: \fB\fIallow trusted domains\fR = yes \fR .RE .PP announce as (G) .RS 4 このパラメータは、 \fBnmbd\fR(8) が、 自身を「ネットワークコンピュータ」中のブラウズリストにアナウンスする際のサーバの種類を指定する。 デフォルトでは Windows NT に設定されている。有効な値は: 「NT Server」(これは「NT」と表記することもできる)、 「NT Workstation」、「Win95」、「WfW」であり、各々 Windows NT Server、 Windows NT Workstation、Windows 95、Windows for Workgroups を意味する。 変更を行なうと、Samba サーバがブラウザサーバ(訳注: ポテンシャルブラウザの意?)に正しく参加できなくなるかも知れないため、 Samba サーバを NT サーバとして表示させたくない特別な理由がない限り、 このパラメータを変更しないこと。 .sp デフォルト値: \fB\fIannounce as\fR = NT Server \fR .sp 設定例: \fB\fIannounce as\fR = Win95 \fR .RE .PP announce version (G) .RS 4 このパラメータは、 nmbd が自身をサーバとしてアナウンスする際に指定するメジャーおよびマイナーバージョン番号を指定する。 デフォルトは 4\.9 である。 Samba サーバをより下位のサーバとして設定する特別な必要性がない限り、このパラメータは変更しないこと。 .sp デフォルト値: \fB\fIannounce version\fR = 4\.9 \fR .sp 設定例: \fB\fIannounce version\fR = 2\.0 \fR .RE .PP auth methods (G) .RS 4 このパラメータにより、管理者は \fBsmbd\fR がユーザ認証を行なう際に使用する認証機構を選択することが可能となる。 このパラメータのデフォルトは、security パラメータに基づいて適切な値が設定される。 このオプションは開発者向けであり、 特殊な状況でのみ使用するものと考えるべきである。 実際の運用では多くの場合 (必ずというわけではない)、デフォルト設定のままにしておくべきである。 .sp ユーザが認証されるまで、 リスト中の各エントリによって順番にユーザ認証が行なわれる。 従って、実際に認証が成功となる認証機構は1つだけである。 .sp 設定可能な値としては、\fBguest\fR (匿名アクセス)、 \fBsam\fR (NetBIOS名あるいはドメイン名に基づくローカルのアカウントリストの検索)、 \fBwinbind\fR (winbinddによるリモートユーザーの認証要求の中継)、 \fBntdomain\fR (winbindd 導入以前のリモートドメインユーザーの認証方法。 現在は winbindd を使用する方が望ましいので使用すべきではない)、 \fBtrustdomain\fR (信頼できるユーザーの、smbd からリモート DC への直接アクセスによる認証。 現在は winbindd を使用する方が望ましいので使用すべきではない) がある。 .sp デフォルト値: \fB\fIauth methods\fR = \fR .sp 設定例: \fB\fIauth methods\fR = guest sam winbind \fR .RE .PP available (S) .RS 4 このパラメータにより、サービスを「無効」とすることが可能である。 \fIavailable = no\fR の場合、 サービスに対する接続は\fBすべて\fR失敗する。これらの失敗は記録される。 .sp デフォルト値: \fB\fIavailable\fR = yes \fR .RE .PP bind interfaces only (G) .RS 4 このグローバルパラメータにより、 Samba 管理者が SMB 要求を受け付けるインタフェースを制限できるようになる。 この影響は、ファイルサービス \fBsmbd\fR(8) とネームサービス \fBnmbd\fR(8) とで多少異なる。 .sp このパラメータを指定すると、ネームサービス \fBnmbd\fR は、 interfaces パラメータで指定されたインタフェースのポート 137 と 138 にバインドする。 \fBnmbd\fR は、ブロードキャストメッセージを受信するために、 「すべてのアドレス」となるインタフェース (0\.0\.0\.0) のポート 137 と 138 にもバインドする。このオプションが設定されていない場合、 \fBnmbd\fR は、これらすべてのソケットに対してネームサービスを提供する。 bind interfaces only が設定されていると、 \fBnmbd\fR はブロードキャストパケットの送信元アドレスを確認して、 interfaces パラメータで指定されたインタフェースのブロードキャストアドレスを経由しないパケットを破棄する。 他のソケットでユニキャストパケットを受信した場合、 \fBnmbd\fR は、 interfaces パラメータで指定されたインタフェースを経由しないパケットを送出したマシンに対してはネームサービスを拒否する。 もっとも、IP ソースアドレスを偽造 (spoofing) することで、この単純なチェックは破られてしまう。 そのため、このパラメータを \fBnmbd\fR のセキュリティ機能と位置付けて本格的に利用すべきではない。 .sp ファイルサービスの場合、このパラメータを指定すると、 \fBsmbd\fR(8) が interfaces パラメータで指定されたインタフェースにのみバインドするようになる。 これにより、 \fBsmbd\fR がサービスを提供するネットワークを指定したインタフェース経由のものに制限することが可能である。 PPP などの間欠的なネットワークインタフェースや、非ブロードキャストなネットワークインタフェースにサービスを提供している場合は、 これらの非永続的なインタフェースをうまく処理できないため、このパラメータを使わないこと。 .sp bind interfaces only が設定されているが、 \fB127\.0\.0\.1\fR のネットワークアドレスが interfaces パラメータに指定されていない場合は、 以下に示すような理由のため、\fBsmbpasswd\fR(8) や \fBswat\fR(8) などが期待したように動作しないことがある。 .sp ユーザの SMB パスワードを変更するために、 \fBsmbpasswd\fR はデフォルトで \fBlocalhost \- 127\.0\.0\.1\fR のアドレスに SMB クライアントとして接続を行ない、パスワード変更要求を送信する。 bind interfaces only が設定されているにも関わらず、 \fB127\.0\.0\.1\fR のネットワークアドレスが interfaces パラメータに含まれていなかった場合、 \fBsmbpasswd\fR のデフォルトの状態では接続に失敗してしまう。 \fBsmbpasswd\fR については、 \fBsmbpasswd\fR(8) に \fI\-r \fR\fI\fIremote machine\fR\fR パラメータを指定して、 \fIremote machine\fR にローカルホストのプライマリインタフェースのIPアドレスを設定することにより、 強制的にローカルホストのプライマリIPインタフェースを利用させることも可能である。 .sp \fBswat\fR のステータス(status)ページは、 \fBsmbd\fR と \fBnmbd\fR が実行されているかを確認するために、 \fB127\.0\.0\.1\fR から接続を行なおうとする。 そのため、\fB127\.0\.0\.1\fRを追加していない場合、\fB smbd\fR と \fBnmbd\fR は実際には動作している場合でも、 常に「not running」と表示される。更に、\fB swat\fR から \fBsmbd\fR と \fBnmbd\fR の開始/停止/再起動を行なうこともできなくなる。 .sp デフォルト値: \fB\fIbind interfaces only\fR = no \fR .RE .PP blocking locks (S) .RS 4 このパラメータは、クライアントからオープン中のファイルの一部範囲に対して、 バイト範囲のロック(byte range lock)が要求された際に、タイムアウトが発生した場合の \fBsmbd\fR(8) の動作を制御する。 .sp このパラメータが設定されている場合にロック範囲の要求が即座に処理できない場合、 Samba は内部的にロック要求をキューイングして、タイムアウトが来るまで定期的にロックを取得する動作を行なう。 .sp このパラメータが \fBno\fR の場合、 Samba は以前のバージョンの Samba (訳注: Samba 1\.9\.x 以前)と同様に振舞い、 ロック範囲が取得できない場合にただちにロック要求を失敗させる。 .sp デフォルト値: \fB\fIblocking locks\fR = yes \fR .RE .PP block size (S) .RS 4 このパラメータにより、ディスクの空き領域を報告する際の \fBsmbd\fR(8) の動作が制御される。 デフォルトでは、ディスクのブロックサイズを 1024 バイトとして報告が行なわれる。 .sp このパラメータを変更した場合、クライアントからの書き込みに影響がでることが予想されるが、確認されていない。このパラメータは、熟練した管理者が(通常より大きい値に)変更を行なうことで、再コンパイルを行なうことなく、クライアントからの書き込みパフォーマンスへの影響をテストすることを可能とするために追加された。これは実験的なオプションのため、将来のリリースでは削除されるかも知れない。 .sp このオプションを変更しても、報告されるディスクの空き容量自体は変わらない。クライアントに報告されるディスクのブロックサイズが変更されるだけである。 .sp デフォルト値: \fB\fIblock size\fR = 1024 \fR .sp 設定例: \fB\fIblock size\fR = 4096 \fR .RE .PP browsable .RS 4 このパラメータは、browseableの別名である。 .RE .PP browseable (S) .RS 4 このパラメータは、net view コマンドやブラウズリスト中に現れる利用可能な共有の一覧にこの共有を表示させるかどうかを制御する。 .sp デフォルト値: \fB\fIbrowseable\fR = yes \fR .RE .PP browse list (G) .RS 4 このパラメータは、クライアントからの \fBNetServerEnum\fR コールに対して、 \fBsmbd\fR(8) がブラウズリストを提供するかどうかを制御する。 通常 \fBtrue\fR に設定されている。 これを変更する必要はまずないであろう。 .sp デフォルト値: \fB\fIbrowse list\fR = yes \fR .RE .PP casesignames .RS 4 このパラメータは、case sensitiveの別名である。 .RE .PP case sensitive (S) .RS 4 name mangling セクションでの説明を参照のこと。 .sp デフォルト値: \fB\fIcase sensitive\fR = no \fR .RE .PP change notify timeout (S) .RS 4 この SMB により、クライアントは指定したディレクトリが変更されていないかをサーバに「監視」させ、なんらかの変更が発生した際にのみ、その SMB 要求に返答させるということが可能になる。こうした定常的なディレクトリの監視は、 UNIX では高負荷な作業になるため、 \fBsmbd\fR(8) デーモンは \fIchange notify timeout\fR で設定された秒毎に、要求された各ディレクトリの監視を行なう。 Samba 3\.0\.23 以降、このパラメータは共有単位のパラメータに変更され、 このパラメータを 0 に設定することで change notify 機能による共有内のディレクトリ走査を完全に抑止することが可能となった。 大量のディレクトリが存在するため、(大量のファイルを削除すると) 削除処理のたびに Windows クライアントが change notify によりディレクトリ全体の再走査を何度も繰り返すような共有において、このパラメータを 0 に設定することが可能となった。 この change notify 処理は、システムによっては非常に負荷のかかる処理となる。 .sp デフォルト値: \fB\fIchange notify timeout\fR = 60 \fR .sp 設定例: \fB\fIchange notify timeout\fR = 300 # スキャン間隔を 5 分毎にする。 \fR .RE .PP change share command (G) .RS 4 Samba 2\.2\.0 では、Windows NT 4\.0 のサーバマネージャから動的な共有の追加や削除を行なう機能が実現されている。 \fIchange share command\fR は \fIsmb\.conf\fR に存在しているサービスの定義を修正するための外部のプログラムやスクリプトを指定するために用いられる。 \fIchange share command\fR を適切に実行するためには、 管理者は root アカウント(uid == 0) で \fBsmbd\fR に接続しておく必要がある。(訳注: SeDiskOperatorPrivilege 権限のあるアカウントでも可能) .sp スクリプト実行時には \fBsmbd\fR が以下の5つのパラメータを設定して自動的に \fIchange share command\fR を実行する。 .sp .RS 4 \h'-04'?\h'+03'\fIconfigFile\fR \- グローバルな \fIsmb\.conf\fR ファイルの位置 .RE .sp .RS 4 \h'-04'?\h'+03'\fIshareName\fR \- 新しい共有名 .RE .sp .RS 4 \h'-04'?\h'+03'\fIpathName\fR \- ディスク上に 「存在している」ディレクトリのパス名 .RE .sp .RS 4 \h'-04'?\h'+03'\fIcomment\fR \- 新しい共有に設定するコメント文字列 .RE .sp .RS 4 \h'-04'?\h'+03'\fImax connections\fR 共有への最大同時接続数。 .RE .IP "" 4 このパラメータは、既に存在するファイル共有の設定を修正するためにのみ用いられる。 印刷共有の設定を修正する場合、Samba ホストをブラウズすると表示される「Printers\.\.\.」フォルダから行なうこと。 .sp デフォルト値: \fB\fIchange share command\fR = \fR .sp 設定例: \fB\fIchange share command\fR = /usr/local/bin/addshare \fR .RE .PP check password script (G) .RS 4 パスワードの複雑性を検証するためのプログラム名を指定する。 パスワードはプログラムの標準入力に送られる。 .sp プログラムは、パスワードが良好であった場合に 0 を、それ以外の場合は他の値を返却しなければならない。 パスワードが脆弱であると判断された(プログラムが 0 を返却しなかった)場合、 ユーザには、パスワード変更の失敗が通知される。 .sp example ディレクトリに、crackcheck というサンプルのプログラムがある。 これは cracklib を用いてパスワードのチェックを行なっている。 .sp デフォルト値: \fB\fIcheck password script\fR = Disabled \fR .sp 設定例: \fB\fIcheck password script\fR = check password script = /usr/local/sbin/crackcheck \fR .RE .PP client lanman auth (G) .RS 4 このパラメータは、\fBsmbclient\fR(8) などの Samba のクライアントツールが 脆弱な LANMAN パスワードハッシュを使用した認証を行なうか否かを制御する。 無効にした場合、 Samba クライアントからは、NT パスワードハッシュを利用するクライアント (Windows NT/2000クライアント、Samba など。しかし Windows 95/98 は含まない) に対してのみ接続できる。 .sp LANMAN 暗号化レスポンスは簡単に解読することが可能である。 これは大文字と小文字を区別しないことや、使用しているアルゴリズムなどに起因する。 Windows 95/98 サーバが存在しない場合は、このオプションを無効にした方がよいだろう。 .sp このオプションを無効にすると、\fBclient plaintext auth\fR オプションも同時に無効となる。 .sp 同様に、 \fBclient ntlmv2 auth\fR パラメータを有効にした場合、NTLMv2 ログインのみが可能となる。 .sp デフォルト値: \fB\fIclient lanman auth\fR = yes \fR .RE .PP client ntlmv2 auth (G) .RS 4 このパラメータにより、\fBsmbclient\fR(8) がサーバへの接続時に NTLMv2 暗号化パスワードレスポンスを使用した認証を行なうかどうかが設定される。 .sp 有効にすると、NTLMv2 および LMv2 レスポンス(両方とも以前のバージョンよりはセキュアである) が送信される。 ただし、多くのサーバ(Windows NT 4\.0 SP3以前、Windows 9x および Samba 2\.2)は NTLMv2 と互換性がない。 .sp 同様に、有効にした場合 NTLMv1、 \fBclient lanman auth\fR および \fBclient plaintext auth\fR 認証は無効となる。また、共有レベルの認証も同時に無効となる。 .sp 無効にした場合、 NTLM レスポンス (および可能であれば LANMAN レスポンス) が、\fBclient lanman auth\fR の値に応じてクライアントから送信される。 .sp サイトによっては (特に「ベストプラクティス」のセキュリティポリシーを適用しているサイト)、NTLMv2 のみを許可し、脆弱な LM および NTLM レスポンスは許可していない。 .sp デフォルト値: \fB\fIclient ntlmv2 auth\fR = no \fR .RE .PP client plaintext auth (G) .RS 4 このパラメータは、サーバが暗号化パスワードをサポートしていない場合にクライアントから平文パスワードを送出するかどうかを制御する。 .sp デフォルト値: \fB\fIclient plaintext auth\fR = yes \fR .RE .PP client schannel (G) .RS 4 このパラメータはクライアントが netlogon セキュアチャネルの使用を有効にするか、もしくは要求するかを制御する。 client schannel = no はセキュアチャネルを有効にしない。 client schannel = auto はセキュアチャネルを有効にするが、強制はしない。 client schannel = yes はサーバが netlogon セキュアチャネルを理解できない場合、アクセスを許可しない。 .sp デフォルト値: \fB\fIclient schannel\fR = auto \fR .sp 設定例: \fB\fIclient schannel\fR = yes \fR .RE .PP client signing (G) .RS 4 このパラメータは、クライアントがサーバと通信する際に SMB 署名を有効にするか、もしくは強制するかを設定する。 設定可能な値は、\fBauto\fR、\fBmandatory\fR、\fBdisabled\fR である。 .sp auto に設定した場合、SMB 署名が有効になるが、強制はしない。 mandatory に設定すると、SMB 署名が必須となる。disable に設定すると、SMB 署名は有効にならない。 .sp デフォルト値: \fB\fIclient signing\fR = auto \fR .RE .PP client use spnego (G) .RS 4 この値により、Samba クライアントが認証の際に Simple and Protected NEGOciation (RFC2478 で規定) をサポートしたサーバ (Windows XP 、 Windows 2000 、Samba 3\.0 を含む) に対して SPNEGO の使用を試みるかどうかが制御される。 SPNEGO は Kerberos 認証の際に有効となる。 .sp デフォルト値: \fB\fIclient use spnego\fR = yes \fR .RE .PP comment (S) .RS 4 これは、クライアントから「ネットワークコンピュータ」や \fBnet view\fR コマンド経由でサーバ上で利用可能な共有を一覧する際に、共有名の横に表示される文字列である。 .sp コンピュータ名の横に表示される文字列を設定したい場合は、server string パラメータを参照のこと。 .sp デフォルト値: \fB\fIcomment\fR = # コメント文字列なし \fR .sp 設定例: \fB\fIcomment\fR = Fred\'s Files \fR .RE .PP config file (G) .RS 4 このオプションを指定することで、デフォルトの設定ファイル (通常\fIsmb\.conf\fR)の代わりのファイルを利用して、 設定を上書きすることが可能になる。このオプション自身が config file 中に記述されるため、これには「鶏と卵」問題がある。 .sp そのため、このパラメータによって設定ファイルが変更されると、 新しい設定ファイルの内容が先頭からロードされる。 .sp このオプションには、通常の変数置換が適用されるので、 うまく使えばとても便利であろう。 .sp 指定された設定ファイルが存在しない場合は読み込まれない (これにより、特定クライアントに対して、 特別な設定ファイルを指定するということが可能となる)。 .sp \fBデフォルト値なし\fR .sp 設定例: \fB\fIconfig file\fR = /usr/local/samba/lib/smb\.conf\.%m \fR .RE .PP copy (S) .RS 4 このパラメータにより、サービスエントリの「複製」 が可能となる。指定されたサービスの設定が単純に現在のサービスへと複製される。 現在のセクションに設定されているパラメータは、 複製元のセクションの設定を上書きする。 .sp この機能を使うと、「ひな型(template)」となるサービスを作成した上で、 同様の設定のサービスを単純に作成するということが可能となる。 複製元のサービスは、 設定ファイル内で複製先のサービスより前に記述する必要があることに注意。 .sp デフォルト値: \fB\fIcopy\fR = \fR .sp 設定例: \fB\fIcopy\fR = otherservice \fR .RE .PP create mode .RS 4 このパラメータは、create maskの別名である。 .RE .PP create mask (S) .RS 4 ファイル作成時に付与されるパーミッションは、 DOS の属性を UNIX のパーミッションに変換することにより生成されるが、 最終的には、このパラメータとビット単位の AND 演算が行なわれる。 このパラメータは、ファイルの UNIX のパーミッションに対するビットマスクと 考えることができる。ここで\fB設定されない\fRビットは、 ファイル作成時のパーミッションから削除される。 .sp このパラメータのデフォルト値は、 「group」と「other」の書き込みおよび実行権を UNIX のパーミッションから取り除いた値である。 .sp この処理に引続き、Samba はこのパラメータにより生成されたパーミッションを force create mode パラメータの値とビット単位の OR 演算を行なう。 なおパラメータの値はデフォルトで、000 に設定されている。 .sp このパラメータは、ディレクトリのパーミッション生成には関与しない。 directory mask パラメータを参照のこと。 .sp このパラメータは、Windows NT/2000 の ACL エディタにより設定されるアクセス許可には関与しない。 管理者が ACL に対するビットマスクも同様に設定したいと考えている場合は、 security mask の設定が必要である。 .sp デフォルト値: \fB\fIcreate mask\fR = 0744 \fR .sp 設定例: \fB\fIcreate mask\fR = 0775 \fR .RE .PP csc policy (S) .RS 4 このパラメータは、\fBクライアントサイドのキャッシングポリシー\fRを規定し、 オフラインキャッシュ機能を持つクライアントが、 共有上のファイルをどのようにキャッシュするかを規定する。 有効な値は、manual, documents, programs, disable である。 .sp これらの値は、Windows のサーバ側の設定に対応している。 .sp 例えば、移動プロファイルが格納されている共有では、 csc policy = disable とすることで、 オフラインキャッシュを無効にできる。 .sp デフォルト値: \fB\fIcsc policy\fR = manual \fR .sp 設定例: \fB\fIcsc policy\fR = programs \fR .RE .PP cups options (S) .RS 4 このパラメータは printing が \fBcups\fR に設定されている場合のみ有効である。 この値は、 CUPS ライブラリに直接渡されるオプションを記述した任意の形式の文字列である。 .sp CUPS で有効な一般の印刷オプション ( CUPS の「Spftware Users\' Manual」に記載されているもの ) はすべて設定できる。 また、設定対象のキューで有効な ( 「lpoptions \-d printername \-l」で表示される ) 任意のプリンタ固有のオプションも設定できる。 .sp Windows クライアントが Samba を経由して印刷を行なう際に CUPS サーバの \fIerror_log\fR ファイルに 「Unsupported format \'application/octet\-stream\'」といったメッセージが含まれている場合、 このパラメータを \fBraw\fR に設定するとよい。 現在では \fI/etc/cups/mime\.{convs,types}\fR において、 システム全体で raw 印刷を有効にする必要はない。 .sp デフォルト値: \fB\fIcups options\fR = "" \fR .sp 設定例: \fB\fIcups options\fR = "raw,media=a4,job\-sheets=secret,secret" \fR .RE .PP cups server (G) .RS 4 このパラメータは printing が \fBcups\fR に設定されている場合のみ有効である。 .sp このパラメータが設定されると、CUPS の \fIclient\.conf\fR で設定された ServerName オプションの値が置き換えられる。 これは、仮想 Samba サーバ毎に異なる CUPS デーモンに接続する際に必要である。 .sp なお、サーバ名に引続きコロンの後ろにポート番号を記述することで、ポー ト番号を指定することも可能である。 ポートの指定が行なわれ名張った場合、IPP のデフォルトポート (631) が用いられる。 .sp デフォルト値: \fB\fIcups server\fR = "" \fR .sp 設定例: \fB\fIcups server\fR = mycupsserver \fR .sp 設定例: \fB\fIcups server\fR = mycupsserver:1631 \fR .RE .PP deadtime (G) .RS 4 このパラメータの値(10進の整数)は、接続が利用されなくなったとみなされて切断が行なわれるまでの経過時間(分)を表す。 deadtime はオープンされているファイルが存在しない時のみ有効である。 .sp このパラメータは、多数の利用されていない接続によって、サーバ上のリソースが枯渇するのを防ぐのに有効である。 .sp 多くのクライアントは、このパラメータをユーザに意識させないように、接続が切断されていた際に、自動で再接続を行なう機能を持っている。 .sp ほとんどのシステムにおいて、このパラメータを利用して、数分でタイムアウトが発生するようにすることを推奨する。 .sp deadtime が 0 の場合、タイムアウトによる自動的な切断は行なわれない。 .sp デフォルト値: \fB\fIdeadtime\fR = 0 \fR .sp 設定例: \fB\fIdeadtime\fR = 15 \fR .RE .PP debug hires timestamp (G) .RS 4 ログメッセージに秒単位以上のタイムスタンプが必要な場合、 この真偽値のパラメータを有効にすることにより、 マイクロ秒単位のタイムスタンプがメッセージに付加される。 .sp このパラメータを有効にする際は、 debug timestamp が有効になっている必要があることに注意。 .sp デフォルト値: \fB\fIdebug hires timestamp\fR = no \fR .RE .PP debug pid (G) .RS 4 fork されて生成された \fBsmbd\fR(8) プロセスが同一のログファイルを共用している場合、 どのプロセスがメッセージを出力しているかを識別することは非常に難しい。 この真偽値パラメータを有効にすることで、ログファイル中のタイムスタンプメッセージのヘッダにプロセスIDが付加されるようになる。 .sp このパラメータを有効にする際は、 debug timestamp が有効になっている必要があることに注意。 .sp デフォルト値: \fB\fIdebug pid\fR = no \fR .RE .PP timestamp logs .RS 4 このパラメータは、debug timestampの別名である。 .RE .PP debug timestamp (G) .RS 4 Samba のデバッグログのメッセージには、 デフォルトでタイムスタンプが付加されるが、 高い、debug level を設定している場合、 このタイムスタンプが目障りに感じることもあるだろう。 この真偽値パラメータにより、タイムスタンプの付加を抑止することができる。 .sp デフォルト値: \fB\fIdebug timestamp\fR = yes \fR .RE .PP debug uid (G) .RS 4 Samba は root 権限で動作する時もあれば、 接続したユーザの権限で動作する時もある。 このパラメータを有効にすると、現在の euid、egid、uid、gid をログファイル中のタイムスタンプメッセージに付加する。 .sp このパラメータを有効にする際は、 debug timestamp が有効になっている必要があることに注意。 .sp デフォルト値: \fB\fIdebug uid\fR = no \fR .RE .PP default case (S) .RS 4 name mangling セクションを参照のこと。 short preserve case パラメータにも注意。 .sp デフォルト値: \fB\fIdefault case\fR = lower \fR .RE .PP default devmode (S) .RS 4 このパラメータは、printable サービスにのみ適用される。 smbd が、Windows NT/2000/XP クライアントに対してプリンタドライバを提供する際に、 Samba サーバ上の各プリンタでは、用紙サイズ、 orientation, duplex, settings といった情報が定義されたデバイスモード(device mode)という値を設定する必要がある。 デバイスモードの適切な値は、プリンタドライバ自身のみが生成することができる (この処理は、Win32 プラットフォームでのみ実行することができる)。 smbd はデバイスモードを生成するドライバのコードを実行できないため、 このフィールドのデフォルト値としては、NULL が設定される。 .sp Windows NT/2000/XP クライアントに対してプリンタドライバを提供する上での問題点の多くは、 デバイスモードの生成に関するものである。 ドライバによっては、デバイスモードとして NULL を設定すると、 クライアント側の Explorer\.exe をクラッシュさせるものがある。 また、デバイスモードがドライバ自身によって生成されていないと（たとえば smbd がデフォルトのデバイスモードを生成するなど）、 クライアントのスプーラサービス(spoolsv\.exe)を停止させてしまうものもある。 .sp このパラメータは、熟慮の上、プリンタドライバのテストを行なった上で用いること。 デバイスモードを NULL のままにしておき、Windows クライアントに適切な値を設定される方が好ましい。 ただし、ドライバが常にこの処理を行なうとは限らないため、 \fBdefault devmode = yes\fR の設定を行なうことで、smbd にデフォルトのデバイスモードを生成するような指示を行なうことができるようになっている。 .sp Windows NT/2000 の印刷システムやデバイスモードに関する詳細な情報については、 MSDN documentation を参照のこと。 .sp デフォルト値: \fB\fIdefault devmode\fR = no \fR .RE .PP default .RS 4 このパラメータは、default serviceの別名である。 .RE .PP default service (G) .RS 4 このパラメータは、 要求されたサービスが存在しなかった場合に接続されるサービス名を指定する。 パラメータの値に、大括弧(\'[\' と \']\')は\fB不要である\fRことに注意(設定例を参照のこと)。 .sp このパラメータにデフォルト値はない。 このパラメータが設定されていない場合、 存在しない共有に対する接続は失敗する。 .sp default service は guest ok と read\-only パラメータを有効にしたサービスにするのが一般的である。 .sp 外面的なサービス名はクライアントから要求されたサービス名に変換される。 これは、\fI%S\fR のようなマクロをワイルドカードサービスに適用する際に、非常に有用である。 .sp default service のサービス名に現れる「_」文字は、「/」にマッピングされる。 これにより、いろいろと面白いことができるだろう。 .sp デフォルト値: \fB\fIdefault service\fR = \fR .sp 設定例: \fB\fIdefault service\fR = pub \fR .RE .PP defer sharing violations (G) .RS 4 Windows ではファイルのオープン時に他のプロセスとの共有方法を指定することができる。 あるプロセスがファイルを開こうとした時に指定した共有方法が 別のプロセスによって指定された共有方法と共存できないようなものであった際に 共有違反が発生する。 このパラメータにより、smbd は Windows サーバのように動作するようになり、 「共有違反」のエラーメッセージを 1 秒待ってから返却するようになり、 クライアントはこの間に共有違反を起こしたファイルをクローズすることが可能となる。 .sp UNIX のデフォルトでは、こうした挙動は行なわれない。 .sp このパラメータは Samba の挙動をより Windows に近づけるためのものであり、 無効にする必然性はないであろう。 .sp デフォルト値: \fB\fIdefer sharing violations\fR = True \fR .RE .PP delete group script (G) .RS 4 このパラメータは、グループの削除が要求された際に、 \fBsmbd\fR(8) によって \fBROOT 権限で\fR 実行されるスクリプトのフルパス名である。 \fI%g\fR はグループ名に置換される。 スクリプトは Windows NT のドメイン管理ツールを使用して設定を行なう際にのみ有効である。 .sp デフォルト値: \fB\fIdelete group script\fR = \fR .RE .PP deleteprinter command (G) .RS 4 Samba 2\.2における Windows NT/2000 クライアントに対応した MS\-RPC ベースの印刷サポートの実装にともない、 DeletePrinter() RPC呼び出しを発行することにより、 実行中にプリンタを削除することが可能になった。 .sp Samba ホスト上では、 実際の印刷システム上から物理的にプリンタが削除される。 deleteprinter command パラメータには、 プリンタを印刷システムと\fIsmb\.conf\fRから削除するために 必要な操作を実行するためのスクリプトを設定する。 .sp deleteprinter command は \fI「プリンタ名」\fRのみをパラメータに設定されて自動的に呼び出される。 .sp deleteprinter command が実行されると、 \fBsmbd\fR は削除対象のプリンタを無効にするために、 \fIsmb\.conf\fR を読み直す。 共有名が依然として有効な場合、\fBsmbd\fR はクライアントに ACCESS_DENIED エラーを返却する。 .sp デフォルト値: \fB\fIdeleteprinter command\fR = \fR .sp 設定例: \fB\fIdeleteprinter command\fR = /usr/bin/removeprinter \fR .RE .PP delete readonly (S) .RS 4 このパラメータにより、読み取り専用のファイルの削除が可能になる。 これは DOS の仕様ではないが、UNIX では可能な処理である。 .sp このオプションは、rcs のようなアプリケーションを動作させるのに有用で、 UNIX ファイルの所有者に関する仕様がファイルのパーミッション変更を妨げたり、 DOS の仕様が読み取り専用ファイルの削除を妨げたりする問題を回避する。 .sp デフォルト値: \fB\fIdelete readonly\fR = no \fR .RE .PP delete share command (G) .RS 4 Samba 2\.2\.0 では、Windows NT 4\.0 のサーバマネージャから動的な共有の追加や削除を行なう機能が実現されている。 \fIdelete share command\fR は \fIsmb\.conf\fR に存在しているサービスの定義を削除するための外部のプログラムやスクリプトを指定するために用いられる。 \fIdelete share command\fR を適切に実行するためには、 管理者は root アカウント(uid == 0) で \fBsmbd\fR に接続しておく必要がある。(訳注: SeDiskOperatorPrivilege 権限のあるアカウントでも可能) .sp スクリプト実行時には \fBsmbd\fR が以下の2つのパラメータを設定して自動的に \fIdelete share command\fR を実行する。 .sp .RS 4 \h'-04'?\h'+03'\fIconfigFile\fR \- グローバルな \fIsmb\.conf\fR ファイルの位置 .RE .sp .RS 4 \h'-04'?\h'+03'\fIshareName\fR \- 存在しているサービス名 .RE .IP "" 4 このパラメータはファイル共有を削除する際にのみ利用される。 印刷共有の削除については、 deleteprinter command を参照のこと。 .sp デフォルト値: \fB\fIdelete share command\fR = \fR .sp 設定例: \fB\fIdelete share command\fR = /usr/local/bin/delshare \fR .RE .PP delete user from group script (G) .RS 4 このパラメータは、 Windows NT のドメイン管理ツールによってユーザがグループから削除された際に実行されるスクリプトのフルパス名である。 これは \fBsmbd\fR(8) によって \fBROOT 権限で\fR 呼び出される。 \fI%g\fR はグループ名に置換され、 \fI%u\fR はユーザ名に置換される。 .sp デフォルト値: \fB\fIdelete user from group script\fR = \fR .sp 設定例: \fB\fIdelete user from group script\fR = /usr/sbin/deluser %u %g \fR .RE .PP delete user script (G) .RS 4 このパラメータは、リモート RPC (NT) ツールによってユーザの管理が行なわれた際に、 \fBsmbd\fR(8) によって実行されるスクリプトのフルパス名である。 .sp このスクリプトは、「ドメインユーザマネージャ」や \fBrpcclient\fR により、リモートのクライアントがサーバからユーザを削除した際に呼び出される。 .sp このスクリプトは指定されたユーザ名の UNIX ユーザを削除するものでなければならない。 .sp デフォルト値: \fB\fIdelete user script\fR = \fR .sp 設定例: \fB\fIdelete user script\fR = /usr/local/samba/bin/del_user %u \fR .RE .PP delete veto files (S) .RS 4 このオプションは、アクセスが禁止(veto)されたディレクトリ (veto files オプションを参照のこと)を含むディレクトリを削除しようとする際に影響する。 このオプションが \fBno\fR (デフォルト) の場合、 アクセスが禁止されたディレクトリ内にアクセスを禁止されていないファイルやディレクトリが含まれていても、 ディレクトリ内の削除は失敗する。これは通常期待されている動作であろう。 .sp このオプションを \fByes\fR に設定すると、 Samba はアクセスが禁止されたディレクトリ内でも 再帰的にすべてのファイルやディレクトリを削除しようとする。 NetAtalk のようなファイルサーバを併用する際は、 通常 DOS/Windows ユーザからの参照するのを禁止しているディレクトリ内にメタファイル (たとえば \fI\.AppleDouble\fRなど)を作成するため、このオプションが有用である。 .sp delete veto files = yes を指定することで、 これらのディレクトリは、親ディレクトリが削除された際に、自動的に削除される (ただし、ユーザはディレクトリを削除するパーミッションを持っている必要がある)。 .sp デフォルト値: \fB\fIdelete veto files\fR = no \fR .RE .PP dfree cache time (S) .RS 4 \fIdfree cache time\fR パラメータは、 Samba のディスク空き容量の計算で問題が発生するシステムでのみ利用すること。 Ultrix では問題の発生することが知られているが、 他のオペレーティングシステムで発生するかも知れない。 この問題は、各々のディレクトリの一覧表示の終了時に 「終了 再試行 無視 (Abort Retry Ignore)」のエラーが発生する形で顕在化する。 .sp このパラメータは Samba 3\.0\.21 で新設されたものである。 これは、smbd がディスク空き容量の結果をキャッシュする時間を秒単位で指定する。0 (デフォルト値) の場合、キャッシュは行なわれない。 これにより、高負荷のサーバで dfree command のスクリプトが頻繁に呼ばれて負荷が増大することが避けられる。 .sp このパラメータのデフォルト値は 0 であり、キャッシュは行なわれない。 .sp \fBデフォルト値なし\fR .sp 設定例: \fB\fIdfree cache time\fR = dfree cache time = 60 \fR .RE .PP dfree command (S) .RS 4 \fIdfree command\fR パラメータは、 Samba のディスク空き容量の計算で問題が発生するシステムでのみ利用すること。 Ultrix では問題の発生することが知られているが、 他のオペレーティングシステムで発生するかも知れない。 この問題は、各々のディレクトリの一覧表示の終了時に 「終了 再試行 無視 (Abort Retry Ignore)」のエラーが発生する形で顕在化する。 .sp このパラメータでは、 総ディスク容量と空き容量を計算する内部ルーチンを置き換える外部スクリプトを指定する。 以下に、この機能を果たすスクリプトの仕様を示す。 .sp Samba 3\.0\.21 において、このパラメータは共有単位に設定可能なパラメータとなり、 新たに追加された dfree cache time パラメータにより、 高負荷のシステムにおいて、このスクリプトの出力結果をキャッシュできるようになった。 .sp 外部スクリプトは、対象となるファイルシステム中のディレクトリを示すパラメータ 1 つを受け取る。 これは通常 \fI\./\fRという文字列からなる。 スクリプトはアスキー文字で 2 つの整数を返さなければならない。 1 つめはブロック単位のディスク総容量で、 2 つめは利用できるブロック数でなければならない。 3 番目の戻り値として、オプションでブロックサイズをバイト単位で返却させることもできる。 デフォルトのブロックサイズは 1024 バイトである。 .sp 注意: スクリプトは、setuid や setgid しては \fBならず\fR、 (root のみ書き込み可能で)所有者は root である必要がある。 .sp dfree スクリプト(実行可能にする必要がある)を以下に示す: .sp .nf #!/bin/sh df $1 | tail \-1 | awk \'{print $2" "$4}\' .fi .sp もしくは、以下のようなものも考えられる(Sys V ベースのシステムの場合): .sp .nf #!/bin/sh /usr/bin/df \-k $1 | tail \-1 | awk \'{print $3" "$5}\' .fi .sp システムによっては、コマンド名をフルパスで記述する必要がある場合があるので注意。 .sp デフォルトは内部ルーチンにより、ディスクの総容量と空き容量が計算される。 .sp \fBデフォルト値なし\fR .sp 設定例: \fB\fIdfree command\fR = /usr/local/samba/bin/dfree \fR .RE .PP directory mode .RS 4 このパラメータは、directory maskの別名である。 .RE .PP directory mask (S) .RS 4 このパラメータは、パーミッションを示す8進数の数値であり、 UNIX 側のディレクトリ作成時に DOS の属性から UNIX のパーミッションを生成する際に使われる。 .sp ディレクトリ作成時に付与されるパーミッションは、 DOS の属性と UNIX のパーミッションとのマッピングにしたがって、 DOS の属性を UNIX のパーミッションに変換することにより生成されるが、 最終的には、このパラメータとビット単位の AND 演算が行なわれる。 このパラメータは、ディレクトリの UNIX のパーミッションに対するビットマスクと 考えることができる。ここで\fB設定されない\fRビットは、 ディレクトリ作成時のパーミッションから削除される。 .sp このパラメータのデフォルト値は、 「group」と「other」の書き込み権を UNIX のパーミッションから取り除き、ディレクトリの所有者のみが変更可能にしたものである。 .sp この処理に引き続いて、Samba はこのパラメータで生成された UNIX のパーミッションと force directory mode パラメータの値との OR 演算を行う。 このパラメータは既定では 000 に設定されている(つまり、追加されるパーミッションはない)。 .sp このパラメータは、Windows NT/2000 の ACL エディタで設定される アクセス許可には適用されない。ACL に対しても強制的にマスクを適用したい場合は、 directory security mask パラメータを設定することが必要である。 .sp デフォルト値: \fB\fIdirectory mask\fR = 0755 \fR .sp 設定例: \fB\fIdirectory mask\fR = 0775 \fR .RE .PP directory security mask (S) .RS 4 このパラメータは、 Windows NT クライアント上のセキュリティダイアログボックスを使って、 UNIX ディレクトリのパーミッションを操作する時に、 設定可能な UNIX 側のパーミッションを指定する。 .sp このパラメータは、変更されるパーミッションビットに対して、 マスクとして適用され (AND 操作が適用され)るため、 このマスクにないビットは変更操作から保護される。 このパラメータを、AND ではなく OR 操作を実行するパラメータである force directory security mode と混同しないように。 基本的に、マスク中で 0 と指定されたビットは、ユーザが変更できないビットと見なされる。 .sp このパラメータが明示的に指定されなかった場合は、 0777 に設定される。これにより、ディレクトリに対する全ての user/group/world パーミッションが変更可能となる。 .sp \fB注意\fR : 他の方法を使って Samba サーバにアクセスすることが可能なユーザは、この制限を簡単に回避できてしまう。 そのため、このパラメータの主な用途はスタンドアロンで動作する「アプライアンス」システムになるだろう。 通常のシステムの管理者のほとんどは、 このパラメータをデフォルトの \fB0777\fR のままにしておきたいと考えるだろう。 .sp デフォルト値: \fB\fIdirectory security mask\fR = 0777 \fR .sp 設定例: \fB\fIdirectory security mask\fR = 0700 \fR .RE .PP disable netbios (G) .RS 4 このパラメータを有効にすると、 Samba の NetBIOS サポート機能が無効になる。 Windows 2000 および Windows XP を除くすべてのバージョンの Windows では、NetBIOS のみを使用できる。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note NetBIOS サポートを無効にすると、 NetBIOS のみをサポートするクライアントからは Samba サーバにアクセスできなくなることに注意。 デフォルト値: \fB\fIdisable netbios\fR = no \fR .RE .PP disable spoolss (G) .RS 4 このパラメータを有効にすることで、 Samba の SPOOLSS MS\-RPC サポートを無効にし、Samba 2\.0\.x と同様の動作をさせることが可能となる。 Windows NT/2000 クライアントは、Lanman 形式の印刷コマンドを利用することも可能である。 Windows 9x/Me は、このパラメータに影響されない。 なお、このパラメータを有効にすると、NT のプリンタプロパティを利用した、 Windows NTのプリンタ追加ウィザードによる Sambaマシンへのプリンタドライバのアップロード機能が無効になる。 また、Windows NT/2000 クライアントが、必要に応じて Samba マシンからプリンタドライバをダウンロードする機能も同時に無効になる。 \fBこのパラメータを有効にする際は、充分注意すること。\fR .sp デフォルト値: \fB\fIdisable spoolss\fR = no \fR .RE .PP display charset (G) .RS 4 Samba がメッセージを標準出力や標準エラー出力に出力したり、 SWAT で表示したりする際に用いる文字コードセットを指定する。(訳注: SWAT で表示する際に用いられるコードは Samba 3\.0\.8 以降このパラメータに影響されない) 通常は、 unix charset と同じに設定すべきである。 (訳注: 現在、デフォルト値は LOCALE であり、これはロケールに依存した文字コードセットが用いられることを意味する。通常この値を変更する必要はないだろう) .sp デフォルト値: \fB\fIdisplay charset\fR = ASCII \fR .sp 設定例: \fB\fIdisplay charset\fR = UTF8 \fR .RE .PP dmapi support (S) .RS 4 このパラメータにより、Samba がオフラインのファイルの判定に DMAPI を用いるかどうかが制御される。 これは、通常ファイルを自動的にテープに移動していくような階層型ストレージとの連携の際に用いられる。 .sp Samba はファイルの状態を DMAPI アプリケーションが登録したイベントを確認することで推測することに注意。 この方法は、多くの階層型ストレージシステムで機能するが、一部機能しないシステムもあるかも知れない。この場合、 Samba はファイルがオフラインであるという誤った報告を行なうことになる。 .sp このパラメータは、コンパイル時に DMAPI の実装サポートを確認できた場合にのみ有効となる。 また、実行時にシステムで DMAPI が使用可能であることが確認できた場合にのみ使用される。 .sp デフォルト値: \fB\fIdmapi support\fR = no \fR .RE .PP dns proxy (G) .RS 4 WINS サーバとして機能している \fBnmbd\fR(8) が WINS サーバとして機能している場合、ある NetBIOS 名が登録されていなかった時に、その NetBIOS 名を DNS 名として扱い、名前の問い合わせを行ったクライアントに代わってその名前を DNS サーバに対して問い合わせるように設定する。 .sp NetBIOS 名の最大長は 15 文字であるため、 問い合わせる DNS 名(もしくはDNSの別名)も、最大15文字に制限される。 .sp \fBnmbd\fR が DNS への名前解決を行う際には、問い合わせにより他の処理が停止させないために、自分自身を複製したプロセスを生成する。 .sp デフォルト値: \fB\fIdns proxy\fR = yes \fR .RE .PP domain logons (G) .RS 4 このパラメータが \fByes\fR に設定されると、 Samba サーバは、自身が所属する workgroup に所属する Windows 95/98 に対するドメインログオン機能を提供するようになる。 さらに、Samba サーバは、 Windows NT 4\.0 形式のドメインコントローラとしても機能するようになる。 この機能の設定に関する詳細な記述は、 Samba\-PDC\-HOWTO の「Domain Control」章を参照のこと。 .sp デフォルト値: \fB\fIdomain logons\fR = no \fR .RE .PP domain master (G) .RS 4 このオプションにより、 \fBsmbd\fR(8) が WAN 環境におけるブラウズリストの統合を行なうことが可能になる。 このオプションを設定すると、\fBnmbd\fR は、指定された workgroup のドメインマスタブラウザであることを表す、ドメイン固有の特別な NetBIOS 名(訳注:NetBIOS 名で末尾が 0x1b のユニーク名を指す) を登録する。 各サブネット上にある、同じ名前の workgroup に属するローカルマスタブラウザは、この \fBnmbd\fRに対して、 ローカルに収集したブラウズリストを提供するとともに、 \fBsmbd\fR(8) に対してネットワーク全体のブラウズリストの完全な複製の提供を要求するようになる。 ブラウザのクライアントは、ローカルマスタブラウザと通信することで、 個々のサブネットのブラウズリストではなく、 そのドメイン全体のブラウズリストを取得できるようになる。 .sp Windows NT のプライマリドメインコントローラは、 workgroup のドメインマスタブラウザとして機能するために、 workgroup 固有の特別な NetBIOS 名を登録することが前提とされていることに注意 (Windows NT PDC のこの動作を抑止することはできない)。 つまり、このパラメータが Yes に設定され、\fBnmbd\fR が Windows NT PDC より前に、workgroup のための特別な NetBIOS 名を登録してしまうと、 サブネット越しのブラウズは正常に動作せず、失敗する。 .sp domain logons = yes の場合、domain master パラメータはデフォルトで有効となる。 domain logons が有効でない場合(デフォルト)、 domain master パラメータもデフォルトでは有効にならない。 .sp domain logons = Yes の場合、このパラメータもデフォルトで Yes となり、Samba は PDC として動作するようになる。 domain master = No の場合、Samba は BDC として動作するようになる。通常、このパラメータを「No」に設定する必要があるのは、BDC として機能させる場合のみである。 .sp デフォルト値: \fB\fIdomain master\fR = auto \fR .RE .PP dont descend (S) .RS 4 システムに存在するディレクトリには、 クライアントに参照させたくないものや、 無限に深い(再帰的)なものが存在する(たとえば Linux での \fI/proc\fR)。 このパラメータは常に空のように見せかけるサーバ側のディレクトリをコンマで区切って指定する。 .sp Samba が要求する「dont descend」の書式は一定ではない。 たとえば \fI/proc\fR ではなく \fI\./proc\fR でなければならないかもしれない。 実験してみるのが最良の方法である。 :\-) .sp デフォルト値: \fB\fIdont descend\fR = \fR .sp 設定例: \fB\fIdont descend\fR = /proc,/dev \fR .RE .PP dos charset (G) .RS 4 DOS SMB クライアントは、サーバ側でも自身と同じ文字コードセットを使用していると想定する。 このオプションにより、 Samba が DOS クライアントと通信する際に用いられる文字コードセットを指定する。 .sp デフォルトは Samba にインストールされた文字コードセットによって異なる。 Samba は、文字コードセット 850 の使用を試みるが、使用できない場合は ASCII を使用する。 \fBtestparm\fR(1) コマンドを実行することで、システム上のデフォルト値を確認することが可能である。 .sp \fBデフォルト値なし\fR .RE .PP dos filemode (S) .RS 4 Samba のデフォルトの動作では、 ファイルやディレクトリの所有者のみがアクセス権を変更できるという、UNIX的な仕様になっている。 しかし、この仕様が DOS/Windows のユーザを混乱させてしまうことも多い。 このパラメータを有効にすることによって、 (何らかの手段によって)ファイルに書き込み権のあるユーザは、パーミッション(ACLを含む)の変更もできるようになる。 ファイルの所有グループに所属しているユーザは、 グループに対して読み込み権限しか与えられていない場合は パーミッションの変更を行なうことができないことに注意。 ファイルやディレクトリの所有者を変更することも可能である。 .sp デフォルト値: \fB\fIdos filemode\fR = no \fR .RE .PP dos filetime resolution (S) .RS 4 DOS や Windows の FAT ファイルシステム下では、 時刻の最小単位は 2 秒である。共有に対してこのパラメータを設定すると、 \fBsmbd\fR(8) に対して 1 秒精度の要求が 行なわれた際に、 返却される時間をもっとも近い 2 秒の境界値に丸める。 .sp このオプションはおもに、Samba の共有で Visual C++ を 使用するための互換性オプションとして利用する。 共有で oplock が有効であると、 Visual C++ はファイルが最後の読み込みから変更されていないかを検査するときに、 扱う日付の最小単位が異なる 2 つの時刻取得の呼び出し (call) を利用する。 そのうちのひとつの呼び出しは 1秒単位であり、もうひとつは 2 秒単位になっている。 2 秒単位で扱う呼び出しが奇数秒を切り捨てるため、 ファイルが奇数秒の日付であると 2 つの日付が一致せず、 Visual C++ はファイルが変更されたと報告し続けてしまう。 このオプションを\fByes\fRに設定することで 2 つの日付は一致し、Visual C++ も幸福になれる。 .sp デフォルト値: \fB\fIdos filetime resolution\fR = no \fR .RE .PP dos filetimes (S) .RS 4 DOS や Windows では、 ファイルに書き込み権のあるユーザが、ファイルのタイムスタンプを変更することが可能である。 POSIX の仕様では、ファイルの所有者か root のみがタイムスタンプを変更できる。 Samba のデフォルトは、POSIX 仕様に準拠しており、 \fBsmbd\fR の実効ユーザがファイルの所有者でないとき、タイムスタンプの変更を禁止する。 このオプションを \fByes\fR にセットすると、 DOS の仕様に準じて動作するようになるため、 \fBsmbd\fR(8) は DOS の要求に従ってタイムスタンプを変更できるようになる。 Microsoft Office 2000 以降で行なわれた変更に対応するため、 Samba 3\.0\.14 以降ではデフォルト値が「no」から「yes」に変更された。 このパラメータが「yes」になっていない場合、ファイルが複数のユーザ間で共用されていると、 Microsoft Excel はファイルが他のユーザによって変更されたという警告のダイアログボックスを表示してしまう。 .sp デフォルト値: \fB\fIdos filetimes\fR = yes \fR .RE .PP ea support (S) .RS 4 この真偽値パラメータにより、 \fBsmbd\fR(8) は、クライアントが共有内に OS/2 形式の拡張属性を格納することを可能とする。 このパラメータを有効にするためには、下位のファイルシステムが (Linux の場合 XFS や EXT3 に対するパッチとして提供されているような) 拡張属性をサポートしていることが必要である。 Linux の場合、拡張属性を有効にするには、カーネルが拡張属性を有効にしてコンパイルされていることに加え、 ファイルシステムのマウントオプションとして user_xattr を指定してマウントする必要がある。 .sp デフォルト値: \fB\fIea support\fR = no \fR .RE .PP enable asu support (G) .RS 4 「Advanced Server for Unix (ASU)」というプロダクトを実行しているホストでは、 IPC コネクションのみをサポートするビルトインの [ADMIN$] 共有が作成されるなど、 ASU 特有の動作が幾つか存在する。長年、これは smbd のデフォルトの動作でもあった。 ところが、Print Migrator tool というマイクロソフトのアプリケーションでは、 リモートのサーバで [ADMIN$] というファイル共有がサポートされている必要がある。 このパラメータを無効にすることで、smb\.conf に [ADMIN$] というファイル共有を作成することが可能になる。 .sp デフォルト値: \fB\fIenable asu support\fR = no \fR .RE .PP enable privileges (G) .RS 4 このパラメータは、smbd が \fBnet rpc rights\fR もしくは Windows 側のユーザ、グループ管理ツールにより、特定の SID に対して指定のユーザー権利を付与する機能を制御する。 このパラメータはデフォルトで有効となっているが、Domain Admins グループのメンバがユーザーやグループにユーザー権利を割り当てることで、 root 権限で実行される smbd の処理が該当ユーザとして接続した状態で実行されることを防止するために無効にすることも可能である。 .sp ユーザー権利を使用することで、例えば smbd が動作するサーバの root 権限を与えずに、 Samba ドメインに参加する権利を付与することが可能である。 .sp より詳細な説明については、Samba HOWTO 中の記載を参照のこと。 .sp デフォルト値: \fB\fIenable privileges\fR = yes \fR .RE .PP encrypt passwords (G) .RS 4 この真偽値パラメータにより、 クライアントとのネゴシエーションに暗号化パスワードを利用するかどうかが決定される。 Windows NT 4\.0 SP3 以降 や Windows 98 以降では、 レジストリの変更をしない限り、暗号化パスワードがデフォルトである。(訳注: これ以前のバージョンでも暗号化パスワードがデフォルトである。ただし、暗号化パスワードの利用ができなかった場合に平文パスワードを送出する点が異なる。) Samba で暗号化パスワードを使う方法は Samba HOWTO collection 中の「User Database」の章を参照してほしい。 .sp Microsoft の暗号化パスワードを想定して、 平文パスワードのサポートを無効にした Windows クライアントは、 暗号化パスワードが有効になっており、 アカウントのパスワードが適切に暗号化されている Samba サーバにのみ接続できる。 ユーザアカウントに対して暗号化パスワードを作成する方法については、 smbpasswd コマンドのマニュアルページを参照のこと。 .sp Microsoft 社の Windows 製品では、すでに平文パスワードのサポートは行なわれていない(訳注: 設定としては残存している)ため、 平文パスワードの利用は推奨できない。 平文パスワードを使用した場合は、このパラメータを no にすること。 .sp 暗号化パスワードを正しく機能させるためには、 \fBsmbd\fR(8) がローカルの \fBsmbpasswd\fR(5) ファイル (設定と保守の方法に関する情報は \fBsmbpasswd\fR(8) プログラムを参照)を参照するようにするか、 security = [server|domain|ads] パラメータを設定して、 \fBsmbd\fR が別のサーバで認証を行うようにする必要がある。 .sp デフォルト値: \fB\fIencrypt passwords\fR = yes \fR .RE .PP enhanced browsing (G) .RS 4 このオプションにより、 Samba に実装されている複数サブネット間でのブラウザのアナウンスメントに関する拡張が有効になる。 ただし、この拡張は、Microsoft の実装の標準とは異なる。 .sp ブラウザのアナウンスメントに関する一つ目の拡張点は、 Samba のWINSサーバに登録されているすべてのドメインマスタブラウザを問い合わせる定期的なワイルドカードクエリと、 返答に含まれる各DMBと行なわれるブラウズリストの同期処理のサポートである。 二つ目の拡張点は、DMBとして識別されているマシンとの間で 定常的に行なわれるランダムなブラウズリストの同期処理のサポートである。 (訳注: これは 120151 などで記載されている、WINS クライアントとなっている Windows NT 3\.5 以上の DMB が定期的に WINS サーバに接続し、WINSサーバが保有する「ドメイン名<1B>」のリストを自身のブラウズリストに追加していく処理のサポートだと思われる) .sp 中身が空のワークグループがブラウズリストから消えないというトラブルが発生した場合は、 このオプションを無効にしたい場合もあるだろう。 ブラウザのプロトコルの仕様上、 この拡張により空のワークグループが永久に残ってしまうという悩ましい問題が起こることがある。 .sp 通常は、サブネット越えのブラウザのアナウンスメントの信頼性向上のため、 このオプションは、有効のままにしておくべきである。 .sp デフォルト値: \fB\fIenhanced browsing\fR = yes \fR .RE .PP enumports command (G) .RS 4 ここでいう「ポート(port)」の概念は、 UNIXのものと大きく異なる。Windows NT/2000のプリントサーバにおいて、 ポートはポートモニタと関連付けられ、通常ローカルポート(LPT1:、COM1:、 FILE:)やリモートポート(LPD Port Monitorなど)といった名称をもつ。 Sambaのデフォルトでは、 \fB「Samba Printer Port」\fR というポートのみが定義されている。 Windows NT/2000においては、すべてのプリンタに適切なポート名がある。 デフォルトの\fB「Samba Printer Port」 \fR以外のポート名をポートの一覧に表示させたい場合 (\fBsmbd\fRはポート名を全く使用していない)、 標準出力に対してポート名のリストを1行に一つずつ生成するようなプログラムを \fIenumports command\fRで定義することができる。 この一覧はレベル1および2のEnumPorts() RPCのレスポンス中で利用される。 .sp デフォルト値: \fB\fIenumports command\fR = \fR .sp 設定例: \fB\fIenumports command\fR = /usr/bin/listports \fR .RE .PP eventlog list (G) .RS 4 このパラメータは、 Samba がマイクロソフトの「イベントビューア」ユーティリティ経由での表示を可能とするログファイル名の一覧を定義する。 一覧に含まれるログに対しては、ディスク上の \fI$(lockdir)/eventlog\fR 内に、 対応する TDB ファイルが割り当てられる。 .sp 管理者は、外部のプロセスを用いて \fI/var/log/messages\fR のような一般の UNIX ログファイルを解析し、 イベントログの TDB ファイルにエントリを書き込む必要がある。 イベントログのエントリを書き込む方法については、eventlogadm(8) ユーティリティを参照のこと。 .sp デフォルト値: \fB\fIeventlog list\fR = \fR .sp 設定例: \fB\fIeventlog list\fR = Security Application Syslog Apache \fR .RE .PP fake directory create times (S) .RS 4 NTFS や Windows VFAT ファイルシステムでは、 すべてのファイルとディレクトリの作成時刻を保持している。 これは UNIX が保持している ctime (状態変更時刻)とは異なるため、 Samba の既定動作では UNIX が保持している中で最も古い時刻を報告する。 共有でこのパラメータを \fByes\fR にした場合、Samba はディレクトリの作成時刻として、 常に 1980/1/1 の午前 0 時を報告する。 .sp このオプションは、Samba 共有上で Visual C++ を使うときに互換性を保つためのオプションとして用いられることが多い。 Visual C++ は、各オブジェクトファイルに対する依存性チェック用途のオブジェクトディレクトリと、 そのディレクトリを作成するルールを持った makefile を生成する。 NMAKE が日付を比較する際にディレクトリをチェックするときには、ファイル作成時刻を使用する。 これにより、オブジェクトディレクトリが存在しない場合は作成され、作成されたディレクトリは、 ディレクトリ中に存在するオブジェクトファイルよりも古い時刻を保持することになる。 .sp しかし、UNIX の時刻の扱いに関する仕様のため、 Samba が報告するディレクトリの作成時間はディレクトリにファイルが作成または削除されたときにも更新されてしまう。 その結果 NMAKE は、オブジェクトディレクトリで最後にビルドされたファイルを除く すべてのオブジェクトファイルがオブジェクトディレクトリより古いと判断し、それらを再構築してしまう。 このオプションを有効にすることで、 常にディレクトリは含まれるファイルよりも前の日付になり、 NMAKE によるビルドが意図したように行なわれることが保証される。 .sp デフォルト値: \fB\fIfake directory create times\fR = no \fR .RE .PP fake oplocks (S) .RS 4 oplock は、SMB クライアントがファイル操作の結果をローカルにキャッシュするための許可をサーバから取得するための機能である。 サーバが oplock (opportunistic lock = 便宜的ロック) を許可すると、 クライアントは自分だけがそのファイルにアクセスしていると認識して、 積極的にファイルの内容をキャッシュする。oplock のタイプによっては、 クライアントがファイルのオープン/クローズの操作をキャッシュすることもありうる。 これにより、多大な性能向上が期待できる。 .sp \fBfake oplocks = yes\fR の設定を行なうと、\fBsmbd\fR(8) は、 実際にそのファイルを利用しているクライアント数に関わらず、 常に oplock を許可する。 .sp 一般的には、このパラメータを利用するよりも、 実際の oplocks を利用する方がよい。 .sp CDROM 等の物理的に読みとり専用のメディアの場合など、 読みとり専用か、同時に 1 台のクライアントからだけしか アクセスされないとわかっている共有でこのオプションを有効にすると、 多くの操作で大きな性能改善が見られるだろう。複数のクライアントから 同時にファイルの読み書きアクセスする可能性がある共有でこのオプションを有効にすると、 ファイルの内容が破壊される場合が起こりうる。 このオプションは慎重に使用して欲しい! .sp デフォルト値: \fB\fIfake oplocks\fR = no \fR .RE .PP fam change notify (G) .RS 4 このパラメータにより、Samba がディレクトリ内の変更を FAM デーモンに問い合わせ、SMB クライアントがサーバ上のデータに変更があった際に、 更新を行なうことが可能になるようにするかが制御される。 .sp このパラメータは、FAM デーモンによるユーザプログラムへの変更通知機能がサポートされている場合のみ使用される。 FAM デーモンが実行されていない場合、このパラメータは自動的に無効となる。 \fIkernel change notify\fR パラメータが有効な場合、そちらが優先される。 .sp デフォルト値: \fB\fIfam change notify\fR = yes \fR .RE .PP follow symlinks (S) .RS 4 このパラメータにより、Samba の管理者は、 \fBsmbd\fR(8) がシンボリックリンクを追跡する処理を共有単位で禁止することが可能になる。 このパラメータを \fBno\fR に設定した場合、 シンボリックリンクのファイルやディレクトリの追跡する処理が抑制される(ユーザにはエラーが返却される)。 このオプションは、ユーザが自分のホーム・ディレクトリに \fI/etc/passwd\fR へのシンボリックリンクを追加するのを防止したりする効果がある。 ただし、わずかながらファイル名の検索が遅くなるだろう。 .sp このオプションはデフォルトで有効になっている (つまり、\fBsmbd\fR はシンボリックリンクを追跡する)。 .sp デフォルト値: \fB\fIfollow symlinks\fR = yes \fR .RE .PP force create mode (S) .RS 4 このパラメータは、Samba によって作成されたファイルのパーミッションに \fB必ず\fR設定される UNIX のパーミッションビットを指定する。 これは、ファイルの作成時やパーミッションの変更時に、 パーミッションビットに対して、このパラメータの値でビット単位の OR 演算を行なうことで実現される。 このパラメータの値がビット単位の OR 演算に用いられるのは、 \fIcreate mask\fR パラメータの適用後である。 .sp 下記の例は、作成されるすべてのファイルに対し、 グループ(group)とその他のユーザ(others)の読み込みと実行ビットと、 所有者(user)の読み込み/書き込み/実行ビットが必ず付与されるようにする。 .sp デフォルト値: \fB\fIforce create mode\fR = 000 \fR .sp 設定例: \fB\fIforce create mode\fR = 0755 \fR .RE .PP force directory mode (S) .RS 4 このパラメータは、Samba によって作成されたディレクトリのパーミッションに \fB必ず\fR設定される UNIX のパーミッションビットを指定する。 これは、ディレクトリの作成時に、 パーミッションビットに対して、このパラメータの値でビット単位の OR 演算を行なうことで実現される。 このパラメータの既定値は 000 (8 進数表記)である。この場合、作成されるディレクトリに対して特にパーミッションビットは追加されない。 このパラメータの値が適用されるのは、 \fIdirectory mask\fR パラメータの適用後である。 .sp 下記の例は、作成されるすべてのディレクトリに対し、 グループ(group)とその他のユーザ(others)の読み込みと実行権ビットと、 所有者(user)の読み込み/書き込み/実行ビットが必ず付与されるようにする。 .sp デフォルト値: \fB\fIforce directory mode\fR = 000 \fR .sp 設定例: \fB\fIforce directory mode\fR = 0755 \fR .RE .PP force directory security mode (S) .RS 4 このパラメータは、 Windows NT クライアント上のセキュリティダイアログボックスを使って、 UNIX ディレクトリのパーミッションを操作する時に、 設定可能な UNIX 側のパーミッションを指定する。 .sp このパラメータは、変更されるパーミッションビットに対して、 OR操作のマスクとして適用されるため、 このマスクにあるビットはユーザが行なった修正変更操作に関わらず、設定される。 このパラメータを、OR ではなく AND 操作を実行するパラメータである directory security mask と混同しないように。 .sp 基本的に、マスク中で 1 と指定されたビットは、 ディレクトリのセキュリティを修正する際に、常に「on」に設定されたとみなされる。 .sp このパラメータが明示的に設定されなかった場合は、 0000 に設定される。これにより、ディレクトリに対する全ての user/group/world パーミッションを制限なしに変更可能となる。 .sp \fB注意\fR : 他の方法を使って Samba サーバにアクセスすることが可能なユーザは、この制限を簡単に回避できてしまう。 そのため、このパラメータの主な用途はスタンドアロンで動作する「アプライアンス」システムになるだろう。 通常システムの管理者のほとんどは、このパラメータを 0000 のままにしておきたいと考えるだろう。 .sp デフォルト値: \fB\fIforce directory security mode\fR = 0 \fR .sp 設定例: \fB\fIforce directory security mode\fR = 700 \fR .RE .PP group .RS 4 このパラメータは、force groupの別名である。 .RE .PP force group (S) .RS 4 このパラメータには、 このサービスに接続するすべてのユーザのデフォルトの所属グループと見なされる UNIX のグループ名を指定する。 このパラメータを使うと、サービス上のファイルに対するアクセスの際のパーミッションチェックには、 ここで指定したグループを用いることができるため、ファイル共有を行う際に便利である。 この設定を行うことで、 このサービス内において提供するファイルやディレクトリに対して指定されたグループ名にパーミッションを割り当てることにより、 Samba の管理者がこれらのファイルの共有を許可/不許可にすることができるようになる。 .sp Samba 2\.0\.5 以降では、このパラメータの機能が拡張されている。 \'+\' 文字からはじまるグループ名が設定されていた場合、 現在共有にアクセスしているユーザが設定されたグループのメンバーだった場合のみ、 そのグループをユーザのデフォルトのプライマリグループに設定する。 この動作により、該当のグループに予め所属しているユーザのみが、 そのグループを所有者とするファイルを作成する設定を行うことが可能となる。 これにより、所有権の設定をより細かく行なうことが可能となる。 たとえば、\fIforce group = +sys\fR という設定を行った場合、 sys グループに所属しているユーザが Samba の 共有 にアクセスした際にのみ、 デフォルトのプライマリグループが sys に設定される。 その他すべてのユーザは、通常のプライマリグループのままとなる。 .sp force user パラメータも設定されていた場合、 \fIforce group\fR で指定されたグループより、 \fIforce user\fR で指定されたユーザのプライマリグループの方が優先される。 .sp デフォルト値: \fB\fIforce group\fR = \fR .sp 設定例: \fB\fIforce group\fR = agroup \fR .RE .PP force printername (S) .RS 4 Windows NT （以降）の OS から印刷を行なう場合、 \fIsmb\.conf\fR 中の各プリンタには、 クライアントから使用可能な名前が 2 つある。 最初のものは smb\.conf で定義された共有名(短い名前)である。 Windows 9x クライアントからは、このプリンタ名しか使用できない。 プリンタに割り当てられたもう一つの名前は、Samba サーバの「プリンタ」 (プリンタとFAX)フォルダ」を参照すると表示されるものである。 これは、(\fIprinter name\fR オプションと混同しないように) 単にプリンタ名と記載する。 .sp Samba を含む Windows 互換のリモートのプリンタサーバ上で、 プリンタに対して新しいドライバが割り当てられた際、 Windows クライアントは、そのドライバの名前に合致するように、プリンタ名を変更する。 これは、複数のプリンタに同じドライバを割り当てているユーザを混乱させる結果となる。 Samba において、プリンタのプリンタ名を smb\.conf で定義された共有名と異なる名称にすることを禁止したい場合は、 \fIforce printername = yes\fR と設定すること。 .sp Windows では、プリンタ名と共有名を強制的に一致させることができないため、 このパラメータを有効にすると、Windows サーバから Samba サーバへプリンタの移行を行なう際に問題が発生するので注意。 .sp プリンタがクライアントにより使用を開始された後にこのパラメータの値を変更することは、 ユーザが自身の「プリンタ」フォルダからプリンタを削除することができなくなるため、推奨しない。 .sp デフォルト値: \fB\fIforce printername\fR = no \fR .RE .PP force security mode (S) .RS 4 このパラメータは、 Windows NT クライアント上で NT 固有のセキュリティダイアログボックスを使った UNIX ファイルのパーミッションを操作を行うときに、 変更可能とする UNIX のパーミッションビットを指定する。 .sp このパラメータは、 変更されるパーミッションビットに対して、OR 操作のマスクとして適用されるため、 このマスクに含まれるビットは、ユーザの設定に関わらず on となる。 このパラメータを、OR ではなく AND 操作を実行するパラメータである security mask と混同しないように。 .sp 端的にいえば、マスク中の各ビットは、ユーザがファイルのセキュリティを変更するときに、 常に「on」に設定するビットとして考えることもできる。 .sp このパラメータが明示的に設定されなかった場合は、 0 に設定される。これにより、ディレクトリに対する全ての user/group/world パーミッションを制限なしに変更可能となる。 .sp \fB注意\fR : 他の方法を使って Samba サーバにアクセスすることが可能なユーザは、この制限を簡単に回避できてしまう。 そのため、このパラメータの主な用途はスタンドアロンで動作する「アプライアンス」システムになるだろう。 通常システムの管理者のほとんどは、 このパラメータを 0000 のままにしておきたいと考えるだろう。 .sp デフォルト値: \fB\fIforce security mode\fR = 0 \fR .sp 設定例: \fB\fIforce security mode\fR = 700 \fR .RE .PP force unknown acl user (S) .RS 4 このパラメータを設定すると、 ファイルの所有者や所有グループとして不明な SID (ユーザやグループIDを示す、 セキュリティディスクリプタ) を含む Windows NT の ACL は、 現在接続しているユーザの UNIX での uid や gid に自動的にマッピングされる。 .sp これは、Windows NT のクライアントマシン上で作成された、 マシン内でのみ有効なユーザ(ドメインユーザでない)を含んだ ACL を持つファイルやフォルダを(通常 XCOPY /O により)、 Windows NT クライアントから Samba サーバにコピーした際に、 ファイル上の不明な userid や groupid を現在接続しているユーザのものに対応付けることを意図したものである。 winbindd による Windows NT の SID から UNIX 側の uid や gid への任意の対応づけを可能とする以外に、 この問題を適切に対処する方法はない。 .sp XCOPY /O が ACCESS_DENIED エラーを引きおこす際には、このパラメータを使って欲しい。 .sp デフォルト値: \fB\fIforce unknown acl user\fR = no \fR .RE .PP force user (S) .RS 4 このパラメータは、サービスに対する接続のすべてで、 デフォルトのユーザとみなされる UNIX ユーザの名前を指定する。 これはファイルを共有する上で便利であるが、誤って使用すると、 セキュリティ上の問題を引き起こす原因となるので、慎重に使用すべきである。 .sp このユーザ名は接続の確立後に適用される。 従って、クライアントが有効なユーザ名とパスワードで接続を行う必要があることには変わりはない。 接続が確立すると、全てのファイル操作は強制的に「force user」で指定されたユーザの権限で実行される。 クライアントが接続を確立した際のユーザ名は無視される。 これは大変便利なことがある。 .sp Samba 2\.0\.5 以降では、このパラメータによって 設定されたユーザのプライマリグループが、 すべてのファイル操作においてプライマリグループとして利用される。 Samba 2\.0\.5 以前では、プライマリグループは本来接続を行ったユーザのプライマリグループのまま変わらない(これはバグである)。 .sp デフォルト値: \fB\fIforce user\fR = \fR .sp 設定例: \fB\fIforce user\fR = auser \fR .RE .PP fstype (S) .RS 4 このパラメータは、 クライアントが共有のファイルシステムを問い合わせた際に、 \fBsmbd\fR(8) が返却する共有のファイルシステム名を指定する。 デフォルトは Windows NT 互換の \fBNTFS\fR だが、 必要に応じて \fBSamba\fR や \fB FAT \fR といった別の文字列に、変更することができる。 .sp デフォルト値: \fB\fIfstype\fR = NTFS \fR .sp 設定例: \fB\fIfstype\fR = Samba \fR .RE .PP get quota command (G) .RS 4 \fBget quota command\fR は Samba が実行されている OS 上で、API が提供されていない場合に限り使用すべきである。 .sp このオプションは、必ず \fB\./configure \-\-with\-sys\-quotas\fR が指定されているときのみ有効である。 もしくは Linux において \fB\./configure \-\-with\-quotas\fR が指定され、システムにクオータの API が存在し、機能する場合にのみ使用できる。 .sp このパラメータは、指定されたディレクトリが存在するパーティションについて、指定されたユーザやグループのクオータ情報を取得するスクリプトへのパスを指定する。 .sp このスクリプトは三つの引数をとる: .sp .RS 4 \h'-04'?\h'+03'ディレクトリ .RE .sp .RS 4 \h'-04'?\h'+03'問い合わせのタイプ .RE .sp .RS 4 \h'-04'?\h'+03'ユーザの uid もしくはグループの gid .RE .IP "" 4 問い合わせのタイプは以下のいずれかの値をとる: .sp .RS 4 \h'-04'?\h'+03'1 \- ユーザのクオータ .RE .sp .RS 4 \h'-04'?\h'+03'2 \- ユーザのデフォルトのクオータ (uid = \-1) .RE .sp .RS 4 \h'-04'?\h'+03'3 \- グループのクオータ .RE .sp .RS 4 \h'-04'?\h'+03'4 \- グループのデフォルトのクオータ (gid = \-1) .RE .IP "" 4 スクリプトの出力は、以下の要素をスペースで区切った1行の形式で行なわれる: .sp .RS 4 \h'-04'?\h'+03'要素1 \- クオータフラグ (0 = クオータは無効、 1 = クオータは有効、 2 = クオータは有効で使用を強制されている) .RE .sp .RS 4 \h'-04'?\h'+03'要素2 \- 現在の使用済ブロック数 .RE .sp .RS 4 \h'-04'?\h'+03'要素3 \- ブロック数のソフトウェア的な上限 .RE .sp .RS 4 \h'-04'?\h'+03'要素4 \- ブロック数のハードウェア的な上限 .RE .sp .RS 4 \h'-04'?\h'+03'要素5 \- 現在の使用済 inode 数 .RE .sp .RS 4 \h'-04'?\h'+03'要素6 \- inode 数のソフトウェア的な上限 .RE .sp .RS 4 \h'-04'?\h'+03'要素7 \- inode 数のハードウェア的な上限 .RE .sp .RS 4 \h'-04'?\h'+03'要素8(オプション) \- ブロックあたりのバイト数(デフォルト1024) .RE .IP "" 4 デフォルト値: \fB\fIget quota command\fR = \fR .sp 設定例: \fB\fIget quota command\fR = /usr/local/sbin/query_quota \fR .RE .PP getwd cache (G) .RS 4 これはチューニングのためのオプションである。このパラメータを有効にすると、 getwd() の呼び出し時間を減らすためのあるキャッシュアルゴリズムが有効になる。特に wide smbconfoptions パラメータが \fBno\fR に設定された場合は、パフォーマンスに対して相当な効果がある。 .sp デフォルト値: \fB\fIgetwd cache\fR = yes \fR .RE .PP guest account (G) .RS 4 このパラメータは、 guest ok (以下を参照のこと) が設定されたサービスにアクセスする際に使用されるユーザ名である。 ゲストサービスに接続しているクライアントすべてに対して、 ここで設定したユーザの権限が適用される。 このユーザはパスワードファイルに存在している必要があるが、ログイン可能となっている必要はない。 このパラメータとして、「ftp」ユーザを利用するのもよいであろう。 .sp システムによっては、アカウント「nobody」では印刷することができない。 この場合は別のアカウントを使用すること。 ゲストユーザでログイン(\fBsu \-\fRコマンドなどを使用する)して、 \fBlpr(1)\fR や \fBlp(1)\fR などの、 システムにある印刷コマンドを実行して印刷を行ってみることで、 これを確認しておくべきであろう。 .sp このパラメータは % マクロを受け付けない。 システムの大半の箇所では、正常動作する上でこの値が静的に設定されていることが必要とされるためである。 .sp デフォルト値: \fB\fIguest account\fR = nobody # default can be changed at compile\-time \fR .sp 設定例: \fB\fIguest account\fR = ftp \fR .RE .PP public .RS 4 このパラメータは、guest okの別名である。 .RE .PP guest ok (S) .RS 4 このパラメータが \fByes\fR のサービスに付いては、 サービスへの接続の際にパスワードが要求されない。 この場合、guest account の権限で操作が行われる。 .sp このパラメータは restrict anonymous = 2 のメリットを無効にする。 .sp このオプションに関する詳細については、 security セクションを参照のこと。 .sp デフォルト値: \fB\fIguest ok\fR = no \fR .RE .PP only guest .RS 4 このパラメータは、guest onlyの別名である。 .RE .PP guest only (S) .RS 4 このパラメータが \fByes\fR のサービスについては、 ゲスト接続のみが許可される。 このパラメータは、guest ok が有効になっていないサービスでは無効である。 .sp このオプションに関する詳細については、security セクションを参照のこと。 .sp デフォルト値: \fB\fIguest only\fR = no \fR .RE .PP hide dot files (S) .RS 4 この真偽値パラメータにより、 ドットで始まるファイル名のファイルを隠しファイルとして扱うかどうかが制御される。 .sp デフォルト値: \fB\fIhide dot files\fR = yes \fR .RE .PP hide files (S) .RS 4 これは、見せたくないがアクセスは許可したいファイルやディレクトリのリストを指定する。 DOSの「隠し」属性が該当するファイルやディレクトリに付加される。 .sp リストの各エントリは、 スペースをエントリ中に含められるようにするため、「/」で区切る必要がある。 「*」と「?」は、DOSのワイルドカードと同様にして、 複数のファイルやディレクトリを指定するために利用することができる。 .sp 各エントリはUNIXのパス形式で指定すること。DOSのパス形式で指定したり、 UNIXでディレクトリを意味する「/」を含んだりはできない。 .sp この設定には、 case sensitive オプションの設定が影響することに注意。 .sp このパラメータを設定すると、 全てのファイルやディレクトリに対して該当するかどうかの確認を行う必要が発生するため、 Samba のパフォーマンスに影響がでる。 .sp 以下の設定例は、Thursby から入手可能な Macintosh 上の SMB クライアント (DAVE) が内部的な用途に作成するファイルの指定に加え、 ドットで始まるファイルを隠しファイルとして指定したものである。 .sp このパラメータの設定例を以下に示す。 .sp .nf hide files = /\.*/DesktopFolderDB/TrashFor%m/resource\.frk/ .fi .sp デフォルト値: \fB\fIhide files\fR = # どのファイルも隠されない \fR .RE .PP hide special files (S) .RS 4 このパラメータにより、クライアントからソケット、デバイス、FIFOなどのファイルがディレクトリ一覧で表示されることを抑止できる。 .sp デフォルト値: \fB\fIhide special files\fR = no \fR .RE .PP hide unreadable (S) .RS 4 このパラメータにより、読みとりができないファイルの存在をクライアントから隠蔽できる。 このパラメータのデフォルトは off になっている。 .sp デフォルト値: \fB\fIhide unreadable\fR = no \fR .RE .PP hide unwriteable files (S) .RS 4 このパラメータにより、書き込みができないファイルの存在をクライアントから隠蔽できる。 このパラメータのデフォルトは off になっている。 書き込みができないディレクトリについては通常通り表示されることに注意。 .sp デフォルト値: \fB\fIhide unwriteable files\fR = no \fR .RE .PP homedir map (G) .RS 4 このパラメータは、 nis homedir が \fByes\fR で \fBsmbd\fR(8) が Windows 95/98 の \fIlogon server\fR として機能している場合に、 ユーザのホームディレクトリがあるサーバがどこかの情報をもつ NIS (YP)のマップを指定する。 現在のところ、Sun の auto\.home マップ形式のみが認識される。 マップの形式は以下のとおり: .sp .nf \fBusername server:/some/file/system\fR .fi プログラムは、最初の「:」の前までをサーバ名として解釈する。 これ以外のマップの形式や、Amd (別の automounter)のマップにも対応した優れた解析ロジックもおそらく存在するはずである。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note このオプションを利用する場合は、 システムがNISクライアントとして稼働している必要がある。 デフォルト値: \fB\fIhomedir map\fR = \fR .sp 設定例: \fB\fIhomedir map\fR = amd\.homedir \fR .RE .PP host msdfs (G) .RS 4 \fByes\fR の場合、 Samba は DFS サーバとして機能し、 DFS を利用可能なクライアントは、サーバ上で提供された DFS ツリーを参照することが可能となる。 .sp 共有単位のパラメータである msdfs root も参照のこと。 Samba で DFS ツリーを構成する場合の詳細な情報については、 Samba3\-HOWTO の MSDFS の章を参照のこと。 .sp デフォルト値: \fB\fIhost msdfs\fR = yes \fR .RE .PP hostname lookups (G) .RS 4 Samba が(負荷のかかる)ホスト名検索を行なうか、 IP アドレスを使用するかを指定する。現在ホスト名検索を使用している箇所としては、 \fBhosts deny\fR および \fBhosts allow\fR の確認箇所などが挙げられる。 .sp デフォルト値: \fB\fIhostname lookups\fR = no \fR .sp 設定例: \fB\fIhostname lookups\fR = yes \fR .RE .PP allow hosts .RS 4 このパラメータは、hosts allowの別名である。 .RE .PP hosts allow (S) .RS 4 このパラメータの同義語として allow hosts がある。 .sp このパラメータには、サービスに対するアクセスを許可するホストのリストを、 コンマ, スペース, タブで区切って指定する。 .sp [global] セクションで指定された場合、 個々のサービスで異なった設定が行われている場合も含めて、 その設定が全てのサービスに対して適用される。 .sp ホストの指定は、IPアドレスでもホスト名でも行うことができる。 例えば、あるClass C サブネット上のホストのみにアクセスを限定したい場合は、 \fBallow hosts = 150\.203\.5\.\fRとすればよい。 指定に利用できる記法の全ては、 \fIhosts_access(5) \fRのマニュアルページ中に記載されている。 このマニュアルページはシステムに存在しないかも知れないので、 ここで簡単に説明を行っておく。 .sp なお、localhost のアドレスである 127\.0\.0\.1 からのアクセスは、 hosts deny パラメータで明示的に禁止されない限り、常にアクセスを許可される。 .sp ホストの指定に、network/netmask 形式を用いたり、 システムがネットグループをサポートしている場合はネットグループ名を用いたりすることも可能である。 \fBEXCEPT\fR を用いることで、ワイルドカードによるホストの指定に対する例外を設けることも可能である。 以下の例が手がかりになるだろう: .sp Example 1: 150\.203\.*\.* 内の全てのIPアドレスを許可する; ただし、例外のアドレスが1つある .sp \fBhosts allow = 150\.203\. EXCEPT 150\.203\.6\.66\fR .sp Example 2: 指定した network/netmask の範囲内のホストからのアクセスを許可する .sp \fBhosts allow = 150\.203\.15\.0/255\.255\.255\.0\fR .sp Example 3: 個別に指定したホストからのアクセスを許可する .sp \fBhosts allow = lapland, arvidsjaur\fR .sp Example 4: NISネットグループの「foonet」に含まれるホストからのアクセスを原則として許可するが、あるホストからのアクセスについては拒否する。 .sp \fBhosts allow = @foonet\fR .sp \fBhosts deny = pirate\fR .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note 実際のアクセスには、ユーザレベルで適切なパスワード指定する必要があることに注意。 ホストレベルのアクセス制御が期待通りになっているかどうかの確認手段については \fBtestparm\fR(1) を参照のこと。 .sp デフォルト値: \fB\fIhosts allow\fR = # なし (全てのホストがアクセス許可される) \fR .sp 設定例: \fB\fIhosts allow\fR = 150\.203\.5\. myhost\.mynet\.edu\.au \fR .RE .PP deny hosts .RS 4 このパラメータは、hosts denyの別名である。 .RE .PP hosts deny (S) .RS 4 \fIhosts allow\fR の反対の意味を持ち、 このパラメータで指定されたホストは、サービス内で明示的にアクセスが許可されない限り、 サービスへのアクセスを\fB拒否される\fR。 両者の設定が矛盾した場合は、\fIallow\fR 側の設定が優先される。 .sp デフォルトでアクセスを拒否したい場合は、 ALL (もしくはネットマスク 0\.0\.0\.0/0) の指定を行ない、 hosts allow = hosts allow パラメータにより、 アクセスを許可したいホストを明示的に指定すること。 .sp デフォルト値: \fB\fIhosts deny\fR = # なし (アクセスを拒否されるホストはない) \fR .sp 設定例: \fB\fIhosts deny\fR = 150\.203\.4\. badhost\.mynet\.edu\.au \fR .RE .PP idmap backend (G) .RS 4 idmap backend パラメータの目的は、ローカルの idmap TDB ファイルから、まだ対応づけされていない SID について SID と UID や GID の対応づけを行なうのではなく、 共用の LDAP 機構から取得するようにすることである。 これにより、すべてのドメインメンバおよびドメインコントローラは、同一の UID や GID と SID との対応づけを保持することとなる。 これにより、UNIX や Linux システム間で UID や GID の一貫性が保持されないことにより、 SMB/CIFS 以外のプロトコル (NFS など) を用いて情報の共有を行なう際に発生するリスクを押えることができる。 .sp SID と UID や GID とを対応づけるもう一つの方法は RID プラグインである。 このプラグインは、アカウントの RID に指定された基本値を加算することで UID や GID を生成する。 このプラグインを用いる際は、 “allow trusted domains = No” パラメータの指定が必須であり、 複数ドメイン環境では使用できない。 idmap uid および idmap gid パラメータの設定も必要である。 .sp この他 ad モジュールを用いることで、RFC 2307 互換の LDAP スキーマを有する Active Directory の LDAP サーバから UID や GID の情報を直接取得することが可能である。 ad モジュールは「Services for Unix(SFU)」の 2\.X および 3\.0 もサポートする。 .sp デフォルト値: \fB\fIidmap backend\fR = \fR .sp 設定例: \fB\fIidmap backend\fR = ldap:ldap://ldapslave\.example\.com \fR .sp 設定例: \fB\fIidmap backend\fR = rid:"BUILTIN=1000\-1999,DOMNAME=2000\-100000000" \fR .sp 設定例: \fB\fIidmap backend\fR = ad \fR .RE .PP winbind gid .RS 4 このパラメータは、idmap gidの別名である。 .RE .PP idmap gid (G) .RS 4 idmap gid パラメータは UNIX グループを NT グループの SID にマッピングする際に使用するグループ id の範囲を指定する。 予期しない競合が発生しないようにするため、この GID の範囲にローカルな グループや NIS グループが存在しないようにすること .sp 正常なグループマッピングを行うためには、idmap gid で指定した範囲が利用可能であることが不可欠である。 .sp デフォルト値: \fB\fIidmap gid\fR = \fR .sp 設定例: \fB\fIidmap gid\fR = 10000\-20000 \fR .RE .PP winbind uid .RS 4 このパラメータは、idmap uidの別名である。 .RE .PP idmap uid (G) .RS 4 idmap uid パラメータは UNIX ユーザを NT ユーザの SID にマッピングする際に割り当てられるユーザ id の範囲を指定する。 予期しない競合が発生しないようにするため、この GID の範囲にローカルな ユーザや NIS ユーザが存在しないようにすること .sp デフォルト値: \fB\fIidmap uid\fR = \fR .sp 設定例: \fB\fIidmap uid\fR = 10000\-20000 \fR .RE .PP include (G) .RS 4 このパラメータにより、ある設定ファイル中に別の設定ファイルを挿入することが可能となる。 挿入されるファイルは、挿入された場所に記述されたかのように、 そのままの形で挿入される。 .sp このパラメータには、\fI%u\fR、 \fI%P\fR、\fI%S\fRパラメータを除き、標準の変数置換が適用される。 .sp デフォルト値: \fB\fIinclude\fR = \fR .sp 設定例: \fB\fIinclude\fR = /usr/local/samba/lib/admin_smb\.conf \fR .RE .PP inherit acls (S) .RS 4 このパラメータは、 親ディレクトリにデフォルト ACL が設定されており、 サブディレクトリの作成時に、その ACL の設定を引き継がせたい場合に用いられる。 デフォルトでは ディレクトリ作成時に設定されるモードが用いられる。 このオプションを有効にすると、モードが 0777 となり、 ディレクトリのデフォルト ACL を確実に継承できるようになる。 .sp デフォルト値: \fB\fIinherit acls\fR = no \fR .RE .PP inherit owner (S) .RS 4 新規作成したファイルやディレクトリの所有者としては、 通常接続しているユーザの実行 UID の値が用いられる。 このパラメータにより、Samba の管理者は、 新規作成したファイルやディレクトリの所有者を 親ディレクトリの所有者と同一にすることが可能となる。 .sp この動作が有用な状況としては、 ユーザがファイルの作成や修正はできるが、削除はできないようにした drop box や、 あるユーザの移動プロファイルのディレクトリ内に新規作成されたファイルの所有者が そのユーザとなるようにしたい場合などが挙げられる。 .sp デフォルト値: \fB\fIinherit owner\fR = no \fR .RE .PP inherit permissions (S) .RS 4 通常、新規作成したファイルやディレクトリのパーミッションは、 create mask 、directory mask 、 force create mode 、 force directory mode パラメータによって決定されるが、 真偽値パラメータである inherit permissions は、それらに優先される。 .sp 新しいディレクトリはsetgid のようなビットも含め、 親ディレクトリのパーミッションを引き継ぐようになる。 .sp 新しく作成されたファイルは、read/write ビットの設定を親ディレクトリから引き継ぐようになる。 execute ビットについては、従来どおり map archive 、 map hidden 、map system などにより制御される。 .sp setuid ビットが引き継がれることは、\fB決して \fRない(コード上で明示的に禁止している)。 .sp このパラメータは、数千人レベルの多くのユーザが存在する大規模なシステムで、 単一の [homes] 共有を各ユーザが柔軟に利用できるようにさせる際に、 特に有用であろう。 .sp デフォルト値: \fB\fIinherit permissions\fR = no \fR .RE .PP interfaces (G) .RS 4 このオプションにより、Sambaがブラウジング、名前の登録その他のNBTの通信に利用するネットワークインタフェースのリストを設定することが可能となる。 デフォルトの場合、Sambaはカーネルに対して有効なインタフェースのリストを問い合わせ、 127\.0\.0\.1以外のブロードキャスト可能なインタフェースをすべて利用する。 .sp このオプションはインタフェースを示す文字列のリストとなる。 各文字列は以下の形式のいずれで指定してもよい。 .sp .RS 4 \h'-04'?\h'+03'ネットワークインタフェース名(eth0など)。 シェルのようなワイルドカード指定も可能である。 例えばeth*は「eth」から始まるすべてのインタフェースを指定したことになる。 .RE .sp .RS 4 \h'-04'?\h'+03'IPアドレス。 この場合、ネットマスクの値は、カーネルから取得されたインタフェースのリストにより設定される。 .RE .sp .RS 4 \h'-04'?\h'+03'IP/mask のペア。 .RE .sp .RS 4 \h'-04'?\h'+03'ブロードキャスト/mask のペア。 .RE .IP "" 4 「mask」パラメータはビット長(例えば24はクラスCネットワーク)で指定しても、 ドット区切り10進数表記で指定してもよい。 .sp 上記の「IP」パラメータは、ドット区切り10進法で指定しても、 OSの標準的なホスト名解決機構で解決可能なホスト名で指定してもよい。 .sp デフォルトで、Samba はループバックインタフェース (IPアドレス 127\.0\.0\.1) を除くブロードキャスト可能なすべての有効なインタフェースを使用する。 .sp 以下の設定では、eth0 デバイスと 192\.168\.2\.10 および 192\.168\.3\.10 の IP アドレスに対応する 3 つのネットワークインタフェースが指定されている。 後者のインタフェース 2 つに対するネットマスクは 255\.255\.255\.0 に設定されている。 .sp デフォルト値: \fB\fIinterfaces\fR = \fR .sp 設定例: \fB\fIinterfaces\fR = eth0 192\.168\.2\.10/24 192\.168\.3\.10/255\.255\.255\.0 \fR .RE .PP invalid users (S) .RS 4 これは、サービスに対するログインを許可しないユーザのリストを指定する。 このパラメータは、不適切な設定により発生しうるセキュリティ上の問題を完全に抑止する、 \fBパラノイド的\fR設定である。 .sp 「@」ではじまる名前は(システムがNISをサポートしている場合)、 まずNISネットグループとして解釈され、NISネットグループに名前が存在しない時は、 UNIXのグループとして解釈される。 .sp 「+」ではじまる名前は、UNIXのグループ名としてのみ解釈される。 「 & 」ではじまる名前は、NISネットグループの名前としてのみ解釈される (この場合システムでNISが稼働している必要がある)。 名前の前に付けられた「+」および「 & 」文字は、検索の順番を示す意味で使うこともできる。 例えば、\fI+&group\fRは、 UNIXグループを検索してから、NISネットグループを検索するという意味になり、 \fI&+group\fRは、 NIS ネットグループを検索してから UNIXグループを検索するという意味になる(これは「@」と同等になる)。 .sp \fI%S\fRは、 現在のサービス名に置換される。これは [homes] セクションで有効である。 .sp デフォルト値: \fB\fIinvalid users\fR = # invalid users は空である \fR .sp 設定例: \fB\fIinvalid users\fR = root fred admin @wheel \fR .RE .PP iprint server (G) .RS 4 このパラメータは、printing が \fBiprint\fR に設定されている場合のみ有効である。 .sp 設定されている場合、CUPS の \fIclient\.conf\fR で指定された ServerName オプションの値がこのパラメータによって上書きされる。 複数の仮想 Samba サーバが起動している環境で各々が異なる CUPS デーモンに接続している環境では、このパラメータが必要となる。 .sp デフォルト値: \fB\fIiprint server\fR = "" \fR .sp 設定例: \fB\fIiprint server\fR = MYCUPSSERVER \fR .RE .PP keepalive (G) .RS 4 このパラメータの値(整数値)により、 \fIkeepalive\fR パケットが送出される秒単位の間隔が設定される。このパラメータの値が0の場合、 keepalive パケットは送出されない。 keepalive パケットを送出することにより、サーバはクライアントマシンが存在していて応答があることを確認することが可能になる。 .sp ソケットにデフォルトで SO_KEEPALIVE 属性が設定されている場合( socket options を参照のこと)、通常 keepalive は不要である。基本的に、このオプションは問題が発生している場合にのみ使用すべきである。 .sp デフォルト値: \fB\fIkeepalive\fR = 300 \fR .sp 設定例: \fB\fIkeepalive\fR = 600 \fR .RE .PP kernel change notify (G) .RS 4 このパラメータは、Samba がカーネルに対してディレクトリの変更 通知を要求するか指定でき、この機能を使用すれば、サーバ上にある データに変更があった場合に SMB クライアントがその結果を 反映できるようになる。 .sp このパラメータは使用しているカーネルが F_NOTIFY fcntl を使用してユーザプログラムに対しての変更の通知をサポートしている 場合にのみ使用される。 .sp デフォルト値: \fB\fIkernel change notify\fR = yes \fR .RE .PP kernel oplocks (G) .RS 4 カーネルベースの oplocks をサポートしているUNIX(現在はIRIXとLinux 2\.4カーネルのみ)の場合、 このパラメータにより oplock の利用を制御できる。 .sp カーネル oplocks のサポートにより、 \fBsmbd\fR(8) が oplock を行ったファイルに対して、 ローカルな UNIX プロセスや NFS 経由でのアクセスがあった際に、 Sambaが \fIoplocks\fR を破棄することが可能となる。 これにより、 SMB/CIFS と NFS やローカルファイルアクセスとの間の完全な一貫性が確保される (これは\fB非常に\fR素晴らしいことである :\-)。 .sp このパラメータのデフォルト値は、 \fBon\fR であるが、 カーネルがこの機能をサポートしていないシステムでは、自動的に無効にされる。 このパラメータを変更する必要はないであろう。 .sp デフォルト値: \fB\fIkernel oplocks\fR = yes \fR .RE .PP lanman auth (G) .RS 4 このパラメータは、\fBsmbd\fR(8) が LANMAN パスワードハッシュを使用した認証を行なうか否かを制御する。 無効にした場合、 NT パスワードハッシュを利用するクライアント (Windows NT/2000クライアント、smbclientなど。しかし Windows 95/98 や MS\-DOS クライアントは含まない)のみがSambaホストに接続できる。 .sp LANMAN 暗号化レスポンスは簡単に解読することが可能である。 これは大文字と小文字を区別しないことや、使用しているアルゴリズムなどに起因する。 Windows 95/98 や MS\-DOS クライアントが存在しない場合は、このオプションを無効にした方ががよいだろう。 .sp \fBencypt passwords\fR オプションとは異なり、このパラメータはクライアントの挙動を制御するものではなく、 LANMAN レスポンスは以前としてネットワーク上を送信される。 Samba のクライアント (smbclient など) で LANMAN レスポンスを無効にするには \fBclient lanman auth\fR を参照のこと。 .sp このパラメータと \fBntlm auth\fR の両方を無効にした場合、 NTLMv2 によるログインのみが可能となる。 クライアントのすべてが NTLMv2 をサポートしているわけではなく、ほとんどのクライアントでは NTLMv2 を使用するために明示的な設定を行なう必要がある。 .sp デフォルト値: \fB\fIlanman auth\fR = yes \fR .RE .PP large readwrite (G) .RS 4 このパラメータは、Windows 2000で導入された、 さまざまなSMBリクエストにおける新しい64Kのストリーム読みとりおよび書き込みを \fBsmbd\fR(8) がサポートするかどうかを制御する。 Windows 2000クライアントのリダイレクタにはバグがあるため、 このパラメータを利用するには、SambaがIRIX、Solaris、Linux 2\.4カーネルのような64ビットのOSで動作している必要がある。 Windows 2000クライアントにおいては、10% のパフォーマンス向上が見込まれる。 デフォルト値は on であるが、他の Samba コードほどにはテストが充分には行われていない。 .sp デフォルト値: \fB\fIlarge readwrite\fR = yes \fR .RE .PP ldap admin dn (G) .RS 4 ldap admin dn は、 Samba がユーザのアカウント情報を取得するために ldap サーバに接続する際に 用いられる、Distinguished Name (DN) を指定する。 ldap admin dn は、 \fIprivate/secrets\.tdb\fR ファイルに 格納された admin dn のパスワードとともに用いられる。 これがどのように連携するかについての詳細な情報は、 \fBsmbpasswd\fR(8) のマニュアルページを参照のこと。 .sp ldap admin dn には完全な DN 名を指定する必要がある。 ldap suffix の値が ldap admin dn に付加されることはない。 .sp \fBデフォルト値なし\fR .RE .PP ldap delete dn (G) .RS 4 このパラメータは ldapsam の削除の操作時に、エントリを完全に 削除するか、Samba でしか使用されない属性だけを消すかの制御を行なう。 .sp デフォルト値: \fB\fIldap delete dn\fR = no \fR .RE .PP ldap group suffix (G) .RS 4 このパラメータは、グループが LDAP ディレクトリに加えられるときの サフィックスを指定する。もしこのパラメータが設定されていない場合、 ldap suffix の値が代わりに使用される。 サフィックスの文字列には、ldap suffix の文字列が付加されるため、相対 DN で指定を行なうこと。 .sp デフォルト値: \fB\fIldap group suffix\fR = \fR .sp 設定例: \fB\fIldap group suffix\fR = ou=Groups \fR .RE .PP ldap idmap suffix (G) .RS 4 このパラメータは idmap mapping の情報の保存先のサフィックスを 指定する。このパラメータが設定されていない場合、 ldap suffix の値が代わりに使用される。 サフィックスの文字列には、ldap suffix の文字列が付加されるため、相対 DN で指定を行なうこと。 .sp デフォルト値: \fB\fIldap idmap suffix\fR = \fR .sp 設定例: \fB\fIldap idmap suffix\fR = ou=Idmap \fR .RE .PP ldap machine suffix (G) .RS 4 このパラメータはマシンアカウントが LDAP ツリーのどこに 追加されるかを指定する。もしこのパラメータが設定されていない場合、 ldap suffix の値が代わりに使用される。 サフィックスの文字列には、ldap suffix の文字列が付加されるため、相対 DN で指定を行なうこと。 .sp デフォルト値: \fB\fIldap machine suffix\fR = \fR .sp 設定例: \fB\fIldap machine suffix\fR = ou=Computers \fR .RE .PP ldap passwd sync (G) .RS 4 このオプションは、Samba によるパスワード変更時に、Samba が通常のアカウント (ワークステーション、サーバやドメインの信頼関係は含まない) の NT ハッシュや LM ハッシュと、LDAP のパスワード の同期をおこなうかを定義する。 .sp ldap passwd sync には、 以下の 3 つのうちの 1 つを設定することができる: .sp .RS 4 \h'-04'?\h'+03'\fIYes\fR = LDAP、NT、LM パスワードの更新を試み、pwdLastSet time を変更する。 .RE .sp .RS 4 \h'-04'?\h'+03'\fINo\fR = NT、LM パスワードと pwdLastSet time を更新する。 .RE .sp .RS 4 \h'-04'?\h'+03'\fIOnly\fR = LDAP パスワードのみを変更し、あとの処理は LDAP サーバに 委任する。 .RE .IP "" 4 デフォルト値: \fB\fIldap passwd sync\fR = no \fR .RE .PP ldap replication sleep (G) .RS 4 Samba が読みとり専用の LDAP レプリカに対して、書き込みの要求を行なった際には、読み書き可能なマスタサーバと通信するようにリダイレクトを行なう。 その後マスタサーバは、変更を最初に通信した「ローカル」サーバに対して複製を行なうが、特に遅い回線越しの場合、これには数秒の時間を要する。 特にドメインへの参加といったクライアント側の処理については、「成功」した処理が LDAP のデータに即座に反映されないことで、 混乱する可能性がある。 .sp このオプションにより、LDAP サーバに変更が反映されるのを待つために Samba が短い時間待機するようになる。 遅延の大きいネットワークの場合、LDAP の複製に要する時間をネットワークモニタで取得の上、それに応じて値を増減すればよいだろう。 データの複製が完了したかどうかについてのチェックが行なわれるわけではない点に注意すること。 .sp この値はミリ秒単位で指定する。最大値は 5000 (5秒)である。 .sp デフォルト値: \fB\fIldap replication sleep\fR = 1000 \fR .RE .PP ldapsam:trusted (G) .RS 4 デフォルトで、ドメインコントローラとして動作し、認証に LDAP を用いている Samba は、ユーザやグループの情報を取得するために、UNIX の NSS サブシステムを必要とする。 UNIX がユーザ情報を /etc/passwd や /etc/group に格納する機構からすると、これは明らかに非効率である。 ユーザが把握する必要がある重要な項目の一つに、所属グループの一覧がある。 通常の UNIX のユーザ管理機構であれば、/etc/group ファイルの全体を参照するか、LDAP 環境においては NSS 機構を用いて同様のことを行なう。 UNIX には group のメンバを参照するのに最適化された関数が存在している。 しかし、残念なことに、ユーザやグループを扱うその他の関数については、こうした最適化は行なわれていない。 .sp o Samba を大規模環境に適用させるため、ldapsam:trusted = yes オプションにより、Samba に関係するユーザおよびグループのデータベースは LDAP 標準の posixAccount/posixGroup 属性に格納されているとみなす。 さらに、Samba の AUXILIARY(補助) オブジェクトクラスについても、同じ LDAP オブジェクト中に POSIX データとして格納されているものとみなす。 これらの前提条件に適合する場合、 ldapsam:trusted = yes を設定することが可能となる。 この場合、Samba はユーザ情報の NSS に対する問い合わせを完全にバイパスする。 最適化された LDAP クエリにより、ログオンや管理作業が劇的に高速化される。 LDAP データベースのサイズにもよるが、共通的なクエリについては、100 倍以上の高速化が容易に達成される。 .sp デフォルト値: \fB\fIldapsam:trusted\fR = no \fR .RE .PP ldap ssl (G) .RS 4 このオプションは、Samba が ldap server に接続する際に、SSL を用いるかどうかを制御するために用いられる。これは、 \fIconfigure\fR スクリプトの \fB\-\-with\-ssl\fR オプションで有効化される、 Samba の古い SSL サポートとは \fB無関係\fR .sp \fIldap ssl\fR の値には、以下の 3 つのうちいずれかを設定すること: .sp .RS 4 \h'-04'?\h'+03'\fIOff\fR = ディレクトリのクエリ時には決して SSL を用いない。 .RE .sp .RS 4 \h'-04'?\h'+03'\fIStart_tls\fR = ディレクトリサーバと通信する際に、LDAPv3 StartTLS 拡張オプション (RFC2830) を利用する。 .RE .sp .RS 4 \h'-04'?\h'+03'\fIOn\fR = \fIldap server\fR に対して、常に ldaps ポートで SSL を用いて接続する。 下位互換である \fB\-\-with\-ldapsam \fR オプションが configure 時に指定された場合に のみ有効である。 passdb backend も参照のこと。 .RE .IP "" 4 デフォルト値: \fB\fIldap ssl\fR = start_tls \fR .RE .PP ldap suffix (G) .RS 4 全体に適用される LDAP サフィックスを指定すると共に、sambaDomain オブジェクトの格納先を指定する。 .sp ldap suffix は、ldap user suffix、 ldap group suffix、ldap machine suffix、 ldap idmap suffix で指定された値に付加される。 これらのパラメータでは ldap suffix からの相対 DN で指定が行なわれる。 .sp デフォルト値: \fB\fIldap suffix\fR = \fR .sp 設定例: \fB\fIldap suffix\fR = dc=samba,dc=org \fR .RE .PP ldap timeout (G) .RS 4 Samba が LDAP サーバに接続しようとした際に、該当サーバがダウンしていたり、該当サーバに到達することができなかったりした場合に Samba が接続待ちでフリーズしてしまわないように、このパラメータでは Samba が接続の確立を待機する時間を秒単位で指定する。 デフォルトは 15 秒であり、この時間内に LDAP サーバは接続要求に対して応答する必要がある。 .sp デフォルト値: \fB\fIldap timeout\fR = 15 \fR .RE .PP ldap user suffix (G) .RS 4 このパラメータは、ユーザが LDAP ディレクトリに加えられるときの サフィックスを指定する。もしこのパラメータが設定されていない場合、 ldap suffix の値が代わりに使用される。 サフィックスの文字列には、ldap suffix の文字列が付加されるため、相対 DN で指定を行なうこと。 .sp デフォルト値: \fB\fIldap user suffix\fR = \fR .sp 設定例: \fB\fIldap user suffix\fR = ou=people \fR .RE .PP level2 oplocks (S) .RS 4 このパラメータにより、 Samba が共有上で level2(読みとり専用) oplock をサポートするかどうかが制御される。 .sp level2 の読みとり専用 oplock を利用することで、 Windows NT クライアントは、既に oplock が行われているファイルを別のクライアントがオープンしようとした際に (今までの排他的な oplock の場合に行われていた関連するすべての oplock を廃棄する処理の代わりに)、 読み書き可能な oplock から読みとり専用の oplock へのダウングレードを行うような oplock をファイルに対して行うことが可能になる。 これにより、ファイルをオープンしているクライアントのうち、level2 oplock をサポートしているものは、 ファイルの先読みのみを行うキャッシュ(このキャッシュは書き込みキャッシュやロックを行わない)を引続き行うため、 書き込みが行われないようなファイル(例えばアプリケーションのexeファイルなど)に対して多くのアクセスが行われる際のパフォーマンスが改善される。 .sp read only の oplock を行っていたクライアントのいずれかがファイルに書き込みを行った時点で、 すべてのクライアントに対して、 oplock を「なし(none)」の状態に解除し、先読みキャッシュを破棄するように通知が行なわれる(応答待ちは行なわれない)。 .sp このパラメータを有効にして、 共有されている実行ファイルのアクセスを高速化することを推奨する。 .sp level2 oplock に関する詳細な議論については、CIFS の仕様を参照のこと。 .sp 現在、kernel oplocks がサポートされていると、 level2 oplock は(このパラメータが\fByes\fRになっていても)、利用されない。 このパラメータを機能させるためには、 oplocks パラメータが、共有上で \fByes\fR である必要があることに注意。 .sp デフォルト値: \fB\fIlevel2 oplocks\fR = yes \fR .RE .PP lm announce (G) .RS 4 このパラメータにより、 \fBnmbd\fR(8) が、 OS/2 クライアントのブラウズリスト上に Samba サーバを格納するために必要な lanman announce のブロードキャストを送出するかどうかが制御される。 このパラメータは3つの値、\fByes\fR、 \fBno\fR、\fBauto\fRをとる。 デフォルトは \fBauto\fR である。 \fBno\fR の場合、Sambaは決してこのブロードキャストを送出しない。 \fByes\fR の場合、Sambaは lanman announce のブロードキャストを lm interval によって設定された間隔で定期的に送出する。 \fBauto\fR の場合、 Sambaはデフォルトでは lanman announce を送出しないが、受信を待機する。 そして、このブロードキャストを受信すると、 lm interval によって設定された間隔で定期的なブロードキャストの送出を開始する。 .sp デフォルト値: \fB\fIlm announce\fR = auto \fR .sp 設定例: \fB\fIlm announce\fR = yes \fR .RE .PP lm interval (G) .RS 4 Samba が OS/2 クライアントが必要とする lanman announce のブロードキャストを送出するように設定されている場合 (lm announce パラメータを参照のこと)、 このパラメータにより送出間隔が秒単位で指定される。 これが 0 の場合、 lm announce パラメータの設定に関わらず、 lanman announce は送出されない。 .sp デフォルト値: \fB\fIlm interval\fR = 60 \fR .sp 設定例: \fB\fIlm interval\fR = 120 \fR .RE .PP load printers (G) .RS 4 このパラメータは、printcapファイル中で定義されたすべてのプリンタをデフォルトでブラウジング可能とするかどうかを制御する真偽値パラメータである。 詳細は、 printers セクションを参照のこと。 .sp デフォルト値: \fB\fIload printers\fR = yes \fR .RE .PP local master (G) .RS 4 このオプションにより、 \fBnmbd\fR(8) がサブネットのローカルマスタブラウザになるかどうかが制御される。 \fBno\fR の場合、 \fBnmbd\fR はサブネットのローカルマスタブラウザになろうとせず、 すべてのブラウザ選定において、常に敗退することになる。 デフォルトで、このパラメータは \fByes\fR に設定されている。 このパラメータを \fByes\fR にすることは、 Samba がサブネットのローカルマスタブラウザと\fBなる\fRことを意味するものではなく、 \fBnmbd\fR がローカルマスタブラザの選定に\fB 参加する\fR ということを意味するものに過ぎない。 .sp このパラメータの値を \fBno\fR にすると、\fBnmbd\fR は \fB決して\fR ローカルマスタブラウザにならなくなる。 .sp デフォルト値: \fB\fIlocal master\fR = yes \fR .RE .PP lock dir .RS 4 このパラメータは、lock directoryの別名である。 .RE .PP lock directory (G) .RS 4 このオプションにより、ロックファイルが置かれるディレクトリが指定される。 ロックファイルは max connections オプションにより利用される。 .sp デフォルト値: \fB\fIlock directory\fR = ${prefix}/var/locks \fR .sp 設定例: \fB\fIlock directory\fR = /var/run/samba/locks \fR .RE .PP locking (S) .RS 4 このパラメータは、 クライアントからのロック要求により、 サーバがロック処理を行うかどうかを制御する。 .sp \fBlocking = no\fRの場合、 すべてのロックおよびアンロック要求は成功したものとして扱われ、 すべてのロック状態の問い合わせは、ファイルがロック可能であると応答する。 .sp \fBlocking = yes\fRの場合、 サーバにより実際のロック処理が実行される。 .sp このオプションを\fBno\fRにすることは、 いかなる場合でも推奨されないが、 ロックを必要としない\fBと思われる\fR read only のファイルシステム(例えばCDROMドライブ)では、有用 \fBかも知れない\fR。 .sp ロックが機能しない場合、 データが破壊される可能性もあるため、全体に対しても、 個々の共有に対しても、ロックを無効にする際には注意すること。このパラメータの設定は通常必要ない。 .sp \fBデフォルト値なし\fR .RE .PP lock spin count (G) .RS 4 Samba 3\.0\.24 において、このパラメータは無効となった。 このパラメータで実現されていた機能は、現在 lock spin time パラメータで制御されている。 .sp デフォルト値: \fB\fIlock spin count\fR = 0 \fR .RE .PP lock spin time (G) .RS 4 smbd が一度失敗したロックを再度獲得しようとする際の待ち時間を、 マイクロ秒単位で指定する。 このパラメータのデフォルト値は、 Samba 3\.0\.23 において 10 から 200 に変更された。 関連する lock spin count パラメータは Samba 3\.0\.24 以降では使用されない。 このパラメータの値を変更する必要はないであろう。 .sp デフォルト値: \fB\fIlock spin time\fR = 200 \fR .RE .PP log file (G) .RS 4 このオプションにより、 Sambaのログファイル(デバッグファイル)の名称を変更することが可能である。 .sp このオプションには、標準の変数置換が適用されるため、 個々のユーザやマシン毎にログを分割することが可能である。 .sp \fBデフォルト値なし\fR .sp 設定例: \fB\fIlog file\fR = /usr/local/samba/var/log\.%m \fR .RE .PP debuglevel .RS 4 このパラメータは、log levelの別名である。 .RE .PP log level (G) .RS 4 このパラメータの値(整数値)により、 \fIsmb\.conf\fR ファイル中でデバッグレベル(ログレベル)を設定することが可能になる。 このパラメータは Samba 2\.2\.x 系列と比べ強化されており、デバッグクラス毎にデバッグレベルを指定することが可能となっている。 これにより、システムの設定が非常に柔軟に行なえるようになる。 .sp デフォルトのログレベルは、コマンドラインで指定された値になる。 指定が行なわれていない場合は、0 になる。 .sp \fBデフォルト値なし\fR .sp 設定例: \fB\fIlog level\fR = 3 passdb:5 auth:10 winbind:2 \fR .RE .PP logon drive (G) .RS 4 このパラメータは、 ホームディレクトリとして接続されるパスを指定する (logon home も参照のこと)。 このパラメータは NT Workstation によってのみ利用される。 .sp このパラメータは、Sambaがログオンサーバとして構成された場合のみ、 意味をもつことに注意。 .sp 訳注: Samba 3\.0 系列で LDAP や TDB を認証データベースとして用いている場合、これらの値はユーザ毎に保持され、本パラメータは指定がなかった際のデフォルト値を設定するものとなる。 .sp デフォルト値: \fB\fIlogon drive\fR = \fR .sp 設定例: \fB\fIlogon drive\fR = h: \fR .RE .PP logon home (G) .RS 4 このパラメータは、Windows 95/98/NT Workstation がSambaのPDCに対してログオンする際に用いられるホームディレクトリの位置を指定する。 これにより、例えば .sp C:\e>\fBNET USE H: /HOME\fR .sp のような形式でコマンドプロンプトから接続を行うことが可能となる。 .sp このオプションには、通常の変数置換が適用されるため、 個々のユーザやマシン毎にログオンスクリプトを分けることが可能になっている。 .sp このパラメータは、Windows 9x ワークステーションにおいて、 移動プロファイルをユーザのホームディレクトリのサブディレクトリに格納するために利用することが可能である。 この場合、以下のような設定を行う: .sp \fBlogon home = \e\e%N\e%U\eprofile\fR .sp これにより、Samba はクライアントから NetUserGetInfo リクエストなどで情報を要求された場合に上記文字列を返却するが、その際変数置換が行なわれる。 Windows 9x のクライアントは、ユーザが \fBnet use /home\fR コマンドを発行した際には、この情報の \e\eserver\eshare 部分だけを用いるが、 プロファイルを扱う場合は文字列全体を利用する。 .sp Sambaの以前のバージョンでは、 \fIlogon home\fRではなく、logon path が用いられていた。 このため、\fBnet use /home\fR がうまく動作しなかったが、 プロファイルをホームディレクトリの外に置くことが可能であった。 現在の実装は正しい実装である。上記のような技を用いることで、 このパラメータをプロファイルの位置の設定にも利用することが可能になっている。 .sp この機能を無効とするには、logon home = "" のように空の文字列を設定する。 .sp このパラメータは、Sambaがログオンサーバとして構成された場合のみ、 意味をもつ。 .sp 訳注: Samba 3\.0 系列で LDAP や TDB を認証データベースとして用いている場合、これらの値はユーザ毎に保持され、本パラメータは指定がなかった際のデフォルト値を設定するものとなる。 .sp デフォルト値: \fB\fIlogon home\fR = \e\e%N\e%U \fR .sp 設定例: \fB\fIlogon home\fR = \e\eremote_smb_server\e%U \fR .RE .PP logon path (G) .RS 4 このパラメータにより、移動プロファイル(Desktop、NTuser\.datなど)が格納されるディレクトリが指定される。 以前のマニュアルページとは矛盾するが、このパラメータはWindows 9xの移動プロファイルとは無関係である。 Windows 9x システムで移動プロファイルを利用する方法については、 logon home パラメータを参照のこと。 .sp このオプションは、標準の変数置換が適用されるため、 個々のユーザやマシン毎にログオンスクリプトを分けることが可能である。 このパラメータにより、Windows NT クライアントによって読み出される「Application Data」( \fIデスクトップ\fR、\fIスタート メニュー\fR、 \fIネットワークコンピュータ\fR、 \fIプログラム\fRやその他のフォルダとそのコンテンツ)のディレクトリも設定される。 .sp 設定やディレクトリを Windows NT クライアント上にロードするため、共有やパスはユーザが読み込み可能にしなければならない。 また、Windows NT クライアントが NTuser\.dat やその他のディレクトリを作成できるように、 ユーザが最初にログインする時には共有を書き込み可能にしなければならない。 必要があれば、ディレクトリと中身は読み出し専用にすることができる。 ただし、NTuser\.dat ファイルを読み出し専用にすることは推奨できない。 NTuser\.dat を NTuser\.man に名前を変更することで期待される動作(\fB固定\fRプロファイル(MANdatory profile))を実現できる。 .sp Windows クライアントは、ユーザがログインしていなくても [homes] 共有への接続を保持することがある。 そのため、logon path に [homes] 共有への参照を含めないようにしなくてはならない (たとえば、このパラメータを\e\e%N\ehomes\eprofile_path のように設定すると問題が発生することがある)。 .sp このオプションには、標準の変数置換が適用されるため、 個々のユーザやマシン毎にログオンスクリプトを分けることが可能になる。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Warning この値をクォーテーションで囲まないこと。これを “\e\e%N\eprofile\e%U” のようにすると、 プロファイル機構に問題が発生する。 tdbsam もしくは ldapsam が passdb backend として用いられている環境では、 ユーザアカウントが作成された時点で、このパラメータで設定されている内容が passdb backend に書き込まれるが、 その後 smb\.conf ファイルにあるパラメータの値は、上書きされることがある。 passdb backend への書き込みに際して発生したエラーについては、 適切なツール(コマンドラインツールの pdbedit などのツール)を用いて編集する必要がある。 このパラメータは、Sambaがログオンサーバとして構成された場合のみ、 意味をもつことに注意。 .sp このパラメータの値を空文字列に設定することで、移動プロファイルを無効にすることができる。 logon path = "" のようにすれば良い。 smb\.conf ファイルのデフォルトの値を空文字列にしても、 passdb backend 中のユーザアカウントの設定で何らかの値を指定した場合は、 空文字列の設定を上書きすることになるので注意すること。 移動プロファイルを完全に無効とするには、各ユーザアカウントの設定が空文字列になっている必要がある。 .sp 設定例: .sp .nf logon path = \e\ePROFILESERVER\ePROFILE\e%U .fi .sp デフォルト値: \fB\fIlogon path\fR = \e\e%N\e%U\eprofile \fR .RE .PP logon script (G) .RS 4 このパラメータは、 ユーザのログインが成功した際にダウンロードして実行される、 バッチファイル (\.bat) や Windows NT のコマンドファイル (\.cmd) を指定する。 ファイルは DOS 形式の行末(改行コード) CR/LF でなければならない。 ファイルの作成には DOS 形式のエディタを使うことが推奨される。 .sp スクリプトは \fI[netlogon]\fR サービスからの相対パスで記述する必要がある。 [netlogon] サービスの path が \fI/usr/local/samba/netlogon\fR で、logon script = STARTUP\.BAT の場合、 実際にファイルがダウンロードされるパスは以下のものになる: .sp .nf /usr/local/samba/netlogon/STARTUP\.BAT .fi .sp バッチファイルの中身は自由に記述することが可能である。 推奨されるコマンドとしては、 各マシンを同じタイムサーバの時刻と同期するようにさせる \fBNET TIME \e\eSERVER /SET /YES\fR がある。 ほかには、共通に利用されるユーティリティ用に、例えば \fBNET USE U: \e\eSERVER\eUTILS\fR という設定を行なったり、サンプルとして .sp .nf \fBNET USE Q: \e\eSERVER\eISO9001_QA\fR .fi といった設定を行ったりすることが挙げられる。 .sp [netlogon] 共有に対しては、 バッチファイルが改変されてセキュリティが侵害されてしまわないように、 書き込みアクセスを許可しないか、 安全な環境下でのみバッチファイルへの書き込み権限をユーザに与えるようにすること。 .sp このオプションには、標準の変数置換が適用されるため、 個々のユーザやマシン毎にログオンスクリプトを分けることが可能になる。 .sp このパラメータは、Sambaがログオンサーバとして構成された場合のみ、 意味をもつ。 .sp デフォルト値: \fB\fIlogon script\fR = \fR .sp 設定例: \fB\fIlogon script\fR = scripts\e%U\.bat \fR .RE .PP lppause command (S) .RS 4 このパラメータには、 指定した印刷ジョブの印刷やスプーリングを停止させるためにサーバホスト上で実行されるコマンドを指定する。 .sp このコマンドは、プリンタ名と停止させる印刷ジョブの番号を引数にとり、印刷ジョブを一時停止させるプログラムやスクリプトでなければならない。 これを実装する方法の一つは、非常に低い優先権を持つジョブはプリンタに送られないというジョブの優先権の仕様を利用するものである。 .sp \fI%p\fR 変数は、 プリンタ名に置換される。 \fI%j\fR はジョブ番号(整数)に置換される。 HPUX の場合(\fIprinting=hpux\fRを参照のこと)、 \fI\-p%p\fR オプションを lpq コマンドに付加することで、正しいステータスが表示される。 たとえば、ジョブの優先権が設定されたフェンス優先権より低いならジョブは停止状態であるが、 優先権が等しいかより高いならスプール状態または印刷中の状態となる。 .sp サーバの PATH 環境変数が利用できないかもしれないことを考慮して、 lppause command を絶対パスで記述する癖をつけておくと良い。 .sp デフォルト値: \fB\fIlppause command\fR = # 現在のところデフォルト値は設定されていない。 ただし、\fIprinting\fR パラメータの値が ただし、printing パラメータの値が \fBSYSV\fR の場合は \fBlp \-i %p\-%j \-H hold\fR、 \fBSOFTQ\fR の場合は \fBqstat \-s \-j%j \-h\fR がデフォルト値となる。 \fR .sp 設定例: \fB\fIlppause command\fR = /usr/bin/lpalt %p\-%j \-p0 \fR .RE .PP lpq cache time (G) .RS 4 このパラメータは、 \fBlpq\fR コマンドが頻繁に呼び出されるのを防ぐため、lpr の情報(出力)をキャッシュする期間を制御する。 システムが使用する \fBlpq\fR コマンドの種別毎にキャッシュが行なわれる。そのため、ユーザ毎に異なった \fBlpq\fR コマンドを使用する場合、 キャッシュ情報は共有されない。 .sp キャッシュファイルは \fI/tmp/lpq\.xxxx\fR に保存される。 xxxx は使用している \fBlpq\fR コマンドのハッシュ値となる。 .sp デフォルトは 10 秒であるため、キャッシュされたデータが10秒以内の場合は、 前回行なわれた同一の\fBlpq\fRの実行結果のキャッシュが用いられる。 \fB lpq \fR コマンドのレスポンスが非常に遅い場合は、この値を大きくすることを推奨する。 .sp 値を 0 にした場合、キャッシュは完全に無効となる。 .sp デフォルト値: \fB\fIlpq cache time\fR = 10 \fR .sp 設定例: \fB\fIlpq cache time\fR = 30 \fR .RE .PP lpq command (S) .RS 4 このパラメータには、 \fBlpq\fR形式のプリンタ状態情報を得るため、 サーバ上で実行するコマンドを指定する。 .sp このコマンドは、プリンタ名のみを引数としてとり 、 プリンタ状態情報を出力するプログラムやスクリプトでなければならない。 .sp 現在、BSD、AIX、LPRNG、PLP、SYSV、HPUX、QNX、CUPS、SOFTQ という9つの印刷形式がサポートされており、 これにより大部分の UNIX システムがサポートされる。 \fIprinting =\fR オプションにより、利用する形式を指定することも可能である。 .sp クライアントによっては(特にWindows for Workgroups)、 状態情報を要求しているプリンタの接続番号(connection number)を正しく送らないことがある。 この場合、サーバはクライアントが接続している最初の印刷サービスの状況を報告する。この動作は、 与えられた接続番号が不正な場合にのみ行なわれる。 .sp \fI%p\fR 変数は、 プリンタ名に置換される。この変数が指定されなかった場合、プリンタ名はコマンドの最後に付加される。 .sp サーバの \fB$PATH\fR 環境変数が利用できないかもしれないことを考慮して、 \fIlpq command\fR を絶対パスで記述する癖をつけておくと良い。 CUPS ライブラリを付加してコンパイルした場合は、 smbd が印刷キューのリストを取得するためのライブラリコールを行なうため、 \fIlpq command\fR は必要ない。 .sp デフォルト値: \fB\fIlpq command\fR = \fR .sp 設定例: \fB\fIlpq command\fR = /usr/bin/lpq \-P%p \fR .RE .PP lpresume command (S) .RS 4 このパラメータには、 特定の印刷ジョブの印刷やスプールを再開したり続行するためにサーバ上で実行するコマンドを指定する。 .sp このコマンドは、 プリンタ名とジョブ番号を受け取るとその印刷ジョブを再開するプログラムやスクリプトでなければならない。 lppause command パラメータも参照のこと。 .sp \fI%p\fR 変数は、 プリンタ名に置換される。 \fI%j\fR はジョブ番号(整数)に置換される。 .sp サーバの PATH 環境変数が利用できないかもしれないことを考慮して、 \fIlpresume command\fR を絶対パスで記述することを推奨する。 .sp printing パラメータも参照のこと。 .sp デフォルト: 現在のところ、この設定のデフォルト値は設定されていない。 ただし、\fIprinting\fR パラメータの値が \fBSYSV\fR の場合、 デフォルト値は以下の通り: .sp \fBlp \-i %p\-%j \-H resume\fR .sp また、\fIprinting\fR パラメータの値が \fBSOFTQ\fR の場合、デフォルト値は以下の通り: .sp \fBqstat \-s \-j%j \-r\fR .sp デフォルト値: \fB\fIlpresume command\fR = lpresume command = /usr/bin/lpalt %p\-%j \-p2 \fR .RE .PP lprm command (S) .RS 4 このパラメータには、 印刷ジョブを削除するためにサーバ上で実行するコマンドを指定する。 .sp このコマンドは、 プリンタ名とジョブ番号を受け取るとその印刷ジョブを削除するプログラムやスクリプトでなければならない。 .sp \fI%p\fR 変数は、 プリンタ名に置換される。 \fI%j\fR はジョブ番号(整数)に置換される。 .sp サーバの PATH 環境変数が利用できないかもしれないことを考慮して、 \fIlprm command\fR を絶対パスで記述することを推奨する。 .sp 以下に設定例を示す。 .sp .nf lprm command = /usr/bin/lprm \-P%p %j あるいは lprm command = /usr/bin/cancel %p\-%j .fi .sp デフォルト値: \fB\fIlprm command\fR = printing パラメータの設定に依存する \fR .RE .PP machine password timeout (G) .RS 4 Sambaサーバが NT ドメインのメンバである場合 (security = domainパラメータを参照のこと) 、 実行中の smbd プロセスは、\fIprivate/secrets\.tdb\fR という TDB ファイルに格納されたコンピュータアカウントのパスワードを定期的に変更しようとする。 このパラメータは、パスワードの変更を行なう間隔を秒単位で設定する。デフォルトは、NT ドメインのメンバサーバと同じく 1 週間 (秒単位で表される) である。 .sp \fBsmbpasswd\fR(8) および security = domain パラメータも参照のこと。 .sp デフォルト値: \fB\fImachine password timeout\fR = 604800 \fR .RE .PP magic output (S) .RS 4 このパラメータは、Magic スクリプト(下記の magic script パラメータを参照) によって生成される出力結果が書き込まれるファイルの名前を指定する。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Warning 複数のクライアントが同じ \fIMagic スクリプト\fR を同じディレクトリで利用する場合、 出力ファイルの内容は不定になる。 デフォルト値: \fB\fImagic output\fR = \.out \fR .sp 設定例: \fB\fImagic output\fR = myfile\.txt \fR .RE .PP magic script (S) .RS 4 このパラメータで指定したファイルは、 ファイルをオープン後クローズした時点でサーバにより実行される。 このパラメータにより、UNIX のスクリプトを Samba ホストに送って、 接続しているユーザの権限で実行する機能が提供される。 .sp このようにして実行されたスクリプトは、 ユーザに削除する権限があり、ファイルが削除可能であれば、 実行完了と同時に削除される。 .sp スクリプトが生成した出力は、 magic output パラメータ(前述)で指定されたファイルに書き込まれる。 .sp シェルによっては、改行コードとして CR ではなく CR/LF を利用しているスクリプトをうまく実行できないことに注意。 Magic スクリプトはホスト上で\fBそのまま\fR実行されるため、ホストやシェルによっては、 DOS の改行コードを修正しておく必要があるかも知れない。 .sp Magic スクリプトは \fB 実験用 \fR のパラメータであり、このパラメータを安全だと考えるべきでは \fBない\fR。 .sp デフォルト値: \fB\fImagic script\fR = \fR .sp 設定例: \fB\fImagic script\fR = user\.csh \fR .RE .PP mangled map (S) .RS 4 このパラメータは、 Windows や DOS で表示できない UNIX ファイル名の対応づけを直接指定するためのものである。 名前の短縮のみがこの機能に必要とされるすべてではない。 実際、DOS と UNIX とでファイル名の拡張子の異なるドキュメントが存在することがある。 一例を挙げると、UNIX では通常 HTML ファイルを示す拡張子として \fI\.html\fR が使用されるが、DOS では \fI\.htm\fR の方が一般的である。 .sp このため、\fIhtml\fR と \fIhtm\fR の対応づけを行なう場合は、以下のようにする: .sp mangled map = (*\.html *\.htm)\. .sp とても便利な利用方法の一つに、CDROMによってファイル名の末尾に付加されている \fI;1\fR(幾つかのUNIX上でのみ表示される) の削除が挙げられる。これを行なうためには、 (*;1 *;) のように指定すればよい。 .sp デフォルト値: \fB\fImangled map\fR = # mangled map なし \fR .sp 設定例: \fB\fImangled map\fR = (*;1 *;) \fR .RE .PP mangled names (S) .RS 4 このパラメータは、 UNIX 上の DOS非互換のファイル名をDOS互換の名前(「短縮名」)に短縮してアクセス可能にするか、 単純に無視するかどうかを制御する。 .sp 短縮処理がどのように行なわれているかについての詳細は、 name mangling セクションを参照のこと。 .sp 短縮が行なわれる場合のアルゴリズムは以下の通りである(訳注:以下は hash アルゴリズムの場合): .sp .RS 4 \h'-04'?\h'+03'ファイル名の先頭から一番右にあるドットの前までの英数5文字は、 大文字に変換された上で、 短縮名の先頭5文字となる。 .RE .sp .RS 4 \h'-04'?\h'+03'チルダ「~」が短縮名に付加される。 更に元々のファイル名のベース部分(ファイル名から拡張子部分を除いたもの)から生成された一意な2文字が付加される。 拡張子にあたる部分は、大文字を含んでいるか、 3文字以上の場合のみ、ハッシュの計算に含まれる。 .sp 「~」の利用を避けたい場合は、 mangling char オプションにより、別の文字を指定することも可能である。 .RE .sp .RS 4 \h'-04'?\h'+03'UNIX 上のファイル名がドットから始まる場合、 そのファイルは DOS の隠しファイルとして扱われる。 この場合の短縮名は、ファイル名の先頭のドットを取り除き、 実際の拡張子に関わらず、拡張子「___(「_」3文字」を付加したものから、一般のファイル名と同様にして生成する。 .RE .IP "" 4 2桁のハッシュ値は、大文字の英数文字になる。 .sp このアルゴリズムは、 ディレクトリ内のファイルに先頭の英数 5 文字が同一のファイル名が存在する時のみ名前の衝突が発生するが、 実際に衝突する確率は、1/1300 である。 .sp 名前の短縮処理により、(この処理が有効な限り) Windows や DOS から、UNIX 側の長いファイル名を保持したまま UNIX ディレクトリ間のファイルのコピーができる。 Windows や DOS 側から UNIX 側のファイル名の拡張子を変更しても、ベース名は保持される。 なお、セッションが異なっても短縮名は変化しない。 .sp デフォルト値: \fB\fImangled names\fR = yes \fR .RE .PP mangle prefix (G) .RS 4 短縮名を生成する際に、元々の名前に付加するプレフィックスの長さを指定する。 大きな値を指定すると、 ハッシュアルゴリズムの効果が低下し、 名前の衝突の可能性が高まる。 最小値は 1 であり、最大は 6 である。 .sp mangle prefix は mangling method が hash2 の時のみ有効である。 .sp デフォルト値: \fB\fImangle prefix\fR = 1 \fR .sp 設定例: \fB\fImangle prefix\fR = 4 \fR .RE .PP mangling char (S) .RS 4 このパラメータは name mangling において、 \fBmagic\fR キャラクタとして利用される文字を指定する。デフォルトは「~」であるが、 ソフトウェアによっては問題が発生してしまうかも知れない。 このオプションにより、任意の文字を指定することが可能になる。 このパラメータは mangling method が hash の時のみ有効である。 .sp デフォルト値: \fB\fImangling char\fR = ~ \fR .sp 設定例: \fB\fImangling char\fR = ^ \fR .RE .PP mangling method (G) .RS 4 短縮名を生成する際に利用するアルゴリズムを指定する。 「hash」と「hash2」という2つの値を指定することが可能である。 「hash」は Samba 2\.2\.x でのデフォルト値であり、長年 Samba で利用されてきた方式である。 「hash2」は新しい方式であり、現在のデフォルト値である。これは、 (名前の重複の発生が低減される点で)より優れたアルゴリズムといえる。 Win32 アプリケーションの多くが短縮名を記憶しているため、 新しいアルゴリズムへの変更は、 こうしたアプリケーションの再インストールが必要になる可能性があるという点で、安易に行なうべきではない。 .sp デフォルト値: \fB\fImangling method\fR = hash2 \fR .sp 設定例: \fB\fImangling method\fR = hash \fR .RE .PP map acl inherit (S) .RS 4 この真偽値パラメータにより、 \fBsmbd\fR(8) は Windows の ACL に格納される「inherit」および「protected」の ACE フラグを user\.SAMBA_PAI (訳注: Samba_Posix_Acl_Inheritance) と呼ばれる拡張属性にマッピングすることが可能となる。 このパラメータは Samba が拡張属性をサポートしているプラットフォーム(Linux および IRIX など)で実行されており、Windows 2000 の ACL エディタから Samba 側の POSIX ACL とのマッピングを実現するコードで継承を適切に設定できる場合のみ、有効となる。 .sp デフォルト値: \fB\fImap acl inherit\fR = no \fR .RE .PP map archive (S) .RS 4 このパラメータは、DOSのアーカイブ属性を UNIXの所有者(owner)実行権ビットに割り当てるかどうかを決定する。 DOSのアーカイブ属性は、バックアップを行なった後でファイルが修正されると設定される。 このオプションを変更する契機の一つは、Samba マシン上のファイルを修正した際に、UNIX 上で実行可能になってしまわないようにしたい場合であろう。 これは、共有のソースコードやドキュメントなどに関して、非常に悩ましい事象である。 .sp このパラメータを利用する場合は、 所有者の実行権ビットがマスクされないように(100というアクセス権が含まれるように)、 create mask パラメータを設定することが必要となることに注意。 詳細は、create mask パラメータを参照のこと。 .sp デフォルト値: \fB\fImap archive\fR = yes \fR .RE .PP map hidden (S) .RS 4 このパラメータは、DOSの隠しファイル属性を UNIXの全員(world)の実行権ビットに割り当てるかどうかを決定する。 .sp このパラメータを利用する場合は、 全体の実行権ビットがマスクされないように(001というアクセス権を含むように)、 create mask パラメータを設定することが必要となることに注意。 詳細は、create mask パラメータを参照のこと。 .sp \fBデフォルト値なし\fR .RE .PP map read only (S) .RS 4 このパラメータは、DOS の読みとり専用属性を UNIX のファイルシステムに対応付ける方法を制御する。 .sp このパラメータには 3 とおりの値を指定することが可能である。これにより、 store dos attributes が \fBNo\fR、もしくは拡張属性が存在しない環境において、 \fBsmbd\fR(8) がファイルの読みとり専用属性を表示する方法を制御することが可能である。 store dos attributes が \fByes\fR の場合、このパラメータは\fB無視される\fR。 これは Samba 3\.0\.21 で新設されたパラメータである。 .sp 3 とおりの値を以下に示す: .sp .RS 4 \h'-04'?\h'+03' \fBYes\fR \- 読みとり専用の DOS 属性は、UNIX のパーミッションビットにおけるユーザ、すなわち所有者の書き込み権ビットに対応付けられる。 所有者の書き込み権ビットが設定されていない場合、ファイルには読みとり専用属性が付加されているものとみなされる。 .RE .sp .RS 4 \h'-04'?\h'+03' \fBPermissions\fR \- 読みとり専用の DOS 属性は、接続しているユーザに対する有効なパーミッションに対応付けられる。 これは、\fBsmbd\fR(8) が UNIX のパーミッションおよび (存在していれば) POSIX の ACL を読みとることにより確認される。 接続しているユーザにファイルを編集するパーミッションがない場合、ファイルには読みとり専用属性が付加されているものとみなされる。 .RE .sp .RS 4 \h'-04'?\h'+03' \fBNo\fR \- 読みとり専用 DOS 属性は、パーミッションに対応付けられず、 store dos attributes パラメータによってのみ付与される。 これは、マウント中の CD を共有する場合にも便利かも知れない。 .RE .IP "" 4 デフォルト値: \fB\fImap read only\fR = yes \fR .RE .PP map system (S) .RS 4 このパラメータは、DOSのシステムファイル属性を UNIXのグループ実行権ビットに割り当てるかどうかを決定する。 .sp このパラメータを利用する場合は、 グループ実行権ビットがマスクされないように(010というアクセス権を含むように)、 create mask パラメータを設定することが必要となることに注意。 詳細は、create mask パラメータを参照のこと。 .sp デフォルト値: \fB\fImap system\fR = no \fR .RE .PP map to guest (G) .RS 4 このパラメータは、SECURITY = security モードが \fIsecurity = share\fR 以外の時、すなわち \fBuser\fR、\fBserver\fR、 \fBdomain\fR のときにのみ有用である。 .sp このパラメータの値には、 \fBsmbd\fR(8) が 何らかの方法で有効なUNIXユーザとして認証されなかったユーザのログイン要求をどのように扱うかを指定するための 4 つの値のいずれかを設定することが可能である。 .sp 4 つの値を以下に示す: .sp .RS 4 \h'-04'?\h'+03'\fBNever\fR \- 不正なパスワードによるユーザのログイン要求を拒否する。 これがデフォルトである。 .RE .sp .RS 4 \h'-04'?\h'+03'\fBBad User\fR \- 存在するユーザに対する不正なパスワードによるログイン要求は拒否する。 指定されたユーザが存在しなかった場合はゲストログインとして扱い、 guest account で指定されたアカウントにマッピングする。 .RE .sp .RS 4 \h'-04'?\h'+03'\fBBad Password\fR \- 不正なパスワードによるユーザのログイン要求は、ゲストログインとして扱い、 guest account で指定されたアカウントにマッピングする。 この場合、パスワードをタイプミスすると、 なにも言われずに「guest」としてログインしてしまう。 パスワードをタイプミスしたというメッセージがないため、 アクセス可能である筈のファイルにできないが理由がわからないという問題が発生する。 \fImap to guest\fR パラメータをこの設定にすると、 ヘルプディスクサービスからは \fB憎まれる\fR ことになるだろう:\-)。 .RE .sp .RS 4 \h'-04'?\h'+03'\fBBad Uid\fR \- これは、Sambaがドメインモードのセキュリティ (security = {domain|ads}) で構成されている環境でのみ意味を持つ。 この環境において、認証が成功したにも関わらず UNIX側のユーザアカウントが存在しない (smbdが作成することもできない) 場合に、定義されたゲストアカウントへのマッピングを行う。これは Samba 2\.2 系列におけるデフォルトの挙動である。 メンバサーバで winbindd が実行されている場合、nss_winbind ライブラリが Windows ドメインのユーザやグループを NSS インタフェース経由で Samba を実行する OS に対して提供するため、このパラメータが必要となる事態は発生し得ない。 .RE .IP "" 4 \fIsecurity\fR モードが share 以外の場合、「ゲスト」共有サービスを設定する場合は、 このパラメータが必須である。これは、サーバがクライアントの認証に成功しない限り、 要求されるリソースの名前がサーバに送られることは\fB決して\fRなく、 サーバが「ゲスト」共有に対する認証の成否を、 適切な時点(共有への接続時)に行なうことができないためである。 .sp 以前の Samba のリリースに親しんでいる人のため、 このパラメータは、local\.h 中の \fBGUEST_SESSSETUP \fR というコンパイル設定に対応づけられている。 .sp デフォルト値: \fB\fImap to guest\fR = Never \fR .sp 設定例: \fB\fImap to guest\fR = Bad User \fR .RE .PP max connections (S) .RS 4 このオプションにより、サービスへの同時コネクション数が制限される。 \fImax connections\fR が 0 より大きい場合、すでにオープンされているサービスに対するコネクション数がこの数に達していると、それ以上の接続が拒否される。値が 0 の場合は、コネクション数は無制限であることを意味する。 .sp レコードロックファイルが、この機能の実装に利用されている。ロッ クファイルは、 lock directory オプションで指定されたディレクトリに保存される。 .sp デフォルト値: \fB\fImax connections\fR = 0 \fR .sp 設定例: \fB\fImax connections\fR = 10 \fR .RE .PP max disk size (G) .RS 4 このオプションにより、見かけ上のディスクの容量の上限を設定することができる。このオプションを 100 に設定すると、すべての共有は 100MB 以上の容量に見えることはない。 .sp このオプションは、ディスクに置くことができるデータの容量を制限するものではないことに注意。前述した設定を行なった場合でも、 100MB を越える容量をディスクに書き込むことは可能であるが、クライアントがディスクの空き容量や総ディスクサイズを求めると、結果は \fImax disk size\fR で指定された量に制限されることになる。 .sp このオプションは、主として非常に大きいディスク、特に 1GB を越えるサイズをもつディスクを扱えないソフトウェアのバグを回避する際に有用である。 .sp \fImax disk size\fR パラメータが 0 の場合は、無制限を意味する。 .sp デフォルト値: \fB\fImax disk size\fR = 0 \fR .sp 設定例: \fB\fImax disk size\fR = 1000 \fR .RE .PP max log size (G) .RS 4 このオプション(キロバイト単位の数値)は、 ログファイルの最大サイズを指定する。 Samba は定期的にログファイルのサイズを調べ、 最大値を超過した場合は、ファイルの拡張子に \fI\.old\fR を付加した名前にファイル名を変更する。 .sp サイズ 0 は無制限を意味する。 .sp デフォルト値: \fB\fImax log size\fR = 5000 \fR .sp 設定例: \fB\fImax log size\fR = 1000 \fR .RE .PP max mux (G) .RS 4 このオプションは、 Samba がクライアントに通知する同時に実行可能な SMB オペレーションの最大数を制御する。 このパラメータを設定する必要はないであろう。 .sp デフォルト値: \fB\fImax mux\fR = 50 \fR .RE .PP max open files (G) .RS 4 このパラメータにより、ある \fBsmbd\fR(8) プロセスが1つのクライアントに対して同時に開くことのできるファイル数の上限値が設定される。 Samba は、オープンされていないファイルごとにわずか 1 ビットしか消費しないので、このパラメータのデフォルト値は、非常に大きな値 (10000) に設定されている。 .sp オープンするファイルの数の制限は、通常このパラメータではなく UNIX におけるプロセス毎のファイルディスクリプタの上限値によって制限される。そのため、この値を変更する必要はないであろう。 .sp デフォルト値: \fB\fImax open files\fR = 10000 \fR .RE .PP max print jobs (S) .RS 4 このパラメータにより、 ある時点で Samba の印刷キューに蓄積可能なジョブの最大数が設定される。 設定数を超過すると、 \fBsmbd\fR(8) は、 クライアントに「空き領域がない」というエラーを返却する。 .sp デフォルト値: \fB\fImax print jobs\fR = 1000 \fR .sp 設定例: \fB\fImax print jobs\fR = 5000 \fR .RE .PP protocol .RS 4 このパラメータは、max protocolの別名である。 .RE .PP max protocol (G) .RS 4 このパラメータ(文字列)の値は、 サーバがサポートする最上位のプロトコルである。 .sp 設定可能な値は以下の通りである: .sp .RS 4 \h'-04'?\h'+03'\fBCORE\fR: 最初期のもので、ユーザの概念がない .RE .sp .RS 4 \h'-04'?\h'+03'\fBCOREPLUS\fR: ほんの少し CORE に手を加えたものである .RE .sp .RS 4 \h'-04'?\h'+03'\fBLANMAN1\fR: 最初の \fB 近代的な\fR バージョンであり、 長いファイル名をサポートしている .RE .sp .RS 4 \h'-04'?\h'+03'\fBLANMAN2\fR: LANMAN1 プロトコルを改良したものである .RE .sp .RS 4 \h'-04'?\h'+03'\fBNT1\fR: 最も新しいプロトコルであり、 Windows NT が利用する。CIFSと呼ばれることもある。 .RE .IP "" 4 通常、SMB プロトコルによりネゴシエーションを経て適切なプロトコルが選択されるため、 このオプションを設定すべきではない。 .sp デフォルト値: \fB\fImax protocol\fR = NT1 \fR .sp 設定例: \fB\fImax protocol\fR = LANMAN1 \fR .RE .PP max reported print jobs (S) .RS 4 このパラメータにより、ある時点で Samba の印刷キューのポートモニタが表示する印刷ジョブの最大数が設定される。 この数値を超過した場合、超過したジョブは表示されない。 0 が設定された場合は、表示される印刷ジョブの制限はなくなる。 .sp デフォルト値: \fB\fImax reported print jobs\fR = 0 \fR .sp 設定例: \fB\fImax reported print jobs\fR = 1000 \fR .RE .PP max smbd processes (G) .RS 4 このパラメータは、システムで同時に実行可能な \fBsmbd\fR(8) プロセス数の最大値を設定することで、コネクションを扱うリソースが不足して、クライアントに対するサービスが低下することを抑止する。通常の環境では、各ユーザ毎に \fBsmbd\fR(8) が割り当てられ、そのホストからの共有に対するコネクションのすべてを扱うことに注意。 .sp デフォルト値: \fB\fImax smbd processes\fR = 0 \fR .sp 設定例: \fB\fImax smbd processes\fR = 1000 \fR .RE .PP max stat cache size (G) .RS 4 このパラメータにより、大文字小文字を区別しない名前の対応づけの高速化に用いられる \fIstat cache\fR に用いられるメモリの上限値が指定される。 このパラメータには、使用する stat cache のサイズをキロバイト (1024) 単位で指定する。 デフォルト値は 0 であり、無制限を意味する。 このパラメータを変更する必要はないであろう。 .sp デフォルト値: \fB\fImax stat cache size\fR = 0 \fR .sp 設定例: \fB\fImax stat cache size\fR = 1024 \fR .RE .PP max ttl (G) .RS 4 このオプションは、 \fBnmbd\fR(8) がブロードキャストを利用したりWINSサーバを利用したりして NetBIOS 名を要求する際の NetBIOS 名のデフォルトのTTL(time to live)を(秒単位で)設定する。 このパラメータを変更する必要はないであろう。 デフォルトは3日である。 .sp デフォルト値: \fB\fImax ttl\fR = 259200 \fR .RE .PP max wins ttl (G) .RS 4 このオプションは、 \fBsmbd\fR(8) が WINS サーバとして動作している (wins support = yes) \fBnmbd\fRに登録される NetBIOS 名の最大のTTL(time to live)を秒単位で指定する。 このパラメータを変更する必要はないであろう。 デフォルトは6日(518400秒)である。 .sp デフォルト値: \fB\fImax wins ttl\fR = 518400 \fR .RE .PP max xmit (G) .RS 4 このオプションにより、 Samba がネゴシエーション時に用いるパケットサイズの最大値が設定される。 デフォルトは 16644 であり、これは Windows 2000 の挙動に合わせた値である。 2048 以下ではおそらく問題が出るだろう。 このパラメータの値をデフォルトから変更する必要はないだろう。 .sp デフォルト値: \fB\fImax xmit\fR = 16644 \fR .sp 設定例: \fB\fImax xmit\fR = 8192 \fR .RE .PP message command (G) .RS 4 このパラメータは、サーバが WinPopup 形式のメッセージを受信した際に、どのようなコマンドを実行するかを指定する。 .sp 一般的には、 何らかの形でメッセージを配送するコマンドを指定する。 これをどのようにして行なうかは、発想次第である。 .sp 以下に一例を示す: .sp .nf \fBmessage command = csh \-c \'xedit %s;rm %s\' &\fR .fi .sp これは、 \fBxedit\fRを利用してメッセージを配送し、 その後メッセージを削除する。\fB コマンドは、 すぐに制御を戻すようにすることが必須であることに注意すること\fR。 最後に \'&\' をつけたのは、そのためである。 コマンドを実行後すぐに制御が戻らないと、PC はメッセージ送信後フリーズしてしまう(うまくいけば、30 秒後に回復することになるだろう)。 .sp 全てのメッセージは、グローバルなゲストユーザの権限で配送される。 コマンド中では、標準の変数を利用できるが、 \fI%u\fR は機能しない(\fI%U\fR を利用するのが適切であろう)。 .sp 標準の変数以外に、 以下に示す変数を利用することが可能である: .sp .RS 4 \h'-04'?\h'+03'\fI%s\fR = メッセージを含むファイル名 .RE .sp .RS 4 \h'-04'?\h'+03'\fI%t\fR = メッセージの送信先(通常はサーバ名) .RE .sp .RS 4 \h'-04'?\h'+03'\fI%f\fR = メッセージの送り元のユーザ .RE .IP "" 4 このコマンドにより、 メールを送るなど、さまざまな動作が考えられる。 おもしろいアイデアを思いついたら教えて欲しい。 .sp 以下はメッセージをrootへのメールとして送信する方法である: .sp .nf \fBmessage command = /bin/mail \-s \'message from %f on %m\' root < %s; rm %s\fR .fi .sp message command が指定されていない場合、 メッセージは配送されず、Sambaは送信者にエラーの発生を通知する。 ただし、WfWg はエラーコードを無視して配送を行ない、 メッセージの配送を報告する。 .sp メッセージを単に削除したい場合は、以下のように設定すること: .sp .nf \fBmessage command = rm %s\fR .fi .sp デフォルト値: \fB\fImessage command\fR = \fR .sp 設定例: \fB\fImessage command\fR = csh \-c \'xedit %s; rm %s\' & \fR .RE .PP min print space (S) .RS 4 ユーザの印刷ジョブをスプールする際に利用可能でなければならない空きディスクスペースの最小容量を設定する。この値はキロバイト単位で指定する。デフォルトは 0 で、この場合、ユーザは常に印刷ジョブをスプールできる。 .sp デフォルト値: \fB\fImin print space\fR = 0 \fR .sp 設定例: \fB\fImin print space\fR = 2000 \fR .RE .PP min protocol (G) .RS 4 このパラメータの値(文字列)は、 Sambaがサポートする最低限のSMBプロトコルの dialect(レベル) を指定する。 有効なプロトコル名の一覧と、その簡単な説明については、 max protocol パラメータを参照のこと。クライアントがサポートするプロトコルの dialect 一覧については、 \fIsource/smbd/negprot\.c\fR の Cソースを参照するとよいであろう。 .sp セキュリティ的な観点では、 lanman auth パラメータも参照のこと。 それ以外の観点からこのパラメータを変更する必要はないであろう。 .sp デフォルト値: \fB\fImin protocol\fR = CORE \fR .sp 設定例: \fB\fImin protocol\fR = NT1 \fR .RE .PP min wins ttl (G) .RS 4 このオプションは、 \fBnmbd\fR(8) がWINSサーバとして動作している時に (wins support = yes)、 \fBnmbd\fR に登録された NetBIOS 名の最小の TTL (time to live)を秒単位で指定する。 このパラメータを変更する必要はないであろう。 デフォルトは6時間(21600秒)である。 .sp デフォルト値: \fB\fImin wins ttl\fR = 21600 \fR .RE .PP msdfs proxy (S) .RS 4 このパラメータは、この共有がパラメータで指定された別の CIFS 共有をプロキシする共有であることを指定する。 この共有に接続したクライアントは、 SMB の DFS プロトコルにより、別の共有に転送される。 .sp DFS ルートのみがプロキシする共有として機能できる。 DFS ルートの共有を設定する方法については、 msdfs root および host msdfs オプションを参照のこと。 .sp \fBデフォルト値なし\fR .sp 設定例: \fB\fImsdfs proxy\fR = \eotherserver\esomeshare \fR .RE .PP msdfs root (S) .RS 4 \fByes\fRに設定された場合、 Samba はその共有を DFS ルートとして扱うため、クライアントは、その共有ディレクトリをルートとする DFS (分散ファイルシステム)ツリーを参照することが可能になる。 DFS リンクの作成は、共有ディレクトリ内で \fImsdfs:serverA\e\eshareA,serverB\e\eshareB\fR のような形式でシンボリックリンクを作成することにより行なわれる。 DFS ツリーを Samba で構成する際の詳細情報については、 Samba3\-HOWTO の MSDFS の章を参照のこと。 .sp デフォルト値: \fB\fImsdfs root\fR = yes \fR .RE .PP name cache timeout (G) .RS 4 Samba のホスト名キャッシュ内のエントリがタイムアウトするまで時間を秒単位で指定する。タイムアウトが 0 に設定された場合、キャッシュは無効になる。 .sp デフォルト値: \fB\fIname cache timeout\fR = 660 \fR .sp 設定例: \fB\fIname cache timeout\fR = 0 \fR .RE .PP name resolve order (G) .RS 4 このオプションは、どの名前サービスを用いて、またどのような順番で、 ホスト名から IP アドレスを解決するかを決定するため、 Samba の各プログラムで利用される。 このオプションの主な目的は、NetBIOS 名前解決をどのように行なうかを指定することである。 オプションは、名前解決オプションをスペースで区切った文字列で指定する。 .sp オプションは、「lmhosts」、「host」、「wins」、「bcast」である。 これらは以下に示すように名前解決を実行する: .sp .RS 4 \h'-04'?\h'+03'\fBlmhosts\fR : Samba の lmhosts ファイルから IP アドレスを検索する。 NetBIOS 名サフィックスの指定されていない行が lmhosts ファイル中にあった場合、 (詳細は、lmhosts ファイルのマニュアルページを参照のこと)、 その行はすべてのサフィックスの検索にマッチする。 .RE .sp .RS 4 \h'-04'?\h'+03'\fBhost\fR : システム標準の方法で、\fI/etc/hosts \fR、 NIS 、 DNS への問い合わせを行ない、 ホスト名から IP アドレスへの名前解決を行なう。 名前解決の方法は、OSに依存する。 IRIX や Solaris の場合、 \fI/etc/nsswitch\.conf\fR ファイルにより制御される。この方法は、問い合わせされた NetBIOS のサフィックスが 0x20(サーバ) か 0x1c(ドメインコントローラ) の時のみ利用され、それ以外は無効であることに注意。 後者は、アクティブディレクトリドメインでのみ有効である。 この場合、_ldap\._tcp\.domain に対応する　SRV RR エントリを検索するための DNS クエリが行われる。 .RE .sp .RS 4 \h'-04'?\h'+03'\fBwins\fR : WINSSERVER パラメータで指定された IP アドレスに対して名前の問い合わせが行なわれる。 WINS サーバが指定されていない場合、この方法は無視される。 .RE .sp .RS 4 \h'-04'?\h'+03'\fBbcast\fR : interfaces パラメータで設定された各インタフェースに対してブロードキャストが実行される。 これは解決したいホストがローカルサブネットに接続されていることを前提とするため、 もっとも信頼性の低い名前解決の方法である。 .RE .IP "" 4 以下の例では、最初にローカルの lmhosts ファイルを調査し、 次にブロードキャストを行ない、 最後にシステム標準のホスト名検索を試行する。 .sp Samba が ADS セキュリティモード (\fBsecurity = ads\fR) で動作する場合、 \fIname resolve order\fR の設定は次のようにすべきである: .sp \fBname resolve order = wins bcast\fR .sp この 場合でも、DC は DNS への問い合わせを行なう。 失敗した場合に NetBIOS 名の問い合わせを行なうが、その際無意味な DNS への「DOMAIN<0x1c>」の問い合わせが抑止される。 .sp デフォルト値: \fB\fIname resolve order\fR = lmhosts host wins bcast \fR .sp 設定例: \fB\fIname resolve order\fR = lmhosts bcast host \fR .RE .PP netbios aliases (G) .RS 4 これは、nmbdが Samba サーバの別名としてアナウンスする NetBIOS 名のリストである。これにより、ブラウズリスト中で単一のマシンを複数の名前で表示させることが可能になる。 マシンがブラウズサーバやログオンサーバとして動作している場合、別名はブラウズサーバやログオンサーバとしてはアナウンスされない。マシン本来の名前だけがそれらの機能をもつ名前としてアナウンスされる。 .sp デフォルト値: \fB\fInetbios aliases\fR = # 空文字列 (別名なし) \fR .sp 設定例: \fB\fInetbios aliases\fR = TEST TEST1 TEST2 \fR .RE .PP netbios name (G) .RS 4 このパラメータにより、 Samba サーバの NetBIOS 名が設定される。デフォルトでは、ホストの DNS 名の最初の部分と同一である。マシンがブラウズサーバや、ログオンサーバの場合、ここで設定された名前 (またはホストのDNS名の最初の部分)がサービスをアナウンスする際に用いられる。 .sp Samba 3\.0 には、NetBIOS が PIPE に設定されるとブラウジングや共有へのアクセスに問題が発生するというバグがある。 この問題を避けるためには、Samba 3\.0 マシンの名前を PIPE にしないこと。 .sp デフォルト値: \fB\fInetbios name\fR = # マシンの DNS 名 \fR .sp 設定例: \fB\fInetbios name\fR = MYNAME \fR .RE .PP netbios scope (G) .RS 4 このパラメータにより、 Samba が使用する NetBIOS スコープを設定される。LAN上のすべてのマシンに同じ値を設定しない限り、このパラメータを設定すべきではない。 .sp デフォルト値: \fB\fInetbios scope\fR = \fR .RE .PP nis homedir (G) .RS 4 NIS マップから、[home] 共有を提供するサーバを取得する。 automounter を使用する UNIX システムでは、 ユーザのホームディレクトリが、必要に応じてリモートサーバから ワークステーションにマウントされるようになっていることが多い。 .sp Samba のログオンサーバが実際のホームディレクトリを提供するサーバではなく、 NFS経由でホームディレクトリをマウントしている場合、 クライアントに自分自身がホームディレクトリを提供する SMB サーバであるように見せると、 ユーザがホームディレクトリにアクセスするためには、 二段階のネットワークアクセスが必要になる(1つは SMB で、もう 1 つは NFS)。 これはとても遅くなることがある。 .sp このオプションにより、 Samba は home 共有がログオンサーバとは異なるサーバにあるものとして扱うことが可能になり、 Samba デーモンがホームディレクトリを提供するサーバで動作している限り、 Samba クライアントは、ホームディレクトリを提供しているサーバ上の共有を直接マウントする。 Samba が home 共有の情報をクライアントに返すとき、 homedir map パラメータ で指定された NIS マップに問い合わせて、そこにあるサーバの情報を利用する。 .sp このオプションが機能するためには、NIS システムが動いていなければならず、 このオプションを指定した Samba サーバは、 ログオンサーバでなければならないことに注意すること。 .sp デフォルト値: \fB\fInis homedir\fR = no \fR .RE .PP nt acl support (S) .RS 4 この真偽値パラメータにより、 \fBsmbd\fR(8) が UNIX のパーミッションを Windows NT のアクセスコントロールリストにマップするかどうかが決定される。 対象となる UNIX のパーミッションは、 ファイルやディレクトリに設定された伝統的な UNIX の所有者とグループのパーミッションと POSIX ACL である。 このパラメータは、Samba 2\.2\.2 より前のリリースでは、グローバルパラメータであった。 .sp デフォルト値: \fB\fInt acl support\fR = yes \fR .RE .PP ntlm auth (G) .RS 4 このパラメータにより、\fBsmbd\fR(8) が NTLM レスポンスを用いてユーザ認証を行なうかどうかが設定される。NTLM レスポンスが無効な場合、クライアントは LANMAN パスワードハッシュか NTLMv2 レスポンスを送信する必要がある。 .sp このオプションと \fBlanman auth\fR の両方を無効にした場合、NTLMv2 ログインのみが可能となる。すべてのクライアントが NTLMv2 をサポートしているわけではなく、ほとんどの場合、NTLMv2 を使用するためには、明示的に設定を行なうことが必要である。 .sp デフォルト値: \fB\fIntlm auth\fR = yes \fR .RE .PP nt pipe support (G) .RS 4 この真偽値パラメータにより、 \fBsmbd\fR(8) が Windows NT のクライアントに対して、 Windows NT の SMB 固有の \fBIPC$\fR パイプへの接続を許可するかどうかが制御される。 これは開発者のデバッグオプションであり、意識する必要はない。 .sp デフォルト値: \fB\fInt pipe support\fR = yes \fR .RE .PP nt status support (G) .RS 4 この真偽値パラメータは、 \fBsmbd\fR(8) が、 Windows NT/2000/XP クライアントに対して、 NT 固有のステータスのサポートのネゴシエーションを行なうかどうかを制御する。 これは、開発者のデバッグ用オプションであり、設定を変更すべきではない。 このオプションが \fBno\fR の場合、 Samba は Samba 2\.2\.3 以前と全く同様に、DOS エラーコードを返却する。 .sp このオプションを無効にしてはならない。 .sp デフォルト値: \fB\fInt status support\fR = yes \fR .RE .PP null passwords (G) .RS 4 Nullパスワードを持つアカウントへのクライアントからのアクセスを許可、あるいは禁止する。 .sp \fBsmbpasswd\fR(5) も参照のこと。 .sp デフォルト値: \fB\fInull passwords\fR = no \fR .RE .PP obey pam restrictions (G) .RS 4 PAMサポートを有効にして(\-\-with\-pam) configure された Samba 3\.0 系列において、このパラメータは、Samba が PAM のアカウントとセッション管理機構を利用するかどうかを制御する。 デフォルトの場合、 PAM は平文テキスト認証にのみ利用され、 アカウントとセッション管理は利用されない。 encrypt passwords = yes の場合、Sambaは常に PAM による認証を無視することに気を付けること。 これは、PAMモジュールが、 SMBのパスワード暗号化に必要なチャレンジアンドレスポンス認証機構をサポートしていないためである。 .sp デフォルト値: \fB\fIobey pam restrictions\fR = no \fR .RE .PP only user (S) .RS 4 この真偽値のオプションは、\fIuser\fR パラメータに設定されていないユーザからの接続を許可するかどうかを制御する。 デフォルトでは、このオプションは無効になっており、 クライアントがサーバで使用するユーザ名を提供することが可能である。 このパラメータを有効にすることで、サーバは \fIuser\fR パラメータで設定されたユーザ名のみを利用する。 これは security = share のセキュリティの時のみ有用である。 .sp このパラメータを有効にすると、 Samba はサービス名からユーザ名を推測することも行なわなくなる。 このため、[homes] セクションを利用していると問題が発生してしまうことがある。 \fBuser = %S\fR とすることで、 \fIuser\fR リストにサービス名が設定され、 ホームディレクトリをユーザの名前にすることができる。 .sp このパラメータを有効にすると、 Samba はサービス名からユーザ名を推測することも行なわなくなるので注意すること。 これにより、[homes] セクションを利用していると問題が発生してしまうことがある。 \fBuser = %S\fR とすることで、 \fIuser\fR リストにサービス名が設定され、 ホームディレクトリをユーザの名前にすることができる。 .sp デフォルト値: \fB\fIonly user\fR = no \fR .RE .PP open files database hash size (G) .RS 4 このパラメータは Samba 3\.0\.23 で追加された。 これはオープンされているファイルのデータベースに用いられる TDB ファイルのハッシュサイズを設定する内部チューニング用のパラメータである。 このパラメータにより、非常に大規模な (同時接続数が何千ユーザの) システム用のチューニングを行なうことが可能となる。 このパラメータのデフォルト値は、ほとんどの環境で十分な値である。 Samba Team のメンバからアドバイスされない限り、このパラメータを変更しないことを推奨する。 .sp デフォルト値: \fB\fIopen files database hash size\fR = 10007 \fR .sp 設定例: \fB\fIopen files database hash size\fR = 1338457 \fR .RE .PP oplock break wait time (G) .RS 4 これは Windows 9x と Windows NT 双方のバグに対応するために追加されたチューニングオプションである。 クライアントが oplock を解除させるような SMB を発行した時に、 Samba のクライアントに対する応答が早過ぎると、 クライアントは誤動作してしまい、解除要求に応答しない。 このチューニングパラメータ(ミリ秒単位で指定する)は、 こうした(異常動作を行なう)クライアントに対して oplock 解除要求を送付する前に、Samba がとる待ち時間になる。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Warning Samba の oplock コードを読んで理解していない限り、このパラメータを変更してはいけない。 デフォルト値: \fB\fIoplock break wait time\fR = 0 \fR .RE .PP oplock contention limit (S) .RS 4 これは \fB非常に\fR 高度な \fBsmbd\fR(8) のチューニングオプションで、 複数のクライアントから同じファイルへの oplock 要求が行なわれた際の効率を改善するものである。 .sp このパラメータには数値を指定する。 同じファイルに対して oplock を行なおうとするクライアントの大体の数がこのパラメータで指定した限界を越えると、 \fBsmbd\fR(8) は、 たとえ要求されても oplock を許可しないようになる。これにより、 \fBsmbd\fRは Windows NT と同様の動作を行うようになる。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Warning Samba の oplock コードを読んで理解していない限り、このパラメータを変更してはいけない。 デフォルト値: \fB\fIoplock contention limit\fR = 2 \fR .RE .PP oplocks (S) .RS 4 この真偽値オプションは、 共有内のファイルオープンが要求された際に oplock (opportunistic lock = 便宜的ロック) を行なうかどうかを \fBsmbd\fR に指示する。 oplock により、Samba サーバ上のファイルアクセス速度を劇的に改善(およそ 30% 以上)することができる。 oplock により、クライアントは、積極的にファイルをローカルにキャッシュするようになるが、 信頼性の低いネットワーク環境の場合などに、これを無効にしたいと考えることもあるだろう (Windows NT サーバにおけるデフォルト値は有効である)。 これ以上の情報については、 Samba の \fIdocs/\fR ディレクトリにある \fISpeed\.txt\fR を参照のこと(訳注:現在は存在していないファイルである)。 .sp oplock は共有内のファイル単位で無効にすることも可能である。 veto oplock files パラメータを参照のこと。 システムによっては、oplock が OS 自身によって認識される。 この場合、Samba、NFS、ローカルなUNIXのいずれを経由してアクセスが行なわれた場合でも、 oplock が行なわれたファイルとのデータの同期が実現する。 詳細は、kernel oplocks パラメータを参照のこと。 .sp デフォルト値: \fB\fIoplocks\fR = yes \fR .RE .PP os2 driver map (G) .RS 4 このパラメータでは、 OS/2 のプリンタドライバ名と Windows NT のプリンタドライバ名とのマッピングが記述されたファイルへの絶対パスを指定する。 ファイル形式は以下のようになっている: .sp = \. .sp HP LaserJet 5 のプリンタドライバを例にとった場合、 正しいエントリは\fBHP LaserJet 5L = LASERJET\.HP LaserJet 5L\fRのようになる。 .sp このファイルは、 Samba3\-HOWTO 本の Classical Printing 章で記述されているプリンタドライバの名前空間の問題に対応するために用いられる。 OS/2 クライアントに関する詳細については、Samba3\-HOWTO 本の other clients 章を参照のこと。 .sp デフォルト値: \fB\fIos2 driver map\fR = \fR .RE .PP os level (G) .RS 4 この数値は、 Samba がブラウザ選定時に宣言する優先度を設定する。 このパラメータの値は、 \fBnmbd\fR(8) が、ブロードキャスト範囲内における workgroup のローカルマスタブラウザになるかどうかに影響する。 .sp \fB注意 :\fR ローカルマスタブラウザの選定に際して、デフォルトでは、 Samba が Windows NT 4\.0/2000 のドメインコントローラ以外のすべての Microsoft 社のOSに優先する。 このため、Samba ホストの設定が不正の場合、 ブラウジング的にそのサブネットが孤立してしまう可能性がある。 Samba 3\.0 系列では、このパラメータは通常自動設定されるため、デフォルト値を手動で設定する必要は通常発生しない。(訳注: 実際には自動設定は行なわれない。この説明は誤りだと思われる) このパラメータに関する詳細は、Samba\-3 HOWTO ドキュメントの第 9 章を参照のこと。 .sp デフォルト値: \fB\fIos level\fR = 20 \fR .sp 設定例: \fB\fIos level\fR = 65 \fR .RE .PP pam password change (G) .RS 4 Samba 2\.2 における PAM サポート機能の追加にともない、 このパラメータを用いることで、 Samba で PAM を使ったパスワード変更が可能となった。 このパラメータが有効な場合、SMB クライアントからの要求があれば、 passwd program\. に設定されたプログラムに代わって、PAM を使ってパスワードの変更が行なわれる。 ほとんどの場合、 passwd chat パラメータの変更なしにこのパラメータを有効にすることが可能である。 .sp デフォルト値: \fB\fIpam password change\fR = no \fR .RE .PP panic action (G) .RS 4 これは Samba 開発者のためのオプションで、 \fBsmbd\fR(8) か \fBsmbd\fR(8) がクラッシュした際に呼び出されるシステム上のコマンドを指定する。 これは通常問題が発生した事実を警告するのに使われる。 .sp デフォルト値: \fB\fIpanic action\fR = \fR .sp 設定例: \fB\fIpanic action\fR = "/bin/sleep 90000" \fR .RE .PP paranoid server security (G) .RS 4 Windows NT 4\.x のバージョンによっては、問題のあるパスワードの非ゲストアカウントが許容されている。このオプションを有効にした場合、 Samba はこうした Windows NT 4\.x サーバを password server として使用せず、ログに出力を行ない終了するようになる。 .sp このオプションを無効にすることで、 Samba がこのチェックを行なわなくなるため、リモートサーバに対する問題のあるログオンの試行が明示的に許可される。 .sp デフォルト値: \fB\fIparanoid server security\fR = yes \fR .RE .PP passdb backend (G) .RS 4 このオプションにより、管理者はパスワードの格納および取得にどのような機構(backend)を使用するかについて指定できる。 これにより、再コンパイルなしで機構を取り換えることが可能となる。 .sp このパラメータは、機構の名称と、特定の機構に依存した「位置」を示す文字列との 2 つの要素から構成されている。 この要素は「:」文字で区切られる。 .sp 指定可能な機構は以下のとおりである: .sp .RS 4 \h'-04'?\h'+03'\fBsmbpasswd\fR \- デフォルトの smbpasswd 機構である。オプションの引数として smbpasswd ファイルの位置を指定する。 .RE .sp .RS 4 \h'-04'?\h'+03'\fBtdbsam\fR \- TDB ベースのパスワード格納機構である。 オプションの引数として、 TDB ファイルへのパス (デフォルトは private dir ディレクトリ内の passdb\.tdb) を指定する。 .RE .sp .RS 4 \h'-04'?\h'+03'\fBldapsam\fR \- LDAP ベースのパスワード機構である。 オプションの引数として、 LDAP の URL (デフォルトは \fBldap://localhost\fR) を指定する。 .sp LDAP の接続は、可能な場合は暗号化される。 これは Start\-TLS (ldap ssl を参照のこと) か \fIldaps://\fR を URL 引数中で指定することにより行なわれる。 .sp LDAP ライブラリが LDAP URL 表記をサポートしていれば (OpenLDAP はサポートしている)、 ダブルクォーテーションを使って複数のサーバを指定できる。 .RE .IP "" 4 .sp 以下に設定例を示す。 .sp .nf passdb backend = tdbsam:/etc/samba/private/passdb\.tdb または passdb backend = ldapsam:"ldap://ldap\-1\.example\.com ldap://ldap\-2\.example\.com" .fi .sp デフォルト値: \fB\fIpassdb backend\fR = smbpasswd \fR .RE .PP passdb expand explicit (G) .RS 4 このパラメータは、passdb の指定に % マクロが明示的に指定された際に、 それを展開するかどうかを制御する。 ここではマクロを用いることが可能となっているが、 Windows クライアントがユーザのプライマリグループに置換されるべき %G が含まれている %G_osver% といった変数を展開してしまうというバグを引き起こしてしまうことがある。 .sp デフォルト値: \fB\fIpassdb expand explicit\fR = no \fR .RE .PP passwd chat (G) .RS 4 このパラメータで指定される文字列は、 \fBsmbd\fR(8) とローカルなパスワード変更プログラムとの間でパスワード変更時に発生する \fB「やりとり(chat)」\fR を制御する。 文字列には、 \fBsmbd\fR(8) が passwd program で指定したプログラムに行なう送信内容と、それに対して期待される応答内容とを定義したやりとりの手順を記述する。 期待される応答がない場合、パスワードは変更されない。 .sp このやりとりの手順は、 パスワード制御のためにどのような方法(たとえば NIS など)を使うかに依存するため、 通常サイト依存のものとなる。 .sp このパラメータは、 unix password sync パラメータが \fByes\fR の時のみ利用される。 このやりとりは、smbpasswd ファイル中の SMBパスワードが変更される際に、 古いパスワードの平文へアクセスすることなしに、 \fBROOT権限で\fR 呼び出される。 これは、root であれば以前のパスワードを知らなくても、ユーザのパスワードの再設定を行なうことができるからである。 NIS/YP を利用している場合、 passwd program は NIS マスタサーバ上で実行する必要がある .sp 文字列には、新パスワードに置換される、 \fI%n\fR マクロや、 各々改行、復帰、タブ、空白を意味する標準的なマクロである、\en, \er, \et, \es も記述できる。 さらに、この文字列には、任意の文字列に一致する \'*\' を記述してもよい。 ダブルクオーテーションは、空白を含む複数の文字列を 1 つの文字列と見なすのに使うことができる。 .sp やりとりの手順中で、送信文字列としてピリオド「\.」が指定されていた場合、実際にはなんの文字列も送られない。 同様に、受信文字列としてピリオドが指定されていた場合、 実際には何も受信しないことが期待されている。 .sp \fIpam password change\fR パラメータが \fByes\fR の場合、やりとりの手順は、任意の順番でマッチし、 成功したか否かは出力結果ではなく PAM の戻り値で判断される。 PAM の場合、\en マクロは無視される。 .sp デフォルト値: \fB\fIpasswd chat\fR = *new*password* %n\en*new*password* %n\en *changed* \fR .sp 設定例: \fB\fIpasswd chat\fR = "*Enter OLD password*" %o\en "*Enter NEW password*" %n\en "*Reenter NEW password*" %n\en "*Password changed*" \fR .RE .PP passwd chat debug (G) .RS 4 この真偽値パラメータは、passwd chat script パラメータを \fBdebug\fR モードで実行するかどうかに影響する。 debug モードの場合、passwd chat 中にやりとりされる文字列は、 debug level を 100 にすることで、 \fBsmbd\fR(8) のログファイル中に出力されるようになる。 \fBsmbd\fR のログ中に平文のパスワードが見えてしまうため、これは危険なオプションである。 このパラメータは、 Samba の管理者が \fIpasswd chat\fR スクリプトが \fIpasswd program\fR のデバッグを行なう際に役立つ。デバッグが終了したら、必ず無効にすること。 pam password change パラメータが有効になっている場合、このオプションは無効になる。 このパラメータはデフォルトで無効になっている。 .sp デフォルト値: \fB\fIpasswd chat debug\fR = no \fR .RE .PP passwd chat timeout (G) .RS 4 この整数値により、smbd が passwd chat script の実行を待機する時間を秒単位で指定する。 最初の応答が受信されて以降のやりとりは、 この値の 1/10 の時間で応答される必要がある。 デフォルトは 2 秒である。 .sp デフォルト値: \fB\fIpasswd chat timeout\fR = 2 \fR .RE .PP passwd program (G) .RS 4 ユーザの UNIX 上のパスワードを設定するために使用するプログラムの名前を指定する。 \fI%u\fR はユーザ名に置換される。 パスワード変更プログラムを呼び出す前に、 指定されたユーザ名が存在するかのチェックが行なわれる。 .sp 多くのパスワード変更プログラムは、 パスワードの最小字数や大文字と小文字併用や、数字の混在などの \fB適切な\fRパスワードを要求することに注意して欲しい。 一部のクライアント(Windows for Workgroups など)は、 パスワードを送信する前に大文字化してしまうため、問題が発生する。 .sp \fB注意:\fR\fIunix password sync\fR パラメータを \fByes\fR に設定すると、 smbpasswd ファイル中の SMBパスワードが変更される前に、 このプログラムが \fBROOT権限で\fR 呼び出される。 UNIX 側のパスワード変更が失敗すると、 \fBsmbd\fR は SMBパスワードの変更も失敗させる(これは仕様である)。 .sp \fIunix password sync\fR パラメータが \fByes\fR に設定されている場合は、 このパラメータで指定する \fBすべての\fR プログラムを \fB必ず絶対パスで設定し\fR、 セキュリティ上の問題が発生しないようにしておくこと。 デフォルトでは \fIunix password sync\fR は \fBno\fR になっているので注意。 .sp デフォルト値: \fB\fIpasswd program\fR = \fR .sp 設定例: \fB\fIpasswd program\fR = /bin/passwd %u \fR .RE .PP password level (G) .RS 4 クライアントとサーバの組合せによっては、 大文字と小文字が混在したパスワードの扱いに問題が発生することがある。 問題が発生するクライアントとしては、 LANMAN1 プロトコルを使用しているとパスワードを強制的に大文字にするが、 COREPLUS を使用しているときはこの変換を行なわない Windows for Workgroups が挙げられる。 Windows 95/98 系列のオペレーティングシステムにも問題がある。 これらのクライアントは、プロトコルのネゴシエーションの結果 NT LM 0\.12が使われることになった場合でも、平文のパスワードを大文字化してしまう。 .sp このパラメータは、 パスワード中に含まれる大文字の最大数を設定する。 .sp 例えば、与えられたパスワードが「FRED」であったとする。 \fIpassword level\fR が 1 に設定されていると、 「FRED」で失敗したときに以下の組み合わせによる再試行が行なわれる: .sp "Fred", "fred", "fRed", "frEd","freD" .sp \fIpassword level\fR が 2 に設定されていると、 以下の組合せによる試行も行なわれる: .sp "FRed", "FrEd", "FreD", "fREd", "fReD", "frED", …… .sp 以降も同様である。 .sp このパラメータを大きくするほど、 大文字と小文字の混在したパスワードが大文字あるいは小文字のみのパスワードと一致するようになる。 しかし、このパラメータの利用はセキュリティの低下につながることと、 新規の接続を処理するための時間が増大することを意識しておく必要がある。 .sp 値を 0 にすると、入力された通りのパスワードと、 それらを全て小文字にした場合の 2 回の試行のみを行なう。 .sp このパラメータは、平文のパスワードを使用する場合にのみ使用される。暗号化パスワードが使用されている場合 (samba\-3\.0\.0 以降はそれがデフォルト) にはまったく使用されない。つまり、このパラメータは encrypt passwords = No という設定の場合にのみ使用するということである。 .sp デフォルト値: \fB\fIpassword level\fR = 0 \fR .sp 設定例: \fB\fIpassword level\fR = 4 \fR .RE .PP password server (G) .RS 4 このオプションで、別の SMB サーバ(Windows NT マシンなど)の名前を指定した上で、 \fBsecurity = [ads|domain|server]\fR の設定を行なうことで、 Samba が行なうユーザ名、パスワードの認証のすべてを指定した別のサーバに行なわせることが可能となる。 .sp このオプションでは、使用するパスワードサーバの名前あるいは IP アドレスを設定する。 また、現在は、 ADS のレルムに対応するサーバへの接続時に使用するポートの指定にもこのオプ ョンが使用できるようになっており、そのための書式も追加されている。 デフォルトの LDAP ポートである 389 以外のポートを指定する場合には、名前あるいは IP アドレスの後にコロンを付けて指定する（例: 192\.168\.1\.100:389）。 ポートを指定しなかった場合、 Samba は標準の LDAP ポートである tcp/389 を使用する。このポート番号は、Windows NT 4\.0 ドメインや NetBIOS 接続に対応するパスワードサーバには何の意味も持たないという点に注意。 .sp このパラメータの値が名前の名前解決は name resolve order パラメータで設定された方法と順番に従って行なわれるため、 このパラメータで指定可能な任意の方式を任意の順番で組み合わせることができる。 .sp パスワードサーバは、 「LM1\.2X002」または「LM NT 0\.12」プロトコルが利用可能であり、 ユーザレベルのセキュリティモードで構成されたマシンである必要がある。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note パスワードサーバを利用するということは、 Samba を実行している UNIX マシンのセキュリティはパスワードサーバに依存するということである。 \fB 完全に信頼することができるサーバ以外をパスワードサーバとして設定してはいけない\fR。 Samba サーバ自身をパスワードサーバに設定しないこと。 これはループを発生させ、Samba サーバをフリーズさせてしまう! .sp password server の値には、 Samba 変数も通常通り利用できるが、 事実上有用なものは、Samba サーバに接続してきたクライアントをパスワードサーバとして設定することを意味する、 \fI%m\fR だけであろう。 この設定はクライアントを信頼することになるため、 hosts allow パラメータにより接続を制限することが望ましい。 .sp \fIsecurity\fR パラメータを \fBdomain\fR もしくは \fBads\fR に設定する場合、このオプションでは、 ドメインのプライマリおよびバックアップドメインコントローラを指定するか、 「*」という文字を指定する必要がある。これは、 Samba サーバをドメインのメンバとして機能させるとともに、 ユーザのログオン時に認証を行なうために、暗号化された認証済のRPCコールを利用するためである。 \fBsecurity = domain\fR を用いる利点は、 \fIpassword server\fR オプションで幾つかのサーバを指定した場合に、 \fB smbd\fR が、どれかのサーバから応答があるまでリスト中のサーバに対して順番に問い合わせを行なっていくという点にある。 これは、通常問い合わせを行なうサーバが停止してしまった時に効果を発揮する。 .sp \fIpassword server\fR オプションに文字 「*」 を指定すると、Samba は \fBWORKGROUP<1C>\fR への問い合わせを行い、名前解決機構から返却された IP アドレスリスト中の各サーバにアクセスを行って認証を実施するため、プライマリあるいはバックアップドメインコントローラの名前解決を自動的に実施する。 .sp 「*」文字とサーバのリストの両方を指定した場合、 リストは問い合わせを行なうサーバの優先順位として機能するが、 それ以外の DC もリストには追加される。 Samba は最も近い DC の位置を検出することによるリストの最適化は行なわない。 .sp \fIsecurity\fR パラメータが \fBserver\fR の場合、 \fBsecurity = domain\fR の場合にはなかった制限事項が幾つか発生する: .sp .RS 4 \h'-04'?\h'+03'複数のパスワードサーバを \fI password server\fR パラメータ中に設定できるが、 一旦 \fBsmbd\fR が接続を行なったパスワードサーバが停止してしまうと、 その \fBsmbd\fR ではそれ以上のユーザ認証が一切行なえなくなる。 これは \fBsecurity = server\fR モードにおける SMB/CIFS プロトコルでの制限で、Samba 側では対処できない。 .RE .sp .RS 4 \h'-04'?\h'+03'Windows NT サーバをパスワードサーバとして使っている場合、 ユーザが Samba サーバからログオンできるようにする必要がある。 これは、\fBsecurity = server\fR モードの場合、 ネットワーク経由のログオンは、ユーザのワークステーションからではなく、 Samba サーバから行われたものとして扱われるためである。 .RE .IP "" 4 デフォルト値: \fB\fIpassword server\fR = \fR .sp 設定例: \fB\fIpassword server\fR = NT\-PDC, NT\-BDC1, NT\-BDC2, * \fR .sp 設定例: \fB\fIpassword server\fR = windc\.mydomain\.com:389 192\.168\.1\.101 * \fR .sp 設定例: \fB\fIpassword server\fR = * \fR .RE .PP directory .RS 4 このパラメータは、pathの別名である。 .RE .PP path (S) .RS 4 このパラメータは、サービスに接続したユーザがアクセスするディレクトリを指定する。印刷サービスの場合、これは印刷データがホストの印刷機構に送られる前にスプールされる場所になる。 .sp ゲストアクセスを許可している印刷サービスの場合、サービスは読みとりのみにした上で、パスは全ユーザ書き込み可能として sticky ビットをセットすべきである。これはもちろん必須ではないが、このようにしない限りは、おそらく意図した設定を行なうことができないだろう。 .sp \fI%u\fR は、クライアントが接続する際に使用した UNIX のユーザ名に置換される。\fI%m\fR は、接続してきたマシンの NetBIOS 名に置換される。これらの置換機能は、ユーザに仮想的なホームディレクトリを設定する際非常に有用である。 .sp root dir が指定されていた場合、このパラメータもその影響を受けることに注意。 .sp デフォルト値: \fB\fIpath\fR = \fR .sp 設定例: \fB\fIpath\fR = /home/fred \fR .RE .PP pid directory (G) .RS 4 このオプションにより、 pid ファイルがおかれるディレクトリが指定される。 .sp デフォルト値: \fB\fIpid directory\fR = ${prefix}/var/locks \fR .sp 設定例: \fB\fIpid directory\fR = pid directory = /var/run/ \fR .RE .PP posix locking (S) .RS 4 \fBsmbd\fR(8) デーモンでは、 SMB クライアントによって行なわれたファイルロックの情報を記録するデータベースを管理している。 デフォルトでは、データベースの内部処理として POSIX ロックへの置換えが行なわれている。 これにより、SMB クライアントによって行なわれたファイルロックは、 POSIX 互換のアプリケーションが SMB 以外の方式(NFS やローカルなファイルアクセス) を用いて、ファイルにアクセスする際にも認識されることになる。 このパラメータを無効にする必要はまずないであろう。 .sp デフォルト値: \fB\fIposix locking\fR = yes \fR .RE .PP postexec (S) .RS 4 このオプションは、 サービスから切断した際に常に起動されるコマンドを指定する。 このパラメータでは通常の Samba の変数も利用できる。 システムによってはコマンドが root で実行される場合もあるかも知れない。 .sp 面白い例としては、サーバのリソースを umount するような用途が考えられる: .sp \fBpostexec = /etc/umount /cdrom\fR .sp デフォルト値: \fB\fIpostexec\fR = \fR .sp 設定例: \fB\fIpostexec\fR = echo \e"%u disconnected from %S from %m (%I)\e" >> /tmp/log \fR .RE .PP exec .RS 4 このパラメータは、preexecの別名である。 .RE .PP preexec (S) .RS 4 このオプションは、サービスへ接続した際に必ず実行されるコマンドを指定する。 このパラメータでは通常のSambaの変数も利用できる。 .sp 面白い例としては、接続する度に、 ユーザに歓迎(welcome)メッセージを送るような用途が考えられる。 その日の一言 (message of the day) も面白いかも知れない。以下に例を示す: .sp \fBpreexec = csh \-c \'echo \e"Welcome to %S!\e" | /usr/local/samba/bin/smbclient \-M %m \-I %I\' & \fR .sp 無論、しばらく経つとこれはイライラのもとになるだけだろう :\-)。 .sp preexec close や postexec も参照のこと。 .sp デフォルト値: \fB\fIpreexec\fR = \fR .sp 設定例: \fB\fIpreexec\fR = echo \e"%u connected to %S from %m (%I)\e" >> /tmp/log \fR .RE .PP preexec close (S) .RS 4 この真偽値オプションは、preexec で指定したコマンドから 0 以外の戻り値が返却された際に、 サービスへの接続をクローズするかどうかを制御する。 .sp デフォルト値: \fB\fIpreexec close\fR = no \fR .RE .PP prefered master .RS 4 このパラメータは、preferred masterの別名である。 .RE .PP preferred master (G) .RS 4 この真偽値パラメータは、 \fBnmbd\fR(8) が ワークグループのマスタブラウザとして優先されるかどうかに影響する。 .sp これが \fByes\fR に設定されていると、 \fBnmbd\fR は起動時にブラウザの選定を強要する。 また、選定時の優先度でも、わずかではあるが有利になる。 このパラメータは、\fBnmbd\fR がドメインマスタブラウザになることを保証するために、 domain master = yes の設定と連携して使用することが推奨されている。 (訳注: Samba 3\.0 系列では、domain logons = Yesの場合 preferred master パラメータもデフォルトでは有効となる。\fIdomain logons\fR が有効でない場合(デフォルト)、\fIdomain master\fR もデフォルトでは有効にならない。 .sp 同じサブネット上に優先マスタブラウザに指定されたホスト(Samba サーバ、Windows 95/NT のいずれの場合も)が複数台存在すると、 それらのホストは定期的にローカルマスタブラウザになろうとする 試みを永続的に繰り返すことになる。 これは不要なブロードキャストトラフィックを発生させるだけでなく、 ブラウジング機能自体にも支障を発生させてしまうため、このオプションは注意して扱うこと。 .sp デフォルト値: \fB\fIpreferred master\fR = auto \fR .RE .PP auto services .RS 4 このパラメータは、preloadの別名である。 .RE .PP preload (G) .RS 4 このパラメータは、 自動的にブラウズリスト上に追加したいサービスのリストを設定する。 このパラメータを利用しないと不可視になる homes や printers サービスにとって有用である。 .sp printcap ファイルにあるすべてのプリンタを指定したい場合は、 load printers オプションを利用する方が簡単である。 .sp デフォルト値: \fB\fIpreload\fR = \fR .sp 設定例: \fB\fIpreload\fR = fred lp colorlp \fR .RE .PP preload modules (G) .RS 4 このパラメータには、クライアントの接続前に smbd にロードされるモジュールのパスのリストを指定する。 これにより smbd が新しい接続を開始する際の時間が短縮される。 .sp デフォルト値: \fB\fIpreload modules\fR = \fR .sp 設定例: \fB\fIpreload modules\fR = /usr/lib/samba/passdb/mysql\.so \fR .RE .PP preserve case (S) .RS 4 クライアントから送信されてきた新しいファイル名中の大文字小文字をそのまま利用するか、 default case パラメータの設定を強制するかどうかを設定する。 .sp この設定に関する詳細については、 名前の短縮 セクションを参照のこと。 .sp デフォルト値: \fB\fIpreserve case\fR = yes \fR .RE .PP print ok .RS 4 このパラメータは、printableの別名である。 .RE .PP printable (S) .RS 4 このパラメータが \fByes\fR の場合に、 クライアントから指定されたディレクトリにスプールファイルを書き込むことが可能になる。 .sp 印刷可能(printable)なサービスでは、 (ユーザがUNIX上に権限をもっている限り)印刷データをスプールファイルに書き込むことが常に可能となることに注意。 read only パラメータは、 リソースに対する印刷以外のアクセスにのみ影響する。 .sp デフォルト値: \fB\fIprintable\fR = no \fR .RE .PP printcap cache time (G) .RS 4 このオプションにより、印刷サブシステムがプリンタの一覧情報を再確認するまでの時間を秒単位で制御することが可能となる。 この値が 60 より大きい場合、 初回の再確認時間は 60 秒に設定される。 これは、印刷サブシステムが初回の再確認を早期に実行するためである。 .sp このパラメータを 0 (デフォルト値) にすると、 起動後に新しいプリンタや削除されたプリンタを再確認する機能が無効化される。 .sp デフォルト値: \fB\fIprintcap cache time\fR = 0 \fR .sp 設定例: \fB\fIprintcap cache time\fR = 600 \fR .RE .PP printcap .RS 4 このパラメータは、printcap nameの別名である。 .RE .PP printcap name (S) .RS 4 このパラメータは、 コンパイル時に設定されるデフォルトでサーバが用いる printcap ファイル名 (通常 \fI/etc/printcap\fR) を上書きにするために使われる。 このパラメータを設定すべき状況については、前述した [printers] セクションに関する説明を参照のこと。 .sp CUPS 印刷インタフェースを利用する際は、\fBprintcap name = cups \fR という設定を行なうこと。これにより [global] セクションの printing = cups パラメータにより補完される。 \fBprintcap name = cups\fR により、 CUPS の設定ファイルによって指定された、 CUPS によって作成される「ダミー」の printcap が用いられるようになる。 .sp \fBlpstat\fR を利用することで 利用可能なプリンタの一覧を取得できる System V のシステムでは、 \fBprintcap name = lpstat\fR と設定することで、利用可能なプリンタの一覧を自動的に取得できる。 (ほとんどの System V ベースのシステムが該当する)では、これがデフォルトである。 これらのシステムで \fIprintcap name\fR に \fBlpstat\fR が設定されると、 Samba は \fBlpstat \-v\fR を実行し、その出力からプリンタ一覧を取得する。 .sp 最低限の printcap ファイルは下記のようなものである: .sp .nf print1|My Printer 1 print2|My Printer 2 print3|My Printer 3 print4|My Printer 4 print5|My Printer 5 .fi \'|\' によって、プリンタの別名が区切られる。 ただし、2 番目の別名中に空白があると、 Samba はそれをプリンタのコメントであると判断する。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note AIXにおけるデフォルトの printcap ファイルの名前は、 \fI/etc/qconfig\fRである。printcap ファイルの名前が \fIqconfig\fR の場合、Samba はファイルが AIXの \fIqconfig\fR形式であると仮定する。 デフォルト値: \fB\fIprintcap name\fR = /etc/printcap \fR .sp 設定例: \fB\fIprintcap name\fR = /etc/myprintcap \fR .RE .PP print command (S) .RS 4 印刷ジョブが、スプールファイルの書き込みを完了した後で、 ここで指定したコマンドが \fBsystem()\fR 関数経由でスプールファイルを処理するために、利用される。 通常、指定したコマンドはスプールファイルをホストの印刷サブシステムに送信するが、 そうしなければならないということはない。 サーバはスプールファイルを削除しないので、 指定したコマンドが処理完了後にスプールファイルを削除しなければならない。 さもなければ、古いスプールファイルを手動で削除する必要がある。 .sp print command は、単純なテキスト文字列である。 これは、以下のマクロが置換される他はそのまま利用される。 .sp %s, %f \- スプールファイル名へのパス .sp %p \- プリンタ名 .sp %J \- the job クライアントから送信されたジョブ名 .sp %c \- スプールされたジョブのうち、 すでに印刷されたページ数(検知可能な場合) .sp %z \- スプールされた印刷ジョブのサイズ (バイト) .sp print command には、\fB最低限\fR \fI%s\fR もしくは \fI%f\fR の記述が必要である。 \fI%p\fR については必須ではない。 ジョブの実行時にプリンタ名が指定されていない場合、 \fI%p\fR は単に print command から無視される。 .sp [global] セクション中で指定された print command は、 独自の print command が設定されていない各印刷サービスに適用される。 .sp 印刷サービスに print command の定義がなく、 グローバルな print command の定義もない場合、 スプールファイルは作成されるが処理されず、(これが最も重要だが)削除されない。 .sp UNIX プラットフォームによっては \fBnobody\fR アカウントを用いた印刷が失敗する場合があるので注意して欲しい。 この場合、印刷の実行が可能な別のゲストアカウントを作成し、 [global] セクション中の guest account に設定すること。 .sp シェルで解析できる限りの非常に複雑な print command を記述することが可能である。 以下の例では印刷ジョブを記録し、ファイルを印刷してからそれを削除している。 \';\' はシェルスクリプトにおいて、 通常コマンド間のセパレータとして用いられることに注意。 .sp \fBprint command = echo Printing %s >> /tmp/print\.log; lpr \-P %p %s; rm %s\fR .sp システムでファイルを印刷する一般的な方法によっては、 このコマンドを適宜変更する必要があるかもしれない。 パラメータのデフォルト値は、printing パラメータの設定に応じて変化する。 .sp デフォルト: \fBprinting = BSD, AIX, QNX, LPRNG, PLPの場合:\fR .sp \fBprint command = lpr \-r \-P%p %s\fR .sp \fBprinting = SYSV, HPUXの場合:\fR .sp \fBprint command = lp \-c \-d%p %s; rm %s\fR .sp \fBprinting = SOFTQの場合:\fR .sp \fBprint command = lp \-d%p \-s %s; rm %s\fR .sp printing = CUPS の場合: Samba が libcups を利用してコンパイルされた場合、 printcap = cups は、ジョブの送信などに CUPS API を利用する。 それ以外の場合は、\fBlp \-c \-d%p \-oraw; rm %s\fR のように、 System V 系の印刷用コマンドに \-oraw オプションをつけたものに対応づけられる。 Samba が libcups を利用してコンパイルされ、 \fBprinting = cups\fR の設定が行なわれた場合、 手動で設定された print コマンドは無視される。 .sp \fBデフォルト値なし\fR .sp 設定例: \fB\fIprint command\fR = /usr/local/samba/bin/myprintscript %p %s \fR .RE .PP printer admin (S) .RS 4 このパラメータには、 MS\-RPC(通常Windows NT Workstationによって使用される)による、 遠隔からのプリンタ管理インタフェース経由でプリンタに対するすべての操作を行なう権限をもつユーザのリストを設定する。 このパラメータは共有単位に指定することも Samba 全体に対して指定することも可能である。 root は常にこの権限をもつことに注意。 このパラメータを Samba 全体に対して設定した場合、思わぬ副作用を招く可能性があるので、注意すること。 .sp このパラメータは SePrintOperatorPrivilege ユーザ権利とプリンタのア クセス許可により、廃止予定のパラメータとなっている。 将来のリリースでは廃止されるだろう。 .sp デフォルト値: \fB\fIprinter admin\fR = \fR .sp 設定例: \fB\fIprinter admin\fR = admin, @staff \fR .RE .PP printer .RS 4 このパラメータは、printer nameの別名である。 .RE .PP printer name (S) .RS 4 このパラメータは、印刷サービスに対して印刷ジョブが送られた際に、 それをスプールするプリンタ名を設定する。 .sp [global] セクションで設定された場合、 そのプリンタ名は、独自のプリンタ名が指定されていないすべての 印刷サービスで利用される。 .sp printer name のデフォルト値は 、 大半のシステムで lp である。 .sp デフォルト値: \fB\fIprinter name\fR = なし \fR .sp 設定例: \fB\fIprinter name\fR = laserwriter \fR .RE .PP printing (S) .RS 4 このパラメータは、プリンタの状態に関する情報をどのように解釈するかを設定する。 更に、[global] セクションで指定された場合は、 \fIprint command\fR、 \fIlpq command\fR、\fIlppause command \fR、\fIlpresume command\fR、 \fIlprm command\fR のデフォルト値にも影響する。 .sp 現在、 \fBBSD\fR、\fBAIX\fR、 \fBLPRNG\fR、\fBPLP\fR、 \fBSYSV\fR、\fBHPUX\fR、 \fBQNX\fR、\fBSOFTQ\fR、 \fBCUPS\fR の9つの印刷形式がサポートされている。 .sp このオプションを設定した際に、 関連する印刷コマンドのデフォルトがどのように設定されるかを確認する際は、 \fBtestparm\fR(1) プログラムを使用すること。 .sp このオプションはプリンタ毎に設定することが可能である。 各種の印刷に関するコマンド (print command や lpq command など) で デフォルトの設定を上書きさせる場合は、 \fIprinting\fR パラメータの設定後に指定する必要があることに注意。 .sp [printers] セクションでの説明も参照のこと。 .sp \fBデフォルト値なし\fR .RE .PP private dir (G) .RS 4 このパラメータは、 smbd が \fIsmbpasswd\fR や \fIsecrets\.tdb\fR といったファイルを格納するために使用するディレクトリを指定する。 .sp デフォルト値: \fB\fIprivate dir\fR = ${prefix}/private \fR .RE .PP profile acls (S) .RS 4 この真偽値パラメータは、Windows 2000 もしくは Windows XP 用のユーザプロファイルを Samba サーバ上の共有に格納する際に発生する問題に対処するため作成された。 Windows 2000 や Windows XP の新しいサービスパック(訳注: 各々 SP4 と SP1) では、セキュリティの ACL チェックが行なわれるようになり、ローカルのワークステーション上に格納されているプロファイルのコピーを Samba 上の共有にコピーする際に、プロファイルのディレクトリの所有者と書き込み権をチェックするようになった。 .sp winbindd を用いたドメインモードで運用していない場合、ローカルワークステーション上に複製された、ワークステーションにログオン中ユーザのセキュリティ情報 (SID) は無意味なため、結果としてプロファイルの格納に失敗する。 このパラメータをプロファイルの格納に使用する共有で有効にすることにより、クライアントに返却される Windows の ACL について、以下の 2 点が変更となる。 まず、すべてのファイルおよびディレクトリの所有者とグループの所有者が、各々 BUILTIN\eAdministrators および BUILTIN\eUsers となる (SID は各々 S\-1\-5\-32\-544 と S\-1\-5\-32\-545)。 次に、返却されるすべての ACL に対して BUILTIN\eUsers にフルコントロールの ACE が付加される。 これにより、Windows 2000 および Windows XP のワークステーションのユーザがプロファイルにアクセスできるようになる。 .sp ワークステーションに複数のユーザがログオンする環境の場合、別ユーザのプロファイルへのアクセスを禁止するためには、「捜査チェックのバイパス」権利を削除する必要がある。 プロファイルディレクトリのトップ(ユーザ名を含む名称となっている)がワークステーション上で作成される際、所有するユーザ以外のアクセスを禁止するような ACL が設定されるため、この設定により、別のユーザのプロファイルディレクトリへのアクセスを禁止することができる。 .sp デフォルト値: \fB\fIprofile acls\fR = no \fR .RE .PP queuepause command (S) .RS 4 このパラメータは、印刷キューを一時停止させるために、 サーバ上で実行するコマンドを指定する。 .sp このコマンドは、引数としてプリンタ名をとり、 印刷キューにある印刷ジョブの送信を停止させるために印刷キューを停止させる機能を持つ プログラムまたはスクリプトである必要がある。 .sp Windows 95 や Windows NTでは、 「プリンタ」ウインドウからこのコマンドを発行することができるが、 Windows for Workgroups ではこのコマンドがサポートされていない。 .sp コマンド中に \fI%p\fR が指定された場合は、プリンタ名がそこに引数として置かれる。 それ以外の場合、プリンタ名はコマンド文字列の最後におかれる。 .sp サーバ上で PATH 環境変数が設定されていない場合を想定して、 コマンドをフルパスで記述することが推奨される。 .sp \fBデフォルト値なし\fR .sp 設定例: \fB\fIqueuepause command\fR = disable %p \fR .RE .PP queueresume command (S) .RS 4 このパラメータは、印刷キューを再開させるために、 サーバ上で実行するコマンドを指定する。 これは、前述したパラメータ (queuepause command) によって一時停止された動作を再開させるコマンドになる。 .sp このコマンドは、引数としてプリンタ名をとり、 印刷キューにある印刷ジョブを再度プリンタへ送信させるために印刷キューを再開する機能を持つ プログラムまたはスクリプトである必要がある。 .sp Windows 95 や Windows NTでは、 「プリンタ」ウインドウからこのコマンドを発行することができるが、 Windows for Workgroups ではこのコマンドがサポートされていない。 .sp コマンド中に \fI%p\fR が指定された場合は、プリンタ名がそこに引数として置かれる。 それ以外の場合、プリンタ名はコマンド文字列の最後におかれる。 .sp サーバ上で PATH 環境変数が設定されていない場合を想定して、 コマンドをフルパスで記述することが推奨される。 .sp デフォルト値: \fB\fIqueueresume command\fR = \fR .sp 設定例: \fB\fIqueueresume command\fR = enable %p \fR .RE .PP read bmpx (G) .RS 4 この真偽値パラメータは、 \fBsmbd \fR(8) に 「Read Block Multiplex」 SMB をサポートさせるかどうかを制御する。 これは、まず使われることがないため、デフォルトは \fBno\fR になっている。 このパラメータを設定する必要はまずないであろう。 .sp デフォルト値: \fB\fIread bmpx\fR = no \fR .RE .PP read list (S) .RS 4 これは、サービスに対して読み取りアクセス許可のみを与えられたユーザのリストである。 接続したユーザがこのリスト中に存在する場合、 read only パラメータの値がどのように設定されていても、 書き込みアクセス許可は与えられない。 リストには invalid users パラメータの説明で記述した形式を使って、グループ名を含めることも可能である。 .sp Samba 3\.0 系列において、このパラメータは security = share の環境で動作しない。これは仕様である。 .sp デフォルト値: \fB\fIread list\fR = \fR .sp 設定例: \fB\fIread list\fR = mary, @students \fR .RE .PP read only (S) .RS 4 writeable の反意語である。 .sp このパラメータが \fByes\fR の場合、 ユーザは、サービスのディレクトリ内におけるファイルの作成も修正もできない。 .sp 印刷サービス(\fBprintable = yes\fR)の場合、 ユーザは\fB常に\fR(アクセス権を持っている) ディレクトリに対して書き込むことが可能であるが、書き込みはスプール操作経由に限られる。 .sp デフォルト値: \fB\fIread only\fR = yes \fR .RE .PP read raw (G) .RS 4 このパラメータは、データをクライアントに転送する際に、 サーバ側で raw read SMB リクエストをサポートするかどうかを設定する。 .sp 有効な場合、 raw read SMB により、1パケットあたり 65535 バイトの読み込みが可能となる。 これは性能の向上に大きく貢献する。 .sp ただし、クライアントによっては、ブロックサイズを誤認識したり、 大きなブロックサイズを利用できなかったりするので、その場合は、 raw read を無効にする必要があるだろう。 .sp このパラメータは、システムのチューニングパラメータであり、 通常は設定を変更すべきものではない。 .sp デフォルト値: \fB\fIread raw\fR = yes \fR .RE .PP realm (G) .RS 4 このオプションは、使用する Kerberos レルムを指定する。 レルムは Windows NT 4\.0 における\fBドメイン\fRに相当する Active Directory の概念である。 レルムには、通常 Kerberos サーバの DNS 名が設定される。 .sp デフォルト値: \fB\fIrealm\fR = \fR .sp 設定例: \fB\fIrealm\fR = mysambabox\.mycompany\.com \fR .RE .PP remote announce (G) .RS 4 このオプションにより、 \fBnmbd\fR(8) は、指定したIPアドレスに対して設定したワークグループ情報を定期的にアナウンスするようになる。 .sp これは、Samba サーバを通常のブラウズリストの交換ができない別のワークグループ上に表示させたい場合に有用である。 別のワークグループは、IP パケットを送信できるところであればどこにあってもよい。 .sp 以下に例を示す: .sp .nf \fBremote announce = 192\.168\.2\.255/SERVERS 192\.168\.4\.255/STAFF\fR .fi 上記の設定は、\fBnmbd\fR が指定された2つのアドレスに対して、 指定されたワークグループ名を使って自身のアナウンスを行なう設定である。 ワークグループ名を指定しなかった場合、 workgroup パラメータで指定された値が代わりに利用される。 .sp 設定するIPアドレスとしては、 通常リモートネットワークのブロードキャストが用いられるが、 ネットワークが安定していれば、マスタブラウザのIPアドレスを指定することもできる。 .sp Samba HOWTO の Network Browsing 章を参照のこと。 .sp デフォルト値: \fB\fIremote announce\fR = \fR .RE .PP remote browse sync (G) .RS 4 このオプションにより、 \fBnmbd\fR(8) が、 別セグメントにある Samba サーバのマスタブラウザと定期的にブラウズリストの同期要求を行なうように構成される。 このオプションにより、 ルーティングされたネットワーク上に存在する複数ワークグループからなるブラウズリストを構築することが可能になる。 これは Samba 固有の方式で動作するため、 Samba 以外のサーバでは機能しない。 .sp これは、Samba サーバおよび同じセグメント上のクライアントマシンを、 通常のブラウズリストの交換ができない別のワークグループ上に表示させたい場合に有用である。 別のワークグループは、IP パケットを送信できるところであればどこにあってもよい。 .sp 以下に例を示す: .sp .nf \fIremote browse sync = 192\.168\.2\.255 192\.168\.4\.255\fR .fi 上記の設定は、\fBnmbd\fRが指定されたサブネットのマスタブラウザに対して、 ローカルサーバとのブラウズリストの同期を要求する設定である。 .sp 設定するIPアドレスとしては、 通常リモートネットワークのブロードキャストが用いられるが、 ネットワークが安定していればマスタブラウザのIPアドレスを指定することもできる。 IPアドレスが設定された場合、Sambaはそのマシンが起動していて、 要求を待っているかについても、そのセグメントのマスタブラウザであるかどうかについても確認しない。 .sp remote browse sync は、 WINS サーバが存在しない場合も、 ネットワーク毎に異なる WINS サーバを指定している場合にも用いることができる。 .sp デフォルト値: \fB\fIremote browse sync\fR = \fR .RE .PP rename user script (G) .RS 4 このパラメータは、以下に記述する特別な条件下において、 \fBsmbd\fR(8) によって \fBROOT 権限で\fR 実行されるスクリプトのフルパス名である。 .sp 管理者権限もしくは SeAddUserPrivilege ユーザ権利を保持しているユーザは、（NT4 のドメイン ユーザー マネージャなどから）このスクリプトを実行して、POSIX ユーザの名前を変更することが可能となる。 %uold および %unew という 2 つの変数が利用可能で、各々古いユーザ名と新しいユーザ名とに置換される。 このスクリプトは成功時に 0 を返却し、それ以外の特に 0 以外の値を返却する必要がある。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note このスクリプトは POSIX 機構でアクセスが行なわれるすべての情報について名前を変更する必要があるが、パスワード機構により必要とされる変更箇所が異なる。 tdbsam と smbpasswd の場合、各ファイル中の情報についての変更は自動的に行なわれるため、スクリプト側では POSIX のユーザ名とホームディレクトリなどの環境依存で必要とされるデータの変更だけを行なえば良い。 ホームディレクトリの名前自体を変更する必要があるかも検討すべきだろう。 ldapsam の場合、LDAP のネーミング属性（LDAP naming attribute）を変更することには潜在的な問題があるため、LDAP 中の情報については全く変更が行なわれない。 この場合、スクリプト側で責任を持って Samba がユーザの識別に用いる属性（UID）および同じディレクトリを利用する他のアプリケーションが参照する情報の変更を行なう必要がある。 デフォルト値: \fB\fIrename user script\fR = no \fR .RE .PP reset on zero vc (S) .RS 4 この真偽値オプションは、到着したセッションセットアップが、 同一の IP アドレスからの別のセッションを切断するかを制御する。 これは Windows Server 2003 のデフォルトの挙動である。 ネットワークが不安定で、 Windows が、古い接続がファイルを共有モードでオープンしているにも関わらず、再接続を試行してしまうような環境では、このパラメータを yes にする必要があるだろう。 これらのファイルは、新しい接続経由ではアクセスできなくなるが、 クライアントが新しい接続中で 0 VC を送信すると、Windows Server 2003 は同一の IP が送信元のすべての他の接続を切断する。 これにより、ロックされたファイルが再度アクセスできるようになる。 このオプションを有効にすると、ルータで同一 IP アドレスに隠蔽されている接続も切断されてしまうことに注意。 .sp デフォルト値: \fB\fIreset on zero vc\fR = no \fR .RE .PP restrict anonymous (G) .RS 4 このパラメータは、ユーザやグループの一覧情報を匿名接続に対して返却するかどうかを制御するものである。 このパラメータは Windows NT や Windows 2000 の .sp .nf HKEY_LOCAL_MACHINE\eSYSTEM\eCurrentControlSet\eControl\eLSA\eRestrictAnonymous .fi レジストリキーに相当するものである。 0 に設定された場合、ユーザやグループの一覧情報は誰に対しても返却される。 1 に設定された場合、認証済のユーザのみがユーザやグループの一覧情報を取得できる。 2 に設定された場合、匿名接続は一切拒否される。なおこの値は Windows 2000/XP や Samba でのみサポートされる。 これは匿名接続での操作が実行される前提のサードパーティおよび Microsoft のアプリケーションで問題を引き起こすことがある。 .sp restrict anonymous = 1 を用いることによるセキュリティ上の利点があるかどうかは疑わしい。これはユーザやグループの一覧情報を別の方法を用いて取得することが可能であるためである。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note restrict anonymous = 2 を用いることによるセキュリティ上の利点は、いずれかの共有において guest ok = yes の設定を行なうことで損なわれてしまうことに注意。 デフォルト値: \fB\fIrestrict anonymous\fR = 0 \fR .RE .PP root .RS 4 このパラメータは、root directoryの別名である。 .RE .PP root dir .RS 4 このパラメータは、root directoryの別名である。 .RE .PP root directory (G) .RS 4 サーバの起動時に、このディレクトリへ \fBchroot()\fR (ルートディレクトリの変更)が行なわれる。 これは、安全のため絶対に必要というものではない。 この設定がなくても、サービスの提供するディレクトリ配下にないファイルへのアクセスは許可されない。 また、ファイルシステムへの他の部分へのシンボリックリンクや、 ファイル名に「\.\.」をつけて他のディレクトリにアクセスするような行為をチェックして、 アクセスを拒否することもできる (wide links パラメータの設定に依存する)。 .sp \fIroot directory\fR として「/」以外を指定した場合は、 代償もあるが、非常に強固なセキュリティが実現される。 \fIroot directory\fR オプションで指定されたディレクトリのサブディレクトリ以外にあるファイルへは、 サーバの動作に必要なファイルも\fB含め\fR、 一切アクセスできない。サーバを動作させるには、 \fIroot directory\fR 内に必要なシステムファイルをコピーしておく必要がある。 例えば \fI/etc/passwd\fR (またはその一部)や、 印刷に必要となる設定ファイルやバイナリなどを（場合によっては）コピーする必要がある。 コピーしなければならないファイルは、オペレーティングシステムに依存する。 .sp デフォルト値: \fB\fIroot directory\fR = / \fR .sp 設定例: \fB\fIroot directory\fR = /homes/smb \fR .RE .PP root postexec (S) .RS 4 このパラメータは、 コマンドが root で実行されることを除き、 \fIpostexec\fR パラメータと同一である。 このコマンドは、コネクションの切断後に(CD\-ROMなどの)ファイルシステムをアンマウントするのに便利である。 .sp デフォルト値: \fB\fIroot postexec\fR = \fR .RE .PP root preexec (S) .RS 4 このパラメータは、 コマンドが root で実行されることを除き、 \fIpreexec \fR パラメータと同一である。 このコマンドは、コネクションの開始時に(CD\-ROMなどの)ファイルシステムをマウントするのに便利である。 .sp デフォルト値: \fB\fIroot preexec\fR = \fR .RE .PP root preexec close (S) .RS 4 このパラメータは、 コマンドが root で実行されることを除き、 \fIpreexec close \fR パラメータと同一である。 .sp デフォルト値: \fB\fIroot preexec close\fR = no \fR .RE .PP security (G) .RS 4 このオプションは、 クライアントがどのように Samba に応答するかを決めるものであり、 \fIsmb\.conf\fR 中でもっとも重要な設定の 1 つである。 .sp このオプションは、 \fBsmbd\fR(8) とのプロトコルネゴシエーション時の応答に含まれる、 「security mode bit」を設定し、共有レベルのセキュリティを使用するか否かを制御する。 クライアントは、この bit を元にして、ユーザとパスワードの情報をサーバに転送するかどうか、 また転送する際の方法を決定する。 .sp デフォルトは、\fBsecurity = user\fR であり、 これは Windows 98 と Windows NT との間で通信を行なうときに必要とされるもっとも一般的な設定(訳注: ユーザレベルのセキュリティ)である。 .sp その他 \fBsecurity = share\fR、 \fBsecurity = server\fR、 \fB security = domain \fR が設定可能な値である。 .sp 2\.0\.0 以前のバージョンの Samba では、 主に過去との互換性を保つ目的で、 \fBsecurity = share\fR がデフォルトであった。 .sp Windows for Workgroups(WfWg) には、 このオプションの設定時に注意すべきバグがある。 このパラメータが user もしくは server の場合、 WfWg クライアントは、「connect drive」ダイアログボックスで入力したパスワードを完全に無視してしまう。 そのため、WfWg にログオンしたユーザ以外のユーザで、 Samba の サービスに接続することが(不可能でない場合でも)非常に難しくなっている。 .sp PC上で UNIX マシン上と同じユーザ名を使う場合は、 \fBsecurity = user\fR を用いるとよいだろう。 UNIX マシン上にないユーザ名を使っている場合は、 \fBsecurity = share\fR を使う必要がある。 .sp パスワードなしの共有(ゲスト共有)の作成が主目的である場合も、 \fBsecurity = share\fR を使った方がよいであろう。 この設定は、通常共有プリンタサーバで使われることが多い。 \fBsecurity = user\fR の設定で、 ゲスト共有を作成するのは、多少複雑になる。 詳細については、map to guest パラメータを参照のこと。 .sp NetBIOS aliases を用いることで、 ユーザレベルと共有レベルのセキュリティの両方を提供する \fB混在モード(hybrid mode)\fR で \fBsmbd\fRを運用することも可能である。 .sp 以下、それ以外の設定について説明する。 .sp \fBSECURITY = SHARE\fR .sp 共有レベルのセキュリティに構成されたサーバに接続するクライアントは、 共有リソースに接続しようとする際に、 適切なユーザ名とパスワードでサーバにログオンしておく必要がない (最近の Windows 95/98 や Windows NT は、 \fBsecurity=share\fR のサーバと通信をする際にユーザ名を設定してログオン要求を送るが、パスワードは送らない)。 そのかわり、クライアントは、共有への接続時に共有毎に認証情報(パスワード)を送信する。 .sp \fBsecurity=share\fR レベルのセキュリティで構成されていた場合であっても、 \fBsmbd\fR がクライアントからの要求を処理する際には\fB常に\fR UNIX 上のいずれかのユーザの権限で処理が行なわれる点に注意。 .sp 共有レベルのセキュリティでは、 クライアントがユーザ名をサーバに送るように要求されないため、 \fBsmbd\fR は、いくつかの方法を用いて、 クライアントの要求を処理する際に利用する UNIX 上のユーザを決定する。 .sp クライアントから送られてきたパスワードの確認対象となる UNIX 側のユーザのリストは、以下のようにして生成される: .sp .RS 4 \h'-04'?\h'+03' guest only パラメータが設定されている場合、 以下の手順は省略され、 guest account に設定されたユーザ名のみが確認対象となる。 .RE .sp .RS 4 \h'-04'?\h'+03'共有への接続時にユーザ名も送られてきた場合、 そのユーザ名(変換後のもの \- username map を参照のこと) が確認対象のユーザ名に追加される。 .RE .sp .RS 4 \h'-04'?\h'+03'クライアントが以前に \fBログオン \fR 要求 (SessionSetup SMB 呼び出し) を行なっていた場合、 その SMB 呼び出し中で送られたユーザ名が確認対象のユーザ名に追加される。 .RE .sp .RS 4 \h'-04'?\h'+03'クライアントが接続しようとしているサービスの名前が、 確認対象のユーザ名に追加される。 .RE .sp .RS 4 \h'-04'?\h'+03'クライアントの NetBIOS 名が、 確認対象のユーザ名に追加される。 .RE .sp .RS 4 \h'-04'?\h'+03' user リスト中のユーザ名が確認対象のユーザ名に追加される。 .RE .IP "" 4 \fIguest only\fR パラメータが設定されていないと、 このリスト中のユーザ名を用いて、送信されたパスワードの確認が行なわれる。 送信されたパスワードが最初に一致したユーザが、 以降の処理に用いられる UNIX 上のユーザとして利用される。 .sp \fIguest only\fR パラメータが設定されているか、 利用するユーザを決定できなかった場合、 共有で \fI guest account \fR が利用可能であれば、ゲストアクセスが行なわれ、 それ以外の場合はアクセスが拒否されることになる。 .sp 共有レベルのセキュリティでは、 どの UNIX 上のユーザを用いてアクセス権のチェックが行なわれるかの判断が、 \fB非常に\fR 複雑になる事態が想定されることに注意。 .sp ユーザ名とパスワード認証についての注意 のセクションも参照のこと。 .sp \fBSECURITY = USER\fR .sp これは、Samba 3\.0 におけるデフォルトのセキュリティ設定である。 ユーザレベルのセキュリティにおいては、クライアントは最初に正しいユーザ名とパスワード (username map パラメータを使ってマッピングしたものでもよい)で「ログオン」を行なう必要がある。 このセキュリティレベルでは、暗号化パスワード( encrypted passwords パラメータを参照のこと) も使うことができる。 user や guest only のようなパラメータを利用して、この接続で利用する UNIX 上のユーザを変更することもできるが、 これはユーザ認証に成功した後で、行なわれる。 .sp \fB注意\fR : 要求されたリソース名は、 サーバがクライアントの認証に成功するまでサーバに\fB送られない\fR。 そのため、ユーザレベルのセキュリティでは、 サーバ上で不明なユーザを自動的に guest account として処理するようにしない限り、ゲスト共有がうまく動作しない。 上記処理の詳細については、 map to guest パラメータを参照のこと。 .sp ユーザ名とパスワード認証についての注意 のセクションも参照のこと。 .sp \fBSECURITY = DOMAIN\fR .sp このモードは、 \fBnet\fR(8) コマンドで、 マシンを Windows NT ドメインに参加させている時のみ正しく動作する。 このモードでは、encrypted passwords パラメータを \fByes\fR にすることが求められる。このモードでは、 Samba は認証要求を Windows NT のプライマリ、もしくはバックアップドメインコントローラに対して、 Windows NT Server と全く同様の方法で依頼する。 .sp \fB注意\fR: ファイルアクセスを行なう際に、 Samba は UNIX 上のアカウントを用いる必要があるため、 ドメインコントローラ上のアカウントだけでなく、 UNIX 上のアカウントも依然として存在する必要がある。 .sp \fB注意\fR: クライアントからは、 \fBsecurity=domain\fR と \fBsecurity=user\fR とは同一である。 このパラメータは、サーバがどのように認証を行なうかにのみ影響し、 クライアントとのやりとりには何ら影響しない。 .sp \fB注意\fR : 要求されたリソース名は、 サーバがクライアントの認証に成功するまでサーバに\fB送られない\fR。 サーバ上で不明なユーザを自動的に guest account として処理するようにしない限り、ゲスト共有がうまく動作しない。 上記処理の詳細については、 map to guest パラメータを参照のこと。 .sp ユーザ名とパスワード認証についての注意 のセクションも参照のこと。 .sp \fIpassword server\fR パラメータおよび \fIencrypted passwords\fR パラメータも参照のこと。 .sp \fBSECURITY = SERVER\fR .sp このモードの場合、 Samba はまず NT マシンのような別の SMB サーバにユーザ名とパスワードの認証を依頼する。 これに失敗すると、\fBsecurity = user\fR と同様に処理を行なう。このモードを用いる場合は、リモートサーバが対応していない場合を除き、 \fIencrypted passwords\fR パラメータを \fByes\fR にする必要がある。 なお、暗号化パスワードで認証処理が行なわれると、 Samba 上で UNIX パスワードファイルでの認証(平文認証)に戻れなくなるため、 ユーザの認証は \fIsmbpasswd\fR ファイルで行なう必要がある。 設定方法の詳細は、 Samba HOWTO collection 中の User Database の章を参照のこと。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note このモードの処理には、中間介入攻撃(man\-in\-the\-middle attack) やサーバの偽装に脆弱であるという重大な落し穴がある。 また、ユーザのセッションが継続している間、アクティブなコネクションを維持しておく必要があるため、 PDC のリソースを非常に多く消費する恐れある。 さらに、このコネクションがいったん失われると、回復させることができず、それ以降 (個々のクライアントがコネクションを一度切断するまでの間) Samba サーバに対する認証は失敗してしまう。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note クライアントからは、 \fBsecurity=server\fR と \fBsecurity=user\fR とは同一である。 このパラメータは、サーバがどのように認証を行なうかにのみ影響し、 クライアントとのやりとりには何ら影響しない。 \fB注意\fR : 要求されたリソース名は、 サーバがクライアントの認証に成功するまでサーバに\fB送られない\fR。 そのため、ユーザレベルのセキュリティでは、サーバ上で不明なユーザを自動的に guest account\. として処理するようにしない限り、ゲスト共有がうまく動作しない。 上記処理の詳細については、 map to guest パラメータを参照のこと。 .sp ユーザ名とパスワード認証についての注意 のセクションも参照のこと。 .sp password server パラメータおよび encrypted passwords パラメータも参照のこと。 .sp \fBSECURITY = ADS\fR .sp このモードの場合、Samba は ADS レルムのドメインメンバーとして振舞う。 このモードで動作させるためには、Samba が実行されているマシンに Kerberos がインストールされて構成されていることが必要であり、Samba は net ユーティリティを使用して ADS レルムに参加する必要がある。 .sp このモードは Samba を Active Ditectory のドメインコントローラとして動作させるものではないことに注意。 .sp 詳細については、HOWTO の Domain Membership の章を熟読のこと。 .sp デフォルト値: \fB\fIsecurity\fR = USER \fR .sp 設定例: \fB\fIsecurity\fR = DOMAIN \fR .RE .PP security mask (S) .RS 4 このパラメータは、 Windows NT クライアント上から、 NT 上のセキュリティダイアログボックスを使って UNIX ファイルのパーミッションを操作するときに、 どのパーミッションビットを変更可能にするかを制御する。 .sp このパラメータは、 変更されるパーミッションのビットに対する論理積(AND)操作を行なうマスクとして機能するため、 マスク中に含まれないビットに対する変更操作が制限される。 このパラメータを、論理積(AND)操作ではなく論理和(OR)操作を行なう類似パラメータである force security mode パラメータと混同しないこと。 .sp 基本的に、マスク中で 0 と指定されたビットは、ユーザが変更できないビットとなる。 .sp 明示的に設定されていない場合、このパラメータの値は 0777 になる。これは、 ファイルの user/group/world パーミッションのすべてについて、 ユーザからの変更を許可する。 .sp Samba を経由せずサーバにアクセスできるユーザは、 簡単にこの制限を回避できるため、 このパラメータが有用なのは、単体の「アプライアンス」システムに対してである。 ほとんどの一般的なシステムの管理者は、 おそらく \fB0777\fR に設定することであろう。 .sp デフォルト値: \fB\fIsecurity mask\fR = 0777 \fR .sp 設定例: \fB\fIsecurity mask\fR = 0770 \fR .RE .PP server schannel (G) .RS 4 このパラメータは、サーバが netlogon のセキュアチャネルを提供するかどうかを制御する。 server schannel = no の場合、セキュアチャネルは提供されない。 server schannel = auto の場合セキュアチャネルが提供されるが強制はされない。 server schannel = yes の場合、クライアントが netlogon のセキュアチャネルを認識できない場合は接続が拒否される。 これに該当するのは Windows NT 4\.0 SP4 以前のみである。 .sp このパラメータを no に設定した場合、 Windows XP マシンには Samba アーカイブの docs/Registry サブディレクトリ中にある \fIWinXP_SignOrSeal\.reg\fR ファイルを適用してレジストリを修正する必要があることに注意。 .sp デフォルト値: \fB\fIserver schannel\fR = auto \fR .sp 設定例: \fB\fIserver schannel\fR = yes \fR .RE .PP server signing (G) .RS 4 このパラメータは、Samba が通信先のクライアントに対して SMB 署名の使用を有効にするか、もしくは要求するかを設定する。 設定可能な値は、\fBauto\fR、\fBmandatory\fR、\fBdisabled\fR である。 .sp auto に設定した場合、SMB 署名が有効になるが、強制はしない。 mandatory に設定すると、SMB 署名が必須となる。disable に設定すると、SMB 署名は有効にならない。 .sp デフォルト値: \fB\fIserver signing\fR = Disabled \fR .RE .PP server string (G) .RS 4 このパラメータにより、プリンタマネージャにおける各プリンタのコメント欄および \fBnet view\fR において IPC 接続の横に表示されるテキストが設定される。ユーザに表示させたい任意のテキストを設定することができる。 .sp このパラメータにより、ブラウズリストでコンピュータ名の横に表示されるテキストも設定される。 .sp \fI%v\fR は、 Samba のバージョン番号に置換される。 .sp \fI%h\fR は、ホスト名に置換される。 .sp デフォルト値: \fB\fIserver string\fR = Samba %v \fR .sp 設定例: \fB\fIserver string\fR = University of GNUs Samba Server \fR .RE .PP set directory (S) .RS 4 \fBset directory = no\fR の場合、 サービスの利用者が、 ディレクトリ変更のための setdir コマンドを使えなくなる。 .sp \fBsetdir\fR コマンドは Digital Pathworks クライアントにおいてのみ実装されている。 詳細については、Pathworks の説明書を参照のこと。 .sp デフォルト値: \fB\fIset directory\fR = no \fR .RE .PP set primary group script (G) .RS 4 NT の POSIX サブシステムのおかげで、 Windows ユーザには、 auxiliary (補助)グループに加えて、 プライマリグループを設定することができる。 このスクリプトにより、管理者が Windows のユーザマネージャからプライマリグループを設定したり、 \fBnet rpc vampire\fR により SAM を取得したりした際に、 UNIX のユーザデータベースのプライマリグループが設定される。 \fI%u\fR は、プライマリグループを設定するユーザに置き換えられる。 \fI%g\fR は設定されるグループ名に置き換えられる。 .sp デフォルト値: \fB\fIset primary group script\fR = \fR .sp 設定例: \fB\fIset primary group script\fR = /usr/sbin/usermod \-g \'%g\' \'%u\' \fR .RE .PP set quota command (G) .RS 4 \fBset quota command\fR は Samba が実行されている OS 上で、API が提供されていない場合に限り使用すべきである。 .sp このオプションは、必ず \fB\./configure \-\-with\-sys\-quotas\fR が指定されているときのみ有効である。 もしくは Linux において \fB\./configure \-\-with\-quotas\fR が指定され、システムにクオータの API が存在し、機能する場合にのみ使用できる。 ほとんどのパッケージでは、これらのオプションを指定して構成されている。 .sp このパラメータは、引数を指定することで、クオータの設定を行なうスクリプトへのパスを指定する。 .sp このスクリプトは以下の引数をとる: .sp .RS 4 \h'-04'?\h'+03'1 \- クオータのタイプ .sp .RS 4 \h'-04'?\h'+03'1 \- ユーザのクオータ .RE .sp .RS 4 \h'-04'?\h'+03'2 \- ユーザのデフォルトのクオータ (uid = \-1) .RE .sp .RS 4 \h'-04'?\h'+03'3 \- グループのクオータ .RE .sp .RS 4 \h'-04'?\h'+03'4 \- グループのデフォルトのクオータ (gid = \-1) .RE .IP "" 4 .RE .sp .RS 4 \h'-04'?\h'+03'2 \- id (ユーザの uid もしくはグループの gid 。 \-1 を指定した場合はどちらともみなされない) .RE .sp .RS 4 \h'-04'?\h'+03'3 \- クオータの状態 (0 = 無効, 1 = 有効, 2 = 有効かつ強制) .RE .sp .RS 4 \h'-04'?\h'+03'4 \- ブロック数のソフトウェア的な上限 .RE .sp .RS 4 \h'-04'?\h'+03'5 \- ブロック数のハードウェア的な上限 .RE .sp .RS 4 \h'-04'?\h'+03'6 \- inode 数のソフトウェア的な上限 .RE .sp .RS 4 \h'-04'?\h'+03'7 \- inode 数のハードウェア的な上限 .RE .sp .RS 4 \h'-04'?\h'+03'8(オプション) \- ブロックサイズ、デフォルトは 1024 .RE .IP "" 4 このスクリプトは少なくとも1行のデータ行を出力する必要がある。ただし処理が成功しなかった場合は何も出力されない。 .sp デフォルト値: \fB\fIset quota command\fR = \fR .sp 設定例: \fB\fIset quota command\fR = /usr/local/sbin/set_quota \fR .RE .PP share modes (S) .RS 4 このパラメータは、ファイルオープン中の \fIshare modes\fR の制御を有効にするかどうかを設定する。 このモードは、ファイルへの排他的な読み出し又は書き込みアクセスを得るために、クライアントによって利用されるものである。 .sp これらのモードは、UNIX では提供されていないため、 共有メモリ、共有メモリをサポートしていない場合はロックファイル(共有メモリはほとんどすべてのUNIXでサポートされている)で疑似的に実現されている。 .sp このオプションで有効化される共有モードは \fBDENY_DOS\fR、\fBDENY_ALL\fR, \fBDENY_READ\fR、\fBDENY_WRITE\fR, \fBDENY_NONE\fR、\fBDENY_FCB\fR である。 .sp このオプションは共有機能の互換性を保つため、 デフォルトで有効になっている。 .sp このパラメータは、 \fB絶対に\fR off にしてはならない。 off にした場合、多くの Windows アプリケーションが誤動作するであろう。 .sp デフォルト値: \fB\fIshare modes\fR = yes \fR .RE .PP short preserve case (S) .RS 4 この真偽値パラメータは、 すべて大文字で適切な長さという 8\.3 形式の条件を満たすファイル名を大文字のファイル名にして作成するか、 default case パラメータにしたがった文字の大きさで作成するかを指定する(訳注: 実際は、8+3 形式の名前において大文字小文字の混在を容認するか、規定値の文字の大きさに統一するかを制御する)。 このオプションは、 preserve case = yes を用いて長いファイル名の大文字小文字の情報を保持している際に、 短いファイル名における大文字小文字の情報を保持するために利用する。 .sp NAME MANGLINGセクションも参照のこと。 .sp デフォルト値: \fB\fIshort preserve case\fR = yes \fR .RE .PP show add printer wizard (G) .RS 4 Samba 2\.2 での Windows NT/2000 クライアントに対する MS\-RPC ベースのプリンタサポート機能のサポートによって、 Samba ホスト上の共有一覧で「プリンタ」フォルダが表示されようになっている。 通常、このフォルダにはプリンタの追加ウィザード (MS Add Printer Wizard (APW))のアイコンが存在している。 しかし、接続したユーザの権限に関わらず、 この機能を無効にすることも可能である。 .sp 通常の場合、Windows NT/2000 クライアントは Administrator 権限を持っているかどうかを確認するために、 OpenPrinterEx() 関数により、プリンタサーバ上のハンドルをオープンしようとする。 ユーザにプリンタサーバ上での管理者権限がない場合 (root でなく、\fIprinter admin\fR グループのメンバでもない)、 OpenPrinterEx() の呼出は失敗して、 client は低い権限でも可能な別の関数呼出を行なう。 これに成功しても、APW のアイコンは表示されない。 .sp \fIshow add printer wizard\fR パラメータを無効にすることにより、サーバ上での OpenPrinterEx() 呼出が常に失敗するようになる。 そのため、APW のアイコンは決して表示されなくなる。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note このパラメータは、ユーザが個々のプリンタの管理権限を持つことを制限するものではない。 デフォルト値: \fB\fIshow add printer wizard\fR = yes \fR .RE .PP shutdown script (G) .RS 4 このパラメータは、 \fBsmbd\fR(8) が呼び出すことで、 シャットダウン処理を実行するスクリプトのフルパス名である。 .sp サーバに接続しているユーザが \fBSeRemoteShutdownPrivilege\fR 権利を有している場合、 このコマンドはそのユーザの権限で実行される。 .sp %m %t %r %f パラメータは以下のように展開される: .sp .RS 4 \h'-04'?\h'+03'\fI%m\fR はサーバに送信されるシャットダウンメッセージに置換される。 .RE .sp .RS 4 \h'-04'?\h'+03'\fI%t\fR は実際にシャットダウン処理が開始されるまでに待機する時間(秒単位)に置換される。 .RE .sp .RS 4 \h'-04'?\h'+03'\fI%r\fR は \fB\-r\fR スイッチに置換される。これは NT の「シャットダウン後再起動」を意味する。 .RE .sp .RS 4 \h'-04'?\h'+03'\fI%f\fR は \fB\-f\fR スイッチに置換される。これは NT の「アプリケーションが応答しない場合でも強制的にシャットダウンする」を意味する。 .RE .IP "" 4 シャットダウンスクリプト例を以下に示す: .sp .nf #!/bin/bash $time=0 let "time/60" let "time++" /sbin/shutdown $3 $4 +$time $1 & .fi シャットダウン処理から復帰することはないので、この処理はバックグラウンドで実行する必要がある。 .sp デフォルト値: \fB\fIshutdown script\fR = \fR .sp 設定例: \fB\fIshutdown script\fR = /usr/local/samba/sbin/shutdown %m %t %r %f \fR .RE .PP smb passwd file (G) .RS 4 このオプションにより、暗号化された smbpasswd ファイルへのパスが設定される。 デフォルトの smbpasswd ファイルへのパスは、 Samba のコンパイル時に設定される。 .sp 以下に設定例を示す: .sp .nf smb passwd file = /etc/samba/smbpasswd .fi .sp デフォルト値: \fB\fIsmb passwd file\fR = ${prefix}/private/smbpasswd \fR .RE .PP smb ports (G) .RS 4 サーバが SMB トラヒックを町受けるポートを設定する。 .sp デフォルト値: \fB\fIsmb ports\fR = 445 139 \fR .RE .PP socket address (G) .RS 4 このオプションは、 Samba がどのアドレスで接続を listen するかを設定する。 これは、サーバ上で複数の仮想インタフェースを用いる必要があり、 各々のインタフェース上で 異なる構成の Samba を動作させる際に利用できる。 .sp デフォルトの場合、 Sambaはどのアドレスからのアクセスでも受け付ける。 .sp デフォルト値: \fB\fIsocket address\fR = \fR .sp 設定例: \fB\fIsocket address\fR = 192\.168\.2\.20 \fR .RE .PP socket options (G) .RS 4 このオプションは、クライアントとの通信に利用されるソケットオプションを設定する。 .sp ソケットオプションは、 OS のネットワーク層の接続に影響し、通信の最適化に利用されるものである。 .sp このオプションは、各ネットワークにおける Samba サーバの性能の最適化に用いられることが多い。 Samba 自身がネットワークにおける最適のパラメータを知るすべはないので、このオプションは、自分自身で実験して設定しなければならない。設定を行なう前に、使用している OS の適切なドキュメント (恐らく \fBman setsockopt\fR が役立つだろう) を読むことを強く推奨する。 .sp システムによっては、このオプションを設定すると、 Samba が「Unknown socket option」というメッセージを返却するようになるかもしれない。この原因は、ミスタイプか、 includes\.h に使用している OS の include ファイルを追加する必要があるかのいずれかであろう。後者の場合は、samba\-technical@samba\.org までパッチを送ってほしい。 .sp サポートされているソケットオプションについては、 OS の制約がない限り、どれでもどのような組合せでも用いることができる。 .sp 以下に現在このオプションで設定可能なソケットオプションの一覧を示す: .sp .RS 4 \h'-04'?\h'+03'SO_KEEPALIVE .RE .sp .RS 4 \h'-04'?\h'+03'SO_REUSEADDR .RE .sp .RS 4 \h'-04'?\h'+03'SO_BROADCAST .RE .sp .RS 4 \h'-04'?\h'+03'TCP_NODELAY .RE .sp .RS 4 \h'-04'?\h'+03'IPTOS_LOWDELAY .RE .sp .RS 4 \h'-04'?\h'+03'IPTOS_THROUGHPUT .RE .sp .RS 4 \h'-04'?\h'+03'SO_SNDBUF * .RE .sp .RS 4 \h'-04'?\h'+03'SO_RCVBUF * .RE .sp .RS 4 \h'-04'?\h'+03'SO_SNDLOWAT * .RE .sp .RS 4 \h'-04'?\h'+03'SO_RCVLOWAT * .RE .IP "" 4 \fB\'*\'\fR 印のあるオプションは、整数の引数を必要とする。それ以外のものは、 1 または 0 の引数で有効、無効を指定することもできるが、 1 または 0 を指定しない場合は、有効に設定される。 .sp 引数を指定する場合は、\fBSO_SNDBUF = 8192\fR のように、 SOME_OPTION = VALUE という形式で指定する。 = 記号の前後に空白を入れてはいけない。 .sp ローカルネットワーク以外を考慮しなくても良い場合、 .sp \fBsocket options = IPTOS_LOWDELAY\fR .sp と設定するのがよいであろう。 .sp ローカルネットワークが存在する場合は以下の設定を試してみるとよいであろう: .sp \fBsocket options = IPTOS_LOWDELAY TCP_NODELAY\fR .sp WAN の場合は、 IPTOS_THROUGHPUT を設定してみるとよいかも知れない。 .sp これらのオプションの中には、 Samba サーバを完全に停止させるものもあるかもしれない。オプションを設定する際には気をつけること。 .sp デフォルト値: \fB\fIsocket options\fR = TCP_NODELAY \fR .sp 設定例: \fB\fIsocket options\fR = IPTOS_LOWDELAY \fR .RE .PP stat cache (G) .RS 4 このパラメータにより、 \fBsmbd\fR(8) が、 大文字小文字を区別しない名前のマップ操作を高速化するためにキャッシュを利用するかどうかが設定される。 このパラメータを変更する必要はないであろう。 .sp デフォルト値: \fB\fIstat cache\fR = yes \fR .RE .PP store dos attributes (S) .RS 4 このパラメータが設定されると、Samba は DOS のファイル属性(システム、隠し、アーカイブ、読み取り専用)を、 (map hidden や map readonly パラメータにより制御される) UNIX のパーミッションビットからのマッピングを行なう前に、 ファイルシステムの拡張属性から読み取ろうとする。 このパラメータが設定されると、DOS のファイル属性は、UNIX ファイルシステム上で、各ファイルやディレクトリ毎に割り当てられた拡張属性の領域に格納される。 これ以外のマッピング機構が動作しないようにするため、 map hidden、 map system、map archive、map readonly といったパラメータは無効にする必要がある。 このパラメータは DOS のファイル属性を「user\.DOSATTRIB」という名前の拡張属性に、文字列として書き込む。 この拡張属性は、クライアントの拡張属性に関するリクエストからは明示的に隠蔽されている。 Linux において拡張属性を有効にするには、 Linux カーネルで拡張属性がコンパイルされており、 ファイルシステムが user_xattr オプションをつけてマウントされている必要がある。 .sp デフォルト値: \fB\fIstore dos attributes\fR = yes \fR .RE .PP strict allocate (S) .RS 4 この真偽値パラメータは、サーバ上のディスク領域の割当を制御するものである。 このパラメータが \fByes\fR の場合、 サーバは、ファイルが拡張されただけでは実際のディスク領域を割り当てない UNIX 流の動作をやめ、 ファイルがあるサイズで作成されたり、拡張されたりした際に、 実際にディスク領域を割り当てる Windows 流の動作を行なうようになる。 これは、Samba がスパースファイルを作成しなくなることを意味する。 これにより、システムによっては処理が遅くなる。 .sp strict allocate が \fBno\fR の場合、 サーバは、ファイルの拡張時にスパースファイルを作成する。 .sp このパラメータを \fByes\fR にすると、 ディスククオータによるディスク領域の制限を行なっているシステムで、 クォータ超過メッセージを出力する際には便利である。 .sp デフォルト値: \fB\fIstrict allocate\fR = no \fR .RE .PP strict locking (S) .RS 4 これは、 サーバ上でのロックの扱いを制御する列挙型の値のパラメータである。 \fByes\fR に設定された場合、 サーバはすべての読み書きのアクセスについてファイルのロック状態を検査し、 ロックされている場合はアクセスを拒否する。 システムによっては、アクセス速度の低下につながるだろう。 .sp strict locking が Auto (デフォルト値)の場合、サーバは oplock が行なわれていないファイルについてのみ、ロック状態の検査を行なう。 Windows のリダイレクタの多くは、oplock が行なわれているファイルについてはファイルロックのチェックをローカルで実施しているため、 この設定は、パフォーマンス低下とのうまいトレードオフを実現している。 .sp strict locking が無効の場合、 サーバは、クライアントが明示的に要求したときに限って、 ファイルのロック状態の確認を行なう。 .sp 行儀のよいクライアントは、 重要な操作を行ない際には必ずロックの状態を問い合わせる。 従って、大抵の場合は \fBstrict locking = Auto\fR か \fBstrict locking = no\fR がよい。 .sp デフォルト値: \fB\fIstrict locking\fR = Auto \fR .RE .PP strict sync (S) .RS 4 (Windows 98 の Explorer を含む)多くの Windows アプリケーションは、 バッファのデータをフラッシュする処理を、ディスクに対し、同期を行う処理と取り違えているようである。 UNIX における同期処理は、カーネル内のディスクバッファに残っているデータが無事に記憶装置へ保存されたことをカーネルが確認するまで、プロセスを停止させる。 この処理は非常に遅く、頻繁に行うべきではない。 このパラメータを \fBno\fR(デフォルト)に設定すると、 \fBsmbd\fR(8) は Windows アプリケーションからの同期処理要求を無視する。 この場合でも、データが失われる可能性があるのは、 Samba が動作しているオペレーティングシステム自身がクラッシュしたときだけであるので、この設定による危険度は少ない。 また、 Windows 98 の Explorer を使ったファイルコピーのパフォーマンス問題が報告されているが、こちらも改善される。 .sp デフォルト値: \fB\fIstrict sync\fR = no \fR .RE .PP svcctl list (G) .RS 4 このパラメータにより、smbd が Win32 の ServiceControl API 経由で UNIX 側のサービスを起動、停止させる際に用いられる起動スクリプトの一覧を定義する。 これにより、Windows の管理者が Microsoft Management Console プラグインを用いて Samba サーバ上が動作する UNIX サービスを制御することが可能となる。 .sp 管理者は、Samba の $(libdir) 以下に \fIsvcctl\fR というディレクトリを作成して、 \fI/etc/init\.d/\fR に存在する起動スクリプトのシンボリックリンクを作成しておく必要がある。 シンボリックリンク名は、 \fIsvcctl list\fR パラメータに記載した名称と同一にしておくこと。 .sp デフォルト値: \fB\fIsvcctl list\fR = \fR .sp 設定例: \fB\fIsvcctl list\fR = cups postfix portmap httpd \fR .RE .PP sync always (S) .RS 4 この真偽値パラメータは、書き込み時に不摘発性のストレージへの書き込みとの同期を常に行なうかどうかを制御する。 \fBno\fR の場合、 サーバは個々のクライアントからの書き込み要求に基づいて、同期を行なうかどうかを制御する (クライアントは個々の書き込みについて、同期要求ビットを設定することが可能である)。 \fByes\fR の場合、 個々の書き込みに毎に、データを確実にディスクに書き込むため \fBfsync()\fR が呼び出される。 このパラメータが機能するには、 \fIstrict sync\fRパラメータが\fB yes\fRに設定されている必要がある。 .sp デフォルト値: \fB\fIsync always\fR = no \fR .RE .PP syslog (G) .RS 4 このパラメータは、 Samba のデバッグメッセージと syslog のプライオリティとの対応づけを行なう。 Samba のデバッグレベル 0 は、 syslog の \fBLOG_ERR\fRに割り当てられ、以下、 デバッグレベル 1 は \fBLOG_WARNING\fR、 デバッグレベル 2 は \fBLOG_NOTICE\fR、 デバッグレベル 3 は \fBLOG_INFO\fR、 それ以上のデバッグレベルは \fBLOG_DEBUG\fR にそれぞれ割り当てられている。 .sp このパラメータは どのデバッグレベルまでのメッセージを syslog に送るかのしきい値を設定する。 この値未満の Samba のデバッグメッセージのみが syslog に送られる。 .sp デフォルト値: \fB\fIsyslog\fR = 1 \fR .RE .PP syslog only (G) .RS 4 このパラメータが設定されると、 Samba のデバッグメッセージが システムの syslog にのみ記録されるようになり、 デバッグログファイルに出力されなくなる。 .sp デフォルト値: \fB\fIsyslog only\fR = no \fR .RE .PP template homedir (G) .RS 4 NT ドメインのユーザに対応するユーザ情報を作成する際、 \fBwinbindd\fR(8) デーモンは、このパラメータによってユーザのホームディレクトリの位置を設定する。文字列中に \fI%D\fR があれば、ユーザの所属する NT ドメイン名に置き換えられる。文字列中に \fI%U\fR があれば、ユーザの NT ドメインにおけるユーザ名に置き換えられる。 .sp デフォルト値: \fB\fItemplate homedir\fR = /home/%D/%U \fR .RE .PP template shell (G) .RS 4 NT ドメインのユーザに対応するユーザ情報を作成する際、 \fBwinbindd\fR(8) デーモンは、このパラメータによってユーザのログインシェルを設定する。 .sp \fBデフォルト値なし\fR .RE .PP time offset (G) .RS 4 このパラメータは、GMT からローカル時間への変換時に追加する時間(分単位)を設定する。 夏時間処理に問題があるPCを多数管理している際に有効である。 .sp デフォルト値: \fB\fItime offset\fR = 0 \fR .sp 設定例: \fB\fItime offset\fR = 60 \fR .RE .PP time server (G) .RS 4 このパラメータにより、 \fBnmbd\fR(8) が、 Windows クライアントに対して、自身をタイムサーバとしてアナウンスするかどうかが制御される。 .sp デフォルト値: \fB\fItime server\fR = no \fR .RE .PP unix charset (G) .RS 4 Samba が動作する UNIX マシンで使われている文字コードを指定する。 この情報は、Samba が SMB クライアントの使用している文字コードと文字列の変換を行なうために必要である。 .sp ここで設定した文字コードは、Samba から実行するスクリプトの引数にも用いられる。 .sp デフォルト値: \fB\fIunix charset\fR = UTF8 \fR .sp 設定例: \fB\fIunix charset\fR = ASCII \fR .RE .PP unix extensions (G) .RS 4 この真偽値パラメータは、Samba が HP 社によって定義された CIFS の UNIX拡張を利用するかどうかを制御する。 これらの拡張は、UNIX クライアントから UNIX サーバに対して接続する際に有用な CIFS を有効にし、 シンボリックリンクやハードリンクなどを利用可能にする。 これらの拡張により、Samba は UNIX の CIFS クライアントに対して、 シンボリックリンクやハードリンクといった機能を提供することが可能となる。 .sp デフォルト値: \fB\fIunix extensions\fR = yes \fR .RE .PP unix password sync (G) .RS 4 この真偽値パラメータにより、 smbpasswd ファイルの暗号化された SMBパスワードの更新時に、 Samba が UNIX のパスワードを SMB パスワードと同期させるようになる。 これを \fByes\fR に設定した場合、 (SMB パスワードの変更コードは古い平文パスワードを参照できず、新しいパスワードだけが渡されるため、) 新しい UNIX パスワードを古いパスワードの情報なしで設定するため、 \fIpasswd program\fR パラメータで指定されたコマンドが \fBROOT権限で\fR呼び出される。 .sp デフォルト値: \fB\fIunix password sync\fR = no \fR .RE .PP update encrypted () .RS 4 この真偽値パラメータにより、 平文パスワードでログインしたユーザのログオン時に、 そのユーザの暗号化(ハッシュ化)パスワードが自動的に smbpasswd ファイル中に格納されるようになる。 このオプションにより、暗号化パスワード認証を有効にする際、 ユーザに smbpasswd へのパスワード再入力を強制することなく、 平文パスワード認証 (平文パスワードによるユーザ認証情報がネットワーク上を流れて UNIX 側のアカウントデータベースで照会される)から暗号化パスワード認証 (SMB のチャレンジアンドレスポンス認証) への移行を行うことが可能になる。 これは便利なオプションで、 ある程度の時間をかけて徐々に暗号化パスワードへと移行することを可能にする。 すべてのユーザが smbpasswd ファイルに暗号化パスワードを格納したら、 このパラメータを \fBno\fR に設定すべきだろう。 .sp このパラメータは encrypt passwords が \fBno\fR に設定されている時のみ動作する。 encrypt passwords = Yes がデフォルトであるため、 update encrypted を動作させるには このパラメータを \fBno\fR に設定する必要があることに注意。 .sp このパラメータが有効になっている場合であっても、 \fBsmbd\fR に接続するユーザは正しいパスワードを入力して、 (smbpasswdファイル中の)暗号化されたパスワードを更新する必要がある。 .sp デフォルト値: \fB\fIupdate encrypted\fR = no \fR .RE .PP use client driver (S) .RS 4 このパラメータは、Windows NT/2000 クライアントに対してのみ影響し、 Windows 95/98/Me クライアントに対しては影響しない。 Windows NT/2000 クライアントに対して、 Samba ホスト上に適切なプリンタドライバをインストールせずに、プリンタ共有を提供する場合、 クライアント側ローカルにプリンタドライバをインストールする必要がある。 このため、クライアントは、そのプリンタをローカルプリンタとして扱い、 ネットワークプリンタとしては扱わなくなる。 これは、\fBdisable spoolss = yes\fRにしたときとほぼ同様の動作になる。 .sp 違いが発生するのは、通常の環境下において、 NT/2000 クライアントは MS\-RPC を用いてネットワークプリンタをオープンしようとする点にある。 クライアントはプリンタがローカルにあると判断しているため、 ログオンしているユーザに割り当てられたアクセス権を要求して OpenPrinterEx() 呼出を発行してしまう点が問題となる。 ユーザがローカルで管理者権限を持っているが、Samba ホスト上では root 権限を持っていない場合(これはよくあるケースになる)、 OpenPrinterEx() 呼出は失敗する。 その結果、(印刷ジョブが正常に印刷されているにも関わらず、) クライアント側のプリンタキューのウインドウには、 「Access Denied; Unable to connect」というメッセージが表示される。 .sp このパラメータが有効になっているプリンタに対しては、 PRINTER_ACCESS_ADMINISTER 権限によるプリンタのオープンの試みはすべて、 PRINTER_ACCESS_USE の権限で行なわれ、 これにより、OpenPrinterEx() が成功することになる。 \fB適切なプリンタドライバがインストールされている Samba サーバ上のプリンタ共有に対して、このパラメータを有効にしてはならない。\fR .sp デフォルト値: \fB\fIuse client driver\fR = no \fR .RE .PP use kerberos keytab (G) .RS 4 このパラメータは、Samba がシステムの keytab ファイル中にある、 \fBhost/FQDN\fR および \fBcifs/FQDN\fR サービスプリンシパルの維持を行なうかどうかを制御する。 .sp heimdal Kerberos ライブラリを利用している場合、 \fI/etc/krb5\.conf\fR に以下の記述も必要である: .sp .nf [libdefaults] default_keytab_name = FILE:/etc/krb5\.keytab .fi .sp デフォルト値: \fB\fIuse kerberos keytab\fR = False \fR .RE .PP use mmap (G) .RS 4 このグローバルパラメータは、 Samba が内部的に利用する tdb の動作を、システムの mmap が正しく動作するかどうかに依存させるかどうかを制御する。 Samba は一貫性の保たれた mmap (read\-write system memory cache) を必要とする。 現在、HPUX については、こうした一貫性のあるキャッシュが実装されていないため、 HPUX におけるこのパラメータのデフォルトは、\fBno\fR になっている。 それ以外のシステムにおいては、このパラメータの値を変更すべきではない。 このパラメータは、Samba 開発者の tdb の内部コードの問題解析を支援するために提供されている。 .sp デフォルト値: \fB\fIuse mmap\fR = yes \fR .RE .PP user .RS 4 このパラメータは、usernameの別名である。 .RE .PP users .RS 4 このパラメータは、usernameの別名である。 .RE .PP username (S) .RS 4 このパラメータに複数のユーザをコンマで区切ったリストで指定することにより、 各ユーザ名に対して(左から右に)順番に入力したパスワードを用いた認証が行われる。 .sp \fIusername\fR パラメータは、 PC 側からユーザ名が提供されない時にのみ必要である。 これに該当するのは、COREPLUS プロトコルを用いているか、 Windows for Workgroup において、ユーザ名が UNIX 側のユーザ名と異なっている場合である。 どちらの場合も、このパラメータの代わりに \e\eserver\eshare%user の記法を用いるのが好ましい。 .sp Sambaは \fIusername\fR パラメータで指定された各ユーザに対して、 提供されたパスワードを用いて順番に認証を行っていくことになるため、 \fIusername\fRは最適の解決策とはいえない。 これは遅い上、パスワードが重複しているユーザが多数存在しているような場合には困ったことになる。 このパラメータを不用意に使うと、 タイムアウトやセキュリティ上の問題などが発生するかも知れない。 .sp Samba は、プラットフォームである UNIX のセキュリティ機構に依存している。 このパラメータは、ログインできるユーザを制限するものではなく、 提供されたパスワードを適用するユーザについての情報を Samba サーバに与えるものである。 ユーザは自分が好むユーザとしてログインすることが可能であるが、 telnet セッションよりは、被害を与えないだろう。 デーモンはログインしたユーザの権限で動作するため、 ユーザの権限で行えないことは何も行えない。 .sp サービスへのアクセスを特定のユーザに制限したい場合は、 valid users パラメータを利用すること。 .sp ユーザ名が \'@\' ではじまっている場合は、 (Samba がネットグループをサポートするようにコンパイルされている場合) まず NIS のネットグループ、更に UNIX のグループデータベースにおいて、 該当する名前のグループがないかが検索され、 その名前のグループに所属する全てのユーザ名に展開される。 .sp ユーザ名が \'+\' から始まっている場合は、 UNIX のグループデータベースのみが検索され、 その名前のグループに所属する全てのユーザ名に展開される。 .sp ユーザ名が \'&\' から始まっている場合は、 (Samba がネットグループをサポートするようにコンパイルされている場合) NIS のネットグループのみが検索され、 その名前のグループに所属する全てのユーザ名に展開される。 .sp グループ名の検索には時間が掛かるため、 クライアントによっては検索がタイムアウトしてしまう場合があることに注意。 .sp このパラメータにより、サービスへのアクセスがどのように行われるかの詳細については NOTE ABOUT ユーザ名とパスワード認証についての注意 のセクションを参照のこと。 .sp デフォルト値: \fB\fIusername\fR = # ゲストサービスの時は、 guest account で設定されたアカウント、それ以外の時は <空文字列> \fR .sp 設定例: \fB\fIusername\fR = fred, mary, jack, jane, @users, @pcgroup \fR .RE .PP username level (G) .RS 4 このオプションは、 DOS クライアントの多くが送信する大文字化されたユーザ名から、 Samba が本当の UNIX のユーザ名を「推測」する際の手助けを行う。 デフォルトの場合、 Samba は全て小文字のユーザ名、 先頭の文字のみを大文字にしたユーザ名を順に試しても、 UNIX マシン上に該当するユーザ名がない場合は処理を失敗させる。 .sp このパラメータに 0 以外の値を指定することで、この処理を変更できる。 このパラメータは、UNIX 側のユーザ名を確認する際に大文字が幾つ入ったユーザ名の組合せまで確認を行なうかを決定するものである。 大きい数字を指定する程、多くの組合せが確認されるため、 ユーザ名の確認作業は遅くなる。 このパラメータは、UNIX マシン上に \fBAstrangeUser \fRといった名前が存在する際に使用すること。 .sp このパラメータは、ユーザ名の大文字、小文字が区別される UNIX システムでのみ必要である。 .sp デフォルト値: \fB\fIusername level\fR = 0 \fR .sp 設定例: \fB\fIusername level\fR = 5 \fR .RE .PP username map (G) .RS 4 このオプションにより、 クライアント上とサーバ上でのユーザ名のマッピング情報を格納したファイルが指定される。 これは幾つかの目的で利用される。 通常は DOS や Windows マシンでユーザが利用しているユーザ名を UNIX マシン上でのユーザ名にマッピングする為に用いられるが、 複数のユーザを特定のユーザ名にマッピングすることで、 ユーザ間でのファイル共有を簡単に行なえるようにするために用いることも可能である。 .sp security パラメータが user もしくは share の場合、username map パラメータは ユーザの資格情報が検証されるたびに適用されることに注意。 ドメインのメンバサーバ(domain もしくは ads)の場合、ドメインコントローラから認証を受けた後で username map パラメータが適用され、マッピングの際には、完全ユーザ名(例えば biddle = DOMAIN\efoo) で記述する必要がある。 .sp ファイルは各行ごとに評価される。 各々の行は、左端に UNIX ユーザ名があり、\'=\' を挟んでその右側にユーザ名のリストが続く形式をとる。 右側のユーザ名のリストには、 グループ内のすべての UNIX ユーザ名に一致させる @group という形式を含めることもできる。 \'*\' はワイルドカードであり、任意の名前と一致する。 ファイルの各行は最大 1023 文字まで記述可能である。 .sp ファイルの評価は、 提供されたユーザ名と \'=\' の右側の各ユーザ名とを各行毎に比較することにより行なわれる。 提供されたユーザ名が右側のどれかに一致すると、 提供されたユーザ名が一致したユーザ名に置き換わり、 引続き以降の行の処理が行なわれていくことになる。 .sp \'#\' や \';\' で始まる行は無視される。 .sp \'!\' ではじまる行はがあると、 以降の行でユーザ名が一致した時点で比較処理は中止される。 それ以外の場合、この比較処理はすべての行に対して継続される。 ファイルの最後でワイルドカードによるマッピングを行なっている場合には、 \'!\' を使うとかなり便利である。 .sp たとえば、\fBadmin\fR や \fBadministrator\fR といった名前から UNIX の \fBroot\fR へのマッピングを行ないたい場合は、以下のように記述する: .sp .nf \fBroot = admin administrator\fR .fi また、UNIX の \fBsystem\fR グループに所属するユーザを \fBsys\fR という UNIX ユーザに置き換えるには、以下のように記述する: .sp .nf \fBsys = @system\fR .fi .sp username map のファイル中には幾つのマッピングの設定を行なっても構わない。 .sp システムが NIS の NETGROUP オプションをサポートしている場合、 グループ名の一致処理を行なう際には、 \fI/etc/group\fR データベースより先にネットグループのデータベースが調べられる。 .sp 空白を含む Windows のユーザ名は、 ダブルクォートで両側を括って記述する。たとえば、 .sp .nf \fBtridge = "Andrew Tridgell"\fR .fi は、Windows のユーザ名 "Andrew Tridgell" を UNIX のユーザ名 "tridge" に置き換える。 .sp 以下の例は、 mary と fred を UNIX ユーザ sys に置き換え、 そのほかのユーザを guest に置き換える。 \'!\'を利用することで、一致した行以降の処理を抑止していることに注意。 .sp .nf !sys = mary fred guest = * .fi .sp ユーザ名が現われる箇所全てに置き換えの結果が適用されることに注意。 例えば、\e\eserver\efred に接続する場合、\fB fred\fR が \fBmary\fR に置き換えられる場合は、 実際に接続する先は \e\eserver\emary であり、パスワードも \fBfred\fR ではなく、\fBmary\fR のものを入力することが必要になる。この唯一の例外は、(設定している場合に) password server に対してユーザ名を送出するときである。 password server は、 クライアントが提供したユーザ名を置換なしでそのまま受け取る。 .sp 逆のマッピングは行われないことにも注意。この影響が現われるのは印刷時である。 Windows for Workgroup におけるプリントマネージャは、 置き換えが行われたユーザが印刷ジョブを所有していないと判断するため、 印刷ジョブ削除時にトラブルが発生する。 .sp Samba 3\.0\.8 より前のバージョンでは、Kerberos ログインが行なわれる場合にのみ、完全ユーザ名がサポートされており、 NTLM[SSP] によるユーザ認証の際には、ユーザ名部分のみがマッチングの対象となっていた。 このため、同一のサーバに対するアクセスで、結果が一致しないという事態が発生していた。 .sp 以下の機能は、Samba 3\.0\.8 以降のものである。 .sp ローカル認証の場合、username map パラメータは、コネクションに対する認証が行なわれる際のユーザ名に対して適用される。 .sp 認証を外部のドメインコントローラに依存している場合、 smbd は username map パラメータを、ユーザ認証が成功した場合にのみ、認証された完全ユーザ名(例: DOMAIN\euser) に対して適用する。 .sp 以下に設定例を示す: .sp .nf username map = /usr/local/samba/lib/users\.map .fi .sp デフォルト値: \fB\fIusername map\fR = # no username map \fR .RE .PP username map script (G) .RS 4 このパラメータは username map パラメータと排他的な関係にある。 このパラメータは、（認証要求で渡されたユーザ名を示す）コマンドライン引数を1つだけとり、 標準出力に（マッピングされたアカウント名を示す）文字列を1行返却する 外部プログラム、もしくはスクリプトを指定する。 これにより、ユーザ名のマッピング表を LDAP や NIS などのディレクトリサービス上に格納することが可能となる。 .sp デフォルト値: \fB\fIusername map script\fR = \fR .sp 設定例: \fB\fIusername map script\fR = /etc/samba/scripts/mapusers\.sh \fR .RE .PP usershare allow guests (G) .RS 4 このパラメータは、ユーザ定義共有に認証されていないユーザのアクセスを許可するかどうかを制御する。 これは、ユーザが共有の定義において \fIguest ok = yes\fR オプションを付与した共有を作成することの許可と同義である。 セキュリティ上注意を要するため、デフォルト値は無効となっている。 .sp デフォルト値: \fB\fIusershare allow guests\fR = no \fR .RE .PP usershare max shares (G) .RS 4 このパラメータは(訳注: usershare path パラメータで定義された) ユーザ定義共有ディレクトリの所有グループに所属するユーザによって作成可能なユーザ定義共有の最大数を設定する。 0 (デフォルト) の場合、ユーザ定義共有は作成できない。 .sp デフォルト値: \fB\fIusershare max shares\fR = 0 \fR .RE .PP usershare owner only (G) .RS 4 このパラメータは、ユーザ定義共有として公開されるパスが、 ユーザ定義共有を作成しようとしているユーザの所有であることを必須とするかどうかを制御する。 必須とした場合 (デフォルト値) 、smbd は公開しようとしているディレクトリが、ユーザ定義共有の設定ファイルの所有者と同一であることを確認し、もし異なっていた倍は作成を拒否する。 必須としなかった場合、こうした確認は行なわれず、誰が所有しているかに関わらず、ディレクトリの公開が可能となる。 .sp デフォルト値: \fB\fIusershare owner only\fR = True \fR .RE .PP usershare path (G) .RS 4 このパラメータにより、ユーザ定義共有の設定ファイルが格納されるファイルシステム上のディレクトリの絶対パスが指定される。 このディレクトリは root の所有でなければならず、その他(other)がアクセス可能であってはならず、グループの所有者のみが書き込み可能となっている必要がある。 加えて、ファイルの所有者による名前の変更と削除を制限するため、「sticky」ビットが設定されている必要がある (これは /tmp ディレクトリに対して通常行なわれる設定と同義である)。 このディレクトリのグループ所有者が、ユーザ定義共有を作成可能なユーザとなる。 このパラメータが設定されていない場合、誰もユーザ定義共有を作成できない。 .sp 一例として、ユーザ定義共有のディレクトリを /use/local/samba/lib/usershares に設定する場合、以下のようにする。 .sp .nf ls \-ld /usr/local/samba/lib/usershares/ drwxrwx\-\-T 2 root power_users 4096 2006\-05\-05 12:27 /usr/local/samba/lib/usershares/ .fi .sp この場合、「power_users」グループのメンバのみがユーザ定義共有を作成できる。 .sp デフォルト値: \fB\fIusershare path\fR = NULL \fR .RE .PP usershare prefix allow list (G) .RS 4 このパラメータには、ユーザ定義共有による共有を許可する絶対パス名のリストを指定する。 共有しようとしているパス名の先頭がこのリストに指定されたパス名のいずれかと合致していない場合、公開は許可されない。 これにより、Samba の管理者がユーザ定義共有による公開を可能とするディレクトリを制限することが可能となる。 .sp 「usershare prefix deny list」と「usershare prefix allow list」の両方が定義されている場合は、 拒否リスト側が先に処理され、後から許可リストが処理される。 これにより、拒否リストによる制限を優先している。 .sp デフォルト値: \fB\fIusershare prefix allow list\fR = NULL \fR .sp 設定例: \fB\fIusershare prefix allow list\fR = /home /data /space \fR .RE .PP usershare prefix deny list (G) .RS 4 このパラメータには、ユーザ定義共有による公開を拒否する絶対パス名のリストを指定する。 公開しようとしているパス名の先頭がこのリストに指定されたパス名のいずれかと合致している場合、公開は許可されない。 このリストに指定されたパス名のいずれとも合致していないパス名から始まるパス名は、ユーザ定義共有として公開を許可することができる。 これにより、Samba の管理者がユーザ定義共有による公開を可能とするディレクトリを制限することが可能となる。 .sp 「usershare prefix deny list」と「usershare prefix allow list」の両方が定義されている場合は、 拒否リスト側が先に処理され、後から許可リストが処理される。 これにより、拒否リストによる制限を優先している。 .sp デフォルト値: \fB\fIusershare prefix deny list\fR = NULL \fR .sp 設定例: \fB\fIusershare prefix deny list\fR = /etc /dev /private \fR .RE .PP usershare template share (G) .RS 4 ユーザ定義共有では、path 、 guest ok といった幾つかのパラメータしか設定できないが、 このパラメータにより、ユーザ定義共有を既存の共有から「複製」することが可能となる。 「usershare template share」に既存の共有名が設定されていた場合、作成されるすべてのユーザ定義共有では、デフォルト値としてこの共有に設定されたパラメータが用いられる。 .sp 対象となる共有には、「\-valid = False」の設定をテンプレートの設定として行なっておくことで、実際のファイル共有として機能しないようにしておくことができる。 これにより、ユーザ定義共有のテンプレートとして用いつつ、その共有が実際に公開されないようにできる。 .sp デフォルト値: \fB\fIusershare template share\fR = NULL \fR .sp 設定例: \fB\fIusershare template share\fR = template_share \fR .RE .PP use sendfile (S) .RS 4 このパラメータが \fByes\fR であり、 かつ Samba の動作する OS で \fBsendfile() \fR システムコールがサポートされている場合、いくつかの SMB read コール (主に ReadAndX と ReadRaw) において排他的 oplock が行なわれているファイルに対して効率的な sendfile システムコールが使用される。これにより、システムの CPU の効率的な使用が行なわれ、 Samba の動作も高速化するだろう。 Samba は NT LM 0\.12 未満のプロトコルを用いるクライアントや Windows 9x ( Linux から sendfile を用いると、これらのクライアントの処理が失敗する) に対しては、自動的にこのオプションを無効にする。 .sp デフォルト値: \fB\fIuse sendfile\fR = false \fR .RE .PP use spnego (G) .RS 4 このパラメータの値により、 Samba が Windows 2000 や Windows XP クライアントの間で行なわれる認証の際に Simple and Protected NEGOciation (RFC2478 で規定) の使用を試みるかどうかが制御される。 .sp SPNEGO の実装に問題点が発見されない限り、 これを無効にする必要性はない。 .sp デフォルト値: \fB\fIuse spnego\fR = yes \fR .RE .PP utmp (G) .RS 4 この真偽値パラメータは、 Sambaが \fB\-\-with\-utmp\fR オプションで configure され、コンパイルされた時にのみに有効である。 このパラメータを \fByes\fR に設定することで、 Sambaは utmp または utmpx レコード(UNIXシステムに依存)に、 Sambaサーバへの接続時の情報を追加するようになる。 このパラメータにより、 Sambaの共有への接続を記録することが可能になる。 .sp utmp レコードの仕様のため、接続する個々のユーザ毎に一意な識別子が生成されている必要がある。 この、オプションを有効にすることで、 n^2 アルゴリズムを使ってその番号を検索する処理が発生する。 大規模システムの場合、この処理がパフォーマンスに影響を与える場合も考えられる。 .sp デフォルト値: \fB\fIutmp\fR = no \fR .RE .PP utmp directory (G) .RS 4 このパラメータは、 Sambaが \fB\-\-with\-utmp\fR オプションで configure され、コンパイルされた時にのみに有効である。 このパラメータは、 Sambaサーバへの接続を記録する utmp または utmpx ファイル (UNIXシステムに依存)が存在するディレクトリを指定する。 デフォルトではこの値は設定されない。 この場合、システムが利用している utmp ファイルが使われる (Linux の場合、通常 \fI/var/run/utmp\fR にある)。 .sp デフォルト値: \fB\fIutmp directory\fR = # Determined automatically \fR .sp 設定例: \fB\fIutmp directory\fR = /var/run/utmp \fR .RE .PP \-valid (S) .RS 4 このパラメータは、共有が有効であり、使用可能かどうかを制御する。 このパラメータを false に設定した場合、いかなる方法を用いても、共有を表示したり、共有に対してアクセスしたりすることができなくなる。 .sp このオプションは一般ユーザが利用すべきものではなく、開発者の利便性のために設けられている。 Samba はこのオプションを内部的に用いて、共有が削除されたことを記録している。 .sp デフォルト値: \fB\fI\-valid\fR = yes \fR .RE .PP valid users (S) .RS 4 サービスにアクセスできるユーザのリストを指定する。 \'@\'、\'+\'、\'&\' からはじまる名前は、 \fIinvalid users\fR パラメータで説明した規則にしたがって解釈される。 .sp このパラメータが設定されていない場合(既定値)、どのようなユーザでもログインできる。このリストと \fIinvalid users\fR の両方に含まれるユーザのアクセスは拒否される。 .sp \fI%S\fR は、現在のサービス名に置き換えられる。 これは [homes] セクションで用いると便利である。 .sp デフォルト値: \fB\fIvalid users\fR = # No valid users list (anyone can login) \fR .sp 設定例: \fB\fIvalid users\fR = greg, @pcusers \fR .RE .PP veto files (S) .RS 4 このパラメータは、 一覧することもアクセスすることもできないファイルとディレクトリのリストを指定する。 リストの各エントリは \'/\' で区切ること。これにより、 エントリ中に空白文字を用いることが可能になっている。 \'*\'と \'?\'は DOS のワイルドカードと同様、 複数のファイルやディレクトリを指定するために利用できる。 .sp 各エントリはDOSの形式ではなく、 UNIXでのパス形式である必要があり、 UNIX のディレクトリ区切りである \'/\'を\fB含めてはならない\fR。 .sp case sensitive オプションが、この処理に影響することに注意。 .sp veto files パラメータの利用に際して注意すべき重要な点が、 ディレクトリ削除時の動作である。 削除されるディレクトリに veto files パラメータに一致するファイルが存在する場合、 delete veto files パラメータが \fIyes\fR でない限り、削除は\fB失敗\fRする。 .sp このパラメータを設定した場合は、 ファイルやディレクトリの一覧を取得する際、 すべてのファイルとディレクトリについて、 このパラメータのマッチング処理が行なわれるようになるため、 Samba の性能に影響が発生する。 .sp 以下に設定例を記載する: .sp .nf ; Veto any files containing the word Security, ; any ending in \.tmp, and any directory containing the ; word root\. veto files = /*Security*/*\.tmp/*root*/ ; Veto the Apple specific files that a NetAtalk server ; creates\. veto files = /\.AppleDouble/\.bin/\.AppleDesktop/Network Trash Folder/ .fi .sp デフォルト値: \fB\fIveto files\fR = アクセスできないファイルやディレクトリはない \fR .RE .PP veto oplock files (S) .RS 4 このパラメータは、 oplocks パラメータが有効になっている共有でのみ意味がある。 Samba の管理者は、このパラメータを使って リストにマッチしたファイルに対する oplock を禁止することができる。 リストは veto files パラメータで利用されているものと同様の形式である。 .sp クライアントによるロック競合が激しいファイルに対して、 このオプションを適用したいということがあるだろう。 例としては NetBench SMB ベンチマーク・プログラムがある。 このプログラムは \fI「\.SEM」\fR で終わる名前のファイルに対して激しい競合を発生させる。 これらのファイルに対する oplock を禁止するためには、 以下の設定例のように指定する ([global] セクションか、 Net Bench 用の共有のいずれかにおいて)。 .sp 以下に設定例を示す。 .sp .nf veto oplock files = /\.*SEM/ .fi .sp デフォルト値: \fB\fIveto oplock files\fR = # oplock 取得を禁止されるファイルやディレクトリはない \fR .RE .PP vfs object .RS 4 このパラメータは、vfs objectsの別名である。 .RE .PP vfs objects (S) .RS 4 このパラメータは、 Samba の VFS I/O 操作において用いられるバックエンド名を指定する。デフォルトでは通常のディスク I/O 操作が行なわれるが、 VFS オブジェクトによりこの操作を変更することが可能である。 .sp デフォルト値: \fB\fIvfs objects\fR = \fR .sp 設定例: \fB\fIvfs objects\fR = extd_audit recycle \fR .RE .PP volume (S) .RS 4 このパラメータにより、共有のボリュームラベルの設定が可能になる。 これは、特定のボリューム名が必要なインストールプログラムを格納した CD\-ROM を共有する際に便利である。 .sp デフォルト値: \fB\fIvolume\fR = # the name of the share \fR .RE .PP wide links (S) .RS 4 このパラメータは、 UNIXファイルシステム上のリンクをサーバが追跡するかどうかを制御する。 サーバが公開するディレクトリツリー内部へのリンクは、 常に許可されている。このパラメータは、 公開されているディレクトリツリー外部へのアクセスを制御する。 .sp このパラメータを no に設定すると、 リンク先のチェックを行なうための余分なシステムコールを実行する必要があるため、 サーバのパフォーマンスに悪影響を及ぼすことに注意。 .sp デフォルト値: \fB\fIwide links\fR = yes \fR .RE .PP winbind cache time (G) .RS 4 このパラメータにより、 \fBwinbindd\fR(8) デーモンが Windows NT Server に問い合わせを行なう代わりにキャッシュしたユーザとグループの情報を使用する時間を秒単位で指定する。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note このキャッシュは、認証要求には用いられない。 認証要求は常にその場で処理される。 デフォルト値: \fB\fIwinbind cache time\fR = 300 \fR .RE .PP winbind enum groups (G) .RS 4 非常に大規模な環境において、 \fBwinbindd\fR(8) を使用する際には、 \fBsetgrent()\fR, \fBgetgrent()\fR や \fBendgrent()\fR といったシステムコール群の呼び出しによるグループの一覧取得を抑止する必要があるかも知れない。 \fIwinbind enum groups\fR パラメータが \fBno\fR の場合、 \fBgetgrent()\fR システムコールの呼び出しは、全くデータを返却しない。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Warning グループ一覧(enumeration)を無効にするとプログラムによっては異常動作を引き起こす恐れがある。 デフォルト値: \fB\fIwinbind enum groups\fR = no \fR .RE .PP winbind enum users (G) .RS 4 非常に大規模な環境において、 \fBwinbindd\fR(8) を使用する際には、 \fBsetpwent()\fR, \fBgetpwent()\fR や \fBendpwent()\fR といったシステムコール群の呼び出しによるユーザの一覧取得を抑止する必要があるかも知れない。 \fIwinbind enum users\fR パラメータが \fBno\fR の場合、 \fBgetpwent()\fR システムコールの呼び出しは、全くデータを返却しない。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Warning ユーザ一覧(enumeration)を無効にするとプログラムによっては異常動作を引き起こす恐れがある。 例えば、finger プログラムは、全てのユーザの一覧にアクセスできる前提で、ユーザ名のマッチングを行なっている。 デフォルト値: \fB\fIwinbind enum users\fR = no \fR .RE .PP winbind nested groups (G) .RS 4 このパラメータを yes にすると、グループの入れ子が可能になる。 入れ子になるグループは、ローカルグループやエイリアスと呼ばれる。 これは、Windows のローカルグループに対応するものである。 入れ子になるグループは、各マシンローカルで定義され (ただしドメインコントローラ間では SAM を共有するため共有され)、 信頼される任意の SAM で定義されたユーザやグローバルグループを含めることができる。 入れ子になるグループを用いるには、nss_winbind を有効にしておく必要がある。 .sp デフォルト値: \fB\fIwinbind nested groups\fR = yes \fR .RE .PP winbind nss info (G) .RS 4 このパラメータは、Winbind が Name Service Information からユーザのホームディレクトリやログインシェルの情報を取得する方法を指定する。 現在のところ、以下の値が利用できる: .sp .RS 4 \h'-04'?\h'+03'\fItemplate\fR \- デフォルト値であり、\fItemplate shell\fR および \fItemplate homedir\fR パラメータの値を用いる。 .RE .sp .RS 4 \h'-04'?\h'+03'\fIsfu\fR \- Samba が security = ads で実行されており、Active Directory の DC が Microsoft Services for Unix (SFU) の LDAP スキーマをサポートしている場合、Winbind 機構はログインシェルおよびホームディレクトリ属性を DC から直接取得する。 UID や GID 情報を DC から取得したい場合は、 \fIidmap backend\fR = idmap_ad も設定すること。 .RE .IP "" 4 .sp デフォルト値: \fB\fIwinbind nss info\fR = template \fR .sp 設定例: \fB\fIwinbind nss info\fR = template sfu \fR .RE .PP winbind offline logon (G) .RS 4 このパラメータは、Winbind 機構で \fIpam_winbind\fR モジュールにキャッシュされた資格情報を用いたログインを可能にするかどうかを指定する。 有効にした場合、winbindd は、ログインに成功したユーザの資格情報を、暗号化してローカルのキャッシュに格納する。 .sp デフォルト値: \fB\fIwinbind offline logon\fR = false \fR .sp 設定例: \fB\fIwinbind offline logon\fR = true \fR .RE .PP winbind refresh tickets (G) .RS 4 このパラメータは Winbind 機構が \fIpam_winbind\fR モジュールから取得した Kerberos チケットをリフレッシュするかどうかを制御する。 .sp デフォルト値: \fB\fIwinbind refresh tickets\fR = false \fR .sp 設定例: \fB\fIwinbind refresh tickets\fR = true \fR .RE .PP winbind separator (G) .RS 4 このパラメータは、 \fIDOMAIN \fR\e\fIuser\fR の形式でユーザ名を表示する際に使用される区切り文字を指定する。 このパラメータは UNIX のサービスが \fIpam_winbind\.so\fR および \fInss_winbind\.so\fR モジュールを使用する時のみ適用される。 .sp + 文字は NIS において /etc/group 中で特別な意味を持っているため、このパラメータを + に設定した場合、少なくとも glibc システムにおいては問題が発生する。 .sp デフォルト値: \fB\fIwinbind separator\fR = \'\e\' \fR .sp 設定例: \fB\fIwinbind separator\fR = + \fR .RE .PP winbind trusted domains only (G) .RS 4 このパラメータは、Samba が管理するドメインの、他の Samba メンバーサーバに対して、NIS、rsync や LDAP で配布されている UNIX アカウントの uid を、プライマリドメインの winbindd ユーザの uid として使用するのを目的として設計された。これにより、DOMAIN\euser1 というユーザは、新しい uid が割り当てられる代わりに /etc/passwd の user1 というアカウントに割り当てられる。 .sp デフォルト値: \fB\fIwinbind trusted domains only\fR = no \fR .RE .PP winbind use default domain (G) .RS 4 このパラメータにより、 \fBwinbindd\fR(8) デーモンが、ドメイン名が付加されていないユーザ名を扱う方式が指定される。ドメイン名が付加されていないユーザは、winbindd サーバのドメインのものとして扱われる。 Windows ユーザにとっては、どちらでもよい話であるが、 SSH, FTP や e\-mail を利用する際に、 UNIX システム本来のやり方に近い方法で指定することが可能となる。 .sp デフォルト値: \fB\fIwinbind use default domain\fR = no \fR .sp 設定例: \fB\fIwinbind use default domain\fR = yes \fR .RE .PP wins hook (G) .RS 4 Samba が WINS サーバとして動いている場合、このオプションによって、 WINS データベースに対して変更が行なわれる度に外部のプログラムが起動されるようになる。このオプションの主な目的は、ダイナミック DNS のような外部の名前解決データベースの動的な更新を実現することである。 .sp wins hook パラメータは、以下の形式で呼びだされるスクリプト又は実行形式のプログラムを指定する。 .sp \fBwins_hook operation name nametype ttl IP_list\fR .sp .RS 4 \h'-04'?\h'+03'最初の引数は操作の指定であり、 "add", "delete", "refresh" のいずれかを取る。 ほとんどの場合、残りのパラメータで提供される情報が不足している場合、操作は無視される(訳注: sufficient は insufficient の typo と思われる)。 "refresh" は名前がまだ追加されていない時点で呼び出されることがあるので注意。この場合操作は add として扱われる。 .RE .sp .RS 4 \h'-04'?\h'+03'3番目の引数は NetBIOS名のタイプで、2桁の16進数である。 .RE .sp .RS 4 \h'-04'?\h'+03'4番目の引数は 名前の TTL(生存時間) で秒数単位である。 .RE .sp .RS 4 \h'-04'?\h'+03'5番目以降の引数は、その名前で現在登録されているIPアドレスである。リストが空の場合、名前は削除される。 .RE .IP "" 4 BIND の動的なDNS更新プログラムである \fBnsupdate\fR を呼び出すスクリプトのサンプルが、 Samba ソースコードの examples ディレクトリに格納されている。 .sp \fBデフォルト値なし\fR .RE .PP wins proxy (G) .RS 4 この真偽値パラメータにより、 \fBnmbd\fR(8) が別のホストの代理としてブロードキャストによる名前問い合わせに応答するかどうかが設定される。古いクライアントの為に、このパラメータを \fByes\fR にする必要があるかも知れない。 .sp デフォルト値: \fB\fIwins proxy\fR = no \fR .RE .PP wins server (G) .RS 4 このパラメータは、 \fBnmbd\fR(8) が名前を登録する WINS サーバの IP アドレス(もしくはDNS名: IPアドレスが望ましい)を指定する。ネットワークに WINS サーバが存在している場合は、このパラメータを WINS サーバの IP アドレスに設定すること。 .sp 複数サブネットからなるネットワークの場合は、このパラメータで WINS サーバを指定すべきである。 .sp 複数の名前空間が存在している場合、各々の WINS サーバに「タグ」をつけることが可能である。同じタグのついたサーバ内では 1 台の(動作中の)サーバに対してのみ、名前の問い合わせが行なわれる。タグはコロンによって IP アドレスと区切られる。 .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br Note 複数のサブネットからなるネットワークで、サブネット越しのブラウジングを正しく機能させたい場合は、 Samba で WINS サーバの設定を行なう必要がある。 Samba3\-HOWTO の Network Browsing 章を参照のこと。 .sp デフォルト値: \fB\fIwins server\fR = \fR .sp 設定例: \fB\fIwins server\fR = mary:192\.9\.200\.1 fred:192\.168\.3\.199 mary:192\.168\.2\.61 # この例では、名前の問い合わせを行なう際に、 192\.9\.200\.1 に最初に問い合わせが行なわれる。応答がなかった場合は、 192\.168\.2\.61 に問い合わせが行なわれる。いずれのサーバからにも名前が存在しなかった場合、 192\.168\.3\.199 に対して問い合わせが行なわれる。 \fR .sp 設定例: \fB\fIwins server\fR = 192\.9\.200\.1 192\.168\.2\.61 \fR .RE .PP wins support (G) .RS 4 この真偽値パラメータにより、 Samba の \fBnmbd\fR(8) プロセスを WINS サーバして機能させるかどうかが設定される。複数サブネットに及ぶネットワークを構築しており、いずれかの \fBnmbd\fR を WINS サーバとして機能させようとしない限り、このパラメータを \fByes\fR にしないこと。 .sp ネットワーク上の複数のマシンで、このパラメータを \fByes\fR に設定することが\fB絶対に\fRないように注意すること。 .sp デフォルト値: \fB\fIwins support\fR = no \fR .RE .PP workgroup () .RS 4 これは、クライアントが問い合わせを行なった際に、 サーバが表示されるワークグループを設定する。 このパラメータにより、 security = domain の設定におけるドメイン名も設定されることに注意。 .sp デフォルト値: \fB\fIworkgroup\fR = WORKGROUP \fR .sp 設定例: \fB\fIworkgroup\fR = MYGROUP \fR .RE .PP writable .RS 4 このパラメータは、writeableの別名である。 .RE .PP writeable (S) .RS 4 read only の反意語である。 .sp \fBデフォルト値なし\fR .RE .PP write cache size (S) .RS 4 この数値パラメータを 0 以外に設定すると、 Sambaは oplock された各ファイルに対してメモリキャッシュを作成するようになる (oplock されないファイルに対しては \fB 行なわれない \fR。 クライアントがディスクへの書き出しを直接要求していない書き込みは全て、 可能な限りこのキャッシュに蓄積される。 キャッシュはキャッシュに適さない位置からの書き込みが行なわれた時か、 ファイルがクライアントによってクローズされた時に書き出される。 データがキャッシュ中に存在していれば、 ファイルからの読み出しにキャッシュが使用される。 .sp Sambaは、このキャッシュにより、 RAID ディスクに対して適切な書き込みサイズでクライアントからの書き込みを処理できるようになり (例えば、書き込みサイズをRAIDのストライプサイズに合わせる)、 ディスクサブシステムがボトルネックとなっているが、 ユーザ空間のプログラム向けの空きメモリがあるシステムのパフォーマンスを向上させることができる。 .sp この数値パラメータにより、(oplock を行なったファイル単位での) キャッシュサイズがバイト単位で指定される。 .sp デフォルト値: \fB\fIwrite cache size\fR = 0 \fR .sp 設定例: \fB\fIwrite cache size\fR = 262144 # for a 256k cache size per file \fR .RE .PP write list (S) .RS 4 これは、サービスに対して読みとりおよび書き込み権が与えられるユーザのリストである。 接続したユーザがこのリストに存在している場合は、 例え read only オプションが no であっても書き込み権が与えられる。このリストには、 @group という形式を用いることでグループ名を含めることもできる。 .sp Samba 3\.0 において、このパラメータは security = share では動作しない。これは仕様である。 .sp デフォルト値: \fB\fIwrite list\fR = \fR .sp 設定例: \fB\fIwrite list\fR = admin, root, @staff \fR .RE .PP write raw (G) .RS 4 このパラメータは、クライアントからのデータ転送時に、 サーバ側で raw write SMB のサポートを行なうかどうかを制御する。 このパラメータを変更する必要はないだろう。 .sp デフォルト値: \fB\fIwrite raw\fR = yes \fR .RE .PP wtmp directory (G) .RS 4 このパラメータは、 Sambaが \fB\-\-with\-utmp\fR オプションで configure され、コンパイルされた時にのみに有効である。 このパラメータは、 Sambaサーバへの接続を記録する wtmp または wtmpx ファイル (UNIXシステムに依存)が存在するディレクトリを指定する。 utmp directory との違いは、ユーザ情報がユーザのログオフ後も記録され続ける点である。 .sp デフォルトではこの値は設定されない。 この場合、システムが利用している utmp ファイルが使われる (Linux の場合、通常 \fI/var/run/wtmp\fR にある)。 .sp デフォルト値: \fB\fIwtmp directory\fR = \fR .sp 設定例: \fB\fIwtmp directory\fR = /var/log/wtmp \fR .RE .SH "注意" .PP 設定ファイルでは、スペースを含むサービス名も利用できるが、 クライアント側のソフトウェアで禁止されているかもしれない。 文字列比較を行なう際にスペースは常に無視されるため、 問題は発生しないはずであるが、可能性は考慮しておく必要がある。 .PP 同様の注意事項として、多くのクライアント、特に DOS クライアントでは、サービス名が最長8文字に制限されている。 \fBsmbd\fR(8) にはそのような制限はなく、 こうしたクライアントからの接続要求は、サービス名が切り捨てられてしまう ために失敗することになる。このため、サービス名の長さは、最大 8 文字に制限すべきである。 .PP [homes] および [printers] という特殊セクションにより、 管理者の負担を軽減することができるが、デフォルトの設定の組合せ方に よっては、予期しない設定が行なわれる可能性もある。これらのセクションの 設定を行なう際には、特に注意深く行なうこと。特にスプールディレクトリの パーミッションが適切であることを確認しておくこと。 .SH "バージョン" .PP このマニュアルページは Samba 3\.0 対応のものである。 .SH "関連項目" .PP \fBsamba\fR(7), \fBsmbpasswd\fR(8), \fBswat\fR(8), \fBsmbd\fR(8), \fBnmbd\fR(8), \fBsmbclient\fR(1), \fBnmblookup\fR(1), \fBtestparm\fR(1), \fBtestprns\fR(1) .SH "作者" .PP オリジナルの Samba ソフトウェアと関連するユーティリティは、 Andrew Tridgell によって作成された。現在 Samba は Samba Team によって、 Linux カーネルの開発と同様のオープンソースプロジェクトとして開発が 行なわれている。 .PP オリジナルの Samba マニュアルページは Karl Auer によって 作成された。マニュアルページは YODL 形式 (ftp://ftp\.icce\.rug\.nl/pub/unix/ で入手可能な優れた オープンソースソフトウェア) に変換され、Samba 2\.0 リリースに伴い、 Jeremy Allison によって更新された。Samba 2\.2 における DocBook 形式への変換は、Gerald Carter によって行なわれた。Samba 3\.0 における DocBook XML 4\.2 形式への変換は Alexander Bokovoy によって行われた。 .SH "日本語訳" .PP このマニュアルページは Samba 3\.0\.23d 対応のものである。 .PP Samba 3\.0\.23d 対応の翻訳は、たかはしもとのぶ (monyo@samba\.gr\.jp) によって行なわれた。