InfraAcademy

InfraAcademy Blog

Linuxのエラーメッセージとerrno一覧。Permission denied・No space left on device・Connection refusedの番号と、まず確かめること

著者: ryu | #Linux #トラブルシューティング #errno
講座一覧を見る

Linux・ネットワーク・AWSなど、学びたい分野の講座を探せます

この記事を共有

こんにちは、インフラエンジニアの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のように、番号とメッセージは対応しているので、どのプログラムのログでも同じように読めます。

分類が分かれば、調べる場所はほぼ決まります。ファイルなら権限とディスク、資源なら上限とメモリ、ネットワークなら待ち受けと経路です。

次にエラーに出会ったら、この一覧で番号と分類を確かめてから調べ始めてみてください。闇雲にコマンドを打つより、ずっと早く原因にたどり着けるはずです。

参考

Next Action

記事で読んだ内容を、講座で実装してみましょう

InfraAcademyでは、ブラウザ上でLinuxやネットワークの実践環境を使いながら学習できます。無料で始められる講座から、学習の流れを試せます。

この記事を書いた人

ryu

株式会社InfraAcademy 代表 / エンジニア

大手メーカーでインフラエンジニアとして勤務した後、ベンチャー企業・スタートアップでフルスタックエンジニアを経験。その後、起業し学習サービス「InfraAcademy」を運営しています。
保有資格:ネットワークスペシャリストなど 運営会社:株式会社InfraAcademy

Related

関連記事

ブログ一覧へ

Roadmap

まずはこの4講座から

ログインすれば無料で始められる講座です。気になったテーマから手を動かして学べます。

講座一覧を見る