checkAUTHORS.pl once more
[perl.git] / util.c
1 /*    util.c
2  *
3  *    Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999,
4  *    2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, by Larry Wall and others
5  *
6  *    You may distribute under the terms of either the GNU General Public
7  *    License or the Artistic License, as specified in the README file.
8  *
9  */
10
11 /*
12  * "Very useful, no doubt, that was to Saruman; yet it seems that he was
13  * not content."  --Gandalf
14  */
15
16 /* This file contains assorted utility routines.
17  * Which is a polite way of saying any stuff that people couldn't think of
18  * a better place for. Amongst other things, it includes the warning and
19  * dieing stuff, plus wrappers for malloc code.
20  */
21
22 #include "EXTERN.h"
23 #define PERL_IN_UTIL_C
24 #include "perl.h"
25
26 #ifndef PERL_MICRO
27 #include <signal.h>
28 #ifndef SIG_ERR
29 # define SIG_ERR ((Sighandler_t) -1)
30 #endif
31 #endif
32
33 #ifdef __Lynx__
34 /* Missing protos on LynxOS */
35 int putenv(char *);
36 #endif
37
38 #ifdef I_SYS_WAIT
39 #  include <sys/wait.h>
40 #endif
41
42 #ifdef HAS_SELECT
43 # ifdef I_SYS_SELECT
44 #  include <sys/select.h>
45 # endif
46 #endif
47
48 #define FLUSH
49
50 #if defined(HAS_FCNTL) && defined(F_SETFD) && !defined(FD_CLOEXEC)
51 #  define FD_CLOEXEC 1                  /* NeXT needs this */
52 #endif
53
54 /* NOTE:  Do not call the next three routines directly.  Use the macros
55  * in handy.h, so that we can easily redefine everything to do tracking of
56  * allocated hunks back to the original New to track down any memory leaks.
57  * XXX This advice seems to be widely ignored :-(   --AD  August 1996.
58  */
59
60 static char *
61 S_write_no_mem(pTHX)
62 {
63     dVAR;
64     /* Can't use PerlIO to write as it allocates memory */
65     PerlLIO_write(PerlIO_fileno(Perl_error_log),
66                   PL_no_mem, strlen(PL_no_mem));
67     my_exit(1);
68     NORETURN_FUNCTION_END;
69 }
70
71 /* paranoid version of system's malloc() */
72
73 Malloc_t
74 Perl_safesysmalloc(MEM_SIZE size)
75 {
76     dTHX;
77     Malloc_t ptr;
78 #ifdef HAS_64K_LIMIT
79         if (size > 0xffff) {
80             PerlIO_printf(Perl_error_log,
81                           "Allocation too large: %lx\n", size) FLUSH;
82             my_exit(1);
83         }
84 #endif /* HAS_64K_LIMIT */
85 #ifdef PERL_TRACK_MEMPOOL
86     size += sTHX;
87 #endif
88 #ifdef DEBUGGING
89     if ((long)size < 0)
90         Perl_croak_nocontext("panic: malloc");
91 #endif
92     ptr = (Malloc_t)PerlMem_malloc(size?size:1);        /* malloc(0) is NASTY on our system */
93     PERL_ALLOC_CHECK(ptr);
94     DEBUG_m(PerlIO_printf(Perl_debug_log, "0x%"UVxf": (%05ld) malloc %ld bytes\n",PTR2UV(ptr),(long)PL_an++,(long)size));
95     if (ptr != NULL) {
96 #ifdef PERL_TRACK_MEMPOOL
97         struct perl_memory_debug_header *const header
98             = (struct perl_memory_debug_header *)ptr;
99 #endif
100
101 #ifdef PERL_POISON
102         PoisonNew(((char *)ptr), size, char);
103 #endif
104
105 #ifdef PERL_TRACK_MEMPOOL
106         header->interpreter = aTHX;
107         /* Link us into the list.  */
108         header->prev = &PL_memory_debug_header;
109         header->next = PL_memory_debug_header.next;
110         PL_memory_debug_header.next = header;
111         header->next->prev = header;
112 #  ifdef PERL_POISON
113         header->size = size;
114 #  endif
115         ptr = (Malloc_t)((char*)ptr+sTHX);
116 #endif
117         return ptr;
118 }
119     else if (PL_nomemok)
120         return NULL;
121     else {
122         return write_no_mem();
123     }
124     /*NOTREACHED*/
125 }
126
127 /* paranoid version of system's realloc() */
128
129 Malloc_t
130 Perl_safesysrealloc(Malloc_t where,MEM_SIZE size)
131 {
132     dTHX;
133     Malloc_t ptr;
134 #if !defined(STANDARD_C) && !defined(HAS_REALLOC_PROTOTYPE) && !defined(PERL_MICRO)
135     Malloc_t PerlMem_realloc();
136 #endif /* !defined(STANDARD_C) && !defined(HAS_REALLOC_PROTOTYPE) */
137
138 #ifdef HAS_64K_LIMIT
139     if (size > 0xffff) {
140         PerlIO_printf(Perl_error_log,
141                       "Reallocation too large: %lx\n", size) FLUSH;
142         my_exit(1);
143     }
144 #endif /* HAS_64K_LIMIT */
145     if (!size) {
146         safesysfree(where);
147         return NULL;
148     }
149
150     if (!where)
151         return safesysmalloc(size);
152 #ifdef PERL_TRACK_MEMPOOL
153     where = (Malloc_t)((char*)where-sTHX);
154     size += sTHX;
155     {
156         struct perl_memory_debug_header *const header
157             = (struct perl_memory_debug_header *)where;
158
159         if (header->interpreter != aTHX) {
160             Perl_croak_nocontext("panic: realloc from wrong pool");
161         }
162         assert(header->next->prev == header);
163         assert(header->prev->next == header);
164 #  ifdef PERL_POISON
165         if (header->size > size) {
166             const MEM_SIZE freed_up = header->size - size;
167             char *start_of_freed = ((char *)where) + size;
168             PoisonFree(start_of_freed, freed_up, char);
169         }
170         header->size = size;
171 #  endif
172     }
173 #endif
174 #ifdef DEBUGGING
175     if ((long)size < 0)
176         Perl_croak_nocontext("panic: realloc");
177 #endif
178     ptr = (Malloc_t)PerlMem_realloc(where,size);
179     PERL_ALLOC_CHECK(ptr);
180
181     DEBUG_m(PerlIO_printf(Perl_debug_log, "0x%"UVxf": (%05ld) rfree\n",PTR2UV(where),(long)PL_an++));
182     DEBUG_m(PerlIO_printf(Perl_debug_log, "0x%"UVxf": (%05ld) realloc %ld bytes\n",PTR2UV(ptr),(long)PL_an++,(long)size));
183
184     if (ptr != NULL) {
185 #ifdef PERL_TRACK_MEMPOOL
186         struct perl_memory_debug_header *const header
187             = (struct perl_memory_debug_header *)ptr;
188
189 #  ifdef PERL_POISON
190         if (header->size < size) {
191             const MEM_SIZE fresh = size - header->size;
192             char *start_of_fresh = ((char *)ptr) + size;
193             PoisonNew(start_of_fresh, fresh, char);
194         }
195 #  endif
196
197         header->next->prev = header;
198         header->prev->next = header;
199
200         ptr = (Malloc_t)((char*)ptr+sTHX);
201 #endif
202         return ptr;
203     }
204     else if (PL_nomemok)
205         return NULL;
206     else {
207         return write_no_mem();
208     }
209     /*NOTREACHED*/
210 }
211
212 /* safe version of system's free() */
213
214 Free_t
215 Perl_safesysfree(Malloc_t where)
216 {
217 #if defined(PERL_IMPLICIT_SYS) || defined(PERL_TRACK_MEMPOOL)
218     dTHX;
219 #else
220     dVAR;
221 #endif
222     DEBUG_m( PerlIO_printf(Perl_debug_log, "0x%"UVxf": (%05ld) free\n",PTR2UV(where),(long)PL_an++));
223     if (where) {
224 #ifdef PERL_TRACK_MEMPOOL
225         where = (Malloc_t)((char*)where-sTHX);
226         {
227             struct perl_memory_debug_header *const header
228                 = (struct perl_memory_debug_header *)where;
229
230             if (header->interpreter != aTHX) {
231                 Perl_croak_nocontext("panic: free from wrong pool");
232             }
233             if (!header->prev) {
234                 Perl_croak_nocontext("panic: duplicate free");
235             }
236             if (!(header->next) || header->next->prev != header
237                 || header->prev->next != header) {
238                 Perl_croak_nocontext("panic: bad free");
239             }
240             /* Unlink us from the chain.  */
241             header->next->prev = header->prev;
242             header->prev->next = header->next;
243 #  ifdef PERL_POISON
244             PoisonNew(where, header->size, char);
245 #  endif
246             /* Trigger the duplicate free warning.  */
247             header->next = NULL;
248         }
249 #endif
250         PerlMem_free(where);
251     }
252 }
253
254 /* safe version of system's calloc() */
255
256 Malloc_t
257 Perl_safesyscalloc(MEM_SIZE count, MEM_SIZE size)
258 {
259     dTHX;
260     Malloc_t ptr;
261     MEM_SIZE total_size = 0;
262
263     /* Even though calloc() for zero bytes is strange, be robust. */
264     if (size && (count <= MEM_SIZE_MAX / size))
265         total_size = size * count;
266     else
267         Perl_croak_nocontext(PL_memory_wrap);
268 #ifdef PERL_TRACK_MEMPOOL
269     if (sTHX <= MEM_SIZE_MAX - (MEM_SIZE)total_size)
270         total_size += sTHX;
271     else
272         Perl_croak_nocontext(PL_memory_wrap);
273 #endif
274 #ifdef HAS_64K_LIMIT
275     if (total_size > 0xffff) {
276         PerlIO_printf(Perl_error_log,
277                       "Allocation too large: %lx\n", total_size) FLUSH;
278         my_exit(1);
279     }
280 #endif /* HAS_64K_LIMIT */
281 #ifdef DEBUGGING
282     if ((long)size < 0 || (long)count < 0)
283         Perl_croak_nocontext("panic: calloc");
284 #endif
285 #ifdef PERL_TRACK_MEMPOOL
286     /* Have to use malloc() because we've added some space for our tracking
287        header.  */
288     /* malloc(0) is non-portable. */
289     ptr = (Malloc_t)PerlMem_malloc(total_size ? total_size : 1);
290 #else
291     /* Use calloc() because it might save a memset() if the memory is fresh
292        and clean from the OS.  */
293     if (count && size)
294         ptr = (Malloc_t)PerlMem_calloc(count, size);
295     else /* calloc(0) is non-portable. */
296         ptr = (Malloc_t)PerlMem_calloc(count ? count : 1, size ? size : 1);
297 #endif
298     PERL_ALLOC_CHECK(ptr);
299     DEBUG_m(PerlIO_printf(Perl_debug_log, "0x%"UVxf": (%05ld) calloc %ld x %ld bytes\n",PTR2UV(ptr),(long)PL_an++,(long)count,(long)total_size));
300     if (ptr != NULL) {
301 #ifdef PERL_TRACK_MEMPOOL
302         {
303             struct perl_memory_debug_header *const header
304                 = (struct perl_memory_debug_header *)ptr;
305
306             memset((void*)ptr, 0, total_size);
307             header->interpreter = aTHX;
308             /* Link us into the list.  */
309             header->prev = &PL_memory_debug_header;
310             header->next = PL_memory_debug_header.next;
311             PL_memory_debug_header.next = header;
312             header->next->prev = header;
313 #  ifdef PERL_POISON
314             header->size = total_size;
315 #  endif
316             ptr = (Malloc_t)((char*)ptr+sTHX);
317         }
318 #endif
319         return ptr;
320     }
321     else if (PL_nomemok)
322         return NULL;
323     return write_no_mem();
324 }
325
326 /* These must be defined when not using Perl's malloc for binary
327  * compatibility */
328
329 #ifndef MYMALLOC
330
331 Malloc_t Perl_malloc (MEM_SIZE nbytes)
332 {
333     dTHXs;
334     return (Malloc_t)PerlMem_malloc(nbytes);
335 }
336
337 Malloc_t Perl_calloc (MEM_SIZE elements, MEM_SIZE size)
338 {
339     dTHXs;
340     return (Malloc_t)PerlMem_calloc(elements, size);
341 }
342
343 Malloc_t Perl_realloc (Malloc_t where, MEM_SIZE nbytes)
344 {
345     dTHXs;
346     return (Malloc_t)PerlMem_realloc(where, nbytes);
347 }
348
349 Free_t   Perl_mfree (Malloc_t where)
350 {
351     dTHXs;
352     PerlMem_free(where);
353 }
354
355 #endif
356
357 /* copy a string up to some (non-backslashed) delimiter, if any */
358
359 char *
360 Perl_delimcpy(pTHX_ register char *to, register const char *toend, register const char *from, register const char *fromend, register int delim, I32 *retlen)
361 {
362     register I32 tolen;
363     PERL_UNUSED_CONTEXT;
364
365     for (tolen = 0; from < fromend; from++, tolen++) {
366         if (*from == '\\') {
367             if (from[1] != delim) {
368                 if (to < toend)
369                     *to++ = *from;
370                 tolen++;
371             }
372             from++;
373         }
374         else if (*from == delim)
375             break;
376         if (to < toend)
377             *to++ = *from;
378     }
379     if (to < toend)
380         *to = '\0';
381     *retlen = tolen;
382     return (char *)from;
383 }
384
385 /* return ptr to little string in big string, NULL if not found */
386 /* This routine was donated by Corey Satten. */
387
388 char *
389 Perl_instr(pTHX_ register const char *big, register const char *little)
390 {
391     register I32 first;
392     PERL_UNUSED_CONTEXT;
393
394     if (!little)
395         return (char*)big;
396     first = *little++;
397     if (!first)
398         return (char*)big;
399     while (*big) {
400         register const char *s, *x;
401         if (*big++ != first)
402             continue;
403         for (x=big,s=little; *s; /**/ ) {
404             if (!*x)
405                 return NULL;
406             if (*s != *x)
407                 break;
408             else {
409                 s++;
410                 x++;
411             }
412         }
413         if (!*s)
414             return (char*)(big-1);
415     }
416     return NULL;
417 }
418
419 /* same as instr but allow embedded nulls */
420
421 char *
422 Perl_ninstr(pTHX_ const char *big, const char *bigend, const char *little, const char *lend)
423 {
424     PERL_UNUSED_CONTEXT;
425     if (little >= lend)
426         return (char*)big;
427     {
428         char first = *little++;
429         const char *s, *x;
430         bigend -= lend - little;
431     OUTER:
432         while (big <= bigend) {
433             if (*big++ == first) {
434                 for (x=big,s=little; s < lend; x++,s++) {
435                     if (*s != *x)
436                         goto OUTER;
437                 }
438                 return (char*)(big-1);
439             }
440         }
441     }
442     return NULL;
443 }
444
445 /* reverse of the above--find last substring */
446
447 char *
448 Perl_rninstr(pTHX_ register const char *big, const char *bigend, const char *little, const char *lend)
449 {
450     register const char *bigbeg;
451     register const I32 first = *little;
452     register const char * const littleend = lend;
453     PERL_UNUSED_CONTEXT;
454
455     if (little >= littleend)
456         return (char*)bigend;
457     bigbeg = big;
458     big = bigend - (littleend - little++);
459     while (big >= bigbeg) {
460         register const char *s, *x;
461         if (*big-- != first)
462             continue;
463         for (x=big+2,s=little; s < littleend; /**/ ) {
464             if (*s != *x)
465                 break;
466             else {
467                 x++;
468                 s++;
469             }
470         }
471         if (s >= littleend)
472             return (char*)(big+1);
473     }
474     return NULL;
475 }
476
477 /* As a space optimization, we do not compile tables for strings of length
478    0 and 1, and for strings of length 2 unless FBMcf_TAIL.  These are
479    special-cased in fbm_instr().
480
481    If FBMcf_TAIL, the table is created as if the string has a trailing \n. */
482
483 /*
484 =head1 Miscellaneous Functions
485
486 =for apidoc fbm_compile
487
488 Analyses the string in order to make fast searches on it using fbm_instr()
489 -- the Boyer-Moore algorithm.
490
491 =cut
492 */
493
494 void
495 Perl_fbm_compile(pTHX_ SV *sv, U32 flags)
496 {
497     dVAR;
498     register const U8 *s;
499     register U32 i;
500     STRLEN len;
501     U32 rarest = 0;
502     U32 frequency = 256;
503
504     if (flags & FBMcf_TAIL) {
505         MAGIC * const mg = SvUTF8(sv) && SvMAGICAL(sv) ? mg_find(sv, PERL_MAGIC_utf8) : NULL;
506         sv_catpvs(sv, "\n");            /* Taken into account in fbm_instr() */
507         if (mg && mg->mg_len >= 0)
508             mg->mg_len++;
509     }
510     s = (U8*)SvPV_force_mutable(sv, len);
511     if (len == 0)               /* TAIL might be on a zero-length string. */
512         return;
513     SvUPGRADE(sv, SVt_PVGV);
514     SvIOK_off(sv);
515     SvNOK_off(sv);
516     SvVALID_on(sv);
517     if (len > 2) {
518         const unsigned char *sb;
519         const U8 mlen = (len>255) ? 255 : (U8)len;
520         register U8 *table;
521
522         Sv_Grow(sv, len + 256 + PERL_FBM_TABLE_OFFSET);
523         table
524             = (unsigned char*)(SvPVX_mutable(sv) + len + PERL_FBM_TABLE_OFFSET);
525         s = table - 1 - PERL_FBM_TABLE_OFFSET;  /* last char */
526         memset((void*)table, mlen, 256);
527         i = 0;
528         sb = s - mlen + 1;                      /* first char (maybe) */
529         while (s >= sb) {
530             if (table[*s] == mlen)
531                 table[*s] = (U8)i;
532             s--, i++;
533         }
534     } else {
535         Sv_Grow(sv, len + PERL_FBM_TABLE_OFFSET);
536     }
537     sv_magic(sv, NULL, PERL_MAGIC_bm, NULL, 0); /* deep magic */
538
539     s = (const unsigned char*)(SvPVX_const(sv));        /* deeper magic */
540     for (i = 0; i < len; i++) {
541         if (PL_freq[s[i]] < frequency) {
542             rarest = i;
543             frequency = PL_freq[s[i]];
544         }
545     }
546     BmFLAGS(sv) = (U8)flags;
547     BmRARE(sv) = s[rarest];
548     BmPREVIOUS(sv) = rarest;
549     BmUSEFUL(sv) = 100;                 /* Initial value */
550     if (flags & FBMcf_TAIL)
551         SvTAIL_on(sv);
552     DEBUG_r(PerlIO_printf(Perl_debug_log, "rarest char %c at %lu\n",
553                           BmRARE(sv),(unsigned long)BmPREVIOUS(sv)));
554 }
555
556 /* If SvTAIL(littlestr), it has a fake '\n' at end. */
557 /* If SvTAIL is actually due to \Z or \z, this gives false positives
558    if multiline */
559
560 /*
561 =for apidoc fbm_instr
562
563 Returns the location of the SV in the string delimited by C<str> and
564 C<strend>.  It returns C<NULL> if the string can't be found.  The C<sv>
565 does not have to be fbm_compiled, but the search will not be as fast
566 then.
567
568 =cut
569 */
570
571 char *
572 Perl_fbm_instr(pTHX_ unsigned char *big, register unsigned char *bigend, SV *littlestr, U32 flags)
573 {
574     register unsigned char *s;
575     STRLEN l;
576     register const unsigned char *little
577         = (const unsigned char *)SvPV_const(littlestr,l);
578     register STRLEN littlelen = l;
579     register const I32 multiline = flags & FBMrf_MULTILINE;
580
581     if ((STRLEN)(bigend - big) < littlelen) {
582         if ( SvTAIL(littlestr)
583              && ((STRLEN)(bigend - big) == littlelen - 1)
584              && (littlelen == 1
585                  || (*big == *little &&
586                      memEQ((char *)big, (char *)little, littlelen - 1))))
587             return (char*)big;
588         return NULL;
589     }
590
591     if (littlelen <= 2) {               /* Special-cased */
592
593         if (littlelen == 1) {
594             if (SvTAIL(littlestr) && !multiline) { /* Anchor only! */
595                 /* Know that bigend != big.  */
596                 if (bigend[-1] == '\n')
597                     return (char *)(bigend - 1);
598                 return (char *) bigend;
599             }
600             s = big;
601             while (s < bigend) {
602                 if (*s == *little)
603                     return (char *)s;
604                 s++;
605             }
606             if (SvTAIL(littlestr))
607                 return (char *) bigend;
608             return NULL;
609         }
610         if (!littlelen)
611             return (char*)big;          /* Cannot be SvTAIL! */
612
613         /* littlelen is 2 */
614         if (SvTAIL(littlestr) && !multiline) {
615             if (bigend[-1] == '\n' && bigend[-2] == *little)
616                 return (char*)bigend - 2;
617             if (bigend[-1] == *little)
618                 return (char*)bigend - 1;
619             return NULL;
620         }
621         {
622             /* This should be better than FBM if c1 == c2, and almost
623                as good otherwise: maybe better since we do less indirection.
624                And we save a lot of memory by caching no table. */
625             const unsigned char c1 = little[0];
626             const unsigned char c2 = little[1];
627
628             s = big + 1;
629             bigend--;
630             if (c1 != c2) {
631                 while (s <= bigend) {
632                     if (s[0] == c2) {
633                         if (s[-1] == c1)
634                             return (char*)s - 1;
635                         s += 2;
636                         continue;
637                     }
638                   next_chars:
639                     if (s[0] == c1) {
640                         if (s == bigend)
641                             goto check_1char_anchor;
642                         if (s[1] == c2)
643                             return (char*)s;
644                         else {
645                             s++;
646                             goto next_chars;
647                         }
648                     }
649                     else
650                         s += 2;
651                 }
652                 goto check_1char_anchor;
653             }
654             /* Now c1 == c2 */
655             while (s <= bigend) {
656                 if (s[0] == c1) {
657                     if (s[-1] == c1)
658                         return (char*)s - 1;
659                     if (s == bigend)
660                         goto check_1char_anchor;
661                     if (s[1] == c1)
662                         return (char*)s;
663                     s += 3;
664                 }
665                 else
666                     s += 2;
667             }
668         }
669       check_1char_anchor:               /* One char and anchor! */
670         if (SvTAIL(littlestr) && (*bigend == *little))
671             return (char *)bigend;      /* bigend is already decremented. */
672         return NULL;
673     }
674     if (SvTAIL(littlestr) && !multiline) {      /* tail anchored? */
675         s = bigend - littlelen;
676         if (s >= big && bigend[-1] == '\n' && *s == *little
677             /* Automatically of length > 2 */
678             && memEQ((char*)s + 1, (char*)little + 1, littlelen - 2))
679         {
680             return (char*)s;            /* how sweet it is */
681         }
682         if (s[1] == *little
683             && memEQ((char*)s + 2, (char*)little + 1, littlelen - 2))
684         {
685             return (char*)s + 1;        /* how sweet it is */
686         }
687         return NULL;
688     }
689     if (!SvVALID(littlestr)) {
690         char * const b = ninstr((char*)big,(char*)bigend,
691                          (char*)little, (char*)little + littlelen);
692
693         if (!b && SvTAIL(littlestr)) {  /* Automatically multiline!  */
694             /* Chop \n from littlestr: */
695             s = bigend - littlelen + 1;
696             if (*s == *little
697                 && memEQ((char*)s + 1, (char*)little + 1, littlelen - 2))
698             {
699                 return (char*)s;
700             }
701             return NULL;
702         }
703         return b;
704     }
705
706     /* Do actual FBM.  */
707     if (littlelen > (STRLEN)(bigend - big))
708         return NULL;
709
710     {
711         register const unsigned char * const table
712             = little + littlelen + PERL_FBM_TABLE_OFFSET;
713         register const unsigned char *oldlittle;
714
715         --littlelen;                    /* Last char found by table lookup */
716
717         s = big + littlelen;
718         little += littlelen;            /* last char */
719         oldlittle = little;
720         if (s < bigend) {
721             register I32 tmp;
722
723           top2:
724             if ((tmp = table[*s])) {
725                 if ((s += tmp) < bigend)
726                     goto top2;
727                 goto check_end;
728             }
729             else {              /* less expensive than calling strncmp() */
730                 register unsigned char * const olds = s;
731
732                 tmp = littlelen;
733
734                 while (tmp--) {
735                     if (*--s == *--little)
736                         continue;
737                     s = olds + 1;       /* here we pay the price for failure */
738                     little = oldlittle;
739                     if (s < bigend)     /* fake up continue to outer loop */
740                         goto top2;
741                     goto check_end;
742                 }
743                 return (char *)s;
744             }
745         }
746       check_end:
747         if ( s == bigend
748              && (BmFLAGS(littlestr) & FBMcf_TAIL)
749              && memEQ((char *)(bigend - littlelen),
750                       (char *)(oldlittle - littlelen), littlelen) )
751             return (char*)bigend - littlelen;
752         return NULL;
753     }
754 }
755
756 /* start_shift, end_shift are positive quantities which give offsets
757    of ends of some substring of bigstr.
758    If "last" we want the last occurrence.
759    old_posp is the way of communication between consequent calls if
760    the next call needs to find the .
761    The initial *old_posp should be -1.
762
763    Note that we take into account SvTAIL, so one can get extra
764    optimizations if _ALL flag is set.
765  */
766
767 /* If SvTAIL is actually due to \Z or \z, this gives false positives
768    if PL_multiline.  In fact if !PL_multiline the authoritative answer
769    is not supported yet. */
770
771 char *
772 Perl_screaminstr(pTHX_ SV *bigstr, SV *littlestr, I32 start_shift, I32 end_shift, I32 *old_posp, I32 last)
773 {
774     dVAR;
775     register const unsigned char *big;
776     register I32 pos;
777     register I32 previous;
778     register I32 first;
779     register const unsigned char *little;
780     register I32 stop_pos;
781     register const unsigned char *littleend;
782     I32 found = 0;
783
784     assert(SvTYPE(littlestr) == SVt_PVGV);
785     assert(SvVALID(littlestr));
786
787     if (*old_posp == -1
788         ? (pos = PL_screamfirst[BmRARE(littlestr)]) < 0
789         : (((pos = *old_posp), pos += PL_screamnext[pos]) == 0)) {
790       cant_find:
791         if ( BmRARE(littlestr) == '\n'
792              && BmPREVIOUS(littlestr) == SvCUR(littlestr) - 1) {
793             little = (const unsigned char *)(SvPVX_const(littlestr));
794             littleend = little + SvCUR(littlestr);
795             first = *little++;
796             goto check_tail;
797         }
798         return NULL;
799     }
800
801     little = (const unsigned char *)(SvPVX_const(littlestr));
802     littleend = little + SvCUR(littlestr);
803     first = *little++;
804     /* The value of pos we can start at: */
805     previous = BmPREVIOUS(littlestr);
806     big = (const unsigned char *)(SvPVX_const(bigstr));
807     /* The value of pos we can stop at: */
808     stop_pos = SvCUR(bigstr) - end_shift - (SvCUR(littlestr) - 1 - previous);
809     if (previous + start_shift > stop_pos) {
810 /*
811   stop_pos does not include SvTAIL in the count, so this check is incorrect
812   (I think) - see [ID 20010618.006] and t/op/study.t. HVDS 2001/06/19
813 */
814 #if 0
815         if (previous + start_shift == stop_pos + 1) /* A fake '\n'? */
816             goto check_tail;
817 #endif
818         return NULL;
819     }
820     while (pos < previous + start_shift) {
821         if (!(pos += PL_screamnext[pos]))
822             goto cant_find;
823     }
824     big -= previous;
825     do {
826         register const unsigned char *s, *x;
827         if (pos >= stop_pos) break;
828         if (big[pos] != first)
829             continue;
830         for (x=big+pos+1,s=little; s < littleend; /**/ ) {
831             if (*s++ != *x++) {
832                 s--;
833                 break;
834             }
835         }
836         if (s == littleend) {
837             *old_posp = pos;
838             if (!last) return (char *)(big+pos);
839             found = 1;
840         }
841     } while ( pos += PL_screamnext[pos] );
842     if (last && found)
843         return (char *)(big+(*old_posp));
844   check_tail:
845     if (!SvTAIL(littlestr) || (end_shift > 0))
846         return NULL;
847     /* Ignore the trailing "\n".  This code is not microoptimized */
848     big = (const unsigned char *)(SvPVX_const(bigstr) + SvCUR(bigstr));
849     stop_pos = littleend - little;      /* Actual littlestr len */
850     if (stop_pos == 0)
851         return (char*)big;
852     big -= stop_pos;
853     if (*big == first
854         && ((stop_pos == 1) ||
855             memEQ((char *)(big + 1), (char *)little, stop_pos - 1)))
856         return (char*)big;
857     return NULL;
858 }
859
860 I32
861 Perl_ibcmp(pTHX_ const char *s1, const char *s2, register I32 len)
862 {
863     register const U8 *a = (const U8 *)s1;
864     register const U8 *b = (const U8 *)s2;
865     PERL_UNUSED_CONTEXT;
866
867     while (len--) {
868         if (*a != *b && *a != PL_fold[*b])
869             return 1;
870         a++,b++;
871     }
872     return 0;
873 }
874
875 I32
876 Perl_ibcmp_locale(pTHX_ const char *s1, const char *s2, register I32 len)
877 {
878     dVAR;
879     register const U8 *a = (const U8 *)s1;
880     register const U8 *b = (const U8 *)s2;
881     PERL_UNUSED_CONTEXT;
882
883     while (len--) {
884         if (*a != *b && *a != PL_fold_locale[*b])
885             return 1;
886         a++,b++;
887     }
888     return 0;
889 }
890
891 /* copy a string to a safe spot */
892
893 /*
894 =head1 Memory Management
895
896 =for apidoc savepv
897
898 Perl's version of C<strdup()>. Returns a pointer to a newly allocated
899 string which is a duplicate of C<pv>. The size of the string is
900 determined by C<strlen()>. The memory allocated for the new string can
901 be freed with the C<Safefree()> function.
902
903 =cut
904 */
905
906 char *
907 Perl_savepv(pTHX_ const char *pv)
908 {
909     PERL_UNUSED_CONTEXT;
910     if (!pv)
911         return NULL;
912     else {
913         char *newaddr;
914         const STRLEN pvlen = strlen(pv)+1;
915         Newx(newaddr, pvlen, char);
916         return (char*)memcpy(newaddr, pv, pvlen);
917     }
918 }
919
920 /* same thing but with a known length */
921
922 /*
923 =for apidoc savepvn
924
925 Perl's version of what C<strndup()> would be if it existed. Returns a
926 pointer to a newly allocated string which is a duplicate of the first
927 C<len> bytes from C<pv>, plus a trailing NUL byte. The memory allocated for
928 the new string can be freed with the C<Safefree()> function.
929
930 =cut
931 */
932
933 char *
934 Perl_savepvn(pTHX_ const char *pv, register I32 len)
935 {
936     register char *newaddr;
937     PERL_UNUSED_CONTEXT;
938
939     Newx(newaddr,len+1,char);
940     /* Give a meaning to NULL pointer mainly for the use in sv_magic() */
941     if (pv) {
942         /* might not be null terminated */
943         newaddr[len] = '\0';
944         return (char *) CopyD(pv,newaddr,len,char);
945     }
946     else {
947         return (char *) ZeroD(newaddr,len+1,char);
948     }
949 }
950
951 /*
952 =for apidoc savesharedpv
953
954 A version of C<savepv()> which allocates the duplicate string in memory
955 which is shared between threads.
956
957 =cut
958 */
959 char *
960 Perl_savesharedpv(pTHX_ const char *pv)
961 {
962     register char *newaddr;
963     STRLEN pvlen;
964     if (!pv)
965         return NULL;
966
967     pvlen = strlen(pv)+1;
968     newaddr = (char*)PerlMemShared_malloc(pvlen);
969     if (!newaddr) {
970         return write_no_mem();
971     }
972     return (char*)memcpy(newaddr, pv, pvlen);
973 }
974
975 /*
976 =for apidoc savesharedpvn
977
978 A version of C<savepvn()> which allocates the duplicate string in memory
979 which is shared between threads. (With the specific difference that a NULL
980 pointer is not acceptable)
981
982 =cut
983 */
984 char *
985 Perl_savesharedpvn(pTHX_ const char *const pv, const STRLEN len)
986 {
987     char *const newaddr = (char*)PerlMemShared_malloc(len + 1);
988     assert(pv);
989     if (!newaddr) {
990         return write_no_mem();
991     }
992     newaddr[len] = '\0';
993     return (char*)memcpy(newaddr, pv, len);
994 }
995
996 /*
997 =for apidoc savesvpv
998
999 A version of C<savepv()>/C<savepvn()> which gets the string to duplicate from
1000 the passed in SV using C<SvPV()>
1001
1002 =cut
1003 */
1004
1005 char *
1006 Perl_savesvpv(pTHX_ SV *sv)
1007 {
1008     STRLEN len;
1009     const char * const pv = SvPV_const(sv, len);
1010     register char *newaddr;
1011
1012     ++len;
1013     Newx(newaddr,len,char);
1014     return (char *) CopyD(pv,newaddr,len,char);
1015 }
1016
1017
1018 /* the SV for Perl_form() and mess() is not kept in an arena */
1019
1020 STATIC SV *
1021 S_mess_alloc(pTHX)
1022 {
1023     dVAR;
1024     SV *sv;
1025     XPVMG *any;
1026
1027     if (!PL_dirty)
1028         return sv_2mortal(newSVpvs(""));
1029
1030     if (PL_mess_sv)
1031         return PL_mess_sv;
1032
1033     /* Create as PVMG now, to avoid any upgrading later */
1034     Newx(sv, 1, SV);
1035     Newxz(any, 1, XPVMG);
1036     SvFLAGS(sv) = SVt_PVMG;
1037     SvANY(sv) = (void*)any;
1038     SvPV_set(sv, NULL);
1039     SvREFCNT(sv) = 1 << 30; /* practically infinite */
1040     PL_mess_sv = sv;
1041     return sv;
1042 }
1043
1044 #if defined(PERL_IMPLICIT_CONTEXT)
1045 char *
1046 Perl_form_nocontext(const char* pat, ...)
1047 {
1048     dTHX;
1049     char *retval;
1050     va_list args;
1051     va_start(args, pat);
1052     retval = vform(pat, &args);
1053     va_end(args);
1054     return retval;
1055 }
1056 #endif /* PERL_IMPLICIT_CONTEXT */
1057
1058 /*
1059 =head1 Miscellaneous Functions
1060 =for apidoc form
1061
1062 Takes a sprintf-style format pattern and conventional
1063 (non-SV) arguments and returns the formatted string.
1064
1065     (char *) Perl_form(pTHX_ const char* pat, ...)
1066
1067 can be used any place a string (char *) is required:
1068
1069     char * s = Perl_form("%d.%d",major,minor);
1070
1071 Uses a single private buffer so if you want to format several strings you
1072 must explicitly copy the earlier strings away (and free the copies when you
1073 are done).
1074
1075 =cut
1076 */
1077
1078 char *
1079 Perl_form(pTHX_ const char* pat, ...)
1080 {
1081     char *retval;
1082     va_list args;
1083     va_start(args, pat);
1084     retval = vform(pat, &args);
1085     va_end(args);
1086     return retval;
1087 }
1088
1089 char *
1090 Perl_vform(pTHX_ const char *pat, va_list *args)
1091 {
1092     SV * const sv = mess_alloc();
1093     sv_vsetpvfn(sv, pat, strlen(pat), args, NULL, 0, NULL);
1094     return SvPVX(sv);
1095 }
1096
1097 #if defined(PERL_IMPLICIT_CONTEXT)
1098 SV *
1099 Perl_mess_nocontext(const char *pat, ...)
1100 {
1101     dTHX;
1102     SV *retval;
1103     va_list args;
1104     va_start(args, pat);
1105     retval = vmess(pat, &args);
1106     va_end(args);
1107     return retval;
1108 }
1109 #endif /* PERL_IMPLICIT_CONTEXT */
1110
1111 SV *
1112 Perl_mess(pTHX_ const char *pat, ...)
1113 {
1114     SV *retval;
1115     va_list args;
1116     va_start(args, pat);
1117     retval = vmess(pat, &args);
1118     va_end(args);
1119     return retval;
1120 }
1121
1122 STATIC const COP*
1123 S_closest_cop(pTHX_ const COP *cop, const OP *o)
1124 {
1125     dVAR;
1126     /* Look for PL_op starting from o.  cop is the last COP we've seen. */
1127
1128     if (!o || o == PL_op)
1129         return cop;
1130
1131     if (o->op_flags & OPf_KIDS) {
1132         const OP *kid;
1133         for (kid = cUNOPo->op_first; kid; kid = kid->op_sibling) {
1134             const COP *new_cop;
1135
1136             /* If the OP_NEXTSTATE has been optimised away we can still use it
1137              * the get the file and line number. */
1138
1139             if (kid->op_type == OP_NULL && kid->op_targ == OP_NEXTSTATE)
1140                 cop = (const COP *)kid;
1141
1142             /* Keep searching, and return when we've found something. */
1143
1144             new_cop = closest_cop(cop, kid);
1145             if (new_cop)
1146                 return new_cop;
1147         }
1148     }
1149
1150     /* Nothing found. */
1151
1152     return NULL;
1153 }
1154
1155 SV *
1156 Perl_vmess(pTHX_ const char *pat, va_list *args)
1157 {
1158     dVAR;
1159     SV * const sv = mess_alloc();
1160
1161     sv_vsetpvfn(sv, pat, strlen(pat), args, NULL, 0, NULL);
1162     if (!SvCUR(sv) || *(SvEND(sv) - 1) != '\n') {
1163         /*
1164          * Try and find the file and line for PL_op.  This will usually be
1165          * PL_curcop, but it might be a cop that has been optimised away.  We
1166          * can try to find such a cop by searching through the optree starting
1167          * from the sibling of PL_curcop.
1168          */
1169
1170         const COP *cop = closest_cop(PL_curcop, PL_curcop->op_sibling);
1171         if (!cop)
1172             cop = PL_curcop;
1173
1174         if (CopLINE(cop))
1175             Perl_sv_catpvf(aTHX_ sv, " at %s line %"IVdf,
1176             OutCopFILE(cop), (IV)CopLINE(cop));
1177         /* Seems that GvIO() can be untrustworthy during global destruction. */
1178         if (GvIO(PL_last_in_gv) && (SvTYPE(GvIOp(PL_last_in_gv)) == SVt_PVIO)
1179                 && IoLINES(GvIOp(PL_last_in_gv)))
1180         {
1181             const bool line_mode = (RsSIMPLE(PL_rs) &&
1182                               SvCUR(PL_rs) == 1 && *SvPVX_const(PL_rs) == '\n');
1183             Perl_sv_catpvf(aTHX_ sv, ", <%s> %s %"IVdf,
1184                            PL_last_in_gv == PL_argvgv ? "" : GvNAME(PL_last_in_gv),
1185                            line_mode ? "line" : "chunk",
1186                            (IV)IoLINES(GvIOp(PL_last_in_gv)));
1187         }
1188         if (PL_dirty)
1189             sv_catpvs(sv, " during global destruction");
1190         sv_catpvs(sv, ".\n");
1191     }
1192     return sv;
1193 }
1194
1195 void
1196 Perl_write_to_stderr(pTHX_ const char* message, int msglen)
1197 {
1198     dVAR;
1199     IO *io;
1200     MAGIC *mg;
1201
1202     if (PL_stderrgv && SvREFCNT(PL_stderrgv) 
1203         && (io = GvIO(PL_stderrgv))
1204         && (mg = SvTIED_mg((SV*)io, PERL_MAGIC_tiedscalar))) 
1205     {
1206         dSP;
1207         ENTER;
1208         SAVETMPS;
1209
1210         save_re_context();
1211         SAVESPTR(PL_stderrgv);
1212         PL_stderrgv = NULL;
1213
1214         PUSHSTACKi(PERLSI_MAGIC);
1215
1216         PUSHMARK(SP);
1217         EXTEND(SP,2);
1218         PUSHs(SvTIED_obj((SV*)io, mg));
1219         PUSHs(sv_2mortal(newSVpvn(message, msglen)));
1220         PUTBACK;
1221         call_method("PRINT", G_SCALAR);
1222
1223         POPSTACK;
1224         FREETMPS;
1225         LEAVE;
1226     }
1227     else {
1228 #ifdef USE_SFIO
1229         /* SFIO can really mess with your errno */
1230         const int e = errno;
1231 #endif
1232         PerlIO * const serr = Perl_error_log;
1233
1234         PERL_WRITE_MSG_TO_CONSOLE(serr, message, msglen);
1235         (void)PerlIO_flush(serr);
1236 #ifdef USE_SFIO
1237         errno = e;
1238 #endif
1239     }
1240 }
1241
1242 /* Common code used by vcroak, vdie, vwarn and vwarner  */
1243
1244 STATIC bool
1245 S_vdie_common(pTHX_ const char *message, STRLEN msglen, I32 utf8, bool warn)
1246 {
1247     dVAR;
1248     HV *stash;
1249     GV *gv;
1250     CV *cv;
1251     SV **const hook = warn ? &PL_warnhook : &PL_diehook;
1252     /* sv_2cv might call Perl_croak() or Perl_warner() */
1253     SV * const oldhook = *hook;
1254
1255     assert(oldhook);
1256
1257     ENTER;
1258     SAVESPTR(*hook);
1259     *hook = NULL;
1260     cv = sv_2cv(oldhook, &stash, &gv, 0);
1261     LEAVE;
1262     if (cv && !CvDEPTH(cv) && (CvROOT(cv) || CvXSUB(cv))) {
1263         dSP;
1264         SV *msg;
1265
1266         ENTER;
1267         save_re_context();
1268         if (warn) {
1269             SAVESPTR(*hook);
1270             *hook = NULL;
1271         }
1272         if (warn || message) {
1273             msg = newSVpvn(message, msglen);
1274             SvFLAGS(msg) |= utf8;
1275             SvREADONLY_on(msg);
1276             SAVEFREESV(msg);
1277         }
1278         else {
1279             msg = ERRSV;
1280         }
1281
1282         PUSHSTACKi(warn ? PERLSI_WARNHOOK : PERLSI_DIEHOOK);
1283         PUSHMARK(SP);
1284         XPUSHs(msg);
1285         PUTBACK;
1286         call_sv((SV*)cv, G_DISCARD);
1287         POPSTACK;
1288         LEAVE;
1289         return TRUE;
1290     }
1291     return FALSE;
1292 }
1293
1294 STATIC const char *
1295 S_vdie_croak_common(pTHX_ const char* pat, va_list* args, STRLEN* msglen,
1296                     I32* utf8)
1297 {
1298     dVAR;
1299     const char *message;
1300
1301     if (pat) {
1302         SV * const msv = vmess(pat, args);
1303         if (PL_errors && SvCUR(PL_errors)) {
1304             sv_catsv(PL_errors, msv);
1305             message = SvPV_const(PL_errors, *msglen);
1306             SvCUR_set(PL_errors, 0);
1307         }
1308         else
1309             message = SvPV_const(msv,*msglen);
1310         *utf8 = SvUTF8(msv);
1311     }
1312     else {
1313         message = NULL;
1314     }
1315
1316     DEBUG_S(PerlIO_printf(Perl_debug_log,
1317                           "%p: die/croak: message = %s\ndiehook = %p\n",
1318                           (void*)thr, message, (void*)PL_diehook));
1319     if (PL_diehook) {
1320         S_vdie_common(aTHX_ message, *msglen, *utf8, FALSE);
1321     }
1322     return message;
1323 }
1324
1325 OP *
1326 Perl_vdie(pTHX_ const char* pat, va_list *args)
1327 {
1328     dVAR;
1329     const char *message;
1330     const int was_in_eval = PL_in_eval;
1331     STRLEN msglen;
1332     I32 utf8 = 0;
1333
1334     DEBUG_S(PerlIO_printf(Perl_debug_log,
1335                           "%p: die: curstack = %p, mainstack = %p\n",
1336                           (void*)thr, (void*)PL_curstack, (void*)PL_mainstack));
1337
1338     message = vdie_croak_common(pat, args, &msglen, &utf8);
1339
1340     PL_restartop = die_where(message, msglen);
1341     SvFLAGS(ERRSV) |= utf8;
1342     DEBUG_S(PerlIO_printf(Perl_debug_log,
1343           "%p: die: restartop = %p, was_in_eval = %d, top_env = %p\n",
1344           (void*)thr, (void*)PL_restartop, was_in_eval, (void*)PL_top_env));
1345     if ((!PL_restartop && was_in_eval) || PL_top_env->je_prev)
1346         JMPENV_JUMP(3);
1347     return PL_restartop;
1348 }
1349
1350 #if defined(PERL_IMPLICIT_CONTEXT)
1351 OP *
1352 Perl_die_nocontext(const char* pat, ...)
1353 {
1354     dTHX;
1355     OP *o;
1356     va_list args;
1357     va_start(args, pat);
1358     o = vdie(pat, &args);
1359     va_end(args);
1360     return o;
1361 }
1362 #endif /* PERL_IMPLICIT_CONTEXT */
1363
1364 OP *
1365 Perl_die(pTHX_ const char* pat, ...)
1366 {
1367     OP *o;
1368     va_list args;
1369     va_start(args, pat);
1370     o = vdie(pat, &args);
1371     va_end(args);
1372     return o;
1373 }
1374
1375 void
1376 Perl_vcroak(pTHX_ const char* pat, va_list *args)
1377 {
1378     dVAR;
1379     const char *message;
1380     STRLEN msglen;
1381     I32 utf8 = 0;
1382
1383     message = S_vdie_croak_common(aTHX_ pat, args, &msglen, &utf8);
1384
1385     if (PL_in_eval) {
1386         PL_restartop = die_where(message, msglen);
1387         SvFLAGS(ERRSV) |= utf8;
1388         JMPENV_JUMP(3);
1389     }
1390     else if (!message)
1391         message = SvPVx_const(ERRSV, msglen);
1392
1393     write_to_stderr(message, msglen);
1394     my_failure_exit();
1395 }
1396
1397 #if defined(PERL_IMPLICIT_CONTEXT)
1398 void
1399 Perl_croak_nocontext(const char *pat, ...)
1400 {
1401     dTHX;
1402     va_list args;
1403     va_start(args, pat);
1404     vcroak(pat, &args);
1405     /* NOTREACHED */
1406     va_end(args);
1407 }
1408 #endif /* PERL_IMPLICIT_CONTEXT */
1409
1410 /*
1411 =head1 Warning and Dieing
1412
1413 =for apidoc croak
1414
1415 This is the XSUB-writer's interface to Perl's C<die> function.
1416 Normally call this function the same way you call the C C<printf>
1417 function.  Calling C<croak> returns control directly to Perl,
1418 sidestepping the normal C order of execution. See C<warn>.
1419
1420 If you want to throw an exception object, assign the object to
1421 C<$@> and then pass C<NULL> to croak():
1422
1423    errsv = get_sv("@", TRUE);
1424    sv_setsv(errsv, exception_object);
1425    croak(NULL);
1426
1427 =cut
1428 */
1429
1430 void
1431 Perl_croak(pTHX_ const char *pat, ...)
1432 {
1433     va_list args;
1434     va_start(args, pat);
1435     vcroak(pat, &args);
1436     /* NOTREACHED */
1437     va_end(args);
1438 }
1439
1440 void
1441 Perl_vwarn(pTHX_ const char* pat, va_list *args)
1442 {
1443     dVAR;
1444     STRLEN msglen;
1445     SV * const msv = vmess(pat, args);
1446     const I32 utf8 = SvUTF8(msv);
1447     const char * const message = SvPV_const(msv, msglen);
1448
1449     if (PL_warnhook) {
1450         if (vdie_common(message, msglen, utf8, TRUE))
1451             return;
1452     }
1453
1454     write_to_stderr(message, msglen);
1455 }
1456
1457 #if defined(PERL_IMPLICIT_CONTEXT)
1458 void
1459 Perl_warn_nocontext(const char *pat, ...)
1460 {
1461     dTHX;
1462     va_list args;
1463     va_start(args, pat);
1464     vwarn(pat, &args);
1465     va_end(args);
1466 }
1467 #endif /* PERL_IMPLICIT_CONTEXT */
1468
1469 /*
1470 =for apidoc warn
1471
1472 This is the XSUB-writer's interface to Perl's C<warn> function.  Call this
1473 function the same way you call the C C<printf> function.  See C<croak>.
1474
1475 =cut
1476 */
1477
1478 void
1479 Perl_warn(pTHX_ const char *pat, ...)
1480 {
1481     va_list args;
1482     va_start(args, pat);
1483     vwarn(pat, &args);
1484     va_end(args);
1485 }
1486
1487 #if defined(PERL_IMPLICIT_CONTEXT)
1488 void
1489 Perl_warner_nocontext(U32 err, const char *pat, ...)
1490 {
1491     dTHX; 
1492     va_list args;
1493     va_start(args, pat);
1494     vwarner(err, pat, &args);
1495     va_end(args);
1496 }
1497 #endif /* PERL_IMPLICIT_CONTEXT */
1498
1499 void
1500 Perl_warner(pTHX_ U32  err, const char* pat,...)
1501 {
1502     va_list args;
1503     va_start(args, pat);
1504     vwarner(err, pat, &args);
1505     va_end(args);
1506 }
1507
1508 void
1509 Perl_vwarner(pTHX_ U32  err, const char* pat, va_list* args)
1510 {
1511     dVAR;
1512     if (PL_warnhook == PERL_WARNHOOK_FATAL || ckDEAD(err)) {
1513         SV * const msv = vmess(pat, args);
1514         STRLEN msglen;
1515         const char * const message = SvPV_const(msv, msglen);
1516         const I32 utf8 = SvUTF8(msv);
1517
1518         if (PL_diehook) {
1519             assert(message);
1520             S_vdie_common(aTHX_ message, msglen, utf8, FALSE);
1521         }
1522         if (PL_in_eval) {
1523             PL_restartop = die_where(message, msglen);
1524             SvFLAGS(ERRSV) |= utf8;
1525             JMPENV_JUMP(3);
1526         }
1527         write_to_stderr(message, msglen);
1528         my_failure_exit();
1529     }
1530     else {
1531         Perl_vwarn(aTHX_ pat, args);
1532     }
1533 }
1534
1535 /* implements the ckWARN? macros */
1536
1537 bool
1538 Perl_ckwarn(pTHX_ U32 w)
1539 {
1540     dVAR;
1541     return
1542         (
1543                isLEXWARN_on
1544             && PL_curcop->cop_warnings != pWARN_NONE
1545             && (
1546                    PL_curcop->cop_warnings == pWARN_ALL
1547                 || isWARN_on(PL_curcop->cop_warnings, unpackWARN1(w))
1548                 || (unpackWARN2(w) &&
1549                      isWARN_on(PL_curcop->cop_warnings, unpackWARN2(w)))
1550                 || (unpackWARN3(w) &&
1551                      isWARN_on(PL_curcop->cop_warnings, unpackWARN3(w)))
1552                 || (unpackWARN4(w) &&
1553                      isWARN_on(PL_curcop->cop_warnings, unpackWARN4(w)))
1554                 )
1555         )
1556         ||
1557         (
1558             isLEXWARN_off && PL_dowarn & G_WARN_ON
1559         )
1560         ;
1561 }
1562
1563 /* implements the ckWARN?_d macro */
1564
1565 bool
1566 Perl_ckwarn_d(pTHX_ U32 w)
1567 {
1568     dVAR;
1569     return
1570            isLEXWARN_off
1571         || PL_curcop->cop_warnings == pWARN_ALL
1572         || (
1573               PL_curcop->cop_warnings != pWARN_NONE 
1574            && (
1575                    isWARN_on(PL_curcop->cop_warnings, unpackWARN1(w))
1576               || (unpackWARN2(w) &&
1577                    isWARN_on(PL_curcop->cop_warnings, unpackWARN2(w)))
1578               || (unpackWARN3(w) &&
1579                    isWARN_on(PL_curcop->cop_warnings, unpackWARN3(w)))
1580               || (unpackWARN4(w) &&
1581                    isWARN_on(PL_curcop->cop_warnings, unpackWARN4(w)))
1582               )
1583            )
1584         ;
1585 }
1586
1587 /* Set buffer=NULL to get a new one.  */
1588 STRLEN *
1589 Perl_new_warnings_bitfield(pTHX_ STRLEN *buffer, const char *const bits,
1590                            STRLEN size) {
1591     const MEM_SIZE len_wanted = sizeof(STRLEN) + size;
1592     PERL_UNUSED_CONTEXT;
1593
1594     buffer = (STRLEN*)
1595         (specialWARN(buffer) ?
1596          PerlMemShared_malloc(len_wanted) :
1597          PerlMemShared_realloc(buffer, len_wanted));
1598     buffer[0] = size;
1599     Copy(bits, (buffer + 1), size, char);
1600     return buffer;
1601 }
1602
1603 /* since we've already done strlen() for both nam and val
1604  * we can use that info to make things faster than
1605  * sprintf(s, "%s=%s", nam, val)
1606  */
1607 #define my_setenv_format(s, nam, nlen, val, vlen) \
1608    Copy(nam, s, nlen, char); \
1609    *(s+nlen) = '='; \
1610    Copy(val, s+(nlen+1), vlen, char); \
1611    *(s+(nlen+1+vlen)) = '\0'
1612
1613 #ifdef USE_ENVIRON_ARRAY
1614        /* VMS' my_setenv() is in vms.c */
1615 #if !defined(WIN32) && !defined(NETWARE)
1616 void
1617 Perl_my_setenv(pTHX_ const char *nam, const char *val)
1618 {
1619   dVAR;
1620 #ifdef USE_ITHREADS
1621   /* only parent thread can modify process environment */
1622   if (PL_curinterp == aTHX)
1623 #endif
1624   {
1625 #ifndef PERL_USE_SAFE_PUTENV
1626     if (!PL_use_safe_putenv) {
1627     /* most putenv()s leak, so we manipulate environ directly */
1628     register I32 i=setenv_getix(nam);          /* where does it go? */
1629     int nlen, vlen;
1630
1631     if (environ == PL_origenviron) {   /* need we copy environment? */
1632        I32 j;
1633        I32 max;
1634        char **tmpenv;
1635
1636        max = i;
1637        while (environ[max])
1638            max++;
1639        tmpenv = (char**)safesysmalloc((max+2) * sizeof(char*));
1640        for (j=0; j<max; j++) {         /* copy environment */
1641            const int len = strlen(environ[j]);
1642            tmpenv[j] = (char*)safesysmalloc((len+1)*sizeof(char));
1643            Copy(environ[j], tmpenv[j], len+1, char);
1644        }
1645        tmpenv[max] = NULL;
1646        environ = tmpenv;               /* tell exec where it is now */
1647     }
1648     if (!val) {
1649        safesysfree(environ[i]);
1650        while (environ[i]) {
1651            environ[i] = environ[i+1];
1652            i++;
1653         }
1654        return;
1655     }
1656     if (!environ[i]) {                 /* does not exist yet */
1657        environ = (char**)safesysrealloc(environ, (i+2) * sizeof(char*));
1658        environ[i+1] = NULL;    /* make sure it's null terminated */
1659     }
1660     else
1661        safesysfree(environ[i]);
1662        nlen = strlen(nam);
1663        vlen = strlen(val);
1664
1665        environ[i] = (char*)safesysmalloc((nlen+vlen+2) * sizeof(char));
1666        /* all that work just for this */
1667        my_setenv_format(environ[i], nam, nlen, val, vlen);
1668     } else {
1669 # endif
1670 #   if defined(__CYGWIN__) || defined(EPOC) || defined(__SYMBIAN32__) || defined(__riscos__)
1671 #       if defined(HAS_UNSETENV)
1672         if (val == NULL) {
1673             (void)unsetenv(nam);
1674         } else {
1675             (void)setenv(nam, val, 1);
1676         }
1677 #       else /* ! HAS_UNSETENV */
1678         (void)setenv(nam, val, 1);
1679 #       endif /* HAS_UNSETENV */
1680 #   else
1681 #       if defined(HAS_UNSETENV)
1682         if (val == NULL) {
1683             (void)unsetenv(nam);
1684         } else {
1685             const int nlen = strlen(nam);
1686             const int vlen = strlen(val);
1687             char * const new_env =
1688                 (char*)safesysmalloc((nlen + vlen + 2) * sizeof(char));
1689             my_setenv_format(new_env, nam, nlen, val, vlen);
1690             (void)putenv(new_env);
1691         }
1692 #       else /* ! HAS_UNSETENV */
1693         char *new_env;
1694         const int nlen = strlen(nam);
1695         int vlen;
1696         if (!val) {
1697            val = "";
1698         }
1699         vlen = strlen(val);
1700         new_env = (char*)safesysmalloc((nlen + vlen + 2) * sizeof(char));
1701         /* all that work just for this */
1702         my_setenv_format(new_env, nam, nlen, val, vlen);
1703         (void)putenv(new_env);
1704 #       endif /* HAS_UNSETENV */
1705 #   endif /* __CYGWIN__ */
1706 #ifndef PERL_USE_SAFE_PUTENV
1707     }
1708 #endif
1709   }
1710 }
1711
1712 #else /* WIN32 || NETWARE */
1713
1714 void
1715 Perl_my_setenv(pTHX_ const char *nam, const char *val)
1716 {
1717     dVAR;
1718     register char *envstr;
1719     const int nlen = strlen(nam);
1720     int vlen;
1721
1722     if (!val) {
1723        val = "";
1724     }
1725     vlen = strlen(val);
1726     Newx(envstr, nlen+vlen+2, char);
1727     my_setenv_format(envstr, nam, nlen, val, vlen);
1728     (void)PerlEnv_putenv(envstr);
1729     Safefree(envstr);
1730 }
1731
1732 #endif /* WIN32 || NETWARE */
1733
1734 #ifndef PERL_MICRO
1735 I32
1736 Perl_setenv_getix(pTHX_ const char *nam)
1737 {
1738     register I32 i;
1739     register const I32 len = strlen(nam);
1740     PERL_UNUSED_CONTEXT;
1741
1742     for (i = 0; environ[i]; i++) {
1743         if (
1744 #ifdef WIN32
1745             strnicmp(environ[i],nam,len) == 0
1746 #else
1747             strnEQ(environ[i],nam,len)
1748 #endif
1749             && environ[i][len] == '=')
1750             break;                      /* strnEQ must come first to avoid */
1751     }                                   /* potential SEGV's */
1752     return i;
1753 }
1754 #endif /* !PERL_MICRO */
1755
1756 #endif /* !VMS && !EPOC*/
1757
1758 #ifdef UNLINK_ALL_VERSIONS
1759 I32
1760 Perl_unlnk(pTHX_ const char *f) /* unlink all versions of a file */
1761 {
1762     I32 retries = 0;
1763
1764     while (PerlLIO_unlink(f) >= 0)
1765         retries++;
1766     return retries ? 0 : -1;
1767 }
1768 #endif
1769
1770 /* this is a drop-in replacement for bcopy() */
1771 #if (!defined(HAS_MEMCPY) && !defined(HAS_BCOPY)) || (!defined(HAS_MEMMOVE) && !defined(HAS_SAFE_MEMCPY) && !defined(HAS_SAFE_BCOPY))
1772 char *
1773 Perl_my_bcopy(register const char *from,register char *to,register I32 len)
1774 {
1775     char * const retval = to;
1776
1777     if (from - to >= 0) {
1778         while (len--)
1779             *to++ = *from++;
1780     }
1781     else {
1782         to += len;
1783         from += len;
1784         while (len--)
1785             *(--to) = *(--from);
1786     }
1787     return retval;
1788 }
1789 #endif
1790
1791 /* this is a drop-in replacement for memset() */
1792 #ifndef HAS_MEMSET
1793 void *
1794 Perl_my_memset(register char *loc, register I32 ch, register I32 len)
1795 {
1796     char * const retval = loc;
1797
1798     while (len--)
1799         *loc++ = ch;
1800     return retval;
1801 }
1802 #endif
1803
1804 /* this is a drop-in replacement for bzero() */
1805 #if !defined(HAS_BZERO) && !defined(HAS_MEMSET)
1806 char *
1807 Perl_my_bzero(register char *loc, register I32 len)
1808 {
1809     char * const retval = loc;
1810
1811     while (len--)
1812         *loc++ = 0;
1813     return retval;
1814 }
1815 #endif
1816
1817 /* this is a drop-in replacement for memcmp() */
1818 #if !defined(HAS_MEMCMP) || !defined(HAS_SANE_MEMCMP)
1819 I32
1820 Perl_my_memcmp(const char *s1, const char *s2, register I32 len)
1821 {
1822     register const U8 *a = (const U8 *)s1;
1823     register const U8 *b = (const U8 *)s2;
1824     register I32 tmp;
1825
1826     while (len--) {
1827         if ((tmp = *a++ - *b++))
1828             return tmp;
1829     }
1830     return 0;
1831 }
1832 #endif /* !HAS_MEMCMP || !HAS_SANE_MEMCMP */
1833
1834 #ifndef HAS_VPRINTF
1835 /* This vsprintf replacement should generally never get used, since
1836    vsprintf was available in both System V and BSD 2.11.  (There may
1837    be some cross-compilation or embedded set-ups where it is needed,
1838    however.)
1839
1840    If you encounter a problem in this function, it's probably a symptom
1841    that Configure failed to detect your system's vprintf() function.
1842    See the section on "item vsprintf" in the INSTALL file.
1843
1844    This version may compile on systems with BSD-ish <stdio.h>,
1845    but probably won't on others.
1846 */
1847
1848 #ifdef USE_CHAR_VSPRINTF
1849 char *
1850 #else
1851 int
1852 #endif
1853 vsprintf(char *dest, const char *pat, void *args)
1854 {
1855     FILE fakebuf;
1856
1857 #if defined(STDIO_PTR_LVALUE) && defined(STDIO_CNT_LVALUE)
1858     FILE_ptr(&fakebuf) = (STDCHAR *) dest;
1859     FILE_cnt(&fakebuf) = 32767;
1860 #else
1861     /* These probably won't compile -- If you really need
1862        this, you'll have to figure out some other method. */
1863     fakebuf._ptr = dest;
1864     fakebuf._cnt = 32767;
1865 #endif
1866 #ifndef _IOSTRG
1867 #define _IOSTRG 0
1868 #endif
1869     fakebuf._flag = _IOWRT|_IOSTRG;
1870     _doprnt(pat, args, &fakebuf);       /* what a kludge */
1871 #if defined(STDIO_PTR_LVALUE)
1872     *(FILE_ptr(&fakebuf)++) = '\0';
1873 #else
1874     /* PerlIO has probably #defined away fputc, but we want it here. */
1875 #  ifdef fputc
1876 #    undef fputc  /* XXX Should really restore it later */
1877 #  endif
1878     (void)fputc('\0', &fakebuf);
1879 #endif
1880 #ifdef USE_CHAR_VSPRINTF
1881     return(dest);
1882 #else
1883     return 0;           /* perl doesn't use return value */
1884 #endif
1885 }
1886
1887 #endif /* HAS_VPRINTF */
1888
1889 #ifdef MYSWAP
1890 #if BYTEORDER != 0x4321
1891 short
1892 Perl_my_swap(pTHX_ short s)
1893 {
1894 #if (BYTEORDER & 1) == 0
1895     short result;
1896
1897     result = ((s & 255) << 8) + ((s >> 8) & 255);
1898     return result;
1899 #else
1900     return s;
1901 #endif
1902 }
1903
1904 long
1905 Perl_my_htonl(pTHX_ long l)
1906 {
1907     union {
1908         long result;
1909         char c[sizeof(long)];
1910     } u;
1911
1912 #if BYTEORDER == 0x1234 || BYTEORDER == 0x12345678
1913 #if BYTEORDER == 0x12345678
1914     u.result = 0; 
1915 #endif 
1916     u.c[0] = (l >> 24) & 255;
1917     u.c[1] = (l >> 16) & 255;
1918     u.c[2] = (l >> 8) & 255;
1919     u.c[3] = l & 255;
1920     return u.result;
1921 #else
1922 #if ((BYTEORDER - 0x1111) & 0x444) || !(BYTEORDER & 0xf)
1923     Perl_croak(aTHX_ "Unknown BYTEORDER\n");
1924 #else
1925     register I32 o;
1926     register I32 s;
1927
1928     for (o = BYTEORDER - 0x1111, s = 0; s < (sizeof(long)*8); o >>= 4, s += 8) {
1929         u.c[o & 0xf] = (l >> s) & 255;
1930     }
1931     return u.result;
1932 #endif
1933 #endif
1934 }
1935
1936 long
1937 Perl_my_ntohl(pTHX_ long l)
1938 {
1939     union {
1940         long l;
1941         char c[sizeof(long)];
1942     } u;
1943
1944 #if BYTEORDER == 0x1234
1945     u.c[0] = (l >> 24) & 255;
1946     u.c[1] = (l >> 16) & 255;
1947     u.c[2] = (l >> 8) & 255;
1948     u.c[3] = l & 255;
1949     return u.l;
1950 #else
1951 #if ((BYTEORDER - 0x1111) & 0x444) || !(BYTEORDER & 0xf)
1952     Perl_croak(aTHX_ "Unknown BYTEORDER\n");
1953 #else
1954     register I32 o;
1955     register I32 s;
1956
1957     u.l = l;
1958     l = 0;
1959     for (o = BYTEORDER - 0x1111, s = 0; s < (sizeof(long)*8); o >>= 4, s += 8) {
1960         l |= (u.c[o & 0xf] & 255) << s;
1961     }
1962     return l;
1963 #endif
1964 #endif
1965 }
1966
1967 #endif /* BYTEORDER != 0x4321 */
1968 #endif /* MYSWAP */
1969
1970 /*
1971  * Little-endian byte order functions - 'v' for 'VAX', or 'reVerse'.
1972  * If these functions are defined,
1973  * the BYTEORDER is neither 0x1234 nor 0x4321.
1974  * However, this is not assumed.
1975  * -DWS
1976  */
1977
1978 #define HTOLE(name,type)                                        \
1979         type                                                    \
1980         name (register type n)                                  \
1981         {                                                       \
1982             union {                                             \
1983                 type value;                                     \
1984                 char c[sizeof(type)];                           \
1985             } u;                                                \
1986             register U32 i;                                     \
1987             register U32 s = 0;                                 \
1988             for (i = 0; i < sizeof(u.c); i++, s += 8) {         \
1989                 u.c[i] = (n >> s) & 0xFF;                       \
1990             }                                                   \
1991             return u.value;                                     \
1992         }
1993
1994 #define LETOH(name,type)                                        \
1995         type                                                    \
1996         name (register type n)                                  \
1997         {                                                       \
1998             union {                                             \
1999                 type value;                                     \
2000                 char c[sizeof(type)];                           \
2001             } u;                                                \
2002             register U32 i;                                     \
2003             register U32 s = 0;                                 \
2004             u.value = n;                                        \
2005             n = 0;                                              \
2006             for (i = 0; i < sizeof(u.c); i++, s += 8) {         \
2007                 n |= ((type)(u.c[i] & 0xFF)) << s;              \
2008             }                                                   \
2009             return n;                                           \
2010         }
2011
2012 /*
2013  * Big-endian byte order functions.
2014  */
2015
2016 #define HTOBE(name,type)                                        \
2017         type                                                    \
2018         name (register type n)                                  \
2019         {                                                       \
2020             union {                                             \
2021                 type value;                                     \
2022                 char c[sizeof(type)];                           \
2023             } u;                                                \
2024             register U32 i;                                     \
2025             register U32 s = 8*(sizeof(u.c)-1);                 \
2026             for (i = 0; i < sizeof(u.c); i++, s -= 8) {         \
2027                 u.c[i] = (n >> s) & 0xFF;                       \
2028             }                                                   \
2029             return u.value;                                     \
2030         }
2031
2032 #define BETOH(name,type)                                        \
2033         type                                                    \
2034         name (register type n)                                  \
2035         {                                                       \
2036             union {                                             \
2037                 type value;                                     \
2038                 char c[sizeof(type)];                           \
2039             } u;                                                \
2040             register U32 i;                                     \
2041             register U32 s = 8*(sizeof(u.c)-1);                 \
2042             u.value = n;                                        \
2043             n = 0;                                              \
2044             for (i = 0; i < sizeof(u.c); i++, s -= 8) {         \
2045                 n |= ((type)(u.c[i] & 0xFF)) << s;              \
2046             }                                                   \
2047             return n;                                           \
2048         }
2049
2050 /*
2051  * If we just can't do it...
2052  */
2053
2054 #define NOT_AVAIL(name,type)                                    \
2055         type                                                    \
2056         name (register type n)                                  \
2057         {                                                       \
2058             Perl_croak_nocontext(#name "() not available");     \
2059             return n; /* not reached */                         \
2060         }
2061
2062
2063 #if defined(HAS_HTOVS) && !defined(htovs)
2064 HTOLE(htovs,short)
2065 #endif
2066 #if defined(HAS_HTOVL) && !defined(htovl)
2067 HTOLE(htovl,long)
2068 #endif
2069 #if defined(HAS_VTOHS) && !defined(vtohs)
2070 LETOH(vtohs,short)
2071 #endif
2072 #if defined(HAS_VTOHL) && !defined(vtohl)
2073 LETOH(vtohl,long)
2074 #endif
2075
2076 #ifdef PERL_NEED_MY_HTOLE16
2077 # if U16SIZE == 2
2078 HTOLE(Perl_my_htole16,U16)
2079 # else
2080 NOT_AVAIL(Perl_my_htole16,U16)
2081 # endif
2082 #endif
2083 #ifdef PERL_NEED_MY_LETOH16
2084 # if U16SIZE == 2
2085 LETOH(Perl_my_letoh16,U16)
2086 # else
2087 NOT_AVAIL(Perl_my_letoh16,U16)
2088 # endif
2089 #endif
2090 #ifdef PERL_NEED_MY_HTOBE16
2091 # if U16SIZE == 2
2092 HTOBE(Perl_my_htobe16,U16)
2093 # else
2094 NOT_AVAIL(Perl_my_htobe16,U16)
2095 # endif
2096 #endif
2097 #ifdef PERL_NEED_MY_BETOH16
2098 # if U16SIZE == 2
2099 BETOH(Perl_my_betoh16,U16)
2100 # else
2101 NOT_AVAIL(Perl_my_betoh16,U16)
2102 # endif
2103 #endif
2104
2105 #ifdef PERL_NEED_MY_HTOLE32
2106 # if U32SIZE == 4
2107 HTOLE(Perl_my_htole32,U32)
2108 # else
2109 NOT_AVAIL(Perl_my_htole32,U32)
2110 # endif
2111 #endif
2112 #ifdef PERL_NEED_MY_LETOH32
2113 # if U32SIZE == 4
2114 LETOH(Perl_my_letoh32,U32)
2115 # else
2116 NOT_AVAIL(Perl_my_letoh32,U32)
2117 # endif
2118 #endif
2119 #ifdef PERL_NEED_MY_HTOBE32
2120 # if U32SIZE == 4
2121 HTOBE(Perl_my_htobe32,U32)
2122 # else
2123 NOT_AVAIL(Perl_my_htobe32,U32)
2124 # endif
2125 #endif
2126 #ifdef PERL_NEED_MY_BETOH32
2127 # if U32SIZE == 4
2128 BETOH(Perl_my_betoh32,U32)
2129 # else
2130 NOT_AVAIL(Perl_my_betoh32,U32)
2131 # endif
2132 #endif
2133
2134 #ifdef PERL_NEED_MY_HTOLE64
2135 # if U64SIZE == 8
2136 HTOLE(Perl_my_htole64,U64)
2137 # else
2138 NOT_AVAIL(Perl_my_htole64,U64)
2139 # endif
2140 #endif
2141 #ifdef PERL_NEED_MY_LETOH64
2142 # if U64SIZE == 8
2143 LETOH(Perl_my_letoh64,U64)
2144 # else
2145 NOT_AVAIL(Perl_my_letoh64,U64)
2146 # endif
2147 #endif
2148 #ifdef PERL_NEED_MY_HTOBE64
2149 # if U64SIZE == 8
2150 HTOBE(Perl_my_htobe64,U64)
2151 # else
2152 NOT_AVAIL(Perl_my_htobe64,U64)
2153 # endif
2154 #endif
2155 #ifdef PERL_NEED_MY_BETOH64
2156 # if U64SIZE == 8
2157 BETOH(Perl_my_betoh64,U64)
2158 # else
2159 NOT_AVAIL(Perl_my_betoh64,U64)
2160 # endif
2161 #endif
2162
2163 #ifdef PERL_NEED_MY_HTOLES
2164 HTOLE(Perl_my_htoles,short)
2165 #endif
2166 #ifdef PERL_NEED_MY_LETOHS
2167 LETOH(Perl_my_letohs,short)
2168 #endif
2169 #ifdef PERL_NEED_MY_HTOBES
2170 HTOBE(Perl_my_htobes,short)
2171 #endif
2172 #ifdef PERL_NEED_MY_BETOHS
2173 BETOH(Perl_my_betohs,short)
2174 #endif
2175
2176 #ifdef PERL_NEED_MY_HTOLEI
2177 HTOLE(Perl_my_htolei,int)
2178 #endif
2179 #ifdef PERL_NEED_MY_LETOHI
2180 LETOH(Perl_my_letohi,int)
2181 #endif
2182 #ifdef PERL_NEED_MY_HTOBEI
2183 HTOBE(Perl_my_htobei,int)
2184 #endif
2185 #ifdef PERL_NEED_MY_BETOHI
2186 BETOH(Perl_my_betohi,int)
2187 #endif
2188
2189 #ifdef PERL_NEED_MY_HTOLEL
2190 HTOLE(Perl_my_htolel,long)
2191 #endif
2192 #ifdef PERL_NEED_MY_LETOHL
2193 LETOH(Perl_my_letohl,long)
2194 #endif
2195 #ifdef PERL_NEED_MY_HTOBEL
2196 HTOBE(Perl_my_htobel,long)
2197 #endif
2198 #ifdef PERL_NEED_MY_BETOHL
2199 BETOH(Perl_my_betohl,long)
2200 #endif
2201
2202 void
2203 Perl_my_swabn(void *ptr, int n)
2204 {
2205     register char *s = (char *)ptr;
2206     register char *e = s + (n-1);
2207     register char tc;
2208
2209     for (n /= 2; n > 0; s++, e--, n--) {
2210       tc = *s;
2211       *s = *e;
2212       *e = tc;
2213     }
2214 }
2215
2216 PerlIO *
2217 Perl_my_popen_list(pTHX_ char *mode, int n, SV **args)
2218 {
2219 #if (!defined(DOSISH) || defined(HAS_FORK) || defined(AMIGAOS)) && !defined(OS2) && !defined(VMS) && !defined(__OPEN_VM) && !defined(EPOC) && !defined(MACOS_TRADITIONAL) && !defined(NETWARE)
2220     dVAR;
2221     int p[2];
2222     register I32 This, that;
2223     register Pid_t pid;
2224     SV *sv;
2225     I32 did_pipes = 0;
2226     int pp[2];
2227
2228     PERL_FLUSHALL_FOR_CHILD;
2229     This = (*mode == 'w');
2230     that = !This;
2231     if (PL_tainting) {
2232         taint_env();
2233         taint_proper("Insecure %s%s", "EXEC");
2234     }
2235     if (PerlProc_pipe(p) < 0)
2236         return NULL;
2237     /* Try for another pipe pair for error return */
2238     if (PerlProc_pipe(pp) >= 0)
2239         did_pipes = 1;
2240     while ((pid = PerlProc_fork()) < 0) {
2241         if (errno != EAGAIN) {
2242             PerlLIO_close(p[This]);
2243             PerlLIO_close(p[that]);
2244             if (did_pipes) {
2245                 PerlLIO_close(pp[0]);
2246                 PerlLIO_close(pp[1]);
2247             }
2248             return NULL;
2249         }
2250         sleep(5);
2251     }
2252     if (pid == 0) {
2253         /* Child */
2254 #undef THIS
2255 #undef THAT
2256 #define THIS that
2257 #define THAT This
2258         /* Close parent's end of error status pipe (if any) */
2259         if (did_pipes) {
2260             PerlLIO_close(pp[0]);
2261 #if defined(HAS_FCNTL) && defined(F_SETFD)
2262             /* Close error pipe automatically if exec works */
2263             fcntl(pp[1], F_SETFD, FD_CLOEXEC);
2264 #endif
2265         }
2266         /* Now dup our end of _the_ pipe to right position */
2267         if (p[THIS] != (*mode == 'r')) {
2268             PerlLIO_dup2(p[THIS], *mode == 'r');
2269             PerlLIO_close(p[THIS]);
2270             if (p[THAT] != (*mode == 'r'))      /* if dup2() didn't close it */
2271                 PerlLIO_close(p[THAT]); /* close parent's end of _the_ pipe */
2272         }
2273         else
2274             PerlLIO_close(p[THAT]);     /* close parent's end of _the_ pipe */
2275 #if !defined(HAS_FCNTL) || !defined(F_SETFD)
2276         /* No automatic close - do it by hand */
2277 #  ifndef NOFILE
2278 #  define NOFILE 20
2279 #  endif
2280         {
2281             int fd;
2282
2283             for (fd = PL_maxsysfd + 1; fd < NOFILE; fd++) {
2284                 if (fd != pp[1])
2285                     PerlLIO_close(fd);
2286             }
2287         }
2288 #endif
2289         do_aexec5(NULL, args-1, args-1+n, pp[1], did_pipes);
2290         PerlProc__exit(1);
2291 #undef THIS
2292 #undef THAT
2293     }
2294     /* Parent */
2295     do_execfree();      /* free any memory malloced by child on fork */
2296     if (did_pipes)
2297         PerlLIO_close(pp[1]);
2298     /* Keep the lower of the two fd numbers */
2299     if (p[that] < p[This]) {
2300         PerlLIO_dup2(p[This], p[that]);
2301         PerlLIO_close(p[This]);
2302         p[This] = p[that];
2303     }
2304     else
2305         PerlLIO_close(p[that]);         /* close child's end of pipe */
2306
2307     LOCK_FDPID_MUTEX;
2308     sv = *av_fetch(PL_fdpid,p[This],TRUE);
2309     UNLOCK_FDPID_MUTEX;
2310     SvUPGRADE(sv,SVt_IV);
2311     SvIV_set(sv, pid);
2312     PL_forkprocess = pid;
2313     /* If we managed to get status pipe check for exec fail */
2314     if (did_pipes && pid > 0) {
2315         int errkid;
2316         unsigned n = 0;
2317         SSize_t n1;
2318
2319         while (n < sizeof(int)) {
2320             n1 = PerlLIO_read(pp[0],
2321                               (void*)(((char*)&errkid)+n),
2322                               (sizeof(int)) - n);
2323             if (n1 <= 0)
2324                 break;
2325             n += n1;
2326         }
2327         PerlLIO_close(pp[0]);
2328         did_pipes = 0;
2329         if (n) {                        /* Error */
2330             int pid2, status;
2331             PerlLIO_close(p[This]);
2332             if (n != sizeof(int))
2333                 Perl_croak(aTHX_ "panic: kid popen errno read");
2334             do {
2335                 pid2 = wait4pid(pid, &status, 0);
2336             } while (pid2 == -1 && errno == EINTR);
2337             errno = errkid;             /* Propagate errno from kid */
2338             return NULL;
2339         }
2340     }
2341     if (did_pipes)
2342          PerlLIO_close(pp[0]);
2343     return PerlIO_fdopen(p[This], mode);
2344 #else
2345 #  ifdef OS2    /* Same, without fork()ing and all extra overhead... */
2346     return my_syspopen4(aTHX_ Nullch, mode, n, args);
2347 #  else
2348     Perl_croak(aTHX_ "List form of piped open not implemented");
2349     return (PerlIO *) NULL;
2350 #  endif
2351 #endif
2352 }
2353
2354     /* VMS' my_popen() is in VMS.c, same with OS/2. */
2355 #if (!defined(DOSISH) || defined(HAS_FORK) || defined(AMIGAOS)) && !defined(VMS) && !defined(__OPEN_VM) && !defined(EPOC) && !defined(MACOS_TRADITIONAL)
2356 PerlIO *
2357 Perl_my_popen(pTHX_ const char *cmd, const char *mode)
2358 {
2359     dVAR;
2360     int p[2];
2361     register I32 This, that;
2362     register Pid_t pid;
2363     SV *sv;
2364     const I32 doexec = !(*cmd == '-' && cmd[1] == '\0');
2365     I32 did_pipes = 0;
2366     int pp[2];
2367
2368     PERL_FLUSHALL_FOR_CHILD;
2369 #ifdef OS2
2370     if (doexec) {
2371         return my_syspopen(aTHX_ cmd,mode);
2372     }
2373 #endif
2374     This = (*mode == 'w');
2375     that = !This;
2376     if (doexec && PL_tainting) {
2377         taint_env();
2378         taint_proper("Insecure %s%s", "EXEC");
2379     }
2380     if (PerlProc_pipe(p) < 0)
2381         return NULL;
2382     if (doexec && PerlProc_pipe(pp) >= 0)
2383         did_pipes = 1;
2384     while ((pid = PerlProc_fork()) < 0) {
2385         if (errno != EAGAIN) {
2386             PerlLIO_close(p[This]);
2387             PerlLIO_close(p[that]);
2388             if (did_pipes) {
2389                 PerlLIO_close(pp[0]);
2390                 PerlLIO_close(pp[1]);
2391             }
2392             if (!doexec)
2393                 Perl_croak(aTHX_ "Can't fork");
2394             return NULL;
2395         }
2396         sleep(5);
2397     }
2398     if (pid == 0) {
2399         GV* tmpgv;
2400
2401 #undef THIS
2402 #undef THAT
2403 #define THIS that
2404 #define THAT This
2405         if (did_pipes) {
2406             PerlLIO_close(pp[0]);
2407 #if defined(HAS_FCNTL) && defined(F_SETFD)
2408             fcntl(pp[1], F_SETFD, FD_CLOEXEC);
2409 #endif
2410         }
2411         if (p[THIS] != (*mode == 'r')) {
2412             PerlLIO_dup2(p[THIS], *mode == 'r');
2413             PerlLIO_close(p[THIS]);
2414             if (p[THAT] != (*mode == 'r'))      /* if dup2() didn't close it */
2415                 PerlLIO_close(p[THAT]);
2416         }
2417         else
2418             PerlLIO_close(p[THAT]);
2419 #ifndef OS2
2420         if (doexec) {
2421 #if !defined(HAS_FCNTL) || !defined(F_SETFD)
2422 #ifndef NOFILE
2423 #define NOFILE 20
2424 #endif
2425             {
2426                 int fd;
2427
2428                 for (fd = PL_maxsysfd + 1; fd < NOFILE; fd++)
2429                     if (fd != pp[1])
2430                         PerlLIO_close(fd);
2431             }
2432 #endif
2433             /* may or may not use the shell */
2434             do_exec3(cmd, pp[1], did_pipes);
2435             PerlProc__exit(1);
2436         }
2437 #endif  /* defined OS2 */
2438
2439 #ifdef PERLIO_USING_CRLF
2440    /* Since we circumvent IO layers when we manipulate low-level
2441       filedescriptors directly, need to manually switch to the
2442       default, binary, low-level mode; see PerlIOBuf_open(). */
2443    PerlLIO_setmode((*mode == 'r'), O_BINARY);
2444 #endif 
2445
2446         if ((tmpgv = gv_fetchpvs("$", GV_ADD|GV_NOTQUAL, SVt_PV))) {
2447             SvREADONLY_off(GvSV(tmpgv));
2448             sv_setiv(GvSV(tmpgv), PerlProc_getpid());
2449             SvREADONLY_on(GvSV(tmpgv));
2450         }
2451 #ifdef THREADS_HAVE_PIDS
2452         PL_ppid = (IV)getppid();
2453 #endif
2454         PL_forkprocess = 0;
2455 #ifdef PERL_USES_PL_PIDSTATUS
2456         hv_clear(PL_pidstatus); /* we have no children */
2457 #endif
2458         return NULL;
2459 #undef THIS
2460 #undef THAT
2461     }
2462     do_execfree();      /* free any memory malloced by child on vfork */
2463     if (did_pipes)
2464         PerlLIO_close(pp[1]);
2465     if (p[that] < p[This]) {
2466         PerlLIO_dup2(p[This], p[that]);
2467         PerlLIO_close(p[This]);
2468         p[This] = p[that];
2469     }
2470     else
2471         PerlLIO_close(p[that]);
2472
2473     LOCK_FDPID_MUTEX;
2474     sv = *av_fetch(PL_fdpid,p[This],TRUE);
2475     UNLOCK_FDPID_MUTEX;
2476     SvUPGRADE(sv,SVt_IV);
2477     SvIV_set(sv, pid);
2478     PL_forkprocess = pid;
2479     if (did_pipes && pid > 0) {
2480         int errkid;
2481         unsigned n = 0;
2482         SSize_t n1;
2483
2484         while (n < sizeof(int)) {
2485             n1 = PerlLIO_read(pp[0],
2486                               (void*)(((char*)&errkid)+n),
2487                               (sizeof(int)) - n);
2488             if (n1 <= 0)
2489                 break;
2490             n += n1;
2491         }
2492         PerlLIO_close(pp[0]);
2493         did_pipes = 0;
2494         if (n) {                        /* Error */
2495             int pid2, status;
2496             PerlLIO_close(p[This]);
2497             if (n != sizeof(int))
2498                 Perl_croak(aTHX_ "panic: kid popen errno read");
2499             do {
2500                 pid2 = wait4pid(pid, &status, 0);
2501             } while (pid2 == -1 && errno == EINTR);
2502             errno = errkid;             /* Propagate errno from kid */
2503             return NULL;
2504         }
2505     }
2506     if (did_pipes)
2507          PerlLIO_close(pp[0]);
2508     return PerlIO_fdopen(p[This], mode);
2509 }
2510 #else
2511 #if defined(atarist) || defined(EPOC)
2512 FILE *popen();
2513 PerlIO *
2514 Perl_my_popen(pTHX_ const char *cmd, const char *mode)
2515 {
2516     PERL_FLUSHALL_FOR_CHILD;
2517     /* Call system's popen() to get a FILE *, then import it.
2518        used 0 for 2nd parameter to PerlIO_importFILE;
2519        apparently not used
2520     */
2521     return PerlIO_importFILE(popen(cmd, mode), 0);
2522 }
2523 #else
2524 #if defined(DJGPP)
2525 FILE *djgpp_popen();
2526 PerlIO *
2527 Perl_my_popen(pTHX_ const char *cmd, const char *mode)
2528 {
2529     PERL_FLUSHALL_FOR_CHILD;
2530     /* Call system's popen() to get a FILE *, then import it.
2531        used 0 for 2nd parameter to PerlIO_importFILE;
2532        apparently not used
2533     */
2534     return PerlIO_importFILE(djgpp_popen(cmd, mode), 0);
2535 }
2536 #endif
2537 #endif
2538
2539 #endif /* !DOSISH */
2540
2541 /* this is called in parent before the fork() */
2542 void
2543 Perl_atfork_lock(void)
2544 {
2545    dVAR;
2546 #if defined(USE_ITHREADS)
2547     /* locks must be held in locking order (if any) */
2548 #  ifdef MYMALLOC
2549     MUTEX_LOCK(&PL_malloc_mutex);
2550 #  endif
2551     OP_REFCNT_LOCK;
2552 #endif
2553 }
2554
2555 /* this is called in both parent and child after the fork() */
2556 void
2557 Perl_atfork_unlock(void)
2558 {
2559     dVAR;
2560 #if defined(USE_ITHREADS)
2561     /* locks must be released in same order as in atfork_lock() */
2562 #  ifdef MYMALLOC
2563     MUTEX_UNLOCK(&PL_malloc_mutex);
2564 #  endif
2565     OP_REFCNT_UNLOCK;
2566 #endif
2567 }
2568
2569 Pid_t
2570 Perl_my_fork(void)
2571 {
2572 #if defined(HAS_FORK)
2573     Pid_t pid;
2574 #if defined(USE_ITHREADS) && !defined(HAS_PTHREAD_ATFORK)
2575     atfork_lock();
2576     pid = fork();
2577     atfork_unlock();
2578 #else
2579     /* atfork_lock() and atfork_unlock() are installed as pthread_atfork()
2580      * handlers elsewhere in the code */
2581     pid = fork();
2582 #endif
2583     return pid;
2584 #else
2585     /* this "canna happen" since nothing should be calling here if !HAS_FORK */
2586     Perl_croak_nocontext("fork() not available");
2587     return 0;
2588 #endif /* HAS_FORK */
2589 }
2590
2591 #ifdef DUMP_FDS
2592 void
2593 Perl_dump_fds(pTHX_ char *s)
2594 {
2595     int fd;
2596     Stat_t tmpstatbuf;
2597
2598     PerlIO_printf(Perl_debug_log,"%s", s);
2599     for (fd = 0; fd < 32; fd++) {
2600         if (PerlLIO_fstat(fd,&tmpstatbuf) >= 0)
2601             PerlIO_printf(Perl_debug_log," %d",fd);
2602     }
2603     PerlIO_printf(Perl_debug_log,"\n");
2604     return;
2605 }
2606 #endif  /* DUMP_FDS */
2607
2608 #ifndef HAS_DUP2
2609 int
2610 dup2(int oldfd, int newfd)
2611 {
2612 #if defined(HAS_FCNTL) && defined(F_DUPFD)
2613     if (oldfd == newfd)
2614         return oldfd;
2615     PerlLIO_close(newfd);
2616     return fcntl(oldfd, F_DUPFD, newfd);
2617 #else
2618 #define DUP2_MAX_FDS 256
2619     int fdtmp[DUP2_MAX_FDS];
2620     I32 fdx = 0;
2621     int fd;
2622
2623     if (oldfd == newfd)
2624         return oldfd;
2625     PerlLIO_close(newfd);
2626     /* good enough for low fd's... */
2627     while ((fd = PerlLIO_dup(oldfd)) != newfd && fd >= 0) {
2628         if (fdx >= DUP2_MAX_FDS) {
2629             PerlLIO_close(fd);
2630             fd = -1;
2631             break;
2632         }
2633         fdtmp[fdx++] = fd;
2634     }
2635     while (fdx > 0)
2636         PerlLIO_close(fdtmp[--fdx]);
2637     return fd;
2638 #endif
2639 }
2640 #endif
2641
2642 #ifndef PERL_MICRO
2643 #ifdef HAS_SIGACTION
2644
2645 #ifdef MACOS_TRADITIONAL
2646 /* We don't want restart behavior on MacOS */
2647 #undef SA_RESTART
2648 #endif
2649
2650 Sighandler_t
2651 Perl_rsignal(pTHX_ int signo, Sighandler_t handler)
2652 {
2653     dVAR;
2654     struct sigaction act, oact;
2655
2656 #ifdef USE_ITHREADS
2657     /* only "parent" interpreter can diddle signals */
2658     if (PL_curinterp != aTHX)
2659         return (Sighandler_t) SIG_ERR;
2660 #endif
2661
2662     act.sa_handler = (void(*)(int))handler;
2663     sigemptyset(&act.sa_mask);
2664     act.sa_flags = 0;
2665 #ifdef SA_RESTART
2666     if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG)
2667         act.sa_flags |= SA_RESTART;     /* SVR4, 4.3+BSD */
2668 #endif
2669 #if defined(SA_NOCLDWAIT) && !defined(BSDish) /* See [perl #18849] */
2670     if (signo == SIGCHLD && handler == (Sighandler_t) SIG_IGN)
2671         act.sa_flags |= SA_NOCLDWAIT;
2672 #endif
2673     if (sigaction(signo, &act, &oact) == -1)
2674         return (Sighandler_t) SIG_ERR;
2675     else
2676         return (Sighandler_t) oact.sa_handler;
2677 }
2678
2679 Sighandler_t
2680 Perl_rsignal_state(pTHX_ int signo)
2681 {
2682     struct sigaction oact;
2683     PERL_UNUSED_CONTEXT;
2684
2685     if (sigaction(signo, (struct sigaction *)NULL, &oact) == -1)
2686         return (Sighandler_t) SIG_ERR;
2687     else
2688         return (Sighandler_t) oact.sa_handler;
2689 }
2690
2691 int
2692 Perl_rsignal_save(pTHX_ int signo, Sighandler_t handler, Sigsave_t *save)
2693 {
2694     dVAR;
2695     struct sigaction act;
2696
2697 #ifdef USE_ITHREADS
2698     /* only "parent" interpreter can diddle signals */
2699     if (PL_curinterp != aTHX)
2700         return -1;
2701 #endif
2702
2703     act.sa_handler = (void(*)(int))handler;
2704     sigemptyset(&act.sa_mask);
2705     act.sa_flags = 0;
2706 #ifdef SA_RESTART
2707     if (PL_signals & PERL_SIGNALS_UNSAFE_FLAG)
2708         act.sa_flags |= SA_RESTART;     /* SVR4, 4.3+BSD */
2709 #endif
2710 #if defined(SA_NOCLDWAIT) && !defined(BSDish) /* See [perl #18849] */
2711     if (signo == SIGCHLD && handler == (Sighandler_t) SIG_IGN)
2712         act.sa_flags |= SA_NOCLDWAIT;
2713 #endif
2714     return sigaction(signo, &act, save);
2715 }
2716
2717 int
2718 Perl_rsignal_restore(pTHX_ int signo, Sigsave_t *save)
2719 {
2720     dVAR;
2721 #ifdef USE_ITHREADS
2722     /* only "parent" interpreter can diddle signals */
2723     if (PL_curinterp != aTHX)
2724         return -1;
2725 #endif
2726
2727     return sigaction(signo, save, (struct sigaction *)NULL);
2728 }
2729
2730 #else /* !HAS_SIGACTION */
2731
2732 Sighandler_t
2733 Perl_rsignal(pTHX_ int signo, Sighandler_t handler)
2734 {
2735 #if defined(USE_ITHREADS) && !defined(WIN32)
2736     /* only "parent" interpreter can diddle signals */
2737     if (PL_curinterp != aTHX)
2738         return (Sighandler_t) SIG_ERR;
2739 #endif
2740
2741     return PerlProc_signal(signo, handler);
2742 }
2743
2744 static Signal_t
2745 sig_trap(int signo)
2746 {
2747     dVAR;
2748     PL_sig_trapped++;
2749 }
2750
2751 Sighandler_t
2752 Perl_rsignal_state(pTHX_ int signo)
2753 {
2754     dVAR;
2755     Sighandler_t oldsig;
2756
2757 #if defined(USE_ITHREADS) && !defined(WIN32)
2758     /* only "parent" interpreter can diddle signals */
2759     if (PL_curinterp != aTHX)
2760         return (Sighandler_t) SIG_ERR;
2761 #endif
2762
2763     PL_sig_trapped = 0;
2764     oldsig = PerlProc_signal(signo, sig_trap);
2765     PerlProc_signal(signo, oldsig);
2766     if (PL_sig_trapped)
2767         PerlProc_kill(PerlProc_getpid(), signo);
2768     return oldsig;
2769 }
2770
2771 int
2772 Perl_rsignal_save(pTHX_ int signo, Sighandler_t handler, Sigsave_t *save)
2773 {
2774 #if defined(USE_ITHREADS) && !defined(WIN32)
2775     /* only "parent" interpreter can diddle signals */
2776     if (PL_curinterp != aTHX)
2777         return -1;
2778 #endif
2779     *save = PerlProc_signal(signo, handler);
2780     return (*save == (Sighandler_t) SIG_ERR) ? -1 : 0;
2781 }
2782
2783 int
2784 Perl_rsignal_restore(pTHX_ int signo, Sigsave_t *save)
2785 {
2786 #if defined(USE_ITHREADS) && !defined(WIN32)
2787     /* only "parent" interpreter can diddle signals */
2788     if (PL_curinterp != aTHX)
2789         return -1;
2790 #endif
2791     return (PerlProc_signal(signo, *save) == (Sighandler_t) SIG_ERR) ? -1 : 0;
2792 }
2793
2794 #endif /* !HAS_SIGACTION */
2795 #endif /* !PERL_MICRO */
2796
2797     /* VMS' my_pclose() is in VMS.c; same with OS/2 */
2798 #if (!defined(DOSISH) || defined(HAS_FORK) || defined(AMIGAOS)) && !defined(VMS) && !defined(__OPEN_VM) && !defined(EPOC) && !defined(MACOS_TRADITIONAL)
2799 I32
2800 Perl_my_pclose(pTHX_ PerlIO *ptr)
2801 {
2802     dVAR;
2803     Sigsave_t hstat, istat, qstat;
2804     int status;
2805     SV **svp;
2806     Pid_t pid;
2807     Pid_t pid2;
2808     bool close_failed;
2809     int saved_errno = 0;
2810 #ifdef WIN32
2811     int saved_win32_errno;
2812 #endif
2813
2814     LOCK_FDPID_MUTEX;
2815     svp = av_fetch(PL_fdpid,PerlIO_fileno(ptr),TRUE);
2816     UNLOCK_FDPID_MUTEX;
2817     pid = (SvTYPE(*svp) == SVt_IV) ? SvIVX(*svp) : -1;
2818     SvREFCNT_dec(*svp);
2819     *svp = &PL_sv_undef;
2820 #ifdef OS2
2821     if (pid == -1) {                    /* Opened by popen. */
2822         return my_syspclose(ptr);
2823     }
2824 #endif
2825     if ((close_failed = (PerlIO_close(ptr) == EOF))) {
2826         saved_errno = errno;
2827 #ifdef WIN32
2828         saved_win32_errno = GetLastError();
2829 #endif
2830     }
2831 #ifdef UTS
2832     if(PerlProc_kill(pid, 0) < 0) { return(pid); }   /* HOM 12/23/91 */
2833 #endif
2834 #ifndef PERL_MICRO
2835     rsignal_save(SIGHUP,  (Sighandler_t) SIG_IGN, &hstat);
2836     rsignal_save(SIGINT,  (Sighandler_t) SIG_IGN, &istat);
2837     rsignal_save(SIGQUIT, (Sighandler_t) SIG_IGN, &qstat);
2838 #endif
2839     do {
2840         pid2 = wait4pid(pid, &status, 0);
2841     } while (pid2 == -1 && errno == EINTR);
2842 #ifndef PERL_MICRO
2843     rsignal_restore(SIGHUP, &hstat);
2844     rsignal_restore(SIGINT, &istat);
2845     rsignal_restore(SIGQUIT, &qstat);
2846 #endif
2847     if (close_failed) {
2848         SETERRNO(saved_errno, 0);
2849         return -1;
2850     }
2851     return(pid2 < 0 ? pid2 : status == 0 ? 0 : (errno = 0, status));
2852 }
2853 #endif /* !DOSISH */
2854
2855 #if  (!defined(DOSISH) || defined(OS2) || defined(WIN32) || defined(NETWARE)) && !defined(MACOS_TRADITIONAL)
2856 I32
2857 Perl_wait4pid(pTHX_ Pid_t pid, int *statusp, int flags)
2858 {
2859     dVAR;
2860     I32 result = 0;
2861     if (!pid)
2862         return -1;
2863 #ifdef PERL_USES_PL_PIDSTATUS
2864     {
2865         if (pid > 0) {
2866             /* The keys in PL_pidstatus are now the raw 4 (or 8) bytes of the
2867                pid, rather than a string form.  */
2868             SV * const * const svp = hv_fetch(PL_pidstatus,(const char*) &pid,sizeof(Pid_t),FALSE);
2869             if (svp && *svp != &PL_sv_undef) {
2870                 *statusp = SvIVX(*svp);
2871                 (void)hv_delete(PL_pidstatus,(const char*) &pid,sizeof(Pid_t),
2872                                 G_DISCARD);
2873                 return pid;
2874             }
2875         }
2876         else {
2877             HE *entry;
2878
2879             hv_iterinit(PL_pidstatus);
2880             if ((entry = hv_iternext(PL_pidstatus))) {
2881                 SV * const sv = hv_iterval(PL_pidstatus,entry);
2882                 I32 len;
2883                 const char * const spid = hv_iterkey(entry,&len);
2884
2885                 assert (len == sizeof(Pid_t));
2886                 memcpy((char *)&pid, spid, len);
2887                 *statusp = SvIVX(sv);
2888                 /* The hash iterator is currently on this entry, so simply
2889                    calling hv_delete would trigger the lazy delete, which on
2890                    aggregate does more work, beacuse next call to hv_iterinit()
2891                    would spot the flag, and have to call the delete routine,
2892                    while in the meantime any new entries can't re-use that
2893                    memory.  */
2894                 hv_iterinit(PL_pidstatus);
2895                 (void)hv_delete(PL_pidstatus,spid,len,G_DISCARD);
2896                 return pid;
2897             }
2898         }
2899     }
2900 #endif
2901 #ifdef HAS_WAITPID
2902 #  ifdef HAS_WAITPID_RUNTIME
2903     if (!HAS_WAITPID_RUNTIME)
2904         goto hard_way;
2905 #  endif
2906     result = PerlProc_waitpid(pid,statusp,flags);
2907     goto finish;
2908 #endif
2909 #if !defined(HAS_WAITPID) && defined(HAS_WAIT4)
2910     result = wait4((pid==-1)?0:pid,statusp,flags,NULL);
2911     goto finish;
2912 #endif
2913 #ifdef PERL_USES_PL_PIDSTATUS
2914 #if defined(HAS_WAITPID) && defined(HAS_WAITPID_RUNTIME)
2915   hard_way:
2916 #endif
2917     {
2918         if (flags)
2919             Perl_croak(aTHX_ "Can't do waitpid with flags");
2920         else {
2921             while ((result = PerlProc_wait(statusp)) != pid && pid > 0 && result >= 0)
2922                 pidgone(result,*statusp);
2923             if (result < 0)
2924                 *statusp = -1;
2925         }
2926     }
2927 #endif
2928 #if defined(HAS_WAITPID) || defined(HAS_WAIT4)
2929   finish:
2930 #endif
2931     if (result < 0 && errno == EINTR) {
2932         PERL_ASYNC_CHECK();
2933     }
2934     return result;
2935 }
2936 #endif /* !DOSISH || OS2 || WIN32 || NETWARE */
2937
2938 #ifdef PERL_USES_PL_PIDSTATUS
2939 void
2940 Perl_pidgone(pTHX_ Pid_t pid, int status)
2941 {
2942     register SV *sv;
2943
2944     sv = *hv_fetch(PL_pidstatus,(const char*)&pid,sizeof(Pid_t),TRUE);
2945     SvUPGRADE(sv,SVt_IV);
2946     SvIV_set(sv, status);
2947     return;
2948 }
2949 #endif
2950
2951 #if defined(atarist) || defined(OS2) || defined(EPOC)
2952 int pclose();
2953 #ifdef HAS_FORK
2954 int                                     /* Cannot prototype with I32
2955                                            in os2ish.h. */
2956 my_syspclose(PerlIO *ptr)
2957 #else
2958 I32
2959 Perl_my_pclose(pTHX_ PerlIO *ptr)
2960 #endif
2961 {
2962     /* Needs work for PerlIO ! */
2963     FILE * const f = PerlIO_findFILE(ptr);
2964     const I32 result = pclose(f);
2965     PerlIO_releaseFILE(ptr,f);
2966     return result;
2967 }
2968 #endif
2969
2970 #if defined(DJGPP)
2971 int djgpp_pclose();
2972 I32
2973 Perl_my_pclose(pTHX_ PerlIO *ptr)
2974 {
2975     /* Needs work for PerlIO ! */
2976     FILE * const f = PerlIO_findFILE(ptr);
2977     I32 result = djgpp_pclose(f);
2978     result = (result << 8) & 0xff00;
2979     PerlIO_releaseFILE(ptr,f);
2980     return result;
2981 }
2982 #endif
2983
2984 void
2985 Perl_repeatcpy(pTHX_ register char *to, register const char *from, I32 len, register I32 count)
2986 {
2987     register I32 todo;
2988     register const char * const frombase = from;
2989     PERL_UNUSED_CONTEXT;
2990
2991     if (len == 1) {
2992         register const char c = *from;
2993         while (count-- > 0)
2994             *to++ = c;
2995         return;
2996     }
2997     while (count-- > 0) {
2998         for (todo = len; todo > 0; todo--) {
2999             *to++ = *from++;
3000         }
3001         from = frombase;
3002     }
3003 }
3004
3005 #ifndef HAS_RENAME
3006 I32
3007 Perl_same_dirent(pTHX_ const char *a, const char *b)
3008 {
3009     char *fa = strrchr(a,'/');
3010     char *fb = strrchr(b,'/');
3011     Stat_t tmpstatbuf1;
3012     Stat_t tmpstatbuf2;
3013     SV * const tmpsv = sv_newmortal();
3014
3015     if (fa)
3016         fa++;
3017     else
3018         fa = a;
3019     if (fb)
3020         fb++;
3021     else
3022         fb = b;
3023     if (strNE(a,b))
3024         return FALSE;
3025     if (fa == a)
3026         sv_setpvn(tmpsv, ".", 1);
3027     else
3028         sv_setpvn(tmpsv, a, fa - a);
3029     if (PerlLIO_stat(SvPVX_const(tmpsv), &tmpstatbuf1) < 0)
3030         return FALSE;
3031     if (fb == b)
3032         sv_setpvn(tmpsv, ".", 1);
3033     else
3034         sv_setpvn(tmpsv, b, fb - b);
3035     if (PerlLIO_stat(SvPVX_const(tmpsv), &tmpstatbuf2) < 0)
3036         return FALSE;
3037     return tmpstatbuf1.st_dev == tmpstatbuf2.st_dev &&
3038            tmpstatbuf1.st_ino == tmpstatbuf2.st_ino;
3039 }
3040 #endif /* !HAS_RENAME */
3041
3042 char*
3043 Perl_find_script(pTHX_ const char *scriptname, bool dosearch,
3044                  const char *const *const search_ext, I32 flags)
3045 {
3046     dVAR;
3047     const char *xfound = NULL;
3048     char *xfailed = NULL;
3049     char tmpbuf[MAXPATHLEN];
3050     register char *s;
3051     I32 len = 0;
3052     int retval;
3053     char *bufend;
3054 #if defined(DOSISH) && !defined(OS2) && !defined(atarist)
3055 #  define SEARCH_EXTS ".bat", ".cmd", NULL
3056 #  define MAX_EXT_LEN 4
3057 #endif
3058 #ifdef OS2
3059 #  define SEARCH_EXTS ".cmd", ".btm", ".bat", ".pl", NULL
3060 #  define MAX_EXT_LEN 4
3061 #endif
3062 #ifdef VMS
3063 #  define SEARCH_EXTS ".pl", ".com", NULL
3064 #  define MAX_EXT_LEN 4
3065 #endif
3066     /* additional extensions to try in each dir if scriptname not found */
3067 #ifdef SEARCH_EXTS
3068     static const char *const exts[] = { SEARCH_EXTS };
3069     const char *const *const ext = search_ext ? search_ext : exts;
3070     int extidx = 0, i = 0;
3071     const char *curext = NULL;
3072 #else
3073     PERL_UNUSED_ARG(search_ext);
3074 #  define MAX_EXT_LEN 0
3075 #endif
3076
3077     /*
3078      * If dosearch is true and if scriptname does not contain path
3079      * delimiters, search the PATH for scriptname.
3080      *
3081      * If SEARCH_EXTS is also defined, will look for each
3082      * scriptname{SEARCH_EXTS} whenever scriptname is not found
3083      * while searching the PATH.
3084      *
3085      * Assuming SEARCH_EXTS is C<".foo",".bar",NULL>, PATH search
3086      * proceeds as follows:
3087      *   If DOSISH or VMSISH:
3088      *     + look for ./scriptname{,.foo,.bar}
3089      *     + search the PATH for scriptname{,.foo,.bar}
3090      *
3091      *   If !DOSISH:
3092      *     + look *only* in the PATH for scriptname{,.foo,.bar} (note
3093      *       this will not look in '.' if it's not in the PATH)
3094      */
3095     tmpbuf[0] = '\0';
3096
3097 #ifdef VMS
3098 #  ifdef ALWAYS_DEFTYPES
3099     len = strlen(scriptname);
3100     if (!(len == 1 && *scriptname == '-') && scriptname[len-1] != ':') {
3101         int idx = 0, deftypes = 1;
3102         bool seen_dot = 1;
3103
3104         const int hasdir = !dosearch || (strpbrk(scriptname,":[</") != NULL);
3105 #  else
3106     if (dosearch) {
3107         int idx = 0, deftypes = 1;
3108         bool seen_dot = 1;
3109
3110         const int hasdir = (strpbrk(scriptname,":[</") != NULL);
3111 #  endif
3112         /* The first time through, just add SEARCH_EXTS to whatever we
3113          * already have, so we can check for default file types. */
3114         while (deftypes ||
3115                (!hasdir && my_trnlnm("DCL$PATH",tmpbuf,idx++)) )
3116         {
3117             if (deftypes) {
3118                 deftypes = 0;
3119                 *tmpbuf = '\0';
3120             }
3121             if ((strlen(tmpbuf) + strlen(scriptname)
3122                  + MAX_EXT_LEN) >= sizeof tmpbuf)
3123                 continue;       /* don't search dir with too-long name */
3124             my_strlcat(tmpbuf, scriptname, sizeof(tmpbuf));
3125 #else  /* !VMS */
3126
3127 #ifdef DOSISH
3128     if (strEQ(scriptname, "-"))
3129         dosearch = 0;
3130     if (dosearch) {             /* Look in '.' first. */
3131         const char *cur = scriptname;
3132 #ifdef SEARCH_EXTS
3133         if ((curext = strrchr(scriptname,'.'))) /* possible current ext */
3134             while (ext[i])
3135                 if (strEQ(ext[i++],curext)) {
3136                     extidx = -1;                /* already has an ext */
3137                     break;
3138                 }
3139         do {
3140 #endif
3141             DEBUG_p(PerlIO_printf(Perl_debug_log,
3142                                   "Looking for %s\n",cur));
3143             if (PerlLIO_stat(cur,&PL_statbuf) >= 0
3144                 && !S_ISDIR(PL_statbuf.st_mode)) {
3145                 dosearch = 0;
3146                 scriptname = cur;
3147 #ifdef SEARCH_EXTS
3148                 break;
3149 #endif
3150             }
3151 #ifdef SEARCH_EXTS
3152             if (cur == scriptname) {
3153                 len = strlen(scriptname);
3154                 if (len+MAX_EXT_LEN+1 >= sizeof(tmpbuf))
3155                     break;
3156                 my_strlcpy(tmpbuf, scriptname, sizeof(tmpbuf));
3157                 cur = tmpbuf;
3158             }
3159         } while (extidx >= 0 && ext[extidx]     /* try an extension? */
3160                  && my_strlcpy(tmpbuf+len, ext[extidx++], sizeof(tmpbuf) - len));
3161 #endif
3162     }
3163 #endif
3164
3165 #ifdef MACOS_TRADITIONAL
3166     if (dosearch && !strchr(scriptname, ':') &&
3167         (s = PerlEnv_getenv("Commands")))
3168 #else
3169     if (dosearch && !strchr(scriptname, '/')
3170 #ifdef DOSISH
3171                  && !strchr(scriptname, '\\')
3172 #endif
3173                  && (s = PerlEnv_getenv("PATH")))
3174 #endif
3175     {
3176         bool seen_dot = 0;
3177
3178         bufend = s + strlen(s);
3179         while (s < bufend) {
3180 #ifdef MACOS_TRADITIONAL
3181             s = delimcpy(tmpbuf, tmpbuf + sizeof tmpbuf, s, bufend,
3182                         ',',
3183                         &len);
3184 #else
3185 #if defined(atarist) || defined(DOSISH)
3186             for (len = 0; *s
3187 #  ifdef atarist
3188                     && *s != ','
3189 #  endif
3190                     && *s != ';'; len++, s++) {
3191                 if (len < sizeof tmpbuf)
3192                     tmpbuf[len] = *s;
3193             }
3194             if (len < sizeof tmpbuf)
3195                 tmpbuf[len] = '\0';
3196 #else  /* ! (atarist || DOSISH) */
3197             s = delimcpy(tmpbuf, tmpbuf + sizeof tmpbuf, s, bufend,
3198                         ':',
3199                         &len);
3200 #endif /* ! (atarist || DOSISH) */
3201 #endif /* MACOS_TRADITIONAL */
3202             if (s < bufend)
3203                 s++;
3204             if (len + 1 + strlen(scriptname) + MAX_EXT_LEN >= sizeof tmpbuf)
3205                 continue;       /* don't search dir with too-long name */
3206 #ifdef MACOS_TRADITIONAL
3207             if (len && tmpbuf[len - 1] != ':')
3208                 tmpbuf[len++] = ':';
3209 #else
3210             if (len
3211 #  if defined(atarist) || defined(__MINT__) || defined(DOSISH)
3212                 && tmpbuf[len - 1] != '/'
3213                 && tmpbuf[len - 1] != '\\'
3214 #  endif
3215                )
3216                 tmpbuf[len++] = '/';
3217             if (len == 2 && tmpbuf[0] == '.')
3218                 seen_dot = 1;
3219 #endif
3220             (void)my_strlcpy(tmpbuf + len, scriptname, sizeof(tmpbuf) - len);
3221 #endif  /* !VMS */
3222
3223 #ifdef SEARCH_EXTS
3224             len = strlen(tmpbuf);
3225             if (extidx > 0)     /* reset after previous loop */
3226                 extidx = 0;
3227             do {
3228 #endif
3229                 DEBUG_p(PerlIO_printf(Perl_debug_log, "Looking for %s\n",tmpbuf));
3230                 retval = PerlLIO_stat(tmpbuf,&PL_statbuf);
3231                 if (S_ISDIR(PL_statbuf.st_mode)) {
3232                     retval = -1;
3233                 }
3234 #ifdef SEARCH_EXTS
3235             } while (  retval < 0               /* not there */
3236                     && extidx>=0 && ext[extidx] /* try an extension? */
3237                     && my_strlcpy(tmpbuf+len, ext[extidx++], sizeof(tmpbuf) - len)
3238                 );
3239 #endif
3240             if (retval < 0)
3241                 continue;
3242             if (S_ISREG(PL_statbuf.st_mode)
3243                 && cando(S_IRUSR,TRUE,&PL_statbuf)
3244 #if !defined(DOSISH) && !defined(MACOS_TRADITIONAL)
3245                 && cando(S_IXUSR,TRUE,&PL_statbuf)
3246 #endif
3247                 )
3248             {
3249                 xfound = tmpbuf;                /* bingo! */
3250                 break;
3251             }
3252             if (!xfailed)
3253                 xfailed = savepv(tmpbuf);
3254         }
3255 #ifndef DOSISH
3256         if (!xfound && !seen_dot && !xfailed &&
3257             (PerlLIO_stat(scriptname,&PL_statbuf) < 0
3258              || S_ISDIR(PL_statbuf.st_mode)))
3259 #endif
3260             seen_dot = 1;                       /* Disable message. */
3261         if (!xfound) {
3262             if (flags & 1) {                    /* do or die? */
3263                 Perl_croak(aTHX_ "Can't %s %s%s%s",
3264                       (xfailed ? "execute" : "find"),
3265                       (xfailed ? xfailed : scriptname),
3266                       (xfailed ? "" : " on PATH"),
3267                       (xfailed || seen_dot) ? "" : ", '.' not in PATH");
3268             }
3269             scriptname = NULL;
3270         }
3271         Safefree(xfailed);
3272         scriptname = xfound;
3273     }
3274     return (scriptname ? savepv(scriptname) : NULL);
3275 }
3276
3277 #ifndef PERL_GET_CONTEXT_DEFINED
3278
3279 void *
3280 Perl_get_context(void)
3281 {
3282     dVAR;
3283 #if defined(USE_ITHREADS)
3284 #  ifdef OLD_PTHREADS_API
3285     pthread_addr_t t;
3286     if (pthread_getspecific(PL_thr_key, &t))
3287         Perl_croak_nocontext("panic: pthread_getspecific");
3288     return (void*)t;
3289 #  else
3290 #    ifdef I_MACH_CTHREADS
3291     return (void*)cthread_data(cthread_self());
3292 #    else
3293     return (void*)PTHREAD_GETSPECIFIC(PL_thr_key);
3294 #    endif
3295 #  endif
3296 #else
3297     return (void*)NULL;
3298 #endif
3299 }
3300
3301 void
3302 Perl_set_context(void *t)
3303 {
3304     dVAR;
3305 #if defined(USE_ITHREADS)
3306 #  ifdef I_MACH_CTHREADS
3307     cthread_set_data(cthread_self(), t);
3308 #  else
3309     if (pthread_setspecific(PL_thr_key, t))
3310         Perl_croak_nocontext("panic: pthread_setspecific");
3311 #  endif
3312 #else
3313     PERL_UNUSED_ARG(t);
3314 #endif
3315 }
3316
3317 #endif /* !PERL_GET_CONTEXT_DEFINED */
3318
3319 #if defined(PERL_GLOBAL_STRUCT) && !defined(PERL_GLOBAL_STRUCT_PRIVATE)
3320 struct perl_vars *
3321 Perl_GetVars(pTHX)
3322 {
3323  return &PL_Vars;
3324 }
3325 #endif
3326
3327 char **
3328 Perl_get_op_names(pTHX)
3329 {
3330     PERL_UNUSED_CONTEXT;
3331     return (char **)PL_op_name;
3332 }
3333
3334 char **
3335 Perl_get_op_descs(pTHX)
3336 {
3337     PERL_UNUSED_CONTEXT;
3338     return (char **)PL_op_desc;
3339 }
3340
3341 const char *
3342 Perl_get_no_modify(pTHX)
3343 {
3344     PERL_UNUSED_CONTEXT;
3345     return PL_no_modify;
3346 }
3347
3348 U32 *
3349 Perl_get_opargs(pTHX)
3350 {
3351     PERL_UNUSED_CONTEXT;
3352     return (U32 *)PL_opargs;
3353 }
3354
3355 PPADDR_t*
3356 Perl_get_ppaddr(pTHX)
3357 {
3358     dVAR;
3359     PERL_UNUSED_CONTEXT;
3360     return (PPADDR_t*)PL_ppaddr;
3361 }
3362
3363 #ifndef HAS_GETENV_LEN
3364 char *
3365 Perl_getenv_len(pTHX_ const char *env_elem, unsigned long *len)
3366 {
3367     char * const env_trans = PerlEnv_getenv(env_elem);
3368     PERL_UNUSED_CONTEXT;
3369     if (env_trans)
3370         *len = strlen(env_trans);
3371     return env_trans;
3372 }
3373 #endif
3374
3375
3376 MGVTBL*
3377 Perl_get_vtbl(pTHX_ int vtbl_id)
3378 {
3379     const MGVTBL* result;
3380     PERL_UNUSED_CONTEXT;
3381
3382     switch(vtbl_id) {
3383     case want_vtbl_sv:
3384         result = &PL_vtbl_sv;
3385         break;
3386     case want_vtbl_env:
3387         result = &PL_vtbl_env;
3388         break;
3389     case want_vtbl_envelem:
3390         result = &PL_vtbl_envelem;
3391         break;
3392     case want_vtbl_sig:
3393         result = &PL_vtbl_sig;
3394         break;
3395     case want_vtbl_sigelem:
3396         result = &PL_vtbl_sigelem;
3397         break;
3398     case want_vtbl_pack:
3399         result = &PL_vtbl_pack;
3400         break;
3401     case want_vtbl_packelem:
3402         result = &PL_vtbl_packelem;
3403         break;
3404     case want_vtbl_dbline:
3405         result = &PL_vtbl_dbline;
3406         break;
3407     case want_vtbl_isa:
3408         result = &PL_vtbl_isa;
3409         break;
3410     case want_vtbl_isaelem:
3411         result = &PL_vtbl_isaelem;
3412         break;
3413     case want_vtbl_arylen:
3414         result = &PL_vtbl_arylen;
3415         break;
3416     case want_vtbl_mglob:
3417         result = &PL_vtbl_mglob;
3418         break;
3419     case want_vtbl_nkeys:
3420         result = &PL_vtbl_nkeys;
3421         break;
3422     case want_vtbl_taint:
3423         result = &PL_vtbl_taint;
3424         break;
3425     case want_vtbl_substr:
3426         result = &PL_vtbl_substr;
3427         break;
3428     case want_vtbl_vec:
3429         result = &PL_vtbl_vec;
3430         break;
3431     case want_vtbl_pos:
3432         result = &PL_vtbl_pos;
3433         break;
3434     case want_vtbl_bm:
3435         result = &PL_vtbl_bm;
3436         break;
3437     case want_vtbl_fm:
3438         result = &PL_vtbl_fm;
3439         break;
3440     case want_vtbl_uvar:
3441         result = &PL_vtbl_uvar;
3442         break;
3443     case want_vtbl_defelem:
3444         result = &PL_vtbl_defelem;
3445         break;
3446     case want_vtbl_regexp:
3447         result = &PL_vtbl_regexp;
3448         break;
3449     case want_vtbl_regdata:
3450         result = &PL_vtbl_regdata;
3451         break;
3452     case want_vtbl_regdatum:
3453         result = &PL_vtbl_regdatum;
3454         break;
3455 #ifdef USE_LOCALE_COLLATE
3456     case want_vtbl_collxfrm:
3457         result = &PL_vtbl_collxfrm;
3458         break;
3459 #endif
3460     case want_vtbl_amagic:
3461         result = &PL_vtbl_amagic;
3462         break;
3463     case want_vtbl_amagicelem:
3464         result = &PL_vtbl_amagicelem;
3465         break;
3466     case want_vtbl_backref:
3467         result = &PL_vtbl_backref;
3468         break;
3469     case want_vtbl_utf8:
3470         result = &PL_vtbl_utf8;
3471         break;
3472     default:
3473         result = NULL;
3474         break;
3475     }
3476     return (MGVTBL*)result;
3477 }
3478
3479 I32
3480 Perl_my_fflush_all(pTHX)
3481 {
3482 #if defined(USE_PERLIO) || defined(FFLUSH_NULL) || defined(USE_SFIO)
3483     return PerlIO_flush(NULL);
3484 #else
3485 # if defined(HAS__FWALK)
3486     extern int fflush(FILE *);
3487     /* undocumented, unprototyped, but very useful BSDism */
3488     extern void _fwalk(int (*)(FILE *));
3489     _fwalk(&fflush);
3490     return 0;
3491 # else
3492 #  if defined(FFLUSH_ALL) && defined(HAS_STDIO_STREAM_ARRAY)
3493     long open_max = -1;
3494 #   ifdef PERL_FFLUSH_ALL_FOPEN_MAX
3495     open_max = PERL_FFLUSH_ALL_FOPEN_MAX;
3496 #   else
3497 #    if defined(HAS_SYSCONF) && defined(_SC_OPEN_MAX)
3498     open_max = sysconf(_SC_OPEN_MAX);
3499 #     else
3500 #      ifdef FOPEN_MAX
3501     open_max = FOPEN_MAX;
3502 #      else
3503 #       ifdef OPEN_MAX
3504     open_max = OPEN_MAX;
3505 #       else
3506 #        ifdef _NFILE
3507     open_max = _NFILE;
3508 #        endif
3509 #       endif
3510 #      endif
3511 #     endif
3512 #    endif
3513     if (open_max > 0) {
3514       long i;
3515       for (i = 0; i < open_max; i++)
3516             if (STDIO_STREAM_ARRAY[i]._file >= 0 &&
3517                 STDIO_STREAM_ARRAY[i]._file < open_max &&
3518                 STDIO_STREAM_ARRAY[i]._flag)
3519                 PerlIO_flush(&STDIO_STREAM_ARRAY[i]);
3520       return 0;
3521     }
3522 #  endif
3523     SETERRNO(EBADF,RMS_IFI);
3524     return EOF;
3525 # endif
3526 #endif
3527 }
3528
3529 void
3530 Perl_report_evil_fh(pTHX_ const GV *gv, const IO *io, I32 op)
3531 {
3532     const char * const name = gv && isGV(gv) ? GvENAME(gv) : NULL;
3533
3534     if (op == OP_phoney_OUTPUT_ONLY || op == OP_phoney_INPUT_ONLY) {
3535         if (ckWARN(WARN_IO)) {
3536             const char * const direction =
3537                 (const char *)((op == OP_phoney_INPUT_ONLY) ? "in" : "out");
3538             if (name && *name)
3539                 Perl_warner(aTHX_ packWARN(WARN_IO),
3540                             "Filehandle %s opened only for %sput",
3541                             name, direction);
3542             else
3543                 Perl_warner(aTHX_ packWARN(WARN_IO),
3544                             "Filehandle opened only for %sput", direction);
3545         }
3546     }
3547     else {
3548         const char *vile;
3549         I32   warn_type;
3550
3551         if (gv && io && IoTYPE(io) == IoTYPE_CLOSED) {
3552             vile = "closed";
3553             warn_type = WARN_CLOSED;
3554         }
3555         else {
3556             vile = "unopened";
3557             warn_type = WARN_UNOPENED;
3558         }
3559
3560         if (ckWARN(warn_type)) {
3561             const char * const pars =
3562                 (const char *)(OP_IS_FILETEST(op) ? "" : "()");
3563             const char * const func =
3564                 (const char *)
3565                 (op == OP_READLINE   ? "readline"  :    /* "<HANDLE>" not nice */
3566                  op == OP_LEAVEWRITE ? "write" :                /* "write exit" not nice */
3567                  op < 0              ? "" :              /* handle phoney cases */
3568                  PL_op_desc[op]);
3569             const char * const type =
3570                 (const char *)
3571                 (OP_IS_SOCKET(op) ||
3572                  (gv && io && IoTYPE(io) == IoTYPE_SOCKET) ?
3573                  "socket" : "filehandle");
3574             if (name && *name) {
3575                 Perl_warner(aTHX_ packWARN(warn_type),
3576                             "%s%s on %s %s %s", func, pars, vile, type, name);
3577                 if (io && IoDIRP(io) && !(IoFLAGS(io) & IOf_FAKE_DIRP))
3578                     Perl_warner(
3579                         aTHX_ packWARN(warn_type),
3580                         "\t(Are you trying to call %s%s on dirhandle %s?)\n",
3581                         func, pars, name
3582                     );
3583             }
3584             else {
3585                 Perl_warner(aTHX_ packWARN(warn_type),
3586                             "%s%s on %s %s", func, pars, vile, type);
3587                 if (gv && io && IoDIRP(io) && !(IoFLAGS(io) & IOf_FAKE_DIRP))
3588                     Perl_warner(
3589                         aTHX_ packWARN(warn_type),
3590                         "\t(Are you trying to call %s%s on dirhandle?)\n",
3591                         func, pars
3592                     );
3593             }
3594         }
3595     }
3596 }
3597
3598 #ifdef EBCDIC
3599 /* in ASCII order, not that it matters */
3600 static const char controllablechars[] = "?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_";
3601
3602 int
3603 Perl_ebcdic_control(pTHX_ int ch)
3604 {
3605     if (ch > 'a') {
3606         const char *ctlp;
3607
3608         if (islower(ch))
3609             ch = toupper(ch);
3610
3611         if ((ctlp = strchr(controllablechars, ch)) == 0) {
3612             Perl_die(aTHX_ "unrecognised control character '%c'\n", ch);
3613         }
3614
3615         if (ctlp == controllablechars)
3616             return('\177'); /* DEL */
3617         else
3618             return((unsigned char)(ctlp - controllablechars - 1));
3619     } else { /* Want uncontrol */
3620         if (ch == '\177' || ch == -1)
3621             return('?');
3622         else if (ch == '\157')
3623             return('\177');
3624         else if (ch == '\174')
3625             return('\000');
3626         else if (ch == '^')    /* '\137' in 1047, '\260' in 819 */
3627             return('\036');
3628         else if (ch == '\155')
3629             return('\037');
3630         else if (0 < ch && ch < (sizeof(controllablechars) - 1))
3631             return(controllablechars[ch+1]);
3632         else
3633             Perl_die(aTHX_ "invalid control request: '\\%03o'\n", ch & 0xFF);
3634     }
3635 }
3636 #endif
3637
3638 /* To workaround core dumps from the uninitialised tm_zone we get the
3639  * system to give us a reasonable struct to copy.  This fix means that
3640  * strftime uses the tm_zone and tm_gmtoff values returned by
3641  * localtime(time()). That should give the desired result most of the
3642  * time. But probably not always!
3643  *
3644  * This does not address tzname aspects of NETaa14816.
3645  *
3646  */
3647
3648 #ifdef HAS_GNULIBC
3649 # ifndef STRUCT_TM_HASZONE
3650 #    define STRUCT_TM_HASZONE
3651 # endif
3652 #endif
3653
3654 #ifdef STRUCT_TM_HASZONE /* Backward compat */
3655 # ifndef HAS_TM_TM_ZONE
3656 #    define HAS_TM_TM_ZONE
3657 # endif
3658 #endif
3659
3660 void
3661 Perl_init_tm(pTHX_ struct tm *ptm)      /* see mktime, strftime and asctime */
3662 {
3663 #ifdef HAS_TM_TM_ZONE
3664     Time_t now;
3665     const struct tm* my_tm;
3666     (void)time(&now);
3667     my_tm = localtime(&now);
3668     if (my_tm)
3669         Copy(my_tm, ptm, 1, struct tm);
3670 #else
3671     PERL_UNUSED_ARG(ptm);
3672 #endif
3673 }
3674
3675 /*
3676  * mini_mktime - normalise struct tm values without the localtime()
3677  * semantics (and overhead) of mktime().
3678  */
3679 void
3680 Perl_mini_mktime(pTHX_ struct tm *ptm)
3681 {
3682     int yearday;
3683     int secs;
3684     int month, mday, year, jday;
3685     int odd_cent, odd_year;
3686     PERL_UNUSED_CONTEXT;
3687
3688 #define DAYS_PER_YEAR   365
3689 #define DAYS_PER_QYEAR  (4*DAYS_PER_YEAR+1)
3690 #define DAYS_PER_CENT   (25*DAYS_PER_QYEAR-1)
3691 #define DAYS_PER_QCENT  (4*DAYS_PER_CENT+1)
3692 #define SECS_PER_HOUR   (60*60)
3693 #define SECS_PER_DAY    (24*SECS_PER_HOUR)
3694 /* parentheses deliberately absent on these two, otherwise they don't work */
3695 #define MONTH_TO_DAYS   153/5
3696 #define DAYS_TO_MONTH   5/153
3697 /* offset to bias by March (month 4) 1st between month/mday & year finding */
3698 #define YEAR_ADJUST     (4*MONTH_TO_DAYS+1)
3699 /* as used here, the algorithm leaves Sunday as day 1 unless we adjust it */
3700 #define WEEKDAY_BIAS    6       /* (1+6)%7 makes Sunday 0 again */
3701
3702 /*
3703  * Year/day algorithm notes:
3704  *
3705  * With a suitable offset for numeric value of the month, one can find
3706  * an offset into the year by considering months to have 30.6 (153/5) days,
3707  * using integer arithmetic (i.e., with truncation).  To avoid too much
3708  * messing about with leap days, we consider January and February to be
3709  * the 13th and 14th month of the previous year.  After that transformation,
3710  * we need the month index we use to be high by 1 from 'normal human' usage,
3711  * so the month index values we use run from 4 through 15.
3712  *
3713  * Given that, and the rules for the Gregorian calendar (leap years are those
3714  * divisible by 4 unless also divisible by 100, when they must be divisible
3715  * by 400 instead), we can simply calculate the number of days since some
3716  * arbitrary 'beginning of time' by futzing with the (adjusted) year number,
3717  * the days we derive from our month index, and adding in the day of the
3718  * month.  The value used here is not adjusted for the actual origin which
3719  * it normally would use (1 January A.D. 1), since we're not exposing it.
3720  * We're only building the value so we can turn around and get the
3721  * normalised values for the year, month, day-of-month, and day-of-year.
3722  *
3723  * For going backward, we need to bias the value we're using so that we find
3724  * the right year value.  (Basically, we don't want the contribution of
3725  * March 1st to the number to apply while deriving the year).  Having done
3726  * that, we 'count up' the contribution to the year number by accounting for
3727  * full quadracenturies (400-year periods) with their extra leap days, plus
3728  * the contribution from full centuries (to avoid counting in the lost leap
3729  * days), plus the contribution from full quad-years (to count in the normal
3730  * leap days), plus the leftover contribution from any non-leap years.
3731  * At this point, if we were working with an actual leap day, we'll have 0
3732  * days left over.  This is also true for March 1st, however.  So, we have
3733  * to special-case that result, and (earlier) keep track of the 'odd'
3734  * century and year contributions.  If we got 4 extra centuries in a qcent,
3735  * or 4 extra years in a qyear, then it's a leap day and we call it 29 Feb.
3736  * Otherwise, we add back in the earlier bias we removed (the 123 from
3737  * figuring in March 1st), find the month index (integer division by 30.6),
3738  * and the remainder is the day-of-month.  We then have to convert back to
3739  * 'real' months (including fixing January and February from being 14/15 in
3740  * the previous year to being in the proper year).  After that, to get
3741  * tm_yday, we work with the normalised year and get a new yearday value for
3742  * January 1st, which we subtract from the yearday value we had earlier,
3743  * representing the date we've re-built.  This is done from January 1
3744  * because tm_yday is 0-origin.
3745  *
3746  * Since POSIX time routines are only guaranteed to work for times since the
3747  * UNIX epoch (00:00:00 1 Jan 1970 UTC), the fact that this algorithm
3748  * applies Gregorian calendar rules even to dates before the 16th century
3749  * doesn't bother me.  Besides, you'd need cultural context for a given
3750  * date to know whether it was Julian or Gregorian calendar, and that's
3751  * outside the scope for this routine.  Since we convert back based on the
3752  * same rules we used to build the yearday, you'll only get strange results
3753  * for input which needed normalising, or for the 'odd' century years which
3754  * were leap years in the Julian calander but not in the Gregorian one.
3755  * I can live with that.
3756  *
3757  * This algorithm also fails to handle years before A.D. 1 gracefully, but
3758  * that's still outside the scope for POSIX time manipulation, so I don't
3759  * care.
3760  */
3761
3762     year = 1900 + ptm->tm_year;
3763     month = ptm->tm_mon;
3764     mday = ptm->tm_mday;
3765     /* allow given yday with no month & mday to dominate the result */
3766     if (ptm->tm_yday >= 0 && mday <= 0 && month <= 0) {
3767         month = 0;
3768         mday = 0;
3769         jday = 1 + ptm->tm_yday;
3770     }
3771     else {
3772         jday = 0;
3773     }
3774     if (month >= 2)
3775         month+=2;
3776     else
3777         month+=14, year--;
3778     yearday = DAYS_PER_YEAR * year + year/4 - year/100 + year/400;
3779     yearday += month*MONTH_TO_DAYS + mday + jday;
3780     /*
3781      * Note that we don't know when leap-seconds were or will be,
3782      * so we have to trust the user if we get something which looks
3783      * like a sensible leap-second.  Wild values for seconds will
3784      * be rationalised, however.
3785      */
3786     if ((unsigned) ptm->tm_sec <= 60) {
3787         secs = 0;
3788     }
3789     else {
3790         secs = ptm->tm_sec;
3791         ptm->tm_sec = 0;
3792     }
3793     secs += 60 * ptm->tm_min;
3794     secs += SECS_PER_HOUR * ptm->tm_hour;
3795     if (secs < 0) {
3796         if (secs-(secs/SECS_PER_DAY*SECS_PER_DAY) < 0) {
3797             /* got negative remainder, but need positive time */
3798             /* back off an extra day to compensate */
3799             yearday += (secs/SECS_PER_DAY)-1;
3800             secs -= SECS_PER_DAY * (secs/SECS_PER_DAY - 1);
3801         }
3802         else {
3803             yearday += (secs/SECS_PER_DAY);
3804             secs -= SECS_PER_DAY * (secs/SECS_PER_DAY);
3805         }
3806     }
3807     else if (secs >= SECS_PER_DAY) {
3808         yearday += (secs/SECS_PER_DAY);
3809         secs %= SECS_PER_DAY;
3810     }
3811     ptm->tm_hour = secs/SECS_PER_HOUR;
3812     secs %= SECS_PER_HOUR;
3813     ptm->tm_min = secs/60;
3814     secs %= 60;
3815     ptm->tm_sec += secs;
3816     /* done with time of day effects */
3817     /*
3818      * The algorithm for yearday has (so far) left it high by 428.
3819      * To avoid mistaking a legitimate Feb 29 as Mar 1, we need to
3820      * bias it by 123 while trying to figure out what year it
3821      * really represents.  Even with this tweak, the reverse
3822      * translation fails for years before A.D. 0001.
3823      * It would still fail for Feb 29, but we catch that one below.
3824      */
3825     jday = yearday;     /* save for later fixup vis-a-vis Jan 1 */
3826     yearday -= YEAR_ADJUST;
3827     year = (yearday / DAYS_PER_QCENT) * 400;
3828     yearday %= DAYS_PER_QCENT;
3829     odd_cent = yearday / DAYS_PER_CENT;
3830     year += odd_cent * 100;
3831     yearday %= DAYS_PER_CENT;
3832     year += (yearday / DAYS_PER_QYEAR) * 4;
3833     yearday %= DAYS_PER_QYEAR;
3834     odd_year = yearday / DAYS_PER_YEAR;
3835     year += odd_year;
3836     yearday %= DAYS_PER_YEAR;
3837     if (!yearday && (odd_cent==4 || odd_year==4)) { /* catch Feb 29 */
3838         month = 1;
3839         yearday = 29;
3840     }
3841     else {
3842         yearday += YEAR_ADJUST; /* recover March 1st crock */
3843         month = yearday*DAYS_TO_MONTH;
3844         yearday -= month*MONTH_TO_DAYS;
3845         /* recover other leap-year adjustment */
3846         if (month > 13) {
3847             month-=14;
3848             year++;
3849         }
3850         else {
3851             month-=2;
3852         }
3853     }
3854     ptm->tm_year = year - 1900;
3855     if (yearday) {
3856       ptm->tm_mday = yearday;
3857       ptm->tm_mon = month;
3858     }
3859     else {
3860       ptm->tm_mday = 31;
3861       ptm->tm_mon = month - 1;
3862     }
3863     /* re-build yearday based on Jan 1 to get tm_yday */
3864     year--;
3865     yearday = year*DAYS_PER_YEAR + year/4 - year/100 + year/400;
3866     yearday += 14*MONTH_TO_DAYS + 1;
3867     ptm->tm_yday = jday - yearday;
3868     /* fix tm_wday if not overridden by caller */
3869     if ((unsigned)ptm->tm_wday > 6)
3870         ptm->tm_wday = (jday + WEEKDAY_BIAS) % 7;
3871 }
3872
3873 char *
3874 Perl_my_strftime(pTHX_ const char *fmt, int sec, int min, int hour, int mday, int mon, int year, int wday, int yday, int isdst)
3875 {
3876 #ifdef HAS_STRFTIME
3877   char *buf;
3878   int buflen;
3879   struct tm mytm;
3880   int len;
3881
3882   init_tm(&mytm);       /* XXX workaround - see init_tm() above */
3883   mytm.tm_sec = sec;
3884   mytm.tm_min = min;
3885   mytm.tm_hour = hour;
3886   mytm.tm_mday = mday;
3887   mytm.tm_mon = mon;
3888   mytm.tm_year = year;
3889   mytm.tm_wday = wday;
3890   mytm.tm_yday = yday;
3891   mytm.tm_isdst = isdst;
3892   mini_mktime(&mytm);
3893   /* use libc to get the values for tm_gmtoff and tm_zone [perl #18238] */
3894 #if defined(HAS_MKTIME) && (defined(HAS_TM_TM_GMTOFF) || defined(HAS_TM_TM_ZONE))
3895   STMT_START {
3896     struct tm mytm2;
3897     mytm2 = mytm;
3898     mktime(&mytm2);
3899 #ifdef HAS_TM_TM_GMTOFF
3900     mytm.tm_gmtoff = mytm2.tm_gmtoff;
3901 #endif
3902 #ifdef HAS_TM_TM_ZONE
3903     mytm.tm_zone = mytm2.tm_zone;
3904 #endif
3905   } STMT_END;
3906 #endif
3907   buflen = 64;
3908   Newx(buf, buflen, char);
3909   len = strftime(buf, buflen, fmt, &mytm);
3910   /*
3911   ** The following is needed to handle to the situation where
3912   ** tmpbuf overflows.  Basically we want to allocate a buffer
3913   ** and try repeatedly.  The reason why it is so complicated
3914   ** is that getting a return value of 0 from strftime can indicate
3915   ** one of the following:
3916   ** 1. buffer overflowed,
3917   ** 2. illegal conversion specifier, or
3918   ** 3. the format string specifies nothing to be returned(not
3919   **      an error).  This could be because format is an empty string
3920   **    or it specifies %p that yields an empty string in some locale.
3921   ** If there is a better way to make it portable, go ahead by
3922   ** all means.
3923   */
3924   if ((len > 0 && len < buflen) || (len == 0 && *fmt == '\0'))
3925     return buf;
3926   else {
3927     /* Possibly buf overflowed - try again with a bigger buf */
3928     const int fmtlen = strlen(fmt);
3929     int bufsize = fmtlen + buflen;
3930
3931     Newx(buf, bufsize, char);
3932     while (buf) {
3933       buflen = strftime(buf, bufsize, fmt, &mytm);
3934       if (buflen > 0 && buflen < bufsize)
3935         break;
3936       /* heuristic to prevent out-of-memory errors */
3937       if (bufsize > 100*fmtlen) {
3938         Safefree(buf);
3939         buf = NULL;
3940         break;
3941       }
3942       bufsize *= 2;
3943       Renew(buf, bufsize, char);
3944     }
3945     return buf;
3946   }
3947 #else
3948   Perl_croak(aTHX_ "panic: no strftime");
3949   return NULL;
3950 #endif
3951 }
3952
3953
3954 #define SV_CWD_RETURN_UNDEF \
3955 sv_setsv(sv, &PL_sv_undef); \
3956 return FALSE
3957
3958 #define SV_CWD_ISDOT(dp) \
3959     (dp->d_name[0] == '.' && (dp->d_name[1] == '\0' || \
3960         (dp->d_name[1] == '.' && dp->d_name[2] == '\0')))
3961
3962 /*
3963 =head1 Miscellaneous Functions
3964
3965 =for apidoc getcwd_sv
3966
3967 Fill the sv with current working directory
3968
3969 =cut
3970 */
3971
3972 /* Originally written in Perl by John Bazik; rewritten in C by Ben Sugars.
3973  * rewritten again by dougm, optimized for use with xs TARG, and to prefer
3974  * getcwd(3) if available
3975  * Comments from the orignal:
3976  *     This is a faster version of getcwd.  It's also more dangerous
3977  *     because you might chdir out of a directory that you can't chdir
3978  *     back into. */
3979
3980 int
3981 Perl_getcwd_sv(pTHX_ register SV *sv)
3982 {
3983 #ifndef PERL_MICRO
3984     dVAR;
3985 #ifndef INCOMPLETE_TAINTS
3986     SvTAINTED_on(sv);
3987 #endif
3988
3989 #ifdef HAS_GETCWD
3990     {
3991         char buf[MAXPATHLEN];
3992
3993         /* Some getcwd()s automatically allocate a buffer of the given
3994          * size from the heap if they are given a NULL buffer pointer.
3995          * The problem is that this behaviour is not portable. */
3996         if (getcwd(buf, sizeof(buf) - 1)) {
3997             sv_setpv(sv, buf);
3998             return TRUE;
3999         }
4000         else {
4001             sv_setsv(sv, &PL_sv_undef);
4002             return FALSE;
4003         }
4004     }
4005
4006 #else
4007
4008     Stat_t statbuf;
4009     int orig_cdev, orig_cino, cdev, cino, odev, oino, tdev, tino;
4010     int pathlen=0;
4011     Direntry_t *dp;
4012
4013     SvUPGRADE(sv, SVt_PV);
4014
4015     if (PerlLIO_lstat(".", &statbuf) < 0) {
4016         SV_CWD_RETURN_UNDEF;
4017     }
4018
4019     orig_cdev = statbuf.st_dev;
4020     orig_cino = statbuf.st_ino;
4021     cdev = orig_cdev;
4022     cino = orig_cino;
4023
4024     for (;;) {
4025         DIR *dir;
4026         odev = cdev;
4027         oino = cino;
4028
4029         if (PerlDir_chdir("..") < 0) {
4030             SV_CWD_RETURN_UNDEF;
4031         }
4032         if (PerlLIO_stat(".", &statbuf) < 0) {
4033             SV_CWD_RETURN_UNDEF;
4034         }
4035
4036         cdev = statbuf.st_dev;
4037         cino = statbuf.st_ino;
4038
4039         if (odev == cdev && oino == cino) {
4040             break;
4041         }
4042         if (!(dir = PerlDir_open("."))) {
4043             SV_CWD_RETURN_UNDEF;
4044         }
4045
4046         while ((dp = PerlDir_read(dir)) != NULL) {
4047 #ifdef DIRNAMLEN
4048             const int namelen = dp->d_namlen;
4049 #else
4050             const int namelen = strlen(dp->d_name);
4051 #endif
4052             /* skip . and .. */
4053             if (SV_CWD_ISDOT(dp)) {
4054                 continue;
4055             }
4056
4057             if (PerlLIO_lstat(dp->d_name, &statbuf) < 0) {
4058                 SV_CWD_RETURN_UNDEF;
4059             }
4060
4061             tdev = statbuf.st_dev;
4062             tino = statbuf.st_ino;
4063             if (tino == oino && tdev == odev) {
4064                 break;
4065             }
4066         }
4067
4068         if (!dp) {
4069             SV_CWD_RETURN_UNDEF;
4070         }
4071
4072         if (pathlen + namelen + 1 >= MAXPATHLEN) {
4073             SV_CWD_RETURN_UNDEF;
4074         }
4075
4076         SvGROW(sv, pathlen + namelen + 1);
4077
4078         if (pathlen) {
4079             /* shift down */
4080             Move(SvPVX_const(sv), SvPVX(sv) + namelen + 1, pathlen, char);
4081         }
4082
4083         /* prepend current directory to the front */
4084         *SvPVX(sv) = '/';
4085         Move(dp->d_name, SvPVX(sv)+1, namelen, char);
4086         pathlen += (namelen + 1);
4087
4088 #ifdef VOID_CLOSEDIR
4089         PerlDir_close(dir);
4090 #else
4091         if (PerlDir_close(dir) < 0) {
4092             SV_CWD_RETURN_UNDEF;
4093         }
4094 #endif
4095     }
4096
4097     if (pathlen) {
4098         SvCUR_set(sv, pathlen);
4099         *SvEND(sv) = '\0';
4100         SvPOK_only(sv);
4101
4102         if (PerlDir_chdir(SvPVX_const(sv)) < 0) {
4103             SV_CWD_RETURN_UNDEF;
4104         }
4105     }
4106     if (PerlLIO_stat(".", &statbuf) < 0) {
4107         SV_CWD_RETURN_UNDEF;
4108     }
4109
4110     cdev = statbuf.st_dev;
4111     cino = statbuf.st_ino;
4112
4113     if (cdev != orig_cdev || cino != orig_cino) {
4114         Perl_croak(aTHX_ "Unstable directory path, "
4115                    "current directory changed unexpectedly");
4116     }
4117
4118     return TRUE;
4119 #endif
4120
4121 #else
4122     return FALSE;
4123 #endif
4124 }
4125
4126 /*
4127 =for apidoc scan_version
4128
4129 Returns a pointer to the next character after the parsed
4130 version string, as well as upgrading the passed in SV to
4131 an RV.
4132
4133 Function must be called with an already existing SV like
4134
4135     sv = newSV(0);
4136     s = scan_version(s, SV *sv, bool qv);
4137
4138 Performs some preprocessing to the string to ensure that
4139 it has the correct characteristics of a version.  Flags the
4140 object if it contains an underscore (which denotes this
4141 is an alpha version).  The boolean qv denotes that the version
4142 should be interpreted as if it had multiple decimals, even if
4143 it doesn't.
4144
4145 =cut
4146 */
4147
4148 const char *
4149 Perl_scan_version(pTHX_ const char *s, SV *rv, bool qv)
4150 {
4151     const char *start;
4152     const char *pos;
4153     const char *last;
4154     int saw_period = 0;
4155     int alpha = 0;
4156     int width = 3;
4157     AV * const av = newAV();
4158     SV * const hv = newSVrv(rv, "version"); /* create an SV and upgrade the RV */
4159     (void)sv_upgrade(hv, SVt_PVHV); /* needs to be an HV type */
4160
4161 #ifndef NODEFAULT_SHAREKEYS
4162     HvSHAREKEYS_on(hv);         /* key-sharing on by default */
4163 #endif
4164
4165     while (isSPACE(*s)) /* leading whitespace is OK */
4166         s++;
4167
4168     start = last = s;
4169
4170     if (*s == 'v') {
4171         s++;  /* get past 'v' */
4172         qv = 1; /* force quoted version processing */
4173     }
4174
4175     pos = s;
4176
4177     /* pre-scan the input string to check for decimals/underbars */
4178     while ( *pos == '.' || *pos == '_' || isDIGIT(*pos) )
4179     {
4180         if ( *pos == '.' )
4181         {
4182             if ( alpha )
4183                 Perl_croak(aTHX_ "Invalid version format (underscores before decimal)");
4184             saw_period++ ;
4185             last = pos;
4186         }
4187         else if ( *pos == '_' )
4188         {
4189             if ( alpha )
4190                 Perl_croak(aTHX_ "Invalid version format (multiple underscores)");
4191             alpha = 1;
4192             width = pos - last - 1; /* natural width of sub-version */
4193         }
4194         pos++;
4195     }
4196
4197     if ( alpha && !saw_period )
4198         Perl_croak(aTHX_ "Invalid version format (alpha without decimal)");
4199
4200     if ( alpha && saw_period && width == 0 )
4201         Perl_croak(aTHX_ "Invalid version format (misplaced _ in number)");
4202
4203     if ( saw_period > 1 )
4204         qv = 1; /* force quoted version processing */
4205
4206     pos = s;
4207
4208     if ( qv )
4209         hv_store((HV *)hv, "qv", 2, newSViv(qv), 0);
4210     if ( alpha )
4211         hv_store((HV *)hv, "alpha", 5, newSViv(alpha), 0);
4212     if ( !qv && width < 3 )
4213         hv_store((HV *)hv, "width", 5, newSViv(width), 0);
4214     
4215     while (isDIGIT(*pos))
4216         pos++;
4217     if (!isALPHA(*pos)) {
4218         I32 rev;
4219
4220         for (;;) {
4221             rev = 0;
4222             {
4223                 /* this is atoi() that delimits on underscores */
4224                 const char *end = pos;
4225                 I32 mult = 1;
4226                 I32 orev;
4227
4228                 /* the following if() will only be true after the decimal
4229                  * point of a version originally created with a bare
4230                  * floating point number, i.e. not quoted in any way
4231                  */
4232                 if ( !qv && s > start && saw_period == 1 ) {
4233                     mult *= 100;
4234                     while ( s < end ) {
4235                         orev = rev;
4236                         rev += (*s - '0') * mult;
4237                         mult /= 10;
4238                         if ( PERL_ABS(orev) > PERL_ABS(rev) )
4239                             Perl_croak(aTHX_ "Integer overflow in version");
4240                         s++;
4241                         if ( *s == '_' )
4242                             s++;
4243                     }
4244                 }
4245                 else {
4246                     while (--end >= s) {
4247                         orev = rev;
4248                         rev += (*end - '0') * mult;
4249                         mult *= 10;
4250                         if ( PERL_ABS(orev) > PERL_ABS(rev) )
4251                             Perl_croak(aTHX_ "Integer overflow in version");
4252                     }
4253                 } 
4254             }
4255
4256             /* Append revision */
4257             av_push(av, newSViv(rev));
4258             if ( *pos == '.' )
4259                 s = ++pos;
4260             else if ( *pos == '_' && isDIGIT(pos[1]) )
4261                 s = ++pos;
4262             else if ( isDIGIT(*pos) )
4263                 s = pos;
4264             else {
4265                 s = pos;
4266                 break;
4267             }
4268             if ( qv ) {
4269                 while ( isDIGIT(*pos) )
4270                     pos++;
4271             }
4272             else {
4273                 int digits = 0;
4274                 while ( ( isDIGIT(*pos) || *pos == '_' ) && digits < 3 ) {
4275                     if ( *pos != '_' )
4276                         digits++;
4277                     pos++;
4278                 }
4279             }
4280         }
4281     }
4282     if ( qv ) { /* quoted versions always get at least three terms*/
4283         I32 len = av_len(av);
4284         /* This for loop appears to trigger a compiler bug on OS X, as it
4285            loops infinitely. Yes, len is negative. No, it makes no sense.
4286            Compiler in question is:
4287            gcc version 3.3 20030304 (Apple Computer, Inc. build 1640)
4288            for ( len = 2 - len; len > 0; len-- )
4289            av_push((AV *)sv, newSViv(0));
4290         */
4291         len = 2 - len;
4292         while (len-- > 0)
4293             av_push(av, newSViv(0));
4294     }
4295
4296     /* need to save off the current version string for later */
4297     if ( s > start ) {
4298         SV * orig = newSVpvn(start,s-start);
4299         if ( qv && saw_period == 1 && *start != 'v' ) {
4300             /* need to insert a v to be consistent */
4301             sv_insert(orig, 0, 0, "v", 1);
4302         }
4303         hv_store((HV *)hv, "original", 8, orig, 0);
4304     }
4305     else {
4306         hv_store((HV *)hv, "original", 8, newSVpvn("0",1), 0);
4307         av_push(av, newSViv(0));
4308     }
4309
4310     /* And finally, store the AV in the hash */
4311     hv_store((HV *)hv, "version", 7, newRV_noinc((SV *)av), 0);
4312
4313     /* fix RT#19517 - special case 'undef' as string */
4314     if ( *s == 'u' && strEQ(s,"undef") ) {
4315         s += 5;
4316     }
4317
4318     return s;
4319 }
4320
4321 /*
4322 =for apidoc new_version
4323
4324 Returns a new version object based on the passed in SV:
4325
4326     SV *sv = new_version(SV *ver);
4327
4328 Does not alter the passed in ver SV.  See "upg_version" if you
4329 want to upgrade the SV.
4330
4331 =cut
4332 */
4333
4334 SV *
4335 Perl_new_version(pTHX_ SV *ver)
4336 {
4337     dVAR;
4338     SV * const rv = newSV(0);
4339     if ( sv_derived_from(ver,"version") ) /* can just copy directly */
4340     {
4341         I32 key;
4342         AV * const av = newAV();
4343         AV *sav;
4344         /* This will get reblessed later if a derived class*/
4345         SV * const hv = newSVrv(rv, "version"); 
4346         (void)sv_upgrade(hv, SVt_PVHV); /* needs to be an HV type */
4347 #ifndef NODEFAULT_SHAREKEYS
4348         HvSHAREKEYS_on(hv);         /* key-sharing on by default */
4349 #endif
4350
4351         if ( SvROK(ver) )
4352             ver = SvRV(ver);
4353
4354         /* Begin copying all of the elements */
4355         if ( hv_exists((HV *)ver, "qv", 2) )
4356             hv_store((HV *)hv, "qv", 2, &PL_sv_yes, 0);
4357
4358         if ( hv_exists((HV *)ver, "alpha", 5) )
4359             hv_store((HV *)hv, "alpha", 5, &PL_sv_yes, 0);
4360         
4361         if ( hv_exists((HV*)ver, "width", 5 ) )
4362         {
4363             const I32 width = SvIV(*hv_fetchs((HV*)ver, "width", FALSE));
4364             hv_store((HV *)hv, "width", 5, newSViv(width), 0);
4365         }
4366
4367         if ( hv_exists((HV*)ver, "original", 8 ) )
4368         {
4369             SV * pv = *hv_fetchs((HV*)ver, "original", FALSE);
4370             hv_store((HV *)hv, "original", 8, newSVsv(pv), 0);
4371         }
4372
4373         sav = (AV *)SvRV(*hv_fetchs((HV*)ver, "version", FALSE));
4374         /* This will get reblessed later if a derived class*/
4375         for ( key = 0; key <= av_len(sav); key++ )
4376         {
4377             const I32 rev = SvIV(*av_fetch(sav, key, FALSE));
4378             av_push(av, newSViv(rev));
4379         }
4380
4381         hv_store((HV *)hv, "version", 7, newRV_noinc((SV *)av), 0);
4382         return rv;
4383     }
4384 #ifdef SvVOK
4385     {
4386         const MAGIC* const mg = SvVSTRING_mg(ver);
4387         if ( mg ) { /* already a v-string */
4388             const STRLEN len = mg->mg_len;
4389             char * const version = savepvn( (const char*)mg->mg_ptr, len);
4390             sv_setpvn(rv,version,len);
4391             /* this is for consistency with the pure Perl class */
4392             if ( *version != 'v' ) 
4393                 sv_insert(rv, 0, 0, "v", 1);
4394             Safefree(version);
4395         }
4396         else {
4397 #endif
4398         sv_setsv(rv,ver); /* make a duplicate */
4399 #ifdef SvVOK
4400         }
4401     }
4402 #endif
4403     return upg_version(rv, FALSE);
4404 }
4405
4406 /*
4407 =for apidoc upg_version
4408
4409 In-place upgrade of the supplied SV to a version object.
4410
4411     SV *sv = upg_version(SV *sv, bool qv);
4412
4413 Returns a pointer to the upgraded SV.  Set the boolean qv if you want
4414 to force this SV to be interpreted as an "extended" version.
4415
4416 =cut
4417 */
4418
4419 SV *
4420 Perl_upg_version(pTHX_ SV *ver, bool qv)
4421 {
4422     const char *version, *s;
4423 #ifdef SvVOK
4424     const MAGIC *mg;
4425 #endif
4426
4427     if ( SvNOK(ver) && !( SvPOK(ver) && sv_len(ver) == 3 ) )
4428     {
4429         /* may get too much accuracy */ 
4430         char tbuf[64];
4431 #ifdef USE_LOCALE_NUMERIC
4432         char *loc = setlocale(LC_NUMERIC, "C");
4433 #endif
4434         STRLEN len = my_snprintf(tbuf, sizeof(tbuf), "%.9"NVff, SvNVX(ver));
4435 #ifdef USE_LOCALE_NUMERIC
4436         setlocale(LC_NUMERIC, loc);
4437 #endif
4438         while (tbuf[len-1] == '0' && len > 0) len--;
4439         if ( tbuf[len-1] == '.' ) len--; /* eat the trailing decimal */
4440         version = savepvn(tbuf, len);
4441     }
4442 #ifdef SvVOK
4443     else if ( (mg = SvVSTRING_mg(ver)) ) { /* already a v-string */
4444         version = savepvn( (const char*)mg->mg_ptr,mg->mg_len );
4445         qv = 1;
4446     }
4447 #endif
4448     else /* must be a string or something like a string */
4449     {
4450         STRLEN len;
4451         version = savepv(SvPV(ver,len));
4452 #ifndef SvVOK
4453 #  if PERL_VERSION > 5
4454         /* This will only be executed for 5.6.0 - 5.8.0 inclusive */
4455         if ( len == 3 && !instr(version,".") && !instr(version,"_") ) {
4456             /* may be a v-string */
4457             SV * const nsv = sv_newmortal();
4458             const char *nver;
4459             const char *pos;
4460             int saw_period = 0;
4461             sv_setpvf(nsv,"v%vd",ver);
4462             pos = nver = savepv(SvPV_nolen(nsv));
4463
4464             /* scan the resulting formatted string */
4465             pos++; /* skip the leading 'v' */
4466             while ( *pos == '.' || isDIGIT(*pos) ) {
4467                 if ( *pos == '.' )
4468                     saw_period++ ;
4469                 pos++;
4470             }
4471
4472             /* is definitely a v-string */
4473             if ( saw_period == 2 ) {    
4474                 Safefree(version);
4475                 version = nver;
4476             }
4477         }
4478 #  endif
4479 #endif
4480     }
4481
4482     s = scan_version(version, ver, qv);
4483     if ( *s != '\0' ) 
4484         if(ckWARN(WARN_MISC))
4485             Perl_warner(aTHX_ packWARN(WARN_MISC), 
4486                 "Version string '%s' contains invalid data; "
4487                 "ignoring: '%s'", version, s);
4488     Safefree(version);
4489     return ver;
4490 }
4491
4492 /*
4493 =for apidoc vverify
4494
4495 Validates that the SV contains a valid version object.
4496
4497     bool vverify(SV *vobj);
4498
4499 Note that it only confirms the bare minimum structure (so as not to get
4500 confused by derived classes which may contain additional hash entries):
4501
4502 =over 4
4503
4504 =item * The SV contains a [reference to a] hash
4505
4506 =item * The hash contains a "version" key
4507
4508 =item * The "version" key has [a reference to] an AV as its value
4509
4510 =back
4511
4512 =cut
4513 */
4514
4515 bool
4516 Perl_vverify(pTHX_ SV *vs)
4517 {
4518     SV *sv;
4519     if ( SvROK(vs) )
4520         vs = SvRV(vs);
4521
4522     /* see if the appropriate elements exist */
4523     if ( SvTYPE(vs) == SVt_PVHV
4524          && hv_exists((HV*)vs, "version", 7)
4525          && (sv = SvRV(*hv_fetchs((HV*)vs, "version", FALSE)))
4526          && SvTYPE(sv) == SVt_PVAV )
4527         return TRUE;
4528     else
4529         return FALSE;
4530 }
4531
4532 /*
4533 =for apidoc vnumify
4534
4535 Accepts a version object and returns the normalized floating
4536 point representation.  Call like:
4537
4538     sv = vnumify(rv);
4539
4540 NOTE: you can pass either the object directly or the SV
4541 contained within the RV.
4542
4543 =cut
4544 */
4545
4546 SV *
4547 Perl_vnumify(pTHX_ SV *vs)
4548 {
4549     I32 i, len, digit;
4550     int width;
4551     bool alpha = FALSE;
4552     SV * const sv = newSV(0);
4553     AV *av;
4554     if ( SvROK(vs) )
4555         vs = SvRV(vs);
4556
4557     if ( !vverify(vs) )
4558         Perl_croak(aTHX_ "Invalid version object");
4559
4560     /* see if various flags exist */
4561     if ( hv_exists((HV*)vs, "alpha", 5 ) )
4562         alpha = TRUE;
4563     if ( hv_exists((HV*)vs, "width", 5 ) )
4564         width = SvIV(*hv_fetchs((HV*)vs, "width", FALSE));
4565     else
4566         width = 3;
4567
4568
4569     /* attempt to retrieve the version array */
4570     if ( !(av = (AV *)SvRV(*hv_fetchs((HV*)vs, "version", FALSE)) ) ) {
4571         sv_catpvs(sv,"0");
4572         return sv;
4573     }
4574
4575     len = av_len(av);
4576     if ( len == -1 )
4577     {
4578         sv_catpvs(sv,"0");
4579         return sv;
4580     }
4581
4582     digit = SvIV(*av_fetch(av, 0, 0));
4583     Perl_sv_setpvf(aTHX_ sv, "%d.", (int)PERL_ABS(digit));
4584     for ( i = 1 ; i < len ; i++ )
4585     {
4586         digit = SvIV(*av_fetch(av, i, 0));
4587         if ( width < 3 ) {
4588             const int denom = (width == 2 ? 10 : 100);
4589             const div_t term = div((int)PERL_ABS(digit),denom);
4590             Perl_sv_catpvf(aTHX_ sv, "%0*d_%d", width, term.quot, term.rem);
4591         }
4592         else {
4593             Perl_sv_catpvf(aTHX_ sv, "%0*d", width, (int)digit);
4594         }
4595     }
4596
4597     if ( len > 0 )
4598     {
4599         digit = SvIV(*av_fetch(av, len, 0));
4600         if ( alpha && width == 3 ) /* alpha version */
4601             sv_catpvs(sv,"_");
4602         Perl_sv_catpvf(aTHX_ sv, "%0*d", width, (int)digit);
4603     }
4604     else /* len == 0 */
4605     {
4606         sv_catpvs(sv, "000");
4607     }
4608     return sv;
4609 }
4610
4611 /*
4612 =for apidoc vnormal
4613
4614 Accepts a version object and returns the normalized string
4615 representation.  Call like:
4616
4617     sv = vnormal(rv);
4618
4619 NOTE: you can pass either the object directly or the SV
4620 contained within the RV.
4621
4622 =cut
4623 */
4624
4625 SV *
4626 Perl_vnormal(pTHX_ SV *vs)
4627 {
4628     I32 i, len, digit;
4629     bool alpha = FALSE;
4630     SV * const sv = newSV(0);
4631     AV *av;
4632     if ( SvROK(vs) )
4633         vs = SvRV(vs);
4634
4635     if ( !vverify(vs) )
4636         Perl_croak(aTHX_ "Invalid version object");
4637
4638     if ( hv_exists((HV*)vs, "alpha", 5 ) )
4639         alpha = TRUE;
4640     av = (AV *)SvRV(*hv_fetchs((HV*)vs, "version", FALSE));
4641
4642     len = av_len(av);
4643     if ( len == -1 )
4644     {
4645         sv_catpvs(sv,"");
4646         return sv;
4647     }
4648     digit = SvIV(*av_fetch(av, 0, 0));
4649     Perl_sv_setpvf(aTHX_ sv, "v%"IVdf, (IV)digit);
4650     for ( i = 1 ; i < len ; i++ ) {
4651         digit = SvIV(*av_fetch(av, i, 0));
4652         Perl_sv_catpvf(aTHX_ sv, ".%"IVdf, (IV)digit);
4653     }
4654
4655     if ( len > 0 )
4656     {
4657         /* handle last digit specially */
4658         digit = SvIV(*av_fetch(av, len, 0));
4659         if ( alpha )
4660             Perl_sv_catpvf(aTHX_ sv, "_%"IVdf, (IV)digit);
4661         else
4662             Perl_sv_catpvf(aTHX_ sv, ".%"IVdf, (IV)digit);
4663     }
4664
4665     if ( len <= 2 ) { /* short version, must be at least three */
4666         for ( len = 2 - len; len != 0; len-- )
4667             sv_catpvs(sv,".0");
4668     }
4669     return sv;
4670 }
4671
4672 /*
4673 =for apidoc vstringify
4674
4675 In order to maintain maximum compatibility with earlier versions
4676 of Perl, this function will return either the floating point
4677 notation or the multiple dotted notation, depending on whether
4678 the original version contained 1 or more dots, respectively
4679
4680 =cut
4681 */
4682
4683 SV *
4684 Perl_vstringify(pTHX_ SV *vs)
4685 {
4686     SV *pv;
4687     if ( SvROK(vs) )
4688         vs = SvRV(vs);
4689     
4690     if ( !vverify(vs) )
4691         Perl_croak(aTHX_ "Invalid version object");
4692
4693     pv = *hv_fetchs((HV*)vs, "original", FALSE);
4694     if ( SvPOK(pv) ) 
4695         return newSVsv(pv);
4696     else
4697         return &PL_sv_undef;
4698 }
4699
4700 /*
4701 =for apidoc vcmp
4702
4703 Version object aware cmp.  Both operands must already have been 
4704 converted into version objects.
4705
4706 =cut
4707 */
4708
4709 int
4710 Perl_vcmp(pTHX_ SV *lhv, SV *rhv)
4711 {
4712     I32 i,l,m,r,retval;
4713     bool lalpha = FALSE;
4714     bool ralpha = FALSE;
4715     I32 left = 0;
4716     I32 right = 0;
4717     AV *lav, *rav;
4718     if ( SvROK(lhv) )
4719         lhv = SvRV(lhv);
4720     if ( SvROK(rhv) )
4721         rhv = SvRV(rhv);
4722
4723     if ( !vverify(lhv) )
4724         Perl_croak(aTHX_ "Invalid version object");
4725
4726     if ( !vverify(rhv) )
4727         Perl_croak(aTHX_ "Invalid version object");
4728
4729     /* get the left hand term */
4730     lav = (AV *)SvRV(*hv_fetchs((HV*)lhv, "version", FALSE));
4731     if ( hv_exists((HV*)lhv, "alpha", 5 ) )
4732         lalpha = TRUE;
4733
4734     /* and the right hand term */
4735     rav = (AV *)SvRV(*hv_fetchs((HV*)rhv, "version", FALSE));
4736     if ( hv_exists((HV*)rhv, "alpha", 5 ) )
4737         ralpha = TRUE;
4738
4739     l = av_len(lav);
4740     r = av_len(rav);
4741     m = l < r ? l : r;
4742     retval = 0;
4743     i = 0;
4744     while ( i <= m && retval == 0 )
4745     {
4746         left  = SvIV(*av_fetch(lav,i,0));
4747         right = SvIV(*av_fetch(rav,i,0));
4748         if ( left < right  )
4749             retval = -1;
4750         if ( left > right )
4751             retval = +1;
4752         i++;
4753     }
4754
4755     /* tiebreaker for alpha with identical terms */
4756     if ( retval == 0 && l == r && left == right && ( lalpha || ralpha ) )
4757     {
4758         if ( lalpha && !ralpha )
4759         {
4760             retval = -1;
4761         }
4762         else if ( ralpha && !lalpha)
4763         {
4764             retval = +1;
4765         }
4766     }
4767
4768     if ( l != r && retval == 0 ) /* possible match except for trailing 0's */
4769     {
4770         if ( l < r )
4771         {
4772             while ( i <= r && retval == 0 )
4773             {
4774                 if ( SvIV(*av_fetch(rav,i,0)) != 0 )
4775                     retval = -1; /* not a match after all */
4776                 i++;
4777             }
4778         }
4779         else
4780         {
4781             while ( i <= l && retval == 0 )
4782             {
4783                 if ( SvIV(*av_fetch(lav,i,0)) != 0 )
4784                     retval = +1; /* not a match after all */
4785                 i++;
4786             }
4787         }
4788     }
4789     return retval;
4790 }
4791
4792 #if !defined(HAS_SOCKETPAIR) && defined(HAS_SOCKET) && defined(AF_INET) && defined(PF_INET) && defined(SOCK_DGRAM) && defined(HAS_SELECT)
4793 #   define EMULATE_SOCKETPAIR_UDP
4794 #endif
4795
4796 #ifdef EMULATE_SOCKETPAIR_UDP
4797 static int
4798 S_socketpair_udp (int fd[2]) {
4799     dTHX;
4800     /* Fake a datagram socketpair using UDP to localhost.  */
4801     int sockets[2] = {-1, -1};
4802     struct sockaddr_in addresses[2];
4803     int i;
4804     Sock_size_t size = sizeof(struct sockaddr_in);
4805     unsigned short port;
4806     int got;
4807
4808     memset(&addresses, 0, sizeof(addresses));
4809     i = 1;
4810     do {
4811         sockets[i] = PerlSock_socket(AF_INET, SOCK_DGRAM, PF_INET);
4812         if (sockets[i] == -1)
4813             goto tidy_up_and_fail;
4814
4815         addresses[i].sin_family = AF_INET;
4816         addresses[i].sin_addr.s_addr = htonl(INADDR_LOOPBACK);
4817         addresses[i].sin_port = 0;      /* kernel choses port.  */
4818         if (PerlSock_bind(sockets[i], (struct sockaddr *) &addresses[i],
4819                 sizeof(struct sockaddr_in)) == -1)
4820             goto tidy_up_and_fail;
4821     } while (i--);
4822
4823     /* Now have 2 UDP sockets. Find out which port each is connected to, and
4824        for each connect the other socket to it.  */
4825     i = 1;
4826     do {
4827         if (PerlSock_getsockname(sockets[i], (struct sockaddr *) &addresses[i],
4828                 &size) == -1)
4829             goto tidy_up_and_fail;
4830         if (size != sizeof(struct sockaddr_in))
4831             goto abort_tidy_up_and_fail;
4832         /* !1 is 0, !0 is 1 */
4833         if (PerlSock_connect(sockets[!i], (struct sockaddr *) &addresses[i],
4834                 sizeof(struct sockaddr_in)) == -1)
4835             goto tidy_up_and_fail;
4836     } while (i--);
4837
4838     /* Now we have 2 sockets connected to each other. I don't trust some other
4839        process not to have already sent a packet to us (by random) so send
4840        a packet from each to the other.  */
4841     i = 1;
4842     do {
4843         /* I'm going to send my own port number.  As a short.
4844            (Who knows if someone somewhere has sin_port as a bitfield and needs
4845            this routine. (I'm assuming crays have socketpair)) */
4846         port = addresses[i].sin_port;
4847         got = PerlLIO_write(sockets[i], &port, sizeof(port));
4848         if (got != sizeof(port)) {
4849             if (got == -1)
4850                 goto tidy_up_and_fail;
4851             goto abort_tidy_up_and_fail;
4852         }
4853     } while (i--);
4854
4855     /* Packets sent. I don't trust them to have arrived though.
4856        (As I understand it Solaris TCP stack is multithreaded. Non-blocking
4857        connect to localhost will use a second kernel thread. In 2.6 the
4858        first thread running the connect() returns before the second completes,
4859        so EINPROGRESS> In 2.7 the improved stack is faster and connect()
4860        returns 0. Poor programs have tripped up. One poor program's authors'
4861        had a 50-1 reverse stock split. Not sure how connected these were.)
4862        So I don't trust someone not to have an unpredictable UDP stack.
4863     */
4864
4865     {
4866         struct timeval waitfor = {0, 100000}; /* You have 0.1 seconds */
4867         int max = sockets[1] > sockets[0] ? sockets[1] : sockets[0];
4868         fd_set rset;
4869
4870         FD_ZERO(&rset);
4871         FD_SET((unsigned int)sockets[0], &rset);
4872         FD_SET((unsigned int)sockets[1], &rset);
4873
4874         got = PerlSock_select(max + 1, &rset, NULL, NULL, &waitfor);
4875         if (got != 2 || !FD_ISSET(sockets[0], &rset)
4876                 || !FD_ISSET(sockets[1], &rset)) {
4877             /* I hope this is portable and appropriate.  */
4878             if (got == -1)
4879                 goto tidy_up_and_fail;
4880             goto abort_tidy_up_and_fail;
4881         }
4882     }
4883
4884     /* And the paranoia department even now doesn't trust it to have arrive
4885        (hence MSG_DONTWAIT). Or that what arrives was sent by us.  */
4886     {
4887         struct sockaddr_in readfrom;
4888         unsigned short buffer[2];
4889
4890         i = 1;
4891         do {
4892 #ifdef MSG_DONTWAIT
4893             got = PerlSock_recvfrom(sockets[i], (char *) &buffer,
4894                     sizeof(buffer), MSG_DONTWAIT,
4895                     (struct sockaddr *) &readfrom, &size);
4896 #else
4897             got = PerlSock_recvfrom(sockets[i], (char *) &buffer,
4898                     sizeof(buffer), 0,
4899                     (struct sockaddr *) &readfrom, &size);
4900 #endif
4901
4902             if (got == -1)
4903                 goto tidy_up_and_fail;
4904             if (got != sizeof(port)
4905                     || size != sizeof(struct sockaddr_in)
4906                     /* Check other socket sent us its port.  */
4907                     || buffer[0] != (unsigned short) addresses[!i].sin_port
4908                     /* Check kernel says we got the datagram from that socket */
4909                     || readfrom.sin_family != addresses[!i].sin_family
4910                     || readfrom.sin_addr.s_addr != addresses[!i].sin_addr.s_addr
4911                     || readfrom.sin_port != addresses[!i].sin_port)
4912                 goto abort_tidy_up_and_fail;
4913         } while (i--);
4914     }
4915     /* My caller (my_socketpair) has validated that this is non-NULL  */
4916     fd[0] = sockets[0];
4917     fd[1] = sockets[1];
4918     /* I hereby declare this connection open.  May God bless all who cross
4919        her.  */
4920     return 0;
4921
4922   abort_tidy_up_and_fail:
4923     errno = ECONNABORTED;
4924   tidy_up_and_fail:
4925     {
4926         const int save_errno = errno;
4927         if (sockets[0] != -1)
4928             PerlLIO_close(sockets[0]);
4929         if (sockets[1] != -1)
4930             PerlLIO_close(sockets[1]);
4931         errno = save_errno;
4932         return -1;
4933     }
4934 }
4935 #endif /*  EMULATE_SOCKETPAIR_UDP */
4936
4937 #if !defined(HAS_SOCKETPAIR) && defined(HAS_SOCKET) && defined(AF_INET) && defined(PF_INET)
4938 int
4939 Perl_my_socketpair (int family, int type, int protocol, int fd[2]) {
4940     /* Stevens says that family must be AF_LOCAL, protocol 0.
4941        I'm going to enforce that, then ignore it, and use TCP (or UDP).  */
4942     dTHX;
4943     int listener = -1;
4944     int connector = -1;
4945     int acceptor = -1;
4946     struct sockaddr_in listen_addr;
4947     struct sockaddr_in connect_addr;
4948     Sock_size_t size;
4949
4950     if (protocol
4951 #ifdef AF_UNIX
4952         || family != AF_UNIX
4953 #endif
4954     ) {
4955         errno = EAFNOSUPPORT;
4956         return -1;
4957     }
4958     if (!fd) {
4959         errno = EINVAL;
4960         return -1;
4961     }
4962
4963 #ifdef EMULATE_SOCKETPAIR_UDP
4964     if (type == SOCK_DGRAM)
4965         return S_socketpair_udp(fd);
4966 #endif
4967
4968     listener = PerlSock_socket(AF_INET, type, 0);
4969     if (listener == -1)
4970         return -1;
4971     memset(&listen_addr, 0, sizeof(listen_addr));
4972     listen_addr.sin_family = AF_INET;
4973     listen_addr.sin_addr.s_addr = htonl(INADDR_LOOPBACK);
4974     listen_addr.sin_port = 0;   /* kernel choses port.  */
4975     if (PerlSock_bind(listener, (struct sockaddr *) &listen_addr,
4976             sizeof(listen_addr)) == -1)
4977         goto tidy_up_and_fail;
4978     if (PerlSock_listen(listener, 1) == -1)
4979         goto tidy_up_and_fail;
4980
4981     connector = PerlSock_socket(AF_INET, type, 0);
4982     if (connector == -1)
4983         goto tidy_up_and_fail;
4984     /* We want to find out the port number to connect to.  */
4985     size = sizeof(connect_addr);
4986     if (PerlSock_getsockname(listener, (struct sockaddr *) &connect_addr,
4987             &size) == -1)
4988         goto tidy_up_and_fail;
4989     if (size != sizeof(connect_addr))
4990         goto abort_tidy_up_and_fail;
4991     if (PerlSock_connect(connector, (struct sockaddr *) &connect_addr,
4992             sizeof(connect_addr)) == -1)
4993         goto tidy_up_and_fail;
4994
4995     size = sizeof(listen_addr);
4996     acceptor = PerlSock_accept(listener, (struct sockaddr *) &listen_addr,
4997             &size);
4998     if (acceptor == -1)
4999         goto tidy_up_and_fail;
5000     if (size != sizeof(listen_addr))
5001         goto abort_tidy_up_and_fail;
5002     PerlLIO_close(listener);
5003     /* Now check we are talking to ourself by matching port and host on the
5004        two sockets.  */
5005     if (PerlSock_getsockname(connector, (struct sockaddr *) &connect_addr,
5006             &size) == -1)
5007         goto tidy_up_and_fail;
5008     if (size != sizeof(connect_addr)
5009             || listen_addr.sin_family != connect_addr.sin_family
5010             || listen_addr.sin_addr.s_addr != connect_addr.sin_addr.s_addr
5011             || listen_addr.sin_port != connect_addr.sin_port) {
5012         goto abort_tidy_up_and_fail;
5013     }
5014     fd[0] = connector;
5015     fd[1] = acceptor;
5016     return 0;
5017
5018   abort_tidy_up_and_fail:
5019 #ifdef ECONNABORTED
5020   errno = ECONNABORTED; /* This would be the standard thing to do. */
5021 #else
5022 #  ifdef ECONNREFUSED
5023   errno = ECONNREFUSED; /* E.g. Symbian does not have ECONNABORTED. */
5024 #  else
5025   errno = ETIMEDOUT;    /* Desperation time. */
5026 #  endif
5027 #endif
5028   tidy_up_and_fail:
5029     {
5030         const int save_errno = errno;
5031         if (listener != -1)
5032             PerlLIO_close(listener);
5033         if (connector != -1)
5034             PerlLIO_close(connector);
5035         if (acceptor != -1)
5036             PerlLIO_close(acceptor);
5037         errno = save_errno;
5038         return -1;
5039     }
5040 }
5041 #else
5042 /* In any case have a stub so that there's code corresponding
5043  * to the my_socketpair in global.sym. */
5044 int
5045 Perl_my_socketpair (int family, int type, int protocol, int fd[2]) {
5046 #ifdef HAS_SOCKETPAIR
5047     return socketpair(family, type, protocol, fd);
5048 #else
5049     return -1;
5050 #endif
5051 }
5052 #endif
5053