ZedのリモートサーバーをFreeBSDで動作させるためにZedを騙す方法
Lying to Zed to get its remote server running on FreeBSD (hayzam.com)
要約
著者は、ZedエディタのリモートサーバーをFreeBSD上で動作させるために、Linux互換レイヤーとカスタムunameラッパーを使用しました。これにより、ZedはFreeBSDをLinuxと誤認し、リモートサーバーが正常に起動します。また、FreeBSDのLinuxulatorにおけるディレクトリ読み取りバッファサイズのバグについても解説しています。
全文翻訳
ZedのリモートサーバーをFreeBSDで動作させるためにZedを騙す方法
私は約16歳、つまりほぼ10年間VS Codeを使用してきました。正直なところ、ほとんど問題ありませんでした。しかし最近では、遅く、AIのスロップでますます重くなり、耐え難いものになっています。grahamperrin@さんが、VS Codeにchat.disableAIFeaturesという設定があることを教えてくれました。彼らの言う通りです。私は完全にそれを見落としていました!限定的なテストで見る限り、組み込みのAI機能をオフにするようで、機能します。しかし、それがオフになっていても、VS Codeは依然として非常に扱いにくいと感じます。一方、Zedは高速で、VS Codeよりも少し早くすべてのAI機能をオフにするネイティブスイッチがあり、私はそれを完全に気に入っています。(設定のトグル、または設定ファイル内の"disable_ai": trueです。)
それはLLMを避けているからではありません。ただ、私が書くすべての行を編集しようとしたり、不気味に私を評価するように隅に座ったりしてほしくないだけです。私はまだFOSSコードのほとんどを自分で書いています。それは私を正気に保ち、FOSS開発者はLLMが盗むためにコードをきれいに保つ責任があると感じています(笑)。私が任せるのは、退屈な部分です。回帰テスト、エッジケース、そして私の20ワットの脳では保持できない範囲の探索です。OpenCodeのようなモデルと連携するハーネスを使用しています。自動補完を超えて…エディタ内のClaude Codeのような完全なハーネスは常に非常に扱いにくいと感じてきました。
動作させる
Zedには(まだ)FreeBSD用のリモートサーバー提供がありませんが、FreeBSDはLinuxバイナリを大量に実行できるため、ZedのLinux版を使用します。必要なのはSSHできるFreeBSDサーバーだけです。
1. Linux互換性をオンにする
sudo sysrc linux_enable=YES
sudo service linux start
sudo pkg install linux_base-rl9
kldstat -m linux64 # モジュールが表示されるはずです
2. ZedにLinuxサーバーを選ばせる
Zedはホストにプラットフォームが何であるかを尋ねます。FreeBSDはFreeBSD amd64と応答し、それに対応するサーバーがないため、Zedは諦めます。このラッパーは、その質問に対してLinux x86_64と応答し、それ以外のすべてを実際のunameに渡します。これを~/.local/bin/unameとして保存し、実行可能にします。
#!/bin/sh
case "$#:$*" in
1:-sm|1:-ms) printf 'Linux x86_64\n' ;; # uname -sm または uname -ms の場合
*) exec /usr/bin/uname "$@" ;; # それ以外の場合は実際のunameを実行
esac
非対話SSHセッションのために~/.local/binをPATHに追加します。zshの場合は、これを~/.zshenvに追加します(お使いのシェルの同等のものを使用してください)。
export PATH="$HOME/.local/bin:$PATH"
これは小さな嘘ですが、封じ込められたものであり、私が廃止したい部分です。
3. 接続する。
SSH経由でZedから接続し、フォルダを開きます。最初の接続でLinuxサーバーが~/.zed_server/にアップロードされます。監視するには、tail -f ~/.zed_server/logs/server-workspace-*.logを実行します。
4. (FreeBSD)修正済みのカーネルを実行する
これがないと、正常に接続できても空のプロジェクトツリーが表示され、サーバーログには次のような内容が表示されます。
error processing entry failed to read directory entry
Caused by:
Invalid argument (os error 22)
修正はec6629628cbで、main、stable/15、releng/15.2に含まれています。したがって、15.2-RELEASEにはこれが含まれます。エラーが続く場合は、uname -vで新しいカーネルを起動したか確認してください。
バグの平易な言葉での説明
プロジェクトを表示するために、Zedはサーバーに各フォルダ内のファイル名を一度にいくつか尋ねます。Zedは各バッチのために小さなスペースを確保します。
先生が生徒にクラスの生徒名簿を読み上げ、生徒がその名前を付箋に書き留める様子を想像してください(これ以上の例えが思いつきませんでした。ご容赦ください)。先生は名前を読むたびにそれを消していき、消した名前を二度と読みません。生徒の付箋には6つの名前のスペースがあります。先生は4つずつのグループで読み上げますが、これはほとんどの場合うまくいくだろうという賢明な習慣です。しかし、6はグループの整数倍ではないため、先生は8つの名前を読み、それらすべてを消してしまいます。付箋には6つしか入りません。
ここで先生は窮地に陥ります。彼女のミスは、確認する前に収まりきらないほど多くを掴んでしまったことです。収まった6つを渡して残りの2つを後回しにすることはできません。なぜなら、それらはすでに消されており、二度と読まれることはないからです。そのため、代わりにエラーを報告します。これは少なくとも、大きな音を立てるものです。私が静かな方法を試したとき、私の1,002個のファイルのうち112個が警告なしに(リストから)消えました。大きなエラーは、静かな損失よりも良いと確信しています。Zedはそのエラーを見て、フォルダを読み取れないと判断し、空のまま表示しました。
修正は小さいです。付箋に収まる数以上の名前を読み取らないようにします。6つ読み、6つ消し、次の6つを取りに戻り、名簿が終わるまで続けます。実際のバグでは、先生はFreeBSDのLinuxトランスレーター(Linuxulator)であり、付箋は768バイトのバッファであり、4つの名前のグループは512バイトのブロックです。
カーネルオタク向け
これはリグレッションです。2026年2月のNFSディレクトリが偽のエントリを返す修正(110f2567cb51、PR 292282)により、sys/compat/linux/linux_file.cでのネイティブ読み取りのサイズ設定が変更されました。linux_getdents()とlinux_getdents64()の両方でです。
/* 2026年2月以前 */
buflen = min(args->count, MAXBSIZE);
/* 以降:各リクエストは512バイトブロックに切り上げられます */
buflen = min(roundup2(args->count, DEV_BSIZE), MAXBSIZE);
呼び出し元のバッファが512バイトの倍数でない場合、ネイティブバッチがそれを超える可能性があります。エミュレーションレイヤーはレコードを変換しますが、1つが収まらないとEINVALを返します。しかし、kern_getdirentries()はすでにディレクトリオフセットをバッチ全体にスキップしています。そのため、部分的なバッチを返すだけでは十分ではありません。
修正(ec6629628cb、D60760でレビュー済み):
if (args->count >= DEV_BSIZE)
buflen = min(args->count, MAXBSIZE);
else
buflen = roundup2(args->count, DEV_BSIZE);
これは安全です。なぜなら、LinuxのディレクトリレコードはFreeBSDのものより大きくなることはないからです。dirent64の場合、ヘッダーは19バイト対24バイトであり、どちらも各レコードを8バイトの倍数に切り上げます。呼び出し元のバッファに収まるネイティブバッチは、収まるバッチにつながります。
レガシーgetdentsは、32ビットおよび64ビットの呼び出し元に対して同じバグを抱えていました。私の最初のパッチはgetdents64のみを修正しました。両方を修正するには、テストマトリックスの失敗が86からゼロになりました。
謝辞
このパッチ以前にも多くのパッチがマージされましたが、これはreleng/15.2に最も早く取り込まれたものの一つでした(幸いにも!)。リリースエンジニアリングチーム(re@)は、私がまだ完全に深く理解していない本当にクールなプロセスを実行しています。パッチのレビューと、その過程でのノートについて、Kyle Evans(kevans@)とMark Johnston(markj@)にも感謝します。