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 .\" Japanese Version Copyright (c) 2004 Yuichi SATO
   8 .\"         all rights reserved.
   9 .\" Translated Thu Jul  1 01:12:35 JST 2004
  10 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  11 .\"
  12 .\"WORD:        severity class  重大度
  13 .\"
  14 .TH ADDSEVERITY 3 2008-06-14 "GNU" "Linux Programmer's Manual"
  15 .\"O .SH NAME
  16 .SH 名前
  17 .\"O addseverity \- introduce new severity classes
  18 addseverity \- 新しい重大度 (severity class) を導入する
  19 .\"O .SH SYNOPSIS
  20 .SH 書式
  21 .nf
  22 .sp
  23 .B #include <fmtmsg.h>
  24 .sp
  25 .BI "int addseverity(int " severity ", const char *" s );
  26 .fi
  27 .sp
  28 .in -4n
  29 .\"O Feature Test Macro Requirements for glibc (see
  30 .\"O .BR feature_test_macros (7)):
  31 glibc 向けの機能検査マクロの要件
  32 .RB ( feature_test_macros (7)
  33 参照):
  34 .in
  35 .sp
  36 .BR addseverity ():
  37 _SVID_SOURCE
  38 .\"O .SH DESCRIPTION
  39 .SH 説明
  40 .\"O This function allows the introduction of new severity classes
  41 .\"O which can be addressed by the
  42 .\"O .I severity
  43 .\"O argument of the
  44 .\"O .BR fmtmsg (3)
  45 .\"O function.
  46 .\"O By default that latter function only knows how to
  47 .\"O print messages for severity 0-4 (with strings (none), HALT,
  48 .\"O ERROR, WARNING, INFO).
  49 .\"O This call attaches the given string
  50 .\"O .I s
  51 .\"O to the given value
  52 .\"O .IR severity .
  53 この関数により、新しい重大度を導入できる。
  54 この重大度は、
  55 .BR fmtmsg (3)
  56 関数の
  57 .I severity
  58 引き数に入れることができる。
  59 デフォルトでは、後者の
  60 .BR fmtmsg (3)
  61 関数は重大度 0-4 (文字列では (none), HALT, ERROR, WARNING, INFO) の
  62 メッセージを表示する方法しか知らない。
  63 この
  64 .BR addseverity (3)
  65 の呼び出しにより、指定された文字列
  66 .I s
  67 に指定された値
  68 .I severity
  69 を付加する。
  70 .\"O If
  71 .\"O .I s
  72 .\"O is NULL, the severity class with the numeric value
  73 .\"O .I severity
  74 .\"O is removed.
  75 .I s
  76 が NULL の場合、数値
  77 .I severity
  78 の重大度が削除される。
  79 .\"O It is not possible to overwrite or remove one of the default
  80 .\"O severity classes.
  81 .\"O The severity value must be nonnegative.
  82 デフォルトの重大度のどれかを上書きしたり削除したりすることはできない。
  83 重大度の値は負でない数としなければならない。
  84 .\"O .SH "RETURN VALUE"
  85 .SH 返り値
  86 .\"O Upon success, the value
  87 .\"O .B MM_OK
  88 .\"O is returned.
  89 .\"O Upon error, the return value is
  90 .\"O .BR MM_NOTOK .
  91 成功した場合、値
  92 .B MM_OK
  93 が返される。
  94 エラーの場合、返り値は
  95 .B MM_NOTOK
  96 である。
  97 .\"O Possible errors include: out of memory, attempt to remove a
  98 .\"O nonexistent or default severity class.
  99 起こる可能性があるエラーには、以下のものが含まれる:
 100 メモリを使い果たした。
 101 存在しない重大度またはデフォルトの重大度を削除しようとした。
 102 .\"O .SH VERSIONS
 103 .SH バージョン
 104 .\"O .BR addseverity ()
 105 .\"O is provided in glibc since version 2.1.
 106 .BR addseverity ()
 107 はバージョン 2.1 以降の glibc で提供されている。
 108 .\"O .SH "CONFORMING TO"
 109 .SH 準拠
 110 .\"O This function is not specified in the X/Open Portability Guide
 111 .\"O although the
 112 .\"O .BR fmtmsg (3)
 113 .\"O function is.
 114 .\"O It is available on System V
 115 .\"O systems.
 116 .BR fmtmsg (3)
 117 関数は X/Open Portability Guide に指定されているが、
 118 この関数は指定されていない。
 119 この関数は System V システムで利用可能である。
 120 .\"O .SH NOTES
 121 .SH 注意
 122 .\"O New severity classes can also be added by setting the environment variable
 123 .\"O .BR SEV_LEVEL .
 124 新しい重大度は、環境変数
 125 .B SEV_LEVEL
 126 を設定することで追加することもできる。
 127 .\"O .SH "SEE ALSO"
 128 .SH 関連項目
 129 .BR fmtmsg (3)