0 " ˆl–Ðz¾” Jn-jq@5p ¸ËÊbÑ¿Æ ƒxAo¿Ã  =encoding utf8 =head1 NAME perl5241delta - what is new for perl v5.24.1 =head1 DESCRIPTION This document describes differences between the 5.24.0 release and the 5.24.1 release. If you are upgrading from an earlier release such as 5.22.0, first read L, which describes differences between 5.22.0 and 5.24.0. =head1 Security =head2 B<-Di> switch is now required for PerlIO debugging output Previously PerlIO debugging output would be sent to the file specified by the C environment variable if perl wasn't running setuid and the B<-T> or B<-t> switches hadn't been parsed yet. If perl performed output at a point where it hadn't yet parsed its switches this could result in perl creating or overwriting the file named by C even when the B<-T> switch had been supplied. Perl now requires the B<-Di> switch to produce PerlIO debugging output. By default this is written to C, but can optionally be redirected to a file by setting the C environment variable. If perl is running setuid or the B<-T> switch was supplied C is ignored and the debugging output is sent to C as for any other B<-D> switch. =head2 Core modules and tools no longer search F<"."> for optional modules The tools and many modules supplied in core no longer search the default current directory entry in L|perlvar/@INC> for optional modules. For example, L will remove the final F<"."> from C<@INC> before trying to load L. This prevents an attacker injecting an optional module into a process run by another user where the current directory is writable by the attacker, e.g. the F directory. In most cases this removal should not cause problems, but difficulties were encountered with L, which treats every module name supplied as optional. These difficulties have not yet been resolved, so for this release there are no changes to L. We hope to have a fix for L in Perl 5.24.2. To protect your own code from this attack, either remove the default F<"."> entry from C<@INC> at the start of your script, so: #!/usr/bin/perl use strict; ... becomes: #!/usr/bin/perl BEGIN { pop @INC if $INC[-1] eq '.' } use strict; ... or for modules, remove F<"."> from a localized C<@INC>, so: my $can_foo = eval { require Foo; } becomes: my $can_foo = eval { local @INC = @INC; pop @INC if $INC[-1] eq '.'; require Foo; }; =head1 Incompatible Changes Other than the security changes above there are no changes intentionally incompatible with Perl 5.24.0. If any exist, they are bugs, and we request that you submit a report. See L below. =head1 Modules and Pragmata =head2 Updated Modules and Pragmata =over 4 =item * L has been upgraded from version 2.04 to 2.04_01. =item * L has been upgraded from version 0.42 to 0.42_01. =item * L has been upgraded from version 2.11 to 2.11_01. =item * L has been upgraded from version 1.17 to 1.17_01. =item * L has been upgraded from version 5.95 to 5.95_01. =item * L has been upgraded from version 2.80 to 2.80_01. =item * L has been upgraded from version 7.10_01 to 7.10_02. =item * L has been upgraded from version 0.48 to 0.48_01. =item * L has been upgraded from version 3.63 to 3.63_01. =item * L has been upgraded from version 0.056 to 0.056_001. =item * L has been upgraded from version 1.36 to 1.36_01. =item * The IO-Compress modules have been upgraded from version 2.069 to 2.069_001. =item * L has been upgraded from version 0.92 to 0.92_01. =item * L has been upgraded from version 2.27300 to 2.27300_01. =item * L has been upgraded from version 1.26 to 1.26_01. =item * L has been upgraded from version 0.21 to 0.21_01. =item * L has been upgraded from version 1.03 to 1.03_01.