1PERL5222DELTA(1)       Perl Programmers Reference Guide       PERL5222DELTA(1)
2
3
4

NAME

6       perl5222delta - what is new for perl v5.22.2
7

DESCRIPTION

9       This document describes differences between the 5.22.1 release and the
10       5.22.2 release.
11
12       If you are upgrading from an earlier release such as 5.22.0, first read
13       perl5221delta, which describes differences between 5.22.0 and 5.22.1.
14

Security

16   Fix out of boundary access in Win32 path handling
17       This is CVE-2015-8608.  For more information see [GH #15067]
18       <https://github.com/Perl/perl5/issues/15067>.
19
20   Fix loss of taint in "canonpath()"
21       This is CVE-2015-8607.  For more information see [GH #15084]
22       <https://github.com/Perl/perl5/issues/15084>.
23
24   Set proper umask before calling mkstemp(3)
25       In 5.22.0 perl started setting umask to 0600 before calling mkstemp(3)
26       and restoring it afterwards.  This wrongfully tells open(2) to strip
27       the owner read and write bits from the given mode before applying it,
28       rather than the intended negation of leaving only those bits in place.
29
30       Systems that use mode 0666 in mkstemp(3) (like old versions of glibc)
31       create a file with permissions 0066, leaving world read and write
32       permissions regardless of current umask.
33
34       This has been fixed by using umask 0177 instead.
35
36       [GH #15135] <https://github.com/Perl/perl5/issues/15135>
37
38   Avoid accessing uninitialized memory in Win32 "crypt()"
39       Validation that will detect both a short salt and invalid characters in
40       the salt has been added.
41
42       [GH #15091] <https://github.com/Perl/perl5/issues/15091>
43
44   Remove duplicate environment variables from "environ"
45       Previously, if an environment variable appeared more than once in
46       "environ[]", %ENV would contain the last entry for that name, while a
47       typical "getenv()" would return the first entry.  We now make sure %ENV
48       contains the same as what "getenv()" returns.
49
50       Secondly, we now remove duplicates from "environ[]", so if a setting
51       with that name is set in %ENV we won't pass an unsafe value to a child
52       process.
53
54       This is CVE-2016-2381.
55

Incompatible Changes

57       There are no changes intentionally incompatible with Perl 5.22.1.  If
58       any exist, they are bugs, and we request that you submit a report.  See
59       "Reporting Bugs" below.
60

Modules and Pragmata

62   Updated Modules and Pragmata
63       •   File::Spec has been upgraded from version 3.56 to 3.56_01.
64
65           "canonpath()" now preserves taint.  See "Fix loss of taint in
66           "canonpath()"".
67
68       •   Module::CoreList has been upgraded from version 5.20151213 to
69           5.20160429.
70
71           The version number of Digest::SHA listed for Perl 5.18.4 was wrong
72           and has been corrected.  Likewise for the version number of Config
73           in 5.18.3 and 5.18.4.  [GH #15202]
74           <https://github.com/Perl/perl5/issues/15202>
75

Documentation

77   Changes to Existing Documentation
78       perldiag
79
80       •   The explanation of the warning "unable to close filehandle %s
81           properly: %s" which can occur when doing an implicit close of a
82           filehandle has been expanded and improved.
83
84       perlfunc
85
86       •   The documentation of "hex()" has been revised to clarify valid
87           inputs.
88

Configuration and Compilation

90       •   Dtrace builds now build successfully on systems with a newer dtrace
91           that require an input object file that uses the probes in the .d
92           file.
93
94           Previously the probe would fail and cause a build failure.
95
96           [GH #13985] <https://github.com/Perl/perl5/issues/13985>
97
98Configure no longer probes for libnm by default.  Originally this
99           was the "New Math" library, but the name has been re-used by the
100           GNOME NetworkManager.
101
102           [GH #15115] <https://github.com/Perl/perl5/issues/15115>
103
104Configure now knows about gcc 5.
105
106       •   Compiling perl with -DPERL_MEM_LOG now works again.
107

Platform Support

109   Platform-Specific Notes
110       Darwin
111           Compiling perl with -Dusecbacktrace on Darwin now works again.
112
113           [GH #15245] <https://github.com/Perl/perl5/issues/15245>
114
115       OS X/Darwin
116           Builds with both -DDEBUGGING and threading enabled would fail with
117           a "panic: free from wrong pool" error when built or tested from
118           Terminal on OS X.  This was caused by perl's internal management of
119           the environment conflicting with an atfork handler using the libc
120           "setenv()" function to update the environment.
121
122           Perl now uses "setenv()"/"unsetenv()" to update the environment on
123           OS X.
124
125           [GH #14955] <https://github.com/Perl/perl5/issues/14955>
126
127       ppc64el
128           The floating point format of ppc64el (Debian naming for little-
129           endian PowerPC) is now detected correctly.
130
131       Tru64
132           A test failure in t/porting/extrefs.t has been fixed.
133

Internal Changes

135       •   An unwarranted assertion in "Perl_newATTRSUB_x()" has been removed.
136           If a stub subroutine definition with a prototype has been seen,
137           then any subsequent stub (or definition) of the same subroutine
138           with an attribute was causing an assertion failure because of a
139           null pointer.
140
141           [GH #15081] <https://github.com/Perl/perl5/issues/15081>
142

Selected Bug Fixes

144       •   Calls to the placeholder &PL_sv_yes used internally when an
145           "import()" or "unimport()" method isn't found now correctly handle
146           scalar context.  [GH #14902]
147           <https://github.com/Perl/perl5/issues/14902>
148
149       •   The "pipe()" operator would assert for "DEBUGGING" builds instead
150           of producing the correct error message.  The condition asserted on
151           is detected and reported on correctly without the assertions, so
152           the assertions were removed.  [GH #15015]
153           <https://github.com/Perl/perl5/issues/15015>
154
155       •   In some cases, failing to parse a here-doc would attempt to use
156           freed memory.  This was caused by a pointer not being restored
157           correctly.  [GH #15009]
158           <https://github.com/Perl/perl5/issues/15009>
159
160       •   Perl now reports more context when it sees an array where it
161           expects to see an operator, and avoids an assertion failure.  [GH
162           #14472] <https://github.com/Perl/perl5/issues/14472>
163
164       •   If a here-doc was found while parsing another operator, the parser
165           had already read end of file, and the here-doc was not terminated,
166           perl could produce an assertion or a segmentation fault.  This now
167           reliably complains about the unterminated here-doc.  [GH #14789]
168           <https://github.com/Perl/perl5/issues/14789>
169
170       •   Parsing beyond the end of the buffer when processing a "#line"
171           directive with no filename is now avoided.  [GH #15139]
172           <https://github.com/Perl/perl5/issues/15139>
173
174       •   Perl 5.22.0 added support for the C99 hexadecimal floating point
175           notation, but sometimes misparsed hex floats.  This has been fixed.
176           [GH #15120] <https://github.com/Perl/perl5/issues/15120>
177
178       •   Certain regex patterns involving a complemented posix class in an
179           inverted bracketed character class, and matching something else
180           optionally would improperly fail to match.  An example of one that
181           could fail is "qr/_?[^\Wbar]\x{100}/".  This has been fixed.  [GH
182           #15181] <https://github.com/Perl/perl5/issues/15181>
183
184       •   Fixed an issue with "pack()" where "pack "H"" (and "pack "h"")
185           could read past the source when given a non-utf8 source and a utf8
186           target.  [GH #14977] <https://github.com/Perl/perl5/issues/14977>
187
188       •   Fixed some cases where perl would abort due to a segmentation
189           fault, or a C-level assert.  [GH #14941]
190           <https://github.com/Perl/perl5/issues/14941> [GH #14962]
191           <https://github.com/Perl/perl5/issues/14962> [GH #14963]
192           <https://github.com/Perl/perl5/issues/14963> [GH #14997]
193           <https://github.com/Perl/perl5/issues/14997> [GH #15039]
194           <https://github.com/Perl/perl5/issues/15039> [GH #15247]
195           <https://github.com/Perl/perl5/issues/15247> [GH #15251]
196           <https://github.com/Perl/perl5/issues/15251>
197
198       •   A memory leak when setting $ENV{foo} on Darwin has been fixed.  [GH
199           #14955] <https://github.com/Perl/perl5/issues/14955>
200
201       •   Perl now correctly raises an error when trying to compile patterns
202           with unterminated character classes while there are trailing
203           backslashes.  [GH #14919]
204           <https://github.com/Perl/perl5/issues/14919>
205
206       •   "NOTHING" regops and "EXACTFU_SS" regops in "make_trie()" are now
207           handled properly.  [GH #14945]
208           <https://github.com/Perl/perl5/issues/14945>
209
210       •   Perl now only tests "semctl()" if we have everything needed to use
211           it.  In FreeBSD the "semctl()" entry point may exist, but it can be
212           disabled by policy.  [GH #15180]
213           <https://github.com/Perl/perl5/issues/15180>
214
215       •   A regression that allowed undeclared barewords as hash keys to work
216           despite strictures has been fixed.  [GH #15099]
217           <https://github.com/Perl/perl5/issues/15099>
218
219       •   As an optimization (introduced in Perl 5.20.0), "uc()", "lc()",
220           "ucfirst()" and "lcfirst()" sometimes modify their argument in-
221           place rather than returning a modified copy.  The criteria for this
222           optimization has been made stricter to avoid these functions
223           accidentally modifying in-place when they should not, which has
224           been happening in some cases, e.g. in List::Util.
225
226       •   Excessive memory usage in the compilation of some regular
227           expressions involving non-ASCII characters has been reduced.  A
228           more complete fix is forthcoming in Perl 5.24.0.
229

Acknowledgements

231       Perl 5.22.2 represents approximately 5 months of development since Perl
232       5.22.1 and contains approximately 3,000 lines of changes across 110
233       files from 24 authors.
234
235       Excluding auto-generated files, documentation and release tools, there
236       were approximately 1,500 lines of changes to 52 .pm, .t, .c and .h
237       files.
238
239       Perl continues to flourish into its third decade thanks to a vibrant
240       community of users and developers.  The following people are known to
241       have contributed the improvements that became Perl 5.22.2:
242
243       Aaron Crane, Abigail, Andreas Koenig, Aristotle Pagaltzis, Chris
244       'BinGOs' Williams, Craig A. Berry, Dagfinn Ilmari Mannsaaker, David
245       Golden, David Mitchell, H.Merijn Brand, James E Keenan, Jarkko
246       Hietaniemi, Karen Etheridge, Karl Williamson, Matthew Horsfall, Niko
247       Tyni, Ricardo Signes, Sawyer X, Stevan Little, Steve Hay, Todd Rinaldo,
248       Tony Cook, Vladimir Timofeev, Yves Orton.
249
250       The list above is almost certainly incomplete as it is automatically
251       generated from version control history.  In particular, it does not
252       include the names of the (very much appreciated) contributors who
253       reported issues to the Perl bug tracker.
254
255       Many of the changes included in this version originated in the CPAN
256       modules included in Perl's core.  We're grateful to the entire CPAN
257       community for helping Perl to flourish.
258
259       For a more complete list of all of Perl's historical contributors,
260       please see the AUTHORS file in the Perl source distribution.
261

Reporting Bugs

263       If you find what you think is a bug, you might check the articles
264       recently posted to the comp.lang.perl.misc newsgroup and the perl bug
265       database at https://rt.perl.org/ .  There may also be information at
266       http://www.perl.org/ , the Perl Home Page.
267
268       If you believe you have an unreported bug, please run the perlbug
269       program included with your release.  Be sure to trim your bug down to a
270       tiny but sufficient test case.  Your bug report, along with the output
271       of "perl -V", will be sent off to perlbug@perl.org to be analysed by
272       the Perl porting team.
273
274       If the bug you are reporting has security implications, which make it
275       inappropriate to send to a publicly archived mailing list, then please
276       send it to perl5-security-report@perl.org.  This points to a closed
277       subscription unarchived mailing list, which includes all the core
278       committers, who will be able to help assess the impact of issues,
279       figure out a resolution, and help co-ordinate the release of patches to
280       mitigate or fix the problem across all platforms on which Perl is
281       supported.  Please only use this address for security issues in the
282       Perl core, not for modules independently distributed on CPAN.
283

SEE ALSO

285       The Changes file for an explanation of how to view exhaustive details
286       on what changed.
287
288       The INSTALL file for how to build Perl.
289
290       The README file for general stuff.
291
292       The Artistic and Copying files for copyright information.
293
294
295
296perl v5.34.1                      2022-03-15                  PERL5222DELTA(1)
Impressum