Document interaction between filesystem snapshots and external backup tools

doc/snapraid-ja.1

@@ -1833,6 +1833,31 @@ ZFSでは標準の \`.zfs/snapshot/\` が使用されます。
 パリティには、中断された sync で使用されたスナップショットから計算されたブロックが
 まだ含まれている可能性があります。その後の sync によりそのスナップショットが
 置き換えられ、中間バージョンのファイルが復元できなくなる可能性があります。
+.SS ファイルシステムスナップショットと外部バックアップ (External backups with filesystem snapshots) 
+ファイルシステムスナップショットが有効な場合、SnapRAIDは各データサブボリューム、
+ボリューム、またはデータセットのルートにあるスナップショットにアクセスまたは作成します。
+.PP
+外部ツールとの干渉を避ける簡単な方法は、\`data\` 設定をサブボリュームまたは
+ボリューム内の通常のサブディレクトリ（例えば \`/mnt/subvol\` の代わりに
+\`/mnt/subvol/data\`）に指定することです。SnapRAIDは常にサブボリュームのルートに
+スナップショットディレクトリを作成するため（例えば \`/mnt/subvol/.snapraid/\`）、
+データサブディレクトリがクリーンに保たれ、スナップショットはそのディレクトリ内で
+動作するバックアップツールから見えない状態のままになります。
+.PP
+一方、設定された \`data\` ディレクトリ自体がサブボリュームまたはボリュームの
+ルートである場合、SnapRAIDはその直下に \`.snapraid/\` ディレクトリを作成します（Btrfs、
+Bcachefs、およびNTFS）。SnapRAID自身のスキャンからは自動的に除外されますが、
+外部のバックアップツールやファイル同期ツールはそのディレクトリを検出します。
+除外設定を行わない場合、スナップショットやディレクトリリンク内を走査して凍結された
+データツリー全体をコピーしてしまい、データが重複してバックアップストレージを使い果たす
+可能性があります。外部バックアップツールでは、必ず \`.snapraid/\` ディレクトリを
+除外するように設定してください。
+.PP
+ZFSでは、スナップショットは \`.snapraid/\` ではなく標準の仮想ディレクトリ
+\`.zfs/snapshot/\` 経由で公開されます。デフォルト（\`snapdir=hidden\`）では、ZFSはこの
+ディレクトリを一覧表示から隠すため、外部バックアップツールが走査することはありません。
+\`snapdir=visible\` を有効にしている場合は、バックアップツールが \`.zfs/\` ディレクトリを
+除外するように設定してください。
 .SH パターン (PATTERN) 
 パターンは、含めるファイルまたは除外するファイルをフィルタリングするための柔軟な方法を
 提供します。グロブ文字を使用することで、すべてのパスを手動でリストすることなく、