This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Upgrade Time::HiRes from version 1.9734 to 1.9739
[perl5.git] / dist / Time-HiRes / Changes
1 Revision history for the Perl extension Time::HiRes.
2
3 1.9739 [2016-06-28]
4   - the upcoming macOS 10.12 (Sierra, the operating system formerly
5     known as OS X, or Darwin) has implemented the clock_gettime()
6     and clock_getres() interfaces but not the clock_nanosleep()
7
8 1.9738 [2016-06-26]
9   - fix the dates in the Changes, it's not July yet
10     [rt.cpan.org #115553]
11   - in cygwin, drop the utime.t expected timestamp resolution
12   - documented for utime that the actual timestamp resolution depends
13     on the operating system and the filesystem, just like for stat
14   - looks like in gnukfreebsd 10.1 neither futimens or utimensat work
15     even though they exist, skipping utime tests there for now
16   - demodernize the Test::More use in utime.t (no subtest) to
17     better support older Perl installations
18   - for all the tests, drop the Test::More 0.82 requirement,
19     the only "modern" thing used is the note routine which
20     can be replaced with print("# ...\n") (or printf),
21     with this works back at least with Test::More 0.54 (perl 5.8.7) 
22
23 1.9737 [2016-06-22]
24   - utime in HiRes.xs had dXSARGS which was unnecessary, leading
25     to two markstack pops, panic, and two-minute wait for the watchdog
26     (thanks to Dave Mitchell for the eagle-eye)
27   - even though 5.10.x should have the Perl_ck_warner, many CPAN
28     smokes proved otherwise, so requiring now at least 5.12 for
29     Perl_ck_warner use in IS_SAFE_PATHNAME() 
30
31 1.9736 [2016-06-22]
32   - the IS_SAFE_PATHNAME() emulation was too modern for Perl 5.10
33   - make it so that only one value is set for -DTIME_HIRES_STAT
34     even on systems that support many options
35   - the 1.9734 (only released in blead, and as part of the development
36     release 5.25.2) fix for Darwin's clock_gettime was wrong under
37     threaded builds, leading into mutex panics in clock.t 
38   - the d_hires_utime determination was made more precise
39   - the utime.t was failing in platforms where only one of
40     futimens/utimensat was present (neither or both was okay)
41
42 1.9735 [2016-06-20]
43   - Time::HiRes should override `utime` to allow setting hires
44     (futimens and utimensat support)
45     [rt.perl.org #114809]
46   - the utime patch used IS_SAFE_PATHNAME() which isn't available in
47     too old Perls, so emulate (in case the Devel::PPPort is too old)
48
49 1.9734 [2016-06-17]
50   - fix Darwins with clock_gettime: blead 2d41a263
51     [rt.perl.org #128427]
52
53 1.9733 [2016-04-23]
54   - C90 declaration-after-statement error with darwin threads: blead de1003b4
55     [rt.cpan.org #113856]
56
57 1.9732 [2016-03-13]
58   - MUTEX_LOCK, not PERL_MUTEX_LOCK: blead e5b02b5d
59   - also hrt_ualarm_itimer() is unused: 1cb6cce3
60   - the mutex needs init: 2d639e20
61   - version bump to 1.9732: 730d7fdc
62
63 1.9731 [2016-03-13]
64   - mark unused variable as such: blead a914236c
65   - OS X emulation mutex accidentally unused: da7a6455
66   - remove hrt_ualarm: 6da77c36
67   - pod error fixes: 919ca095
68   - nanosleep and clock_nanosleep cleanups: c8ea02b8..e3ff671b
69   - static funcs in HiRes.xs: 4e922c26
70   - Remove unused variable: 52ffb1b5
71
72 1.9730 [2016-02-17]
73   - TIME_HIRES_DONT_RUN_PROBES=1 to build the probes but not run them
74     [rt.cpan.org #111391]
75
76 1.9729 [2016-02-13]
77   - new constants
78     [rt.cpan.org #111170]
79   - clock_getres(), clock_gettime(), clock_nanosleep() emulation for OS X
80     [rt.cpan.org #78566]
81
82 1.9728 [2015-11-13]
83   - No changes since 1.9727_03
84
85 1.9727_03 [2015-11-06]
86   - use PERL_UNUSED_ARG() in the not-here-croak branches
87   - Makefile.PL/metadata improvements
88
89 1.9727_02 [2015-08-29]
90   - correct documentation to note that Time::NVtime is NV, not double
91     [perl #123879]
92   - avoid a warning about clock_t on OS X / clang 3.6 - 3.6
93     [rt.cpan.org #102718]
94
95 1.9727_01 [2015-08-17]
96   - Remove usage of 5.005 thread APIs in favor of 5.6 and up thread APIs
97     [rt.cpan.org #102799].
98   - Silence a C++ compiler warning [rt.cpan.org #101497].
99   - respect $Config{run} for cross-compiling [rt.cpan.org #92607]
100
101 1.9726 [2013-08-17]
102         - Correct s/us splitting of usleep(1000000) [rt.cpan.org #78266].
103         - Avoid integer overflow in itimer-based alarm() with large
104           argument [rt.cpan.org #87160].
105         - Define PERL_NO_INLINE_FUNCTIONS during probe compilations, to
106           avoid false negatives caused by not linking with the perl core.
107         - Be more careful about context in stat().
108         - Install into "site" directories by default on perl 5.11+
109           [rt.cpan.org #79797].
110         - Fix a couple of doc typos [rt.cpan.org #85365].
111         - Fix function name in a doc example [rt.cpan.org #86318].
112         - Provide lstat() that yields high-res timestamps, alongside
113           the existing high-res stat() [rt.cpan.org #78732].
114
115 1.9725 [2012-02-01]
116         - Correct stack discipline in stat(), which was screwing up list
117           operations in expressions containing calls to it [rt.cpan.org
118           #72926].
119         - Add missing OUTPUT sections to the XS code [rt.cpan.org #70930].
120         - Skip itimer tests on GNU/Hurd, which has the API but lacks
121           the implementation [rt.cpan.org #72754].
122         - Fix a doubled word in the documentation [rt.cpan.org #72763].
123
124 1.9724 [2011-06-09]
125         - Correct XS parameter list, and therefore prototype, for
126           unimplemented-on-this-platform version of clock_nanosleep()
127           [rt.cpan.org #68700].
128         - Declare package variables with "our" rather than "use vars".
129         - Corresponding to "our" usage, check for minimum Perl version
130           5.006.
131         - Declare module dependencies.
132
133 1.9723 [2011-06-07]
134         - Remove $ENV{PERL_CORE} logic from test suite, which is no
135           longer desired in the core.
136         - Convert test suite to use Test::More.
137         - Factor out watchdog code from test suite.
138         - In test suite, be consistent about using fully-qualified form
139           of function names.
140         - Divide test suite into feature-specific scripts.
141         - Make ualarm timing test less vulnerable to delay-induced false
142           failure, from Dave Mitchell.
143
144 1.9722 [2011-05-18]
145         - Update for changes in build process in the core, patches
146           from BinGOs [rt.cpan.org #58858] and Craig Berry [rt.cpan.org
147           #63363].
148         - Fix broken linkage on Windows with gcc 3.4 seen with ActivePerl,
149           report from Christian Walde [rt.cpan.org #61648], fix derived
150           from Vincent Pit.
151         - Jump through hoops to avoid compiler warnings.
152
153 1.9721 [2010-03-17]
154         - Address [rt.cpan.org #54196] alarm and ularm return values are bogus,
155           additional fix from Gisle Aas
156         - Address [rt.cpan.org #55665] "Bad plan" on Windows,
157           report and fix from Jan Dubois
158
159 1.9720 [2010-02-14]
160         - Address [rt.cpan.org #54196] alarm and ularm return values are bogus,
161           report and fix from Nicholas Clark
162
163 1.9719  [2009-01-04]
164         - As with QNX, Haiku has the API of interval timers but not
165           the implementation (bleadperl change #34630), hence skip
166           the tests, via David Mitchell.
167
168 1.9718  [2008-12-31]
169         - .xs code cleanup from Albert Dvornik
170         - in the #39 and #40 do not do us I did, mixing alarm() and
171           sleep().  Now instead spin until enough time has passed.
172
173 1.9717  [2008-12-30]
174         - Skip the tests added in 1.9716 (#39, #40) if there's no subsecond
175           alarm capability, like with the older subsecond alarm tests
176
177 1.9716  [2008-12-26]
178         - Change documentation to agree with reality: there are
179           no interval timers in Win32.
180         - Address [rt.cpan.org #35899] (problem in subsecond sleeps),
181           add two tests to guard against this problem
182         - Address [rt.cpan.org #36600] 'Division by zero' failure in test suite
183         - Address [rt.cpan.org #37340] [PATCH] Address timer process in test
184         - Address [rt.cpan.org#40311 ] bad implementation of hrt_usleep
185           with TIME_HIRES_NANOSLEEP
186
187 1.9715  [2008-04-08]
188         - Silly me: Makefile.PL does need to accept arguments other than mine.
189           Some testing frameworks obviously do this.
190         - Add retrying for tests 34..37, which are the most commonly
191           failing tests.  If this helps, consider extending the retry
192           framework to all the tests.  [Inspired by Slaven Rezic,
193           [rt.cpan.org #34711] Occasional failures of test 35 or 36 (FreeBSD)]
194
195 1.9714  [2008-04-07]
196         - Under Perl 5.6.* NVgf needs to be "g", reported by Zefram,
197           it seems that ppport.h 3.13 gets this wrong.
198         - remove the check in Makefile.PL for 5.7.2, shouldn't be
199           (a) necessary (b) relevant
200         - add logic to Makefile.PL to skip configure/write Makefile
201           step if the "xdefine" file already exists, indicating that
202           the configure step has already been done, one can still
203           force (re)configure by "perl Makefile.PL configure",
204           or of course by "make clean && perl Makefile.PL".
205
206 1.9713  [2008-04-04]
207         - for alarm() and ualarm() [Perl] prefer setitimer() [C]
208           instead of ualarm() [C] since ualarm() [C] cannot portably
209           (and standards-compliantly) be used for more than 999_999
210           microseconds (rt.cpan.org #34655)
211         - it seems that HP-UX has started (at least in 11.31 ia64)
212           #defining the CLOCK_REALTIME et alia (instead of having
213           them just as enums)
214         - document all the diagnostics
215
216 1.9712  [2008-02-09]
217         - move the sub tick in the test file back to where it used to be
218         - in the "consider upgrading" message recommend at least Perl 5.8.8
219           and make the message to appear only for 5.8.0 since 5.8.1 and
220           later have the problem fixed
221         - VOS tweak for Makefile (core perl change #33259)
222         - since the test #17 seems to fail often, relax its limits a bit
223
224 1.9711  [2007-11-29]
225         - lost VMS test skippage from Craig Berry
226         - reformat the test code a little
227
228 1.9710  [2007-11-29]
229         - I got the sense of the QNX test the wrong way in an attempt
230           to generalize it for future
231
232 1.9709  [2007-11-28]
233         - casting fixes from Robin Barker for g++ and 64bitint
234         - in QNX skip the itimer tests because though the API
235           is there, the implementation isn't, from Matt Kraai
236         - raise the dead man timer to 180 seconds for really
237           slow/busy systems
238         - elaborate the UTF-8 locale warning from Makefile.PL
239
240 1.9708  [2007-10-05]
241         - [rt.cpan.org #29747]: Build failure with perl 5.005_05
242           Fixed by regenerating the ppport.h using Devel::PPPort 3.13.
243
244 1.9707  [2007-02-27]
245         - t/HiRes.t failed in Perl 5.6.2,
246           "action is not of type POSIX::SigAction at t/HiRes.t line 318",
247           reported and fixed by Anton Berezin, the reason was faulty
248           use of sigaction() when restoring the old action.
249
250 1.9706  [2007-02-25]
251         - with bleadperl in VMS the HiRes.t overrun the maximum number
252           of deferred signals because the libc SIGALRM was not strong
253           enough to interrupt select(), and select() got restarted every
254           time, solution is to use POSIX::SigAction if available.
255           A fix from Craig Berry (not 100% there, but helps).
256         - allow for more measuring noise for ualarm() tests 35..37
257
258 1.9705  [2007-02-06]
259         - nanosleep() and clock_nanosleep() detection and use were
260           quite broken; in Linux -lrt needed; fixes from Zefram
261         - [internal] slightly cleaner building of $DEFINE in Makefile.PL,
262           should avoid double/conflicting -D flags
263
264 1.9704  [2007-01-01]
265         - allow 10% of slop in test #14 (testing difference between
266           CORE::time() and Time::HiRes::time()), there seem to be often
267           transient failures from Perl smoke builds on this test
268         - small pod tweaks
269
270 1.9703  [2006-12-08]
271         - use int main(int argc, char **argv) consistently in Makefile.PL,
272           should help with
273           [rt.cpan.org #23868] nanosleep not detected under Mac OS 10.3.9 starting with Time::HiRes 1.96
274         - if someone still has the locale-broken Perl 5.8.0,
275           suggest that they upgrade their Perl
276
277 1.9702  [2006-12-06]
278         - restore the -DATLEASTFIVEOHOHFIVE, Win32 needed it still
279
280 1.9701  [2006-12-04]
281         - upgrade to ppport.h 3.10_02
282         - remove the -DATLEASTFIVEOHOHFIVE
283         - use the ppport.h PL_ppaddr, PL_statcache, PL_laststatval
284         - use the ppport.h aTHXR for calling Perl stat()
285         - switch into four-digit version since 2.0 is coming up
286           awfully fast but not feeling like a major rewrite
287
288 1.97    [2006-11-30]
289         - 1.95 broke building in Win32 (since pp_stat is not exported),
290           figured out how to call an op directly in 5.005 (use Perl_ppaddr
291           instead of PL_ppaddr)
292         - backport to Perl 5.004_05  (requires using statcache
293           and laststatval instead of PL_statcache and PL_laststatval)
294           (also checked to work in 5.005_04, 5.6.1, and 5.8.8 with threads)
295
296 1.96    [2006-11-30]
297         - 1.95 broke builds for threaded Perls, rt.cpan.org tickets:
298           [rt.cpan.org #23694] Time::HiRes fails tests on Solaris and Perl 5.6.1
299           [rt.cpan.org #23712] Time-HiRes 1.95 Fails make on AIX 5.2 with Perl 5.8.8
300           [rt.cpan.org #23730] Time::HiRes 1.95 fails make on MacOS X 10.3.9/perl 5.8.8
301         - use main() prototype consistently in Makefile.PL
302
303 1.95    [2006-11-29]
304         - integrate core change #29180: Silence VC++ compiler warnings
305           from Steve Hay
306         - do not use PL_ppaddr in stat() because that is not available
307           in Perl 5.005_04
308         - regenerate fallback/*.inc for older Perls without
309           ExtUtils::Constant because of d_hires_stat, resolves
310           [rt.cpan.org #23694] Time::HiRes fails tests on Solaris and Perl 5.6.1
311         - Make Makefile.PL more defensive against false PERL_CORE
312
313 1.94    [2006-10-16]
314         - file timestamps oddities seen: the atime and mtime
315           can be out of sync (modify first and read second can leave
316           atime < mtime) and mtime can be subsecond while atime is not.
317           So make the test more forgiving.
318
319 1.93    [2006-10-15]
320         - the ualarm() tests (34-37) assumed that ualarm(N)
321           could never alarm in less than N seconds, widened
322           the acceptable relative range to 0.9..1.5.  Addresses
323           [rt.cpan.org #22090] and [rt.cpan.org #22091].
324
325         - skip the stat() tests in cygwin and win32, because
326           if run on FAT the timestamp granularity is only 2 seconds.
327           Any good way to detect (cygwin or win32) whether we are
328           being run on NTFS or anywhere with better timestamps?
329           Addresses [rt.cpan.org #22089] and [rt.cpan.org #22098].
330
331 1.92    [2006-10-13]
332         - scan for subsecond resolution timestamps in struct stat,
333           some known possibilities:
334
335           (1)  struct  timespec st_atimespec;
336                                 st_atimespec.tv_nsec;
337           (2)  time_t  st_atime;
338                long    st_atimensec;
339           (3)  time_t  st_atime;
340                int     st_atime_n;
341           (4)  timestruc_t st_atim;
342                            st_atim.tv_nsec
343           (5)  time_t  st_atime;
344                int     st_uatime;
345
346           If something like this is found, one can do
347
348             use Time::HiRes;
349             my @stat = Time::HiRes::stat();
350
351           or even override the standard stat():
352
353             use Time::HiRes qw(stat);
354
355           to get the stat() timestamps
356
357             my ($atime, $mtime, $ctime) = @stat[8, 9, 10];
358
359           with subsecond resolution (assuming both the operating
360           system and the filesystem support that kind of thing).
361
362           Contributions for more systems (especially non-UNIX,
363           e.g. but not limited to: Win32, VMS, OS/2) gladly accepted.
364           (also more UNIX variants welcome: HP-UX? IRIX?)
365
366           Thanks to H.Merijn Brand, John Peacock, and Craig
367           Berry for brave beta testing.
368
369 1.91    [2006-09-29]
370         - ualarm() in SuSE 10.1 was overflowing after ~4.2 seconds,
371           possibly due to a glibc bug/feature (suspected overflow at
372           2**32 microseconds?), workaround by using the setitimer()
373           implementation of ualarm() if either useconds or
374           interval > 999_999 (this case seems to vary between systems:
375           are useconds more than 999_999 for ualarm() defined or not)
376           Added more ualarm() tests to catch various overflow points,
377           hopefully no problems in various platforms.
378           (The problem report by Mark Seger and Jon Paul Sullivan of HP.)
379
380 1.90    [2006-08-22]
381         - tweak still needed for Const64(), from Jerry Hedden
382         - get a freshly generated ppport.h
383         - update Copyright years
384
385 1.89    [2006-08-22]
386         - Const64() already appends an 'LL' (or i64), so provide LL and i64
387           forms for the IV_1E[679] (effects Win32 and Cygwin), reported by
388           Jerry Hedden.
389         - the Changes entry for 1.88 talked about [IN]V_1[679],
390           missing the 'E'.
391
392 1.88    [2006-08-21]
393         - clean up the g++ warnings in HiRes.xs, all of them
394           about mixing integer and floating point, introduce
395           constants IV_1E[679] and NV_1E[679]
396
397 1.87    [2006-02-13]
398         - [rt.cpan.org #17442] 'make test' frequently fails under
399           Cygwin Perl v5.8.8, reported and patched by J. R. Hedden
400           (two race condition bugs in the END block in the case the
401            main process dies before the timer process, unearthed
402            by a bug in Cygwin ualarm)
403
404 1.86    [2005-12-17]
405         - HiRes.t:s/ok 32/ok 33/, from Dominic Dunlop
406         - tighten up the clock() test marginally by requiring non-negative
407         - clock_nanosleep() and clock() doc tweaks
408
409 1.85    [2005-12-16]
410         - the interface to clock_nanosleep() is more natural
411           when it is like (hires) time() (instead of like nanosleep),
412           and the .xs implementation of clock_nanosleep() in 1.84
413           was broken anyway
414         - the semantics of clock() are not quite so silly as I thought,
415           but still somewhat odd, documented as such
416         - additional enhancements to the clock() documentation
417         - add test for clock_nanosleep() (I cannot test this
418           since none of my systems have the function)
419         - add test for clock()
420
421 1.84    [2005-12-16]
422         - add clock() which returns the processor time in
423           (floating point) seconds since an arbitrary era
424         - add clock_nanosleep() which suspends the current
425           thread until either absolute time or for relative time
426         - [rt.cpan.org #16486] printf missing value in HiRes.t
427         - add constants CLOCKS_PER_SEC, CLOCK_SOFTTIME, TIMER_ABSTIME
428         - tiny typo fixes
429
430 1.83    [2005-11-19]
431         - has_symbol() was wrong since e.g. ITIMER_VIRTUAL is exported
432           via @EXPORT_OK even when it is not available.  This is heinous.
433           @EXPORT_OK should be determined at Makefile.PL time.
434         - be more lenient is testing clock_gettime(): allow more slop,
435           and retry up to three times, sleeping a random nap between
436           the retries
437         - human months are one-based (noticed by Anton Berezin)
438
439 1.82    [2005-10-06]
440         - CLOCK_REALTIME is an enum value (of the clockid_t enum)
441           in HP-UX (and might be so elsewhere, too), debugged by
442           H. Merijn Brand
443         - include const-c.inc as late as possible (from Randy Kobes,
444           [rt.cpan.org #15552] to avoid undefined usleep() on Win32
445
446 1.81    [2005-11-05]
447         - try to be more robust and consistent in the detection of
448           CLOCK_REALTIME and ITIMER_VIRTUAL in HiRes.t: the proper
449           way is
450
451                 sub has_symbol {
452                     my $symbol = shift;
453                     eval 'import Time::HiRes qw($symbol)';
454                     return 0 unless $@ eq '';
455                     return exists ${"Time::HiRes::$symbol"};
456                 }
457
458           and then use
459
460                 &FOO_BAR
461
462           in the test.  All these moves are needed because
463
464           1) one cannot directly do eval 'Time::HiRes::FOO_BAR'
465              because FOO_BAR might have a true value of zero
466              (or in the general case an empty string or even undef)
467
468           2) In case FOO_BAR is not available in this platform,
469              &FOO_BAR avoids the bareword warning
470
471         - wait more (1.5 seconds instead of 0.1) for the CLOCK_REALTIME test
472           but expect the 'customary' slop of 0.20 instead of 0.25
473         - fixed inside a comment HAS_POLL -> TIME_HIRES_NANOSLEEP
474         - at the end of HiRest.t tell how close we were to termination
475
476 1.80    [2005-11-04]
477         - Gisle noticed a mistake (using HAS_NANOSLEEP) in 1.79
478
479 1.79    [2005-11-03]
480         - try nanosleep for emulating usleep -- may help in some weird
481           embedded realtime places which have nanosleep but neither usleep
482           nor select nor poll (doesn't have to be weird embedded realtime
483           place, though -- in many places usleep is nanosleep anyway)
484         - try poll for emulating usleep -- this may help some obscure/old
485           SVR4 places that have neither usleep nor select
486         - a redundant test guard in HiRes.t
487
488 1.78    [2005-11-03]
489         - ITIMER_VIRTUAL detection in HiRes.t had problems (that we cannot
490           in the general case fail already at 'use' phase is suboptimal)
491         - fixes to the documentation of clock_gettime() and clock_getres()
492
493 1.77    [2005-11-03]
494         - add support for the POSIX clock_gettime() and clock_getres(),
495           if available, either as library calls or as syscalls
496         - be more defensive about missing functionality: break out
497           early (during 'use') if no e.g. clock_getres() is available,
498           and protect our back by trapping those cases also in HiRes.xs
499         - the test added in 1.76 could cause an endless loop e.g. in Solaris,
500           due to mixing of sleep() and alarm() (bad programmer, no cookie!)
501
502 1.76    [2005-10-22]
503         - testing for nanosleep had wrong logic which caused nanosleep
504           to become undefined for e.g. Mac OS X
505         - added a test for a core dump that was introduced by Perl 5.8.0
506           safe signals and was fixed for the time of 5.8.1 (one report of
507           the core dump was [perl #20920]), the test skipped pre-5.8.1.
508         - *cough* s/unanosleep/nanosleep/g; *cough*
509
510 1.75    [2005-10-18]
511         - installation patch from Gisle Aas: in Perls 5.8.x and later
512           use MakeMaker INSTALLDIRS value of 'perl' instead of 'site'.
513
514 1.74    [2005-09-19]
515         - [cpan #14608] Solaris 8 perl 5.005_03 File::Spec module does not have method rel2abs
516           (the workaround is not to use rel2abs, should not be necessary)
517         - [cpan #14642] U2time wrongly exported on the C API
518           (patch supplied by the reporter, SALVA@cpan.org)
519         - add release dates to Changes
520
521 1.73    [2005-08-16]
522         - Time::HiRes::nanosleep support for Solaris [PATCH]
523           (POSIX::uname() not available if building with core perl,
524            from Gisle Aas, via perl5-porters, perl change #25295)
525
526 1.72    [2005-07-01]
527         - going back to the 1.68 loader setup (using DynaLoader)
528           since too many weird things starting breaking
529         - fix a typo in José Auguste-Etienne's name
530
531 1.71    [2005-06-28]
532         - a thinko in the nanosleep() detection
533         - move more changes stuff from the README to Changes
534         - add -w to the Makefile.PL
535
536 1.70    [2005-06-26]
537         - oops in 1.69 about @ISA (not affecting anything but silly)
538         - add copyright 2005 to HiRes.pm
539         - add copyright and license to HiRes.xs
540         - add copyrights 2003, 2004, 2005 to README
541
542 1.69    [2005-06-25]
543         - actually run a test for nanosleep
544           (if there is no $Config{d_nanosleep}) since e.g. in AIX 4.2
545           it seems that one can link in nanosleep() but then calling
546           it fails instantly and sets errno to ENOSYS (Not implemented).
547           This may be fixable in the AIX case by figuring out the right
548           (realtime POSIX?) libs and whatnot, but in the general case
549           running a real test case is better.  (Of course, this change
550           will no doubt run into portability problems because of the
551           execution step...)  Note that because of hysterical raisins
552           most Perls do NOT have $Config{d_nanosleep} (scanning for
553           it by Configure would in many platforms require linking in
554           things like -lrt, which would in many platforms be a bad idea
555           for Perl itself).
556           (from José Auguste-Etienne)
557         - support XSLoader also since it's much faster
558           (from Alexey Tourbin)
559         - add SEE ALSO (BSD::Resource and Time::TAI64)
560
561 1.68    [2005-05-14]
562         - somehow 1.67 had a lot of doubled lines (a major cut-and-paste
563           error suspected), but miraculously it still worked since the
564           doubling took place below the __END__ token
565         - undef Pause() before defining it to avoid redefinition warnings
566           during compilation in case perl.h had already defined Pause()
567           (part of perl change #24271)
568         - minor doc tweaks
569
570 1.67    [2005-05-04]
571         - (internal) don't ignore the return value of gettimeofday()
572         - (external) return undef or an empty if the C gettimeofday() fails
573           (affects Time::HiRes gettimeofday() and the hires time())
574
575 1.66    [2004-12-19]
576         - add nanosleep()
577         - fix the 'hierachy' typo in Makefile.PL [rt.cpan.org #8492]
578         - should now build in Solaris [rt.cpan.org #7165] (since 1.64)
579         - should now build in Cygwin [rt.cpan.org #7535] (since 1.64)
580         - close also [rt.cpan.org #5933] "Time::HiRes::time does not
581           pick up time adjustments like ntp" since ever reproducing it
582           (and therefore verifying a possible fix) in the same environment
583           has become rather unlikely
584
585 1.65    [2004-09-18]
586         - one should not mix u?alarm and sleep (the tests modified
587           by 1.65, #12 and #13, hung in Solaris), now we just busy
588           loop executing an empty block
589         - in the documentation underline the unspecificity of mixing
590           sleeps and alarms
591         - small spelling fixes
592
593 1.64    [2004-09-16]
594         - regenerate ppport.h with Devel::PPPort 3.03,
595           now the MY_CXT_CLONE is defined in ppport.h,
596           we no more need to do that.
597
598         - the test #12 would often hang in sigsuspend() (at least that's
599           where Mac OS X' ktrace shows it hanging).  With the sleep()s
600           changed to sleep(1)s, the tests still pass but no hang after
601           a few hundred repeats.
602
603 1.63    [2004-09-01]
604         - Win32 and any ithread build: ppport.h didn't define
605           MY_CXT_CLONE, which seems to be a Time-HiRes-ism.
606
607 1.62    [2004-08-31]
608         - Skip testing if under PERL_CORE and Time::HiRes has not
609           been Configured (from Marcus Holland-Moritz, core change
610           #23246)
611         - Use ppport.h generated by Devel::PPPort 3.01,
612           allowing cutting away our own portability code.
613         - Don't use $ENV{PERL_CORE} for < 5.6.0.
614         - Don't use "for my $i" for <= 5.003.
615         - Don't use Pause() for <= 5.003.
616         - Can't use newSVpvf for <= 5.003.
617         (most of the changes from Marcus)
618
619 1.61    [2004-08-21]
620         - Win32: reset reading from the performance counters every
621           five minutes to better track wall clock time (thanks to
622           PC timers being often quite bad), should help long-running
623           programs.
624
625 1.60    [2004-08-15]
626         - Win32: Patch from Steve Hay
627           [PATCH] Re: [perl #30755] [Win32] Different results from Time::HiRes::gettimeofdayunder the debugger
628           to [perl #30755] reported by Nigel Sandever
629
630         - Cygwin: Use the Win32 recalibration code also in Cygwin if the
631           <w32api/windows.h> APIs are available.  Cygwin testing by
632           Yitzchak Scott-Thoennes.
633
634         - Solaris: use -lposix4 to get nanosleep for Solaris 2.6,
635           after that keep using -lrt, patch from Alan Burlison,
636           bug reported in [cpan #7165]
637
638 1.59    [2004-04-08]
639         - Change the Win32 recalibration limit to 0.5 seconds and tweak
640           the documentation to blather less about the gory details of the
641           Win32 implementation and more about the complications in general
642           of meddling with the system clock.
643
644 1.58    [2004-04-08]
645         - Document the 1.57 change better.
646
647 1.57    [2004-07-04]
648         - Win32/Cygwin/MinGW: if the performance counter drifts by more
649           than two seconds from the system clock (due to ntp adjustments,
650           for example), recalibrate our internal counter: from Jan Dubois,
651           based on [cpan #5933] by Jerry D. Hedden.
652
653 1.56    [2004-29-02]
654         - Give a clearer message if the tests timeout (perl change #22253)
655         - Don't use /tmp or its moral equivalents (perl bug #15036,
656           perl change #22258)
657
658 1.55    [2004-01-14]
659         - Windows: mingw32 patch from Mike Pomraning (use Perl's Const64()
660           instead of VC-specific i64 suffix)
661
662 1.54    [2003-12-31]
663         - Solaris: like Tru64 (dec_osf) also Solaris need -lrt for nanosleep
664
665 1.53    [2003-12-30]
666         - Windows: higher resolution time() by using the Windows
667           performance counter API, from Jan Dubois and Anton Shcherbinin.
668           The exact new higher resolution depends on the hardware,
669           but it should be quite a bit better than using the basic
670           Windows timers.
671
672 1.52    [2003-10-28]
673         - In AIX (v?) with perl 5.6.1 the HiRes.t can hang after
674           the subtest 18.  No known analysis nor fix, but added
675           an alarm (that requires fork() and alarm()) to the test.
676
677 1.51    [2003-09-22]
678         - doc tweaks from mjd (perl change #20456)
679         - NCR MP-RAS hints file added (svr4.pl) (perl change #21249)
680
681 1.50    [2003-08-02]
682         - add a message (for non-core builds) to Makefile.PL about
683           the LC_ALL=C workaround
684         - &Time::HiRes::d_nanosleep was broken (perl change #20131)
685         - the nanosleep() probe was broken (perl change #20061)
686         - use existence instead of definedness for feature probes
687           (perl change #20043)
688         - MPE/iX tweak (perl change #20042)
689         - do not use HAS_NANOSLEEP (perl change #19898)
690
691 1.49    [2003-06-23]
692         - UVuf for non-IVSIZE platforms (from Keiichiro Nagano)
693         - OS/2 can always mix subsecond sleeps with signals
694           (part of perl change #19789)
695
696 1.48    [2003-06-04]
697         - workaround for buggy gcc 2.95.3 in openbsd/sparc64
698           (perl change #19592)
699
700 1.47    [2003-05-03]
701         - do not use -lrt in Linux (from March Lehmann, perl change #19449)
702                 - unnecessary (nanosleep is in libc anyway)
703                 - harmful (-lrt slows down execution)
704                 - incompatible (with many distributions' pthreads)
705
706 1.46    [2003-04-25]
707         - do not create files in blib directories under core
708           (perl change #19160, from rgs)
709         - detypo s/VTLARM/VTARLM/ (perl change #19328, from mjd)
710
711 1.45    [2003-04-01]
712         - guarantee that $xdefine in HiRes.t is always defined
713           (perl change #19109, from IlyaZ)
714         - a cleaner way to detect PERL_CORE (perl change #19111,
715           from IlyaZ)
716
717 1.44    [2003-03-30]
718         - add hints/irix.pl to turn off overly POSIX flags that
719           cause hide struct timespec to be hidden (and compilation
720           to fail) (bleadperl change #19085)
721         - documentation tweaks
722
723 1.43    [2003-03-11]
724         - add c:/temp to the list of temp directories to probe
725           so that cygwin (and win*?) builds are happy.  This was
726           needed at least in my cygwin 1.3.20/w2k setup.
727
728 1.42    [2003-01-07]
729         - modernize the constants code (from Nicholas Clark)
730
731 1.41    [2003-01-03]
732         - At some point the ability to figure our the correct incdir
733           for EXTERN.h (either a core perl build, or an installed perl)
734           had broken (which lead into all test compiles failing with
735           a core perl build, but thanks to the robustness of Makefile.PL
736           nothing of this was visible).  The brokenness seemed to be
737           caused by $ENV{PERL_CORE} not being on for core builds?
738           Now stole a trick from the Encode that sets $ENV{PERL_CORE}
739           right, and both styles of build should work again.
740
741 1.40    [2003-01-03]
742         - Nicholas Clark noticed that the my_catdir() emulation function
743           was broken (which means that we didn't really work for Perls
744           5.002 and 5.003)
745         - inspired by fixing the above made the whole Makefile.PL -w
746           and strict clean
747         - tightened up the Makefile.PL output, less whitespace
748
749 1.39    [2003-10-20]
750         - fix from Craig Berry for better building in VMS with PERL_CORE
751
752 1.38    [2003-10-13]
753         - no functional changes
754         - move lib/Time/HiRes.pm as Hires.pm
755         - libraries scanning was slightly broken (always scanned
756           for a library even when $Config{libs} already had it)
757
758 1.37    [2003-09-23]
759         - Ray Zimmerman ran into a race condition in Mac OS X.
760           A 0.01-second alarm fired before the test expected.
761           The test first slept indefinitely (blocking for signals)
762           and only after that tested for the signal having been sent.
763           Since the signal had already been sent, the test #12 never
764           completed.  The solution: test first, then block.
765         - default to being silent on all probing attempts, set the
766           environment variable VERBOSE to a true value to see the
767           details (the probing command and the possible errors)
768
769 1.36    [2003-09-12]
770         - do not clear MAN3PODS in Makefile.PL (Radoslaw Zielinski)
771         - INSTALLDIRS => 'perl' missing which means that Time::HiRes
772           cannot be upgraded from CPAN to override the 5.8.0 version
773           (Guido A. Ostkamp)
774         - Time::HiRes 1.35 could not be dropped as-is to bleadperl
775           because the include directories did not adjust themselves
776           if $ENV{PERL_CORE} (Hugo van der Sanden)
777         - add documentation about the restart of select() under alarm()
778
779 1.35    [2003-08-24]
780         - small documentation tweaks
781
782
783 1.34    [2003-08-22]
784         - better VMS operation (Craig Berry)
785
786 1.33    [2003-08-20]
787         - our time machine is accelerating: now works with Perl 5.004_01
788           (tried with 5.003_07 and 5.002 but I get segmentation faults
789            from running the Makefile.PL with those in Tru64 4.0D)
790
791 1.32    [2003-08-20]
792         - backward compatibility (pre-5.6.0) tweaks:
793           - no XSLoader in 5.00503, use DynaLoader instead
794           - no SvPV_nolen, either
795           - no PerlProc_pause(), either
796           - now tested with 5.00404 and 5.00503
797           - Makefile.PL requires 5.00404 (no more 5.002)
798         - use nanosleep instead of usleep, if it is available (Wilson Snyder)
799           (this means that one can mix subsecond sleeps with alarms)
800         - because of nanosleep we probe for -lrt and -lposix4
801         - the existence of getitimer/nanosleep/setitimer/ualarm/usleep
802           is available by exportable constants Time::HiRes::d_func
803           (since older Perl do not have them in %Config, and even
804            5.8.0 does not probe for nanosleep)
805
806 1.31    [2003-08-19]
807         - backward compatibility (pre-5.6.1) tweaks:
808           - define NV if no NVTYPE
809           - define IVdf if needed (note: the Devel::PPPort
810             in 5.8.0 does not try hard hard enough since
811             the IVSIZE might not be defined)
812           - define NVgf if needed
813           - grab the typemap from 5.8.0 for the NV stuff
814
815         1.31 and 1.32 add more backward compatibility (now all the way
816         back to Perl 5.00404), and using nanosleep() (if available) for
817         subsecond sleeps.
818
819 1.30    [2003-08-16]
820
821         - release 1.29_02 as 1.30
822
823         1.30 adds all the changes made during the Perl 5.6->5.7->5.8
824         development cycle.  Most notably portability across platforms has been
825         enhanced, and the interval timers (setitimer, getitimer) have been
826         added.  Note that the version of Time::HiRes that is included in Perl
827         5.8.0 calls itself 1.20_00, but it is equivalent to this Time::HiRes
828         version.  Note also that in 1.30 Wegscheid turns over the maintenance
829         to Jarkko Hietaniemi.
830
831 1.29_02 [2003-08-16]
832
833         - fix a silly unclosed comment typo in HiRes.xs
834         - document and export REALTIME_REALPROF (Solaris)
835
836 1.29_01 [2003-08-16]
837
838         - only getitimer(ITIMER_REAL) available in Cygwin and Win32
839           (need to patch this also in Perl 5.[89])
840         - remove CVS revision log from HiRes.xs
841
842 1.29_00 [2003-08-14]
843
844         The following numbered patches refer to the Perl 5.7 changes,
845         you can browse them at http://public.activestate.com/cgi-bin/perlbrowse
846
847         - 17558: Add #!./perl to the .t
848         - 17201: linux + usemorebits fix, from Rafael Garcia-Suarez
849         - 16198: political correctness, from Simon Cozens
850         - 15857: doc tweaks, from Jarkko Hietaniemi
851         - 15593: optimization in .xs, from Paul Green
852         - 14892: pod fixes, from Robin Barker
853         - 14100: VOS fixes, from Paul Green
854         - 13422: XS segfault, from Marc Lehmann
855         - 13378: whether select() gets restarted on signals, depends
856         - 13354: timing constraints, again, from Andy Dougherty
857         - 13278: can't do subsecond alarms with ualarm;
858                  break out early if alarms do not seem to be working
859         - 13266: test relaxation (cygwin gets lower hires
860                  times than lores ones)
861         - 12846: protect against high load, from Jarkko Hietaniemi
862         - 12837: HiRes.t VMS tweak, from Craig A. Berry
863         - 12797: HiRes.t VMS tweak, from Charles Lane
864         - 12769: HiRes.t VMS tweak, from Craig A. Berry
865         - 12744: gcc vs MS 64-bit constant syntax, from Nick Ing-Simmons
866         - 12722: VMS ualarm for VMS without ualarm, from Charles Lane
867         - 12692: alarm() ain't gonna work if ualarm() ain't,
868                  from Gurusamy Sarathy
869         - 12680: minor VMS tweak, from Charles Lane
870         - 12617: don't try to print ints as IVs, from Jarkko Hietaniemi
871         - 12609: croak on negative time, from Jarkko Hietaniemi
872         - 12595: Cygwin rounds up for time(), from Jarkko Hietaniemi
873         - 12594: MacOS Classic timeofday, from Chris Nandor
874         - 12473: allow for more than one second for sleep() and usleep()
875         - 12458: test tuning, relax timing constraints,
876                  from Jarkko Hietaniemi
877         - 12449: make sleep() and usleep() to return the number
878                  of seconds and microseconds actually slept (analogously
879                  with the builtin sleep()), also make usleep() croak if
880                  asked for more than 1_000_000 useconds, from Jarkko Hietaniemi
881         - 12366: Time::HiRes for VMS pre-7.0, from Charles Lane
882         - 12199: do not use ftime on Win32, from Gurusamy Sarathy
883         - 12196: use ftime() on Win32, from Artur Bergman
884         - 12184: fix Time::HiRes gettimeofday() on Win32, from Gurusamy Sarathy
885         - 12105: use GetSystemTime() on Win32, from Artur Bergman
886         - 12060: explain the 1e9 seconds problem, from Jarkko Hietaniemi
887         - 11901: UNICOS sloppy division, from Jarkko Hietaniemi
888         - 11797: problem in HiRes.t, from John P. Linderman
889         - 11414: prototype from Time::HiRes::sleep(), from Abhijit Menon-Sen
890         - 11409: Time::HiRes qw(sleep) failed, from Abhijit Menon-Sen
891         - 11270: dynix/ptx 4.5.2 hints fix, from Peter Prymmer
892         - 11032: VAX VMS s/div/lib\$ediv/ fix, from Peter Prymmer
893         - 11011: VAX VMS s/qdiv/div/ fix, from Peter Prymmer
894         - 10953: SCO OpenServer 5.0.5 requires an explicit -lc for usleep(),
895                  from Jonathan Stowe
896         - 10942: MPE/IX test tweaks, from Mark Bixby
897         - 10784: unnecessary pod2man calls, from Andy Dougherty
898         - 10354: ext/ + -Wall, from Doug MacEachern
899         - 10320: fix the BOOT section to call myU2time correctly
900         - 10317: correct casting for AIX< from H. Merijn Brand
901         - 10119: document that the core time() may be rounding, not truncating
902         - 10118: test fix, from John Peacock
903         -  9988: long =item, from Robin Barker
904         -  9714: correct test output
905         -  9708: test also the scalar aspect of getitimer()
906         -  9705: Add interval timers (setitimer, getitimer)
907         -  9692: do not require at least 5.005 using XS
908                 
909         The following changes were made on top of the changes
910         made for Time::HiRes during the Perl 5.7 development
911         cycle that culminated in the release of Perl 5.8.0.
912
913         - add "require 5.005" to the Makefile.PL
914         - remove the REVISION section (CVS log) from HiRes.pm
915         - add jhi's copyright alongside Douglas'
916         - move HiRes.pm to lib/Time/
917         - move HiRes.t to t/
918         - modify HiRes.t to use $ENV{PERL_CORE}
919         - modify the original Time::HiRes version 1.20 Makefile.PL
920           to work both with Perl 5.8.0 and the new code with pre-5.8.0
921           Perls (tried with 5.6.1)
922         - tiny tweaks and updates in README and TODO
923         - bump the VERSION to 1.29
924
925 1.20  Wed Feb 24 21:30 1999
926         - make our usleep and ualarm substitutes into hrt_usleep
927           and hrt_ualarm. This helps static links of Perl with other
928           packages that also have usleep, etc. From
929           Ilya Zakharevich <ilya@math.ohio-state.edu>
930         - add C API stuff. From Joshua Pritikin
931           <joshua.pritikin@db.com>
932         - VMS Makefile.PL fun.  From pvhp@forte.com (Peter Prymmer)
933         - hopefully correct "-lc" fix for SCO.
934         - add PPD stuff
935
936         1.20 adds a platform neutral set of C accessible routines if you are
937         running 5.005+.  All other changes are packaging changes and build
938         fixes(?) for statically linked Perl, SCO, and VMS.
939
940 1.19  Tue Sep 29 22:30 1998
941         - put VMS gettimeofday() in. Patch is from Sebastian Bazley
942           <seb@stian.demon.co.uk>
943         - change GIMME_V to GIMME to help people with older versions of
944           Perl.
945         - fix Win32 version of gettimeofday(). It didn't affect anything,
946           but it confuses people reading the code when the return value
947           is backwards (0 is success).
948         - fix Makefile.PL (more) so that detection of gettimeofday is
949           more correct.
950
951         1.19 has better VMS support.
952
953 1.18  Mon Jul 6 22:40 1998
954         - add usleep() for Win32.
955         - fix Makefile.PL to fix reported HP/UX feature where unresolved
956           externals still cause an executable to be generated (though no
957           x bit set). Thanks to David Kozinn for report and explanation.
958           Problems with the fix are mine :)
959
960         1.18 has limited Win32 support (no ualarm). Added usleep for Win32.
961         Probably buggy. I'm sure I'll hear.
962
963 1.17  Wed Jul 1 20:10 1998
964         - fix setitimer calls so microseconds is not more than 1000000.
965           Hp/UX 9 doesn't like that. Provided by Roland B Robert, PhD.
966         - make Win32. We only get gettimeofday (the select hack doesn't
967           seem to work on my Win95 system).
968         - fix test 4 on 01test.t. add test to see if time() and
969           Time::HiRes::time() are close.
970
971 1.16  Wed Nov 12 21:05 1997
972         - add missing EXTEND in new gettimeofday scalar code.
973
974         1.16+ should be closer to building out of the box on Linux. Thanks
975         to Gisle Aas for patches, and the ualarm equivalent using setitimer.
976
977         If your underlying operating system doesn't implement ualarm(), then
978         a fake using setitimer() will be made.  If the OS is missing usleep(),
979         a fake one using select() will be made. If a fake can't be made for
980         either ualarm() or usleep(), then the corresponding Perl function will
981         not be available.  If the OS is missing gettimeofday(), you will get
982         unresolved externals, either at link- or run-time.
983
984         This is an improvement; the package used to not even build if
985         you were missing any of these bits. Roderick Schertler
986
987         <roderick@argon.org> did all the conditional compilation stuff,
988         look at HiRes.pm and the test suites; it's good educational reading.
989
990 1.15  Mon Nov 10 21:30 1997
991         - HiRes.pm: update pod. Provided by Gisle Aas.
992         - HiRes.xs: if gettimeofday() called in scalar context, do
993           something more useful than before. Provided by Gisle Aas.
994         - README: tell of xsubpp '-nolinenumber' woes. thanks to
995           Edward Henigin <ed@texas.net> for pointing out the problem.
996
997 1.14  Wed Nov 5 9:40 1997
998         - Makefile.PL: look for setitimer
999         - HiRes.xs: if missing ualarm, but we have setitimer, make up
1000           our own setitimer. These were provided by Gisle Aas.
1001
1002 1.13  Tue Nov 4 23:30 1997
1003         - Makefile.PL: fix autodetect mechanism to do try linking in addition
1004           to just compiling; should fix Linux build problem. Fix was provided
1005           by Gisle Aas.
1006
1007 1.12  Sun Oct 12 12:00:00 1997
1008         - Makefile.PL: set XSOPT to '-nolinenumbers' to work around xsubpp bug;
1009           you may need to comment this back out if you have an older xsubpp.
1010         - HiRes.xs: set PROTOTYPES: DISABLE
1011
1012 1.11  Fri Sep 05 16:00:00 1997
1013         - Makefile.PL:
1014           Had some line commented out that shouldn't have been (testing
1015           remnants)
1016         - README:
1017           Previous version was corrupted.
1018
1019 1.10  Thu May 22 20:20:00 1997
1020         - HiRes.xs, HiRes.pm, t/*:
1021               - only compile what we have OS support for (or can
1022                 fake with select())
1023               - only test what we compiled
1024               - gross improvement to the test suite
1025               - fix EXPORT_FAIL.
1026           This work was all done by Roderick Schertler
1027           <roderick@argon.org>. If you run Linux or
1028           one of the other ualarm-less platforms, and you like this
1029           module, let Roderick know; without him, it still wouldn't
1030           be working on those boxes...
1031         - Makefile.PL: figure out what routines the OS has and
1032           only build what we need. These bits were written by Jarkko
1033           Hietaniemi <jhi@iki.fi>. Again, gratitude is due...
1034
1035 1.02  Mon Dec 30 08:00:00 1996
1036         - HiRes.pm: update documentation to say what to do when missing
1037           ualarm() and friends.
1038         - README: update to warn that ualarm() and friends need to exist
1039
1040 1.01  Fri Oct 17 08:00:00 1996
1041         - Makefile.PL: make XSPROTOARGS => '-noprototyopes'
1042         - HiRes.pm: put blank line between __END__ and =head1 so that
1043           pod2man works.
1044
1045 1.00  Tue Sep 03 13:00:00 1996
1046         - original version; created by h2xs 1.16