Text file busyの原因と対処法|実行中のファイルを上書きしたとき

Text file busyは、「実行中のプログラムのファイルを、書き換えようとした」ことを意味します。ここでの「Text」は、プログラムの機械語の部分を指す言葉です。プログラムを止めてから上書きするか、別名でコピーしてからmvで差し替えます。

このエラーが表示される例

cp: cannot create regular file '/usr/local/bin/app': Text file busy
bash: ./deploy.sh: /bin/bash: bad interpreter: Text file busy

「Text file busy」の意味

Linuxは、実行中のプログラムのファイルが書き換えられると、動いているプロセスが壊れるおそれがあるため、上書きのための書き込みを拒否します。

一方、mvでの置き換えやrmでの削除は許されます。これは、ファイルの中身ではなく「名前とファイルの結び付き」を変える操作だからです。実行中のプロセスは古い中身を使い続け、次に起動したときから新しいファイルが使われます。

原因を切り分ける手順

ステップ1:どのプロセスが実行しているかを確認する

$ sudo fuser -v /usr/local/bin/app
$ pgrep -a app

実行中のプロセスのPIDとコマンドラインを確認します。

原因別の対処法

プログラムを止めてから上書きする

サービスならsystemctl stopで止め、上書きしてからsystemctl startで起動します。

別名で置いてから mv で差し替える

cp app /usr/local/bin/app.newでコピーし、mv /usr/local/bin/app.new /usr/local/bin/appで置き換えます。そのあとプログラムを再起動すると、新しい版が使われます。

注意:
別名で置いて差し替えた場合、再起動するまでは古い版が動き続けます。
「更新したのに直らない」と勘違いしやすいので、差し替えたあとにプロセスを再起動し、バージョンを確認するところまで行いましょう。

再発を防ぐために

デプロイの手順やスクリプトでは、直接cpで上書きするのではなく、「別名で置く → mvで差し替える → 再起動する → バージョンを確認する」の流れにしておくと、このエラーと中途半端な状態の両方を防げます。

よくある質問

スクリプトを編集しただけなのに出ました

スクリプトを実行している最中に、エディタやコピーで上書きしようとすると発生することがあります。実行の終了を待つか、別名で保存して差し替えます。

rm は成功するのはなぜですか?

削除は、名前との結び付きを外す操作で、中身は実行中のプロセスが使い終わるまで残ります。そのため許されます。

この記事を書いた人:
こすけ(コマンド学習道場 運営者)。
AWSの運用保守に携わるエンジニアで、保有資格はCCNA・AWS-SAA・LPIC-3(305)。
詳しくは運営者情報をご覧ください。

ほかのエラーメッセージを調べる

← エラーメッセージ辞典へ戻る