.\"  Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de)
.\"  Distributed under GPL
.\"  adapted glibc info page
.\"
.\"  This should run as 'Guru Meditation' (amiga joke :)
.\"  The function is quite complex and deserves an example
.\"
.\"  Polished, aeb, 2003-11-01
.\"
.\" Japanese Version Copyright (c) 2004 Yuichi SATO
.\"         all rights reserved.
.\" Translated Sat Jul 24 20:19:54 JST 2004
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
.TH FMTMSG 3 2003-11-01 "" "Linux Programmer's Manual"
.SH ̾
fmtmsg \- 줿顼åɽ
.SH 
.nf
.B #include <fmtmsg.h>
.sp
.BI "int fmtmsg(long " classification ", const char *" label ,
.br
.BI "           int " severity ", const char *" text ,
.br
.BI "           const char *" action ", const char *" tag );
.fi
.SH 
δؿϡǵҤ줿å
.I classification
ǻꤵ줿ǥХɽ롣
.I stderr
˽񤭽ФåΥեޥåȤϡ
.B MSGVERB
Ķѿ˰¸롣
.LP
.I label
ϥåȯ̤롣
ʸϥǶڤ줿 2 Ĥʬ鹽ƤʤФʤʤ
1 ܤʬ 10 ʸǤʤФʤ餺
2 ܤʬ 14 ʸǤʤФʤʤ
.LP
.I text
ˤϥ顼򵭽Ҥ롣
.LP
.I action
ˤϥ顼뤿Ѳǽʥƥåפ򵭽Ҥ롣
줬ɽ硢"TO FIX: " դ
.LP
.I tag
Ϥ¿ξ򸫤Ĥ뤿Υ饤ɥȤؤλȤǤ롣

.I label
ͤȥˡʼֹޤǤ٤Ǥ롣
.SS ߡ
ưˤϥߡͤ뤳ȤǤ롣
ߡ
.I classification

.B MM_NULLMC
(0L) ϽϤ򲿤ꤷʤΤᲿɽʤ
ߡ
.I severity

.B NO_SEV
(0) Ͻ (severity) ͿƤʤȤɽ

.BR MM_NULLLBL ,
.BR MM_NULLTXT ,
.BR MM_NULLACT ,
.B MM_NULLTAG

.I "((char *) 0)"
ȶʸ̾Ǥꡢ
.B MM_NULLSEV

.B NO_SEV
̾Ǥ롣
.SS "classification "
.I classification
 4 ξ򵭽Ҥͤ¤Ǥ롣
.br
.sp
ǽͤϽϥͥ롣
.TP 12n
.B MM_PRINT
.I stderr
˽Ϥ롣
.TP
.B MM_CONSOLE
ƥॳ󥽡˽Ϥ롣
.TP
.B "MM_PRINT | MM_CONSOLE"
ξ˽Ϥ롣
.PP
2 ܤͤϥ顼ȯǤ:
.TP 12n
.B MM_HARD
ϡɥ顼ä
.TP
.B MM_FIRM
ե०顼ä
.TP
.B MM_SOFT
եȥ顼ä
.PP
3 ܤͤθΤԤäΤ򥨥󥳡ɤ:
.TP 12n
.B MM_APPL
ץꥱˤäƸΤ줿
.TP
.B MM_UTIL
桼ƥƥˤäƸΤ줿
.TP
.B MM_OPSYS
ڥ졼ƥ󥰥ƥˤäƸΤ줿
.PP
4 ܤͤν٤ɽ:
.TP 12n
.B MM_RECOVER
ǽʥ顼Ǥ롣
.TP
.B MM_NRECOV
Բǽʥ顼Ǥ롣
.SS "severity "
.I severity
ϰʲ 1 ĤͤȤ뤳ȤǤ롣
.TP 12n
.B MM_NOSEV
٤ɽʤ
.TP
.B MM_HALT
ͤ HALT Ȥɽ롣
.TP
.B MM_ERROR
ͤ ERROR Ȥɽ롣
.TP
.B MM_WARNING
ͤ WARNING Ȥɽ롣
.TP
.B MM_INFO
ͤ INFO Ȥɽ롣
.PP
ͤξ 0  4 Ǥ롣
.BR addseverity (3)
ޤϴĶѿ
.B SEV_LEVEL
ȤȤˤꡢɽ٥ʸ򹹤ɲäǤ롣
.SH ֤
ؿ 4 Ĥ֤ͤ:
.TP 12n
.B MM_OK
Ƥޤä
.TP
.B MM_NOTOK
˼Ԥ
.TP
.B MM_NOMSG
.I stderr
˽񤭹Ȥ˥顼ä
.TP
.B MM_NOCON
󥽡˽񤭹Ȥ˥顼ä
.SH Ķѿ
Ķѿ
.B MSGVERB
("message verbosity") 
.I stderr
ؤνϤΰΤ˻ȤȤǤ롣
(󥽡ؤνϤˤϱƶʤ)
ѿơNULL Ǥʤ
Ƕڤ줿ͭʥɤΥꥹȤǤ硢
ɤбåΰΤߤɽ롣
ͭʥɤ "label", "severity", "text", "action", "tag" Ǥ롣
.PP
Ķѿ
.B SEV_LEVEL
Ͽ٥٥ƳΤ˻ѤǤ롣
ǥեȤǤϡ嵭 5 Ĥν٥٥ΤߤѲǽǤ롣
¾οͤξ硢
.BR fmtmsg ()
ϲɽʤ
.BR fmtmsg ()
ƸƤӽФˡ桼
.B SEV_LEVEL

.sp
.RS
SEV_LEVEL=[description[:description[:...]]]
.RE
.sp
Τ褦ʷǥץδĶꤹȡ
.BR fmtmsg ()
 (ɸΥ٥ 0-4 ˲ä) level ˻ꤵ줿ͤդ
Τ褦ʥ٥꤬ȯȻꤵ줿 printstring ɽ롣
 description 
.sp
.RS
severity-keyword,level,printstring
.RE
.sp
ȤǤ롣
.LP
severity-keyword 
.BR fmtmsg ()
˻Ѥʤ¸ߤʤФʤʤ
level ϿͤʸɽΤǤ롣
ͤ 4 礭ͤǤʤФʤʤ
ͤ
.BR fmtmsg ()
 severity ǻѤʤФʤ餺ν٤򤹤롣
ä줿٤񤭤뤳ȤϤǤʤ
printstring ϡ
ν٤Υå
.BR fmtmsg ()
ˤä줿ɽʸǤ롣
.SH 
ؿ
.BR fmtmsg ()

.BR addseverity (3)
ȴĶѿ
.B MSGVERB

.B SEV_LEVEL
 System V ͳ褷Ƥ롣
ؿ
.BR fmtmsg ()
ȴĶѿ
.B MSGVERB
 POSIX.1-2001 ˵ҤƤ롣
.SH 
System V  Unixware  man ڡˤϡ
֤δؿ "pfmt()  addsev()"
ޤ "pfmt(), vpfmt(), lfmt(), vlfmt()" ֤Ƥꡢ
ϺͽǤפȽ񤫤Ƥ롣
.SH 
.nf
#include <stdio.h>
#include <stdlib.h>
#include <fmtmsg.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\en");
        break;
    case MM_NOMSG:
        printf("Nothing printed to stderr\en");
        break;
    case MM_NOCON:
        printf("No console output\en");
        break;
    default:
        printf("Unknown error from fmtmsg()\en");
    }
    exit(EXIT_SUCCESS);
}
.fi
.PP
Ϥ
.nf

    util\-linux:mount: ERROR: unknown mount option
    TO FIX: See mount(8).  util\-linux:mount:017

.fi
Τ褦ˤʤꡢ
.nf

    MSGVERB=text:action; export MSGVERB

.fi
¹ԤǤ
.nf

    unknown mount option
    TO FIX: See mount(8).

.fi
Ȥʤ롣
.SH Ϣ
.BR addseverity (3),
.BR perror (3)