C 語言呼叫系統呼叫/函式庫函數失敗時,會設定全域變數 errno (需 #include ) 指示錯誤原因。掌握常見錯誤碼與正確處理模式,能大幅提升除錯效率。
"自訂字串: 系統錯誤訊息"。strerror(errno) 結果。#include#include #include FILE *fp = fopen("nonexist.txt", "r"); if (!fp) { perror("fopen failed"); // 方式 1 fprintf(stderr, "fopen failed: %s\n", strerror(errno)); // 方式 2 printf("fopen failed: %m\n"); // 方式 3 (GNU) }
網路函數 gethostbyname()、gethostbyaddr() 錯誤碼存於 h_errno,需用 herror() 或 hstrerror() 處理,不可用 perror/strerror。
struct hostent *h = gethostbyname("example.com");
if (!h) {
herror("gethostbyname"); // 正確
// perror("gethostbyname"); // 錯誤:讀取 errno 而非 h_errno
}
| 宏定義 | 值 | 描述 |
|---|---|---|
| EPERM | 1 | 操作不被允許 (非 root/權限不足) |
| ENOENT | 2 | 檔案或目錄不存在 |
| ESRCH | 3 | 指定行程不存在 |
| EINTR | 4 | 系統呼叫被中斷 (訊號) |
| EIO | 5 | I/O 錯誤 (硬體故障) |
| ENXIO | 6 | 裝置/位址不存在 |
| E2BIG | 7 | 參數列表過長 |
| ENOEXEC | 8 | 執行檔格式錯誤 |
| EBADF | 9 | 壞的檔案描述符 |
| ECHILD | 10 | 無子行程 |
| EAGAIN / EWOULDBLOCK | 11 | 資源暫時不可用 (非阻塞 I/O) |
| ENOMEM | 12 | 記憶體不足 |
| EACCES | 13 | 權限被拒絕 |
| EFAULT | 14 | 錯誤的位址 (使用者空間指標無效) |
| ENOTBLK | 15 | 需要區塊裝置 |
| EBUSY | 16 | 裝置或資源忙碌 |
| EEXIST | 17 | 檔案已存在 |
| EXDEV | 18 | 跨裝置連結 |
| ENODEV | 19 | 無此裝置 |
| ENOTDIR | 20 | 非目錄 |
| EISDIR | 21 | 是目錄 |
| EINVAL | 22 | 無效參數 |
| ENFILE | 23 | 系統檔案表滿 |
| EMFILE | 24 | 行程開啟檔案過多 |
| ENOTTY | 25 | 非終端機裝置 |
| ETXTBSY | 26 | 文字檔忙碌 (執行中檔案寫入) |
| EFBIG | 27 | 檔案過大 |
| ENOSPC | 28 | 裝置無剩餘空間 |
| ESPIPE | 29 | 非法 seek (管道/通訊端) |
| EROFS | 30 | 唯讀檔案系統 |
| EMLINK | 31 | 連結數過多 |
| EPIPE | 32 | 管道破裂 (寫入無讀端管道) |
| EDOM | 33 | 數學函數定義域錯誤 |
| ERANGE | 34 | 數學函數結果超出範圍 |
| EDEADLK | 35 | 資源死結會發生 |
| ENAMETOOLONG | 36 | 檔案名稱過長 |
| ENOLCK | 37 | 無可用記錄鎖 |
| ENOSYS | 38 | 功能未實作 |
| ENOTEMPTY | 39 | 目錄非空 |
| ELOOP | 40 | 符號連結層級過深 |
| ENOMSG | 42 | 無所需類型訊息 |
| EIDRM | 43 | 識別碼已移除 |
| ENOTSOCK | 88 | 非 Socket |
| EDESTADDRREQ | 89 | 需指定目的地址 |
| EMSGSIZE | 90 | 訊息過大 |
| EPROTOTYPE | 91 | 協議類型錯誤 |
| ENOPROTOOPT | 92 | 協議選項不存在 |
| EPROTONOSUPPORT | 93 | 協議不支援 |
| ESOCKTNOSUPPORT | 94 | Socket 類型不支援 |
| EOPNOTSUPP | 95 | 操作不支援 |
| EPFNOSUPPORT | 96 | 協議族不支援 |
| EAFNOSUPPORT | 97 | 地址族不支援 |
| EADDRINUSE | 98 | 地址已在使用 |
| EADDRNOTAVAIL | 99 | 地址不可用 |
| ENETDOWN | 100 | 網路不可用 |
| ENETUNREACH | 101 | 網路不可達 |
| ENETRESET | 102 | 連線被網路重置 |
| ECONNABORTED | 103 | 連線被軟體中止 |
| ECONNRESET | 104 | 連線被對端重置 |
| ENOBUFS | 105 | 緩衝區空間不足 |
| EISCONN | 106 | 已連線 |
| ENOTCONN | 107 | 未連線 |
| ESHUTDOWN | 108 | 連線已關閉 |
| ETOOMANYREFS | 109 | 參考過多 |
| ETIMEDOUT | 110 | 連線逾時 |
| ECONNREFUSED | 111 | 連線被拒絕 |
| EHOSTDOWN | 112 | 主機宕機 |
| EHOSTUNREACH | 113 | 主機不可達 |
| EALREADY | 114 | 操作已在進行中 |
| EINPROGRESS | 115 | 操作進行中 |
| ESTALE | 116 | NFS 檔案控制塊過期 |
| EREMOTE | 117 | 對象在遠端 |
errno (後續函數呼叫會覆蓋)。strerror(errno) 記錄日誌,保留上下文 (函數名、參數、時間戳)。ECONNRESET, ETIMEDOUT, EHOSTUNREACH 並實作指數退避重連。errno 為執行緒區域變數 (TLS),各緒互不干擾 (需編譯器/庫支援,現代 glibc/pthreads 均支援)。strace -f -e trace=all ./program 追蹤系統呼叫與 errno 回傳,快速定位問題。man 3 errno、man 2 intro (系統呼叫錯誤碼)。errno -l (moreutils 套件) 列出所有定義。