errno

Глобальная переменная для значений ошибок

Прототип:

#include <errno.h>
                                       
extern int errno;
                                       
char * const sys_errlist[];
int sys_nerr;

Библиотека:

libc

Описание:

Переменная errno устанавливается в текущее значение ошибки многими функциями во время возникновения ошибки.

---

Проверять значение переменной errno после вызова функции целесообразно только в том случае, если функция явно указывает на возникшую в процессе её выполнения ошибку (например, определённым значением возвращаемого результата). В противном случае значение errno недействительно. Также функции системной библиотеки никогда не сбрасывают значение errno в 0 в случае успешного выполнения. В документации функции могут быть явно перечислены некоторые значения errno с уточнением их смысла. При этом функция потенциально может использовать и другие возможные значения для errno.

---

Переменная errno может быть реализована как макрос, но ее значение всегда можно проверить или установить, как если бы она была простым целочисленным значением.

---

Каждый поток в многопоточной программе имеет собственное значение ошибки в своем локальном хранилище. Вне зависимости от того, в каком потоке Вы находитесь, Вы можете просто сослаться на errno — она определена таким образом, что всегда ссылается на корректное значение переменной для потока. Для дополнительной информации смотрите ThreadCreate().

---

В <errno.h> также определены следующие переменные:

sys_errlist

Массив сообщений об ошибках, ссылающихся на errno.

sys_nerr

Количество сообщений в массиве sys_errlist.

Значения errno включают минимум следующие значения:

Изменения в EALREADY

POSIX требует, чтобы номера ошибок в <errno.h> имели уникальное значение. Для удовлетворения этого требования EALREADY изменен и не имеет одинакового значения с EBUSY.

Это изменение могло вызвать проблемы совместимости, поскольку код, использующий в данный момент EALREADY, был скомпилирован со старым значением. Для безопасного перехода к новому значению заголовочный файл <errno.h> был изменен путем определения новых символьных значений:

EALREADY_OLD

Старое значение (16).

EALREADY_NEW

Новое значение (237).

EALREADY_DYNAMIC

Значение, которое можно сконфигурировать во время запуска. Это переменная в libc, которая устанавливается в старое или новое значение на основе общесистемного параметра конфигурации.

В следующей редакции значение EALREADY будет изменено на EALREADY_NEW. Чтобы обеспечить безопасный переход к новому значению, нужно модифицировать код следующим образом:

• Если код проверяет возвращаемое значение EALREADY, измените его следующим образом:

  #if defined( EALREADY_NEW ) && defined( EALREADY_OLD )
      if ( error == EALREADY_NEW || error == EALREADY_OLD )
      {
          /* deal with EALREADY error cases */
      }
  #else
      if ( error == EALREADY )
      {
          /* deal with EALREADY error cases */
      }
  #endif

  Это гарантирует, что код, обработает ошибку EALREADY для любого API, возвращающего старое или новое значение.

• Если код возвращает ошибку EALREADY, измените его, чтобы он возвращал EALREADY_DYNAMIC. Во многих случаях этого можно добиться добавлением флага компиляции -DEALREADY=EALREADY_DYNAMIC.

Можно использовать опцию -e procnto-* для установки значения EALREADY_DYNAMIC:

• -eo — использовать прежнее значение, совпадающее со значением EBUSY.
• -en — использовать соответствующее POSIX значение.

Примеры:

/*
 *  The following program makes an illegal call
 *  to the write() function, then prints the
 *  value held in errno.
 */
#include <stdio.h>
#include <unistd.h>
#include <errno.h>
#include <string.h>
                                       
int main( void )
{
    int errvalue;
                                       
    errno = EOK;
    write( -1, "hello, world\n", strlen( "hello, world\n" ) );
    errvalue = errno;
    printf( "The error generated was %d\n", errvalue );
    printf( "That means: %s\n", strerror( errvalue ) );
}

Классификация:

ANSI, POSIX 1003.1

Тематические ссылки:

h_errno, perror(), stderr, strerror(), strerror_r()

Предыдущий раздел: Описание API системной библиотеки