名 前
addseverity − 新 し い 重 大 度 (severity class) を 導 入 す る
書 式
#include <fmtmsg.h>
int addseverity(int severity, const char *s);
glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):
addseverity(): _SVID_SOURCE
説 明
こ の 関 数 に よ り 、 新 し い 重 大 度 を 導 入 で き る 。 こ の 重 大 度 は 、 fmtmsg(3) 関 数 の severity 引 き 数 に 入 れ る こ と が で き る 。 デ フ ォ ル ト で は 、 fmtmsg(3) 関 数 は 重 大 度 0−4 (文 字 列 で は (none), HALT, ERROR, WARNING, INFO) の メ ッ セ ー ジ を 表 示 す る 方 法 し か 知 ら な い 。 こ の addseverity(3) の 呼 び 出 し に よ り 、 指 定 さ れ た 文 字 列 s に 指 定 さ れ た 値 severity を 付 加 す る 。 s が NULL の 場 合 、 数 値 severity の 重 大 度 が 削 除 さ れ る 。 デ フ ォ ル ト の 重 大 度 の ど れ か を 上 書 き し た り 削 除 し た り す る こ と は で き な い 。 重 大 度 の 値 は 負 で な い 数 と し な け れ ば な ら な い 。
返 り 値
成 功 し た 場 合 、 値 MM_OK が 返 さ れ る 。 エ ラ ー の 場 合 、 返 り 値 は MM_NOTOK で あ る 。 起 こ る 可 能 性 が あ る エ ラ ー に は 、 以 下 の も の が 含 ま れ る : メ モ リ ー を 使 い 果 た し た 。 存 在 し な い 重 大 度 ま た は デ フ ォ ル ト の 重 大 度 を 削 除 し よ う と し た 。
バ ー ジ ョ ン
addseverity() は バ ー ジ ョ ン 2.1 以 降 の glibc で 提 供 さ れ て い る 。
準 拠
fmtmsg(3) 関 数 は X/Open Portability Guide に 指 定 さ れ て い る が 、 こ の 関 数 は 指 定 さ れ て い な い 。 こ の 関 数 は System V シ ス テ ム で 利 用 可 能 で あ る 。
注 意
新 し い 重 大 度 は 、 環 境 変 数 SEV_LEVEL を 設 定 す る こ と で 追 加 す る こ と も で き る 。
関 連 項 目
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。