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