[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
Выдача сообщения в стандартом формате
В зависимости от компоненты сообщения classification, fmtmsg(3C) пишет
форматированное сообщение либо в стандартный вывод диагностики stderr,
либо на /dev/console. Форматированное сообщение может состоять из
следующих шести стандартных компонент:
classification Направляет выдачу сообщения в stderr и/или на консоль.
Возможные значения этого аргумента приведены на
следующей странице.
label Метка. Определяет источник сообщения. Формат этой
компоненты - два поля, разделенные двоеточием. Первое
поле может быть до 10 символов, второе - до 14.
Предполагается, что метка определяет пакет, к которому
принадлежит программа, и имя самой программы. Например,
метка UX:lp обозначает пакет ОС UNIX System V и
программу lp.
severity Серьезность ошибки. Возможные значения этого аргумента
обсуждаются на следующей странице.
text Причина выдачи сообщения.
action Действия, которые можно предпринять для исправления
ошибки. Перед строкой action автоматически выводится
префикс: TO FIX:.
tag Тег для поиска в документации. Предполагается, что тег
содержит метку и уникальный номер. Пример тега:
UX:lp:123, где 123 - это номер данного сообщения в
документации. Строка tag ограничена длиной 32 символа.
ВЫДАЧА СООБЩЕНИЯ В СТАНДАРТНОМ ФОРМАТЕ
fmtmsg(3C)
ИМЯ
fmtmsg - выдать сообщение в stderr или на системную консоль
ИСПОЛЬЗОВАНИЕ
#include <fmtmsg.h>
int fmtmsg(long classification,
const char *label, int severity,
const char *text, const char *action,
const char *tag);
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
успех - MM_OK
неуспех - MM_NOTOK - полная неудача
MM_NOMSG - не удалось выдать сообщение в stderr
MM_NOCON - не удалось выдать сообщение на консоль