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