win32-eventlog 0.5.3 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/CHANGES +234 -226
- data/MANIFEST +19 -16
- data/README +78 -68
- data/Rakefile +6 -1
- data/doc/tutorial.txt +136 -136
- data/examples/example_notify.rb +23 -23
- data/examples/example_read.rb +83 -83
- data/examples/example_write.rb +64 -64
- data/lib/win32/eventlog.rb +1146 -1157
- data/lib/win32/mc.rb +120 -118
- data/lib/win32/windows/constants.rb +56 -0
- data/lib/win32/windows/functions.rb +51 -0
- data/lib/win32/windows/helper.rb +13 -0
- data/lib/win32/windows/structs.rb +30 -0
- data/misc/install_msg.rb +46 -46
- data/misc/rubymsg.mc +35 -35
- data/test/foo.mc +24 -24
- data/test/test_eventlog.rb +310 -319
- data/test/test_mc.rb +64 -67
- data/win32-eventlog.gemspec +30 -29
- metadata +90 -90
checksums.yaml
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
---
|
|
2
|
+
SHA1:
|
|
3
|
+
metadata.gz: ceb5a13af0deadb88315e89d570a5f1aa2c79f27
|
|
4
|
+
data.tar.gz: 7b5687780d298adefe46bdd3c8f5216947cc3052
|
|
5
|
+
SHA512:
|
|
6
|
+
metadata.gz: c43100375b65b7b42eb8f571eb603dda0ecfcad79d4aa1936bd007feef87b7c8f7d03badddbb2e4dfb321919d1c9012d5abc5c34601d3a1f87d8be6a813e0c00
|
|
7
|
+
data.tar.gz: 34ad5d018e864eec47b0af9a936fa0248f35a2c0d0d0795c5e90bb1512817324dbcc3b7705390270376242d1315f457a495a2f7a0ab62c94eb0bf6a8cddd19a0
|
data/CHANGES
CHANGED
|
@@ -1,226 +1,234 @@
|
|
|
1
|
-
== 0.
|
|
2
|
-
*
|
|
3
|
-
|
|
4
|
-
*
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
*
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
*
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
*
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
*
|
|
23
|
-
|
|
24
|
-
*
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
*
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
*
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
*
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
*
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
*
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
*
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
*
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
== 0.4.
|
|
97
|
-
* Fixed a bug in the EventLog
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
*
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
* Fixed a bug in the EventLog#
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
*
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
*
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
*
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
*
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
*
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
* Made
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
*
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
*
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
*
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
*
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
* Fixed
|
|
164
|
-
of
|
|
165
|
-
*
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
*
|
|
170
|
-
|
|
171
|
-
*
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
*
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
*
|
|
178
|
-
|
|
179
|
-
*
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
*
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
*
|
|
186
|
-
|
|
187
|
-
*
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
*
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
*
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
*
|
|
212
|
-
|
|
213
|
-
*
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
*
|
|
222
|
-
|
|
223
|
-
*
|
|
224
|
-
|
|
225
|
-
== 0.1.
|
|
226
|
-
*
|
|
1
|
+
== 0.6.0 - 13-Jan-2014
|
|
2
|
+
* Now assumes Windows Vista or later and Ruby 1.9.1 or later.
|
|
3
|
+
* The code base has been converted to use FFI, and now works with JRuby.
|
|
4
|
+
* The report_event method now accepts an array of strings.
|
|
5
|
+
* The ERROR, WARN and INFO constants were changed to ERROR_TYPE, WARN_TYPE and
|
|
6
|
+
INFO_TYPE.
|
|
7
|
+
* The rake and ptools gems have been added as development dependencies.
|
|
8
|
+
|
|
9
|
+
== 0.5.3 - 26-Oct-2011
|
|
10
|
+
* Fixed the String#nstrip method for Ruby 1.9.x. Thanks go to Jason Bourne
|
|
11
|
+
for the spot and Ben Jansen for the patch.
|
|
12
|
+
* Refactored the Rakefile and tests.
|
|
13
|
+
|
|
14
|
+
== 0.5.2 - 21-Aug-2009
|
|
15
|
+
* EventLogStruct's are now frozen on read operations. This is read-only data.
|
|
16
|
+
* Added a test to validate that structs are frozen.
|
|
17
|
+
|
|
18
|
+
== 0.5.1 - 8-Aug-2009
|
|
19
|
+
* License changed to Artistic 2.0.
|
|
20
|
+
* Some gemspec updates; test-unit and ptools are now development dependencies
|
|
21
|
+
instead of runtime dependencies and the description has been updated.
|
|
22
|
+
* Some RDoc updates, including documentation of the event type constants.
|
|
23
|
+
* Several RDoc updates for the Win32::MC class.
|
|
24
|
+
* Minor refactoring of the test suite.
|
|
25
|
+
* Added rake tasks for running the mc or eventlog libraries separately, as
|
|
26
|
+
well as tasks for running the examples.
|
|
27
|
+
* Example programs renamed to avoid any confusion with actual test files.
|
|
28
|
+
|
|
29
|
+
== 0.5.0 - 12-Sep-2008
|
|
30
|
+
* Fixed an issue for Windows Vista and later where some event descriptions
|
|
31
|
+
were missing. This fix requires windows-pr 0.9.3 or later.
|
|
32
|
+
* The EventLog#full? method now raises an EventLog::Error if it should fail
|
|
33
|
+
instead of a StandardError.
|
|
34
|
+
* Minor tweak to mc.rb - chomp the input file name if run as a program.
|
|
35
|
+
* Added test-unit 2.0.0 or later as a dependency.
|
|
36
|
+
* Added ptools as a dependency for the sake of the test suite.
|
|
37
|
+
* Renamed the test files to start with 'test_'.
|
|
38
|
+
* Removed the ts_all.rb file.
|
|
39
|
+
|
|
40
|
+
== 0.4.9 - 7-Sep-2008
|
|
41
|
+
* The private get_description method, which is used internally to read the
|
|
42
|
+
event log, has been updated to work with 64 bit Windows. The changes needed
|
|
43
|
+
for this require a more recent windows-pr library, i.e. 0.9.2 or later.
|
|
44
|
+
* Now properly separates the string inserts and description in the private
|
|
45
|
+
method get_last_event. This fixes the description and string_insert
|
|
46
|
+
properties for both the EventLog#tail and EventLog#notify_change methods.
|
|
47
|
+
* Some internal refactoring to use begin/ensure where appropriate.
|
|
48
|
+
|
|
49
|
+
== 0.4.8 - 17-May-2008
|
|
50
|
+
* Fixed in a bug in the EventLog#read method where a log entry requiring
|
|
51
|
+
over 64k would fail and spiral into an infinite loop. Thanks go to
|
|
52
|
+
Stuart Clarke for the spot.
|
|
53
|
+
* Improved handling of failed log reading in the read_last_event private
|
|
54
|
+
method.
|
|
55
|
+
|
|
56
|
+
== 0.4.7 - 8-Dec-2007
|
|
57
|
+
* Fixed a bug where you couldn't write to custom (parent) event sources.
|
|
58
|
+
Thanks go to Tim Uckun for the spot.
|
|
59
|
+
* Now handles ParameterMessageFiles, both in the EventLog.add_event_source
|
|
60
|
+
method and in terms of getting event descriptions properly. Thanks go to
|
|
61
|
+
botp for spotting the description problem.
|
|
62
|
+
* The EventLog.open_backup method handles a block the same way that the
|
|
63
|
+
EventLog.open method does.
|
|
64
|
+
* The EventLog.add_event_source now returns the creation disposition
|
|
65
|
+
instead of self.
|
|
66
|
+
|
|
67
|
+
== 0.4.6 - 27-Aug-2007
|
|
68
|
+
* Reading event logs is now approximately 5-7 times faster!
|
|
69
|
+
* Fixed a potential bug where, in rare cases, event descriptions could be
|
|
70
|
+
overwritten by other event descriptions.
|
|
71
|
+
* Fixed a bug where, in unusual cases, there was leading garbage in the
|
|
72
|
+
event descriptions.
|
|
73
|
+
|
|
74
|
+
== 0.4.5 - 25-Aug-2007
|
|
75
|
+
* Fixed two potential issues where reading from remote event log sources
|
|
76
|
+
could fail either due to permissions (reading DLL's) or because local
|
|
77
|
+
registry entries didn't necessarily match the remote registry entries.
|
|
78
|
+
Thanks go to Andrew Garberoglio and Ivan Shiel for the spot.
|
|
79
|
+
|
|
80
|
+
== 0.4.4 - 31-Jul-2007
|
|
81
|
+
* The EventLogError class is now EventLog::Error.
|
|
82
|
+
* The MCError class is now MC::Error.
|
|
83
|
+
* Added a Rakefile with tasks for installation and testing.
|
|
84
|
+
* Removed the install.rb file. Installation is now handled by the Rakefile.
|
|
85
|
+
* Fixed some bad test cases in tc_eventlog.rb.
|
|
86
|
+
* Added some more source comments.
|
|
87
|
+
* Updates to the README and MANIFEST file.
|
|
88
|
+
|
|
89
|
+
== 0.4.3 - 18-Dec-2006
|
|
90
|
+
* Removed the FORMAT_MESSAGE_FROM_SYSTEM flag to the FormatMessage function
|
|
91
|
+
in the get_description private method because it could sometimes return
|
|
92
|
+
bogus information. Thanks go to Greg Holmes for the spot.
|
|
93
|
+
* Added the string_inserts member to the EventLogStruct. This contains an
|
|
94
|
+
array of only the raw string inserts, rather than the entire text message.
|
|
95
|
+
|
|
96
|
+
== 0.4.2 - 6-Aug-2006
|
|
97
|
+
* Fixed a bug in the EventLog.read method related to the
|
|
98
|
+
EVENTLOG_BACKWARDS_READ flag.
|
|
99
|
+
* Fixed a bug in the EventLog.read method where the event_type was not being
|
|
100
|
+
set properly. Thanks go to "TheR" for the spot and the fix.
|
|
101
|
+
* Fixed bugs in the EventLog#tail method where it would fail if the log was
|
|
102
|
+
full and dups would appear.
|
|
103
|
+
|
|
104
|
+
== 0.4.1 - 28-May-2006
|
|
105
|
+
* Fixed a bug in the EventLog#notify_change method where the handle would
|
|
106
|
+
die after five or six reads. Thanks go to botp for the spot.
|
|
107
|
+
|
|
108
|
+
== 0.4.0 - 24-May-2006
|
|
109
|
+
* Now pure Ruby.
|
|
110
|
+
* Now includes a gemspec.
|
|
111
|
+
* Fixed a major bug the EventLog#tail method where it was reading the log in
|
|
112
|
+
the wrong order (!!!).
|
|
113
|
+
* Fixed a bug in the EventLog#report_event with regards to long category_id's.
|
|
114
|
+
Actually, this wasn't so much "fixed" as "avoided" by virtue of using a
|
|
115
|
+
pure Ruby solution.
|
|
116
|
+
* Added the EventLog#full? method.
|
|
117
|
+
* Documentation updates and corrections, including the tutorial on creating
|
|
118
|
+
and writing to your own event source.
|
|
119
|
+
|
|
120
|
+
== 0.3.3 - 2-Jan-2006
|
|
121
|
+
* If EventLog.new fails, it now raises EventLogError instead of StandardError.
|
|
122
|
+
* Added documentation to the eventlog.txt file for EventLog#notify_change.
|
|
123
|
+
* Added inline rdoc to the C source code.
|
|
124
|
+
* Code cleanup.
|
|
125
|
+
|
|
126
|
+
== 0.3.2 - 26-May-2005
|
|
127
|
+
* Code now more Unicode friendly, and other cleanup.
|
|
128
|
+
* Made the .txt files rdoc friendly, and removed the .rd files.
|
|
129
|
+
* Minor adjustments to the test suite.
|
|
130
|
+
|
|
131
|
+
=== 0.3.1 - 16-Feb-2005
|
|
132
|
+
* Minor modifications to the source to eliminate some warnings that appeared
|
|
133
|
+
in Ruby 1.8.2 or later, plus other minor tweaks.
|
|
134
|
+
* Renamed the sample programs and moved the 'examples' directory to the
|
|
135
|
+
toplevel directory.
|
|
136
|
+
* Made this document rdoc friendly.
|
|
137
|
+
|
|
138
|
+
== 0.3.0 - 30-Oct-2004
|
|
139
|
+
* Added the notify_change() and tail() methods.
|
|
140
|
+
* Added the write() alias for report_event().
|
|
141
|
+
* The read() class and instance methods now return an array of structs if
|
|
142
|
+
no block is given.
|
|
143
|
+
* Added the 'rubymsg.mc' message category file. If installed, this will
|
|
144
|
+
create a 'RubyMsg' event source for use with win32-service, though you
|
|
145
|
+
may use it for whatever you wish. See the README for more details.
|
|
146
|
+
* Renamed struct back to EventLogStruct - sorry, sorry - I promise I won't
|
|
147
|
+
change this again.
|
|
148
|
+
* Fixed a bug where using EventLog::SEEK_READ did not work properly (thanks
|
|
149
|
+
Park).
|
|
150
|
+
* Added the notify.rb test script under doc/examples.
|
|
151
|
+
|
|
152
|
+
== 0.2.5 - 28-Oct-2004
|
|
153
|
+
* Modified the open() and read() class methods to default to "Application"
|
|
154
|
+
for the default Event source.
|
|
155
|
+
* Removed the .html files. You can generate these on your own with rd2.
|
|
156
|
+
|
|
157
|
+
== 0.2.4 - 19-Oct-2004
|
|
158
|
+
* Fixed a bug where a segfault would result if an Event Log entry were
|
|
159
|
+
somehow corrupted. Thanks go again to Joey Gibson for the spot.
|
|
160
|
+
* Very minor doc corrections in tutorial.txt and eventlog.txt
|
|
161
|
+
|
|
162
|
+
== 0.2.3 - 14-Oct-2004
|
|
163
|
+
* Fixed a bug where some Event Log descriptions were returning nil instead
|
|
164
|
+
of the actual description. Thanks go to Joey Gibson for the spot.
|
|
165
|
+
* Minor test suite and doc additions, including a "future plan" that may
|
|
166
|
+
be of interest.
|
|
167
|
+
|
|
168
|
+
== 0.2.2 - 02-Jul-2004
|
|
169
|
+
* Fixed a bug in the read() method where not all the records were being
|
|
170
|
+
returned.
|
|
171
|
+
* Fixed calls to rb_time_new() - second argument appears to be mandatory as
|
|
172
|
+
of 1.8.2.
|
|
173
|
+
* Renamed struct returned by read() to "EventLog".
|
|
174
|
+
* Changed struct members "id" and "type" to "event_id" and "event_type",
|
|
175
|
+
respectively. This was to avoid any confusion with the builtin Ruby
|
|
176
|
+
methods of the same name.
|
|
177
|
+
* Replaced STR2CSTR() with StringValuePtr(), as the former is deprecated.
|
|
178
|
+
This means that as of this version, Ruby 1.8.0 or later is required.
|
|
179
|
+
* Moved the sample programs to doc/examples.
|
|
180
|
+
|
|
181
|
+
== 0.2.1 - 04-Mar-2004
|
|
182
|
+
* The add_event_source() and report_event() methods now accept symbols as
|
|
183
|
+
well as do key validation.
|
|
184
|
+
* Moved the EventLogError class under the Win32 module.
|
|
185
|
+
* Normalized the tc_eventlog.rb and tc_mc.rb scripts by making it easier to
|
|
186
|
+
run them standalone from another directory.
|
|
187
|
+
* Minor modification to the build process.
|
|
188
|
+
* Added a test_write.rb script for general futzing when it comes to creating
|
|
189
|
+
and writing events to the log.
|
|
190
|
+
* Doc updates, warranty information added.
|
|
191
|
+
|
|
192
|
+
== 0.2.0 - 1-Feb-2004
|
|
193
|
+
* Changed the Win32EventLogError class to just EventLogError. I felt the
|
|
194
|
+
Win32 was redundant given that the class is already under the Win32 module.
|
|
195
|
+
* Fixed bug where bogus error messages were returned because I was calling
|
|
196
|
+
GetLastError() too late.
|
|
197
|
+
* Fixed bug where error messages were getting cut off and/or garbled due to
|
|
198
|
+
\r\n character. (Thanks Park Heesob).
|
|
199
|
+
* Added open_backup class method.
|
|
200
|
+
|
|
201
|
+
== 0.1.4 - 16-Jan-2004
|
|
202
|
+
* Slightly better handling of the EventLog#close method. Adopted from code
|
|
203
|
+
previously submitted by Park Heesob.
|
|
204
|
+
* Fixed a bug in the (internal) GetUser() function that caused a segfault if
|
|
205
|
+
there were 250+ records. That function has been greatly simplified.
|
|
206
|
+
* Removed the rb_ensure() approach. What I thought was a memory leak was not,
|
|
207
|
+
in fact, a memory leak. Also, it was slowing down the method considerably.
|
|
208
|
+
* Minor test suite update.
|
|
209
|
+
|
|
210
|
+
== 0.1.3 - 7-Jan-2004
|
|
211
|
+
* Fixed memory leaks in read() method (Park Heesob).
|
|
212
|
+
* Added read() class method (Daniel Berger).
|
|
213
|
+
* Test suite and doc additions & updates
|
|
214
|
+
|
|
215
|
+
== 0.1.2 - 30-Nov-2003
|
|
216
|
+
* Added the report_event method. You can now write to the event log.
|
|
217
|
+
* Added the add_event_source class method, allowing you to register a custom
|
|
218
|
+
event source.
|
|
219
|
+
* Added the win32-mc package to the distribution. This is a simple
|
|
220
|
+
wrapper to generate .dll files from .mc files.
|
|
221
|
+
* Added Event Type constants
|
|
222
|
+
* Test suite additions
|
|
223
|
+
* Documentation updates and additions, including a small tutorial.
|
|
224
|
+
|
|
225
|
+
== 0.1.1 - 5-Nov-2003
|
|
226
|
+
* Fixed the free() call, and added implicit eventlog closing (when the
|
|
227
|
+
EventLog object is free'd).
|
|
228
|
+
* Simplified constants by removing 'EVENTLOG_' portion of name.
|
|
229
|
+
* Cleanup in the GetDescription() method, which was causing segfaults in
|
|
230
|
+
conjunction with TestUnit.
|
|
231
|
+
* Minor doc updates and cleanup.
|
|
232
|
+
|
|
233
|
+
== 0.1.0 - 14-Oct-2003
|
|
234
|
+
* Initial release
|