This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
pod/perlipc.pod patch
[perl5.git] / pod / perldiag.pod
CommitLineData
a0d0e21e
LW
1=head1 NAME
2
3perldiag - various Perl diagnostics
4
5=head1 DESCRIPTION
6
7These messages are classified as follows (listed in increasing order of
8desperation):
9
10 (W) A warning (optional).
11 (D) A deprecation (optional).
12 (S) A severe warning (mandatory).
13 (F) A fatal error (trappable).
14 (P) An internal error you should never see (trappable).
15 (X) A very fatal error (non-trappable).
cb1a09d0 16 (A) An alien error message (not generated by Perl).
a0d0e21e 17
748a9306 18Optional warnings are enabled by using the B<-w> switch. Warnings may
8b1a09fc 19be captured by setting C<$SIG{__WARN__}> to a reference to a routine that will be
748a9306
LW
20called on each warning instead of printing it. See L<perlvar>.
21Trappable errors may be trapped using the eval operator. See
22L<perlfunc/eval>.
a0d0e21e
LW
23
24Some of these messages are generic. Spots that vary are denoted with a %s,
2ba9eb46 25just as in a printf format. Note that some messages start with a %s!
a0d0e21e
LW
26The symbols C<"%-?@> sort before the letters, while C<[> and C<\> sort after.
27
28=over 4
29
30=item "my" variable %s can't be in a package
31
32(F) Lexically scoped variables aren't in a package, so it doesn't make sense
33to try to declare one with a package qualifier on the front. Use local()
34if you want to localize a package variable.
35
2ba9eb46 36=item "my" variable %s masks earlier declaration in same scope
37
38(S) A lexical variable has been redeclared in the same scope, effectively
39eliminating all access to the previous instance. This is almost always
8b1a09fc 40a typographical error. Note that the earlier variable will still exist
2ba9eb46 41until the end of the scope or until all closure referents to it are
42destroyed.
43
a0d0e21e
LW
44=item "no" not allowed in expression
45
46(F) The "no" keyword is recognized and executed at compile time, and returns
47no useful value. See L<perlmod>.
48
49=item "use" not allowed in expression
50
51(F) The "use" keyword is recognized and executed at compile time, and returns
52no useful value. See L<perlmod>.
53
54=item % may only be used in unpack
55
56(F) You can't pack a string by supplying a checksum, since the
57checksumming process loses information, and you can't go the other
58way. See L<perlfunc/unpack>.
59
60=item %s (...) interpreted as function
61
62(W) You've run afoul of the rule that says that any list operator followed
8b1a09fc 63by parentheses turns into a function, with all the list operators arguments
a0d0e21e
LW
64found inside the parens. See L<perlop/Terms and List Operators (Leftward)>.
65
66=item %s argument is not a HASH element
67
68(F) The argument to delete() or exists() must be a hash element, such as
69
70 $foo{$bar}
71 $ref->[12]->{"susie"}
72
73=item %s did not return a true value
74
75(F) A required (or used) file must return a true value to indicate that
76it compiled correctly and ran its initialization code correctly. It's
77traditional to end such a file with a "1;", though any true value would
78do. See L<perlfunc/require>.
79
80=item %s found where operator expected
81
82(S) The Perl lexer knows whether to expect a term or an operator. If it
83sees what it knows to be a term when it was expecting to see an operator,
84it gives you this warning. Usually it indicates that an operator or
85delimiter was omitted, such as a semicolon.
86
87=item %s had compilation errors.
88
89(F) The final summary message when a C<perl -c> fails.
90
91=item %s has too many errors.
92
93(F) The parser has given up trying to parse the program after 10 errors.
94Further error messages would likely be uninformative.
95
96=item %s matches null string many times
97
98(W) The pattern you've specified would be an infinite loop if the
99regular expression engine didn't specifically check for that. See L<perlre>.
100
101=item %s never introduced
102
103(S) The symbol in question was declared but somehow went out of scope
104before it could possibly have been used.
105
106=item %s syntax OK
107
108(F) The final summary message when a C<perl -c> succeeds.
109
cb1a09d0
AD
110=item %s: Command not found.
111
112(A) You've accidentally run your script through B<csh> instead
8b1a09fc 113of Perl. Check the E<lt>#!E<gt> line, or manually feed your script
cb1a09d0
AD
114into Perl yourself.
115
116=item %s: Expression syntax.
117
118(A) You've accidentally run your script through B<csh> instead
8b1a09fc 119of Perl. Check the E<lt>#!E<gt> line, or manually feed your script
cb1a09d0
AD
120into Perl yourself.
121
122=item %s: Undefined variable.
123
124(A) You've accidentally run your script through B<csh> instead
8b1a09fc 125of Perl. Check the E<lt>#!E<gt> line, or manually feed your script
cb1a09d0
AD
126into Perl yourself.
127
128=item %s: not found
129
8b1a09fc 130(A) You've accidentally run your script through the Bourne shell
131instead of Perl. Check the E<lt>#!E<gt> line, or manually feed your script
cb1a09d0
AD
132into Perl yourself.
133
a0d0e21e
LW
134=item B<-P> not allowed for setuid/setgid script
135
136(F) The script would have to be opened by the C preprocessor by name,
137which provides a race condition that breaks security.
138
139=item C<-T> and C<-B> not implemented on filehandles
140
141(F) Perl can't peek at the stdio buffer of filehandles when it doesn't
142know about your kind of stdio. You'll have to use a filename instead.
143
a5f75d66
AD
144=item 500 Server error
145
146See Server error.
147
a0d0e21e
LW
148=item ?+* follows nothing in regexp
149
150(F) You started a regular expression with a quantifier. Backslash it
151if you meant it literally. See L<perlre>.
152
153=item @ outside of string
154
2ba9eb46 155(F) You had a pack template that specified an absolute position outside
a0d0e21e
LW
156the string being unpacked. See L<perlfunc/pack>.
157
158=item accept() on closed fd
159
160(W) You tried to do an accept on a closed socket. Did you forget to check
161the return value of your socket() call? See L<perlfunc/accept>.
162
163=item Allocation too large: %lx
164
55497cff 165(X) You can't allocate more than 64K on an MSDOS machine.
166
167=item Allocation too large
168
169(F) You can't allocate more than 2^31+"small amount" bytes.
a0d0e21e
LW
170
171=item Arg too short for msgsnd
172
173(F) msgsnd() requires a string at least as long as sizeof(long).
174
748a9306
LW
175=item Ambiguous use of %s resolved as %s
176
177(W)(S) You said something that may not be interpreted the way
178you thought. Normally it's pretty easy to disambiguate it by supplying
179a missing quote, operator, paren pair or declaration.
180
a0d0e21e
LW
181=item Args must match #! line
182
183(F) The setuid emulator requires that the arguments Perl was invoked
184with match the arguments specified on the #! line.
185
186=item Argument "%s" isn't numeric
187
188(W) The indicated string was fed as an argument to an operator that
189expected a numeric value instead. If you're fortunate the message
190will identify which operator was so unfortunate.
191
192=item Array @%s missing the @ in argument %d of %s()
193
194(D) Really old Perl let you omit the @ on array names in some spots. This
195is now heavily deprecated.
196
197=item assertion botched: %s
198
199(P) The malloc package that comes with Perl had an internal failure.
200
201=item Assertion failed: file "%s"
202
203(P) A general assertion failed. The file in question must be examined.
204
205=item Assignment to both a list and a scalar
206
207(F) If you assign to a conditional operator, the 2nd and 3rd arguments
208must either both be scalars or both be lists. Otherwise Perl won't
209know which context to supply to the right side.
210
211=item Attempt to free non-arena SV: 0x%lx
212
213(P) All SV objects are supposed to be allocated from arenas that will
214be garbage collected on exit. An SV was discovered to be outside any
215of those arenas.
216
bbce6d69 217=item Attempt to free non-existent shared string
218
219(P) Perl maintains a reference counted internal table of strings to
220optimize the storage and access of hash keys and other strings. This
221indicates someone tried to decrement the reference count of a string
222that can no longer be found in the table.
223
a0d0e21e
LW
224=item Attempt to free temp prematurely
225
226(W) Mortalized values are supposed to be freed by the free_tmps()
227routine. This indicates that something else is freeing the SV before
228the free_tmps() routine gets a chance, which means that the free_tmps()
229routine will be freeing an unreferenced scalar when it does try to free
230it.
231
232=item Attempt to free unreferenced glob pointers
233
234(P) The reference counts got screwed up on symbol aliases.
235
236=item Attempt to free unreferenced scalar
237
238(W) Perl went to decrement the reference count of a scalar to see if it
239would go to 0, and discovered that it had already gone to 0 earlier,
240and should have been freed, and in fact, probably was freed. This
241could indicate that SvREFCNT_dec() was called too many times, or that
242SvREFCNT_inc() was called too few times, or that the SV was mortalized
243when it shouldn't have been, or that memory has been corrupted.
244
b7a902f4 245=item Attempt to use reference as lvalue in substr
246
247(W) You supplied a reference as the first argument to substr() used
8b1a09fc 248as an lvalue, which is pretty strange. Perhaps you forgot to
b7a902f4 249dereference it first. See L<perlfunc/substr>.
250
a0d0e21e
LW
251=item Bad arg length for %s, is %d, should be %d
252
253(F) You passed a buffer of the wrong size to one of msgctl(), semctl() or
2ba9eb46 254shmctl(). In C parlance, the correct sizes are, respectively,
a0d0e21e
LW
255S<sizeof(struct msqid_ds *)>, S<sizeof(struct semid_ds *)> and
256S<sizeof(struct shmid_ds *)>.
257
258=item Bad associative array
259
260(P) One of the internal hash routines was passed a null HV pointer.
261
262=item Bad filehandle: %s
263
264(F) A symbol was passed to something wanting a filehandle, but the symbol
265has no filehandle associated with it. Perhaps you didn't do an open(), or
266did it in another package.
267
268=item Bad free() ignored
269
270(S) An internal routine called free() on something that had never been
33c8a3fe
IZ
271malloc()ed in the first place. Mandatory, but can be disabled by
272setting environment variable C<PERL_BADFREE> to 1.
273
274This message can be quite often seen with DB_File on systems with
275"hard" dynamic linking, like C<AIX> and C<OS/2>. It is a bug of
276C<Berkeley DB> which is left unnoticed if C<DB> uses I<forgiving>
277system malloc().
a0d0e21e
LW
278
279=item Bad name after %s::
280
281(F) You started to name a symbol by using a package prefix, and then didn't
282finish the symbol. In particular, you can't interpolate outside of quotes,
283so
284
285 $var = 'myvar';
286 $sym = mypack::$var;
287
288is not the same as
289
290 $var = 'myvar';
291 $sym = "mypack::$var";
292
293=item Bad symbol for array
294
295(P) An internal request asked to add an array entry to something that
296wasn't a symbol table entry.
297
298=item Bad symbol for filehandle
299
300(P) An internal request asked to add a filehandle entry to something that
301wasn't a symbol table entry.
302
303=item Bad symbol for hash
304
305(P) An internal request asked to add a hash entry to something that
306wasn't a symbol table entry.
307
8b1a09fc 308=item Badly placed ()'s
cb1a09d0
AD
309
310(A) You've accidentally run your script through B<csh> instead
8b1a09fc 311of Perl. Check the E<lt>#!E<gt> line, or manually feed your script
cb1a09d0
AD
312into Perl yourself.
313
a0d0e21e
LW
314=item BEGIN failed--compilation aborted
315
316(F) An untrapped exception was raised while executing a BEGIN subroutine.
317Compilation stops immediately and the interpreter is exited.
318
319=item bind() on closed fd
320
321(W) You tried to do a bind on a closed socket. Did you forget to check
322the return value of your socket() call? See L<perlfunc/bind>.
323
4633a7c4
LW
324=item Bizarre copy of %s in %s
325
326(P) Perl detected an attempt to copy an internal value that is not copiable.
327
a0d0e21e
LW
328=item Callback called exit
329
330(F) A subroutine invoked from an external package via perl_call_sv()
331exited by calling exit.
332
333=item Can't "last" outside a block
334
335(F) A "last" statement was executed to break out of the current block,
336except that there's this itty bitty problem called there isn't a
337current block. Note that an "if" or "else" block doesn't count as a
338"loopish" block. You can usually double the curlies to get the same
339effect though, since the inner curlies will be considered a block
340that loops once. See L<perlfunc/last>.
341
342=item Can't "next" outside a block
343
344(F) A "next" statement was executed to reiterate the current block, but
345there isn't a current block. Note that an "if" or "else" block doesn't
346count as a "loopish" block. You can usually double the curlies to get
347the same effect though, since the inner curlies will be considered a block
348that loops once. See L<perlfunc/last>.
349
350=item Can't "redo" outside a block
351
352(F) A "redo" statement was executed to restart the current block, but
353there isn't a current block. Note that an "if" or "else" block doesn't
354count as a "loopish" block. You can usually double the curlies to get
355the same effect though, since the inner curlies will be considered a block
356that loops once. See L<perlfunc/last>.
357
358=item Can't bless non-reference value
359
360(F) Only hard references may be blessed. This is how Perl "enforces"
361encapsulation of objects. See L<perlobj>.
362
363=item Can't break at that line
364
365(S) A warning intended for while running within the debugger, indicating
366the line number specified wasn't the location of a statement that could
367be stopped at.
368
369=item Can't call method "%s" in empty package "%s"
370
371(F) You called a method correctly, and it correctly indicated a package
372functioning as a class, but that package doesn't have ANYTHING defined
373in it, let alone methods. See L<perlobj>.
374
375=item Can't call method "%s" on unblessed reference
376
377(F) A method call must know what package it's supposed to run in. It
378ordinarily finds this out from the object reference you supply, but
379you didn't supply an object reference in this case. A reference isn't
380an object reference until it has been blessed. See L<perlobj>.
381
382=item Can't call method "%s" without a package or object reference
383
384(F) You used the syntax of a method call, but the slot filled by the
385object reference or package name contains an expression that returns
386neither an object reference nor a package name. (Perhaps it's null?)
387Something like this will reproduce the error:
388
389 $BADREF = undef;
390 process $BADREF 1,2,3;
391 $BADREF->process(1,2,3);
392
393=item Can't chdir to %s
394
395(F) You called C<perl -x/foo/bar>, but C</foo/bar> is not a directory
396that you can chdir to, possibly because it doesn't exist.
397
398=item Can't coerce %s to integer in %s
399
400(F) Certain types of SVs, in particular real symbol table entries
55497cff 401(typeglobs), can't be forced to stop being what they are. So you can't
a0d0e21e
LW
402say things like:
403
404 *foo += 1;
405
406You CAN say
407
408 $foo = *foo;
409 $foo += 1;
410
411but then $foo no longer contains a glob.
412
413=item Can't coerce %s to number in %s
414
415(F) Certain types of SVs, in particular real symbol table entries
55497cff 416(typeglobs), can't be forced to stop being what they are.
a0d0e21e
LW
417
418=item Can't coerce %s to string in %s
419
420(F) Certain types of SVs, in particular real symbol table entries
55497cff 421(typeglobs), can't be forced to stop being what they are.
a0d0e21e
LW
422
423=item Can't create pipe mailbox
424
748a9306
LW
425(P) An error peculiar to VMS. The process is suffering from exhausted quotas
426or other plumbing problems.
a0d0e21e
LW
427
428=item Can't declare %s in my
429
430(F) Only scalar, array and hash variables may be declared as lexical variables.
431They must have ordinary identifiers as names.
432
433=item Can't do inplace edit on %s: %s
434
435(S) The creation of the new file failed for the indicated reason.
436
437=item Can't do inplace edit without backup
438
439(F) You're on a system such as MSDOS that gets confused if you try reading
440from a deleted (but still opened) file. You have to say B<-i>C<.bak>, or some
441such.
442
8b1a09fc 443=item Can't do inplace edit: %s E<gt> 14 characters
a0d0e21e
LW
444
445(S) There isn't enough room in the filename to make a backup name for the file.
446
447=item Can't do inplace edit: %s is not a regular file
448
449(S) You tried to use the B<-i> switch on a special file, such as a file in
450/dev, or a FIFO. The file was ignored.
451
452=item Can't do setegid!
453
454(P) The setegid() call failed for some reason in the setuid emulator
455of suidperl.
456
457=item Can't do seteuid!
458
459(P) The setuid emulator of suidperl failed for some reason.
460
461=item Can't do setuid
462
463(F) This typically means that ordinary perl tried to exec suidperl to
464do setuid emulation, but couldn't exec it. It looks for a name of the
465form sperl5.000 in the same directory that the perl executable resides
466under the name perl5.000, typically /usr/local/bin on Unix machines.
467If the file is there, check the execute permissions. If it isn't, ask
468your sysadmin why he and/or she removed it.
469
470=item Can't do waitpid with flags
471
472(F) This machine doesn't have either waitpid() or wait4(), so only waitpid()
473without flags is emulated.
474
8b1a09fc 475=item Can't do {n,m} with n E<gt> m
a0d0e21e
LW
476
477(F) Minima must be less than or equal to maxima. If you really want
478your regexp to match something 0 times, just put {0}. See L<perlre>.
479
480=item Can't emulate -%s on #! line
481
482(F) The #! line specifies a switch that doesn't make sense at this point.
483For example, it'd be kind of silly to put a B<-x> on the #! line.
484
485=item Can't exec "%s": %s
486
487(W) An system(), exec() or piped open call could not execute the named
488program for the indicated reason. Typical reasons include: the permissions
489were wrong on the file, the file wasn't found in C<$ENV{PATH}>, the
490executable in question was compiled for another architecture, or the
491#! line in a script points to an interpreter that can't be run for
492similar reasons. (Or maybe your system doesn't support #! at all.)
493
494=item Can't exec %s
495
496(F) Perl was trying to execute the indicated program for you because that's
497what the #! line said. If that's not what you wanted, you may need to
498mention "perl" on the #! line somewhere.
499
500=item Can't execute %s
501
502(F) You used the B<-S> switch, but the script to execute could not be found
503in the PATH, or at least not with the correct permissions.
504
505=item Can't find label %s
506
507(F) You said to goto a label that isn't mentioned anywhere that it's possible
508for us to go to. See L<perlfunc/goto>.
509
510=item Can't find string terminator %s anywhere before EOF
511
512(F) Perl strings can stretch over multiple lines. This message means that
513the closing delimiter was omitted. Since bracketed quotes count nesting
514levels, the following is missing its final parenthesis:
515
516 print q(The character '(' starts a side comment.)
517
518=item Can't fork
519
520(F) A fatal error occurred while trying to fork while opening a pipeline.
521
33c8a3fe
IZ
522=item Unsupported function fork
523
524(F) Your version of executable does not support forking.
525
526Note that under some systems, like OS/2, there may be different flavors of
527Perl executables, some of which may support fork, some not. Try changing
528the name you call Perl by to C<perl_>, C<perl__>, and so on.
529
748a9306
LW
530=item Can't get filespec - stale stat buffer?
531
532(S) A warning peculiar to VMS. This arises because of the difference between
533access checks under VMS and under the Unix model Perl assumes. Under VMS,
534access checks are done by filename, rather than by bits in the stat buffer, so
535that ACLs and other protections can be taken into account. Unfortunately, Perl
536assumes that the stat buffer contains all the necessary information, and passes
537it, instead of the filespec, to the access checking routine. It will try to
538retrieve the filespec using the device name and FID present in the stat buffer,
539but this works only if you haven't made a subsequent call to the CRTL stat()
540routine, since the device name is overwritten with each call. If this warning
541appears, the name lookup failed, and the access checking routine gave up and
542returned FALSE, just to be conservative. (Note: The access checking routine
543knows about the Perl C<stat> operator and file tests, so you shouldn't ever
544see this warning in response to a Perl command; it arises only if some internal
545code takes stat buffers lightly.)
546
a0d0e21e
LW
547=item Can't get pipe mailbox device name
548
748a9306
LW
549(P) An error peculiar to VMS. After creating a mailbox to act as a pipe, Perl
550can't retrieve its name for later use.
a0d0e21e
LW
551
552=item Can't get SYSGEN parameter value for MAXBUF
553
748a9306
LW
554(P) An error peculiar to VMS. Perl asked $GETSYI how big you want your
555mailbox buffers to be, and didn't get an answer.
a0d0e21e
LW
556
557=item Can't goto subroutine outside a subroutine
558
559(F) The deeply magical "goto subroutine" call can only replace one subroutine
560call for another. It can't manufacture one out of whole cloth. In general
561you should only be calling it out of an AUTOLOAD routine anyway. See
562L<perlfunc/goto>.
563
4633a7c4
LW
564=item Can't localize a reference
565
566(F) You said something like C<local $$ref>, which is not allowed because
567the compiler can't determine whether $ref will end up pointing to anything
568with a symbol table entry, and a symbol table entry is necessary to
569do a local.
570
748a9306
LW
571=item Can't localize lexical variable %s
572
2ba9eb46 573(F) You used local on a variable name that was previously declared as a
748a9306
LW
574lexical variable using "my". This is not allowed. If you want to
575localize a package variable of the same name, qualify it with the
576package name.
577
a0d0e21e
LW
578=item Can't locate %s in @INC
579
580(F) You said to do (or require, or use) a file that couldn't be found
581in any of the libraries mentioned in @INC. Perhaps you need to set
582the PERL5LIB environment variable to say where the extra library is,
583or maybe the script needs to add the library name to @INC. Or maybe
584you just misspelled the name of the file. See L<perlfunc/require>.
585
586=item Can't locate object method "%s" via package "%s"
587
588(F) You called a method correctly, and it correctly indicated a package
589functioning as a class, but that package doesn't define that particular
2ba9eb46 590method, nor does any of its base classes. See L<perlobj>.
a0d0e21e
LW
591
592=item Can't locate package %s for @%s::ISA
593
594(W) The @ISA array contained the name of another package that doesn't seem
595to exist.
596
597=item Can't mktemp()
598
599(F) The mktemp() routine failed for some reason while trying to process
600a B<-e> switch. Maybe your /tmp partition is full, or clobbered.
601
602=item Can't modify %s in %s
603
604(F) You aren't allowed to assign to the item indicated, or otherwise try to
605change it, such as with an autoincrement.
606
607=item Can't modify non-existent substring
608
609(P) The internal routine that does assignment to a substr() was handed
610a NULL.
611
612=item Can't msgrcv to readonly var
613
614(F) The target of a msgrcv must be modifiable in order to be used as a receive
615buffer.
616
617=item Can't open %s: %s
618
619(S) An inplace edit couldn't open the original file for the indicated reason.
620Usually this is because you don't have read permission for the file.
621
622=item Can't open bidirectional pipe
623
624(W) You tried to say C<open(CMD, "|cmd|")>, which is not supported. You can
625try any of several modules in the Perl library to do this, such as
8b1a09fc 626"open2.pl". Alternately, direct the pipe's output to a file using "E<gt>",
a0d0e21e
LW
627and then read it in under a different file handle.
628
748a9306
LW
629=item Can't open error file %s as stderr
630
631(F) An error peculiar to VMS. Perl does its own command line redirection, and
8b1a09fc 632couldn't open the file specified after '2E<gt>' or '2E<gt>E<gt>' on the
633command line for writing.
748a9306
LW
634
635=item Can't open input file %s as stdin
636
637(F) An error peculiar to VMS. Perl does its own command line redirection, and
8b1a09fc 638couldn't open the file specified after 'E<lt>' on the command line for reading.
748a9306
LW
639
640=item Can't open output file %s as stdout
641
642(F) An error peculiar to VMS. Perl does its own command line redirection, and
8b1a09fc 643couldn't open the file specified after 'E<gt>' or 'E<gt>E<gt>' on the command
644line for writing.
748a9306
LW
645
646=item Can't open output pipe (name: %s)
647
648(P) An error peculiar to VMS. Perl does its own command line redirection, and
649couldn't open the pipe into which to send data destined for stdout.
650
a0d0e21e
LW
651=item Can't open perl script "%s": %s
652
653(F) The script you specified can't be opened for the indicated reason.
654
655=item Can't rename %s to %s: %s, skipping file
656
657(S) The rename done by the B<-i> switch failed for some reason, probably because
658you don't have write permission to the directory.
659
748a9306
LW
660=item Can't reopen input pipe (name: %s) in binary mode
661
662(P) An error peculiar to VMS. Perl thought stdin was a pipe, and tried to
663reopen it to accept binary data. Alas, it failed.
664
a0d0e21e
LW
665=item Can't reswap uid and euid
666
667(P) The setreuid() call failed for some reason in the setuid emulator
668of suidperl.
669
670=item Can't return outside a subroutine
671
672(F) The return statement was executed in mainline code, that is, where
673there was no subroutine call to return out of. See L<perlsub>.
674
675=item Can't stat script "%s"
676
677(P) For some reason you can't fstat() the script even though you have
678it open already. Bizarre.
679
680=item Can't swap uid and euid
681
682(P) The setreuid() call failed for some reason in the setuid emulator
683of suidperl.
684
685=item Can't take log of %g
686
687(F) Logarithms are only defined on positive real numbers.
688
689=item Can't take sqrt of %g
690
691(F) For ordinary real numbers, you can't take the square root of a
692negative number. There's a Complex package available for Perl, though,
693if you really want to do that.
694
695=item Can't undef active subroutine
696
697(F) You can't undefine a routine that's currently running. You can,
698however, redefine it while it's running, and you can even undef the
699redefined subroutine while the old routine is running. Go figure.
700
701=item Can't unshift
702
703(F) You tried to unshift an "unreal" array that can't be unshifted, such
704as the main Perl stack.
705
706=item Can't upgrade that kind of scalar
707
708(P) The internal sv_upgrade routine adds "members" to an SV, making
709it into a more specialized kind of SV. The top several SV types are
710so specialized, however, that they cannot be interconverted. This
711message indicates that such a conversion was attempted.
712
713=item Can't upgrade to undef
714
715(P) The undefined SV is the bottom of the totem pole, in the scheme
716of upgradability. Upgrading to undef indicates an error in the
717code calling sv_upgrade.
718
c07a80fd 719=item Can't use "my %s" in sort comparison
720
721(F) The global variables $a and $b are reserved for sort comparisons.
8b1a09fc 722You mentioned $a or $b in the same line as the E<lt>=E<gt> or cmp operator,
c07a80fd 723and the variable had earlier been declared as a lexical variable.
724Either qualify the sort variable with the package name, or rename the
725lexical variable.
726
a0d0e21e
LW
727=item Can't use %s for loop variable
728
729(F) Only a simple scalar variable may be used as a loop variable on a foreach.
730
731=item Can't use %s ref as %s ref
732
733(F) You've mixed up your reference types. You have to dereference a
734reference of the type needed. You can use the ref() function to
735test the type of the reference, if need be.
736
748a9306
LW
737=item Can't use \1 to mean $1 in expression
738
739(W) In an ordinary expression, backslash is a unary operator that creates
740a reference to its argument. The use of backslash to indicate a backreference
741to a matched substring is only valid as part of a regular expression pattern.
742Trying to do this in ordinary Perl code produces a value that prints
743out looking like SCALAR(0xdecaf). Use the $1 form instead.
744
745=item Can't use string ("%s") as %s ref while "strict refs" in use
a0d0e21e
LW
746
747(F) Only hard references are allowed by "strict refs". Symbolic references
748are disallowed. See L<perlref>.
749
750=item Can't use an undefined value as %s reference
751
752(F) A value used as either a hard reference or a symbolic reference must
753be a defined value. This helps to de-lurk some insidious errors.
754
a0d0e21e
LW
755=item Can't use global %s in "my"
756
757(F) You tried to declare a magical variable as a lexical variable. This is
758not allowed, because the magic can only be tied to one location (namely
759the global variable) and it would be incredibly confusing to have
760variables in your program that looked like magical variables but
761weren't.
762
748a9306
LW
763=item Can't use subscript on %s
764
765(F) The compiler tried to interpret a bracketed expression as a
766subscript. But to the left of the brackets was an expression that
767didn't look like an array reference, or anything else subscriptable.
768
a0d0e21e
LW
769=item Can't write to temp file for B<-e>: %s
770
771(F) The write routine failed for some reason while trying to process
772a B<-e> switch. Maybe your /tmp partition is full, or clobbered.
773
774=item Can't x= to readonly value
775
776(F) You tried to repeat a constant value (often the undefined value) with
777an assignment operator, which implies modifying the value itself.
778Perhaps you need to copy the value to a temporary, and repeat that.
779
780=item Cannot open temporary file
781
8b1a09fc 782(F) The create routine failed for some reason while trying to process
a0d0e21e
LW
783a B<-e> switch. Maybe your /tmp partition is full, or clobbered.
784
785=item chmod: mode argument is missing initial 0
786
787(W) A novice will sometimes say
788
789 chmod 777, $filename
790
791not realizing that 777 will be interpreted as a decimal number, equivalent
792to 01411. Octal constants are introduced with a leading 0 in Perl, as in C.
793
8b1a09fc 794=item Close on unopened file E<lt>%sE<gt>
a0d0e21e
LW
795
796(W) You tried to close a filehandle that was never opened.
797
798=item connect() on closed fd
799
800(W) You tried to do a connect on a closed socket. Did you forget to check
801the return value of your socket() call? See L<perlfunc/connect>.
802
803=item Corrupt malloc ptr 0x%lx at 0x%lx
804
805(P) The malloc package that comes with Perl had an internal failure.
806
807=item corrupted regexp pointers
808
809(P) The regular expression engine got confused by what the regular
810expression compiler gave it.
811
812=item corrupted regexp program
813
814(P) The regular expression engine got passed a regexp program without
815a valid magic number.
816
817=item Deep recursion on subroutine "%s"
818
819(W) This subroutine has called itself (directly or indirectly) 100
820times than it has returned. This probably indicates an infinite
821recursion, unless you're writing strange benchmark programs, in which
822case it indicates something else.
823
4633a7c4
LW
824=item Did you mean &%s instead?
825
826(W) You probably referred to an imported subroutine &FOO as $FOO or some such.
827
748a9306 828=item Did you mean $ or @ instead of %?
a0d0e21e 829
748a9306
LW
830(W) You probably said %hash{$key} when you meant $hash{$key} or @hash{@keys}.
831On the other hand, maybe you just meant %hash and got carried away.
832
833=item Do you need to predeclare %s?
834
835(S) This is an educated guess made in conjunction with the message "%s
836found where operator expected". It often means a subroutine or module
837name is being referenced that hasn't been declared yet. This may be
838because of ordering problems in your file, or because of a missing
839"sub", "package", "require", or "use" statement. If you're
840referencing something that isn't defined yet, you don't actually have
841to define the subroutine or package before the current location. You
842can use an empty "sub foo;" or "package FOO;" to enter a "forward"
843declaration.
a0d0e21e
LW
844
845=item Don't know how to handle magic of type '%s'
846
847(P) The internal handling of magical variables has been cursed.
848
849=item do_study: out of memory
850
851(P) This should have been caught by safemalloc() instead.
852
853=item Duplicate free() ignored
854
855(S) An internal routine called free() on something that had already
856been freed.
857
4633a7c4
LW
858=item elseif should be elsif
859
860(S) There is no keyword "elseif" in Perl because Larry thinks it's
861ugly. Your code will be interpreted as an attempt to call a method
862named "elseif" for the class returned by the following block. This is
863unlikely to be what you want.
864
a0d0e21e
LW
865=item END failed--cleanup aborted
866
867(F) An untrapped exception was raised while executing an END subroutine.
868The interpreter is immediately exited.
869
748a9306
LW
870=item Error converting file specification %s
871
872(F) An error peculiar to VMS. Since Perl may have to deal with file
873specifications in either VMS or Unix syntax, it converts them to a
874single form when it must operate on them directly. Either you've
875passed an invalid file specification to Perl, or you've found a
876case the conversion routines don't handle. Drat.
877
a0d0e21e
LW
878=item Execution of %s aborted due to compilation errors.
879
880(F) The final summary message when a Perl compilation fails.
881
882=item Exiting eval via %s
883
8b1a09fc 884(W) You are exiting an eval by unconventional means, such as
a0d0e21e
LW
885a goto, or a loop control statement.
886
887=item Exiting subroutine via %s
888
8b1a09fc 889(W) You are exiting a subroutine by unconventional means, such as
a0d0e21e
LW
890a goto, or a loop control statement.
891
892=item Exiting substitution via %s
893
8b1a09fc 894(W) You are exiting a substitution by unconventional means, such as
a0d0e21e
LW
895a return, a goto, or a loop control statement.
896
748a9306 897=item Fatal VMS error at %s, line %d
a0d0e21e 898
748a9306
LW
899(P) An error peculiar to VMS. Something untoward happened in a VMS system
900service or RTL routine; Perl's exit status should provide more details. The
901filename in "at %s" and the line number in "line %d" tell you which section of
902the Perl source code is distressed.
a0d0e21e
LW
903
904=item fcntl is not implemented
905
906(F) Your machine apparently doesn't implement fcntl(). What is this, a
907PDP-11 or something?
908
909=item Filehandle %s never opened
910
911(W) An I/O operation was attempted on a filehandle that was never initialized.
912You need to do an open() or a socket() call, or call a constructor from
913the FileHandle package.
914
915=item Filehandle %s opened only for input
916
917(W) You tried to write on a read-only filehandle. If you
918intended it to be a read-write filehandle, you needed to open it with
8b1a09fc 919"+E<lt>" or "+E<gt>" or "+E<gt>E<gt>" instead of with "E<lt>" or nothing. If
920you only intended to write the file, use "E<gt>" or "E<gt>E<gt>". See
921L<perlfunc/open>.
a0d0e21e
LW
922
923=item Filehandle only opened for input
924
925(W) You tried to write on a read-only filehandle. If you
926intended it to be a read-write filehandle, you needed to open it with
8b1a09fc 927"+E<lt>" or "+E<gt>" or "+E<gt>E<gt>" instead of with "E<lt>" or nothing. If
928you only intended to write the file, use "E<gt>" or "E<gt>E<gt>". See
929L<perlfunc/open>.
a0d0e21e
LW
930
931=item Final $ should be \$ or $name
932
933(F) You must now decide whether the final $ in a string was meant to be
934a literal dollar sign, or was meant to introduce a variable name
935that happens to be missing. So you have to put either the backslash or
936the name.
937
938=item Final @ should be \@ or @name
939
940(F) You must now decide whether the final @ in a string was meant to be
941a literal "at" sign, or was meant to introduce a variable name
942that happens to be missing. So you have to put either the backslash or
943the name.
944
945=item Format %s redefined
946
947(W) You redefined a format. To suppress this warning, say
948
949 {
950 local $^W = 0;
951 eval "format NAME =...";
952 }
953
954=item Format not terminated
955
956(F) A format must be terminated by a line with a solitary dot. Perl got
957to the end of your file without finding such a line.
958
959=item Found = in conditional, should be ==
960
961(W) You said
962
963 if ($foo = 123)
964
965when you meant
966
967 if ($foo == 123)
968
969(or something like that).
970
971=item gdbm store returned %d, errno %d, key "%s"
972
973(S) A warning from the GDBM_File extension that a store failed.
974
975=item gethostent not implemented
976
977(F) Your C library apparently doesn't implement gethostent(), probably
978because if it did, it'd feel morally obligated to return every hostname
979on the Internet.
980
981=item get{sock,peer}name() on closed fd
982
983(W) You tried to get a socket or peer socket name on a closed socket.
984Did you forget to check the return value of your socket() call?
985
748a9306
LW
986=item getpwnam returned invalid UIC %#o for user "%s"
987
988(S) A warning peculiar to VMS. The call to C<sys$getuai> underlying the
989C<getpwnam> operator returned an invalid UIC.
990
991
a0d0e21e
LW
992=item Glob not terminated
993
994(F) The lexer saw a left angle bracket in a place where it was expecting
995a term, so it's looking for the corresponding right angle bracket, and not
996finding it. Chances are you left some needed parentheses out earlier in
997the line, and you really meant a "less than".
998
999=item Global symbol "%s" requires explicit package name
1000
1001(F) You've said "use strict vars", which indicates that all variables must
1002either be lexically scoped (using "my"), or explicitly qualified to
1003say which package the global variable is in (using "::").
1004
1005=item goto must have label
1006
1007(F) Unlike with "next" or "last", you're not allowed to goto an
1008unspecified destination. See L<perlfunc/goto>.
1009
1010=item Had to create %s unexpectedly
1011
1012(S) A routine asked for a symbol from a symbol table that ought to have
1013existed already, but for some reason it didn't, and had to be created on
1014an emergency basis to prevent a core dump.
1015
1016=item Hash %%s missing the % in argument %d of %s()
1017
1018(D) Really old Perl let you omit the % on hash names in some spots. This
1019is now heavily deprecated.
1020
8b1a09fc 1021=item Ill-formed logical name |%s| in prime_env_iter
a0d0e21e 1022
8b1a09fc 1023(W) A warning peculiar to VMS. A logical name was encountered when preparing
1024to iterate over %ENV which violates the syntactic rules governing logical
1025names. Since it cannot be translated normally, it is skipped, and will not
1026appear in %ENV. This may be a benign occurence, as some software packages
1027might directly modify logical name tables and introduce non-standard names,
1028or it may indicate that a logical name table has been corrupted.
a0d0e21e
LW
1029
1030=item Illegal division by zero
1031
1032(F) You tried to divide a number by 0. Either something was wrong in your
1033logic, or you need to put a conditional in to guard against meaningless input.
1034
1035=item Illegal modulus zero
1036
1037(F) You tried to divide a number by 0 to get the remainder. Most numbers
1038don't take to this kindly.
1039
1040=item Illegal octal digit
1041
1042(F) You used an 8 or 9 in a octal number.
1043
748a9306
LW
1044=item Illegal octal digit ignored
1045
1046(W) You may have tried to use an 8 or 9 in a octal number. Interpretation
1047of the octal number stopped before the 8 or 9.
1048
a0d0e21e
LW
1049=item Insecure dependency in %s
1050
8b1a09fc 1051(F) You tried to do something that the tainting mechanism didn't like.
a0d0e21e
LW
1052The tainting mechanism is turned on when you're running setuid or setgid,
1053or when you specify B<-T> to turn it on explicitly. The tainting mechanism
1054labels all data that's derived directly or indirectly from the user,
1055who is considered to be unworthy of your trust. If any such data is
1056used in a "dangerous" operation, you get this error. See L<perlsec>
1057for more information.
1058
1059=item Insecure directory in %s
1060
1061(F) You can't use system(), exec(), or a piped open in a setuid or setgid
8b1a09fc 1062script if C<$ENV{PATH}> contains a directory that is writable by the world.
a0d0e21e
LW
1063See L<perlsec>.
1064
1065=item Insecure PATH
1066
1067(F) You can't use system(), exec(), or a piped open in a setuid or
8b1a09fc 1068setgid script if C<$ENV{PATH}> is derived from data supplied (or
a0d0e21e
LW
1069potentially supplied) by the user. The script must set the path to a
1070known value, using trustworthy data. See L<perlsec>.
1071
bbce6d69 1072=item Integer overflow in hex number
1073
1074(S) The literal hex number you have specified is too big for your
1075architecture. On a 32-bit architecture the largest hex literal is
10760xFFFFFFFF.
1077
1078=item Integer overflow in octal number
1079
1080(S) The literal octal number you have specified is too big for your
1081architecture. On a 32-bit architecture the largest octal literal is
1082037777777777.
1083
748a9306
LW
1084=item Internal inconsistency in tracking vforks
1085
1086(S) A warning peculiar to VMS. Perl keeps track of the number
1087of times you've called C<fork> and C<exec>, in order to determine
2ba9eb46 1088whether the current call to C<exec> should affect the current
748a9306
LW
1089script or a subprocess (see L<perlvms/exec>). Somehow, this count
1090has become scrambled, so Perl is making a guess and treating
1091this C<exec> as a request to terminate the Perl script
1092and execute the specified command.
1093
a0d0e21e
LW
1094=item internal disaster in regexp
1095
1096(P) Something went badly wrong in the regular expression parser.
1097
1098=item internal urp in regexp at /%s/
1099
1100(P) Something went badly awry in the regular expression parser.
1101
1102=item invalid [] range in regexp
1103
1104(F) The range specified in a character class had a minimum character
1105greater than the maximum character. See L<perlre>.
1106
1107=item ioctl is not implemented
1108
1109(F) Your machine apparently doesn't implement ioctl(), which is pretty
1110strange for a machine that supports C.
1111
1112=item junk on end of regexp
1113
1114(P) The regular expression parser is confused.
1115
1116=item Label not found for "last %s"
1117
1118(F) You named a loop to break out of, but you're not currently in a
1119loop of that name, not even if you count where you were called from.
1120See L<perlfunc/last>.
1121
1122=item Label not found for "next %s"
1123
1124(F) You named a loop to continue, but you're not currently in a loop of
1125that name, not even if you count where you were called from. See
1126L<perlfunc/last>.
1127
1128=item Label not found for "redo %s"
1129
1130(F) You named a loop to restart, but you're not currently in a loop of
1131that name, not even if you count where you were called from. See
1132L<perlfunc/last>.
1133
1134=item listen() on closed fd
1135
1136(W) You tried to do a listen on a closed socket. Did you forget to check
1137the return value of your socket() call? See L<perlfunc/listen>.
1138
1139=item Literal @%s now requires backslash
1140
1141(F) It used to be that Perl would try to guess whether you wanted an
1142array interpolated or a literal @. It did this when the string was
1143first used at runtime. Now strings are parsed at compile time, and
1144ambiguous instances of @ must be disambiguated, either by putting a
1145backslash to indicate a literal, or by declaring (or using) the array
1146within the program before the string (lexically). (Someday it will simply
1147assume that an unbackslashed @ interpolates an array.)
1148
1149=item Method for operation %s not found in package %s during blessing
1150
1151(F) An attempt was made to specify an entry in an overloading table that
8b1a09fc 1152doesn't somehow point to a valid method. See L<overload>.
a0d0e21e
LW
1153
1154=item Might be a runaway multi-line %s string starting on line %d
1155
1156(S) An advisory indicating that the previous error may have been caused
1157by a missing delimiter on a string or pattern, because it eventually
1158ended earlier on the current line.
1159
1160=item Misplaced _ in number
1161
1162(W) An underline in a decimal constant wasn't on a 3-digit boundary.
1163
1164=item Missing $ on loop variable
1165
8b1a09fc 1166(F) Apparently you've been programming in B<csh> too much. Variables are always
1167mentioned with the $ in Perl, unlike in the shells, where it can vary from
a0d0e21e
LW
1168one line to the next.
1169
1170=item Missing comma after first argument to %s function
1171
1172(F) While certain functions allow you to specify a filehandle or an
1173"indirect object" before the argument list, this ain't one of them.
1174
748a9306
LW
1175=item Missing operator before %s?
1176
1177(S) This is an educated guess made in conjunction with the message "%s
1178found where operator expected". Often the missing operator is a comma.
1179
a0d0e21e
LW
1180=item Missing right bracket
1181
1182(F) The lexer counted more opening curly brackets (braces) than closing ones.
1183As a general rule, you'll find it's missing near the place you were last
1184editing.
1185
1186=item Missing semicolon on previous line?
1187
1188(S) This is an educated guess made in conjunction with the message "%s
1189found where operator expected". Don't automatically put a semicolon on
1190the previous line just because you saw this message.
1191
1192=item Modification of a read-only value attempted
1193
1194(F) You tried, directly or indirectly, to change the value of a
1195constant. You didn't, of course, try "2 = 1", since the compiler
1196catches that. But an easy way to do the same thing is:
1197
1198 sub mod { $_[0] = 1 }
1199 mod(2);
1200
1201Another way is to assign to a substr() that's off the end of the string.
1202
1203=item Modification of non-creatable array value attempted, subscript %d
1204
1205(F) You tried to make an array value spring into existence, and the
1206subscript was probably negative, even counting from end of the array
1207backwards.
1208
1209=item Modification of non-creatable hash value attempted, subscript "%s"
1210
1211(F) You tried to make a hash value spring into existence, and it couldn't
1212be created for some peculiar reason.
1213
1214=item Module name must be constant
1215
1216(F) Only a bare module name is allowed as the first argument to a "use".
1217
1218=item msg%s not implemented
1219
1220(F) You don't have System V message IPC on your system.
1221
1222=item Multidimensional syntax %s not supported
1223
8b1a09fc 1224(W) Multidimensional arrays aren't written like C<$foo[1,2,3]>. They're written
1225like C<$foo[1][2][3]>, as in C.
1226
1227=item Name "%s::%s" used only once: possible typo
1228
1229(W) Typographical errors often show up as unique variable names. If you
1230had a good reason for having a unique name, then just mention it
1231again somehow to suppress the message (the C<use vars> pragma is
1232provided for just this purpose).
a0d0e21e
LW
1233
1234=item Negative length
1235
1236(F) You tried to do a read/write/send/recv operation with a buffer length
1237that is less than 0. This is difficult to imagine.
1238
1239=item nested *?+ in regexp
1240
1241(F) You can't quantify a quantifier without intervening parens. So
1242things like ** or +* or ?* are illegal.
1243
1244Note, however, that the minimal matching quantifiers, *?, +? and ?? appear
1245to be nested quantifiers, but aren't. See L<perlre>.
1246
1247=item No #! line
1248
1249(F) The setuid emulator requires that scripts have a well-formed #! line
1250even on machines that don't support the #! construct.
1251
1252=item No %s allowed while running setuid
1253
1254(F) Certain operations are deemed to be too insecure for a setuid or setgid
1255script to even be allowed to attempt. Generally speaking there will be
1256another way to do what you want that is, if not secure, at least securable.
1257See L<perlsec>.
1258
1259=item No B<-e> allowed in setuid scripts
1260
1261(F) A setuid script can't be specified by the user.
1262
1263=item No comma allowed after %s
1264
1265(F) A list operator that has a filehandle or "indirect object" is not
1266allowed to have a comma between that and the following arguments.
1267Otherwise it'd be just another one of the arguments.
1268
748a9306
LW
1269=item No command into which to pipe on command line
1270
1271(F) An error peculiar to VMS. Perl handles its own command line redirection,
1272and found a '|' at the end of the command line, so it doesn't know whither you
1273want to pipe the output from this command.
1274
a0d0e21e
LW
1275=item No DB::DB routine defined
1276
1277(F) The currently executing code was compiled with the B<-d> switch,
1278but for some reason the perl5db.pl file (or some facsimile thereof)
1279didn't define a routine to be called at the beginning of each
1280statement. Which is odd, because the file should have been required
1281automatically, and should have blown up the require if it didn't parse
1282right.
1283
1284=item No dbm on this machine
1285
1286(P) This is counted as an internal error, because every machine should
1287supply dbm nowadays, since Perl comes with SDBM. See L<SDBM_File>.
1288
1289=item No DBsub routine
1290
1291(F) The currently executing code was compiled with the B<-d> switch,
1292but for some reason the perl5db.pl file (or some facsimile thereof)
1293didn't define a DB::sub routine to be called at the beginning of each
1294ordinary subroutine call.
1295
8b1a09fc 1296=item No error file after 2E<gt> or 2E<gt>E<gt> on command line
748a9306
LW
1297
1298(F) An error peculiar to VMS. Perl handles its own command line redirection,
8b1a09fc 1299and found a '2E<gt>' or a '2E<gt>E<gt>' on the command line, but can't find
1300the name of the file to which to write data destined for stderr.
748a9306 1301
8b1a09fc 1302=item No input file after E<lt> on command line
748a9306
LW
1303
1304(F) An error peculiar to VMS. Perl handles its own command line redirection,
8b1a09fc 1305and found a 'E<lt>' on the command line, but can't find the name of the file
1306from which to read data for stdin.
748a9306 1307
8b1a09fc 1308=item No output file after E<gt> on command line
748a9306
LW
1309
1310(F) An error peculiar to VMS. Perl handles its own command line redirection,
8b1a09fc 1311and found a lone 'E<gt>' at the end of the command line, so it doesn't know
1312whither you wanted to redirect stdout.
748a9306 1313
8b1a09fc 1314=item No output file after E<gt> or E<gt>E<gt> on command line
748a9306
LW
1315
1316(F) An error peculiar to VMS. Perl handles its own command line redirection,
8b1a09fc 1317and found a 'E<gt>' or a 'E<gt>E<gt>' on the command line, but can't find the
1318name of the file to which to write data destined for stdout.
748a9306 1319
a0d0e21e
LW
1320=item No Perl script found in input
1321
1322(F) You called C<perl -x>, but no line was found in the file beginning
1323with #! and containing the word "perl".
1324
1325=item No setregid available
1326
1327(F) Configure didn't find anything resembling the setregid() call for
1328your system.
1329
1330=item No setreuid available
1331
1332(F) Configure didn't find anything resembling the setreuid() call for
1333your system.
1334
1335=item No space allowed after B<-I>
1336
1337(F) The argument to B<-I> must follow the B<-I> immediately with no
1338intervening space.
1339
748a9306
LW
1340=item No such pipe open
1341
1342(P) An error peculiar to VMS. The internal routine my_pclose() tried to
1343close a pipe which hadn't been opened. This should have been caught earlier as
1344an attempt to close an unopened filehandle.
1345
a0d0e21e
LW
1346=item No such signal: SIG%s
1347
1348(W) You specified a signal name as a subscript to %SIG that was not recognized.
1349Say C<kill -l> in your shell to see the valid signal names on your system.
1350
1351=item Not a CODE reference
1352
1353(F) Perl was trying to evaluate a reference to a code value (that is, a
1354subroutine), but found a reference to something else instead. You can
1355use the ref() function to find out what kind of ref it really was.
1356See also L<perlref>.
1357
1358=item Not a format reference
1359
1360(F) I'm not sure how you managed to generate a reference to an anonymous
1361format, but this indicates you did, and that it didn't exist.
1362
1363=item Not a GLOB reference
1364
55497cff 1365(F) Perl was trying to evaluate a reference to a "typeglob" (that is,
a0d0e21e
LW
1366a symbol table entry that looks like C<*foo>), but found a reference to
1367something else instead. You can use the ref() function to find out
1368what kind of ref it really was. See L<perlref>.
1369
1370=item Not a HASH reference
1371
1372(F) Perl was trying to evaluate a reference to a hash value, but
1373found a reference to something else instead. You can use the ref()
1374function to find out what kind of ref it really was. See L<perlref>.
1375
1376=item Not a perl script
1377
1378(F) The setuid emulator requires that scripts have a well-formed #! line
1379even on machines that don't support the #! construct. The line must
1380mention perl.
1381
1382=item Not a SCALAR reference
1383
1384(F) Perl was trying to evaluate a reference to a scalar value, but
1385found a reference to something else instead. You can use the ref()
1386function to find out what kind of ref it really was. See L<perlref>.
1387
1388=item Not a subroutine reference
1389
1390(F) Perl was trying to evaluate a reference to a code value (that is, a
1391subroutine), but found a reference to something else instead. You can
1392use the ref() function to find out what kind of ref it really was.
1393See also L<perlref>.
1394
1395=item Not a subroutine reference in %OVERLOAD
1396
1397(F) An attempt was made to specify an entry in an overloading table that
8b1a09fc 1398doesn't somehow point to a valid subroutine. See L<overload>.
a0d0e21e
LW
1399
1400=item Not an ARRAY reference
1401
1402(F) Perl was trying to evaluate a reference to an array value, but
1403found a reference to something else instead. You can use the ref()
1404function to find out what kind of ref it really was. See L<perlref>.
1405
1406=item Not enough arguments for %s
1407
1408(F) The function requires more arguments than you specified.
1409
1410=item Not enough format arguments
1411
1412(W) A format specified more picture fields than the next line supplied.
1413See L<perlform>.
1414
1415=item Null filename used
1416
1417(F) You can't require the null filename, especially since on many machines
1418that means the current directory! See L<perlfunc/require>.
1419
55497cff 1420=item Null picture in formline
1421
1422(F) The first argument to formline must be a valid format picture
1423specification. It was found to be empty, which probably means you
1424supplied it an uninitialized value. See L<perlform>.
1425
a0d0e21e
LW
1426=item NULL OP IN RUN
1427
1428(P) Some internal routine called run() with a null opcode pointer.
1429
1430=item Null realloc
1431
1432(P) An attempt was made to realloc NULL.
1433
1434=item NULL regexp argument
1435
1436(P) The internal pattern matching routines blew it bigtime.
1437
1438=item NULL regexp parameter
1439
1440(P) The internal pattern matching routines are out of their gourd.
1441
1442=item Odd number of elements in hash list
1443
1444(S) You specified an odd number of elements to a hash list, which is odd,
1445since hash lists come in key/value pairs.
1446
bbce6d69 1447=item Offset outside string
1448
1449(F) You tried to do a read/write/send/recv operation with an offset
1450pointing outside the buffer. This is difficult to imagine.
1451The sole exception to this is that C<sysread()>ing past the buffer
1452will extend the buffer and zero pad the new area.
1453
a0d0e21e
LW
1454=item oops: oopsAV
1455
1456(S) An internal warning that the grammar is screwed up.
1457
1458=item oops: oopsHV
1459
1460(S) An internal warning that the grammar is screwed up.
1461
1462=item Operation `%s' %s: no method found,
1463
1464(F) An attempt was made to use an entry in an overloading table that
8b1a09fc 1465somehow no longer points to a valid method. See L<overload>.
a0d0e21e 1466
748a9306
LW
1467=item Operator or semicolon missing before %s
1468
1469(S) You used a variable or subroutine call where the parser was
1470expecting an operator. The parser has assumed you really meant
1471to use an operator, but this is highly likely to be incorrect.
1472For example, if you say "*foo *foo" it will be interpreted as
1473if you said "*foo * 'foo'".
1474
a0d0e21e
LW
1475=item Out of memory for yacc stack
1476
1477(F) The yacc parser wanted to grow its stack so it could continue parsing,
1478but realloc() wouldn't give it more memory, virtual or otherwise.
1479
1480=item Out of memory!
1481
55497cff 1482(X|F) The malloc() function returned 0, indicating there was insufficient
eff9c6e2
CS
1483remaining memory (or virtual memory) to satisfy the request.
1484
1485The request was judged to be small, so the possibility to trap it
1486depends on the way perl was compiled. By default it is not trappable.
1487However, if compiled for this, Perl may use the contents of C<$^M> as
1488an emergency pool after die()ing with this message. In this case the
55497cff 1489error is trappable I<once>.
1490
1491=item Out of memory during request for %s
1492
1493(F) The malloc() function returned 0, indicating there was insufficient
1494remaining memory (or virtual memory) to satisfy the request. However,
1495the request was judged large enough (compile-time default is 64K), so
1496a possibility to shut down by trapping this error is granted.
1497
a0d0e21e
LW
1498=item page overflow
1499
1500(W) A single call to write() produced more lines than can fit on a page.
1501See L<perlform>.
1502
1503=item panic: ck_grep
1504
1505(P) Failed an internal consistency check trying to compile a grep.
1506
1507=item panic: ck_split
1508
1509(P) Failed an internal consistency check trying to compile a split.
1510
1511=item panic: corrupt saved stack index
1512
1513(P) The savestack was requested to restore more localized values than there
1514are in the savestack.
1515
1516=item panic: die %s
1517
1518(P) We popped the context stack to an eval context, and then discovered
1519it wasn't an eval context.
1520
1521=item panic: do_match
1522
1523(P) The internal pp_match() routine was called with invalid operational data.
1524
1525=item panic: do_split
1526
1527(P) Something terrible went wrong in setting up for the split.
1528
1529=item panic: do_subst
1530
1531(P) The internal pp_subst() routine was called with invalid operational data.
1532
1533=item panic: do_trans
1534
1535(P) The internal do_trans() routine was called with invalid operational data.
1536
1537=item panic: goto
1538
1539(P) We popped the context stack to a context with the specified label,
1540and then discovered it wasn't a context we know how to do a goto in.
1541
1542=item panic: INTERPCASEMOD
1543
1544(P) The lexer got into a bad state at a case modifier.
1545
1546=item panic: INTERPCONCAT
1547
1548(P) The lexer got into a bad state parsing a string with brackets.
1549
1550=item panic: last
1551
1552(P) We popped the context stack to a block context, and then discovered
1553it wasn't a block context.
1554
1555=item panic: leave_scope clearsv
1556
1557(P) A writable lexical variable became readonly somehow within the scope.
1558
1559=item panic: leave_scope inconsistency
1560
1561(P) The savestack probably got out of sync. At least, there was an
1562invalid enum on the top of it.
1563
1564=item panic: malloc
1565
1566(P) Something requested a negative number of bytes of malloc.
1567
1568=item panic: mapstart
1569
1570(P) The compiler is screwed up with respect to the map() function.
1571
1572=item panic: null array
1573
1574(P) One of the internal array routines was passed a null AV pointer.
1575
1576=item panic: pad_alloc
1577
1578(P) The compiler got confused about which scratch pad it was allocating
1579and freeing temporaries and lexicals from.
1580
1581=item panic: pad_free curpad
1582
1583(P) The compiler got confused about which scratch pad it was allocating
1584and freeing temporaries and lexicals from.
1585
1586=item panic: pad_free po
1587
1588(P) An invalid scratch pad offset was detected internally.
1589
1590=item panic: pad_reset curpad
1591
1592(P) The compiler got confused about which scratch pad it was allocating
1593and freeing temporaries and lexicals from.
1594
1595=item panic: pad_sv po
1596
1597(P) An invalid scratch pad offset was detected internally.
1598
1599=item panic: pad_swipe curpad
1600
1601(P) The compiler got confused about which scratch pad it was allocating
1602and freeing temporaries and lexicals from.
1603
1604=item panic: pad_swipe po
1605
1606(P) An invalid scratch pad offset was detected internally.
1607
1608=item panic: pp_iter
1609
1610(P) The foreach iterator got called in a non-loop context frame.
1611
1612=item panic: realloc
1613
1614(P) Something requested a negative number of bytes of realloc.
1615
1616=item panic: restartop
1617
1618(P) Some internal routine requested a goto (or something like it), and
1619didn't supply the destination.
1620
1621=item panic: return
1622
1623(P) We popped the context stack to a subroutine or eval context, and
1624then discovered it wasn't a subroutine or eval context.
1625
1626=item panic: scan_num
1627
1628(P) scan_num() got called on something that wasn't a number.
1629
1630=item panic: sv_insert
1631
1632(P) The sv_insert() routine was told to remove more string than there
1633was string.
1634
1635=item panic: top_env
1636
1637(P) The compiler attempted to do a goto, or something weird like that.
1638
1639=item panic: yylex
1640
1641(P) The lexer got into a bad state while processing a case modifier.
1642
1643=item Parens missing around "%s" list
1644
1645(W) You said something like
1646
1647 my $foo, $bar = @_;
1648
1649when you meant
1650
1651 my ($foo, $bar) = @_;
1652
1653Remember that "my" and "local" bind closer than comma.
1654
1655=item Perl %3.3f required--this is only version %s, stopped
1656
1657(F) The module in question uses features of a version of Perl more recent
1658than the currently running version. How long has it been since you upgraded,
1659anyway? See L<perlfunc/require>.
1660
1661=item Permission denied
1662
1663(F) The setuid emulator in suidperl decided you were up to no good.
1664
748a9306
LW
1665=item pid %d not a child
1666
1667(W) A warning peculiar to VMS. Waitpid() was asked to wait for a process which
1668isn't a subprocess of the current process. While this is fine from VMS'
1669perspective, it's probably not what you intended.
1670
a0d0e21e
LW
1671=item POSIX getpgrp can't take an argument
1672
1673(F) Your C compiler uses POSIX getpgrp(), which takes no argument, unlike
1674the BSD version, which takes a pid.
1675
bbce6d69 1676=item Possible attempt to put comments in qw() list
1677
1678(W) You probably wrote somthing like this:
1679
1680 qw( a # a comment
1681 b # another comment
1682 ) ;
1683
1684when you should have written this:
1685
1686 qw( a
1687 b
1688 ) ;
1689
1690=item Possible attempt to separate words with commas
1691
1692(W) You probably wrote somthing like this:
1693
1694 qw( a, b, c );
1695
1696when you should have written this:
1697
1698 qw( a b c );
1699
a0d0e21e
LW
1700=item Possible memory corruption: %s overflowed 3rd argument
1701
1702(F) An ioctl() or fcntl() returned more than Perl was bargaining for.
1703Perl guesses a reasonable buffer size, but puts a sentinel byte at the
1704end of the buffer just in case. This sentinel byte got clobbered, and
1705Perl assumes that memory is now corrupted. See L<perlfunc/ioctl>.
1706
1707=item Precedence problem: open %s should be open(%s)
1708
1709(S) The old irregular construct
cb1a09d0 1710
a0d0e21e
LW
1711 open FOO || die;
1712
1713is now misinterpreted as
1714
1715 open(FOO || die);
1716
1717because of the strict regularization of Perl 5's grammar into unary and
1718list operators. (The old open was a little of both.) You must put
1719parens around the filehandle, or use the new "or" operator instead of "||".
1720
1721=item print on closed filehandle %s
1722
1723(W) The filehandle you're printing on got itself closed sometime before now.
1724Check your logic flow.
1725
1726=item printf on closed filehandle %s
1727
1728(W) The filehandle you're writing to got itself closed sometime before now.
1729Check your logic flow.
1730
1731=item Probable precedence problem on %s
1732
1733(W) The compiler found a bare word where it expected a conditional,
1734which often indicates that an || or && was parsed as part of the
1735last argument of the previous construct, for example:
1736
1737 open FOO || die;
1738
4633a7c4
LW
1739=item Prototype mismatch: (%s) vs (%s)
1740
1741(S) The subroutine being defined had a predeclared (forward) declaration
1742with a different function prototype.
1743
8b1a09fc 1744=item Read on closed filehandle E<lt>%sE<gt>
a0d0e21e
LW
1745
1746(W) The filehandle you're reading from got itself closed sometime before now.
1747Check your logic flow.
1748
1749=item Reallocation too large: %lx
1750
1751(F) You can't allocate more than 64K on an MSDOS machine.
1752
1753=item Recompile perl with B<-D>DEBUGGING to use B<-D> switch
1754
1755(F) You can't use the B<-D> option unless the code to produce the
1756desired output is compiled into Perl, which entails some overhead,
1757which is why it's currently left out of your copy.
1758
1759=item Recursive inheritance detected
1760
1761(F) More than 100 levels of inheritance were used. Probably indicates
1762an unintended loop in your inheritance hierarchy.
1763
1764=item Reference miscount in sv_replace()
1765
1766(W) The internal sv_replace() function was handed a new SV with a
1767reference count of other than 1.
1768
1769=item regexp memory corruption
1770
1771(P) The regular expression engine got confused by what the regular
1772expression compiler gave it.
1773
1774=item regexp out of space
1775
1776(P) A "can't happen" error, because safemalloc() should have caught it earlier.
1777
1778=item regexp too big
1779
2ba9eb46 1780(F) The current implementation of regular expressions uses shorts as
a0d0e21e
LW
1781address offsets within a string. Unfortunately this means that if
1782the regular expression compiles to longer than 32767, it'll blow up.
1783Usually when you want a regular expression this big, there is a better
1784way to do it with multiple statements. See L<perlre>.
1785
1786=item Reversed %s= operator
1787
1788(W) You wrote your assignment operator backwards. The = must always
1789comes last, to avoid ambiguity with subsequent unary operators.
1790
1791=item Runaway format
1792
1793(F) Your format contained the ~~ repeat-until-blank sequence, but it
1794produced 200 lines at once, and the 200th line looked exactly like the
1795199th line. Apparently you didn't arrange for the arguments to exhaust
1796themselves, either by using ^ instead of @ (for scalar variables), or by
1797shifting or popping (for array variables). See L<perlform>.
1798
1799=item Scalar value @%s[%s] better written as $%s[%s]
1800
1801(W) You've used an array slice (indicated by @) to select a single value of
1802an array. Generally it's better to ask for a scalar value (indicated by $).
8b1a09fc 1803The difference is that C<$foo[&bar]> always behaves like a scalar, both when
1804assigning to it and when evaluating its argument, while C<@foo[&bar]> behaves
a0d0e21e
LW
1805like a list when you assign to it, and provides a list context to its
1806subscript, which can do weird things if you're only expecting one subscript.
1807
748a9306
LW
1808On the other hand, if you were actually hoping to treat the array
1809element as a list, you need to look into how references work, since
1810Perl will not magically convert between scalars and lists for you. See
1811L<perlref>.
1812
a0d0e21e
LW
1813=item Script is not setuid/setgid in suidperl
1814
1815(F) Oddly, the suidperl program was invoked on a script with its setuid
8b1a09fc 1816or setgid bit not set. This doesn't make much sense.
a0d0e21e
LW
1817
1818=item Search pattern not terminated
1819
1820(F) The lexer couldn't find the final delimiter of a // or m{}
1821construct. Remember that bracketing delimiters count nesting level.
1822
1823=item seek() on unopened file
1824
1825(W) You tried to use the seek() function on a filehandle that was either
1826never opened or has been closed since.
1827
1828=item select not implemented
1829
1830(F) This machine doesn't implement the select() system call.
1831
1832=item sem%s not implemented
1833
1834(F) You don't have System V semaphore IPC on your system.
1835
1836=item semi-panic: attempt to dup freed string
1837
1838(S) The internal newSVsv() routine was called to duplicate a scalar
1839that had previously been marked as free.
1840
1841=item Semicolon seems to be missing
1842
1843(W) A nearby syntax error was probably caused by a missing semicolon,
1844or possibly some other missing operator, such as a comma.
1845
1846=item Send on closed socket
1847
1848(W) The filehandle you're sending to got itself closed sometime before now.
1849Check your logic flow.
1850
1851=item Sequence (?#... not terminated
1852
1853(F) A regular expression comment must be terminated by a closing
1854parenthesis. Embedded parens aren't allowed. See L<perlre>.
1855
1856=item Sequence (?%s...) not implemented
1857
1858(F) A proposed regular expression extension has the character reserved
1859but has not yet been written. See L<perlre>.
1860
1861=item Sequence (?%s...) not recognized
1862
1863(F) You used a regular expression extension that doesn't make sense.
1864See L<perlre>.
1865
a5f75d66
AD
1866=item Server error
1867
1868Also known as "500 Server error". This is a CGI error, not a Perl
1869error. You need to make sure your script is executable, is accessible
1870by the user CGI is running the script under (which is probably not
1871the user account you tested it under), does not rely on any environment
1872variables (like PATH) from the user it isn't running under, and isn't
1873in a location where the CGI server can't find it, basically, more or less.
1874
a0d0e21e
LW
1875=item setegid() not implemented
1876
8b1a09fc 1877(F) You tried to assign to C<$)>, and your operating system doesn't support
a0d0e21e
LW
1878the setegid() system call (or equivalent), or at least Configure didn't
1879think so.
1880
1881=item seteuid() not implemented
1882
8b1a09fc 1883(F) You tried to assign to C<$E<gt>>, and your operating system doesn't support
a0d0e21e
LW
1884the seteuid() system call (or equivalent), or at least Configure didn't
1885think so.
1886
1887=item setrgid() not implemented
1888
8b1a09fc 1889(F) You tried to assign to C<$(>, and your operating system doesn't support
a0d0e21e
LW
1890the setrgid() system call (or equivalent), or at least Configure didn't
1891think so.
1892
1893=item setruid() not implemented
1894
8b1a09fc 1895(F) You tried to assign to C<$<lt>>, and your operating system doesn't support
a0d0e21e
LW
1896the setruid() system call (or equivalent), or at least Configure didn't
1897think so.
1898
1899=item Setuid/gid script is writable by world
1900
1901(F) The setuid emulator won't run a script that is writable by the world,
1902because the world might have written on it already.
1903
1904=item shm%s not implemented
1905
1906(F) You don't have System V shared memory IPC on your system.
1907
1908=item shutdown() on closed fd
1909
1910(W) You tried to do a shutdown on a closed socket. Seems a bit superfluous.
1911
1912=item SIG%s handler "%s" not defined.
1913
1914(W) The signal handler named in %SIG doesn't, in fact, exist. Perhaps you
1915put it into the wrong package?
1916
1917=item sort is now a reserved word
1918
1919(F) An ancient error message that almost nobody ever runs into anymore.
1920But before sort was a keyword, people sometimes used it as a filehandle.
1921
1922=item Sort subroutine didn't return a numeric value
1923
1924(F) A sort comparison routine must return a number. You probably blew
4633a7c4 1925it by not using C<E<lt>=E<gt>> or C<cmp>, or by not using them correctly.
a0d0e21e
LW
1926See L<perlfunc/sort>.
1927
1928=item Sort subroutine didn't return single value
1929
1930(F) A sort comparison subroutine may not return a list value with more
1931or less than one element. See L<perlfunc/sort>.
1932
1933=item Split loop
1934
1935(P) The split was looping infinitely. (Obviously, a split shouldn't iterate
1936more times than there are characters of input, which is what happened.)
1937See L<perlfunc/split>.
1938
8b1a09fc 1939=item Stat on unopened file E<lt>%sE<gt>
a0d0e21e
LW
1940
1941(W) You tried to use the stat() function (or an equivalent file test)
1942on a filehandle that was either never opened or has been closed since.
1943
1944=item Statement unlikely to be reached
1945
1946(W) You did an exec() with some statement after it other than a die().
1947This is almost always an error, because exec() never returns unless
1948there was a failure. You probably wanted to use system() instead,
1949which does return. To suppress this warning, put the exec() in a block
1950by itself.
1951
1952=item Subroutine %s redefined
1953
1954(W) You redefined a subroutine. To suppress this warning, say
1955
1956 {
1957 local $^W = 0;
1958 eval "sub name { ... }";
1959 }
1960
1961=item Substitution loop
1962
1963(P) The substitution was looping infinitely. (Obviously, a
1964substitution shouldn't iterate more times than there are characters of
1965input, which is what happened.) See the discussion of substitution in
1966L<perlop/"Quote and Quotelike Operators">.
1967
1968=item Substitution pattern not terminated
1969
1970(F) The lexer couldn't find the interior delimiter of a s/// or s{}{}
1971construct. Remember that bracketing delimiters count nesting level.
1972
1973=item Substitution replacement not terminated
1974
1975(F) The lexer couldn't find the final delimiter of a s/// or s{}{}
1976construct. Remember that bracketing delimiters count nesting level.
1977
1978=item substr outside of string
1979
1980(W) You tried to reference a substr() that pointed outside of a string.
1981That is, the absolute value of the offset was larger than the length of
1982the string. See L<perlfunc/substr>.
1983
1984=item suidperl is no longer needed since...
1985
1986(F) Your Perl was compiled with B<-D>SETUID_SCRIPTS_ARE_SECURE_NOW, but a
1987version of the setuid emulator somehow got run anyway.
1988
1989=item syntax error
1990
1991(F) Probably means you had a syntax error. Common reasons include:
1992
1993 A keyword is misspelled.
1994 A semicolon is missing.
1995 A comma is missing.
1996 An opening or closing parenthesis is missing.
1997 An opening or closing brace is missing.
1998 A closing quote is missing.
1999
2000Often there will be another error message associated with the syntax
2001error giving more information. (Sometimes it helps to turn on B<-w>.)
2002The error message itself often tells you where it was in the line when
2003it decided to give up. Sometimes the actual error is several tokens
2004before this, since Perl is good at understanding random input.
2005Occasionally the line number may be misleading, and once in a blue moon
2006the only way to figure out what's triggering the error is to call
2007C<perl -c> repeatedly, chopping away half the program each time to see
2008if the error went away. Sort of the cybernetic version of S<20 questions>.
2009
cb1a09d0
AD
2010=item syntax error at line %d: `%s' unexpected
2011
8b1a09fc 2012(A) You've accidentally run your script through the Bourne shell
2013instead of Perl. Check the E<lt>#!E<gt> line, or manually feed your script
cb1a09d0
AD
2014into Perl yourself.
2015
a0d0e21e
LW
2016=item System V IPC is not implemented on this machine
2017
2018(F) You tried to do something with a function beginning with "sem", "shm"
2019or "msg". See L<perlfunc/semctl>, for example.
2020
2021=item Syswrite on closed filehandle
2022
2023(W) The filehandle you're writing to got itself closed sometime before now.
2024Check your logic flow.
2025
2026=item tell() on unopened file
2027
2028(W) You tried to use the tell() function on a filehandle that was either
2029never opened or has been closed since.
2030
8b1a09fc 2031=item Test on unopened file E<lt>%sE<gt>
a0d0e21e
LW
2032
2033(W) You tried to invoke a file test operator on a filehandle that isn't
2034open. Check your logic. See also L<perlfunc/-X>.
2035
2036=item That use of $[ is unsupported
2037
8b1a09fc 2038(F) Assignment to C<$[> is now strictly circumscribed, and interpreted as
a0d0e21e
LW
2039a compiler directive. You may only say one of
2040
2041 $[ = 0;
2042 $[ = 1;
2043 ...
2044 local $[ = 0;
2045 local $[ = 1;
2046 ...
2047
2048This is to prevent the problem of one module changing the array base
2049out from under another module inadvertently. See L<perlvar/$[>.
2050
2051=item The %s function is unimplemented
2052
2053The function indicated isn't implemented on this architecture, according
2054to the probings of Configure.
2055
2056=item The crypt() function is unimplemented due to excessive paranoia.
2057
2058(F) Configure couldn't find the crypt() function on your machine,
2059probably because your vendor didn't supply it, probably because they
8b1a09fc 2060think the U.S. Government thinks it's a secret, or at least that they
a0d0e21e
LW
2061will continue to pretend that it is. And if you quote me on that, I
2062will deny it.
2063
2064=item The stat preceding C<-l _> wasn't an lstat
2065
2066(F) It makes no sense to test the current stat buffer for symbolic linkhood
2067if the last stat that wrote to the stat buffer already went past
2068the symlink to get to the real file. Use an actual filename instead.
2069
2070=item times not implemented
2071
2072(F) Your version of the C library apparently doesn't do times(). I suspect
2073you're not running on Unix.
2074
2075=item Too few args to syscall
2076
2077(F) There has to be at least one argument to syscall() to specify the
2078system call to call, silly dilly.
2079
cb1a09d0
AD
2080=item Too many ('s
2081
2082=item Too many )'s
2083
2084(A) You've accidentally run your script through B<csh> instead
8b1a09fc 2085of Perl. Check the E<lt>#!E<gt> line, or manually feed your script
cb1a09d0
AD
2086into Perl yourself.
2087
a0d0e21e
LW
2088=item Too many args to syscall
2089
2090(F) Perl only supports a maximum of 14 args to syscall().
2091
2092=item Too many arguments for %s
2093
2094(F) The function requires fewer arguments than you specified.
2095
2096=item trailing \ in regexp
2097
2098(F) The regular expression ends with an unbackslashed backslash. Backslash
2099it. See L<perlre>.
2100
2101=item Translation pattern not terminated
2102
2103(F) The lexer couldn't find the interior delimiter of a tr/// or tr[][]
2104construct.
2105
2106=item Translation replacement not terminated
2107
2108(F) The lexer couldn't find the final delimiter of a tr/// or tr[][]
2109construct.
2110
2111=item truncate not implemented
2112
2113(F) Your machine doesn't implement a file truncation mechanism that
2114Configure knows about.
2115
2116=item Type of arg %d to %s must be %s (not %s)
2117
2118(F) This function requires the argument in that position to be of a
8b1a09fc 2119certain type. Arrays must be @NAME or C<@{EXPR}>. Hashes must be
2120%NAME or C<%{EXPR}>. No implicit dereferencing is allowed--use the
a0d0e21e
LW
2121{EXPR} forms as an explicit dereference. See L<perlref>.
2122
2123=item umask: argument is missing initial 0
2124
2125(W) A umask of 222 is incorrect. It should be 0222, since octal literals
2126always start with 0 in Perl, as in C.
2127
4633a7c4
LW
2128=item Unable to create sub named "%s"
2129
2130(F) You attempted to create or access a subroutine with an illegal name.
2131
a0d0e21e
LW
2132=item Unbalanced context: %d more PUSHes than POPs
2133
2134(W) The exit code detected an internal inconsistency in how many execution
2135contexts were entered and left.
2136
2137=item Unbalanced saves: %d more saves than restores
2138
2139(W) The exit code detected an internal inconsistency in how many
2140values were temporarily localized.
2141
2142=item Unbalanced scopes: %d more ENTERs than LEAVEs
2143
2144(W) The exit code detected an internal inconsistency in how many blocks
2145were entered and left.
2146
2147=item Unbalanced tmps: %d more allocs than frees
2148
2149(W) The exit code detected an internal inconsistency in how many mortal
2150scalars were allocated and freed.
2151
2152=item Undefined format "%s" called
2153
2154(F) The format indicated doesn't seem to exist. Perhaps it's really in
2155another package? See L<perlform>.
2156
2157=item Undefined sort subroutine "%s" called
2158
2159(F) The sort comparison routine specified doesn't seem to exist. Perhaps
2160it's in a different package? See L<perlfunc/sort>.
2161
2162=item Undefined subroutine &%s called
2163
2164(F) The subroutine indicated hasn't been defined, or if it was, it
2165has since been undefined.
2166
2167=item Undefined subroutine called
2168
2169(F) The anonymous subroutine you're trying to call hasn't been defined,
2170or if it was, it has since been undefined.
2171
2172=item Undefined subroutine in sort
2173
2174(F) The sort comparison routine specified is declared but doesn't seem to
2175have been defined yet. See L<perlfunc/sort>.
2176
4633a7c4
LW
2177=item Undefined top format "%s" called
2178
2179(F) The format indicated doesn't seem to exist. Perhaps it's really in
2180another package? See L<perlform>.
2181
a0d0e21e
LW
2182=item unexec of %s into %s failed!
2183
2184(F) The unexec() routine failed for some reason. See your local FSF
2185representative, who probably put it there in the first place.
2186
2187=item Unknown BYTEORDER
2188
2189(F) There are no byteswapping functions for a machine with this byte order.
2190
2191=item unmatched () in regexp
2192
2193(F) Unbackslashed parentheses must always be balanced in regular
2194expressions. If you're a vi user, the % key is valuable for finding
2195the matching paren. See L<perlre>.
2196
2197=item Unmatched right bracket
2198
2199(F) The lexer counted more closing curly brackets (braces) than opening
2200ones, so you're probably missing an opening bracket. As a general
2201rule, you'll find the missing one (so to speak) near the place you were
2202last editing.
2203
2204=item unmatched [] in regexp
2205
2206(F) The brackets around a character class must match. If you wish to
2207include a closing bracket in a character class, backslash it or put it first.
2208See L<perlre>.
2209
2210=item Unquoted string "%s" may clash with future reserved word
2211
2212(W) You used a bare word that might someday be claimed as a reserved word.
2213It's best to put such a word in quotes, or capitalize it somehow, or insert
2214an underbar into it. You might also declare it as a subroutine.
2215
2216=item Unrecognized character \%03o ignored
2217
2218(S) A garbage character was found in the input, and ignored, in case it's
2219a weird control character on an EBCDIC machine, or some such.
2220
2221=item Unrecognized signal name "%s"
2222
2223(F) You specified a signal name to the kill() function that was not recognized.
2224Say C<kill -l> in your shell to see the valid signal names on your system.
2225
2226=item Unrecognized switch: -%s
2227
2228(F) You specified an illegal option to Perl. Don't do that.
2229(If you think you didn't do that, check the #! line to see if it's
2230supplying the bad switch on your behalf.)
2231
2232=item Unsuccessful %s on filename containing newline
2233
2234(W) A file operation was attempted on a filename, and that operation
2235failed, PROBABLY because the filename contained a newline, PROBABLY
2236because you forgot to chop() or chomp() it off. See L<perlfunc/chop>.
2237
2238=item Unsupported directory function "%s" called
2239
2240(F) Your machine doesn't support opendir() and readdir().
2241
2242=item Unsupported function %s
2243
2244(F) This machines doesn't implement the indicated function, apparently.
2245At least, Configure doesn't think so.
2246
2247=item Unsupported socket function "%s" called
2248
2249(F) Your machine doesn't support the Berkeley socket mechanism, or at
2250least that's what Configure thought.
2251
8b1a09fc 2252=item Unterminated E<lt>E<gt> operator
a0d0e21e
LW
2253
2254(F) The lexer saw a left angle bracket in a place where it was expecting
2255a term, so it's looking for the corresponding right angle bracket, and not
2256finding it. Chances are you left some needed parentheses out earlier in
2257the line, and you really meant a "less than".
2258
2259=item Use of $# is deprecated
2260
8b1a09fc 2261(D) This was an ill-advised attempt to emulate a poorly defined B<awk> feature.
a0d0e21e
LW
2262Use an explicit printf() or sprintf() instead.
2263
2264=item Use of $* is deprecated
2265
2266(D) This variable magically turned on multiline pattern matching, both for
2267you and for any luckless subroutine that you happen to call. You should
2268use the new C<//m> and C<//s> modifiers now to do that without the dangerous
2269action-at-a-distance effects of C<$*>.
2270
748a9306
LW
2271=item Use of %s in printf format not supported
2272
2273(F) You attempted to use a feature of printf that is accessible only
2274from C. This usually means there's a better way to do it in Perl.
2275
a0d0e21e
LW
2276=item Use of %s is deprecated
2277
2278(D) The construct indicated is no longer recommended for use, generally
2279because there's a better way to do it, and also because the old way has
2280bad side effects.
2281
8b1a09fc 2282=item Use of bare E<lt>E<lt> to mean E<lt>E<lt>"" is deprecated
4633a7c4
LW
2283
2284(D) You are now encouraged to use the explicitly quoted form if you
2285wish to use a blank line as the terminator of the here-document.
2286
a0d0e21e
LW
2287=item Use of implicit split to @_ is deprecated
2288
2289(D) It makes a lot of work for the compiler when you clobber a
2290subroutine's argument list, so it's better if you assign the results of
2291a split() explicitly to an array (or list).
2292
2293=item Use of uninitialized value
2294
2295(W) An undefined value was used as if it were already defined. It was
2296interpreted as a "" or a 0, but maybe it was a mistake. To suppress this
2297warning assign an initial value to your variables.
2298
2299=item Useless use of %s in void context
2300
2301(W) You did something without a side effect in a context that does nothing
2302with the return value, such as a statement that doesn't return a value
2303from a block, or the left side of a scalar comma operator. Very often
2304this points not to stupidity on your part, but a failure of Perl to parse
2305your program the way you thought it would. For example, you'd get this
2306if you mixed up your C precedence with Python precedence and said
2307
2308 $one, $two = 1, 2;
2309
2310when you meant to say
2311
2312 ($one, $two) = (1, 2);
2313
748a9306
LW
2314Another common error is to use ordinary parentheses to construct a list
2315reference when you should be using square or curly brackets, for
2316example, if you say
2317
2318 $array = (1,2);
2319
2320when you should have said
2321
2322 $array = [1,2];
2323
2324The square brackets explicitly turn a list value into a scalar value,
2325while parentheses do not. So when a parenthesized list is evaluated in
2326a scalar context, the comma is treated like C's comma operator, which
2327throws away the left argument, which is not what you want. See
2328L<perlref> for more on this.
2329
55497cff 2330=item untie attempted while %d inner references still exist
2331
2332(W) A copy of the object returned from C<tie> (or C<tied>) was still
2333valid when C<untie> was called.
2334
4633a7c4
LW
2335=item Variable "%s" is not exported
2336
2337(F) While "use strict" in effect, you referred to a global variable
2338that you apparently thought was imported from another module, because
2339something else of the same name (usually a subroutine) is exported
2340by that module. It usually means you put the wrong funny character
2341on the front of your variable.
2342
cb1a09d0
AD
2343=item Variable syntax.
2344
2345(A) You've accidentally run your script through B<csh> instead
8b1a09fc 2346of Perl. Check the E<lt>#!E<gt> line, or manually feed your script
cb1a09d0
AD
2347into Perl yourself.
2348
a0d0e21e
LW
2349=item Warning: unable to close filehandle %s properly.
2350
8b1a09fc 2351(S) The implicit close() done by an open() got an error indication on the
2ba9eb46 2352close(). This usually indicates your filesystem ran out of disk space.
a0d0e21e
LW
2353
2354=item Warning: Use of "%s" without parens is ambiguous
2355
2356(S) You wrote a unary operator followed by something that looks like a
2357binary operator that could also have been interpreted as a term or
2358unary operator. For instance, if you know that the rand function
2359has a default argument of 1.0, and you write
2360
2361 rand + 5;
2362
2363you may THINK you wrote the same thing as
2364
2365 rand() + 5;
2366
2367but in actual fact, you got
2368
2369 rand(+5);
2370
2371So put in parens to say what you really mean.
2372
2373=item Write on closed filehandle
2374
2375(W) The filehandle you're writing to got itself closed sometime before now.
2376Check your logic flow.
2377
2378=item X outside of string
2379
2380(F) You had a pack template that specified a relative position before
2381the beginning of the string being unpacked. See L<perlfunc/pack>.
2382
2383=item x outside of string
2384
2385(F) You had a pack template that specified a relative position after
2386the end of the string being unpacked. See L<perlfunc/pack>.
2387
2388=item Xsub "%s" called in sort
2389
2390(F) The use of an external subroutine as a sort comparison is not yet supported.
2391
2392=item Xsub called in sort
2393
2394(F) The use of an external subroutine as a sort comparison is not yet supported.
2395
2396=item You can't use C<-l> on a filehandle
2397
2398(F) A filehandle represents an opened file, and when you opened the file it
2399already went past any symlink you are presumably trying to look for.
2400Use a filename instead.
2401
2402=item YOU HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!
2403
2404(F) And you probably never will, since you probably don't have the
2405sources to your kernel, and your vendor probably doesn't give a rip
2406about what you want. Your best bet is to use the wrapsuid script in
2407the eg directory to put a setuid C wrapper around your script.
2408
2409=item You need to quote "%s"
2410
2411(W) You assigned a bareword as a signal handler name. Unfortunately, you
2412already have a subroutine of that name declared, which means that Perl 5
2413will try to call the subroutine when the assignment is executed, which is
2414probably not what you want. (If it IS what you want, put an & in front.)
2415
2416=item [gs]etsockopt() on closed fd
2417
2418(W) You tried to get or set a socket option on a closed socket.
2419Did you forget to check the return value of your socket() call?
2420See L<perlfunc/getsockopt>.
2421
2422=item \1 better written as $1
2423
2424(W) Outside of patterns, backreferences live on as variables. The use
2425of backslashes is grandfathered on the righthand side of a
2426substitution, but stylistically it's better to use the variable form
2427because other Perl programmers will expect it, and it works better
2428if there are more than 9 backreferences.
2429
8b1a09fc 2430=item '|' and 'E<lt>' may not both be specified on command line
748a9306
LW
2431
2432(F) An error peculiar to VMS. Perl does its own command line redirection, and
2433found that STDIN was a pipe, and that you also tried to redirect STDIN using
8b1a09fc 2434'E<lt>'. Only one STDIN stream to a customer, please.
748a9306 2435
8b1a09fc 2436=item '|' and 'E<gt>' may not both be specified on command line
748a9306
LW
2437
2438(F) An error peculiar to VMS. Perl does its own command line redirection, and
2439thinks you tried to redirect stdout both to a file and into a pipe to another
2440command. You need to choose one or the other, though nothing's stopping you
2441from piping into a program or Perl script which 'splits' output into two
2442streams, such as
2443
2444 open(OUT,">$ARGV[0]") or die "Can't write to $ARGV[0]: $!";
2445 while (<STDIN>) {
2446 print;
2447 print OUT;
2448 }
2449 close OUT;
2450
33c8a3fe
IZ
2451=item Got an error from DosAllocMem:
2452
2453(P) An error peculiar to OS/2. Most probably you use an obsolete version
2454of perl, and should not happen anyway.
2455
2456=item Malformed PERLLIB_PREFIX
2457
2458(F) An error peculiar to OS/2. PERLLIB_PREFIX should be of the form
2459
2460 prefix1;prefix2
2461
2462or
2463
2464 prefix1 prefix2
2465
2466with non-empty prefix1 and prefix2. If C<prefix1> is indeed a prefix of
2467a builtin library search path, prefix2 is substituted. The error may appear
2468if components are not found, or are too long. See L<perlos2/"PERLLIB_PREFIX">.
2469
2470=item PERL_SH_DIR too long
2471
2472(F) An error peculiar to OS/2. PERL_SH_DIR is the directory to find the
2473C<sh>-shell in. See L<perlos2/"PERL_SH_DIR">.
2474
2475=item Process terminated by SIG%s
2476
2477(W) This is a standard message issued by OS/2 applications, while *nix
2478applications die in silence. It is considered a feature of the OS/2
2479port. One can easily disable this by appropriate sighandlers, see
2480L<perlipc/"Signals">. See L<perlos2/"Process terminated by SIGTERM/SIGINT">.
2481
a0d0e21e
LW
2482=back
2483