win32-eventlog 0.5.3 → 0.6.0
Sign up to get free protection for your applications and to get access to all the features.
- 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
|