| 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>.
| 2019-03-06 |