open
- 1_8_6_287
- 1_8_7_72
- 1_8_7_330
- 1_9_1_378
- 1_9_2_180
- 1_9_3_125 (0)
- 1_9_3_392 (0)
- 2_1_10 (0)
- 2_2_9 (0)
- 2_4_6 (0)
- 2_5_5 (0)
- 2_6_3 (0)
- What's this?
open(p1 = v1, p2 = v2, p3 = v3)
public
Open the syslog facility. Raises a runtime exception if it is already open.
Can be called with or without a code block. If called with a block, the Syslog object created is passed to the block.
If the syslog is already open, raises a RuntimeError.
ident is a String which identifies the calling program.
options is the logical OR of any of the following:
LOG_CONS |
If there is an error while sending to the system logger, write directly to the console instead. |
LOG_NDELAY |
Open the connection now, rather than waiting for the first message to be written. |
LOG_NOWAIT |
Don’t wait for any child processes created while logging messages. (Has no effect on Linux.) |
LOG_ODELAY |
Opposite of LOG_NDELAY; wait until a message is sent before opening the connection. (This is the default.) |
LOG_PERROR |
Print the message to stderr as well as sending it to syslog. (Not in POSIX.1-2001.) |
LOG_PID |
Include the current process ID with each message. |
facility describes the type of program opening the syslog, and is the logical OR of any of the following which are defined for the host OS:
LOG_AUTH |
Security or authorization. Deprecated, use LOG_AUTHPRIV instead. |
LOG_AUTHPRIV |
Security or authorization messages which should be kept private. |
LOG_CONSOLE |
System console message. |
LOG_CRON |
System task scheduler (cron or at). |
LOG_DAEMON |
A system daemon which has no facility value of its own. |
LOG_FTP |
An FTP server. |
LOG_KERN |
A kernel message (not sendable by user processes, so not of much use to Ruby, but listed here for completeness). |
LOG_LPR |
Line printer subsystem. |
LOG_MAIL |
Mail delivery or transport subsystem. |
LOG_NEWS |
Usenet news system. |
LOG_NTP |
Network Time Protocol server. |
LOG_SECURITY |
General security message. |
LOG_SYSLOG |
Messages generated internally by syslog. |
LOG_USER |
Generic user-level message. |
LOG_UUCP |
UUCP subsystem. |
LOG_LOCAL0 to LOG_LOCAL7 |
Locally-defined facilities. |
Example:
Syslog.open("webrick", Syslog::LOG_PID, Syslog::LOG_DAEMON | Syslog::LOG_LOCAL3)