1PERL5222DELTA(1) Perl Programmers Reference Guide PERL5222DELTA(1)
2
3
4
6 perl5222delta - what is new for perl v5.22.2
7
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
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
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
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
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
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
98 • Configure 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
104 • Configure now knows about gcc 5.
105
106 • Compiling perl with -DPERL_MEM_LOG now works again.
107
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
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
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
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
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
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)