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