This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Re: odd (or not so odd?) segmentation fault in 5.8.0
[perl5.git] / pod / perldiag.pod
CommitLineData
a0d0e21e
LW
1=head1 NAME
2
3perldiag - various Perl diagnostics
4
5=head1 DESCRIPTION
6
7These messages are classified as follows (listed in increasing order of
8desperation):
9
10 (W) A warning (optional).
11 (D) A deprecation (optional).
e476b1b5 12 (S) A severe warning (default).
a0d0e21e
LW
13 (F) A fatal error (trappable).
14 (P) An internal error you should never see (trappable).
54310121 15 (X) A very fatal error (nontrappable).
cb1a09d0 16 (A) An alien error message (not generated by Perl).
a0d0e21e 17
75b44862 18The majority of messages from the first three classifications above
64977eb6 19(W, D & S) can be controlled using the C<warnings> pragma.
e476b1b5
GS
20
21If a message can be controlled by the C<warnings> pragma, its warning
22category is included with the classification letter in the description
23below.
24
25Optional warnings are enabled by using the C<warnings> pragma or the B<-w>
26and B<-W> switches. Warnings may be captured by setting C<$SIG{__WARN__}>
27to a reference to a routine that will be called on each warning instead
28of printing it. See L<perlvar>.
29
30Default warnings are always enabled unless they are explicitly disabled
31with the C<warnings> pragma or the B<-X> switch.
4438c4b7 32
748a9306 33Trappable errors may be trapped using the eval operator. See
4438c4b7
JH
34L<perlfunc/eval>. In almost all cases, warnings may be selectively
35disabled or promoted to fatal errors using the C<warnings> pragma.
36See L<warnings>.
a0d0e21e 37
6df41af2
GS
38The messages are in alphabetical order, without regard to upper or
39lower-case. Some of these messages are generic. Spots that vary are
40denoted with a %s or other printf-style escape. These escapes are
41ignored by the alphabetical order, as are all characters other than
42letters. To look up your message, just ignore anything that is not a
43letter.
a0d0e21e
LW
44
45=over 4
46
c133c03f
JH
47=item A thread exited while %d other threads were still running
48
49(W) When using threaded Perl, a thread (not necessarily the main
50thread) exited while there were still other threads running.
51Usually it's a good idea to first collect the return values of the
32419a4c 52created threads by joining them, and only then exit from the main
c133c03f
JH
53thread. See L<threads>.
54
6df41af2 55=item accept() on closed socket %s
33633739 56
be771a83
GS
57(W closed) You tried to do an accept on a closed socket. Did you forget
58to check the return value of your socket() call? See
59L<perlfunc/accept>.
33633739 60
6df41af2 61=item Allocation too large: %lx
a0d0e21e 62
6df41af2 63(X) You can't allocate more than 64K on an MS-DOS machine.
a0d0e21e 64
f61d411c 65=item '!' allowed only after types %s
ef54e1a4 66
f61d411c
JH
67(F) The '!' is allowed in pack() and unpack() only after certain types.
68See L<perlfunc/pack>.
ef54e1a4 69
6df41af2 70=item Ambiguous call resolved as CORE::%s(), qualify as such or use &
43192e07 71
75b44862 72(W ambiguous) A subroutine you have declared has the same name as a Perl
be771a83
GS
73keyword, and you have used the name without qualification for calling
74one or the other. Perl decided to call the builtin because the
75subroutine is not imported.
43192e07 76
6df41af2
GS
77To force interpretation as a subroutine call, either put an ampersand
78before the subroutine name, or qualify the name with its package.
79Alternatively, you can import the subroutine (or pretend that it's
80imported with the C<use subs> pragma).
43192e07 81
6df41af2 82To silently interpret it as the Perl operator, use the C<CORE::> prefix
496a33f5 83on the operator (e.g. C<CORE::log($x)>) or declare the subroutine
be771a83
GS
84to be an object method (see L<perlsub/"Subroutine Attributes"> or
85L<attributes>).
43192e07 86
c2e66d9e
GS
87=item Ambiguous range in transliteration operator
88
89(F) You wrote something like C<tr/a-z-0//> which doesn't mean anything at
90all. To include a C<-> character in a transliteration, put it either
91first or last. (In the past, C<tr/a-z-0//> was synonymous with
92C<tr/a-y//>, which was probably not what you would have expected.)
93
6df41af2 94=item Ambiguous use of %s resolved as %s
43192e07 95
6df41af2
GS
96(W ambiguous)(S) You said something that may not be interpreted the way
97you thought. Normally it's pretty easy to disambiguate it by supplying
98a missing quote, operator, parenthesis pair or declaration.
a0d0e21e 99
6df41af2 100=item '|' and '<' may not both be specified on command line
a0d0e21e 101
be771a83
GS
102(F) An error peculiar to VMS. Perl does its own command line
103redirection, and found that STDIN was a pipe, and that you also tried to
104redirect STDIN using '<'. Only one STDIN stream to a customer, please.
c9f97d15 105
6df41af2 106=item '|' and '>' may not both be specified on command line
1028017a 107
be771a83
GS
108(F) An error peculiar to VMS. Perl does its own command line
109redirection, and thinks you tried to redirect stdout both to a file and
110into a pipe to another command. You need to choose one or the other,
111though nothing's stopping you from piping into a program or Perl script
112which 'splits' output into two streams, such as
1028017a 113
6df41af2
GS
114 open(OUT,">$ARGV[0]") or die "Can't write to $ARGV[0]: $!";
115 while (<STDIN>) {
116 print;
117 print OUT;
118 }
119 close OUT;
c9f97d15 120
6df41af2 121=item Applying %s to %s will act on scalar(%s)
eb6e2d6f 122
496a33f5
SC
123(W misc) The pattern match (C<//>), substitution (C<s///>), and
124transliteration (C<tr///>) operators work on scalar values. If you apply
be771a83
GS
125one of them to an array or a hash, it will convert the array or hash to
126a scalar value -- the length of an array, or the population info of a
127hash -- and then work on that scalar value. This is probably not what
128you meant to do. See L<perlfunc/grep> and L<perlfunc/map> for
129alternatives.
eb6e2d6f 130
6df41af2 131=item Args must match #! line
a0d0e21e 132
6df41af2
GS
133(F) The setuid emulator requires that the arguments Perl was invoked
134with match the arguments specified on the #! line. Since some systems
135impose a one-argument limit on the #! line, try combining switches;
136for example, turn C<-w -U> into C<-wU>.
a0d0e21e 137
6df41af2 138=item Arg too short for msgsnd
76cd736e 139
6df41af2 140(F) msgsnd() requires a string at least as long as sizeof(long).
76cd736e 141
8ea97a1e 142=item %s argument is not a HASH or ARRAY element
a0d0e21e 143
8ea97a1e 144(F) The argument to exists() must be a hash or array element, such as:
a0d0e21e
LW
145
146 $foo{$bar}
cb4f522a 147 $ref->{"susie"}[12]
a0d0e21e 148
8ea97a1e 149=item %s argument is not a HASH or ARRAY element or slice
5f05dabc 150
be771a83
GS
151(F) The argument to delete() must be either a hash or array element,
152such as:
5f05dabc
PP
153
154 $foo{$bar}
cb4f522a 155 $ref->{"susie"}[12]
5f05dabc 156
8ea97a1e 157or a hash or array slice, such as:
5f05dabc 158
6df41af2
GS
159 @foo[$bar, $baz, $xyzzy]
160 @{$ref->[12]}{"susie", "queue"}
5315574d 161
6df41af2 162=item %s argument is not a subroutine name
a0d0e21e 163
6df41af2 164(F) The argument to exists() for C<exists &sub> must be a subroutine
be771a83
GS
165name, and not a subroutine call. C<exists &sub()> will generate this
166error.
a0d0e21e 167
cb77fdf0
RGS
168=item '%s' trapped by operation mask
169
170(F) You tried to use an operator from a Safe compartment in which it's
171disallowed. See L<Safe>.
172
f86702cc 173=item Argument "%s" isn't numeric%s
a0d0e21e 174
be771a83
GS
175(W numeric) The indicated string was fed as an argument to an operator
176that expected a numeric value instead. If you're fortunate the message
177will identify which operator was so unfortunate.
a0d0e21e
LW
178
179=item Array @%s missing the @ in argument %d of %s()
180
75b44862
GS
181(D deprecated) Really old Perl let you omit the @ on array names in some
182spots. This is now heavily deprecated.
a0d0e21e
LW
183
184=item assertion botched: %s
185
186(P) The malloc package that comes with Perl had an internal failure.
187
188=item Assertion failed: file "%s"
189
190(P) A general assertion failed. The file in question must be examined.
191
192=item Assignment to both a list and a scalar
193
194(F) If you assign to a conditional operator, the 2nd and 3rd arguments
195must either both be scalars or both be lists. Otherwise Perl won't
196know which context to supply to the right side.
197
2393f1b9 198=item Attempt to access disallowed key '%s' in a restricted hash
1b1f1335 199
49293501 200(F) The failing code has attempted to get or set a key which is not in
2393f1b9 201the current set of allowed keys of a restricted hash.
49293501 202
2393f1b9 203=item Attempt to clear a restricted hash
49293501 204
2393f1b9 205(F) It is currently not allowed to clear a restricted hash, even if the
49293501
MS
206new hash would contain the same keys as before. This may change in
207the future.
208
2393f1b9 209=item Attempt to delete readonly key '%s' from a restricted hash
49293501
MS
210
211(F) The failing code attempted to delete a key whose value has been
2393f1b9 212declared readonly from a restricted hash.
49293501 213
2393f1b9 214=item Attempt to delete disallowed key '%s' from a restricted hash
49293501 215
2393f1b9
JH
216(F) The failing code attempted to delete from a restricted hash a key
217which is not in its key set.
1b1f1335 218
81689caa
HS
219=item Attempt to bless into a reference
220
221(F) The CLASSNAME argument to the bless() operator is expected to be
222the name of the package to bless the resulting object into. You've
223supplied instead a reference to something: perhaps you wrote
224
225 bless $self, $proto;
226
227when you intended
228
229 bless $self, ref($proto) || $proto;
230
231If you actually want to bless into the stringified version
232of the reference supplied, you need to stringify it yourself, for
233example by:
234
235 bless $self, "$proto";
236
a0d0e21e
LW
237=item Attempt to free non-arena SV: 0x%lx
238
be771a83
GS
239(P internal) All SV objects are supposed to be allocated from arenas
240that will be garbage collected on exit. An SV was discovered to be
241outside any of those arenas.
a0d0e21e 242
54310121 243=item Attempt to free nonexistent shared string
bbce6d69 244
be771a83
GS
245(P internal) Perl maintains a reference counted internal table of
246strings to optimize the storage and access of hash keys and other
247strings. This indicates someone tried to decrement the reference count
248of a string that can no longer be found in the table.
bbce6d69 249
a0d0e21e
LW
250=item Attempt to free temp prematurely
251
be771a83
GS
252(W debugging) Mortalized values are supposed to be freed by the
253free_tmps() routine. This indicates that something else is freeing the
254SV before the free_tmps() routine gets a chance, which means that the
255free_tmps() routine will be freeing an unreferenced scalar when it does
256try to free it.
a0d0e21e
LW
257
258=item Attempt to free unreferenced glob pointers
259
e476b1b5 260(P internal) The reference counts got screwed up on symbol aliases.
a0d0e21e
LW
261
262=item Attempt to free unreferenced scalar
263
be771a83
GS
264(W internal) Perl went to decrement the reference count of a scalar to
265see if it would go to 0, and discovered that it had already gone to 0
266earlier, and should have been freed, and in fact, probably was freed.
267This could indicate that SvREFCNT_dec() was called too many times, or
268that SvREFCNT_inc() was called too few times, or that the SV was
269mortalized when it shouldn't have been, or that memory has been
270corrupted.
a0d0e21e 271
dcdda58d
GS
272=item Attempt to join self
273
274(F) You tried to join a thread from within itself, which is an
be771a83
GS
275impossible task. You may be joining the wrong thread, or you may need
276to move the join() to some other thread.
dcdda58d 277
84902520
TB
278=item Attempt to pack pointer to temporary value
279
be771a83
GS
280(W pack) You tried to pass a temporary value (like the result of a
281function, or a computed expression) to the "p" pack() template. This
282means the result contains a pointer to a location that could become
283invalid anytime, even before the end of the current statement. Use
284literals or global values as arguments to the "p" pack() template to
285avoid this warning.
84902520 286
b7a902f4
PP
287=item Attempt to use reference as lvalue in substr
288
be771a83
GS
289(W substr) You supplied a reference as the first argument to substr()
290used as an lvalue, which is pretty strange. Perhaps you forgot to
291dereference it first. See L<perlfunc/substr>.
b7a902f4 292
dc26df50 293=item Bad arg length for %s, is %d, should be %s
a0d0e21e 294
be771a83
GS
295(F) You passed a buffer of the wrong size to one of msgctl(), semctl()
296or shmctl(). In C parlance, the correct sizes are, respectively,
5f05dabc 297S<sizeof(struct msqid_ds *)>, S<sizeof(struct semid_ds *)>, and
a0d0e21e
LW
298S<sizeof(struct shmid_ds *)>.
299
7a95317d
GS
300=item Bad evalled substitution pattern
301
496a33f5 302(F) You've used the C</e> switch to evaluate the replacement for a
7a95317d
GS
303substitution, but perl found a syntax error in the code to evaluate,
304most likely an unexpected right brace '}'.
305
a0d0e21e
LW
306=item Bad filehandle: %s
307
be771a83
GS
308(F) A symbol was passed to something wanting a filehandle, but the
309symbol has no filehandle associated with it. Perhaps you didn't do an
310open(), or did it in another package.
a0d0e21e
LW
311
312=item Bad free() ignored
313
be771a83
GS
314(S malloc) An internal routine called free() on something that had never
315been malloc()ed in the first place. Mandatory, but can be disabled by
9ea8bc6d 316setting environment variable C<PERL_BADFREE> to 0.
33c8a3fe 317
9ea8bc6d 318This message can be seen quite often with DB_File on systems with "hard"
be771a83
GS
319dynamic linking, like C<AIX> and C<OS/2>. It is a bug of C<Berkeley DB>
320which is left unnoticed if C<DB> uses I<forgiving> system malloc().
a0d0e21e 321
aa689395
PP
322=item Bad hash
323
324(P) One of the internal hash routines was passed a null HV pointer.
325
6df41af2
GS
326=item Badly placed ()'s
327
328(A) You've accidentally run your script through B<csh> instead
329of Perl. Check the #! line, or manually feed your script into
330Perl yourself.
331
a0d0e21e
LW
332=item Bad name after %s::
333
be771a83
GS
334(F) You started to name a symbol by using a package prefix, and then
335didn't finish the symbol. In particular, you can't interpolate outside
336of quotes, so
a0d0e21e
LW
337
338 $var = 'myvar';
339 $sym = mypack::$var;
340
341is not the same as
342
343 $var = 'myvar';
344 $sym = "mypack::$var";
345
4ad56ec9
IZ
346=item Bad realloc() ignored
347
be771a83
GS
348(S malloc) An internal routine called realloc() on something that had
349never been malloc()ed in the first place. Mandatory, but can be disabled
350by setting environment variable C<PERL_BADFREE> to 1.
4ad56ec9 351
a0d0e21e
LW
352=item Bad symbol for array
353
354(P) An internal request asked to add an array entry to something that
355wasn't a symbol table entry.
356
357=item Bad symbol for filehandle
358
be771a83
GS
359(P) An internal request asked to add a filehandle entry to something
360that wasn't a symbol table entry.
a0d0e21e
LW
361
362=item Bad symbol for hash
363
364(P) An internal request asked to add a hash entry to something that
365wasn't a symbol table entry.
366
34d09196
GS
367=item Bareword found in conditional
368
be771a83
GS
369(W bareword) The compiler found a bareword where it expected a
370conditional, which often indicates that an || or && was parsed as part
371of the last argument of the previous construct, for example:
34d09196
GS
372
373 open FOO || die;
374
be771a83
GS
375It may also indicate a misspelled constant that has been interpreted as
376a bareword:
34d09196
GS
377
378 use constant TYPO => 1;
379 if (TYOP) { print "foo" }
380
381The C<strict> pragma is useful in avoiding such errors.
382
6df41af2
GS
383=item Bareword "%s" not allowed while "strict subs" in use
384
385(F) With "strict subs" in use, a bareword is only allowed as a
be771a83
GS
386subroutine identifier, in curly brackets or to the left of the "=>"
387symbol. Perhaps you need to predeclare a subroutine?
6df41af2
GS
388
389=item Bareword "%s" refers to nonexistent package
390
be771a83
GS
391(W bareword) You used a qualified bareword of the form C<Foo::>, but the
392compiler saw no other uses of that namespace before that point. Perhaps
393you need to predeclare a package?
6df41af2 394
a0d0e21e
LW
395=item BEGIN failed--compilation aborted
396
be771a83
GS
397(F) An untrapped exception was raised while executing a BEGIN
398subroutine. Compilation stops immediately and the interpreter is
399exited.
a0d0e21e 400
68dc0745
PP
401=item BEGIN not safe after errors--compilation aborted
402
403(F) Perl found a C<BEGIN {}> subroutine (or a C<use> directive, which
be771a83
GS
404implies a C<BEGIN {}>) after one or more compilation errors had already
405occurred. Since the intended environment for the C<BEGIN {}> could not
406be guaranteed (due to the errors), and since subsequent code likely
407depends on its correct operation, Perl just gave up.
68dc0745 408
6df41af2
GS
409=item \1 better written as $1
410
be771a83
GS
411(W syntax) Outside of patterns, backreferences live on as variables.
412The use of backslashes is grandfathered on the right-hand side of a
413substitution, but stylistically it's better to use the variable form
414because other Perl programmers will expect it, and it works better if
415there are more than 9 backreferences.
6df41af2 416
252aa082
JH
417=item Binary number > 0b11111111111111111111111111111111 non-portable
418
e476b1b5 419(W portable) The binary number you specified is larger than 2**32-1
9e24b6e2
JH
420(4294967295) and therefore non-portable between systems. See
421L<perlport> for more on portability concerns.
252aa082 422
69282e91 423=item bind() on closed socket %s
a0d0e21e 424
be771a83
GS
425(W closed) You tried to do a bind on a closed socket. Did you forget to
426check the return value of your socket() call? See L<perlfunc/bind>.
a0d0e21e 427
c289d2f7
JH
428=item binmode() on closed filehandle %s
429
430(W unopened) You tried binmode() on a filehandle that was never opened.
431Check you control flow and number of arguments.
432
c5a0f51a
JH
433=item Bit vector size > 32 non-portable
434
e476b1b5 435(W portable) Using bit vector sizes larger than 32 is non-portable.
c5a0f51a 436
4633a7c4
LW
437=item Bizarre copy of %s in %s
438
be771a83 439(P) Perl detected an attempt to copy an internal value that is not
b45f050a 440copyable.
4633a7c4 441
6df41af2
GS
442=item B<-P> not allowed for setuid/setgid script
443
444(F) The script would have to be opened by the C preprocessor by name,
445which provides a race condition that breaks security.
446
f675dbe5
CB
447=item Buffer overflow in prime_env_iter: %s
448
be771a83
GS
449(W internal) A warning peculiar to VMS. While Perl was preparing to
450iterate over %ENV, it encountered a logical name or symbol definition
451which was too long, so it was truncated to the string shown.
f675dbe5 452
a0d0e21e
LW
453=item Callback called exit
454
4929bf7b 455(F) A subroutine invoked from an external package via call_sv()
a0d0e21e
LW
456exited by calling exit.
457
6df41af2 458=item %s() called too early to check prototype
f675dbe5 459
be771a83
GS
460(W prototype) You've called a function that has a prototype before the
461parser saw a definition or declaration for it, and Perl could not check
462that the call conforms to the prototype. You need to either add an
463early prototype declaration for the subroutine in question, or move the
464subroutine definition ahead of the call to get proper prototype
465checking. Alternatively, if you are certain that you're calling the
466function correctly, you may put an ampersand before the name to avoid
467the warning. See L<perlsub>.
f675dbe5 468
0258719b
NC
469=item Can only compress unsigned integers
470
471(F) An argument to pack("w",...) was not an integer. The BER compressed
472integer format can only be used with positive integers, and you attempted
473to compress something else. See L<perlfunc/pack>.
474
475=item Cannot compress integer
476
477(F) An argument to pack("w",...) was too large to compress. The BER
478compressed integer format can only be used with positive integers, and you
479attempted to compress Infinity or a very large number (> 1e308).
480See L<perlfunc/pack>.
481
482=item Cannot compress negative numbers
483
484(F) An argument to pack("w",...) was negative. The BER compressed integer
485format can only be used with positive integers. See L<perlfunc/pack>.
486
6df41af2 487=item / cannot take a count
a0d0e21e 488
be771a83
GS
489(F) You had an unpack template indicating a counted-length string, but
490you have also specified an explicit size for the string. See
491L<perlfunc/pack>.
a0d0e21e
LW
492
493=item Can't bless non-reference value
494
495(F) Only hard references may be blessed. This is how Perl "enforces"
496encapsulation of objects. See L<perlobj>.
497
a0d0e21e
LW
498=item Can't call method "%s" in empty package "%s"
499
500(F) You called a method correctly, and it correctly indicated a package
501functioning as a class, but that package doesn't have ANYTHING defined
502in it, let alone methods. See L<perlobj>.
503
6df41af2
GS
504=item Can't call method "%s" on an undefined value
505
506(F) You used the syntax of a method call, but the slot filled by the
be771a83
GS
507object reference or package name contains an undefined value. Something
508like this will reproduce the error:
6df41af2
GS
509
510 $BADREF = undef;
511 process $BADREF 1,2,3;
512 $BADREF->process(1,2,3);
513
a0d0e21e
LW
514=item Can't call method "%s" on unblessed reference
515
54310121 516(F) A method call must know in what package it's supposed to run. It
be771a83
GS
517ordinarily finds this out from the object reference you supply, but you
518didn't supply an object reference in this case. A reference isn't an
519object reference until it has been blessed. See L<perlobj>.
a0d0e21e
LW
520
521=item Can't call method "%s" without a package or object reference
522
523(F) You used the syntax of a method call, but the slot filled by the
be771a83
GS
524object reference or package name contains an expression that returns a
525defined value which is neither an object reference nor a package name.
72b5445b
GS
526Something like this will reproduce the error:
527
528 $BADREF = 42;
529 process $BADREF 1,2,3;
530 $BADREF->process(1,2,3);
531
a0d0e21e
LW
532=item Can't chdir to %s
533
534(F) You called C<perl -x/foo/bar>, but C</foo/bar> is not a directory
535that you can chdir to, possibly because it doesn't exist.
536
0545a864 537=item Can't check filesystem of script "%s" for nosuid
104d25b7 538
be771a83
GS
539(P) For some reason you can't check the filesystem of the script for
540nosuid.
104d25b7 541
6df41af2
GS
542=item Can't coerce array into hash
543
544(F) You used an array where a hash was expected, but the array has no
545information on how to map from keys to array indices. You can do that
546only with arrays that have a hash reference at index 0.
547
a0d0e21e
LW
548=item Can't coerce %s to integer in %s
549
550(F) Certain types of SVs, in particular real symbol table entries
55497cff 551(typeglobs), can't be forced to stop being what they are. So you can't
a0d0e21e
LW
552say things like:
553
554 *foo += 1;
555
556You CAN say
557
558 $foo = *foo;
559 $foo += 1;
560
561but then $foo no longer contains a glob.
562
563=item Can't coerce %s to number in %s
564
565(F) Certain types of SVs, in particular real symbol table entries
55497cff 566(typeglobs), can't be forced to stop being what they are.
a0d0e21e
LW
567
568=item Can't coerce %s to string in %s
569
570(F) Certain types of SVs, in particular real symbol table entries
55497cff 571(typeglobs), can't be forced to stop being what they are.
a0d0e21e
LW
572
573=item Can't create pipe mailbox
574
be771a83
GS
575(P) An error peculiar to VMS. The process is suffering from exhausted
576quotas or other plumbing problems.
a0d0e21e 577
eb64745e 578=item Can't declare class for non-scalar %s in "%s"
a0d0e21e 579
2f7e735d
AMS
580(F) Currently, only scalar variables can be declared with a specific
581class qualifier in a "my" or "our" declaration. The semantics may be
582extended for other types of variables in future.
eb64745e
GS
583
584=item Can't declare %s in "%s"
585
586(F) Only scalar, array, and hash variables may be declared as "my" or
587"our" variables. They must have ordinary identifiers as names.
a0d0e21e 588
6df41af2
GS
589=item Can't do inplace edit: %s is not a regular file
590
be771a83
GS
591(S inplace) You tried to use the B<-i> switch on a special file, such as
592a file in /dev, or a FIFO. The file was ignored.
6df41af2 593
a0d0e21e
LW
594=item Can't do inplace edit on %s: %s
595
be771a83
GS
596(S inplace) The creation of the new file failed for the indicated
597reason.
a0d0e21e 598
54310121 599=item Can't do inplace edit without backup
a0d0e21e 600
be771a83
GS
601(F) You're on a system such as MS-DOS that gets confused if you try
602reading from a deleted (but still opened) file. You have to say
603C<-i.bak>, or some such.
a0d0e21e 604
10f9c03d 605=item Can't do inplace edit: %s would not be unique
a0d0e21e 606
e476b1b5 607(S inplace) Your filesystem does not support filenames longer than 14
10f9c03d
CK
608characters and Perl was unable to create a unique filename during
609inplace editing with the B<-i> switch. The file was ignored.
a0d0e21e 610
7253e4e3 611=item Can't do {n,m} with n > m in regex; marked by <-- HERE in m/%s/
a0d0e21e 612
b45f050a 613(F) Minima must be less than or equal to maxima. If you really want your
7253e4e3 614regexp to match something 0 times, just put {0}. The <-- HERE shows in the
b45f050a 615regular expression about where the problem was discovered. See L<perlre>.
a0d0e21e
LW
616
617=item Can't do setegid!
618
be771a83
GS
619(P) The setegid() call failed for some reason in the setuid emulator of
620suidperl.
a0d0e21e
LW
621
622=item Can't do seteuid!
623
624(P) The setuid emulator of suidperl failed for some reason.
625
626=item Can't do setuid
627
be771a83
GS
628(F) This typically means that ordinary perl tried to exec suidperl to do
629setuid emulation, but couldn't exec it. It looks for a name of the form
630sperl5.000 in the same directory that the perl executable resides under
631the name perl5.000, typically /usr/local/bin on Unix machines. If the
632file is there, check the execute permissions. If it isn't, ask your
633sysadmin why he and/or she removed it.
a0d0e21e
LW
634
635=item Can't do waitpid with flags
636
be771a83
GS
637(F) This machine doesn't have either waitpid() or wait4(), so only
638waitpid() without flags is emulated.
a0d0e21e 639
a0d0e21e
LW
640=item Can't emulate -%s on #! line
641
be771a83
GS
642(F) The #! line specifies a switch that doesn't make sense at this
643point. For example, it'd be kind of silly to put a B<-x> on the #!
644line.
a0d0e21e
LW
645
646=item Can't exec "%s": %s
647
d1be9408 648(W exec) A system(), exec(), or piped open call could not execute the
be771a83
GS
649named program for the indicated reason. Typical reasons include: the
650permissions were wrong on the file, the file wasn't found in
651C<$ENV{PATH}>, the executable in question was compiled for another
652architecture, or the #! line in a script points to an interpreter that
653can't be run for similar reasons. (Or maybe your system doesn't support
654#! at all.)
a0d0e21e
LW
655
656=item Can't exec %s
657
be771a83
GS
658(F) Perl was trying to execute the indicated program for you because
659that's what the #! line said. If that's not what you wanted, you may
660need to mention "perl" on the #! line somewhere.
a0d0e21e
LW
661
662=item Can't execute %s
663
be771a83
GS
664(F) You used the B<-S> switch, but the copies of the script to execute
665found in the PATH did not have correct permissions.
2a92aaa0 666
6df41af2 667=item Can't find an opnumber for "%s"
2a92aaa0 668
be771a83
GS
669(F) A string of a form C<CORE::word> was given to prototype(), but there
670is no builtin with the name C<word>.
6df41af2 671
56ca2fc0
JH
672=item Can't find %s character property "%s"
673
674(F) You used C<\p{}> or C<\P{}> but the character property by that name
89d60977 675could not be found. Maybe you misspelled the name of the property
56ca2fc0
JH
676(remember that the names of character properties consist only of
677alphanumeric characters), or maybe you forgot the C<Is> or C<In> prefix?
678
6df41af2
GS
679=item Can't find label %s
680
be771a83
GS
681(F) You said to goto a label that isn't mentioned anywhere that it's
682possible for us to go to. See L<perlfunc/goto>.
2a92aaa0
GS
683
684=item Can't find %s on PATH
685
be771a83
GS
686(F) You used the B<-S> switch, but the script to execute could not be
687found in the PATH.
a0d0e21e 688
6df41af2 689=item Can't find %s on PATH, '.' not in PATH
a0d0e21e 690
be771a83
GS
691(F) You used the B<-S> switch, but the script to execute could not be
692found in the PATH, or at least not with the correct permissions. The
693script exists in the current directory, but PATH prohibits running it.
a0d0e21e
LW
694
695=item Can't find string terminator %s anywhere before EOF
696
be771a83
GS
697(F) Perl strings can stretch over multiple lines. This message means
698that the closing delimiter was omitted. Because bracketed quotes count
699nesting levels, the following is missing its final parenthesis:
a0d0e21e 700
fb73857a
PP
701 print q(The character '(' starts a side comment.);
702
be771a83
GS
703If you're getting this error from a here-document, you may have included
704unseen whitespace before or after your closing tag. A good programmer's
705editor will have a way to help you find these characters.
a0d0e21e 706
64977eb6 707=item Can't find %s property definition %s
0103b764 708
77b96956
RGS
709(F) You may have tried to use C<\p> which means a Unicode property (for
710example C<\p{Lu}> is all uppercase letters). If you did mean to use a
bc45ce41
JH
711Unicode property, see L<perlunicode> for the list of known properties.
712If you didn't mean to use a Unicode property, escape the C<\p>, either
77b96956 713by C<\\p> (just the C<\p>) or by C<\Q\p> (the rest of the string, until
f91328b7 714possible C<\E>).
0103b764 715
a0d0e21e
LW
716=item Can't fork
717
be771a83
GS
718(F) A fatal error occurred while trying to fork while opening a
719pipeline.
a0d0e21e 720
748a9306
LW
721=item Can't get filespec - stale stat buffer?
722
be771a83
GS
723(S) A warning peculiar to VMS. This arises because of the difference
724between access checks under VMS and under the Unix model Perl assumes.
725Under VMS, access checks are done by filename, rather than by bits in
726the stat buffer, so that ACLs and other protections can be taken into
727account. Unfortunately, Perl assumes that the stat buffer contains all
728the necessary information, and passes it, instead of the filespec, to
729the access checking routine. It will try to retrieve the filespec using
730the device name and FID present in the stat buffer, but this works only
731if you haven't made a subsequent call to the CRTL stat() routine,
732because the device name is overwritten with each call. If this warning
733appears, the name lookup failed, and the access checking routine gave up
734and returned FALSE, just to be conservative. (Note: The access checking
735routine knows about the Perl C<stat> operator and file tests, so you
736shouldn't ever see this warning in response to a Perl command; it arises
737only if some internal code takes stat buffers lightly.)
748a9306 738
a0d0e21e
LW
739=item Can't get pipe mailbox device name
740
be771a83
GS
741(P) An error peculiar to VMS. After creating a mailbox to act as a
742pipe, Perl can't retrieve its name for later use.
a0d0e21e
LW
743
744=item Can't get SYSGEN parameter value for MAXBUF
745
748a9306
LW
746(P) An error peculiar to VMS. Perl asked $GETSYI how big you want your
747mailbox buffers to be, and didn't get an answer.
a0d0e21e 748
6df41af2 749=item Can't "goto" into the middle of a foreach loop
a0d0e21e 750
be771a83
GS
751(F) A "goto" statement was executed to jump into the middle of a foreach
752loop. You can't get there from here. See L<perlfunc/goto>.
6df41af2
GS
753
754=item Can't "goto" out of a pseudo block
755
be771a83
GS
756(F) A "goto" statement was executed to jump out of what might look like
757a block, except that it isn't a proper block. This usually occurs if
758you tried to jump out of a sort() block or subroutine, which is a no-no.
759See L<perlfunc/goto>.
a0d0e21e 760
b150fb22
RH
761=item Can't goto subroutine from an eval-string
762
be771a83
GS
763(F) The "goto subroutine" call can't be used to jump out of an eval
764"string". (You can use it to jump out of an eval {BLOCK}, but you
765probably don't want to.)
b150fb22 766
6df41af2
GS
767=item Can't goto subroutine outside a subroutine
768
be771a83
GS
769(F) The deeply magical "goto subroutine" call can only replace one
770subroutine call for another. It can't manufacture one out of whole
771cloth. In general you should be calling it out of only an AUTOLOAD
772routine anyway. See L<perlfunc/goto>.
6df41af2 773
0b5b802d
GS
774=item Can't ignore signal CHLD, forcing to default
775
be771a83
GS
776(W signal) Perl has detected that it is being run with the SIGCHLD
777signal (sometimes known as SIGCLD) disabled. Since disabling this
778signal will interfere with proper determination of exit status of child
779processes, Perl has reset the signal to its default value. This
780situation typically indicates that the parent program under which Perl
781may be running (e.g. cron) is being very careless.
0b5b802d 782
6df41af2 783=item Can't "last" outside a loop block
4633a7c4 784
6df41af2 785(F) A "last" statement was executed to break out of the current block,
be771a83
GS
786except that there's this itty bitty problem called there isn't a current
787block. Note that an "if" or "else" block doesn't count as a "loopish"
788block, as doesn't a block given to sort(), map() or grep(). You can
789usually double the curlies to get the same effect though, because the
790inner curlies will be considered a block that loops once. See
791L<perlfunc/last>.
4633a7c4 792
748a9306
LW
793=item Can't localize lexical variable %s
794
2ba9eb46 795(F) You used local on a variable name that was previously declared as a
748a9306
LW
796lexical variable using "my". This is not allowed. If you want to
797localize a package variable of the same name, qualify it with the
798package name.
799
6df41af2 800=item Can't localize through a reference
4727527e 801
6df41af2
GS
802(F) You said something like C<local $$ref>, which Perl can't currently
803handle, because when it goes to restore the old value of whatever $ref
be771a83 804pointed to after the scope of the local() is finished, it can't be sure
64977eb6 805that $ref will still be a reference.
4727527e 806
ea071790 807=item Can't locate %s
ec889f3a
GS
808
809(F) You said to C<do> (or C<require>, or C<use>) a file that couldn't be
810found. Perl looks for the file in all the locations mentioned in @INC,
be771a83
GS
811unless the file name included the full path to the file. Perhaps you
812need to set the PERL5LIB or PERL5OPT environment variable to say where
813the extra library is, or maybe the script needs to add the library name
814to @INC. Or maybe you just misspelled the name of the file. See
815L<perlfunc/require> and L<lib>.
a0d0e21e 816
6df41af2
GS
817=item Can't locate auto/%s.al in @INC
818
be771a83
GS
819(F) A function (or method) was called in a package which allows
820autoload, but there is no function to autoload. Most probable causes
821are a misprint in a function/method name or a failure to C<AutoSplit>
822the file, say, by doing C<make install>.
6df41af2 823
a0d0e21e
LW
824=item Can't locate object method "%s" via package "%s"
825
826(F) You called a method correctly, and it correctly indicated a package
827functioning as a class, but that package doesn't define that particular
2ba9eb46 828method, nor does any of its base classes. See L<perlobj>.
a0d0e21e 829
d28b25d0
JH
830=item Can't locate PerlIO%s
831
832(F) You tried to use in open() a PerlIO layer that does not exist,
3ad17c7e 833e.g. open(FH, ">:nosuchlayer", "somefile").
d28b25d0 834
c1899e02
GS
835=item (perhaps you forgot to load "%s"?)
836
837(F) This is an educated guess made in conjunction with the message
838"Can't locate object method \"%s\" via package \"%s\"". It often means
839that a method requires a package that has not been loaded.
840
a0d0e21e
LW
841=item Can't locate package %s for @%s::ISA
842
be771a83
GS
843(W syntax) The @ISA array contained the name of another package that
844doesn't seem to exist.
a0d0e21e 845
3e3baf6d
TB
846=item Can't make list assignment to \%ENV on this system
847
be771a83
GS
848(F) List assignment to %ENV is not supported on some systems, notably
849VMS.
3e3baf6d 850
a0d0e21e
LW
851=item Can't modify %s in %s
852
be771a83
GS
853(F) You aren't allowed to assign to the item indicated, or otherwise try
854to change it, such as with an auto-increment.
a0d0e21e 855
54310121 856=item Can't modify nonexistent substring
a0d0e21e
LW
857
858(P) The internal routine that does assignment to a substr() was handed
859a NULL.
860
6df41af2
GS
861=item Can't modify non-lvalue subroutine call
862
863(F) Subroutines meant to be used in lvalue context should be declared as
864such, see L<perlsub/"Lvalue subroutines">.
865
5f05dabc 866=item Can't msgrcv to read-only var
a0d0e21e 867
5f05dabc 868(F) The target of a msgrcv must be modifiable to be used as a receive
a0d0e21e
LW
869buffer.
870
6df41af2
GS
871=item Can't "next" outside a loop block
872
873(F) A "next" statement was executed to reiterate the current block, but
874there isn't a current block. Note that an "if" or "else" block doesn't
be771a83
GS
875count as a "loopish" block, as doesn't a block given to sort(), map() or
876grep(). You can usually double the curlies to get the same effect
877though, because the inner curlies will be considered a block that loops
878once. See L<perlfunc/next>.
6df41af2 879
a0d0e21e
LW
880=item Can't open %s: %s
881
c47ff5f1 882(S inplace) The implicit opening of a file through use of the C<< <> >>
08e9d68e
DD
883filehandle, either implicitly under the C<-n> or C<-p> command-line
884switches, or explicitly, failed for the indicated reason. Usually this
be771a83
GS
885is because you don't have read permission for a file which you named on
886the command line.
a0d0e21e 887
9a869a14
RGS
888=item Can't open a reference
889
890(W io) You tried to open a scalar reference for reading or writing,
891using the 3-arg open() syntax :
892
893 open FH, '>', $ref;
894
895but your version of perl is compiled without perlio, and this form of
896open is not supported.
897
a0d0e21e
LW
898=item Can't open bidirectional pipe
899
be771a83
GS
900(W pipe) You tried to say C<open(CMD, "|cmd|")>, which is not supported.
901You can try any of several modules in the Perl library to do this, such
902as IPC::Open2. Alternately, direct the pipe's output to a file using
903">", and then read it in under a different file handle.
a0d0e21e 904
748a9306
LW
905=item Can't open error file %s as stderr
906
be771a83
GS
907(F) An error peculiar to VMS. Perl does its own command line
908redirection, and couldn't open the file specified after '2>' or '2>>' on
909the command line for writing.
748a9306
LW
910
911=item Can't open input file %s as stdin
912
be771a83
GS
913(F) An error peculiar to VMS. Perl does its own command line
914redirection, and couldn't open the file specified after '<' on the
915command line for reading.
748a9306
LW
916
917=item Can't open output file %s as stdout
918
be771a83
GS
919(F) An error peculiar to VMS. Perl does its own command line
920redirection, and couldn't open the file specified after '>' or '>>' on
921the command line for writing.
748a9306
LW
922
923=item Can't open output pipe (name: %s)
924
be771a83
GS
925(P) An error peculiar to VMS. Perl does its own command line
926redirection, and couldn't open the pipe into which to send data destined
927for stdout.
748a9306 928
584d69ec 929=item Can't open perl script%s: %s
a0d0e21e
LW
930
931(F) The script you specified can't be opened for the indicated reason.
932
6df41af2
GS
933=item Can't read CRTL environ
934
935(S) A warning peculiar to VMS. Perl tried to read an element of %ENV
936from the CRTL's internal environment array and discovered the array was
937missing. You need to figure out where your CRTL misplaced its environ
be771a83
GS
938or define F<PERL_ENV_TABLES> (see L<perlvms>) so that environ is not
939searched.
6df41af2 940
7bac28a0
PP
941=item Can't redefine active sort subroutine %s
942
943(F) Perl optimizes the internal handling of sort subroutines and keeps
be771a83
GS
944pointers into them. You tried to redefine one such sort subroutine when
945it was currently active, which is not allowed. If you really want to do
7bac28a0
PP
946this, you should write C<sort { &func } @x> instead of C<sort func @x>.
947
6df41af2
GS
948=item Can't "redo" outside a loop block
949
950(F) A "redo" statement was executed to restart the current block, but
951there isn't a current block. Note that an "if" or "else" block doesn't
952count as a "loopish" block, as doesn't a block given to sort(), map()
953or grep(). You can usually double the curlies to get the same effect
954though, because the inner curlies will be considered a block that
955loops once. See L<perlfunc/redo>.
956
64977eb6 957=item Can't remove %s: %s, skipping file
10f9c03d 958
be771a83
GS
959(S inplace) You requested an inplace edit without creating a backup
960file. Perl was unable to remove the original file to replace it with
961the modified file. The file was left unmodified.
10f9c03d 962
a0d0e21e
LW
963=item Can't rename %s to %s: %s, skipping file
964
e476b1b5 965(S inplace) The rename done by the B<-i> switch failed for some reason,
10f9c03d 966probably because you don't have write permission to the directory.
a0d0e21e 967
748a9306
LW
968=item Can't reopen input pipe (name: %s) in binary mode
969
be771a83
GS
970(P) An error peculiar to VMS. Perl thought stdin was a pipe, and tried
971to reopen it to accept binary data. Alas, it failed.
748a9306 972
6df41af2
GS
973=item Can't resolve method `%s' overloading `%s' in package `%s'
974
be771a83
GS
975(F|P) Error resolving overloading specified by a method name (as opposed
976to a subroutine reference): no such method callable via the package. If
977method name is C<???>, this is an internal error.
6df41af2 978
a0d0e21e
LW
979=item Can't reswap uid and euid
980
be771a83
GS
981(P) The setreuid() call failed for some reason in the setuid emulator of
982suidperl.
a0d0e21e 983
cd06dffe
GS
984=item Can't return %s from lvalue subroutine
985
be771a83
GS
986(F) Perl detected an attempt to return illegal lvalues (such as
987temporary or readonly values) from a subroutine used as an lvalue. This
988is not allowed.
cd06dffe 989
78f9721b
SM
990=item Can't return %s to lvalue scalar context
991
992(F) You tried to return a complete array or hash from an lvalue subroutine,
993but you called the subroutine in a way that made Perl think you meant
994to return only one value. You probably meant to write parentheses around
995the call to the subroutine, which tell Perl that the call should be in
996list context.
997
6df41af2
GS
998=item Can't return outside a subroutine
999
1000(F) The return statement was executed in mainline code, that is, where
1001there was no subroutine call to return out of. See L<perlsub>.
1002
a0d0e21e
LW
1003=item Can't stat script "%s"
1004
be771a83
GS
1005(P) For some reason you can't fstat() the script even though you have it
1006open already. Bizarre.
a0d0e21e
LW
1007
1008=item Can't swap uid and euid
1009
be771a83
GS
1010(P) The setreuid() call failed for some reason in the setuid emulator of
1011suidperl.
a0d0e21e
LW
1012
1013=item Can't take log of %g
1014
fb73857a
PP
1015(F) For ordinary real numbers, you can't take the logarithm of a
1016negative number or zero. There's a Math::Complex package that comes
be771a83
GS
1017standard with Perl, though, if you really want to do that for the
1018negative numbers.
a0d0e21e
LW
1019
1020=item Can't take sqrt of %g
1021
1022(F) For ordinary real numbers, you can't take the square root of a
fb73857a
PP
1023negative number. There's a Math::Complex package that comes standard
1024with Perl, though, if you really want to do that.
a0d0e21e
LW
1025
1026=item Can't undef active subroutine
1027
1028(F) You can't undefine a routine that's currently running. You can,
1029however, redefine it while it's running, and you can even undef the
1030redefined subroutine while the old routine is running. Go figure.
1031
1032=item Can't unshift
1033
1034(F) You tried to unshift an "unreal" array that can't be unshifted, such
1035as the main Perl stack.
1036
1037=item Can't upgrade that kind of scalar
1038
be771a83
GS
1039(P) The internal sv_upgrade routine adds "members" to an SV, making it
1040into a more specialized kind of SV. The top several SV types are so
1041specialized, however, that they cannot be interconverted. This message
1042indicates that such a conversion was attempted.
a0d0e21e
LW
1043
1044=item Can't upgrade to undef
1045
be771a83
GS
1046(P) The undefined SV is the bottom of the totem pole, in the scheme of
1047upgradability. Upgrading to undef indicates an error in the code
1048calling sv_upgrade.
a0d0e21e 1049
6df41af2
GS
1050=item Can't use an undefined value as %s reference
1051
1052(F) A value used as either a hard reference or a symbolic reference must
1053be a defined value. This helps to delurk some insidious errors.
1054
1db89ea5
BS
1055=item Can't use anonymous symbol table for method lookup
1056
1057(P) The internal routine that does method lookup was handed a symbol
1058table that doesn't have a name. Symbol tables can become anonymous
1059for example by undefining stashes: C<undef %Some::Package::>.
1060
6df41af2
GS
1061=item Can't use bareword ("%s") as %s ref while "strict refs" in use
1062
be771a83
GS
1063(F) Only hard references are allowed by "strict refs". Symbolic
1064references are disallowed. See L<perlref>.
6df41af2 1065
90b75b61 1066=item Can't use %! because Errno.pm is not available
1d2dff63
GS
1067
1068(F) The first time the %! hash is used, perl automatically loads the
1069Errno.pm module. The Errno module is expected to tie the %! hash to
1070provide symbolic names for C<$!> errno values.
1071
6df41af2
GS
1072=item Can't use %s for loop variable
1073
be771a83
GS
1074(F) Only a simple scalar variable may be used as a loop variable on a
1075foreach.
6df41af2
GS
1076
1077=item Can't use global %s in "my"
1078
be771a83
GS
1079(F) You tried to declare a magical variable as a lexical variable. This
1080is not allowed, because the magic can be tied to only one location
1081(namely the global variable) and it would be incredibly confusing to
1082have variables in your program that looked like magical variables but
6df41af2
GS
1083weren't.
1084
c07a80fd
PP
1085=item Can't use "my %s" in sort comparison
1086
1087(F) The global variables $a and $b are reserved for sort comparisons.
c47ff5f1 1088You mentioned $a or $b in the same line as the <=> or cmp operator,
c07a80fd
PP
1089and the variable had earlier been declared as a lexical variable.
1090Either qualify the sort variable with the package name, or rename the
1091lexical variable.
1092
a0d0e21e
LW
1093=item Can't use %s ref as %s ref
1094
1095(F) You've mixed up your reference types. You have to dereference a
1096reference of the type needed. You can use the ref() function to
1097test the type of the reference, if need be.
1098
748a9306 1099=item Can't use string ("%s") as %s ref while "strict refs" in use
a0d0e21e 1100
be771a83
GS
1101(F) Only hard references are allowed by "strict refs". Symbolic
1102references are disallowed. See L<perlref>.
a0d0e21e 1103
748a9306
LW
1104=item Can't use subscript on %s
1105
1106(F) The compiler tried to interpret a bracketed expression as a
1107subscript. But to the left of the brackets was an expression that
1108didn't look like an array reference, or anything else subscriptable.
1109
6df41af2
GS
1110=item Can't use \%c to mean $%c in expression
1111
75b44862
GS
1112(W syntax) In an ordinary expression, backslash is a unary operator that
1113creates a reference to its argument. The use of backslash to indicate a
1114backreference to a matched substring is valid only as part of a regular
be771a83
GS
1115expression pattern. Trying to do this in ordinary Perl code produces a
1116value that prints out looking like SCALAR(0xdecaf). Use the $1 form
1117instead.
6df41af2 1118
810b8aa5
GS
1119=item Can't weaken a nonreference
1120
1121(F) You attempted to weaken something that was not a reference. Only
1122references can be weakened.
1123
5f05dabc 1124=item Can't x= to read-only value
a0d0e21e 1125
be771a83
GS
1126(F) You tried to repeat a constant value (often the undefined value)
1127with an assignment operator, which implies modifying the value itself.
a0d0e21e
LW
1128Perhaps you need to copy the value to a temporary, and repeat that.
1129
ac7cd81a
SC
1130=item Character in "C" format wrapped
1131
1132(W pack) You said
1133
1134 pack("C", $x)
1135
1136where $x is either less than 0 or more than 255; the C<"C"> format is
1137only for encoding native operating system characters (ASCII, EBCDIC,
1138and so on) and not for Unicode characters, so Perl behaved as if you meant
1139
1140 pack("C", $x & 255)
1141
1142If you actually want to pack Unicode codepoints, use the C<"U"> format
1143instead.
1144
1145=item Character in "c" format wrapped
1146
1147(W pack) You said
1148
1149 pack("c", $x)
1150
1151where $x is either less than -128 or more than 127; the C<"c"> format
1152is only for encoding native operating system characters (ASCII, EBCDIC,
1153and so on) and not for Unicode characters, so Perl behaved as if you meant
1154
1155 pack("c", $x & 255);
1156
1157If you actually want to pack Unicode codepoints, use the C<"U"> format
1158instead.
1159
9ddeeac9 1160=item close() on unopened filehandle %s
a0d0e21e 1161
e476b1b5 1162(W unopened) You tried to close a filehandle that was never opened.
a0d0e21e 1163
6df41af2
GS
1164=item %s: Command not found
1165
be771a83
GS
1166(A) You've accidentally run your script through B<csh> instead of Perl.
1167Check the #! line, or manually feed your script into Perl yourself.
6df41af2 1168
7a2e2cd6
PP
1169=item Compilation failed in require
1170
1171(F) Perl could not compile a file specified in a C<require> statement.
be771a83
GS
1172Perl uses this generic message when none of the errors that it
1173encountered were severe enough to halt compilation immediately.
7a2e2cd6 1174
c3464db5
DD
1175=item Complex regular subexpression recursion limit (%d) exceeded
1176
be771a83
GS
1177(W regexp) The regular expression engine uses recursion in complex
1178situations where back-tracking is required. Recursion depth is limited
1179to 32766, or perhaps less in architectures where the stack cannot grow
1180arbitrarily. ("Simple" and "medium" situations are handled without
1181recursion and are not subject to a limit.) Try shortening the string
1182under examination; looping in Perl code (e.g. with C<while>) rather than
1183in the regular expression engine; or rewriting the regular expression so
c2e66d9e 1184that it is simpler or backtracks less. (See L<perlfaq2> for information
be771a83 1185on I<Mastering Regular Expressions>.)
c3464db5 1186
38875929
DM
1187=item cond_broadcast() called on unlocked variable
1188
1189(W threads) Within a thread-enabled program, you tried to call
1190cond_broadcast() on a variable which wasn't locked. The cond_broadcast()
1191function is used to wake up another thread that is waiting in a
1192cond_wait(). To ensure that the signal isn't sent before the other thread
1193has a chance to enter the wait, it is usual for the signaling thread to
1194first wait for a lock on variable. This lock attempt will only succeed
1195after the other thread has entered cond_wait() and thus relinquished the
1196lock.
1197
1198
1199=item cond_signal() called on unlocked variable
1200
1201(W threads) Within a thread-enabled program, you tried to call
1202cond_signal() on a variable which wasn't locked. The cond_signal()
1203function is used to wake up another thread that is waiting in a
1204cond_wait(). To ensure that the signal isn't sent before the other thread
1205has a chance to enter the wait, it is usual for the signaling thread to
1206first wait for a lock on variable. This lock attempt will only succeed
1207after the other thread has entered cond_wait() and thus relinquished the
1208lock.
1209
69282e91 1210=item connect() on closed socket %s
a0d0e21e 1211
be771a83
GS
1212(W closed) You tried to do a connect on a closed socket. Did you forget
1213to check the return value of your socket() call? See
1214L<perlfunc/connect>.
a0d0e21e 1215
41ab332f 1216=item Constant(%s)%s: %s
6df41af2 1217
be771a83
GS
1218(F) The parser found inconsistencies either while attempting to define
1219an overloaded constant, or when trying to find the character name
1220specified in the C<\N{...}> escape. Perhaps you forgot to load the
1221corresponding C<overload> or C<charnames> pragma? See L<charnames> and
1222L<overload>.
6df41af2 1223
779c5bc9
GS
1224=item Constant is not %s reference
1225
1226(F) A constant value (perhaps declared using the C<use constant> pragma)
be771a83
GS
1227is being dereferenced, but it amounts to the wrong type of reference.
1228The message indicates the type of reference that was expected. This
1229usually indicates a syntax error in dereferencing the constant value.
779c5bc9
GS
1230See L<perlsub/"Constant Functions"> and L<constant>.
1231
4cee8e80
CS
1232=item Constant subroutine %s redefined
1233
bb028877 1234(S) You redefined a subroutine which had previously been
be771a83
GS
1235eligible for inlining. See L<perlsub/"Constant Functions"> for
1236commentary and workarounds.
4cee8e80 1237
9607fc9c
PP
1238=item Constant subroutine %s undefined
1239
be771a83
GS
1240(W misc) You undefined a subroutine which had previously been eligible
1241for inlining. See L<perlsub/"Constant Functions"> for commentary and
1242workarounds.
9607fc9c 1243
e7ea3e70
IZ
1244=item Copy method did not return a reference
1245
64977eb6 1246(F) The method which overloads "=" is buggy. See
13a2d996 1247L<overload/Copy Constructor>.
e7ea3e70 1248
6798c92b
GS
1249=item CORE::%s is not a keyword
1250
1251(F) The CORE:: namespace is reserved for Perl keywords.
1252
a0d0e21e
LW
1253=item corrupted regexp pointers
1254
1255(P) The regular expression engine got confused by what the regular
1256expression compiler gave it.
1257
1258=item corrupted regexp program
1259
be771a83
GS
1260(P) The regular expression engine got passed a regexp program without a
1261valid magic number.
a0d0e21e 1262
6df41af2
GS
1263=item Corrupt malloc ptr 0x%lx at 0x%lx
1264
1265(P) The malloc package that comes with Perl had an internal failure.
1266
1267=item C<-p> destination: %s
1268
1269(F) An error occurred during the implicit output invoked by the C<-p>
1270command-line switch. (This output goes to STDOUT unless you've
1271redirected it with select().)
1272
1273=item C<-T> and C<-B> not implemented on filehandles
1274
1275(F) Perl can't peek at the stdio buffer of filehandles when it doesn't
1276know about your kind of stdio. You'll have to use a filename instead.
1277
a0d0e21e
LW
1278=item Deep recursion on subroutine "%s"
1279
be771a83
GS
1280(W recursion) This subroutine has called itself (directly or indirectly)
1281100 times more than it has returned. This probably indicates an
1282infinite recursion, unless you're writing strange benchmark programs, in
1283which case it indicates something else.
a0d0e21e 1284
f10b0346 1285=item defined(@array) is deprecated
69794302 1286
be771a83
GS
1287(D deprecated) defined() is not usually useful on arrays because it
1288checks for an undefined I<scalar> value. If you want to see if the
64977eb6 1289array is empty, just use C<if (@array) { # not empty }> for example.
69794302 1290
f10b0346 1291=item defined(%hash) is deprecated
69794302 1292
be771a83
GS
1293(D deprecated) defined() is not usually useful on hashes because it
1294checks for an undefined I<scalar> value. If you want to see if the hash
64977eb6 1295is empty, just use C<if (%hash) { # not empty }> for example.
69794302 1296
62658f4d
PM
1297=item %s defines neither package nor VERSION--version check failed
1298
1299(F) You said something like "use Module 42" but in the Module file
1300there are neither package declarations nor a C<$VERSION>.
1301
fc36a67e
PP
1302=item Delimiter for here document is too long
1303
be771a83
GS
1304(F) In a here document construct like C<<<FOO>, the label C<FOO> is too
1305long for Perl to handle. You have to be seriously twisted to write code
1306that triggers this error.
fc36a67e 1307
3cdd684c
TP
1308=item Did not produce a valid header
1309
1310See Server error.
1311
6df41af2
GS
1312=item %s did not return a true value
1313
1314(F) A required (or used) file must return a true value to indicate that
1315it compiled correctly and ran its initialization code correctly. It's
1316traditional to end such a file with a "1;", though any true value would
1317do. See L<perlfunc/require>.
1318
cc507455 1319=item (Did you mean &%s instead?)
4633a7c4 1320
be771a83
GS
1321(W) You probably referred to an imported subroutine &FOO as $FOO or some
1322such.
4633a7c4 1323
cc507455 1324=item (Did you mean "local" instead of "our"?)
33633739 1325
be771a83
GS
1326(W misc) Remember that "our" does not localize the declared global
1327variable. You have declared it again in the same lexical scope, which
1328seems superfluous.
33633739 1329
cc507455 1330=item (Did you mean $ or @ instead of %?)
a0d0e21e 1331
be771a83
GS
1332(W) You probably said %hash{$key} when you meant $hash{$key} or
1333@hash{@keys}. On the other hand, maybe you just meant %hash and got
1334carried away.
748a9306 1335
7e1af8bc 1336=item Died
5f05dabc
PP
1337
1338(F) You passed die() an empty string (the equivalent of C<die "">) or
1339you called it with no args and both C<$@> and C<$_> were empty.
1340
3cdd684c
TP
1341=item Document contains no data
1342
1343See Server error.
1344
62658f4d
PM
1345=item %s does not define %s::VERSION--version check failed
1346
1347(F) You said something like "use Module 42" but the Module did not
1348define a C<$VERSION.>
1349
a0d0e21e
LW
1350=item Don't know how to handle magic of type '%s'
1351
1352(P) The internal handling of magical variables has been cursed.
1353
1354=item do_study: out of memory
1355
1356(P) This should have been caught by safemalloc() instead.
1357
6df41af2
GS
1358=item (Do you need to predeclare %s?)
1359
1360(S) This is an educated guess made in conjunction with the message "%s
1361found where operator expected". It often means a subroutine or module
1362name is being referenced that hasn't been declared yet. This may be
1363because of ordering problems in your file, or because of a missing
be771a83
GS
1364"sub", "package", "require", or "use" statement. If you're referencing
1365something that isn't defined yet, you don't actually have to define the
1366subroutine or package before the current location. You can use an empty
1367"sub foo;" or "package FOO;" to enter a "forward" declaration.
6df41af2 1368
ac206dc8
RGS
1369=item dump() better written as CORE::dump()
1370
1371(W misc) You used the obsolescent C<dump()> built-in function, without fully
1372qualifying it as C<CORE::dump()>. Maybe it's a typo. See L<perlfunc/dump>.
1373
a0d0e21e
LW
1374=item Duplicate free() ignored
1375
be771a83
GS
1376(S malloc) An internal routine called free() on something that had
1377already been freed.
a0d0e21e 1378
4633a7c4
LW
1379=item elseif should be elsif
1380
be771a83
GS
1381(S) There is no keyword "elseif" in Perl because Larry thinks it's ugly.
1382Your code will be interpreted as an attempt to call a method named
1383"elseif" for the class returned by the following block. This is
4633a7c4
LW
1384unlikely to be what you want.
1385
ab13f0c7
JH
1386=item Empty %s
1387
af6f566e
HS
1388(F) C<\p> and C<\P> are used to introduce a named Unicode property, as
1389described in L<perlunicode> and L<perlre>. You used C<\p> or C<\P> in
1390a regular expression without specifying the property name.
ab13f0c7 1391
85ab1d1d 1392=item entering effective %s failed
5ff3f7a4 1393
85ab1d1d 1394(F) While under the C<use filetest> pragma, switching the real and
5ff3f7a4
GS
1395effective uids or gids failed.
1396
748a9306
LW
1397=item Error converting file specification %s
1398
5f05dabc 1399(F) An error peculiar to VMS. Because Perl may have to deal with file
748a9306 1400specifications in either VMS or Unix syntax, it converts them to a
be771a83
GS
1401single form when it must operate on them directly. Either you've passed
1402an invalid file specification to Perl, or you've found a case the
1403conversion routines don't handle. Drat.
748a9306 1404
e4d48cc9
GS
1405=item %s: Eval-group in insecure regular expression
1406
be771a83
GS
1407(F) Perl detected tainted data when trying to compile a regular
1408expression that contains the C<(?{ ... })> zero-width assertion, which
1409is unsafe. See L<perlre/(?{ code })>, and L<perlsec>.
e4d48cc9 1410
e4d48cc9
GS
1411=item %s: Eval-group not allowed at run time
1412
be771a83
GS
1413(F) Perl tried to compile a regular expression containing the
1414C<(?{ ... })> zero-width assertion at run time, as it would when the
1415pattern contains interpolated values. Since that is a security risk, it
1416is not allowed. If you insist, you may still do this by explicitly
1417building the pattern from an interpolated string at run time and using
1418that in an eval(). See L<perlre/(?{ code })>.
e4d48cc9 1419
6df41af2
GS
1420=item %s: Eval-group not allowed, use re 'eval'
1421
be771a83
GS
1422(F) A regular expression contained the C<(?{ ... })> zero-width
1423assertion, but that construct is only allowed when the C<use re 'eval'>
1424pragma is in effect. See L<perlre/(?{ code })>.
6df41af2 1425
fc36a67e
PP
1426=item Excessively long <> operator
1427
1428(F) The contents of a <> operator may not exceed the maximum size of a
1429Perl identifier. If you're just trying to glob a long list of
1430filenames, try using the glob() operator, or put the filenames into a
1431variable and glob that.
1432
ed9aa3b7
SG
1433=item exec? I'm not *that* kind of operating system
1434
1435(F) The C<exec> function is not implemented in MacPerl. See L<perlport>.
1436
f86702cc 1437=item Execution of %s aborted due to compilation errors
a0d0e21e
LW
1438
1439(F) The final summary message when a Perl compilation fails.
1440
1441=item Exiting eval via %s
1442
be771a83
GS
1443(W exiting) You are exiting an eval by unconventional means, such as a
1444goto, or a loop control statement.
e476b1b5
GS
1445
1446=item Exiting format via %s
1447
9a2ff54b 1448(W exiting) You are exiting a format by unconventional means, such as a
be771a83 1449goto, or a loop control statement.
a0d0e21e 1450
0a753a76
PP
1451=item Exiting pseudo-block via %s
1452
be771a83
GS
1453(W exiting) You are exiting a rather special block construct (like a
1454sort block or subroutine) by unconventional means, such as a goto, or a
1455loop control statement. See L<perlfunc/sort>.
0a753a76 1456
a0d0e21e
LW
1457=item Exiting subroutine via %s
1458
be771a83
GS
1459(W exiting) You are exiting a subroutine by unconventional means, such
1460as a goto, or a loop control statement.
a0d0e21e
LW
1461
1462=item Exiting substitution via %s
1463
be771a83
GS
1464(W exiting) You are exiting a substitution by unconventional means, such
1465as a return, a goto, or a loop control statement.
a0d0e21e 1466
7b8d334a
GS
1467=item Explicit blessing to '' (assuming package main)
1468
be771a83
GS
1469(W misc) You are blessing a reference to a zero length string. This has
1470the effect of blessing the reference into the package main. This is
1471usually not what you want. Consider providing a default target package,
1472e.g. bless($ref, $p || 'MyPackage');
7b8d334a 1473
6df41af2
GS
1474=item %s: Expression syntax
1475
be771a83
GS
1476(A) You've accidentally run your script through B<csh> instead of Perl.
1477Check the #! line, or manually feed your script into Perl yourself.
6df41af2
GS
1478
1479=item %s failed--call queue aborted
1480
1481(F) An untrapped exception was raised while executing a CHECK, INIT, or
1482END subroutine. Processing of the remainder of the queue of such
1483routines has been prematurely ended.
1484
7253e4e3 1485=item False [] range "%s" in regex; marked by <-- HERE in m/%s/
73b437c8 1486
be771a83 1487(W regexp) A character class range must start and end at a literal
7253e4e3
RK
1488character, not another character class like C<\d> or C<[:alpha:]>. The "-"
1489in your false range is interpreted as a literal "-". Consider quoting the
1490"-", "\-". The <-- HERE shows in the regular expression about where the
1491problem was discovered. See L<perlre>.
73b437c8 1492
748a9306 1493=item Fatal VMS error at %s, line %d
a0d0e21e 1494
be771a83
GS
1495(P) An error peculiar to VMS. Something untoward happened in a VMS
1496system service or RTL routine; Perl's exit status should provide more
1497details. The filename in "at %s" and the line number in "line %d" tell
1498you which section of the Perl source code is distressed.
a0d0e21e
LW
1499
1500=item fcntl is not implemented
1501
1502(F) Your machine apparently doesn't implement fcntl(). What is this, a
1503PDP-11 or something?
1504
af8c498a 1505=item Filehandle %s opened only for input
a0d0e21e 1506
6c8d78fb
HS
1507(W io) You tried to write on a read-only filehandle. If you intended
1508it to be a read-write filehandle, you needed to open it with "+<" or
1509"+>" or "+>>" instead of with "<" or nothing. If you intended only to
1510write the file, use ">" or ">>". See L<perlfunc/open>.
a0d0e21e 1511
af8c498a 1512=item Filehandle %s opened only for output
a0d0e21e 1513
6c8d78fb
HS
1514(W io) You tried to read from a filehandle opened only for writing, If
1515you intended it to be a read/write filehandle, you needed to open it
be771a83
GS
1516with "+<" or "+>" or "+>>" instead of with "<" or nothing. If you
1517intended only to read from the file, use "<". See L<perlfunc/open>.
6c8d78fb
HS
1518Another possibility is that you attempted to open filedescriptor 0
1519(also known as STDIN) for output (maybe you closed STDIN earlier?).
97828cef
RGS
1520
1521=item Filehandle %s reopened as %s only for input
1522
1523(W io) You opened for reading a filehandle that got the same filehandle id
1524as STDOUT or STDERR. This occured because you closed STDOUT or STDERR
1525previously.
1526
1527=item Filehandle STDIN reopened as %s only for output
1528
1529(W io) You opened for writing a filehandle that got the same filehandle id
1530as STDIN. This occured because you closed STDIN previously.
a0d0e21e
LW
1531
1532=item Final $ should be \$ or $name
1533
1534(F) You must now decide whether the final $ in a string was meant to be
be771a83
GS
1535a literal dollar sign, or was meant to introduce a variable name that
1536happens to be missing. So you have to put either the backslash or the
1537name.
a0d0e21e
LW
1538
1539=item Final @ should be \@ or @name
1540
1541(F) You must now decide whether the final @ in a string was meant to be
be771a83
GS
1542a literal "at" sign, or was meant to introduce a variable name that
1543happens to be missing. So you have to put either the backslash or the
1544name.
a0d0e21e 1545
56e90b21
GS
1546=item flock() on closed filehandle %s
1547
be771a83 1548(W closed) The filehandle you're attempting to flock() got itself closed
c289d2f7 1549some time before now. Check your control flow. flock() operates on
be771a83
GS
1550filehandles. Are you attempting to call flock() on a dirhandle by the
1551same name?
56e90b21 1552
5cd5c422
RB
1553=item Quantifier follows nothing in regex;
1554
1555marked by <-- HERE in m/%s/
6df41af2 1556
b45f050a 1557(F) You started a regular expression with a quantifier. Backslash it if you
7253e4e3
RK
1558meant it literally. The <-- HERE shows in the regular expression about
1559where the problem was discovered. See L<perlre>.
6df41af2
GS
1560
1561=item Format not terminated
1562
1563(F) A format must be terminated by a line with a solitary dot. Perl got
1564to the end of your file without finding such a line.
1565
a0d0e21e
LW
1566=item Format %s redefined
1567
e476b1b5 1568(W redefine) You redefined a format. To suppress this warning, say
a0d0e21e
LW
1569
1570 {
271595cc 1571 no warnings 'redefine';
a0d0e21e
LW
1572 eval "format NAME =...";
1573 }
1574
a0d0e21e
LW
1575=item Found = in conditional, should be ==
1576
e476b1b5 1577(W syntax) You said
a0d0e21e
LW
1578
1579 if ($foo = 123)
1580
1581when you meant
1582
1583 if ($foo == 123)
1584
1585(or something like that).
1586
6df41af2
GS
1587=item %s found where operator expected
1588
1589(S) The Perl lexer knows whether to expect a term or an operator. If it
be771a83
GS
1590sees what it knows to be a term when it was expecting to see an
1591operator, it gives you this warning. Usually it indicates that an
1592operator or delimiter was omitted, such as a semicolon.
6df41af2 1593
a0d0e21e
LW
1594=item gdbm store returned %d, errno %d, key "%s"
1595
1596(S) A warning from the GDBM_File extension that a store failed.
1597
1598=item gethostent not implemented
1599
1600(F) Your C library apparently doesn't implement gethostent(), probably
1601because if it did, it'd feel morally obligated to return every hostname
1602on the Internet.
1603
69282e91 1604=item get%sname() on closed socket %s
a0d0e21e 1605
be771a83
GS
1606(W closed) You tried to get a socket or peer socket name on a closed
1607socket. Did you forget to check the return value of your socket() call?
a0d0e21e 1608
748a9306
LW
1609=item getpwnam returned invalid UIC %#o for user "%s"
1610
1611(S) A warning peculiar to VMS. The call to C<sys$getuai> underlying the
1612C<getpwnam> operator returned an invalid UIC.
1613
6df41af2
GS
1614=item getsockopt() on closed socket %s
1615
be771a83
GS
1616(W closed) You tried to get a socket option on a closed socket. Did you
1617forget to check the return value of your socket() call? See
6df41af2
GS
1618L<perlfunc/getsockopt>.
1619
1620=item Global symbol "%s" requires explicit package name
1621
1622(F) You've said "use strict vars", which indicates that all variables
1623must either be lexically scoped (using "my"), declared beforehand using
1624"our", or explicitly qualified to say which package the global variable
1625is in (using "::").
1626
e476b1b5
GS
1627=item glob failed (%s)
1628
be771a83
GS
1629(W glob) Something went wrong with the external program(s) used for
1630C<glob> and C<< <*.c> >>. Usually, this means that you supplied a
1631C<glob> pattern that caused the external program to fail and exit with a
1632nonzero status. If the message indicates that the abnormal exit
1633resulted in a coredump, this may also mean that your csh (C shell) is
1634broken. If so, you should change all of the csh-related variables in
1635config.sh: If you have tcsh, make the variables refer to it as if it
1636were csh (e.g. C<full_csh='/usr/bin/tcsh'>); otherwise, make them all
1637empty (except that C<d_csh> should be C<'undef'>) so that Perl will
1638think csh is missing. In either case, after editing config.sh, run
75b44862 1639C<./Configure -S> and rebuild Perl.
e476b1b5 1640
a0d0e21e
LW
1641=item Glob not terminated
1642
1643(F) The lexer saw a left angle bracket in a place where it was expecting
be771a83
GS
1644a term, so it's looking for the corresponding right angle bracket, and
1645not finding it. Chances are you left some needed parentheses out
1646earlier in the line, and you really meant a "less than".
a0d0e21e 1647
6df41af2 1648=item Got an error from DosAllocMem
a0d0e21e 1649
6df41af2
GS
1650(P) An error peculiar to OS/2. Most probably you're using an obsolete
1651version of Perl, and this should not happen anyway.
a0d0e21e
LW
1652
1653=item goto must have label
1654
1655(F) Unlike with "next" or "last", you're not allowed to goto an
1656unspecified destination. See L<perlfunc/goto>.
1657
18529408
IZ
1658=item %s-group starts with a count
1659
1660(F) In pack/unpack a ()-group started with a count. A count is
1661supposed to follow something: a template character or a ()-group.
1662
6df41af2
GS
1663=item %s had compilation errors
1664
1665(F) The final summary message when a C<perl -c> fails.
1666
a0d0e21e
LW
1667=item Had to create %s unexpectedly
1668
be771a83
GS
1669(S internal) A routine asked for a symbol from a symbol table that ought
1670to have existed already, but for some reason it didn't, and had to be
1671created on an emergency basis to prevent a core dump.
a0d0e21e
LW
1672
1673=item Hash %%s missing the % in argument %d of %s()
1674
be771a83
GS
1675(D deprecated) Really old Perl let you omit the % on hash names in some
1676spots. This is now heavily deprecated.
a0d0e21e 1677
6df41af2
GS
1678=item %s has too many errors
1679
1680(F) The parser has given up trying to parse the program after 10 errors.
1681Further error messages would likely be uninformative.
1682
252aa082
JH
1683=item Hexadecimal number > 0xffffffff non-portable
1684
e476b1b5 1685(W portable) The hexadecimal number you specified is larger than 2**32-1
9e24b6e2
JH
1686(4294967295) and therefore non-portable between systems. See
1687L<perlport> for more on portability concerns.
252aa082 1688
8903cb82
PP
1689=item Identifier too long
1690
1691(F) Perl limits identifiers (names for variables, functions, etc.) to
fc36a67e 1692about 250 characters for simple names, and somewhat more for compound
be771a83
GS
1693names (like C<$A::B>). You've exceeded Perl's limits. Future versions
1694of Perl are likely to eliminate these arbitrary limitations.
8903cb82 1695
6df41af2 1696=item Illegal binary digit %s
f675dbe5 1697
6df41af2 1698(F) You used a digit other than 0 or 1 in a binary number.
f675dbe5 1699
6df41af2 1700=item Illegal binary digit %s ignored
a0d0e21e 1701
be771a83
GS
1702(W digit) You may have tried to use a digit other than 0 or 1 in a
1703binary number. Interpretation of the binary number stopped before the
1704offending digit.
a0d0e21e 1705
4fdae800
PP
1706=item Illegal character %s (carriage return)
1707
d5898338 1708(F) Perl normally treats carriage returns in the program text as it
be771a83
GS
1709would any other whitespace, which means you should never see this error
1710when Perl was built using standard options. For some reason, your
1711version of Perl appears to have been built without this support. Talk
1712to your Perl administrator.
4fdae800 1713
d37a9538
ST
1714=item Illegal character in prototype for %s : %s
1715
420cdfc1 1716(W syntax) An illegal character was found in a prototype declaration. Legal
d37a9538
ST
1717characters in prototypes are $, @, %, *, ;, [, ], &, and \.
1718
904d85c5
RGS
1719=item Illegal declaration of anonymous subroutine
1720
1721(F) When using the C<sub> keyword to construct an anonymous subroutine,
1722you must always specify a block of code. See L<perlsub>.
1723
a0d0e21e
LW
1724=item Illegal division by zero
1725
be771a83
GS
1726(F) You tried to divide a number by 0. Either something was wrong in
1727your logic, or you need to put a conditional in to guard against
1728meaningless input.
a0d0e21e 1729
6df41af2
GS
1730=item Illegal hexadecimal digit %s ignored
1731
be771a83
GS
1732(W digit) You may have tried to use a character other than 0 - 9 or
1733A - F, a - f in a hexadecimal number. Interpretation of the hexadecimal
1734number stopped before the illegal character.
6df41af2 1735
a0d0e21e
LW
1736=item Illegal modulus zero
1737
be771a83
GS
1738(F) You tried to divide a number by 0 to get the remainder. Most
1739numbers don't take to this kindly.
a0d0e21e 1740
6df41af2 1741=item Illegal number of bits in vec
399388f4 1742
6df41af2
GS
1743(F) The number of bits in vec() (the third argument) must be a power of
1744two from 1 to 32 (or 64, if your platform supports that).
399388f4
GS
1745
1746=item Illegal octal digit %s
a0d0e21e 1747
d1be9408 1748(F) You used an 8 or 9 in an octal number.
a0d0e21e 1749
399388f4 1750=item Illegal octal digit %s ignored
748a9306 1751
d1be9408 1752(W digit) You may have tried to use an 8 or 9 in an octal number.
75b44862 1753Interpretation of the octal number stopped before the 8 or 9.
748a9306 1754
6df41af2 1755=item Illegal switch in PERL5OPT: %s
6ff81951 1756
6df41af2 1757(X) The PERL5OPT environment variable may only be used to set the
1c4db469 1758following switches: B<-[DIMUdmtw]>.
6ff81951 1759
6df41af2 1760=item Ill-formed CRTL environ value "%s"
81e118e0 1761
75b44862 1762(W internal) A warning peculiar to VMS. Perl tried to read the CRTL's
be771a83
GS
1763internal environ array, and encountered an element without the C<=>
1764delimiter used to separate keys from values. The element is ignored.
09bef843 1765
6df41af2 1766=item Ill-formed message in prime_env_iter: |%s|
54310121 1767
be771a83
GS
1768(W internal) A warning peculiar to VMS. Perl tried to read a logical
1769name or CLI symbol definition when preparing to iterate over %ENV, and
1770didn't see the expected delimiter between key and value, so the line was
1771ignored.
54310121 1772
8fa7688f
SF
1773=item Impossible to activate assertion call
1774
1775(W assertions) You're calling an assertion function in a block that is
1776not under the control of the C<assertions> pragma.
1777
6df41af2 1778=item (in cleanup) %s
9607fc9c 1779
be771a83
GS
1780(W misc) This prefix usually indicates that a DESTROY() method raised
1781the indicated exception. Since destructors are usually called by the
1782system at arbitrary points during execution, and often a vast number of
1783times, the warning is issued only once for any number of failures that
1784would otherwise result in the same message being repeated.
6df41af2 1785
be771a83
GS
1786Failure of user callbacks dispatched using the C<G_KEEPERR> flag could
1787also result in this warning. See L<perlcall/G_KEEPERR>.
9607fc9c 1788
979699d9
JH
1789=item In EBCDIC the v-string components cannot exceed 2147483647
1790
1791(F) An error peculiar to EBCDIC. Internally, v-strings are stored as
1792Unicode code points, and encoded in EBCDIC as UTF-EBCDIC. The UTF-EBCDIC
1793encoding is limited to code points no larger than 2147483647 (0x7FFFFFFF).
1794
a0d0e21e
LW
1795=item Insecure dependency in %s
1796
8b1a09fc 1797(F) You tried to do something that the tainting mechanism didn't like.
be771a83
GS
1798The tainting mechanism is turned on when you're running setuid or
1799setgid, or when you specify B<-T> to turn it on explicitly. The
1800tainting mechanism labels all data that's derived directly or indirectly
1801from the user, who is considered to be unworthy of your trust. If any
1802such data is used in a "dangerous" operation, you get this error. See
1803L<perlsec> for more information.
a0d0e21e
LW
1804
1805=item Insecure directory in %s
1806
be771a83
GS
1807(F) You can't use system(), exec(), or a piped open in a setuid or
1808setgid script if C<$ENV{PATH}> contains a directory that is writable by
1809the world. See L<perlsec>.
a0d0e21e 1810
62f468fc 1811=item Insecure $ENV{%s} while running %s
a0d0e21e
LW
1812
1813(F) You can't use system(), exec(), or a piped open in a setuid or
62f468fc 1814setgid script if any of C<$ENV{PATH}>, C<$ENV{IFS}>, C<$ENV{CDPATH}>,
332d5f78
SR
1815C<$ENV{ENV}>, C<$ENV{BASH_ENV}> or C<$ENV{TERM}> are derived from data
1816supplied (or potentially supplied) by the user. The script must set
1817the path to a known value, using trustworthy data. See L<perlsec>.
a0d0e21e 1818
a7ae9550
GS
1819=item Integer overflow in %s number
1820
75b44862 1821(W overflow) The hexadecimal, octal or binary number you have specified
be771a83
GS
1822either as a literal or as an argument to hex() or oct() is too big for
1823your architecture, and has been converted to a floating point number.
1824On a 32-bit architecture the largest hexadecimal, octal or binary number
9e24b6e2
JH
1825representable without overflow is 0xFFFFFFFF, 037777777777, or
18260b11111111111111111111111111111111 respectively. Note that Perl
1827transparently promotes all numbers to a floating point representation
1828internally--subject to loss of precision errors in subsequent
1829operations.
bbce6d69 1830
46314c13
JP
1831=item Integer overflow in version
1832
1833(F) Some portion of a version initialization is too large for the
1834size of integers for your architecture. This is not a warning
1835because there is no rational reason for a version to try and use a
1836element larger than typically 2**32. This is usually caused by
1837trying to use some odd mathematical operation as a version, like
1838100/9.
1839
7253e4e3 1840=item Internal disaster in regex; marked by <-- HERE in m/%s/
6df41af2
GS
1841
1842(P) Something went badly wrong in the regular expression parser.
7253e4e3 1843The <-- HERE shows in the regular expression about where the problem was
b45f050a
JF
1844discovered.
1845
748a9306
LW
1846=item Internal inconsistency in tracking vforks
1847
be771a83
GS
1848(S) A warning peculiar to VMS. Perl keeps track of the number of times
1849you've called C<fork> and C<exec>, to determine whether the current call
1850to C<exec> should affect the current script or a subprocess (see
1851L<perlvms/"exec LIST">). Somehow, this count has become scrambled, so
1852Perl is making a guess and treating this C<exec> as a request to
1853terminate the Perl script and execute the specified command.
748a9306 1854
7253e4e3 1855=item Internal urp in regex; marked by <-- HERE in m/%s/
b45f050a 1856
7253e4e3
RK
1857(P) Something went badly awry in the regular expression parser. The
1858<-- HERE shows in the regular expression about where the problem was
1859discovered.
a0d0e21e 1860
6df41af2
GS
1861=item %s (...) interpreted as function
1862
75b44862 1863(W syntax) You've run afoul of the rule that says that any list operator
be771a83 1864followed by parentheses turns into a function, with all the list
64977eb6 1865operators arguments found inside the parentheses. See
13a2d996 1866L<perlop/Terms and List Operators (Leftward)>.
6df41af2 1867
09bef843
SB
1868=item Invalid %s attribute: %s
1869
1870The indicated attribute for a subroutine or variable was not recognized
1871by Perl or by a user-supplied handler. See L<attributes>.
1872
1873=item Invalid %s attributes: %s
1874
be771a83
GS
1875The indicated attributes for a subroutine or variable were not
1876recognized by Perl or by a user-supplied handler. See L<attributes>.
09bef843 1877
c635e13b
PP
1878=item Invalid conversion in %s: "%s"
1879
be771a83
GS
1880(W printf) Perl does not understand the given format conversion. See
1881L<perlfunc/sprintf>.
c635e13b 1882
7253e4e3 1883=item Invalid [] range "%s" in regex; marked by <-- HERE in m/%s/
6df41af2
GS
1884
1885(F) The range specified in a character class had a minimum character
7253e4e3
RK
1886greater than the maximum character. One possibility is that you forgot the
1887C<{}> from your ending C<\x{}> - C<\x> without the curly braces can go only
1888up to C<ff>. The <-- HERE shows in the regular expression about where the
1889problem was discovered. See L<perlre>.
6df41af2 1890
d1573ac7 1891=item Invalid range "%s" in transliteration operator
c2e66d9e
GS
1892
1893(F) The range specified in the tr/// or y/// operator had a minimum
1894character greater than the maximum character. See L<perlop>.
1895
09bef843
SB
1896=item Invalid separator character %s in attribute list
1897
0120eecf 1898(F) Something other than a colon or whitespace was seen between the
be771a83
GS
1899elements of an attribute list. If the previous attribute had a
1900parenthesised parameter list, perhaps that list was terminated too soon.
1901See L<attributes>.
09bef843 1902
96e4d5b1
PP
1903=item Invalid type in pack: '%s'
1904
8903cb82 1905(F) The given character is not a valid pack type. See L<perlfunc/pack>.
be771a83
GS
1906(W pack) The given character is not a valid pack type but used to be
1907silently ignored.
96e4d5b1
PP
1908
1909=item Invalid type in unpack: '%s'
1910
be771a83
GS
1911(F) The given character is not a valid unpack type. See
1912L<perlfunc/unpack>.
75b44862
GS
1913(W unpack) The given character is not a valid unpack type but used to be
1914silently ignored.
96e4d5b1 1915
46314c13
JP
1916=item Invalid version format (multiple underscores)
1917
1918(F) Versions may contain at most a single underscore, which signals
1919that the version is a beta release. See L<version> for the allowed
1920version formats.
1921
1922=item Invalid version format (underscores before decimal)
1923
1924(F) Versions may not contain decimals after the optional underscore.
1925See L<version> for the allowed version formats.
1926
a0d0e21e
LW
1927=item ioctl is not implemented
1928
1929(F) Your machine apparently doesn't implement ioctl(), which is pretty
1930strange for a machine that supports C.
1931
c289d2f7
JH
1932=item ioctl() on unopened %s
1933
1934(W unopened) You tried ioctl() on a filehandle that was never opened.
1935Check you control flow and number of arguments.
1936
80cbd5ad
JH
1937=item IO::Socket::atmark not implemented on this architecture
1938
1939(F) Your machine doesn't implement the sockatmark() functionality,
1940neither as a system call or an ioctl call (SIOCATMARK).
1941
6ad11d81
JH
1942=item `%s' is not a code reference
1943
04a80ee0
RGS
1944(W overload) The second (fourth, sixth, ...) argument of overload::constant
1945needs to be a code reference. Either an anonymous subroutine, or a reference
6ad11d81
JH
1946to a subroutine.
1947
1948=item `%s' is not an overloadable type
1949
04a80ee0
RGS
1950(W overload) You tried to overload a constant type the overload package is
1951unaware of.
6ad11d81 1952
a0d0e21e
LW
1953=item junk on end of regexp
1954
1955(P) The regular expression parser is confused.
1956
1957=item Label not found for "last %s"
1958
be771a83
GS
1959(F) You named a loop to break out of, but you're not currently in a loop
1960of that name, not even if you count where you were called from. See
1961L<perlfunc/last>.
a0d0e21e
LW
1962
1963=item Label not found for "next %s"
1964
1965(F) You named a loop to continue, but you're not currently in a loop of
1966that name, not even if you count where you were called from. See
1967L<perlfunc/last>.
1968
1969=item Label not found for "redo %s"
1970
1971(F) You named a loop to restart, but you're not currently in a loop of
1972that name, not even if you count where you were called from. See
1973L<perlfunc/last>.
1974
85ab1d1d 1975=item leaving effective %s failed
5ff3f7a4 1976
85ab1d1d 1977(F) While under the C<use filetest> pragma, switching the real and
5ff3f7a4
GS
1978effective uids or gids failed.
1979
69282e91 1980=item listen() on closed socket %s
a0d0e21e 1981
be771a83
GS
1982(W closed) You tried to do a listen on a closed socket. Did you forget
1983to check the return value of your socket() call? See
1984L<perlfunc/listen>.
a0d0e21e 1985
5d3e98de
RGS
1986=item lstat() on filehandle %s
1987
1988(W io) You tried to do an lstat on a filehandle. What did you mean
1989by that? lstat() makes sense only on filenames. (Perl did a fstat()
1990instead on the filehandle.)
1991
cd06dffe
GS
1992=item Lvalue subs returning %s not implemented yet
1993
1994(F) Due to limitations in the current implementation, array and hash
be771a83
GS
1995values cannot be returned in subroutines used in lvalue context. See
1996L<perlsub/"Lvalue subroutines">.
cd06dffe 1997
5cd5c422
RB
1998=item Lookbehind longer than %d not implemented in regex;
1999
2000marked by <-- HERE in m/%s/
b45f050a
JF
2001
2002(F) There is currently a limit on the length of string which lookbehind can
7253e4e3
RK
2003handle. This restriction may be eased in a future release. The <-- HERE
2004shows in the regular expression about where the problem was discovered.
2e50fd82 2005
6df41af2
GS
2006=item Malformed PERLLIB_PREFIX
2007
2008(F) An error peculiar to OS/2. PERLLIB_PREFIX should be of the form
2009
2010 prefix1;prefix2
2011
2012or
6df41af2
GS
2013 prefix1 prefix2
2014
be771a83
GS
2015with nonempty prefix1 and prefix2. If C<prefix1> is indeed a prefix of
2016a builtin library search path, prefix2 is substituted. The error may
2017appear if components are not found, or are too long. See
fecfaeb8 2018"PERLLIB_PREFIX" in L<perlos2>.
6df41af2 2019
2f758a16
ST
2020=item Malformed prototype for %s: %s
2021
d37a9538
ST
2022(F) You tried to use a function with a malformed prototype. The
2023syntax of function prototypes is given a brief compile-time check for
2024obvious errors like invalid characters. A more rigorous check is run
2025when the function is called.
2f758a16 2026
ba210ebe
JH
2027=item Malformed UTF-8 character (%s)
2028
2029Perl detected something that didn't comply with UTF-8 encoding rules.
2030
901b21bf
JH
2031One possible cause is that you read in data that you thought to be in
2032UTF-8 but it wasn't (it was for example legacy 8-bit data). Another
2033possibility is careless use of utf8::upgrade().
2034
dea0fc0b
JH
2035=item Malformed UTF-16 surrogate
2036
2037Perl thought it was reading UTF-16 encoded character data but while
2038doing it Perl met a malformed Unicode surrogate.
2039
5cd5c422
RB
2040=item %s matches null string many times in regex;
2041
2042marked by <-- HERE in m/%s/
6df41af2
GS
2043
2044(W regexp) The pattern you've specified would be an infinite loop if the
7253e4e3
RK
2045regular expression engine didn't specifically check for that. The <-- HERE
2046shows in the regular expression about where the problem was discovered.
2047See L<perlre>.
6df41af2 2048
25f58aea
PN
2049=item "%s" may clash with future reserved word
2050
2051(W) This warning may be due to running a perl5 script through a perl4
2052interpreter, especially if the word that is being warned about is
2053"use" or "my".
2054
6df41af2
GS
2055=item % may only be used in unpack
2056
2057(F) You can't pack a string by supplying a checksum, because the
be771a83
GS
2058checksumming process loses information, and you can't go the other way.
2059See L<perlfunc/unpack>.
6df41af2 2060
a0d0e21e
LW
2061=item Method for operation %s not found in package %s during blessing
2062
2063(F) An attempt was made to specify an entry in an overloading table that
e7ea3e70 2064doesn't resolve to a valid subroutine. See L<overload>.
a0d0e21e 2065
3cdd684c
TP
2066=item Method %s not permitted
2067
2068See Server error.
2069
a0d0e21e
LW
2070=item Might be a runaway multi-line %s string starting on line %d
2071
2072(S) An advisory indicating that the previous error may have been caused
2073by a missing delimiter on a string or pattern, because it eventually
2074ended earlier on the current line.
2075
2076=item Misplaced _ in number
2077
d4ced10d
JH
2078(W syntax) An underscore (underbar) in a numeric constant did not
2079separate two digits.
a0d0e21e 2080
4a2d328f 2081=item Missing %sbrace%s on \N{}
423cee85 2082
4a2d328f 2083(F) Wrong syntax of character name literal C<\N{charname}> within
423cee85
JH
2084double-quotish context.
2085
a0d0e21e
LW
2086=item Missing comma after first argument to %s function
2087
2088(F) While certain functions allow you to specify a filehandle or an
2089"indirect object" before the argument list, this ain't one of them.
2090
06eaf0bc
GS
2091=item Missing command in piped open
2092
be771a83
GS
2093(W pipe) You used the C<open(FH, "| command")> or
2094C<open(FH, "command |")> construction, but the command was missing or
2095blank.
06eaf0bc 2096
961ce445
RGS
2097=item Missing control char name in \c
2098
2099(F) A double-quoted string ended with "\c", without the required control
2100character name.
2101
6df41af2
GS
2102=item Missing name in "my sub"
2103
be771a83
GS
2104(F) The reserved syntax for lexically scoped subroutines requires that
2105they have a name with which they can be found.
6df41af2
GS
2106
2107=item Missing $ on loop variable
2108
be771a83
GS
2109(F) Apparently you've been programming in B<csh> too much. Variables
2110are always mentioned with the $ in Perl, unlike in the shells, where it
2111can vary from one line to the next.
6df41af2 2112
cc507455 2113=item (Missing operator before %s?)
748a9306
LW
2114
2115(S) This is an educated guess made in conjunction with the message "%s
2116found where operator expected". Often the missing operator is a comma.
2117
ab13f0c7
JH
2118=item Missing right brace on %s
2119
2120(F) Missing right brace in C<\p{...}> or C<\P{...}>.
2121
d98d5fff 2122=item Missing right curly or square bracket
a0d0e21e 2123
be771a83
GS
2124(F) The lexer counted more opening curly or square brackets than closing
2125ones. As a general rule, you'll find it's missing near the place you
2126were last editing.
a0d0e21e 2127
6df41af2
GS
2128=item (Missing semicolon on previous line?)
2129
2130(S) This is an educated guess made in conjunction with the message "%s
2131found where operator expected". Don't automatically put a semicolon on
2132the previous line just because you saw this message.
2133
a0d0e21e
LW
2134=item Modification of a read-only value attempted
2135
2136(F) You tried, directly or indirectly, to change the value of a
5f05dabc 2137constant. You didn't, of course, try "2 = 1", because the compiler
a0d0e21e
LW
2138catches that. But an easy way to do the same thing is:
2139
2140 sub mod { $_[0] = 1 }
2141 mod(2);
2142
2143Another way is to assign to a substr() that's off the end of the string.
2144
c5674021
PDF
2145Yet another way is to assign to a C<foreach> loop I<VAR> when I<VAR>
2146is aliased to a constant in the look I<LIST>:
2147
2148 $x = 1;
2149 foreach my $n ($x, 2) {
2150 $n *= 2; # modifies the $x, but fails on attempt to modify the 2
64977eb6 2151 }
c5674021 2152
7a4340ed 2153=item Modification of non-creatable array value attempted, %s
a0d0e21e
LW
2154
2155(F) You tried to make an array value spring into existence, and the
2156subscript was probably negative, even counting from end of the array
2157backwards.
2158
7a4340ed 2159=item Modification of non-creatable hash value attempted, %s
a0d0e21e 2160
be771a83
GS
2161(P) You tried to make a hash value spring into existence, and it
2162couldn't be created for some peculiar reason.
a0d0e21e
LW
2163
2164=item Module name must be constant
2165
2166(F) Only a bare module name is allowed as the first argument to a "use".
2167
be98fb35 2168=item Module name required with -%c option
6df41af2 2169
be98fb35
GS
2170(F) The C<-M> or C<-m> options say that Perl should load some module, but
2171you omitted the name of the module. Consult L<perlrun> for full details
2172about C<-M> and C<-m>.
6df41af2 2173
ed9aa3b7
SG
2174=item More than one argument to open
2175
2176(F) The C<open> function has been asked to open multiple files. This
2177can happen if you are trying to open a pipe to a command that takes a
2178list of arguments, but have forgotten to specify a piped open mode.
2179See L<perlfunc/open> for details.
2180
a0d0e21e
LW
2181=item msg%s not implemented
2182
2183(F) You don't have System V message IPC on your system.
2184
2185=item Multidimensional syntax %s not supported
2186
75b44862
GS
2187(W syntax) Multidimensional arrays aren't written like C<$foo[1,2,3]>.
2188They're written like C<$foo[1][2][3]>, as in C.
8b1a09fc 2189
6df41af2 2190=item / must be followed by a*, A* or Z*
09bef843 2191
6df41af2 2192(F) You had a pack template indicating a counted-length string,
be771a83
GS
2193Currently the only things that can have their length counted are a*, A*
2194or Z*. See L<perlfunc/pack>.
6df41af2
GS
2195
2196=item / must be followed by a, A or Z
2197
be771a83
GS
2198(F) You had an unpack template indicating a counted-length string, which
2199must be followed by one of the letters a, A or Z to indicate what sort
2200of string is to be unpacked. See L<perlfunc/pack>.
6df41af2
GS
2201
2202=item / must follow a numeric type
2203
be771a83
GS
2204(F) You had an unpack template that contained a '#', but this did not
2205follow some numeric unpack specification. See L<perlfunc/pack>.
6df41af2
GS
2206
2207=item "my sub" not yet implemented
2208
be771a83
GS
2209(F) Lexically scoped subroutines are not yet implemented. Don't try
2210that yet.
6df41af2
GS
2211
2212=item "my" variable %s can't be in a package
2213
be771a83
GS
2214(F) Lexically scoped variables aren't in a package, so it doesn't make
2215sense to try to declare one with a package qualifier on the front. Use
2216local() if you want to localize a package variable.
09bef843 2217
8b1a09fc
PP
2218=item Name "%s::%s" used only once: possible typo
2219
e476b1b5 2220(W once) Typographical errors often show up as unique variable names.
be771a83
GS
2221If you had a good reason for having a unique name, then just mention it
2222again somehow to suppress the message. The C<our> declaration is
77ca0c92 2223provided for this purpose.
a0d0e21e
LW
2224
2225=item Negative length
2226
be771a83
GS
2227(F) You tried to do a read/write/send/recv operation with a buffer
2228length that is less than 0. This is difficult to imagine.
a0d0e21e 2229
ed9aa3b7
SG
2230=item Negative offset to vec in lvalue context
2231
2232(F) When C<vec> is called in an lvalue context, the second argument must be
2233greater than or equal to zero.
2234
7253e4e3 2235=item Nested quantifiers in regex; marked by <-- HERE in m/%s/
a0d0e21e 2236
b45f050a 2237(F) You can't quantify a quantifier without intervening parentheses. So
7253e4e3 2238things like ** or +* or ?* are illegal. The <-- HERE shows in the regular
b45f050a 2239expression about where the problem was discovered.
a0d0e21e 2240
7253e4e3 2241Note that the minimal matching quantifiers, C<*?>, C<+?>, and
be771a83 2242C<??> appear to be nested quantifiers, but aren't. See L<perlre>.
a0d0e21e 2243
6df41af2 2244=item %s never introduced
a0d0e21e 2245
be771a83
GS
2246(S internal) The symbol in question was declared but somehow went out of
2247scope before it could possibly have been used.
a0d0e21e
LW
2248
2249=item No %s allowed while running setuid
2250
be771a83
GS
2251(F) Certain operations are deemed to be too insecure for a setuid or
2252setgid script to even be allowed to attempt. Generally speaking there
2253will be another way to do what you want that is, if not secure, at least
2254securable. See L<perlsec>.
a0d0e21e
LW
2255
2256=item No B<-e> allowed in setuid scripts
2257
2258(F) A setuid script can't be specified by the user.
2259
2260=item No comma allowed after %s
2261
2262(F) A list operator that has a filehandle or "indirect object" is not
2263allowed to have a comma between that and the following arguments.
2264Otherwise it'd be just another one of the arguments.
2265
0a753a76
PP
2266One possible cause for this is that you expected to have imported a
2267constant to your name space with B<use> or B<import> while no such
2268importing took place, it may for example be that your operating system
2269does not support that particular constant. Hopefully you did use an
2270explicit import list for the constants you expect to see, please see
2271L<perlfunc/use> and L<perlfunc/import>. While an explicit import list
2272would probably have caught this error earlier it naturally does not
2273remedy the fact that your operating system still does not support that
2274constant. Maybe you have a typo in the constants of the symbol import
2275list of B<use> or B<import> or in the constant name at the line where
2276this error was triggered?
2277
748a9306
LW
2278=item No command into which to pipe on command line
2279
be771a83
GS
2280(F) An error peculiar to VMS. Perl handles its own command line
2281redirection, and found a '|' at the end of the command line, so it
2282doesn't know where you want to pipe the output from this command.
748a9306 2283
a0d0e21e
LW
2284=item No DB::DB routine defined
2285
be771a83
GS
2286(F) The currently executing code was compiled with the B<-d> switch, but
2287for some reason the perl5db.pl file (or some facsimile thereof) didn't
2288define a routine to be called at the beginning of each statement. Which
2289is odd, because the file should have been required automatically, and
2290should have blown up the require if it didn't parse right.
a0d0e21e
LW
2291
2292=item No dbm on this machine
2293
2294(P) This is counted as an internal error, because every machine should
5f05dabc 2295supply dbm nowadays, because Perl comes with SDBM. See L<SDBM_File>.
a0d0e21e
LW
2296
2297=item No DBsub routine
2298
2299(F) The currently executing code was compiled with the B<-d> switch,
2300but for some reason the perl5db.pl file (or some facsimile thereof)
2301didn't define a DB::sub routine to be called at the beginning of each
2302ordinary subroutine call.
2303
c47ff5f1 2304=item No error file after 2> or 2>> on command line
748a9306 2305
be771a83
GS
2306(F) An error peculiar to VMS. Perl handles its own command line
2307redirection, and found a '2>' or a '2>>' on the command line, but can't
2308find the name of the file to which to write data destined for stderr.
748a9306 2309
c47ff5f1 2310=item No input file after < on command line
748a9306 2311
be771a83
GS
2312(F) An error peculiar to VMS. Perl handles its own command line
2313redirection, and found a '<' on the command line, but can't find the
2314name of the file from which to read data for stdin.
748a9306 2315
6df41af2
GS
2316=item No #! line
2317
2318(F) The setuid emulator requires that scripts have a well-formed #! line
2319even on machines that don't support the #! construct.
2320
2321=item "no" not allowed in expression
2322
be771a83
GS
2323(F) The "no" keyword is recognized and executed at compile time, and
2324returns no useful value. See L<perlmod>.
6df41af2 2325
c47ff5f1 2326=item No output file after > on command line
748a9306 2327
be771a83
GS
2328(F) An error peculiar to VMS. Perl handles its own command line
2329redirection, and found a lone '>' at the end of the command line, so it
2330doesn't know where you wanted to redirect stdout.
748a9306 2331
c47ff5f1 2332=item No output file after > or >> on command line
748a9306 2333
be771a83
GS
2334(F) An error peculiar to VMS. Perl handles its own command line
2335redirection, and found a '>' or a '>>' on the command line, but can't
2336find the name of the file to which to write data destined for stdout.
748a9306 2337
1ec3e8de
GS
2338=item No package name allowed for variable %s in "our"
2339
be771a83
GS
2340(F) Fully qualified variable names are not allowed in "our"
2341declarations, because that doesn't make much sense under existing
2342semantics. Such syntax is reserved for future extensions.
1ec3e8de 2343
a0d0e21e
LW
2344=item No Perl script found in input
2345
2346(F) You called C<perl -x>, but no line was found in the file beginning
2347with #! and containing the word "perl".
2348
2349=item No setregid available
2350
2351(F) Configure didn't find anything resembling the setregid() call for
2352your system.
2353
2354=item No setreuid available
2355
2356(F) Configure didn't find anything resembling the setreuid() call for
2357your system.
2358
a67e862a 2359=item No space allowed after -%c
a0d0e21e 2360
be771a83
GS
2361(F) The argument to the indicated command line switch must follow
2362immediately after the switch, without intervening spaces.
a0d0e21e 2363
6df41af2
GS
2364=item No %s specified for -%c
2365
2366(F) The indicated command line switch needs a mandatory argument, but
2367you haven't specified one.
2368
2c692339
RGS
2369=item No such class %s
2370
2371(F) You provided a class qualifier in a "my" or "our" declaration, but
2372this class doesn't exist at this point in your program.
2373
6df41af2
GS
2374=item No such pipe open
2375
2376(P) An error peculiar to VMS. The internal routine my_pclose() tried to
be771a83
GS
2377close a pipe which hadn't been opened. This should have been caught
2378earlier as an attempt to close an unopened filehandle.
6df41af2 2379
a0d0e21e
LW
2380=item No such signal: SIG%s
2381
be771a83
GS
2382(W signal) You specified a signal name as a subscript to %SIG that was
2383not recognized. Say C<kill -l> in your shell to see the valid signal
2384names on your system.
a0d0e21e
LW
2385
2386=item Not a CODE reference
2387
2388(F) Perl was trying to evaluate a reference to a code value (that is, a
2389subroutine), but found a reference to something else instead. You can
be771a83
GS
2390use the ref() function to find out what kind of ref it really was. See
2391also L<perlref>.
a0d0e21e
LW
2392
2393=item Not a format reference
2394
2395(F) I'm not sure how you managed to generate a reference to an anonymous
2396format, but this indicates you did, and that it didn't exist.
2397
2398=item Not a GLOB reference
2399
be771a83
GS
2400(F) Perl was trying to evaluate a reference to a "typeglob" (that is, a
2401symbol table entry that looks like C<*foo>), but found a reference to
2402something else instead. You can use the ref() function to find out what
2403kind of ref it really was. See L<perlref>.
a0d0e21e
LW
2404
2405=item Not a HASH reference
2406
be771a83
GS
2407(F) Perl was trying to evaluate a reference to a hash value, but found a
2408reference to something else instead. You can use the ref() function to
2409find out what kind of ref it really was. See L<perlref>.
a0d0e21e 2410
6df41af2
GS
2411=item Not an ARRAY reference
2412
be771a83
GS
2413(F) Perl was trying to evaluate a reference to an array value, but found
2414a reference to something else instead. You can use the ref() function
2415to find out what kind of ref it really was. See L<perlref>.
6df41af2 2416
a0d0e21e
LW
2417=item Not a perl script
2418
2419(F) The setuid emulator requires that scripts have a well-formed #! line
2420even on machines that don't support the #! construct. The line must
2421mention perl.
2422
2423=item Not a SCALAR reference
2424
be771a83
GS
2425(F) Perl was trying to evaluate a reference to a scalar value, but found
2426a reference to something else instead. You can use the ref() function
2427to find out what kind of ref it really was. See L<perlref>.
a0d0e21e
LW
2428
2429=item Not a subroutine reference
2430
2431(F) Perl was trying to evaluate a reference to a code value (that is, a
2432subroutine), but found a reference to something else instead. You can
be771a83
GS
2433use the ref() function to find out what kind of ref it really was. See
2434also L<perlref>.
a0d0e21e 2435
e7ea3e70 2436=item Not a subroutine reference in overload table
a0d0e21e
LW
2437
2438(F) An attempt was made to specify an entry in an overloading table that
8b1a09fc 2439doesn't somehow point to a valid subroutine. See L<overload>.
a0d0e21e 2440
a0d0e21e
LW
2441=item Not enough arguments for %s
2442
2443(F) The function requires more arguments than you specified.
2444
6df41af2
GS
2445=item Not enough format arguments
2446
be771a83
GS
2447(W syntax) A format specified more picture fields than the next line
2448supplied. See L<perlform>.
6df41af2
GS
2449
2450=item %s: not found
2451
be771a83
GS
2452(A) You've accidentally run your script through the Bourne shell instead
2453of Perl. Check the #! line, or manually feed your script into Perl
2454yourself.
6df41af2 2455
206947d2
IZ
2456=item %s not allowed in length fields
2457
2458(F) The count in the (un)pack template may be replaced by C<[TEMPLATE]> only if
2459C<TEMPLATE> always matches the same amount of packed bytes. Redesign
2460the template.
2461
6df41af2 2462=item no UTC offset information; assuming local time is UTC
a0d0e21e 2463
6df41af2
GS
2464(S) A warning peculiar to VMS. Perl was unable to find the local
2465timezone offset, so it's assuming that local system time is equivalent
be771a83
GS
2466to UTC. If it's not, define the logical name
2467F<SYS$TIMEZONE_DIFFERENTIAL> to translate to the number of seconds which
2468need to be added to UTC to get local time.
a0d0e21e
LW
2469
2470=item Null filename used
2471
be771a83
GS
2472(F) You can't require the null filename, especially because on many
2473machines that means the current directory! See L<perlfunc/require>.
a0d0e21e 2474
6df41af2
GS
2475=item NULL OP IN RUN
2476
be771a83
GS
2477(P debugging) Some internal routine called run() with a null opcode
2478pointer.
6df41af2 2479
55497cff
PP
2480=item Null picture in formline
2481
2482(F) The first argument to formline must be a valid format picture
2483specification. It was found to be empty, which probably means you
2484supplied it an uninitialized value. See L<perlform>.
2485
a0d0e21e
LW
2486=item Null realloc
2487
2488(P) An attempt was made to realloc NULL.
2489
2490=item NULL regexp argument
2491
5f05dabc 2492(P) The internal pattern matching routines blew it big time.
a0d0e21e
LW
2493
2494=item NULL regexp parameter
2495
2496(P) The internal pattern matching routines are out of their gourd.
2497
fc36a67e
PP
2498=item Number too long
2499
be771a83 2500(F) Perl limits the representation of decimal numbers in programs to
da75cd15 2501about 250 characters. You've exceeded that length. Future
be771a83
GS
2502versions of Perl are likely to eliminate this arbitrary limitation. In
2503the meantime, try using scientific notation (e.g. "1e6" instead of
2504"1_000_000").
fc36a67e 2505
6df41af2
GS
2506=item Octal number in vector unsupported
2507
be771a83
GS
2508(F) Numbers with a leading C<0> are not currently allowed in vectors.
2509The octal number interpretation of such numbers may be supported in a
2510future version.
6df41af2 2511
252aa082
JH
2512=item Octal number > 037777777777 non-portable
2513
75b44862 2514(W portable) The octal number you specified is larger than 2**32-1
be771a83
GS
2515(4294967295) and therefore non-portable between systems. See
2516L<perlport> for more on portability concerns.
252aa082
JH
2517
2518See also L<perlport> for writing portable code.
2519
6ad11d81
JH
2520=item Odd number of arguments for overload::constant
2521
04a80ee0
RGS
2522(W overload) The call to overload::constant contained an odd number of
2523arguments. The arguments should come in pairs.
6ad11d81 2524
b21befc1
MG
2525=item Odd number of elements in anonymous hash
2526
2527(W misc) You specified an odd number of elements to initialize a hash,
2528which is odd, because hashes come in key/value pairs.
2529
1930e939 2530=item Odd number of elements in hash assignment
a0d0e21e 2531
be771a83
GS
2532(W misc) You specified an odd number of elements to initialize a hash,
2533which is odd, because hashes come in key/value pairs.
a0d0e21e 2534
bbce6d69
PP
2535=item Offset outside string
2536
2537(F) You tried to do a read/write/send/recv operation with an offset
be771a83
GS
2538pointing outside the buffer. This is difficult to imagine. The sole
2539exception to this is that C<sysread()>ing past the buffer will extend
2540the buffer and zero pad the new area.
bbce6d69 2541
9ddeeac9
JH
2542=item -%s on unopened filehandle %s
2543
2544(W unopened) You tried to invoke a file test operator on a filehandle
c289d2f7 2545that isn't open. Check your control flow. See also L<perlfunc/-X>.
9ddeeac9 2546
c289d2f7 2547=item %s() on unopened %s
2dd78f96
JH
2548
2549(W unopened) An I/O operation was attempted on a filehandle that was
2550never initialized. You need to do an open(), a sysopen(), or a socket()
2551call, or call a constructor from the FileHandle package.
2552
a0d0e21e
LW
2553=item oops: oopsAV
2554
e476b1b5 2555(S internal) An internal warning that the grammar is screwed up.
a0d0e21e
LW
2556
2557=item oops: oopsHV
2558
e476b1b5 2559(S internal) An internal warning that the grammar is screwed up.
a0d0e21e 2560
56f7f34b 2561=item Operation `%s': no method found, %s
44a8e56a 2562
be771a83
GS
2563(F) An attempt was made to perform an overloaded operation for which no
2564handler was defined. While some handlers can be autogenerated in terms
2565of other handlers, there is no default handler for any operation, unless
2566C<fallback> overloading key is specified to be true. See L<overload>.
44a8e56a 2567
748a9306
LW
2568=item Operator or semicolon missing before %s
2569
be771a83
GS
2570(S ambiguous) You used a variable or subroutine call where the parser
2571was expecting an operator. The parser has assumed you really meant to
2572use an operator, but this is highly likely to be incorrect. For
2573example, if you say "*foo *foo" it will be interpreted as if you said
2574"*foo * 'foo'".
748a9306 2575
6df41af2
GS
2576=item "our" variable %s redeclared
2577
be771a83
GS
2578(W misc) You seem to have already declared the same global once before
2579in the current lexical scope.
6df41af2 2580
a80b8354
GS
2581=item Out of memory!
2582
2583(X) The malloc() function returned 0, indicating there was insufficient
be771a83
GS
2584remaining memory (or virtual memory) to satisfy the request. Perl has
2585no option but to exit immediately.
a80b8354 2586
6df41af2 2587=item Out of memory during "large" request for %s
a0d0e21e 2588
6df41af2
GS
2589(F) The malloc() function returned 0, indicating there was insufficient
2590remaining memory (or virtual memory) to satisfy the request. However,
be771a83
GS
2591the request was judged large enough (compile-time default is 64K), so a
2592possibility to shut down by trapping this error is granted.
a0d0e21e 2593
1b979e0a 2594=item Out of memory during request for %s
a0d0e21e 2595
be771a83
GS
2596(X|F) The malloc() function returned 0, indicating there was
2597insufficient remaining memory (or virtual memory) to satisfy the
2598request.
eff9c6e2
CS
2599
2600The request was judged to be small, so the possibility to trap it
2601depends on the way perl was compiled. By default it is not trappable.
be771a83
GS
2602However, if compiled for this, Perl may use the contents of C<$^M> as an
2603emergency pool after die()ing with this message. In this case the error
b022d2d2
IZ
2604is trappable I<once>, and the error message will include the line and file
2605where the failed request happened.
55497cff 2606
1b979e0a
IZ
2607=item Out of memory during ridiculously large request
2608
2609(F) You can't allocate more than 2^31+"small amount" bytes. This error
be771a83
GS
2610is most likely to be caused by a typo in the Perl program. e.g.,
2611C<$arr[time]> instead of C<$arr[$time]>.
1b979e0a 2612
6df41af2
GS
2613=item Out of memory for yacc stack
2614
be771a83
GS
2615(F) The yacc parser wanted to grow its stack so it could continue
2616parsing, but realloc() wouldn't give it more memory, virtual or
2617otherwise.
6df41af2
GS
2618
2619=item @ outside of string
2620
2621(F) You had a pack template that specified an absolute position outside
2622the string being unpacked. See L<perlfunc/pack>.
2623
2624=item %s package attribute may clash with future reserved word: %s
2625
be771a83
GS
2626(W reserved) A lowercase attribute name was used that had a
2627package-specific handler. That name might have a meaning to Perl itself
2628some day, even though it doesn't yet. Perhaps you should use a
2629mixed-case attribute name, instead. See L<attributes>.
6df41af2 2630
a0d0e21e
LW
2631=item page overflow
2632
be771a83
GS
2633(W io) A single call to write() produced more lines than can fit on a
2634page. See L<perlform>.
a0d0e21e 2635
6df41af2
GS
2636=item panic: %s
2637
2638(P) An internal error.
2639
a0d0e21e
LW
2640=item panic: ck_grep
2641
2642(P) Failed an internal consistency check trying to compile a grep.
2643
2644=item panic: ck_split
2645
2646(P) Failed an internal consistency check trying to compile a split.
2647
2648=item panic: corrupt saved stack index
2649
be771a83
GS
2650(P) The savestack was requested to restore more localized values than
2651there are in the savestack.
a0d0e21e 2652
810b8aa5
GS
2653=item panic: del_backref
2654
2655(P) Failed an internal consistency check while trying to reset a weak
2656reference.
2657
a0d0e21e
LW
2658=item panic: die %s
2659
2660(P) We popped the context stack to an eval context, and then discovered
2661it wasn't an eval context.
2662
290deeac 2663=item panic: pp_match%s
a0d0e21e 2664
be771a83
GS
2665(P) The internal pp_match() routine was called with invalid operational
2666data.
a0d0e21e 2667
a0d0e21e
LW
2668=item panic: do_subst
2669
be771a83
GS
2670(P) The internal pp_subst() routine was called with invalid operational
2671data.
a0d0e21e 2672
2269b42e 2673=item panic: do_trans_%s
a0d0e21e 2674
2269b42e 2675(P) The internal do_trans routines were called with invalid operational
be771a83 2676data.
a0d0e21e 2677
c635e13b
PP
2678=item panic: frexp
2679
2680(P) The library function frexp() failed, making printf("%f") impossible.
2681
a0d0e21e
LW
2682=item panic: goto
2683
2684(P) We popped the context stack to a context with the specified label,
2685and then discovered it wasn't a context we know how to do a goto in.
2686
2687=item panic: INTERPCASEMOD
2688
2689(P) The lexer got into a bad state at a case modifier.
2690
2691=item panic: INTERPCONCAT
2692
2693(P) The lexer got into a bad state parsing a string with brackets.
2694
e446cec8
IZ
2695=item panic: kid popen errno read
2696
2697(F) forked child returned an incomprehensible message about its errno.
2698
a0d0e21e
LW
2699=item panic: last
2700
2701(P) We popped the context stack to a block context, and then discovered
2702it wasn't a block context.
2703
2704=item panic: leave_scope clearsv
2705
be771a83
GS
2706(P) A writable lexical variable became read-only somehow within the
2707scope.
a0d0e21e
LW
2708
2709=item panic: leave_scope inconsistency
2710
2711(P) The savestack probably got out of sync. At least, there was an
2712invalid enum on the top of it.
2713
810b8aa5
GS
2714=item panic: magic_killbackrefs
2715
2716(P) Failed an internal consistency check while trying to reset all weak
2717references to an object.
2718
6df41af2
GS
2719=item panic: malloc
2720
2721(P) Something requested a negative number of bytes of malloc.
2722
a0d0e21e
LW
2723=item panic: mapstart
2724
2725(P) The compiler is screwed up with respect to the map() function.
2726
2727=item panic: null array
2728
2729(P) One of the internal array routines was passed a null AV pointer.
2730
2731=item panic: pad_alloc
2732
2733(P) The compiler got confused about which scratch pad it was allocating
2734and freeing temporaries and lexicals from.
2735
2736=item panic: pad_free curpad
2737
2738(P) The compiler got confused about which scratch pad it was allocating
2739and freeing temporaries and lexicals from.
2740
2741=item panic: pad_free po
2742
2743(P) An invalid scratch pad offset was detected internally.
2744
2745=item panic: pad_reset curpad
2746
2747(P) The compiler got confused about which scratch pad it was allocating
2748and freeing temporaries and lexicals from.
2749
2750=item panic: pad_sv po
2751
2752(P) An invalid scratch pad offset was detected internally.
2753
2754=item panic: pad_swipe curpad
2755
2756(P) The compiler got confused about which scratch pad it was allocating
2757and freeing temporaries and lexicals from.
2758
2759=item panic: pad_swipe po
2760
2761(P) An invalid scratch pad offset was detected internally.
2762
2763=item panic: pp_iter
2764
2765(P) The foreach iterator got called in a non-loop context frame.
2766
2269b42e
JH
2767=item panic: pp_split
2768
2769(P) Something terrible went wrong in setting up for the split.
2770
a0d0e21e
LW
2771=item panic: realloc
2772
2773(P) Something requested a negative number of bytes of realloc.
2774
2775=item panic: restartop
2776
2777(P) Some internal routine requested a goto (or something like it), and
2778didn't supply the destination.
2779
2780=item panic: return
2781
2782(P) We popped the context stack to a subroutine or eval context, and
2783then discovered it wasn't a subroutine or eval context.
2784
2785=item panic: scan_num
2786
2787(P) scan_num() got called on something that wasn't a number.
2788
2789=item panic: sv_insert
2790
2791(P) The sv_insert() routine was told to remove more string than there
2792was string.
2793
2794=item panic: top_env
2795
6224f72b 2796(P) The compiler attempted to do a goto, or something weird like that.
a0d0e21e
LW
2797
2798=item panic: yylex
2799
2800(P) The lexer got into a bad state while processing a case modifier.
2801
dea0fc0b
JH
2802=item panic: utf16_to_utf8: odd bytelen
2803
2804(P) Something tried to call utf16_to_utf8 with an odd (as opposed
64977eb6 2805to even) byte length.
dea0fc0b 2806
7b8d334a 2807=item Parentheses missing around "%s" list
a0d0e21e 2808
e476b1b5 2809(W parenthesis) You said something like
a0d0e21e
LW
2810
2811 my $foo, $bar = @_;
2812
2813when you meant
2814
2815 my ($foo, $bar) = @_;
2816
54884818 2817Remember that "my", "our", and "local" bind tighter than comma.
a0d0e21e 2818
75b44862 2819=item Perl %s required--this is only version %s, stopped
a0d0e21e 2820
be771a83
GS
2821(F) The module in question uses features of a version of Perl more
2822recent than the currently running version. How long has it been since
2823you upgraded, anyway? See L<perlfunc/require>.
a0d0e21e 2824
6df41af2
GS
2825=item PERL_SH_DIR too long
2826
2827(F) An error peculiar to OS/2. PERL_SH_DIR is the directory to find the
fecfaeb8 2828C<sh>-shell in. See "PERL_SH_DIR" in L<perlos2>.
6df41af2
GS
2829
2830=item perl: warning: Setting locale failed.
2831
2832(S) The whole warning message will look something like:
2833
2834 perl: warning: Setting locale failed.
2835 perl: warning: Please check that your locale settings:
2836 LC_ALL = "En_US",
2837 LANG = (unset)
2838 are supported and installed on your system.
2839 perl: warning: Falling back to the standard locale ("C").
2840
2841Exactly what were the failed locale settings varies. In the above the
2842settings were that the LC_ALL was "En_US" and the LANG had no value.
0ea6b70f
JH
2843This error means that Perl detected that you and/or your operating
2844system supplier and/or system administrator have set up the so-called
2845locale system but Perl could not use those settings. This was not
2846dead serious, fortunately: there is a "default locale" called "C" that
2847Perl can and will use, the script will be run. Before you really fix
2848the problem, however, you will get the same error message each time
2849you run Perl. How to really fix the problem can be found in
2850L<perllocale> section B<LOCALE PROBLEMS>.
6df41af2 2851
bccbfa77
NC
2852=item perlio: argument list not closed for layer "%s"
2853
d7133549
RGS
2854(W layer) When pushing a layer with arguments onto the Perl I/O system you
2855forgot the ) that closes the argument list. (Layers take care of transforming
64977eb6
NC
2856data between external and internal representations.) Perl stopped parsing
2857the layer list at this point and did not attempt to push this layer.
2858If your program didn't explicitly request the failing operation, it may be
2859the result of the value of the environment variable PERLIO.
2860
d7133549 2861=item perlio: invalid separator character %s in layer specification list %s
64977eb6 2862
d7133549 2863(W layer) When pushing layers onto the Perl I/O system, something other than a
d1be9408 2864colon or whitespace was seen between the elements of a layer list.
64977eb6
NC
2865If the previous attribute had a parenthesised parameter list, perhaps that
2866list was terminated too soon.
bccbfa77 2867
ef0f9817
DD
2868=item perlio: unknown layer "%s"
2869
d7133549 2870(W layer) An attempt was made to push an unknown layer onto the Perl I/O
ef0f9817
DD
2871system. (Layers take care of transforming data between external and
2872internal representations.) Note that some layers, such as C<mmap>,
2873are not supported in all environments. If your program didn't
2874explicitly request the failing operation, it may be the result of the
2875value of the environment variable PERLIO.
2876
a0d0e21e
LW
2877=item Permission denied
2878
2879(F) The setuid emulator in suidperl decided you were up to no good.
2880
bd3fa61c 2881=item pid %x not a child
748a9306 2882
be771a83
GS
2883(W exec) A warning peculiar to VMS. Waitpid() was asked to wait for a
2884process which isn't a subprocess of the current process. While this is
2885fine from VMS' perspective, it's probably not what you intended.
748a9306 2886
3bf38418
WL
2887=item P must have an explicit size
2888
2889(F) The unpack format P must have an explicit size, not "*".
2890
5cd5c422
RB
2891=item POSIX syntax [%s] belongs inside character classes in regex;
2892
2893marked by <-- HERE in m/%s/
b45f050a 2894
9a0b3859 2895(W regexp) The character class constructs [: :], [= =], and [. .] go
7253e4e3
RK
2896I<inside> character classes, the [] are part of the construct, for example:
2897/[012[:alpha:]345]/. Note that [= =] and [. .] are not currently
2898implemented; they are simply placeholders for future extensions and will
2899cause fatal errors. The <-- HERE shows in the regular expression about
2900where the problem was discovered. See L<perlre>.
b45f050a 2901
5cd5c422
RB
2902=item POSIX syntax [. .] is reserved for future extensions in regex;
2903
2904marked by <-- HERE in m/%s/
b45f050a
JF
2905
2906(F regexp) Within regular expression character classes ([]) the syntax
7253e4e3
RK
2907beginning with "[." and ending with ".]" is reserved for future extensions.
2908If you need to represent those character sequences inside a regular
2909expression character class, just quote the square brackets with the
2910backslash: "\[." and ".\]". The <-- HERE shows in the regular expression
2911about where the problem was discovered. See L<perlre>.
b45f050a 2912
5cd5c422
RB
2913=item POSIX syntax [= =] is reserved for future extensions in regex;
2914
2915marked by <-- HERE in m/%s/
b45f050a 2916
7253e4e3
RK
2917(F) Within regular expression character classes ([]) the syntax beginning
2918with "[=" and ending with "=]" is reserved for future extensions. If you
2919need to represent those character sequences inside a regular expression
2920character class, just quote the square brackets with the backslash: "\[="
2921and "=\]". The <-- HERE shows in the regular expression about where the
2922problem was discovered. See L<perlre>.
b45f050a 2923
5cd5c422
RB
2924=item POSIX class [:%s:] unknown in regex;
2925
2926marked by <-- HERE in m/%s/
b45f050a 2927
7253e4e3
RK
2928(F) The class in the character class [: :] syntax is unknown. The <-- HERE
2929shows in the regular expression about where the problem was discovered.
80feea45
JH
2930Note that the POSIX character classes do B<not> have the C<is> prefix
2931the corresponding C interfaces have: in other words, it's C<[[:print:]]>,
2932not C<isprint>. See L<perlre>.
b45f050a 2933
a0d0e21e
LW
2934=item POSIX getpgrp can't take an argument
2935
81777298 2936(F) Your system has POSIX getpgrp(), which takes no argument, unlike
a0d0e21e
LW
2937the BSD version, which takes a pid.
2938
bbce6d69
PP
2939=item Possible attempt to put comments in qw() list
2940
e476b1b5 2941(W qw) qw() lists contain items separated by whitespace; as with literal
75b44862 2942strings, comment characters are not ignored, but are instead treated as
be771a83
GS
2943literal data. (You may have used different delimiters than the
2944parentheses shown here; braces are also frequently used.)
bbce6d69 2945
774d564b
PP
2946You probably wrote something like this:
2947
54310121 2948 @list = qw(
774d564b 2949 a # a comment
bbce6d69 2950 b # another comment
774d564b 2951 );
bbce6d69
PP
2952
2953when you should have written this:
2954
774d564b 2955 @list = qw(
54310121
PP
2956 a
2957 b
774d564b
PP
2958 );
2959
2960If you really want comments, build your list the
2961old-fashioned way, with quotes and commas:
2962
2963 @list = (
2964 'a', # a comment
2965 'b', # another comment
2966 );
bbce6d69
PP
2967
2968=item Possible attempt to separate words with commas
2969
be771a83
GS
2970(W qw) qw() lists contain items separated by whitespace; therefore
2971commas aren't needed to separate the items. (You may have used
2972different delimiters than the parentheses shown here; braces are also
2973frequently used.)
bbce6d69 2974
54310121 2975You probably wrote something like this:
bbce6d69 2976
774d564b
PP
2977 qw! a, b, c !;
2978
2979which puts literal commas into some of the list items. Write it without
2980commas if you don't want them to appear in your data:
bbce6d69 2981
774d564b 2982 qw! a b c !;
bbce6d69 2983
a0d0e21e
LW
2984=item Possible memory corruption: %s overflowed 3rd argument
2985
2986(F) An ioctl() or fcntl() returned more than Perl was bargaining for.
2987Perl guesses a reasonable buffer size, but puts a sentinel byte at the
2988end of the buffer just in case. This sentinel byte got clobbered, and
2989Perl assumes that memory is now corrupted. See L<perlfunc/ioctl>.
2990
276b2a0c
RGS
2991=item Possible precedence problem on bitwise %c operator
2992
2993(W precedence) Your program uses a bitwise logical operator in conjunction
2994with a numeric comparison operator, like this :
2995
2996 if ($x & $y == 0) { ... }
2997
2998This expression is actually equivalent to C<$x & ($y == 0)>, due to the
2999higher precedence of C<==>. This is probably not what you want. (If you
3000really meant to write this, disable the warning, or, better, write
3001C<$x & ($y == 0 ? 1 : 0)>).
3002
18623440
PS
3003=item Possible unintended interpolation of %s in string
3004
3005(W ambiguous) You said something like `@foo' in a double-quoted string
32b0a12e
AMS
3006but there was no array C<@foo> in scope at the time. If you wanted a
3007literal @foo, then write it as \@foo; otherwise find out what happened
3008to the array you apparently lost track of.
18623440 3009
6df41af2
GS
3010=item Possible Y2K bug: %s
3011
3012(W y2k) You are concatenating the number 19 with another number, which
3013could be a potential Year 2000 problem.
3014
8cd79558
GS
3015=item pragma "attrs" is deprecated, use "sub NAME : ATTRS" instead
3016
a1063b2d 3017(D deprecated) You have written something like this:
8cd79558
GS
3018
3019 sub doit
3020 {
3021 use attrs qw(locked);
3022 }
3023
3024You should use the new declaration syntax instead.
3025
3026 sub doit : locked
3027 {
3028 ...
3029
3030The C<use attrs> pragma is now obsolete, and is only provided for
3031backward-compatibility. See L<perlsub/"Subroutine Attributes">.
3032
a0d0e21e
LW
3033=item Precedence problem: open %s should be open(%s)
3034
e476b1b5 3035(S precedence) The old irregular construct
cb1a09d0 3036
a0d0e21e
LW
3037 open FOO || die;
3038
3039is now misinterpreted as
3040
3041 open(FOO || die);
3042
be771a83
GS
3043because of the strict regularization of Perl 5's grammar into unary and
3044list operators. (The old open was a little of both.) You must put
3045parentheses around the filehandle, or use the new "or" operator instead
3046of "||".
a0d0e21e 3047
3cdd684c
TP
3048=item Premature end of script headers
3049
3050See Server error.
3051
6df41af2
GS
3052=item printf() on closed filehandle %s
3053
be771a83 3054(W closed) The filehandle you're writing to got itself closed sometime
c289d2f7 3055before now. Check your control flow.
6df41af2 3056
9a7dcd9c 3057=item print() on closed filehandle %s
a0d0e21e 3058
be771a83 3059(W closed) The filehandle you're printing on got itself closed sometime
c289d2f7 3060before now. Check your control flow.
a0d0e21e 3061
6df41af2 3062=item Process terminated by SIG%s
a0d0e21e 3063
6df41af2
GS
3064(W) This is a standard message issued by OS/2 applications, while *nix
3065applications die in silence. It is considered a feature of the OS/2
3066port. One can easily disable this by appropriate sighandlers, see
3067L<perlipc/"Signals">. See also "Process terminated by SIGTERM/SIGINT"
fecfaeb8 3068in L<perlos2>.
a0d0e21e 3069
3fe9a6f1 3070=item Prototype mismatch: %s vs %s
4633a7c4 3071
9a0b3859 3072(S prototype) The subroutine being declared or defined had previously been
be771a83 3073declared or defined with a different function prototype.
4633a7c4 3074
ed9aa3b7
SG
3075=item Prototype not terminated
3076
2a6fd447 3077(F) You've omitted the closing parenthesis in a function prototype
ed9aa3b7
SG
3078definition.
3079
5cd5c422
RB
3080=item Quantifier in {,} bigger than %d in regex;
3081
3082marked by <-- HERE in m/%s/
9baa0206 3083
b45f050a 3084(F) There is currently a limit to the size of the min and max values of the
7253e4e3 3085{min,max} construct. The <-- HERE shows in the regular expression about where
b45f050a 3086the problem was discovered. See L<perlre>.
9baa0206 3087
5cd5c422
RB
3088=item Quantifier unexpected on zero-length expression;
3089
3090marked by <-- HERE in m/%s/
9baa0206 3091
b45f050a
JF
3092(W regexp) You applied a regular expression quantifier in a place where
3093it makes no sense, such as on a zero-width assertion. Try putting the
3094quantifier inside the assertion instead. For example, the way to match
3095"abc" provided that it is followed by three repetitions of "xyz" is
3096C</abc(?=(?:xyz){3})/>, not C</abc(?=xyz){3}/>.
9baa0206 3097
7253e4e3
RK
3098The <-- HERE shows in the regular expression about where the problem was
3099discovered.
3100
89ea2908
GA
3101=item Range iterator outside integer range
3102
3103(F) One (or both) of the numeric arguments to the range operator ".."
3104are outside the range which can be represented by integers internally.
be771a83
GS
3105One possible workaround is to force Perl to use magical string increment
3106by prepending "0" to your numbers.
89ea2908 3107
b5fe5ca2
SR
3108=item read() on closed filehandle %s
3109
3110(W closed) You tried to read from a closed filehandle.
3111
3112=item read() on unopened filehandle %s
3113
3114(W unopened) You tried to read from a filehandle that was never opened.
3115
9a7dcd9c 3116=item readline() on closed filehandle %s
a0d0e21e 3117
75b44862 3118(W closed) The filehandle you're reading from got itself closed sometime
c289d2f7 3119before now. Check your control flow.
a0d0e21e 3120
6df41af2
GS
3121=item Reallocation too large: %lx
3122
3123(F) You can't allocate more than 64K on an MS-DOS machine.
3124
4ad56ec9
IZ
3125=item realloc() of freed memory ignored
3126
be771a83
GS
3127(S malloc) An internal routine called realloc() on something that had
3128already been freed.
4ad56ec9 3129
a0d0e21e
LW
3130=item Recompile perl with B<-D>DEBUGGING to use B<-D> switch
3131
be771a83
GS
3132(F debugging) You can't use the B<-D> option unless the code to produce
3133the desired output is compiled into Perl, which entails some overhead,
a0d0e21e
LW
3134which is why it's currently left out of your copy.
3135
3e0ccd42 3136=item Recursive inheritance detected in package '%s'
a0d0e21e
LW
3137
3138(F) More than 100 levels of inheritance were used. Probably indicates
3139an unintended loop in your inheritance hierarchy.
3140
7a4340ed 3141=item Recursive inheritance detected while looking for method %s
3e0ccd42 3142
be771a83
GS
3143(F) More than 100 levels of inheritance were encountered while invoking
3144a method. Probably indicates an unintended loop in your inheritance
3145hierarchy.
3e0ccd42 3146
1930e939
TP
3147=item Reference found where even-sized list expected
3148
be771a83
GS
3149(W misc) You gave a single reference where Perl was expecting a list
3150with an even number of elements (for assignment to a hash). This usually
3151means that you used the anon hash constructor when you meant to use
3152parens. In any case, a hash requires key/value B<pairs>.
7b8d334a
GS
3153
3154 %hash = { one => 1, two => 2, }; # WRONG
3155 %hash = [ qw/ an anon array / ]; # WRONG
3156 %hash = ( one => 1, two => 2, ); # right
3157 %hash = qw( one 1 two 2 ); # also fine
3158
810b8aa5
GS
3159=item Reference is already weak
3160
e476b1b5 3161(W misc) You have attempted to weaken a reference that is already weak.
810b8aa5
GS
3162Doing so has no effect.
3163
a0d0e21e
LW
3164=item Reference miscount in sv_replace()
3165
be771a83
GS
3166(W internal) The internal sv_replace() function was handed a new SV with
3167a reference count of other than 1.
a0d0e21e 3168
5cd5c422
RB
3169=item Reference to nonexistent group in regex;
3170
3171marked by <-- HERE in m/%s/
b45f050a
JF
3172
3173(F) You used something like C<\7> in your regular expression, but there are
3174not at least seven sets of capturing parentheses in the expression. If you
3175wanted to have the character with value 7 inserted into the regular expression,
3176prepend a zero to make the number at least two digits: C<\07>
9baa0206 3177
7253e4e3 3178The <-- HERE shows in the regular expression about where the problem was
b45f050a 3179discovered.
9baa0206 3180
a0d0e21e
LW
3181=item regexp memory corruption
3182
3183(P) The regular expression engine got confused by what the regular
3184expression compiler gave it.
3185
b45f050a 3186=item Regexp out of space
a0d0e21e 3187
be771a83
GS
3188(P) A "can't happen" error, because safemalloc() should have caught it
3189earlier.
a0d0e21e 3190
7a95317d
GS
3191=item Repeat count in pack overflows
3192
be771a83
GS
3193(F) You can't specify a repeat count so large that it overflows your
3194signed integers. See L<perlfunc/pack>.
7a95317d
GS
3195
3196=item Repeat count in unpack overflows
3197
be771a83
GS
3198(F) You can't specify a repeat count so large that it overflows your
3199signed integers. See L<perlfunc/unpack>.
7a95317d 3200
a0d0e21e
LW
3201=item Reversed %s= operator
3202
be771a83
GS
3203(W syntax) You wrote your assignment operator backwards. The = must
3204always comes last, to avoid ambiguity with subsequent unary operators.
a0d0e21e
LW
3205
3206=item Runaway format
3207
3208(F) Your format contained the ~~ repeat-until-blank sequence, but it
3209produced 200 lines at once, and the 200th line looked exactly like the
3210199th line. Apparently you didn't arrange for the arguments to exhaust
3211themselves, either by using ^ instead of @ (for scalar variables), or by
3212shifting or popping (for array variables). See L<perlform>.
3213
3214=item Scalar value @%s[%s] better written as $%s[%s]
3215
be771a83
GS
3216(W syntax) You've used an array slice (indicated by @) to select a
3217single element of an array. Generally it's better to ask for a scalar
3218value (indicated by $). The difference is that C<$foo[&bar]> always
3219behaves like a scalar, both when assigning to it and when evaluating its
3220argument, while C<@foo[&bar]> behaves like a list when you assign to it,
3221and provides a list context to its subscript, which can do weird things
3222if you're expecting only one subscript.
a0d0e21e 3223
748a9306 3224On the other hand, if you were actually hoping to treat the array
5f05dabc 3225element as a list, you need to look into how references work, because
748a9306
LW
3226Perl will not magically convert between scalars and lists for you. See
3227L<perlref>.
3228
a6006777
PP
3229=item Scalar value @%s{%s} better written as $%s{%s}
3230
75b44862 3231(W syntax) You've used a hash slice (indicated by @) to select a single
be771a83
GS
3232element of a hash. Generally it's better to ask for a scalar value
3233(indicated by $). The difference is that C<$foo{&bar}> always behaves
3234like a scalar, both when assigning to it and when evaluating its
3235argument, while C<@foo{&bar}> behaves like a list when you assign to it,
3236and provides a list context to its subscript, which can do weird things
3237if you're expecting only one subscript.
3238
3239On the other hand, if you were actually hoping to treat the hash element
3240as a list, you need to look into how references work, because Perl will
3241not magically convert between scalars and lists for you. See
a6006777
PP
3242L<perlref>.
3243
3e2f796a
NIS
3244=item Scalars leaked: %d
3245
3246(P) Something went wrong in Perl's internal bookkeeping of scalars:
3247not all scalar variables were deallocated by the time Perl exited.
3248What this usually indicates is a memory leak, which is of course bad,
3249especially if the Perl program is intended to be long-running.
3250
a0d0e21e
LW
3251=item Script is not setuid/setgid in suidperl
3252
54310121
PP
3253(F) Oddly, the suidperl program was invoked on a script without a setuid
3254or setgid bit set. This doesn't make much sense.
a0d0e21e
LW
3255
3256=item Search pattern not terminated
3257
3258(F) The lexer couldn't find the final delimiter of a // or m{}
3259construct. Remember that bracketing delimiters count nesting level.
fb73857a 3260Missing the leading C<$> from a variable C<$m> may cause this error.
a0d0e21e 3261
0cb1bcd7 3262Note that since Perl 5.9.0 a // can also be the I<defined-or>
5d9c98cd
JH
3263construct, not just the empty search pattern. Therefore code written
3264in Perl 5.9.0 or later that uses the // as the I<defined-or> can be
3265misparsed by pre-5.9.0 Perls as a non-terminated search pattern.
3266
9ddeeac9 3267=item %sseek() on unopened filehandle
a0d0e21e 3268
be771a83
GS
3269(W unopened) You tried to use the seek() or sysseek() function on a
3270filehandle that was either never opened or has since been closed.
a0d0e21e
LW
3271
3272=item select not implemented
3273
3274(F) This machine doesn't implement the select() system call.
3275
ae21d580 3276=item Self-ties of arrays and hashes are not supported
68a4a7e4 3277
ae21d580
JH
3278(F) Self-ties are of arrays and hashes are not supported in
3279the current implementation.
68a4a7e4 3280
6df41af2 3281=item Semicolon seems to be missing
a0d0e21e 3282
75b44862
GS
3283(W semicolon) A nearby syntax error was probably caused by a missing
3284semicolon, or possibly some other missing operator, such as a comma.
a0d0e21e
LW
3285
3286=item semi-panic: attempt to dup freed string
3287
be771a83
GS
3288(S internal) The internal newSVsv() routine was called to duplicate a
3289scalar that had previously been marked as free.
a0d0e21e 3290
6df41af2 3291=item sem%s not implemented
a0d0e21e 3292
6df41af2 3293(F) You don't have System V semaphore IPC on your system.
a0d0e21e 3294
69282e91 3295=item send() on closed socket %s
a0d0e21e 3296
be771a83 3297(W closed) The socket you're sending to got itself closed sometime
c289d2f7 3298before now. Check your control flow.
a0d0e21e 3299
7253e4e3 3300=item Sequence (? incomplete in regex; marked by <-- HERE in m/%s/
7b8d334a 3301
7253e4e3 3302(F) A regular expression ended with an incomplete extension (?. The <-- HERE
b45f050a 3303shows in the regular expression about where the problem was discovered. See
be771a83 3304L<perlre>.
1b1626e4 3305
5cd5c422
RB
3306=item Sequence (?{...}) not terminated or not {}-balanced in regex;
3307
3308marked by <-- HERE in m/%s/
b45f050a
JF
3309
3310(F) If the contents of a (?{...}) clause contains braces, they must balance
7253e4e3
RK
3311for Perl to properly detect the end of the clause. The <-- HERE shows in
3312the regular expression about where the problem was discovered. See
3313L<perlre>.
a0d0e21e 3314
5cd5c422
RB
3315=item Sequence (?%s...) not implemented in regex;
3316
3317marked by <-- HERE in m/%s/
a0d0e21e 3318
b45f050a 3319(F) A proposed regular expression extension has the character reserved but
7253e4e3 3320has not yet been written. The <-- HERE shows in the regular expression about
b45f050a
JF
3321where the problem was discovered. See L<perlre>.
3322
5cd5c422
RB
3323=item Sequence (?%s...) not recognized in regex;
3324
3325marked by <-- HERE in m/%s/
a0d0e21e 3326
7253e4e3
RK
3327(F) You used a regular expression extension that doesn't make sense. The
3328<-- HERE shows in the regular expression about where the problem was
3329discovered. See L<perlre>.
a0d0e21e 3330
5cd5c422
RB
3331=item Sequence (?#... not terminated in regex;
3332
3333marked by <-- HERE in m/%s/
6df41af2
GS
3334
3335(F) A regular expression comment must be terminated by a closing
7253e4e3
RK
3336parenthesis. Embedded parentheses aren't allowed. The <-- HERE shows in
3337the regular expression about where the problem was discovered. See
3338L<perlre>.
6df41af2
GS
3339
3340=item 500 Server error
3341
3342See Server error.
3343
a5f75d66
AD
3344=item Server error
3345
3cdd684c 3346This is the error message generally seen in a browser window when trying
be771a83
GS
3347to run a CGI program (including SSI) over the web. The actual error text
3348varies widely from server to server. The most frequently-seen variants
3349are "500 Server error", "Method (something) not permitted", "Document
3350contains no data", "Premature end of script headers", and "Did not
3351produce a valid header".
9607fc9c
PP
3352
3353B<This is a CGI error, not a Perl error>.
3354
be771a83
GS
3355You need to make sure your script is executable, is accessible by the
3356user CGI is running the script under (which is probably not the user
3357account you tested it under), does not rely on any environment variables
3358(like PATH) from the user it isn't running under, and isn't in a
3359location where the CGI server can't find it, basically, more or less.
3360Please see the following for more information:
9607fc9c 3361
06a5f41f
JH
3362 http://www.perl.org/CGI_MetaFAQ.html
3363 http://www.htmlhelp.org/faq/cgifaq.html
3364 http://www.w3.org/Security/Faq/
a5f75d66 3365
be94a901
GS
3366You should also look at L<perlfaq9>.
3367
a0d0e21e
LW
3368=item setegid() not implemented
3369
be771a83
GS
3370(F) You tried to assign to C<$)>, and your operating system doesn't
3371support the setegid() system call (or equivalent), or at least Configure
3372didn't think so.
a0d0e21e
LW
3373
3374=item seteuid() not implemented
3375
be771a83
GS
3376(F) You tried to assign to C<< $> >>, and your operating system doesn't