OSDN Git Service

Retire LDP man-pages repository
[linuxjm/LDP_man-pages.git] / release / man3 / syslog.3
diff --git a/release/man3/syslog.3 b/release/man3/syslog.3
deleted file mode 100644 (file)
index 635e1c5..0000000
+++ /dev/null
@@ -1,240 +0,0 @@
-.\" Written  Feb 1994 by Steve Greenland (stevegr@neosoft.com)
-.\"
-.\" %%%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.
-.\"
-.\" Permission is granted to copy and distribute modified versions of this
-.\" manual under the conditions for verbatim copying, provided that the
-.\" entire resulting derived work is distributed under the terms of a
-.\" permission notice identical to this one.
-.\"
-.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date.  The author(s) assume no
-.\" responsibility for errors or omissions, or for damages resulting from
-.\" the use of the information contained herein.  The author(s) may not
-.\" have taken the same level of care in the production of this manual,
-.\" which is licensed free of charge, as they might when working
-.\" professionally.
-.\"
-.\" Formatted or processed versions of this manual, if unaccompanied by
-.\" the source, must acknowledge the copyright and authors of this work.
-.\" %%%LICENSE_END
-.\"
-.\" Updated 1999.12.19 by Karl M. Hegbloom <karlheg@debian.org>
-.\"
-.\" Updated 13 Oct 2001, Michael Kerrisk <mtk.manpages@gmail.com>
-.\"    Added description of vsyslog
-.\"    Added descriptions of LOG_ODELAY and LOG_NOWAIT
-.\"    Added brief description of facility and option arguments
-.\"    Added CONFORMING TO section
-.\" 2001-10-13, aeb, minor changes
-.\" Modified 13 Dec 2001, Martin Schulze <joey@infodrom.org>
-.\" Modified 3 Jan 2002, Michael Kerrisk <mtk.manpages@gmail.com>
-.\"
-.\"*******************************************************************
-.\"
-.\" This file was generated with po4a. Translate the source file.
-.\"
-.\"*******************************************************************
-.\"
-.\" 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>
-.\" Updated 2012-05-29, Akihiro MOTOKI <amotoki@gmail.com>
-.\" Updated 2013-03-26, Akihiro MOTOKI <amotoki@gmail.com>
-.\"
-.TH SYSLOG 3 2012\-08\-17 Linux "Linux Programmer's Manual"
-.SH 名前
-closelog, openlog, syslog, vsyslog \- システムロガーにメッセージを送る
-.SH 書式
-\fB#include <syslog.h>\fP
-.sp
-\fBvoid openlog(const char *\fP\fIident\fP\fB, int \fP\fIoption\fP\fB, int
-\fP\fIfacility\fP\fB);\fP
-.br
-\fBvoid syslog(int \fP\fIpriority\fP\fB, const char *\fP\fIformat\fP\fB, ...);\fP
-.br
-\fBvoid closelog(void);\fP
-.sp
-\fB#include <stdarg.h>\fP
-.sp
-\fBvoid vsyslog(int \fP\fIpriority\fP\fB, const char *\fP\fIformat\fP\fB, va_list
-\fP\fIap\fP\fB);\fP
-.sp
-.in -4n
-glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
-.in
-.sp
-\fBvsyslog\fP(): _BSD_SOURCE
-.SH 説明
-\fBcloselog\fP()  はシステムのログ記録用プログラム(システムロガー \fBsyslogd\fP(8))  ヘの接続を終了する。
-\fBcloselog\fP()  は必須ではない。
-.sp
-\fBopenlog\fP() はログを出力しようとしているプログラムからログ記録用
-プログラム (system logger) への 接続を開始する。
-\fIident\fP で指定した文字列は各メッセージの前に付与される。
-通常は \fIident\fP にはプログラム名が設定される。
-\fIident\fP が NULL の場合、プログラムが \fIident\fP として使用される
-(POSIX.1\-2008 では \fIident\fP が NULL の場合の動作は規定されていない)。
-
-\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
-\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)  によって置き換えられる。
-必要な場合は末尾に改行が加えられる。
-
-\fBvsyslog\fP()  関数は \fBsyslog\fP()  と同じ機能を持つが、可変引き数リストを指定することができる点が異なる。
-指定された引き数は、 \fBstdarg\fP(3)  可変引き数リストマクロを用いて取得される。
-
-以下のサブセクションでは、 \fIoption\fP と \fIfacility\fP と \fIpriority\fP
-の値を設定するのに使用されるパラメーターを説明する。
-.SS option
-下記の値を OR したものが \fBopenlog\fP()  の \fIoption\fP 引き数になる:
-.TP  15
-\fBLOG_CONS\fP
-エラーがあれば、システムロガーに送る一方でシステムコンソールにも直接書く。
-.TP 
-\fBLOG_NDELAY\fP
-ログ記録用プログラムとの接続を即座に開始する (通常は、最初のメッセージが記録される時に接続を開く)。
-.TP 
-\fBLOG_NOWAIT\fP
-メッセージを記録する際に生成される子プロセスの終了を待たない。 (GNU C ライブラリは子プロセスを生成しない。 したがって、このオプションは
-Linux では無効である。)
-.TP 
-\fBLOG_ODELAY\fP
-\fBLOG_NDELAY\fP の反対。 \fBsyslog\fP()  が呼ばれるまで、接続の開始を行わない。
-(このオプションはデフォルトであり、特に指定する必要はない。)
-.TP 
-\fBLOG_PERROR\fP
-stderr にも出力する。
-(POSIX.1\-2001 と POSIX.1\-2008 では定義されていない)
-.TP 
-\fBLOG_PID\fP
-個々のメッセージに PID を含める。
-.SS facility
-\fIfacility\fP 引き数はメッセージに記録されるプログラムのタイプを指定するために使われる。
-これによって異なるタイプのプログラムからのメッセージは異なる扱いを するように設定ファイル( \fBsyslog.conf\fP(5))  に定義できる。
-.TP  15
-\fBLOG_AUTH\fP
-セキュリティ/認証 メッセージ
-.TP 
-\fBLOG_AUTHPRIV\fP
-セキュリティ/認証 メッセージ (プライベート)
-.TP 
-\fBLOG_CRON\fP
-クロックデーモン (\fBcron\fP と at\fB)\fP
-.TP 
-\fBLOG_DAEMON\fP
-特定の facility 値を持たないシステムデーモン
-.TP 
-\fBLOG_FTP\fP
-ftp デーモン
-.TP 
-\fBLOG_KERN\fP
-.\" LOG_KERN has the value 0; if used as a facility, zero translates to:
-.\" "use the default facility".
-カーネルメッセージ (ユーザープロセスから生成することはできない)
-.TP 
-\fBLOG_LOCAL0\fP から \fBLOG_LOCAL7\fP
-ローカルな使用のためにリザーブされている
-.TP 
-\fBLOG_LPR\fP
-ラインプリンタサブシステム
-.TP 
-\fBLOG_MAIL\fP
-メールサブシステム
-.TP 
-\fBLOG_NEWS\fP
-USENET ニュースサブシステム
-.TP 
-\fBLOG_SYSLOG\fP
-\fBsyslogd\fP(8)  によって内部的に発行されるメッセージ
-.TP 
-\fBLOG_USER\fP (デフォルト)
-一般的なユーザーレベルメッセージ
-.TP 
-\fBLOG_UUCP\fP
-UUCPサブシステム
-.SS level
-これはメッセージの優先度を指定する。 優先度の高いものから低いものの順で下記する。
-.TP  15
-\fBLOG_EMERG\fP
-システムが使用不可
-.TP 
-\fBLOG_ALERT\fP
-直ちに行動を起こさなければならない
-.TP 
-\fBLOG_CRIT\fP
-危険な状態
-.TP 
-\fBLOG_ERR\fP
-エラーの状態
-.TP 
-\fBLOG_WARNING\fP
-ワーニングの状態
-.TP 
-\fBLOG_NOTICE\fP
-通常だが重要な状態
-.TP 
-\fBLOG_INFO\fP
-インフォメーションメッセージ
-.TP 
-\fBLOG_DEBUG\fP
-デバッグレベルのメッセージ
-.LP
-\fBsetlogmask\fP(3)  関数を使用して、 指定されたレベルのメッセージだけを記録するように 制限することができる。
-.SH 準拠
-.\" .SH HISTORY
-.\" A
-.\" .BR syslog ()
-.\" function call appeared in 4.2BSD.
-.\" 4.3BSD documents
-.\" .BR openlog (),
-.\" .BR syslog (),
-.\" .BR closelog (),
-.\" 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,
-POSIX.1\-2008 で規定されている (但し \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 と POSIX.1\-2008 では規定されていないが、
-UNIX の多くのバージョンで使用可能である。
-.SH 注意
-\fBopenlog\fP()  呼び出しの \fIident\fP 引き数は、値がそのまま保持されていることを前提にしている。 それゆえ、 \fIident\fP
-で指定された文字列が変更されると、 \fBsyslog\fP()  は変更された文字列の追加するだろうし、
-指定された文字列が存在しなくなった場合、結果は未定義である。 最も移植性がある方法は、文字列定数を使用することである。
-.LP
-ユーザーから与えられたデータを format として渡してはならない。 代わりに以下を使うこと。
-.nf
-
-    syslog(priority, "%s", string);
-.fi
-.SH 関連項目
-\fBlogger\fP(1), \fBsetlogmask\fP(3), \fBsyslog.conf\fP(5), \fBsyslogd\fP(8)
-.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
-である。プロジェクトの説明とバグ報告に関する情報は
-http://www.kernel.org/doc/man\-pages/ に書かれている。