[#33511] [Ruby 1.9-Bug#4108][Open] irb hangs on Windows with trunk — Heesob Park <redmine@...>
Bug #4108: irb hangs on Windows with trunk
4 messages
2010/12/02
[#33521] [Ruby 1.9-Feature#4111][Open] Add XLIST support to Net::IMAP — Geoff Youngs <redmine@...>
Feature #4111: Add XLIST support to Net::IMAP
5 messages
2010/12/02
[#33530] [Ruby 1.9-Bug#4113][Open] Cannot build trunk with MSVC. — Heesob Park <redmine@...>
Bug #4113: Cannot build trunk with MSVC.
4 messages
2010/12/03
[#33583] Initialization time — SASADA Koichi <ko1@...>
Hi,
6 messages
2010/12/05
[#33605] Why is SyncEnumerator in REXML? — Asher <asher@...>
in 1.8 SyncEnumerator is in lib/generator.rb; in 1.9 it is in lib/rexml/syncenumerator.rb
8 messages
2010/12/07
[#33623] Re: Why is SyncEnumerator in REXML?
— James Edward Gray II <james@...>
2010/12/07
On Dec 6, 2010, at 11:09 PM, Asher wrote:
[#33624] Re: Why is SyncEnumerator in REXML?
— Asher <asher@...>
2010/12/07
If that is the case, it would make sense historically, but doesn't seem to make much sense now, as SyncEnumerator doesn't seem to have any relation to REXML, even if REXML utilizes it.
[#33628] [Ruby 1.8-Bug#4132][Open] Socket.close attempting to close the socket twice — Claudio Villalobos <redmine@...>
Bug #4132: Socket.close attempting to close the socket twice
5 messages
2010/12/07
[#33640] [Ruby 1.9-Bug#4136][Open] Enumerable#reject should not inherit the receiver's instance variables — Hiro Asari <redmine@...>
Bug #4136: Enumerable#reject should not inherit the receiver's instance variables
10 messages
2010/12/08
[#33704] [Ruby 1.9-Bug#4136] Enumerable#reject should not inherit the receiver's instance variables
— Marc-Andre Lafortune <redmine@...>
2010/12/13
Issue #4136 has been updated by Marc-Andre Lafortune.
[#33705] Re: [Ruby 1.9-Bug#4136] Enumerable#reject should not inherit the receiver's instance variables
— Yukihiro Matsumoto <matz@...>
2010/12/14
Hi,
[#33648] Why doesn’t StringIO implement #freeze? — Nikolai Weibull <now@...>
IO implements #freeze, but StringIO doesn’t. What’s up with that?
7 messages
2010/12/09
[#34012] Re: Why doesn’t StringIO implement #freeze?
— Nobuyoshi Nakada <nobu@...>
2010/12/31
Hi,
[#34017] Re: [ruby-core:34012] Re: Why doesn’t StringIO implement #freeze?
— Nikolai Weibull <now@...>
2010/12/31
On Fri, Dec 31, 2010 at 03:09, Nobuyoshi Nakada <nobu@ruby-lang.org> wrote:
[#33656] [Ruby 1.9-Bug#4141][Open] Tk extension is not accepting any type of parameter combination — Luis Lavena <redmine@...>
Bug #4141: Tk extension is not accepting any type of parameter combination
5 messages
2010/12/09
[#33917] Re: [Ruby 1.9-Bug#4141][Open] Tk extension is not accepting any type of parameter combination
— Hidetoshi NAGAI <nagai@...>
2010/12/27
Hi,
[#33922] Re: [Ruby 1.9-Bug#4141][Open] Tk extension is not accepting any type of parameter combination
— Luis Lavena <luislavena@...>
2010/12/27
On Sun, Dec 26, 2010 at 10:05 PM, Hidetoshi NAGAI
[#33661] [Ruby 1.9-Feature#4145][Open] The result of UTF-16 encoded string concatenation — Heesob Park <redmine@...>
Feature #4145: The result of UTF-16 encoded string concatenation
4 messages
2010/12/10
[#33662] [Ruby 1.9-Feature#4145][Assigned] The result of UTF-16 encoded string concatenation
— Yui NARUSE <redmine@...>
2010/12/10
Issue #4145 has been updated by Yui NARUSE.
[#33667] [Ruby 1.9-Bug#4149][Open] Documentation submission: syslog standard library — mathew murphy <redmine@...>
Bug #4149: Documentation submission: syslog standard library
11 messages
2010/12/10
[#33678] [Ruby 1.9-Bug#4149] Documentation submission: syslog standard library
— mathew murphy <redmine@...>
2010/12/11
Issue #4149 has been updated by mathew murphy.
[#33683] [feature:trunk] Enumerable#categorize — Tanaka Akira <akr@...>
Hi.
14 messages
2010/12/12
[#33684] Re: [feature:trunk] Enumerable#categorize
— "Martin J. Dst" <duerst@...>
2010/12/12
[#33714] Re: [feature:trunk] Enumerable#categorize
— Tanaka Akira <akr@...>
2010/12/14
2010/12/12 "Martin J. Dst" <duerst@it.aoyama.ac.jp>:
[#33777] Re: [feature:trunk] Enumerable#categorize
— "Martin J. Dürst" <duerst@...>
2010/12/20
Hello Akira,
[#33869] Re: [feature:trunk] Enumerable#categorize
— Tanaka Akira <akr@...>
2010/12/25
2010/12/20 "Martin J. Dst" <duerst@it.aoyama.ac.jp>:
[#33921] Re: [feature:trunk] Enumerable#categorize
— Marc-Andre Lafortune <ruby-core-mailing-list@...>
2010/12/27
Hi!
[#33963] Re: [feature:trunk] Enumerable#categorize
— Tanaka Akira <akr@...>
2010/12/28
2010/12/27 Marc-Andre Lafortune <ruby-core-mailing-list@marc-andre.ca>:
[#33991] Re: [feature:trunk] Enumerable#categorize
— Marc-Andre Lafortune <ruby-core-mailing-list@...>
2010/12/29
Hi!
[#33687] Towards a standardized AST for Ruby code — Magnus Holm <judofyr@...>
Hey folks,
23 messages
2010/12/12
[#33688] Re: Towards a standardized AST for Ruby code
— Charles Oliver Nutter <headius@...>
2010/12/12
On Sun, Dec 12, 2010 at 9:55 AM, Magnus Holm <judofyr@gmail.com> wrote:
[#33689] Re: Towards a standardized AST for Ruby code
— "Haase, Konstantin" <Konstantin.Haase@...>
2010/12/12
On Dec 12, 2010, at 17:46 , Charles Oliver Nutter wrote:
[#33695] Re: Towards a standardized AST for Ruby code
— Ryan Davis <ryand-ruby@...>
2010/12/13
[#33700] Re: Towards a standardized AST for Ruby code
— Rocky Bernstein <rockyb@...>
2010/12/13
On Sun, Dec 12, 2010 at 7:09 PM, Ryan Davis <ryand-ruby@zenspider.com>wrote:
[#33693] Re: Towards a standardized AST for Ruby code
— Urabe Shyouhei <shyouhei@...>
2010/12/12
(2010/12/13 1:54), Haase, Konstantin wrote:
[#33694] Re: Towards a standardized AST for Ruby code
— Ryan Davis <ryand-ruby@...>
2010/12/13
[#33698] Re: Towards a standardized AST for Ruby code
— Urabe Shyouhei <shyouhei@...>
2010/12/13
(2010/12/13 9:06), Ryan Davis wrote:
[#33699] Re: Towards a standardized AST for Ruby code
— Ryan Davis <ryand-ruby@...>
2010/12/13
[#33708] Re: Towards a standardized AST for Ruby code
— Charles Oliver Nutter <headius@...>
2010/12/14
On Sun, Dec 12, 2010 at 6:33 PM, Ryan Davis <ryand-ruby@zenspider.com> wrote:
[#33709] Re: Towards a standardized AST for Ruby code
— "Haase, Konstantin" <Konstantin.Haase@...>
2010/12/14
On Dec 14, 2010, at 09:47 , Charles Oliver Nutter wrote:
[#33711] Re: Towards a standardized AST for Ruby code
— Charles Oliver Nutter <headius@...>
2010/12/14
On Tue, Dec 14, 2010 at 2:54 AM, Haase, Konstantin
[#33690] [Ruby 1.9-Bug#4153][Open] Minitest or ruby bug - wrong return code — Robert Pankowecki <redmine@...>
Bug #4153: Minitest or ruby bug - wrong return code
6 messages
2010/12/12
[#33735] [Ruby 1.9-Bug#4163][Assigned] RubyGems uses deprecated API: YAML.quick_emit. — Yui NARUSE <redmine@...>
Bug #4163: RubyGems uses deprecated API: YAML.quick_emit.
6 messages
2010/12/15
[#33743] Re: [Ruby 1.9-Bug#4163][Assigned] RubyGems uses deprecated API: YAML.quick_emit.
— Aaron Patterson <aaron@...>
2010/12/16
On Thu, Dec 16, 2010 at 04:46:33AM +0900, Yui NARUSE wrote:
[#33763] [Ruby 1.9-Bug#4168][Open] WeakRef is unsafe to use in Ruby 1.9 — Brian Durand <redmine@...>
Bug #4168: WeakRef is unsafe to use in Ruby 1.9
43 messages
2010/12/17
[#34338] [Ruby 1.9-Bug#4168] WeakRef is unsafe to use in Ruby 1.9
— Kurt Stephens <redmine@...>
2011/01/11
Issue #4168 has been updated by Kurt Stephens.
[#33779] [Ruby 1.9-Bug#4174][Open] 1F1E on rdoc tests — Kouhei Yanagita <redmine@...>
Bug #4174: 1F1E on rdoc tests
6 messages
2010/12/20
[#33801] [Ruby 1.9-Feature#4183][Open] [ext/openssl] Timestamp support — Martin Bosslet <redmine@...>
Feature #4183: [ext/openssl] Timestamp support
8 messages
2010/12/21
[#33858] Re: [Ruby 1.9-Feature#4183][Open] [ext/openssl] Timestamp support
— Aaron Patterson <aaron@...>
2010/12/24
On Wed, Dec 22, 2010 at 03:19:12AM +0900, Martin Bosslet wrote:
[#33815] trunk warnflags build issue with curb 0.7.9? — Jon <jon.forums@...>
As this may turn out to be a 3rd party issue rather than a bug, I'd like some feedback.
11 messages
2010/12/22
[#33821] Re: trunk warnflags build issue with curb 0.7.9?
— Nobuyoshi Nakada <nobu@...>
2010/12/23
Hi,
[#33818] [Ruby 1.9-Bug#4188][Open] minitest warnings in 1.9.3 — Aaron Patterson <redmine@...>
Bug #4188: minitest warnings in 1.9.3
4 messages
2010/12/23
[#33825] PATCH: REE fast-thread.patch: stack_free() not called in rb_thread_die(). — Kurt Stephens <ks@...>
http://code.google.com/p/rubyenterpriseedition/issues/detail?id=57
5 messages
2010/12/23
[#33828] Re: PATCH: REE fast-thread.patch: stack_free() not called in rb_thread_die().
— Kurt Stephens <ks@...>
2010/12/23
Similar technique might be relevant in MRI 1.9 if fiber/continuation
[#33836] Re: PATCH: REE fast-thread.patch: stack_free() not called in rb_thread_die().
— KOSAKI Motohiro <kosaki.motohiro@...>
2010/12/23
> Similar technique might be relevant in MRI 1.9 if fiber/continuation stacks
[#33833] Ruby 1.9.2 is going to be released — "Yuki Sonoda (Yugui)" <yugui@...>
-----BEGIN PGP SIGNED MESSAGE-----
15 messages
2010/12/23
[#33834] Re: Ruby 1.9.2 is going to be released
— Luis Lavena <luislavena@...>
2010/12/23
On Thu, Dec 23, 2010 at 9:47 AM, Yuki Sonoda (Yugui) <yugui@yugui.jp> wrote:
[#33855] Re: Ruby 1.9.2 is going to be released
— Luis Lavena <luislavena@...>
2010/12/24
On Thu, Dec 23, 2010 at 9:47 AM, Yuki Sonoda (Yugui) <yugui@yugui.jp> wrote:
[#33845] Getting involved in Ruby — Benoit Daloze <eregontp@...>
Hi dear Ruby core team !
9 messages
2010/12/23
[#33846] [Ruby 1.9-Feature#4197][Open] Improvement of the benchmark library — Benoit Daloze <redmine@...>
Feature #4197: Improvement of the benchmark library
15 messages
2010/12/23
[#35025] [Ruby 1.9-Feature#4197][Closed] Improvement of the benchmark library
— Yui NARUSE <redmine@...>
2011/01/31
Issue #4197 has been updated by Yui NARUSE.
[#33852] [Ruby 1.9-Bug#4199][Open] make test ruby-1.9.2-p0 failed on Solaris10 x86 — Dmitry Perfilyev <redmine@...>
Bug #4199: make test ruby-1.9.2-p0 failed on Solaris10 x86
3 messages
2010/12/24
[#33864] [Backport92-Backport#4200][Open] minitest 2.0.2 on trunk — Ryan Davis <redmine@...>
Backport #4200: minitest 2.0.2 on trunk
6 messages
2010/12/25
[#34078] [Backport92-Backport#4200] minitest 2.0.2 on trunk
— Ryan Davis <redmine@...>
2011/01/05
Issue #4200 has been updated by Ryan Davis.
[#33880] As platform mantainer - what are my boundaries? — Luis Lavena <luislavena@...>
Hello,
8 messages
2010/12/25
[#33916] Re: As platform mantainer - what are my boundaries?
— "U.Nakamura" <usa@...>
2010/12/27
Hello,
[#33918] Re: As platform mantainer - what are my boundaries?
— Luis Lavena <luislavena@...>
2010/12/27
On Sun, Dec 26, 2010 at 9:50 PM, U.Nakamura <usa@garbagecollect.jp> wrote:
[#33986] Re: As platform mantainer - what are my boundaries?
— Yugui <yugui@...>
2010/12/29
On Mon, Dec 27, 2010 at 11:05 AM, Luis Lavena <luislavena@gmail.com> wrote:
[#33988] Re: As platform mantainer - what are my boundaries?
— Yugui <yugui@...>
2010/12/29
Luis,
[#33994] Re: As platform mantainer - what are my boundaries?
— Luis Lavena <luislavena@...>
2010/12/29
On Wed, Dec 29, 2010 at 1:31 AM, Yugui <yugui@yugui.jp> wrote:
[#33910] [Ruby 1.9-Feature#4211][Open] Converting the Ruby and C API documentation to YARD syntax — Loren Segal <redmine@...>
Feature #4211: Converting the Ruby and C API documentation to YARD syntax
10 messages
2010/12/26
[#33939] Re: [Ruby 1.9-Feature#4211][Open] Converting the Ruby and C API documentation to YARD syntax
— Eric Hodel <drbrain@...7.net>
2010/12/27
On Dec 26, 2010, at 13:00, Loren Segal wrote:
[#33949] Re: [Ruby 1.9-Feature#4211][Open] Converting the Ruby and C API documentation to YARD syntax
— Loren Segal <lsegal@...>
2010/12/28
[#33920] [Ruby 1.9-Feature#4211] Converting the Ruby and C API documentation to YARD syntax
— Yui NARUSE <redmine@...>
2010/12/27
Issue #4211 has been updated by Yui NARUSE.
[#33934] Re: [Ruby 1.9-Feature#4211] Converting the Ruby and C API documentation to YARD syntax
— Aaron Patterson <aaron@...>
2010/12/27
On Mon, Dec 27, 2010 at 12:01:00PM +0900, Yui NARUSE wrote:
[#33923] [Ruby 1.9-Bug#4214][Open] Fiddle::WINDOWS == false on Windows — Jon Forums <redmine@...>
Bug #4214: Fiddle::WINDOWS == false on Windows
15 messages
2010/12/27
[#33961] [Ruby 1.9-Bug#4214] Fiddle::WINDOWS == false on Windows
— Luis Lavena <redmine@...>
2010/12/28
Issue #4214 has been updated by Luis Lavena.
[#33948] Multi-line comments — Rodrigo Rosenfeld Rosas <rr.rosas@...>
I was always curious about the reasoning Ruby doesn't support
13 messages
2010/12/28
[#33950] Re: Multi-line comments
— Joshua Ballanco <jballanc@...>
2010/12/28
On Mon, Dec 27, 2010 at 8:55 PM, Rodrigo Rosenfeld Rosas <rr.rosas@gmail.com
[#33956] Re: Multi-line comments
— Rodrigo Rosenfeld Rosas <rr.rosas@...>
2010/12/28
On 28-12-2010 01:54, Joshua Ballanco wrote:
[#33957] Re: Multi-line comments
— Loren Segal <lsegal@...>
2010/12/28
[#33951] [Ruby 1.9-Bug#4217][Open] irb exits unexpectedly with non-ascii Regexp on Windows — Heesob Park <redmine@...>
Bug #4217: irb exits unexpectedly with non-ascii Regexp on Windows
6 messages
2010/12/28
[#33983] [Ruby 1.9-Bug#4217] irb exits unexpectedly with non-ascii Regexp on Windows
— Heesob Park <redmine@...>
2010/12/29
Issue #4217 has been updated by Heesob Park.
[#33953] my redmine login is not working and wanted to submit a bug — deepak kannan <kannan.deepak@...>
hi,
6 messages
2010/12/28
[#34011] [Backport92-Backport#4228][Open] Backward gemspec compatibility change in r29663 broke rake gems — Luis Lavena <redmine@...>
Backport #4228: Backward gemspec compatibility change in r29663 broke rake gems
6 messages
2010/12/30
[#34023] ruby -h doesn't include --disable-gems — Ryan Davis <ryand-ruby@...>
Is there a reason why ruby -h doesn't show --disable-gems ?
8 messages
2010/12/31
[#34037] Re: ruby -h doesn't include --disable-gems
— Ryan Davis <ryand-ruby@...>
2011/01/04
[#34047] Re: ruby -h doesn't include --disable-gems
— KOSAKI Motohiro <kosaki.motohiro@...>
2011/01/04
2011/1/4 Ryan Davis <ryand-ruby@zenspider.com>:
[#34055] Re: ruby -h doesn't include --disable-gems
— Luis Lavena <luislavena@...>
2011/01/04
On Tue, Jan 4, 2011 at 12:14 AM, KOSAKI Motohiro
[ruby-core:33786] [Ruby 1.9-Bug#4149] Documentation submission: syslog standard library
From:
mathew murphy <redmine@...>
Date:
2010-12-20 17:56:28 UTC
List:
ruby-core #33786
Issue #4149 has been updated by mathew murphy. File syslog.c.patch added I am (definitely) attaching an updated documentation patch with call-seq: directives, since they now work in RDoc 2.0.1. ---------------------------------------- http://redmine.ruby-lang.org/issues/show/4149 ---------------------------------------- http://redmine.ruby-lang.org
Attachments (1)
syslog.c.patch
(7.34 KB, text/x-patch)
=== modified file 'ext/syslog/syslog.c'
--- ext/syslog/syslog.c 2010-04-22 07:04:13 +0000
+++ ext/syslog/syslog.c 2010-12-20 17:47:09 +0000
@@ -2,9 +2,10 @@
* UNIX Syslog extension for Ruby
* Amos Gouaux, University of Texas at Dallas
* <amos+ruby@utdallas.edu>
+ * Documented by mathew <meta@pobox.com>
*
* $RoughId: syslog.c,v 1.21 2002/02/25 12:21:17 knu Exp $
- * $Id$
+ * $Id: syslog.c 27437 2010-04-22 08:04:13Z nobu $
*/
#include "ruby/ruby.h"
@@ -36,7 +37,9 @@
syslog(pri, "%s", RSTRING_PTR(str));
}
-/* Syslog module methods */
+/* Closes the syslog facility.
+ * Raises a runtime exception if it is not open.
+ */
static VALUE mSyslog_close(VALUE self)
{
rb_secure(4);
@@ -54,6 +57,83 @@
return Qnil;
}
+/* call-seq:
+ * open(ident, options, facility) => syslog
+ *
+ * :yields: syslog
+ *
+ * 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_LRP: 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)
+ *
+ */
static VALUE mSyslog_open(int argc, VALUE *argv, VALUE self)
{
VALUE ident, opt, fac;
@@ -96,6 +176,15 @@
return self;
}
+/* call-seq:
+ * open(ident, options, facility) => syslog
+ *
+ * :yields: syslog
+ *
+ * Closes and then reopens the syslog.
+ *
+ * Arguments are the same as for open().
+ */
static VALUE mSyslog_reopen(int argc, VALUE *argv, VALUE self)
{
mSyslog_close(self);
@@ -103,31 +192,58 @@
return mSyslog_open(argc, argv, self);
}
+/*
+ * Returns true if the syslog is open.
+ */
static VALUE mSyslog_isopen(VALUE self)
{
return syslog_opened ? Qtrue : Qfalse;
}
+/* Returns the identity string used in the last call to open()
+ */
static VALUE mSyslog_ident(VALUE self)
{
return syslog_opened ? rb_str_new2(syslog_ident) : Qnil;
}
+/* Returns the options bitmask used in the last call to open()
+ */
static VALUE mSyslog_options(VALUE self)
{
return syslog_opened ? INT2NUM(syslog_options) : Qnil;
}
+/* Returns the facility number used in the last call to open()
+ */
static VALUE mSyslog_facility(VALUE self)
{
return syslog_opened ? INT2NUM(syslog_facility) : Qnil;
}
+/* Returns the log priority mask in effect. The mask is not reset by opening
+ * or closing syslog.
+ */
static VALUE mSyslog_get_mask(VALUE self)
{
return syslog_opened ? INT2NUM(syslog_mask) : Qnil;
}
+/* call-seq:
+ * mask(priority_mask)
+ *
+ * Sets the log priority mask. A method LOG_UPTO is defined to make it easier
+ * to set mask values. Example:
+ *
+ * Syslog.mask = Syslog::LOG_UPTO(Syslog::LOG_ERR)
+ *
+ * Alternatively, specific priorities can be selected and added together using
+ * binary OR. Example:
+ *
+ * Syslog.mask = Syslog::LOG_MASK(Syslog::LOG_ERR) | Syslog::LOG_MASK(Syslog::LOG_CRIT)
+ *
+ * The priority mask persists through calls to open() and close().
+ */
static VALUE mSyslog_set_mask(VALUE self, VALUE mask)
{
rb_secure(4);
@@ -140,6 +256,25 @@
return mask;
}
+/* call-seq:
+ * log(priority, message)
+ *
+ * Log a message with the specified priority. Example:
+ *
+ * log(Syslog::LOG_CRIT, "Out of disk space")
+ *
+ * The priority levels, in descending order, are:
+ *
+ * * LOG_EMERG - System is unusable
+ * * LOG_ALERT - Action needs to be taken immediately
+ * * LOG_CRIT - A critical condition has occurred
+ * * LOG_ERR - An error occurred
+ * * LOG_WARNING - Warning of a possible problem
+ * * LOG_NOTICE - A normal but significant condition occurred
+ * * LOG_INFO - Informational message
+ * * LOG_DEBUG - Debugging information
+ *
+ */
static VALUE mSyslog_log(int argc, VALUE *argv, VALUE self)
{
VALUE pri;
@@ -160,6 +295,8 @@
return self;
}
+/* Returns an inspect() string summarizing the object state.
+ */
static VALUE mSyslog_inspect(VALUE self)
{
char buf[1024];
@@ -180,6 +317,8 @@
return rb_str_new2(buf);
}
+/* Returns self, for backward compatibility.
+ */
static VALUE mSyslog_instance(VALUE self)
{
return self;
@@ -218,17 +357,41 @@
define_syslog_shortcut_method(LOG_DEBUG, debug)
#endif
+/* call-seq:
+ * LOG_MASK(priority_level) => priority_mask
+ *
+ * Generates a mask bit for a priority level. See #mask=
+ */
static VALUE mSyslogConstants_LOG_MASK(VALUE klass, VALUE pri)
{
return INT2FIX(LOG_MASK(NUM2INT(pri)));
}
+/* call-seq:
+ * LOG_UPTO(priority_level) => priority_mask
+ *
+ * Generates a mask value for priority levels at or below the level specified.
+ * See #mask=
+ */
static VALUE mSyslogConstants_LOG_UPTO(VALUE klass, VALUE pri)
{
return INT2FIX(LOG_UPTO(NUM2INT(pri)));
}
-/* Init for package syslog */
+/* The syslog package provides a Ruby interface to the POSIX system logging
+ * facility.
+ *
+ * Syslog messages are typically passed to a central logging daemon.
+ * The daemon may filter them; route them into different files (usually
+ * found under /var/log); place them in SQL databases; forward
+ * them to centralized logging servers via TCP or UDP; or even alert the
+ * system administrator via email, pager or text message.
+ *
+ * Unlike application-level logging via Logger or Log4r, syslog is designed
+ * to allow secure tamper-proof logging.
+ *
+ * The syslog protocol is standardized in RFC 5424.
+ */
void Init_syslog()
{
mSyslog = rb_define_module("Syslog");