OSDN Git Service

(split) LDP: Update drafts based on LDP v3.40.
[linuxjm/LDP_man-pages.git] / draft / man3 / setlogmask.3
index 4a412e4..e01bea2 100644 (file)
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
 .\"
-.\" Japanese Version Copyright (c) 2001 Akihiro MOTOKI
-.\"         all rights reserved.
-.\" Translated Sat Nov  3 01:46:03 JST 2001
-.\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\"*******************************************************************
 .\"
-.\"WORD:       logging         ¥í¥°¼ý½¸
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH SETLOGMASK 3  2001-10-05 "" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O setlogmask \- set log priority mask
-setlogmask \- ¥í¥°¤ÎÍ¥ÀèÅÙ¥Þ¥¹¥¯¤òÀßÄꤹ¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.\"*******************************************************************
+.TH SETLOGMASK 3 2001\-10\-05 "" "Linux Programmer's Manual"
+.SH 名前
+setlogmask \- ログの優先度マスクを設定する
+.SH 書式
 .nf
-.B #include <syslog.h>
+\fB#include <syslog.h>\fP
 .sp
-.BI "int setlogmask(int " mask );
+\fBint setlogmask(int \fP\fImask\fP\fB);\fP
 .fi
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O A process has a log priority mask that determines which calls to
-.\"O .BR syslog (3)
-.\"O may be logged.
-.\"O All other calls will be ignored.
-¥×¥í¥»¥¹¤Ë¤Ï¥í¥°Í¥ÀèÅÙ¥Þ¥¹¥¯(log priority mask)¤¬ÍÑ°Õ¤µ¤ì¤Æ¤¤¤Æ¡¢
-¤³¤ì¤òÍѤ¤¤Æ
-.BR syslog (3)
-¤¬¸Æ¤Ó½Ð¤µ¤ì¤¿¾ì¹ç¤Ë¥í¥°µ­Ï¿¤ò¹Ô¤¦¤«¤É¤¦¤«¤ò·èÄꤹ¤ë¡£
-¾¤Î¤¹¤Ù¤Æ¤Î´Ø¿ô¤¬¸Æ¤Ó½Ð¤µ¤ì¤¿¾ì¹ç¤Ï¥í¥°µ­Ï¿¤¬¹Ô¤ï¤ì¤Ê¤¤¡£
-.\"O Logging is enabled for the priorities that have the corresponding
-.\"O bit set in
-.\"O .IR mask .
-.I mask
-¤Î³Æ¥Ó¥Ã¥È¤ÏÍ¥ÀèÅÙ¤ËÂбþ¤·¤Æ¤ª¤ê¡¢Âбþ¤¹¤ë¥Ó¥Ã¥È¤¬ 1 ¤Ë¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤ë
-Í¥ÀèÅÙ¤ËÂФ·¤Æ¥í¥°¼ý½¸(logging)¤¬Í­¸ú¤Ë¤Ê¤ë¡£
-.\"O The initial mask is such that logging is enabled for all priorities.
-¥Þ¥¹¥¯¤Î½é´üÃͤϡ¢¤¹¤Ù¤Æ¤ÎÍ¥ÀèÅÙ¤ËÂФ·¤Æ¥í¥°¼ý½¸¤¬Í­¸ú¤Ë¤Ê¤ë¤è¤¦¤ÊÃͤǤ¢¤ë¡£
+.SH 説明
+プロセスにはログ優先度マスク(log priority mask)が用意されていて、 これを用いて \fBsyslog\fP(3)
+が呼び出された場合にログ記録を行うかどうかを決定する。 他のすべての関数が呼び出された場合はログ記録が行われない。 \fImask\fP
+の各ビットは優先度に対応しており、対応するビットが 1 にセットされている 優先度に対してログ収集(logging)が有効になる。
+マスクの初期値は、すべての優先度に対してログ収集が有効になるような値である。
 .LP
-.\"O The
-.\"O .BR setlogmask ()
-.\"O function sets this logmask for the calling process,
-.\"O and returns the previous mask.
-.BR setlogmask ()
-´Ø¿ô¤Ï¡¢¸Æ¤Ó½Ð¤·¸µ¤Î¥×¥í¥»¥¹¤ËÂФ¹¤ë¥í¥°¥Þ¥¹¥¯¤òÀßÄꤷ¡¢
-Êѹ¹Á°¤Î¥Þ¥¹¥¯¤òÊÖ¤¹¡£
-.\"O If the mask argument is 0, the current logmask is not modified.
-.I mask
-°ú¤­¿ô¤¬ 0 ¤Ê¤é¤Ð¡¢¸½ºß¤Î¥í¥°¥Þ¥¹¥¯¤ÏÊѹ¹¤µ¤ì¤Ê¤¤¡£
+\fBsetlogmask\fP()  関数は、呼び出し元のプロセスに対するログマスクを設定し、 変更前のマスクを返す。 \fImask\fP 引き数が 0
+ならば、現在のログマスクは変更されない。
 .LP
-.\"O The eight priorities are
-.\"O .BR LOG_EMERG ,
-.\"O .BR LOG_ALERT ,
-.\"O .BR LOG_CRIT ,
-.\"O .BR LOG_ERR ,
-.\"O .BR LOG_WARNING ,
-.\"O .BR LOG_NOTICE ,
-.\"O .BR LOG_INFO ,
-.\"O and
-.\"O .BR LOG_DEBUG .
-.\"O The bit corresponding to a priority \fIp\fP is \fBLOG_MASK\fP(\fIp\fP).
-.\"O Some systems also provide a macro \fBLOG_UPTO\fP(\fIp\fP) for the mask
-.\"O of all priorities in the above list up to and including \fIp\fP.
-°Ê²¼¤Î8¥ì¥Ù¥ë¤ÎÍ¥ÀèÅÙ¤¬ÄêµÁ¤µ¤ì¤Æ¤¤¤ë(Í¥ÀèÅ٤ι⤤½ç)¡§
-.BR LOG_EMERG ,
-.BR LOG_ALERT ,
-.BR LOG_CRIT ,
-.BR LOG_ERR ,
-.BR LOG_WARNING ,
-.BR LOG_NOTICE ,
-.BR LOG_INFO ,
-.BR LOG_DEBUG ¡£
-Í¥ÀèÅÙ \fIp\fP ¤ËÂбþ¤¹¤ë¥Ó¥Ã¥ÈÎó¤Ï \fBLOG_MASK\fP(\fIp\fP) ¤Ë¤è¤Ã¤Æµá¤á¤é¤ì¤ë¡£
-Í¥ÀèÅÙ \fIp\fP °Ê¾å¤Î¤¹¤Ù¤Æ¤ÎÍ¥ÀèÅÙ (\fIp\fP ¤ò´Þ¤à) ¤Î¥Þ¥¹¥¯¥Ó¥Ã¥È¤ò
-µá¤á¤ë¤³¤È¤¬¤Ç¤­¤ë¥Þ¥¯¥í \fBLOG_UPTO\fP(\fIp\fP) ¤ò»ÈÍѤǤ­¤ë¥·¥¹¥Æ¥à¤â¤¢¤ë¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O This function returns the previous log priority mask.
-Êѹ¹Á°¤Î¥í¥°Í¥ÀèÅÙ¥Þ¥¹¥¯¤ÎÃͤòÊÖ¤¹¡£
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.\"O None.
-¤Ê¤·¡£
-.\"O .\" .SH NOTES
-.SH Ãí°Õ
-.\"O .\" The glibc logmask handling was broken in versions before glibc 2.1.1.
-glibc 2.1.1 ¤è¤êÁ°¤Î¥Ð¡¼¥¸¥ç¥ó¤Ç¤Ï glibc ¤Î¥í¥°¥Þ¥¹¥¯¤Î°·¤¤¤ËÉÔ¶ñ¹ç¤¬¤¢¤ë¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-POSIX.1-2001.
-.\"O Note that the description in POSIX.1-2001 is flawed.
-POSIX.1-2001 ¤Ç¤ÎÀâÌÀ¤Ë¤Ï·ç´Ù¤¬¤¢¤ë¤³¤È¤ËÃí°Õ¤¹¤ë¤³¤È¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR closelog (3),
-.BR openlog (3),
-.BR syslog (3)
+以下の8レベルの優先度が定義されている(優先度の高い順): \fBLOG_EMERG\fP, \fBLOG_ALERT\fP, \fBLOG_CRIT\fP,
+\fBLOG_ERR\fP, \fBLOG_WARNING\fP, \fBLOG_NOTICE\fP, \fBLOG_INFO\fP, \fBLOG_DEBUG\fP。 優先度
+\fIp\fP に対応するビット列は \fBLOG_MASK\fP(\fIp\fP) によって求められる。 優先度 \fIp\fP 以上のすべての優先度 (\fIp\fP を含む)
+のマスクビットを 求めることができるマクロ \fBLOG_UPTO\fP(\fIp\fP) を使用できるシステムもある。
+.SH 返り値
+変更前のログ優先度マスクの値を返す。
+.SH エラー
+.\" .SH NOTES
+.\" The glibc logmask handling was broken in versions before glibc 2.1.1.
+なし。
+.SH 準拠
+POSIX.1\-2001.  POSIX.1\-2001 での説明には欠陥があることに注意すること。
+.SH 関連項目
+\fBcloselog\fP(3), \fBopenlog\fP(3), \fBsyslog\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.40 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。