errno

errno는 시스템 콜이나 라이브러리 함수가 실패했을 때 에러 원인을 나타내는 전역 변수다.

#include <errno.h>

extern int errno;

exit cod가 프로세스 종료 상태를 표현하는 것과 비슷하게 errno는 시스템 콜 에러 상태를 나타낸다.

구분	errno	exit code
범위	시스템 콜 에러	프로세스 종료 상태
접근	errno 변수	$? 또는 waitpid
값	양수 (1~133+)	0~255
0의 의미	에러 없음	성공

주요 errno 값

리소스 관련

errno	값	설명
EAGAIN	11	Resource temporarily unavailable
ENOMEM	12	Out of memory
EBUSY	16	Device or resource busy
EMFILE	24	Too many open files (process limit)
ENFILE	23	Too many open files (system limit)

파일 관련

errno	값	설명
ENOENT	2	No such file or directory
EEXIST	17	File exists
EACCES	13	Permission denied
EISDIR	21	Is a directory
ENOTDIR	20	Not a directory

네트워크 관련

errno	값	설명
ECONNREFUSED	111	Connection refused
ETIMEDOUT	110	Connection timed out
EADDRINUSE	98	Address already in use
ENETUNREACH	101	Network is unreachable

프로세스/쓰레드 관련

errno	값	설명
EINTR	4	Interrupted system call
ECHILD	10	No child processes
ESRCH	3	No such process

EAGAIN 상세

EAGAIN(또는 EWOULDBLOCK)은 “나중에 다시 시도하라”는 의미로, 다양한 상황에서 발생한다.

1. Non-blocking I/O

   // non-blocking 소켓에서 데이터가 아직 없을 때
   read(sock_fd, buf, size);  // EAGAIN

2. futex WAIT

   // 기대한 값과 실제 값이 다를 때
   futex(addr, FUTEX_WAIT, expected, ...);  // EAGAIN if *addr != expected

3. 리소스 일시 부족

   // fork 시 일시적으로 프로세스 생성 불가
   fork();  // EAGAIN

올바른 처리

while (1) {
    int ret = some_syscall();
    if (ret == -1) {
        if (errno == EAGAIN || errno == EWOULDBLOCK) {
            // 일시적 실패 → 재시도
            continue;
        }
        if (errno == EINTR) {
            // 시그널 인터럽트 → 재시도
            continue;
        }
        // 다른 에러는 실제 실패
        perror("syscall failed");
        break;
    }
    // 성공
    break;
}

errno 확인 방법

C 코드

#include <stdio.h>
#include <string.h>
#include <errno.h>

if (syscall() == -1) {
    printf("Error: %s (errno=%d)\n", strerror(errno), errno);
    perror("syscall");
}

쉘

# 마지막 명령의 exit code
echo $?

# errno 번호로 이름 찾기
python3 -c "import errno; print(errno.errorcode[11])"  # EAGAIN

strace 출력

read(3, 0x7fff..., 1024) = -1 EAGAIN (Resource temporarily unavailable)

---

참고

• https://man7.org/linux/man-pages/man3/errno.3.html
• /usr/include/asm-generic/errno.h
• /usr/include/asm-generic/errno-base.h