draft/man3/addseverity.3

   1 .\"  Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\"  Distributed under GPL
   3 .\"  adapted glibc info page
   4 .\"
   5 .\"  polished a little, aeb
   6 .\"*******************************************************************
   7 .\"
   8 .\" This file was generated with po4a. Translate the source file.
   9 .\"
  10 .\"*******************************************************************
  11 .TH ADDSEVERITY 3 2008\-06\-14 GNU "Linux Programmer's Manual"
  12 .SH 名前
  13 addseverity \- 新しい重大度 (severity class) を導入する
  14 .SH 書式
  15 .nf
  16 .sp
  17 \fB#include <fmtmsg.h>\fP
  18 .sp
  19 \fBint addseverity(int \fP\fIseverity\fP\fB, const char *\fP\fIs\fP\fB);\fP
  20 .fi
  21 .sp
  22 .in -4n
  23 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  24 .in
  25 .sp
  26 \fBaddseverity\fP(): _SVID_SOURCE
  27 .SH 説明
  28 この関数により、新しい重大度を導入できる。 この重大度は、 \fBfmtmsg\fP(3)  関数の \fIseverity\fP 引き数に入れることができる。
  29 デフォルトでは、後者の \fBfmtmsg\fP(3)  関数は重大度 0\-4 (文字列では (none), HALT, ERROR, WARNING,
  30 INFO) の メッセージを表示する方法しか知らない。 この \fBaddseverity\fP(3)  の呼び出しにより、指定された文字列 \fIs\fP
  31 に指定された値 \fIseverity\fP を付加する。 \fIs\fP が NULL の場合、数値 \fIseverity\fP の重大度が削除される。
  32 デフォルトの重大度のどれかを上書きしたり削除したりすることはできない。 重大度の値は負でない数としなければならない。
  33 .SH 返り値
  34 成功した場合、値 \fBMM_OK\fP が返される。 エラーの場合、返り値は \fBMM_NOTOK\fP である。
  35 起こる可能性があるエラーには、以下のものが含まれる: メモリを使い果たした。 存在しない重大度またはデフォルトの重大度を削除しようとした。
  36 .SH バージョン
  37 \fBaddseverity\fP()  はバージョン 2.1 以降の glibc で提供されている。
  38 .SH 準拠
  39 \fBfmtmsg\fP(3)  関数は X/Open Portability Guide に指定されているが、 この関数は指定されていない。 この関数は
  40 System V システムで利用可能である。
  41 .SH 注意
  42 新しい重大度は、環境変数 \fBSEV_LEVEL\fP を設定することで追加することもできる。
  43 .SH 関連項目
  44 \fBfmtmsg\fP(3)