こんにちは、インフラエンジニアのryuです。
Permission denied、No space left on device、Connection refused。Linuxのサーバーを触っていると、こうした英語のエラーメッセージに毎日のように出会います。実はこれらの多くは、OSが返す errno(エラー番号) という共通の仕組みから来ています。
errno を知っておくと、nginx のログに (13: Permission denied) と出ても、Python が [Errno 28] と出しても、同じ種類のエラーだと分かります。番号から意味を引けるようになると、どこから調べればよいかの見当がすぐにつきます。
この記事では、運用でよく見る errno を、番号・名前・メッセージの一覧にしたうえで、出やすい場面と最初に確かめることを添えて整理しました。詳しい切り分けを書いた記事がある項目には、リンクを付けています。
errnoとは何か¶
プログラムがファイルを開く、通信を始める、といった処理をOSに頼んで失敗すると、OSは失敗した理由を番号で返します。この番号が errno です。
番号にはそれぞれ EACCES や ENOSPC のような名前と、Permission denied のような決まった英語のメッセージが対応しています。プログラムは、このメッセージをそのまま、または少し形を変えてログに書きます。
| プログラム | 同じ errno 13 の表示の例 |
|---|---|
| シェル(bash) | bash: ./run.sh: Permission denied |
| nginx | open() "/var/www/html/index.html" failed (13: Permission denied) |
| Python | PermissionError: [Errno 13] Permission denied: '/etc/shadow' |
| strace | openat(AT_FDCWD, "/etc/shadow", O_RDONLY) = -1 EACCES (Permission denied) |
表の行はどれも説明用の例で、パスなどは環境によって変わります。どの表示でも、番号かメッセージのどちらかが分かれば、この記事の一覧から引けます。
番号はOSやCPUの種類で変わることがある¶
man ページの errno(3) には、名前に対応する番号はUNIX系のOSごとに違う、と書かれています。Linux の中でも、一部の古いCPUアーキテクチャでは番号が違います。
この記事の番号は、x86_64 と arm64 の Linux で使われる値(カーネルの asm-generic の定義)です。プログラムを書くときは番号ではなく名前で判断するのが原則で、番号は「ログを読むときの手がかり」として使ってください。
手元のサーバーで番号を調べる方法¶
一覧に無い番号が出てきたときは、サーバーの上で直接調べられます。Python が入っていれば、次のように番号からメッセージと名前を出せます。
# 番号からメッセージを出す
python3 -c 'import os; print(os.strerror(28))'
# 番号から名前を出す
python3 -c 'import errno; print(errno.errorcode[28])'
# ヘッダーファイルから探す(linux-libc-dev などが入っている場合)
grep -w ENOSPC /usr/include/asm-generic/errno-base.h
moreutils パッケージを入れると、errno -l で一覧を出す errno コマンドも使えます。
ファイルと権限のエラー一覧¶
まずは、ファイルを開く・書く・消すときに出るエラーです。サーバーのトラブルでいちばんよく見るのがこの分類です。
| 番号 | 名前 | メッセージ | 出やすい場面 | 最初に確かめること |
|---|---|---|---|---|
| 1 | EPERM | Operation not permitted | root でないのに所有者を変える、属性で守られたファイルを消す | sudo が要る操作か、lsattr で変更不可の属性が付いていないか |
| 2 | ENOENT | No such file or directory | パスの書き間違い、スクリプトの1行目のインタプリタが無い | ls -l でパスを1段ずつ確かめる。#! の行のパス |
| 13 | EACCES | Permission denied | 権限・所有者の不足、SELinux などの拒否 | ls -l と namei -l パス で途中のディレクトリまで。SELinux の記録 |
| 17 | EEXIST | File exists | 同じ名前のファイルやディレクトリを作ろうとした | 既にあるものを使うか、mkdir -p などで済むか |
| 18 | EXDEV | Invalid cross-device link | 別のファイルシステムへハードリンクを張る | df パス で同じファイルシステムか。コピーで済ませる |
| 20 | ENOTDIR | Not a directory | パスの途中がファイルになっている | パスの各段が本当にディレクトリか |
| 21 | EISDIR | Is a directory | ファイルのつもりでディレクトリを開いた | 指定したパスの末尾 |
| 26 | ETXTBSY | Text file busy | 実行中のプログラムのファイルに書き込もうとした | そのファイルを実行中のプロセス(fuser パス) |
| 27 | EFBIG | File too large | ファイルシステムやプロセスの上限を超える大きさ | ファイルシステムの種類と ulimit -f |
| 28 | ENOSPC | No space left on device | ディスクが満杯、または inode が枯渇 | df -h と df -i の両方 |
| 30 | EROFS | Read-only file system | ファイルシステムが読み取り専用でマウントされている | findmnt パス のオプションと、カーネルのログ |
| 36 | ENAMETOOLONG | File name too long | ファイル名やパスが長すぎる | 自動生成された名前の長さ |
| 39 | ENOTEMPTY | Directory not empty | 中身のあるディレクトリを rmdir した |
中身を確かめてから消す |
| 40 | ELOOP | Too many levels of symbolic links | シンボリックリンクが輪になっている | readlink -f や namei パス でリンクの先 |
| 116 | ESTALE | Stale file handle | NFS などで、相手側でファイルが消えた・入れ替わった | 再マウントやファイルの開き直し |
| 117 | EUCLEAN | Structure needs cleaning | ファイルシステムの構造が壊れている | カーネルのログ。アンマウントしてから修復 |
| 122 | EDQUOT | Disk quota exceeded | ユーザーやグループの容量制限を超えた | quota の設定と使用量 |
EACCES と EPERM は、どちらも「許されていない」という意味なので混同しやすいエラーです。一般的には、ファイルの権限が足りないときは EACCES、root などの特別な権限が無いとできない操作のときは EPERM になります。
Permission denied で権限が合っているように見えるときは、SELinuxの拒否をausearchで確かめる方法を見てください。SSH の Permission denied (publickey) は、errno ではなく SSH の認証の失敗なので、ssh -vとサーバーのログで鍵認証を確かめる方法で扱っています。
ENOSPC は、容量に空きがあるのに出ることがあります。inode が尽きている場合や、消したファイルをプロセスが開いたままの場合で、切り分けはディスクが100%なのにduでは空いているときの調べ方にまとめています。EROFS は、Read-only file systemで急に書き込めないときの原因の調べ方が詳しい記事です。
プロセスと資源のエラー一覧¶
次は、プロセスやメモリ、ファイルの数などの資源に関係するエラーです。サービスが急に動かなくなったときに、ログに出ていることが多い分類です。
| 番号 | 名前 | メッセージ | 出やすい場面 | 最初に確かめること |
|---|---|---|---|---|
| 3 | ESRCH | No such process | 終わったプロセスに kill した |
PIDが今も同じプロセスか(ps -p PID) |
| 4 | EINTR | Interrupted system call | 処理中にシグナルを受けた | 多くはプログラム側でやり直す。続くときはシグナルの送り元 |
| 5 | EIO | Input/output error | ディスクやデバイスの読み書きの失敗 | カーネルのログ(journalctl -k)とディスクの状態 |
| 7 | E2BIG | Argument list too long | rm * などで引数が多すぎる |
find ... -delete や xargs に分ける |
| 8 | ENOEXEC | Exec format error | CPUの種類が違うバイナリを実行した | file コマンド名 と uname -m |
| 9 | EBADF | Bad file descriptor | 閉じたファイルを使おうとした | 多くはプログラムの不具合。アプリのログ |
| 11 | EAGAIN | Resource temporarily unavailable | プロセス数の上限、待たずに読み書きする処理 | ulimit -u、サービスの TasksMax |
| 12 | ENOMEM | Cannot allocate memory | メモリが確保できない | free の available、OOM Killer の記録 |
| 16 | EBUSY | Device or resource busy | 使用中のファイルシステムをアンマウントした | fuser -m マウント先 や lsof で使っているプロセス |
| 23 | ENFILE | Too many open files in system | システム全体で開けるファイル数の上限 | /proc/sys/fs/file-nr と file-max |
| 24 | EMFILE | Too many open files | プロセスごとに開けるファイル数の上限 | /proc/PID/limits の Max open files |
| 32 | EPIPE | Broken pipe | 相手が閉じたパイプやソケットに書いた | 読む側のプロセスや接続先が先に終わっていないか |
EMFILE と ENFILE はメッセージがよく似ていますが、in system が付くかどうかで、当たっている上限がプロセス単位かシステム全体かが分かれます。どちらの上限かの見分け方は、Too many open filesはどの上限に当たっているかの調べ方で解説しています。
ENOMEM が出たときに free の空きだけを見ると判断を誤りやすいので、Linuxのメモリ不足をavailableとOOM Killerの記録から判断する方法もあわせて読んでみてください。
ネットワークのエラー一覧¶
最後は通信のエラーです。メッセージだけで、通信がどこで止まったのかの見当がつくものが多くあります。
| 番号 | 名前 | メッセージ | 出やすい場面 | 最初に確かめること |
|---|---|---|---|---|
| 98 | EADDRINUSE | Address already in use | 待ち受けたいポートを別のソケットが使っている | sudo ss -ltnp でポートの持ち主 |
| 99 | EADDRNOTAVAIL | Cannot assign requested address | サーバーに無いIPアドレスで待ち受けようとした | ip -br addr と設定ファイルのアドレス |
| 100 | ENETDOWN | Network is down | インターフェースが落ちている | ip -br link の状態 |
| 101 | ENETUNREACH | Network is unreachable | 相手のネットワークへの経路が無い | ip route とデフォルトゲートウェイ |
| 104 | ECONNRESET | Connection reset by peer | 相手やその途中の機器が接続を切った | 相手のサーバーのログ、途中のロードバランサー |
| 107 | ENOTCONN | Transport endpoint is not connected | つながっていないソケットを使った。FUSE のマウントが切れた | アプリのログ。マウントなら findmnt |
| 110 | ETIMEDOUT | Connection timed out | 返事が来ない。途中で通信が捨てられている | ファイアウォール・セキュリティグループ・経路 |
| 111 | ECONNREFUSED | Connection refused | 相手に届いたが、そのポートで待ち受けていない | 相手側で ss -ltn、サービスが動いているか |
| 113 | EHOSTUNREACH | No route to host | 経路が無い、または途中で拒否された | ip route、相手側のファイアウォールの拒否の設定 |
運用でいちばん役に立つのは、Connection refused と Connection timed out の違いです。
Connection refused は、相手のサーバーまでは届いたけれど、そのポートでは誰も待ち受けていなかった、という意味です。調べる場所は相手のサーバーの中で、サービスが起動しているか、待ち受けているアドレスとポートが正しいかを見ます。
Connection timed out は、どこかで通信が捨てられて、返事が来なかったという意味です。こちらはファイアウォールやクラウドのセキュリティグループ、経路など、途中の設定を疑います。層ごとの切り分けは、ping・ss・tcpdumpで疎通トラブルを層ごとに切り分ける方法にまとめています。
Address already in use の調べ方は、ssとlsofでポートを使っているプロセスを突き止める順番で詳しく書いています。
一覧の使い方¶
エラーメッセージを見たら、まずこの一覧で分類を確かめるのがおすすめです。分類が分かれば、見るべき場所がほぼ決まります。
| 分類 | 主に見る場所 |
|---|---|
| ファイルと権限 | 権限・所有者・マウントの状態・ディスクの空き・カーネルのログ |
| プロセスと資源 | 上限の設定(ulimit・systemd のユニット)・メモリ・カーネルのログ |
| ネットワーク | 相手が待ち受けているか・経路・ファイアウォール |
もう1つのコツは、エラーを出したのが「どの処理」だったかを確かめることです。同じ Permission denied でも、設定ファイルを読むときなのか、ログを書くときなのか、ポートで待ち受けるときなのかで、直す場所が変わります。ログにパスやアドレスが出ていればそれを手がかりにし、出ていなければ strace で失敗したシステムコールを確かめる方法もあります。
なお、名前解決の失敗(Name or service not known など)は errno ではなく、名前解決のライブラリが返す別のエラーです。こちらはLinuxの名前解決の順番を見てください。
この一覧は2026年11月23日に作成し、番号とメッセージは Ubuntu 24.04(x86_64)上の glibc とカーネルのヘッダーファイル、意味は errno(3) の man ページで確認しました。「出やすい場面」と「最初に確かめること」は、調べ始めるときの目安で、原因をすべて網羅したものではありません。
Linuxのエラーを読めるようになるには¶
エラーメッセージを読んで調べる場所を決められるかどうかは、ファイルの権限、プロセスと資源の上限、ネットワークの仕組みといった基礎がつながっているかで決まります。一覧で当たりを付けたあとに、なぜそのエラーが出るのかを説明できると、トラブルの対応が速くなります。
InfraAcademy の Linuxのロードマップ では、ファイルと権限、プロセスの管理、ネットワークの確認コマンドを順番に学べます。通信のエラーをもっと深く理解したい人は、ネットワークのロードマップ もあわせて使ってみてください。
まとめ¶
Linuxのエラーメッセージの多くは、errno という共通の番号から来ています。Permission denied は13、No space left on device は28、Connection refused は111のように、番号とメッセージは対応しているので、どのプログラムのログでも同じように読めます。
分類が分かれば、調べる場所はほぼ決まります。ファイルなら権限とディスク、資源なら上限とメモリ、ネットワークなら待ち受けと経路です。
次にエラーに出会ったら、この一覧で番号と分類を確かめてから調べ始めてみてください。闇雲にコマンドを打つより、ずっと早く原因にたどり着けるはずです。



