.\" Modified 13 Dec 2001, Martin Schulze <joey@infodrom.org>
.\" Modified 3 Jan 2002, Michael Kerrisk <mtk.manpages@gmail.com>
.\"
-.\" Japanese Verion Copyright (c) 1996 Shoichi OZAWA
-.\" all right reserved.
-.\" Translated Sep 1 20:14:01 JST 1996
-.\" by Shoichi OZAWA <ozawa@omika.hitachi.co.jp>
-.\" Updated Thu Oct 18 01:00:02 JST 2001
-.\" by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated Fri Jan 4 22:15:21 JST 2002
-.\" by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2002-04-14 by Kentaro Shirakata <argrath@ub32.org>
-.\" Updated 2007-01-01 by Kentaro Shirakata <argrath@ub32.org>
+.\"*******************************************************************
.\"
-.TH SYSLOG 3 2008-11-12 "Linux" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH SYSLOG 3 2008\-11\-12 Linux "Linux Programmer's Manual"
.SH 名前
closelog, openlog, syslog, vsyslog \- システムロガーにメッセージを送る
.SH 書式
-.B #include <syslog.h>
+\fB#include <syslog.h>\fP
.sp
-.BI "void openlog(const char *" ident ", int " option ", int " facility );
+\fBvoid openlog(const char *\fP\fIident\fP\fB, int \fP\fIoption\fP\fB, int
+\fP\fIfacility\fP\fB);\fP
.br
-.BI "void syslog(int " priority ", const char *" format ", ...);"
+\fBvoid syslog(int \fP\fIpriority\fP\fB, const char *\fP\fIformat\fP\fB, ...);\fP
.br
-.B "void closelog(void);"
+\fBvoid closelog(void);\fP
.sp
-.B #include <stdarg.h>
+\fB#include <stdarg.h>\fP
.sp
-.BI "void vsyslog(int " priority ", const char *" format ", va_list " ap );
+\fBvoid vsyslog(int \fP\fIpriority\fP\fB, const char *\fP\fIformat\fP\fB, va_list
+\fP\fIap\fP\fB);\fP
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
-.BR vsyslog ():
-_BSD_SOURCE
+\fBvsyslog\fP(): _BSD_SOURCE
.SH 説明
-.BR closelog ()
-はシステムのログ記録用プログラム(システムロガー
-.BR syslogd (8))
-ヘの接続を終了する。
-.BR closelog ()
-は必須ではない。
+\fBcloselog\fP() はシステムのログ記録用プログラム(システムロガー \fBsyslogd\fP(8)) ヘの接続を終了する。
+\fBcloselog\fP() は必須ではない。
.sp
-.BR openlog ()
-はログを出力しようとしているプログラムからログ記録用プログラムへの
-接続を開始する。
-.I ident
-で指定した文字列(通常は
-.BR openlog ()
-したプログラムの名前)はログ出力の一文一文に追加され、どのプログラム
-が出力したログかを識別するために使われる。
-.I option
-引き数は、
-.BR openlog ()
-の動作とその後の
-.BR syslog ()
-の呼び出しを制御するフラグを指定する。
-.I facility
-引き数は、後で
-.BR syslog ()
-を呼び出す際に facility が指定されなかった場合に使用される
-デフォルト値を決定する。
-.I option
-と
-.I facility
-については後述する。
-.BR openlog ()
-は必須ではなく、必要に応じて
-.BR syslog ()
-から呼び出される。
-.BR syslog ()
-が呼び出した場合、
-.I ident
-のデフォルト値は NULL になる。
+\fBopenlog\fP() はログを出力しようとしているプログラムからログ記録用プログラムへの 接続を開始する。 \fIident\fP
+で指定した文字列(通常は \fBopenlog\fP() したプログラムの名前)はログ出力の一文一文に追加され、どのプログラム
+が出力したログかを識別するために使われる。 \fIoption\fP 引き数は、 \fBopenlog\fP() の動作とその後の \fBsyslog\fP()
+の呼び出しを制御するフラグを指定する。 \fIfacility\fP 引き数は、後で \fBsyslog\fP() を呼び出す際に facility
+が指定されなかった場合に使用される デフォルト値を決定する。 \fIoption\fP と \fIfacility\fP については後述する。
+\fBopenlog\fP() は必須ではなく、必要に応じて \fBsyslog\fP() から呼び出される。 \fBsyslog\fP() が呼び出した場合、
+\fIident\fP のデフォルト値は NULL になる。
.sp
-.BR syslog ()
-はログメッセージを出力し、
-.BR syslogd (8)
-がそのメッセージを記録する。
-.I priority
-引き数は
-.I facility
-と
-.I level
-との組合せで指定する。
-.I facility
-と
-.I level
-の取りうる値は後述する。
-残りの
-.I format
-引き数は
-.BR printf (3)
-と似たスタイルの書式とその書式に与える値である。
-.I format
-中の2文字
-.B %m
-はその時点での
-.I errno
-に関連するエラーメッセージ文字列
-.RI ( strerror )
-によって置き換えられる。
+\fBsyslog\fP() はログメッセージを出力し、 \fBsyslogd\fP(8) がそのメッセージを記録する。 \fIpriority\fP 引き数は
+\fIfacility\fP と \fIlevel\fP との組合せで指定する。 \fIfacility\fP と \fIlevel\fP の取りうる値は後述する。 残りの
+\fIformat\fP 引き数は \fBprintf\fP(3) と似たスタイルの書式とその書式に与える値である。 \fIformat\fP 中の2文字 \fB%m\fP
+はその時点での \fIerrno\fP に関連するエラーメッセージ文字列 (\fIstrerror\fP) によって置き換えられる。
必要な場合は末尾に改行が加えられる。
-.BR vsyslog ()
-関数は
-.BR syslog ()
-と同じ機能を持つが、可変引き数リストを指定することができる点が異なる。
-指定された引き数は、
-.BR stdarg (3)
-可変引き数リストマクロを用いて取得される。
-以下のサブセクションでは、
-.I option
-と
-.I facility
-と
-.I priority
+\fBvsyslog\fP() 関数は \fBsyslog\fP() と同じ機能を持つが、可変引き数リストを指定することができる点が異なる。
+指定された引き数は、 \fBstdarg\fP(3) 可変引き数リストマクロを用いて取得される。
+
+以下のサブセクションでは、 \fIoption\fP と \fIfacility\fP と \fIpriority\fP
の値を設定するのに使用されるパラメータを説明する。
.SS option
-下記の値を OR したものが
-.BR openlog ()
-の
-.I option
-引き数になる:
-.TP 15
-.B LOG_CONS
+下記の値を OR したものが \fBopenlog\fP() の \fIoption\fP 引き数になる:
+.TP 15
+\fBLOG_CONS\fP
エラーがあれば、システムロガーに送る一方でシステムコンソールにも直接書く。
-.TP
-.B LOG_NDELAY
-ログ記録用プログラムとの接続を即座に開始する
-(通常は、最初のメッセージが記録される時に接続を開く)。
-.TP
-.B LOG_NOWAIT
-メッセージを記録する際に生成される子プロセスの終了を待たない。
-(GNU C ライブラリは子プロセスを生成しない。
-したがって、このオプションは Linux では無効である。)
-.TP
-.B LOG_ODELAY
-.B LOG_NDELAY
-の反対。
-.BR syslog ()
-が呼ばれるまで、接続の開始を行わない。
+.TP
+\fBLOG_NDELAY\fP
+ログ記録用プログラムとの接続を即座に開始する (通常は、最初のメッセージが記録される時に接続を開く)。
+.TP
+\fBLOG_NOWAIT\fP
+メッセージを記録する際に生成される子プロセスの終了を待たない。 (GNU C ライブラリは子プロセスを生成しない。 したがって、このオプションは
+Linux では無効である。)
+.TP
+\fBLOG_ODELAY\fP
+\fBLOG_NDELAY\fP の反対。 \fBsyslog\fP() が呼ばれるまで、接続の開始を行わない。
(このオプションはデフォルトであり、特に指定する必要はない。)
-.TP
-.B LOG_PERROR
-stderr にも出力する。(POSIX.1-2001 では定義されていない)
-.TP
-.B LOG_PID
+.TP
+\fBLOG_PERROR\fP
+stderr にも出力する。(POSIX.1\-2001 では定義されていない)
+.TP
+\fBLOG_PID\fP
個々のメッセージに PID を含める。
.SS facility
-.I facility
-引き数はメッセージに記録されるプログラムのタイプを指定するために使われる。
-これによって異なるタイプのプログラムからのメッセージは異なる扱いを
-するように設定ファイル(
-.BR syslog.conf (5))
-に定義できる。
-.TP 15
-.B LOG_AUTH
-セキュリティ/認証 メッセージ
-(非推奨。代わりに
-.B LOG_AUTHPRIV
-を使用すること)
-.TP
-.B LOG_AUTHPRIV
+\fIfacility\fP 引き数はメッセージに記録されるプログラムのタイプを指定するために使われる。
+これによって異なるタイプのプログラムからのメッセージは異なる扱いを するように設定ファイル( \fBsyslog.conf\fP(5)) に定義できる。
+.TP 15
+\fBLOG_AUTH\fP
+セキュリティ/認証 メッセージ (非推奨。代わりに \fBLOG_AUTHPRIV\fP を使用すること)
+.TP
+\fBLOG_AUTHPRIV\fP
セキュリティ/認証 メッセージ (プライベート)
-.TP
-.B LOG_CRON
-クロックデーモン
-.RB ( cron
-と
-.RB at )
-.TP
-.B LOG_DAEMON
+.TP
+\fBLOG_CRON\fP
+クロックデーモン (\fBcron\fP と at\fB)\fP
+.TP
+\fBLOG_DAEMON\fP
特定の facility 値を持たないシステムデーモン
-.TP
-.B LOG_FTP
+.TP
+\fBLOG_FTP\fP
ftp デーモン
-.TP
-.B LOG_KERN
-カーネルメッセージ (ユーザプロセスから生成することはできない)
+.TP
+\fBLOG_KERN\fP
.\" LOG_KERN has the value 0; if used as a facility, zero translates to:
.\" "use the default facility".
-.TP
-.BR LOG_LOCAL0 " から " LOG_LOCAL7
+カーネルメッセージ (ユーザプロセスから生成することはできない)
+.TP
+\fBLOG_LOCAL0\fP から \fBLOG_LOCAL7\fP
ローカルな使用のためにリザーブされている
-.TP
-.B LOG_LPR
+.TP
+\fBLOG_LPR\fP
ラインプリンタ・サブシステム
-.TP
-.B LOG_MAIL
+.TP
+\fBLOG_MAIL\fP
メール・サブシステム
-.TP
-.B LOG_NEWS
+.TP
+\fBLOG_NEWS\fP
USENET ニュース・サブシステム
-.TP
-.B LOG_SYSLOG
-.BR syslogd (8)
-によって内部的に発行されるメッセージ
-.TP
-.BR LOG_USER " (デフォルト)"
+.TP
+\fBLOG_SYSLOG\fP
+\fBsyslogd\fP(8) によって内部的に発行されるメッセージ
+.TP
+\fBLOG_USER\fP (デフォルト)
一般的なユーザレベルメッセージ
-.TP
-.B LOG_UUCP
+.TP
+\fBLOG_UUCP\fP
UUCPサブシステム
.SS level
-これはメッセージの優先度を指定する。
-優先度の高いものから低いものの順で下記する。
-.TP 15
-.B LOG_EMERG
+これはメッセージの優先度を指定する。 優先度の高いものから低いものの順で下記する。
+.TP 15
+\fBLOG_EMERG\fP
システムが使用不可
-.TP
-.B LOG_ALERT
+.TP
+\fBLOG_ALERT\fP
直ちに行動を起こさなければならない
-.TP
-.B LOG_CRIT
+.TP
+\fBLOG_CRIT\fP
危険な状態
-.TP
-.B LOG_ERR
+.TP
+\fBLOG_ERR\fP
エラーの状態
-.TP
-.B LOG_WARNING
+.TP
+\fBLOG_WARNING\fP
ワーニングの状態
-.TP
-.B LOG_NOTICE
+.TP
+\fBLOG_NOTICE\fP
通常だが重要な状態
-.TP
-.B LOG_INFO
+.TP
+\fBLOG_INFO\fP
インフォメーションメッセージ
-.TP
-.B LOG_DEBUG
+.TP
+\fBLOG_DEBUG\fP
デバッグレベルのメッセージ
.LP
-.BR setlogmask (3)
-関数を使用して、
-指定されたレベルのメッセージだけを記録するように
-制限することができる。
+\fBsetlogmask\fP(3) 関数を使用して、 指定されたレベルのメッセージだけを記録するように 制限することができる。
.SH 準拠
-.BR openlog (),
-.BR closelog (),
-.BR syslog ()
-は SUSv2 と POSIX.1-2001 で規定されている
-(但し
-.BR vsyslog ()
-は除く)。
-POSIX.1-2001 では
-.I facility
-として
-.B LOG_USER
-と
-.B LOG_LOCAL*
-の値が規定されているだけである。
-しかしながら、
-.B LOG_AUTHPRIV
-と
-.B LOG_FTP
-という例外はあるが、
-それ以外の
-.I facility
-の値は多くの UNIX システムで使われている。
-.I option
-の値の
-.B LOG_PERROR
-の値は、 POSIX.1-2001 では規定されていないが、
-UNIX の多くのバージョンで使用可能である。
-.\" .SH 履歴
+.\" .SH HISTORY
+.\" A
.\" .BR syslog ()
-.\" ファンクション・コールは 4.2BSD から実装された。
-.\" 4.3BSD には
+.\" function call appeared in 4.2BSD.
+.\" 4.3BSD documents
.\" .BR openlog (),
.\" .BR syslog (),
.\" .BR closelog (),
-.\" .BR setlogmask ()
-.\" が実装されている。
-.\" また、4.3BSD-Reno には
-.\" .BR vsyslog ()
-.\" が実装されている。
-.\" 当然ながら初期の v* 関数は
-.\" .I <stdarg.h>
-.\" とは互換性のない
+.\" and
+.\" .BR setlogmask ().
+.\" 4.3BSD-Reno also documents
+.\" .BR vsyslog ().
+.\" Of course early v* functions used the
.\" .I <varargs.h>
-.\" の仕組を使用したものである。
+.\" mechanism, which is not compatible with
+.\" .IR <stdarg.h> .
+\fBopenlog\fP(), \fBcloselog\fP(), \fBsyslog\fP() は SUSv2 と POSIX.1\-2001 で規定されている
+(但し \fBvsyslog\fP() は除く)。 POSIX.1\-2001 では \fIfacility\fP として \fBLOG_USER\fP と
+\fBLOG_LOCAL*\fP の値が規定されているだけである。 しかしながら、 \fBLOG_AUTHPRIV\fP と \fBLOG_FTP\fP
+という例外はあるが、 それ以外の \fIfacility\fP の値は多くの UNIX システムで使われている。 \fIoption\fP の値の
+\fBLOG_PERROR\fP の値は、 POSIX.1\-2001 では規定されていないが、 UNIX の多くのバージョンで使用可能である。
.SH 注意
-.BR openlog ()
-呼び出しの
-.I ident
-引き数は、値がそのまま保持されていることを前提にしている。
-それゆえ、
-.I ident
-で指定された文字列が変更されると、
-.BR syslog ()
-は変更された文字列の追加するだろうし、
-指定された文字列が存在しなくなった場合、結果は未定義である。
-最も移植性がある方法は、文字列定数を使用することである。
+\fBopenlog\fP() 呼び出しの \fIident\fP 引き数は、値がそのまま保持されていることを前提にしている。 それゆえ、 \fIident\fP
+で指定された文字列が変更されると、 \fBsyslog\fP() は変更された文字列の追加するだろうし、
+指定された文字列が存在しなくなった場合、結果は未定義である。 最も移植性がある方法は、文字列定数を使用することである。
.LP
-ユーザーから与えられたデータを format として渡してはならない。
-代わりに以下を使うこと。
+ユーザーから与えられたデータを format として渡してはならない。 代わりに以下を使うこと。
.nf
syslog(priority, "%s", string);
.fi
.SH 関連項目
-.BR logger (1),
-.BR setlogmask (3),
-.BR syslog.conf (5),
-.BR syslogd (8)
+\fBlogger\fP(1), \fBsetlogmask\fP(3), \fBsyslog.conf\fP(5), \fBsyslogd\fP(8)
OSDN Git Service
