openlog

(PHP 3, PHP 4, PHP 5)

openlog -- システムログへの接続をオープンする

説明

bool openlog ( string ident, int option, int facility )

openlog()は、プログラムによるシステムログへの 接続をオープンします。 文字列identは、各メッセージに 追加されます。optionおよび facilityの値は、以下で説明します。 option 引数は、ログメッセージの生成時に使 用されるロギング用オプションを指定するために使用されます。 引数 facility には、ロギングを行う際のメッ セージ型を指定します。これにより、(使用するシステムのsyslogの設定 に関して)異なった facility を有するメッセージをどの程度処理するか を指定することが可能になります。 openlog()の使用は必須ではありません。この関数 は、必要な場合にsyslog()により自動的に呼び出さ れます。この場合、identのデフォルト値は FALSEとなります。

表 1. openlog()のオプション

定数説明
LOG_CONS システムログにデータが送信される間にエラーが発生した場合、直 接、システムコンソールに書き込まれます。
LOG_NDELAY 直ちにログへの接続をオープンします。
LOG_ODELAY (デフォルト) 最初のメッセージがロギングされるまで接続のオー プンを遅延します。
LOG_PERROR標準エラー出力にもログメッセージを出力します。
LOG_PID各メッセージにPIDをインクルードします
このオプションを一つまたは複数設定することが可能です。複数のオプ ションを使用した場合、これらの論理和をとる必要があります。すなわ ち、直ちに接続をオープンし、コンソールに書き込み、各メッセージに PIDをインクルードするには、次のようにします。 : LOG_CONS | LOG_NDELAY | LOG_PID

表 2. openlog() の機能

定数説明
LOG_AUTH セキュリティ/認証用メッセージ (定数LOG_AUTHPRIVが定義されているシステムでは、代わりにそれ を使用してください。)
LOG_AUTHPRIVセキュリティ/認証 メッセージ(プライベート)
LOG_CRONクロン デーモン(cron およびat)
LOG_DAEMON他のシステムデーモン
LOG_KERNカーネルメッセージ
LOG_LOCAL0 ... LOG_LOCAL7ローカルでの使用のために確保
LOG_LPRラインプリンタサブシステム
LOG_MAILメールサブシステム
LOG_NEWSUSENET ニュース サブシステム
LOG_SYSLOGsyslogd で内部的に生成されたメッセージ
LOG_USER一般的なユーザーレベルのメッセージ
LOG_UUCPUUCP サブシステム

注意: LOG_USERはWindows環境でのみ使用できるタイプです。

define_syslog_variables(), syslog(),closelog()も 参考にしてください。