manページ  — MOUNT_UNIONFS

ファイルシステムのセキュリティを維持するため、 ファイルシステムをマウントするユーザは、スーパユーザか、 マウントポイントのディレクトリに書き込み許可を持つ者でなければなりません。 さらに、普通のユーザがファイルシステムをマウントするを許可するには、 vfs.usermount sysctl(8) 変数を 1 に設定しなければなりません。

ファイルの検索は、上の層、下の層の順におこなわれます。 上の層にはエントリのないディレクトリが、下の層で見つかった場合には、上の層に シャドウ ディレクトリが作られます。 このディレクトリはユニオンマウントを実行したユーザの所有になり、モードは "rwxrwxrwx" (0777) をその時点で有効な umask で修正したものになります。

あるファイルが上の層に存在している場合、下の層にある 同じ名前のファイルをアクセスする方法はありません。 どうしても必要なら、ループバックマウントとユニオンマウントを 組み合せることで、別のパス名を使って下の層のファイルを アクセスできるようにしておくことができます。

オブジェクトへのアクセスは、それがディレクトリである場合を除き、 通常のファイルシステムのアクセス権チェックのあとで実行されます。 ディレクトリの場合には、アクセスをおこなうユーザは上の層と下の層の 両方のディレクトリのアクセス権を持っていなければなりません (両方のディレクトリが存在している必要があります)。

いくつかの特別な場合を除き、 uniondir 中のオブジェクトの作成や変更の要求は上の層に渡されます。 下の層に存在するファイルを書き込み用にオープンしようとすると、 そのファイルの 完全な コピーが上の層に作成され、それから上の層のコピーがオープンされます。 同様に、下の層のファイルを切り詰めてサイズを 0 にしようとすると、 空のファイルが上の層に作成されることになります。 これ以外の、本当に下の層の変更が必要となる操作は失敗し、 EROFS が返されます。

ユニオンファイルシステムは、個々のファイルシステムを扱うというよりも 名前空間を扱うものです。 ユニオンマウントは uniondir 以下のディレクトリツリーに再帰的に影響します。 このため uniondir 以下にマウントされたファイルシステムは、すべて ユニオン効果を持つようになります。 これが mount(8) の union オプションとは異なる点です。 union オプションでは、ユニオン効果はマウントポイントだけに働き、 ファイル名の探索のみに使われます。

上の層を支えているファイルシステムで、ホワイトアウトが サポートされていないため、下の層のオブジェクトに対して 削除や名前変更の操作をおこなう方法はありません。 このような操作や、下の層を変更する操作、たとえば chmod(1) のような操作に対しては、 EROFS が返されます。

ユニオンツリーの上で find(1) を実行すると、上の層にシャドウディレクトリのツリーが 作成されてしまうという副作用があります。