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 [perl #126755]
18       <https://rt.perl.org/Ticket/Display.html?id=126755>.
19
20   Fix loss of taint in "canonpath()"
21       This is CVE-2015-8607.  For more information see [perl #126862]
22       <https://rt.perl.org/Ticket/Display.html?id=126862>.
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       [perl #127322] <https://rt.perl.org/Ticket/Display.html?id=127322>
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       [perl #126922] <https://rt.perl.org/Ticket/Display.html?id=126922>
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.  [perl #127624]
74           <https://rt.perl.org/Ticket/Display.html?id=127624>
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           [perl #122287] <https://rt.perl.org/Ticket/Display.html?id=122287>
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           [perl #127131] <https://rt.perl.org/Ticket/Display.html?id=127131>
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           [perl #127764] <https://rt.perl.org/Ticket/Display.html?id=127764>
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           [perl #126240] <https://rt.perl.org/Ticket/Display.html?id=126240>
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           [perl #126845] <https://rt.perl.org/Ticket/Display.html?id=126845>
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.  [perl #126042]
147           <https://rt.perl.org/Ticket/Display.html?id=126042>
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.  [perl #126480]
153           <https://rt.perl.org/Ticket/Display.html?id=126480>
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.  [perl #126443]
158           <https://rt.perl.org/Ticket/Display.html?id=126443>
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.  [perl
162           #123737] <https://rt.perl.org/Ticket/Display.html?id=123737>
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.  [perl #125540]
168           <https://rt.perl.org/Ticket/Display.html?id=125540>
169
170       •   Parsing beyond the end of the buffer when processing a "#line"
171           directive with no filename is now avoided.  [perl #127334]
172           <https://rt.perl.org/Ticket/Display.html?id=127334>
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           [perl #127183] <https://rt.perl.org/Ticket/Display.html?id=127183>
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.  [perl
182           #127537] <https://rt.perl.org/Ticket/Display.html?id=127537>
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.  [perl #126325]
187           <https://rt.perl.org/Ticket/Display.html?id=126325>
188
189       •   Fixed some cases where perl would abort due to a segmentation
190           fault, or a C-level assert.  [perl #126193]
191           <https://rt.perl.org/Ticket/Display.html?id=126193> [perl #126257]
192           <https://rt.perl.org/Ticket/Display.html?id=126257> [perl #126258]
193           <https://rt.perl.org/Ticket/Display.html?id=126258> [perl #126405]
194           <https://rt.perl.org/Ticket/Display.html?id=126405> [perl #126602]
195           <https://rt.perl.org/Ticket/Display.html?id=126602> [perl #127773]
196           <https://rt.perl.org/Ticket/Display.html?id=127773> [perl #127786]
197           <https://rt.perl.org/Ticket/Display.html?id=127786>
198
199       •   A memory leak when setting $ENV{foo} on Darwin has been fixed.
200           [perl #126240] <https://rt.perl.org/Ticket/Display.html?id=126240>
201
202       •   Perl now correctly raises an error when trying to compile patterns
203           with unterminated character classes while there are trailing
204           backslashes.  [perl #126141]
205           <https://rt.perl.org/Ticket/Display.html?id=126141>
206
207       •   "NOTHING" regops and "EXACTFU_SS" regops in "make_trie()" are now
208           handled properly.  [perl #126206]
209           <https://rt.perl.org/Ticket/Display.html?id=126206>
210
211       •   Perl now only tests "semctl()" if we have everything needed to use
212           it.  In FreeBSD the "semctl()" entry point may exist, but it can be
213           disabled by policy.  [perl #127533]
214           <https://rt.perl.org/Ticket/Display.html?id=127533>
215
216       •   A regression that allowed undeclared barewords as hash keys to work
217           despite strictures has been fixed.  [perl #126981]
218           <https://rt.perl.org/Ticket/Display.html?id=126981>
219
220       •   As an optimization (introduced in Perl 5.20.0), "uc()", "lc()",
221           "ucfirst()" and "lcfirst()" sometimes modify their argument in-
222           place rather than returning a modified copy.  The criteria for this
223           optimization has been made stricter to avoid these functions
224           accidentally modifying in-place when they should not, which has
225           been happening in some cases, e.g. in List::Util.
226
227       •   Excessive memory usage in the compilation of some regular
228           expressions involving non-ASCII characters has been reduced.  A
229           more complete fix is forthcoming in Perl 5.24.0.
230

Acknowledgements

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

Reporting Bugs

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

SEE ALSO

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