シェル出力の自動マスキングと TTY 保持(PTY プロキシ)

シェル関数ラッパー#

.zshrc や .bashrc に docker() { command docker "$@" | mask; return ${PIPESTATUS[0]}; } のように書く方式。無限再帰を避けるため command で PATH 上の実体を呼ぶ。終了コードは PIPESTATUS[0] で取れるが、シグナル終了時は 128+N になり、パイプ閉鎖のタイミングで SIGPIPE が出ることもある。パイプを挟んだ時点で TTY が消えるので、色・TUI・対話プロンプトが壊れる。全コマンドにラッパーを書くのは現実的でなく、サブシェルからの直呼びはラッパーを素通りする。

実行前フック(preexec / DEBUG トラップ)#

いずれも「コマンド実行の前にコードを走らせる」仕組みで、実行中の stdout を横取りする機能はない。zsh で exec 1> >(mask) を試みても exec | pipe 構文が動かず、coprocess 経由の回避策は zsh が coprocess を 1 つしか持てない制約と衝突する。動いたとしても TTY は失われる。BASH_XTRACEFD は set -x の出力先を変える変数で、stdout とは無関係。

script / unbuffer#

unbuffer(expect 付属)や script -q -c "bash" /dev/null は子プロセスを PTY 上で起動するので、子から見た isatty() は true になり色や progress bar が残る。ただし出力を | mask に渡した時点で最終 fd が非 TTY になり、対話性は失われる。個別コマンドへの手動適用が前提で、全コマンド自動化には向かない。faketty は PTY を割り当てつつ stdout と stderr を分離する変種。

PTY プロキシ#

マスクプロセスがユーザー端末(PTY1 slave)と内側の PTY2 の間に立ち、シェル自体を PTY2 slave 上で起動する。

1
[ユーザー端末 (PTY1 slave)]
2
   ↕ raw TTY
3
[マスクプロセス: PTY1 を読み書き / PTY2 master でフィルタ]
4
   ↕ PTY master/slave
5
[bash / zsh / コマンド (PTY2 slave, isatty()=true)]

シェルから見ると isatty() は true のままで、色・TUI・対話入力が保たれる。Go なら creack/pty、Python なら pexpect の output_filter で組める。実装上の要点と既知の難所は次のとおり。

1. PTY slave 上でシェルを起動する(posix_openpt → grantpt → unlockpt → ptsname → exec。creack/pty の pty.Start() が相当)
2. SIGWINCH を両方向に伝播する(外側のサイズ変更を TIOCSWINSZ で内側へ。pty.InheritSize)
3. stdin を raw モードにしてユーザー入力を透過する(term.MakeRaw / term.Restore)
4. ANSI エスケープの断片化に備える。read() のバッファ境界が \x1b[31m の途中で切れたり、秘匿値がエスケープをまたいで分割されたりするので、ストリームをバッファしながらマッチする
5. シグナル伝播。Ctrl+C は raw モードなら PTY 経由で自動的に届くが、一部は手動伝播が要る
6. PTY 上では stdout と stderr が混ざる(分離したいなら faketty 的な工夫が要る)
7. 全出力を中継するので大量出力でオーバーヘッドが出る
8. sudo / su / vim のようにフルスクリーン化や新 PTY を起動するコマンドとの相性は未検証領域が残る。macOS では posix_openpt の挙動差の報告がある

LD_PRELOAD で write() を横取り#

write(fd, ...) を上書きし、fd == STDOUT_FILENO のときバッファをスキャンして置換する共有ライブラリを LD_PRELOAD で注入する。fd を変えないので TTY 判定に影響しない点が利点。一方、静的リンクされたバイナリ、CGO 無効でビルドされた Go バイナリ(docker / kubectl など、libc の write() を使わない)、syscall.Write() の直呼び、setuid バイナリには効かない。マルチスレッドではロックが要り、バイト境界の問題も残る。Go 製 CLI が多い現在の環境では適用範囲が狭い。

tmux pipe-pane#

tmux pipe-pane -o 'cmd' はペインの出力を外部コマンドに複製する。表示と並行してコピーするだけで、表示前に書き換えることはできない。マスキングには使えず、ロギングや監査ログの用途になる。流れるのはペイン全体のストリーム(入力・プロンプト・制御文字を含む)なので、純粋な stdout を取り出すには後処理が要る。

Warp 方式(描画レイヤー)#

Warp は PTY から読んだバイト列を内部グリッドに書き、描画レイヤーで正規表現マッチして表示文字列をマスク文字に置換する。

1
PTY master(生出力) → パース → グリッド(内部バッファ) → 描画レイヤー(マスキング)

子プロセスは通常の PTY slave に書くだけなので TTY を一切壊さない。設計としては最も安全だが、ターミナルエミュレータそのものを作らない限り再現できない。「子プロセスは通常の PTY に繋いだまま、表示前にフィルタする」という思想は PTY プロキシにも応用できる。