Debian Codegraph @

upstream/debian-unstable/man1/perl5243delta.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "PERL5243DELTA 1"
58 .TH PERL5243DELTA 1 2025-11-16 "perl v5.40.1" "Perl Programmers Reference Guide"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 perl5243delta \- what is new for perl v5.24.3
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes differences between the 5.24.2 release and the 5.24.3
68 release.
69 .PP
70 If you are upgrading from an earlier release such as 5.24.1, first read
71 perl5242delta, which describes differences between 5.24.1 and 5.24.2.
72 .SH Security
73 .IX Header "Security"
74 .SS "[CVE\-2017\-12837] Heap buffer overflow in regular expression compiler"
75 .IX Subsection "[CVE-2017-12837] Heap buffer overflow in regular expression compiler"
76 Compiling certain regular expression patterns with the case-insensitive
77 modifier could cause a heap buffer overflow and crash perl. This has now been
78 fixed.
79 [GH #16021] <https://github.com/Perl/perl5/issues/16021>
80 .SS "[CVE\-2017\-12883] Buffer over-read in regular expression parser"
81 .IX Subsection "[CVE-2017-12883] Buffer over-read in regular expression parser"
82 For certain types of syntax error in a regular expression pattern, the error
83 message could either contain the contents of a random, possibly large, chunk of
84 memory, or could crash perl. This has now been fixed.
85 [GH #16025] <https://github.com/Perl/perl5/issues/16025>
86 .ie n .SS "[CVE\-2017\-12814] $ENV{$key} stack buffer overflow on Windows"
87 .el .SS "[CVE\-2017\-12814] \f(CW$ENV{$key}\fP stack buffer overflow on Windows"
88 .IX Subsection "[CVE-2017-12814] $ENV{$key} stack buffer overflow on Windows"
89 A possible stack buffer overflow in the \f(CW%ENV\fR code on Windows has been fixed
90 by removing the buffer completely since it was superfluous anyway.
91 [GH #16051] <https://github.com/Perl/perl5/issues/16051>
92 .SH "Incompatible Changes"
93 .IX Header "Incompatible Changes"
94 There are no changes intentionally incompatible with 5.24.2. If any exist,
95 they are bugs, and we request that you submit a report. See "Reporting
96 Bugs" below.
97 .SH "Modules and Pragmata"
98 .IX Header "Modules and Pragmata"
99 .SS "Updated Modules and Pragmata"
100 .IX Subsection "Updated Modules and Pragmata"
101 .IP \(bu 4
102 Module::CoreList has been upgraded from version 5.20170715_24 to
103 5.20170922_24.
104 .IP \(bu 4
105 POSIX has been upgraded from version 1.65 to 1.65_01.
106 .IP \(bu 4
107 Time::HiRes has been upgraded from version 1.9733 to 1.9741.
108 .Sp
109 [GH #15396] <https://github.com/Perl/perl5/issues/15396>
110 [GH #15401] <https://github.com/Perl/perl5/issues/15401>
111 [GH #15524] <https://github.com/Perl/perl5/issues/15524>
112 [cpan #120032] <https://rt.cpan.org/Public/Bug/Display.html?id=120032>
113 .SH "Configuration and Compilation"
114 .IX Header "Configuration and Compilation"
115 .IP \(bu 4
116 When building with GCC 6 and link-time optimization (the \fB\-flto\fR option to
117 \&\fBgcc\fR), \fIConfigure\fR was treating all probed symbols as present on the system,
118 regardless of whether they actually exist. This has been fixed.
119 [GH #15322] <https://github.com/Perl/perl5/issues/15322>
120 .IP \(bu 4
121 \&\fIConfigure\fR now aborts if both \f(CW\*(C`\-Duselongdouble\*(C'\fR and \f(CW\*(C`\-Dusequadmath\*(C'\fR are
122 requested.
123 [GH #14944] <https://github.com/Perl/perl5/issues/14944>
124 .IP \(bu 4
125 Fixed a bug in which \fIConfigure\fR could append \f(CW\*(C`\-quadmath\*(C'\fR to the archname
126 even if it was already present.
127 [GH #15423] <https://github.com/Perl/perl5/issues/15423>
128 .IP \(bu 4
129 Clang builds with \f(CW\*(C`\-DPERL_GLOBAL_STRUCT\*(C'\fR or \f(CW\*(C`\-DPERL_GLOBAL_STRUCT_PRIVATE\*(C'\fR
130 have been fixed (by disabling Thread Safety Analysis for these configurations).
131 .SH "Platform Support"
132 .IX Header "Platform Support"
133 .SS "Platform-Specific Notes"
134 .IX Subsection "Platform-Specific Notes"
135 .IP VMS 4
136 .IX Item "VMS"
137 .RS 4
138 .PD 0
139 .IP \(bu 4
140 .PD
141 \&\f(CW\*(C`configure.com\*(C'\fR now recognizes the VSI-branded C compiler.
142 .RE
143 .RS 4
144 .RE
145 .IP Windows 4
146 .IX Item "Windows"
147 .RS 4
148 .PD 0
149 .IP \(bu 4
150 .PD
151 Building XS modules with GCC 6 in a 64\-bit build of Perl failed due to
152 incorrect mapping of \f(CW\*(C`strtoll\*(C'\fR and \f(CW\*(C`strtoull\*(C'\fR. This has now been fixed.
153 [GH #16074] <https://github.com/Perl/perl5/issues/16074>
154 [cpan #121683] <https://rt.cpan.org/Public/Bug/Display.html?id=121683>
155 [cpan #122353] <https://rt.cpan.org/Public/Bug/Display.html?id=122353>
156 .RE
157 .RS 4
158 .RE
159 .SH "Selected Bug Fixes"
160 .IX Header "Selected Bug Fixes"
161 .IP \(bu 4
162 \&\f(CW\*(C`/@0{0*\->@*/*0\*(C'\fR and similar contortions used to crash, but no longer
163 do, but merely produce a syntax error.
164 [GH #15333] <https://github.com/Perl/perl5/issues/15333>
165 .IP \(bu 4
166 \&\f(CW\*(C`do\*(C'\fR or \f(CW\*(C`require\*(C'\fR with an argument which is a reference or typeglob which,
167 when stringified, contains a null character, started crashing in Perl 5.20, but
168 has now been fixed.
169 [GH #15337] <https://github.com/Perl/perl5/issues/15337>
170 .IP \(bu 4
171 Expressions containing an \f(CW\*(C`&&\*(C'\fR or \f(CW\*(C`||\*(C'\fR operator (or their synonyms \f(CW\*(C`and\*(C'\fR and
172 \&\f(CW\*(C`or\*(C'\fR) were being compiled incorrectly in some cases. If the left-hand side
173 consisted of either a negated bareword constant or a negated \f(CW\*(C`do {}\*(C'\fR block
174 containing a constant expression, and the right-hand side consisted of a
175 negated non-foldable expression, one of the negations was effectively ignored.
176 The same was true of \f(CW\*(C`if\*(C'\fR and \f(CW\*(C`unless\*(C'\fR statement modifiers, though with the
177 left-hand and right-hand sides swapped. This long-standing bug has now been
178 fixed.
179 [GH #15285] <https://github.com/Perl/perl5/issues/15285>
180 .IP \(bu 4
181 \&\f(CW\*(C`reset\*(C'\fR with an argument no longer crashes when encountering stash entries
182 other than globs.
183 [GH #15314] <https://github.com/Perl/perl5/issues/15314>
184 .IP \(bu 4
185 Assignment of hashes to, and deletion of, typeglobs named \f(CW*::::::\fR no longer
186 causes crashes.
187 [GH #15307] <https://github.com/Perl/perl5/issues/15307>
188 .IP \(bu 4
189 Assignment variants of any bitwise ops under the \f(CW\*(C`bitwise\*(C'\fR feature would crash
190 if the left-hand side was an array or hash.
191 [GH #15346] <https://github.com/Perl/perl5/issues/15346>
192 .IP \(bu 4
193 \&\f(CW\*(C`socket\*(C'\fR now leaves the error code returned by the system in \f(CW$!\fR on failure.
194 [GH #15383] <https://github.com/Perl/perl5/issues/15383>
195 .IP \(bu 4
196 Parsing bad POSIX charclasses no longer leaks memory.
197 [GH #15382] <https://github.com/Perl/perl5/issues/15382>
198 .IP \(bu 4
199 Since Perl 5.20, line numbers have been off by one when perl is invoked with
200 the \fB\-x\fR switch. This has been fixed.
201 [GH #15413] <https://github.com/Perl/perl5/issues/15413>
202 .IP \(bu 4
203 Some obscure cases of subroutines and file handles being freed at the same time
204 could result in crashes, but have been fixed. The crash was introduced in Perl
205 5.22.
206 [GH #15435] <https://github.com/Perl/perl5/issues/15435>
207 .IP \(bu 4
208 Some regular expression parsing glitches could lead to assertion failures with
209 regular expressions such as \f(CW\*(C`/(?<=/\*(C'\fR and \f(CW\*(C`/(?<!/\*(C'\fR. This has now been
210 fixed.
211 [GH #15332] <https://github.com/Perl/perl5/issues/15332>
212 .IP \(bu 4
213 \&\f(CW\*(C`gethostent\*(C'\fR and similar functions now perform a null check internally, to
214 avoid crashing with the torsocks library. This was a regression from Perl
215 5.22.
216 [GH #15478] <https://github.com/Perl/perl5/issues/15478>
217 .IP \(bu 4
218 Mentioning the same constant twice in a row (which is a syntax error) no longer
219 fails an assertion under debugging builds. This was a regression from Perl
220 5.20.
221 [GH #15017] <https://github.com/Perl/perl5/issues/15017>
222 .IP \(bu 4
223 In Perl 5.24 \f(CW\*(C`fchown\*(C'\fR was changed not to accept negative one as an argument
224 because in some platforms that is an error. However, in some other platforms
225 that is an acceptable argument. This change has been reverted.
226 [GH #15523] <https://github.com/Perl/perl5/issues/15523>.
227 .IP \(bu 4
228 \&\f(CW\*(C`@{x\*(C'\fR followed by a newline where \f(CW"x"\fR represents a control or non-ASCII
229 character no longer produces a garbled syntax error message or a crash.
230 [GH #15518] <https://github.com/Perl/perl5/issues/15518>
231 .IP \(bu 4
232 A regression in Perl 5.24 with \f(CW\*(C`tr/\eN{U+...}/foo/\*(C'\fR when the code point was
233 between 128 and 255 has been fixed.
234 [GH #15475] <https://github.com/Perl/perl5/issues/15475>.
235 .IP \(bu 4
236 Many issues relating to \f(CW\*(C`printf "%a"\*(C'\fR of hexadecimal floating point were
237 fixed. In addition, the "subnormals" (formerly known as "denormals") floating
238 point numbers are now supported both with the plain IEEE 754 floating point
239 numbers (64\-bit or 128\-bit) and the x86 80\-bit "extended precision". Note that
240 subnormal hexadecimal floating point literals will give a warning about
241 "exponent underflow".
242 [GH #15495] <https://github.com/Perl/perl5/issues/15495>
243 [GH #15502] <https://github.com/Perl/perl5/issues/15502>
244 [GH #15503] <https://github.com/Perl/perl5/issues/15503>
245 [GH #15504] <https://github.com/Perl/perl5/issues/15504>
246 [GH #15505] <https://github.com/Perl/perl5/issues/15505>
247 [GH #15510] <https://github.com/Perl/perl5/issues/15510>
248 [GH #15512] <https://github.com/Perl/perl5/issues/15512>
249 .IP \(bu 4
250 The parser could sometimes crash if a bareword came after \f(CW\*(C`evalbytes\*(C'\fR.
251 [GH #15586] <https://github.com/Perl/perl5/issues/15586>
252 .IP \(bu 4
253 Fixed a place where the regex parser was not setting the syntax error correctly
254 on a syntactically incorrect pattern.
255 [GH #15565] <https://github.com/Perl/perl5/issues/15565>
256 .IP \(bu 4
257 A vulnerability in Perl's \f(CW\*(C`sprintf\*(C'\fR implementation has been fixed by avoiding
258 a possible memory wrap.
259 [GH #15970] <https://github.com/Perl/perl5/issues/15970>
260 .SH Acknowledgements
261 .IX Header "Acknowledgements"
262 Perl 5.24.3 represents approximately 2 months of development since Perl 5.24.2
263 and contains approximately 3,200 lines of changes across 120 files from 23
264 authors.
265 .PP
266 Excluding auto-generated files, documentation and release tools, there were
267 approximately 1,600 lines of changes to 56 .pm, .t, .c and .h files.
268 .PP
269 Perl continues to flourish into its third decade thanks to a vibrant community
270 of users and developers. The following people are known to have contributed
271 the improvements that became Perl 5.24.3:
272 .PP
273 Aaron Crane, Craig A. Berry, Dagfinn Ilmari Mannsåker, Dan Collins, Daniel
274 Dragan, Dave Cross, David Mitchell, Eric Herman, Father Chrysostomos, H.Merijn
275 Brand, Hugo van der Sanden, James E Keenan, Jarkko Hietaniemi, John SJ
276 Anderson, Karl Williamson, Ken Brown, Lukas Mai, Matthew Horsfall, Stevan
277 Little, Steve Hay, Steven Humphrey, Tony Cook, Yves Orton.
278 .PP
279 The list above is almost certainly incomplete as it is automatically generated
280 from version control history. In particular, it does not include the names of
281 the (very much appreciated) contributors who reported issues to the Perl bug
282 tracker.
283 .PP
284 Many of the changes included in this version originated in the CPAN modules
285 included in Perl's core. We're grateful to the entire CPAN community for
286 helping Perl to flourish.
287 .PP
288 For a more complete list of all of Perl's historical contributors, please see
289 the \fIAUTHORS\fR file in the Perl source distribution.
290 .SH "Reporting Bugs"
291 .IX Header "Reporting Bugs"
292 If you find what you think is a bug, you might check the articles recently
293 posted to the comp.lang.perl.misc newsgroup and the perl bug database at
294 <https://rt.perl.org/> . There may also be information at
295 <http://www.perl.org/> , the Perl Home Page.
296 .PP
297 If you believe you have an unreported bug, please run the perlbug program
298 included with your release. Be sure to trim your bug down to a tiny but
299 sufficient test case. Your bug report, along with the output of \f(CW\*(C`perl \-V\*(C'\fR,
300 will be sent off to [email protected] to be analysed by the Perl porting team.
301 .PP
302 If the bug you are reporting has security implications which make it
303 inappropriate to send to a publicly archived mailing list, then see
304 "SECURITY VULNERABILITY CONTACT INFORMATION" in perlsec for details of how to
305 report the issue.
306 .SH "SEE ALSO"
307 .IX Header "SEE ALSO"
308 The \fIChanges\fR file for an explanation of how to view exhaustive details on
309 what changed.
310 .PP
311 The \fIINSTALL\fR file for how to build Perl.
312 .PP
313 The \fIREADME\fR file for general stuff.
314 .PP
315 The \fIArtistic\fR and \fICopying\fR files for copyright information.