Sys::SigAction::Changes - List of significant changes
Revision history for Sys::SigAction.
Responding to Bug: https://rt.cpan.org/Public/Bug/Display.html?id=105091
Renamed t/nested.t to t/inline_nested.t (don't execute this on arm platforms arm perl port appear to be at fault. See t/inline_nested.t
create new tests:
t/alternatives.t t/recursive_nested.t
Allow arm platforms, but skip t/inline_nested.t with a warning on arm platforms.
Desupport perl 5.5 (that was soooo long ago > 12 years)... This allows me to turn on use warnings everywhere: Prompted by the Kwalitee folks who noticed it was not used.
Set MIN_PERL_VERSION => 5.6.0 in Makefile.PL.
Referenced the new github repository in the generated META.* files: https://github.com/labaxter/sys-sigaction
Fix lack of interpolation in Makefile.PL for unsupported MSWin OS.
Remove erroneous note at the end of the POD related to references to this module in DBD:Oracle. In reality the reference was in DBI, and it is still there.
Close pod error bug (which referred to the above paragraph) submitted by the Debian Packaging team.
Even if Time::HiRes::ualarm() exists, it may not necessarily work. (There were way too many broken smoke tests which might have been the result of this). One reason for this may also bave been that the test was looking for too small an interval in the sub-second timeout tests. On busy systems, this may also have been causing tests to fail.
Time::HiRes::ualarm()
This version got rid of the attempt at tracking broken environments in timeout.t (the hash structure mentioned in the previous change).
The sub-second timer tests now set a timeout at 0.1 seconds, and check for a delta time that is less than 0.8 seconds. Proving that they completed in under 1 second. This provides a 0.7 second range of execution time to account for busy systems. Previous tests, only allowed for something less than 0.1 second.
Makefile.PL now looks for Time::HiRes::ualarm(), and tests it. If it works, high resolution timeouts are enabled. Makefile.PL reports what it finds, and t/timeout.t reports when high resolution tests are disabled, but timeout.t should not fail because of this... it will just run fewer tests.
Change sig_alarm() to use HiRes::ualarm() instead of HiRes::alarm(). Hoping to fix hires test failures on some platforms.
Build a hash structure in timeout.t to disable the HiRes tests on certain platforms where these functions may to be consistently broken, but disable them for at least another round, hoping that the change to using HiRes::ualarm() solves the problem.
Also, restructure timeout.t to hardcode the number of tests run. Apparently Test::More on perl 5.8.x insisteds on getting the plan before ANY tests are run.
Build similar structure in mask.t to disable the test on certain platforms were signal masking appears to be broken. Currently this is set to
my $mask_broken_platforms = { 'archname' => { 'i686-cygwin-thread-multi-64int' => 1 } ,'perlver' => { 'v5.10.1' => 1 } };
Update Makefile.PL to note the fact the HiRes timeouts may broken on some platforms.
Fix "bareword" error on some platforms at least, by explicitly importing INT_MAX from POSIX module.
Fix Changes file which listed verson 0.16 twice when it should have list version 0.17 for the more recent changes.
Fix timeout.t to use POSIX::pause() instead of select(), which was used to optimized the while ( 1 ) loop in the forever function. This caused failures on some platforms. pause() is right solution -- thanks (again) to Carsten Gaebler and for the suggestion for handling the Time::HiRes request.
More double eval documentation cleanup that had not been previously caught in the POD. (bug #79130).
When Time::HiRes is present, allow for long timeouts longer than the POSIX::INT_MAX microseconds when Time::HiRes is present. Just call call alarm() instead of ualarm() in the case where input argument would result in a msecs value in an argument to ualarm which is larger than POSIX::INT_MAX (and, of course, add a test for this in timeout.t). (bug/enhancement request #75784)
Fix typos in dbd-oracle-timeout.POD (bug #87141). It appears that the DBD:oracle module may now have internal handling for this problem (DBD::oracle not longer references Sys::SigAction).
Thanks to excellent patches from Carsten Gaebler (contact me if you want to contact him), timeout_call() now supports passing an array of arguments which it will pass to the code it executes.
Minor tweak to POD.
Clean up POD. Close bug #69057. Other minor tweaks to POD.
No functional changes. Fix for test timeout.t. Fix strict undefined symbol error in timeout.t, when Time::HiRes is not present. Not sure if constant pragma will exist in all supported perl versions, so, we just commented out the use strict in this test.
Print warning when Time::HiRes not found in Makefile.PL
Conditionally add 'LICENSE' => 'perl' to WriteMakefile() call if $ExtUtils::MakeMaker::VERSION >= 6.3002.
Added support for timeout_call() in fractional seconds expressed as a floating point number. If Time::HiRes is not loadable, then the timeout value is raised to the next high integer value with the POSIX:ceil() funtion.
Added sig_alarm(), which timeout_call uses. This is drop in replacement for alarm(). If Time::HiRes is not loadable, then the seconds argument is raised to the next high integer value with the POSIX:ceil() funtion.
Update sample code to use double evals in response
https://rt.cpan.org/Public/Bug/Display.html?id=50628
The bug author wrote:
Suppose the eval dies for some reason unrelated to the signal handling just before the alarm expires, and then the code exits the eval, and then the alarm expires before the final alarm(0) can be called. Now either the code will completely die because there is no SIGALRM handler in place to catch the signal, or the wrong handler (not the local handler) will be called.
Make the same change in timeout_call(). The change traps the remote possibility that an alarm signal could arrive between the time code dies (for some unrelated reason) and the final eval is called or called.
Remove Restriction in License which required permission to include in CDROM media for commercial distribution.
License is now Straight GPL or Artistic as Perl is.
Fix safe attribute for perl >= 5.8.2, but applying patch in (duplicate) bugs:
http://rt.cpan.org/Ticket/Display.html?id=39599 http://rt.cpan.org/Ticket/Display.html?id=39946
Test by cloning mask.t into safe.t in the block for perl => 5.008002 and test setting safe attribute. Sadly, using both masked signals and safe=>1 at the same time, is still broken.
Add checks for unsupported configurations in Makefile.PL to (hopefully) suppress the Smoke test failures for those environments.
Update documentation.
Lincoln
Documentation cleanup, thanks to Tim Maher.
Francesco has pointed out that I still have a special case of safe=>0 broken for perl 5.8.0.
The perl 5.8.1 build I tested with (I could not find 5.8.0) it turns out has .../lib/5.8.1/auto/POSIX/SigAction/safe.al, my previous tests works.
This version of Sys::SigAction now as a test of these subtleties in t/safe.t, those still no real test of safe=>1 for perls >= 5.8.2
Add extra protection to test of $attrs->(safe} when the perl version is between 5.8 and 5.8.2, thanks to Francesco Duranti. Now test for it being defined before testing it's value. It would be a pretty bizarre case for that to happen, but... belt and suspenders... is 'safe'.
Fix warning in safe.t which referred to attrs.t (old test name) which was renamed to mask.t, to refer to mask.t.
Version 0.06 broke in perl < 5.8.2... (who uses that any more!!!) Well someone does... at least on RedHat... I did (do) claim backwards compatibility... So I fixed it right this time, by checking the perl version before called the safe accessor on the POSIX::SigAction object.
Still no good test for safe mode... be prepared to send me a test if you think safe signal handling is broken... for sure I could not get it to work the way I think it should with with deferred signals.
Fix setting of SAFE flag in POSIX::sigaction. In response to CPAN bug: http://rt.cpan.org/Ticket/Display.html?id=19916 Thanks to Steve Purk?, for point this out.
This required NOT setting safe=>1 (changing to to safe=>0) in t/attrs.t and the the dbd-oracle test script.
A new test for safe=>1 needs to be developed, which explicitly tests deferred signal handling. I would welcome such a contribution.
Lincoln A Baxter
Fix typo in POD for mask => thanks to Henri Asseily This was apparently never uploaded. :-(
Modify forever() in timeout.t so just loop instead of trying to read from STDIN, which apparently does not block or immediately returns an error on some platforms or test environments
Lincoln A Baxter ck =head2 Changes in Sys::SigAction 0.03 4 April 2004
Skip attrs.t test if perl version < 5.8.2 (rt.cpan.org ticket #5948)
Rename dbd-oracle-timout.PL -> dbd-oracle-timeout.POD
Comment out 'use warnings' for $] < 5.006
Suppress undefined warning in destructor for $] < 5.008
Documentation expansion and cleanup
Add dbd-oracle-timeout.PL
original version; created by h2xs 1.22 with options:
--compat-version=5.5.0 -X --name=Sys::SigAction \ --use-new-tests --skip-warnings --version=0.01
To install Sys::SigAction, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Sys::SigAction
CPAN shell
perl -MCPAN -e shell install Sys::SigAction
For more information on module installation, please visit the detailed CPAN module installation guide.