gv.c

   1 /* $RCSfile: gv.c,v $$Revision: 4.1 $$Date: 92/08/07 18:26:39 $
   2  *
   3  *    Copyright (c) 1991, Larry Wall
   4  *
   5  *    You may distribute under the terms of either the GNU General Public
   6  *    License or the Artistic License, as specified in the README file.
   7  *
   8  * $Log:        gv.c,v $
   9  * Revision 4.1  92/08/07  18:26:39  lwall
  10  *
  11  * Revision 4.0.1.4  92/06/08  15:32:19  lwall
  12  * patch20: fixed confusion between a *var's real name and its effective name
  13  * patch20: the debugger now warns you on lines that can't set a breakpoint
  14  * patch20: the debugger made perl forget the last pattern used by //
  15  * patch20: paragraph mode now skips extra newlines automatically
  16  * patch20: ($<,$>) = ... didn't work on some architectures
  17  *
  18  * Revision 4.0.1.3  91/11/05  18:35:33  lwall
  19  * patch11: length($x) was sometimes wrong for numeric $x
  20  * patch11: perl now issues warning if $SIG{'ALARM'} is referenced
  21  * patch11: *foo = undef coredumped
  22  * patch11: solitary subroutine references no longer trigger typo warnings
  23  * patch11: local(*FILEHANDLE) had a memory leak
  24  *
  25  * Revision 4.0.1.2  91/06/07  11:55:53  lwall
  26  * patch4: new copyright notice
  27  * patch4: added $^P variable to control calling of perldb routines
  28  * patch4: added $^F variable to specify maximum system fd, default 2
  29  * patch4: $` was busted inside s///
  30  * patch4: default top-of-form run_format is now FILEHANDLE_TOP
  31  * patch4: length($`), length($&), length($') now optimized to avoid string copy
  32  * patch4: $^D |= 1024 now does syntax tree dump at run-time
  33  *
  34  * Revision 4.0.1.1  91/04/12  09:10:24  lwall
  35  * patch1: Configure now differentiates getgroups() type from getgid() type
  36  * patch1: you may now use "die" and "caller" in a signal handler
  37  *
  38  * Revision 4.0  91/03/20  01:39:41  lwall
  39  * 4.0 baseline.
  40  *
  41  */
  42
  43 #include "EXTERN.h"
  44 #include "perl.h"
  45
  46 extern char rcsid[];
  47
  48 GV *
  49 gv_AVadd(gv)
  50 register GV *gv;
  51 {
  52     if (!GvAV(gv))
  53         GvAV(gv) = newAV();
  54     return gv;
  55 }
  56
  57 GV *
  58 gv_HVadd(gv)
  59 register GV *gv;
  60 {
  61     if (!GvHV(gv))
  62         GvHV(gv) = newHV();
  63     return gv;
  64 }
  65
  66 GV *
  67 gv_fetchfile(name)
  68 char *name;
  69 {
  70     char tmpbuf[1200];
  71     GV *gv;
  72
  73     sprintf(tmpbuf,"'_<%s", name);
  74     gv = gv_fetchpv(tmpbuf, TRUE);
  75     sv_setpv(GvSV(gv), name);
  76     if (perldb)
  77         hv_magic(GvHVn(gv_AVadd(gv)), gv, 'L');
  78     return gv;
  79 }
  80
  81 void
  82 gv_init(gv, stash, name, len, multi)
  83 GV *gv;
  84 HV *stash;
  85 char *name;
  86 STRLEN len;
  87 int multi;
  88 {
  89     register GP *gp;
  90
  91     sv_upgrade(gv, SVt_PVGV);
  92     if (SvLEN(gv))
  93         Safefree(SvPVX(gv));
  94     Newz(602,gp, 1, GP);
  95     GvGP(gv) = gp;
  96     GvREFCNT(gv) = 1;
  97     GvSV(gv) = NEWSV(72,0);
  98     GvLINE(gv) = curcop->cop_line;
  99     GvEGV(gv) = gv;
 100     sv_magic((SV*)gv, (SV*)gv, '*', name, len);
 101     GvSTASH(gv) = stash;
 102     GvNAME(gv) = nsavestr(name, len);
 103     GvNAMELEN(gv) = len;
 104     if (multi)
 105         SvMULTI_on(gv);
 106 }
 107
 108 GV *
 109 gv_fetchmeth(stash, name, len)
 110 HV* stash;
 111 char* name;
 112 STRLEN len;
 113 {
 114     AV* av;
 115     GV* topgv;
 116     GV* gv;
 117     GV** gvp;
 118
 119     gvp = (GV**)hv_fetch(stash, name, len, TRUE);
 120
 121     DEBUG_o( deb("Looking for method %s in package %s\n",name,HvNAME(stash)) );
 122     topgv = *gvp;
 123     if (SvTYPE(topgv) != SVt_PVGV)
 124         gv_init(topgv, stash, name, len, TRUE);
 125
 126     if (GvCV(topgv)) {
 127         if (!GvCVGEN(topgv) || GvCVGEN(topgv) >= sub_generation)
 128             return topgv;
 129     }
 130
 131     gvp = (GV**)hv_fetch(stash,"ISA",3,FALSE);
 132     if (gvp && (gv = *gvp) != (GV*)&sv_undef && (av = GvAV(gv))) {
 133         SV** svp = AvARRAY(av);
 134         I32 items = AvFILL(av) + 1;
 135         while (items--) {
 136             SV* sv = *svp++;
 137             HV* basestash = fetch_stash(sv, FALSE);
 138             if (!basestash) {
 139                 if (dowarn)
 140                     warn("Can't locate package %s for @%s'ISA",
 141                         SvPVX(sv), HvNAME(stash));
 142                 continue;
 143             }
 144             gv = gv_fetchmeth(basestash, name, len);
 145             if (gv) {
 146                 GvCV(topgv) = GvCV(gv);                 /* cache the CV */
 147                 GvCVGEN(topgv) = sub_generation;        /* valid for now */
 148                 return gv;
 149             }
 150         }
 151     }
 152     return 0;
 153 }
 154
 155 GV *
 156 gv_fetchmethod(stash, name)
 157 HV* stash;
 158 char* name;
 159 {
 160     register char *nend;
 161
 162     for (nend = name; *nend; nend++) {
 163         if (*nend == ':' || *nend == '\'') {
 164             return gv_fetchpv(name, FALSE);
 165         }
 166     }
 167     return gv_fetchmeth(stash, name, nend - name);
 168 }
 169
 170 GV *
 171 gv_fetchpv(nambeg,add)
 172 char *nambeg;
 173 I32 add;
 174 {
 175     register char *name = nambeg;
 176     register GV *gv = 0;
 177     GV**gvp;
 178     I32 len;
 179     register char *namend;
 180     HV *stash = 0;
 181     bool global = FALSE;
 182     char tmpbuf[256];
 183
 184     for (namend = name; *namend; namend++) {
 185         if ((*namend == '\'' && namend[1]) ||
 186             (*namend == ':' && namend[1] == ':'))
 187         {
 188             len = namend - name;
 189             *tmpbuf = '_';
 190             Copy(name, tmpbuf+1, len, char);
 191             len++;
 192             tmpbuf[len] = '\0';
 193             if (!stash)
 194                 stash = defstash;
 195
 196             if (len > 1) {
 197                 gvp = (GV**)hv_fetch(stash,tmpbuf,len,add);
 198                 if (!gvp || *gvp == (GV*)&sv_undef)
 199                     return Nullgv;
 200                 gv = *gvp;
 201                 if (SvTYPE(gv) == SVt_PVGV)
 202                     SvMULTI_on(gv);
 203                 else
 204                     gv_init(gv, stash, nambeg, namend - nambeg, (add & 2));
 205                 if (!(stash = GvHV(gv)))
 206                     stash = GvHV(gv) = newHV();
 207                 if (!HvNAME(stash))
 208                     HvNAME(stash) = nsavestr(nambeg, namend - nambeg);
 209             }
 210
 211             if (*namend == ':')
 212                 namend++;
 213             namend++;
 214             name = namend;
 215             if (!*name)
 216                 return gv ? gv : defgv;
 217         }
 218     }
 219
 220     /* No stash in name, so see how we can default */
 221
 222     if (!stash) {
 223         if (isIDFIRST(*name)) {
 224             if (isUPPER(*name)) {
 225                 if (*name > 'I') {
 226                     if (*name == 'S' && (
 227                       strEQ(name, "SIG") ||
 228                       strEQ(name, "STDIN") ||
 229                       strEQ(name, "STDOUT") ||
 230                       strEQ(name, "STDERR") ))
 231                         global = TRUE;
 232                 }
 233                 else if (*name > 'E') {
 234                     if (*name == 'I' && strEQ(name, "INC"))
 235                         global = TRUE;
 236                 }
 237                 else if (*name > 'A') {
 238                     if (*name == 'E' && strEQ(name, "ENV"))
 239                         global = TRUE;
 240                 }
 241                 else if (*name == 'A' && (
 242                   strEQ(name, "ARGV") ||
 243                   strEQ(name, "ARGVOUT") ))
 244                     global = TRUE;
 245             }
 246             else if (*name == '_' && !name[1])
 247                 global = TRUE;
 248             if (global)
 249                 stash = defstash;
 250             else if ((COP*)curcop == &compiling)
 251                 stash = curstash;
 252             else
 253                 stash = curcop->cop_stash;
 254         }
 255         else
 256             stash = defstash;
 257     }
 258
 259     /* By this point we should have a stash and a name */
 260
 261     if (!stash)
 262         croak("Global symbol \"%s\" requires explicit package name", name);
 263     len = namend - name;
 264     if (!len)
 265         len = 1;
 266     gvp = (GV**)hv_fetch(stash,name,len,add);
 267     if (!gvp || *gvp == (GV*)&sv_undef)
 268         return Nullgv;
 269     gv = *gvp;
 270     if (SvTYPE(gv) == SVt_PVGV) {
 271         SvMULTI_on(gv);
 272         return gv;
 273     }
 274
 275     /* Adding a new symbol */
 276
 277     gv_init(gv, stash, name, len, add & 2);
 278
 279     /* set up magic where warranted */
 280     switch (*name) {
 281     case 'I':
 282         if (strEQ(name, "ISA")) {
 283             AV* av = GvAVn(gv);
 284             sv_magic((SV*)av, (SV*)gv, 'I', 0, 0);
 285         }
 286         break;
 287     case 'S':
 288         if (strEQ(name, "SIG")) {
 289             HV *hv;
 290             siggv = gv;
 291             SvMULTI_on(siggv);
 292             hv = GvHVn(siggv);
 293             hv_magic(hv, siggv, 'S');
 294
 295             /* initialize signal stack */
 296             signalstack = newAV();
 297             av_store(signalstack, 32, Nullsv);
 298             av_clear(signalstack);
 299             AvREAL_off(signalstack);
 300         }
 301         break;
 302
 303     case '&':
 304         if (len > 1)
 305             break;
 306         ampergv = gv;
 307         sawampersand = TRUE;
 308         goto magicalize;
 309
 310     case '`':
 311         if (len > 1)
 312             break;
 313         leftgv = gv;
 314         sawampersand = TRUE;
 315         goto magicalize;
 316
 317     case '\'':
 318         if (len > 1)
 319             break;
 320         rightgv = gv;
 321         sawampersand = TRUE;
 322         goto magicalize;
 323
 324     case ':':
 325         if (len > 1)
 326             break;
 327         sv_setpv(GvSV(gv),chopset);
 328         goto magicalize;
 329
 330     case '!':
 331     case '#':
 332     case '?':
 333     case '^':
 334     case '~':
 335     case '=':
 336     case '-':
 337     case '%':
 338     case '.':
 339     case '+':
 340     case '*':
 341     case '(':
 342     case ')':
 343     case '<':
 344     case '>':
 345     case ',':
 346     case '\\':
 347     case '/':
 348     case '[':
 349     case '|':
 350     case '\004':
 351     case '\t':
 352     case '\020':
 353     case '\024':
 354     case '\027':
 355     case '\006':
 356         if (len > 1)
 357             break;
 358         goto magicalize;
 359
 360     case '1':
 361     case '2':
 362     case '3':
 363     case '4':
 364     case '5':
 365     case '6':
 366     case '7':
 367     case '8':
 368     case '9':
 369       magicalize:
 370         sv_magic(GvSV(gv), (SV*)gv, 0, name, len);
 371         break;
 372
 373     case '\014':
 374         if (len > 1)
 375             break;
 376         sv_setpv(GvSV(gv),"\f");
 377         formfeed = GvSV(gv);
 378         break;
 379     case ';':
 380         if (len > 1)
 381             break;
 382         sv_setpv(GvSV(gv),"\034");
 383         break;
 384     case ']':
 385         if (len == 1) {
 386             SV *sv;
 387             sv = GvSV(gv);
 388             sv_upgrade(sv, SVt_PVNV);
 389             sv_setpv(sv,rcsid);
 390             SvNVX(sv) = atof(patchlevel);
 391             SvNOK_on(sv);
 392         }
 393         break;
 394     }
 395     return gv;
 396 }
 397
 398 void
 399 gv_fullname(sv,gv)
 400 SV *sv;
 401 GV *gv;
 402 {
 403     HV *hv = GvSTASH(gv);
 404
 405     if (!hv)
 406         return;
 407     sv_setpv(sv, sv == (SV*)gv ? "*" : "");
 408     sv_catpv(sv,HvNAME(hv));
 409     sv_catpvn(sv,"::", 2);
 410     sv_catpvn(sv,GvNAME(gv),GvNAMELEN(gv));
 411 }
 412
 413 void
 414 gv_efullname(sv,gv)
 415 SV *sv;
 416 GV *gv;
 417 {
 418     GV* egv = GvEGV(gv);
 419     HV *hv = GvSTASH(egv);
 420
 421     if (!hv)
 422         return;
 423     sv_setpv(sv, sv == (SV*)gv ? "*" : "");
 424     sv_catpv(sv,HvNAME(hv));
 425     sv_catpvn(sv,"::", 2);
 426     sv_catpvn(sv,GvNAME(egv),GvNAMELEN(egv));
 427 }
 428
 429 IO *
 430 newIO()
 431 {
 432     IO *io;
 433
 434     Newz(603,io,1,IO);
 435     io->page_len = 60;
 436     return io;
 437 }
 438
 439 void
 440 gv_check(stash)
 441 HV* stash;
 442 {
 443     register HE *entry;
 444     register I32 i;
 445     register GV *gv;
 446     HV *hv;
 447
 448     for (i = 0; i <= HvMAX(stash); i++) {
 449         for (entry = HvARRAY(stash)[i]; entry; entry = entry->hent_next) {
 450             if (isALPHA(*entry->hent_key)) {
 451                 gv = (GV*)entry->hent_val;
 452                 if (SvMULTI(gv))
 453                     continue;
 454                 curcop->cop_line = GvLINE(gv);
 455                 warn("Possible typo: \"%s::%s\"", HvNAME(stash), GvNAME(gv));
 456             }
 457             else if (*entry->hent_key == '_' &&
 458                 (gv = (GV*)entry->hent_val) &&
 459                 (hv = GvHV(gv)) && HvNAME(hv) && hv != defstash)
 460                      gv_check(hv);              /* nested package */
 461
 462         }
 463     }
 464 }
 465
 466 GV *
 467 newGVgen()
 468 {
 469     (void)sprintf(tokenbuf,"_GEN_%d",gensym++);
 470     return gv_fetchpv(tokenbuf,TRUE);
 471 }
 472
 473 /* hopefully this is only called on local symbol table entries */
 474
 475 GP*
 476 gp_ref(gp)
 477 GP* gp;
 478 {
 479     gp->gp_refcnt++;
 480     return gp;
 481
 482 }
 483
 484 void
 485 gp_free(gv)
 486 GV* gv;
 487 {
 488     IO *io;
 489     CV *cv;
 490     GP* gp;
 491
 492     if (!gv || !(gp = GvGP(gv)))
 493         return;
 494     if (gp->gp_refcnt == 0) {
 495         warn("Attempt to free unreferenced glob pointers");
 496         return;
 497     }
 498     if (--gp->gp_refcnt > 0)
 499         return;
 500
 501     sv_free((SV*)gp->gp_sv);
 502     sv_free((SV*)gp->gp_av);
 503     sv_free((SV*)gp->gp_hv);
 504     if (io = gp->gp_io) {
 505         do_close(gv,FALSE);
 506         Safefree(io->top_name);
 507         Safefree(io->fmt_name);
 508         Safefree(io);
 509     }
 510     if (cv = gp->gp_cv)
 511         sv_free((SV*)cv);
 512     Safefree(gp);
 513     GvGP(gv) = 0;
 514 }
 515
 516 #if defined(CRIPPLED_CC) && (defined(iAPX286) || defined(M_I286) || defined(I80286))
 517 #define MICROPORT
 518 #endif
 519
 520 #ifdef  MICROPORT       /* Microport 2.4 hack */
 521 AV *GvAVn(gv)
 522 register GV *gv;
 523 {
 524     if (GvGP(gv)->gp_av)
 525         return GvGP(gv)->gp_av;
 526     else
 527         return GvGP(gv_AVadd(gv))->gp_av;
 528 }
 529
 530 HV *GvHVn(gv)
 531 register GV *gv;
 532 {
 533     if (GvGP(gv)->gp_hv)
 534         return GvGP(gv)->gp_hv;
 535     else
 536         return GvGP(gv_HVadd(gv))->gp_hv;
 537 }
 538 #endif                  /* Microport 2.4 hack */
 539
 540 GV *
 541 fetch_gv(op,num)
 542 OP *op;
 543 I32 num;
 544 {
 545     if (op->op_private < num)
 546         return 0;
 547     if (op->op_flags & OPf_STACKED)
 548         return gv_fetchpv(SvPVx(*(stack_sp--), na),TRUE);
 549     else
 550         return cGVOP->op_gv;
 551 }
 552
 553 IO *
 554 fetch_io(op,num)
 555 OP *op;
 556 I32 num;
 557 {
 558     GV *gv;
 559
 560     if (op->op_private < num)
 561         return 0;
 562     if (op->op_flags & OPf_STACKED)
 563         gv = gv_fetchpv(SvPVx(*(stack_sp--), na),TRUE);
 564     else
 565         gv = cGVOP->op_gv;
 566
 567     if (!gv)
 568         return 0;
 569
 570     return GvIOn(gv);
 571 }