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 は成功するのはなぜですか?
削除は、名前との結び付きを外す操作で、中身は実行中のプロセスが使い終わるまで残ります。そのため許されます。
ほかのエラーメッセージを調べる
Connection refusedConnection timed outTemporary failure in name resolutionREMOTE HOST IDENTIFICATION HAS CHANGEDbad interpreter: No such file or directoryArgument list too longToo many open filesAddress already in useRead-only file systemOperation not permittedis not in the sudoers fileKilled(Out of memory)No space left on devicecommand not foundPermission denied (publickey)Device or resource busyNo such file or directoryJob for xxx.service failed because the control process exited with error codeCould not get lock /var/lib/dpkg/lock-frontendsudo: unable to resolve hostSegmentation fault (core dumped)