errno(3) - wariua/manpages-ko GitHub Wiki

errno - 마지막 오류의 번호

#include <errno.h>

<errno.h> 헤더 파일에서 정수 변수 errno를 정의한다. 시스템 호출과 일부 라이브러리 함수에서 오류 발생 시 무엇이 잘못됐는지 나타내기 위해 그 변수를 설정한다.

호출의 반환 값이 오류를 나타낸 (즉 대부분 시스템 호출에서 -1, 대부분 라이브러리 함수에서 -1 내지 NULL인) 때에만 errno의 값이 의미가 있다. 즉 성공하는 함수에서 errno를 바꾸는 것이 허용된다. 어떤 시스템 호출이나 라이브러리 호출에서도 절대 errno 값을 0으로 설정하지는 않는다.

어떤 시스템 호출과 라이브러리 함수(가령 getpriority(2))에서는 -1이 성공 시의 유효한 반환 값이다. 그런 경우에는 호출 전에 errno를 0으로 설정해서 성공 반환과 오류 반환을 구별할 수 있다. 오류가 발생했을 수도 있음을 나타내는 상태를 호출에서 반환하면 errno가 0 아닌 값인지 확인하면 된다.

errno는 ISO C에서 int 타입의 변경 가능한 lvalue라고 규정돼 있으며 명시적으로 선언해서는 안 된다. 즉 errno가 매크로일 수도 있다. errno는 스레드 로컬이다. 그래서 한 스레드에서 그 값을 설정해도 다른 스레드의 값에 영향을 주지 않는다.

유효한 오류 번호들은 모두 양수 번호이다. errno에 등장할 수 있는 오류 번호 각각의 심볼 이름이 <errno.h> 헤더 파일에 정의돼 있다.

POSIX.1에서 명세하는 오류 이름들은 모두 서로 다른 값을 가져야 한다. 단 예외로 EAGAIN과 EWOULDBLOCK은 같을 수도 있다.

각 심볼 이름에 대응하는 오류 번호는 유닉스 시스템 종류에 따라 다르며 심지어 리눅스에서 아키텍처에 따라 다르기도 하다. 그래서 아래의 오류 이름 목록에는 번호 값이 포함돼 있지 않다. perror(3) 및 strerror(3) 함수를 사용하면 그 이름을 대응하는 텍스트 오류 메시지로 변환할 수 있다.

어떤 리눅스 시스템 상에서든 (moreutils 패키지에 포함된) errno(1) 명령을 쓰면 모든 오류 심볼 이름과 대응하는 오류 번호들의 목록을 얻을 수 있다.

$ errno -l
EPERM 1 Operation not permitted
ENOENT 2 No such file or directory
ESRCH 3 No such process
EINTR 4 Interrupted system call
EIO 5 Input/output error
...

또한 errno(1) 명령을 사용해 다음과 같이 개별 오류 번호와 이름을 찾아보고 오류 서술에서 얻은 문자열로 오류를 검색할 수 있다.

$ errno 2
ENOENT 2 No such file or directory
$ errno ESRCH
ESRCH 3 No such process
$ errno -s permission
EACCES 13 Permission denied

아래의 오류 심볼 이름 목록에서 여러 이름들에 다음과 같은 표시가 되어 있다.

• POSIX.1-2001: 그 이름을 POSIX.1-2001에서, 그리고 달리 표시돼 있지 않으면 이후 POSIX.1 버전들에서도 규정하고 있다.

• POSIX.1-2008: 그 이름을 POSIX.1-2008에서는 규정하고 있지만 더 전의 POSIX.1 표준에는 없다.

• C99: 그 이름을 C99에서 규정하고 있다. 다음은 리눅스에서 정의돼 있는 오류 심볼 이름들의 목록이다.

많이 하는 실수로 다음과 같은 게 있다.

if (somecall() == -1) {
    printf("somecall() failed\n");
    if (errno == ...) { ... }
}

여기서 errno가 꼭 somecall() 함수 반환 시의 값을 가지고 있는 게 아니다. (즉 printf(3)에 의해 바뀌었을 수도 있다.) 라이브러리 호출을 거치면서 errno 값이 보존돼야 한다면 저장을 해야 한다.

if (somecall() == -1) {
    int errsv = errno;
    printf("somecall() failed\n");
    if (errsv == ...) { ... }
}

일부 아주 오래된 시스템에서는 <errno.h>가 존재하지 않거나 errno를 선언해 주지 않았으며, 그래서 errno를 직접 선언(extern int errno)해야 했다. 지금은 그렇게 해선 안 된다. 오래 전부터 그럴 필요가 없게 됐으며 최근의 C 라이브러리 버전들에서 문제를 일으키게 된다.

errno(1), err(3), error(3), perror(3), strerror(3)

2019-03-06