要約
- 自社開発。OpenMacFUSE は、ドライバのプロセスにリンクされ FUSE 2.x API を提供する NFSv4.0 サーバです。C 言語で約 17,000 行、RFC 7530・5531・4506 に基づいて実装し、MIT ライセンスで公開しています。カーネル拡張を必要としない、オープンソースの macOS 向け FUSE 実装の一つです。
- 速度。差が最も大きいのはメタデータ中心の処理です。ボリューム内の全ファイルのチェックサム計算は FUSE-T の 797 秒に対して 23 秒、小さなファイル 10,000 個の削除は 6〜9 倍速くなります。実機の USB ドライブでの大きなファイルの連続読み書きでは、測定できる差はありません。
- メモリ。ドライバプロセスの物理メモリ使用量は、ファイル数や稼働時間にかかわらず 45〜51 MB です。
- 信頼性。書き込み中に USB の電源を切ると、ドライバは 0.5 秒以内にアンマウントして終了します。電源が戻ればボリュームは通常どおりマウントでき、内容が壊れたファイルはありません。失われるのは、直前の約一秒間に完了した書き込みだけです。
- 保守性。プロトコル層、FUSE インターフェース、NTFS エンジンが一つのコードベースにあるため、マウント層の問題を直接調べて修正でき、第三者のリリースを待つ必要がありません。
23 秒 vs. 797 秒
FUSE-T は 381 MB
USB SSD で実測
macOS 12 ですべて合格
1 背景2 構造3 性能4 メモリ5 macOS の動作6 障害時の動作7 測定方法8 制約9 まとめよくある質問
1背景
macOS 11 以降では、カーネル拡張を読み込むために macOS リカバリで起動し、Mac を「低セキュリティ」に切り替える必要があります。一般のユーザー向けソフトにとって、この方法はもう現実的ではありません。カーネルに触れずに済む方法は主に二つあります。Apple の FSKit(macOS 15.4 以降で利用可能で、NTFSTool の「ドライバ 2」が採用)と、macOS 標準の NFS クライアントです。後者は、ローカルで NFS サーバを動かし、ファイルシステム操作をユーザー空間のドライバへの呼び出しに変換して、mount_nfs でマウントする方式です。FUSE-T がこの方式を採っており、最も成熟した実装であるため、この記事のすべての比較の基準としています。
この層を自社で実装することにした理由は、技術面で三つあります。
- 導入。FUSE-T は独立したコンポーネントです。初回利用時に管理者パスワードを入力してインストールする必要があり、手順が一つ増え、失敗しうる箇所も増えます。
- 修正のしやすさ。第三者のマウント層はバイナリで配布されます。大きなフォルダの一覧表示が遅い、メモリ使用量が増え続けるといった問題は再現できても、修正できるのは作者だけです。
- 動作の整合。汎用のマウント層は NTFS を知りません。大文字小文字の扱い、隠しファイル属性と読み取り専用属性、拡張属性の保存場所は、ファイルシステムエンジンと一体でなければ正しく処理できません。
2構造
OpenMacFUSE は静的ライブラリとしてドライバにリンクされています。ドライバは起動すると、自身のプロセス内でローカルのエンドポイントを待ち受け、続けてシステムの mount_nfs を呼び出します。カーネルの NFS クライアントからの COMPOUND リクエストは、すべてこの一つのプロセス内でデコードされ、FUSE コールバックに渡されて応答されます。別プロセスはなく、途中での余分なコピーやコンテキストスイッチもありません。
通信方式とマウントオプション
macOS 26 以降では Unix ドメインソケット(proto=ticotsord)を使います。ポートは開かれず、同じ Mac の他のユーザーは接続できません。macOS 12 のカーネルクライアントは、この方式で大きな書き込みをすると失敗するため、それ以前の macOS では 127.0.0.1 上の TCP に切り替え、接続がローカルのマウントからのものであることをサーバ側で二重に確認します。次は、macOS 27 でマウントした後にシステムが報告したオプションです。
$ nfsstat -m <mount point> NFS parameters: vers=4.0,ticotsord,port=/var/folders/…/openmacfuse.P1wAL0/s,hard,intr, noresvport,nocallback,negnamecache,nonamedattr,noacl,noaclonly,locks,noquota, rsize=262144,wsize=262144,readahead=16,dsize=32768,nordirplus,nodumbtimer, timeo=10,maxgroups=16,…,deadtimeout=60
nonamedattr はシステムクライアントの既定値で、5 節で説明する拡張属性の扱いを決めます。nordirplus は当社の選択で、そのコストは 8 節で述べます。実装上の選択
- サイズ制限付きのノードテーブル。ファイルハンドルはメモリ上のオブジェクトへのポインタではありません。ノードテーブルには上限があり、追い出されたノードのハンドルは、次に使われたときにパスから解決し直します。テストでは上限を 64 エントリに下げて 301 回連続で名前を変更し、古いハンドル経由の 7,839 回のアクセスがすべて復元され、
NFS4ERR_STALEは一度も返りませんでした。メモリ使用量がファイル数に比例して増えないのはこのためです。 - 重複リクエストキャッシュ。クライアントはタイムアウト後にリクエストを再送します。CREATE、REMOVE、RENAME のように繰り返すと結果が変わる操作では、サーバが直近の応答を保存し、再送にはその応答を返すだけで、操作を再実行しません。テストでは6 種類の操作それぞれで応答を一つ破棄しましたが、どの操作も実行はちょうど一回でした。
- 名前付き属性は使わない。NFSv4 の名前付き属性は拡張属性に自然に対応するプロトコル機能ですが、macOS のカーネル NFS クライアントにはその経路にシステムをクラッシュさせる不具合があります。開発中に macOS 27.0.1 と 12.7.6 の両方で遭遇しました。そのため OpenMacFUSE はクライアントが最もよく使う経路にとどまり、名前付き属性は無効のままにしています。
3性能
OpenMacFUSE は、メタデータ中心の処理では FUSE-T 1.0.49 より 6〜35 倍速く、実機の USB ドライブでの連続読み書きでは同等です。測定方法:同じマシン、同じボリュームイメージ、同じ NTFS エンジンのソースを使い、OpenMacFUSE と FUSE-T 1.0.49 のそれぞれにリンクしました。イメージは内蔵 SSD に置き、I/O はシステムのページキャッシュを通るため、図 3 が測るのはディスクではなく、マウント層とエンジンのオーバーヘッドです。実機ドライブの結果は表 1 に別掲します。
OpenMacFUSE
FUSE-T 1.0.49| 表 1 · 実機の USB ドライブ | OpenMacFUSE | FUSE-T |
|---|---|---|
| SSD、連続書き込み 4.5 GB | 293〜313 MB/s | 300 MB/s |
| SSD、コールドリード | 245〜251 MB/s | 236〜241 MB/s |
| SSD、ディレクトリツリーの走査 | 0.25〜0.30 秒 | 4.1〜4.6 秒 |
| SSD、小さなファイル 2,000 個の削除 | 0.82〜0.86 秒 | 8.4〜9.7 秒 |
| ハードドライブ、連続書き込み / 読み込み | 70 / 97 MB/s | 74 / 93 MB/s |
SSD は Apple M2 / macOS 27、ハードドライブは Intel i7 / macOS 12.7 で測定。連続スループットは USB 接続とドライブ自体が上限となり、差は測定誤差の範囲内です。
掲載を見送った結果:小さなファイルの作成。これらのベンチマークの後、OpenMacFUSE の既定のフラッシュポリシーをより保守的に変更したため(6 節)、小さなファイルの作成は約二倍遅くなりました。新しいポリシーでの FUSE-T との実機比較はまだやり直していないため、それが済むまで旧データは掲載しません。
4メモリ
OpenMacFUSE の物理メモリ使用量は、処理内容や稼働時間にかかわらず 45〜51 MB で推移しました。同じテストで FUSE-T は 200 MB から 1 GB を使いました。数値はすべて物理フットプリントで、アクティビティモニタの「メモリ」列と同じ指標です。OpenMacFUSE は単一のドライバプロセス、FUSE-T はドライバプロセスと NFS サーバプロセスの合計です。どちらも、NTFS エンジンが持つ約 35 MB のブロックキャッシュを含みます。
5macOS の動作
OpenMacFUSE はドライブ上に ._ ファイルを作らず、NTFS の属性を macOS の対応する属性に変換します。
._ ファイルはありません。AppleDouble
macOS の NFS クライアントは、既定では名前付き属性を使いません。ファイルの拡張属性、リソースフォーク、Finder 情報を、._ファイル名 という AppleDouble ファイルにまとめ、通常の OPEN と WRITE でサーバに送ります。サーバが受け取ったものをそのまま保存すると、これらのファイルがドライブに残り、Windows では余分なファイルとして見えてしまいます。
macOS 26 では、新しいファイルすべてに com.apple.provenance 属性が付くため、すべてのファイルに ._ ファイルが付いてくるようになり、問題が目立ちました。小さなファイル 40,000 個のデータセットを FUSE-T 経由で書き込むと、ドライブに余分な ._ ファイルが 40,048 個残りました。ボリューム上の git リポジトリでは未追跡ファイルが 48 個表示され、git fsck は 67 件のエラーを報告しました。
OpenMacFUSE は、サーバ側で ._ ファイルへのアクセスを検出し、AppleDouble の内容を解析して、各属性をメインファイルの NTFS 代替データストリームに書き込みます。読み込み時には、必要に応じて AppleDouble ファイルを再構築します。ディスク上に別ファイルは作られず、ディレクトリの一覧にも現れません。すでに ._ ファイルがあるドライブでは、それらを非表示にし、対応するメインファイルが次に変更されたときに、データストリームへ移します。
代償はディレクトリ一覧表示時のフィルタ処理です。40,000 エントリのフォルダの初回一覧表示は 1.4 秒から 3.6 秒になります。妥当な引き換えだと考えています。
その他の動作
| 項目 | OpenMacFUSE の動作 | FUSE-T での観察結果 |
|---|---|---|
| ファイル名の大文字小文字 | 既定では Windows と同様に、大文字小文字を区別せず、入力どおりに保持します。ボリューム上に大文字小文字だけが異なる名前がすでにある場合は、自動的に大文字小文字を区別するマウントに切り替わります | 大文字小文字を区別 |
| Unicode 正規化 | 名前の NFC 形式と NFD 形式が同じファイルに届きます(アクセント付き文字、韓国語) | 未検証 |
| 隠しファイル属性 | NTFS の HIDDEN ビットと Finder の非表示フラグが双方向に対応します | 対応なし |
| 読み取り専用属性 | NTFS の READONLY ビットにより、macOS 上でそのファイルは書き込み不可になります | 反映されない |
| 作成日時 | stat -f %B が、ディスクに保存された作成日時を返します | 常に 0 |
| バイト範囲ロック | 対応。SQLite データベースをボリューム上で直接開けます | 未検証 |
6障害時の動作
外付けドライブは、予告なく抜かれることがあります。それは例外ではなく普通の使い方であり、OpenMacFUSE にはその際にマウントを解除する仕組みが三つあります。NFS を使うマウント層には、構造上のリスクが一つあります。マウントは hard のため、サーバが応答しなくなると、ボリュームに触れたプロセスは中断できない待機状態に入り、Finder が応答しなくなります。そこでマウント層には、マウントポイントを必ず誰かが取り除くことが求められます。
- デバイス消失の検出。I/O でデバイスエラーが出たときは即座に処理します。アイドル中は、IOKit で一秒ごとにデバイスノードを確認します。消失が確定すると、保留中のリクエストはエラーで失敗させ、ボリュームを強制アンマウントして、プロセスを終了します。
- ウォッチドッグ。リクエストの処理中に 30 秒間なにも進まなければ、ドライバが応答しない状態と判断し、同じ手順でアンマウントして終了します。
- ガードプロセス。ドライバ自体がクラッシュしたり強制終了されたりしたときは、小さな別プロセスがマウントポイントを取り除きます。これがない場合、システムが自動で片づけるのは約 70 秒後(
deadtimeout)で、それまではボリュームに触れたプロセスを中断できません。
== 電源断: B-write1 (負荷: 書き込み、変更後、NTFSTOOL_DRIVER_FSYNC=bounded) - 電源断の後: 書き込み側のエラー 0.19 秒、マウントポイント消失 0.21 秒、 ドライバ終了 0.45 秒、中断できないプロセス: 0 [pass] 電源断から完全復旧まで 0.45 秒 (上限 10 秒) - fsync 済みファイル 303 個、最後の fsync 完了からデバイス消失の検出まで 0.081 秒 [pass] 電源断後に ntfsfix なしでマウント (0.33 秒)
電源断後の整合性
書き込み中に電源を切っても、現在はすべての試行で修復ツールなしでボリュームがマウントでき、内容が誤ったファイルは出ていません。マウント層が影響を与えられるのは、電源が戻ったときに修復ツールなしでマウントできるかどうかと、アプリにすでに完了と通知した書き込みのうちどれだけが残るか、の二点です。OpenMacFUSE ではここで三つの変更を加えました。
- 書き込み順序。ファイルのデータを、それを参照するメタデータより先にデバイスへ届けます。順序をつけない場合、電源断の試行 5 回中 4 回で内容が誤ったファイルができましたが、順序をつけるとゼロになりました。
- 上限付きのキャッシュフラッシュ。既定のポリシーでは、
fsyncはデータがデバイスに書き込まれた時点で戻り、ドライブ自身の書き込みキャッシュは、バックグラウンドのスレッドが一秒以内にフラッシュします。呼び出しのたびに同期フラッシュすると、失われるのは一回の試行あたり最大でファイル一個に減りますが、小さなファイルの書き込みは 13〜23 倍遅くなります。この方式もオプションとして残してあります。 - マウント時の自己修復。電源断でよく起きるのが
$MFTと$MFTMirrの不一致で、仕様上はこの場合マウントを拒否しなければなりません。OpenMacFUSE はマウント中にこれを検査して修復するため、先に修復ツールを実行する必要はありません。
| USB SSD、書き込み中の電源断 | 変更前 | 変更後(既定ポリシー) |
|---|---|---|
| 電源復旧後に修復ツールなしでマウントできたか | 5 回中 3 回が $MFTMirr の不一致で失敗 | 毎回成功 |
| 一回あたりに失われた、完了済みのファイル | 12〜19 | 1〜27、すべて直前の約一秒間に書かれたもの |
| 内容が誤ったファイル | 一部のファイルがすべてゼロで戻った | 0 |
「変更前」は、この作業を行う前のエンジンの挙動です。同じエンジンを FUSE-T 経由でマウントしても、結果は同じでした。バッテリーのないポータブルドライブが書き込み中に電源を失った場合、直前のデータをどのファイルシステムも保証できません。ここでの目標は、失われるものを直近の書き込みだけにとどめ、ボリュームの構造を無傷に保つことです。
7測定方法
| 項目 | 詳細 |
|---|---|
| ハードウェア | MacBook Pro(Intel i7-4770HQ、16 GB、macOS 12.7.6)、Mac(Apple M2、24 GB、macOS 27.0.1)、120 GB USB SSD、1 TB USB ハードドライブ、USB フラッシュドライブ |
| 比較 | 同じマシン、同じイメージ、同じ NTFS エンジンのソース。変えるのはマウント層だけ。FUSE-T のバージョンは 1.0.49 |
| 計時 | 書き込みの計時には sync を含む。連続読み込みは、クライアントキャッシュを避けるため、アンマウントして再マウントした後に実行 |
| メモリ | proc_pid_rusage の ri_phys_footprint、0.2 秒間隔 |
| 取り外しと電源断 | アンマウントせずに、リレーで USB の 5 V 電源を切る。電源が戻った後、ボリューム構造を読み取り専用で検査し、続けて修復なしでマウントして、すべてのファイルを比較する |
| 正確性 | ランダムな読み書き比較を 300 秒間(692,000 回の操作、不一致 0 件)、8 本の同時書き込みに再帰的な一覧表示 2 本、毎回の実行後にボリューム構造を検査 |
| リグレッション | 15 本のスクリプトスイート、869 項目のチェックで、NTFS の読み書き、macOS の動作、ext・exFAT・BitLocker ボリューム、および障害注入(取り外し、強制終了、ハング、マウントハンドシェイクのタイムアウト)を網羅 |
07:29:09 [pass] マウント完了 07:29:10 [pass] 大きなファイルを書き込み 07:29:12 [pass] 小さなファイルを書き込み 07:29:13 [pass] 大きなファイルの MD5 が一致 07:29:13 [pass] 小さなファイルの MD5 がすべて一致 07:29:13 [pass] 名前変更 / 追記 / 切り詰め / 削除 07:29:13 [pass] 大文字小文字を区別せずに開く 07:29:13 [pass] 一覧に ._ ファイルなし 07:29:13 [pass] 拡張属性の読み書き 07:29:15 [pass] 通常のアンマウント 07:29:15 [pass] ドライバ終了 07:29:15 [pass] ガードプロセス終了
8制約
- リグレッションテストの対象 macOS。自動リグレッションテスト一式は、現在 macOS 12.7(Intel)と macOS 27(Apple シリコン)で実行しています。他のバージョンは順次追加中です。macOS 27 での最初のリグレッションテストでは、macOS 12 では起きない問題が三つ見つかり、いずれも修正済みです。
- 比較の範囲。FUSE-T の数値はすべて、当社の二台のマシンとバージョン 1.0.49 のみで得たものです。「未検証」は、その機能に対応していないという意味ではありません。
- カーネルクライアントの不具合はユーザー空間では回避できません。この種のマウントの安定性は、macOS の NFS クライアントを超えられません。失敗することがわかっている二つの経路(名前付き属性と、マウントハンドシェイクのタイムアウト後の再接続)は避けていますが、他にないとは言い切れません。
- macOS はこれらのボリュームをネットワークボリュームとして扱います。ゴミ箱はなく、Spotlight による検索インデックスも作成されません。FUSE-T も同様で、この方式に固有の性質です。
- 非常に大きなフォルダ。40,000 エントリを超えるフォルダを Finder で初めて開くと、約 74 秒かかります。ボトルネックは Finder がエントリごとに属性を取得する方式にあり、どちらのマウント層でも同じです。
- 削除時の書き込み順序には、書き込みと同じ対策をまだ施していません。電源断の際に、削除したばかりのファイルが空けた領域に書かれた新しいデータが影響を受ける可能性が、わずかにあります。
9まとめ
OpenMacFUSE は、NTFSTool Pro のドライバ 1 の標準マウント層で、NTFS・ext・exFAT・BitLocker のボリュームはすべてこれを通してマウントされます。マウント層を自社のコードベースに持つことには、四つの利点があります。
- 自社開発。RPC、XDR、NFSv4.0 の状態機械、FUSE インターフェースは、すべて自社実装です。第三者のマウントコンポーネントはなく、追加でインストールするものもありません。
- 性能。リクエストは一つのプロセス内で完結します。メタデータ操作は FUSE-T より 6〜35 倍速く、メモリ使用量は 6 分の 1〜20 分の 1 です。
- 信頼性。ドライブを抜いたとき、ドライバが応答しなくなったとき、プロセスが強制終了されたときに、それぞれ専用の終了の仕組みがあり、電源断の後もボリュームは通常どおりマウントできます。
- 保守性。869 項目の自動チェックが通常の経路と障害注入をカバーしているため、一つのコードベースで問題の再現、調査、修正、リグレッションテストまで行えます。
よくある質問
- OpenMacFUSE とは何ですか?
- OpenMacFUSE は、NTFSTool が開発したオープンソースのユーザー空間マウント層で、NTFSTool Pro に組み込まれています。macOS 上で NTFS・ext・exFAT・BitLocker のボリュームをマウントします。ドライバのプロセス内で動作する NFSv4.0 サーバで、カーネル拡張は使いません。
- NTFSTool Pro を使うのに macFUSE や FUSE-T のインストールは必要ですか?
- いいえ、不要です。NTFSTool 独自のマウント層である OpenMacFUSE が NTFSTool Pro に同梱されています。macFUSE、FUSE-T、カーネル拡張のいずれにも依存せず、macOS リカバリで起動して Mac のセキュリティを下げる必要もありません。
- OpenMacFUSE は FUSE-T と比べて、性能はどのくらい違いますか?
- 同じ Mac・同じ NTFS エンジンで、ボリューム内の全ファイルのチェックサム計算は、OpenMacFUSE が 23 秒、FUSE-T が 797 秒です。小さなファイル 10,000 個の削除は 6〜9 倍速くなります。実機の USB ドライブでの大きなファイルの連続読み書きは同等です。メモリ使用量は、OpenMacFUSE が 45〜51 MB、FUSE-T が 200 MB〜1 GB です。
- 書き込み中にドライブを抜くとどうなりますか?
- OpenMacFUSE のドライバは、約 0.5 秒で自動的にボリュームをアンマウントして終了するため、Finder や他のアプリが固まることはありません。ドライブを挿し直せば、ボリュームは通常どおりマウントされます。電源が切れる直前の約一秒間に完了した書き込みは失われることがありますが、他のファイルの内容には影響しません。
- NTFSTool はなぜ、オープンソースや第三者のコンポーネントを使わず、独自のマウント層を作ったのですか?
- マウント層は、速度、メモリ使用量、障害時の挙動を左右します。独自実装であれば、NTFSTool は一つのコードベースで問題を調べて修正でき、NTFS 固有の動作(大文字小文字の扱い、隠しファイル属性と読み取り専用属性、拡張属性)もファイルシステムエンジンと一体で処理できます。
- OpenMacFUSE はオープンソースですか?
- はい。OpenMacFUSE は MIT ライセンスのオープンソースで、コードは GitHub の ntfstool/openmacfuse で公開しています。FUSE 2.x のファイルシステムであれば、どれでもリンクして使えます。
この記事のデータはすべて NTFSTool エンジニアリングチームが測定したもので、測定方法は 7 節に記載しています。FUSE-T はその作者のプロジェクトで、NTFSTool とは関係ありません。OpenMacFUSE は独立したプロジェクトで、macFUSE およびその作者とは関係ありません。