Syslog

UNIXのsyslogのラッパークラスです。 執筆者募集

スーパークラス:

• Object

クラスメソッド:

open(ident=$0, options=Syslog::LOG_PID|Syslog::LOG_CONS, facility=Syslog::LOG_USER)

open(ident=$0, options=Syslog::LOG_PID|Syslog::LOG_CONS, facility=Syslog::LOG_USER) { |syslog| ... }

与えられた引数でsyslogを開いて、Syslogの唯一の インスタンスを返す。 ブロック付きで呼ばれた場合は、インスタンスを引数として ブロックを呼び出す。 syslogを既に開いていた場合はRuntimeErrorが 発生する。

ident はすべてのログにつく識別子で、どのプログラムから 送られたログなのかを識別するために使われる。 options と facility については Syslog::Constants を参照。

例:
  sl = Syslog.open('ftpd', Syslog::LOG_PID | Syslog::LOG_NDELAY,
                   Syslog::LOG_FTP)

instance

Syslog の唯一のインスタンスを返す。 (Singleton参照。)

LOG_MASK(priority)

1つの優先度に対するマスクを作成する。

LOG_UPTO(priority)

priorityまでのすべての優先度のマスクを作成する。

メソッド:

open(ident=$0, options=Syslog::LOG_PID|Syslog::LOG_CONS, facility=Syslog::LOG_USER)

与えられた引数でsyslogを開く。 syslogを既に開いていた場合はRuntimeErrorが 発生する。

reopen(ident=$0, options=LOG_PID|LOG_CONS, facility=LOG_USER)

open!(ident=$0, options=LOG_PID|LOG_CONS, facility=LOG_USER)

最初にcloseしてからopenと同様に開く。

opened?

syslogを既に開いていればtrueを、 開いていなければfalseを返す。

ident

options

facility

最後のopenで与えられた対応する引数を返す。

log(priority, format, ...)

syslogにメッセージを書き込む。 format以降はsprintfと同じです。

例:
  sl.log(Syslog::LOG_CRIT, "the sky is falling in %d seconds!", 10)

crit(message, ...)

emerg(message, ...)

alert(message, ...)

err(message, ...)

warning(message, ...)

notice(message, ...)

info(message, ...)

debug(message, ...)

Syslog#log()のショートカットメソッドです。 システムによっては定義されていないものもあります。

例:
  sl.crit("the sky is falling in %d seconds!",5)

mask

mask=(mask)

ログの優先度のマスクを取得または設定する。 マスクは永続的であり、 Syslog::open/Syslog#open/Syslog#close ではリセットされない。

例:
  sl.mask = Syslog::LOG_UPTO(Syslog::LOG_ERR)

close

syslogを閉じる。

inspect

inspect参照。