PERROR(3)

ИМЯ
perror - печатает системное сообщение об ошибке

ОБЗОР
#include <stdio.h>

void perror(const char *s); #include <errno.h>

const char * const sys_errlist[];
int sys_nerr;
int errno; /* в реальности объявлено не так; смотрите errno(3) */

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

sys_errlist, sys_nerr:
    начиная с glibc 2.19:
        _DEFAULT_SOURCE
    в glibc 2.19 и старее:
        _BSD_SOURCE

ОПИСАНИЕ
Функция perror() выводит сообщение в стандартный поток ошибок, описывающее последнюю ошибку, возникшую при вызове системной или библиотечной функции.

Сначала печатается строка из аргумента s (если s не равно NULL и *s не указывает на байт null ('\0')), после неё двоеточие и пробел. Затем выводится сообщение о ошибке, соответствующее текущему значению errno, а после этого символ новой строки.

Для большей информативности в строке параметра должно быть имя функции, в которой произошла ошибка.

Глобальный список ошибок sys_errlist[], к которым можно обращаться по номеру errno, можно использовать для получения сообщения об ошибке без символа новой строки. Самый большой номер сообщения в таблице равен sys_nerr-1. Будьте внимательны при прямом доступе к этому списку, так как новые значения ошибок могут быть ещё не добавлены в sys_errlist[]. В настоящее время использование sys_errlist[] не рекомендуется; вместо этого используйте strerror(3).

Когда завершается ошибкой системный вызов, обычно возвращается -1 и изменяется переменная errno для указания что пошло не так (её значения можно найти в <errno.h>). Многие библиотечные функции работают также. Функция perror() служит для перевода этого кода ошибки в форму, понятную человеку. Заметим, что значение errno не определено после успешного выполнения системного вызова или библиотечной функции: этот вызов может также изменить эту переменную даже при успешном выполнении, например из-за ошибки другой библиотечной функции, которая вызывалась при работе. То есть, если после вызова функции сразу не вызывается perror(), значение errno нужно куда-нибудь сохранить.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
perror() | Безвредность в нитях | MT-Safe race:stderr

СООТВЕТСТВИЕ СТАНДАРТАМ
perror(), errno: POSIX.1-2001, POSIX.1-2008, C89, C99, 4.3BSD.

Внешние sys_nerr и sys_errlist появились из BSD, и не описаны в POSIX.1.

ЗАМЕЧАНИЯ
Внешние sys_nerr и sys_errlist определены в glibc, но в файле <stdio.h>.

СМОТРИТЕ ТАКЖЕ
err(3), errno(3), error(3), strerror(3)