Scroll to navigation

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:
From glibc 2.19 to 2.31:
_DEFAULT_SOURCE
Glibc 2.19 and earlier:
_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 нужно куда-нибудь сохранить.

ВЕРСИИ

Since glibc version 2.32, the declarations of sys_errlist and sys_nerr are no longer exposed by <stdio.h>.

АТРИБУТЫ

Описание терминов данного раздела смотрите в 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)

ЗАМЕЧАНИЯ

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Alexey, Azamat Hackimov <azamat.hackimov@gmail.com>, kogamatranslator49 <r.podarov@yandex.ru>, Kogan, Max Is <ismax799@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.

1 ноября 2020 г.