| 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 "PERLDIAG 1" |
| 58 |
.TH PERLDIAG 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 |
perldiag \- various Perl diagnostics |
| 65 |
.SH DESCRIPTION |
| 66 |
.IX Header "DESCRIPTION" |
| 67 |
These messages are classified as follows (listed in increasing order of |
| 68 |
desperation): |
| 69 |
.PP |
| 70 |
.Vb 7 |
| 71 |
\& (W) A warning (optional). |
| 72 |
\& (D) A deprecation (enabled by default). |
| 73 |
\& (S) A severe warning (enabled by default). |
| 74 |
\& (F) A fatal error (trappable). |
| 75 |
\& (P) An internal error you should never see (trappable). |
| 76 |
\& (X) A very fatal error (nontrappable). |
| 77 |
\& (A) An alien error message (not generated by Perl). |
| 78 |
.Ve |
| 79 |
.PP |
| 80 |
The majority of messages from the first three classifications above |
| 81 |
(W, D & S) can be controlled using the \f(CW\*(C`warnings\*(C'\fR pragma. |
| 82 |
.PP |
| 83 |
If a message can be controlled by the \f(CW\*(C`warnings\*(C'\fR pragma, its warning |
| 84 |
category is included with the classification letter in the description |
| 85 |
below. E.g. \f(CW\*(C`(W closed)\*(C'\fR means a warning in the \f(CW\*(C`closed\*(C'\fR category. |
| 86 |
.PP |
| 87 |
Optional warnings are enabled by using the \f(CW\*(C`warnings\*(C'\fR pragma or the \fB\-w\fR |
| 88 |
and \fB\-W\fR switches. Warnings may be captured by setting \f(CW$SIG{_\|_WARN_\|_}\fR |
| 89 |
to a reference to a routine that will be called on each warning instead |
| 90 |
of printing it. See perlvar. |
| 91 |
.PP |
| 92 |
Severe warnings are always enabled, unless they are explicitly disabled |
| 93 |
with the \f(CW\*(C`warnings\*(C'\fR pragma or the \fB\-X\fR switch. |
| 94 |
.PP |
| 95 |
Trappable errors may be trapped using the eval operator. See |
| 96 |
"eval" in perlfunc. In almost all cases, warnings may be selectively |
| 97 |
disabled or promoted to fatal errors using the \f(CW\*(C`warnings\*(C'\fR pragma. |
| 98 |
See warnings. |
| 99 |
.PP |
| 100 |
The messages are in alphabetical order, without regard to upper or |
| 101 |
lower-case. Some of these messages are generic. Spots that vary are |
| 102 |
denoted with a \f(CW%s\fR or other printf-style escape. These escapes are |
| 103 |
ignored by the alphabetical order, as are all characters other than |
| 104 |
letters. To look up your message, just ignore anything that is not a |
| 105 |
letter. |
| 106 |
.ie n .IP "\fBaccept()\fR on closed socket %s" 4 |
| 107 |
.el .IP "\fBaccept()\fR on closed socket \f(CW%s\fR" 4 |
| 108 |
.IX Item "accept() on closed socket %s" |
| 109 |
(W closed) You tried to do an accept on a closed socket. Did you forget |
| 110 |
to check the return value of your \fBsocket()\fR call? See |
| 111 |
"accept" in perlfunc. |
| 112 |
.IP "ADJUST is experimental" 4 |
| 113 |
.IX Item "ADJUST is experimental" |
| 114 |
(S experimental::class) This warning is emitted if you use the \f(CW\*(C`ADJUST\*(C'\fR |
| 115 |
keyword of \f(CW\*(C`use feature \*(Aqclass\*(Aq\*(C'\fR. This keyword is currently |
| 116 |
experimental and its behaviour may change in future releases of Perl. |
| 117 |
.IP "Aliasing via reference is experimental" 4 |
| 118 |
.IX Item "Aliasing via reference is experimental" |
| 119 |
(S experimental::refaliasing) This warning is emitted if you use |
| 120 |
a reference constructor on the left-hand side of an assignment to |
| 121 |
alias one variable to another. Simply suppress the warning if you |
| 122 |
want to use the feature, but know that in doing so you are taking |
| 123 |
the risk of using an experimental feature which may change or be |
| 124 |
removed in a future Perl version: |
| 125 |
.Sp |
| 126 |
.Vb 3 |
| 127 |
\& no warnings "experimental::refaliasing"; |
| 128 |
\& use feature "refaliasing"; |
| 129 |
\& \e$x = \e$y; |
| 130 |
.Ve |
| 131 |
.ie n .IP "'%c' allowed only after types %s in %s" 4 |
| 132 |
.el .IP "'%c' allowed only after types \f(CW%s\fR in \f(CW%s\fR" 4 |
| 133 |
.IX Item "'%c' allowed only after types %s in %s" |
| 134 |
(F) The modifiers '!', '<' and '>' are allowed in \fBpack()\fR or \fBunpack()\fR only |
| 135 |
after certain types. See "pack" in perlfunc. |
| 136 |
.IP "alpha\->\fBnumify()\fR is lossy" 4 |
| 137 |
.IX Item "alpha->numify() is lossy" |
| 138 |
(W numeric) An alpha version can not be numified without losing |
| 139 |
information. |
| 140 |
.IP "Ambiguous call resolved as CORE::%s(), qualify as such or use &" 4 |
| 141 |
.IX Item "Ambiguous call resolved as CORE::%s(), qualify as such or use &" |
| 142 |
(W ambiguous) A subroutine you have declared has the same name as a Perl |
| 143 |
keyword, and you have used the name without qualification for calling |
| 144 |
one or the other. Perl decided to call the builtin because the |
| 145 |
subroutine is not imported. |
| 146 |
.Sp |
| 147 |
To force interpretation as a subroutine call, either put an ampersand |
| 148 |
before the subroutine name, or qualify the name with its package. |
| 149 |
Alternatively, you can import the subroutine (or pretend that it's |
| 150 |
imported with the \f(CW\*(C`use subs\*(C'\fR pragma). |
| 151 |
.Sp |
| 152 |
To silently interpret it as the Perl operator, use the \f(CW\*(C`CORE::\*(C'\fR prefix |
| 153 |
on the operator (e.g. \f(CWCORE::log($x)\fR) or declare the subroutine |
| 154 |
to be an object method (see "Subroutine Attributes" in perlsub or |
| 155 |
attributes). |
| 156 |
.IP "Ambiguous range in transliteration operator" 4 |
| 157 |
.IX Item "Ambiguous range in transliteration operator" |
| 158 |
(F) You wrote something like \f(CW\*(C`tr/a\-z\-0//\*(C'\fR which doesn't mean anything at |
| 159 |
all. To include a \f(CW\*(C`\-\*(C'\fR character in a transliteration, put it either |
| 160 |
first or last. (In the past, \f(CW\*(C`tr/a\-z\-0//\*(C'\fR was synonymous with |
| 161 |
\&\f(CW\*(C`tr/a\-y//\*(C'\fR, which was probably not what you would have expected.) |
| 162 |
.ie n .IP "Ambiguous use of %s resolved as %s" 4 |
| 163 |
.el .IP "Ambiguous use of \f(CW%s\fR resolved as \f(CW%s\fR" 4 |
| 164 |
.IX Item "Ambiguous use of %s resolved as %s" |
| 165 |
(S ambiguous) You said something that may not be interpreted the way |
| 166 |
you thought. Normally it's pretty easy to disambiguate it by supplying |
| 167 |
a missing quote, operator, parenthesis pair or declaration. |
| 168 |
.IP "Ambiguous use of \-%s resolved as \-&%s()" 4 |
| 169 |
.IX Item "Ambiguous use of -%s resolved as -&%s()" |
| 170 |
(S ambiguous) You wrote something like \f(CW\*(C`\-foo\*(C'\fR, which might be the |
| 171 |
string \f(CW"\-foo"\fR, or a call to the function \f(CW\*(C`foo\*(C'\fR, negated. If you meant |
| 172 |
the string, just write \f(CW"\-foo"\fR. If you meant the function call, |
| 173 |
write \f(CW\*(C`\-foo()\*(C'\fR. |
| 174 |
.ie n .IP "Ambiguous use of %c resolved as operator %c" 4 |
| 175 |
.el .IP "Ambiguous use of \f(CW%c\fR resolved as operator \f(CW%c\fR" 4 |
| 176 |
.IX Item "Ambiguous use of %c resolved as operator %c" |
| 177 |
(S ambiguous) \f(CW\*(C`%\*(C'\fR, \f(CW\*(C`&\*(C'\fR, and \f(CW\*(C`*\*(C'\fR are both infix operators (modulus, |
| 178 |
bitwise and, and multiplication) \fIand\fR initial special characters |
| 179 |
(denoting hashes, subroutines and typeglobs), and you said something |
| 180 |
like \f(CW\*(C`*foo * foo\*(C'\fR that might be interpreted as either of them. We |
| 181 |
assumed you meant the infix operator, but please try to make it more |
| 182 |
clear \-\- in the example given, you might write \f(CW\*(C`*foo * foo()\*(C'\fR if you |
| 183 |
really meant to multiply a glob by the result of calling a function. |
| 184 |
.ie n .IP "Ambiguous use of %c{%s} resolved to %c%s" 4 |
| 185 |
.el .IP "Ambiguous use of \f(CW%c\fR{%s} resolved to \f(CW%c\fR%s" 4 |
| 186 |
.IX Item "Ambiguous use of %c{%s} resolved to %c%s" |
| 187 |
(W ambiguous) You wrote something like \f(CW\*(C`@{foo}\*(C'\fR, which might be |
| 188 |
asking for the variable \f(CW@foo\fR, or it might be calling a function |
| 189 |
named foo, and dereferencing it as an array reference. If you wanted |
| 190 |
the variable, you can just write \f(CW@foo\fR. If you wanted to call the |
| 191 |
function, write \f(CW\*(C`@{foo()}\*(C'\fR ... or you could just not have a variable |
| 192 |
and a function with the same name, and save yourself a lot of trouble. |
| 193 |
.ie n .IP "Ambiguous use of %c{%s[...]} resolved to %c%s[...]" 4 |
| 194 |
.el .IP "Ambiguous use of \f(CW%c\fR{%s[...]} resolved to \f(CW%c\fR%s[...]" 4 |
| 195 |
.IX Item "Ambiguous use of %c{%s[...]} resolved to %c%s[...]" |
| 196 |
.PD 0 |
| 197 |
.ie n .IP "Ambiguous use of %c{%s{...}} resolved to %c%s{...}" 4 |
| 198 |
.el .IP "Ambiguous use of \f(CW%c\fR{%s{...}} resolved to \f(CW%c\fR%s{...}" 4 |
| 199 |
.IX Item "Ambiguous use of %c{%s{...}} resolved to %c%s{...}" |
| 200 |
.PD |
| 201 |
(W ambiguous) You wrote something like \f(CW\*(C`${foo[2]}\*(C'\fR (where foo represents |
| 202 |
the name of a Perl keyword), which might be looking for element number |
| 203 |
2 of the array named \f(CW@foo\fR, in which case please write \f(CW$foo[2]\fR, or you |
| 204 |
might have meant to pass an anonymous arrayref to the function named |
| 205 |
foo, and then do a scalar deref on the value it returns. If you meant |
| 206 |
that, write \f(CW\*(C`${foo([2])}\*(C'\fR. |
| 207 |
.Sp |
| 208 |
In regular expressions, the \f(CW\*(C`${foo[2]}\*(C'\fR syntax is sometimes necessary |
| 209 |
to disambiguate between array subscripts and character classes. |
| 210 |
\&\f(CW\*(C`/$length[2345]/\*(C'\fR, for instance, will be interpreted as \f(CW$length\fR followed |
| 211 |
by the character class \f(CW\*(C`[2345]\*(C'\fR. If an array subscript is what you |
| 212 |
want, you can avoid the warning by changing \f(CW\*(C`/${length[2345]}/\*(C'\fR to the |
| 213 |
unsightly \f(CW\*(C`/${\e$length[2345]}/\*(C'\fR, by renaming your array to something |
| 214 |
that does not coincide with a built-in keyword, or by simply turning |
| 215 |
off warnings with \f(CW\*(C`no warnings \*(Aqambiguous\*(Aq;\*(C'\fR. |
| 216 |
.IP "'|' and '<' may not both be specified on command line" 4 |
| 217 |
.IX Item "'|' and '<' may not both be specified on command line" |
| 218 |
(F) An error peculiar to VMS. Perl does its own command line |
| 219 |
redirection, and found that STDIN was a pipe, and that you also tried to |
| 220 |
redirect STDIN using '<'. Only one STDIN stream to a customer, please. |
| 221 |
.IP "'|' and '>' may not both be specified on command line" 4 |
| 222 |
.IX Item "'|' and '>' may not both be specified on command line" |
| 223 |
(F) An error peculiar to VMS. Perl does its own command line |
| 224 |
redirection, and thinks you tried to redirect stdout both to a file and |
| 225 |
into a pipe to another command. You need to choose one or the other, |
| 226 |
though nothing's stopping you from piping into a program or Perl script |
| 227 |
which 'splits' output into two streams, such as |
| 228 |
.Sp |
| 229 |
.Vb 6 |
| 230 |
\& open(OUT,">$ARGV[0]") or die "Can\*(Aqt write to $ARGV[0]: $!"; |
| 231 |
\& while (<STDIN>) { |
| 232 |
\& print; |
| 233 |
\& print OUT; |
| 234 |
\& } |
| 235 |
\& close OUT; |
| 236 |
.Ve |
| 237 |
.ie n .IP "Applying %s to %s will act on scalar(%s)" 4 |
| 238 |
.el .IP "Applying \f(CW%s\fR to \f(CW%s\fR will act on scalar(%s)" 4 |
| 239 |
.IX Item "Applying %s to %s will act on scalar(%s)" |
| 240 |
(W misc) The pattern match (\f(CW\*(C`//\*(C'\fR), substitution (\f(CW\*(C`s///\*(C'\fR), and |
| 241 |
transliteration (\f(CW\*(C`tr///\*(C'\fR) operators work on scalar values. If you apply |
| 242 |
one of them to an array or a hash, it will convert the array or hash to |
| 243 |
a scalar value (the length of an array, or the population info of a |
| 244 |
hash) and then work on that scalar value. This is probably not what |
| 245 |
you meant to do. See "grep" in perlfunc and "map" in perlfunc for |
| 246 |
alternatives. |
| 247 |
.IP "Arg too short for msgsnd" 4 |
| 248 |
.IX Item "Arg too short for msgsnd" |
| 249 |
(F) \fBmsgsnd()\fR requires a string at least as long as sizeof(long). |
| 250 |
.IP "Argument ""%s"" isn't numeric%s" 4 |
| 251 |
.IX Item "Argument ""%s"" isn't numeric%s" |
| 252 |
(W numeric) The indicated string was fed as an argument to an operator |
| 253 |
that expected a numeric value instead. If you're fortunate the message |
| 254 |
will identify which operator was so unfortunate. |
| 255 |
.Sp |
| 256 |
Note that for the \f(CW\*(C`Inf\*(C'\fR and \f(CW\*(C`NaN\*(C'\fR (infinity and not-a-number) the |
| 257 |
definition of "numeric" is somewhat unusual: the strings themselves |
| 258 |
(like "Inf") are considered numeric, and anything following them is |
| 259 |
considered non-numeric. |
| 260 |
.IP "Argument list not closed for PerlIO layer ""%s""" 4 |
| 261 |
.IX Item "Argument list not closed for PerlIO layer ""%s""" |
| 262 |
(W layer) When pushing a layer with arguments onto the Perl I/O |
| 263 |
system you forgot the ) that closes the argument list. (Layers |
| 264 |
take care of transforming data between external and internal |
| 265 |
representations.) Perl stopped parsing the layer list at this |
| 266 |
point and did not attempt to push this layer. If your program |
| 267 |
didn't explicitly request the failing operation, it may be the |
| 268 |
result of the value of the environment variable PERLIO. |
| 269 |
.IP "Argument ""%s"" treated as 0 in increment (++)" 4 |
| 270 |
.IX Item "Argument ""%s"" treated as 0 in increment (++)" |
| 271 |
(W numeric) The indicated string was fed as an argument to the \f(CW\*(C`++\*(C'\fR |
| 272 |
operator which expects either a number or a string matching |
| 273 |
\&\f(CW\*(C`/^[a\-zA\-Z]*[0\-9]*\ez/\*(C'\fR. See "Auto-increment and |
| 274 |
Auto-decrement" in perlop for details. |
| 275 |
.IP "Array passed to stat will be coerced to a scalar%s" 4 |
| 276 |
.IX Item "Array passed to stat will be coerced to a scalar%s" |
| 277 |
(W syntax) You called \fBstat()\fR on an array, but the array will be |
| 278 |
coerced to a scalar \- the number of elements in the array. |
| 279 |
.IP "A signature parameter must start with '$', '@' or '%'" 4 |
| 280 |
.IX Item "A signature parameter must start with '$', '@' or '%'" |
| 281 |
(F) Each subroutine signature parameter declaration must start with a valid |
| 282 |
sigil; for example: |
| 283 |
.Sp |
| 284 |
.Vb 1 |
| 285 |
\& sub foo ($x, $, $y = 1, @z) {} |
| 286 |
.Ve |
| 287 |
.IP "A slurpy parameter may not have a default value" 4 |
| 288 |
.IX Item "A slurpy parameter may not have a default value" |
| 289 |
(F) Only scalar subroutine signature parameters may have a default value; |
| 290 |
for example: |
| 291 |
.Sp |
| 292 |
.Vb 3 |
| 293 |
\& sub foo ($x = 1) {} # legal |
| 294 |
\& sub foo (@x = (1)) {} # invalid |
| 295 |
\& sub foo (%x = (a => b)) {} # invalid |
| 296 |
.Ve |
| 297 |
.ie n .IP "assertion botched: %s" 4 |
| 298 |
.el .IP "assertion botched: \f(CW%s\fR" 4 |
| 299 |
.IX Item "assertion botched: %s" |
| 300 |
(X) The malloc package that comes with Perl had an internal failure. |
| 301 |
.ie n .IP "Assertion %s failed: file ""%s"", line %d" 4 |
| 302 |
.el .IP "Assertion \f(CW%s\fR failed: file ""%s"", line \f(CW%d\fR" 4 |
| 303 |
.IX Item "Assertion %s failed: file ""%s"", line %d" |
| 304 |
(X) A general assertion failed. The file in question must be examined. |
| 305 |
.IP "Assigned value is not a reference" 4 |
| 306 |
.IX Item "Assigned value is not a reference" |
| 307 |
(F) You tried to assign something that was not a reference to an lvalue |
| 308 |
reference (e.g., \f(CW\*(C`\e$x = $y\*(C'\fR). If you meant to make \f(CW$x\fR an alias to \f(CW$y\fR, use |
| 309 |
\&\f(CW\*(C`\e$x = \e$y\*(C'\fR. |
| 310 |
.ie n .IP "Assigned value is not %s reference" 4 |
| 311 |
.el .IP "Assigned value is not \f(CW%s\fR reference" 4 |
| 312 |
.IX Item "Assigned value is not %s reference" |
| 313 |
(F) You tried to assign a reference to a reference constructor, but the |
| 314 |
two references were not of the same type. You cannot alias a scalar to |
| 315 |
an array, or an array to a hash; the two types must match. |
| 316 |
.Sp |
| 317 |
.Vb 4 |
| 318 |
\& \e$x = \e@y; # error |
| 319 |
\& \e@x = \e%y; # error |
| 320 |
\& $y = []; |
| 321 |
\& \e$x = $y; # error; did you mean \e$y? |
| 322 |
.Ve |
| 323 |
.IP "Assigning non-zero to $[ is no longer possible" 4 |
| 324 |
.IX Item "Assigning non-zero to $[ is no longer possible" |
| 325 |
(F) When the "array_base" feature is disabled |
| 326 |
(e.g., and under \f(CW\*(C`use v5.16;\*(C'\fR, and as of Perl 5.30) |
| 327 |
the special variable \f(CW$[\fR, which is deprecated, is now a fixed zero value. |
| 328 |
.IP "Assignment to both a list and a scalar" 4 |
| 329 |
.IX Item "Assignment to both a list and a scalar" |
| 330 |
(F) If you assign to a conditional operator, the 2nd and 3rd arguments |
| 331 |
must either both be scalars or both be lists. Otherwise Perl won't |
| 332 |
know which context to supply to the right side. |
| 333 |
.ie n .IP "Assuming NOT a POSIX class since %s in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 334 |
.el .IP "Assuming NOT a POSIX class since \f(CW%s\fR in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 335 |
.IX Item "Assuming NOT a POSIX class since %s in regex; marked by <--\ HERE in m/%s/" |
| 336 |
(W regexp) You had something like these: |
| 337 |
.Sp |
| 338 |
.Vb 2 |
| 339 |
\& [[:alnum]] |
| 340 |
\& [[:digit:xyz] |
| 341 |
.Ve |
| 342 |
.Sp |
| 343 |
They look like they might have been meant to be the POSIX classes |
| 344 |
\&\f(CW\*(C`[:alnum:]\*(C'\fR or \f(CW\*(C`[:digit:]\*(C'\fR. If so, they should be written: |
| 345 |
.Sp |
| 346 |
.Vb 2 |
| 347 |
\& [[:alnum:]] |
| 348 |
\& [[:digit:]xyz] |
| 349 |
.Ve |
| 350 |
.Sp |
| 351 |
Since these aren't legal POSIX class specifications, but are legal |
| 352 |
bracketed character classes, Perl treats them as the latter. In the |
| 353 |
first example, it matches the characters \f(CW":"\fR, \f(CW"["\fR, \f(CW"a"\fR, \f(CW"l"\fR, |
| 354 |
\&\f(CW"m"\fR, \f(CW"n"\fR, and \f(CW"u"\fR. |
| 355 |
.Sp |
| 356 |
If these weren't meant to be POSIX classes, this warning message is |
| 357 |
spurious, and can be suppressed by reordering things, such as |
| 358 |
.Sp |
| 359 |
.Vb 1 |
| 360 |
\& [[al:num]] |
| 361 |
.Ve |
| 362 |
.Sp |
| 363 |
or |
| 364 |
.Sp |
| 365 |
.Vb 1 |
| 366 |
\& [[:munla]] |
| 367 |
.Ve |
| 368 |
.IP "<> at require-statement should be quotes" 4 |
| 369 |
.IX Item "<> at require-statement should be quotes" |
| 370 |
(F) You wrote \f(CW\*(C`require <file>\*(C'\fR when you should have written |
| 371 |
\&\f(CW\*(C`require \*(Aqfile\*(Aq\*(C'\fR. |
| 372 |
.IP "Attempt to access disallowed key '%s' in a restricted hash" 4 |
| 373 |
.IX Item "Attempt to access disallowed key '%s' in a restricted hash" |
| 374 |
(F) The failing code has attempted to get or set a key which is not in |
| 375 |
the current set of allowed keys of a restricted hash. |
| 376 |
.IP "Attempt to bless into a freed package" 4 |
| 377 |
.IX Item "Attempt to bless into a freed package" |
| 378 |
(F) You wrote \f(CW\*(C`bless $foo\*(C'\fR with one argument after somehow causing |
| 379 |
the current package to be freed. Perl cannot figure out what to |
| 380 |
do, so it throws up its hands in despair. |
| 381 |
.IP "Attempt to bless into a class" 4 |
| 382 |
.IX Item "Attempt to bless into a class" |
| 383 |
(F) You are attempting to call \f(CW\*(C`bless\*(C'\fR with a package name that is a |
| 384 |
new-style \f(CW\*(C`class\*(C'\fR. This is not necessary, as instances created by the |
| 385 |
constructor are already in the correct class. Instances cannot be created |
| 386 |
by other means, such as \f(CW\*(C`bless\*(C'\fR. |
| 387 |
.IP "Attempt to bless into a reference" 4 |
| 388 |
.IX Item "Attempt to bless into a reference" |
| 389 |
(F) The CLASSNAME argument to the \fBbless()\fR operator is expected to be |
| 390 |
the name of the package to bless the resulting object into. You've |
| 391 |
supplied instead a reference to something: perhaps you wrote |
| 392 |
.Sp |
| 393 |
.Vb 1 |
| 394 |
\& bless $self, $proto; |
| 395 |
.Ve |
| 396 |
.Sp |
| 397 |
when you intended |
| 398 |
.Sp |
| 399 |
.Vb 1 |
| 400 |
\& bless $self, ref($proto) || $proto; |
| 401 |
.Ve |
| 402 |
.Sp |
| 403 |
If you actually want to bless into the stringified version |
| 404 |
of the reference supplied, you need to stringify it yourself, for |
| 405 |
example by: |
| 406 |
.Sp |
| 407 |
.Vb 1 |
| 408 |
\& bless $self, "$proto"; |
| 409 |
.Ve |
| 410 |
.IP "Attempt to clear deleted array" 4 |
| 411 |
.IX Item "Attempt to clear deleted array" |
| 412 |
(S debugging) An array was assigned to when it was being freed. |
| 413 |
Freed values are not supposed to be visible to Perl code. This |
| 414 |
can also happen if XS code calls \f(CW\*(C`av_clear\*(C'\fR from a custom magic |
| 415 |
callback on the array. |
| 416 |
.IP "Attempt to delete disallowed key '%s' from a restricted hash" 4 |
| 417 |
.IX Item "Attempt to delete disallowed key '%s' from a restricted hash" |
| 418 |
(F) The failing code attempted to delete from a restricted hash a key |
| 419 |
which is not in its key set. |
| 420 |
.IP "Attempt to delete readonly key '%s' from a restricted hash" 4 |
| 421 |
.IX Item "Attempt to delete readonly key '%s' from a restricted hash" |
| 422 |
(F) The failing code attempted to delete a key whose value has been |
| 423 |
declared readonly from a restricted hash. |
| 424 |
.IP "Attempt to free non-arena SV: 0x%x" 4 |
| 425 |
.IX Item "Attempt to free non-arena SV: 0x%x" |
| 426 |
(S internal) All SV objects are supposed to be allocated from arenas |
| 427 |
that will be garbage collected on exit. An SV was discovered to be |
| 428 |
outside any of those arenas. |
| 429 |
.IP "Attempt to free nonexistent shared string '%s'%s" 4 |
| 430 |
.IX Item "Attempt to free nonexistent shared string '%s'%s" |
| 431 |
(S internal) Perl maintains a reference-counted internal table of |
| 432 |
strings to optimize the storage and access of hash keys and other |
| 433 |
strings. This indicates someone tried to decrement the reference count |
| 434 |
of a string that can no longer be found in the table. |
| 435 |
.IP "Attempt to free temp prematurely: SV 0x%x" 4 |
| 436 |
.IX Item "Attempt to free temp prematurely: SV 0x%x" |
| 437 |
(S debugging) Mortalized values are supposed to be freed by the |
| 438 |
\&\fBfree_tmps()\fR routine. This indicates that something else is freeing the |
| 439 |
SV before the \fBfree_tmps()\fR routine gets a chance, which means that the |
| 440 |
\&\fBfree_tmps()\fR routine will be freeing an unreferenced scalar when it does |
| 441 |
try to free it. |
| 442 |
.IP "Attempt to free unreferenced glob pointers" 4 |
| 443 |
.IX Item "Attempt to free unreferenced glob pointers" |
| 444 |
(S internal) The reference counts got screwed up on symbol aliases. |
| 445 |
.IP "Attempt to free unreferenced scalar: SV 0x%x" 4 |
| 446 |
.IX Item "Attempt to free unreferenced scalar: SV 0x%x" |
| 447 |
(S internal) Perl went to decrement the reference count of a scalar to |
| 448 |
see if it would go to 0, and discovered that it had already gone to 0 |
| 449 |
earlier, and should have been freed, and in fact, probably was freed. |
| 450 |
This could indicate that \fBSvREFCNT_dec()\fR was called too many times, or |
| 451 |
that \fBSvREFCNT_inc()\fR was called too few times, or that the SV was |
| 452 |
mortalized when it shouldn't have been, or that memory has been |
| 453 |
corrupted. |
| 454 |
.IP "Attempt to pack pointer to temporary value" 4 |
| 455 |
.IX Item "Attempt to pack pointer to temporary value" |
| 456 |
(W pack) You tried to pass a temporary value (like the result of a |
| 457 |
function, or a computed expression) to the "p" \fBpack()\fR template. This |
| 458 |
means the result contains a pointer to a location that could become |
| 459 |
invalid anytime, even before the end of the current statement. Use |
| 460 |
literals or global values as arguments to the "p" \fBpack()\fR template to |
| 461 |
avoid this warning. |
| 462 |
.ie n .IP "Attempt to reload %s aborted." 4 |
| 463 |
.el .IP "Attempt to reload \f(CW%s\fR aborted." 4 |
| 464 |
.IX Item "Attempt to reload %s aborted." |
| 465 |
(F) You tried to load a file with \f(CW\*(C`use\*(C'\fR or \f(CW\*(C`require\*(C'\fR that failed to |
| 466 |
compile once already. Perl will not try to compile this file again |
| 467 |
unless you delete its entry from \f(CW%INC\fR. See "require" in perlfunc and |
| 468 |
"%INC" in perlvar. |
| 469 |
.IP "Attempt to set length of freed array" 4 |
| 470 |
.IX Item "Attempt to set length of freed array" |
| 471 |
(W misc) You tried to set the length of an array which has |
| 472 |
been freed. You can do this by storing a reference to the |
| 473 |
scalar representing the last index of an array and later |
| 474 |
assigning through that reference. For example |
| 475 |
.Sp |
| 476 |
.Vb 2 |
| 477 |
\& $r = do {my @a; \e$#a}; |
| 478 |
\& $$r = 503 |
| 479 |
.Ve |
| 480 |
.IP "Attempt to use reference as lvalue in substr" 4 |
| 481 |
.IX Item "Attempt to use reference as lvalue in substr" |
| 482 |
(W substr) You supplied a reference as the first argument to \fBsubstr()\fR |
| 483 |
used as an lvalue, which is pretty strange. Perhaps you forgot to |
| 484 |
dereference it first. See "substr" in perlfunc. |
| 485 |
.IP "Attribute prototype(%s) discards earlier prototype attribute in same sub" 4 |
| 486 |
.IX Item "Attribute prototype(%s) discards earlier prototype attribute in same sub" |
| 487 |
(W misc) A sub was declared as sub foo : prototype(A) : prototype(B) {}, for |
| 488 |
example. Since each sub can only have one prototype, the earlier |
| 489 |
declaration(s) are discarded while the last one is applied. |
| 490 |
.IP "av_reify called on tied array" 4 |
| 491 |
.IX Item "av_reify called on tied array" |
| 492 |
(S debugging) This indicates that something went wrong and Perl got \fIvery\fR |
| 493 |
confused about \f(CW@_\fR or \f(CW@DB::args\fR being tied. |
| 494 |
.ie n .IP "Bad arg length for %s, is %u, should be %d" 4 |
| 495 |
.el .IP "Bad arg length for \f(CW%s\fR, is \f(CW%u\fR, should be \f(CW%d\fR" 4 |
| 496 |
.IX Item "Bad arg length for %s, is %u, should be %d" |
| 497 |
(F) You passed a buffer of the wrong size to one of \fBmsgctl()\fR, \fBsemctl()\fR |
| 498 |
or \fBshmctl()\fR. In C parlance, the correct sizes are, respectively, |
| 499 |
sizeof(struct\ msqid_ds\ *), sizeof(struct\ semid_ds\ *), and |
| 500 |
sizeof(struct\ shmid_ds\ *). |
| 501 |
.IP "Bad evalled substitution pattern" 4 |
| 502 |
.IX Item "Bad evalled substitution pattern" |
| 503 |
(F) You've used the \f(CW\*(C`/e\*(C'\fR switch to evaluate the replacement for a |
| 504 |
substitution, but perl found a syntax error in the code to evaluate, |
| 505 |
most likely an unexpected right brace '}'. |
| 506 |
.ie n .IP "Bad filehandle: %s" 4 |
| 507 |
.el .IP "Bad filehandle: \f(CW%s\fR" 4 |
| 508 |
.IX Item "Bad filehandle: %s" |
| 509 |
(F) A symbol was passed to something wanting a filehandle, but the |
| 510 |
symbol has no filehandle associated with it. Perhaps you didn't do an |
| 511 |
\&\fBopen()\fR, or did it in another package. |
| 512 |
.IP "Bad \fBfree()\fR ignored" 4 |
| 513 |
.IX Item "Bad free() ignored" |
| 514 |
(S malloc) An internal routine called \fBfree()\fR on something that had never |
| 515 |
been \fBmalloc()\fRed in the first place. Mandatory, but can be disabled by |
| 516 |
setting environment variable \f(CW\*(C`PERL_BADFREE\*(C'\fR to 0. |
| 517 |
.Sp |
| 518 |
This message can be seen quite often with DB_File on systems with "hard" |
| 519 |
dynamic linking, like \f(CW\*(C`AIX\*(C'\fR and \f(CW\*(C`OS/2\*(C'\fR. It is a bug of \f(CW\*(C`Berkeley DB\*(C'\fR |
| 520 |
which is left unnoticed if \f(CW\*(C`DB\*(C'\fR uses \fIforgiving\fR system \fBmalloc()\fR. |
| 521 |
.IP "Bad infix plugin result (%zd) \- did not consume entire identifier <%s>" 4 |
| 522 |
.IX Item "Bad infix plugin result (%zd) - did not consume entire identifier <%s>" |
| 523 |
(F) A plugin using the \f(CW\*(C`PL_infix_plugin\*(C'\fR mechanism to parse an infix |
| 524 |
keyword consumed part of a named identifier operator name but did not |
| 525 |
consume all of it. This is not permitted as it leads to fragile parsing |
| 526 |
results. |
| 527 |
.IP "Badly placed ()'s" 4 |
| 528 |
.IX Item "Badly placed ()'s" |
| 529 |
(A) You've accidentally run your script through \fBcsh\fR instead |
| 530 |
of Perl. Check the #! line, or manually feed your script into |
| 531 |
Perl yourself. |
| 532 |
.ie n .IP "Bad name after %s" 4 |
| 533 |
.el .IP "Bad name after \f(CW%s\fR" 4 |
| 534 |
.IX Item "Bad name after %s" |
| 535 |
(F) You started to name a symbol by using a package prefix, and then |
| 536 |
didn't finish the symbol. In particular, you can't interpolate outside |
| 537 |
of quotes, so |
| 538 |
.Sp |
| 539 |
.Vb 2 |
| 540 |
\& $var = \*(Aqmyvar\*(Aq; |
| 541 |
\& $sym = mypack::$var; |
| 542 |
.Ve |
| 543 |
.Sp |
| 544 |
is not the same as |
| 545 |
.Sp |
| 546 |
.Vb 2 |
| 547 |
\& $var = \*(Aqmyvar\*(Aq; |
| 548 |
\& $sym = "mypack::$var"; |
| 549 |
.Ve |
| 550 |
.IP "Bad plugin affecting keyword '%s'" 4 |
| 551 |
.IX Item "Bad plugin affecting keyword '%s'" |
| 552 |
(F) An extension using the keyword plugin mechanism violated the |
| 553 |
plugin API. |
| 554 |
.IP "Bad \fBrealloc()\fR ignored" 4 |
| 555 |
.IX Item "Bad realloc() ignored" |
| 556 |
(S malloc) An internal routine called \fBrealloc()\fR on something that |
| 557 |
had never been \fBmalloc()\fRed in the first place. Mandatory, but can |
| 558 |
be disabled by setting the environment variable \f(CW\*(C`PERL_BADFREE\*(C'\fR to 1. |
| 559 |
.ie n .IP "Bad symbol for %s" 4 |
| 560 |
.el .IP "Bad symbol for \f(CW%s\fR" 4 |
| 561 |
.IX Item "Bad symbol for %s" |
| 562 |
(P) An internal request asked to add an entry of the named type to something that |
| 563 |
wasn't a symbol table entry. |
| 564 |
.IP "Bad symbol for scalar" 4 |
| 565 |
.IX Item "Bad symbol for scalar" |
| 566 |
(P) An internal request asked to add a scalar entry to something that |
| 567 |
wasn't a symbol table entry. |
| 568 |
.IP "Bareword found in conditional" 4 |
| 569 |
.IX Item "Bareword found in conditional" |
| 570 |
(W bareword) The compiler found a bareword where it expected a |
| 571 |
conditional, which often indicates that an || or && was parsed as part |
| 572 |
of the last argument of the previous construct, for example: |
| 573 |
.Sp |
| 574 |
.Vb 1 |
| 575 |
\& open FOO || die; |
| 576 |
.Ve |
| 577 |
.Sp |
| 578 |
It may also indicate a misspelled constant that has been interpreted as |
| 579 |
a bareword: |
| 580 |
.Sp |
| 581 |
.Vb 2 |
| 582 |
\& use constant TYPO => 1; |
| 583 |
\& if (TYOP) { print "foo" } |
| 584 |
.Ve |
| 585 |
.Sp |
| 586 |
The \f(CW\*(C`strict\*(C'\fR pragma is useful in avoiding such errors. |
| 587 |
.IP "Bareword in require contains ""%s""" 4 |
| 588 |
.IX Item "Bareword in require contains ""%s""" |
| 589 |
.PD 0 |
| 590 |
.IP "Bareword in require maps to disallowed filename ""%s""" 4 |
| 591 |
.IX Item "Bareword in require maps to disallowed filename ""%s""" |
| 592 |
.IP "Bareword in require maps to empty filename" 4 |
| 593 |
.IX Item "Bareword in require maps to empty filename" |
| 594 |
.PD |
| 595 |
(F) The bareword form of require has been invoked with a filename which could |
| 596 |
not have been generated by a valid bareword permitted by the parser. You |
| 597 |
shouldn't be able to get this error from Perl code, but XS code may throw it |
| 598 |
if it passes an invalid module name to \f(CW\*(C`Perl_load_module\*(C'\fR. |
| 599 |
.IP "Bareword in require must not start with a double-colon: ""%s""" 4 |
| 600 |
.IX Item "Bareword in require must not start with a double-colon: ""%s""" |
| 601 |
(F) In \f(CW\*(C`require Bare::Word\*(C'\fR, the bareword is not allowed to start with a |
| 602 |
double-colon. Write \f(CW\*(C`require ::Foo::Bar\*(C'\fR as \f(CW\*(C`require Foo::Bar\*(C'\fR instead. |
| 603 |
.IP "Bareword ""%s"" not allowed while ""strict subs"" in use" 4 |
| 604 |
.IX Item "Bareword ""%s"" not allowed while ""strict subs"" in use" |
| 605 |
(F) With "strict subs" in use, a bareword is only allowed as a |
| 606 |
subroutine identifier, in curly brackets or to the left of the "=>" |
| 607 |
symbol. Perhaps you need to predeclare a subroutine? |
| 608 |
.IP "Bareword ""%s"" refers to nonexistent package" 4 |
| 609 |
.IX Item "Bareword ""%s"" refers to nonexistent package" |
| 610 |
(W bareword) You used a qualified bareword of the form \f(CW\*(C`Foo::\*(C'\fR, but the |
| 611 |
compiler saw no other uses of that namespace before that point. Perhaps |
| 612 |
you need to predeclare a package? |
| 613 |
.IP "Bareword filehandle ""%s"" not allowed under 'no feature ""bareword_filehandles""'" 4 |
| 614 |
.IX Item "Bareword filehandle ""%s"" not allowed under 'no feature ""bareword_filehandles""'" |
| 615 |
(F) You attempted to use a bareword filehandle with the |
| 616 |
\&\f(CW\*(C`bareword_filehandles\*(C'\fR feature disabled. |
| 617 |
.Sp |
| 618 |
Only the built-in handles \f(CW\*(C`STDIN\*(C'\fR, \f(CW\*(C`STDOUT\*(C'\fR, \f(CW\*(C`STDERR\*(C'\fR, \f(CW\*(C`ARGV\*(C'\fR, |
| 619 |
\&\f(CW\*(C`ARGVOUT\*(C'\fR and \f(CW\*(C`DATA\*(C'\fR can be used with the \f(CW\*(C`bareword_filehandles\*(C'\fR |
| 620 |
feature disabled. |
| 621 |
.IP "BEGIN failed\-\-compilation aborted" 4 |
| 622 |
.IX Item "BEGIN failed--compilation aborted" |
| 623 |
(F) An untrapped exception was raised while executing a BEGIN |
| 624 |
subroutine. Compilation stops immediately and the interpreter is |
| 625 |
exited. |
| 626 |
.IP "BEGIN not safe after errors\-\-compilation aborted" 4 |
| 627 |
.IX Item "BEGIN not safe after errors--compilation aborted" |
| 628 |
(F) Perl found a \f(CW\*(C`BEGIN {}\*(C'\fR subroutine (or a \f(CW\*(C`use\*(C'\fR directive, which |
| 629 |
implies a \f(CW\*(C`BEGIN {}\*(C'\fR) after one or more compilation errors had already |
| 630 |
occurred. Since the intended environment for the \f(CW\*(C`BEGIN {}\*(C'\fR could not |
| 631 |
be guaranteed (due to the errors), and since subsequent code likely |
| 632 |
depends on its correct operation, Perl just gave up. |
| 633 |
.IP "\e%d better written as $%d" 4 |
| 634 |
.IX Item "%d better written as $%d" |
| 635 |
(W syntax) Outside of patterns, backreferences live on as variables. |
| 636 |
The use of backslashes is grandfathered on the right-hand side of a |
| 637 |
substitution, but stylistically it's better to use the variable form |
| 638 |
because other Perl programmers will expect it, and it works better if |
| 639 |
there are more than 9 backreferences. |
| 640 |
.IP "Binary number > 0b11111111111111111111111111111111 non-portable" 4 |
| 641 |
.IX Item "Binary number > 0b11111111111111111111111111111111 non-portable" |
| 642 |
(W portable) The binary number you specified is larger than 2**32\-1 |
| 643 |
(4294967295) and therefore non-portable between systems. See |
| 644 |
perlport for more on portability concerns. |
| 645 |
.ie n .IP "\fBbind()\fR on closed socket %s" 4 |
| 646 |
.el .IP "\fBbind()\fR on closed socket \f(CW%s\fR" 4 |
| 647 |
.IX Item "bind() on closed socket %s" |
| 648 |
(W closed) You tried to do a bind on a closed socket. Did you forget to |
| 649 |
check the return value of your \fBsocket()\fR call? See "bind" in perlfunc. |
| 650 |
.ie n .IP "\fBbinmode()\fR on closed filehandle %s" 4 |
| 651 |
.el .IP "\fBbinmode()\fR on closed filehandle \f(CW%s\fR" 4 |
| 652 |
.IX Item "binmode() on closed filehandle %s" |
| 653 |
(W unopened) You tried \fBbinmode()\fR on a filehandle that was never opened. |
| 654 |
Check your control flow and number of arguments. |
| 655 |
.IP "Bit vector size > 32 non-portable" 4 |
| 656 |
.IX Item "Bit vector size > 32 non-portable" |
| 657 |
(W portable) Using bit vector sizes larger than 32 is non-portable. |
| 658 |
.ie n .IP "Bizarre copy of %s" 4 |
| 659 |
.el .IP "Bizarre copy of \f(CW%s\fR" 4 |
| 660 |
.IX Item "Bizarre copy of %s" |
| 661 |
(P) Perl detected an attempt to copy an internal value that is not |
| 662 |
copiable. |
| 663 |
.IP "Bizarre SvTYPE [%d]" 4 |
| 664 |
.IX Item "Bizarre SvTYPE [%d]" |
| 665 |
(P) When starting a new thread or returning values from a thread, Perl |
| 666 |
encountered an invalid data type. |
| 667 |
.IP "Both or neither range ends should be Unicode in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 668 |
.IX Item "Both or neither range ends should be Unicode in regex; marked by <--\ HERE in m/%s/" |
| 669 |
(W regexp) (only under \f(CW\*(C`use\ re\ \*(Aqstrict\*(Aq\*(C'\fR or within \f(CW\*(C`(?[...])\*(C'\fR) |
| 670 |
.Sp |
| 671 |
In a bracketed character class in a regular expression pattern, you |
| 672 |
had a range which has exactly one end of it specified using \f(CW\*(C`\eN{}\*(C'\fR, and |
| 673 |
the other end is specified using a non-portable mechanism. Perl treats |
| 674 |
the range as a Unicode range, that is, all the characters in it are |
| 675 |
considered to be the Unicode characters, and which may be different code |
| 676 |
points on some platforms Perl runs on. For example, \f(CW\*(C`[\eN{U+06}\-\ex08]\*(C'\fR |
| 677 |
is treated as if you had instead said \f(CW\*(C`[\eN{U+06}\-\eN{U+08}]\*(C'\fR, that is it |
| 678 |
matches the characters whose code points in Unicode are 6, 7, and 8. |
| 679 |
But that \f(CW\*(C`\ex08\*(C'\fR might indicate that you meant something different, so |
| 680 |
the warning gets raised. |
| 681 |
.ie n .IP "Buffer overflow in prime_env_iter: %s" 4 |
| 682 |
.el .IP "Buffer overflow in prime_env_iter: \f(CW%s\fR" 4 |
| 683 |
.IX Item "Buffer overflow in prime_env_iter: %s" |
| 684 |
(W internal) A warning peculiar to VMS. While Perl was preparing to |
| 685 |
iterate over \f(CW%ENV\fR, it encountered a logical name or symbol definition |
| 686 |
which was too long, so it was truncated to the string shown. |
| 687 |
.IP "Built-in function '%s' is experimental" 4 |
| 688 |
.IX Item "Built-in function '%s' is experimental" |
| 689 |
(S experimental::builtin) A call is being made to a function in the |
| 690 |
\&\f(CW\*(C`builtin::\*(C'\fR namespace, which is currently experimental. The existence |
| 691 |
or nature of the function may be subject to change in a future version |
| 692 |
of Perl. |
| 693 |
.IP "builtin::import can only be called at compile time" 4 |
| 694 |
.IX Item "builtin::import can only be called at compile time" |
| 695 |
(F) The \f(CW\*(C`import\*(C'\fR method of the \f(CW\*(C`builtin\*(C'\fR package was invoked when no code |
| 696 |
is currently being compiled. Since this method is used to introduce new |
| 697 |
lexical subroutines into the scope currently being compiled, this is not |
| 698 |
going to have any effect. |
| 699 |
.IP "Builtin version bundle ""%s"" is not supported by Perl" 4 |
| 700 |
.IX Item "Builtin version bundle ""%s"" is not supported by Perl" |
| 701 |
(F) You attempted to \f(CW\*(C`use builtin :ver\*(C'\fR for a version number that is either |
| 702 |
older than 5.39 (when the ability was added), or newer than the current perl |
| 703 |
version. |
| 704 |
.IP "Callback called exit" 4 |
| 705 |
.IX Item "Callback called exit" |
| 706 |
(F) A subroutine invoked from an external package via \fBcall_sv()\fR |
| 707 |
exited by calling exit. |
| 708 |
.IP "%s() called too early to check prototype" 4 |
| 709 |
.IX Item "%s() called too early to check prototype" |
| 710 |
(W prototype) You've called a function that has a prototype before the |
| 711 |
parser saw a definition or declaration for it, and Perl could not check |
| 712 |
that the call conforms to the prototype. You need to either add an |
| 713 |
early prototype declaration for the subroutine in question, or move the |
| 714 |
subroutine definition ahead of the call to get proper prototype |
| 715 |
checking. Alternatively, if you are certain that you're calling the |
| 716 |
function correctly, you may put an ampersand before the name to avoid |
| 717 |
the warning. See perlsub. |
| 718 |
.ie n .IP "Cannot assign :param(%s) to field %s because that name is already in use" 4 |
| 719 |
.el .IP "Cannot assign :param(%s) to field \f(CW%s\fR because that name is already in use" 4 |
| 720 |
.IX Item "Cannot assign :param(%s) to field %s because that name is already in use" |
| 721 |
(F) An attempt was made to apply a parameter name to a field, when the name |
| 722 |
is already being used by another field in the same class, or one of its |
| 723 |
parent classes. This would cause a name clash so is not allowed. |
| 724 |
.ie n .IP "Cannot chr %f" 4 |
| 725 |
.el .IP "Cannot chr \f(CW%f\fR" 4 |
| 726 |
.IX Item "Cannot chr %f" |
| 727 |
(F) You passed an invalid number (like an infinity or not-a-number) to \f(CW\*(C`chr\*(C'\fR. |
| 728 |
.ie n .IP "Cannot complete in-place edit of %s: %s" 4 |
| 729 |
.el .IP "Cannot complete in-place edit of \f(CW%s:\fR \f(CW%s\fR" 4 |
| 730 |
.IX Item "Cannot complete in-place edit of %s: %s" |
| 731 |
(F) Your perl script appears to have changed directory while |
| 732 |
performing an in-place edit of a file specified by a relative path, |
| 733 |
and your system doesn't include the directory relative POSIX functions |
| 734 |
needed to handle that. |
| 735 |
.ie n .IP "Cannot compress %f in pack" 4 |
| 736 |
.el .IP "Cannot compress \f(CW%f\fR in pack" 4 |
| 737 |
.IX Item "Cannot compress %f in pack" |
| 738 |
(F) You tried compressing an infinity or not-a-number as an unsigned |
| 739 |
integer with BER, which makes no sense. |
| 740 |
.IP "Cannot compress integer in pack" 4 |
| 741 |
.IX Item "Cannot compress integer in pack" |
| 742 |
(F) An argument to pack("w",...) was too large to compress. |
| 743 |
The BER compressed integer format can only be used with positive |
| 744 |
integers, and you attempted to compress a very large number (> 1e308). |
| 745 |
See "pack" in perlfunc. |
| 746 |
.IP "Cannot compress negative numbers in pack" 4 |
| 747 |
.IX Item "Cannot compress negative numbers in pack" |
| 748 |
(F) An argument to pack("w",...) was negative. The BER compressed integer |
| 749 |
format can only be used with positive integers. See "pack" in perlfunc. |
| 750 |
.ie n .IP "Cannot convert a reference to %s to typeglob" 4 |
| 751 |
.el .IP "Cannot convert a reference to \f(CW%s\fR to typeglob" 4 |
| 752 |
.IX Item "Cannot convert a reference to %s to typeglob" |
| 753 |
(F) You manipulated Perl's symbol table directly, stored a reference |
| 754 |
in it, then tried to access that symbol via conventional Perl syntax. |
| 755 |
The access triggers Perl to autovivify that typeglob, but it there is |
| 756 |
no legal conversion from that type of reference to a typeglob. |
| 757 |
.ie n .IP "Cannot copy to %s" 4 |
| 758 |
.el .IP "Cannot copy to \f(CW%s\fR" 4 |
| 759 |
.IX Item "Cannot copy to %s" |
| 760 |
(P) Perl detected an attempt to copy a value to an internal type that cannot |
| 761 |
be directly assigned to. |
| 762 |
.ie n .IP "Cannot create class %s as it already has a non-empty @ISA" 4 |
| 763 |
.el .IP "Cannot create class \f(CW%s\fR as it already has a non-empty \f(CW@ISA\fR" 4 |
| 764 |
.IX Item "Cannot create class %s as it already has a non-empty @ISA" |
| 765 |
(F) An attempt was made to create a class out of a package that already has |
| 766 |
an \f(CW@ISA\fR array, and the array is not empty. This is not permitted, as it |
| 767 |
would lead to a class with inconsistent inheritance. |
| 768 |
.IP "Cannot create an object of incomplete class ""%s""" 4 |
| 769 |
.IX Item "Cannot create an object of incomplete class ""%s""" |
| 770 |
(F) An attempt was made to create an object of a class where the start |
| 771 |
of the class definition has been seen, but the class has not been |
| 772 |
completed. |
| 773 |
.Sp |
| 774 |
This can happen for a failed eval, or if you attempt to create an |
| 775 |
object at compile time before the class is complete: |
| 776 |
.Sp |
| 777 |
.Vb 2 |
| 778 |
\& eval "class Foo {"; Foo\->new; # error |
| 779 |
\& class Bar { BEGIN { Bar\->new } }; # error |
| 780 |
.Ve |
| 781 |
.IP "Cannot find encoding ""%s""" 4 |
| 782 |
.IX Item "Cannot find encoding ""%s""" |
| 783 |
(S io) You tried to apply an encoding that did not exist to a filehandle, |
| 784 |
either with \fBopen()\fR or \fBbinmode()\fR. |
| 785 |
.IP "Cannot invoke a method of ""%s"" on an instance of ""%s""" 4 |
| 786 |
.IX Item "Cannot invoke a method of ""%s"" on an instance of ""%s""" |
| 787 |
(F) You tried to directly call a \f(CW\*(C`method\*(C'\fR subroutine of one class by passing |
| 788 |
in a value that is an instance of a different class. This is not permitted, |
| 789 |
as the method would not have access to the correct instance fields. |
| 790 |
.IP "Cannot invoke method on a non-instance" 4 |
| 791 |
.IX Item "Cannot invoke method on a non-instance" |
| 792 |
(F) You tried to directly call a \f(CW\*(C`method\*(C'\fR subroutine of a class by passing |
| 793 |
in a value that is not an instance of that class. This is not permitted, as |
| 794 |
the method would not then have access to its instance fields. |
| 795 |
.ie n .IP "Cannot open %s as a dirhandle: it is already open as a filehandle" 4 |
| 796 |
.el .IP "Cannot open \f(CW%s\fR as a dirhandle: it is already open as a filehandle" 4 |
| 797 |
.IX Item "Cannot open %s as a dirhandle: it is already open as a filehandle" |
| 798 |
(F) You tried to use \fBopendir()\fR to associate a dirhandle to a symbol (glob |
| 799 |
or scalar) that already holds a filehandle. Since this idiom might render |
| 800 |
your code confusing, it was deprecated in Perl 5.10. As of Perl 5.28, it |
| 801 |
is a fatal error. |
| 802 |
.ie n .IP "Cannot open %s as a filehandle: it is already open as a dirhandle" 4 |
| 803 |
.el .IP "Cannot open \f(CW%s\fR as a filehandle: it is already open as a dirhandle" 4 |
| 804 |
.IX Item "Cannot open %s as a filehandle: it is already open as a dirhandle" |
| 805 |
(F) You tried to use \fBopen()\fR to associate a filehandle to a symbol (glob |
| 806 |
or scalar) that already holds a dirhandle. Since this idiom might render |
| 807 |
your code confusing, it was deprecated in Perl 5.10. As of Perl 5.28, it |
| 808 |
is a fatal error. |
| 809 |
.IP "Cannot '%s' outside of a 'class'" 4 |
| 810 |
.IX Item "Cannot '%s' outside of a 'class'" |
| 811 |
(F) You attempted to use one of the keywords that only makes sense inside |
| 812 |
a \f(CW\*(C`class\*(C'\fR definition, at a location that is not inside such a class. |
| 813 |
.ie n .IP "Cannot pack %f with '%c'" 4 |
| 814 |
.el .IP "Cannot pack \f(CW%f\fR with '%c'" 4 |
| 815 |
.IX Item "Cannot pack %f with '%c'" |
| 816 |
(F) You tried converting an infinity or not-a-number to an integer, |
| 817 |
which makes no sense. |
| 818 |
.ie n .IP "Cannot printf %f with '%c'" 4 |
| 819 |
.el .IP "Cannot printf \f(CW%f\fR with '%c'" 4 |
| 820 |
.IX Item "Cannot printf %f with '%c'" |
| 821 |
(F) You tried printing an infinity or not-a-number as a character (%c), |
| 822 |
which makes no sense. Maybe you meant '%s', or just stringifying it? |
| 823 |
.IP "Cannot reopen existing class ""%s""" 4 |
| 824 |
.IX Item "Cannot reopen existing class ""%s""" |
| 825 |
(F) You tried to begin a \f(CW\*(C`class\*(C'\fR definition for a class that already exists. |
| 826 |
A class may only have one definition block. |
| 827 |
.ie n .IP "Cannot set tied @DB::args" 4 |
| 828 |
.el .IP "Cannot set tied \f(CW@DB::args\fR" 4 |
| 829 |
.IX Item "Cannot set tied @DB::args" |
| 830 |
(F) \f(CW\*(C`caller\*(C'\fR tried to set \f(CW@DB::args\fR, but found it tied. Tying \f(CW@DB::args\fR |
| 831 |
is not supported. (Before this error was added, it used to crash.) |
| 832 |
.IP "Cannot tie unreifiable array" 4 |
| 833 |
.IX Item "Cannot tie unreifiable array" |
| 834 |
(P) You somehow managed to call \f(CW\*(C`tie\*(C'\fR on an array that does not |
| 835 |
keep a reference count on its arguments and cannot be made to |
| 836 |
do so. Such arrays are not even supposed to be accessible to |
| 837 |
Perl code, but are only used internally. |
| 838 |
.IP "Cannot use _\|_CLASS_\|_ outside of a method or field initializer expression" 4 |
| 839 |
.IX Item "Cannot use __CLASS__ outside of a method or field initializer expression" |
| 840 |
(F) A \f(CW\*(C`_\|_CLASS_\|_\*(C'\fR expression yields the class name of the object instance |
| 841 |
executing the current method, and therefore it can only be placed inside an |
| 842 |
actual method (or method-like expression, such as a field initializer |
| 843 |
expression). |
| 844 |
.IP "Cannot yet reorder \fBsv_vcatpvfn()\fR arguments from va_list" 4 |
| 845 |
.IX Item "Cannot yet reorder sv_vcatpvfn() arguments from va_list" |
| 846 |
(F) Some XS code tried to use \f(CWsv_vcatpvfn()\fR or a related function with a |
| 847 |
format string that specifies explicit indexes for some of the elements, and |
| 848 |
using a C\-style variable-argument list (a \f(CW\*(C`va_list\*(C'\fR). This is not currently |
| 849 |
supported. XS authors wanting to do this must instead construct a C array |
| 850 |
of \f(CW\*(C`SV*\*(C'\fR scalars containing the arguments. |
| 851 |
.IP "Can only compress unsigned integers in pack" 4 |
| 852 |
.IX Item "Can only compress unsigned integers in pack" |
| 853 |
(F) An argument to pack("w",...) was not an integer. The BER compressed |
| 854 |
integer format can only be used with positive integers, and you attempted |
| 855 |
to compress something else. See "pack" in perlfunc. |
| 856 |
.IP "Can't ""%s"" out of a ""defer"" block" 4 |
| 857 |
.IX Item "Can't ""%s"" out of a ""defer"" block" |
| 858 |
(F) An attempt was made to jump out of the scope of a \f(CW\*(C`defer\*(C'\fR block by using |
| 859 |
a control-flow statement such as \f(CW\*(C`return\*(C'\fR, \f(CW\*(C`goto\*(C'\fR or a loop control. This is |
| 860 |
not permitted. |
| 861 |
.IP "Can't ""%s"" out of a ""finally"" block" 4 |
| 862 |
.IX Item "Can't ""%s"" out of a ""finally"" block" |
| 863 |
(F) Similar to above, but involving a \f(CW\*(C`finally\*(C'\fR block at the end of a |
| 864 |
\&\f(CW\*(C`try\*(C'\fR/\f(CW\*(C`catch\*(C'\fR construction rather than a \f(CW\*(C`defer\*(C'\fR block. |
| 865 |
.IP "Can't bless an object reference" 4 |
| 866 |
.IX Item "Can't bless an object reference" |
| 867 |
(F) You attempted to call \f(CW\*(C`bless\*(C'\fR on a value that already refers to a real |
| 868 |
object instance. |
| 869 |
.IP "Can't bless non-reference value" 4 |
| 870 |
.IX Item "Can't bless non-reference value" |
| 871 |
(F) Only hard references may be blessed. This is how Perl "enforces" |
| 872 |
encapsulation of objects. See perlobj. |
| 873 |
.IP "Can't ""break"" in a loop topicalizer" 4 |
| 874 |
.IX Item "Can't ""break"" in a loop topicalizer" |
| 875 |
(F) You called \f(CW\*(C`break\*(C'\fR, but you're in a \f(CW\*(C`foreach\*(C'\fR block rather than |
| 876 |
a \f(CW\*(C`given\*(C'\fR block. You probably meant to use \f(CW\*(C`next\*(C'\fR or \f(CW\*(C`last\*(C'\fR. |
| 877 |
.IP "Can't ""break"" outside a given block" 4 |
| 878 |
.IX Item "Can't ""break"" outside a given block" |
| 879 |
(F) You called \f(CW\*(C`break\*(C'\fR, but you're not inside a \f(CW\*(C`given\*(C'\fR block. |
| 880 |
.IP "Can't call destructor for 0x%p in global destruction" 4 |
| 881 |
.IX Item "Can't call destructor for 0x%p in global destruction" |
| 882 |
(S) This should not happen. Internals code has set up a destructor |
| 883 |
using \f(CW\*(C`mortal_destructor_sv\*(C'\fR or \f(CW\*(C`mortal_destructor_x\*(C'\fR which is firing |
| 884 |
during global destruction. Please attempt to reduce the code that triggers |
| 885 |
this warning down to a small an example as possible and then report the |
| 886 |
problem to <https://github.com/Perl/perl5/issues/new/choose> |
| 887 |
.IP "Can't call method ""%s"" on an undefined value" 4 |
| 888 |
.IX Item "Can't call method ""%s"" on an undefined value" |
| 889 |
(F) You used the syntax of a method call, but the slot filled by the |
| 890 |
object reference or package name contains an undefined value. Something |
| 891 |
like this will reproduce the error: |
| 892 |
.Sp |
| 893 |
.Vb 3 |
| 894 |
\& $BADREF = undef; |
| 895 |
\& process $BADREF 1,2,3; |
| 896 |
\& $BADREF\->process(1,2,3); |
| 897 |
.Ve |
| 898 |
.IP "Can't call method ""%s"" on unblessed reference" 4 |
| 899 |
.IX Item "Can't call method ""%s"" on unblessed reference" |
| 900 |
(F) A method call must know in what package it's supposed to run. It |
| 901 |
ordinarily finds this out from the object reference you supply, but you |
| 902 |
didn't supply an object reference in this case. A reference isn't an |
| 903 |
object reference until it has been blessed. See perlobj. |
| 904 |
.IP "Can't call method ""%s"" without a package or object reference" 4 |
| 905 |
.IX Item "Can't call method ""%s"" without a package or object reference" |
| 906 |
(F) You used the syntax of a method call, but the slot filled by the |
| 907 |
object reference or package name contains an expression that returns a |
| 908 |
defined value which is neither an object reference nor a package name. |
| 909 |
Something like this will reproduce the error: |
| 910 |
.Sp |
| 911 |
.Vb 3 |
| 912 |
\& $BADREF = 42; |
| 913 |
\& process $BADREF 1,2,3; |
| 914 |
\& $BADREF\->process(1,2,3); |
| 915 |
.Ve |
| 916 |
.IP "Can't call \fBmro_isa_changed_in()\fR on anonymous symbol table" 4 |
| 917 |
.IX Item "Can't call mro_isa_changed_in() on anonymous symbol table" |
| 918 |
(P) Perl got confused as to whether a hash was a plain hash or a |
| 919 |
symbol table hash when trying to update \f(CW@ISA\fR caches. |
| 920 |
.IP "Can't call \fBmro_method_changed_in()\fR on anonymous symbol table" 4 |
| 921 |
.IX Item "Can't call mro_method_changed_in() on anonymous symbol table" |
| 922 |
(F) An XS module tried to call \f(CW\*(C`mro_method_changed_in\*(C'\fR on a hash that was |
| 923 |
not attached to the symbol table. |
| 924 |
.ie n .IP "Can't chdir to %s" 4 |
| 925 |
.el .IP "Can't chdir to \f(CW%s\fR" 4 |
| 926 |
.IX Item "Can't chdir to %s" |
| 927 |
(F) You called \f(CW\*(C`perl \-x/foo/bar\*(C'\fR, but \fI/foo/bar\fR is not a directory |
| 928 |
that you can chdir to, possibly because it doesn't exist. |
| 929 |
.ie n .IP "Can't coerce %s to %s in %s" 4 |
| 930 |
.el .IP "Can't coerce \f(CW%s\fR to \f(CW%s\fR in \f(CW%s\fR" 4 |
| 931 |
.IX Item "Can't coerce %s to %s in %s" |
| 932 |
(F) Certain types of SVs, in particular real symbol table entries |
| 933 |
(typeglobs), can't be forced to stop being what they are. So you can't |
| 934 |
say things like: |
| 935 |
.Sp |
| 936 |
.Vb 1 |
| 937 |
\& *foo += 1; |
| 938 |
.Ve |
| 939 |
.Sp |
| 940 |
You CAN say |
| 941 |
.Sp |
| 942 |
.Vb 2 |
| 943 |
\& $foo = *foo; |
| 944 |
\& $foo += 1; |
| 945 |
.Ve |
| 946 |
.Sp |
| 947 |
but then \f(CW$foo\fR no longer contains a glob. |
| 948 |
.IP "Can't ""continue"" outside a when block" 4 |
| 949 |
.IX Item "Can't ""continue"" outside a when block" |
| 950 |
(F) You called \f(CW\*(C`continue\*(C'\fR, but you're not inside a \f(CW\*(C`when\*(C'\fR |
| 951 |
or \f(CW\*(C`default\*(C'\fR block. |
| 952 |
.IP "can't convert empty path" 4 |
| 953 |
.IX Item "can't convert empty path" |
| 954 |
(F) On Cygwin, you called a path conversion function with an empty path. |
| 955 |
Only non-empty paths are legal. |
| 956 |
.IP "Can't create pipe mailbox" 4 |
| 957 |
.IX Item "Can't create pipe mailbox" |
| 958 |
(P) An error peculiar to VMS. The process is suffering from exhausted |
| 959 |
quotas or other plumbing problems. |
| 960 |
.ie n .IP "Can't declare %s in ""%s""" 4 |
| 961 |
.el .IP "Can't declare \f(CW%s\fR in ""%s""" 4 |
| 962 |
.IX Item "Can't declare %s in ""%s""" |
| 963 |
(F) Only scalar, array, and hash variables may be declared as "my", "our" or |
| 964 |
"state" variables. They must have ordinary identifiers as names. |
| 965 |
.IP "Can't ""default"" outside a topicalizer" 4 |
| 966 |
.IX Item "Can't ""default"" outside a topicalizer" |
| 967 |
(F) You have used a \f(CW\*(C`default\*(C'\fR block that is neither inside a |
| 968 |
\&\f(CW\*(C`foreach\*(C'\fR loop nor a \f(CW\*(C`given\*(C'\fR block. (Note that this error is |
| 969 |
issued on exit from the \f(CW\*(C`default\*(C'\fR block, so you won't get the |
| 970 |
error if you use an explicit \f(CW\*(C`continue\*(C'\fR.) |
| 971 |
.ie n .IP "Can't determine class of operator %s, assuming BASEOP" 4 |
| 972 |
.el .IP "Can't determine class of operator \f(CW%s\fR, assuming BASEOP" 4 |
| 973 |
.IX Item "Can't determine class of operator %s, assuming BASEOP" |
| 974 |
(S) This warning indicates something wrong in the internals of perl. |
| 975 |
Perl was trying to find the class (e.g. LISTOP) of a particular OP, |
| 976 |
and was unable to do so. This is likely to be due to a bug in the perl |
| 977 |
internals, or due to a bug in XS code which manipulates perl optrees. |
| 978 |
.ie n .IP "Can't do inplace edit: %s is not a regular file" 4 |
| 979 |
.el .IP "Can't do inplace edit: \f(CW%s\fR is not a regular file" 4 |
| 980 |
.IX Item "Can't do inplace edit: %s is not a regular file" |
| 981 |
(S inplace) You tried to use the \fB\-i\fR switch on a special file, such as |
| 982 |
a file in /dev, a FIFO or an uneditable directory. The file was ignored. |
| 983 |
.ie n .IP "Can't do inplace edit on %s: %s" 4 |
| 984 |
.el .IP "Can't do inplace edit on \f(CW%s:\fR \f(CW%s\fR" 4 |
| 985 |
.IX Item "Can't do inplace edit on %s: %s" |
| 986 |
(S inplace) The creation of the new file failed for the indicated |
| 987 |
reason. |
| 988 |
.ie n .IP "Can't do inplace edit: %s would not be unique" 4 |
| 989 |
.el .IP "Can't do inplace edit: \f(CW%s\fR would not be unique" 4 |
| 990 |
.IX Item "Can't do inplace edit: %s would not be unique" |
| 991 |
(S inplace) Your filesystem does not support filenames longer than 14 |
| 992 |
characters and Perl was unable to create a unique filename during |
| 993 |
inplace editing with the \fB\-i\fR switch. The file was ignored. |
| 994 |
.IP "Can't do %s(""%s"") on non\-UTF\-8 locale; resolved to ""%s""." 4 |
| 995 |
.IX Item "Can't do %s(""%s"") on non-UTF-8 locale; resolved to ""%s""." |
| 996 |
(W locale) You are 1) running under "\f(CW\*(C`use locale\*(C'\fR"; 2) the current |
| 997 |
locale is not a UTF\-8 one; 3) you tried to do the designated case-change |
| 998 |
operation on the specified Unicode character; and 4) the result of this |
| 999 |
operation would mix Unicode and locale rules, which likely conflict. |
| 1000 |
Mixing of different rule types is forbidden, so the operation was not |
| 1001 |
done; instead the result is the indicated value, which is the best |
| 1002 |
available that uses entirely Unicode rules. That turns out to almost |
| 1003 |
always be the original character, unchanged. |
| 1004 |
.Sp |
| 1005 |
It is generally a bad idea to mix non\-UTF\-8 locales and Unicode, and |
| 1006 |
this issue is one of the reasons why. This warning is raised when |
| 1007 |
Unicode rules would normally cause the result of this operation to |
| 1008 |
contain a character that is in the range specified by the locale, |
| 1009 |
0..255, and hence is subject to the locale's rules, not Unicode's. |
| 1010 |
.Sp |
| 1011 |
If you are using locale purely for its characteristics related to things |
| 1012 |
like its numeric and time formatting (and not \f(CW\*(C`LC_CTYPE\*(C'\fR), consider |
| 1013 |
using a restricted form of the locale pragma (see "The "use |
| 1014 |
locale" pragma" in perllocale) like "\f(CW\*(C`use\ locale\ \*(Aq:not_characters\*(Aq\*(C'\fR". |
| 1015 |
.Sp |
| 1016 |
Note that failed case-changing operations done as a result of |
| 1017 |
case-insensitive \f(CW\*(C`/i\*(C'\fR regular expression matching will show up in this |
| 1018 |
warning as having the \f(CW\*(C`fc\*(C'\fR operation (as that is what the regular |
| 1019 |
expression engine calls behind the scenes.) |
| 1020 |
.IP "Can't do waitpid with flags" 4 |
| 1021 |
.IX Item "Can't do waitpid with flags" |
| 1022 |
(F) This machine doesn't have either \fBwaitpid()\fR or \fBwait4()\fR, so only |
| 1023 |
\&\fBwaitpid()\fR without flags is emulated. |
| 1024 |
.IP "Can't emulate \-%s on #! line" 4 |
| 1025 |
.IX Item "Can't emulate -%s on #! line" |
| 1026 |
(F) The #! line specifies a switch that doesn't make sense at this |
| 1027 |
point. For example, it'd be kind of silly to put a \fB\-x\fR on the #! |
| 1028 |
line. |
| 1029 |
.ie n .IP "Can't %s %s\-endian %ss on this platform" 4 |
| 1030 |
.el .IP "Can't \f(CW%s\fR \f(CW%s\fR\-endian \f(CW%ss\fR on this platform" 4 |
| 1031 |
.IX Item "Can't %s %s-endian %ss on this platform" |
| 1032 |
(F) Your platform's byte-order is neither big-endian nor little-endian, |
| 1033 |
or it has a very strange pointer size. Packing and unpacking big\- or |
| 1034 |
little-endian floating point values and pointers may not be possible. |
| 1035 |
See "pack" in perlfunc. |
| 1036 |
.ie n .IP "Can't exec ""%s"": %s" 4 |
| 1037 |
.el .IP "Can't exec ""%s"": \f(CW%s\fR" 4 |
| 1038 |
.IX Item "Can't exec ""%s"": %s" |
| 1039 |
(W exec) A \fBsystem()\fR, \fBexec()\fR, or piped open call could not execute the |
| 1040 |
named program for the indicated reason. Typical reasons include: the |
| 1041 |
permissions were wrong on the file, the file wasn't found in |
| 1042 |
\&\f(CW$ENV{PATH}\fR, the executable in question was compiled for another |
| 1043 |
architecture, or the #! line in a script points to an interpreter that |
| 1044 |
can't be run for similar reasons. (Or maybe your system doesn't support |
| 1045 |
#! at all.) |
| 1046 |
.ie n .IP "Can't exec %s" 4 |
| 1047 |
.el .IP "Can't exec \f(CW%s\fR" 4 |
| 1048 |
.IX Item "Can't exec %s" |
| 1049 |
(F) Perl was trying to execute the indicated program for you because |
| 1050 |
that's what the #! line said. If that's not what you wanted, you may |
| 1051 |
need to mention "perl" on the #! line somewhere. |
| 1052 |
.ie n .IP "Can't execute %s" 4 |
| 1053 |
.el .IP "Can't execute \f(CW%s\fR" 4 |
| 1054 |
.IX Item "Can't execute %s" |
| 1055 |
(F) You used the \fB\-S\fR switch, but the copies of the script to execute |
| 1056 |
found in the PATH did not have correct permissions. |
| 1057 |
.IP "Can't find an opnumber for ""%s""" 4 |
| 1058 |
.IX Item "Can't find an opnumber for ""%s""" |
| 1059 |
(F) A string of a form \f(CW\*(C`CORE::word\*(C'\fR was given to \fBprototype()\fR, but there |
| 1060 |
is no builtin with the name \f(CW\*(C`word\*(C'\fR. |
| 1061 |
.ie n .IP "Can't find label %s" 4 |
| 1062 |
.el .IP "Can't find label \f(CW%s\fR" 4 |
| 1063 |
.IX Item "Can't find label %s" |
| 1064 |
(F) You said to goto a label that isn't mentioned anywhere that it's |
| 1065 |
possible for us to go to. See "goto" in perlfunc. |
| 1066 |
.ie n .IP "Can't find %s on PATH" 4 |
| 1067 |
.el .IP "Can't find \f(CW%s\fR on PATH" 4 |
| 1068 |
.IX Item "Can't find %s on PATH" |
| 1069 |
(F) You used the \fB\-S\fR switch, but the script to execute could not be |
| 1070 |
found in the PATH. |
| 1071 |
.ie n .IP "Can't find %s on PATH, '.' not in PATH" 4 |
| 1072 |
.el .IP "Can't find \f(CW%s\fR on PATH, '.' not in PATH" 4 |
| 1073 |
.IX Item "Can't find %s on PATH, '.' not in PATH" |
| 1074 |
(F) You used the \fB\-S\fR switch, but the script to execute could not be |
| 1075 |
found in the PATH, or at least not with the correct permissions. The |
| 1076 |
script exists in the current directory, but PATH prohibits running it. |
| 1077 |
.ie n .IP "Can't find string terminator %s anywhere before EOF" 4 |
| 1078 |
.el .IP "Can't find string terminator \f(CW%s\fR anywhere before EOF" 4 |
| 1079 |
.IX Item "Can't find string terminator %s anywhere before EOF" |
| 1080 |
(F) Perl strings can stretch over multiple lines. This message means |
| 1081 |
that the closing delimiter was omitted. Because bracketed quotes count |
| 1082 |
nesting levels, the following is missing its final parenthesis: |
| 1083 |
.Sp |
| 1084 |
.Vb 1 |
| 1085 |
\& print q(The character \*(Aq(\*(Aq starts a side comment.); |
| 1086 |
.Ve |
| 1087 |
.Sp |
| 1088 |
If you're getting this error from a here-document, you may have |
| 1089 |
included unseen whitespace before or after your closing tag or there |
| 1090 |
may not be a linebreak after it. A good programmer's editor will have |
| 1091 |
a way to help you find these characters (or lack of characters). See |
| 1092 |
perlop for the full details on here-documents. |
| 1093 |
.IP "Can't find Unicode property definition ""%s""" 4 |
| 1094 |
.IX Item "Can't find Unicode property definition ""%s""" |
| 1095 |
.PD 0 |
| 1096 |
.IP "Can't find Unicode property definition ""%s"" in regex; marked by <\-\- HERE in m/%s/" 4 |
| 1097 |
.IX Item "Can't find Unicode property definition ""%s"" in regex; marked by <-- HERE in m/%s/" |
| 1098 |
.PD |
| 1099 |
(F) The named property which you specified via \f(CW\*(C`\ep\*(C'\fR or \f(CW\*(C`\eP\*(C'\fR is not one |
| 1100 |
known to Perl. Perhaps you misspelled the name? See |
| 1101 |
"Properties accessible through \ep{} and \eP{}" in perluniprops |
| 1102 |
for a complete list of available official |
| 1103 |
properties. If it is a |
| 1104 |
user-defined property |
| 1105 |
it must have been defined by the time the regular expression is |
| 1106 |
matched. |
| 1107 |
.Sp |
| 1108 |
If you didn't mean to use a Unicode property, escape the \f(CW\*(C`\ep\*(C'\fR, either |
| 1109 |
by \f(CW\*(C`\e\ep\*(C'\fR (just the \f(CW\*(C`\ep\*(C'\fR) or by \f(CW\*(C`\eQ\ep\*(C'\fR (the rest of the string, or |
| 1110 |
until \f(CW\*(C`\eE\*(C'\fR). |
| 1111 |
.ie n .IP "Can't fork: %s" 4 |
| 1112 |
.el .IP "Can't fork: \f(CW%s\fR" 4 |
| 1113 |
.IX Item "Can't fork: %s" |
| 1114 |
(F) A fatal error occurred while trying to fork while opening a |
| 1115 |
pipeline. |
| 1116 |
.IP "Can't fork, trying again in 5 seconds" 4 |
| 1117 |
.IX Item "Can't fork, trying again in 5 seconds" |
| 1118 |
(W pipe) A fork in a piped open failed with EAGAIN and will be retried |
| 1119 |
after five seconds. |
| 1120 |
.IP "Can't get filespec \- stale stat buffer?" 4 |
| 1121 |
.IX Item "Can't get filespec - stale stat buffer?" |
| 1122 |
(S) A warning peculiar to VMS. This arises because of the difference |
| 1123 |
between access checks under VMS and under the Unix model Perl assumes. |
| 1124 |
Under VMS, access checks are done by filename, rather than by bits in |
| 1125 |
the stat buffer, so that ACLs and other protections can be taken into |
| 1126 |
account. Unfortunately, Perl assumes that the stat buffer contains all |
| 1127 |
the necessary information, and passes it, instead of the filespec, to |
| 1128 |
the access-checking routine. It will try to retrieve the filespec using |
| 1129 |
the device name and FID present in the stat buffer, but this works only |
| 1130 |
if you haven't made a subsequent call to the CRTL \fBstat()\fR routine, |
| 1131 |
because the device name is overwritten with each call. If this warning |
| 1132 |
appears, the name lookup failed, and the access-checking routine gave up |
| 1133 |
and returned FALSE, just to be conservative. (Note: The access-checking |
| 1134 |
routine knows about the Perl \f(CW\*(C`stat\*(C'\fR operator and file tests, so you |
| 1135 |
shouldn't ever see this warning in response to a Perl command; it arises |
| 1136 |
only if some internal code takes stat buffers lightly.) |
| 1137 |
.IP "Can't get pipe mailbox device name" 4 |
| 1138 |
.IX Item "Can't get pipe mailbox device name" |
| 1139 |
(P) An error peculiar to VMS. After creating a mailbox to act as a |
| 1140 |
pipe, Perl can't retrieve its name for later use. |
| 1141 |
.IP "Can't get SYSGEN parameter value for MAXBUF" 4 |
| 1142 |
.IX Item "Can't get SYSGEN parameter value for MAXBUF" |
| 1143 |
(P) An error peculiar to VMS. Perl asked \f(CW$GETSYI\fR how big you want your |
| 1144 |
mailbox buffers to be, and didn't get an answer. |
| 1145 |
.IP "Can't ""goto"" into a binary or list expression" 4 |
| 1146 |
.IX Item "Can't ""goto"" into a binary or list expression" |
| 1147 |
(F) A "goto" statement was executed to jump into the middle of a binary |
| 1148 |
or list expression. You can't get there from here. The reason for this |
| 1149 |
restriction is that the interpreter would get confused as to how many |
| 1150 |
arguments there are, resulting in stack corruption or crashes. This |
| 1151 |
error occurs in cases such as these: |
| 1152 |
.Sp |
| 1153 |
.Vb 2 |
| 1154 |
\& goto F; |
| 1155 |
\& print do { F: }; # Can\*(Aqt jump into the arguments to print |
| 1156 |
\& |
| 1157 |
\& goto G; |
| 1158 |
\& $x + do { G: $y }; # How is + supposed to get its first operand? |
| 1159 |
.Ve |
| 1160 |
.IP "Can't ""goto"" into a ""defer"" block" 4 |
| 1161 |
.IX Item "Can't ""goto"" into a ""defer"" block" |
| 1162 |
(F) A \f(CW\*(C`goto\*(C'\fR statement was executed to jump into the scope of a \f(CW\*(C`defer\*(C'\fR |
| 1163 |
block. This is not permitted. |
| 1164 |
.IP "Can't ""goto"" into a ""given"" block" 4 |
| 1165 |
.IX Item "Can't ""goto"" into a ""given"" block" |
| 1166 |
(F) A "goto" statement was executed to jump into the middle of a \f(CW\*(C`given\*(C'\fR |
| 1167 |
block. You can't get there from here. See "goto" in perlfunc. |
| 1168 |
.IP "Can't ""goto"" into the middle of a foreach loop" 4 |
| 1169 |
.IX Item "Can't ""goto"" into the middle of a foreach loop" |
| 1170 |
(F) A "goto" statement was executed to jump into the middle of a foreach |
| 1171 |
loop. You can't get there from here. See "goto" in perlfunc. |
| 1172 |
.IP "Can't ""goto"" out of a pseudo block" 4 |
| 1173 |
.IX Item "Can't ""goto"" out of a pseudo block" |
| 1174 |
(F) A "goto" statement was executed to jump out of what might look like |
| 1175 |
a block, except that it isn't a proper block. This usually occurs if |
| 1176 |
you tried to jump out of a \fBsort()\fR block or subroutine, which is a no-no. |
| 1177 |
See "goto" in perlfunc. |
| 1178 |
.IP "Can't goto subroutine from an eval\-%s" 4 |
| 1179 |
.IX Item "Can't goto subroutine from an eval-%s" |
| 1180 |
(F) The "goto subroutine" call can't be used to jump out of an eval |
| 1181 |
"string" or block. |
| 1182 |
.IP "Can't goto subroutine from a sort sub (or similar callback)" 4 |
| 1183 |
.IX Item "Can't goto subroutine from a sort sub (or similar callback)" |
| 1184 |
(F) The "goto subroutine" call can't be used to jump out of the |
| 1185 |
comparison sub for a \fBsort()\fR, or from a similar callback (such |
| 1186 |
as the \fBreduce()\fR function in List::Util). |
| 1187 |
.IP "Can't goto subroutine outside a subroutine" 4 |
| 1188 |
.IX Item "Can't goto subroutine outside a subroutine" |
| 1189 |
(F) The deeply magical "goto subroutine" call can only replace one |
| 1190 |
subroutine call for another. It can't manufacture one out of whole |
| 1191 |
cloth. In general you should be calling it out of only an AUTOLOAD |
| 1192 |
routine anyway. See "goto" in perlfunc. |
| 1193 |
.IP "Can't ignore signal CHLD, forcing to default" 4 |
| 1194 |
.IX Item "Can't ignore signal CHLD, forcing to default" |
| 1195 |
(W signal) Perl has detected that it is being run with the SIGCHLD |
| 1196 |
signal (sometimes known as SIGCLD) disabled. Since disabling this |
| 1197 |
signal will interfere with proper determination of exit status of child |
| 1198 |
processes, Perl has reset the signal to its default value. This |
| 1199 |
situation typically indicates that the parent program under which Perl |
| 1200 |
may be running (e.g. cron) is being very careless. |
| 1201 |
.IP "Can't kill a non-numeric process ID" 4 |
| 1202 |
.IX Item "Can't kill a non-numeric process ID" |
| 1203 |
(F) Process identifiers must be (signed) integers. It is a fatal error to |
| 1204 |
attempt to \fBkill()\fR an undefined, empty-string or otherwise non-numeric |
| 1205 |
process identifier. |
| 1206 |
.IP "Can't ""last"" outside a loop block" 4 |
| 1207 |
.IX Item "Can't ""last"" outside a loop block" |
| 1208 |
(F) A "last" statement was executed to break out of the current block, |
| 1209 |
except that there's this itty bitty problem called there isn't a current |
| 1210 |
block. Note that an "if" or "else" block doesn't count as a "loopish" |
| 1211 |
block, as doesn't a block given to \fBsort()\fR, \fBmap()\fR or \fBgrep()\fR. You can |
| 1212 |
usually double the curlies to get the same effect though, because the |
| 1213 |
inner curlies will be considered a block that loops once. See |
| 1214 |
"last" in perlfunc. |
| 1215 |
.IP "Can't linearize anonymous symbol table" 4 |
| 1216 |
.IX Item "Can't linearize anonymous symbol table" |
| 1217 |
(F) Perl tried to calculate the method resolution order (MRO) of a |
| 1218 |
package, but failed because the package stash has no name. |
| 1219 |
.ie n .IP "Can't load '%s' for module %s" 4 |
| 1220 |
.el .IP "Can't load '%s' for module \f(CW%s\fR" 4 |
| 1221 |
.IX Item "Can't load '%s' for module %s" |
| 1222 |
(F) The module you tried to load failed to load a dynamic extension. |
| 1223 |
This may either mean that you upgraded your version of perl to one |
| 1224 |
that is incompatible with your old dynamic extensions (which is known |
| 1225 |
to happen between major versions of perl), or (more likely) that your |
| 1226 |
dynamic extension was built against an older version of the library |
| 1227 |
that is installed on your system. You may need to rebuild your old |
| 1228 |
dynamic extensions. |
| 1229 |
.ie n .IP "Can't localize lexical variable %s" 4 |
| 1230 |
.el .IP "Can't localize lexical variable \f(CW%s\fR" 4 |
| 1231 |
.IX Item "Can't localize lexical variable %s" |
| 1232 |
(F) You used local on a variable name that was previously declared as a |
| 1233 |
lexical variable using "my" or "state". This is not allowed. If you |
| 1234 |
want to localize a package variable of the same name, qualify it with |
| 1235 |
the package name. |
| 1236 |
.IP "Can't localize through a reference" 4 |
| 1237 |
.IX Item "Can't localize through a reference" |
| 1238 |
(F) You said something like \f(CW\*(C`local $$ref\*(C'\fR, which Perl can't currently |
| 1239 |
handle, because when it goes to restore the old value of whatever \f(CW$ref\fR |
| 1240 |
pointed to after the scope of the \fBlocal()\fR is finished, it can't be sure |
| 1241 |
that \f(CW$ref\fR will still be a reference. |
| 1242 |
.ie n .IP "Can't locate %s" 4 |
| 1243 |
.el .IP "Can't locate \f(CW%s\fR" 4 |
| 1244 |
.IX Item "Can't locate %s" |
| 1245 |
(F) You said to \f(CW\*(C`do\*(C'\fR (or \f(CW\*(C`require\*(C'\fR, or \f(CW\*(C`use\*(C'\fR) a file that couldn't be found. |
| 1246 |
Perl looks for the file in all the locations mentioned in \f(CW@INC\fR, unless |
| 1247 |
the file name included the full path to the file. Perhaps you need |
| 1248 |
to set the PERL5LIB or PERL5OPT environment variable to say where the |
| 1249 |
extra library is, or maybe the script needs to add the library name |
| 1250 |
to \f(CW@INC\fR. Or maybe you just misspelled the name of the file. See |
| 1251 |
"require" in perlfunc and lib. |
| 1252 |
.ie n .IP "Can't locate auto/%s.al in @INC" 4 |
| 1253 |
.el .IP "Can't locate auto/%s.al in \f(CW@INC\fR" 4 |
| 1254 |
.IX Item "Can't locate auto/%s.al in @INC" |
| 1255 |
(F) A function (or method) was called in a package which allows |
| 1256 |
autoload, but there is no function to autoload. Most probable causes |
| 1257 |
are a misprint in a function/method name or a failure to \f(CW\*(C`AutoSplit\*(C'\fR |
| 1258 |
the file, say, by doing \f(CW\*(C`make install\*(C'\fR. |
| 1259 |
.ie n .IP "Can't locate loadable object for module %s in @INC" 4 |
| 1260 |
.el .IP "Can't locate loadable object for module \f(CW%s\fR in \f(CW@INC\fR" 4 |
| 1261 |
.IX Item "Can't locate loadable object for module %s in @INC" |
| 1262 |
(F) The module you loaded is trying to load an external library, like |
| 1263 |
for example, \fIfoo.so\fR or \fIbar.dll\fR, but the DynaLoader module was |
| 1264 |
unable to locate this library. See DynaLoader. |
| 1265 |
.IP "Can't locate object method ""%s"" via package ""%s""" 4 |
| 1266 |
.IX Item "Can't locate object method ""%s"" via package ""%s""" |
| 1267 |
(F) You called a method correctly, and it correctly indicated a package |
| 1268 |
functioning as a class, but that package doesn't define that particular |
| 1269 |
method, nor does any of its base classes. See perlobj. |
| 1270 |
.IP "Can't locate object method ""%s"" via package ""%s"" (perhaps you forgot to load ""%s""?)" 4 |
| 1271 |
.IX Item "Can't locate object method ""%s"" via package ""%s"" (perhaps you forgot to load ""%s""?)" |
| 1272 |
(F) You called a method on a class that did not exist, and the method |
| 1273 |
could not be found in UNIVERSAL. This often means that a method |
| 1274 |
requires a package that has not been loaded. |
| 1275 |
.ie n .IP "Can't locate object method ""INC"", nor ""INCDIR"" nor string overload via package ""%s"" %s in @INC" 4 |
| 1276 |
.el .IP "Can't locate object method ""INC"", nor ""INCDIR"" nor string overload via package ""%s"" \f(CW%s\fR in \f(CW@INC\fR" 4 |
| 1277 |
.IX Item "Can't locate object method ""INC"", nor ""INCDIR"" nor string overload via package ""%s"" %s in @INC" |
| 1278 |
(F) You pushed an object, either directly or via an array reference hook, |
| 1279 |
into \f(CW@INC\fR, but the object doesn't support any known hook methods, nor |
| 1280 |
a string overload and is also not a blessed CODE reference. In short the |
| 1281 |
\&\f(CW\*(C`require\*(C'\fR function does not know what to do with the object. |
| 1282 |
See also "require" in perlfunc. |
| 1283 |
.ie n .IP "Attempt to call undefined %s method with arguments (""%s""%s) via package ""%s"" (Perhaps you forgot to load the package?)" 4 |
| 1284 |
.el .IP "Attempt to call undefined \f(CW%s\fR method with arguments (""%s""%s) via package ""%s"" (Perhaps you forgot to load the package?)" 4 |
| 1285 |
.IX Item "Attempt to call undefined %s method with arguments (""%s""%s) via package ""%s"" (Perhaps you forgot to load the package?)" |
| 1286 |
(D deprecated::missing_import_called_with_args) You called the |
| 1287 |
\&\f(CWimport()\fR or \f(CWunimport()\fR method of a class that has no import method |
| 1288 |
defined in its inheritance graph, and passed an argument to the method. |
| 1289 |
This is very often the sign of a misspelled package name in a use or |
| 1290 |
require statement that has silently succeded due to a case insensitive |
| 1291 |
file system. |
| 1292 |
.Sp |
| 1293 |
Another common reason this may happen is when mistakenly attempting to |
| 1294 |
import or unimport a symbol from a class definition or package which |
| 1295 |
does not use \f(CW\*(C`Exporter\*(C'\fR or otherwise define its own \f(CW\*(C`import\*(C'\fR or |
| 1296 |
\&\f(CW\*(C`unimport\*(C'\fR method. |
| 1297 |
.ie n .IP "Can't locate package %s for @%s::ISA" 4 |
| 1298 |
.el .IP "Can't locate package \f(CW%s\fR for @%s::ISA" 4 |
| 1299 |
.IX Item "Can't locate package %s for @%s::ISA" |
| 1300 |
(W syntax) The \f(CW@ISA\fR array contained the name of another package that |
| 1301 |
doesn't seem to exist. |
| 1302 |
.IP "Can't locate PerlIO%s" 4 |
| 1303 |
.IX Item "Can't locate PerlIO%s" |
| 1304 |
(F) You tried to use in \fBopen()\fR a PerlIO layer that does not exist, |
| 1305 |
e.g. open(FH, ">:nosuchlayer", "somefile"). |
| 1306 |
.ie n .IP "Can't make list assignment to %ENV on this system" 4 |
| 1307 |
.el .IP "Can't make list assignment to \f(CW%ENV\fR on this system" 4 |
| 1308 |
.IX Item "Can't make list assignment to %ENV on this system" |
| 1309 |
(F) List assignment to \f(CW%ENV\fR is not supported on some systems, notably |
| 1310 |
VMS. |
| 1311 |
.ie n .IP "Can't make loaded symbols global on this platform while loading %s" 4 |
| 1312 |
.el .IP "Can't make loaded symbols global on this platform while loading \f(CW%s\fR" 4 |
| 1313 |
.IX Item "Can't make loaded symbols global on this platform while loading %s" |
| 1314 |
(S) A module passed the flag 0x01 to \fBDynaLoader::dl_load_file()\fR to request |
| 1315 |
that symbols from the stated file are made available globally within the |
| 1316 |
process, but that functionality is not available on this platform. Whilst |
| 1317 |
the module likely will still work, this may prevent the perl interpreter |
| 1318 |
from loading other XS-based extensions which need to link directly to |
| 1319 |
functions defined in the C or XS code in the stated file. |
| 1320 |
.ie n .IP "Can't modify %s in %s" 4 |
| 1321 |
.el .IP "Can't modify \f(CW%s\fR in \f(CW%s\fR" 4 |
| 1322 |
.IX Item "Can't modify %s in %s" |
| 1323 |
(F) You aren't allowed to assign to the item indicated, or otherwise try |
| 1324 |
to change it, such as with an auto-increment. |
| 1325 |
.IP "Can't modify non-lvalue subroutine call of &%s" 4 |
| 1326 |
.IX Item "Can't modify non-lvalue subroutine call of &%s" |
| 1327 |
.PD 0 |
| 1328 |
.ie n .IP "Can't modify non-lvalue subroutine call of &%s in %s" 4 |
| 1329 |
.el .IP "Can't modify non-lvalue subroutine call of &%s in \f(CW%s\fR" 4 |
| 1330 |
.IX Item "Can't modify non-lvalue subroutine call of &%s in %s" |
| 1331 |
.PD |
| 1332 |
(F) Subroutines meant to be used in lvalue context should be declared as |
| 1333 |
such. See "Lvalue subroutines" in perlsub. |
| 1334 |
.ie n .IP "Can't modify reference to %s in %s assignment" 4 |
| 1335 |
.el .IP "Can't modify reference to \f(CW%s\fR in \f(CW%s\fR assignment" 4 |
| 1336 |
.IX Item "Can't modify reference to %s in %s assignment" |
| 1337 |
(F) Only a limited number of constructs can be used as the argument to a |
| 1338 |
reference constructor on the left-hand side of an assignment, and what |
| 1339 |
you used was not one of them. See "Assigning to References" in perlref. |
| 1340 |
.IP "Can't modify reference to localized parenthesized array in list assignment" 4 |
| 1341 |
.IX Item "Can't modify reference to localized parenthesized array in list assignment" |
| 1342 |
(F) Assigning to \f(CW\*(C`\elocal(@array)\*(C'\fR or \f(CW\*(C`\e(local @array)\*(C'\fR is not supported, as |
| 1343 |
it is not clear exactly what it should do. If you meant to make \f(CW@array\fR |
| 1344 |
refer to some other array, use \f(CW\*(C`\e@array = \e@other_array\*(C'\fR. If you want to |
| 1345 |
make the elements of \f(CW@array\fR aliases of the scalars referenced on the |
| 1346 |
right-hand side, use \f(CW\*(C`\e(@array) = @scalar_refs\*(C'\fR. |
| 1347 |
.IP "Can't modify reference to parenthesized hash in list assignment" 4 |
| 1348 |
.IX Item "Can't modify reference to parenthesized hash in list assignment" |
| 1349 |
(F) Assigning to \f(CW\*(C`\e(%hash)\*(C'\fR is not supported. If you meant to make \f(CW%hash\fR |
| 1350 |
refer to some other hash, use \f(CW\*(C`\e%hash = \e%other_hash\*(C'\fR. If you want to |
| 1351 |
make the elements of \f(CW%hash\fR into aliases of the scalars referenced on the |
| 1352 |
right-hand side, use a hash slice: \f(CW\*(C`\e@hash{@keys} = @those_scalar_refs\*(C'\fR. |
| 1353 |
.IP "Can't msgrcv to read-only var" 4 |
| 1354 |
.IX Item "Can't msgrcv to read-only var" |
| 1355 |
(F) The target of a msgrcv must be modifiable to be used as a receive |
| 1356 |
buffer. |
| 1357 |
.IP "Can't ""next"" outside a loop block" 4 |
| 1358 |
.IX Item "Can't ""next"" outside a loop block" |
| 1359 |
(F) A "next" statement was executed to reiterate the current block, but |
| 1360 |
there isn't a current block. Note that an "if" or "else" block doesn't |
| 1361 |
count as a "loopish" block, as doesn't a block given to \fBsort()\fR, \fBmap()\fR or |
| 1362 |
\&\fBgrep()\fR. You can usually double the curlies to get the same effect |
| 1363 |
though, because the inner curlies will be considered a block that loops |
| 1364 |
once. See "next" in perlfunc. |
| 1365 |
.ie n .IP "Can't open %s: %s" 4 |
| 1366 |
.el .IP "Can't open \f(CW%s:\fR \f(CW%s\fR" 4 |
| 1367 |
.IX Item "Can't open %s: %s" |
| 1368 |
(S inplace) The implicit opening of a file through use of the \f(CW\*(C`<>\*(C'\fR |
| 1369 |
filehandle, either implicitly under the \f(CW\*(C`\-n\*(C'\fR or \f(CW\*(C`\-p\*(C'\fR command-line |
| 1370 |
switches, or explicitly, failed for the indicated reason. Usually |
| 1371 |
this is because you don't have read permission for a file which |
| 1372 |
you named on the command line. |
| 1373 |
.Sp |
| 1374 |
(F) You tried to call perl with the \fB\-e\fR switch, but \fI/dev/null\fR (or |
| 1375 |
your operating system's equivalent) could not be opened. |
| 1376 |
.IP "Can't open a reference" 4 |
| 1377 |
.IX Item "Can't open a reference" |
| 1378 |
(W io) You tried to open a scalar reference for reading or writing, |
| 1379 |
using the 3\-arg \fBopen()\fR syntax: |
| 1380 |
.Sp |
| 1381 |
.Vb 1 |
| 1382 |
\& open FH, \*(Aq>\*(Aq, $ref; |
| 1383 |
.Ve |
| 1384 |
.Sp |
| 1385 |
but your version of perl is compiled without perlio, and this form of |
| 1386 |
open is not supported. |
| 1387 |
.IP "Can't open bidirectional pipe" 4 |
| 1388 |
.IX Item "Can't open bidirectional pipe" |
| 1389 |
(W pipe) You tried to say \f(CW\*(C`open(CMD, "|cmd|")\*(C'\fR, which is not supported. |
| 1390 |
You can try any of several modules in the Perl library to do this, such |
| 1391 |
as IPC::Open2. Alternately, direct the pipe's output to a file using |
| 1392 |
">", and then read it in under a different file handle. |
| 1393 |
.ie n .IP "Can't open error file %s as stderr" 4 |
| 1394 |
.el .IP "Can't open error file \f(CW%s\fR as stderr" 4 |
| 1395 |
.IX Item "Can't open error file %s as stderr" |
| 1396 |
(F) An error peculiar to VMS. Perl does its own command line |
| 1397 |
redirection, and couldn't open the file specified after '2>' or '2>>' on |
| 1398 |
the command line for writing. |
| 1399 |
.ie n .IP "Can't open input file %s as stdin" 4 |
| 1400 |
.el .IP "Can't open input file \f(CW%s\fR as stdin" 4 |
| 1401 |
.IX Item "Can't open input file %s as stdin" |
| 1402 |
(F) An error peculiar to VMS. Perl does its own command line |
| 1403 |
redirection, and couldn't open the file specified after '<' on the |
| 1404 |
command line for reading. |
| 1405 |
.ie n .IP "Can't open output file %s as stdout" 4 |
| 1406 |
.el .IP "Can't open output file \f(CW%s\fR as stdout" 4 |
| 1407 |
.IX Item "Can't open output file %s as stdout" |
| 1408 |
(F) An error peculiar to VMS. Perl does its own command line |
| 1409 |
redirection, and couldn't open the file specified after '>' or '>>' on |
| 1410 |
the command line for writing. |
| 1411 |
.ie n .IP "Can't open output pipe (name: %s)" 4 |
| 1412 |
.el .IP "Can't open output pipe (name: \f(CW%s\fR)" 4 |
| 1413 |
.IX Item "Can't open output pipe (name: %s)" |
| 1414 |
(P) An error peculiar to VMS. Perl does its own command line |
| 1415 |
redirection, and couldn't open the pipe into which to send data destined |
| 1416 |
for stdout. |
| 1417 |
.ie n .IP "Can't open perl script ""%s"": %s" 4 |
| 1418 |
.el .IP "Can't open perl script ""%s"": \f(CW%s\fR" 4 |
| 1419 |
.IX Item "Can't open perl script ""%s"": %s" |
| 1420 |
(F) The script you specified can't be opened for the indicated reason. |
| 1421 |
.Sp |
| 1422 |
If you're debugging a script that uses #!, and normally relies on the |
| 1423 |
shell's \f(CW$PATH\fR search, the \-S option causes perl to do that search, so |
| 1424 |
you don't have to type the path or \f(CW\`which $scriptname\`\fR. |
| 1425 |
.IP "Can't read CRTL environ" 4 |
| 1426 |
.IX Item "Can't read CRTL environ" |
| 1427 |
(S) A warning peculiar to VMS. Perl tried to read an element of \f(CW%ENV\fR |
| 1428 |
from the CRTL's internal environment array and discovered the array was |
| 1429 |
missing. You need to figure out where your CRTL misplaced its environ |
| 1430 |
or define \fIPERL_ENV_TABLES\fR (see perlvms) so that environ is not |
| 1431 |
searched. |
| 1432 |
.IP "Can't redeclare ""%s"" in ""%s""" 4 |
| 1433 |
.IX Item "Can't redeclare ""%s"" in ""%s""" |
| 1434 |
(F) A "my", "our" or "state" declaration was found within another declaration, |
| 1435 |
such as \f(CW\*(C`my ($x, my($y), $z)\*(C'\fR or \f(CW\*(C`our (my $x)\*(C'\fR. |
| 1436 |
.IP "Can't ""redo"" outside a loop block" 4 |
| 1437 |
.IX Item "Can't ""redo"" outside a loop block" |
| 1438 |
(F) A "redo" statement was executed to restart the current block, but |
| 1439 |
there isn't a current block. Note that an "if" or "else" block doesn't |
| 1440 |
count as a "loopish" block, as doesn't a block given to \fBsort()\fR, \fBmap()\fR |
| 1441 |
or \fBgrep()\fR. You can usually double the curlies to get the same effect |
| 1442 |
though, because the inner curlies will be considered a block that |
| 1443 |
loops once. See "redo" in perlfunc. |
| 1444 |
.ie n .IP "Can't remove %s: %s, skipping file" 4 |
| 1445 |
.el .IP "Can't remove \f(CW%s:\fR \f(CW%s\fR, skipping file" 4 |
| 1446 |
.IX Item "Can't remove %s: %s, skipping file" |
| 1447 |
(S inplace) You requested an inplace edit without creating a backup |
| 1448 |
file. Perl was unable to remove the original file to replace it with |
| 1449 |
the modified file. The file was left unmodified. |
| 1450 |
.ie n .IP "Can't rename in-place work file '%s' to '%s': %s" 4 |
| 1451 |
.el .IP "Can't rename in-place work file '%s' to '%s': \f(CW%s\fR" 4 |
| 1452 |
.IX Item "Can't rename in-place work file '%s' to '%s': %s" |
| 1453 |
(F) When closed implicitly, the temporary file for in-place editing |
| 1454 |
couldn't be renamed to the original filename. |
| 1455 |
.ie n .IP "Can't rename %s to %s: %s, skipping file" 4 |
| 1456 |
.el .IP "Can't rename \f(CW%s\fR to \f(CW%s:\fR \f(CW%s\fR, skipping file" 4 |
| 1457 |
.IX Item "Can't rename %s to %s: %s, skipping file" |
| 1458 |
(F) The rename done by the \fB\-i\fR switch failed for some reason, |
| 1459 |
probably because you don't have write permission to the directory. |
| 1460 |
.ie n .IP "Can't reopen input pipe (name: %s) in binary mode" 4 |
| 1461 |
.el .IP "Can't reopen input pipe (name: \f(CW%s\fR) in binary mode" 4 |
| 1462 |
.IX Item "Can't reopen input pipe (name: %s) in binary mode" |
| 1463 |
(P) An error peculiar to VMS. Perl thought stdin was a pipe, and tried |
| 1464 |
to reopen it to accept binary data. Alas, it failed. |
| 1465 |
.IP "Can't represent character for Ox%X on this platform" 4 |
| 1466 |
.IX Item "Can't represent character for Ox%X on this platform" |
| 1467 |
(F) There is a hard limit to how big a character code point can be due |
| 1468 |
to the fundamental properties of UTF\-8, especially on EBCDIC |
| 1469 |
platforms. The given code point exceeds that. The only work-around is |
| 1470 |
to not use such a large code point. |
| 1471 |
.ie n .IP "Can't reset %ENV on this system" 4 |
| 1472 |
.el .IP "Can't reset \f(CW%ENV\fR on this system" 4 |
| 1473 |
.IX Item "Can't reset %ENV on this system" |
| 1474 |
(F) You called \f(CWreset(\*(AqE\*(Aq)\fR or similar, which tried to reset |
| 1475 |
all variables in the current package beginning with "E". In |
| 1476 |
the main package, that includes \f(CW%ENV\fR. Resetting \f(CW%ENV\fR is not |
| 1477 |
supported on some systems, notably VMS. |
| 1478 |
.IP "Can't resolve method ""%s"" overloading ""%s"" in package ""%s""" 4 |
| 1479 |
.IX Item "Can't resolve method ""%s"" overloading ""%s"" in package ""%s""" |
| 1480 |
(F)(P) Error resolving overloading specified by a method name (as |
| 1481 |
opposed to a subroutine reference): no such method callable via the |
| 1482 |
package. If the method name is \f(CW\*(C`???\*(C'\fR, this is an internal error. |
| 1483 |
.ie n .IP "Can't return %s from lvalue subroutine" 4 |
| 1484 |
.el .IP "Can't return \f(CW%s\fR from lvalue subroutine" 4 |
| 1485 |
.IX Item "Can't return %s from lvalue subroutine" |
| 1486 |
(F) Perl detected an attempt to return illegal lvalues (such as |
| 1487 |
temporary or readonly values) from a subroutine used as an lvalue. This |
| 1488 |
is not allowed. |
| 1489 |
.IP "Can't return outside a subroutine" 4 |
| 1490 |
.IX Item "Can't return outside a subroutine" |
| 1491 |
(F) The return statement was executed in mainline code, that is, where |
| 1492 |
there was no subroutine call to return out of. See perlsub. |
| 1493 |
.ie n .IP "Can't return %s to lvalue scalar context" 4 |
| 1494 |
.el .IP "Can't return \f(CW%s\fR to lvalue scalar context" 4 |
| 1495 |
.IX Item "Can't return %s to lvalue scalar context" |
| 1496 |
(F) You tried to return a complete array or hash from an lvalue |
| 1497 |
subroutine, but you called the subroutine in a way that made Perl |
| 1498 |
think you meant to return only one value. You probably meant to |
| 1499 |
write parentheses around the call to the subroutine, which tell |
| 1500 |
Perl that the call should be in list context. |
| 1501 |
.ie n .IP "Can't take log of %g" 4 |
| 1502 |
.el .IP "Can't take log of \f(CW%g\fR" 4 |
| 1503 |
.IX Item "Can't take log of %g" |
| 1504 |
(F) For ordinary real numbers, you can't take the logarithm of a |
| 1505 |
negative number or zero. There's a Math::Complex package that comes |
| 1506 |
standard with Perl, though, if you really want to do that for the |
| 1507 |
negative numbers. |
| 1508 |
.ie n .IP "Can't take sqrt of %g" 4 |
| 1509 |
.el .IP "Can't take sqrt of \f(CW%g\fR" 4 |
| 1510 |
.IX Item "Can't take sqrt of %g" |
| 1511 |
(F) For ordinary real numbers, you can't take the square root of a |
| 1512 |
negative number. There's a Math::Complex package that comes standard |
| 1513 |
with Perl, though, if you really want to do that. |
| 1514 |
.IP "Can't undef active subroutine" 4 |
| 1515 |
.IX Item "Can't undef active subroutine" |
| 1516 |
(F) You can't undefine a routine that's currently running. You can, |
| 1517 |
however, redefine it while it's running, and you can even undef the |
| 1518 |
redefined subroutine while the old routine is running. Go figure. |
| 1519 |
.IP "Can't unweaken a nonreference" 4 |
| 1520 |
.IX Item "Can't unweaken a nonreference" |
| 1521 |
(F) You attempted to unweaken something that was not a reference. Only |
| 1522 |
references can be unweakened. |
| 1523 |
.ie n .IP "Can't upgrade %s (%d) to %d" 4 |
| 1524 |
.el .IP "Can't upgrade \f(CW%s\fR (%d) to \f(CW%d\fR" 4 |
| 1525 |
.IX Item "Can't upgrade %s (%d) to %d" |
| 1526 |
(P) The internal sv_upgrade routine adds "members" to an SV, making it |
| 1527 |
into a more specialized kind of SV. The top several SV types are so |
| 1528 |
specialized, however, that they cannot be interconverted. This message |
| 1529 |
indicates that such a conversion was attempted. |
| 1530 |
.IP "Can't use '%c' after \-mname" 4 |
| 1531 |
.IX Item "Can't use '%c' after -mname" |
| 1532 |
(F) You tried to call perl with the \fB\-m\fR switch, but you put something |
| 1533 |
other than "=" after the module name. |
| 1534 |
.IP "Can't use a hash as a reference" 4 |
| 1535 |
.IX Item "Can't use a hash as a reference" |
| 1536 |
(F) You tried to use a hash as a reference, as in |
| 1537 |
\&\f(CW\*(C`%foo\->{"bar"}\*(C'\fR or \f(CW\*(C`%$ref\->{"hello"}\*(C'\fR. Versions of perl |
| 1538 |
<= 5.22.0 used to allow this syntax, but shouldn't |
| 1539 |
have. This was deprecated in perl 5.6.1. |
| 1540 |
.IP "Can't use an array as a reference" 4 |
| 1541 |
.IX Item "Can't use an array as a reference" |
| 1542 |
(F) You tried to use an array as a reference, as in |
| 1543 |
\&\f(CW\*(C`@foo\->[23]\*(C'\fR or \f(CW\*(C`@$ref\->[99]\*(C'\fR. Versions of perl <= 5.22.0 |
| 1544 |
used to allow this syntax, but shouldn't have. This |
| 1545 |
was deprecated in perl 5.6.1. |
| 1546 |
.IP "Can't use anonymous symbol table for method lookup" 4 |
| 1547 |
.IX Item "Can't use anonymous symbol table for method lookup" |
| 1548 |
(F) The internal routine that does method lookup was handed a symbol |
| 1549 |
table that doesn't have a name. Symbol tables can become anonymous |
| 1550 |
for example by undefining stashes: \f(CW\*(C`undef %Some::Package::\*(C'\fR. |
| 1551 |
.ie n .IP "Can't use an undefined value as %s reference" 4 |
| 1552 |
.el .IP "Can't use an undefined value as \f(CW%s\fR reference" 4 |
| 1553 |
.IX Item "Can't use an undefined value as %s reference" |
| 1554 |
(F) A value used as either a hard reference or a symbolic reference must |
| 1555 |
be a defined value. This helps to delurk some insidious errors. |
| 1556 |
.ie n .IP "Can't use bareword (""%s"") as %s ref while ""strict refs"" in use" 4 |
| 1557 |
.el .IP "Can't use bareword (""%s"") as \f(CW%s\fR ref while ""strict refs"" in use" 4 |
| 1558 |
.IX Item "Can't use bareword (""%s"") as %s ref while ""strict refs"" in use" |
| 1559 |
(F) Only hard references are allowed by "strict refs". Symbolic |
| 1560 |
references are disallowed. See perlref. |
| 1561 |
.IP "Can't use %! because Errno.pm is not available" 4 |
| 1562 |
.IX Item "Can't use %! because Errno.pm is not available" |
| 1563 |
(F) The first time the \f(CW\*(C`%!\*(C'\fR hash is used, perl automatically loads the |
| 1564 |
Errno.pm module. The Errno module is expected to tie the %! hash to |
| 1565 |
provide symbolic names for \f(CW$!\fR errno values. |
| 1566 |
.ie n .IP "Can't use both '<' and '>' after type '%c' in %s" 4 |
| 1567 |
.el .IP "Can't use both '<' and '>' after type '%c' in \f(CW%s\fR" 4 |
| 1568 |
.IX Item "Can't use both '<' and '>' after type '%c' in %s" |
| 1569 |
(F) A type cannot be forced to have both big-endian and little-endian |
| 1570 |
byte-order at the same time, so this combination of modifiers is not |
| 1571 |
allowed. See "pack" in perlfunc. |
| 1572 |
.IP "Can't use 'defined(@array)' (Maybe you should just omit the \fBdefined()\fR?)" 4 |
| 1573 |
.IX Item "Can't use 'defined(@array)' (Maybe you should just omit the defined()?)" |
| 1574 |
(F) \fBdefined()\fR is not useful on arrays because it |
| 1575 |
checks for an undefined \fIscalar\fR value. If you want to see if the |
| 1576 |
array is empty, just use \f(CW\*(C`if (@array) { # not empty }\*(C'\fR for example. |
| 1577 |
.IP "Can't use 'defined(%hash)' (Maybe you should just omit the \fBdefined()\fR?)" 4 |
| 1578 |
.IX Item "Can't use 'defined(%hash)' (Maybe you should just omit the defined()?)" |
| 1579 |
(F) \f(CWdefined()\fR is not usually right on hashes. |
| 1580 |
.Sp |
| 1581 |
Although \f(CW\*(C`defined %hash\*(C'\fR is false on a plain not-yet-used hash, it |
| 1582 |
becomes true in several non-obvious circumstances, including iterators, |
| 1583 |
weak references, stash names, even remaining true after \f(CW\*(C`undef %hash\*(C'\fR. |
| 1584 |
These things make \f(CW\*(C`defined %hash\*(C'\fR fairly useless in practice, so it now |
| 1585 |
generates a fatal error. |
| 1586 |
.Sp |
| 1587 |
If a check for non-empty is what you wanted then just put it in boolean |
| 1588 |
context (see "Scalar values" in perldata): |
| 1589 |
.Sp |
| 1590 |
.Vb 3 |
| 1591 |
\& if (%hash) { |
| 1592 |
\& # not empty |
| 1593 |
\& } |
| 1594 |
.Ve |
| 1595 |
.Sp |
| 1596 |
If you had \f(CW\*(C`defined %Foo::Bar::QUUX\*(C'\fR to check whether such a package |
| 1597 |
variable exists then that's never really been reliable, and isn't |
| 1598 |
a good way to enquire about the features of a package, or whether |
| 1599 |
it's loaded, etc. |
| 1600 |
.ie n .IP "Can't use %s for loop variable" 4 |
| 1601 |
.el .IP "Can't use \f(CW%s\fR for loop variable" 4 |
| 1602 |
.IX Item "Can't use %s for loop variable" |
| 1603 |
(P) The parser got confused when trying to parse a \f(CW\*(C`foreach\*(C'\fR loop. |
| 1604 |
.ie n .IP "Can't use global %s in %s" 4 |
| 1605 |
.el .IP "Can't use global \f(CW%s\fR in \f(CW%s\fR" 4 |
| 1606 |
.IX Item "Can't use global %s in %s" |
| 1607 |
(F) You tried to declare a magical variable as a lexical variable. This |
| 1608 |
is not allowed, because the magic can be tied to only one location |
| 1609 |
(namely the global variable) and it would be incredibly confusing to |
| 1610 |
have variables in your program that looked like magical variables but |
| 1611 |
weren't. |
| 1612 |
.ie n .IP "Can't use '%c' in a group with different byte-order in %s" 4 |
| 1613 |
.el .IP "Can't use '%c' in a group with different byte-order in \f(CW%s\fR" 4 |
| 1614 |
.IX Item "Can't use '%c' in a group with different byte-order in %s" |
| 1615 |
(F) You attempted to force a different byte-order on a type |
| 1616 |
that is already inside a group with a byte-order modifier. |
| 1617 |
For example you cannot force little-endianness on a type that |
| 1618 |
is inside a big-endian group. |
| 1619 |
.ie n .IP "Can't use ""my %s"" in sort comparison" 4 |
| 1620 |
.el .IP "Can't use ""my \f(CW%s\fR"" in sort comparison" 4 |
| 1621 |
.IX Item "Can't use ""my %s"" in sort comparison" |
| 1622 |
(F) The global variables \f(CW$a\fR and \f(CW$b\fR are reserved for sort comparisons. |
| 1623 |
You mentioned \f(CW$a\fR or \f(CW$b\fR in the same line as the <=> or cmp operator, |
| 1624 |
and the variable had earlier been declared as a lexical variable. |
| 1625 |
Either qualify the sort variable with the package name, or rename the |
| 1626 |
lexical variable. |
| 1627 |
.ie n .IP "Can't use %s ref as %s ref" 4 |
| 1628 |
.el .IP "Can't use \f(CW%s\fR ref as \f(CW%s\fR ref" 4 |
| 1629 |
.IX Item "Can't use %s ref as %s ref" |
| 1630 |
(F) You've mixed up your reference types. You have to dereference a |
| 1631 |
reference of the type needed. You can use the \fBref()\fR function to |
| 1632 |
test the type of the reference, if need be. |
| 1633 |
.ie n .IP "Can't use string (""%s"") as %s ref while ""strict refs"" in use" 4 |
| 1634 |
.el .IP "Can't use string (""%s"") as \f(CW%s\fR ref while ""strict refs"" in use" 4 |
| 1635 |
.IX Item "Can't use string (""%s"") as %s ref while ""strict refs"" in use" |
| 1636 |
.PD 0 |
| 1637 |
.ie n .IP "Can't use string (""%s""...) as %s ref while ""strict refs"" in use" 4 |
| 1638 |
.el .IP "Can't use string (""%s""...) as \f(CW%s\fR ref while ""strict refs"" in use" 4 |
| 1639 |
.IX Item "Can't use string (""%s""...) as %s ref while ""strict refs"" in use" |
| 1640 |
.PD |
| 1641 |
(F) You've told Perl to dereference a string, something which |
| 1642 |
\&\f(CW\*(C`use strict\*(C'\fR blocks to prevent it happening accidentally. See |
| 1643 |
"Symbolic references" in perlref. This can be triggered by an \f(CW\*(C`@\*(C'\fR or \f(CW\*(C`$\*(C'\fR |
| 1644 |
in a double-quoted string immediately before interpolating a variable, |
| 1645 |
for example in \f(CW"user @$twitter_id"\fR, which says to treat the contents |
| 1646 |
of \f(CW$twitter_id\fR as an array reference; use a \f(CW\*(C`\e\*(C'\fR to have a literal \f(CW\*(C`@\*(C'\fR |
| 1647 |
symbol followed by the contents of \f(CW$twitter_id\fR: \f(CW"user \e@$twitter_id"\fR. |
| 1648 |
.ie n .IP "Can't use subscript on %s" 4 |
| 1649 |
.el .IP "Can't use subscript on \f(CW%s\fR" 4 |
| 1650 |
.IX Item "Can't use subscript on %s" |
| 1651 |
(F) The compiler tried to interpret a bracketed expression as a |
| 1652 |
subscript. But to the left of the brackets was an expression that |
| 1653 |
didn't look like a hash or array reference, or anything else subscriptable. |
| 1654 |
.IP "Can't use \e%c to mean $%c in expression" 4 |
| 1655 |
.IX Item "Can't use %c to mean $%c in expression" |
| 1656 |
(W syntax) In an ordinary expression, backslash is a unary operator that |
| 1657 |
creates a reference to its argument. The use of backslash to indicate a |
| 1658 |
backreference to a matched substring is valid only as part of a regular |
| 1659 |
expression pattern. Trying to do this in ordinary Perl code produces a |
| 1660 |
value that prints out looking like \fBSCALAR\fR\|(0xdecaf). Use the \f(CW$1\fR form |
| 1661 |
instead. |
| 1662 |
.IP "Can't weaken a nonreference" 4 |
| 1663 |
.IX Item "Can't weaken a nonreference" |
| 1664 |
(F) You attempted to weaken something that was not a reference. Only |
| 1665 |
references can be weakened. |
| 1666 |
.IP "Can't ""when"" outside a topicalizer" 4 |
| 1667 |
.IX Item "Can't ""when"" outside a topicalizer" |
| 1668 |
(F) You have used a \fBwhen()\fR block that is neither inside a \f(CW\*(C`foreach\*(C'\fR |
| 1669 |
loop nor a \f(CW\*(C`given\*(C'\fR block. (Note that this error is issued on exit |
| 1670 |
from the \f(CW\*(C`when\*(C'\fR block, so you won't get the error if the match fails, |
| 1671 |
or if you use an explicit \f(CW\*(C`continue\*(C'\fR.) |
| 1672 |
.IP "Can't x= to read-only value" 4 |
| 1673 |
.IX Item "Can't x= to read-only value" |
| 1674 |
(F) You tried to repeat a constant value (often the undefined value) |
| 1675 |
with an assignment operator, which implies modifying the value itself. |
| 1676 |
Perhaps you need to copy the value to a temporary, and repeat that. |
| 1677 |
.IP "catch block requires a (VAR)" 4 |
| 1678 |
.IX Item "catch block requires a (VAR)" |
| 1679 |
(F) You tried to use the \f(CW\*(C`try\*(C'\fR and \f(CW\*(C`catch\*(C'\fR syntax of \f(CW\*(C`use feature \*(Aqtry\*(Aq\*(C'\fR |
| 1680 |
but did not include the error variable in the \f(CW\*(C`catch\*(C'\fR block. The |
| 1681 |
parenthesized variable name is not optional, unlike in some other forms of |
| 1682 |
syntax you may be familiar with from CPAN modules or other languages. |
| 1683 |
.Sp |
| 1684 |
The required syntax is |
| 1685 |
.Sp |
| 1686 |
.Vb 2 |
| 1687 |
\& try { ... } |
| 1688 |
\& catch ($var) { ... } |
| 1689 |
.Ve |
| 1690 |
.IP "Changing use VERSION while another use VERSION is in scope is now deprecated" 4 |
| 1691 |
.IX Item "Changing use VERSION while another use VERSION is in scope is now deprecated" |
| 1692 |
(W deprecated) Once you have a \f(CW\*(C`use VERSION\*(C'\fR statement in scope, any |
| 1693 |
\&\f(CW\*(C`use VERSION\*(C'\fR statement that requests a different version is now deprecated, |
| 1694 |
due to the increasing complexity of swapping from one prevailing version to |
| 1695 |
another. |
| 1696 |
.Sp |
| 1697 |
It is suggested that you do not try to mix multiple different version |
| 1698 |
declarations within the same file as it leads to complex behaviours about the |
| 1699 |
visibility of features and builtin functions, as well as confusing human |
| 1700 |
readers. |
| 1701 |
.Sp |
| 1702 |
If it is essential to have different \f(CW\*(C`use VERSION\*(C'\fR declarations in different |
| 1703 |
regions of the same file, you should surround each one by its own enclosing |
| 1704 |
scope so the two do not mix. |
| 1705 |
.Sp |
| 1706 |
.Vb 8 |
| 1707 |
\& { |
| 1708 |
\& use v5.20; |
| 1709 |
\& ... |
| 1710 |
\& } |
| 1711 |
\& { |
| 1712 |
\& use v5.36; |
| 1713 |
\& ... |
| 1714 |
\& } |
| 1715 |
.Ve |
| 1716 |
.IP "Character following ""\ec"" must be printable ASCII" 4 |
| 1717 |
.IX Item "Character following ""c"" must be printable ASCII" |
| 1718 |
(F) In \f(CW\*(C`\ec\fR\f(CIX\fR\f(CW\*(C'\fR, \fIX\fR must be a printable (non-control) ASCII character. |
| 1719 |
.Sp |
| 1720 |
Note that ASCII characters that don't map to control characters are |
| 1721 |
discouraged, and will generate the warning (when enabled) |
| 1722 |
""\ec%c" is more clearly written simply as "%s"". |
| 1723 |
.IP "Character following \e%c must be '{' or a single-character Unicode property name in regex; marked by <\-\- HERE in m/%s/" 4 |
| 1724 |
.IX Item "Character following %c must be '{' or a single-character Unicode property name in regex; marked by <-- HERE in m/%s/" |
| 1725 |
(F) (In the above the \f(CW%c\fR is replaced by either \f(CW\*(C`p\*(C'\fR or \f(CW\*(C`P\*(C'\fR.) You |
| 1726 |
specified something that isn't a legal Unicode property name. Most |
| 1727 |
Unicode properties are specified by \f(CW\*(C`\ep{...}\*(C'\fR. But if the name is a |
| 1728 |
single character one, the braces may be omitted. |
| 1729 |
.IP "Character in 'C' format wrapped in pack" 4 |
| 1730 |
.IX Item "Character in 'C' format wrapped in pack" |
| 1731 |
(W pack) You said |
| 1732 |
.Sp |
| 1733 |
.Vb 1 |
| 1734 |
\& pack("C", $x) |
| 1735 |
.Ve |
| 1736 |
.Sp |
| 1737 |
where \f(CW$x\fR is either less than 0 or more than 255; the \f(CW"C"\fR format is |
| 1738 |
only for encoding native operating system characters (ASCII, EBCDIC, |
| 1739 |
and so on) and not for Unicode characters, so Perl behaved as if you meant |
| 1740 |
.Sp |
| 1741 |
.Vb 1 |
| 1742 |
\& pack("C", $x & 255) |
| 1743 |
.Ve |
| 1744 |
.Sp |
| 1745 |
If you actually want to pack Unicode codepoints, use the \f(CW"U"\fR format |
| 1746 |
instead. |
| 1747 |
.IP "Character in 'c' format wrapped in pack" 4 |
| 1748 |
.IX Item "Character in 'c' format wrapped in pack" |
| 1749 |
(W pack) You said |
| 1750 |
.Sp |
| 1751 |
.Vb 1 |
| 1752 |
\& pack("c", $x) |
| 1753 |
.Ve |
| 1754 |
.Sp |
| 1755 |
where \f(CW$x\fR is either less than \-128 or more than 127; the \f(CW"c"\fR format |
| 1756 |
is only for encoding native operating system characters (ASCII, EBCDIC, |
| 1757 |
and so on) and not for Unicode characters, so Perl behaved as if you meant |
| 1758 |
.Sp |
| 1759 |
.Vb 1 |
| 1760 |
\& pack("c", $x & 255); |
| 1761 |
.Ve |
| 1762 |
.Sp |
| 1763 |
If you actually want to pack Unicode codepoints, use the \f(CW"U"\fR format |
| 1764 |
instead. |
| 1765 |
.IP "Character in '%c' format wrapped in unpack" 4 |
| 1766 |
.IX Item "Character in '%c' format wrapped in unpack" |
| 1767 |
(W unpack) You tried something like |
| 1768 |
.Sp |
| 1769 |
.Vb 1 |
| 1770 |
\& unpack("H", "\ex{2a1}") |
| 1771 |
.Ve |
| 1772 |
.Sp |
| 1773 |
where the format expects to process a byte (a character with a value |
| 1774 |
below 256), but a higher value was provided instead. Perl uses the |
| 1775 |
value modulus 256 instead, as if you had provided: |
| 1776 |
.Sp |
| 1777 |
.Vb 1 |
| 1778 |
\& unpack("H", "\ex{a1}") |
| 1779 |
.Ve |
| 1780 |
.IP "Character in 'W' format wrapped in pack" 4 |
| 1781 |
.IX Item "Character in 'W' format wrapped in pack" |
| 1782 |
(W pack) You said |
| 1783 |
.Sp |
| 1784 |
.Vb 1 |
| 1785 |
\& pack("U0W", $x) |
| 1786 |
.Ve |
| 1787 |
.Sp |
| 1788 |
where \f(CW$x\fR is either less than 0 or more than 255. However, \f(CW\*(C`U0\*(C'\fR\-mode |
| 1789 |
expects all values to fall in the interval [0, 255], so Perl behaved |
| 1790 |
as if you meant: |
| 1791 |
.Sp |
| 1792 |
.Vb 1 |
| 1793 |
\& pack("U0W", $x & 255) |
| 1794 |
.Ve |
| 1795 |
.IP "Character(s) in '%c' format wrapped in pack" 4 |
| 1796 |
.IX Item "Character(s) in '%c' format wrapped in pack" |
| 1797 |
(W pack) You tried something like |
| 1798 |
.Sp |
| 1799 |
.Vb 1 |
| 1800 |
\& pack("u", "\ex{1f3}b") |
| 1801 |
.Ve |
| 1802 |
.Sp |
| 1803 |
where the format expects to process a sequence of bytes (character with a |
| 1804 |
value below 256), but some of the characters had a higher value. Perl |
| 1805 |
uses the character values modulus 256 instead, as if you had provided: |
| 1806 |
.Sp |
| 1807 |
.Vb 1 |
| 1808 |
\& pack("u", "\ex{f3}b") |
| 1809 |
.Ve |
| 1810 |
.IP "Character(s) in '%c' format wrapped in unpack" 4 |
| 1811 |
.IX Item "Character(s) in '%c' format wrapped in unpack" |
| 1812 |
(W unpack) You tried something like |
| 1813 |
.Sp |
| 1814 |
.Vb 1 |
| 1815 |
\& unpack("s", "\ex{1f3}b") |
| 1816 |
.Ve |
| 1817 |
.Sp |
| 1818 |
where the format expects to process a sequence of bytes (character with a |
| 1819 |
value below 256), but some of the characters had a higher value. Perl |
| 1820 |
uses the character values modulus 256 instead, as if you had provided: |
| 1821 |
.Sp |
| 1822 |
.Vb 1 |
| 1823 |
\& unpack("s", "\ex{f3}b") |
| 1824 |
.Ve |
| 1825 |
.ie n .IP "charnames alias definitions may not contain a sequence of multiple spaces; marked by <\-\-\ HERE in %s" 4 |
| 1826 |
.el .IP "charnames alias definitions may not contain a sequence of multiple spaces; marked by <\-\-\ HERE in \f(CW%s\fR" 4 |
| 1827 |
.IX Item "charnames alias definitions may not contain a sequence of multiple spaces; marked by <--\ HERE in %s" |
| 1828 |
(F) You defined a character name which had multiple space characters |
| 1829 |
in a row. Change them to single spaces. Usually these names are |
| 1830 |
defined in the \f(CW\*(C`:alias\*(C'\fR import argument to \f(CW\*(C`use charnames\*(C'\fR, but they |
| 1831 |
could be defined by a translator installed into \f(CW$^H{charnames}\fR. See |
| 1832 |
"CUSTOM ALIASES" in charnames. |
| 1833 |
.ie n .IP "\fBchdir()\fR on unopened filehandle %s" 4 |
| 1834 |
.el .IP "\fBchdir()\fR on unopened filehandle \f(CW%s\fR" 4 |
| 1835 |
.IX Item "chdir() on unopened filehandle %s" |
| 1836 |
(W unopened) You tried \fBchdir()\fR on a filehandle that was never opened. |
| 1837 |
.IP """\ec%c"" is more clearly written simply as ""%s""" 4 |
| 1838 |
.IX Item """c%c"" is more clearly written simply as ""%s""" |
| 1839 |
(W syntax) The \f(CW\*(C`\ec\fR\f(CIX\fR\f(CW\*(C'\fR construct is intended to be a way to specify |
| 1840 |
non-printable characters. You used it for a printable one, which |
| 1841 |
is better written as simply itself, perhaps preceded by a backslash |
| 1842 |
for non-word characters. Doing it the way you did is not portable |
| 1843 |
between ASCII and EBCDIC platforms. |
| 1844 |
.IP "Class already has a superclass, cannot add another" 4 |
| 1845 |
.IX Item "Class already has a superclass, cannot add another" |
| 1846 |
(F) You attempted to specify a second superclass for a \f(CW\*(C`class\*(C'\fR by using |
| 1847 |
the \f(CW\*(C`:isa\*(C'\fR attribute, when one is already specified. Unlike classes |
| 1848 |
whose instances are created with \f(CW\*(C`bless\*(C'\fR, classes created via the |
| 1849 |
\&\f(CW\*(C`class\*(C'\fR keyword cannot have more than one superclass. |
| 1850 |
.ie n .IP "Class attribute %s requires a value" 4 |
| 1851 |
.el .IP "Class attribute \f(CW%s\fR requires a value" 4 |
| 1852 |
.IX Item "Class attribute %s requires a value" |
| 1853 |
(F) You specified an attribute for a class that would require a value to |
| 1854 |
be passed in parentheses, but did not provide one. Remember that |
| 1855 |
whitespace is \fBnot\fR permitted between the attribute name and its value; |
| 1856 |
you must write this as |
| 1857 |
.Sp |
| 1858 |
.Vb 1 |
| 1859 |
\& class Example::Class :attr(VALUE) ... |
| 1860 |
.Ve |
| 1861 |
.IP "class is experimental" 4 |
| 1862 |
.IX Item "class is experimental" |
| 1863 |
(S experimental::class) This warning is emitted if you use the \f(CW\*(C`class\*(C'\fR |
| 1864 |
keyword of \f(CW\*(C`use feature \*(Aqclass\*(Aq\*(C'\fR. This keyword is currently |
| 1865 |
experimental and its behaviour may change in future releases of Perl. |
| 1866 |
.IP "Class :isa attribute requires a class but ""%s"" is not one" 4 |
| 1867 |
.IX Item "Class :isa attribute requires a class but ""%s"" is not one" |
| 1868 |
(F) When creating a subclass using the \f(CW\*(C`class\*(C'\fR \f(CW\*(C`:isa\*(C'\fR attribute, the |
| 1869 |
named superclass must also be a real class created using the \f(CW\*(C`class\*(C'\fR |
| 1870 |
keyword. |
| 1871 |
.IP "Cloning substitution context is unimplemented" 4 |
| 1872 |
.IX Item "Cloning substitution context is unimplemented" |
| 1873 |
(F) Creating a new thread inside the \f(CW\*(C`s///\*(C'\fR operator is not supported. |
| 1874 |
.ie n .IP "\fBclosedir()\fR attempted on invalid dirhandle %s" 4 |
| 1875 |
.el .IP "\fBclosedir()\fR attempted on invalid dirhandle \f(CW%s\fR" 4 |
| 1876 |
.IX Item "closedir() attempted on invalid dirhandle %s" |
| 1877 |
(W io) The dirhandle you tried to close is either closed or not really |
| 1878 |
a dirhandle. Check your control flow. |
| 1879 |
.ie n .IP "\fBclose()\fR on unopened filehandle %s" 4 |
| 1880 |
.el .IP "\fBclose()\fR on unopened filehandle \f(CW%s\fR" 4 |
| 1881 |
.IX Item "close() on unopened filehandle %s" |
| 1882 |
(W unopened) You tried to close a filehandle that was never opened. |
| 1883 |
.IP "Closure prototype called" 4 |
| 1884 |
.IX Item "Closure prototype called" |
| 1885 |
(F) If a closure has attributes, the subroutine passed to an attribute |
| 1886 |
handler is the prototype that is cloned when a new closure is created. |
| 1887 |
This subroutine cannot be called. |
| 1888 |
.IP "\eC no longer supported in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 1889 |
.IX Item "C no longer supported in regex; marked by <--\ HERE in m/%s/" |
| 1890 |
(F) The \eC character class used to allow a match of single byte |
| 1891 |
within a multi-byte utf\-8 character, but was removed in v5.24 as |
| 1892 |
it broke encapsulation and its implementation was extremely buggy. |
| 1893 |
If you really need to process the individual bytes, you probably |
| 1894 |
want to convert your string to one where each underlying byte is |
| 1895 |
stored as a character, with \fButf8::encode()\fR. |
| 1896 |
.IP "Code missing after '/'" 4 |
| 1897 |
.IX Item "Code missing after '/'" |
| 1898 |
(F) You had a (sub\-)template that ends with a '/'. There must be |
| 1899 |
another template code following the slash. See "pack" in perlfunc. |
| 1900 |
.IP "Code point 0x%X is not Unicode, and not portable" 4 |
| 1901 |
.IX Item "Code point 0x%X is not Unicode, and not portable" |
| 1902 |
(S non_unicode portable) You had a code point that has never been in any |
| 1903 |
standard, so it is likely that languages other than Perl will NOT |
| 1904 |
understand it. This code point also will not fit in a 32\-bit word on |
| 1905 |
ASCII platforms and therefore is non-portable between systems. |
| 1906 |
.Sp |
| 1907 |
At one time, it was legal in some standards to have code points up to |
| 1908 |
0x7FFF_FFFF, but not higher, and this code point is higher. |
| 1909 |
.Sp |
| 1910 |
Acceptance of these code points is a Perl extension, and you should |
| 1911 |
expect that nothing other than Perl can handle them; Perl itself on |
| 1912 |
EBCDIC platforms before v5.24 does not handle them. |
| 1913 |
.Sp |
| 1914 |
Perl also makes no guarantees that the representation of these code |
| 1915 |
points won't change at some point in the future, say when machines |
| 1916 |
become available that have larger than a 64\-bit word. At that time, |
| 1917 |
files containing any of these, written by an older Perl might require |
| 1918 |
conversion before being readable by a newer Perl. |
| 1919 |
.IP "Code point 0x%X is not Unicode, may not be portable" 4 |
| 1920 |
.IX Item "Code point 0x%X is not Unicode, may not be portable" |
| 1921 |
(S non_unicode) You had a code point above the Unicode maximum |
| 1922 |
of U+10FFFF. |
| 1923 |
.Sp |
| 1924 |
Perl allows strings to contain a superset of Unicode code points, but |
| 1925 |
these may not be accepted by other languages/systems. Further, even if |
| 1926 |
these languages/systems accept these large code points, they may have |
| 1927 |
chosen a different representation for them than the UTF\-8\-like one that |
| 1928 |
Perl has, which would mean files are not exchangeable between them and |
| 1929 |
Perl. |
| 1930 |
.Sp |
| 1931 |
On EBCDIC platforms, code points above 0x3FFF_FFFF have a different |
| 1932 |
representation in Perl v5.24 than before, so any file containing these |
| 1933 |
that was written before that version will require conversion before |
| 1934 |
being readable by a later Perl. |
| 1935 |
.ie n .IP "%s: Command not found" 4 |
| 1936 |
.el .IP "\f(CW%s:\fR Command not found" 4 |
| 1937 |
.IX Item "%s: Command not found" |
| 1938 |
(A) You've accidentally run your script through \fBcsh\fR or another shell |
| 1939 |
instead of Perl. Check the #! line, or manually feed your script into |
| 1940 |
Perl yourself. The #! line at the top of your file could look like |
| 1941 |
.Sp |
| 1942 |
.Vb 1 |
| 1943 |
\& #!/usr/bin/perl |
| 1944 |
.Ve |
| 1945 |
.ie n .IP "%s: command not found" 4 |
| 1946 |
.el .IP "\f(CW%s:\fR command not found" 4 |
| 1947 |
.IX Item "%s: command not found" |
| 1948 |
(A) You've accidentally run your script through \fBbash\fR or another shell |
| 1949 |
instead of Perl. Check the #! line, or manually feed your script into |
| 1950 |
Perl yourself. The #! line at the top of your file could look like |
| 1951 |
.Sp |
| 1952 |
.Vb 1 |
| 1953 |
\& #!/usr/bin/perl |
| 1954 |
.Ve |
| 1955 |
.ie n .IP "%s: command not found: %s" 4 |
| 1956 |
.el .IP "\f(CW%s:\fR command not found: \f(CW%s\fR" 4 |
| 1957 |
.IX Item "%s: command not found: %s" |
| 1958 |
(A) You've accidentally run your script through \fBzsh\fR or another shell |
| 1959 |
instead of Perl. Check the #! line, or manually feed your script into |
| 1960 |
Perl yourself. The #! line at the top of your file could look like |
| 1961 |
.Sp |
| 1962 |
.Vb 1 |
| 1963 |
\& #!/usr/bin/perl |
| 1964 |
.Ve |
| 1965 |
.IP "Compilation failed in require" 4 |
| 1966 |
.IX Item "Compilation failed in require" |
| 1967 |
(F) Perl could not compile a file specified in a \f(CW\*(C`require\*(C'\fR statement. |
| 1968 |
Perl uses this generic message when none of the errors that it |
| 1969 |
encountered were severe enough to halt compilation immediately. |
| 1970 |
.ie n .IP "\fBconnect()\fR on closed socket %s" 4 |
| 1971 |
.el .IP "\fBconnect()\fR on closed socket \f(CW%s\fR" 4 |
| 1972 |
.IX Item "connect() on closed socket %s" |
| 1973 |
(W closed) You tried to do a connect on a closed socket. Did you forget |
| 1974 |
to check the return value of your \fBsocket()\fR call? See |
| 1975 |
"connect" in perlfunc. |
| 1976 |
.IP "Constant(%s): Call to &{$^H{%s}} did not return a defined value" 4 |
| 1977 |
.IX Item "Constant(%s): Call to &{$^H{%s}} did not return a defined value" |
| 1978 |
(F) The subroutine registered to handle constant overloading |
| 1979 |
(see overload) or a custom charnames handler (see |
| 1980 |
"CUSTOM TRANSLATORS" in charnames) returned an undefined value. |
| 1981 |
.IP "Constant(%s): $^H{%s} is not defined" 4 |
| 1982 |
.IX Item "Constant(%s): $^H{%s} is not defined" |
| 1983 |
(F) The parser found inconsistencies while attempting to define an |
| 1984 |
overloaded constant. Perhaps you forgot to load the corresponding |
| 1985 |
overload pragma? |
| 1986 |
.ie n .IP "Constant is not %s reference" 4 |
| 1987 |
.el .IP "Constant is not \f(CW%s\fR reference" 4 |
| 1988 |
.IX Item "Constant is not %s reference" |
| 1989 |
(F) A constant value (perhaps declared using the \f(CW\*(C`use constant\*(C'\fR pragma) |
| 1990 |
is being dereferenced, but it amounts to the wrong type of reference. |
| 1991 |
The message indicates the type of reference that was expected. This |
| 1992 |
usually indicates a syntax error in dereferencing the constant value. |
| 1993 |
See "Constant Functions" in perlsub and constant. |
| 1994 |
.IP "Constants from lexical variables potentially modified elsewhere are no longer permitted" 4 |
| 1995 |
.IX Item "Constants from lexical variables potentially modified elsewhere are no longer permitted" |
| 1996 |
(F) You wrote something like |
| 1997 |
.Sp |
| 1998 |
.Vb 2 |
| 1999 |
\& my $var; |
| 2000 |
\& $sub = sub () { $var }; |
| 2001 |
.Ve |
| 2002 |
.Sp |
| 2003 |
but \f(CW$var\fR is referenced elsewhere and could be modified after the \f(CW\*(C`sub\*(C'\fR |
| 2004 |
expression is evaluated. Either it is explicitly modified elsewhere |
| 2005 |
(\f(CW\*(C`$var = 3\*(C'\fR) or it is passed to a subroutine or to an operator like |
| 2006 |
\&\f(CW\*(C`printf\*(C'\fR or \f(CW\*(C`map\*(C'\fR, which may or may not modify the variable. |
| 2007 |
.Sp |
| 2008 |
Traditionally, Perl has captured the value of the variable at that |
| 2009 |
point and turned the subroutine into a constant eligible for inlining. |
| 2010 |
In those cases where the variable can be modified elsewhere, this |
| 2011 |
breaks the behavior of closures, in which the subroutine captures |
| 2012 |
the variable itself, rather than its value, so future changes to the |
| 2013 |
variable are reflected in the subroutine's return value. |
| 2014 |
.Sp |
| 2015 |
This usage was deprecated, and as of Perl 5.32 is no longer allowed, |
| 2016 |
making it possible to change the behavior in the future. |
| 2017 |
.Sp |
| 2018 |
If you intended for the subroutine to be eligible for inlining, then |
| 2019 |
make sure the variable is not referenced elsewhere, possibly by |
| 2020 |
copying it: |
| 2021 |
.Sp |
| 2022 |
.Vb 2 |
| 2023 |
\& my $var2 = $var; |
| 2024 |
\& $sub = sub () { $var2 }; |
| 2025 |
.Ve |
| 2026 |
.Sp |
| 2027 |
If you do want this subroutine to be a closure that reflects future |
| 2028 |
changes to the variable that it closes over, add an explicit \f(CW\*(C`return\*(C'\fR: |
| 2029 |
.Sp |
| 2030 |
.Vb 2 |
| 2031 |
\& my $var; |
| 2032 |
\& $sub = sub () { return $var }; |
| 2033 |
.Ve |
| 2034 |
.ie n .IP "Constant subroutine %s redefined" 4 |
| 2035 |
.el .IP "Constant subroutine \f(CW%s\fR redefined" 4 |
| 2036 |
.IX Item "Constant subroutine %s redefined" |
| 2037 |
(W redefine)(S) You redefined a subroutine which had previously |
| 2038 |
been eligible for inlining. See "Constant Functions" in perlsub |
| 2039 |
for commentary and workarounds. |
| 2040 |
.ie n .IP "Constant subroutine %s undefined" 4 |
| 2041 |
.el .IP "Constant subroutine \f(CW%s\fR undefined" 4 |
| 2042 |
.IX Item "Constant subroutine %s undefined" |
| 2043 |
(W misc) You undefined a subroutine which had previously been eligible |
| 2044 |
for inlining. See "Constant Functions" in perlsub for commentary and |
| 2045 |
workarounds. |
| 2046 |
.IP "Constant(%s) unknown" 4 |
| 2047 |
.IX Item "Constant(%s) unknown" |
| 2048 |
(F) The parser found inconsistencies either while attempting |
| 2049 |
to define an overloaded constant, or when trying to find the |
| 2050 |
character name specified in the \f(CW\*(C`\eN{...}\*(C'\fR escape. Perhaps you |
| 2051 |
forgot to load the corresponding overload pragma? |
| 2052 |
.IP ":const is not permitted on named subroutines" 4 |
| 2053 |
.IX Item ":const is not permitted on named subroutines" |
| 2054 |
(F) The "const" attribute causes an anonymous subroutine to be run and |
| 2055 |
its value captured at the time that it is cloned. Named subroutines are |
| 2056 |
not cloned like this, so the attribute does not make sense on them. |
| 2057 |
.IP "Copy method did not return a reference" 4 |
| 2058 |
.IX Item "Copy method did not return a reference" |
| 2059 |
(F) The method which overloads "=" is buggy. See |
| 2060 |
"Copy Constructor" in overload. |
| 2061 |
.IP "&CORE::%s cannot be called directly" 4 |
| 2062 |
.IX Item "&CORE::%s cannot be called directly" |
| 2063 |
(F) You tried to call a subroutine in the \f(CW\*(C`CORE::\*(C'\fR namespace |
| 2064 |
with \f(CW&foo\fR syntax or through a reference. Some subroutines |
| 2065 |
in this package cannot yet be called that way, but must be |
| 2066 |
called as barewords. Something like this will work: |
| 2067 |
.Sp |
| 2068 |
.Vb 2 |
| 2069 |
\& BEGIN { *shove = \e&CORE::push; } |
| 2070 |
\& shove @array, 1,2,3; # pushes on to @array |
| 2071 |
.Ve |
| 2072 |
.IP "CORE::%s is not a keyword" 4 |
| 2073 |
.IX Item "CORE::%s is not a keyword" |
| 2074 |
(F) The CORE:: namespace is reserved for Perl keywords. |
| 2075 |
.ie n .IP "Corrupted regexp opcode %d > %d" 4 |
| 2076 |
.el .IP "Corrupted regexp opcode \f(CW%d\fR > \f(CW%d\fR" 4 |
| 2077 |
.IX Item "Corrupted regexp opcode %d > %d" |
| 2078 |
(P) This is either an error in Perl, or, if you're using |
| 2079 |
one, your custom regular expression engine. If not the |
| 2080 |
latter, report the problem to <https://github.com/Perl/perl5/issues/new/choose>. |
| 2081 |
.IP "corrupted regexp pointers" 4 |
| 2082 |
.IX Item "corrupted regexp pointers" |
| 2083 |
(P) The regular expression engine got confused by what the regular |
| 2084 |
expression compiler gave it. |
| 2085 |
.IP "corrupted regexp program" 4 |
| 2086 |
.IX Item "corrupted regexp program" |
| 2087 |
(P) The regular expression engine got passed a regexp program without a |
| 2088 |
valid magic number. |
| 2089 |
.IP "Corrupt malloc ptr 0x%x at 0x%x" 4 |
| 2090 |
.IX Item "Corrupt malloc ptr 0x%x at 0x%x" |
| 2091 |
(P) The malloc package that comes with Perl had an internal failure. |
| 2092 |
.IP "Count after length/code in unpack" 4 |
| 2093 |
.IX Item "Count after length/code in unpack" |
| 2094 |
(F) You had an unpack template indicating a counted-length string, but |
| 2095 |
you have also specified an explicit size for the string. See |
| 2096 |
"pack" in perlfunc. |
| 2097 |
.IP "Declaring references is experimental" 4 |
| 2098 |
.IX Item "Declaring references is experimental" |
| 2099 |
(S experimental::declared_refs) This warning is emitted if you use |
| 2100 |
a reference constructor on the right-hand side of \f(CW\*(C`my\*(C'\fR, \f(CW\*(C`state\*(C'\fR, \f(CW\*(C`our\*(C'\fR, or |
| 2101 |
\&\f(CW\*(C`local\*(C'\fR. Simply suppress the warning if you want to use the feature, but |
| 2102 |
know that in doing so you are taking the risk of using an experimental |
| 2103 |
feature which may change or be removed in a future Perl version: |
| 2104 |
.Sp |
| 2105 |
.Vb 3 |
| 2106 |
\& no warnings "experimental::declared_refs"; |
| 2107 |
\& use feature "declared_refs"; |
| 2108 |
\& $fooref = my \e$foo; |
| 2109 |
.Ve |
| 2110 |
.IP "Deep recursion on anonymous subroutine" 4 |
| 2111 |
.IX Item "Deep recursion on anonymous subroutine" |
| 2112 |
.PD 0 |
| 2113 |
.IP "Deep recursion on subroutine ""%s""" 4 |
| 2114 |
.IX Item "Deep recursion on subroutine ""%s""" |
| 2115 |
.PD |
| 2116 |
(W recursion) This subroutine has called itself (directly or indirectly) |
| 2117 |
100 times more than it has returned. This probably indicates an |
| 2118 |
infinite recursion, unless you're writing strange benchmark programs, in |
| 2119 |
which case it indicates something else. |
| 2120 |
.Sp |
| 2121 |
This threshold can be changed from 100, by recompiling the \fIperl\fR binary, |
| 2122 |
setting the C pre-processor macro \f(CW\*(C`PERL_SUB_DEPTH_WARN\*(C'\fR to the desired value. |
| 2123 |
.IP "(?(DEFINE)....) does not allow branches in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 2124 |
.IX Item "(?(DEFINE)....) does not allow branches in regex; marked by <--\ HERE in m/%s/" |
| 2125 |
(F) You used something like \f(CW\*(C`(?(DEFINE)...|..)\*(C'\fR which is illegal. The |
| 2126 |
most likely cause of this error is that you left out a parenthesis inside |
| 2127 |
of the \f(CW\*(C`....\*(C'\fR part. |
| 2128 |
.Sp |
| 2129 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 2130 |
discovered. |
| 2131 |
.ie n .IP "%s defines neither package nor VERSION\-\-version check failed" 4 |
| 2132 |
.el .IP "\f(CW%s\fR defines neither package nor VERSION\-\-version check failed" 4 |
| 2133 |
.IX Item "%s defines neither package nor VERSION--version check failed" |
| 2134 |
(F) You said something like "use Module 42" but in the Module file |
| 2135 |
there are neither package declarations nor a \f(CW$VERSION\fR. |
| 2136 |
.IP "delete argument is not a HASH or ARRAY element or slice" 4 |
| 2137 |
.IX Item "delete argument is not a HASH or ARRAY element or slice" |
| 2138 |
(F) The argument to \f(CW\*(C`delete\*(C'\fR must be either a hash or array element, |
| 2139 |
such as: |
| 2140 |
.Sp |
| 2141 |
.Vb 2 |
| 2142 |
\& $foo{$bar} |
| 2143 |
\& $ref\->{"susie"}[12] |
| 2144 |
.Ve |
| 2145 |
.Sp |
| 2146 |
or a hash or array slice, such as: |
| 2147 |
.Sp |
| 2148 |
.Vb 2 |
| 2149 |
\& @foo[$bar, $baz, $xyzzy] |
| 2150 |
\& $ref\->[12]\->@{"susie", "queue"} |
| 2151 |
.Ve |
| 2152 |
.Sp |
| 2153 |
or a hash key/value or array index/value slice, such as: |
| 2154 |
.Sp |
| 2155 |
.Vb 2 |
| 2156 |
\& %foo[$bar, $baz, $xyzzy] |
| 2157 |
\& $ref\->[12]\->%{"susie", "queue"} |
| 2158 |
.Ve |
| 2159 |
.IP "Delimiter for here document is too long" 4 |
| 2160 |
.IX Item "Delimiter for here document is too long" |
| 2161 |
(F) In a here document construct like \f(CW\*(C`<<FOO\*(C'\fR, the label \f(CW\*(C`FOO\*(C'\fR is too |
| 2162 |
long for Perl to handle. You have to be seriously twisted to write code |
| 2163 |
that triggers this error. |
| 2164 |
.IP "DESTROY created new reference to dead object '%s'" 4 |
| 2165 |
.IX Item "DESTROY created new reference to dead object '%s'" |
| 2166 |
(F) A \fBDESTROY()\fR method created a new reference to the object which is |
| 2167 |
just being DESTROYed. Perl is confused, and prefers to abort rather |
| 2168 |
than to create a dangling reference. |
| 2169 |
.IP "Did not produce a valid header" 4 |
| 2170 |
.IX Item "Did not produce a valid header" |
| 2171 |
See "500 Server error". |
| 2172 |
.ie n .IP "%s did not return a true value" 4 |
| 2173 |
.el .IP "\f(CW%s\fR did not return a true value" 4 |
| 2174 |
.IX Item "%s did not return a true value" |
| 2175 |
(F) A required (or used) file must return a true value to indicate that |
| 2176 |
it compiled correctly and ran its initialization code correctly. It's |
| 2177 |
traditional to end such a file with a "1;", though any true value would |
| 2178 |
do. See "require" in perlfunc. |
| 2179 |
.IP "(Did you mean &%s instead?)" 4 |
| 2180 |
.IX Item "(Did you mean &%s instead?)" |
| 2181 |
(W misc) You probably referred to an imported subroutine &FOO as \f(CW$FOO\fR or |
| 2182 |
some such. |
| 2183 |
.IP "(Did you mean ""local"" instead of ""our""?)" 4 |
| 2184 |
.IX Item "(Did you mean ""local"" instead of ""our""?)" |
| 2185 |
(W shadow) Remember that "our" does not localize the declared global |
| 2186 |
variable. You have declared it again in the same lexical scope, which |
| 2187 |
seems superfluous. |
| 2188 |
.IP "(Did you mean $ or @ instead of %?)" 4 |
| 2189 |
.IX Item "(Did you mean $ or @ instead of %?)" |
| 2190 |
(W) You probably said \f(CW%hash\fR{$key} when you meant \f(CW$hash\fR{$key} or |
| 2191 |
\&\f(CW@hash\fR{@keys}. On the other hand, maybe you just meant \f(CW%hash\fR and got |
| 2192 |
carried away. |
| 2193 |
.IP Died 4 |
| 2194 |
.IX Item "Died" |
| 2195 |
(F) You passed \fBdie()\fR an empty string (the equivalent of \f(CW\*(C`die ""\*(C'\fR) or |
| 2196 |
you called it with no args and \f(CW$@\fR was empty. |
| 2197 |
.IP "Document contains no data" 4 |
| 2198 |
.IX Item "Document contains no data" |
| 2199 |
See "500 Server error". |
| 2200 |
.ie n .IP "%s does not define %s::VERSION\-\-version check failed" 4 |
| 2201 |
.el .IP "\f(CW%s\fR does not define \f(CW%s::VERSION\fR\-\-version check failed" 4 |
| 2202 |
.IX Item "%s does not define %s::VERSION--version check failed" |
| 2203 |
(F) You said something like "use Module 42" but the Module did not |
| 2204 |
define a \f(CW$VERSION\fR. |
| 2205 |
.ie n .IP "'/' does not take a repeat count in %s" 4 |
| 2206 |
.el .IP "'/' does not take a repeat count in \f(CW%s\fR" 4 |
| 2207 |
.IX Item "'/' does not take a repeat count in %s" |
| 2208 |
(F) You cannot put a repeat count of any kind right after the '/' code. |
| 2209 |
See "pack" in perlfunc. |
| 2210 |
.ie n .IP "do ""%s"" failed, '.' is no longer in @INC; did you mean do ""./%s""?" 4 |
| 2211 |
.el .IP "do ""%s"" failed, '.' is no longer in \f(CW@INC\fR; did you mean do ""./%s""?" 4 |
| 2212 |
.IX Item "do ""%s"" failed, '.' is no longer in @INC; did you mean do ""./%s""?" |
| 2213 |
(D deprecated::dot_in_inc) Previously \f(CW\*(C` do "somefile"; \*(C'\fR would search |
| 2214 |
the current directory for the specified file. Since perl v5.26.0, \fI.\fR |
| 2215 |
has been removed from \f(CW@INC\fR by default, so this is no longer true. To |
| 2216 |
search the current directory (and only the current directory) you can |
| 2217 |
write \f(CW\*(C` do "./somefile"; \*(C'\fR. |
| 2218 |
.IP "'%s' does not appear to be an imported builtin function" 4 |
| 2219 |
.IX Item "'%s' does not appear to be an imported builtin function" |
| 2220 |
(F) An attempt was made to remove a previously-imported lexical from |
| 2221 |
builtin by using the \f(CW\*(C`unimport\*(C'\fR method (likely via \f(CW\*(C`no builtin ...\*(C'\fR |
| 2222 |
syntax), but the requested function has not been imported into the current |
| 2223 |
scope. |
| 2224 |
.IP "Don't know how to get file name" 4 |
| 2225 |
.IX Item "Don't know how to get file name" |
| 2226 |
(P) \f(CW\*(C`PerlIO_getname\*(C'\fR, a perl internal I/O function specific to VMS, was |
| 2227 |
somehow called on another platform. This should not happen. |
| 2228 |
.IP "Don't know how to handle magic of type \e%o" 4 |
| 2229 |
.IX Item "Don't know how to handle magic of type %o" |
| 2230 |
(P) The internal handling of magical variables has been cursed. |
| 2231 |
.IP "Downgrading a use VERSION declaration to below v5.11 is not permitted" 4 |
| 2232 |
.IX Item "Downgrading a use VERSION declaration to below v5.11 is not permitted" |
| 2233 |
(F) A \f(CW\*(C`use VERSION\*(C'\fR statement that requests a version below v5.11 |
| 2234 |
(when the effects of \f(CW\*(C`use strict\*(C'\fR would be disabled) has been found |
| 2235 |
after a previous declaration of one having a larger number (which would |
| 2236 |
have enabled these effects). Because of a change to the way that |
| 2237 |
\&\f(CW\*(C`use VERSION\*(C'\fR interacts with the strictness flags, this is no longer |
| 2238 |
supported. |
| 2239 |
.ie n .IP "(Do you need to predeclare %s?)" 4 |
| 2240 |
.el .IP "(Do you need to predeclare \f(CW%s\fR?)" 4 |
| 2241 |
.IX Item "(Do you need to predeclare %s?)" |
| 2242 |
(S syntax) This is an educated guess made in conjunction with the message |
| 2243 |
"%s found where operator expected". It often means a subroutine or module |
| 2244 |
name is being referenced that hasn't been declared yet. This may be |
| 2245 |
because of ordering problems in your file, or because of a missing |
| 2246 |
"sub", "package", "require", or "use" statement. If you're referencing |
| 2247 |
something that isn't defined yet, you don't actually have to define the |
| 2248 |
subroutine or package before the current location. You can use an empty |
| 2249 |
"sub foo;" or "package FOO;" to enter a "forward" declaration. |
| 2250 |
.IP "\fBdump()\fR must be written as \fBCORE::dump()\fR as of Perl 5.30" 4 |
| 2251 |
.IX Item "dump() must be written as CORE::dump() as of Perl 5.30" |
| 2252 |
(F) You used the obsolete \f(CWdump()\fR built-in function. That was deprecated in |
| 2253 |
Perl 5.8.0. As of Perl 5.30 it must be written in fully qualified format: |
| 2254 |
\&\f(CWCORE::dump()\fR. |
| 2255 |
.Sp |
| 2256 |
See "dump" in perlfunc. |
| 2257 |
.IP "dump is not supported" 4 |
| 2258 |
.IX Item "dump is not supported" |
| 2259 |
(F) Your machine doesn't support dump/undump. |
| 2260 |
.IP "Duplicate \fBfree()\fR ignored" 4 |
| 2261 |
.IX Item "Duplicate free() ignored" |
| 2262 |
(S malloc) An internal routine called \fBfree()\fR on something that had |
| 2263 |
already been freed. |
| 2264 |
.ie n .IP "Duplicate modifier '%c' after '%c' in %s" 4 |
| 2265 |
.el .IP "Duplicate modifier '%c' after '%c' in \f(CW%s\fR" 4 |
| 2266 |
.IX Item "Duplicate modifier '%c' after '%c' in %s" |
| 2267 |
(W unpack) You have applied the same modifier more than once after a |
| 2268 |
type in a pack template. See "pack" in perlfunc. |
| 2269 |
.ie n .IP "each on anonymous %s will always start from the beginning" 4 |
| 2270 |
.el .IP "each on anonymous \f(CW%s\fR will always start from the beginning" 4 |
| 2271 |
.IX Item "each on anonymous %s will always start from the beginning" |
| 2272 |
(W syntax) You called each on an anonymous hash or |
| 2273 |
array. Since a new hash or array is created each time, \fBeach()\fR will |
| 2274 |
restart iterating over your hash or array every time. |
| 2275 |
.IP "elseif should be elsif" 4 |
| 2276 |
.IX Item "elseif should be elsif" |
| 2277 |
(S syntax) There is no keyword "elseif" in Perl because Larry thinks |
| 2278 |
it's ugly. Your code will be interpreted as an attempt to call a method |
| 2279 |
named "elseif" for the class returned by the following block. This is |
| 2280 |
unlikely to be what you want. |
| 2281 |
.IP "Empty \e%c in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 2282 |
.IX Item "Empty %c in regex; marked by <--\ HERE in m/%s/" |
| 2283 |
.PD 0 |
| 2284 |
.IP "Empty \e%c{}" 4 |
| 2285 |
.IX Item "Empty %c{}" |
| 2286 |
.IP "Empty \e%c{} in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 2287 |
.IX Item "Empty %c{} in regex; marked by <--\ HERE in m/%s/" |
| 2288 |
.PD |
| 2289 |
(F) You used something like \f(CW\*(C`\eb{}\*(C'\fR, \f(CW\*(C`\eB{}\*(C'\fR, \f(CW\*(C`\eo{}\*(C'\fR, \f(CW\*(C`\ep\*(C'\fR, \f(CW\*(C`\eP\*(C'\fR, or |
| 2290 |
\&\f(CW\*(C`\ex\*(C'\fR without specifying anything for it to operate on. |
| 2291 |
.Sp |
| 2292 |
Unfortunately, for backwards compatibility reasons, an empty \f(CW\*(C`\ex\*(C'\fR is |
| 2293 |
legal outside \f(CW\*(C`use\ re\ \*(Aqstrict\*(Aq\*(C'\fR and expands to a NUL character. |
| 2294 |
.IP "Empty (?) without any modifiers in regex; marked by <\-\- HERE in m/%s/" 4 |
| 2295 |
.IX Item "Empty (?) without any modifiers in regex; marked by <-- HERE in m/%s/" |
| 2296 |
(W regexp) (only under \f(CW\*(C`use\ re\ \*(Aqstrict\*(Aq\*(C'\fR) |
| 2297 |
\&\f(CW\*(C`(?)\*(C'\fR does nothing, so perhaps this is a typo. |
| 2298 |
.IP "${^ENCODING} is no longer supported" 4 |
| 2299 |
.IX Item "${^ENCODING} is no longer supported" |
| 2300 |
(F) The special variable \f(CW\*(C`${^ENCODING}\*(C'\fR, formerly used to implement |
| 2301 |
the \f(CW\*(C`encoding\*(C'\fR pragma, is no longer supported as of Perl 5.26.0. |
| 2302 |
.Sp |
| 2303 |
Setting it to anything other than \f(CW\*(C`undef\*(C'\fR is a fatal error as of Perl |
| 2304 |
5.28. |
| 2305 |
.IP "${^HOOK}{%s} may only be a CODE reference or undef" 4 |
| 2306 |
.IX Item "${^HOOK}{%s} may only be a CODE reference or undef" |
| 2307 |
(F) You attempted to assign something other than undef or a CODE ref to |
| 2308 |
\&\f(CW\*(C`%{^HOOK}\*(C'\fR. Hooks may only be CODE refs. See "%{^HOOK}" in perlvar for |
| 2309 |
details. |
| 2310 |
.IP "Attempt to set unknown hook '%s' in %{^HOOK}" 4 |
| 2311 |
.IX Item "Attempt to set unknown hook '%s' in %{^HOOK}" |
| 2312 |
(F) You attempted to assign something other than undef or a CODE ref to |
| 2313 |
\&\f(CW\*(C`%{^HOOK}\*(C'\fR. Hooks may only be CODE refs. See "%{^HOOK}" in perlvar for |
| 2314 |
details. |
| 2315 |
.ie n .IP "entering effective %s failed" 4 |
| 2316 |
.el .IP "entering effective \f(CW%s\fR failed" 4 |
| 2317 |
.IX Item "entering effective %s failed" |
| 2318 |
(F) While under the \f(CW\*(C`use filetest\*(C'\fR pragma, switching the real and |
| 2319 |
effective uids or gids failed. |
| 2320 |
.ie n .IP "%ENV is aliased to %s" 4 |
| 2321 |
.el .IP "\f(CW%ENV\fR is aliased to \f(CW%s\fR" 4 |
| 2322 |
.IX Item "%ENV is aliased to %s" |
| 2323 |
(F) You're running under taint mode, and the \f(CW%ENV\fR variable has been |
| 2324 |
aliased to another hash, so it doesn't reflect anymore the state of the |
| 2325 |
program's environment. This is potentially insecure. |
| 2326 |
.ie n .IP "Error converting file specification %s" 4 |
| 2327 |
.el .IP "Error converting file specification \f(CW%s\fR" 4 |
| 2328 |
.IX Item "Error converting file specification %s" |
| 2329 |
(F) An error peculiar to VMS. Because Perl may have to deal with file |
| 2330 |
specifications in either VMS or Unix syntax, it converts them to a |
| 2331 |
single form when it must operate on them directly. Either you've passed |
| 2332 |
an invalid file specification to Perl, or you've found a case the |
| 2333 |
conversion routines don't handle. Drat. |
| 2334 |
.ie n .IP "Error %s in expansion of %s" 4 |
| 2335 |
.el .IP "Error \f(CW%s\fR in expansion of \f(CW%s\fR" 4 |
| 2336 |
.IX Item "Error %s in expansion of %s" |
| 2337 |
(F) An error was encountered in handling a user-defined property |
| 2338 |
("User-Defined Character Properties" in perlunicode). These are |
| 2339 |
programmer written subroutines, hence subject to errors that may |
| 2340 |
prevent them from compiling or running. The calls to these subs are |
| 2341 |
\&\f(CW\*(C`eval\*(C'\fR'd, and if there is a failure, this message is raised, using the |
| 2342 |
contents of \f(CW$@\fR from the failed \f(CW\*(C`eval\*(C'\fR. |
| 2343 |
.Sp |
| 2344 |
Another possibility is that tainted data was encountered somewhere in |
| 2345 |
the chain of expanding the property. If so, the message wording will |
| 2346 |
indicate that this is the problem. See "Insecure user-defined |
| 2347 |
property \f(CW%s\fR". |
| 2348 |
.IP "Eval-group in insecure regular expression" 4 |
| 2349 |
.IX Item "Eval-group in insecure regular expression" |
| 2350 |
(F) Perl detected tainted data when trying to compile a regular |
| 2351 |
expression that contains the \f(CW\*(C`(?{ ... })\*(C'\fR zero-width assertion, which |
| 2352 |
is unsafe. See "(?{ code })" in perlre, and perlsec. |
| 2353 |
.IP "Eval-group not allowed at runtime, use re 'eval' in regex m/%s/" 4 |
| 2354 |
.IX Item "Eval-group not allowed at runtime, use re 'eval' in regex m/%s/" |
| 2355 |
(F) Perl tried to compile a regular expression containing the |
| 2356 |
\&\f(CW\*(C`(?{ ... })\*(C'\fR zero-width assertion at run time, as it would when the |
| 2357 |
pattern contains interpolated values. Since that is a security risk, |
| 2358 |
it is not allowed. If you insist, you may still do this by using the |
| 2359 |
\&\f(CW\*(C`re \*(Aqeval\*(Aq\*(C'\fR pragma or by explicitly building the pattern from an |
| 2360 |
interpolated string at run time and using that in an \fBeval()\fR. See |
| 2361 |
"(?{ code })" in perlre. |
| 2362 |
.IP "Eval-group not allowed, use re 'eval' in regex m/%s/" 4 |
| 2363 |
.IX Item "Eval-group not allowed, use re 'eval' in regex m/%s/" |
| 2364 |
(F) A regular expression contained the \f(CW\*(C`(?{ ... })\*(C'\fR zero-width |
| 2365 |
assertion, but that construct is only allowed when the \f(CW\*(C`use re \*(Aqeval\*(Aq\*(C'\fR |
| 2366 |
pragma is in effect. See "(?{ code })" in perlre. |
| 2367 |
.IP "EVAL without pos change exceeded limit in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 2368 |
.IX Item "EVAL without pos change exceeded limit in regex; marked by <--\ HERE in m/%s/" |
| 2369 |
(F) You used a pattern that nested too many EVAL calls without consuming |
| 2370 |
any text. Restructure the pattern so that text is consumed. |
| 2371 |
.Sp |
| 2372 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 2373 |
discovered. |
| 2374 |
.IP "Excessively long <> operator" 4 |
| 2375 |
.IX Item "Excessively long <> operator" |
| 2376 |
(F) The contents of a <> operator may not exceed the maximum size of a |
| 2377 |
Perl identifier. If you're just trying to glob a long list of |
| 2378 |
filenames, try using the \fBglob()\fR operator, or put the filenames into a |
| 2379 |
variable and glob that. |
| 2380 |
.IP "exec? I'm not *that* kind of operating system" 4 |
| 2381 |
.IX Item "exec? I'm not *that* kind of operating system" |
| 2382 |
(F) The \f(CW\*(C`exec\*(C'\fR function is not implemented on some systems, e.g. |
| 2383 |
Catamount. See perlport. |
| 2384 |
.ie n .IP "%sExecution of %s aborted due to compilation errors." 4 |
| 2385 |
.el .IP "\f(CW%sExecution\fR of \f(CW%s\fR aborted due to compilation errors." 4 |
| 2386 |
.IX Item "%sExecution of %s aborted due to compilation errors." |
| 2387 |
(F) The final summary message when a Perl compilation fails. |
| 2388 |
.ie n .IP "Execution of %s aborted due to compilation errors." 4 |
| 2389 |
.el .IP "Execution of \f(CW%s\fR aborted due to compilation errors." 4 |
| 2390 |
.IX Item "Execution of %s aborted due to compilation errors." |
| 2391 |
(F) The final summary message when a Perl compilation fails. |
| 2392 |
.IP "exists argument is not a HASH or ARRAY element or a subroutine" 4 |
| 2393 |
.IX Item "exists argument is not a HASH or ARRAY element or a subroutine" |
| 2394 |
(F) The argument to \f(CW\*(C`exists\*(C'\fR must be a hash or array element or a |
| 2395 |
subroutine with an ampersand, such as: |
| 2396 |
.Sp |
| 2397 |
.Vb 3 |
| 2398 |
\& $foo{$bar} |
| 2399 |
\& $ref\->{"susie"}[12] |
| 2400 |
\& &do_something |
| 2401 |
.Ve |
| 2402 |
.IP "exists argument is not a subroutine name" 4 |
| 2403 |
.IX Item "exists argument is not a subroutine name" |
| 2404 |
(F) The argument to \f(CW\*(C`exists\*(C'\fR for \f(CW\*(C`exists &sub\*(C'\fR must be a subroutine name, |
| 2405 |
and not a subroutine call. \f(CW\*(C`exists &sub()\*(C'\fR will generate this error. |
| 2406 |
.ie n .IP "Exiting eval via %s" 4 |
| 2407 |
.el .IP "Exiting eval via \f(CW%s\fR" 4 |
| 2408 |
.IX Item "Exiting eval via %s" |
| 2409 |
(W exiting) You are exiting an eval by unconventional means, such as a |
| 2410 |
goto, or a loop control statement. |
| 2411 |
.ie n .IP "Exiting format via %s" 4 |
| 2412 |
.el .IP "Exiting format via \f(CW%s\fR" 4 |
| 2413 |
.IX Item "Exiting format via %s" |
| 2414 |
(W exiting) You are exiting a format by unconventional means, such as a |
| 2415 |
goto, or a loop control statement. |
| 2416 |
.ie n .IP "Exiting pseudo-block via %s" 4 |
| 2417 |
.el .IP "Exiting pseudo-block via \f(CW%s\fR" 4 |
| 2418 |
.IX Item "Exiting pseudo-block via %s" |
| 2419 |
(W exiting) You are exiting a rather special block construct (like a |
| 2420 |
sort block or subroutine) by unconventional means, such as a goto, or a |
| 2421 |
loop control statement. See "sort" in perlfunc. |
| 2422 |
.ie n .IP "Exiting subroutine via %s" 4 |
| 2423 |
.el .IP "Exiting subroutine via \f(CW%s\fR" 4 |
| 2424 |
.IX Item "Exiting subroutine via %s" |
| 2425 |
(W exiting) You are exiting a subroutine by unconventional means, such |
| 2426 |
as a goto, or a loop control statement. |
| 2427 |
.ie n .IP "Exiting substitution via %s" 4 |
| 2428 |
.el .IP "Exiting substitution via \f(CW%s\fR" 4 |
| 2429 |
.IX Item "Exiting substitution via %s" |
| 2430 |
(W exiting) You are exiting a substitution by unconventional means, such |
| 2431 |
as a return, a goto, or a loop control statement. |
| 2432 |
.ie n .IP "Expected %s reference in export_lexically" 4 |
| 2433 |
.el .IP "Expected \f(CW%s\fR reference in export_lexically" 4 |
| 2434 |
.IX Item "Expected %s reference in export_lexically" |
| 2435 |
(F) The type of a reference given to "export_lexically" in builtin did not |
| 2436 |
match the sigil of the preceding name, or the value was not a reference at |
| 2437 |
all. |
| 2438 |
.IP "Expecting close bracket in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 2439 |
.IX Item "Expecting close bracket in regex; marked by <--\ HERE in m/%s/" |
| 2440 |
(F) You wrote something like |
| 2441 |
.Sp |
| 2442 |
.Vb 1 |
| 2443 |
\& (?13 |
| 2444 |
.Ve |
| 2445 |
.Sp |
| 2446 |
to denote a capturing group of the form |
| 2447 |
\&\f(CW\*(C`(?\fR\f(CIPARNO\fR\f(CW)\*(C'\fR, |
| 2448 |
but omitted the \f(CW")"\fR. |
| 2449 |
.IP "Expecting interpolated extended charclass in regex; marked by <\-\- HERE in m/%s/" 4 |
| 2450 |
.IX Item "Expecting interpolated extended charclass in regex; marked by <-- HERE in m/%s/" |
| 2451 |
(F) It looked like you were attempting to interpolate an |
| 2452 |
already-compiled extended character class, like so: |
| 2453 |
.Sp |
| 2454 |
.Vb 3 |
| 2455 |
\& my $thai_or_lao = qr/(?[ \ep{Thai} + \ep{Lao} ])/; |
| 2456 |
\& ... |
| 2457 |
\& qr/(?[ \ep{Digit} & $thai_or_lao ])/; |
| 2458 |
.Ve |
| 2459 |
.Sp |
| 2460 |
But the marked code isn't syntactically correct to be such an |
| 2461 |
interpolated class. |
| 2462 |
.IP "Experimental aliasing via reference not enabled" 4 |
| 2463 |
.IX Item "Experimental aliasing via reference not enabled" |
| 2464 |
(F) To do aliasing via references, you must first enable the feature: |
| 2465 |
.Sp |
| 2466 |
.Vb 3 |
| 2467 |
\& no warnings "experimental::refaliasing"; |
| 2468 |
\& use feature "refaliasing"; |
| 2469 |
\& \e$x = \e$y; |
| 2470 |
.Ve |
| 2471 |
.ie n .IP "Experimental %s on scalar is now forbidden" 4 |
| 2472 |
.el .IP "Experimental \f(CW%s\fR on scalar is now forbidden" 4 |
| 2473 |
.IX Item "Experimental %s on scalar is now forbidden" |
| 2474 |
(F) An experimental feature added in Perl 5.14 allowed \f(CW\*(C`each\*(C'\fR, \f(CW\*(C`keys\*(C'\fR, |
| 2475 |
\&\f(CW\*(C`push\*(C'\fR, \f(CW\*(C`pop\*(C'\fR, \f(CW\*(C`shift\*(C'\fR, \f(CW\*(C`splice\*(C'\fR, \f(CW\*(C`unshift\*(C'\fR, and \f(CW\*(C`values\*(C'\fR to be called with a |
| 2476 |
scalar argument. This experiment is considered unsuccessful, and |
| 2477 |
has been removed. The \f(CW\*(C`postderef\*(C'\fR feature may meet your needs better. |
| 2478 |
.IP "Experimental subroutine signatures not enabled" 4 |
| 2479 |
.IX Item "Experimental subroutine signatures not enabled" |
| 2480 |
(F) To use subroutine signatures, you must first enable them: |
| 2481 |
.Sp |
| 2482 |
.Vb 2 |
| 2483 |
\& use feature "signatures"; |
| 2484 |
\& sub foo ($left, $right) { ... } |
| 2485 |
.Ve |
| 2486 |
.IP "Explicit blessing to '' (assuming package main)" 4 |
| 2487 |
.IX Item "Explicit blessing to '' (assuming package main)" |
| 2488 |
(W misc) You are blessing a reference to a zero length string. This has |
| 2489 |
the effect of blessing the reference into the package main. This is |
| 2490 |
usually not what you want. Consider providing a default target package, |
| 2491 |
e.g. bless($ref, \f(CW$p\fR || 'MyPackage'); |
| 2492 |
.IP "export_lexically can only be called at compile time" 4 |
| 2493 |
.IX Item "export_lexically can only be called at compile time" |
| 2494 |
(F) "export_lexically" in builtin was called at runtime. Because it creates |
| 2495 |
new names in the lexical scope currently being compiled, it can only be |
| 2496 |
called from code inside \f(CW\*(C`BEGIN\*(C'\fR block in that scope. |
| 2497 |
.ie n .IP "%s: Expression syntax" 4 |
| 2498 |
.el .IP "\f(CW%s:\fR Expression syntax" 4 |
| 2499 |
.IX Item "%s: Expression syntax" |
| 2500 |
(A) You've accidentally run your script through \fBcsh\fR instead of Perl. |
| 2501 |
Check the #! line, or manually feed your script into Perl yourself. |
| 2502 |
.ie n .IP "%s failed\-\-call queue aborted" 4 |
| 2503 |
.el .IP "\f(CW%s\fR failed\-\-call queue aborted" 4 |
| 2504 |
.IX Item "%s failed--call queue aborted" |
| 2505 |
(F) An untrapped exception was raised while executing a UNITCHECK, |
| 2506 |
CHECK, INIT, or END subroutine. Processing of the remainder of the |
| 2507 |
queue of such routines has been prematurely ended. |
| 2508 |
.ie n .IP "Failed to close in-place work file %s: %s" 4 |
| 2509 |
.el .IP "Failed to close in-place work file \f(CW%s:\fR \f(CW%s\fR" 4 |
| 2510 |
.IX Item "Failed to close in-place work file %s: %s" |
| 2511 |
(F) Closing an output file from in-place editing, as with the \f(CW\*(C`\-i\*(C'\fR |
| 2512 |
command-line switch, failed. |
| 2513 |
.IP "False [] range ""%s"" in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 2514 |
.IX Item "False [] range ""%s"" in regex; marked by <--\ HERE in m/%s/" |
| 2515 |
(W regexp)(F) A character class range must start and end at a literal |
| 2516 |
character, not another character class like \f(CW\*(C`\ed\*(C'\fR or \f(CW\*(C`[:alpha:]\*(C'\fR. The "\-" |
| 2517 |
in your false range is interpreted as a literal "\-". In a \f(CW\*(C`(?[...])\*(C'\fR |
| 2518 |
construct, this is an error, rather than a warning. Consider quoting |
| 2519 |
the "\-", "\e\-". The <\-\-\ HERE shows whereabouts in the regular expression |
| 2520 |
the problem was discovered. See perlre. |
| 2521 |
.ie n .IP "Fatal VMS error (status=%d) at %s, line %d" 4 |
| 2522 |
.el .IP "Fatal VMS error (status=%d) at \f(CW%s\fR, line \f(CW%d\fR" 4 |
| 2523 |
.IX Item "Fatal VMS error (status=%d) at %s, line %d" |
| 2524 |
(P) An error peculiar to VMS. Something untoward happened in a VMS |
| 2525 |
system service or RTL routine; Perl's exit status should provide more |
| 2526 |
details. The filename in "at \f(CW%s\fR" and the line number in "line \f(CW%d\fR" tell |
| 2527 |
you which section of the Perl source code is distressed. |
| 2528 |
.IP "fcntl is not implemented" 4 |
| 2529 |
.IX Item "fcntl is not implemented" |
| 2530 |
(F) Your machine apparently doesn't implement \fBfcntl()\fR. What is this, a |
| 2531 |
PDP\-11 or something? |
| 2532 |
.IP "FETCHSIZE returned a negative value" 4 |
| 2533 |
.IX Item "FETCHSIZE returned a negative value" |
| 2534 |
(F) A tied array claimed to have a negative number of elements, which |
| 2535 |
is not possible. |
| 2536 |
.IP "Field already has a parameter name, cannot add another" 4 |
| 2537 |
.IX Item "Field already has a parameter name, cannot add another" |
| 2538 |
(F) A field may have at most one application of the \f(CW\*(C`:param\*(C'\fR attribute to |
| 2539 |
assign a parameter name to it; once applied a second one is not allowed. |
| 2540 |
.ie n .IP "Field attribute %s requires a value" 4 |
| 2541 |
.el .IP "Field attribute \f(CW%s\fR requires a value" 4 |
| 2542 |
.IX Item "Field attribute %s requires a value" |
| 2543 |
(F) You specified an attribute for a field that would require a value to |
| 2544 |
be passed in parentheses, but did not provide one. Remember that |
| 2545 |
whitespace is \fBnot\fR permitted between the attribute name and its value; |
| 2546 |
you must write this as |
| 2547 |
.Sp |
| 2548 |
.Vb 1 |
| 2549 |
\& field $var :attr(VALUE) ... |
| 2550 |
.Ve |
| 2551 |
.IP "field is experimental" 4 |
| 2552 |
.IX Item "field is experimental" |
| 2553 |
(S experimental::class) This warning is emitted if you use the \f(CW\*(C`field\*(C'\fR |
| 2554 |
keyword of \f(CW\*(C`use feature \*(Aqclass\*(Aq\*(C'\fR. This keyword is currently |
| 2555 |
experimental and its behaviour may change in future releases of Perl. |
| 2556 |
.ie n .IP "Field %s is not accessible outside a method" 4 |
| 2557 |
.el .IP "Field \f(CW%s\fR is not accessible outside a method" 4 |
| 2558 |
.IX Item "Field %s is not accessible outside a method" |
| 2559 |
(F) An attempt was made to access a field variable of a class from code |
| 2560 |
that does not appear inside the body of a \f(CW\*(C`method\*(C'\fR subroutine. This is not |
| 2561 |
permitted, as only methods will have access to the fields of an instance. |
| 2562 |
.ie n .IP "Field %s of ""%s"" is not accessible in a method of ""%s""" 4 |
| 2563 |
.el .IP "Field \f(CW%s\fR of ""%s"" is not accessible in a method of ""%s""" 4 |
| 2564 |
.IX Item "Field %s of ""%s"" is not accessible in a method of ""%s""" |
| 2565 |
(F) An attempt was made to access a field variable of a class, from a |
| 2566 |
method of another class nested inside the one that actually defined it. |
| 2567 |
This is not permitted, as only methods defined by a given class are |
| 2568 |
permitted to access fields of that class. |
| 2569 |
.IP "Field too wide in 'u' format in pack" 4 |
| 2570 |
.IX Item "Field too wide in 'u' format in pack" |
| 2571 |
(W pack) Each line in an uuencoded string starts with a length indicator |
| 2572 |
which can't encode values above 63. So there is no point in asking for |
| 2573 |
a line length bigger than that. Perl will behave as if you specified |
| 2574 |
\&\f(CW\*(C`u63\*(C'\fR as the format. |
| 2575 |
.ie n .IP "Filehandle %s opened only for input" 4 |
| 2576 |
.el .IP "Filehandle \f(CW%s\fR opened only for input" 4 |
| 2577 |
.IX Item "Filehandle %s opened only for input" |
| 2578 |
(W io) You tried to write on a read-only filehandle. If you intended |
| 2579 |
it to be a read-write filehandle, you needed to open it with "+<" or |
| 2580 |
"+>" or "+>>" instead of with "<" or nothing. If you intended only to |
| 2581 |
write the file, use ">" or ">>". See "open" in perlfunc. |
| 2582 |
.ie n .IP "Filehandle %s opened only for output" 4 |
| 2583 |
.el .IP "Filehandle \f(CW%s\fR opened only for output" 4 |
| 2584 |
.IX Item "Filehandle %s opened only for output" |
| 2585 |
(W io) You tried to read from a filehandle opened only for writing, If |
| 2586 |
you intended it to be a read/write filehandle, you needed to open it |
| 2587 |
with "+<" or "+>" or "+>>" instead of with ">". If you intended only to |
| 2588 |
read from the file, use "<". See "open" in perlfunc. Another possibility |
| 2589 |
is that you attempted to open filedescriptor 0 (also known as STDIN) for |
| 2590 |
output (maybe you closed STDIN earlier?). |
| 2591 |
.ie n .IP "Filehandle %s reopened as %s only for input" 4 |
| 2592 |
.el .IP "Filehandle \f(CW%s\fR reopened as \f(CW%s\fR only for input" 4 |
| 2593 |
.IX Item "Filehandle %s reopened as %s only for input" |
| 2594 |
(W io) You opened for reading a filehandle that got the same filehandle id |
| 2595 |
as STDOUT or STDERR. This occurred because you closed STDOUT or STDERR |
| 2596 |
previously. |
| 2597 |
.ie n .IP "Filehandle STDIN reopened as %s only for output" 4 |
| 2598 |
.el .IP "Filehandle STDIN reopened as \f(CW%s\fR only for output" 4 |
| 2599 |
.IX Item "Filehandle STDIN reopened as %s only for output" |
| 2600 |
(W io) You opened for writing a filehandle that got the same filehandle id |
| 2601 |
as STDIN. This occurred because you closed STDIN previously. |
| 2602 |
.ie n .IP "Filehandle STD%s reopened as %s only for input" 4 |
| 2603 |
.el .IP "Filehandle STD%s reopened as \f(CW%s\fR only for input" 4 |
| 2604 |
.IX Item "Filehandle STD%s reopened as %s only for input" |
| 2605 |
(W io) You opened for reading a filehandle that got the same filehandle id |
| 2606 |
as STDOUT or STDERR. This occurred because you closed the handle previously. |
| 2607 |
.ie n .IP "Final $ should be \e$ or $name" 4 |
| 2608 |
.el .IP "Final $ should be \e$ or \f(CW$name\fR" 4 |
| 2609 |
.IX Item "Final $ should be $ or $name" |
| 2610 |
(F) You must now decide whether the final $ in a string was meant to be |
| 2611 |
a literal dollar sign, or was meant to introduce a variable name that |
| 2612 |
happens to be missing. So you have to put either the backslash or the |
| 2613 |
name. |
| 2614 |
.IP "defer is experimental" 4 |
| 2615 |
.IX Item "defer is experimental" |
| 2616 |
(S experimental::defer) The \f(CW\*(C`defer\*(C'\fR block modifier is experimental. If you |
| 2617 |
want to use the feature, disable the warning with |
| 2618 |
\&\f(CW\*(C`no warnings \*(Aqexperimental::defer\*(Aq\*(C'\fR, but know that in doing so you are taking |
| 2619 |
the risk that your code may break in a future Perl version. |
| 2620 |
.ie n .IP "\fBflock()\fR on closed filehandle %s" 4 |
| 2621 |
.el .IP "\fBflock()\fR on closed filehandle \f(CW%s\fR" 4 |
| 2622 |
.IX Item "flock() on closed filehandle %s" |
| 2623 |
(W closed) The filehandle you're attempting to \fBflock()\fR got itself closed |
| 2624 |
some time before now. Check your control flow. \fBflock()\fR operates on |
| 2625 |
filehandles. Are you attempting to call \fBflock()\fR on a dirhandle by the |
| 2626 |
same name? |
| 2627 |
.IP "for my (...) is experimental" 4 |
| 2628 |
.IX Item "for my (...) is experimental" |
| 2629 |
(S experimental::for_list) This warning is emitted if you use \f(CW\*(C`for\*(C'\fR to |
| 2630 |
iterate multiple values at a time. This syntax is currently experimental |
| 2631 |
and its behaviour may change in future releases of Perl. |
| 2632 |
.IP "Forked open '%s' not meaningful in <>" 4 |
| 2633 |
.IX Item "Forked open '%s' not meaningful in <>" |
| 2634 |
(S inplace) You had \f(CW\*(C`|\-\*(C'\fR or \f(CW\*(C`\-|\*(C'\fR in \f(CW@ARGV\fR and tried to use \f(CW\*(C`<>\*(C'\fR to read from it. |
| 2635 |
.Sp |
| 2636 |
Previously this would fork and produce a confusing error message. |
| 2637 |
.IP "Format not terminated" 4 |
| 2638 |
.IX Item "Format not terminated" |
| 2639 |
(F) A format must be terminated by a line with a solitary dot. Perl got |
| 2640 |
to the end of your file without finding such a line. |
| 2641 |
.ie n .IP "Format %s redefined" 4 |
| 2642 |
.el .IP "Format \f(CW%s\fR redefined" 4 |
| 2643 |
.IX Item "Format %s redefined" |
| 2644 |
(W redefine) You redefined a format. To suppress this warning, say |
| 2645 |
.Sp |
| 2646 |
.Vb 4 |
| 2647 |
\& { |
| 2648 |
\& no warnings \*(Aqredefine\*(Aq; |
| 2649 |
\& eval "format NAME =..."; |
| 2650 |
\& } |
| 2651 |
.Ve |
| 2652 |
.IP "Found = in conditional, should be ==" 4 |
| 2653 |
.IX Item "Found = in conditional, should be ==" |
| 2654 |
(W syntax) You said |
| 2655 |
.Sp |
| 2656 |
.Vb 1 |
| 2657 |
\& if ($foo = 123) |
| 2658 |
.Ve |
| 2659 |
.Sp |
| 2660 |
when you meant |
| 2661 |
.Sp |
| 2662 |
.Vb 1 |
| 2663 |
\& if ($foo == 123) |
| 2664 |
.Ve |
| 2665 |
.Sp |
| 2666 |
(or something like that). |
| 2667 |
.ie n .IP "%s found where operator expected" 4 |
| 2668 |
.el .IP "\f(CW%s\fR found where operator expected" 4 |
| 2669 |
.IX Item "%s found where operator expected" |
| 2670 |
(S syntax) The Perl lexer knows whether to expect a term or an operator. |
| 2671 |
If it sees what it knows to be a term when it was expecting to see an |
| 2672 |
operator, it gives you this warning. Usually it indicates that an |
| 2673 |
operator or delimiter was omitted, such as a semicolon. |
| 2674 |
.ie n .IP "gdbm store returned %d, errno %d, key ""%s""" 4 |
| 2675 |
.el .IP "gdbm store returned \f(CW%d\fR, errno \f(CW%d\fR, key ""%s""" 4 |
| 2676 |
.IX Item "gdbm store returned %d, errno %d, key ""%s""" |
| 2677 |
(S) A warning from the GDBM_File extension that a store failed. |
| 2678 |
.IP "gethostent not implemented" 4 |
| 2679 |
.IX Item "gethostent not implemented" |
| 2680 |
(F) Your C library apparently doesn't implement \fBgethostent()\fR, probably |
| 2681 |
because if it did, it'd feel morally obligated to return every hostname |
| 2682 |
on the Internet. |
| 2683 |
.ie n .IP "get%\fBsname()\fR on closed socket %s" 4 |
| 2684 |
.el .IP "get%\fBsname()\fR on closed socket \f(CW%s\fR" 4 |
| 2685 |
.IX Item "get%sname() on closed socket %s" |
| 2686 |
(W closed) You tried to get a socket or peer socket name on a closed |
| 2687 |
socket. Did you forget to check the return value of your \fBsocket()\fR call? |
| 2688 |
.IP "getpwnam returned invalid UIC %#o for user ""%s""" 4 |
| 2689 |
.IX Item "getpwnam returned invalid UIC %#o for user ""%s""" |
| 2690 |
(S) A warning peculiar to VMS. The call to \f(CW\*(C`sys$getuai\*(C'\fR underlying the |
| 2691 |
\&\f(CW\*(C`getpwnam\*(C'\fR operator returned an invalid UIC. |
| 2692 |
.ie n .IP "\fBgetsockopt()\fR on closed socket %s" 4 |
| 2693 |
.el .IP "\fBgetsockopt()\fR on closed socket \f(CW%s\fR" 4 |
| 2694 |
.IX Item "getsockopt() on closed socket %s" |
| 2695 |
(W closed) You tried to get a socket option on a closed socket. Did you |
| 2696 |
forget to check the return value of your \fBsocket()\fR call? See |
| 2697 |
"getsockopt" in perlfunc. |
| 2698 |
.IP "get_layers: unknown argument '%s'" 4 |
| 2699 |
.IX Item "get_layers: unknown argument '%s'" |
| 2700 |
(F) You called \fBPerlIO::get_layers()\fR with an unknown argument. Legal |
| 2701 |
arguments are provided in key/value pairs, with the keys being one |
| 2702 |
of \f(CW\*(C`input\*(C'\fR, \f(CW\*(C`output\*(C'\fR or \f(CW\*(C`detail\*(C'\fR, followed by a boolean. |
| 2703 |
.IP "given is deprecated" 4 |
| 2704 |
.IX Item "given is deprecated" |
| 2705 |
(D deprecated::smartmatch) \f(CW\*(C`given\*(C'\fR depends on smartmatch, which is |
| 2706 |
deprecated. It will be removed in Perl 5.42. See the explanation under |
| 2707 |
"Experimental Details on given and when" in perlsyn. |
| 2708 |
.ie n .IP "Global symbol ""%s"" requires explicit package name (did you forget to declare ""my %s""?)" 4 |
| 2709 |
.el .IP "Global symbol ""%s"" requires explicit package name (did you forget to declare ""my \f(CW%s\fR""?)" 4 |
| 2710 |
.IX Item "Global symbol ""%s"" requires explicit package name (did you forget to declare ""my %s""?)" |
| 2711 |
(F) You've said "use strict" or "use strict vars", which indicates |
| 2712 |
that all variables must either be lexically scoped (using "my" or "state"), |
| 2713 |
declared beforehand using "our", or explicitly qualified to say |
| 2714 |
which package the global variable is in (using "::"). |
| 2715 |
.IP "glob failed (%s)" 4 |
| 2716 |
.IX Item "glob failed (%s)" |
| 2717 |
(S glob) Something went wrong with the external program(s) used |
| 2718 |
for \f(CW\*(C`glob\*(C'\fR and \f(CW\*(C`<*.c>\*(C'\fR. Usually, this means that you supplied a \f(CW\*(C`glob\*(C'\fR |
| 2719 |
pattern that caused the external program to fail and exit with a |
| 2720 |
nonzero status. If the message indicates that the abnormal exit |
| 2721 |
resulted in a coredump, this may also mean that your csh (C shell) |
| 2722 |
is broken. If so, you should change all of the csh-related variables |
| 2723 |
in config.sh: If you have tcsh, make the variables refer to it as |
| 2724 |
if it were csh (e.g. \f(CW\*(C`full_csh=\*(Aq/usr/bin/tcsh\*(Aq\*(C'\fR); otherwise, make them |
| 2725 |
all empty (except that \f(CW\*(C`d_csh\*(C'\fR should be \f(CW\*(Aqundef\*(Aq\fR) so that Perl will |
| 2726 |
think csh is missing. In either case, after editing config.sh, run |
| 2727 |
\&\f(CW\*(C`./Configure \-S\*(C'\fR and rebuild Perl. |
| 2728 |
.IP "Glob not terminated" 4 |
| 2729 |
.IX Item "Glob not terminated" |
| 2730 |
(F) The lexer saw a left angle bracket in a place where it was expecting |
| 2731 |
a term, so it's looking for the corresponding right angle bracket, and |
| 2732 |
not finding it. Chances are you left some needed parentheses out |
| 2733 |
earlier in the line, and you really meant a "less than". |
| 2734 |
.IP "gmtime(%f) failed" 4 |
| 2735 |
.IX Item "gmtime(%f) failed" |
| 2736 |
(W overflow) You called \f(CW\*(C`gmtime\*(C'\fR with a number that it could not handle: |
| 2737 |
too large, too small, or NaN. The returned value is \f(CW\*(C`undef\*(C'\fR. |
| 2738 |
.IP "gmtime(%f) too large" 4 |
| 2739 |
.IX Item "gmtime(%f) too large" |
| 2740 |
(W overflow) You called \f(CW\*(C`gmtime\*(C'\fR with a number that was larger than |
| 2741 |
it can reliably handle and \f(CW\*(C`gmtime\*(C'\fR probably returned the wrong |
| 2742 |
date. This warning is also triggered with NaN (the special |
| 2743 |
not-a-number value). |
| 2744 |
.IP "gmtime(%f) too small" 4 |
| 2745 |
.IX Item "gmtime(%f) too small" |
| 2746 |
(W overflow) You called \f(CW\*(C`gmtime\*(C'\fR with a number that was smaller than |
| 2747 |
it can reliably handle and \f(CW\*(C`gmtime\*(C'\fR probably returned the wrong date. |
| 2748 |
.IP "Got an error from DosAllocMem" 4 |
| 2749 |
.IX Item "Got an error from DosAllocMem" |
| 2750 |
(P) An error peculiar to OS/2. Most probably you're using an obsolete |
| 2751 |
version of Perl, and this should not happen anyway. |
| 2752 |
.IP "goto must have label" 4 |
| 2753 |
.IX Item "goto must have label" |
| 2754 |
(F) Unlike with "next" or "last", you're not allowed to goto an |
| 2755 |
unspecified destination. See "goto" in perlfunc. |
| 2756 |
.IP "Goto undefined subroutine%s" 4 |
| 2757 |
.IX Item "Goto undefined subroutine%s" |
| 2758 |
(F) You tried to call a subroutine with \f(CW\*(C`goto &sub\*(C'\fR syntax, but |
| 2759 |
the indicated subroutine hasn't been defined, or if it was, it |
| 2760 |
has since been undefined. |
| 2761 |
.IP "Group name must start with a non-digit word character in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 2762 |
.IX Item "Group name must start with a non-digit word character in regex; marked by <--\ HERE in m/%s/" |
| 2763 |
(F) Group names must follow the rules for perl identifiers, meaning |
| 2764 |
they must start with a non-digit word character. A common cause of |
| 2765 |
this error is using (?&0) instead of (?0). See perlre. |
| 2766 |
.IP "()\-group starts with a count" 4 |
| 2767 |
.IX Item "()-group starts with a count" |
| 2768 |
(F) A ()\-group started with a count. A count is supposed to follow |
| 2769 |
something: a template character or a ()\-group. See "pack" in perlfunc. |
| 2770 |
.ie n .IP "%s had compilation errors." 4 |
| 2771 |
.el .IP "\f(CW%s\fR had compilation errors." 4 |
| 2772 |
.IX Item "%s had compilation errors." |
| 2773 |
(F) The final summary message when a \f(CW\*(C`perl \-c\*(C'\fR fails. |
| 2774 |
.ie n .IP "Had to create %s unexpectedly" 4 |
| 2775 |
.el .IP "Had to create \f(CW%s\fR unexpectedly" 4 |
| 2776 |
.IX Item "Had to create %s unexpectedly" |
| 2777 |
(S internal) A routine asked for a symbol from a symbol table that ought |
| 2778 |
to have existed already, but for some reason it didn't, and had to be |
| 2779 |
created on an emergency basis to prevent a core dump. |
| 2780 |
.ie n .IP "%s has too many errors" 4 |
| 2781 |
.el .IP "\f(CW%s\fR has too many errors" 4 |
| 2782 |
.IX Item "%s has too many errors" |
| 2783 |
(F) The parser has given up trying to parse the program after 10 errors. |
| 2784 |
Further error messages would likely be uninformative. |
| 2785 |
.IP "Hexadecimal float: exponent overflow" 4 |
| 2786 |
.IX Item "Hexadecimal float: exponent overflow" |
| 2787 |
(W overflow) The hexadecimal floating point has a larger exponent |
| 2788 |
than the floating point supports. |
| 2789 |
.IP "Hexadecimal float: exponent underflow" 4 |
| 2790 |
.IX Item "Hexadecimal float: exponent underflow" |
| 2791 |
(W overflow) The hexadecimal floating point has a smaller exponent |
| 2792 |
than the floating point supports. With the IEEE 754 floating point, |
| 2793 |
this may also mean that the subnormals (formerly known as denormals) |
| 2794 |
are being used, which may or may not be an error. |
| 2795 |
.IP "Hexadecimal float: internal error (%s)" 4 |
| 2796 |
.IX Item "Hexadecimal float: internal error (%s)" |
| 2797 |
(F) Something went horribly bad in hexadecimal float handling. |
| 2798 |
.IP "Hexadecimal float: mantissa overflow" 4 |
| 2799 |
.IX Item "Hexadecimal float: mantissa overflow" |
| 2800 |
(W overflow) The hexadecimal floating point literal had more bits in |
| 2801 |
the mantissa (the part between the 0x and the exponent, also known as |
| 2802 |
the fraction or the significand) than the floating point supports. |
| 2803 |
.IP "Hexadecimal float: precision loss" 4 |
| 2804 |
.IX Item "Hexadecimal float: precision loss" |
| 2805 |
(W overflow) The hexadecimal floating point had internally more |
| 2806 |
digits than could be output. This can be caused by unsupported |
| 2807 |
long double formats, or by 64\-bit integers not being available |
| 2808 |
(needed to retrieve the digits under some configurations). |
| 2809 |
.IP "Hexadecimal float: unsupported long double format" 4 |
| 2810 |
.IX Item "Hexadecimal float: unsupported long double format" |
| 2811 |
(F) You have configured Perl to use long doubles but |
| 2812 |
the internals of the long double format are unknown; |
| 2813 |
therefore the hexadecimal float output is impossible. |
| 2814 |
.IP "Hexadecimal number > 0xffffffff non-portable" 4 |
| 2815 |
.IX Item "Hexadecimal number > 0xffffffff non-portable" |
| 2816 |
(W portable) The hexadecimal number you specified is larger than 2**32\-1 |
| 2817 |
(4294967295) and therefore non-portable between systems. See |
| 2818 |
perlport for more on portability concerns. |
| 2819 |
.IP "Identifier too long" 4 |
| 2820 |
.IX Item "Identifier too long" |
| 2821 |
(F) Perl limits identifiers (names for variables, functions, etc.) to |
| 2822 |
about 250 characters for simple names, and somewhat more for compound |
| 2823 |
names (like \f(CW$A::B\fR). You've exceeded Perl's limits. Future versions |
| 2824 |
of Perl are likely to eliminate these arbitrary limitations. |
| 2825 |
.IP "Ignoring zero length \eN{} in character class in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 2826 |
.IX Item "Ignoring zero length N{} in character class in regex; marked by <--\ HERE in m/%s/" |
| 2827 |
(W regexp) Named Unicode character escapes (\f(CW\*(C`\eN{...}\*(C'\fR) may return a |
| 2828 |
zero-length sequence. When such an escape is used in a character |
| 2829 |
class its behavior is not well defined. Check that the correct |
| 2830 |
escape has been used, and the correct charname handler is in scope. |
| 2831 |
.ie n .IP "Illegal %s digit '%c' ignored" 4 |
| 2832 |
.el .IP "Illegal \f(CW%s\fR digit '%c' ignored" 4 |
| 2833 |
.IX Item "Illegal %s digit '%c' ignored" |
| 2834 |
(W digit) Here \f(CW%s\fR is one of "binary", "octal", or "hex". |
| 2835 |
You may have tried to use a digit other than one that is legal for the |
| 2836 |
given type, such as only 0 and 1 for binary. For octals, this is raised |
| 2837 |
only if the illegal character is an '8' or '9'. For hex, 'A' \- 'F' and |
| 2838 |
\&'a' \- 'f' are legal. |
| 2839 |
Interpretation of the number stopped just before the offending digit or |
| 2840 |
character. |
| 2841 |
.IP "Illegal binary digit '%c'" 4 |
| 2842 |
.IX Item "Illegal binary digit '%c'" |
| 2843 |
(F) You used a digit other than 0 or 1 in a binary number. |
| 2844 |
.ie n .IP "Illegal character after '_' in prototype for %s : %s" 4 |
| 2845 |
.el .IP "Illegal character after '_' in prototype for \f(CW%s\fR : \f(CW%s\fR" 4 |
| 2846 |
.IX Item "Illegal character after '_' in prototype for %s : %s" |
| 2847 |
(W illegalproto) An illegal character was found in a prototype |
| 2848 |
declaration. The '_' in a prototype must be followed by a ';', |
| 2849 |
indicating the rest of the parameters are optional, or one of '@' |
| 2850 |
or '%', since those two will accept 0 or more final parameters. |
| 2851 |
.IP "Illegal character \e%o (carriage return)" 4 |
| 2852 |
.IX Item "Illegal character %o (carriage return)" |
| 2853 |
(F) Perl normally treats carriage returns in the program text as |
| 2854 |
it would any other whitespace, which means you should never see |
| 2855 |
this error when Perl was built using standard options. For some |
| 2856 |
reason, your version of Perl appears to have been built without |
| 2857 |
this support. Talk to your Perl administrator. |
| 2858 |
.IP "Illegal character following sigil in a subroutine signature" 4 |
| 2859 |
.IX Item "Illegal character following sigil in a subroutine signature" |
| 2860 |
(F) A parameter in a subroutine signature contained an unexpected character |
| 2861 |
following the \f(CW\*(C`$\*(C'\fR, \f(CW\*(C`@\*(C'\fR or \f(CW\*(C`%\*(C'\fR sigil character. Normally the sigil |
| 2862 |
should be followed by the variable name or \f(CW\*(C`=\*(C'\fR etc. Perhaps you are |
| 2863 |
trying use a prototype while in the scope of \f(CW\*(C`use feature \*(Aqsignatures\*(Aq\*(C'\fR? |
| 2864 |
For example: |
| 2865 |
.Sp |
| 2866 |
.Vb 1 |
| 2867 |
\& sub foo ($$) {} # legal \- a prototype |
| 2868 |
\& |
| 2869 |
\& use feature \*(Aqsignatures; |
| 2870 |
\& sub foo ($$) {} # illegal \- was expecting a signature |
| 2871 |
\& sub foo ($x, $y) |
| 2872 |
\& :prototype($$) {} # legal |
| 2873 |
.Ve |
| 2874 |
.ie n .IP "Illegal character in prototype for %s : %s" 4 |
| 2875 |
.el .IP "Illegal character in prototype for \f(CW%s\fR : \f(CW%s\fR" 4 |
| 2876 |
.IX Item "Illegal character in prototype for %s : %s" |
| 2877 |
(W illegalproto) An illegal character was found in a prototype declaration. |
| 2878 |
Legal characters in prototypes are $, @, %, *, ;, [, ], &, \e, and +. |
| 2879 |
Perhaps you were trying to write a subroutine signature but didn't enable |
| 2880 |
that feature first (\f(CW\*(C`use feature \*(Aqsignatures\*(Aq\*(C'\fR), so your signature was |
| 2881 |
instead interpreted as a bad prototype. |
| 2882 |
.IP "Illegal declaration of anonymous subroutine" 4 |
| 2883 |
.IX Item "Illegal declaration of anonymous subroutine" |
| 2884 |
(F) When using the \f(CW\*(C`sub\*(C'\fR keyword to construct an anonymous subroutine, |
| 2885 |
you must always specify a block of code. See perlsub. |
| 2886 |
.ie n .IP "Illegal declaration of subroutine %s" 4 |
| 2887 |
.el .IP "Illegal declaration of subroutine \f(CW%s\fR" 4 |
| 2888 |
.IX Item "Illegal declaration of subroutine %s" |
| 2889 |
(F) A subroutine was not declared correctly. See perlsub. |
| 2890 |
.IP "Illegal division by zero" 4 |
| 2891 |
.IX Item "Illegal division by zero" |
| 2892 |
(F) You tried to divide a number by 0. Either something was wrong in |
| 2893 |
your logic, or you need to put a conditional in to guard against |
| 2894 |
meaningless input. |
| 2895 |
.IP "Illegal modulus zero" 4 |
| 2896 |
.IX Item "Illegal modulus zero" |
| 2897 |
(F) You tried to divide a number by 0 to get the remainder. Most |
| 2898 |
numbers don't take to this kindly. |
| 2899 |
.IP "Illegal number of bits in vec" 4 |
| 2900 |
.IX Item "Illegal number of bits in vec" |
| 2901 |
(F) The number of bits in \fBvec()\fR (the third argument) must be a power of |
| 2902 |
two from 1 to 32 (or 64, if your platform supports that). |
| 2903 |
.IP "Illegal octal digit '%c'" 4 |
| 2904 |
.IX Item "Illegal octal digit '%c'" |
| 2905 |
(F) You used an 8 or 9 in an octal number. |
| 2906 |
.IP "Illegal operator following parameter in a subroutine signature" 4 |
| 2907 |
.IX Item "Illegal operator following parameter in a subroutine signature" |
| 2908 |
(F) A parameter in a subroutine signature, was followed by something |
| 2909 |
other than \f(CW\*(C`=\*(C'\fR introducing a default, \f(CW\*(C`,\*(C'\fR or \f(CW\*(C`)\*(C'\fR. |
| 2910 |
.Sp |
| 2911 |
.Vb 5 |
| 2912 |
\& use feature \*(Aqsignatures\*(Aq; |
| 2913 |
\& sub foo ($=1) {} # legal |
| 2914 |
\& sub foo ($x = 1) {} # legal |
| 2915 |
\& sub foo ($x += 1) {} # illegal |
| 2916 |
\& sub foo ($x == 1) {} # illegal |
| 2917 |
.Ve |
| 2918 |
.IP "Illegal pattern in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 2919 |
.IX Item "Illegal pattern in regex; marked by <--\ HERE in m/%s/" |
| 2920 |
(F) You wrote something like |
| 2921 |
.Sp |
| 2922 |
.Vb 1 |
| 2923 |
\& (?+foo) |
| 2924 |
.Ve |
| 2925 |
.Sp |
| 2926 |
The \f(CW"+"\fR is valid only when followed by digits, indicating a |
| 2927 |
capturing group. See |
| 2928 |
\&\f(CW\*(C`(?\fR\f(CIPARNO\fR\f(CW)\*(C'\fR. |
| 2929 |
.IP "Illegal suidscript" 4 |
| 2930 |
.IX Item "Illegal suidscript" |
| 2931 |
(F) The script run under suidperl was somehow illegal. |
| 2932 |
.IP "Illegal switch in PERL5OPT: \-%c" 4 |
| 2933 |
.IX Item "Illegal switch in PERL5OPT: -%c" |
| 2934 |
(X) The PERL5OPT environment variable may only be used to set the |
| 2935 |
following switches: \fB\-[CDIMUdmtw]\fR. |
| 2936 |
.IP "Illegal user-defined property name" 4 |
| 2937 |
.IX Item "Illegal user-defined property name" |
| 2938 |
(F) You specified a Unicode-like property name in a regular expression |
| 2939 |
pattern (using \f(CW\*(C`\ep{}\*(C'\fR or \f(CW\*(C`\eP{}\*(C'\fR) that Perl knows isn't an official |
| 2940 |
Unicode property, and was likely meant to be a user-defined property |
| 2941 |
name, but it can't be one of those, as they must begin with either \f(CW\*(C`In\*(C'\fR |
| 2942 |
or \f(CW\*(C`Is\*(C'\fR. Check the spelling. See also |
| 2943 |
"Can't find Unicode property definition "%s"". |
| 2944 |
.IP "Ill-formed CRTL environ value ""%s""" 4 |
| 2945 |
.IX Item "Ill-formed CRTL environ value ""%s""" |
| 2946 |
(W internal) A warning peculiar to VMS. Perl tried to read the CRTL's |
| 2947 |
internal environ array, and encountered an element without the \f(CW\*(C`=\*(C'\fR |
| 2948 |
delimiter used to separate keys from values. The element is ignored. |
| 2949 |
.IP "Ill-formed message in prime_env_iter: |%s|" 4 |
| 2950 |
.IX Item "Ill-formed message in prime_env_iter: |%s|" |
| 2951 |
(W internal) A warning peculiar to VMS. Perl tried to read a logical |
| 2952 |
name or CLI symbol definition when preparing to iterate over \f(CW%ENV\fR, and |
| 2953 |
didn't see the expected delimiter between key and value, so the line was |
| 2954 |
ignored. |
| 2955 |
.ie n .IP "(in cleanup) %s" 4 |
| 2956 |
.el .IP "(in cleanup) \f(CW%s\fR" 4 |
| 2957 |
.IX Item "(in cleanup) %s" |
| 2958 |
(W misc) This prefix usually indicates that a \fBDESTROY()\fR method raised |
| 2959 |
the indicated exception. Since destructors are usually called by the |
| 2960 |
system at arbitrary points during execution, and often a vast number of |
| 2961 |
times, the warning is issued only once for any number of failures that |
| 2962 |
would otherwise result in the same message being repeated. |
| 2963 |
.Sp |
| 2964 |
Failure of user callbacks dispatched using the \f(CW\*(C`G_KEEPERR\*(C'\fR flag could |
| 2965 |
also result in this warning. See "G_KEEPERR" in perlcall. |
| 2966 |
.ie n .IP "Implicit use of @_ in %s with signatured subroutine is experimental" 4 |
| 2967 |
.el .IP "Implicit use of \f(CW@_\fR in \f(CW%s\fR with signatured subroutine is experimental" 4 |
| 2968 |
.IX Item "Implicit use of @_ in %s with signatured subroutine is experimental" |
| 2969 |
(S experimental::args_array_with_signatures) An expression that implicitly |
| 2970 |
involves the \f(CW@_\fR arguments array was found in a subroutine that uses a |
| 2971 |
signature. This is experimental because the interaction between the |
| 2972 |
arguments array and parameter handling via signatures is not guaranteed |
| 2973 |
to remain stable in any future version of Perl, and such code should be |
| 2974 |
avoided. |
| 2975 |
.IP "Incomplete expression within '(?[ ])' in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 2976 |
.IX Item "Incomplete expression within '(?[ ])' in regex; marked by <--\ HERE in m/%s/" |
| 2977 |
(F) There was a syntax error within the \f(CW\*(C`(?[ ])\*(C'\fR. This can happen if the |
| 2978 |
expression inside the construct was completely empty, or if there are |
| 2979 |
too many or few operands for the number of operators. Perl is not smart |
| 2980 |
enough to give you a more precise indication as to what is wrong. |
| 2981 |
.IP "Inconsistent hierarchy during C3 merge of class '%s': merging failed on parent '%s'" 4 |
| 2982 |
.IX Item "Inconsistent hierarchy during C3 merge of class '%s': merging failed on parent '%s'" |
| 2983 |
(F) The method resolution order (MRO) of the given class is not |
| 2984 |
C3\-consistent, and you have enabled the C3 MRO for this class. See the C3 |
| 2985 |
documentation in mro for more information. |
| 2986 |
.ie n .IP "Indentation on line %d of here-doc doesn't match delimiter" 4 |
| 2987 |
.el .IP "Indentation on line \f(CW%d\fR of here-doc doesn't match delimiter" 4 |
| 2988 |
.IX Item "Indentation on line %d of here-doc doesn't match delimiter" |
| 2989 |
(F) You have an indented here-document where one or more of its lines |
| 2990 |
have whitespace at the beginning that does not match the closing |
| 2991 |
delimiter. |
| 2992 |
.Sp |
| 2993 |
For example, line 2 below is wrong because it does not have at least |
| 2994 |
2 spaces, but lines 1 and 3 are fine because they have at least 2: |
| 2995 |
.Sp |
| 2996 |
.Vb 7 |
| 2997 |
\& if ($something) { |
| 2998 |
\& print <<~EOF; |
| 2999 |
\& Line 1 |
| 3000 |
\& Line 2 not |
| 3001 |
\& Line 3 |
| 3002 |
\& EOF |
| 3003 |
\& } |
| 3004 |
.Ve |
| 3005 |
.Sp |
| 3006 |
Note that tabs and spaces are compared strictly, meaning 1 tab will |
| 3007 |
not match 8 spaces. |
| 3008 |
.IP "Infinite recursion in regex" 4 |
| 3009 |
.IX Item "Infinite recursion in regex" |
| 3010 |
(F) You used a pattern that references itself without consuming any input |
| 3011 |
text. You should check the pattern to ensure that recursive patterns |
| 3012 |
either consume text or fail. |
| 3013 |
.IP "Infinite recursion in user-defined property" 4 |
| 3014 |
.IX Item "Infinite recursion in user-defined property" |
| 3015 |
(F) A user-defined property ("User-Defined Character |
| 3016 |
Properties" in perlunicode) can depend on the definitions of other user-defined |
| 3017 |
properties. If the chain of dependencies leads back to this property, |
| 3018 |
infinite recursion would occur, were it not for the check that raised |
| 3019 |
this error. |
| 3020 |
.Sp |
| 3021 |
Restructure your property definitions to avoid this. |
| 3022 |
.IP "Infinite recursion via empty pattern" 4 |
| 3023 |
.IX Item "Infinite recursion via empty pattern" |
| 3024 |
(F) You tried to use the empty pattern inside of a regex code block, |
| 3025 |
for instance \f(CW\*(C`/(?{ s!!! })/\*(C'\fR, which resulted in re-executing |
| 3026 |
the same pattern, which is an infinite loop which is broken by |
| 3027 |
throwing an exception. |
| 3028 |
.IP "Initialization of state variables in list currently forbidden" 4 |
| 3029 |
.IX Item "Initialization of state variables in list currently forbidden" |
| 3030 |
(F) \f(CW\*(C`state\*(C'\fR only permits initializing a single variable, specified |
| 3031 |
without parentheses. So \f(CW\*(C`state $x = 42\*(C'\fR and \f(CW\*(C`state @x = qw(a b c)\*(C'\fR are |
| 3032 |
allowed, but not \f(CW\*(C`state ($x) = 42\*(C'\fR or \f(CW\*(C`(state $x) = 42\*(C'\fR. To initialize |
| 3033 |
more than one \f(CW\*(C`state\*(C'\fR variable, initialize them one at a time. |
| 3034 |
.IP "%%s[%s] in scalar context better written as $%s[%s]" 4 |
| 3035 |
.IX Item "%%s[%s] in scalar context better written as $%s[%s]" |
| 3036 |
(W syntax) In scalar context, you've used an array index/value slice |
| 3037 |
(indicated by %) to select a single element of an array. Generally |
| 3038 |
it's better to ask for a scalar value (indicated by $). The difference |
| 3039 |
is that \f(CW$foo[&bar]\fR always behaves like a scalar, both in the value it |
| 3040 |
returns and when evaluating its argument, while \f(CW%foo[&bar]\fR provides |
| 3041 |
a list context to its subscript, which can do weird things if you're |
| 3042 |
expecting only one subscript. When called in list context, it also |
| 3043 |
returns the index (what \f(CW&bar\fR returns) in addition to the value. |
| 3044 |
.IP "%%s{%s} in scalar context better written as $%s{%s}" 4 |
| 3045 |
.IX Item "%%s{%s} in scalar context better written as $%s{%s}" |
| 3046 |
(W syntax) In scalar context, you've used a hash key/value slice |
| 3047 |
(indicated by %) to select a single element of a hash. Generally it's |
| 3048 |
better to ask for a scalar value (indicated by $). The difference |
| 3049 |
is that \f(CW$foo{&bar}\fR always behaves like a scalar, both in the value |
| 3050 |
it returns and when evaluating its argument, while \f(CW@foo{&bar}\fR and |
| 3051 |
provides a list context to its subscript, which can do weird things |
| 3052 |
if you're expecting only one subscript. When called in list context, |
| 3053 |
it also returns the key in addition to the value. |
| 3054 |
.ie n .IP "Insecure dependency in %s" 4 |
| 3055 |
.el .IP "Insecure dependency in \f(CW%s\fR" 4 |
| 3056 |
.IX Item "Insecure dependency in %s" |
| 3057 |
(F) You tried to do something that the tainting mechanism didn't like. |
| 3058 |
The tainting mechanism is turned on when you're running setuid or |
| 3059 |
setgid, or when you specify \fB\-T\fR to turn it on explicitly. The |
| 3060 |
tainting mechanism labels all data that's derived directly or indirectly |
| 3061 |
from the user, who is considered to be unworthy of your trust. If any |
| 3062 |
such data is used in a "dangerous" operation, you get this error. See |
| 3063 |
perlsec for more information. |
| 3064 |
.ie n .IP "Insecure directory in %s" 4 |
| 3065 |
.el .IP "Insecure directory in \f(CW%s\fR" 4 |
| 3066 |
.IX Item "Insecure directory in %s" |
| 3067 |
(F) You can't use \fBsystem()\fR, \fBexec()\fR, or a piped open in a setuid or |
| 3068 |
setgid script if \f(CW$ENV{PATH}\fR contains a directory that is writable by |
| 3069 |
the world. Also, the PATH must not contain any relative directory. |
| 3070 |
See perlsec. |
| 3071 |
.ie n .IP "Insecure $ENV{%s} while running %s" 4 |
| 3072 |
.el .IP "Insecure \f(CW$ENV\fR{%s} while running \f(CW%s\fR" 4 |
| 3073 |
.IX Item "Insecure $ENV{%s} while running %s" |
| 3074 |
(F) You can't use \fBsystem()\fR, \fBexec()\fR, or a piped open in a setuid or |
| 3075 |
setgid script if any of \f(CW$ENV{PATH}\fR, \f(CW$ENV{IFS}\fR, \f(CW$ENV{CDPATH}\fR, |
| 3076 |
\&\f(CW$ENV{ENV}\fR, \f(CW$ENV{BASH_ENV}\fR or \f(CW$ENV{TERM}\fR are derived from data |
| 3077 |
supplied (or potentially supplied) by the user. The script must set |
| 3078 |
the path to a known value, using trustworthy data. See perlsec. |
| 3079 |
.ie n .IP "Insecure user-defined property %s" 4 |
| 3080 |
.el .IP "Insecure user-defined property \f(CW%s\fR" 4 |
| 3081 |
.IX Item "Insecure user-defined property %s" |
| 3082 |
(F) Perl detected tainted data when trying to compile a regular |
| 3083 |
expression that contains a call to a user-defined character property |
| 3084 |
function, i.e. \f(CW\*(C`\ep{IsFoo}\*(C'\fR or \f(CW\*(C`\ep{InFoo}\*(C'\fR. |
| 3085 |
See "User-Defined Character Properties" in perlunicode and perlsec. |
| 3086 |
.ie n .IP "Integer overflow in format string for %s" 4 |
| 3087 |
.el .IP "Integer overflow in format string for \f(CW%s\fR" 4 |
| 3088 |
.IX Item "Integer overflow in format string for %s" |
| 3089 |
(F) The indexes and widths specified in the format string of \f(CWprintf()\fR |
| 3090 |
or \f(CWsprintf()\fR are too large. The numbers must not overflow the size of |
| 3091 |
integers for your architecture. |
| 3092 |
.ie n .IP "Integer overflow in %s number" 4 |
| 3093 |
.el .IP "Integer overflow in \f(CW%s\fR number" 4 |
| 3094 |
.IX Item "Integer overflow in %s number" |
| 3095 |
(S overflow) The hexadecimal, octal or binary number you have specified |
| 3096 |
either as a literal or as an argument to \fBhex()\fR or \fBoct()\fR is too big for |
| 3097 |
your architecture, and has been converted to a floating point number. |
| 3098 |
On a 32\-bit architecture the largest hexadecimal, octal or binary number |
| 3099 |
representable without overflow is 0xFFFFFFFF, 037777777777, or |
| 3100 |
0b11111111111111111111111111111111 respectively. Note that Perl |
| 3101 |
transparently promotes all numbers to a floating point representation |
| 3102 |
internally\-\-subject to loss of precision errors in subsequent |
| 3103 |
operations. |
| 3104 |
.IP "Integer overflow in srand" 4 |
| 3105 |
.IX Item "Integer overflow in srand" |
| 3106 |
(S overflow) The number you have passed to srand is too big to fit |
| 3107 |
in your architecture's integer representation. The number has been |
| 3108 |
replaced with the largest integer supported (0xFFFFFFFF on 32\-bit |
| 3109 |
architectures). This means you may be getting less randomness than |
| 3110 |
you expect, because different random seeds above the maximum will |
| 3111 |
return the same sequence of random numbers. |
| 3112 |
.IP "Integer overflow in version" 4 |
| 3113 |
.IX Item "Integer overflow in version" |
| 3114 |
.PD 0 |
| 3115 |
.ie n .IP "Integer overflow in version %d" 4 |
| 3116 |
.el .IP "Integer overflow in version \f(CW%d\fR" 4 |
| 3117 |
.IX Item "Integer overflow in version %d" |
| 3118 |
.PD |
| 3119 |
(W overflow) Some portion of a version initialization is too large for |
| 3120 |
the size of integers for your architecture. This is not a warning |
| 3121 |
because there is no rational reason for a version to try and use an |
| 3122 |
element larger than typically 2**32. This is usually caused by trying |
| 3123 |
to use some odd mathematical operation as a version, like 100/9. |
| 3124 |
.IP "Internal disaster in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3125 |
.IX Item "Internal disaster in regex; marked by <--\ HERE in m/%s/" |
| 3126 |
(P) Something went badly wrong in the regular expression parser. |
| 3127 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 3128 |
discovered. |
| 3129 |
.IP "Internal inconsistency in tracking vforks" 4 |
| 3130 |
.IX Item "Internal inconsistency in tracking vforks" |
| 3131 |
(S) A warning peculiar to VMS. Perl keeps track of the number of times |
| 3132 |
you've called \f(CW\*(C`fork\*(C'\fR and \f(CW\*(C`exec\*(C'\fR, to determine whether the current call |
| 3133 |
to \f(CW\*(C`exec\*(C'\fR should affect the current script or a subprocess (see |
| 3134 |
"exec LIST" in perlvms). Somehow, this count has become scrambled, so |
| 3135 |
Perl is making a guess and treating this \f(CW\*(C`exec\*(C'\fR as a request to |
| 3136 |
terminate the Perl script and execute the specified command. |
| 3137 |
.IP "internal %<num>p might conflict with future printf extensions" 4 |
| 3138 |
.IX Item "internal %<num>p might conflict with future printf extensions" |
| 3139 |
(S internal) Perl's internal routine that handles \f(CW\*(C`printf\*(C'\fR and \f(CW\*(C`sprintf\*(C'\fR |
| 3140 |
formatting follows a slightly different set of rules when called from |
| 3141 |
C or XS code. Specifically, formats consisting of digits followed |
| 3142 |
by "p" (e.g., "%7p") are reserved for future use. If you see this |
| 3143 |
message, then an XS module tried to call that routine with one such |
| 3144 |
reserved format. |
| 3145 |
.IP "Internal urp in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3146 |
.IX Item "Internal urp in regex; marked by <--\ HERE in m/%s/" |
| 3147 |
(P) Something went badly awry in the regular expression parser. The |
| 3148 |
<\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 3149 |
discovered. |
| 3150 |
.ie n .IP "%s (...) interpreted as function" 4 |
| 3151 |
.el .IP "\f(CW%s\fR (...) interpreted as function" 4 |
| 3152 |
.IX Item "%s (...) interpreted as function" |
| 3153 |
(W syntax) You've run afoul of the rule that says that any list operator |
| 3154 |
followed by parentheses turns into a function, with all the list |
| 3155 |
operators arguments found inside the parentheses. See |
| 3156 |
"Terms and List Operators (Leftward)" in perlop. |
| 3157 |
.IP "In '(?...)', the '(' and '?' must be adjacent in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3158 |
.IX Item "In '(?...)', the '(' and '?' must be adjacent in regex; marked by <--\ HERE in m/%s/" |
| 3159 |
(F) The two-character sequence \f(CW"(?"\fR in this context in a regular |
| 3160 |
expression pattern should be an indivisible token, with nothing |
| 3161 |
intervening between the \f(CW"("\fR and the \f(CW"?"\fR, but you separated them |
| 3162 |
with whitespace. |
| 3163 |
.IP "In '(*...)', the '(' and '*' must be adjacent in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3164 |
.IX Item "In '(*...)', the '(' and '*' must be adjacent in regex; marked by <--\ HERE in m/%s/" |
| 3165 |
(F) The two-character sequence \f(CW"(*"\fR in this context in a regular |
| 3166 |
expression pattern should be an indivisible token, with nothing |
| 3167 |
intervening between the \f(CW"("\fR and the \f(CW"*"\fR, but you separated them. |
| 3168 |
Fix the pattern and retry. |
| 3169 |
.ie n .IP "Invalid %s attribute: %s" 4 |
| 3170 |
.el .IP "Invalid \f(CW%s\fR attribute: \f(CW%s\fR" 4 |
| 3171 |
.IX Item "Invalid %s attribute: %s" |
| 3172 |
(F) The indicated attribute for a subroutine or variable was not recognized |
| 3173 |
by Perl or by a user-supplied handler. See attributes. |
| 3174 |
.ie n .IP "Invalid %s attributes: %s" 4 |
| 3175 |
.el .IP "Invalid \f(CW%s\fR attributes: \f(CW%s\fR" 4 |
| 3176 |
.IX Item "Invalid %s attributes: %s" |
| 3177 |
(F) The indicated attributes for a subroutine or variable were not |
| 3178 |
recognized by Perl or by a user-supplied handler. See attributes. |
| 3179 |
.IP "Invalid character in charnames alias definition; marked by <\-\-\ HERE in '%s" 4 |
| 3180 |
.IX Item "Invalid character in charnames alias definition; marked by <--\ HERE in '%s" |
| 3181 |
(F) You tried to create a custom alias for a character name, with |
| 3182 |
the \f(CW\*(C`:alias\*(C'\fR option to \f(CW\*(C`use charnames\*(C'\fR and the specified character in |
| 3183 |
the indicated name isn't valid. See "CUSTOM ALIASES" in charnames. |
| 3184 |
.ie n .IP "Invalid \e0 character in %s for %s: %s\e0%s" 4 |
| 3185 |
.el .IP "Invalid \e0 character in \f(CW%s\fR for \f(CW%s:\fR \f(CW%s\fR\e0%s" 4 |
| 3186 |
.IX Item "Invalid 0 character in %s for %s: %s0%s" |
| 3187 |
(W syscalls) Embedded \e0 characters in pathnames or other system call |
| 3188 |
arguments produce a warning as of 5.20. The parts after the \e0 were |
| 3189 |
formerly ignored by system calls. |
| 3190 |
.IP "Invalid character in \eN{...}; marked by <\-\-\ HERE in \eN{%s}" 4 |
| 3191 |
.IX Item "Invalid character in N{...}; marked by <--\ HERE in N{%s}" |
| 3192 |
(F) Only certain characters are valid for character names. The |
| 3193 |
indicated one isn't. See "CUSTOM ALIASES" in charnames. |
| 3194 |
.ie n .IP "Invalid conversion in %s: ""%s""" 4 |
| 3195 |
.el .IP "Invalid conversion in \f(CW%s:\fR ""%s""" 4 |
| 3196 |
.IX Item "Invalid conversion in %s: ""%s""" |
| 3197 |
(W printf) Perl does not understand the given format conversion. See |
| 3198 |
"sprintf" in perlfunc. |
| 3199 |
.IP "Invalid escape in the specified encoding in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3200 |
.IX Item "Invalid escape in the specified encoding in regex; marked by <--\ HERE in m/%s/" |
| 3201 |
(W regexp)(F) The numeric escape (for example \f(CW\*(C`\exHH\*(C'\fR) of value < 256 |
| 3202 |
didn't correspond to a single character through the conversion |
| 3203 |
from the encoding specified by the encoding pragma. |
| 3204 |
The escape was replaced with REPLACEMENT CHARACTER (U+FFFD) |
| 3205 |
instead, except within \f(CW\*(C`(?[\ \ \ ])\*(C'\fR, where it is a fatal error. |
| 3206 |
The <\-\-\ HERE shows whereabouts in the regular expression the |
| 3207 |
escape was discovered. |
| 3208 |
.IP "Invalid hexadecimal number in \eN{U+...}" 4 |
| 3209 |
.IX Item "Invalid hexadecimal number in N{U+...}" |
| 3210 |
.PD 0 |
| 3211 |
.IP "Invalid hexadecimal number in \eN{U+...} in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3212 |
.IX Item "Invalid hexadecimal number in N{U+...} in regex; marked by <--\ HERE in m/%s/" |
| 3213 |
.PD |
| 3214 |
(F) The character constant represented by \f(CW\*(C`...\*(C'\fR is not a valid hexadecimal |
| 3215 |
number. Either it is empty, or you tried to use a character other than |
| 3216 |
0 \- 9 or A \- F, a \- f in a hexadecimal number. |
| 3217 |
.ie n .IP "Invalid module name %s with \-%c option: contains single ':'" 4 |
| 3218 |
.el .IP "Invalid module name \f(CW%s\fR with \-%c option: contains single ':'" 4 |
| 3219 |
.IX Item "Invalid module name %s with -%c option: contains single ':'" |
| 3220 |
(F) The module argument to perl's \fB\-m\fR and \fB\-M\fR command-line options |
| 3221 |
cannot contain single colons in the module name, but only in the |
| 3222 |
arguments after "=". In other words, \fB\-MFoo::Bar=:baz\fR is ok, but |
| 3223 |
\&\fB\-MFoo:Bar=baz\fR is not. |
| 3224 |
.IP "Invalid mro name: '%s'" 4 |
| 3225 |
.IX Item "Invalid mro name: '%s'" |
| 3226 |
(F) You tried to \f(CW\*(C`mro::set_mro("classname", "foo")\*(C'\fR or \f(CW\*(C`use mro \*(Aqfoo\*(Aq\*(C'\fR, |
| 3227 |
where \f(CW\*(C`foo\*(C'\fR is not a valid method resolution order (MRO). Currently, |
| 3228 |
the only valid ones supported are \f(CW\*(C`dfs\*(C'\fR and \f(CW\*(C`c3\*(C'\fR, unless you have loaded |
| 3229 |
a module that is a MRO plugin. See mro and perlmroapi. |
| 3230 |
.IP "Invalid negative number (%s) in chr" 4 |
| 3231 |
.IX Item "Invalid negative number (%s) in chr" |
| 3232 |
(W utf8) You passed a negative number to \f(CW\*(C`chr\*(C'\fR. Negative numbers are |
| 3233 |
not valid character numbers, so it returns the Unicode replacement |
| 3234 |
character (U+FFFD). |
| 3235 |
.IP "Invalid number '%s' for \-C option." 4 |
| 3236 |
.IX Item "Invalid number '%s' for -C option." |
| 3237 |
(F) You supplied a number to the \-C option that either has extra leading |
| 3238 |
zeroes or overflows perl's unsigned integer representation. |
| 3239 |
.IP "invalid option \-D%c, use \-D'' to see choices" 4 |
| 3240 |
.IX Item "invalid option -D%c, use -D'' to see choices" |
| 3241 |
(S debugging) Perl was called with invalid debugger flags. Call perl |
| 3242 |
with the \fB\-D\fR option with no flags to see the list of acceptable values. |
| 3243 |
See also "\-Dletters" in perlrun. |
| 3244 |
.IP "Invalid quantifier in {,} in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3245 |
.IX Item "Invalid quantifier in {,} in regex; marked by <--\ HERE in m/%s/" |
| 3246 |
(F) The pattern looks like a {min,max} quantifier, but the min or max |
| 3247 |
could not be parsed as a valid number \- either it has leading zeroes, |
| 3248 |
or it represents too big a number to cope with. The <\-\-\ HERE shows |
| 3249 |
where in the regular expression the problem was discovered. See perlre. |
| 3250 |
.IP "Invalid [] range ""%s"" in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3251 |
.IX Item "Invalid [] range ""%s"" in regex; marked by <--\ HERE in m/%s/" |
| 3252 |
(F) The range specified in a character class had a minimum character |
| 3253 |
greater than the maximum character. One possibility is that you forgot the |
| 3254 |
\&\f(CW\*(C`{}\*(C'\fR from your ending \f(CW\*(C`\ex{}\*(C'\fR \- \f(CW\*(C`\ex\*(C'\fR without the curly braces can go only |
| 3255 |
up to \f(CW\*(C`ff\*(C'\fR. The <\-\-\ HERE shows whereabouts in the regular expression the |
| 3256 |
problem was discovered. See perlre. |
| 3257 |
.IP "Invalid range ""%s"" in transliteration operator" 4 |
| 3258 |
.IX Item "Invalid range ""%s"" in transliteration operator" |
| 3259 |
(F) The range specified in the tr/// or y/// operator had a minimum |
| 3260 |
character greater than the maximum character. See perlop. |
| 3261 |
.IP "Invalid reference to group in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3262 |
.IX Item "Invalid reference to group in regex; marked by <--\ HERE in m/%s/" |
| 3263 |
(F) The capture group you specified can't possibly exist because the |
| 3264 |
number you used is not within the legal range of possible values for |
| 3265 |
this machine. |
| 3266 |
.ie n .IP "Invalid separator character %s in attribute list" 4 |
| 3267 |
.el .IP "Invalid separator character \f(CW%s\fR in attribute list" 4 |
| 3268 |
.IX Item "Invalid separator character %s in attribute list" |
| 3269 |
(F) Something other than a colon or whitespace was seen between the |
| 3270 |
elements of an attribute list. If the previous attribute had a |
| 3271 |
parenthesised parameter list, perhaps that list was terminated too soon. |
| 3272 |
See attributes. |
| 3273 |
.ie n .IP "Invalid separator character %s in PerlIO layer specification %s" 4 |
| 3274 |
.el .IP "Invalid separator character \f(CW%s\fR in PerlIO layer specification \f(CW%s\fR" 4 |
| 3275 |
.IX Item "Invalid separator character %s in PerlIO layer specification %s" |
| 3276 |
(W layer) When pushing layers onto the Perl I/O system, something other |
| 3277 |
than a colon or whitespace was seen between the elements of a layer list. |
| 3278 |
If the previous attribute had a parenthesised parameter list, perhaps that |
| 3279 |
list was terminated too soon. |
| 3280 |
.IP "Invalid strict version format (%s)" 4 |
| 3281 |
.IX Item "Invalid strict version format (%s)" |
| 3282 |
(F) A version number did not meet the "strict" criteria for versions. |
| 3283 |
A "strict" version number is a positive decimal number (integer or |
| 3284 |
decimal-fraction) without exponentiation or else a dotted-decimal |
| 3285 |
v\-string with a leading 'v' character and at least three components. |
| 3286 |
The parenthesized text indicates which criteria were not met. |
| 3287 |
See the version module for more details on allowed version formats. |
| 3288 |
.ie n .IP "Invalid type '%s' in %s" 4 |
| 3289 |
.el .IP "Invalid type '%s' in \f(CW%s\fR" 4 |
| 3290 |
.IX Item "Invalid type '%s' in %s" |
| 3291 |
(F) The given character is not a valid pack or unpack type. |
| 3292 |
See "pack" in perlfunc. |
| 3293 |
.Sp |
| 3294 |
(W) The given character is not a valid pack or unpack type but used to be |
| 3295 |
silently ignored. |
| 3296 |
.IP "Invalid version bundle ""%s""" 4 |
| 3297 |
.IX Item "Invalid version bundle ""%s""" |
| 3298 |
(F) A version number that is used to specify an import bundle during a |
| 3299 |
\&\f(CW\*(C`use builtin ...\*(C'\fR statement must be formatted as \f(CW\*(C`:MAJOR.MINOR\*(C'\fR with an |
| 3300 |
optional third component, which is ignored. Each component must be a number |
| 3301 |
of 1 to 3 digits. No other characters are permitted. The value that was |
| 3302 |
specified does not conform to these rules. |
| 3303 |
.IP "Invalid version format (%s)" 4 |
| 3304 |
.IX Item "Invalid version format (%s)" |
| 3305 |
(F) A version number did not meet the "lax" criteria for versions. |
| 3306 |
A "lax" version number is a positive decimal number (integer or |
| 3307 |
decimal-fraction) without exponentiation or else a dotted-decimal |
| 3308 |
v\-string. If the v\-string has fewer than three components, it |
| 3309 |
must have a leading 'v' character. Otherwise, the leading 'v' is |
| 3310 |
optional. Both decimal and dotted-decimal versions may have a |
| 3311 |
trailing "alpha" component separated by an underscore character |
| 3312 |
after a fractional or dotted-decimal component. The parenthesized |
| 3313 |
text indicates which criteria were not met. See the version module |
| 3314 |
for more details on allowed version formats. |
| 3315 |
.IP "Invalid version object" 4 |
| 3316 |
.IX Item "Invalid version object" |
| 3317 |
(F) The internal structure of the version object was invalid. |
| 3318 |
Perhaps the internals were modified directly in some way or |
| 3319 |
an arbitrary reference was blessed into the "version" class. |
| 3320 |
.IP "In '(*VERB...)', the '(' and '*' must be adjacent in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3321 |
.IX Item "In '(*VERB...)', the '(' and '*' must be adjacent in regex; marked by <--\ HERE in m/%s/" |
| 3322 |
.PD 0 |
| 3323 |
.IP "Inverting a character class which contains a multi-character sequence is illegal in regex; marked by <\-\- HERE in m/%s/" 4 |
| 3324 |
.IX Item "Inverting a character class which contains a multi-character sequence is illegal in regex; marked by <-- HERE in m/%s/" |
| 3325 |
.PD |
| 3326 |
(F) You wrote something like |
| 3327 |
.Sp |
| 3328 |
.Vb 2 |
| 3329 |
\& qr/\eP{name=KATAKANA LETTER AINU P}/ |
| 3330 |
\& qr/[^\ep{name=KATAKANA LETTER AINU P}]/ |
| 3331 |
.Ve |
| 3332 |
.Sp |
| 3333 |
This name actually evaluates to a sequence of two Katakana characters, |
| 3334 |
not just a single one, and it is illegal to try to take the complement |
| 3335 |
of a sequence. (Mathematically it would mean any sequence of characters |
| 3336 |
from 0 to infinity in length that weren't these two in a row, and that |
| 3337 |
is likely not of any real use.) |
| 3338 |
.Sp |
| 3339 |
(F) The two-character sequence \f(CW"(*"\fR in this context in a regular |
| 3340 |
expression pattern should be an indivisible token, with nothing |
| 3341 |
intervening between the \f(CW"("\fR and the \f(CW"*"\fR, but you separated them. |
| 3342 |
.IP "ioctl is not implemented" 4 |
| 3343 |
.IX Item "ioctl is not implemented" |
| 3344 |
(F) Your machine apparently doesn't implement \fBioctl()\fR, which is pretty |
| 3345 |
strange for a machine that supports C. |
| 3346 |
.ie n .IP "\fBioctl()\fR on unopened %s" 4 |
| 3347 |
.el .IP "\fBioctl()\fR on unopened \f(CW%s\fR" 4 |
| 3348 |
.IX Item "ioctl() on unopened %s" |
| 3349 |
(W unopened) You tried \fBioctl()\fR on a filehandle that was never opened. |
| 3350 |
Check your control flow and number of arguments. |
| 3351 |
.IP "IO layers (like '%s') unavailable" 4 |
| 3352 |
.IX Item "IO layers (like '%s') unavailable" |
| 3353 |
(F) Your Perl has not been configured to have PerlIO, and therefore |
| 3354 |
you cannot use IO layers. To have PerlIO, Perl must be configured |
| 3355 |
with 'useperlio'. |
| 3356 |
.IP "IO::Socket::atmark not implemented on this architecture" 4 |
| 3357 |
.IX Item "IO::Socket::atmark not implemented on this architecture" |
| 3358 |
(F) Your machine doesn't implement the \fBsockatmark()\fR functionality, |
| 3359 |
neither as a system call nor an ioctl call (SIOCATMARK). |
| 3360 |
.IP "'%s' is an unknown bound type in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3361 |
.IX Item "'%s' is an unknown bound type in regex; marked by <--\ HERE in m/%s/" |
| 3362 |
(F) You used \f(CW\*(C`\eb{...}\*(C'\fR or \f(CW\*(C`\eB{...}\*(C'\fR and the \f(CW\*(C`...\*(C'\fR is not known to |
| 3363 |
Perl. The current valid ones are given in |
| 3364 |
"\eb{}, \eb, \eB{}, \eB" in perlrebackslash. |
| 3365 |
.IP "%s() isn't allowed on :utf8 handles" 4 |
| 3366 |
.IX Item "%s() isn't allowed on :utf8 handles" |
| 3367 |
(F) The \fBsysread()\fR, \fBrecv()\fR, \fBsyswrite()\fR and \fBsend()\fR operators are |
| 3368 |
not allowed on handles that have the \f(CW\*(C`:utf8\*(C'\fR layer, either explicitly, or |
| 3369 |
implicitly, eg., with the \f(CW:encoding(UTF\-16LE)\fR layer. |
| 3370 |
.Sp |
| 3371 |
Previously \fBsysread()\fR and \fBrecv()\fR currently use only the \f(CW\*(C`:utf8\*(C'\fR flag for the stream, |
| 3372 |
ignoring the actual layers. Since \fBsysread()\fR and \fBrecv()\fR did no UTF\-8 |
| 3373 |
validation they can end up creating invalidly encoded scalars. |
| 3374 |
.Sp |
| 3375 |
Similarly, \fBsyswrite()\fR and \fBsend()\fR used only the \f(CW\*(C`:utf8\*(C'\fR flag, otherwise ignoring |
| 3376 |
any layers. If the flag is set, both wrote the value UTF\-8 encoded, even if |
| 3377 |
the layer is some different encoding, such as the example above. |
| 3378 |
.Sp |
| 3379 |
Ideally, all of these operators would completely ignore the \f(CW\*(C`:utf8\*(C'\fR state, |
| 3380 |
working only with bytes, but this would result in silently breaking existing |
| 3381 |
code. |
| 3382 |
.IP """%s"" is more clearly written simply as ""%s"" in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3383 |
.IX Item """%s"" is more clearly written simply as ""%s"" in regex; marked by <--\ HERE in m/%s/" |
| 3384 |
(W regexp) (only under \f(CW\*(C`use\ re\ \*(Aqstrict\*(Aq\*(C'\fR or within \f(CW\*(C`(?[...])\*(C'\fR) |
| 3385 |
.Sp |
| 3386 |
You specified a character that has the given plainer way of writing it, and |
| 3387 |
which is also portable to platforms running with different character sets. |
| 3388 |
.IP "$* is no longer supported as of Perl 5.30" 4 |
| 3389 |
.IX Item "$* is no longer supported as of Perl 5.30" |
| 3390 |
(F) The special variable \f(CW$*\fR, deprecated in older perls, was removed in |
| 3391 |
5.10.0, is no longer supported and is a fatal error as of Perl 5.30. In |
| 3392 |
previous versions of perl the use of \f(CW$*\fR enabled or disabled multi-line |
| 3393 |
matching within a string. |
| 3394 |
.Sp |
| 3395 |
Instead of using \f(CW$*\fR you should use the \f(CW\*(C`/m\*(C'\fR (and maybe \f(CW\*(C`/s\*(C'\fR) regexp |
| 3396 |
modifiers. You can enable \f(CW\*(C`/m\*(C'\fR for a lexical scope (even a whole file) |
| 3397 |
with \f(CW\*(C`use re \*(Aq/m\*(Aq\*(C'\fR. (In older versions: when \f(CW$*\fR was set to a true value |
| 3398 |
then all regular expressions behaved as if they were written using \f(CW\*(C`/m\*(C'\fR.) |
| 3399 |
.Sp |
| 3400 |
Use of this variable will be a fatal error in Perl 5.30. |
| 3401 |
.IP "$# is no longer supported as of Perl 5.30" 4 |
| 3402 |
.IX Item "$# is no longer supported as of Perl 5.30" |
| 3403 |
(F) The special variable \f(CW$#\fR, deprecated in older perls, was removed as of |
| 3404 |
5.10.0, is no longer supported and is a fatal error as of Perl 5.30. You |
| 3405 |
should use the printf/sprintf functions instead. |
| 3406 |
.IP "'%s' is not a code reference" 4 |
| 3407 |
.IX Item "'%s' is not a code reference" |
| 3408 |
(W overload) The second (fourth, sixth, ...) argument of |
| 3409 |
overload::constant needs to be a code reference. Either |
| 3410 |
an anonymous subroutine, or a reference to a subroutine. |
| 3411 |
.IP "'%s' is not an overloadable type" 4 |
| 3412 |
.IX Item "'%s' is not an overloadable type" |
| 3413 |
(W overload) You tried to overload a constant type the overload package is |
| 3414 |
unaware of. |
| 3415 |
.IP "'%s' is not recognised as a builtin function" 4 |
| 3416 |
.IX Item "'%s' is not recognised as a builtin function" |
| 3417 |
(F) An attempt was made to \f(CW\*(C`use\*(C'\fR the builtin pragma module to create |
| 3418 |
a lexical alias for an unknown function name. |
| 3419 |
.IP "\-i used with no filenames on the command line, reading from STDIN" 4 |
| 3420 |
.IX Item "-i used with no filenames on the command line, reading from STDIN" |
| 3421 |
(S inplace) The \f(CW\*(C`\-i\*(C'\fR option was passed on the command line, indicating |
| 3422 |
that the script is intended to edit files in place, but no files were |
| 3423 |
given. This is usually a mistake, since editing STDIN in place doesn't |
| 3424 |
make sense, and can be confusing because it can make perl look like |
| 3425 |
it is hanging when it is really just trying to read from STDIN. You |
| 3426 |
should either pass a filename to edit, or remove \f(CW\*(C`\-i\*(C'\fR from the command |
| 3427 |
line. See perlrun for more details. |
| 3428 |
.IP "Junk on end of regexp in regex m/%s/" 4 |
| 3429 |
.IX Item "Junk on end of regexp in regex m/%s/" |
| 3430 |
(P) The regular expression parser is confused. |
| 3431 |
.IP "\eK not permitted in lookahead/lookbehind in regex; marked by <\-\- HERE in m/%s/" 4 |
| 3432 |
.IX Item "K not permitted in lookahead/lookbehind in regex; marked by <-- HERE in m/%s/" |
| 3433 |
(F) Your regular expression used \f(CW\*(C`\eK\*(C'\fR in a lookahead or lookbehind |
| 3434 |
assertion, which currently isn't permitted. |
| 3435 |
.Sp |
| 3436 |
This may change in the future, see Support \eK in |
| 3437 |
lookarounds <https://github.com/Perl/perl5/issues/18134>. |
| 3438 |
.ie n .IP "Label not found for ""last %s""" 4 |
| 3439 |
.el .IP "Label not found for ""last \f(CW%s\fR""" 4 |
| 3440 |
.IX Item "Label not found for ""last %s""" |
| 3441 |
(F) You named a loop to break out of, but you're not currently in a loop |
| 3442 |
of that name, not even if you count where you were called from. See |
| 3443 |
"last" in perlfunc. |
| 3444 |
.ie n .IP "Label not found for ""next %s""" 4 |
| 3445 |
.el .IP "Label not found for ""next \f(CW%s\fR""" 4 |
| 3446 |
.IX Item "Label not found for ""next %s""" |
| 3447 |
(F) You named a loop to continue, but you're not currently in a loop of |
| 3448 |
that name, not even if you count where you were called from. See |
| 3449 |
"last" in perlfunc. |
| 3450 |
.ie n .IP "Label not found for ""redo %s""" 4 |
| 3451 |
.el .IP "Label not found for ""redo \f(CW%s\fR""" 4 |
| 3452 |
.IX Item "Label not found for ""redo %s""" |
| 3453 |
(F) You named a loop to restart, but you're not currently in a loop of |
| 3454 |
that name, not even if you count where you were called from. See |
| 3455 |
"last" in perlfunc. |
| 3456 |
.ie n .IP "leaving effective %s failed" 4 |
| 3457 |
.el .IP "leaving effective \f(CW%s\fR failed" 4 |
| 3458 |
.IX Item "leaving effective %s failed" |
| 3459 |
(F) While under the \f(CW\*(C`use filetest\*(C'\fR pragma, switching the real and |
| 3460 |
effective uids or gids failed. |
| 3461 |
.IP "length/code after end of string in unpack" 4 |
| 3462 |
.IX Item "length/code after end of string in unpack" |
| 3463 |
(F) While unpacking, the string buffer was already used up when an unpack |
| 3464 |
length/code combination tried to obtain more data. This results in |
| 3465 |
an undefined value for the length. See "pack" in perlfunc. |
| 3466 |
.ie n .IP "\fBlength()\fR used on %s (did you mean ""scalar(%s)""?)" 4 |
| 3467 |
.el .IP "\fBlength()\fR used on \f(CW%s\fR (did you mean ""scalar(%s)""?)" 4 |
| 3468 |
.IX Item "length() used on %s (did you mean ""scalar(%s)""?)" |
| 3469 |
(W syntax) You used \fBlength()\fR on either an array or a hash when you |
| 3470 |
probably wanted a count of the items. |
| 3471 |
.Sp |
| 3472 |
Array size can be obtained by doing: |
| 3473 |
.Sp |
| 3474 |
.Vb 1 |
| 3475 |
\& scalar(@array); |
| 3476 |
.Ve |
| 3477 |
.Sp |
| 3478 |
The number of items in a hash can be obtained by doing: |
| 3479 |
.Sp |
| 3480 |
.Vb 1 |
| 3481 |
\& scalar(keys %hash); |
| 3482 |
.Ve |
| 3483 |
.IP "Lexing code attempted to stuff non\-Latin\-1 character into Latin\-1 input" 4 |
| 3484 |
.IX Item "Lexing code attempted to stuff non-Latin-1 character into Latin-1 input" |
| 3485 |
(F) An extension is attempting to insert text into the current parse |
| 3486 |
(using lex_stuff_pvn or similar), but tried to insert a character that |
| 3487 |
couldn't be part of the current input. This is an inherent pitfall |
| 3488 |
of the stuffing mechanism, and one of the reasons to avoid it. Where |
| 3489 |
it is necessary to stuff, stuffing only plain ASCII is recommended. |
| 3490 |
.IP "Lexing code internal error (%s)" 4 |
| 3491 |
.IX Item "Lexing code internal error (%s)" |
| 3492 |
(F) Lexing code supplied by an extension violated the lexer's API in a |
| 3493 |
detectable way. |
| 3494 |
.ie n .IP "\fBlisten()\fR on closed socket %s" 4 |
| 3495 |
.el .IP "\fBlisten()\fR on closed socket \f(CW%s\fR" 4 |
| 3496 |
.IX Item "listen() on closed socket %s" |
| 3497 |
(W closed) You tried to do a listen on a closed socket. Did you forget |
| 3498 |
to check the return value of your \fBsocket()\fR call? See |
| 3499 |
"listen" in perlfunc. |
| 3500 |
.IP "List form of piped open not implemented" 4 |
| 3501 |
.IX Item "List form of piped open not implemented" |
| 3502 |
(F) On some platforms, notably Windows, the three-or-more-arguments |
| 3503 |
form of \f(CW\*(C`open\*(C'\fR does not support pipes, such as \f(CW\*(C`open($pipe, \*(Aq|\-\*(Aq, @args)\*(C'\fR. |
| 3504 |
Use the two-argument \f(CW\*(C`open($pipe, \*(Aq|prog arg1 arg2...\*(Aq)\*(C'\fR form instead. |
| 3505 |
.IP "Literal vertical space in [] is illegal except under /x in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3506 |
.IX Item "Literal vertical space in [] is illegal except under /x in regex; marked by <--\ HERE in m/%s/" |
| 3507 |
(F) (only under \f(CW\*(C`use\ re\ \*(Aqstrict\*(Aq\*(C'\fR or within \f(CW\*(C`(?[...])\*(C'\fR) |
| 3508 |
.Sp |
| 3509 |
Likely you forgot the \f(CW\*(C`/x\*(C'\fR modifier or there was a typo in the pattern. |
| 3510 |
For example, did you really mean to match a form-feed? If so, all the |
| 3511 |
ASCII vertical space control characters are representable by escape |
| 3512 |
sequences which won't present such a jarring appearance as your pattern |
| 3513 |
does when displayed. |
| 3514 |
.Sp |
| 3515 |
.Vb 4 |
| 3516 |
\& \er carriage return |
| 3517 |
\& \ef form feed |
| 3518 |
\& \en line feed |
| 3519 |
\& \ecK vertical tab |
| 3520 |
.Ve |
| 3521 |
.ie n .IP "%s: loadable library and perl binaries are mismatched (got %s handshake key %p, needed %p)" 4 |
| 3522 |
.el .IP "\f(CW%s:\fR loadable library and perl binaries are mismatched (got \f(CW%s\fR handshake key \f(CW%p\fR, needed \f(CW%p\fR)" 4 |
| 3523 |
.IX Item "%s: loadable library and perl binaries are mismatched (got %s handshake key %p, needed %p)" |
| 3524 |
(P) A dynamic loading library \f(CW\*(C`.so\*(C'\fR or \f(CW\*(C`.dll\*(C'\fR was being loaded into the |
| 3525 |
process that was built against a different build of perl than the |
| 3526 |
said library was compiled against. Reinstalling the XS module will |
| 3527 |
likely fix this error. |
| 3528 |
.ie n .IP "Locale '%s' contains (at least) the following characters which have unexpected meanings: %s The Perl program will use the expected meanings" 4 |
| 3529 |
.el .IP "Locale '%s' contains (at least) the following characters which have unexpected meanings: \f(CW%s\fR The Perl program will use the expected meanings" 4 |
| 3530 |
.IX Item "Locale '%s' contains (at least) the following characters which have unexpected meanings: %s The Perl program will use the expected meanings" |
| 3531 |
(W locale) You are using the named UTF\-8 locale. UTF\-8 locales are |
| 3532 |
expected to have very particular behavior, which most do. This message |
| 3533 |
arises when perl found some departures from the expectations, and is |
| 3534 |
notifying you that the expected behavior overrides these differences. |
| 3535 |
In some cases the differences are caused by the locale definition being |
| 3536 |
defective, but the most common causes of this warning are when there are |
| 3537 |
ambiguities and conflicts in following the Standard, and the locale has |
| 3538 |
chosen an approach that differs from Perl's. |
| 3539 |
.Sp |
| 3540 |
One of these is because that, contrary to the claims, Unicode is not |
| 3541 |
completely locale insensitive. Turkish and some related languages |
| 3542 |
have two types of \f(CW"I"\fR characters. One is dotted in both upper\- and |
| 3543 |
lowercase, and the other is dotless in both cases. Unicode allows a |
| 3544 |
locale to use either the Turkish rules, or the rules used in all other |
| 3545 |
instances, where there is only one type of \f(CW"I"\fR, which is dotless in |
| 3546 |
the uppercase, and dotted in the lower. The perl core does not (yet) |
| 3547 |
handle the Turkish case, and this message warns you of that. Instead, |
| 3548 |
the Unicode::Casing module allows you to mostly implement the Turkish |
| 3549 |
casing rules. |
| 3550 |
.Sp |
| 3551 |
The other common cause is for the characters |
| 3552 |
.Sp |
| 3553 |
.Vb 1 |
| 3554 |
\& $ + < = > ^ \` | ~ |
| 3555 |
.Ve |
| 3556 |
.Sp |
| 3557 |
These are problematic. The C standard says that these should be |
| 3558 |
considered punctuation in the C locale (and the POSIX standard defers to |
| 3559 |
the C standard), and Unicode is generally considered a superset of |
| 3560 |
the C locale. But Unicode has added an extra category, "Symbol", and |
| 3561 |
classifies these particular characters as being symbols. Most UTF\-8 |
| 3562 |
locales have them treated as punctuation, so that \fBispunct\fR\|(3) returns |
| 3563 |
non-zero for them. But a few locales have it return 0. Perl takes |
| 3564 |
the first approach, not using \f(CWispunct()\fR at all (see Note [5] in |
| 3565 |
perlrecharclass), and this message is raised to notify you that you |
| 3566 |
are getting Perl's approach, not the locale's. |
| 3567 |
.IP "Locale '%s' is unsupported, and may crash the interpreter" 4 |
| 3568 |
.IX Item "Locale '%s' is unsupported, and may crash the interpreter" |
| 3569 |
(S locale) The named locale is not supported by Perl, and using it leads |
| 3570 |
to undefined behavior, including potentially crashing the computer. |
| 3571 |
.Sp |
| 3572 |
Currently the only locales that generate this severe warning are |
| 3573 |
non\-UTF\-8 ones which have characters that require more than one byte to |
| 3574 |
represent (common in older East Asian language locales). See |
| 3575 |
perllocale. |
| 3576 |
.IP "Locale '%s' may not work well.%s" 4 |
| 3577 |
.IX Item "Locale '%s' may not work well.%s" |
| 3578 |
(W locale) You are using the named locale, which is a non\-UTF\-8 one, and |
| 3579 |
which perl has determined is not fully compatible with what it can |
| 3580 |
handle. The second \f(CW%s\fR gives a reason. |
| 3581 |
.Sp |
| 3582 |
By far the most common reason is that the locale has characters in it |
| 3583 |
that are represented by more than one byte. The only such locales that |
| 3584 |
Perl can handle are the UTF\-8 locales. Most likely the specified locale |
| 3585 |
is a non\-UTF\-8 one for an East Asian language such as Chinese or |
| 3586 |
Japanese. If the locale is a superset of ASCII, the ASCII portion of it |
| 3587 |
may work in Perl. |
| 3588 |
.Sp |
| 3589 |
Some essentially obsolete locales that aren't supersets of ASCII, mainly |
| 3590 |
those in ISO 646 or other 7\-bit locales, such as ASMO 449, can also have |
| 3591 |
problems, depending on what portions of the ASCII character set get |
| 3592 |
changed by the locale and are also used by the program. |
| 3593 |
The warning message lists the determinable conflicting characters. |
| 3594 |
.Sp |
| 3595 |
Note that not all incompatibilities are found. |
| 3596 |
.Sp |
| 3597 |
If this happens to you, there's not much you can do except switch to use a |
| 3598 |
different locale or use Encode to translate from the locale into |
| 3599 |
UTF\-8; if that's impracticable, you have been warned that some things |
| 3600 |
may break. |
| 3601 |
.Sp |
| 3602 |
This message is output once each time a bad locale is switched into |
| 3603 |
within the scope of \f(CW\*(C`use\ locale\*(C'\fR, or on the first possibly-affected |
| 3604 |
operation if the \f(CW\*(C`use\ locale\*(C'\fR inherits a bad one. It is not raised |
| 3605 |
for any operations from the POSIX module. |
| 3606 |
.IP "localtime(%f) failed" 4 |
| 3607 |
.IX Item "localtime(%f) failed" |
| 3608 |
(W overflow) You called \f(CW\*(C`localtime\*(C'\fR with a number that it could not handle: |
| 3609 |
too large, too small, or NaN. The returned value is \f(CW\*(C`undef\*(C'\fR. |
| 3610 |
.IP "localtime(%f) too large" 4 |
| 3611 |
.IX Item "localtime(%f) too large" |
| 3612 |
(W overflow) You called \f(CW\*(C`localtime\*(C'\fR with a number that was larger |
| 3613 |
than it can reliably handle and \f(CW\*(C`localtime\*(C'\fR probably returned the |
| 3614 |
wrong date. This warning is also triggered with NaN (the special |
| 3615 |
not-a-number value). |
| 3616 |
.IP "localtime(%f) too small" 4 |
| 3617 |
.IX Item "localtime(%f) too small" |
| 3618 |
(W overflow) You called \f(CW\*(C`localtime\*(C'\fR with a number that was smaller |
| 3619 |
than it can reliably handle and \f(CW\*(C`localtime\*(C'\fR probably returned the |
| 3620 |
wrong date. |
| 3621 |
.ie n .IP "Lookbehind longer than %d not implemented in regex m/%s/" 4 |
| 3622 |
.el .IP "Lookbehind longer than \f(CW%d\fR not implemented in regex m/%s/" 4 |
| 3623 |
.IX Item "Lookbehind longer than %d not implemented in regex m/%s/" |
| 3624 |
(F) There is currently a limit on the length of string which lookbehind can |
| 3625 |
handle. This restriction may be eased in a future release. |
| 3626 |
.ie n .IP "Lost precision when %s %f by 1" 4 |
| 3627 |
.el .IP "Lost precision when \f(CW%s\fR \f(CW%f\fR by 1" 4 |
| 3628 |
.IX Item "Lost precision when %s %f by 1" |
| 3629 |
(W imprecision) You attempted to increment or decrement a value by one, |
| 3630 |
but the result is too large for the underlying floating point |
| 3631 |
representation to store accurately. Hence, the target of \f(CW\*(C`++\*(C'\fR or \f(CW\*(C`\-\-\*(C'\fR |
| 3632 |
is increased or decreased by quite different value than one, such as |
| 3633 |
zero (\fIi.e.\fR the target is unchanged) or two, due to rounding. |
| 3634 |
Perl issues this |
| 3635 |
warning because it has already switched from integers to floating point |
| 3636 |
when values are too large for integers, and now even floating point is |
| 3637 |
insufficient. You may wish to switch to using Math::BigInt explicitly. |
| 3638 |
.IP "\fBlstat()\fR on filehandle%s" 4 |
| 3639 |
.IX Item "lstat() on filehandle%s" |
| 3640 |
(W io) You tried to do an lstat on a filehandle. What did you mean |
| 3641 |
by that? \fBlstat()\fR makes sense only on filenames. (Perl did a \fBfstat()\fR |
| 3642 |
instead on the filehandle.) |
| 3643 |
.ie n .IP "lvalue attribute %s already-defined subroutine" 4 |
| 3644 |
.el .IP "lvalue attribute \f(CW%s\fR already-defined subroutine" 4 |
| 3645 |
.IX Item "lvalue attribute %s already-defined subroutine" |
| 3646 |
(W misc) Although attributes.pm allows this, turning the lvalue |
| 3647 |
attribute on or off on a Perl subroutine that is already defined |
| 3648 |
does not always work properly. It may or may not do what you |
| 3649 |
want, depending on what code is inside the subroutine, with exact |
| 3650 |
details subject to change between Perl versions. Only do this |
| 3651 |
if you really know what you are doing. |
| 3652 |
.IP "lvalue attribute ignored after the subroutine has been defined" 4 |
| 3653 |
.IX Item "lvalue attribute ignored after the subroutine has been defined" |
| 3654 |
(W misc) Using the \f(CW\*(C`:lvalue\*(C'\fR declarative syntax to make a Perl |
| 3655 |
subroutine an lvalue subroutine after it has been defined is |
| 3656 |
not permitted. To make the subroutine an lvalue subroutine, |
| 3657 |
add the lvalue attribute to the definition, or put the \f(CW\*(C`sub |
| 3658 |
foo :lvalue;\*(C'\fR declaration before the definition. |
| 3659 |
.Sp |
| 3660 |
See also attributes.pm. |
| 3661 |
.IP "Magical list constants are not supported" 4 |
| 3662 |
.IX Item "Magical list constants are not supported" |
| 3663 |
(F) You assigned a magical array to a stash element, and then tried |
| 3664 |
to use the subroutine from the same slot. You are asking Perl to do |
| 3665 |
something it cannot do, details subject to change between Perl versions. |
| 3666 |
.IP "Malformed integer in [] in pack" 4 |
| 3667 |
.IX Item "Malformed integer in [] in pack" |
| 3668 |
(F) Between the brackets enclosing a numeric repeat count only digits |
| 3669 |
are permitted. See "pack" in perlfunc. |
| 3670 |
.IP "Malformed integer in [] in unpack" 4 |
| 3671 |
.IX Item "Malformed integer in [] in unpack" |
| 3672 |
(F) Between the brackets enclosing a numeric repeat count only digits |
| 3673 |
are permitted. See "pack" in perlfunc. |
| 3674 |
.IP "Malformed PERLLIB_PREFIX" 4 |
| 3675 |
.IX Item "Malformed PERLLIB_PREFIX" |
| 3676 |
(F) An error peculiar to OS/2. PERLLIB_PREFIX should be of the form |
| 3677 |
.Sp |
| 3678 |
.Vb 1 |
| 3679 |
\& prefix1;prefix2 |
| 3680 |
.Ve |
| 3681 |
.Sp |
| 3682 |
or |
| 3683 |
prefix1 prefix2 |
| 3684 |
.Sp |
| 3685 |
with nonempty prefix1 and prefix2. If \f(CW\*(C`prefix1\*(C'\fR is indeed a prefix of |
| 3686 |
a builtin library search path, prefix2 is substituted. The error may |
| 3687 |
appear if components are not found, or are too long. See |
| 3688 |
"PERLLIB_PREFIX" in perlos2. |
| 3689 |
.ie n .IP "Malformed prototype for %s: %s" 4 |
| 3690 |
.el .IP "Malformed prototype for \f(CW%s:\fR \f(CW%s\fR" 4 |
| 3691 |
.IX Item "Malformed prototype for %s: %s" |
| 3692 |
(F) You tried to use a function with a malformed prototype. The |
| 3693 |
syntax of function prototypes is given a brief compile-time check for |
| 3694 |
obvious errors like invalid characters. A more rigorous check is run |
| 3695 |
when the function is called. |
| 3696 |
Perhaps the function's author was trying to write a subroutine signature |
| 3697 |
but didn't enable that feature first (\f(CW\*(C`use feature \*(Aqsignatures\*(Aq\*(C'\fR), |
| 3698 |
so the signature was instead interpreted as a bad prototype. |
| 3699 |
.IP "Malformed UTF\-8 character%s" 4 |
| 3700 |
.IX Item "Malformed UTF-8 character%s" |
| 3701 |
(S utf8)(F) Perl detected a string that should be UTF\-8, but didn't |
| 3702 |
comply with UTF\-8 encoding rules, or represents a code point whose |
| 3703 |
ordinal integer value doesn't fit into the word size of the current |
| 3704 |
platform (overflows). Details as to the exact malformation are given in |
| 3705 |
the variable, \f(CW%s\fR, part of the message. |
| 3706 |
.Sp |
| 3707 |
One possible cause is that you set the UTF8 flag yourself for data that |
| 3708 |
you thought to be in UTF\-8 but it wasn't (it was for example legacy 8\-bit |
| 3709 |
data). To guard against this, you can use \f(CW\*(C`Encode::decode(\*(AqUTF\-8\*(Aq, ...)\*(C'\fR. |
| 3710 |
.Sp |
| 3711 |
If you use the \f(CW:encoding(UTF\-8)\fR PerlIO layer for input, invalid byte |
| 3712 |
sequences are handled gracefully, but if you use \f(CW\*(C`:utf8\*(C'\fR, the flag is set |
| 3713 |
without validating the data, possibly resulting in this error message. |
| 3714 |
.Sp |
| 3715 |
See also "Handling Malformed Data" in Encode. |
| 3716 |
.IP "Malformed UTF\-8 returned by \eN{%s} immediately after '%s'" 4 |
| 3717 |
.IX Item "Malformed UTF-8 returned by N{%s} immediately after '%s'" |
| 3718 |
(F) The charnames handler returned malformed UTF\-8. |
| 3719 |
.IP "Malformed UTF\-8 string in ""%s""" 4 |
| 3720 |
.IX Item "Malformed UTF-8 string in ""%s""" |
| 3721 |
(F) This message indicates a bug either in the Perl core or in XS |
| 3722 |
code. Such code was trying to find out if a character, allegedly |
| 3723 |
stored internally encoded as UTF\-8, was of a given type, such as |
| 3724 |
being punctuation or a digit. But the character was not encoded |
| 3725 |
in legal UTF\-8. The \f(CW%s\fR is replaced by a string that can be used |
| 3726 |
by knowledgeable people to determine what the type being checked |
| 3727 |
against was. |
| 3728 |
.Sp |
| 3729 |
Passing malformed strings was deprecated in Perl 5.18, and |
| 3730 |
became fatal in Perl 5.26. |
| 3731 |
.IP "Malformed UTF\-8 string in '%c' format in unpack" 4 |
| 3732 |
.IX Item "Malformed UTF-8 string in '%c' format in unpack" |
| 3733 |
(F) You tried to unpack something that didn't comply with UTF\-8 encoding |
| 3734 |
rules and perl was unable to guess how to make more progress. |
| 3735 |
.IP "Malformed UTF\-8 string in pack" 4 |
| 3736 |
.IX Item "Malformed UTF-8 string in pack" |
| 3737 |
(F) You tried to pack something that didn't comply with UTF\-8 encoding |
| 3738 |
rules and perl was unable to guess how to make more progress. |
| 3739 |
.IP "Malformed UTF\-8 string in unpack" 4 |
| 3740 |
.IX Item "Malformed UTF-8 string in unpack" |
| 3741 |
(F) You tried to unpack something that didn't comply with UTF\-8 encoding |
| 3742 |
rules and perl was unable to guess how to make more progress. |
| 3743 |
.IP "Malformed UTF\-16 surrogate" 4 |
| 3744 |
.IX Item "Malformed UTF-16 surrogate" |
| 3745 |
(F) Perl thought it was reading UTF\-16 encoded character data but while |
| 3746 |
doing it Perl met a malformed Unicode surrogate. |
| 3747 |
.IP "Mandatory parameter follows optional parameter" 4 |
| 3748 |
.IX Item "Mandatory parameter follows optional parameter" |
| 3749 |
(F) In a subroutine signature, you wrote something like "$x = undef, |
| 3750 |
\&\f(CW$y\fR", making an earlier parameter optional and a later one mandatory. |
| 3751 |
Parameters are filled from left to right, so it's impossible for the |
| 3752 |
caller to omit an earlier one and pass a later one. If you want to act |
| 3753 |
as if the parameters are filled from right to left, declare the rightmost |
| 3754 |
optional and then shuffle the parameters around in the subroutine's body. |
| 3755 |
.IP "Matched non-Unicode code point 0x%X against Unicode property; may not be portable" 4 |
| 3756 |
.IX Item "Matched non-Unicode code point 0x%X against Unicode property; may not be portable" |
| 3757 |
(S non_unicode) Perl allows strings to contain a superset of |
| 3758 |
Unicode code points; each code point may be as large as what is storable |
| 3759 |
in a signed integer on your system, but these may not be accepted by |
| 3760 |
other languages/systems. This message occurs when you matched a string |
| 3761 |
containing such a code point against a regular expression pattern, and |
| 3762 |
the code point was matched against a Unicode property, \f(CW\*(C`\ep{...}\*(C'\fR or |
| 3763 |
\&\f(CW\*(C`\eP{...}\*(C'\fR. Unicode properties are only defined on Unicode code points, |
| 3764 |
so the result of this match is undefined by Unicode, but Perl (starting |
| 3765 |
in v5.20) treats non-Unicode code points as if they were typical |
| 3766 |
unassigned Unicode ones, and matched this one accordingly. Whether a |
| 3767 |
given property matches these code points or not is specified in |
| 3768 |
"Properties accessible through \ep{} and \eP{}" in perluniprops. |
| 3769 |
.Sp |
| 3770 |
This message is suppressed (unless it has been made fatal) if it is |
| 3771 |
immaterial to the results of the match if the code point is Unicode or |
| 3772 |
not. For example, the property \f(CW\*(C`\ep{ASCII_Hex_Digit}\*(C'\fR only can match |
| 3773 |
the 22 characters \f(CW\*(C`[0\-9A\-Fa\-f]\*(C'\fR, so obviously all other code points, |
| 3774 |
Unicode or not, won't match it. (And \f(CW\*(C`\eP{ASCII_Hex_Digit}\*(C'\fR will match |
| 3775 |
every code point except these 22.) |
| 3776 |
.Sp |
| 3777 |
Getting this message indicates that the outcome of the match arguably |
| 3778 |
should have been the opposite of what actually happened. If you think |
| 3779 |
that is the case, you may wish to make the \f(CW\*(C`non_unicode\*(C'\fR warnings |
| 3780 |
category fatal; if you agree with Perl's decision, you may wish to turn |
| 3781 |
off this category. |
| 3782 |
.Sp |
| 3783 |
See "Beyond Unicode code points" in perlunicode for more information. |
| 3784 |
.ie n .IP "%s matches null string many times in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3785 |
.el .IP "\f(CW%s\fR matches null string many times in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3786 |
.IX Item "%s matches null string many times in regex; marked by <--\ HERE in m/%s/" |
| 3787 |
(W regexp) The pattern you've specified would be an infinite loop if the |
| 3788 |
regular expression engine didn't specifically check for that. The <\-\-\ HERE |
| 3789 |
shows whereabouts in the regular expression the problem was discovered. |
| 3790 |
See perlre. |
| 3791 |
.IP "Maximal count of pending signals (%u) exceeded" 4 |
| 3792 |
.IX Item "Maximal count of pending signals (%u) exceeded" |
| 3793 |
(F) Perl aborted due to too high a number of signals pending. This |
| 3794 |
usually indicates that your operating system tried to deliver signals |
| 3795 |
too fast (with a very high priority), starving the perl process from |
| 3796 |
resources it would need to reach a point where it can process signals |
| 3797 |
safely. (See "Deferred Signals (Safe Signals)" in perlipc.) |
| 3798 |
.IP """%s"" may clash with future reserved word" 4 |
| 3799 |
.IX Item """%s"" may clash with future reserved word" |
| 3800 |
(W) This warning may be due to running a perl5 script through a perl4 |
| 3801 |
interpreter, especially if the word that is being warned about is |
| 3802 |
"use" or "my". |
| 3803 |
.IP "'%' may not be used in pack" 4 |
| 3804 |
.IX Item "'%' may not be used in pack" |
| 3805 |
(F) You can't pack a string by supplying a checksum, because the |
| 3806 |
checksumming process loses information, and you can't go the other way. |
| 3807 |
See "unpack" in perlfunc. |
| 3808 |
.ie n .IP "Method for operation %s not found in package %s during blessing" 4 |
| 3809 |
.el .IP "Method for operation \f(CW%s\fR not found in package \f(CW%s\fR during blessing" 4 |
| 3810 |
.IX Item "Method for operation %s not found in package %s during blessing" |
| 3811 |
(F) An attempt was made to specify an entry in an overloading table that |
| 3812 |
doesn't resolve to a valid subroutine. See overload. |
| 3813 |
.IP "method is experimental" 4 |
| 3814 |
.IX Item "method is experimental" |
| 3815 |
(S experimental::class) This warning is emitted if you use the \f(CW\*(C`method\*(C'\fR |
| 3816 |
keyword of \f(CW\*(C`use feature \*(Aqclass\*(Aq\*(C'\fR. This keyword is currently |
| 3817 |
experimental and its behaviour may change in future releases of Perl. |
| 3818 |
.ie n .IP "Method %s not permitted" 4 |
| 3819 |
.el .IP "Method \f(CW%s\fR not permitted" 4 |
| 3820 |
.IX Item "Method %s not permitted" |
| 3821 |
See "500 Server error". |
| 3822 |
.ie n .IP "Method %s redefined" 4 |
| 3823 |
.el .IP "Method \f(CW%s\fR redefined" 4 |
| 3824 |
.IX Item "Method %s redefined" |
| 3825 |
(W redefine) You redefined a method. To suppress this warning, say |
| 3826 |
.Sp |
| 3827 |
.Vb 4 |
| 3828 |
\& { |
| 3829 |
\& no warnings \*(Aqredefine\*(Aq; |
| 3830 |
\& *name = method { ... }; |
| 3831 |
\& } |
| 3832 |
.Ve |
| 3833 |
.ie n .IP "Might be a runaway multi-line %s string starting on line %d" 4 |
| 3834 |
.el .IP "Might be a runaway multi-line \f(CW%s\fR string starting on line \f(CW%d\fR" 4 |
| 3835 |
.IX Item "Might be a runaway multi-line %s string starting on line %d" |
| 3836 |
(S) An advisory indicating that the previous error may have been caused |
| 3837 |
by a missing delimiter on a string or pattern, because it eventually |
| 3838 |
ended earlier on the current line. |
| 3839 |
.IP "Mismatched brackets in template" 4 |
| 3840 |
.IX Item "Mismatched brackets in template" |
| 3841 |
(F) A pack template could not be parsed because pairs of \f(CW\*(C`[...]\*(C'\fR or |
| 3842 |
\&\f(CW\*(C`(...)\*(C'\fR could not be matched up. See "pack" in perlfunc. |
| 3843 |
.IP "Misplaced _ in number" 4 |
| 3844 |
.IX Item "Misplaced _ in number" |
| 3845 |
(W syntax) An underscore (underbar) in a numeric constant did not |
| 3846 |
separate two digits. |
| 3847 |
.ie n .IP "Missing argument for %n in %s" 4 |
| 3848 |
.el .IP "Missing argument for \f(CW%n\fR in \f(CW%s\fR" 4 |
| 3849 |
.IX Item "Missing argument for %n in %s" |
| 3850 |
(F) A \f(CW%n\fR was used in a format string with no corresponding argument for |
| 3851 |
perl to write the current string length to. |
| 3852 |
.ie n .IP "Missing argument in %s" 4 |
| 3853 |
.el .IP "Missing argument in \f(CW%s\fR" 4 |
| 3854 |
.IX Item "Missing argument in %s" |
| 3855 |
(W missing) You called a function with fewer arguments than other |
| 3856 |
arguments you supplied indicated would be needed. |
| 3857 |
.Sp |
| 3858 |
Currently only emitted when a printf-type format required more |
| 3859 |
arguments than were supplied, but might be used in the future for |
| 3860 |
other cases where we can statically determine that arguments to |
| 3861 |
functions are missing, e.g. for the "pack" in perlfunc function. |
| 3862 |
.IP "Missing argument to \-%c" 4 |
| 3863 |
.IX Item "Missing argument to -%c" |
| 3864 |
(F) The argument to the indicated command line switch must follow |
| 3865 |
immediately after the switch, without intervening spaces. |
| 3866 |
.IP "Missing braces on \eN{}" 4 |
| 3867 |
.IX Item "Missing braces on N{}" |
| 3868 |
.PD 0 |
| 3869 |
.IP "Missing braces on \eN{} in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3870 |
.IX Item "Missing braces on N{} in regex; marked by <--\ HERE in m/%s/" |
| 3871 |
.PD |
| 3872 |
(F) Wrong syntax of character name literal \f(CW\*(C`\eN{charname}\*(C'\fR within |
| 3873 |
double-quotish context. This can also happen when there is a space |
| 3874 |
(or comment) between the \f(CW\*(C`\eN\*(C'\fR and the \f(CW\*(C`{\*(C'\fR in a regex with the \f(CW\*(C`/x\*(C'\fR modifier. |
| 3875 |
This modifier does not change the requirement that the brace immediately |
| 3876 |
follow the \f(CW\*(C`\eN\*(C'\fR. |
| 3877 |
.IP "Missing braces on \eo{}" 4 |
| 3878 |
.IX Item "Missing braces on o{}" |
| 3879 |
(F) A \f(CW\*(C`\eo\*(C'\fR must be followed immediately by a \f(CW\*(C`{\*(C'\fR in double-quotish context. |
| 3880 |
.ie n .IP "Missing comma after first argument to %s function" 4 |
| 3881 |
.el .IP "Missing comma after first argument to \f(CW%s\fR function" 4 |
| 3882 |
.IX Item "Missing comma after first argument to %s function" |
| 3883 |
(F) While certain functions allow you to specify a filehandle or an |
| 3884 |
"indirect object" before the argument list, this ain't one of them. |
| 3885 |
.IP "Missing comma after first argument to return" 4 |
| 3886 |
.IX Item "Missing comma after first argument to return" |
| 3887 |
(F) While certain operators allow you to specify a filehandle or an |
| 3888 |
"indirect object" before the argument list, \f(CW\*(C`return\*(C'\fR isn't one of |
| 3889 |
them. |
| 3890 |
.IP "Missing command in piped open" 4 |
| 3891 |
.IX Item "Missing command in piped open" |
| 3892 |
(W pipe) You used the \f(CW\*(C`open(FH, "| command")\*(C'\fR or |
| 3893 |
\&\f(CW\*(C`open(FH, "command |")\*(C'\fR construction, but the command was missing or |
| 3894 |
blank. |
| 3895 |
.IP "Missing control char name in \ec" 4 |
| 3896 |
.IX Item "Missing control char name in c" |
| 3897 |
(F) A double-quoted string ended with "\ec", without the required control |
| 3898 |
character name. |
| 3899 |
.ie n .IP "Missing ']' in prototype for %s : %s" 4 |
| 3900 |
.el .IP "Missing ']' in prototype for \f(CW%s\fR : \f(CW%s\fR" 4 |
| 3901 |
.IX Item "Missing ']' in prototype for %s : %s" |
| 3902 |
(W illegalproto) A grouping was started with \f(CW\*(C`[\*(C'\fR but never closed with \f(CW\*(C`]\*(C'\fR. |
| 3903 |
.IP "Missing name in ""%s sub""" 4 |
| 3904 |
.IX Item "Missing name in ""%s sub""" |
| 3905 |
(F) The syntax for lexically scoped subroutines requires that |
| 3906 |
they have a name with which they can be found. |
| 3907 |
.IP "Missing $ on loop variable" 4 |
| 3908 |
.IX Item "Missing $ on loop variable" |
| 3909 |
(F) Apparently you've been programming in \fBcsh\fR too much. Variables |
| 3910 |
are always mentioned with the $ in Perl, unlike in the shells, where it |
| 3911 |
can vary from one line to the next. |
| 3912 |
.ie n .IP "(Missing operator before %s?)" 4 |
| 3913 |
.el .IP "(Missing operator before \f(CW%s\fR?)" 4 |
| 3914 |
.IX Item "(Missing operator before %s?)" |
| 3915 |
(S syntax) This is an educated guess made in conjunction with the message |
| 3916 |
"%s found where operator expected". Often the missing operator is a comma. |
| 3917 |
.ie n .IP "Missing or undefined argument to %s" 4 |
| 3918 |
.el .IP "Missing or undefined argument to \f(CW%s\fR" 4 |
| 3919 |
.IX Item "Missing or undefined argument to %s" |
| 3920 |
(F) You tried to call \f(CW\*(C`require\*(C'\fR or \f(CW\*(C`do\*(C'\fR with no argument or with an |
| 3921 |
undefined value as an argument. Require expects either a package name or |
| 3922 |
a file-specification as an argument; do expects a filename. See |
| 3923 |
"require EXPR" in perlfunc and "do EXPR" in perlfunc. |
| 3924 |
.ie n .IP "Missing or undefined argument to %s via %{^HOOK}{require_\|_before}" 4 |
| 3925 |
.el .IP "Missing or undefined argument to \f(CW%s\fR via %{^HOOK}{require_\|_before}" 4 |
| 3926 |
.IX Item "Missing or undefined argument to %s via %{^HOOK}{require__before}" |
| 3927 |
(F) A \f(CW\*(C`%{^HOOK}{require_\|_before}\*(C'\fR hook rewrote the name of the file being |
| 3928 |
compiled with \f(CW\*(C`require\*(C'\fR or \f(CW\*(C`do\*(C'\fR with an empty string an undefined value |
| 3929 |
which is forbidden. See "%{^HOOK}" in perlvar and "require EXPR" in perlfunc. |
| 3930 |
.IP "Missing right brace on \e%c{} in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 3931 |
.IX Item "Missing right brace on %c{} in regex; marked by <--\ HERE in m/%s/" |
| 3932 |
(F) Missing right brace in \f(CW\*(C`\ex{...}\*(C'\fR, \f(CW\*(C`\ep{...}\*(C'\fR, \f(CW\*(C`\eP{...}\*(C'\fR, or \f(CW\*(C`\eN{...}\*(C'\fR. |
| 3933 |
.IP "Missing right brace on \eN{}" 4 |
| 3934 |
.IX Item "Missing right brace on N{}" |
| 3935 |
.PD 0 |
| 3936 |
.IP "Missing right brace on \eN{} or unescaped left brace after \eN" 4 |
| 3937 |
.IX Item "Missing right brace on N{} or unescaped left brace after N" |
| 3938 |
.PD |
| 3939 |
(F) \f(CW\*(C`\eN\*(C'\fR has two meanings. |
| 3940 |
.Sp |
| 3941 |
The traditional one has it followed by a name enclosed in braces, |
| 3942 |
meaning the character (or sequence of characters) given by that |
| 3943 |
name. Thus \f(CW\*(C`\eN{ASTERISK}\*(C'\fR is another way of writing \f(CW\*(C`*\*(C'\fR, valid in both |
| 3944 |
double-quoted strings and regular expression patterns. In patterns, |
| 3945 |
it doesn't have the meaning an unescaped \f(CW\*(C`*\*(C'\fR does. |
| 3946 |
.Sp |
| 3947 |
Starting in Perl 5.12.0, \f(CW\*(C`\eN\*(C'\fR also can have an additional meaning (only) |
| 3948 |
in patterns, namely to match a non-newline character. (This is short |
| 3949 |
for \f(CW\*(C`[^\en]\*(C'\fR, and like \f(CW\*(C`.\*(C'\fR but is not affected by the \f(CW\*(C`/s\*(C'\fR regex modifier.) |
| 3950 |
.Sp |
| 3951 |
This can lead to some ambiguities. When \f(CW\*(C`\eN\*(C'\fR is not followed immediately |
| 3952 |
by a left brace, Perl assumes the \f(CW\*(C`[^\en]\*(C'\fR meaning. Also, if the braces |
| 3953 |
form a valid quantifier such as \f(CW\*(C`\eN{3}\*(C'\fR or \f(CW\*(C`\eN{5,}\*(C'\fR, Perl assumes that this |
| 3954 |
means to match the given quantity of non-newlines (in these examples, |
| 3955 |
3; and 5 or more, respectively). In all other case, where there is a |
| 3956 |
\&\f(CW\*(C`\eN{\*(C'\fR and a matching \f(CW\*(C`}\*(C'\fR, Perl assumes that a character name is desired. |
| 3957 |
.Sp |
| 3958 |
However, if there is no matching \f(CW\*(C`}\*(C'\fR, Perl doesn't know if it was |
| 3959 |
mistakenly omitted, or if \f(CW\*(C`[^\en]{\*(C'\fR was desired, and raises this error. |
| 3960 |
If you meant the former, add the right brace; if you meant the latter, |
| 3961 |
escape the brace with a backslash, like so: \f(CW\*(C`\eN\e{\*(C'\fR |
| 3962 |
.IP "Missing right curly or square bracket" 4 |
| 3963 |
.IX Item "Missing right curly or square bracket" |
| 3964 |
(F) The lexer counted more opening curly or square brackets than closing |
| 3965 |
ones. As a general rule, you'll find it's missing near the place you |
| 3966 |
were last editing. |
| 3967 |
.IP "(Missing semicolon on previous line?)" 4 |
| 3968 |
.IX Item "(Missing semicolon on previous line?)" |
| 3969 |
(S syntax) This is an educated guess made in conjunction with the message |
| 3970 |
"%s found where operator expected". Don't automatically put a semicolon on |
| 3971 |
the previous line just because you saw this message. |
| 3972 |
.IP "Modification of a read-only value attempted" 4 |
| 3973 |
.IX Item "Modification of a read-only value attempted" |
| 3974 |
(F) You tried, directly or indirectly, to change the value of a |
| 3975 |
constant. You didn't, of course, try "2 = 1", because the compiler |
| 3976 |
catches that. But an easy way to do the same thing is: |
| 3977 |
.Sp |
| 3978 |
.Vb 2 |
| 3979 |
\& sub mod { $_[0] = 1 } |
| 3980 |
\& mod(2); |
| 3981 |
.Ve |
| 3982 |
.Sp |
| 3983 |
Another way is to assign to a \fBsubstr()\fR that's off the end of the string. |
| 3984 |
.Sp |
| 3985 |
Yet another way is to assign to a \f(CW\*(C`foreach\*(C'\fR loop \fIVAR\fR when \fIVAR\fR |
| 3986 |
is aliased to a constant in the look \fILIST\fR: |
| 3987 |
.Sp |
| 3988 |
.Vb 4 |
| 3989 |
\& $x = 1; |
| 3990 |
\& foreach my $n ($x, 2) { |
| 3991 |
\& $n *= 2; # modifies the $x, but fails on attempt to |
| 3992 |
\& } # modify the 2 |
| 3993 |
.Ve |
| 3994 |
.Sp |
| 3995 |
PerlIO::scalar will also produce this message as a warning if you |
| 3996 |
attempt to open a read-only scalar for writing. |
| 3997 |
.ie n .IP "Modification of non-creatable array value attempted, %s" 4 |
| 3998 |
.el .IP "Modification of non-creatable array value attempted, \f(CW%s\fR" 4 |
| 3999 |
.IX Item "Modification of non-creatable array value attempted, %s" |
| 4000 |
(F) You tried to make an array value spring into existence, and the |
| 4001 |
subscript was probably negative, even counting from end of the array |
| 4002 |
backwards. |
| 4003 |
.ie n .IP "Modification of non-creatable hash value attempted, %s" 4 |
| 4004 |
.el .IP "Modification of non-creatable hash value attempted, \f(CW%s\fR" 4 |
| 4005 |
.IX Item "Modification of non-creatable hash value attempted, %s" |
| 4006 |
(P) You tried to make a hash value spring into existence, and it |
| 4007 |
couldn't be created for some peculiar reason. |
| 4008 |
.IP "Module name must be constant" 4 |
| 4009 |
.IX Item "Module name must be constant" |
| 4010 |
(F) Only a bare module name is allowed as the first argument to a "use". |
| 4011 |
.IP "Module name required with \-%c option" 4 |
| 4012 |
.IX Item "Module name required with -%c option" |
| 4013 |
(F) The \f(CW\*(C`\-M\*(C'\fR or \f(CW\*(C`\-m\*(C'\fR options say that Perl should load some module, but |
| 4014 |
you omitted the name of the module. Consult |
| 4015 |
perlrun for full details about \f(CW\*(C`\-M\*(C'\fR and \f(CW\*(C`\-m\*(C'\fR. |
| 4016 |
.IP "More than one argument to '%s' open" 4 |
| 4017 |
.IX Item "More than one argument to '%s' open" |
| 4018 |
(F) The \f(CW\*(C`open\*(C'\fR function has been asked to open multiple files. This |
| 4019 |
can happen if you are trying to open a pipe to a command that takes a |
| 4020 |
list of arguments, but have forgotten to specify a piped open mode. |
| 4021 |
See "open" in perlfunc for details. |
| 4022 |
.ie n .IP "mprotect for COW string %p %u failed with %d" 4 |
| 4023 |
.el .IP "mprotect for COW string \f(CW%p\fR \f(CW%u\fR failed with \f(CW%d\fR" 4 |
| 4024 |
.IX Item "mprotect for COW string %p %u failed with %d" |
| 4025 |
(S) You compiled perl with \fB\-D\fRPERL_DEBUG_READONLY_COW (see |
| 4026 |
"Copy on Write" in perlguts), but a shared string buffer |
| 4027 |
could not be made read-only. |
| 4028 |
.ie n .IP "mprotect for %p %u failed with %d" 4 |
| 4029 |
.el .IP "mprotect for \f(CW%p\fR \f(CW%u\fR failed with \f(CW%d\fR" 4 |
| 4030 |
.IX Item "mprotect for %p %u failed with %d" |
| 4031 |
(S) You compiled perl with \fB\-D\fRPERL_DEBUG_READONLY_OPS (see perlhacktips), |
| 4032 |
but an op tree could not be made read-only. |
| 4033 |
.ie n .IP "mprotect RW for COW string %p %u failed with %d" 4 |
| 4034 |
.el .IP "mprotect RW for COW string \f(CW%p\fR \f(CW%u\fR failed with \f(CW%d\fR" 4 |
| 4035 |
.IX Item "mprotect RW for COW string %p %u failed with %d" |
| 4036 |
(S) You compiled perl with \fB\-D\fRPERL_DEBUG_READONLY_COW (see |
| 4037 |
"Copy on Write" in perlguts), but a read-only shared string |
| 4038 |
buffer could not be made mutable. |
| 4039 |
.ie n .IP "mprotect RW for %p %u failed with %d" 4 |
| 4040 |
.el .IP "mprotect RW for \f(CW%p\fR \f(CW%u\fR failed with \f(CW%d\fR" 4 |
| 4041 |
.IX Item "mprotect RW for %p %u failed with %d" |
| 4042 |
(S) You compiled perl with \fB\-D\fRPERL_DEBUG_READONLY_OPS (see |
| 4043 |
perlhacktips), but a read-only op tree could not be made |
| 4044 |
mutable before freeing the ops. |
| 4045 |
.IP "msg%s not implemented" 4 |
| 4046 |
.IX Item "msg%s not implemented" |
| 4047 |
(F) You don't have System V message IPC on your system. |
| 4048 |
.IP "Multidimensional hash lookup is disabled" 4 |
| 4049 |
.IX Item "Multidimensional hash lookup is disabled" |
| 4050 |
(F) You supplied a list of subscripts to a hash lookup under |
| 4051 |
\&\f(CW\*(C`no feature "multidimensional";\*(C'\fR, eg: |
| 4052 |
.Sp |
| 4053 |
.Vb 1 |
| 4054 |
\& $z = $foo{$x, $y}; |
| 4055 |
.Ve |
| 4056 |
.Sp |
| 4057 |
which by default acts like: |
| 4058 |
.Sp |
| 4059 |
.Vb 1 |
| 4060 |
\& $z = $foo{join($;, $x, $y)}; |
| 4061 |
.Ve |
| 4062 |
.ie n .IP "Multidimensional syntax %s not supported" 4 |
| 4063 |
.el .IP "Multidimensional syntax \f(CW%s\fR not supported" 4 |
| 4064 |
.IX Item "Multidimensional syntax %s not supported" |
| 4065 |
(W syntax) Multidimensional arrays aren't written like \f(CW$foo[1,2,3]\fR. |
| 4066 |
They're written like \f(CW\*(C`$foo[1][2][3]\*(C'\fR, as in C. |
| 4067 |
.IP "Multiple slurpy parameters not allowed" 4 |
| 4068 |
.IX Item "Multiple slurpy parameters not allowed" |
| 4069 |
(F) In subroutine signatures, a slurpy parameter (\f(CW\*(C`@\*(C'\fR or \f(CW\*(C`%\*(C'\fR) must be |
| 4070 |
the last parameter, and there must not be more than one of them; for |
| 4071 |
example: |
| 4072 |
.Sp |
| 4073 |
.Vb 2 |
| 4074 |
\& sub foo ($x, @y) {} # legal |
| 4075 |
\& sub foo ($x, @y, %) {} # invalid |
| 4076 |
.Ve |
| 4077 |
.IP "'/' must follow a numeric type in unpack" 4 |
| 4078 |
.IX Item "'/' must follow a numeric type in unpack" |
| 4079 |
(F) You had an unpack template that contained a '/', but this did not |
| 4080 |
follow some unpack specification producing a numeric value. |
| 4081 |
See "pack" in perlfunc. |
| 4082 |
.ie n .IP "%s must not be a named sequence in transliteration operator" 4 |
| 4083 |
.el .IP "\f(CW%s\fR must not be a named sequence in transliteration operator" 4 |
| 4084 |
.IX Item "%s must not be a named sequence in transliteration operator" |
| 4085 |
(F) Transliteration (\f(CW\*(C`tr///\*(C'\fR and \f(CW\*(C`y///\*(C'\fR) transliterates individual |
| 4086 |
characters. But a named sequence by definition is more than an |
| 4087 |
individual character, and hence doing this operation on it doesn't make |
| 4088 |
sense. |
| 4089 |
.IP """my sub"" not yet implemented" 4 |
| 4090 |
.IX Item """my sub"" not yet implemented" |
| 4091 |
(F) Lexically scoped subroutines are not yet implemented. Don't try |
| 4092 |
that yet. |
| 4093 |
.ie n .IP """my"" subroutine %s can't be in a package" 4 |
| 4094 |
.el .IP """my"" subroutine \f(CW%s\fR can't be in a package" 4 |
| 4095 |
.IX Item """my"" subroutine %s can't be in a package" |
| 4096 |
(F) Lexically scoped subroutines aren't in a package, so it doesn't make |
| 4097 |
sense to try to declare one with a package qualifier on the front. |
| 4098 |
.ie n .IP """my %s"" used in sort comparison" 4 |
| 4099 |
.el .IP """my \f(CW%s\fR"" used in sort comparison" 4 |
| 4100 |
.IX Item """my %s"" used in sort comparison" |
| 4101 |
(W syntax) The package variables \f(CW$a\fR and \f(CW$b\fR are used for sort comparisons. |
| 4102 |
You used \f(CW$a\fR or \f(CW$b\fR in as an operand to the \f(CW\*(C`<=>\*(C'\fR or \f(CW\*(C`cmp\*(C'\fR operator inside a |
| 4103 |
sort comparison block, and the variable had earlier been declared as a |
| 4104 |
lexical variable. Either qualify the sort variable with the package |
| 4105 |
name, or rename the lexical variable. |
| 4106 |
.ie n .IP """my"" variable %s can't be in a package" 4 |
| 4107 |
.el .IP """my"" variable \f(CW%s\fR can't be in a package" 4 |
| 4108 |
.IX Item """my"" variable %s can't be in a package" |
| 4109 |
(F) Lexically scoped variables aren't in a package, so it doesn't make |
| 4110 |
sense to try to declare one with a package qualifier on the front. Use |
| 4111 |
\&\fBlocal()\fR if you want to localize a package variable. |
| 4112 |
.IP "Name ""%s::%s"" used only once: possible typo" 4 |
| 4113 |
.IX Item "Name ""%s::%s"" used only once: possible typo" |
| 4114 |
(W once) Typographical errors often show up as unique variable |
| 4115 |
names. If you had a good reason for having a unique name, then |
| 4116 |
just mention it again somehow to suppress the message. The \f(CW\*(C`our\*(C'\fR |
| 4117 |
declaration is also provided for this purpose. |
| 4118 |
.Sp |
| 4119 |
NOTE: This warning detects package symbols that have been used |
| 4120 |
only once. This means lexical variables will never trigger this |
| 4121 |
warning. It also means that all of the package variables \f(CW$c\fR, \f(CW@c\fR, |
| 4122 |
\&\f(CW%c\fR, as well as *c, &c, sub c{}, c(), and c (the filehandle or |
| 4123 |
format) are considered the same; if a program uses \f(CW$c\fR only once |
| 4124 |
but also uses any of the others it will not trigger this warning. |
| 4125 |
Symbols beginning with an underscore and symbols using special |
| 4126 |
identifiers (q.v. perldata) are exempt from this warning. |
| 4127 |
.IP "Need exactly 3 octal digits in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 4128 |
.IX Item "Need exactly 3 octal digits in regex; marked by <--\ HERE in m/%s/" |
| 4129 |
(F) Within \f(CW\*(C`(?[\ \ \ ])\*(C'\fR, all constants interpreted as octal need to be |
| 4130 |
exactly 3 digits long. This helps catch some ambiguities. If your |
| 4131 |
constant is too short, add leading zeros, like |
| 4132 |
.Sp |
| 4133 |
.Vb 3 |
| 4134 |
\& (?[ [ \e078 ] ]) # Syntax error! |
| 4135 |
\& (?[ [ \e0078 ] ]) # Works |
| 4136 |
\& (?[ [ \e007 8 ] ]) # Clearer |
| 4137 |
.Ve |
| 4138 |
.Sp |
| 4139 |
The maximum number this construct can express is \f(CW\*(C`\e777\*(C'\fR. If you |
| 4140 |
need a larger one, you need to use \eo{} instead. If you meant |
| 4141 |
two separate things, you need to separate them: |
| 4142 |
.Sp |
| 4143 |
.Vb 4 |
| 4144 |
\& (?[ [ \e7776 ] ]) # Syntax error! |
| 4145 |
\& (?[ [ \eo{7776} ] ]) # One meaning |
| 4146 |
\& (?[ [ \e777 6 ] ]) # Another meaning |
| 4147 |
\& (?[ [ \e777 \e006 ] ]) # Still another |
| 4148 |
.Ve |
| 4149 |
.IP "Negative '/' count in unpack" 4 |
| 4150 |
.IX Item "Negative '/' count in unpack" |
| 4151 |
(F) The length count obtained from a length/code unpack operation was |
| 4152 |
negative. See "pack" in perlfunc. |
| 4153 |
.IP "Negative length" 4 |
| 4154 |
.IX Item "Negative length" |
| 4155 |
(F) You tried to do a read/write/send/recv operation with a buffer |
| 4156 |
length that is less than 0. This is difficult to imagine. |
| 4157 |
.IP "Negative offset to vec in lvalue context" 4 |
| 4158 |
.IX Item "Negative offset to vec in lvalue context" |
| 4159 |
(F) When \f(CW\*(C`vec\*(C'\fR is called in an lvalue context, the second argument must be |
| 4160 |
greater than or equal to zero. |
| 4161 |
.IP "Negative repeat count does nothing" 4 |
| 4162 |
.IX Item "Negative repeat count does nothing" |
| 4163 |
(W numeric) You tried to execute the |
| 4164 |
\&\f(CW\*(C`x\*(C'\fR repetition operator fewer than 0 |
| 4165 |
times, which doesn't make sense. |
| 4166 |
.IP "Nested quantifiers in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 4167 |
.IX Item "Nested quantifiers in regex; marked by <--\ HERE in m/%s/" |
| 4168 |
(F) You can't quantify a quantifier without intervening parentheses. |
| 4169 |
So things like ** or +* or ?* are illegal. The <\-\-\ HERE shows |
| 4170 |
whereabouts in the regular expression the problem was discovered. |
| 4171 |
.Sp |
| 4172 |
Note that the minimal matching quantifiers, \f(CW\*(C`*?\*(C'\fR, \f(CW\*(C`+?\*(C'\fR, and |
| 4173 |
\&\f(CW\*(C`??\*(C'\fR appear to be nested quantifiers, but aren't. See perlre. |
| 4174 |
.ie n .IP "%s never introduced" 4 |
| 4175 |
.el .IP "\f(CW%s\fR never introduced" 4 |
| 4176 |
.IX Item "%s never introduced" |
| 4177 |
(S internal) The symbol in question was declared but somehow went out of |
| 4178 |
scope before it could possibly have been used. |
| 4179 |
.IP "next::method/next::can/maybe::next::method cannot find enclosing method" 4 |
| 4180 |
.IX Item "next::method/next::can/maybe::next::method cannot find enclosing method" |
| 4181 |
(F) \f(CW\*(C`next::method\*(C'\fR needs to be called within the context of a |
| 4182 |
real method in a real package, and it could not find such a context. |
| 4183 |
See mro. |
| 4184 |
.IP "\eN in a character class must be a named character: \eN{...} in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 4185 |
.IX Item "N in a character class must be a named character: N{...} in regex; marked by <--\ HERE in m/%s/" |
| 4186 |
(F) The new (as of Perl 5.12) meaning of \f(CW\*(C`\eN\*(C'\fR as \f(CW\*(C`[^\en]\*(C'\fR is not valid in a |
| 4187 |
bracketed character class, for the same reason that \f(CW\*(C`.\*(C'\fR in a character |
| 4188 |
class loses its specialness: it matches almost everything, which is |
| 4189 |
probably not what you want. |
| 4190 |
.IP "\eN{} here is restricted to one character in regex; marked by <\-\- HERE in m/%s/" 4 |
| 4191 |
.IX Item "N{} here is restricted to one character in regex; marked by <-- HERE in m/%s/" |
| 4192 |
(F) Named Unicode character escapes (\f(CW\*(C`\eN{...}\*(C'\fR) may return a |
| 4193 |
multi-character sequence. Even though a character class is |
| 4194 |
supposed to match just one character of input, perl will match the |
| 4195 |
whole thing correctly, except under certain conditions. These currently |
| 4196 |
are |
| 4197 |
.RS 4 |
| 4198 |
.ie n .IP "When the class is inverted (""[^...]"")" 4 |
| 4199 |
.el .IP "When the class is inverted (\f(CW[^...]\fR)" 4 |
| 4200 |
.IX Item "When the class is inverted ([^...])" |
| 4201 |
The mathematically logical behavior for what matches when inverting |
| 4202 |
is very different from what people expect, so we have decided to |
| 4203 |
forbid it. |
| 4204 |
.IP "The escape is the beginning or final end point of a range" 4 |
| 4205 |
.IX Item "The escape is the beginning or final end point of a range" |
| 4206 |
Similarly unclear is what should be generated when the |
| 4207 |
\&\f(CW\*(C`\eN{...}\*(C'\fR is used as one of the end points of the range, such as in |
| 4208 |
.Sp |
| 4209 |
.Vb 1 |
| 4210 |
\& [\ex{41}\-\eN{ARABIC SEQUENCE YEH WITH HAMZA ABOVE WITH AE}] |
| 4211 |
.Ve |
| 4212 |
.Sp |
| 4213 |
What is meant here is unclear, as the \f(CW\*(C`\eN{...}\*(C'\fR escape is a sequence |
| 4214 |
of code points, so this is made an error. |
| 4215 |
.IP "In a regex set" 4 |
| 4216 |
.IX Item "In a regex set" |
| 4217 |
The syntax \f(CW\*(C`(?[\ \ \ ])\*(C'\fR in a regular expression yields a list of |
| 4218 |
single code points, none can be a sequence. |
| 4219 |
.RE |
| 4220 |
.RS 4 |
| 4221 |
.RE |
| 4222 |
.ie n .IP "No %s allowed while running setuid" 4 |
| 4223 |
.el .IP "No \f(CW%s\fR allowed while running setuid" 4 |
| 4224 |
.IX Item "No %s allowed while running setuid" |
| 4225 |
(F) Certain operations are deemed to be too insecure for a setuid or |
| 4226 |
setgid script to even be allowed to attempt. Generally speaking there |
| 4227 |
will be another way to do what you want that is, if not secure, at least |
| 4228 |
securable. See perlsec. |
| 4229 |
.IP "No code specified for \-%c" 4 |
| 4230 |
.IX Item "No code specified for -%c" |
| 4231 |
(F) Perl's \fB\-e\fR and \fB\-E\fR command-line options require an argument. If |
| 4232 |
you want to run an empty program, pass the empty string as a separate |
| 4233 |
argument or run a program consisting of a single 0 or 1: |
| 4234 |
.Sp |
| 4235 |
.Vb 3 |
| 4236 |
\& perl \-e "" |
| 4237 |
\& perl \-e0 |
| 4238 |
\& perl \-e1 |
| 4239 |
.Ve |
| 4240 |
.ie n .IP "No comma allowed after %s" 4 |
| 4241 |
.el .IP "No comma allowed after \f(CW%s\fR" 4 |
| 4242 |
.IX Item "No comma allowed after %s" |
| 4243 |
(F) A list operator that has a filehandle or "indirect object" is |
| 4244 |
not allowed to have a comma between that and the following arguments. |
| 4245 |
Otherwise it'd be just another one of the arguments. |
| 4246 |
.Sp |
| 4247 |
One possible cause for this is that you expected to have imported |
| 4248 |
a constant to your name space with \fBuse\fR or \fBimport\fR while no such |
| 4249 |
importing took place, it may for example be that your operating |
| 4250 |
system does not support that particular constant. Hopefully you did |
| 4251 |
use an explicit import list for the constants you expect to see; |
| 4252 |
please see "use" in perlfunc and "import" in perlfunc. While an |
| 4253 |
explicit import list would probably have caught this error earlier |
| 4254 |
it naturally does not remedy the fact that your operating system |
| 4255 |
still does not support that constant. Maybe you have a typo in |
| 4256 |
the constants of the symbol import list of \fBuse\fR or \fBimport\fR or in the |
| 4257 |
constant name at the line where this error was triggered? |
| 4258 |
.IP "No command into which to pipe on command line" 4 |
| 4259 |
.IX Item "No command into which to pipe on command line" |
| 4260 |
(F) An error peculiar to VMS. Perl handles its own command line |
| 4261 |
redirection, and found a '|' at the end of the command line, so it |
| 4262 |
doesn't know where you want to pipe the output from this command. |
| 4263 |
.IP "No DB::DB routine defined" 4 |
| 4264 |
.IX Item "No DB::DB routine defined" |
| 4265 |
(F) The currently executing code was compiled with the \fB\-d\fR switch, but |
| 4266 |
for some reason the current debugger (e.g. \fIperl5db.pl\fR or a \f(CW\*(C`Devel::\*(C'\fR |
| 4267 |
module) didn't define a routine to be called at the beginning of each |
| 4268 |
statement. |
| 4269 |
.IP "No dbm on this machine" 4 |
| 4270 |
.IX Item "No dbm on this machine" |
| 4271 |
(P) This is counted as an internal error, because every machine should |
| 4272 |
supply dbm nowadays, because Perl comes with SDBM. See SDBM_File. |
| 4273 |
.IP "No DB::sub routine defined" 4 |
| 4274 |
.IX Item "No DB::sub routine defined" |
| 4275 |
(F) The currently executing code was compiled with the \fB\-d\fR switch, but |
| 4276 |
for some reason the current debugger (e.g. \fIperl5db.pl\fR or a \f(CW\*(C`Devel::\*(C'\fR |
| 4277 |
module) didn't define a \f(CW\*(C`DB::sub\*(C'\fR routine to be called at the beginning |
| 4278 |
of each ordinary subroutine call. |
| 4279 |
.ie n .IP "No digits found for %s literal" 4 |
| 4280 |
.el .IP "No digits found for \f(CW%s\fR literal" 4 |
| 4281 |
.IX Item "No digits found for %s literal" |
| 4282 |
(F) No hexadecimal digits were found following \f(CW\*(C`0x\*(C'\fR or no binary digits |
| 4283 |
were found following \f(CW\*(C`0b\*(C'\fR. |
| 4284 |
.IP "No directory specified for \-I" 4 |
| 4285 |
.IX Item "No directory specified for -I" |
| 4286 |
(F) The \fB\-I\fR command-line switch requires a directory name as part of the |
| 4287 |
\&\fIsame\fR argument. Use \fB\-Ilib\fR, for instance. \fB\-I lib\fR won't work. |
| 4288 |
.IP "No error file after 2> or 2>> on command line" 4 |
| 4289 |
.IX Item "No error file after 2> or 2>> on command line" |
| 4290 |
(F) An error peculiar to VMS. Perl handles its own command line |
| 4291 |
redirection, and found a '2>' or a '2>>' on the command line, but can't |
| 4292 |
find the name of the file to which to write data destined for stderr. |
| 4293 |
.IP "No group ending character '%c' found in template" 4 |
| 4294 |
.IX Item "No group ending character '%c' found in template" |
| 4295 |
(F) A pack or unpack template has an opening '(' or '[' without its |
| 4296 |
matching counterpart. See "pack" in perlfunc. |
| 4297 |
.IP "No input file after < on command line" 4 |
| 4298 |
.IX Item "No input file after < on command line" |
| 4299 |
(F) An error peculiar to VMS. Perl handles its own command line |
| 4300 |
redirection, and found a '<' on the command line, but can't find the |
| 4301 |
name of the file from which to read data for stdin. |
| 4302 |
.ie n .IP "No next::method '%s' found for %s" 4 |
| 4303 |
.el .IP "No next::method '%s' found for \f(CW%s\fR" 4 |
| 4304 |
.IX Item "No next::method '%s' found for %s" |
| 4305 |
(F) \f(CW\*(C`next::method\*(C'\fR found no further instances of this method name |
| 4306 |
in the remaining packages of the MRO of this class. If you don't want |
| 4307 |
it throwing an exception, use \f(CW\*(C`maybe::next::method\*(C'\fR |
| 4308 |
or \f(CW\*(C`next::can\*(C'\fR. See mro. |
| 4309 |
.IP "Non-finite repeat count does nothing" 4 |
| 4310 |
.IX Item "Non-finite repeat count does nothing" |
| 4311 |
(W numeric) You tried to execute the |
| 4312 |
\&\f(CW\*(C`x\*(C'\fR repetition operator \f(CW\*(C`Inf\*(C'\fR (or |
| 4313 |
\&\f(CW\*(C`\-Inf\*(C'\fR) or \f(CW\*(C`NaN\*(C'\fR times, which doesn't make sense. |
| 4314 |
.IP "Non-hex character in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 4315 |
.IX Item "Non-hex character in regex; marked by <--\ HERE in m/%s/" |
| 4316 |
(F) In a regular expression, there was a non-hexadecimal character where |
| 4317 |
a hex one was expected, like |
| 4318 |
.Sp |
| 4319 |
.Vb 2 |
| 4320 |
\& (?[ [ \exDG ] ]) |
| 4321 |
\& (?[ [ \ex{DEKA} ] ]) |
| 4322 |
.Ve |
| 4323 |
.IP "Non-hex character '%c' terminates \ex early. Resolved as ""%s""" 4 |
| 4324 |
.IX Item "Non-hex character '%c' terminates x early. Resolved as ""%s""" |
| 4325 |
(W digit) In parsing a hexadecimal numeric constant, a character was |
| 4326 |
unexpectedly encountered that isn't hexadecimal. The resulting value |
| 4327 |
is as indicated. |
| 4328 |
.Sp |
| 4329 |
Note that, within braces, every character starting with the first |
| 4330 |
non-hexadecimal up to the ending brace is ignored. |
| 4331 |
.IP "Non-octal character in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 4332 |
.IX Item "Non-octal character in regex; marked by <--\ HERE in m/%s/" |
| 4333 |
(F) In a regular expression, there was a non-octal character where |
| 4334 |
an octal one was expected, like |
| 4335 |
.Sp |
| 4336 |
.Vb 1 |
| 4337 |
\& (?[ [ \eo{1278} ] ]) |
| 4338 |
.Ve |
| 4339 |
.IP "Non-octal character '%c' terminates \eo early. Resolved as ""%s""" 4 |
| 4340 |
.IX Item "Non-octal character '%c' terminates o early. Resolved as ""%s""" |
| 4341 |
(W digit) In parsing an octal numeric constant, a character was |
| 4342 |
unexpectedly encountered that isn't octal. The resulting value |
| 4343 |
is as indicated. |
| 4344 |
.Sp |
| 4345 |
When not using \f(CW\*(C`\eo{...}\*(C'\fR, you wrote something like \f(CW\*(C`\e08\*(C'\fR, or \f(CW\*(C`\e179\*(C'\fR |
| 4346 |
in a double-quotish string. The resolution is as indicated, with all |
| 4347 |
but the last digit treated as a single character, specified in octal. |
| 4348 |
The last digit is the next character in the string. To tell Perl that |
| 4349 |
this is indeed what you want, you can use the \f(CW\*(C`\eo{ }\*(C'\fR syntax, or use |
| 4350 |
exactly three digits to specify the octal for the character. |
| 4351 |
.Sp |
| 4352 |
Note that, within braces, every character starting with the first |
| 4353 |
non-octal up to the ending brace is ignored. |
| 4354 |
.IP """no"" not allowed in expression" 4 |
| 4355 |
.IX Item """no"" not allowed in expression" |
| 4356 |
(F) The "no" keyword is recognized and executed at compile time, and |
| 4357 |
returns no useful value. See perlmod. |
| 4358 |
.IP "Non-string passed as bitmask" 4 |
| 4359 |
.IX Item "Non-string passed as bitmask" |
| 4360 |
(W misc) A number has been passed as a bitmask argument to \fBselect()\fR. |
| 4361 |
Use the \fBvec()\fR function to construct the file descriptor bitmasks for |
| 4362 |
select. See "select" in perlfunc. |
| 4363 |
.IP "No output file after > on command line" 4 |
| 4364 |
.IX Item "No output file after > on command line" |
| 4365 |
(F) An error peculiar to VMS. Perl handles its own command line |
| 4366 |
redirection, and found a lone '>' at the end of the command line, so it |
| 4367 |
doesn't know where you wanted to redirect stdout. |
| 4368 |
.IP "No output file after > or >> on command line" 4 |
| 4369 |
.IX Item "No output file after > or >> on command line" |
| 4370 |
(F) An error peculiar to VMS. Perl handles its own command line |
| 4371 |
redirection, and found a '>' or a '>>' on the command line, but can't |
| 4372 |
find the name of the file to which to write data destined for stdout. |
| 4373 |
.ie n .IP "No package name allowed for subroutine %s in ""our""" 4 |
| 4374 |
.el .IP "No package name allowed for subroutine \f(CW%s\fR in ""our""" 4 |
| 4375 |
.IX Item "No package name allowed for subroutine %s in ""our""" |
| 4376 |
.PD 0 |
| 4377 |
.ie n .IP "No package name allowed for variable %s in ""our""" 4 |
| 4378 |
.el .IP "No package name allowed for variable \f(CW%s\fR in ""our""" 4 |
| 4379 |
.IX Item "No package name allowed for variable %s in ""our""" |
| 4380 |
.PD |
| 4381 |
(F) Fully qualified subroutine and variable names are not allowed in "our" |
| 4382 |
declarations, because that doesn't make much sense under existing rules. |
| 4383 |
Such syntax is reserved for future extensions. |
| 4384 |
.IP "No Perl script found in input" 4 |
| 4385 |
.IX Item "No Perl script found in input" |
| 4386 |
(F) You called \f(CW\*(C`perl \-x\*(C'\fR, but no line was found in the file beginning |
| 4387 |
with #! and containing the word "perl". |
| 4388 |
.IP "No setregid available" 4 |
| 4389 |
.IX Item "No setregid available" |
| 4390 |
(F) Configure didn't find anything resembling the \fBsetregid()\fR call for |
| 4391 |
your system. |
| 4392 |
.IP "No setreuid available" 4 |
| 4393 |
.IX Item "No setreuid available" |
| 4394 |
(F) Configure didn't find anything resembling the \fBsetreuid()\fR call for |
| 4395 |
your system. |
| 4396 |
.ie n .IP "No such class %s" 4 |
| 4397 |
.el .IP "No such class \f(CW%s\fR" 4 |
| 4398 |
.IX Item "No such class %s" |
| 4399 |
(F) You provided a class qualifier in a "my", "our" or "state" |
| 4400 |
declaration, but this class doesn't exist at this point in your program. |
| 4401 |
.ie n .IP "No such class field ""%s"" in variable %s of type %s" 4 |
| 4402 |
.el .IP "No such class field ""%s"" in variable \f(CW%s\fR of type \f(CW%s\fR" 4 |
| 4403 |
.IX Item "No such class field ""%s"" in variable %s of type %s" |
| 4404 |
(F) You tried to access a key from a hash through the indicated typed |
| 4405 |
variable but that key is not allowed by the package of the same type. |
| 4406 |
The indicated package has restricted the set of allowed keys using the |
| 4407 |
fields pragma. |
| 4408 |
.ie n .IP "No such hook: %s" 4 |
| 4409 |
.el .IP "No such hook: \f(CW%s\fR" 4 |
| 4410 |
.IX Item "No such hook: %s" |
| 4411 |
(F) You specified a signal hook that was not recognized by Perl. |
| 4412 |
Currently, Perl accepts \f(CW\*(C`_\|_DIE_\|_\*(C'\fR and \f(CW\*(C`_\|_WARN_\|_\*(C'\fR as valid signal hooks. |
| 4413 |
.IP "No such pipe open" 4 |
| 4414 |
.IX Item "No such pipe open" |
| 4415 |
(P) An error peculiar to VMS. The internal routine \fBmy_pclose()\fR tried to |
| 4416 |
close a pipe which hadn't been opened. This should have been caught |
| 4417 |
earlier as an attempt to close an unopened filehandle. |
| 4418 |
.IP "No such signal: SIG%s" 4 |
| 4419 |
.IX Item "No such signal: SIG%s" |
| 4420 |
(W signal) You specified a signal name as a subscript to \f(CW%SIG\fR that was |
| 4421 |
not recognized. Say \f(CW\*(C`kill \-l\*(C'\fR in your shell to see the valid signal |
| 4422 |
names on your system. |
| 4423 |
.IP "No Unicode property value wildcard matches:" 4 |
| 4424 |
.IX Item "No Unicode property value wildcard matches:" |
| 4425 |
(W regexp) You specified a wildcard for a Unicode property value, but |
| 4426 |
there is no property value in the current Unicode release that matches |
| 4427 |
it. Check your spelling. |
| 4428 |
.IP "Not a CODE reference" 4 |
| 4429 |
.IX Item "Not a CODE reference" |
| 4430 |
(F) Perl was trying to evaluate a reference to a code value (that is, a |
| 4431 |
subroutine), but found a reference to something else instead. You can |
| 4432 |
use the \fBref()\fR function to find out what kind of ref it really was. See |
| 4433 |
also perlref. |
| 4434 |
.IP "Not a GLOB reference" 4 |
| 4435 |
.IX Item "Not a GLOB reference" |
| 4436 |
(F) Perl was trying to evaluate a reference to a "typeglob" (that is, a |
| 4437 |
symbol table entry that looks like \f(CW*foo\fR), but found a reference to |
| 4438 |
something else instead. You can use the \fBref()\fR function to find out what |
| 4439 |
kind of ref it really was. See perlref. |
| 4440 |
.IP "Not a HASH reference" 4 |
| 4441 |
.IX Item "Not a HASH reference" |
| 4442 |
(F) Perl was trying to evaluate a reference to a hash value, but found a |
| 4443 |
reference to something else instead. You can use the \fBref()\fR function to |
| 4444 |
find out what kind of ref it really was. See perlref. |
| 4445 |
.IP "'#' not allowed immediately following a sigil in a subroutine signature" 4 |
| 4446 |
.IX Item "'#' not allowed immediately following a sigil in a subroutine signature" |
| 4447 |
(F) In a subroutine signature definition, a comment following a sigil |
| 4448 |
(\f(CW\*(C`$\*(C'\fR, \f(CW\*(C`@\*(C'\fR or \f(CW\*(C`%\*(C'\fR), needs to be separated by whitespace or a comma etc., in |
| 4449 |
particular to avoid confusion with the \f(CW$#\fR variable. For example: |
| 4450 |
.Sp |
| 4451 |
.Vb 6 |
| 4452 |
\& # bad |
| 4453 |
\& sub f ($# ignore first arg |
| 4454 |
\& , $y) {} |
| 4455 |
\& # good |
| 4456 |
\& sub f ($, # ignore first arg |
| 4457 |
\& $y) {} |
| 4458 |
.Ve |
| 4459 |
.IP "Not an ARRAY reference" 4 |
| 4460 |
.IX Item "Not an ARRAY reference" |
| 4461 |
(F) Perl was trying to evaluate a reference to an array value, but found |
| 4462 |
a reference to something else instead. You can use the \fBref()\fR function |
| 4463 |
to find out what kind of ref it really was. See perlref. |
| 4464 |
.IP "Not a SCALAR reference" 4 |
| 4465 |
.IX Item "Not a SCALAR reference" |
| 4466 |
(F) Perl was trying to evaluate a reference to a scalar value, but found |
| 4467 |
a reference to something else instead. You can use the \fBref()\fR function |
| 4468 |
to find out what kind of ref it really was. See perlref. |
| 4469 |
.IP "Not a subroutine reference" 4 |
| 4470 |
.IX Item "Not a subroutine reference" |
| 4471 |
(F) Perl was trying to evaluate a reference to a code value (that is, a |
| 4472 |
subroutine), but found a reference to something else instead. You can |
| 4473 |
use the \fBref()\fR function to find out what kind of ref it really was. See |
| 4474 |
also perlref. |
| 4475 |
.IP "Not a subroutine reference in overload table" 4 |
| 4476 |
.IX Item "Not a subroutine reference in overload table" |
| 4477 |
(F) An attempt was made to specify an entry in an overloading table that |
| 4478 |
doesn't somehow point to a valid subroutine. See overload. |
| 4479 |
.ie n .IP "Not enough arguments for %s" 4 |
| 4480 |
.el .IP "Not enough arguments for \f(CW%s\fR" 4 |
| 4481 |
.IX Item "Not enough arguments for %s" |
| 4482 |
(F) The function requires more arguments than you specified. |
| 4483 |
.IP "Not enough format arguments" 4 |
| 4484 |
.IX Item "Not enough format arguments" |
| 4485 |
(W syntax) A format specified more picture fields than the next line |
| 4486 |
supplied. See perlform. |
| 4487 |
.ie n .IP "%s: not found" 4 |
| 4488 |
.el .IP "\f(CW%s:\fR not found" 4 |
| 4489 |
.IX Item "%s: not found" |
| 4490 |
(A) You've accidentally run your script through the Bourne shell instead |
| 4491 |
of Perl. Check the #! line, or manually feed your script into Perl |
| 4492 |
yourself. |
| 4493 |
.IP "no UTC offset information; assuming local time is UTC" 4 |
| 4494 |
.IX Item "no UTC offset information; assuming local time is UTC" |
| 4495 |
(S) A warning peculiar to VMS. Perl was unable to find the local |
| 4496 |
timezone offset, so it's assuming that local system time is equivalent |
| 4497 |
to UTC. If it's not, define the logical name |
| 4498 |
\&\fISYS$TIMEZONE_DIFFERENTIAL\fR to translate to the number of seconds which |
| 4499 |
need to be added to UTC to get local time. |
| 4500 |
.IP "NULL OP IN RUN" 4 |
| 4501 |
.IX Item "NULL OP IN RUN" |
| 4502 |
(S debugging) Some internal routine called \fBrun()\fR with a null opcode |
| 4503 |
pointer. |
| 4504 |
.IP "Null picture in formline" 4 |
| 4505 |
.IX Item "Null picture in formline" |
| 4506 |
(F) The first argument to formline must be a valid format picture |
| 4507 |
specification. It was found to be empty, which probably means you |
| 4508 |
supplied it an uninitialized value. See perlform. |
| 4509 |
.IP "NULL regexp parameter" 4 |
| 4510 |
.IX Item "NULL regexp parameter" |
| 4511 |
(P) The internal pattern matching routines are out of their gourd. |
| 4512 |
.IP "Number too long" 4 |
| 4513 |
.IX Item "Number too long" |
| 4514 |
(F) Perl limits the representation of decimal numbers in programs to |
| 4515 |
about 250 characters. You've exceeded that length. Future |
| 4516 |
versions of Perl are likely to eliminate this arbitrary limitation. In |
| 4517 |
the meantime, try using scientific notation (e.g. "1e6" instead of |
| 4518 |
"1_000_000"). |
| 4519 |
.IP "Number with no digits" 4 |
| 4520 |
.IX Item "Number with no digits" |
| 4521 |
(F) Perl was looking for a number but found nothing that looked like |
| 4522 |
a number. This happens, for example with \f(CW\*(C`\eo{}\*(C'\fR, with no number between |
| 4523 |
the braces. |
| 4524 |
.IP "Numeric format result too large" 4 |
| 4525 |
.IX Item "Numeric format result too large" |
| 4526 |
(F) The length of the result of a numeric format supplied to \fBsprintf()\fR |
| 4527 |
or \fBprintf()\fR would have been too large for the underlying C function to |
| 4528 |
report. This limit is typically 2GB. |
| 4529 |
.IP "Numeric variables with more than one digit may not start with '0'" 4 |
| 4530 |
.IX Item "Numeric variables with more than one digit may not start with '0'" |
| 4531 |
(F) The only numeric variable which is allowed to start with a 0 is \f(CW$0\fR, |
| 4532 |
and you mentioned a variable that starts with 0 that has more than one |
| 4533 |
digit. You probably want to remove the leading 0, or if the intent was |
| 4534 |
to express a variable name in octal you should convert to decimal. |
| 4535 |
.IP "Octal number > 037777777777 non-portable" 4 |
| 4536 |
.IX Item "Octal number > 037777777777 non-portable" |
| 4537 |
(W portable) The octal number you specified is larger than 2**32\-1 |
| 4538 |
(4294967295) and therefore non-portable between systems. See |
| 4539 |
perlport for more on portability concerns. |
| 4540 |
.IP "Odd name/value argument for subroutine '%s'" 4 |
| 4541 |
.IX Item "Odd name/value argument for subroutine '%s'" |
| 4542 |
(F) A subroutine using a slurpy hash parameter in its signature |
| 4543 |
received an odd number of arguments to populate the hash. It requires |
| 4544 |
the arguments to be paired, with the same number of keys as values. |
| 4545 |
The caller of the subroutine is presumably at fault. |
| 4546 |
.Sp |
| 4547 |
The message attempts to include the name of the called subroutine. If the |
| 4548 |
subroutine has been aliased, the subroutine's original name will be shown, |
| 4549 |
regardless of what name the caller used. |
| 4550 |
.IP "Odd number of arguments for overload::constant" 4 |
| 4551 |
.IX Item "Odd number of arguments for overload::constant" |
| 4552 |
(W overload) The call to overload::constant contained an odd number of |
| 4553 |
arguments. The arguments should come in pairs. |
| 4554 |
.IP "Odd number of arguments passed to ""%s"" constructor" 4 |
| 4555 |
.IX Item "Odd number of arguments passed to ""%s"" constructor" |
| 4556 |
(S) The constructor for the given class was called with an odd |
| 4557 |
number of arguments. |
| 4558 |
.Sp |
| 4559 |
Class constructors accept named arguments as a list and expect pairs |
| 4560 |
of name followed by value as if you were initialising a hash. |
| 4561 |
.IP "Odd number of elements in anonymous hash" 4 |
| 4562 |
.IX Item "Odd number of elements in anonymous hash" |
| 4563 |
(W misc) You specified an odd number of elements to initialize a hash, |
| 4564 |
which is odd, because hashes come in key/value pairs. |
| 4565 |
.IP "Odd number of elements in export_lexically" 4 |
| 4566 |
.IX Item "Odd number of elements in export_lexically" |
| 4567 |
(F) A call to "export_lexically" in builtin contained an odd number of |
| 4568 |
arguments. This is not permitted, because each name must be paired with a |
| 4569 |
valid reference value. |
| 4570 |
.IP "Odd number of elements in hash assignment" 4 |
| 4571 |
.IX Item "Odd number of elements in hash assignment" |
| 4572 |
(W misc) You specified an odd number of elements to initialize a hash, |
| 4573 |
which is odd, because hashes come in key/value pairs. |
| 4574 |
.IP "Odd number of elements in hash field initialization" 4 |
| 4575 |
.IX Item "Odd number of elements in hash field initialization" |
| 4576 |
(W misc) You specified an odd number of elements to initialise a hash |
| 4577 |
field of an object. Hashes are initialised from a list of key/value |
| 4578 |
pairs so there must be a corresponding value to every key. The final |
| 4579 |
missing value will be filled in with undef instead. |
| 4580 |
.IP "Offset outside string" 4 |
| 4581 |
.IX Item "Offset outside string" |
| 4582 |
(W layer) You tried to do a read/write/send/recv/seek operation |
| 4583 |
with an offset pointing outside the buffer. This is difficult to |
| 4584 |
imagine. The sole exceptions to this are that zero padding will |
| 4585 |
take place when going past the end of the string when either |
| 4586 |
\&\f(CWsysread()\fRing a file, or when seeking past the end of a scalar opened |
| 4587 |
for I/O (in anticipation of future reads and to imitate the behavior |
| 4588 |
with real files). |
| 4589 |
.IP "Old package separator ""'"" deprecated" 4 |
| 4590 |
.IX Item "Old package separator ""'"" deprecated" |
| 4591 |
(D deprecated::apostrophe_as_package_separator, syntax) You used the old package |
| 4592 |
separator "'" in a variable, subroutine or package name. Support for the |
| 4593 |
old package separator will be removed in Perl 5.42. |
| 4594 |
.IP "Old package separator used in string" 4 |
| 4595 |
.IX Item "Old package separator used in string" |
| 4596 |
(D deprecated::apostrophe_as_package_separator, syntax) You used the old package |
| 4597 |
separator, "'", in a variable named inside a double-quoted string; e.g., |
| 4598 |
\&\f(CW"In $name\*(Aqs house"\fR. This is equivalent to \f(CW"In $name::s house"\fR. If |
| 4599 |
you meant the former, put a backslash before the apostrophe |
| 4600 |
(\f(CW"In $name\e\*(Aqs house"\fR). |
| 4601 |
.Sp |
| 4602 |
Support for the old package separator will be removed in Perl 5.42. |
| 4603 |
.IP "Only scalar fields can take a :param attribute" 4 |
| 4604 |
.IX Item "Only scalar fields can take a :param attribute" |
| 4605 |
(F) You tried to apply the \f(CW\*(C`:param\*(C'\fR attribute to an array or hash field. |
| 4606 |
Currently this is not permitted. |
| 4607 |
.ie n .IP "%s() on unopened %s" 4 |
| 4608 |
.el .IP "%s() on unopened \f(CW%s\fR" 4 |
| 4609 |
.IX Item "%s() on unopened %s" |
| 4610 |
(W unopened) An I/O operation was attempted on a filehandle that was |
| 4611 |
never initialized. You need to do an \fBopen()\fR, a \fBsysopen()\fR, or a \fBsocket()\fR |
| 4612 |
call, or call a constructor from the FileHandle package. |
| 4613 |
.ie n .IP "\-%s on unopened filehandle %s" 4 |
| 4614 |
.el .IP "\-%s on unopened filehandle \f(CW%s\fR" 4 |
| 4615 |
.IX Item "-%s on unopened filehandle %s" |
| 4616 |
(W unopened) You tried to invoke a file test operator on a filehandle |
| 4617 |
that isn't open. Check your control flow. See also "\-X" in perlfunc. |
| 4618 |
.IP "oops: oopsAV" 4 |
| 4619 |
.IX Item "oops: oopsAV" |
| 4620 |
(S internal) An internal warning that the grammar is screwed up. |
| 4621 |
.IP "oops: oopsHV" 4 |
| 4622 |
.IX Item "oops: oopsHV" |
| 4623 |
(S internal) An internal warning that the grammar is screwed up. |
| 4624 |
.IP "Operand with no preceding operator in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 4625 |
.IX Item "Operand with no preceding operator in regex; marked by <--\ HERE in m/%s/" |
| 4626 |
(F) You wrote something like |
| 4627 |
.Sp |
| 4628 |
.Vb 1 |
| 4629 |
\& (?[ \ep{Digit} \ep{Thai} ]) |
| 4630 |
.Ve |
| 4631 |
.Sp |
| 4632 |
There are two operands, but no operator giving how you want to combine |
| 4633 |
them. |
| 4634 |
.ie n .IP "Operation ""%s"": no method found, %s" 4 |
| 4635 |
.el .IP "Operation ""%s"": no method found, \f(CW%s\fR" 4 |
| 4636 |
.IX Item "Operation ""%s"": no method found, %s" |
| 4637 |
(F) An attempt was made to perform an overloaded operation for which no |
| 4638 |
handler was defined. While some handlers can be autogenerated in terms |
| 4639 |
of other handlers, there is no default handler for any operation, unless |
| 4640 |
the \f(CW\*(C`fallback\*(C'\fR overloading key is specified to be true. See overload. |
| 4641 |
.IP "Operation ""%s"" returns its argument for non-Unicode code point 0x%X" 4 |
| 4642 |
.IX Item "Operation ""%s"" returns its argument for non-Unicode code point 0x%X" |
| 4643 |
(S non_unicode) You performed an operation requiring Unicode rules |
| 4644 |
on a code point that is not in Unicode, so what it should do is not |
| 4645 |
defined. Perl has chosen to have it do nothing, and warn you. |
| 4646 |
.Sp |
| 4647 |
If the operation shown is "ToFold", it means that case-insensitive |
| 4648 |
matching in a regular expression was done on the code point. |
| 4649 |
.Sp |
| 4650 |
If you know what you are doing you can turn off this warning by |
| 4651 |
\&\f(CW\*(C`no warnings \*(Aqnon_unicode\*(Aq;\*(C'\fR. |
| 4652 |
.IP "Operation ""%s"" returns its argument for UTF\-16 surrogate U+%X" 4 |
| 4653 |
.IX Item "Operation ""%s"" returns its argument for UTF-16 surrogate U+%X" |
| 4654 |
(S surrogate) You performed an operation requiring Unicode |
| 4655 |
rules on a Unicode surrogate. Unicode frowns upon the use |
| 4656 |
of surrogates for anything but storing strings in UTF\-16, but |
| 4657 |
rules are (reluctantly) defined for the surrogates, and |
| 4658 |
they are to do nothing for this operation. Because the use of |
| 4659 |
surrogates can be dangerous, Perl warns. |
| 4660 |
.Sp |
| 4661 |
If the operation shown is "ToFold", it means that case-insensitive |
| 4662 |
matching in a regular expression was done on the code point. |
| 4663 |
.Sp |
| 4664 |
If you know what you are doing you can turn off this warning by |
| 4665 |
\&\f(CW\*(C`no warnings \*(Aqsurrogate\*(Aq;\*(C'\fR. |
| 4666 |
.ie n .IP "Operator or semicolon missing before %s" 4 |
| 4667 |
.el .IP "Operator or semicolon missing before \f(CW%s\fR" 4 |
| 4668 |
.IX Item "Operator or semicolon missing before %s" |
| 4669 |
(S ambiguous) You used a variable or subroutine call where the parser |
| 4670 |
was expecting an operator. The parser has assumed you really meant to |
| 4671 |
use an operator, but this is highly likely to be incorrect. For |
| 4672 |
example, if you say "*foo *foo" it will be interpreted as if you said |
| 4673 |
"*foo * 'foo'". |
| 4674 |
.IP "Optional parameter lacks default expression" 4 |
| 4675 |
.IX Item "Optional parameter lacks default expression" |
| 4676 |
(F) In a subroutine signature, you wrote something like "$x =", making a |
| 4677 |
named optional parameter without a default value. A nameless optional |
| 4678 |
parameter is permitted to have no default value, but a named one must |
| 4679 |
have a specific default. You probably want "$x = undef". |
| 4680 |
.ie n .IP """our"" variable %s redeclared" 4 |
| 4681 |
.el .IP """our"" variable \f(CW%s\fR redeclared" 4 |
| 4682 |
.IX Item """our"" variable %s redeclared" |
| 4683 |
(W shadow) You seem to have already declared the same global once before |
| 4684 |
in the current lexical scope. |
| 4685 |
.IP "Out of memory!" 4 |
| 4686 |
.IX Item "Out of memory!" |
| 4687 |
(X) The \fBmalloc()\fR function returned 0, indicating there was insufficient |
| 4688 |
remaining memory (or virtual memory) to satisfy the request. Perl has |
| 4689 |
no option but to exit immediately. |
| 4690 |
.Sp |
| 4691 |
At least in Unix you may be able to get past this by increasing your |
| 4692 |
process datasize limits: in csh/tcsh use \f(CW\*(C`limit\*(C'\fR and |
| 4693 |
\&\f(CW\*(C`limit datasize n\*(C'\fR (where \f(CW\*(C`n\*(C'\fR is the number of kilobytes) to check |
| 4694 |
the current limits and change them, and in ksh/bash/zsh use \f(CW\*(C`ulimit \-a\*(C'\fR |
| 4695 |
and \f(CW\*(C`ulimit \-d n\*(C'\fR, respectively. |
| 4696 |
.ie n .IP "Out of memory during %s extend" 4 |
| 4697 |
.el .IP "Out of memory during \f(CW%s\fR extend" 4 |
| 4698 |
.IX Item "Out of memory during %s extend" |
| 4699 |
(X) An attempt was made to extend an array, a list, or a string beyond |
| 4700 |
the largest possible memory allocation. |
| 4701 |
.ie n .IP "Out of memory during ""large"" request for %s" 4 |
| 4702 |
.el .IP "Out of memory during ""large"" request for \f(CW%s\fR" 4 |
| 4703 |
.IX Item "Out of memory during ""large"" request for %s" |
| 4704 |
(F) The \fBmalloc()\fR function returned 0, indicating there was insufficient |
| 4705 |
remaining memory (or virtual memory) to satisfy the request. However, |
| 4706 |
the request was judged large enough (compile-time default is 64K), so a |
| 4707 |
possibility to shut down by trapping this error is granted. |
| 4708 |
.ie n .IP "Out of memory during request for %s" 4 |
| 4709 |
.el .IP "Out of memory during request for \f(CW%s\fR" 4 |
| 4710 |
.IX Item "Out of memory during request for %s" |
| 4711 |
(X)(F) The \fBmalloc()\fR function returned 0, indicating there was |
| 4712 |
insufficient remaining memory (or virtual memory) to satisfy the |
| 4713 |
request. |
| 4714 |
.Sp |
| 4715 |
The request was judged to be small, so the possibility to trap it |
| 4716 |
depends on the way perl was compiled. By default it is not trappable. |
| 4717 |
However, if compiled for this, Perl may use the contents of \f(CW$^M\fR as an |
| 4718 |
emergency pool after \fBdie()\fRing with this message. In this case the error |
| 4719 |
is trappable \fIonce\fR, and the error message will include the line and file |
| 4720 |
where the failed request happened. |
| 4721 |
.IP "Out of memory during ridiculously large request" 4 |
| 4722 |
.IX Item "Out of memory during ridiculously large request" |
| 4723 |
(F) You can't allocate more than 2^31+"small amount" bytes. This error |
| 4724 |
is most likely to be caused by a typo in the Perl program. e.g., |
| 4725 |
\&\f(CW$arr[time]\fR instead of \f(CW$arr[$time]\fR. |
| 4726 |
.IP "Out of memory during vec in lvalue context" 4 |
| 4727 |
.IX Item "Out of memory during vec in lvalue context" |
| 4728 |
(F) An attempt was made to extend a string beyond the largest possible memory |
| 4729 |
allocation by assigning to \f(CWvec()\fR called with a large second argument. |
| 4730 |
.IP "Out of memory for yacc stack" 4 |
| 4731 |
.IX Item "Out of memory for yacc stack" |
| 4732 |
(F) The yacc parser wanted to grow its stack so it could continue |
| 4733 |
parsing, but \fBrealloc()\fR wouldn't give it more memory, virtual or |
| 4734 |
otherwise. |
| 4735 |
.IP "Out of memory in perl:%s" 4 |
| 4736 |
.IX Item "Out of memory in perl:%s" |
| 4737 |
(X) A low-level memory allocation routine failed, indicating there was |
| 4738 |
insufficient remaining (virtual) memory to satisfy the request. Perl has no |
| 4739 |
option but to exit immediately. |
| 4740 |
.Sp |
| 4741 |
At least in Unix you may be able to get past this by increasing your process |
| 4742 |
datasize limits: in csh/tcsh use \f(CW\*(C`limit\*(C'\fR and \f(CW\*(C`limit datasize n\*(C'\fR (where \f(CW\*(C`n\*(C'\fR |
| 4743 |
is the number of kilobytes) to check the current limits and change them, and in |
| 4744 |
ksh/bash/zsh use \f(CW\*(C`ulimit \-a\*(C'\fR and \f(CW\*(C`ulimit \-d n\*(C'\fR, respectively. |
| 4745 |
.IP "'.' outside of string in pack" 4 |
| 4746 |
.IX Item "'.' outside of string in pack" |
| 4747 |
(F) The argument to a '.' in your template tried to move the working |
| 4748 |
position to before the start of the packed string being built. |
| 4749 |
.IP "'@' outside of string in unpack" 4 |
| 4750 |
.IX Item "'@' outside of string in unpack" |
| 4751 |
(F) You had a template that specified an absolute position outside |
| 4752 |
the string being unpacked. See "pack" in perlfunc. |
| 4753 |
.IP "'@' outside of string with malformed UTF\-8 in unpack" 4 |
| 4754 |
.IX Item "'@' outside of string with malformed UTF-8 in unpack" |
| 4755 |
(F) You had a template that specified an absolute position outside |
| 4756 |
the string being unpacked. The string being unpacked was also invalid |
| 4757 |
UTF\-8. See "pack" in perlfunc. |
| 4758 |
.IP "overload arg '%s' is invalid" 4 |
| 4759 |
.IX Item "overload arg '%s' is invalid" |
| 4760 |
(W overload) The overload pragma was passed an argument it did not |
| 4761 |
recognize. Did you mistype an operator? |
| 4762 |
.IP "Overloaded dereference did not return a reference" 4 |
| 4763 |
.IX Item "Overloaded dereference did not return a reference" |
| 4764 |
(F) An object with an overloaded dereference operator was dereferenced, |
| 4765 |
but the overloaded operation did not return a reference. See |
| 4766 |
overload. |
| 4767 |
.IP "Overloaded qr did not return a REGEXP" 4 |
| 4768 |
.IX Item "Overloaded qr did not return a REGEXP" |
| 4769 |
(F) An object with a \f(CW\*(C`qr\*(C'\fR overload was used as part of a match, but the |
| 4770 |
overloaded operation didn't return a compiled regexp. See overload. |
| 4771 |
.ie n .IP "%s package attribute may clash with future reserved word: %s" 4 |
| 4772 |
.el .IP "\f(CW%s\fR package attribute may clash with future reserved word: \f(CW%s\fR" 4 |
| 4773 |
.IX Item "%s package attribute may clash with future reserved word: %s" |
| 4774 |
(W reserved) A lowercase attribute name was used that had a |
| 4775 |
package-specific handler. That name might have a meaning to Perl itself |
| 4776 |
some day, even though it doesn't yet. Perhaps you should use a |
| 4777 |
mixed-case attribute name, instead. See attributes. |
| 4778 |
.IP "pack/unpack repeat count overflow" 4 |
| 4779 |
.IX Item "pack/unpack repeat count overflow" |
| 4780 |
(F) You can't specify a repeat count so large that it overflows your |
| 4781 |
signed integers. See "pack" in perlfunc. |
| 4782 |
.IP "page overflow" 4 |
| 4783 |
.IX Item "page overflow" |
| 4784 |
(W io) A single call to \fBwrite()\fR produced more lines than can fit on a |
| 4785 |
page. See perlform. |
| 4786 |
.ie n .IP "panic: %s" 4 |
| 4787 |
.el .IP "panic: \f(CW%s\fR" 4 |
| 4788 |
.IX Item "panic: %s" |
| 4789 |
(P) An internal error. |
| 4790 |
.ie n .IP "panic: attempt to call %s in %s" 4 |
| 4791 |
.el .IP "panic: attempt to call \f(CW%s\fR in \f(CW%s\fR" 4 |
| 4792 |
.IX Item "panic: attempt to call %s in %s" |
| 4793 |
(P) One of the file test operators entered a code branch that calls |
| 4794 |
an ACL related-function, but that function is not available on this |
| 4795 |
platform. Earlier checks mean that it should not be possible to |
| 4796 |
enter this branch on this platform. |
| 4797 |
.IP "panic: child pseudo-process was never scheduled" 4 |
| 4798 |
.IX Item "panic: child pseudo-process was never scheduled" |
| 4799 |
(P) A child pseudo-process in the ithreads implementation on Windows |
| 4800 |
was not scheduled within the time period allowed and therefore was not |
| 4801 |
able to initialize properly. |
| 4802 |
.IP "panic: ck_grep, type=%u" 4 |
| 4803 |
.IX Item "panic: ck_grep, type=%u" |
| 4804 |
(P) Failed an internal consistency check trying to compile a grep. |
| 4805 |
.ie n .IP "panic: corrupt saved stack index %ld" 4 |
| 4806 |
.el .IP "panic: corrupt saved stack index \f(CW%ld\fR" 4 |
| 4807 |
.IX Item "panic: corrupt saved stack index %ld" |
| 4808 |
(P) The savestack was requested to restore more localized values than |
| 4809 |
there are in the savestack. |
| 4810 |
.IP "panic: del_backref" 4 |
| 4811 |
.IX Item "panic: del_backref" |
| 4812 |
(P) Failed an internal consistency check while trying to reset a weak |
| 4813 |
reference. |
| 4814 |
.ie n .IP "panic: fold_constants JMPENV_PUSH returned %d" 4 |
| 4815 |
.el .IP "panic: fold_constants JMPENV_PUSH returned \f(CW%d\fR" 4 |
| 4816 |
.IX Item "panic: fold_constants JMPENV_PUSH returned %d" |
| 4817 |
(P) While attempting folding constants an exception other than an \f(CW\*(C`eval\*(C'\fR |
| 4818 |
failure was caught. |
| 4819 |
.ie n .IP "panic: frexp: %f" 4 |
| 4820 |
.el .IP "panic: frexp: \f(CW%f\fR" 4 |
| 4821 |
.IX Item "panic: frexp: %f" |
| 4822 |
(P) The library function \fBfrexp()\fR failed, making printf("%f") impossible. |
| 4823 |
.IP "panic: goto, type=%u, ix=%ld" 4 |
| 4824 |
.IX Item "panic: goto, type=%u, ix=%ld" |
| 4825 |
(P) We popped the context stack to a context with the specified label, |
| 4826 |
and then discovered it wasn't a context we know how to do a goto in. |
| 4827 |
.IP "panic: gp_free failed to free glob pointer" 4 |
| 4828 |
.IX Item "panic: gp_free failed to free glob pointer" |
| 4829 |
(P) The internal routine used to clear a typeglob's entries tried |
| 4830 |
repeatedly, but each time something re-created entries in the glob. |
| 4831 |
Most likely the glob contains an object with a reference back to |
| 4832 |
the glob and a destructor that adds a new object to the glob. |
| 4833 |
.ie n .IP "panic: INTERPCASEMOD, %s" 4 |
| 4834 |
.el .IP "panic: INTERPCASEMOD, \f(CW%s\fR" 4 |
| 4835 |
.IX Item "panic: INTERPCASEMOD, %s" |
| 4836 |
(P) The lexer got into a bad state at a case modifier. |
| 4837 |
.ie n .IP "panic: INTERPCONCAT, %s" 4 |
| 4838 |
.el .IP "panic: INTERPCONCAT, \f(CW%s\fR" 4 |
| 4839 |
.IX Item "panic: INTERPCONCAT, %s" |
| 4840 |
(P) The lexer got into a bad state parsing a string with brackets. |
| 4841 |
.IP "panic: kid popen errno read" 4 |
| 4842 |
.IX Item "panic: kid popen errno read" |
| 4843 |
(F) A forked child returned an incomprehensible message about its errno. |
| 4844 |
.ie n .IP "panic: leave_scope inconsistency %u" 4 |
| 4845 |
.el .IP "panic: leave_scope inconsistency \f(CW%u\fR" 4 |
| 4846 |
.IX Item "panic: leave_scope inconsistency %u" |
| 4847 |
(P) The savestack probably got out of sync. At least, there was an |
| 4848 |
invalid enum on the top of it. |
| 4849 |
.IP "panic: magic_killbackrefs" 4 |
| 4850 |
.IX Item "panic: magic_killbackrefs" |
| 4851 |
(P) Failed an internal consistency check while trying to reset all weak |
| 4852 |
references to an object. |
| 4853 |
.ie n .IP "panic: malloc, %s" 4 |
| 4854 |
.el .IP "panic: malloc, \f(CW%s\fR" 4 |
| 4855 |
.IX Item "panic: malloc, %s" |
| 4856 |
(P) Something requested a negative number of bytes of malloc. |
| 4857 |
.IP "panic: memory wrap" 4 |
| 4858 |
.IX Item "panic: memory wrap" |
| 4859 |
(P) Something tried to allocate either more memory than possible or a |
| 4860 |
negative amount. |
| 4861 |
.ie n .IP "panic: newFORLOOP, %s" 4 |
| 4862 |
.el .IP "panic: newFORLOOP, \f(CW%s\fR" 4 |
| 4863 |
.IX Item "panic: newFORLOOP, %s" |
| 4864 |
(P) The parser failed an internal consistency check while trying to parse |
| 4865 |
a \f(CW\*(C`foreach\*(C'\fR loop. |
| 4866 |
.ie n .IP "panic: pad_alloc, %p!=%p" 4 |
| 4867 |
.el .IP "panic: pad_alloc, \f(CW%p\fR!=%p" 4 |
| 4868 |
.IX Item "panic: pad_alloc, %p!=%p" |
| 4869 |
(P) The compiler got confused about which scratch pad it was allocating |
| 4870 |
and freeing temporaries and lexicals from. |
| 4871 |
.ie n .IP "panic: pad_free curpad, %p!=%p" 4 |
| 4872 |
.el .IP "panic: pad_free curpad, \f(CW%p\fR!=%p" 4 |
| 4873 |
.IX Item "panic: pad_free curpad, %p!=%p" |
| 4874 |
(P) The compiler got confused about which scratch pad it was allocating |
| 4875 |
and freeing temporaries and lexicals from. |
| 4876 |
.IP "panic: pad_free po" 4 |
| 4877 |
.IX Item "panic: pad_free po" |
| 4878 |
(P) A zero scratch pad offset was detected internally. An attempt was |
| 4879 |
made to free a target that had not been allocated to begin with. |
| 4880 |
.ie n .IP "panic: pad_reset curpad, %p!=%p" 4 |
| 4881 |
.el .IP "panic: pad_reset curpad, \f(CW%p\fR!=%p" 4 |
| 4882 |
.IX Item "panic: pad_reset curpad, %p!=%p" |
| 4883 |
(P) The compiler got confused about which scratch pad it was allocating |
| 4884 |
and freeing temporaries and lexicals from. |
| 4885 |
.IP "panic: pad_sv po" 4 |
| 4886 |
.IX Item "panic: pad_sv po" |
| 4887 |
(P) A zero scratch pad offset was detected internally. Most likely |
| 4888 |
an operator needed a target but that target had not been allocated |
| 4889 |
for whatever reason. |
| 4890 |
.ie n .IP "panic: pad_swipe curpad, %p!=%p" 4 |
| 4891 |
.el .IP "panic: pad_swipe curpad, \f(CW%p\fR!=%p" 4 |
| 4892 |
.IX Item "panic: pad_swipe curpad, %p!=%p" |
| 4893 |
(P) The compiler got confused about which scratch pad it was allocating |
| 4894 |
and freeing temporaries and lexicals from. |
| 4895 |
.IP "panic: pad_swipe po" 4 |
| 4896 |
.IX Item "panic: pad_swipe po" |
| 4897 |
(P) An invalid scratch pad offset was detected internally. |
| 4898 |
.IP "panic: pp_iter, type=%u" 4 |
| 4899 |
.IX Item "panic: pp_iter, type=%u" |
| 4900 |
(P) The foreach iterator got called in a non-loop context frame. |
| 4901 |
.IP "panic: pp_match%s" 4 |
| 4902 |
.IX Item "panic: pp_match%s" |
| 4903 |
(P) The internal \fBpp_match()\fR routine was called with invalid operational |
| 4904 |
data. |
| 4905 |
.ie n .IP "panic: realloc, %s" 4 |
| 4906 |
.el .IP "panic: realloc, \f(CW%s\fR" 4 |
| 4907 |
.IX Item "panic: realloc, %s" |
| 4908 |
(P) Something requested a negative number of bytes of realloc. |
| 4909 |
.IP "panic: reference miscount on nsv in \fBsv_replace()\fR (%d != 1)" 4 |
| 4910 |
.IX Item "panic: reference miscount on nsv in sv_replace() (%d != 1)" |
| 4911 |
(P) The internal \fBsv_replace()\fR function was handed a new SV with a |
| 4912 |
reference count other than 1. |
| 4913 |
.ie n .IP "panic: restartop in %s" 4 |
| 4914 |
.el .IP "panic: restartop in \f(CW%s\fR" 4 |
| 4915 |
.IX Item "panic: restartop in %s" |
| 4916 |
(P) Some internal routine requested a goto (or something like it), and |
| 4917 |
didn't supply the destination. |
| 4918 |
.IP "panic: return, type=%u" 4 |
| 4919 |
.IX Item "panic: return, type=%u" |
| 4920 |
(P) We popped the context stack to a subroutine or eval context, and |
| 4921 |
then discovered it wasn't a subroutine or eval context. |
| 4922 |
.ie n .IP "panic: scan_num, %s" 4 |
| 4923 |
.el .IP "panic: scan_num, \f(CW%s\fR" 4 |
| 4924 |
.IX Item "panic: scan_num, %s" |
| 4925 |
(P) \fBscan_num()\fR got called on something that wasn't a number. |
| 4926 |
.IP "panic: Sequence (?{...}): no code block found in regex m/%s/" 4 |
| 4927 |
.IX Item "panic: Sequence (?{...}): no code block found in regex m/%s/" |
| 4928 |
(P) While compiling a pattern that has embedded (?{}) or (??{}) code |
| 4929 |
blocks, perl couldn't locate the code block that should have already been |
| 4930 |
seen and compiled by perl before control passed to the regex compiler. |
| 4931 |
.ie n .IP "panic: sv_chop %s" 4 |
| 4932 |
.el .IP "panic: sv_chop \f(CW%s\fR" 4 |
| 4933 |
.IX Item "panic: sv_chop %s" |
| 4934 |
(P) The \fBsv_chop()\fR routine was passed a position that is not within the |
| 4935 |
scalar's string buffer. |
| 4936 |
.IP "panic: sv_insert, midend=%p, bigend=%p" 4 |
| 4937 |
.IX Item "panic: sv_insert, midend=%p, bigend=%p" |
| 4938 |
(P) The \fBsv_insert()\fR routine was told to remove more string than there |
| 4939 |
was string. |
| 4940 |
.IP "panic: top_env" 4 |
| 4941 |
.IX Item "panic: top_env" |
| 4942 |
(P) The compiler attempted to do a goto, or something weird like that. |
| 4943 |
.ie n .IP "panic: unexpected constant lvalue entersub entry via type/targ %d:%d" 4 |
| 4944 |
.el .IP "panic: unexpected constant lvalue entersub entry via type/targ \f(CW%d:\fR%d" 4 |
| 4945 |
.IX Item "panic: unexpected constant lvalue entersub entry via type/targ %d:%d" |
| 4946 |
(P) When compiling a subroutine call in lvalue context, Perl failed an |
| 4947 |
internal consistency check. It encountered a malformed op tree. |
| 4948 |
.ie n .IP "panic: unimplemented op %s (#%d) called" 4 |
| 4949 |
.el .IP "panic: unimplemented op \f(CW%s\fR (#%d) called" 4 |
| 4950 |
.IX Item "panic: unimplemented op %s (#%d) called" |
| 4951 |
(P) The compiler is screwed up and attempted to use an op that isn't |
| 4952 |
permitted at run time. |
| 4953 |
.ie n .IP "panic: unknown OA_*: %x" 4 |
| 4954 |
.el .IP "panic: unknown OA_*: \f(CW%x\fR" 4 |
| 4955 |
.IX Item "panic: unknown OA_*: %x" |
| 4956 |
(P) The internal routine that handles arguments to \f(CW&CORE::foo()\fR |
| 4957 |
subroutine calls was unable to determine what type of arguments |
| 4958 |
were expected. |
| 4959 |
.IP "panic: utf16_to_utf8: odd bytelen" 4 |
| 4960 |
.IX Item "panic: utf16_to_utf8: odd bytelen" |
| 4961 |
(P) Something tried to call utf16_to_utf8 with an odd (as opposed |
| 4962 |
to even) byte length. |
| 4963 |
.IP "panic: utf16_to_utf8_reversed: odd bytelen" 4 |
| 4964 |
.IX Item "panic: utf16_to_utf8_reversed: odd bytelen" |
| 4965 |
(P) Something tried to call utf16_to_utf8_reversed with an odd (as opposed |
| 4966 |
to even) byte length. |
| 4967 |
.ie n .IP "panic: yylex, %s" 4 |
| 4968 |
.el .IP "panic: yylex, \f(CW%s\fR" 4 |
| 4969 |
.IX Item "panic: yylex, %s" |
| 4970 |
(P) The lexer got into a bad state while processing a case modifier. |
| 4971 |
.IP "Parentheses missing around ""%s"" list" 4 |
| 4972 |
.IX Item "Parentheses missing around ""%s"" list" |
| 4973 |
(W parenthesis) You said something like |
| 4974 |
.Sp |
| 4975 |
.Vb 1 |
| 4976 |
\& my $foo, $bar = @_; |
| 4977 |
.Ve |
| 4978 |
.Sp |
| 4979 |
when you meant |
| 4980 |
.Sp |
| 4981 |
.Vb 1 |
| 4982 |
\& my ($foo, $bar) = @_; |
| 4983 |
.Ve |
| 4984 |
.Sp |
| 4985 |
Remember that "my", "our", "local" and "state" bind tighter than comma. |
| 4986 |
.IP "Parsing code internal error (%s)" 4 |
| 4987 |
.IX Item "Parsing code internal error (%s)" |
| 4988 |
(F) Parsing code supplied by an extension violated the parser's API in |
| 4989 |
a detectable way. |
| 4990 |
.IP "Pattern subroutine nesting without pos change exceeded limit in regex" 4 |
| 4991 |
.IX Item "Pattern subroutine nesting without pos change exceeded limit in regex" |
| 4992 |
(F) You used a pattern that uses too many nested subpattern calls without |
| 4993 |
consuming any text. Restructure the pattern so text is consumed before |
| 4994 |
the nesting limit is exceeded. |
| 4995 |
.ie n .IP """\-p"" destination: %s" 4 |
| 4996 |
.el .IP "\f(CW\-p\fR destination: \f(CW%s\fR" 4 |
| 4997 |
.IX Item "-p destination: %s" |
| 4998 |
(F) An error occurred during the implicit output invoked by the \f(CW\*(C`\-p\*(C'\fR |
| 4999 |
command-line switch. (This output goes to STDOUT unless you've |
| 5000 |
redirected it with \fBselect()\fR.) |
| 5001 |
.ie n .IP "Perl API version %s of %s does not match %s" 4 |
| 5002 |
.el .IP "Perl API version \f(CW%s\fR of \f(CW%s\fR does not match \f(CW%s\fR" 4 |
| 5003 |
.IX Item "Perl API version %s of %s does not match %s" |
| 5004 |
(F) The XS module in question was compiled against a different incompatible |
| 5005 |
version of Perl than the one that has loaded the XS module. |
| 5006 |
.IP "Perl folding rules are not up-to-date for 0x%X; please use the perlbug utility to report; in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5007 |
.IX Item "Perl folding rules are not up-to-date for 0x%X; please use the perlbug utility to report; in regex; marked by <--\ HERE in m/%s/" |
| 5008 |
(S regexp) You used a regular expression with case-insensitive matching, |
| 5009 |
and there is a bug in Perl in which the built-in regular expression |
| 5010 |
folding rules are not accurate. This may lead to incorrect results. |
| 5011 |
Please report this as a bug to <https://github.com/Perl/perl5/issues/new/choose>. |
| 5012 |
.IP "Perl_my_%s() not available" 4 |
| 5013 |
.IX Item "Perl_my_%s() not available" |
| 5014 |
(F) Your platform has very uncommon byte-order and integer size, |
| 5015 |
so it was not possible to set up some or all fixed-width byte-order |
| 5016 |
conversion functions. This is only a problem when you're using the |
| 5017 |
\&'<' or '>' modifiers in (un)pack templates. See "pack" in perlfunc. |
| 5018 |
.ie n .IP "Perl %s required (did you mean %s?)\-\-this is only %s, stopped" 4 |
| 5019 |
.el .IP "Perl \f(CW%s\fR required (did you mean \f(CW%s\fR?)\-\-this is only \f(CW%s\fR, stopped" 4 |
| 5020 |
.IX Item "Perl %s required (did you mean %s?)--this is only %s, stopped" |
| 5021 |
(F) The code you are trying to run has asked for a newer version of |
| 5022 |
Perl than you are running. Perhaps \f(CW\*(C`use 5.10\*(C'\fR was written instead |
| 5023 |
of \f(CW\*(C`use 5.010\*(C'\fR or \f(CW\*(C`use v5.10\*(C'\fR. Without the leading \f(CW\*(C`v\*(C'\fR, the number is |
| 5024 |
interpreted as a decimal, with every three digits after the |
| 5025 |
decimal point representing a part of the version number. So 5.10 |
| 5026 |
is equivalent to v5.100. |
| 5027 |
.ie n .IP "Perl %s required\-\-this is only %s, stopped" 4 |
| 5028 |
.el .IP "Perl \f(CW%s\fR required\-\-this is only \f(CW%s\fR, stopped" 4 |
| 5029 |
.IX Item "Perl %s required--this is only %s, stopped" |
| 5030 |
(F) The module in question uses features of a version of Perl more |
| 5031 |
recent than the currently running version. How long has it been since |
| 5032 |
you upgraded, anyway? See "require" in perlfunc. |
| 5033 |
.IP "PERL_SH_DIR too long" 4 |
| 5034 |
.IX Item "PERL_SH_DIR too long" |
| 5035 |
(F) An error peculiar to OS/2. PERL_SH_DIR is the directory to find the |
| 5036 |
\&\f(CW\*(C`sh\*(C'\fR\-shell in. See "PERL_SH_DIR" in perlos2. |
| 5037 |
.IP "PERL_SIGNALS illegal: ""%s""" 4 |
| 5038 |
.IX Item "PERL_SIGNALS illegal: ""%s""" |
| 5039 |
(X) See "PERL_SIGNALS" in perlrun for legal values. |
| 5040 |
.ie n .IP "Perls since %s too modern\-\-this is %s, stopped" 4 |
| 5041 |
.el .IP "Perls since \f(CW%s\fR too modern\-\-this is \f(CW%s\fR, stopped" 4 |
| 5042 |
.IX Item "Perls since %s too modern--this is %s, stopped" |
| 5043 |
(F) The code you are trying to run claims it will not run |
| 5044 |
on the version of Perl you are using because it is too new. |
| 5045 |
Maybe the code needs to be updated, or maybe it is simply |
| 5046 |
wrong and the version check should just be removed. |
| 5047 |
.IP "perl: warning: Non hex character in '$ENV{PERL_HASH_SEED}', seed only partially set" 4 |
| 5048 |
.IX Item "perl: warning: Non hex character in '$ENV{PERL_HASH_SEED}', seed only partially set" |
| 5049 |
(S) PERL_HASH_SEED should match /^\es*(?:0x)?[0\-9a\-fA\-F]+\es*\ez/ but it |
| 5050 |
contained a non hex character. This could mean you are not using the |
| 5051 |
hash seed you think you are. |
| 5052 |
.IP "perl: warning: Setting locale failed." 4 |
| 5053 |
.IX Item "perl: warning: Setting locale failed." |
| 5054 |
(S) The whole warning message will look something like: |
| 5055 |
.Sp |
| 5056 |
.Vb 6 |
| 5057 |
\& perl: warning: Setting locale failed. |
| 5058 |
\& perl: warning: Please check that your locale settings: |
| 5059 |
\& LC_ALL = "En_US", |
| 5060 |
\& LANG = (unset) |
| 5061 |
\& are supported and installed on your system. |
| 5062 |
\& perl: warning: Falling back to the standard locale ("C"). |
| 5063 |
.Ve |
| 5064 |
.Sp |
| 5065 |
Exactly what were the failed locale settings varies. In the above the |
| 5066 |
settings were that the LC_ALL was "En_US" and the LANG had no value. |
| 5067 |
This error means that Perl detected that you and/or your operating |
| 5068 |
system supplier and/or system administrator have set up the so-called |
| 5069 |
locale system but Perl could not use those settings. This was not |
| 5070 |
dead serious, fortunately: there is a "default locale" called "C" that |
| 5071 |
Perl can and will use, and the script will be run. Before you really |
| 5072 |
fix the problem, however, you will get the same error message each |
| 5073 |
time you run Perl. How to really fix the problem can be found in |
| 5074 |
perllocale section \fBLOCALE PROBLEMS\fR. |
| 5075 |
.IP "perl: warning: strange setting in '$ENV{PERL_PERTURB_KEYS}': '%s'" 4 |
| 5076 |
.IX Item "perl: warning: strange setting in '$ENV{PERL_PERTURB_KEYS}': '%s'" |
| 5077 |
(S) Perl was run with the environment variable PERL_PERTURB_KEYS defined |
| 5078 |
but containing an unexpected value. The legal values of this setting |
| 5079 |
are as follows. |
| 5080 |
.Sp |
| 5081 |
.Vb 6 |
| 5082 |
\& Numeric | String | Result |
| 5083 |
\& \-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- |
| 5084 |
\& 0 | NO | Disables key traversal randomization |
| 5085 |
\& 1 | RANDOM | Enables full key traversal randomization |
| 5086 |
\& 2 | DETERMINISTIC | Enables repeatable key traversal |
| 5087 |
\& | | randomization |
| 5088 |
.Ve |
| 5089 |
.Sp |
| 5090 |
Both numeric and string values are accepted, but note that string values are |
| 5091 |
case sensitive. The default for this setting is "RANDOM" or 1. |
| 5092 |
.ie n .IP "pid %x not a child" 4 |
| 5093 |
.el .IP "pid \f(CW%x\fR not a child" 4 |
| 5094 |
.IX Item "pid %x not a child" |
| 5095 |
(W exec) A warning peculiar to VMS. \fBWaitpid()\fR was asked to wait for a |
| 5096 |
process which isn't a subprocess of the current process. While this is |
| 5097 |
fine from VMS' perspective, it's probably not what you intended. |
| 5098 |
.IP "'P' must have an explicit size in unpack" 4 |
| 5099 |
.IX Item "'P' must have an explicit size in unpack" |
| 5100 |
(F) The unpack format P must have an explicit size, not "*". |
| 5101 |
.IP "POSIX class [:%s:] unknown in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5102 |
.IX Item "POSIX class [:%s:] unknown in regex; marked by <--\ HERE in m/%s/" |
| 5103 |
(F) The class in the character class [: :] syntax is unknown. The <\-\-\ HERE |
| 5104 |
shows whereabouts in the regular expression the problem was discovered. |
| 5105 |
Note that the POSIX character classes do \fBnot\fR have the \f(CW\*(C`is\*(C'\fR prefix |
| 5106 |
the corresponding C interfaces have: in other words, it's \f(CW\*(C`[[:print:]]\*(C'\fR, |
| 5107 |
not \f(CW\*(C`isprint\*(C'\fR. See perlre. |
| 5108 |
.IP "POSIX getpgrp can't take an argument" 4 |
| 5109 |
.IX Item "POSIX getpgrp can't take an argument" |
| 5110 |
(F) Your system has POSIX \fBgetpgrp()\fR, which takes no argument, unlike |
| 5111 |
the BSD version, which takes a pid. |
| 5112 |
.ie n .IP "POSIX syntax [%c %c] belongs inside character classes%s in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5113 |
.el .IP "POSIX syntax [%c \f(CW%c\fR] belongs inside character classes%s in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5114 |
.IX Item "POSIX syntax [%c %c] belongs inside character classes%s in regex; marked by <--\ HERE in m/%s/" |
| 5115 |
(W regexp) Perl thinks that you intended to write a POSIX character |
| 5116 |
class, but didn't use enough brackets. These POSIX class constructs [: |
| 5117 |
:], [= =], and [. .] go \fIinside\fR character classes, the [] are part of |
| 5118 |
the construct, for example: \f(CW\*(C`qr/[012[:alpha:]345]/\*(C'\fR. What the regular |
| 5119 |
expression pattern compiled to is probably not what you were intending. |
| 5120 |
For example, \f(CW\*(C`qr/[:alpha:]/\*(C'\fR compiles to a regular bracketed character |
| 5121 |
class consisting of the four characters \f(CW":"\fR, \f(CW"a"\fR, \f(CW"l"\fR, |
| 5122 |
\&\f(CW"h"\fR, and \f(CW"p"\fR. To specify the POSIX class, it should have been |
| 5123 |
written \f(CW\*(C`qr/[[:alpha:]]/\*(C'\fR. |
| 5124 |
.Sp |
| 5125 |
Note that [= =] and [. .] are not currently |
| 5126 |
implemented; they are simply placeholders for future extensions and |
| 5127 |
will cause fatal errors. The <\-\-\ HERE shows whereabouts in the regular |
| 5128 |
expression the problem was discovered. See perlre. |
| 5129 |
.Sp |
| 5130 |
If the specification of the class was not completely valid, the message |
| 5131 |
indicates that. |
| 5132 |
.IP "POSIX syntax [. .] is reserved for future extensions in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5133 |
.IX Item "POSIX syntax [. .] is reserved for future extensions in regex; marked by <--\ HERE in m/%s/" |
| 5134 |
(F) Within regular expression character classes ([]) the syntax beginning |
| 5135 |
with "[." and ending with ".]" is reserved for future extensions. If you |
| 5136 |
need to represent those character sequences inside a regular expression |
| 5137 |
character class, just quote the square brackets with the backslash: "\e[." |
| 5138 |
and ".\e]". The <\-\-\ HERE shows whereabouts in the regular expression the |
| 5139 |
problem was discovered. See perlre. |
| 5140 |
.IP "POSIX syntax [= =] is reserved for future extensions in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5141 |
.IX Item "POSIX syntax [= =] is reserved for future extensions in regex; marked by <--\ HERE in m/%s/" |
| 5142 |
(F) Within regular expression character classes ([]) the syntax beginning |
| 5143 |
with "[=" and ending with "=]" is reserved for future extensions. If you |
| 5144 |
need to represent those character sequences inside a regular expression |
| 5145 |
character class, just quote the square brackets with the backslash: "\e[=" |
| 5146 |
and "=\e]". The <\-\-\ HERE shows whereabouts in the regular expression the |
| 5147 |
problem was discovered. See perlre. |
| 5148 |
.IP "Possible attempt to put comments in \fBqw()\fR list" 4 |
| 5149 |
.IX Item "Possible attempt to put comments in qw() list" |
| 5150 |
(W qw) \fBqw()\fR lists contain items separated by whitespace; as with literal |
| 5151 |
strings, comment characters are not ignored, but are instead treated as |
| 5152 |
literal data. (You may have used different delimiters than the |
| 5153 |
parentheses shown here; braces are also frequently used.) |
| 5154 |
.Sp |
| 5155 |
You probably wrote something like this: |
| 5156 |
.Sp |
| 5157 |
.Vb 4 |
| 5158 |
\& @list = qw( |
| 5159 |
\& a # a comment |
| 5160 |
\& b # another comment |
| 5161 |
\& ); |
| 5162 |
.Ve |
| 5163 |
.Sp |
| 5164 |
when you should have written this: |
| 5165 |
.Sp |
| 5166 |
.Vb 4 |
| 5167 |
\& @list = qw( |
| 5168 |
\& a |
| 5169 |
\& b |
| 5170 |
\& ); |
| 5171 |
.Ve |
| 5172 |
.Sp |
| 5173 |
If you really want comments, build your list the |
| 5174 |
old-fashioned way, with quotes and commas: |
| 5175 |
.Sp |
| 5176 |
.Vb 4 |
| 5177 |
\& @list = ( |
| 5178 |
\& \*(Aqa\*(Aq, # a comment |
| 5179 |
\& \*(Aqb\*(Aq, # another comment |
| 5180 |
\& ); |
| 5181 |
.Ve |
| 5182 |
.IP "Possible attempt to separate words with commas" 4 |
| 5183 |
.IX Item "Possible attempt to separate words with commas" |
| 5184 |
(W qw) \fBqw()\fR lists contain items separated by whitespace; therefore |
| 5185 |
commas aren't needed to separate the items. (You may have used |
| 5186 |
different delimiters than the parentheses shown here; braces are also |
| 5187 |
frequently used.) |
| 5188 |
.Sp |
| 5189 |
You probably wrote something like this: |
| 5190 |
.Sp |
| 5191 |
.Vb 1 |
| 5192 |
\& qw! a, b, c !; |
| 5193 |
.Ve |
| 5194 |
.Sp |
| 5195 |
which puts literal commas into some of the list items. Write it without |
| 5196 |
commas if you don't want them to appear in your data: |
| 5197 |
.Sp |
| 5198 |
.Vb 1 |
| 5199 |
\& qw! a b c !; |
| 5200 |
.Ve |
| 5201 |
.ie n .IP "Possible memory corruption: %s overflowed 3rd argument" 4 |
| 5202 |
.el .IP "Possible memory corruption: \f(CW%s\fR overflowed 3rd argument" 4 |
| 5203 |
.IX Item "Possible memory corruption: %s overflowed 3rd argument" |
| 5204 |
(F) An \fBioctl()\fR or \fBfcntl()\fR returned more than Perl was bargaining for. |
| 5205 |
Perl guesses a reasonable buffer size, but puts a sentinel byte at the |
| 5206 |
end of the buffer just in case. This sentinel byte got clobbered, and |
| 5207 |
Perl assumes that memory is now corrupted. See "ioctl" in perlfunc. |
| 5208 |
.IP "Possible precedence issue with control flow operator (%s)" 4 |
| 5209 |
.IX Item "Possible precedence issue with control flow operator (%s)" |
| 5210 |
(W syntax) There is a possible problem with the mixing of a control |
| 5211 |
flow operator (e.g. \f(CW\*(C`return\*(C'\fR) and a low-precedence operator like |
| 5212 |
\&\f(CW\*(C`or\*(C'\fR. Consider: |
| 5213 |
.Sp |
| 5214 |
.Vb 1 |
| 5215 |
\& sub { return $x or $y; } |
| 5216 |
.Ve |
| 5217 |
.Sp |
| 5218 |
This is parsed as: |
| 5219 |
.Sp |
| 5220 |
.Vb 1 |
| 5221 |
\& sub { (return $x) or $y; } |
| 5222 |
.Ve |
| 5223 |
.Sp |
| 5224 |
Which is effectively just: |
| 5225 |
.Sp |
| 5226 |
.Vb 1 |
| 5227 |
\& sub { return $x; } |
| 5228 |
.Ve |
| 5229 |
.Sp |
| 5230 |
Either use parentheses or the high-precedence variant of the operator. |
| 5231 |
.Sp |
| 5232 |
Note this may be also triggered for constructs like: |
| 5233 |
.Sp |
| 5234 |
.Vb 1 |
| 5235 |
\& sub { 1 if die; } |
| 5236 |
.Ve |
| 5237 |
.ie n .IP "Possible precedence problem on bitwise %s operator" 4 |
| 5238 |
.el .IP "Possible precedence problem on bitwise \f(CW%s\fR operator" 4 |
| 5239 |
.IX Item "Possible precedence problem on bitwise %s operator" |
| 5240 |
(W precedence) Your program uses a bitwise logical operator in conjunction |
| 5241 |
with a numeric comparison operator, like this : |
| 5242 |
.Sp |
| 5243 |
.Vb 1 |
| 5244 |
\& if ($x & $y == 0) { ... } |
| 5245 |
.Ve |
| 5246 |
.Sp |
| 5247 |
This expression is actually equivalent to \f(CW\*(C`$x & ($y == 0)\*(C'\fR, due to the |
| 5248 |
higher precedence of \f(CW\*(C`==\*(C'\fR. This is probably not what you want. (If you |
| 5249 |
really meant to write this, disable the warning, or, better, put the |
| 5250 |
parentheses explicitly and write \f(CW\*(C`$x & ($y == 0)\*(C'\fR). |
| 5251 |
.IP "Possible unintended interpolation of $\e in regex" 4 |
| 5252 |
.IX Item "Possible unintended interpolation of $ in regex" |
| 5253 |
(W ambiguous) You said something like \f(CW\*(C`m/$\e/\*(C'\fR in a regex. |
| 5254 |
The regex \f(CW\*(C`m/foo$\es+bar/m\*(C'\fR translates to: match the word 'foo', the output |
| 5255 |
record separator (see "$\e" in perlvar) and the letter 's' (one time or more) |
| 5256 |
followed by the word 'bar'. |
| 5257 |
.Sp |
| 5258 |
If this is what you intended then you can silence the warning by using |
| 5259 |
\&\f(CW\*(C`m/${\e}/\*(C'\fR (for example: \f(CW\*(C`m/foo${\e}s+bar/\*(C'\fR). |
| 5260 |
.Sp |
| 5261 |
If instead you intended to match the word 'foo' at the end of the line |
| 5262 |
followed by whitespace and the word 'bar' on the next line then you can use |
| 5263 |
\&\f(CW\*(C`m/$(?)\e/\*(C'\fR (for example: \f(CW\*(C`m/foo$(?)\es+bar/\*(C'\fR). |
| 5264 |
.ie n .IP "Possible unintended interpolation of %s in string" 4 |
| 5265 |
.el .IP "Possible unintended interpolation of \f(CW%s\fR in string" 4 |
| 5266 |
.IX Item "Possible unintended interpolation of %s in string" |
| 5267 |
(W ambiguous) You said something like '@foo' in a double-quoted string |
| 5268 |
but there was no array \f(CW@foo\fR in scope at the time. If you wanted a |
| 5269 |
literal \f(CW@foo\fR, then write it as \e@foo; otherwise find out what happened |
| 5270 |
to the array you apparently lost track of. |
| 5271 |
.ie n .IP "Precedence problem: open %s should be open(%s)" 4 |
| 5272 |
.el .IP "Precedence problem: open \f(CW%s\fR should be open(%s)" 4 |
| 5273 |
.IX Item "Precedence problem: open %s should be open(%s)" |
| 5274 |
(S precedence) The old irregular construct |
| 5275 |
.Sp |
| 5276 |
.Vb 1 |
| 5277 |
\& open FOO || die; |
| 5278 |
.Ve |
| 5279 |
.Sp |
| 5280 |
is now misinterpreted as |
| 5281 |
.Sp |
| 5282 |
.Vb 1 |
| 5283 |
\& open(FOO || die); |
| 5284 |
.Ve |
| 5285 |
.Sp |
| 5286 |
because of the strict regularization of Perl 5's grammar into unary and |
| 5287 |
list operators. (The old open was a little of both.) You must put |
| 5288 |
parentheses around the filehandle, or use the new "or" operator instead |
| 5289 |
of "||". |
| 5290 |
.IP "Premature end of script headers" 4 |
| 5291 |
.IX Item "Premature end of script headers" |
| 5292 |
See "500 Server error". |
| 5293 |
.ie n .IP "\fBprintf()\fR on closed filehandle %s" 4 |
| 5294 |
.el .IP "\fBprintf()\fR on closed filehandle \f(CW%s\fR" 4 |
| 5295 |
.IX Item "printf() on closed filehandle %s" |
| 5296 |
(W closed) The filehandle you're writing to got itself closed sometime |
| 5297 |
before now. Check your control flow. |
| 5298 |
.ie n .IP "\fBprint()\fR on closed filehandle %s" 4 |
| 5299 |
.el .IP "\fBprint()\fR on closed filehandle \f(CW%s\fR" 4 |
| 5300 |
.IX Item "print() on closed filehandle %s" |
| 5301 |
(W closed) The filehandle you're printing on got itself closed sometime |
| 5302 |
before now. Check your control flow. |
| 5303 |
.IP "Process terminated by SIG%s" 4 |
| 5304 |
.IX Item "Process terminated by SIG%s" |
| 5305 |
(W) This is a standard message issued by OS/2 applications, while *nix |
| 5306 |
applications die in silence. It is considered a feature of the OS/2 |
| 5307 |
port. One can easily disable this by appropriate sighandlers, see |
| 5308 |
"Signals" in perlipc. See also "Process terminated by SIGTERM/SIGINT" |
| 5309 |
in perlos2. |
| 5310 |
.ie n .IP "Prototype after '%c' for %s : %s" 4 |
| 5311 |
.el .IP "Prototype after '%c' for \f(CW%s\fR : \f(CW%s\fR" 4 |
| 5312 |
.IX Item "Prototype after '%c' for %s : %s" |
| 5313 |
(W illegalproto) A character follows % or @ in a prototype. This is |
| 5314 |
useless, since % and @ gobble the rest of the subroutine arguments. |
| 5315 |
.ie n .IP "Prototype mismatch: %s vs %s" 4 |
| 5316 |
.el .IP "Prototype mismatch: \f(CW%s\fR vs \f(CW%s\fR" 4 |
| 5317 |
.IX Item "Prototype mismatch: %s vs %s" |
| 5318 |
(S prototype) The subroutine being declared or defined had previously been |
| 5319 |
declared or defined with a different function prototype. |
| 5320 |
.IP "Prototype not terminated" 4 |
| 5321 |
.IX Item "Prototype not terminated" |
| 5322 |
(F) You've omitted the closing parenthesis in a function prototype |
| 5323 |
definition. |
| 5324 |
.ie n .IP "Prototype '%s' overridden by attribute 'prototype(%s)' in %s" 4 |
| 5325 |
.el .IP "Prototype '%s' overridden by attribute 'prototype(%s)' in \f(CW%s\fR" 4 |
| 5326 |
.IX Item "Prototype '%s' overridden by attribute 'prototype(%s)' in %s" |
| 5327 |
(W prototype) A prototype was declared in both the parentheses after |
| 5328 |
the sub name and via the prototype attribute. The prototype in |
| 5329 |
parentheses is useless, since it will be replaced by the prototype |
| 5330 |
from the attribute before it's ever used. |
| 5331 |
.ie n .IP "%s on BEGIN block ignored" 4 |
| 5332 |
.el .IP "\f(CW%s\fR on BEGIN block ignored" 4 |
| 5333 |
.IX Item "%s on BEGIN block ignored" |
| 5334 |
(W syntax) \f(CW\*(C`BEGIN\*(C'\fR blocks are executed immediately after they are parsed |
| 5335 |
and then thrown away. Any prototypes or attributes are therefore |
| 5336 |
meaningless and are ignored. You should remove them from the \f(CW\*(C`BEGIN\*(C'\fR block. |
| 5337 |
Note this also means you cannot create a constant called \f(CW\*(C`BEGIN\*(C'\fR. |
| 5338 |
.IP "Quantifier follows nothing in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5339 |
.IX Item "Quantifier follows nothing in regex; marked by <--\ HERE in m/%s/" |
| 5340 |
(F) You started a regular expression with a quantifier. Backslash it if |
| 5341 |
you meant it literally. The <\-\-\ HERE shows whereabouts in the regular |
| 5342 |
expression the problem was discovered. See perlre. |
| 5343 |
.ie n .IP "Quantifier in {,} bigger than %d in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5344 |
.el .IP "Quantifier in {,} bigger than \f(CW%d\fR in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5345 |
.IX Item "Quantifier in {,} bigger than %d in regex; marked by <--\ HERE in m/%s/" |
| 5346 |
(F) There is currently a limit to the size of the min and max values of |
| 5347 |
the {min,max} construct. The <\-\-\ HERE shows whereabouts in the regular |
| 5348 |
expression the problem was discovered. See perlre. |
| 5349 |
.IP "Quantifier {n,m} with n > m can't match in regex" 4 |
| 5350 |
.IX Item "Quantifier {n,m} with n > m can't match in regex" |
| 5351 |
.PD 0 |
| 5352 |
.IP "Quantifier {n,m} with n > m can't match in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5353 |
.IX Item "Quantifier {n,m} with n > m can't match in regex; marked by <--\ HERE in m/%s/" |
| 5354 |
.PD |
| 5355 |
(W regexp) Minima should be less than or equal to maxima. If you really |
| 5356 |
want your regexp to match something 0 times, just put {0}. |
| 5357 |
.IP "Quantifier unexpected on zero-length expression in regex m/%s/" 4 |
| 5358 |
.IX Item "Quantifier unexpected on zero-length expression in regex m/%s/" |
| 5359 |
(W regexp) You applied a regular expression quantifier in a place where |
| 5360 |
it makes no sense, such as on a zero-width assertion. Try putting the |
| 5361 |
quantifier inside the assertion instead. For example, the way to match |
| 5362 |
"abc" provided that it is followed by three repetitions of "xyz" is |
| 5363 |
\&\f(CW\*(C`/abc(?=(?:xyz){3})/\*(C'\fR, not \f(CW\*(C`/abc(?=xyz){3}/\*(C'\fR. |
| 5364 |
.IP "Range iterator outside integer range" 4 |
| 5365 |
.IX Item "Range iterator outside integer range" |
| 5366 |
(F) One (or both) of the numeric arguments to the range operator ".." |
| 5367 |
are outside the range which can be represented by integers internally. |
| 5368 |
One possible workaround is to force Perl to use magical string increment |
| 5369 |
by prepending "0" to your numbers. |
| 5370 |
.IP "Ranges of ASCII printables should be some subset of ""0\-9"", ""A\-Z"", or ""a\-z"" in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5371 |
.IX Item "Ranges of ASCII printables should be some subset of ""0-9"", ""A-Z"", or ""a-z"" in regex; marked by <--\ HERE in m/%s/" |
| 5372 |
(W regexp) (only under \f(CW\*(C`use\ re\ \*(Aqstrict\*(Aq\*(C'\fR or within \f(CW\*(C`(?[...])\*(C'\fR) |
| 5373 |
.Sp |
| 5374 |
Stricter rules help to find typos and other errors. Perhaps you didn't |
| 5375 |
even intend a range here, if the \f(CW"\-"\fR was meant to be some other |
| 5376 |
character, or should have been escaped (like \f(CW"\e\-"\fR). If you did |
| 5377 |
intend a range, the one that was used is not portable between ASCII and |
| 5378 |
EBCDIC platforms, and doesn't have an obvious meaning to a casual |
| 5379 |
reader. |
| 5380 |
.Sp |
| 5381 |
.Vb 7 |
| 5382 |
\& [3\-7] # OK; Obvious and portable |
| 5383 |
\& [d\-g] # OK; Obvious and portable |
| 5384 |
\& [A\-Y] # OK; Obvious and portable |
| 5385 |
\& [A\-z] # WRONG; Not portable; not clear what is meant |
| 5386 |
\& [a\-Z] # WRONG; Not portable; not clear what is meant |
| 5387 |
\& [%\-.] # WRONG; Not portable; not clear what is meant |
| 5388 |
\& [\ex41\-Z] # WRONG; Not portable; not obvious to non\-geek |
| 5389 |
.Ve |
| 5390 |
.Sp |
| 5391 |
(You can force portability by specifying a Unicode range, which means that |
| 5392 |
the endpoints are specified by |
| 5393 |
\&\f(CW\*(C`\eN{...}\*(C'\fR, but the meaning may |
| 5394 |
still not be obvious.) |
| 5395 |
The stricter rules require that ranges that start or stop with an ASCII |
| 5396 |
character that is not a control have all their endpoints be the literal |
| 5397 |
character, and not some escape sequence (like \f(CW"\ex41"\fR), and the ranges |
| 5398 |
must be all digits, or all uppercase letters, or all lowercase letters. |
| 5399 |
.IP "Ranges of digits should be from the same group in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5400 |
.IX Item "Ranges of digits should be from the same group in regex; marked by <--\ HERE in m/%s/" |
| 5401 |
(W regexp) (only under \f(CW\*(C`use\ re\ \*(Aqstrict\*(Aq\*(C'\fR or within \f(CW\*(C`(?[...])\*(C'\fR) |
| 5402 |
.Sp |
| 5403 |
Stricter rules help to find typos and other errors. You included a |
| 5404 |
range, and at least one of the end points is a decimal digit. Under the |
| 5405 |
stricter rules, when this happens, both end points should be digits in |
| 5406 |
the same group of 10 consecutive digits. |
| 5407 |
.ie n .IP "\fBreaddir()\fR attempted on invalid dirhandle %s" 4 |
| 5408 |
.el .IP "\fBreaddir()\fR attempted on invalid dirhandle \f(CW%s\fR" 4 |
| 5409 |
.IX Item "readdir() attempted on invalid dirhandle %s" |
| 5410 |
(W io) The dirhandle you're reading from is either closed or not really |
| 5411 |
a dirhandle. Check your control flow. |
| 5412 |
.ie n .IP "\fBreadline()\fR on closed filehandle %s" 4 |
| 5413 |
.el .IP "\fBreadline()\fR on closed filehandle \f(CW%s\fR" 4 |
| 5414 |
.IX Item "readline() on closed filehandle %s" |
| 5415 |
(W closed) The filehandle you're reading from got itself closed sometime |
| 5416 |
before now. Check your control flow. |
| 5417 |
.ie n .IP "\fBreadline()\fR on unopened filehandle %s" 4 |
| 5418 |
.el .IP "\fBreadline()\fR on unopened filehandle \f(CW%s\fR" 4 |
| 5419 |
.IX Item "readline() on unopened filehandle %s" |
| 5420 |
(W unopened) The filehandle you're reading from was never opened. Check your |
| 5421 |
control flow. |
| 5422 |
.ie n .IP "\fBread()\fR on closed filehandle %s" 4 |
| 5423 |
.el .IP "\fBread()\fR on closed filehandle \f(CW%s\fR" 4 |
| 5424 |
.IX Item "read() on closed filehandle %s" |
| 5425 |
(W closed) You tried to read from a closed filehandle. |
| 5426 |
.ie n .IP "\fBread()\fR on unopened filehandle %s" 4 |
| 5427 |
.el .IP "\fBread()\fR on unopened filehandle \f(CW%s\fR" 4 |
| 5428 |
.IX Item "read() on unopened filehandle %s" |
| 5429 |
(W unopened) You tried to read from a filehandle that was never opened. |
| 5430 |
.IP "\fBrealloc()\fR of freed memory ignored" 4 |
| 5431 |
.IX Item "realloc() of freed memory ignored" |
| 5432 |
(S malloc) An internal routine called \fBrealloc()\fR on something that had |
| 5433 |
already been freed. |
| 5434 |
.IP "Recompile perl with \fB\-D\fRDEBUGGING to use \fB\-D\fR switch" 4 |
| 5435 |
.IX Item "Recompile perl with -DDEBUGGING to use -D switch" |
| 5436 |
(S debugging) You can't use the \fB\-D\fR option unless the code to produce |
| 5437 |
the desired output is compiled into Perl, which entails some overhead, |
| 5438 |
which is why it's currently left out of your copy. |
| 5439 |
.IP "Recursive call to Perl_load_module in PerlIO_find_layer" 4 |
| 5440 |
.IX Item "Recursive call to Perl_load_module in PerlIO_find_layer" |
| 5441 |
(P) It is currently not permitted to load modules when creating |
| 5442 |
a filehandle inside an \f(CW%INC\fR hook. This can happen with \f(CW\*(C`open my |
| 5443 |
$fh, \*(Aq<\*(Aq, \e$scalar\*(C'\fR, which implicitly loads PerlIO::scalar. Try |
| 5444 |
loading PerlIO::scalar explicitly first. |
| 5445 |
.IP "Recursive inheritance detected in package '%s'" 4 |
| 5446 |
.IX Item "Recursive inheritance detected in package '%s'" |
| 5447 |
(F) While calculating the method resolution order (MRO) of a package, Perl |
| 5448 |
believes it found an infinite loop in the \f(CW@ISA\fR hierarchy. This is a |
| 5449 |
crude check that bails out after 100 levels of \f(CW@ISA\fR depth. |
| 5450 |
.ie n .IP "Redundant argument in %s" 4 |
| 5451 |
.el .IP "Redundant argument in \f(CW%s\fR" 4 |
| 5452 |
.IX Item "Redundant argument in %s" |
| 5453 |
(W redundant) You called a function with more arguments than other |
| 5454 |
arguments you supplied indicated would be needed. Currently only |
| 5455 |
emitted when a printf-type format required fewer arguments than were |
| 5456 |
supplied, but might be used in the future for e.g. "pack" in perlfunc. |
| 5457 |
.ie n .IP "refcnt_dec: fd %d%s" 4 |
| 5458 |
.el .IP "refcnt_dec: fd \f(CW%d\fR%s" 4 |
| 5459 |
.IX Item "refcnt_dec: fd %d%s" |
| 5460 |
.PD 0 |
| 5461 |
.ie n .IP "refcnt: fd %d%s" 4 |
| 5462 |
.el .IP "refcnt: fd \f(CW%d\fR%s" 4 |
| 5463 |
.IX Item "refcnt: fd %d%s" |
| 5464 |
.ie n .IP "refcnt_inc: fd %d%s" 4 |
| 5465 |
.el .IP "refcnt_inc: fd \f(CW%d\fR%s" 4 |
| 5466 |
.IX Item "refcnt_inc: fd %d%s" |
| 5467 |
.PD |
| 5468 |
(P) Perl's I/O implementation failed an internal consistency check. If |
| 5469 |
you see this message, something is very wrong. |
| 5470 |
.IP "Reference found where even-sized list expected" 4 |
| 5471 |
.IX Item "Reference found where even-sized list expected" |
| 5472 |
(W misc) You gave a single reference where Perl was expecting a list |
| 5473 |
with an even number of elements (for assignment to a hash). This |
| 5474 |
usually means that you used the anon hash constructor when you meant |
| 5475 |
to use parens. In any case, a hash requires key/value \fBpairs\fR. |
| 5476 |
.Sp |
| 5477 |
.Vb 4 |
| 5478 |
\& %hash = { one => 1, two => 2, }; # WRONG |
| 5479 |
\& %hash = [ qw/ an anon array / ]; # WRONG |
| 5480 |
\& %hash = ( one => 1, two => 2, ); # right |
| 5481 |
\& %hash = qw( one 1 two 2 ); # also fine |
| 5482 |
.Ve |
| 5483 |
.IP "Reference is already weak" 4 |
| 5484 |
.IX Item "Reference is already weak" |
| 5485 |
(W misc) You have attempted to weaken a reference that is already weak. |
| 5486 |
Doing so has no effect. |
| 5487 |
.IP "Reference is not weak" 4 |
| 5488 |
.IX Item "Reference is not weak" |
| 5489 |
(W misc) You have attempted to unweaken a reference that is not weak. |
| 5490 |
Doing so has no effect. |
| 5491 |
.IP "Reference to invalid group 0 in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5492 |
.IX Item "Reference to invalid group 0 in regex; marked by <--\ HERE in m/%s/" |
| 5493 |
(F) You used \f(CW\*(C`\eg0\*(C'\fR or similar in a regular expression. You may refer |
| 5494 |
to capturing parentheses only with strictly positive integers |
| 5495 |
(normal backreferences) or with strictly negative integers (relative |
| 5496 |
backreferences). Using 0 does not make sense. |
| 5497 |
.IP "Reference to nonexistent group in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5498 |
.IX Item "Reference to nonexistent group in regex; marked by <--\ HERE in m/%s/" |
| 5499 |
(F) You used something like \f(CW\*(C`\e7\*(C'\fR in your regular expression, but there are |
| 5500 |
not at least seven sets of capturing parentheses in the expression. If |
| 5501 |
you wanted to have the character with ordinal 7 inserted into the regular |
| 5502 |
expression, prepend zeroes to make it three digits long: \f(CW\*(C`\e007\*(C'\fR |
| 5503 |
.Sp |
| 5504 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 5505 |
discovered. |
| 5506 |
.IP "Reference to nonexistent named group in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5507 |
.IX Item "Reference to nonexistent named group in regex; marked by <--\ HERE in m/%s/" |
| 5508 |
(F) You used something like \f(CW\*(C`\ek\*(AqNAME\*(Aq\*(C'\fR or \f(CW\*(C`\ek<NAME>\*(C'\fR in your regular |
| 5509 |
expression, but there is no corresponding named capturing parentheses |
| 5510 |
such as \f(CW\*(C`(?\*(AqNAME\*(Aq...)\*(C'\fR or \f(CW\*(C`(?<NAME>...)\*(C'\fR. Check if the name has been |
| 5511 |
spelled correctly both in the backreference and the declaration. |
| 5512 |
.Sp |
| 5513 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 5514 |
discovered. |
| 5515 |
.IP "Reference to nonexistent or unclosed group in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5516 |
.IX Item "Reference to nonexistent or unclosed group in regex; marked by <--\ HERE in m/%s/" |
| 5517 |
(F) You used something like \f(CW\*(C`\eg{\-7}\*(C'\fR in your regular expression, but there |
| 5518 |
are not at least seven sets of closed capturing parentheses in the |
| 5519 |
expression before where the \f(CW\*(C`\eg{\-7}\*(C'\fR was located. |
| 5520 |
.Sp |
| 5521 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 5522 |
discovered. |
| 5523 |
.IP "regexp memory corruption" 4 |
| 5524 |
.IX Item "regexp memory corruption" |
| 5525 |
(P) The regular expression engine got confused by what the regular |
| 5526 |
expression compiler gave it. |
| 5527 |
.IP "Regexp modifier ""/%c"" may appear a maximum of twice" 4 |
| 5528 |
.IX Item "Regexp modifier ""/%c"" may appear a maximum of twice" |
| 5529 |
.PD 0 |
| 5530 |
.IP "Regexp modifier ""%c"" may appear a maximum of twice in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5531 |
.IX Item "Regexp modifier ""%c"" may appear a maximum of twice in regex; marked by <--\ HERE in m/%s/" |
| 5532 |
.PD |
| 5533 |
(F) The regular expression pattern had too many occurrences |
| 5534 |
of the specified modifier. Remove the extraneous ones. |
| 5535 |
.IP "Regexp modifier ""%c"" may not appear after the ""\-"" in regex; marked by <\-\- HERE in m/%s/" 4 |
| 5536 |
.IX Item "Regexp modifier ""%c"" may not appear after the ""-"" in regex; marked by <-- HERE in m/%s/" |
| 5537 |
(F) Turning off the given modifier has the side effect of turning on |
| 5538 |
another one. Perl currently doesn't allow this. Reword the regular |
| 5539 |
expression to use the modifier you want to turn on (and place it before |
| 5540 |
the minus), instead of the one you want to turn off. |
| 5541 |
.IP "Regexp modifier ""/%c"" may not appear twice" 4 |
| 5542 |
.IX Item "Regexp modifier ""/%c"" may not appear twice" |
| 5543 |
.PD 0 |
| 5544 |
.IP "Regexp modifier ""%c"" may not appear twice in regex; marked by <\-\- HERE in m/%s/" 4 |
| 5545 |
.IX Item "Regexp modifier ""%c"" may not appear twice in regex; marked by <-- HERE in m/%s/" |
| 5546 |
.PD |
| 5547 |
(F) The regular expression pattern had too many occurrences |
| 5548 |
of the specified modifier. Remove the extraneous ones. |
| 5549 |
.IP "Regexp modifiers ""/%c"" and ""/%c"" are mutually exclusive" 4 |
| 5550 |
.IX Item "Regexp modifiers ""/%c"" and ""/%c"" are mutually exclusive" |
| 5551 |
.PD 0 |
| 5552 |
.IP "Regexp modifiers ""%c"" and ""%c"" are mutually exclusive in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5553 |
.IX Item "Regexp modifiers ""%c"" and ""%c"" are mutually exclusive in regex; marked by <--\ HERE in m/%s/" |
| 5554 |
.PD |
| 5555 |
(F) The regular expression pattern had more than one of these |
| 5556 |
mutually exclusive modifiers. Retain only the modifier that is |
| 5557 |
supposed to be there. |
| 5558 |
.IP "Regexp out of space in regex m/%s/" 4 |
| 5559 |
.IX Item "Regexp out of space in regex m/%s/" |
| 5560 |
(P) A "can't happen" error, because \fBsafemalloc()\fR should have caught it |
| 5561 |
earlier. |
| 5562 |
.IP "Repeated format line will never terminate (~~ and @#)" 4 |
| 5563 |
.IX Item "Repeated format line will never terminate (~~ and @#)" |
| 5564 |
(F) Your format contains the ~~ repeat-until-blank sequence and a |
| 5565 |
numeric field that will never go blank so that the repetition never |
| 5566 |
terminates. You might use ^# instead. See perlform. |
| 5567 |
.IP "Replacement list is longer than search list" 4 |
| 5568 |
.IX Item "Replacement list is longer than search list" |
| 5569 |
(W misc) You have used a replacement list that is longer than the |
| 5570 |
search list. So the additional elements in the replacement list |
| 5571 |
are meaningless. |
| 5572 |
.ie n .IP "Required parameter '%s' is missing for %s constructor" 4 |
| 5573 |
.el .IP "Required parameter '%s' is missing for \f(CW%s\fR constructor" 4 |
| 5574 |
.IX Item "Required parameter '%s' is missing for %s constructor" |
| 5575 |
(F) You called the constructor for a class that has a required named |
| 5576 |
parameter, but did not pass that parameter at all. |
| 5577 |
.IP "'(*%s' requires a terminating ':' in regex; marked by <\-\- HERE in m/%s/" 4 |
| 5578 |
.IX Item "'(*%s' requires a terminating ':' in regex; marked by <-- HERE in m/%s/" |
| 5579 |
(F) You used a construct that needs a colon and pattern argument. |
| 5580 |
Supply these or check that you are using the right construct. |
| 5581 |
.IP "'%s' resolved to '\eo{%s}%d'" 4 |
| 5582 |
.IX Item "'%s' resolved to 'o{%s}%d'" |
| 5583 |
As of Perl 5.32, this message is no longer generated. Instead, see |
| 5584 |
"Non-octal character '%c' terminates \eo early. Resolved as "%s"". |
| 5585 |
(W misc, regexp) You wrote something like \f(CW\*(C`\e08\*(C'\fR, or \f(CW\*(C`\e179\*(C'\fR in a |
| 5586 |
double-quotish string. All but the last digit is treated as a single |
| 5587 |
character, specified in octal. The last digit is the next character in |
| 5588 |
the string. To tell Perl that this is indeed what you want, you can use |
| 5589 |
the \f(CW\*(C`\eo{ }\*(C'\fR syntax, or use exactly three digits to specify the octal |
| 5590 |
for the character. |
| 5591 |
.ie n .IP "Reversed %s= operator" 4 |
| 5592 |
.el .IP "Reversed \f(CW%s\fR= operator" 4 |
| 5593 |
.IX Item "Reversed %s= operator" |
| 5594 |
(W syntax) You wrote your assignment operator backwards. The = must |
| 5595 |
always come last, to avoid ambiguity with subsequent unary operators. |
| 5596 |
.ie n .IP "\fBrewinddir()\fR attempted on invalid dirhandle %s" 4 |
| 5597 |
.el .IP "\fBrewinddir()\fR attempted on invalid dirhandle \f(CW%s\fR" 4 |
| 5598 |
.IX Item "rewinddir() attempted on invalid dirhandle %s" |
| 5599 |
(W io) The dirhandle you tried to do a \fBrewinddir()\fR on is either closed |
| 5600 |
or not really a dirhandle. Check your control flow. |
| 5601 |
.ie n .IP "Scalars leaked: %d" 4 |
| 5602 |
.el .IP "Scalars leaked: \f(CW%d\fR" 4 |
| 5603 |
.IX Item "Scalars leaked: %d" |
| 5604 |
(S internal) Something went wrong in Perl's internal bookkeeping |
| 5605 |
of scalars: not all scalar variables were deallocated by the time |
| 5606 |
Perl exited. What this usually indicates is a memory leak, which |
| 5607 |
is of course bad, especially if the Perl program is intended to be |
| 5608 |
long-running. |
| 5609 |
.IP "Scalar value @%s[%s] better written as $%s[%s]" 4 |
| 5610 |
.IX Item "Scalar value @%s[%s] better written as $%s[%s]" |
| 5611 |
(W syntax) You've used an array slice (indicated by @) to select a |
| 5612 |
single element of an array. Generally it's better to ask for a scalar |
| 5613 |
value (indicated by $). The difference is that \f(CW$foo[&bar]\fR always |
| 5614 |
behaves like a scalar, both when assigning to it and when evaluating its |
| 5615 |
argument, while \f(CW@foo[&bar]\fR behaves like a list when you assign to it, |
| 5616 |
and provides a list context to its subscript, which can do weird things |
| 5617 |
if you're expecting only one subscript. |
| 5618 |
.Sp |
| 5619 |
On the other hand, if you were actually hoping to treat the array |
| 5620 |
element as a list, you need to look into how references work, because |
| 5621 |
Perl will not magically convert between scalars and lists for you. See |
| 5622 |
perlref. |
| 5623 |
.IP "Scalar value @%s{%s} better written as $%s{%s}" 4 |
| 5624 |
.IX Item "Scalar value @%s{%s} better written as $%s{%s}" |
| 5625 |
(W syntax) You've used a hash slice (indicated by @) to select a single |
| 5626 |
element of a hash. Generally it's better to ask for a scalar value |
| 5627 |
(indicated by $). The difference is that \f(CW$foo{&bar}\fR always behaves |
| 5628 |
like a scalar, both when assigning to it and when evaluating its |
| 5629 |
argument, while \f(CW@foo{&bar}\fR behaves like a list when you assign to it, |
| 5630 |
and provides a list context to its subscript, which can do weird things |
| 5631 |
if you're expecting only one subscript. |
| 5632 |
.Sp |
| 5633 |
On the other hand, if you were actually hoping to treat the hash element |
| 5634 |
as a list, you need to look into how references work, because Perl will |
| 5635 |
not magically convert between scalars and lists for you. See |
| 5636 |
perlref. |
| 5637 |
.IP "Search pattern not terminated" 4 |
| 5638 |
.IX Item "Search pattern not terminated" |
| 5639 |
(F) The lexer couldn't find the final delimiter of a // or m{} |
| 5640 |
construct. Remember that bracketing delimiters count nesting level. |
| 5641 |
Missing the leading \f(CW\*(C`$\*(C'\fR from a variable \f(CW$m\fR may cause this error. |
| 5642 |
.Sp |
| 5643 |
Note that since Perl 5.10.0 a // can also be the \fIdefined-or\fR |
| 5644 |
construct, not just the empty search pattern. Therefore code written |
| 5645 |
in Perl 5.10.0 or later that uses the // as the \fIdefined-or\fR can be |
| 5646 |
misparsed by pre\-5.10.0 Perls as a non-terminated search pattern. |
| 5647 |
.ie n .IP "\fBseekdir()\fR attempted on invalid dirhandle %s" 4 |
| 5648 |
.el .IP "\fBseekdir()\fR attempted on invalid dirhandle \f(CW%s\fR" 4 |
| 5649 |
.IX Item "seekdir() attempted on invalid dirhandle %s" |
| 5650 |
(W io) The dirhandle you are doing a \fBseekdir()\fR on is either closed or not |
| 5651 |
really a dirhandle. Check your control flow. |
| 5652 |
.IP "%\fBsseek()\fR on unopened filehandle" 4 |
| 5653 |
.IX Item "%sseek() on unopened filehandle" |
| 5654 |
(W unopened) You tried to use the \fBseek()\fR or \fBsysseek()\fR function on a |
| 5655 |
filehandle that was either never opened or has since been closed. |
| 5656 |
.IP "select not implemented" 4 |
| 5657 |
.IX Item "select not implemented" |
| 5658 |
(F) This machine doesn't implement the \fBselect()\fR system call. |
| 5659 |
.IP "Self-ties of arrays and hashes are not supported" 4 |
| 5660 |
.IX Item "Self-ties of arrays and hashes are not supported" |
| 5661 |
(F) Self-ties are of arrays and hashes are not supported in |
| 5662 |
the current implementation. |
| 5663 |
.IP "Semicolon seems to be missing" 4 |
| 5664 |
.IX Item "Semicolon seems to be missing" |
| 5665 |
(W semicolon) A nearby syntax error was probably caused by a missing |
| 5666 |
semicolon, or possibly some other missing operator, such as a comma. |
| 5667 |
.IP "semi-panic: attempt to dup freed string" 4 |
| 5668 |
.IX Item "semi-panic: attempt to dup freed string" |
| 5669 |
(S internal) The internal \fBnewSVsv()\fR routine was called to duplicate a |
| 5670 |
scalar that had previously been marked as free. |
| 5671 |
.IP "sem%s not implemented" 4 |
| 5672 |
.IX Item "sem%s not implemented" |
| 5673 |
(F) You don't have System V semaphore IPC on your system. |
| 5674 |
.ie n .IP "\fBsend()\fR on closed socket %s" 4 |
| 5675 |
.el .IP "\fBsend()\fR on closed socket \f(CW%s\fR" 4 |
| 5676 |
.IX Item "send() on closed socket %s" |
| 5677 |
(W closed) The socket you're sending to got itself closed sometime |
| 5678 |
before now. Check your control flow. |
| 5679 |
.IP "Sequence ""\ec{"" invalid" 4 |
| 5680 |
.IX Item "Sequence ""c{"" invalid" |
| 5681 |
(F) These three characters may not appear in sequence in a |
| 5682 |
double-quotish context. This message is raised only on non-ASCII |
| 5683 |
platforms (a different error message is output on ASCII ones). If you |
| 5684 |
were intending to specify a control character with this sequence, you'll |
| 5685 |
have to use a different way to specify it. |
| 5686 |
.IP "Sequence (? incomplete in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5687 |
.IX Item "Sequence (? incomplete in regex; marked by <--\ HERE in m/%s/" |
| 5688 |
(F) A regular expression ended with an incomplete extension (?. The |
| 5689 |
<\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 5690 |
discovered. See perlre. |
| 5691 |
.IP "Sequence (?%c...) not implemented in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5692 |
.IX Item "Sequence (?%c...) not implemented in regex; marked by <--\ HERE in m/%s/" |
| 5693 |
(F) A proposed regular expression extension has the character reserved |
| 5694 |
but has not yet been written. The <\-\-\ HERE shows whereabouts in the |
| 5695 |
regular expression the problem was discovered. See perlre. |
| 5696 |
.IP "Sequence (?%s...) not recognized in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5697 |
.IX Item "Sequence (?%s...) not recognized in regex; marked by <--\ HERE in m/%s/" |
| 5698 |
(F) You used a regular expression extension that doesn't make sense. |
| 5699 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 5700 |
discovered. This may happen when using the \f(CW\*(C`(?^...)\*(C'\fR construct to tell |
| 5701 |
Perl to use the default regular expression modifiers, and you |
| 5702 |
redundantly specify a default modifier. For other |
| 5703 |
causes, see perlre. |
| 5704 |
.IP "Sequence (?#... not terminated in regex m/%s/" 4 |
| 5705 |
.IX Item "Sequence (?#... not terminated in regex m/%s/" |
| 5706 |
(F) A regular expression comment must be terminated by a closing |
| 5707 |
parenthesis. Embedded parentheses aren't allowed. See |
| 5708 |
perlre. |
| 5709 |
.IP "Sequence (?&... not terminated in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5710 |
.IX Item "Sequence (?&... not terminated in regex; marked by <--\ HERE in m/%s/" |
| 5711 |
(F) A named reference of the form \f(CW\*(C`(?&...)\*(C'\fR was missing the final |
| 5712 |
closing parenthesis after the name. The <\-\-\ HERE shows whereabouts |
| 5713 |
in the regular expression the problem was discovered. |
| 5714 |
.IP "Sequence (?%c... not terminated in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5715 |
.IX Item "Sequence (?%c... not terminated in regex; marked by <--\ HERE in m/%s/" |
| 5716 |
(F) A named group of the form \f(CW\*(C`(?\*(Aq...\*(Aq)\*(C'\fR or \f(CW\*(C`(?<...>)\*(C'\fR was missing the final |
| 5717 |
closing quote or angle bracket. The <\-\-\ HERE shows whereabouts in the |
| 5718 |
regular expression the problem was discovered. |
| 5719 |
.IP "Sequence (%s... not terminated in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5720 |
.IX Item "Sequence (%s... not terminated in regex; marked by <--\ HERE in m/%s/" |
| 5721 |
(F) A lookahead assertion \f(CW\*(C`(?=...)\*(C'\fR or \f(CW\*(C`(?!...)\*(C'\fR or lookbehind |
| 5722 |
assertion \f(CW\*(C`(?<=...)\*(C'\fR or \f(CW\*(C`(?<!...)\*(C'\fR was missing the final |
| 5723 |
closing parenthesis. The <\-\-\ HERE shows whereabouts in the |
| 5724 |
regular expression the problem was discovered. |
| 5725 |
.IP "Sequence (?(%c... not terminated in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5726 |
.IX Item "Sequence (?(%c... not terminated in regex; marked by <--\ HERE in m/%s/" |
| 5727 |
(F) A named reference of the form \f(CW\*(C`(?(\*(Aq...\*(Aq)...)\*(C'\fR or \f(CW\*(C`(?(<...>)...)\*(C'\fR was |
| 5728 |
missing the final closing quote or angle bracket after the name. The |
| 5729 |
<\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 5730 |
discovered. |
| 5731 |
.IP "Sequence (?... not terminated in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5732 |
.IX Item "Sequence (?... not terminated in regex; marked by <--\ HERE in m/%s/" |
| 5733 |
(F) There was no matching closing parenthesis for the '('. The |
| 5734 |
<\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 5735 |
discovered. |
| 5736 |
.IP "Sequence \e%s... not terminated in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5737 |
.IX Item "Sequence %s... not terminated in regex; marked by <--\ HERE in m/%s/" |
| 5738 |
(F) The regular expression expects a mandatory argument following the escape |
| 5739 |
sequence and this has been omitted or incorrectly written. |
| 5740 |
.IP "Sequence (?{...}) not terminated with ')'" 4 |
| 5741 |
.IX Item "Sequence (?{...}) not terminated with ')'" |
| 5742 |
(F) The end of the perl code contained within the {...} must be |
| 5743 |
followed immediately by a ')'. |
| 5744 |
.IP "Sequence (?P>... not terminated in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5745 |
.IX Item "Sequence (?P>... not terminated in regex; marked by <--\ HERE in m/%s/" |
| 5746 |
(F) A named reference of the form \f(CW\*(C`(?P>...)\*(C'\fR was missing the final |
| 5747 |
closing parenthesis after the name. The <\-\-\ HERE shows whereabouts |
| 5748 |
in the regular expression the problem was discovered. |
| 5749 |
.IP "Sequence (?P<... not terminated in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5750 |
.IX Item "Sequence (?P<... not terminated in regex; marked by <--\ HERE in m/%s/" |
| 5751 |
(F) A named group of the form \f(CW\*(C`(?P<...>\*(Aq)\*(C'\fR was missing the final |
| 5752 |
closing angle bracket. The <\-\-\ HERE shows whereabouts in the |
| 5753 |
regular expression the problem was discovered. |
| 5754 |
.IP "Sequence ?P=... not terminated in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 5755 |
.IX Item "Sequence ?P=... not terminated in regex; marked by <--\ HERE in m/%s/" |
| 5756 |
(F) A named reference of the form \f(CW\*(C`(?P=...)\*(C'\fR was missing the final |
| 5757 |
closing parenthesis after the name. The <\-\-\ HERE shows whereabouts |
| 5758 |
in the regular expression the problem was discovered. |
| 5759 |
.IP "Sequence (?R) not terminated in regex m/%s/" 4 |
| 5760 |
.IX Item "Sequence (?R) not terminated in regex m/%s/" |
| 5761 |
(F) An \f(CW\*(C`(?R)\*(C'\fR or \f(CW\*(C`(?0)\*(C'\fR sequence in a regular expression was missing the |
| 5762 |
final parenthesis. |
| 5763 |
.IP "500 Server error" 4 |
| 5764 |
.IX Item "500 Server error" |
| 5765 |
(A) This is the error message generally seen in a browser window |
| 5766 |
when trying to run a CGI program (including SSI) over the web. The |
| 5767 |
actual error text varies widely from server to server. The most |
| 5768 |
frequently-seen variants are "500 Server error", "Method (something) |
| 5769 |
not permitted", "Document contains no data", "Premature end of script |
| 5770 |
headers", and "Did not produce a valid header". |
| 5771 |
.Sp |
| 5772 |
\&\fBThis is a CGI error, not a Perl error\fR. |
| 5773 |
.Sp |
| 5774 |
You need to make sure your script is executable, is accessible by |
| 5775 |
the user CGI is running the script under (which is probably not the |
| 5776 |
user account you tested it under), does not rely on any environment |
| 5777 |
variables (like PATH) from the user it isn't running under, and isn't |
| 5778 |
in a location where the CGI server can't find it, basically, more or |
| 5779 |
less. Please see the following for more information: |
| 5780 |
.Sp |
| 5781 |
.Vb 3 |
| 5782 |
\& https://www.perl.org/CGI_MetaFAQ.html |
| 5783 |
\& http://www.htmlhelp.org/faq/cgifaq.html |
| 5784 |
\& http://www.w3.org/Security/Faq/ |
| 5785 |
.Ve |
| 5786 |
.Sp |
| 5787 |
You should also look at perlfaq9. |
| 5788 |
.IP "\fBsetegid()\fR not implemented" 4 |
| 5789 |
.IX Item "setegid() not implemented" |
| 5790 |
(F) You tried to assign to \f(CW$)\fR, and your operating system doesn't |
| 5791 |
support the \fBsetegid()\fR system call (or equivalent), or at least Configure |
| 5792 |
didn't think so. |
| 5793 |
.IP "\fBseteuid()\fR not implemented" 4 |
| 5794 |
.IX Item "seteuid() not implemented" |
| 5795 |
(F) You tried to assign to \f(CW$>\fR, and your operating system doesn't |
| 5796 |
support the \fBseteuid()\fR system call (or equivalent), or at least Configure |
| 5797 |
didn't think so. |
| 5798 |
.IP "setpgrp can't take arguments" 4 |
| 5799 |
.IX Item "setpgrp can't take arguments" |
| 5800 |
(F) Your system has the \fBsetpgrp()\fR from BSD 4.2, which takes no |
| 5801 |
arguments, unlike POSIX \fBsetpgid()\fR, which takes a process ID and process |
| 5802 |
group ID. |
| 5803 |
.IP "\fBsetrgid()\fR not implemented" 4 |
| 5804 |
.IX Item "setrgid() not implemented" |
| 5805 |
(F) You tried to assign to \f(CW$(\fR, and your operating system doesn't |
| 5806 |
support the \fBsetrgid()\fR system call (or equivalent), or at least Configure |
| 5807 |
didn't think so. |
| 5808 |
.IP "\fBsetruid()\fR not implemented" 4 |
| 5809 |
.IX Item "setruid() not implemented" |
| 5810 |
(F) You tried to assign to \f(CW$<\fR, and your operating system doesn't |
| 5811 |
support the \fBsetruid()\fR system call (or equivalent), or at least Configure |
| 5812 |
didn't think so. |
| 5813 |
.ie n .IP "\fBsetsockopt()\fR on closed socket %s" 4 |
| 5814 |
.el .IP "\fBsetsockopt()\fR on closed socket \f(CW%s\fR" 4 |
| 5815 |
.IX Item "setsockopt() on closed socket %s" |
| 5816 |
(W closed) You tried to set a socket option on a closed socket. Did you |
| 5817 |
forget to check the return value of your \fBsocket()\fR call? See |
| 5818 |
"setsockopt" in perlfunc. |
| 5819 |
.ie n .IP "Setting $/ to a reference to %s is forbidden" 4 |
| 5820 |
.el .IP "Setting $/ to a reference to \f(CW%s\fR is forbidden" 4 |
| 5821 |
.IX Item "Setting $/ to a reference to %s is forbidden" |
| 5822 |
(F) You assigned a reference to a scalar to \f(CW$/\fR where the referenced item is |
| 5823 |
not a positive integer. In older perls this \fBappeared\fR to work the same as |
| 5824 |
setting it to \f(CW\*(C`undef\*(C'\fR but was in fact internally different, less efficient |
| 5825 |
and with very bad luck could have resulted in your file being split by a |
| 5826 |
stringified form of the reference. |
| 5827 |
.Sp |
| 5828 |
In Perl 5.20.0 this was changed so that it would be \fBexactly\fR the same as |
| 5829 |
setting \f(CW$/\fR to undef, with the exception that this warning would be thrown. |
| 5830 |
.Sp |
| 5831 |
You are recommended to change your code to set \f(CW$/\fR to \f(CW\*(C`undef\*(C'\fR explicitly if |
| 5832 |
you wish to slurp the file. As of Perl 5.28 assigning \f(CW$/\fR to a reference |
| 5833 |
to an integer which isn't positive is a fatal error. |
| 5834 |
.ie n .IP "Setting $/ to %s reference is forbidden" 4 |
| 5835 |
.el .IP "Setting $/ to \f(CW%s\fR reference is forbidden" 4 |
| 5836 |
.IX Item "Setting $/ to %s reference is forbidden" |
| 5837 |
(F) You tried to assign a reference to a non integer to \f(CW$/\fR. In older |
| 5838 |
Perls this would have behaved similarly to setting it to a reference to |
| 5839 |
a positive integer, where the integer was the address of the reference. |
| 5840 |
As of Perl 5.20.0 this is a fatal error, to allow future versions of Perl |
| 5841 |
to use non-integer refs for more interesting purposes. |
| 5842 |
.IP "shm%s not implemented" 4 |
| 5843 |
.IX Item "shm%s not implemented" |
| 5844 |
(F) You don't have System V shared memory IPC on your system. |
| 5845 |
.IP "!=~ should be !~" 4 |
| 5846 |
.IX Item "!=~ should be !~" |
| 5847 |
(W syntax) The non-matching operator is !~, not !=~. !=~ will be |
| 5848 |
interpreted as the != (numeric not equal) and ~ (1's complement) |
| 5849 |
operators: probably not what you intended. |
| 5850 |
.IP "/%s/ should probably be written as ""%s""" 4 |
| 5851 |
.IX Item "/%s/ should probably be written as ""%s""" |
| 5852 |
(W syntax) You have used a pattern where Perl expected to find a string, |
| 5853 |
as in the first argument to \f(CW\*(C`join\*(C'\fR. Perl will treat the true or false |
| 5854 |
result of matching the pattern against \f(CW$_\fR as the string, which is |
| 5855 |
probably not what you had in mind. |
| 5856 |
.ie n .IP "\fBshutdown()\fR on closed socket %s" 4 |
| 5857 |
.el .IP "\fBshutdown()\fR on closed socket \f(CW%s\fR" 4 |
| 5858 |
.IX Item "shutdown() on closed socket %s" |
| 5859 |
(W closed) You tried to do a shutdown on a closed socket. Seems a bit |
| 5860 |
superfluous. |
| 5861 |
.IP "SIG%s handler ""%s"" not defined" 4 |
| 5862 |
.IX Item "SIG%s handler ""%s"" not defined" |
| 5863 |
(W signal) The signal handler named in \f(CW%SIG\fR doesn't, in fact, exist. |
| 5864 |
Perhaps you put it into the wrong package? |
| 5865 |
.ie n .IP "Slab leaked from cv %p" 4 |
| 5866 |
.el .IP "Slab leaked from cv \f(CW%p\fR" 4 |
| 5867 |
.IX Item "Slab leaked from cv %p" |
| 5868 |
(S) If you see this message, then something is seriously wrong with the |
| 5869 |
internal bookkeeping of op trees. An op tree needed to be freed after |
| 5870 |
a compilation error, but could not be found, so it was leaked instead. |
| 5871 |
.IP "sleep(%u) too large" 4 |
| 5872 |
.IX Item "sleep(%u) too large" |
| 5873 |
(W overflow) You called \f(CW\*(C`sleep\*(C'\fR with a number that was larger than |
| 5874 |
it can reliably handle and \f(CW\*(C`sleep\*(C'\fR probably slept for less time than |
| 5875 |
requested. |
| 5876 |
.IP "Slurpy parameter not last" 4 |
| 5877 |
.IX Item "Slurpy parameter not last" |
| 5878 |
(F) In a subroutine signature, you put something after a slurpy (array or |
| 5879 |
hash) parameter. The slurpy parameter takes all the available arguments, |
| 5880 |
so there can't be any left to fill later parameters. |
| 5881 |
.IP "Smart matching a non-overloaded object breaks encapsulation" 4 |
| 5882 |
.IX Item "Smart matching a non-overloaded object breaks encapsulation" |
| 5883 |
(F) You should not use the \f(CW\*(C`~~\*(C'\fR operator on an object that does not |
| 5884 |
overload it: Perl refuses to use the object's underlying structure |
| 5885 |
for the smart match. |
| 5886 |
.IP "Smartmatch is deprecated" 4 |
| 5887 |
.IX Item "Smartmatch is deprecated" |
| 5888 |
(D deprecated::smartmatch) This warning is emitted if you |
| 5889 |
use the smartmatch (\f(CW\*(C`~~\*(C'\fR) operator. This is a deprecated |
| 5890 |
feature. Particularly, its behavior is noticed for being |
| 5891 |
unnecessarily complex and unintuitive, and it will be removed |
| 5892 |
in Perl 5.42. |
| 5893 |
.IP "Sorry, hash keys must be smaller than 2**31 bytes" 4 |
| 5894 |
.IX Item "Sorry, hash keys must be smaller than 2**31 bytes" |
| 5895 |
(F) You tried to create a hash containing a very large key, where "very |
| 5896 |
large" means that it needs at least 2 gigabytes to store. Unfortunately, |
| 5897 |
Perl doesn't yet handle such large hash keys. You should |
| 5898 |
reconsider your design to avoid hashing such a long string directly. |
| 5899 |
.IP "sort is now a reserved word" 4 |
| 5900 |
.IX Item "sort is now a reserved word" |
| 5901 |
(F) An ancient error message that almost nobody ever runs into anymore. |
| 5902 |
But before sort was a keyword, people sometimes used it as a filehandle. |
| 5903 |
.IP "Source filters apply only to byte streams" 4 |
| 5904 |
.IX Item "Source filters apply only to byte streams" |
| 5905 |
(F) You tried to activate a source filter (usually by loading a |
| 5906 |
source filter module) within a string passed to \f(CW\*(C`eval\*(C'\fR. This is |
| 5907 |
not permitted under the \f(CW\*(C`unicode_eval\*(C'\fR feature. Consider using |
| 5908 |
\&\f(CW\*(C`evalbytes\*(C'\fR instead. See feature. |
| 5909 |
.IP "\fBsplice()\fR offset past end of array" 4 |
| 5910 |
.IX Item "splice() offset past end of array" |
| 5911 |
(W misc) You attempted to specify an offset that was past the end of |
| 5912 |
the array passed to \fBsplice()\fR. Splicing will instead commence at the |
| 5913 |
end of the array, rather than past it. If this isn't what you want, |
| 5914 |
try explicitly pre-extending the array by assigning $#array = \f(CW$offset\fR. |
| 5915 |
See "splice" in perlfunc. |
| 5916 |
.IP "Split loop" 4 |
| 5917 |
.IX Item "Split loop" |
| 5918 |
(P) The split was looping infinitely. (Obviously, a split shouldn't |
| 5919 |
iterate more times than there are characters of input, which is what |
| 5920 |
happened.) See "split" in perlfunc. |
| 5921 |
.IP "Statement unlikely to be reached" 4 |
| 5922 |
.IX Item "Statement unlikely to be reached" |
| 5923 |
(W exec) You did an \fBexec()\fR with some statement after it other than a |
| 5924 |
\&\fBdie()\fR. This is almost always an error, because \fBexec()\fR never returns |
| 5925 |
unless there was a failure. You probably wanted to use \fBsystem()\fR |
| 5926 |
instead, which does return. To suppress this warning, put the \fBexec()\fR in |
| 5927 |
a block by itself. |
| 5928 |
.ie n .IP """state"" subroutine %s can't be in a package" 4 |
| 5929 |
.el .IP """state"" subroutine \f(CW%s\fR can't be in a package" 4 |
| 5930 |
.IX Item """state"" subroutine %s can't be in a package" |
| 5931 |
(F) Lexically scoped subroutines aren't in a package, so it doesn't make |
| 5932 |
sense to try to declare one with a package qualifier on the front. |
| 5933 |
.ie n .IP """state %s"" used in sort comparison" 4 |
| 5934 |
.el .IP """state \f(CW%s\fR"" used in sort comparison" 4 |
| 5935 |
.IX Item """state %s"" used in sort comparison" |
| 5936 |
(W syntax) The package variables \f(CW$a\fR and \f(CW$b\fR are used for sort comparisons. |
| 5937 |
You used \f(CW$a\fR or \f(CW$b\fR in as an operand to the \f(CW\*(C`<=>\*(C'\fR or \f(CW\*(C`cmp\*(C'\fR operator inside a |
| 5938 |
sort comparison block, and the variable had earlier been declared as a |
| 5939 |
lexical variable. Either qualify the sort variable with the package |
| 5940 |
name, or rename the lexical variable. |
| 5941 |
.ie n .IP """state"" variable %s can't be in a package" 4 |
| 5942 |
.el .IP """state"" variable \f(CW%s\fR can't be in a package" 4 |
| 5943 |
.IX Item """state"" variable %s can't be in a package" |
| 5944 |
(F) Lexically scoped variables aren't in a package, so it doesn't make |
| 5945 |
sense to try to declare one with a package qualifier on the front. Use |
| 5946 |
\&\fBlocal()\fR if you want to localize a package variable. |
| 5947 |
.ie n .IP "\fBstat()\fR on unopened filehandle %s" 4 |
| 5948 |
.el .IP "\fBstat()\fR on unopened filehandle \f(CW%s\fR" 4 |
| 5949 |
.IX Item "stat() on unopened filehandle %s" |
| 5950 |
(W unopened) You tried to use the \fBstat()\fR function on a filehandle that |
| 5951 |
was either never opened or has since been closed. |
| 5952 |
.IP "Strings with code points over 0xFF may not be mapped into in-memory file handles" 4 |
| 5953 |
.IX Item "Strings with code points over 0xFF may not be mapped into in-memory file handles" |
| 5954 |
(W utf8) You tried to open a reference to a scalar for read or append |
| 5955 |
where the scalar contained code points over 0xFF. In-memory files |
| 5956 |
model on-disk files and can only contain bytes. |
| 5957 |
.IP "Stub found while resolving method ""%s"" overloading ""%s"" in package ""%s""" 4 |
| 5958 |
.IX Item "Stub found while resolving method ""%s"" overloading ""%s"" in package ""%s""" |
| 5959 |
(P) Overloading resolution over \f(CW@ISA\fR tree may be broken by importation |
| 5960 |
stubs. Stubs should never be implicitly created, but explicit calls to |
| 5961 |
\&\f(CW\*(C`can\*(C'\fR may break this. |
| 5962 |
.IP "Subroutine attributes must come before the signature" 4 |
| 5963 |
.IX Item "Subroutine attributes must come before the signature" |
| 5964 |
(F) When subroutine signatures are enabled, any subroutine attributes must |
| 5965 |
come before the signature. Note that this order was the opposite in |
| 5966 |
versions 5.22..5.26. So: |
| 5967 |
.Sp |
| 5968 |
.Vb 2 |
| 5969 |
\& sub foo :lvalue ($x, $y) { ... } # 5.20 and 5.28 + |
| 5970 |
\& sub foo ($x, $y) :lvalue { ... } # 5.22 .. 5.26 |
| 5971 |
.Ve |
| 5972 |
.IP "Subroutine ""&%s"" is not available" 4 |
| 5973 |
.IX Item "Subroutine ""&%s"" is not available" |
| 5974 |
(W closure) During compilation, an inner named subroutine or eval is |
| 5975 |
attempting to capture an outer lexical subroutine that is not currently |
| 5976 |
available. This can happen for one of two reasons. First, the lexical |
| 5977 |
subroutine may be declared in an outer anonymous subroutine that has |
| 5978 |
not yet been created. (Remember that named subs are created at compile |
| 5979 |
time, while anonymous subs are created at run-time.) For example, |
| 5980 |
.Sp |
| 5981 |
.Vb 1 |
| 5982 |
\& sub { my sub a {...} sub f { \e&a } } |
| 5983 |
.Ve |
| 5984 |
.Sp |
| 5985 |
At the time that f is created, it can't capture the current "a" sub, |
| 5986 |
since the anonymous subroutine hasn't been created yet. Conversely, the |
| 5987 |
following won't give a warning since the anonymous subroutine has by now |
| 5988 |
been created and is live: |
| 5989 |
.Sp |
| 5990 |
.Vb 1 |
| 5991 |
\& sub { my sub a {...} eval \*(Aqsub f { \e&a }\*(Aq }\->(); |
| 5992 |
.Ve |
| 5993 |
.Sp |
| 5994 |
The second situation is caused by an eval accessing a lexical subroutine |
| 5995 |
that has gone out of scope, for example, |
| 5996 |
.Sp |
| 5997 |
.Vb 5 |
| 5998 |
\& sub f { |
| 5999 |
\& my sub a {...} |
| 6000 |
\& sub { eval \*(Aq\e&a\*(Aq } |
| 6001 |
\& } |
| 6002 |
\& f()\->(); |
| 6003 |
.Ve |
| 6004 |
.Sp |
| 6005 |
Here, when the '\e&a' in the eval is being compiled, f() is not currently |
| 6006 |
being executed, so its &a is not available for capture. |
| 6007 |
.ie n .IP """%s"" subroutine &%s masks earlier declaration in same %s" 4 |
| 6008 |
.el .IP """%s"" subroutine &%s masks earlier declaration in same \f(CW%s\fR" 4 |
| 6009 |
.IX Item """%s"" subroutine &%s masks earlier declaration in same %s" |
| 6010 |
(W shadow) A "my" or "state" subroutine has been redeclared in the |
| 6011 |
current scope or statement, effectively eliminating all access to |
| 6012 |
the previous instance. This is almost always a typographical error. |
| 6013 |
Note that the earlier subroutine will still exist until the end of |
| 6014 |
the scope or until all closure references to it are destroyed. |
| 6015 |
.ie n .IP "Subroutine %s redefined" 4 |
| 6016 |
.el .IP "Subroutine \f(CW%s\fR redefined" 4 |
| 6017 |
.IX Item "Subroutine %s redefined" |
| 6018 |
(W redefine) You redefined a subroutine. To suppress this warning, say |
| 6019 |
.Sp |
| 6020 |
.Vb 4 |
| 6021 |
\& { |
| 6022 |
\& no warnings \*(Aqredefine\*(Aq; |
| 6023 |
\& eval "sub name { ... }"; |
| 6024 |
\& } |
| 6025 |
.Ve |
| 6026 |
.IP "Subroutine ""%s"" will not stay shared" 4 |
| 6027 |
.IX Item "Subroutine ""%s"" will not stay shared" |
| 6028 |
(W closure) An inner (nested) \fInamed\fR subroutine is referencing a "my" |
| 6029 |
subroutine defined in an outer named subroutine. |
| 6030 |
.Sp |
| 6031 |
When the inner subroutine is called, it will see the value of the outer |
| 6032 |
subroutine's lexical subroutine as it was before and during the *first* |
| 6033 |
call to the outer subroutine; in this case, after the first call to the |
| 6034 |
outer subroutine is complete, the inner and outer subroutines will no |
| 6035 |
longer share a common value for the lexical subroutine. In other words, |
| 6036 |
it will no longer be shared. This will especially make a difference |
| 6037 |
if the lexical subroutines accesses lexical variables declared in its |
| 6038 |
surrounding scope. |
| 6039 |
.Sp |
| 6040 |
This problem can usually be solved by making the inner subroutine |
| 6041 |
anonymous, using the \f(CW\*(C`sub {}\*(C'\fR syntax. When inner anonymous subs that |
| 6042 |
reference lexical subroutines in outer subroutines are created, they |
| 6043 |
are automatically rebound to the current values of such lexical subs. |
| 6044 |
.IP "Substitution loop" 4 |
| 6045 |
.IX Item "Substitution loop" |
| 6046 |
(P) The substitution was looping infinitely. (Obviously, a substitution |
| 6047 |
shouldn't iterate more times than there are characters of input, which |
| 6048 |
is what happened.) See the discussion of substitution in |
| 6049 |
"Regexp Quote-Like Operators" in perlop. |
| 6050 |
.IP "Substitution pattern not terminated" 4 |
| 6051 |
.IX Item "Substitution pattern not terminated" |
| 6052 |
(F) The lexer couldn't find the interior delimiter of an s/// or s{}{} |
| 6053 |
construct. Remember that bracketing delimiters count nesting level. |
| 6054 |
Missing the leading \f(CW\*(C`$\*(C'\fR from variable \f(CW$s\fR may cause this error. |
| 6055 |
.IP "Substitution replacement not terminated" 4 |
| 6056 |
.IX Item "Substitution replacement not terminated" |
| 6057 |
(F) The lexer couldn't find the final delimiter of an s/// or s{}{} |
| 6058 |
construct. Remember that bracketing delimiters count nesting level. |
| 6059 |
Missing the leading \f(CW\*(C`$\*(C'\fR from variable \f(CW$s\fR may cause this error. |
| 6060 |
.IP "substr outside of string" 4 |
| 6061 |
.IX Item "substr outside of string" |
| 6062 |
(W substr)(F) You tried to reference a \fBsubstr()\fR that pointed outside of |
| 6063 |
a string. That is, the absolute value of the offset was larger than the |
| 6064 |
length of the string. See "substr" in perlfunc. This warning is fatal if |
| 6065 |
substr is used in an lvalue context (as the left hand side of an |
| 6066 |
assignment or as a subroutine argument for example). |
| 6067 |
.ie n .IP "sv_upgrade from type %d down to type %d" 4 |
| 6068 |
.el .IP "sv_upgrade from type \f(CW%d\fR down to type \f(CW%d\fR" 4 |
| 6069 |
.IX Item "sv_upgrade from type %d down to type %d" |
| 6070 |
(P) Perl tried to force the upgrade of an SV to a type which was actually |
| 6071 |
inferior to its current type. |
| 6072 |
.IP "Switch (?(condition)... contains too many branches in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6073 |
.IX Item "Switch (?(condition)... contains too many branches in regex; marked by <--\ HERE in m/%s/" |
| 6074 |
(F) A (?(condition)if\-clause|else\-clause) construct can have at most |
| 6075 |
two branches (the if-clause and the else-clause). If you want one or |
| 6076 |
both to contain alternation, such as using \f(CW\*(C`this|that|other\*(C'\fR, enclose |
| 6077 |
it in clustering parentheses: |
| 6078 |
.Sp |
| 6079 |
.Vb 1 |
| 6080 |
\& (?(condition)(?:this|that|other)|else\-clause) |
| 6081 |
.Ve |
| 6082 |
.Sp |
| 6083 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem |
| 6084 |
was discovered. See perlre. |
| 6085 |
.IP "Switch condition not recognized in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6086 |
.IX Item "Switch condition not recognized in regex; marked by <--\ HERE in m/%s/" |
| 6087 |
(F) The condition part of a (?(condition)if\-clause|else\-clause) construct |
| 6088 |
is not known. The condition must be one of the following: |
| 6089 |
.Sp |
| 6090 |
.Vb 9 |
| 6091 |
\& (1) (2) ... true if 1st, 2nd, etc., capture matched |
| 6092 |
\& (<NAME>) (\*(AqNAME\*(Aq) true if named capture matched |
| 6093 |
\& (?=...) (?<=...) true if subpattern matches |
| 6094 |
\& (?!...) (?<!...) true if subpattern fails to match |
| 6095 |
\& (?{ CODE }) true if code returns a true value |
| 6096 |
\& (R) true if evaluating inside recursion |
| 6097 |
\& (R1) (R2) ... true if directly inside capture group 1, 2, etc. |
| 6098 |
\& (R&NAME) true if directly inside named capture |
| 6099 |
\& (DEFINE) always false; for defining named subpatterns |
| 6100 |
.Ve |
| 6101 |
.Sp |
| 6102 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 6103 |
discovered. See perlre. |
| 6104 |
.IP "Switch (?(condition)... not terminated in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6105 |
.IX Item "Switch (?(condition)... not terminated in regex; marked by <--\ HERE in m/%s/" |
| 6106 |
(F) You omitted to close a (?(condition)...) block somewhere |
| 6107 |
in the pattern. Add a closing parenthesis in the appropriate |
| 6108 |
position. See perlre. |
| 6109 |
.ie n .IP "switching effective %s is not implemented" 4 |
| 6110 |
.el .IP "switching effective \f(CW%s\fR is not implemented" 4 |
| 6111 |
.IX Item "switching effective %s is not implemented" |
| 6112 |
(F) While under the \f(CW\*(C`use filetest\*(C'\fR pragma, we cannot switch the real |
| 6113 |
and effective uids or gids. |
| 6114 |
.IP "syntax error" 4 |
| 6115 |
.IX Item "syntax error" |
| 6116 |
(F) Probably means you had a syntax error. Common reasons include: |
| 6117 |
.Sp |
| 6118 |
.Vb 6 |
| 6119 |
\& A keyword is misspelled. |
| 6120 |
\& A semicolon is missing. |
| 6121 |
\& A comma is missing. |
| 6122 |
\& An opening or closing parenthesis is missing. |
| 6123 |
\& An opening or closing brace is missing. |
| 6124 |
\& A closing quote is missing. |
| 6125 |
.Ve |
| 6126 |
.Sp |
| 6127 |
Often there will be another error message associated with the syntax |
| 6128 |
error giving more information. (Sometimes it helps to turn on \fB\-w\fR.) |
| 6129 |
The error message itself often tells you where it was in the line when |
| 6130 |
it decided to give up. Sometimes the actual error is several tokens |
| 6131 |
before this, because Perl is good at understanding random input. |
| 6132 |
Occasionally the line number may be misleading, and once in a blue moon |
| 6133 |
the only way to figure out what's triggering the error is to call |
| 6134 |
\&\f(CW\*(C`perl \-c\*(C'\fR repeatedly, chopping away half the program each time to see |
| 6135 |
if the error went away. Sort of the cybernetic version of 20\ questions. |
| 6136 |
.ie n .IP "syntax error at line %d: '%s' unexpected" 4 |
| 6137 |
.el .IP "syntax error at line \f(CW%d:\fR '%s' unexpected" 4 |
| 6138 |
.IX Item "syntax error at line %d: '%s' unexpected" |
| 6139 |
(A) You've accidentally run your script through the Bourne shell instead |
| 6140 |
of Perl. Check the #! line, or manually feed your script into Perl |
| 6141 |
yourself. |
| 6142 |
.ie n .IP "syntax error in file %s at line %d, next 2 tokens ""%s""" 4 |
| 6143 |
.el .IP "syntax error in file \f(CW%s\fR at line \f(CW%d\fR, next 2 tokens ""%s""" 4 |
| 6144 |
.IX Item "syntax error in file %s at line %d, next 2 tokens ""%s""" |
| 6145 |
(F) This error is likely to occur if you run a perl5 script through |
| 6146 |
a perl4 interpreter, especially if the next 2 tokens are "use strict" |
| 6147 |
or "my \f(CW$var\fR" or "our \f(CW$var\fR". |
| 6148 |
.IP "Syntax error in (?[...]) in regex; marked by <\-\- HERE in m/%s/" 4 |
| 6149 |
.IX Item "Syntax error in (?[...]) in regex; marked by <-- HERE in m/%s/" |
| 6150 |
(F) Perl could not figure out what you meant inside this construct; this |
| 6151 |
notifies you that it is giving up trying. |
| 6152 |
.ie n .IP "%s syntax OK" 4 |
| 6153 |
.el .IP "\f(CW%s\fR syntax OK" 4 |
| 6154 |
.IX Item "%s syntax OK" |
| 6155 |
(F) The final summary message when a \f(CW\*(C`perl \-c\*(C'\fR succeeds. |
| 6156 |
.ie n .IP "\fBsysread()\fR on closed filehandle %s" 4 |
| 6157 |
.el .IP "\fBsysread()\fR on closed filehandle \f(CW%s\fR" 4 |
| 6158 |
.IX Item "sysread() on closed filehandle %s" |
| 6159 |
(W closed) You tried to read from a closed filehandle. |
| 6160 |
.ie n .IP "\fBsysread()\fR on unopened filehandle %s" 4 |
| 6161 |
.el .IP "\fBsysread()\fR on unopened filehandle \f(CW%s\fR" 4 |
| 6162 |
.IX Item "sysread() on unopened filehandle %s" |
| 6163 |
(W unopened) You tried to read from a filehandle that was never opened. |
| 6164 |
.ie n .IP "System V %s is not implemented on this machine" 4 |
| 6165 |
.el .IP "System V \f(CW%s\fR is not implemented on this machine" 4 |
| 6166 |
.IX Item "System V %s is not implemented on this machine" |
| 6167 |
(F) You tried to do something with a function beginning with "sem", |
| 6168 |
"shm", or "msg" but that System V IPC is not implemented in your |
| 6169 |
machine. In some machines the functionality can exist but be |
| 6170 |
unconfigured. Consult your system support. |
| 6171 |
.ie n .IP "\fBsyswrite()\fR on closed filehandle %s" 4 |
| 6172 |
.el .IP "\fBsyswrite()\fR on closed filehandle \f(CW%s\fR" 4 |
| 6173 |
.IX Item "syswrite() on closed filehandle %s" |
| 6174 |
(W closed) The filehandle you're writing to got itself closed sometime |
| 6175 |
before now. Check your control flow. |
| 6176 |
.ie n .IP """\-T"" and ""\-B"" not implemented on filehandles" 4 |
| 6177 |
.el .IP "\f(CW\-T\fR and \f(CW\-B\fR not implemented on filehandles" 4 |
| 6178 |
.IX Item "-T and -B not implemented on filehandles" |
| 6179 |
(F) Perl can't peek at the stdio buffer of filehandles when it doesn't |
| 6180 |
know about your kind of stdio. You'll have to use a filename instead. |
| 6181 |
.IP "Target of goto is too deeply nested" 4 |
| 6182 |
.IX Item "Target of goto is too deeply nested" |
| 6183 |
(F) You tried to use \f(CW\*(C`goto\*(C'\fR to reach a label that was too deeply nested |
| 6184 |
for Perl to reach. Perl is doing you a favor by refusing. |
| 6185 |
.ie n .IP "\fBtelldir()\fR attempted on invalid dirhandle %s" 4 |
| 6186 |
.el .IP "\fBtelldir()\fR attempted on invalid dirhandle \f(CW%s\fR" 4 |
| 6187 |
.IX Item "telldir() attempted on invalid dirhandle %s" |
| 6188 |
(W io) The dirhandle you tried to \fBtelldir()\fR is either closed or not really |
| 6189 |
a dirhandle. Check your control flow. |
| 6190 |
.IP "\fBtell()\fR on unopened filehandle" 4 |
| 6191 |
.IX Item "tell() on unopened filehandle" |
| 6192 |
(W unopened) You tried to use the \fBtell()\fR function on a filehandle that |
| 6193 |
was either never opened or has since been closed. |
| 6194 |
.IP "The \fBcrypt()\fR function is unimplemented due to excessive paranoia." 4 |
| 6195 |
.IX Item "The crypt() function is unimplemented due to excessive paranoia." |
| 6196 |
(F) Configure couldn't find the \fBcrypt()\fR function on your machine, |
| 6197 |
probably because your vendor didn't supply it, probably because they |
| 6198 |
think the U.S. Government thinks it's a secret, or at least that they |
| 6199 |
will continue to pretend that it is. And if you quote me on that, I |
| 6200 |
will deny it. |
| 6201 |
.IP "The experimental declared_refs feature is not enabled" 4 |
| 6202 |
.IX Item "The experimental declared_refs feature is not enabled" |
| 6203 |
(F) To declare references to variables, as in \f(CW\*(C`my \e%x\*(C'\fR, you must first enable |
| 6204 |
the feature: |
| 6205 |
.Sp |
| 6206 |
.Vb 2 |
| 6207 |
\& no warnings "experimental::declared_refs"; |
| 6208 |
\& use feature "declared_refs"; |
| 6209 |
.Ve |
| 6210 |
.ie n .IP "The %s function is unimplemented" 4 |
| 6211 |
.el .IP "The \f(CW%s\fR function is unimplemented" 4 |
| 6212 |
.IX Item "The %s function is unimplemented" |
| 6213 |
(F) The function indicated isn't implemented on this architecture, |
| 6214 |
according to the probings of Configure. |
| 6215 |
.IP "The private_use feature is experimental" 4 |
| 6216 |
.IX Item "The private_use feature is experimental" |
| 6217 |
(S experimental::private_use) This feature is actually a hook for future |
| 6218 |
use. |
| 6219 |
.ie n .IP "The stat preceding %s wasn't an lstat" 4 |
| 6220 |
.el .IP "The stat preceding \f(CW%s\fR wasn't an lstat" 4 |
| 6221 |
.IX Item "The stat preceding %s wasn't an lstat" |
| 6222 |
(F) It makes no sense to test the current stat buffer for symbolic |
| 6223 |
linkhood if the last stat that wrote to the stat buffer already went |
| 6224 |
past the symlink to get to the real file. Use an actual filename |
| 6225 |
instead. |
| 6226 |
.IP "The Unicode property wildcards feature is experimental" 4 |
| 6227 |
.IX Item "The Unicode property wildcards feature is experimental" |
| 6228 |
(S experimental::uniprop_wildcards) This feature is experimental |
| 6229 |
and its behavior may in any future release of perl. See |
| 6230 |
"Wildcards in Property Values" in perlunicode. |
| 6231 |
.IP "The 'unique' attribute may only be applied to 'our' variables" 4 |
| 6232 |
.IX Item "The 'unique' attribute may only be applied to 'our' variables" |
| 6233 |
(F) This attribute was never supported on \f(CW\*(C`my\*(C'\fR or \f(CW\*(C`sub\*(C'\fR declarations. |
| 6234 |
.IP "This Perl can't reset CRTL environ elements (%s)" 4 |
| 6235 |
.IX Item "This Perl can't reset CRTL environ elements (%s)" |
| 6236 |
.PD 0 |
| 6237 |
.IP "This Perl can't set CRTL environ elements (%s=%s)" 4 |
| 6238 |
.IX Item "This Perl can't set CRTL environ elements (%s=%s)" |
| 6239 |
.PD |
| 6240 |
(W internal) Warnings peculiar to VMS. You tried to change or delete an |
| 6241 |
element of the CRTL's internal environ array, but your copy of Perl |
| 6242 |
wasn't built with a CRTL that contained the \fBsetenv()\fR function. You'll |
| 6243 |
need to rebuild Perl with a CRTL that does, or redefine |
| 6244 |
\&\fIPERL_ENV_TABLES\fR (see perlvms) so that the environ array isn't the |
| 6245 |
target of the change to |
| 6246 |
\&\f(CW%ENV\fR which produced the warning. |
| 6247 |
.IP "This Perl has not been built with support for randomized hash key traversal but something called \fBPerl_hv_rand_set()\fR." 4 |
| 6248 |
.IX Item "This Perl has not been built with support for randomized hash key traversal but something called Perl_hv_rand_set()." |
| 6249 |
(F) Something has attempted to use an internal API call which |
| 6250 |
depends on Perl being compiled with the default support for randomized hash |
| 6251 |
key traversal, but this Perl has been compiled without it. You should |
| 6252 |
report this warning to the relevant upstream party, or recompile perl |
| 6253 |
with default options. |
| 6254 |
.IP "This use of \fBmy()\fR in false conditional is no longer allowed" 4 |
| 6255 |
.IX Item "This use of my() in false conditional is no longer allowed" |
| 6256 |
(F) You used a declaration similar to \f(CW\*(C`my $x if 0\*(C'\fR. There |
| 6257 |
has been a long-standing bug in Perl that causes a lexical variable |
| 6258 |
not to be cleared at scope exit when its declaration includes a false |
| 6259 |
conditional. Some people have exploited this bug to achieve a kind of |
| 6260 |
static variable. Since we intend to fix this bug, we don't want people |
| 6261 |
relying on this behavior. You can achieve a similar static effect by |
| 6262 |
declaring the variable in a separate block outside the function, eg |
| 6263 |
.Sp |
| 6264 |
.Vb 1 |
| 6265 |
\& sub f { my $x if 0; return $x++ } |
| 6266 |
.Ve |
| 6267 |
.Sp |
| 6268 |
becomes |
| 6269 |
.Sp |
| 6270 |
.Vb 1 |
| 6271 |
\& { my $x; sub f { return $x++ } } |
| 6272 |
.Ve |
| 6273 |
.Sp |
| 6274 |
Beginning with perl 5.10.0, you can also use \f(CW\*(C`state\*(C'\fR variables to have |
| 6275 |
lexicals that are initialized only once (see feature): |
| 6276 |
.Sp |
| 6277 |
.Vb 1 |
| 6278 |
\& sub f { state $x; return $x++ } |
| 6279 |
.Ve |
| 6280 |
.Sp |
| 6281 |
This use of \f(CWmy()\fR in a false conditional was deprecated beginning in |
| 6282 |
Perl 5.10 and became a fatal error in Perl 5.30. |
| 6283 |
.IP "Timeout waiting for another thread to define \ep{%s}" 4 |
| 6284 |
.IX Item "Timeout waiting for another thread to define p{%s}" |
| 6285 |
(F) The first time a user-defined property |
| 6286 |
("User-Defined Character Properties" in perlunicode) is used, its |
| 6287 |
definition is looked up and converted into an internal form for more |
| 6288 |
efficient handling in subsequent uses. There could be a race if two or |
| 6289 |
more threads tried to do this processing nearly simultaneously. |
| 6290 |
Instead, a critical section is created around this task, locking out all |
| 6291 |
but one thread from doing it. This message indicates that the thread |
| 6292 |
that is doing the conversion is taking an unexpectedly long time. The |
| 6293 |
timeout exists solely to prevent deadlock; it's long enough that the |
| 6294 |
system was likely thrashing and about to crash. There is no real remedy but |
| 6295 |
rebooting. |
| 6296 |
.IP "times not implemented" 4 |
| 6297 |
.IX Item "times not implemented" |
| 6298 |
(F) Your version of the C library apparently doesn't do \fBtimes()\fR. I |
| 6299 |
suspect you're not running on Unix. |
| 6300 |
.IP """\-T"" is on the #! line, it must also be used on the command line" 4 |
| 6301 |
.IX Item """-T"" is on the #! line, it must also be used on the command line" |
| 6302 |
(X) The #! line (or local equivalent) in a Perl script contains |
| 6303 |
the \fB\-T\fR option (or the \fB\-t\fR option), but Perl was not invoked with |
| 6304 |
\&\fB\-T\fR in its command line. This is an error because, by the time |
| 6305 |
Perl discovers a \fB\-T\fR in a script, it's too late to properly taint |
| 6306 |
everything from the environment. So Perl gives up. |
| 6307 |
.Sp |
| 6308 |
If the Perl script is being executed as a command using the #! |
| 6309 |
mechanism (or its local equivalent), this error can usually be |
| 6310 |
fixed by editing the #! line so that the \fB\-%c\fR option is a part of |
| 6311 |
Perl's first argument: e.g. change \f(CW\*(C`perl \-n \-%c\*(C'\fR to \f(CW\*(C`perl \-%c \-n\*(C'\fR. |
| 6312 |
.Sp |
| 6313 |
If the Perl script is being executed as \f(CW\*(C`perl scriptname\*(C'\fR, then the |
| 6314 |
\&\fB\-%c\fR option must appear on the command line: \f(CW\*(C`perl \-%c scriptname\*(C'\fR. |
| 6315 |
.IP "To%s: illegal mapping '%s'" 4 |
| 6316 |
.IX Item "To%s: illegal mapping '%s'" |
| 6317 |
(F) You tried to define a customized To-mapping for \fBlc()\fR, lcfirst, |
| 6318 |
\&\fBuc()\fR, or \fBucfirst()\fR (or their string-inlined versions), but you |
| 6319 |
specified an illegal mapping. |
| 6320 |
See "User-Defined Character Properties" in perlunicode. |
| 6321 |
.IP "Too deeply nested ()\-groups" 4 |
| 6322 |
.IX Item "Too deeply nested ()-groups" |
| 6323 |
(F) Your template contains ()\-groups with a ridiculously deep nesting level. |
| 6324 |
.IP "Too few args to syscall" 4 |
| 6325 |
.IX Item "Too few args to syscall" |
| 6326 |
(F) There has to be at least one argument to \fBsyscall()\fR to specify the |
| 6327 |
system call to call, silly dilly. |
| 6328 |
.ie n .IP "Too few arguments for subroutine '%s' (got %d; expected %d)" 4 |
| 6329 |
.el .IP "Too few arguments for subroutine '%s' (got \f(CW%d\fR; expected \f(CW%d\fR)" 4 |
| 6330 |
.IX Item "Too few arguments for subroutine '%s' (got %d; expected %d)" |
| 6331 |
(F) A subroutine using a signature fewer arguments than required by the |
| 6332 |
signature. The caller of the subroutine is presumably at fault. |
| 6333 |
.Sp |
| 6334 |
The message attempts to include the name of the called subroutine. If |
| 6335 |
the subroutine has been aliased, the subroutine's original name will be |
| 6336 |
shown, regardless of what name the caller used. It will also indicate the |
| 6337 |
number of arguments given and the number expected. |
| 6338 |
.ie n .IP "Too few arguments for subroutine '%s' (got %d; expected at least %d)" 4 |
| 6339 |
.el .IP "Too few arguments for subroutine '%s' (got \f(CW%d\fR; expected at least \f(CW%d\fR)" 4 |
| 6340 |
.IX Item "Too few arguments for subroutine '%s' (got %d; expected at least %d)" |
| 6341 |
Similar to the previous message but for subroutines that accept a variable |
| 6342 |
number of arguments. |
| 6343 |
.IP "Too late for ""\-%s"" option" 4 |
| 6344 |
.IX Item "Too late for ""-%s"" option" |
| 6345 |
(X) The #! line (or local equivalent) in a Perl script contains the |
| 6346 |
\&\fB\-M\fR, \fB\-m\fR or \fB\-C\fR option. |
| 6347 |
.Sp |
| 6348 |
In the case of \fB\-M\fR and \fB\-m\fR, this is an error because those options |
| 6349 |
are not intended for use inside scripts. Use the \f(CW\*(C`use\*(C'\fR pragma instead. |
| 6350 |
.Sp |
| 6351 |
The \fB\-C\fR option only works if it is specified on the command line as |
| 6352 |
well (with the same sequence of letters or numbers following). Either |
| 6353 |
specify this option on the command line, or, if your system supports |
| 6354 |
it, make your script executable and run it directly instead of passing |
| 6355 |
it to perl. |
| 6356 |
.ie n .IP "Too late to run %s block" 4 |
| 6357 |
.el .IP "Too late to run \f(CW%s\fR block" 4 |
| 6358 |
.IX Item "Too late to run %s block" |
| 6359 |
(W void) A CHECK or INIT block is being defined during run time proper, |
| 6360 |
when the opportunity to run them has already passed. Perhaps you are |
| 6361 |
loading a file with \f(CW\*(C`require\*(C'\fR or \f(CW\*(C`do\*(C'\fR when you should be using \f(CW\*(C`use\*(C'\fR |
| 6362 |
instead. Or perhaps you should put the \f(CW\*(C`require\*(C'\fR or \f(CW\*(C`do\*(C'\fR inside a |
| 6363 |
BEGIN block. |
| 6364 |
.IP "Too many args to syscall" 4 |
| 6365 |
.IX Item "Too many args to syscall" |
| 6366 |
(F) Perl supports a maximum of only 14 args to \fBsyscall()\fR. |
| 6367 |
.ie n .IP "Too many arguments for %s" 4 |
| 6368 |
.el .IP "Too many arguments for \f(CW%s\fR" 4 |
| 6369 |
.IX Item "Too many arguments for %s" |
| 6370 |
(F) The function requires fewer arguments than you specified. |
| 6371 |
.ie n .IP "Too many arguments for subroutine '%s' (got %d; expected %d)" 4 |
| 6372 |
.el .IP "Too many arguments for subroutine '%s' (got \f(CW%d\fR; expected \f(CW%d\fR)" 4 |
| 6373 |
.IX Item "Too many arguments for subroutine '%s' (got %d; expected %d)" |
| 6374 |
(F) A subroutine using a signature received more arguments than permitted |
| 6375 |
by the signature. The caller of the subroutine is presumably at fault. |
| 6376 |
.Sp |
| 6377 |
The message attempts to include the name of the called subroutine. If the |
| 6378 |
subroutine has been aliased, the subroutine's original name will be shown, |
| 6379 |
regardless of what name the caller used. It will also indicate the number |
| 6380 |
of arguments given and the number expected. |
| 6381 |
.ie n .IP "Too many arguments for subroutine '%s' (got %d; expected at most %d)" 4 |
| 6382 |
.el .IP "Too many arguments for subroutine '%s' (got \f(CW%d\fR; expected at most \f(CW%d\fR)" 4 |
| 6383 |
.IX Item "Too many arguments for subroutine '%s' (got %d; expected at most %d)" |
| 6384 |
Similar to the previous message but for subroutines that accept a variable |
| 6385 |
number of arguments. |
| 6386 |
.IP "Too many nested open parens in regex; marked by <\-\- HERE in m/%s/" 4 |
| 6387 |
.IX Item "Too many nested open parens in regex; marked by <-- HERE in m/%s/" |
| 6388 |
(F) You have exceeded the number of open \f(CW"("\fR parentheses that haven't |
| 6389 |
been matched by corresponding closing ones. This limit prevents eating |
| 6390 |
up too much memory. It is initially set to 1000, but may be changed by |
| 6391 |
setting \f(CW\*(C`${^RE_COMPILE_RECURSION_LIMIT}\*(C'\fR to some other value. This may |
| 6392 |
need to be done in a BEGIN block before the regular expression pattern |
| 6393 |
is compiled. |
| 6394 |
.ie n .IP "Too many nested BEGIN blocks, maximum of %d allowed" 4 |
| 6395 |
.el .IP "Too many nested BEGIN blocks, maximum of \f(CW%d\fR allowed" 4 |
| 6396 |
.IX Item "Too many nested BEGIN blocks, maximum of %d allowed" |
| 6397 |
(F) You have executed code that nests too many BEGIN blocks inside of |
| 6398 |
each other, either explicitly as BEGIN{} or implicitly as use statements. |
| 6399 |
This limit defaults to a rather high number which should not be exceeded |
| 6400 |
in normal circumstances, and triggering likely indicates something is |
| 6401 |
very wrong in your code. For instance infinite recursion of eval and |
| 6402 |
BEGIN blocks is known to trigger this error. |
| 6403 |
.Sp |
| 6404 |
If you know that you have good reason to exceed the limit you can change |
| 6405 |
it by setting \f(CW\*(C`${^MAX_NESTED_EVAL_BEGIN_BLOCKS}\*(C'\fR to a different value from |
| 6406 |
the default of 1000. |
| 6407 |
.ie n .IP "Too many capture groups (limit is %d) in regex m/%s/" 4 |
| 6408 |
.el .IP "Too many capture groups (limit is \f(CW%d\fR) in regex m/%s/" 4 |
| 6409 |
.IX Item "Too many capture groups (limit is %d) in regex m/%s/" |
| 6410 |
(F) You have too many capture groups in your regex pattern. You need to rework |
| 6411 |
your pattern to use less capture groups. |
| 6412 |
.IP "Too many )'s" 4 |
| 6413 |
.IX Item "Too many )'s" |
| 6414 |
(A) You've accidentally run your script through \fBcsh\fR instead of Perl. |
| 6415 |
Check the #! line, or manually feed your script into Perl yourself. |
| 6416 |
.IP "Too many ('s" 4 |
| 6417 |
.IX Item "Too many ('s" |
| 6418 |
(A) You've accidentally run your script through \fBcsh\fR instead of Perl. |
| 6419 |
Check the #! line, or manually feed your script into Perl yourself. |
| 6420 |
.IP "Trailing \e in regex m/%s/" 4 |
| 6421 |
.IX Item "Trailing in regex m/%s/" |
| 6422 |
(F) The regular expression ends with an unbackslashed backslash. |
| 6423 |
Backslash it. See perlre. |
| 6424 |
.IP "Transliteration pattern not terminated" 4 |
| 6425 |
.IX Item "Transliteration pattern not terminated" |
| 6426 |
(F) The lexer couldn't find the interior delimiter of a tr/// or tr[][] |
| 6427 |
or y/// or y[][] construct. Missing the leading \f(CW\*(C`$\*(C'\fR from variables |
| 6428 |
\&\f(CW$tr\fR or \f(CW$y\fR may cause this error. |
| 6429 |
.IP "Transliteration replacement not terminated" 4 |
| 6430 |
.IX Item "Transliteration replacement not terminated" |
| 6431 |
(F) The lexer couldn't find the final delimiter of a tr///, tr[][], |
| 6432 |
y/// or y[][] construct. |
| 6433 |
.ie n .IP "Treating %s::INIT block as BEGIN block as workaround" 4 |
| 6434 |
.el .IP "Treating \f(CW%s::INIT\fR block as BEGIN block as workaround" 4 |
| 6435 |
.IX Item "Treating %s::INIT block as BEGIN block as workaround" |
| 6436 |
(S) A package is using an old version of \f(CW\*(C`Module::Install::DSL\*(C'\fR to |
| 6437 |
install, which makes unsafe assumptions about when INIT blocks will be |
| 6438 |
called. Because \f(CW\*(C`Module::Install::DSL\*(C'\fR is used to install other modules |
| 6439 |
and is difficult to upgrade we have a special workaround in place to |
| 6440 |
deal with this. Unless you are a maintainer of an affected module you |
| 6441 |
can ignore this warning. We emit it only as a sanity check. |
| 6442 |
.IP "'%s' trapped by operation mask" 4 |
| 6443 |
.IX Item "'%s' trapped by operation mask" |
| 6444 |
(F) You tried to use an operator from a Safe compartment in which it's |
| 6445 |
disallowed. See Safe. |
| 6446 |
.IP "truncate not implemented" 4 |
| 6447 |
.IX Item "truncate not implemented" |
| 6448 |
(F) Your machine doesn't implement a file truncation mechanism that |
| 6449 |
Configure knows about. |
| 6450 |
.IP "try/catch/finally is experimental" 4 |
| 6451 |
.IX Item "try/catch/finally is experimental" |
| 6452 |
(S experimental::try) This warning is emitted if you use the \f(CW\*(C`try\*(C'\fR and |
| 6453 |
\&\f(CW\*(C`catch\*(C'\fR syntax with a \f(CW\*(C`finally\*(C'\fR block. This syntax is currently experimental |
| 6454 |
and its behaviour may change in future releases of Perl. |
| 6455 |
.ie n .IP "Type of arg %d to &CORE::%s must be %s" 4 |
| 6456 |
.el .IP "Type of arg \f(CW%d\fR to &CORE::%s must be \f(CW%s\fR" 4 |
| 6457 |
.IX Item "Type of arg %d to &CORE::%s must be %s" |
| 6458 |
(F) The subroutine in question in the CORE package requires its argument |
| 6459 |
to be a hard reference to data of the specified type. Overloading is |
| 6460 |
ignored, so a reference to an object that is not the specified type, but |
| 6461 |
nonetheless has overloading to handle it, will still not be accepted. |
| 6462 |
.ie n .IP "Type of arg %d to %s must be %s (not %s)" 4 |
| 6463 |
.el .IP "Type of arg \f(CW%d\fR to \f(CW%s\fR must be \f(CW%s\fR (not \f(CW%s\fR)" 4 |
| 6464 |
.IX Item "Type of arg %d to %s must be %s (not %s)" |
| 6465 |
(F) This function requires the argument in that position to be of a |
| 6466 |
certain type. Arrays must be \f(CW@NAME\fR or \f(CW\*(C`@{EXPR}\*(C'\fR. Hashes must be |
| 6467 |
\&\f(CW%NAME\fR or \f(CW\*(C`%{EXPR}\*(C'\fR. No implicit dereferencing is allowed\-\-use the |
| 6468 |
{EXPR} forms as an explicit dereference. See perlref. |
| 6469 |
.IP "umask not implemented" 4 |
| 6470 |
.IX Item "umask not implemented" |
| 6471 |
(F) Your machine doesn't implement the umask function and you tried to |
| 6472 |
use it to restrict permissions for yourself (EXPR & 0700). |
| 6473 |
.IP "UNIVERSAL does not export anything" 4 |
| 6474 |
.IX Item "UNIVERSAL does not export anything" |
| 6475 |
(F) You asked UNIVERSAL to export something, but UNIVERSAL is the |
| 6476 |
base class for all classes and contains no exportable symbols. |
| 6477 |
.ie n .IP "Unbalanced context: %d more PUSHes than POPs" 4 |
| 6478 |
.el .IP "Unbalanced context: \f(CW%d\fR more PUSHes than POPs" 4 |
| 6479 |
.IX Item "Unbalanced context: %d more PUSHes than POPs" |
| 6480 |
(S internal) The exit code detected an internal inconsistency in how |
| 6481 |
many execution contexts were entered and left. |
| 6482 |
.ie n .IP "Unbalanced saves: %d more saves than restores" 4 |
| 6483 |
.el .IP "Unbalanced saves: \f(CW%d\fR more saves than restores" 4 |
| 6484 |
.IX Item "Unbalanced saves: %d more saves than restores" |
| 6485 |
(S internal) The exit code detected an internal inconsistency in how |
| 6486 |
many values were temporarily localized. |
| 6487 |
.ie n .IP "Unbalanced scopes: %d more ENTERs than LEAVEs" 4 |
| 6488 |
.el .IP "Unbalanced scopes: \f(CW%d\fR more ENTERs than LEAVEs" 4 |
| 6489 |
.IX Item "Unbalanced scopes: %d more ENTERs than LEAVEs" |
| 6490 |
(S internal) The exit code detected an internal inconsistency in how |
| 6491 |
many blocks were entered and left. |
| 6492 |
.IP "Unbalanced string table refcount: (%d) for ""%s""" 4 |
| 6493 |
.IX Item "Unbalanced string table refcount: (%d) for ""%s""" |
| 6494 |
(S internal) On exit, Perl found some strings remaining in the shared |
| 6495 |
string table used for copy on write and for hash keys. The entries |
| 6496 |
should have been freed, so this indicates a bug somewhere. |
| 6497 |
.ie n .IP "Unbalanced tmps: %d more allocs than frees" 4 |
| 6498 |
.el .IP "Unbalanced tmps: \f(CW%d\fR more allocs than frees" 4 |
| 6499 |
.IX Item "Unbalanced tmps: %d more allocs than frees" |
| 6500 |
(S internal) The exit code detected an internal inconsistency in how |
| 6501 |
many mortal scalars were allocated and freed. |
| 6502 |
.IP "Undefined format ""%s"" called" 4 |
| 6503 |
.IX Item "Undefined format ""%s"" called" |
| 6504 |
(F) The format indicated doesn't seem to exist. Perhaps it's really in |
| 6505 |
another package? See perlform. |
| 6506 |
.IP "Undefined sort subroutine ""%s"" called" 4 |
| 6507 |
.IX Item "Undefined sort subroutine ""%s"" called" |
| 6508 |
(F) The sort comparison routine specified doesn't seem to exist. |
| 6509 |
Perhaps it's in a different package? See "sort" in perlfunc. |
| 6510 |
.IP "Undefined subroutine &%s called" 4 |
| 6511 |
.IX Item "Undefined subroutine &%s called" |
| 6512 |
(F) The subroutine indicated hasn't been defined, or if it was, it has |
| 6513 |
since been undefined. |
| 6514 |
.IP "Undefined subroutine called" 4 |
| 6515 |
.IX Item "Undefined subroutine called" |
| 6516 |
(F) The anonymous subroutine you're trying to call hasn't been defined, |
| 6517 |
or if it was, it has since been undefined. |
| 6518 |
.IP "Undefined subroutine in sort" 4 |
| 6519 |
.IX Item "Undefined subroutine in sort" |
| 6520 |
(F) The sort comparison routine specified is declared but doesn't seem |
| 6521 |
to have been defined yet. See "sort" in perlfunc. |
| 6522 |
.IP "Undefined top format ""%s"" called" 4 |
| 6523 |
.IX Item "Undefined top format ""%s"" called" |
| 6524 |
(F) The format indicated doesn't seem to exist. Perhaps it's really in |
| 6525 |
another package? See perlform. |
| 6526 |
.IP "Undefined value assigned to typeglob" 4 |
| 6527 |
.IX Item "Undefined value assigned to typeglob" |
| 6528 |
(W misc) An undefined value was assigned to a typeglob, a la |
| 6529 |
\&\f(CW\*(C`*foo = undef\*(C'\fR. This does nothing. It's possible that you really mean |
| 6530 |
\&\f(CW\*(C`undef *foo\*(C'\fR. |
| 6531 |
.ie n .IP "%s: Undefined variable" 4 |
| 6532 |
.el .IP "\f(CW%s:\fR Undefined variable" 4 |
| 6533 |
.IX Item "%s: Undefined variable" |
| 6534 |
(A) You've accidentally run your script through \fBcsh\fR instead of Perl. |
| 6535 |
Check the #! line, or manually feed your script into Perl yourself. |
| 6536 |
.IP "Unescaped left brace in regex is illegal here in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6537 |
.IX Item "Unescaped left brace in regex is illegal here in regex; marked by <--\ HERE in m/%s/" |
| 6538 |
(F) The simple rule to remember, if you want to |
| 6539 |
match a literal \f(CW"{"\fR character (U+007B \f(CW\*(C`LEFT CURLY BRACKET\*(C'\fR) in a |
| 6540 |
regular expression pattern, is to escape each literal instance of it in |
| 6541 |
some way. Generally easiest is to precede it with a backslash, like |
| 6542 |
\&\f(CW"\e{"\fR or enclose it in square brackets (\f(CW"[{]"\fR). If the pattern |
| 6543 |
delimiters are also braces, any matching right brace (\f(CW"}"\fR) should |
| 6544 |
also be escaped to avoid confusing the parser, for example, |
| 6545 |
.Sp |
| 6546 |
.Vb 1 |
| 6547 |
\& qr{abc\e{def\e}ghi} |
| 6548 |
.Ve |
| 6549 |
.Sp |
| 6550 |
Forcing literal \f(CW"{"\fR characters to be escaped enables the Perl |
| 6551 |
language to be extended in various ways in future releases. To avoid |
| 6552 |
needlessly breaking existing code, the restriction is not enforced in |
| 6553 |
contexts where there are unlikely to ever be extensions that could |
| 6554 |
conflict with the use there of \f(CW"{"\fR as a literal. Those that are |
| 6555 |
not potentially ambiguous do not warn; those that are do raise a |
| 6556 |
non-deprecation warning. |
| 6557 |
.Sp |
| 6558 |
The contexts where no warnings or errors are raised are: |
| 6559 |
.RS 4 |
| 6560 |
.IP \(bu 4 |
| 6561 |
as the first character in a pattern, or following \f(CW"^"\fR indicating to |
| 6562 |
anchor the match to the beginning of a line. |
| 6563 |
.IP \(bu 4 |
| 6564 |
as the first character following a \f(CW"|"\fR indicating alternation. |
| 6565 |
.IP \(bu 4 |
| 6566 |
as the first character in a parenthesized grouping like |
| 6567 |
.Sp |
| 6568 |
.Vb 2 |
| 6569 |
\& /foo({bar)/ |
| 6570 |
\& /foo(?:{bar)/ |
| 6571 |
.Ve |
| 6572 |
.IP \(bu 4 |
| 6573 |
as the first character following a quantifier |
| 6574 |
.Sp |
| 6575 |
.Vb 1 |
| 6576 |
\& /\es*{/ |
| 6577 |
.Ve |
| 6578 |
.RE |
| 6579 |
.RS 4 |
| 6580 |
.RE |
| 6581 |
.IP "Unescaped left brace in regex is passed through in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6582 |
.IX Item "Unescaped left brace in regex is passed through in regex; marked by <--\ HERE in m/%s/" |
| 6583 |
(W regexp) The simple rule to remember, if you want to |
| 6584 |
match a literal \f(CW"{"\fR character (U+007B \f(CW\*(C`LEFT CURLY BRACKET\*(C'\fR) in a |
| 6585 |
regular expression pattern, is to escape each literal instance of it in |
| 6586 |
some way. Generally easiest is to precede it with a backslash, like |
| 6587 |
\&\f(CW"\e{"\fR or enclose it in square brackets (\f(CW"[{]"\fR). If the pattern |
| 6588 |
delimiters are also braces, any matching right brace (\f(CW"}"\fR) should |
| 6589 |
also be escaped to avoid confusing the parser, for example, |
| 6590 |
.Sp |
| 6591 |
.Vb 1 |
| 6592 |
\& qr{abc\e{def\e}ghi} |
| 6593 |
.Ve |
| 6594 |
.Sp |
| 6595 |
Forcing literal \f(CW"{"\fR characters to be escaped enables the Perl |
| 6596 |
language to be extended in various ways in future releases. To avoid |
| 6597 |
needlessly breaking existing code, the restriction is not enforced in |
| 6598 |
contexts where there are unlikely to ever be extensions that could |
| 6599 |
conflict with the use there of \f(CW"{"\fR as a literal. Those that are |
| 6600 |
not potentially ambiguous do not warn; those that are raise this |
| 6601 |
warning. This makes sure that an inadvertent typo doesn't silently |
| 6602 |
cause the pattern to compile to something unintended. |
| 6603 |
.Sp |
| 6604 |
The contexts where no warnings or errors are raised are: |
| 6605 |
.RS 4 |
| 6606 |
.IP \(bu 4 |
| 6607 |
as the first character in a pattern, or following \f(CW"^"\fR indicating to |
| 6608 |
anchor the match to the beginning of a line. |
| 6609 |
.IP \(bu 4 |
| 6610 |
as the first character following a \f(CW"|"\fR indicating alternation. |
| 6611 |
.IP \(bu 4 |
| 6612 |
as the first character in a parenthesized grouping like |
| 6613 |
.Sp |
| 6614 |
.Vb 2 |
| 6615 |
\& /foo({bar)/ |
| 6616 |
\& /foo(?:{bar)/ |
| 6617 |
.Ve |
| 6618 |
.IP \(bu 4 |
| 6619 |
as the first character following a quantifier |
| 6620 |
.Sp |
| 6621 |
.Vb 1 |
| 6622 |
\& /\es*{/ |
| 6623 |
.Ve |
| 6624 |
.RE |
| 6625 |
.RS 4 |
| 6626 |
.RE |
| 6627 |
.IP "Unescaped literal '%c' in regex; marked by <\-\- HERE in m/%s/" 4 |
| 6628 |
.IX Item "Unescaped literal '%c' in regex; marked by <-- HERE in m/%s/" |
| 6629 |
(W regexp) (only under \f(CW\*(C`use\ re\ \*(Aqstrict\*(Aq\*(C'\fR) |
| 6630 |
.Sp |
| 6631 |
Within the scope of \f(CW\*(C`use\ re\ \*(Aqstrict\*(Aq\*(C'\fR in a regular expression |
| 6632 |
pattern, you included an unescaped \f(CW\*(C`}\*(C'\fR or \f(CW\*(C`]\*(C'\fR which was interpreted |
| 6633 |
literally. These two characters are sometimes metacharacters, and |
| 6634 |
sometimes literals, depending on what precedes them in the |
| 6635 |
pattern. This is unlike the similar \f(CW\*(C`)\*(C'\fR which is always a |
| 6636 |
metacharacter unless escaped. |
| 6637 |
.Sp |
| 6638 |
This action at a distance, perhaps a large distance, can lead to Perl |
| 6639 |
silently misinterpreting what you meant, so when you specify that you |
| 6640 |
want extra checking by \f(CW\*(C`use\ re\ \*(Aqstrict\*(Aq\*(C'\fR, this warning is generated. |
| 6641 |
If you meant the character as a literal, simply confirm that to Perl by |
| 6642 |
preceding the character with a backslash, or make it into a bracketed |
| 6643 |
character class (like \f(CW\*(C`[}]\*(C'\fR). If you meant it as closing a |
| 6644 |
corresponding \f(CW\*(C`[\*(C'\fR or \f(CW\*(C`{\*(C'\fR, you'll need to look back through the pattern |
| 6645 |
to find out why that isn't happening. |
| 6646 |
.ie n .IP "unexec of %s into %s failed!" 4 |
| 6647 |
.el .IP "unexec of \f(CW%s\fR into \f(CW%s\fR failed!" 4 |
| 6648 |
.IX Item "unexec of %s into %s failed!" |
| 6649 |
(F) The \fBunexec()\fR routine failed for some reason. See your local FSF |
| 6650 |
representative, who probably put it there in the first place. |
| 6651 |
.IP "Unexpected binary operator '%c' with no preceding operand in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6652 |
.IX Item "Unexpected binary operator '%c' with no preceding operand in regex; marked by <--\ HERE in m/%s/" |
| 6653 |
(F) You had something like this: |
| 6654 |
.Sp |
| 6655 |
.Vb 1 |
| 6656 |
\& (?[ | \ep{Digit} ]) |
| 6657 |
.Ve |
| 6658 |
.Sp |
| 6659 |
where the \f(CW"|"\fR is a binary operator with an operand on the right, but |
| 6660 |
no operand on the left. |
| 6661 |
.IP "Unexpected character in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6662 |
.IX Item "Unexpected character in regex; marked by <--\ HERE in m/%s/" |
| 6663 |
(F) You had something like this: |
| 6664 |
.Sp |
| 6665 |
.Vb 1 |
| 6666 |
\& (?[ z ]) |
| 6667 |
.Ve |
| 6668 |
.Sp |
| 6669 |
Within \f(CW\*(C`(?[ ])\*(C'\fR, no literal characters are allowed unless they are |
| 6670 |
within an inner pair of square brackets, like |
| 6671 |
.Sp |
| 6672 |
.Vb 1 |
| 6673 |
\& (?[ [ z ] ]) |
| 6674 |
.Ve |
| 6675 |
.Sp |
| 6676 |
Another possibility is that you forgot a backslash. Perl isn't smart |
| 6677 |
enough to figure out what you really meant. |
| 6678 |
.ie n .IP "Unexpected characters while parsing class :isa attribute: %s" 4 |
| 6679 |
.el .IP "Unexpected characters while parsing class :isa attribute: \f(CW%s\fR" 4 |
| 6680 |
.IX Item "Unexpected characters while parsing class :isa attribute: %s" |
| 6681 |
(F) You tried to specify something other than a single class name with an |
| 6682 |
optional trailing verison number as the value for a \f(CW\*(C`class\*(C'\fR \f(CW\*(C`:isa\*(C'\fR |
| 6683 |
attribute. This confused the parser. |
| 6684 |
.ie n .IP "Unexpected exit %u" 4 |
| 6685 |
.el .IP "Unexpected exit \f(CW%u\fR" 4 |
| 6686 |
.IX Item "Unexpected exit %u" |
| 6687 |
(S) \fBexit()\fR was called or the script otherwise finished gracefully when |
| 6688 |
\&\f(CW\*(C`PERL_EXIT_WARN\*(C'\fR was set in \f(CW\*(C`PL_exit_flags\*(C'\fR. |
| 6689 |
.ie n .IP "Unexpected exit failure %d" 4 |
| 6690 |
.el .IP "Unexpected exit failure \f(CW%d\fR" 4 |
| 6691 |
.IX Item "Unexpected exit failure %d" |
| 6692 |
(S) An uncaught \fBdie()\fR was called when \f(CW\*(C`PERL_EXIT_WARN\*(C'\fR was set in |
| 6693 |
\&\f(CW\*(C`PL_exit_flags\*(C'\fR. |
| 6694 |
.IP "Unexpected ')' in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6695 |
.IX Item "Unexpected ')' in regex; marked by <--\ HERE in m/%s/" |
| 6696 |
(F) You had something like this: |
| 6697 |
.Sp |
| 6698 |
.Vb 1 |
| 6699 |
\& (?[ ( \ep{Digit} + ) ]) |
| 6700 |
.Ve |
| 6701 |
.Sp |
| 6702 |
The \f(CW")"\fR is out-of-place. Something apparently was supposed to |
| 6703 |
be combined with the digits, or the \f(CW"+"\fR shouldn't be there, or |
| 6704 |
something like that. Perl can't figure out what was intended. |
| 6705 |
.IP "Unexpected ']' with no following ')' in (?[... in regex; marked by <\-\- HERE in m/%s/" 4 |
| 6706 |
.IX Item "Unexpected ']' with no following ')' in (?[... in regex; marked by <-- HERE in m/%s/" |
| 6707 |
(F) While parsing an extended character class a ']' character was |
| 6708 |
encountered at a point in the definition where the only legal use of |
| 6709 |
\&']' is to close the character class definition as part of a '])', you |
| 6710 |
may have forgotten the close paren, or otherwise confused the parser. |
| 6711 |
.IP "Unexpected '(' with no preceding operator in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6712 |
.IX Item "Unexpected '(' with no preceding operator in regex; marked by <--\ HERE in m/%s/" |
| 6713 |
(F) You had something like this: |
| 6714 |
.Sp |
| 6715 |
.Vb 1 |
| 6716 |
\& (?[ \ep{Digit} ( \ep{Lao} + \ep{Thai} ) ]) |
| 6717 |
.Ve |
| 6718 |
.Sp |
| 6719 |
There should be an operator before the \f(CW"("\fR, as there's |
| 6720 |
no indication as to how the digits are to be combined |
| 6721 |
with the characters in the Lao and Thai scripts. |
| 6722 |
.IP "Unicode non-character U+%X is not recommended for open interchange" 4 |
| 6723 |
.IX Item "Unicode non-character U+%X is not recommended for open interchange" |
| 6724 |
(S nonchar) Certain codepoints, such as U+FFFE and U+FFFF, are |
| 6725 |
defined by the Unicode standard to be non-characters. Those |
| 6726 |
are legal codepoints, but are reserved for internal use; so, |
| 6727 |
applications shouldn't attempt to exchange them. An application |
| 6728 |
may not be expecting any of these characters at all, and receiving |
| 6729 |
them may lead to bugs. If you know what you are doing you can |
| 6730 |
turn off this warning by \f(CW\*(C`no warnings \*(Aqnonchar\*(Aq;\*(C'\fR. |
| 6731 |
.Sp |
| 6732 |
This is not really a "severe" error, but it is supposed to be |
| 6733 |
raised by default even if warnings are not enabled, and currently |
| 6734 |
the only way to do that in Perl is to mark it as serious. |
| 6735 |
.IP "Unicode property wildcard not terminated" 4 |
| 6736 |
.IX Item "Unicode property wildcard not terminated" |
| 6737 |
(F) A Unicode property wildcard looks like a delimited regular |
| 6738 |
expression pattern (all within the braces of the enclosing \f(CW\*(C`\ep{...}\*(C'\fR. |
| 6739 |
The closing delimtter to match the opening one was not found. If the |
| 6740 |
opening one is escaped by preceding it with a backslash, the closing one |
| 6741 |
must also be so escaped. |
| 6742 |
.IP "Unicode string properties are not implemented in (?[...]) in regex; marked by <\-\- HERE in m/%s/" 4 |
| 6743 |
.IX Item "Unicode string properties are not implemented in (?[...]) in regex; marked by <-- HERE in m/%s/" |
| 6744 |
(F) A Unicode string property is one which expands to a sequence of |
| 6745 |
multiple characters. An example is \f(CW\*(C`\ep{name=KATAKANA LETTER AINU P}\*(C'\fR, |
| 6746 |
which consists of the sequence \f(CW\*(C`\eN{KATAKANA LETTER SMALL H}\*(C'\fR |
| 6747 |
followed by \f(CW\*(C`\eN{COMBINING KATAKANA\-HIRAGANA SEMI\-VOICED SOUND MARK}\*(C'\fR. |
| 6748 |
Extended character classes, \f(CW\*(C`(?[...])\*(C'\fR currently cannot handle these. |
| 6749 |
.IP "Unicode surrogate U+%X is illegal in UTF\-8" 4 |
| 6750 |
.IX Item "Unicode surrogate U+%X is illegal in UTF-8" |
| 6751 |
(S surrogate) You had a UTF\-16 surrogate in a context where they are |
| 6752 |
not considered acceptable. These code points, between U+D800 and |
| 6753 |
U+DFFF (inclusive), are used by Unicode only for UTF\-16. However, Perl |
| 6754 |
internally allows all unsigned integer code points (up to the size limit |
| 6755 |
available on your platform), including surrogates. But these can cause |
| 6756 |
problems when being input or output, which is likely where this message |
| 6757 |
came from. If you really really know what you are doing you can turn |
| 6758 |
off this warning by \f(CW\*(C`no warnings \*(Aqsurrogate\*(Aq;\*(C'\fR. |
| 6759 |
.IP Unimplemented 4 |
| 6760 |
.IX Item "Unimplemented" |
| 6761 |
(F) In Perl 5.12 and above, you have executed an |
| 6762 |
ellipsis statement. This is a |
| 6763 |
bare \f(CW\*(C`...;\*(C'\fR, meant to be used to allow you to outline code that |
| 6764 |
is to be written, but is not complete, similar to the following: |
| 6765 |
.Sp |
| 6766 |
.Vb 4 |
| 6767 |
\& sub not_done_yet { |
| 6768 |
\& my($self, $arg1, $arg2) = @_; |
| 6769 |
\& ... |
| 6770 |
\& } |
| 6771 |
.Ve |
| 6772 |
.Sp |
| 6773 |
If \f(CWnot_done_yet()\fR is called, Perl will die with an \f(CW\*(C`Unimplemented\*(C'\fR error |
| 6774 |
at the line containing \f(CW\*(C`...\*(C'\fR. |
| 6775 |
.IP "Unknown charname '%s'" 4 |
| 6776 |
.IX Item "Unknown charname '%s'" |
| 6777 |
(F) The name you used inside \f(CW\*(C`\eN{}\*(C'\fR is unknown to Perl. Check the |
| 6778 |
spelling. You can say \f(CW\*(C`use charnames ":loose"\*(C'\fR to not have to be |
| 6779 |
so precise about spaces, hyphens, and capitalization on standard Unicode |
| 6780 |
names. (Any custom aliases that have been created must be specified |
| 6781 |
exactly, regardless of whether \f(CW\*(C`:loose\*(C'\fR is used or not.) This error may |
| 6782 |
also happen if the \f(CW\*(C`\eN{}\*(C'\fR is not in the scope of the corresponding |
| 6783 |
\&\f(CW\*(C`use\ charnames\*(C'\fR. |
| 6784 |
.IP "Unknown '(*...)' construct '%s' in regex; marked by <\-\- HERE in m/%s/" 4 |
| 6785 |
.IX Item "Unknown '(*...)' construct '%s' in regex; marked by <-- HERE in m/%s/" |
| 6786 |
(F) The \f(CW\*(C`(*\*(C'\fR was followed by something that the regular expression |
| 6787 |
compiler does not recognize. Check your spelling. |
| 6788 |
.IP "Unknown error" 4 |
| 6789 |
.IX Item "Unknown error" |
| 6790 |
(P) Perl was about to print an error message in \f(CW$@\fR, but the \f(CW$@\fR variable |
| 6791 |
did not exist, even after an attempt to create it. |
| 6792 |
.ie n .IP "Unknown locale category %d" 4 |
| 6793 |
.el .IP "Unknown locale category \f(CW%d\fR" 4 |
| 6794 |
.IX Item "Unknown locale category %d" |
| 6795 |
.PD 0 |
| 6796 |
.ie n .IP "Unknown locale category %d; can't set it to %s" 4 |
| 6797 |
.el .IP "Unknown locale category \f(CW%d\fR; can't set it to \f(CW%s\fR" 4 |
| 6798 |
.IX Item "Unknown locale category %d; can't set it to %s" |
| 6799 |
.PD |
| 6800 |
(W locale) You used a locale category that perl doesn't recognize, so it |
| 6801 |
cannot carry out your request. Check that you are using a valid |
| 6802 |
category. If so, see "Multi-threaded" in perllocale for advice on |
| 6803 |
reporting this as a bug, and for modifying perl locally to accommodate |
| 6804 |
your needs. |
| 6805 |
.IP "Unknown \fBopen()\fR mode '%s'" 4 |
| 6806 |
.IX Item "Unknown open() mode '%s'" |
| 6807 |
(F) The second argument of 3\-argument \fBopen()\fR is not among the list |
| 6808 |
of valid modes: \f(CW\*(C`<\*(C'\fR, \f(CW\*(C`>\*(C'\fR, \f(CW\*(C`>>\*(C'\fR, \f(CW\*(C`+<\*(C'\fR, |
| 6809 |
\&\f(CW\*(C`+>\*(C'\fR, \f(CW\*(C`+>>\*(C'\fR, \f(CW\*(C`\-|\*(C'\fR, \f(CW\*(C`|\-\*(C'\fR, \f(CW\*(C`<&\*(C'\fR, \f(CW\*(C`>&\*(C'\fR. |
| 6810 |
.IP "Unknown PerlIO layer ""%s""" 4 |
| 6811 |
.IX Item "Unknown PerlIO layer ""%s""" |
| 6812 |
(W layer) An attempt was made to push an unknown layer onto the Perl I/O |
| 6813 |
system. (Layers take care of transforming data between external and |
| 6814 |
internal representations.) Note that some layers, such as \f(CW\*(C`mmap\*(C'\fR, |
| 6815 |
are not supported in all environments. If your program didn't |
| 6816 |
explicitly request the failing operation, it may be the result of the |
| 6817 |
value of the environment variable PERLIO. |
| 6818 |
.ie n .IP "Unknown process %x sent message to prime_env_iter: %s" 4 |
| 6819 |
.el .IP "Unknown process \f(CW%x\fR sent message to prime_env_iter: \f(CW%s\fR" 4 |
| 6820 |
.IX Item "Unknown process %x sent message to prime_env_iter: %s" |
| 6821 |
(P) An error peculiar to VMS. Perl was reading values for \f(CW%ENV\fR before |
| 6822 |
iterating over it, and someone else stuck a message in the stream of |
| 6823 |
data Perl expected. Someone's very confused, or perhaps trying to |
| 6824 |
subvert Perl's population of \f(CW%ENV\fR for nefarious purposes. |
| 6825 |
.IP "Unknown regexp modifier ""/%s""" 4 |
| 6826 |
.IX Item "Unknown regexp modifier ""/%s""" |
| 6827 |
(F) Alphanumerics immediately following the closing delimiter |
| 6828 |
of a regular expression pattern are interpreted by Perl as modifier |
| 6829 |
flags for the regex. One of the ones you specified is invalid. One way |
| 6830 |
this can happen is if you didn't put in white space between the end of |
| 6831 |
the regex and a following alphanumeric operator: |
| 6832 |
.Sp |
| 6833 |
.Vb 1 |
| 6834 |
\& if ($x =~ /foo/and $bar == 3) { ... } |
| 6835 |
.Ve |
| 6836 |
.Sp |
| 6837 |
The \f(CW"a"\fR is a valid modifier flag, but the \f(CW"n"\fR is not, and raises |
| 6838 |
this error. Likely what was meant instead was: |
| 6839 |
.Sp |
| 6840 |
.Vb 1 |
| 6841 |
\& if ($x =~ /foo/ and $bar == 3) { ... } |
| 6842 |
.Ve |
| 6843 |
.ie n .IP "Unknown ""re"" subpragma '%s' (known ones are: %s)" 4 |
| 6844 |
.el .IP "Unknown ""re"" subpragma '%s' (known ones are: \f(CW%s\fR)" 4 |
| 6845 |
.IX Item "Unknown ""re"" subpragma '%s' (known ones are: %s)" |
| 6846 |
(W) You tried to use an unknown subpragma of the "re" pragma. |
| 6847 |
.IP "Unknown switch condition (?(...)) in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6848 |
.IX Item "Unknown switch condition (?(...)) in regex; marked by <--\ HERE in m/%s/" |
| 6849 |
(F) The condition part of a (?(condition)if\-clause|else\-clause) construct |
| 6850 |
is not known. The condition must be one of the following: |
| 6851 |
.Sp |
| 6852 |
.Vb 10 |
| 6853 |
\& (1) (2) ... true if 1st, 2nd, etc., capture matched |
| 6854 |
\& (<NAME>) (\*(AqNAME\*(Aq) true if named capture matched |
| 6855 |
\& (?=...) (?<=...) true if subpattern matches |
| 6856 |
\& (*pla:...) (*plb:...) true if subpattern matches; also |
| 6857 |
\& (*positive_lookahead:...) |
| 6858 |
\& (*positive_lookbehind:...) |
| 6859 |
\& (*nla:...) (*nlb:...) true if subpattern fails to match; also |
| 6860 |
\& (*negative_lookahead:...) |
| 6861 |
\& (*negative_lookbehind:...) |
| 6862 |
\& (?{ CODE }) true if code returns a true value |
| 6863 |
\& (R) true if evaluating inside recursion |
| 6864 |
\& (R1) (R2) ... true if directly inside capture group 1, 2, |
| 6865 |
\& etc. |
| 6866 |
\& (R&NAME) true if directly inside named capture |
| 6867 |
\& (DEFINE) always false; for defining named subpatterns |
| 6868 |
.Ve |
| 6869 |
.Sp |
| 6870 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 6871 |
discovered. See perlre. |
| 6872 |
.IP "Unknown Unicode option letter '%c'" 4 |
| 6873 |
.IX Item "Unknown Unicode option letter '%c'" |
| 6874 |
(F) You specified an unknown Unicode option. See |
| 6875 |
perlrun documentation of the \f(CW\*(C`\-C\*(C'\fR switch |
| 6876 |
for the list of known options. |
| 6877 |
.ie n .IP "Unknown Unicode option value %d" 4 |
| 6878 |
.el .IP "Unknown Unicode option value \f(CW%d\fR" 4 |
| 6879 |
.IX Item "Unknown Unicode option value %d" |
| 6880 |
(F) You specified an unknown Unicode option. See |
| 6881 |
perlrun documentation of the \f(CW\*(C`\-C\*(C'\fR switch |
| 6882 |
for the list of known options. |
| 6883 |
.IP "Unknown user-defined property name \ep{%s}" 4 |
| 6884 |
.IX Item "Unknown user-defined property name p{%s}" |
| 6885 |
(F) You specified to use a property within the \f(CW\*(C`\ep{...}\*(C'\fR which was a |
| 6886 |
syntactically valid user-defined property, but no definition was found |
| 6887 |
for it by the time one was required to proceed. Check your spelling. |
| 6888 |
See "User-Defined Character Properties" in perlunicode. |
| 6889 |
.IP "Unknown verb pattern '%s' in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6890 |
.IX Item "Unknown verb pattern '%s' in regex; marked by <--\ HERE in m/%s/" |
| 6891 |
(F) You either made a typo or have incorrectly put a \f(CW\*(C`*\*(C'\fR quantifier |
| 6892 |
after an open brace in your pattern. Check the pattern and review |
| 6893 |
perlre for details on legal verb patterns. |
| 6894 |
.IP "Unknown warnings category '%s'" 4 |
| 6895 |
.IX Item "Unknown warnings category '%s'" |
| 6896 |
(F) An error issued by the \f(CW\*(C`warnings\*(C'\fR pragma. You specified a warnings |
| 6897 |
category that is unknown to perl at this point. |
| 6898 |
.Sp |
| 6899 |
Note that if you want to enable a warnings category registered by a |
| 6900 |
module (e.g. \f(CW\*(C`use warnings \*(AqFile::Find\*(Aq\*(C'\fR), you must have loaded this |
| 6901 |
module first. |
| 6902 |
.IP "Unmatched [ in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6903 |
.IX Item "Unmatched [ in regex; marked by <--\ HERE in m/%s/" |
| 6904 |
(F) The brackets around a character class must match. If you wish to |
| 6905 |
include a closing bracket in a character class, backslash it or put it |
| 6906 |
first. The <\-\-\ HERE shows whereabouts in the regular expression the |
| 6907 |
problem was discovered. See perlre. |
| 6908 |
.IP "Unmatched ( in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6909 |
.IX Item "Unmatched ( in regex; marked by <--\ HERE in m/%s/" |
| 6910 |
.PD 0 |
| 6911 |
.IP "Unmatched ) in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6912 |
.IX Item "Unmatched ) in regex; marked by <--\ HERE in m/%s/" |
| 6913 |
.PD |
| 6914 |
(F) Unbackslashed parentheses must always be balanced in regular |
| 6915 |
expressions. If you're a vi user, the % key is valuable for finding |
| 6916 |
the matching parenthesis. The <\-\-\ HERE shows whereabouts in the |
| 6917 |
regular expression the problem was discovered. See perlre. |
| 6918 |
.ie n .IP "Unmatched right %s bracket" 4 |
| 6919 |
.el .IP "Unmatched right \f(CW%s\fR bracket" 4 |
| 6920 |
.IX Item "Unmatched right %s bracket" |
| 6921 |
(F) The lexer counted more closing curly or square brackets than opening |
| 6922 |
ones, so you're probably missing a matching opening bracket. As a |
| 6923 |
general rule, you'll find the missing one (so to speak) near the place |
| 6924 |
you were last editing. |
| 6925 |
.IP "Unquoted string ""%s"" may clash with future reserved word" 4 |
| 6926 |
.IX Item "Unquoted string ""%s"" may clash with future reserved word" |
| 6927 |
(W reserved) You used a bareword that might someday be claimed as a |
| 6928 |
reserved word. It's best to put such a word in quotes, or capitalize it |
| 6929 |
somehow, or insert an underbar into it. You might also declare it as a |
| 6930 |
subroutine. |
| 6931 |
.ie n .IP "Unrecognized character %s; marked by <\-\-\ HERE after %s near column %d" 4 |
| 6932 |
.el .IP "Unrecognized character \f(CW%s\fR; marked by <\-\-\ HERE after \f(CW%s\fR near column \f(CW%d\fR" 4 |
| 6933 |
.IX Item "Unrecognized character %s; marked by <--\ HERE after %s near column %d" |
| 6934 |
(F) The Perl parser has no idea what to do with the specified character |
| 6935 |
in your Perl script (or eval) near the specified column. Perhaps you |
| 6936 |
tried to run a compressed script, a binary program, or a directory as |
| 6937 |
a Perl program. |
| 6938 |
.ie n .IP "Unrecognized class attribute %s" 4 |
| 6939 |
.el .IP "Unrecognized class attribute \f(CW%s\fR" 4 |
| 6940 |
.IX Item "Unrecognized class attribute %s" |
| 6941 |
(F) You attempted to add a named attribute to a \f(CW\*(C`class\*(C'\fR definition, but |
| 6942 |
perl does not recognise the name of the requested attribute. |
| 6943 |
.IP "Unrecognized escape \e%c in character class in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6944 |
.IX Item "Unrecognized escape %c in character class in regex; marked by <--\ HERE in m/%s/" |
| 6945 |
(F) You used a backslash-character combination which is not |
| 6946 |
recognized by Perl inside character classes. This is a fatal |
| 6947 |
error when the character class is used within \f(CW\*(C`(?[ ])\*(C'\fR. |
| 6948 |
.IP "Unrecognized escape \e%c in character class passed through in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6949 |
.IX Item "Unrecognized escape %c in character class passed through in regex; marked by <--\ HERE in m/%s/" |
| 6950 |
(W regexp) You used a backslash-character combination which is not |
| 6951 |
recognized by Perl inside character classes. The character was |
| 6952 |
understood literally, but this may change in a future version of Perl. |
| 6953 |
The <\-\-\ HERE shows whereabouts in the regular expression the |
| 6954 |
escape was discovered. |
| 6955 |
.IP "Unrecognized escape \e%c passed through" 4 |
| 6956 |
.IX Item "Unrecognized escape %c passed through" |
| 6957 |
(W misc) You used a backslash-character combination which is not |
| 6958 |
recognized by Perl. The character was understood literally, but this may |
| 6959 |
change in a future version of Perl. |
| 6960 |
.IP "Unrecognized escape \e%s passed through in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 6961 |
.IX Item "Unrecognized escape %s passed through in regex; marked by <--\ HERE in m/%s/" |
| 6962 |
(W regexp) You used a backslash-character combination which is not |
| 6963 |
recognized by Perl. The character(s) were understood literally, but |
| 6964 |
this may change in a future version of Perl. The <\-\-\ HERE shows |
| 6965 |
whereabouts in the regular expression the escape was discovered. |
| 6966 |
.ie n .IP "Unrecognized field attribute %s" 4 |
| 6967 |
.el .IP "Unrecognized field attribute \f(CW%s\fR" 4 |
| 6968 |
.IX Item "Unrecognized field attribute %s" |
| 6969 |
(F) You attempted to add a named attribute to a \f(CW\*(C`field\*(C'\fR definition, but |
| 6970 |
perl does not recognise the name of the requested attribute. |
| 6971 |
.ie n .IP "Unrecognised parameters for ""%s"" constructor: %s" 4 |
| 6972 |
.el .IP "Unrecognised parameters for ""%s"" constructor: \f(CW%s\fR" 4 |
| 6973 |
.IX Item "Unrecognised parameters for ""%s"" constructor: %s" |
| 6974 |
(F) You called new on a class but supplied a parameter name that |
| 6975 |
didn't match a class field name. |
| 6976 |
.IP "Unrecognized signal name ""%s""" 4 |
| 6977 |
.IX Item "Unrecognized signal name ""%s""" |
| 6978 |
(F) You specified a signal name to the \fBkill()\fR function that was not |
| 6979 |
recognized. Say \f(CW\*(C`kill \-l\*(C'\fR in your shell to see the valid signal names |
| 6980 |
on your system. |
| 6981 |
.IP "Unrecognized switch: \-%s (\-h will show valid options)" 4 |
| 6982 |
.IX Item "Unrecognized switch: -%s (-h will show valid options)" |
| 6983 |
(F) You specified an illegal option to Perl. Don't do that. (If you |
| 6984 |
think you didn't do that, check the #! line to see if it's supplying the |
| 6985 |
bad switch on your behalf.) |
| 6986 |
.ie n .IP "Unsuccessful %s on filename containing newline" 4 |
| 6987 |
.el .IP "Unsuccessful \f(CW%s\fR on filename containing newline" 4 |
| 6988 |
.IX Item "Unsuccessful %s on filename containing newline" |
| 6989 |
(W newline) A file operation was attempted on a filename, and that |
| 6990 |
operation failed, PROBABLY because the filename contained a newline, |
| 6991 |
PROBABLY because you forgot to \fBchomp()\fR it off. See "chomp" in perlfunc. |
| 6992 |
.IP "Unsupported directory function ""%s"" called" 4 |
| 6993 |
.IX Item "Unsupported directory function ""%s"" called" |
| 6994 |
(F) Your machine doesn't support \fBopendir()\fR and \fBreaddir()\fR. |
| 6995 |
.ie n .IP "Unsupported function %s" 4 |
| 6996 |
.el .IP "Unsupported function \f(CW%s\fR" 4 |
| 6997 |
.IX Item "Unsupported function %s" |
| 6998 |
(F) This machine doesn't implement the indicated function, apparently. |
| 6999 |
At least, Configure doesn't think so. |
| 7000 |
.IP "Unsupported function fork" 4 |
| 7001 |
.IX Item "Unsupported function fork" |
| 7002 |
(F) Your version of executable does not support forking. |
| 7003 |
.Sp |
| 7004 |
Note that under some systems, like OS/2, there may be different flavors |
| 7005 |
of Perl executables, some of which may support fork, some not. Try |
| 7006 |
changing the name you call Perl by to \f(CW\*(C`perl_\*(C'\fR, \f(CW\*(C`perl_\|_\*(C'\fR, and so on. |
| 7007 |
.ie n .IP "Unsupported script encoding %s" 4 |
| 7008 |
.el .IP "Unsupported script encoding \f(CW%s\fR" 4 |
| 7009 |
.IX Item "Unsupported script encoding %s" |
| 7010 |
(F) Your program file begins with a Unicode Byte Order Mark (BOM) which |
| 7011 |
declares it to be in a Unicode encoding that Perl cannot read. |
| 7012 |
.IP "Unsupported socket function ""%s"" called" 4 |
| 7013 |
.IX Item "Unsupported socket function ""%s"" called" |
| 7014 |
(F) Your machine doesn't support the Berkeley socket mechanism, or at |
| 7015 |
least that's what Configure thought. |
| 7016 |
.IP "Unterminated '(*...' argument in regex; marked by <\-\- HERE in m/%s/" 4 |
| 7017 |
.IX Item "Unterminated '(*...' argument in regex; marked by <-- HERE in m/%s/" |
| 7018 |
(F) You used a pattern of the form \f(CW\*(C`(*...:...)\*(C'\fR but did not terminate |
| 7019 |
the pattern with a \f(CW\*(C`)\*(C'\fR. Fix the pattern and retry. |
| 7020 |
.IP "Unterminated attribute list" 4 |
| 7021 |
.IX Item "Unterminated attribute list" |
| 7022 |
(F) The lexer found something other than a simple identifier at the |
| 7023 |
start of an attribute, and it wasn't a semicolon or the start of a |
| 7024 |
block. Perhaps you terminated the parameter list of the previous |
| 7025 |
attribute too soon. See attributes. |
| 7026 |
.IP "Unterminated attribute parameter in attribute list" 4 |
| 7027 |
.IX Item "Unterminated attribute parameter in attribute list" |
| 7028 |
(F) The lexer saw an opening (left) parenthesis character while parsing |
| 7029 |
an attribute list, but the matching closing (right) parenthesis |
| 7030 |
character was not found. You may need to add (or remove) a backslash |
| 7031 |
character to get your parentheses to balance. See attributes. |
| 7032 |
.IP "Unterminated compressed integer" 4 |
| 7033 |
.IX Item "Unterminated compressed integer" |
| 7034 |
(F) An argument to unpack("w",...) was incompatible with the BER |
| 7035 |
compressed integer format and could not be converted to an integer. |
| 7036 |
See "pack" in perlfunc. |
| 7037 |
.IP "Unterminated '(*...' construct in regex; marked by <\-\- HERE in m/%s/" 4 |
| 7038 |
.IX Item "Unterminated '(*...' construct in regex; marked by <-- HERE in m/%s/" |
| 7039 |
(F) You used a pattern of the form \f(CW\*(C`(*...)\*(C'\fR but did not terminate |
| 7040 |
the pattern with a \f(CW\*(C`)\*(C'\fR. Fix the pattern and retry. |
| 7041 |
.IP "Unterminated delimiter for here document" 4 |
| 7042 |
.IX Item "Unterminated delimiter for here document" |
| 7043 |
(F) This message occurs when a here document label has an initial |
| 7044 |
quotation mark but the final quotation mark is missing. Perhaps |
| 7045 |
you wrote: |
| 7046 |
.Sp |
| 7047 |
.Vb 1 |
| 7048 |
\& <<"foo |
| 7049 |
.Ve |
| 7050 |
.Sp |
| 7051 |
instead of: |
| 7052 |
.Sp |
| 7053 |
.Vb 1 |
| 7054 |
\& <<"foo" |
| 7055 |
.Ve |
| 7056 |
.IP "Unterminated \eg... pattern in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7057 |
.IX Item "Unterminated g... pattern in regex; marked by <--\ HERE in m/%s/" |
| 7058 |
.PD 0 |
| 7059 |
.IP "Unterminated \eg{...} pattern in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7060 |
.IX Item "Unterminated g{...} pattern in regex; marked by <--\ HERE in m/%s/" |
| 7061 |
.PD |
| 7062 |
(F) In a regular expression, you had a \f(CW\*(C`\eg\*(C'\fR that wasn't followed by a |
| 7063 |
proper group reference. In the case of \f(CW\*(C`\eg{\*(C'\fR, the closing brace is |
| 7064 |
missing; otherwise the \f(CW\*(C`\eg\*(C'\fR must be followed by an integer. Fix the |
| 7065 |
pattern and retry. |
| 7066 |
.IP "Unterminated <> operator" 4 |
| 7067 |
.IX Item "Unterminated <> operator" |
| 7068 |
(F) The lexer saw a left angle bracket in a place where it was expecting |
| 7069 |
a term, so it's looking for the corresponding right angle bracket, and |
| 7070 |
not finding it. Chances are you left some needed parentheses out |
| 7071 |
earlier in the line, and you really meant a "less than". |
| 7072 |
.IP "Unterminated verb pattern argument in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7073 |
.IX Item "Unterminated verb pattern argument in regex; marked by <--\ HERE in m/%s/" |
| 7074 |
(F) You used a pattern of the form \f(CW\*(C`(*VERB:ARG)\*(C'\fR but did not terminate |
| 7075 |
the pattern with a \f(CW\*(C`)\*(C'\fR. Fix the pattern and retry. |
| 7076 |
.IP "Unterminated verb pattern in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7077 |
.IX Item "Unterminated verb pattern in regex; marked by <--\ HERE in m/%s/" |
| 7078 |
(F) You used a pattern of the form \f(CW\*(C`(*VERB)\*(C'\fR but did not terminate |
| 7079 |
the pattern with a \f(CW\*(C`)\*(C'\fR. Fix the pattern and retry. |
| 7080 |
.ie n .IP "untie attempted while %d inner references still exist" 4 |
| 7081 |
.el .IP "untie attempted while \f(CW%d\fR inner references still exist" 4 |
| 7082 |
.IX Item "untie attempted while %d inner references still exist" |
| 7083 |
(W untie) A copy of the object returned from \f(CW\*(C`tie\*(C'\fR (or \f(CW\*(C`tied\*(C'\fR) was |
| 7084 |
still valid when \f(CW\*(C`untie\*(C'\fR was called. |
| 7085 |
.IP "Usage: POSIX::%s(%s)" 4 |
| 7086 |
.IX Item "Usage: POSIX::%s(%s)" |
| 7087 |
(F) You called a POSIX function with incorrect arguments. |
| 7088 |
See "FUNCTIONS" in POSIX for more information. |
| 7089 |
.IP "Usage: Win32::%s(%s)" 4 |
| 7090 |
.IX Item "Usage: Win32::%s(%s)" |
| 7091 |
(F) You called a Win32 function with incorrect arguments. |
| 7092 |
See Win32 for more information. |
| 7093 |
.ie n .IP "$[ used in %s (did you mean $] ?)" 4 |
| 7094 |
.el .IP "$[ used in \f(CW%s\fR (did you mean $] ?)" 4 |
| 7095 |
.IX Item "$[ used in %s (did you mean $] ?)" |
| 7096 |
(W syntax) You used \f(CW$[\fR in a comparison, such as: |
| 7097 |
.Sp |
| 7098 |
.Vb 3 |
| 7099 |
\& if ($[ > 5.006) { |
| 7100 |
\& ... |
| 7101 |
\& } |
| 7102 |
.Ve |
| 7103 |
.Sp |
| 7104 |
You probably meant to use \f(CW$]\fR instead. \f(CW$[\fR is the base for indexing |
| 7105 |
arrays. \f(CW$]\fR is the Perl version number in decimal. |
| 7106 |
.IP "Use ""%s"" instead of ""%s""" 4 |
| 7107 |
.IX Item "Use ""%s"" instead of ""%s""" |
| 7108 |
(F) The second listed construct is no longer legal. Use the first one |
| 7109 |
instead. |
| 7110 |
.IP "Useless assignment to a temporary" 4 |
| 7111 |
.IX Item "Useless assignment to a temporary" |
| 7112 |
(W misc) You assigned to an lvalue subroutine, but what |
| 7113 |
the subroutine returned was a temporary scalar about to |
| 7114 |
be discarded, so the assignment had no effect. |
| 7115 |
.IP "Useless (?\-%s) \- don't use /%s modifier in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7116 |
.IX Item "Useless (?-%s) - don't use /%s modifier in regex; marked by <--\ HERE in m/%s/" |
| 7117 |
(W regexp) You have used an internal modifier such as (?\-o) that has no |
| 7118 |
meaning unless removed from the entire regexp: |
| 7119 |
.Sp |
| 7120 |
.Vb 1 |
| 7121 |
\& if ($string =~ /(?\-o)$pattern/o) { ... } |
| 7122 |
.Ve |
| 7123 |
.Sp |
| 7124 |
must be written as |
| 7125 |
.Sp |
| 7126 |
.Vb 1 |
| 7127 |
\& if ($string =~ /$pattern/) { ... } |
| 7128 |
.Ve |
| 7129 |
.Sp |
| 7130 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 7131 |
discovered. See perlre. |
| 7132 |
.ie n .IP "Useless localization of %s" 4 |
| 7133 |
.el .IP "Useless localization of \f(CW%s\fR" 4 |
| 7134 |
.IX Item "Useless localization of %s" |
| 7135 |
(W syntax) The localization of lvalues such as \f(CWlocal($x=10)\fR is legal, |
| 7136 |
but in fact the \fBlocal()\fR currently has no effect. This may change at |
| 7137 |
some point in the future, but in the meantime such code is discouraged. |
| 7138 |
.IP "Useless (?%s) \- use /%s modifier in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7139 |
.IX Item "Useless (?%s) - use /%s modifier in regex; marked by <--\ HERE in m/%s/" |
| 7140 |
(W regexp) You have used an internal modifier such as (?o) that has no |
| 7141 |
meaning unless applied to the entire regexp: |
| 7142 |
.Sp |
| 7143 |
.Vb 1 |
| 7144 |
\& if ($string =~ /(?o)$pattern/) { ... } |
| 7145 |
.Ve |
| 7146 |
.Sp |
| 7147 |
must be written as |
| 7148 |
.Sp |
| 7149 |
.Vb 1 |
| 7150 |
\& if ($string =~ /$pattern/o) { ... } |
| 7151 |
.Ve |
| 7152 |
.Sp |
| 7153 |
The <\-\-\ HERE shows whereabouts in the regular expression the problem was |
| 7154 |
discovered. See perlre. |
| 7155 |
.IP "Useless use of attribute ""const""" 4 |
| 7156 |
.IX Item "Useless use of attribute ""const""" |
| 7157 |
(W misc) The \f(CW\*(C`const\*(C'\fR attribute has no effect except |
| 7158 |
on anonymous closure prototypes. You applied it to |
| 7159 |
a subroutine via attributes.pm. This is only useful |
| 7160 |
inside an attribute handler for an anonymous subroutine. |
| 7161 |
.IP "Useless use of /d modifier in transliteration operator" 4 |
| 7162 |
.IX Item "Useless use of /d modifier in transliteration operator" |
| 7163 |
(W misc) You have used the /d modifier where the searchlist has the |
| 7164 |
same length as the replacelist. See perlop for more information |
| 7165 |
about the /d modifier. |
| 7166 |
.IP "Useless use of \eE" 4 |
| 7167 |
.IX Item "Useless use of E" |
| 7168 |
(W misc) You have a \eE in a double-quotish string without a \f(CW\*(C`\eU\*(C'\fR, |
| 7169 |
\&\f(CW\*(C`\eL\*(C'\fR or \f(CW\*(C`\eQ\*(C'\fR preceding it. |
| 7170 |
.IP "Useless use of greediness modifier '%c' in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7171 |
.IX Item "Useless use of greediness modifier '%c' in regex; marked by <--\ HERE in m/%s/" |
| 7172 |
(W regexp) You specified something like these: |
| 7173 |
.Sp |
| 7174 |
.Vb 2 |
| 7175 |
\& qr/a{3}?/ |
| 7176 |
\& qr/b{1,1}+/ |
| 7177 |
.Ve |
| 7178 |
.Sp |
| 7179 |
The \f(CW"?"\fR and \f(CW"+"\fR don't have any effect, as they modify whether to |
| 7180 |
match more or fewer when there is a choice, and by specifying to match |
| 7181 |
exactly a given number, there is no room left for a choice. |
| 7182 |
.ie n .IP "Useless use of %s in scalar context" 4 |
| 7183 |
.el .IP "Useless use of \f(CW%s\fR in scalar context" 4 |
| 7184 |
.IX Item "Useless use of %s in scalar context" |
| 7185 |
(W scalar) You did something whose only interesting return value is a |
| 7186 |
list without a side effect in scalar context, which does not accept a |
| 7187 |
list. |
| 7188 |
.Sp |
| 7189 |
For example |
| 7190 |
.Sp |
| 7191 |
.Vb 1 |
| 7192 |
\& my $x = sort @y; |
| 7193 |
.Ve |
| 7194 |
.Sp |
| 7195 |
This is not very useful, and perl currently optimizes this away. |
| 7196 |
.ie n .IP "Useless use of %s in void context" 4 |
| 7197 |
.el .IP "Useless use of \f(CW%s\fR in void context" 4 |
| 7198 |
.IX Item "Useless use of %s in void context" |
| 7199 |
(W void) You did something without a side effect in a context that does |
| 7200 |
nothing with the return value, such as a statement that doesn't return a |
| 7201 |
value from a block, or the left side of a scalar comma operator. Very |
| 7202 |
often this points not to stupidity on your part, but a failure of Perl |
| 7203 |
to parse your program the way you thought it would. For example, you'd |
| 7204 |
get this if you mixed up your C precedence with Python precedence and |
| 7205 |
said |
| 7206 |
.Sp |
| 7207 |
.Vb 1 |
| 7208 |
\& $one, $two = 1, 2; |
| 7209 |
.Ve |
| 7210 |
.Sp |
| 7211 |
when you meant to say |
| 7212 |
.Sp |
| 7213 |
.Vb 1 |
| 7214 |
\& ($one, $two) = (1, 2); |
| 7215 |
.Ve |
| 7216 |
.Sp |
| 7217 |
Another common error is to use ordinary parentheses to construct a list |
| 7218 |
reference when you should be using square or curly brackets, for |
| 7219 |
example, if you say |
| 7220 |
.Sp |
| 7221 |
.Vb 1 |
| 7222 |
\& $array = (1,2); |
| 7223 |
.Ve |
| 7224 |
.Sp |
| 7225 |
when you should have said |
| 7226 |
.Sp |
| 7227 |
.Vb 1 |
| 7228 |
\& $array = [1,2]; |
| 7229 |
.Ve |
| 7230 |
.Sp |
| 7231 |
The square brackets explicitly turn a list value into a scalar value, |
| 7232 |
while parentheses do not. So when a parenthesized list is evaluated in |
| 7233 |
a scalar context, the comma is treated like C's comma operator, which |
| 7234 |
throws away the left argument, which is not what you want. See |
| 7235 |
perlref for more on this. |
| 7236 |
.Sp |
| 7237 |
This warning will not be issued for numerical constants equal to 0 or 1 |
| 7238 |
since they are often used in statements like |
| 7239 |
.Sp |
| 7240 |
.Vb 1 |
| 7241 |
\& 1 while sub_with_side_effects(); |
| 7242 |
.Ve |
| 7243 |
.Sp |
| 7244 |
String constants that would normally evaluate to 0 or 1 are warned |
| 7245 |
about. |
| 7246 |
.IP "Useless use of (?\-p) in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7247 |
.IX Item "Useless use of (?-p) in regex; marked by <--\ HERE in m/%s/" |
| 7248 |
(W regexp) The \f(CW\*(C`p\*(C'\fR modifier cannot be turned off once set. Trying to do |
| 7249 |
so is futile. |
| 7250 |
.IP "Useless use of ""re"" pragma" 4 |
| 7251 |
.IX Item "Useless use of ""re"" pragma" |
| 7252 |
(W) You did \f(CW\*(C`use re;\*(C'\fR without any arguments. That isn't very useful. |
| 7253 |
.ie n .IP "Useless use of %s with no values" 4 |
| 7254 |
.el .IP "Useless use of \f(CW%s\fR with no values" 4 |
| 7255 |
.IX Item "Useless use of %s with no values" |
| 7256 |
(W syntax) You used the \fBpush()\fR or \fBunshift()\fR function with no arguments |
| 7257 |
apart from the array, like \f(CWpush(@x)\fR or \f(CWunshift(@foo)\fR. That won't |
| 7258 |
usually have any effect on the array, so is completely useless. It's |
| 7259 |
possible in principle that push(@tied_array) could have some effect |
| 7260 |
if the array is tied to a class which implements a PUSH method. If so, |
| 7261 |
you can write it as \f(CW\*(C`push(@tied_array,())\*(C'\fR to avoid this warning. |
| 7262 |
.IP """use"" not allowed in expression" 4 |
| 7263 |
.IX Item """use"" not allowed in expression" |
| 7264 |
(F) The "use" keyword is recognized and executed at compile time, and |
| 7265 |
returns no useful value. See perlmod. |
| 7266 |
.ie n .IP "Use of @_ in %s with signatured subroutine is experimental" 4 |
| 7267 |
.el .IP "Use of \f(CW@_\fR in \f(CW%s\fR with signatured subroutine is experimental" 4 |
| 7268 |
.IX Item "Use of @_ in %s with signatured subroutine is experimental" |
| 7269 |
(S experimental::args_array_with_signatures) An expression involving the |
| 7270 |
\&\f(CW@_\fR arguments array was found in a subroutine that uses a signature. |
| 7271 |
This is experimental because the interaction between the arguments |
| 7272 |
array and parameter handling via signatures is not guaranteed to remain |
| 7273 |
stable in any future version of Perl, and such code should be avoided. |
| 7274 |
.IP "Use of bare << to mean <<"""" is forbidden" 4 |
| 7275 |
.IX Item "Use of bare << to mean <<"""" is forbidden" |
| 7276 |
(F) You are now required to use the explicitly quoted form if you wish |
| 7277 |
to use an empty line as the terminator of the here-document. |
| 7278 |
.Sp |
| 7279 |
Use of a bare terminator was deprecated in Perl 5.000, and is a fatal |
| 7280 |
error as of Perl 5.28. |
| 7281 |
.IP "Use of /c modifier is meaningless in s///" 4 |
| 7282 |
.IX Item "Use of /c modifier is meaningless in s///" |
| 7283 |
(W regexp) You used the /c modifier in a substitution. The /c |
| 7284 |
modifier is not presently meaningful in substitutions. |
| 7285 |
.IP "Use of /c modifier is meaningless without /g" 4 |
| 7286 |
.IX Item "Use of /c modifier is meaningless without /g" |
| 7287 |
(W regexp) You used the /c modifier with a regex operand, but didn't |
| 7288 |
use the /g modifier. Currently, /c is meaningful only when /g is |
| 7289 |
used. (This may change in the future.) |
| 7290 |
.IP "Use of code point 0x%s is not allowed; the permissible max is 0x%X" 4 |
| 7291 |
.IX Item "Use of code point 0x%s is not allowed; the permissible max is 0x%X" |
| 7292 |
.PD 0 |
| 7293 |
.IP "Use of code point 0x%s is not allowed; the permissible max is 0x%X in regex; marked by <\-\- HERE in m/%s/" 4 |
| 7294 |
.IX Item "Use of code point 0x%s is not allowed; the permissible max is 0x%X in regex; marked by <-- HERE in m/%s/" |
| 7295 |
.PD |
| 7296 |
(F) You used a code point that is not allowed, because it is too large. |
| 7297 |
Unicode only allows code points up to 0x10FFFF, but Perl allows much |
| 7298 |
larger ones. Earlier versions of Perl allowed code points above IV_MAX |
| 7299 |
(0x7FFFFFF on 32\-bit platforms, 0x7FFFFFFFFFFFFFFF on 64\-bit platforms), |
| 7300 |
however, this could possibly break the perl interpreter in some constructs, |
| 7301 |
including causing it to hang in a few cases. |
| 7302 |
.Sp |
| 7303 |
If your code is to run on various platforms, keep in mind that the upper |
| 7304 |
limit depends on the platform. It is much larger on 64\-bit word sizes |
| 7305 |
than 32\-bit ones. |
| 7306 |
.Sp |
| 7307 |
The use of out of range code points was deprecated in Perl 5.24, and |
| 7308 |
became a fatal error in Perl 5.28. |
| 7309 |
.IP "Use of \fBeach()\fR on hash after insertion without resetting hash iterator results in undefined behavior" 4 |
| 7310 |
.IX Item "Use of each() on hash after insertion without resetting hash iterator results in undefined behavior" |
| 7311 |
(S internal) The behavior of \f(CWeach()\fR after insertion is undefined; |
| 7312 |
it may skip items, or visit items more than once. Consider using |
| 7313 |
\&\f(CWkeys()\fR instead of \f(CWeach()\fR. |
| 7314 |
.IP "Use of := for an empty attribute list is not allowed" 4 |
| 7315 |
.IX Item "Use of := for an empty attribute list is not allowed" |
| 7316 |
(F) The construction \f(CW\*(C`my $x := 42\*(C'\fR used to parse as equivalent to |
| 7317 |
\&\f(CW\*(C`my $x : = 42\*(C'\fR (applying an empty attribute list to \f(CW$x\fR). |
| 7318 |
This construct was deprecated in 5.12.0, and has now been made a syntax |
| 7319 |
error, so \f(CW\*(C`:=\*(C'\fR can be reclaimed as a new operator in the future. |
| 7320 |
.Sp |
| 7321 |
If you need an empty attribute list, for example in a code generator, add |
| 7322 |
a space before the \f(CW\*(C`=\*(C'\fR. |
| 7323 |
.ie n .IP "Use of %s for non\-UTF\-8 locale is wrong. Assuming a UTF\-8 locale" 4 |
| 7324 |
.el .IP "Use of \f(CW%s\fR for non\-UTF\-8 locale is wrong. Assuming a UTF\-8 locale" 4 |
| 7325 |
.IX Item "Use of %s for non-UTF-8 locale is wrong. Assuming a UTF-8 locale" |
| 7326 |
(W locale) You are matching a regular expression using locale rules, |
| 7327 |
and the specified construct was encountered. This construct is only |
| 7328 |
valid for UTF\-8 locales, which the current locale isn't. This doesn't |
| 7329 |
make sense. Perl will continue, assuming a Unicode (UTF\-8) locale, but |
| 7330 |
the results are likely to be wrong. |
| 7331 |
.IP "Use of freed value in iteration" 4 |
| 7332 |
.IX Item "Use of freed value in iteration" |
| 7333 |
(F) Perhaps you modified the iterated array within the loop? |
| 7334 |
This error is typically caused by code like the following: |
| 7335 |
.Sp |
| 7336 |
.Vb 2 |
| 7337 |
\& @a = (3,4); |
| 7338 |
\& @a = () for (1,2,@a); |
| 7339 |
.Ve |
| 7340 |
.Sp |
| 7341 |
You are not supposed to modify arrays while they are being iterated over. |
| 7342 |
For speed and efficiency reasons, Perl internally does not do full |
| 7343 |
reference-counting of iterated items, hence deleting such an item in the |
| 7344 |
middle of an iteration causes Perl to see a freed value. |
| 7345 |
.IP "Use of /g modifier is meaningless in split" 4 |
| 7346 |
.IX Item "Use of /g modifier is meaningless in split" |
| 7347 |
(W regexp) You used the /g modifier on the pattern for a \f(CW\*(C`split\*(C'\fR |
| 7348 |
operator. Since \f(CW\*(C`split\*(C'\fR always tries to match the pattern |
| 7349 |
repeatedly, the \f(CW\*(C`/g\*(C'\fR has no effect. |
| 7350 |
.IP "Use of ""goto"" to jump into a construct is deprecated" 4 |
| 7351 |
.IX Item "Use of ""goto"" to jump into a construct is deprecated" |
| 7352 |
(D deprecated::goto_construct) Using \f(CW\*(C`goto\*(C'\fR to jump from an outer scope into an inner |
| 7353 |
scope is deprecated and will be removed completely in Perl 5.42. |
| 7354 |
.Sp |
| 7355 |
This was deprecated in Perl 5.12. |
| 7356 |
.ie n .IP "Use of '%s' in \ep{} or \eP{} is deprecated because: %s" 4 |
| 7357 |
.el .IP "Use of '%s' in \ep{} or \eP{} is deprecated because: \f(CW%s\fR" 4 |
| 7358 |
.IX Item "Use of '%s' in p{} or P{} is deprecated because: %s" |
| 7359 |
(D deprecated::unicode_property_name) Certain properties are deprecated |
| 7360 |
by Unicode, and may eventually be removed from the Standard, at which |
| 7361 |
time Perl will follow along. In the meantime, this message is raised to |
| 7362 |
notify you. |
| 7363 |
.ie n .IP "Use of inherited AUTOLOAD for non-method %s::%s() is no longer allowed" 4 |
| 7364 |
.el .IP "Use of inherited AUTOLOAD for non-method \f(CW%s::\fR%s() is no longer allowed" 4 |
| 7365 |
.IX Item "Use of inherited AUTOLOAD for non-method %s::%s() is no longer allowed" |
| 7366 |
(F) As an accidental feature, \f(CW\*(C`AUTOLOAD\*(C'\fR subroutines were looked up as |
| 7367 |
methods (using the \f(CW@ISA\fR hierarchy), even when the subroutines to be |
| 7368 |
autoloaded were called as plain functions (e.g. \f(CWFoo::bar()\fR), not as |
| 7369 |
methods (e.g. \f(CW\*(C`Foo\->bar()\*(C'\fR or \f(CW\*(C`$obj\->bar()\*(C'\fR). |
| 7370 |
.Sp |
| 7371 |
This was deprecated in Perl 5.004, and was made fatal in Perl 5.28. |
| 7372 |
.ie n .IP "Use of %s in printf format not supported" 4 |
| 7373 |
.el .IP "Use of \f(CW%s\fR in printf format not supported" 4 |
| 7374 |
.IX Item "Use of %s in printf format not supported" |
| 7375 |
(F) You attempted to use a feature of printf that is accessible from |
| 7376 |
only C. This usually means there's a better way to do it in Perl. |
| 7377 |
.IP "Use of '%s' is deprecated as a string delimiter" 4 |
| 7378 |
.IX Item "Use of '%s' is deprecated as a string delimiter" |
| 7379 |
(D deprecated::delimiter_will_be_paired) You used the given character as |
| 7380 |
a starting delimiter of a string outside the scope of |
| 7381 |
\&\f(CW\*(C`use\ feature\ \*(Aqextra_paired_delimiters\*(Aq\*(C'\fR. This character is the |
| 7382 |
mirror image of another Unicode character; within the scope of that |
| 7383 |
feature, the two are considered a pair for delimitting strings. It is |
| 7384 |
planned to make that feature the default, at which point this usage |
| 7385 |
would become illegal; hence this warning. |
| 7386 |
.Sp |
| 7387 |
For now, you may live with this warning, or turn it off, but this code |
| 7388 |
will no longer compile in a future version of Perl. Or you can turn on |
| 7389 |
\&\f(CW\*(C`use\ feature\ \*(Aqextra_paired_delimiters\*(Aq\*(C'\fR and use the character that |
| 7390 |
is the mirror image of this one for the closing string delimiter. |
| 7391 |
.IP "Use of '%s' is experimental as a string delimiter" 4 |
| 7392 |
.IX Item "Use of '%s' is experimental as a string delimiter" |
| 7393 |
(S experimental::extra_paired_delimiters) This warning is emitted if |
| 7394 |
you use as a string delimiter one of the non-ASCII mirror image ones |
| 7395 |
enabled by \f(CW\*(C`use\ feature\ \*(Aqextra_paired_delimiters\*(Aq\*(C'\fR. Simply suppress |
| 7396 |
the warning if you want to use the feature, but know that in doing so |
| 7397 |
you are taking the risk of using an experimental feature which may |
| 7398 |
change or be removed in a future Perl version: |
| 7399 |
.ie n .IP "Use of %s is not allowed in Unicode property wildcard subpatterns in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7400 |
.el .IP "Use of \f(CW%s\fR is not allowed in Unicode property wildcard subpatterns in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7401 |
.IX Item "Use of %s is not allowed in Unicode property wildcard subpatterns in regex; marked by <--\ HERE in m/%s/" |
| 7402 |
(F) You were using a wildcard subpattern a Unicode property value, and |
| 7403 |
the subpattern contained something that is illegal. Not all regular |
| 7404 |
expression capabilities are legal in such subpatterns, and this is one. |
| 7405 |
Rewrite your subppattern to not use the offending construct. |
| 7406 |
See "Wildcards in Property Values" in perlunicode. |
| 7407 |
.IP "Use of \-l on filehandle%s" 4 |
| 7408 |
.IX Item "Use of -l on filehandle%s" |
| 7409 |
(W io) A filehandle represents an opened file, and when you opened the file |
| 7410 |
it already went past any symlink you are presumably trying to look for. |
| 7411 |
The operation returned \f(CW\*(C`undef\*(C'\fR. Use a filename instead. |
| 7412 |
.IP "Use of reference ""%s"" as array index" 4 |
| 7413 |
.IX Item "Use of reference ""%s"" as array index" |
| 7414 |
(W misc) You tried to use a reference as an array index; this probably |
| 7415 |
isn't what you mean, because references in numerical context tend |
| 7416 |
to be huge numbers, and so usually indicates programmer error. |
| 7417 |
.Sp |
| 7418 |
If you really do mean it, explicitly numify your reference, like so: |
| 7419 |
\&\f(CW$array[0+$ref]\fR. This warning is not given for overloaded objects, |
| 7420 |
however, because you can overload the numification and stringification |
| 7421 |
operators and then you presumably know what you are doing. |
| 7422 |
.ie n .IP "Use of strings with code points over 0xFF as arguments to %s operator is not allowed" 4 |
| 7423 |
.el .IP "Use of strings with code points over 0xFF as arguments to \f(CW%s\fR operator is not allowed" 4 |
| 7424 |
.IX Item "Use of strings with code points over 0xFF as arguments to %s operator is not allowed" |
| 7425 |
(F) You tried to use one of the string bitwise operators (\f(CW\*(C`&\*(C'\fR or \f(CW\*(C`|\*(C'\fR or \f(CW\*(C`^\*(C'\fR or |
| 7426 |
\&\f(CW\*(C`~\*(C'\fR) on a string containing a code point over 0xFF. The string bitwise |
| 7427 |
operators treat their operands as strings of bytes, and values beyond |
| 7428 |
0xFF are nonsensical in this context. |
| 7429 |
.Sp |
| 7430 |
Certain instances became fatal in Perl 5.28; others in perl 5.32. |
| 7431 |
.IP "Use of strings with code points over 0xFF as arguments to vec is forbidden" 4 |
| 7432 |
.IX Item "Use of strings with code points over 0xFF as arguments to vec is forbidden" |
| 7433 |
(F) You tried to use \f(CW\*(C`vec\*(C'\fR |
| 7434 |
on a string containing a code point over 0xFF, which is nonsensical here. |
| 7435 |
.Sp |
| 7436 |
This became fatal in Perl 5.32. |
| 7437 |
.ie n .IP "Use of tainted arguments in %s is deprecated" 4 |
| 7438 |
.el .IP "Use of tainted arguments in \f(CW%s\fR is deprecated" 4 |
| 7439 |
.IX Item "Use of tainted arguments in %s is deprecated" |
| 7440 |
(W taint, deprecated) You have supplied \f(CWsystem()\fR or \f(CWexec()\fR with multiple |
| 7441 |
arguments and at least one of them is tainted. This used to be allowed |
| 7442 |
but will become a fatal error in a future version of perl. Untaint your |
| 7443 |
arguments. See perlsec. |
| 7444 |
.IP "Use of unassigned code point or non-standalone grapheme for a delimiter is not allowed" 4 |
| 7445 |
.IX Item "Use of unassigned code point or non-standalone grapheme for a delimiter is not allowed" |
| 7446 |
(F) |
| 7447 |
A grapheme is what appears to a native-speaker of a language to be a |
| 7448 |
character. In Unicode (and hence Perl) a grapheme may actually be |
| 7449 |
several adjacent characters that together form a complete grapheme. For |
| 7450 |
example, there can be a base character, like "R" and an accent, like a |
| 7451 |
circumflex "^", that appear when displayed to be a single character with |
| 7452 |
the circumflex hovering over the "R". Perl currently allows things like |
| 7453 |
that circumflex to be delimiters of strings, patterns, \fIetc\fR. When |
| 7454 |
displayed, the circumflex would look like it belongs to the character |
| 7455 |
just to the left of it. In order to move the language to be able to |
| 7456 |
accept graphemes as delimiters, we cannot allow the use of |
| 7457 |
delimiters which aren't graphemes by themselves. Also, a delimiter must |
| 7458 |
already be assigned (or known to be never going to be assigned) to try |
| 7459 |
to future-proof code, for otherwise code that works today would fail to |
| 7460 |
compile if the currently unassigned delimiter ends up being something |
| 7461 |
that isn't a stand-alone grapheme. Because Unicode is never going to |
| 7462 |
assign |
| 7463 |
non-character code points, nor |
| 7464 |
code points that are above the legal Unicode maximum, those can be delimiters, and |
| 7465 |
their use is legal. |
| 7466 |
.IP "Use of uninitialized value%s" 4 |
| 7467 |
.IX Item "Use of uninitialized value%s" |
| 7468 |
(W uninitialized) An undefined value was used as if it were already |
| 7469 |
defined. It was interpreted as a "" or a 0, but maybe it was a mistake. |
| 7470 |
To suppress this warning assign a defined value to your variables. |
| 7471 |
.Sp |
| 7472 |
To help you figure out what was undefined, perl will try to tell you |
| 7473 |
the name of the variable (if any) that was undefined. In some cases |
| 7474 |
it cannot do this, so it also tells you what operation you used the |
| 7475 |
undefined value in. Note, however, that perl optimizes your program |
| 7476 |
and the operation displayed in the warning may not necessarily appear |
| 7477 |
literally in your program. For example, \f(CW"that $foo"\fR is usually |
| 7478 |
optimized into \f(CW\*(C`"that " . $foo\*(C'\fR, and the warning will refer to the |
| 7479 |
\&\f(CW\*(C`concatenation (.)\*(C'\fR operator, even though there is no \f(CW\*(C`.\*(C'\fR in |
| 7480 |
your program. |
| 7481 |
.IP """use re 'strict'"" is experimental" 4 |
| 7482 |
.IX Item """use re 'strict'"" is experimental" |
| 7483 |
(S experimental::re_strict) The things that are different when a regular |
| 7484 |
expression pattern is compiled under \f(CW\*(Aqstrict\*(Aq\fR are subject to change |
| 7485 |
in future Perl releases in incompatible ways. This means that a pattern |
| 7486 |
that compiles today may not in a future Perl release. This warning is |
| 7487 |
to alert you to that risk. |
| 7488 |
.IP "use VERSION is not permitted while another use VERSION of 5.39 or above is in scope" 4 |
| 7489 |
.IX Item "use VERSION is not permitted while another use VERSION of 5.39 or above is in scope" |
| 7490 |
(F) Once you have a \f(CW\*(C`use VERSION\*(C'\fR declaration that calls for a Perl version |
| 7491 |
of at least 5.39, you cannot have a subsequent one while the first is visible, |
| 7492 |
even if it requests a later version. |
| 7493 |
.IP "use VERSION of 5.39 or above is not permitted while another use VERSION is in scope" 4 |
| 7494 |
.IX Item "use VERSION of 5.39 or above is not permitted while another use VERSION is in scope" |
| 7495 |
(F) Once you have a \f(CW\*(C`use VERSION\*(C'\fR declaration in scope, you cannot have a |
| 7496 |
subsequent one that calls for a Perl version of at least 5.39 while the first |
| 7497 |
is visible. |
| 7498 |
.IP "Use \ex{...} for more than two hex characters in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7499 |
.IX Item "Use x{...} for more than two hex characters in regex; marked by <--\ HERE in m/%s/" |
| 7500 |
(F) In a regular expression, you said something like |
| 7501 |
.Sp |
| 7502 |
.Vb 1 |
| 7503 |
\& (?[ [ \exBEEF ] ]) |
| 7504 |
.Ve |
| 7505 |
.Sp |
| 7506 |
Perl isn't sure if you meant this |
| 7507 |
.Sp |
| 7508 |
.Vb 1 |
| 7509 |
\& (?[ [ \ex{BEEF} ] ]) |
| 7510 |
.Ve |
| 7511 |
.Sp |
| 7512 |
or if you meant this |
| 7513 |
.Sp |
| 7514 |
.Vb 1 |
| 7515 |
\& (?[ [ \ex{BE} E F ] ]) |
| 7516 |
.Ve |
| 7517 |
.Sp |
| 7518 |
You need to add either braces or blanks to disambiguate. |
| 7519 |
.IP "Using just the first character returned by \eN{} in character class in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7520 |
.IX Item "Using just the first character returned by N{} in character class in regex; marked by <--\ HERE in m/%s/" |
| 7521 |
(W regexp) Named Unicode character escapes \f(CW\*(C`(\eN{...})\*(C'\fR may return |
| 7522 |
a multi-character sequence. Even though a character class is |
| 7523 |
supposed to match just one character of input, perl will match |
| 7524 |
the whole thing correctly, except when the class is inverted |
| 7525 |
(\f(CW\*(C`[^...]\*(C'\fR), or the escape is the beginning or final end point of |
| 7526 |
a range. For these, what should happen isn't clear at all. In |
| 7527 |
these circumstances, Perl discards all but the first character |
| 7528 |
of the returned sequence, which is not likely what you want. |
| 7529 |
.IP "Using just the single character results returned by \ep{} in (?[...]) in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7530 |
.IX Item "Using just the single character results returned by p{} in (?[...]) in regex; marked by <--\ HERE in m/%s/" |
| 7531 |
(W regexp) Extended character classes currently cannot handle operands |
| 7532 |
that evaluate to more than one character. These are removed from the |
| 7533 |
results of the expansion of the \f(CW\*(C`\ep{}\*(C'\fR. |
| 7534 |
.Sp |
| 7535 |
This situation can happen, for example, in |
| 7536 |
.Sp |
| 7537 |
.Vb 1 |
| 7538 |
\& (?[ \ep{name=/KATAKANA/} ]) |
| 7539 |
.Ve |
| 7540 |
.Sp |
| 7541 |
"KATAKANA LETTER AINU P" is a legal Unicode name (technically a "named |
| 7542 |
sequence"), but it is actually two characters. The above expression |
| 7543 |
with match only the Unicode names containing KATAKANA that represent |
| 7544 |
single characters. |
| 7545 |
.IP "Using /u for '%s' instead of /%s in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7546 |
.IX Item "Using /u for '%s' instead of /%s in regex; marked by <--\ HERE in m/%s/" |
| 7547 |
(W regexp) You used a Unicode boundary (\f(CW\*(C`\eb{...}\*(C'\fR or \f(CW\*(C`\eB{...}\*(C'\fR) in a |
| 7548 |
portion of a regular expression where the character set modifiers \f(CW\*(C`/a\*(C'\fR |
| 7549 |
or \f(CW\*(C`/aa\*(C'\fR are in effect. These two modifiers indicate an ASCII |
| 7550 |
interpretation, and this doesn't make sense for a Unicode definition. |
| 7551 |
The generated regular expression will compile so that the boundary uses |
| 7552 |
all of Unicode. No other portion of the regular expression is affected. |
| 7553 |
.ie n .IP "Using !~ with %s doesn't make sense" 4 |
| 7554 |
.el .IP "Using !~ with \f(CW%s\fR doesn't make sense" 4 |
| 7555 |
.IX Item "Using !~ with %s doesn't make sense" |
| 7556 |
(F) Using the \f(CW\*(C`!~\*(C'\fR operator with \f(CW\*(C`s///r\*(C'\fR, \f(CW\*(C`tr///r\*(C'\fR or \f(CW\*(C`y///r\*(C'\fR is |
| 7557 |
currently reserved for future use, as the exact behavior has not |
| 7558 |
been decided. (Simply returning the boolean opposite of the |
| 7559 |
modified string is usually not particularly useful.) |
| 7560 |
.IP "UTF\-16 surrogate U+%X" 4 |
| 7561 |
.IX Item "UTF-16 surrogate U+%X" |
| 7562 |
(S surrogate) You had a UTF\-16 surrogate in a context where they are |
| 7563 |
not considered acceptable. These code points, between U+D800 and |
| 7564 |
U+DFFF (inclusive), are used by Unicode only for UTF\-16. However, Perl |
| 7565 |
internally allows all unsigned integer code points (up to the size limit |
| 7566 |
available on your platform), including surrogates. But these can cause |
| 7567 |
problems when being input or output, which is likely where this message |
| 7568 |
came from. If you really really know what you are doing you can turn |
| 7569 |
off this warning by \f(CW\*(C`no warnings \*(Aqsurrogate\*(Aq;\*(C'\fR. |
| 7570 |
.ie n .IP "Value of %s can be ""0""; test with \fBdefined()\fR" 4 |
| 7571 |
.el .IP "Value of \f(CW%s\fR can be ""0""; test with \fBdefined()\fR" 4 |
| 7572 |
.IX Item "Value of %s can be ""0""; test with defined()" |
| 7573 |
(W misc) In a conditional expression, you used <HANDLE>, <*> (glob), |
| 7574 |
\&\f(CWeach()\fR, or \f(CWreaddir()\fR as a boolean value. Each of these constructs |
| 7575 |
can return a value of "0"; that would make the conditional expression |
| 7576 |
false, which is probably not what you intended. When using these |
| 7577 |
constructs in conditional expressions, test their values with the |
| 7578 |
\&\f(CW\*(C`defined\*(C'\fR operator. |
| 7579 |
.IP "Value of CLI symbol ""%s"" too long" 4 |
| 7580 |
.IX Item "Value of CLI symbol ""%s"" too long" |
| 7581 |
(W misc) A warning peculiar to VMS. Perl tried to read the value of an |
| 7582 |
\&\f(CW%ENV\fR element from a CLI symbol table, and found a resultant string |
| 7583 |
longer than 1024 characters. The return value has been truncated to |
| 7584 |
1024 characters. |
| 7585 |
.IP "Variable ""%s"" is not available" 4 |
| 7586 |
.IX Item "Variable ""%s"" is not available" |
| 7587 |
(W closure) During compilation, an inner named subroutine or eval is |
| 7588 |
attempting to capture an outer lexical that is not currently available. |
| 7589 |
This can happen for one of two reasons. First, the outer lexical may be |
| 7590 |
declared in an outer anonymous subroutine that has not yet been created. |
| 7591 |
(Remember that named subs are created at compile time, while anonymous |
| 7592 |
subs are created at run-time.) For example, |
| 7593 |
.Sp |
| 7594 |
.Vb 1 |
| 7595 |
\& sub { my $x; sub f { $x } } |
| 7596 |
.Ve |
| 7597 |
.Sp |
| 7598 |
At the time that f is created, it can't capture the current value of \f(CW$x\fR, |
| 7599 |
since the anonymous subroutine hasn't been created yet. Conversely, |
| 7600 |
the following won't give a warning since the anonymous subroutine has by |
| 7601 |
now been created and is live: |
| 7602 |
.Sp |
| 7603 |
.Vb 1 |
| 7604 |
\& sub { my $x; eval \*(Aqsub f { $x }\*(Aq }\->(); |
| 7605 |
.Ve |
| 7606 |
.Sp |
| 7607 |
The second situation is caused by an eval accessing a variable that has |
| 7608 |
gone out of scope, for example, |
| 7609 |
.Sp |
| 7610 |
.Vb 5 |
| 7611 |
\& sub f { |
| 7612 |
\& my $x; |
| 7613 |
\& sub { eval \*(Aq$x\*(Aq } |
| 7614 |
\& } |
| 7615 |
\& f()\->(); |
| 7616 |
.Ve |
| 7617 |
.Sp |
| 7618 |
Here, when the '$x' in the eval is being compiled, f() is not currently |
| 7619 |
being executed, so its \f(CW$x\fR is not available for capture. |
| 7620 |
.IP "Variable ""%s"" is not imported%s" 4 |
| 7621 |
.IX Item "Variable ""%s"" is not imported%s" |
| 7622 |
(S misc) With "use strict" in effect, you referred to a global variable |
| 7623 |
that you apparently thought was imported from another module, because |
| 7624 |
something else of the same name (usually a subroutine) is exported by |
| 7625 |
that module. It usually means you put the wrong funny character on the |
| 7626 |
front of your variable. It is also possible you used an "our" variable |
| 7627 |
whose scope has ended. |
| 7628 |
.IP "Variable length lookbehind not implemented in regex m/%s/" 4 |
| 7629 |
.IX Item "Variable length lookbehind not implemented in regex m/%s/" |
| 7630 |
(F) \fBThis message no longer should be raised as of Perl 5.30.\fR It is |
| 7631 |
retained in this document as a convenience for people using an earlier |
| 7632 |
Perl version. |
| 7633 |
.Sp |
| 7634 |
In Perl 5.30 and earlier, lookbehind is allowed |
| 7635 |
only for subexpressions whose length is fixed and |
| 7636 |
known at compile time. For positive lookbehind, you can use the \f(CW\*(C`\eK\*(C'\fR |
| 7637 |
regex construct as a way to get the equivalent functionality. See |
| 7638 |
(?<=pattern) and \eK in perlre. |
| 7639 |
.Sp |
| 7640 |
Starting in Perl 5.18, there are non-obvious Unicode rules under \f(CW\*(C`/i\*(C'\fR |
| 7641 |
that can match variably, but which you might not think could. For |
| 7642 |
example, the substring \f(CW"ss"\fR can match the single character LATIN |
| 7643 |
SMALL LETTER SHARP S. Here's a complete list of the current ones |
| 7644 |
affecting ASCII characters: |
| 7645 |
.Sp |
| 7646 |
.Vb 11 |
| 7647 |
\& ASCII |
| 7648 |
\& sequence Matches single letter under /i |
| 7649 |
\& FF U+FB00 LATIN SMALL LIGATURE FF |
| 7650 |
\& FFI U+FB03 LATIN SMALL LIGATURE FFI |
| 7651 |
\& FFL U+FB04 LATIN SMALL LIGATURE FFL |
| 7652 |
\& FI U+FB01 LATIN SMALL LIGATURE FI |
| 7653 |
\& FL U+FB02 LATIN SMALL LIGATURE FL |
| 7654 |
\& SS U+00DF LATIN SMALL LETTER SHARP S |
| 7655 |
\& U+1E9E LATIN CAPITAL LETTER SHARP S |
| 7656 |
\& ST U+FB06 LATIN SMALL LIGATURE ST |
| 7657 |
\& U+FB05 LATIN SMALL LIGATURE LONG S T |
| 7658 |
.Ve |
| 7659 |
.Sp |
| 7660 |
This list is subject to change, but is quite unlikely to. |
| 7661 |
Each ASCII sequence can be any combination of upper\- and lowercase. |
| 7662 |
.Sp |
| 7663 |
You can avoid this by using a bracketed character class in the |
| 7664 |
lookbehind assertion, like |
| 7665 |
.Sp |
| 7666 |
.Vb 2 |
| 7667 |
\& (?<![sS]t) |
| 7668 |
\& (?<![fF]f[iI]) |
| 7669 |
.Ve |
| 7670 |
.Sp |
| 7671 |
This fools Perl into not matching the ligatures. |
| 7672 |
.Sp |
| 7673 |
Another option for Perls starting with 5.16, if you only care about |
| 7674 |
ASCII matches, is to add the \f(CW\*(C`/aa\*(C'\fR modifier to the regex. This will |
| 7675 |
exclude all these non-obvious matches, thus getting rid of this message. |
| 7676 |
You can also say |
| 7677 |
.Sp |
| 7678 |
.Vb 1 |
| 7679 |
\& use if $] ge 5.016, re => \*(Aq/aa\*(Aq; |
| 7680 |
.Ve |
| 7681 |
.Sp |
| 7682 |
to apply \f(CW\*(C`/aa\*(C'\fR to all regular expressions compiled within its scope. |
| 7683 |
See re. |
| 7684 |
.IP "Variable length positive lookbehind with capturing is experimental in regex m/%s/" 4 |
| 7685 |
.IX Item "Variable length positive lookbehind with capturing is experimental in regex m/%s/" |
| 7686 |
(W) Variable length positive lookbehind with capturing is not well defined. This |
| 7687 |
warning alerts you to the fact that you are using a construct which may |
| 7688 |
change in a future version of perl. See the |
| 7689 |
documentation of Positive Lookbehind in perlre |
| 7690 |
for details. You may silence this warning with the following: |
| 7691 |
.Sp |
| 7692 |
.Vb 1 |
| 7693 |
\& no warnings \*(Aqexperimental::vlb\*(Aq; |
| 7694 |
.Ve |
| 7695 |
.IP "Variable length negative lookbehind with capturing is experimental in regex m/%s/" 4 |
| 7696 |
.IX Item "Variable length negative lookbehind with capturing is experimental in regex m/%s/" |
| 7697 |
(W) Variable length negative lookbehind with capturing is not well defined. This |
| 7698 |
warning alerts you to the fact that you are using a construct which may |
| 7699 |
change in a future version of perl. See the |
| 7700 |
documentation of Negative Lookbehind in perlre |
| 7701 |
for details. You may silence this warning with the following: |
| 7702 |
.Sp |
| 7703 |
.Vb 1 |
| 7704 |
\& no warnings \*(Aqexperimental::vlb\*(Aq; |
| 7705 |
.Ve |
| 7706 |
.ie n .IP """%s"" variable %s masks earlier declaration in same %s" 4 |
| 7707 |
.el .IP """%s"" variable \f(CW%s\fR masks earlier declaration in same \f(CW%s\fR" 4 |
| 7708 |
.IX Item """%s"" variable %s masks earlier declaration in same %s" |
| 7709 |
(W shadow) A "my", "our", "state" or "field" variable has been redeclared in |
| 7710 |
the current scope or statement, effectively eliminating all access to the |
| 7711 |
previous instance. This is almost always a typographical error. Note |
| 7712 |
that the earlier variable will still exist until the end of the scope |
| 7713 |
or until all closure references to it are destroyed. |
| 7714 |
.IP "Variable syntax" 4 |
| 7715 |
.IX Item "Variable syntax" |
| 7716 |
(A) You've accidentally run your script through \fBcsh\fR instead |
| 7717 |
of Perl. Check the #! line, or manually feed your script into |
| 7718 |
Perl yourself. |
| 7719 |
.IP "Variable ""%s"" will not stay shared" 4 |
| 7720 |
.IX Item "Variable ""%s"" will not stay shared" |
| 7721 |
(W closure) An inner (nested) \fInamed\fR subroutine is referencing a |
| 7722 |
lexical variable defined in an outer named subroutine. |
| 7723 |
.Sp |
| 7724 |
When the inner subroutine is called, it will see the value of |
| 7725 |
the outer subroutine's variable as it was before and during the *first* |
| 7726 |
call to the outer subroutine; in this case, after the first call to the |
| 7727 |
outer subroutine is complete, the inner and outer subroutines will no |
| 7728 |
longer share a common value for the variable. In other words, the |
| 7729 |
variable will no longer be shared. |
| 7730 |
.Sp |
| 7731 |
This problem can usually be solved by making the inner subroutine |
| 7732 |
anonymous, using the \f(CW\*(C`sub {}\*(C'\fR syntax. When inner anonymous subs that |
| 7733 |
reference variables in outer subroutines are created, they |
| 7734 |
are automatically rebound to the current values of such variables. |
| 7735 |
.IP "vector argument not supported with alpha versions" 4 |
| 7736 |
.IX Item "vector argument not supported with alpha versions" |
| 7737 |
(S printf) The \f(CW%vd\fR (s)printf format does not support version objects |
| 7738 |
with alpha parts. |
| 7739 |
.IP "Verb pattern '%s' has a mandatory argument in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7740 |
.IX Item "Verb pattern '%s' has a mandatory argument in regex; marked by <--\ HERE in m/%s/" |
| 7741 |
(F) You used a verb pattern that requires an argument. Supply an |
| 7742 |
argument or check that you are using the right verb. |
| 7743 |
.IP "Verb pattern '%s' may not have an argument in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7744 |
.IX Item "Verb pattern '%s' may not have an argument in regex; marked by <--\ HERE in m/%s/" |
| 7745 |
(F) You used a verb pattern that is not allowed an argument. Remove the |
| 7746 |
argument or check that you are using the right verb. |
| 7747 |
.IP "Version control conflict marker" 4 |
| 7748 |
.IX Item "Version control conflict marker" |
| 7749 |
(F) The parser found a line starting with \f(CW\*(C`<<<<<<<\*(C'\fR, |
| 7750 |
\&\f(CW\*(C`>>>>>>>\*(C'\fR, or \f(CW\*(C`=======\*(C'\fR. These may be left by a |
| 7751 |
version control system to mark conflicts after a failed merge operation. |
| 7752 |
.IP "Version number must be a constant number" 4 |
| 7753 |
.IX Item "Version number must be a constant number" |
| 7754 |
(P) The attempt to translate a \f(CW\*(C`use Module n.n LIST\*(C'\fR statement into |
| 7755 |
its equivalent \f(CW\*(C`BEGIN\*(C'\fR block found an internal inconsistency with |
| 7756 |
the version number. |
| 7757 |
.IP "Version string '%s' contains invalid data; ignoring: '%s'" 4 |
| 7758 |
.IX Item "Version string '%s' contains invalid data; ignoring: '%s'" |
| 7759 |
(W misc) The version string contains invalid characters at the end, which |
| 7760 |
are being ignored. |
| 7761 |
.IP "Warning: something's wrong" 4 |
| 7762 |
.IX Item "Warning: something's wrong" |
| 7763 |
(W) You passed \fBwarn()\fR an empty string (the equivalent of \f(CW\*(C`warn ""\*(C'\fR) or |
| 7764 |
you called it with no args and \f(CW$@\fR was empty. |
| 7765 |
.ie n .IP "Warning: unable to close filehandle %s properly" 4 |
| 7766 |
.el .IP "Warning: unable to close filehandle \f(CW%s\fR properly" 4 |
| 7767 |
.IX Item "Warning: unable to close filehandle %s properly" |
| 7768 |
(S) The implicit \fBclose()\fR done by an \fBopen()\fR got an error indication on |
| 7769 |
the \fBclose()\fR. This usually indicates your file system ran out of disk |
| 7770 |
space. |
| 7771 |
.ie n .IP "Warning: unable to close filehandle properly: %s" 4 |
| 7772 |
.el .IP "Warning: unable to close filehandle properly: \f(CW%s\fR" 4 |
| 7773 |
.IX Item "Warning: unable to close filehandle properly: %s" |
| 7774 |
.PD 0 |
| 7775 |
.ie n .IP "Warning: unable to close filehandle %s properly: %s" 4 |
| 7776 |
.el .IP "Warning: unable to close filehandle \f(CW%s\fR properly: \f(CW%s\fR" 4 |
| 7777 |
.IX Item "Warning: unable to close filehandle %s properly: %s" |
| 7778 |
.PD |
| 7779 |
(S io) There were errors during the implicit \fBclose()\fR done on a filehandle |
| 7780 |
when its reference count reached zero while it was still open, e.g.: |
| 7781 |
.Sp |
| 7782 |
.Vb 4 |
| 7783 |
\& { |
| 7784 |
\& open my $fh, \*(Aq>\*(Aq, $file or die "open: \*(Aq$file\*(Aq: $!\en"; |
| 7785 |
\& print $fh $data or die "print: $!"; |
| 7786 |
\& } # implicit close here |
| 7787 |
.Ve |
| 7788 |
.Sp |
| 7789 |
Because various errors may only be detected by \fBclose()\fR (e.g. buffering could |
| 7790 |
allow the \f(CW\*(C`print\*(C'\fR in this example to return true even when the disk is full), |
| 7791 |
it is dangerous to ignore its result. So when it happens implicitly, perl |
| 7792 |
will signal errors by warning. |
| 7793 |
.Sp |
| 7794 |
\&\fBPrior to version 5.22.0, perl ignored such errors\fR, so the common idiom shown |
| 7795 |
above was liable to cause \fBsilent data loss\fR. |
| 7796 |
.IP "Warning: Use of ""%s"" without parentheses is ambiguous" 4 |
| 7797 |
.IX Item "Warning: Use of ""%s"" without parentheses is ambiguous" |
| 7798 |
(S ambiguous) You wrote a unary operator followed by something that |
| 7799 |
looks like a binary operator that could also have been interpreted as a |
| 7800 |
term or unary operator. For instance, if you know that the rand |
| 7801 |
function has a default argument of 1.0, and you write |
| 7802 |
.Sp |
| 7803 |
.Vb 1 |
| 7804 |
\& rand + 5; |
| 7805 |
.Ve |
| 7806 |
.Sp |
| 7807 |
you may THINK you wrote the same thing as |
| 7808 |
.Sp |
| 7809 |
.Vb 1 |
| 7810 |
\& rand() + 5; |
| 7811 |
.Ve |
| 7812 |
.Sp |
| 7813 |
but in actual fact, you got |
| 7814 |
.Sp |
| 7815 |
.Vb 1 |
| 7816 |
\& rand(+5); |
| 7817 |
.Ve |
| 7818 |
.Sp |
| 7819 |
So put in parentheses to say what you really mean. |
| 7820 |
.IP "when is deprecated" 4 |
| 7821 |
.IX Item "when is deprecated" |
| 7822 |
(D deprecated::smartmatch) \f(CW\*(C`when\*(C'\fR depends on smartmatch, which is |
| 7823 |
deprecated. Additionally, it has several special cases that may |
| 7824 |
not be immediately obvious, and it will be removed in Perl 5.42. |
| 7825 |
See the explanation |
| 7826 |
under "Experimental Details on given and when" in perlsyn. |
| 7827 |
.ie n .IP "Wide character in %s" 4 |
| 7828 |
.el .IP "Wide character in \f(CW%s\fR" 4 |
| 7829 |
.IX Item "Wide character in %s" |
| 7830 |
(S utf8) Perl met a wide character (ordinal >255) when it wasn't |
| 7831 |
expecting one. This warning is by default on for I/O (like print). |
| 7832 |
.Sp |
| 7833 |
If this warning does come from I/O, the easiest |
| 7834 |
way to quiet it is simply to add the \f(CW\*(C`:utf8\*(C'\fR layer, \fIe.g.\fR, |
| 7835 |
\&\f(CW\*(C`binmode\ STDOUT,\ \*(Aq:utf8\*(Aq\*(C'\fR. Another way to turn off the warning is |
| 7836 |
to add \f(CW\*(C`no\ warnings\ \*(Aqutf8\*(Aq;\*(C'\fR but that is often closer to |
| 7837 |
cheating. In general, you are supposed to explicitly mark the |
| 7838 |
filehandle with an encoding, see open and "binmode" in perlfunc. |
| 7839 |
.Sp |
| 7840 |
If the warning comes from other than I/O, this diagnostic probably |
| 7841 |
indicates that incorrect results are being obtained. You should examine |
| 7842 |
your code to determine how a wide character is getting to an operation |
| 7843 |
that doesn't handle them. |
| 7844 |
.ie n .IP "Wide character (U+%X) in %s" 4 |
| 7845 |
.el .IP "Wide character (U+%X) in \f(CW%s\fR" 4 |
| 7846 |
.IX Item "Wide character (U+%X) in %s" |
| 7847 |
(W locale) While in a single-byte locale (\fIi.e.\fR, a non\-UTF\-8 |
| 7848 |
one), a multi-byte character was encountered. Perl considers this |
| 7849 |
character to be the specified Unicode code point. Combining non\-UTF\-8 |
| 7850 |
locales and Unicode is dangerous. Almost certainly some characters |
| 7851 |
will have two different representations. For example, in the ISO 8859\-7 |
| 7852 |
(Greek) locale, the code point 0xC3 represents a Capital Gamma. But so |
| 7853 |
also does 0x393. This will make string comparisons unreliable. |
| 7854 |
.Sp |
| 7855 |
You likely need to figure out how this multi-byte character got mixed up |
| 7856 |
with your single-byte locale (or perhaps you thought you had a UTF\-8 |
| 7857 |
locale, but Perl disagrees). |
| 7858 |
.IP "Within []\-length '%c' not allowed" 4 |
| 7859 |
.IX Item "Within []-length '%c' not allowed" |
| 7860 |
(F) The count in the (un)pack template may be replaced by \f(CW\*(C`[TEMPLATE]\*(C'\fR |
| 7861 |
only if \f(CW\*(C`TEMPLATE\*(C'\fR always matches the same amount of packed bytes that |
| 7862 |
can be determined from the template alone. This is not possible if |
| 7863 |
it contains any of the codes @, /, U, u, w or a *\-length. Redesign |
| 7864 |
the template. |
| 7865 |
.ie n .IP "While trying to resolve method call %s\->%s() can not locate package ""%s"" yet it is mentioned in @%s::ISA (perhaps you forgot to load ""%s""?)" 4 |
| 7866 |
.el .IP "While trying to resolve method call \f(CW%s\fR\->%s() can not locate package ""%s"" yet it is mentioned in @%s::ISA (perhaps you forgot to load ""%s""?)" 4 |
| 7867 |
.IX Item "While trying to resolve method call %s->%s() can not locate package ""%s"" yet it is mentioned in @%s::ISA (perhaps you forgot to load ""%s""?)" |
| 7868 |
(W syntax) It is possible that the \f(CW@ISA\fR contains a misspelled or never loaded |
| 7869 |
package name, which can result in perl choosing an unexpected parent |
| 7870 |
class's method to resolve the method call. If this is deliberate you |
| 7871 |
can do something like |
| 7872 |
.Sp |
| 7873 |
.Vb 1 |
| 7874 |
\& @Missing::Package::ISA = (); |
| 7875 |
.Ve |
| 7876 |
.Sp |
| 7877 |
to silence the warnings, otherwise you should correct the package name, or |
| 7878 |
ensure that the package is loaded prior to the method call. |
| 7879 |
.IP "%s() with negative argument" 4 |
| 7880 |
.IX Item "%s() with negative argument" |
| 7881 |
(S misc) Certain operations make no sense with negative arguments. |
| 7882 |
Warning is given and the operation is not done. |
| 7883 |
.ie n .IP "\fBwrite()\fR on closed filehandle %s" 4 |
| 7884 |
.el .IP "\fBwrite()\fR on closed filehandle \f(CW%s\fR" 4 |
| 7885 |
.IX Item "write() on closed filehandle %s" |
| 7886 |
(W closed) The filehandle you're writing to got itself closed sometime |
| 7887 |
before now. Check your control flow. |
| 7888 |
.ie n .IP "%s ""\ex%X"" does not map to Unicode" 4 |
| 7889 |
.el .IP "\f(CW%s\fR ""\ex%X"" does not map to Unicode" 4 |
| 7890 |
.IX Item "%s ""x%X"" does not map to Unicode" |
| 7891 |
(S utf8) When reading in different encodings, Perl tries to |
| 7892 |
map everything into Unicode characters. The bytes you read |
| 7893 |
in are not legal in this encoding. For example |
| 7894 |
.Sp |
| 7895 |
.Vb 1 |
| 7896 |
\& utf8 "\exE4" does not map to Unicode |
| 7897 |
.Ve |
| 7898 |
.Sp |
| 7899 |
if you try to read in the a\-diaereses Latin\-1 as UTF\-8. |
| 7900 |
.IP "'X' outside of string" 4 |
| 7901 |
.IX Item "'X' outside of string" |
| 7902 |
(F) You had a (un)pack template that specified a relative position before |
| 7903 |
the beginning of the string being (un)packed. See "pack" in perlfunc. |
| 7904 |
.IP "'x' outside of string in unpack" 4 |
| 7905 |
.IX Item "'x' outside of string in unpack" |
| 7906 |
(F) You had an unpack template that specified a relative position after |
| 7907 |
the end of the string being unpacked. See "pack" in perlfunc. |
| 7908 |
.IP "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!" 4 |
| 7909 |
.IX Item "YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!" |
| 7910 |
(F) And you probably never will, because you probably don't have the |
| 7911 |
sources to your kernel, and your vendor probably doesn't give a rip |
| 7912 |
about what you want. There is a vulnerability anywhere that you have a |
| 7913 |
set-id script, and to close it you need to remove the set-id bit from |
| 7914 |
the script that you're attempting to run. To actually run the script |
| 7915 |
set-id, your best bet is to put a set-id C wrapper around your script. |
| 7916 |
.IP "You need to quote ""%s""" 4 |
| 7917 |
.IX Item "You need to quote ""%s""" |
| 7918 |
(W syntax) You assigned a bareword as a signal handler name: |
| 7919 |
.Sp |
| 7920 |
.Vb 1 |
| 7921 |
\& $SIG{...} = foo; |
| 7922 |
.Ve |
| 7923 |
.Sp |
| 7924 |
However, this will not make \f(CW\*(C`sub foo\*(C'\fR the signal handler. Instead, Perl |
| 7925 |
will call the subroutine when the assignment is executed and use the |
| 7926 |
returned value as the signal handler, which is probably not what you want. |
| 7927 |
(If it \fIis\fR what you want, put \f(CW\*(C`()\*(C'\fR after the subroutine name to avoid |
| 7928 |
the warning.) |
| 7929 |
.Sp |
| 7930 |
To register the subroutine as the signal handler, take a reference to it: |
| 7931 |
.Sp |
| 7932 |
.Vb 1 |
| 7933 |
\& $SIG{...} = \e&foo; |
| 7934 |
.Ve |
| 7935 |
.IP "Your random numbers are not that random" 4 |
| 7936 |
.IX Item "Your random numbers are not that random" |
| 7937 |
(F) When trying to initialize the random seed for hashes, Perl could |
| 7938 |
not get any randomness out of your system. This usually indicates |
| 7939 |
Something Very Wrong. |
| 7940 |
.IP "Zero length \eN{} in regex; marked by <\-\-\ HERE in m/%s/" 4 |
| 7941 |
.IX Item "Zero length N{} in regex; marked by <--\ HERE in m/%s/" |
| 7942 |
(F) Named Unicode character escapes (\f(CW\*(C`\eN{...}\*(C'\fR) may return a zero-length |
| 7943 |
sequence. Such an escape was used in an extended character class, i.e. |
| 7944 |
\&\f(CW\*(C`(?[...])\*(C'\fR, or under \f(CW\*(C`use re \*(Aqstrict\*(Aq\*(C'\fR, which is not permitted. Check |
| 7945 |
that the correct escape has been used, and the correct charnames handler |
| 7946 |
is in scope. The <\-\-\ HERE shows whereabouts in the regular |
| 7947 |
expression the problem was discovered. |
| 7948 |
.SH "SEE ALSO" |
| 7949 |
.IX Header "SEE ALSO" |
| 7950 |
warnings, diagnostics. |