perror

PERROR(3)                Руководство программиста Linux                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)



                                   2016-03-15                          PERROR(3)