ИМЯ¶

fmtmsg - выводит отформатированные сообщения об ошибках

LIBRARY¶

Standard C library (libc, -lc)

СИНТАКСИС¶

#include <fmtmsg.h>

int fmtmsg(long classification, const char *label,
           int severity, const char *text,
           const char *action, const char *tag);

ОПИСАНИЕ¶

Эта функция выводит сообщение, описываемое аргументами, на устройство(а), заданное в аргументе classification. Для сообщений, записываемых в stderr, формат зависит от переменной окружения MSGVERB.

В аргументе label задаётся источник сообщения. Строка должна состоять из двух частей, разделённых двоеточиями; первая часть должна быть не более 10 символов, а вторая часть — не более 14.

В аргументе text описывается условие ошибки.

В аргументе action описываются возможные шаги по исправлению ошибки. Если они выводятся, то начинаются с «TO FIX: ».

В аргументе tag указывается ссылка на онлайн-документацию, в которой можно найти дополнительную информацию. Он должен содержать значение label и уникальный идентификационный номер.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

Функция может возвращать 4 значения:

MM_OK

Всё хорошо.

MM_NOTOK

Всё плохо.

MM_NOMSG

Ошибка записи в stderr.

MM_NOCON

Ошибка записи в консоль.

ОКРУЖЕНИЕ¶

The environment variable MSGVERB ("message verbosity") can be used to suppress parts of the output to stderr. (It does not influence output to the console.) When this variable is defined, is non-NULL, and is a colon-separated list of valid keywords, then only the parts of the message corresponding to these keywords is printed. Valid keywords are "label", "severity", "text", "action", and "tag".

Переменная окружения SEV_LEVEL может использоваться для ввода новых уровней важности. По умолчанию, доступно только пять уровней важности, описанных выше. Для любого другого числового значения fmtmsg() ничего не печатает. Если пользователь задал SEV_LEVEL в формате

в окружении процесса перед первым вызовом fmtmsg() и каждое описание имеет вид

то fmtmsg() также будет обрабатывать заданные значения уровней (в дополнении к стандартным уровням 0–4), и использовать указанную строку печати, когда встречается такой уровень.

Часть «ключевое-слово-важности» не используется fmtmsg(), но указывается. Часть «уровень» — это строка, представляющая число. Числовое значение должно быть числом более 4. Это значение должно использоваться в аргументе важности fmtmsg() для выбора этого класса. Невозможно заменить любой из предопределённых классов. «Печатаемая-строка» — строка, которая печатается в случае, когда сообщение этого класса обрабатывается fmtmsg().

ВЕРСИИ¶

fmtmsg() is provided since glibc 2.1.

АТРИБУТЫ¶

Описание терминов данного раздела смотрите в attributes(7).

До glibc 2.16 функция fmtmsg() использовала статическую незащищённую переменную, поэтому функцию нельзя использовать в нескольких нитях одновременно.

Начиная с glibc 2.16 функция fmtmsg() использует блокировку для защиты статической переменной, поэтому функцию можно использовать в нескольких нитях одновременно.

СТАНДАРТЫ¶

Функции fmtmsg() и addseverity(3), и переменные окружения MSGVERB и SEV_LEVEL впервые появились в System V.

Функция fmtmsg() и переменная окружения MSGVERB описана в POSIX.1-2001 и POSIX.1-2008.

ЗАМЕЧАНИЯ¶

В справочных страницах System V и UnixWare указано, что эти функции были заменены на «pfmt() и addsev()» или «pfmt(), vpfmt(), lfmt() и vlfmt()», и будут впоследствии удалены.

ПРИМЕРЫ¶

#include <fmtmsg.h>
#include <stdio.h>
#include <stdlib.h>
int
main(void)
{


    long class = MM_PRINT | MM_SOFT | MM_OPSYS | MM_RECOVER;


    int err;


    err = fmtmsg(class, "util-linux:mount", MM_ERROR,


                 "unknown mount option", "See mount(8).",


                 "util-linux:mount:017");


    switch (err) {


    case MM_OK:


        break;


    case MM_NOTOK:


        printf("Nothing printed\n");


        break;


    case MM_NOMSG:


        printf("Nothing printed to stderr\n");


        break;


    case MM_NOCON:


        printf("No console output\n");


        break;


    default:


        printf("Unknown error from fmtmsg()\n");


    }


    exit(EXIT_SUCCESS);
}

Вывод должен быть таким:

util-linux:mount: ERROR: unknown mount option
TO FIX: Смотрите mount(8).  util-linux:mount:017

а после

MSGVERB=text:action; export MSGVERB

вывод станет:

неизвестный параметр mount


    TO FIX: Смотрите mount(8).

СМ. ТАКЖЕ¶

addseverity(3), perror(3)

ПЕРЕВОД¶

Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

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

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