OSDN Git Service

(split) LDP: Update draft pages
[linuxjm/LDP_man-pages.git] / draft / man3 / setlogmask.3
index 4a412e4..1e8691f 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright (C) 2001 Andries Brouwer <aeb@cwi.nl>.
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
-.\" 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 に対応するビット列は \fILOG_MASK(p)\fP によって求められる。 優先度 \fIp\fP 以上のすべての優先度 (\fIp\fP を含む)
+のマスクビットを 求めることができるマクロ \fILOG_UPTO(p)\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.52 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。