名前

vfs_fruit — OS X と Netatalk との相互運用性を強化する

書式

vfs objects = fruit

説明

この VFS モジュールは samba(7)システムの一部である。

The vfs_fruit モジュールは、Apple SMB クライアント との互換性向上と、Netatalk 3 AFP ファイルサーバーとの相互運用性を提供する。

このモジュールは、もしも文字変換をするのであれば、 vfs_catia といっしょに使うべきであり、さらに、 vfs_streams_xattr と共に使わなければならない。 正しい設定方法は、例 の節を参照のこと。

モジュールは、共有に対して、代替データストリーム(ADS) のサポートと、OS X 特有のストリーム "AFP_AfpInfo" と "AFP_Resource" を横取りし、それを特別な方法で扱う機能を有効にする。 その他すべての名前付きストリームは、vfs_fruit といっしょにロードされねばならないvfs_streams_xattr にゆだねられる。

vfs_fruit は、"ea support = yes" が必要である。

vfs_fruit が有効な共有と無効な共有が混在している場合は注意すること。 OS X クライアントは最初に tcon を行う際に SMB2 AAPL プロトコル拡張の ネゴシエーションを行う。そのため、最初に tcon を行った共有で vfs_fruit が無効の場合、すべての共有で AAPL が無効となってしまう。

共有で OS X クライアント向けの代替データストリーム(訳注:ADS)の サポートを有効化することにより、Apple 固有の SMB サーバー実装と同等の動作が 実現する。これにより、Samba が大文字小文字判別に起因する 顕著なパフォーマンス低下が抑止される。

OS X メタデータとリソースフォークストリームは、Netatalk 3 と 互換性のある方法で、下記のように設定することにより格納される。 fruit:resource = file と fruit:metadata = netatalk

OS X は、NTFS の不正な文字を、SMB要求中で、Unicode のプライベート領域にマップする。 fruit:encoding = native を設定することにより、 すべてのマップされた文字は ネイティブなASCII文字に変換される。

最後に、共有アクセスモードは、 fruit:locking = netatalk を設定することにより、Netatalk AFP 共有モードに対して チェックすることもできる。

このモジュールは、このマニュアルページで言及されている 物以外に対してはスタックできない。

グローバルオプション

以下に示すオプションは smb.conf のグローバルセクションに 定義しなければならず、共有ごとに設定しても無効である。

fruit:aapl = yes | no

グローバルオプション。Appleの コードネーム AAPLの、SMB2+拡張を 有効にするかどうかを指定する。規定値では、 yesである。この拡張は、Macからの接続時に いくつかの足らない機能を補う:

  • ディレクトリ一覧表示は、Macのファイルシステム メタデータで強化され(UNIXモード、FinderInfo、リソースフォーク サイズと実行パーミッション)、その結果、驚異的な性能向上が得られ るので、Mac クライアントは、ディレクトリエントリごとに、個別に このメタデータをフェッチする必要がない。

  • ディレクトリエントリのUNIX モードを問い合わせ/ 変更する機能。

ディレクトリ一覧表示時に、特定のMacメタデータの計算を無効 にするときに使う、共有単位のオプション群がある。規定値では すべて有効である:

  • readdir_attr:aapl_rsize = true | false

  • readdir_attr:aapl_finder_info = true | false

  • readdir_attr:aapl_max_access = true | false

fruit:nfs_aces = yes | no

NFS ACE 経由での、ディレクトリエントリのUNIX モードを問合せ/変更する 機能を有効にするかどうかの指定で、既定値は yes。

fruit:copyfile = yes | no

OS X 固有の、すべての付属するメタデータと一緒にファイル全体 コピーを要求する copychunk ioctl を有効にするかの指定。

注意: copyfile 要求は、サーバーがコピーを行っている間は クライアントに対してブロックされることに注意。

規定値はnoである。

fruit:zero_file_id = yes | no

グローバルオプション。クライアントによる AAPL ネゴシエート 後に、ディスク上のファイル識別子の問い合わせに対してゼロを返すか どうかを指定する。

Mac アプリケーションや Mac SMB クライアントコードは、 ディスク上のファイル識別子が HFS+ カタログノード識別子（HFS+ Catalog Node Identifier; CNID）として機能することを想定しているが、 Samba はこうした機能を提供していない。これは利便性の問題を 引き起こすだけでなく、データ損失を引き起こすことすらある。 ファイル識別子としてゼロが返ると、Mac クライアントはサーバーから 返るファイル識別子を信用しなくなり、使わなくなる。

既定値は yes である。

オプション

以下に示すオプションは smb.conf 内のグローバルセクションと 各共有ごとのいずれにおいても設定できる。

fruit:resource = [ file | xattr | stream ]

どこに OSX リソースフォークを格納するかを制御する:

4.6.0以前の古い Samba バージョンすべてには スペルミスの バグがあり、このオプションは fruit:ressource 、すなわち2つの s が ついている形でも提供されている。

  • file (既定値) - OS X と Netatalk 互換の ._ AppleDouble ファイル を使う。

  • 拡張属性(xattr)を使用する。これは、大きなサイズの拡張属性をサポート するファイルシステムと、拡張属性に準拠した ファイルIO APIが必要となる。つまり、 Solaris と Solaris派生プラットフォームのZFSが必須である。

  • stream - VFSスタックの、次のモジュールに、ストリームを渡す

fruit:metadata = [ stream | netatalk ]

OS X メタデータストリームが格納される場所を指定する:

  • netatalk (既定値) - Netatalk 互換の xattr を使う

  • stream - VFSスタックの次のモジュールにストリームを渡す

fruit:locking = [ netatalk | none ]

  • none (既定値) - cross protocol lockingを使わない

  • netatalk - Netatalk で cross protocol locking を使う

fruit:encoding = [ native | private ]

ファイルシステムに格納される、OS X クライアントで一般的に 使われる、不正なNTFS ASCII文字セットを制御:

  • private (規定値) - OS Xクライアントによってエンコードされた形で文字を格納: Unicodeプライベート領域にマップされる

  • native - そのままのASCII値として文字を格納。 重要:このオプションは、例 で説明している ように、VFS モジュールスタック中で vfs_catia を必要とする。

fruit:veto_appledouble = yes | no

Mac リソースフォークを格納する目的のため、 vfs_fruit それ自身に よって作成された、内部 AppleDouble ファイルの閲覧と変更を、クライアントから 防止するため、._ AppleDouble ファイルを見せなくするかどうかの指定。

._ ファイルを見せなくすると、いくつかのアプリケーションが動かなくなる ことがある。たとえば、 ._ ファイルを含むため、Mac クライアントからの Mac ZIP の回答は失敗する。このオプションを false に設定すると、これを修正するが、 内部的に作成された ._ ファイルの露出をリークする概念は、他の不明な 副作用を引き起こすかもしれない。

既定値はyesである。

fruit:posix_rename = yes | no

OS X クライアントで、POSIX の改名動作を有効にするかどうか。 これがないと、クライアントが、対象ディレクトリ中(再帰的に!)に オープンしているファイルがあると、ディレクトリは改名出来ない。

既定値はyesである。

readdir_attr:aapl_rsize = yes | no

SMB2 FIND レスポンスにおいてリソースフォークサイズを返す。

既定値は yes である。

readdir_attr:aapl_finder_info = yes | no

SMB2 FIND レスポンスにおいて FinderInfo を返す。

既定値は yes である。

readdir_attr:aapl_max_access = yes | no

SMB2 FIND レスポンスにおいて、ユーザーにとって有効な アクセス許可の最大値を返す。これを求める処理には時間を要する。 no に設定した場合は、アクセス許可は最大とみなされる。

既定値は yes である。

例

        [share]
        ea support = yes
	vfs objects = catia fruit streams_xattr
	fruit:resource = file
	fruit:metadata = netatalk
	fruit:locking = netatalk
	fruit:encoding = native

著者

オリジナルの Samba ソフトウェアと関連するユーティリティは、Andrew Tridgell によって作成された。現在 Samba は Samba Team に よって、Linuxカーネルの開発と同様のオープンソースプロジェクト として開発が行なわれている。

日本語訳

このマニュアルページは Samba 4.6.3 - 4.6.6 に対応する。

このドキュメントの Samba 4.2.0 - 4.6.6 対応の翻訳は

  • 太田俊哉 (ribbon@samba.gr.jp)

によって行なわれた。