3 require 5.003; # keep this compatible, an old perl is all we may have before
7 # See database of global and static function prototypes at the __END__.
8 # This is used to generate prototype headers under various configurations,
9 # export symbols lists for different platforms, and macros to provide an
10 # implicit interpreter context argument.
13 open IN, "embed.fnc" or die $!;
15 # walk table providing an array of components in each line to
16 # subroutine, printing the result
19 my $filename = shift || '-';
24 if (ref $filename) { # filehandle
29 open F, ">$filename" or die "Can't open $filename: $!";
32 print $F $leader if $leader;
33 seek IN, 0, 0; # so we may restart
46 @args = split /\s*\|\s*/, $_;
48 my @outs = &{$function}(@args);
49 print $F @outs; # $function->(@args) is not 5.003
51 print $F $trailer if $trailer;
52 close $F unless ref $filename;
55 sub munge_c_files () {
58 warn "\@ARGV empty, nothing to do\n";
63 $functions->{$_[2]} = \@_ if $_[@_-1] =~ /\.\.\./;
68 # if (/^#\s*include\s+"perl.h"/) {
69 # my $file = uc $ARGV;
71 # print "#define PERL_IN_$file\n";
77 # if (exists $functions->{$f}) {
78 # my $flags = $functions->{$f}[0];
79 # $repl = "Perl_$repl" if $flags =~ /p/;
80 # unless ($flags =~ /n/) {
82 # $repl .= "_ " if @{$functions->{$f}} > 3;
84 # warn("$ARGV:$.:$repl\n");
88 s{(\b(\w+)[ \t]*\([ \t]*(?!aTHX))}
92 if (exists $functions->{$f}) {
94 warn("$ARGV:$.:$`#$repl#$'");
99 close ARGV if eof; # restart $.
107 my $wrote_protected = 0;
116 my ($flags,$retval,$func,@args) = @_;
117 $ret .= '/* ' if $flags =~ /m/;
119 $retval = "STATIC $retval";
123 $retval = "PERL_CALLCONV $retval";
125 $func = "Perl_$func";
128 $ret .= "$retval\t$func(";
129 unless ($flags =~ /n/) {
131 $ret .= "_ " if @args;
134 $ret .= join ", ", @args;
137 $ret .= "void" if $flags =~ /n/;
140 $ret .= " __attribute__((noreturn))" if $flags =~ /r/;
141 if( $flags =~ /f/ ) {
142 my $prefix = $flags =~ /n/ ? '' : 'pTHX_';
143 my $args = scalar @args;
144 $ret .= "\n#ifdef CHECK_FORMAT\n";
145 $ret .= sprintf " __attribute__((format(printf,%s%d,%s%d)))",
146 $prefix, $args - 1, $prefix, $args;
147 $ret .= "\n#endif\n";
150 $ret .= ' */' if $flags =~ /m/;
156 # generates global.sym (API export list), and populates %global with global symbols
157 sub write_global_sym {
160 my ($flags,$retval,$func,@args) = @_;
161 if ($flags =~ /A/ && $flags !~ /[xm]/) { # public API, so export
162 $func = "Perl_$func" if $flags =~ /p/;
170 walk_table(\&write_protos, 'proto.h', <<'EOT');
174 * Copyright (c) 1997-2002, Larry Wall
176 * You may distribute under the terms of either the GNU General Public
177 * License or the Artistic License, as specified in the README file.
179 * !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
180 * This file is autogenerated from data in embed.pl. Edit that file
181 * and run 'make regen_headers' to effect changes.
186 walk_table(\&write_global_sym, 'global.sym', <<'EOT');
190 # Copyright (c) 1997-2002, Larry Wall
192 # You may distribute under the terms of either the GNU General Public
193 # License or the Artistic License, as specified in the README file.
195 # !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
196 # This file is autogenerated from data in embed.pl. Edit that file
197 # and run 'make regen_headers' to effect changes.
202 # XXX others that may need adding
206 my @extvars = qw(sv_undef sv_yes sv_no na dowarn
208 tainting tainted stack_base stack_sp sv_arenaroot
210 curstash DBsub DBsingle debstash
224 my ($syms, $file) = @_;
226 open(FILE, "< $file")
227 or die "embed.pl: Can't open $file: $!\n";
229 s/[ \t]*#.*//; # Delete comments.
230 if (/^\s*(\S+)\s*$/) {
232 warn "duplicate symbol $sym while processing $file\n"
233 if exists $$syms{$sym};
240 # Perl_pp_* and Perl_ck_* are in pp.sym
241 readsyms my %ppsym, 'pp.sym';
243 sub readvars(\%$$@) {
244 my ($syms, $file,$pre,$keep_pre) = @_;
246 open(FILE, "< $file")
247 or die "embed.pl: Can't open $file: $!\n";
249 s/[ \t]*#.*//; # Delete comments.
250 if (/PERLVARA?I?C?\($pre(\w+)/) {
252 $sym = $pre . $sym if $keep_pre;
253 warn "duplicate symbol $sym while processing $file\n"
254 if exists $$syms{$sym};
255 $$syms{$sym} = $pre || 1;
264 readvars %intrp, 'intrpvar.h','I';
265 readvars %thread, 'thrdvar.h','T';
266 readvars %globvar, 'perlvars.h','G';
269 foreach $sym (sort keys %thread) {
270 warn "$sym in intrpvar.h as well as thrdvar.h\n" if exists $intrp{$sym};
279 my ($from, $to) = @_;
280 my $t = int(length($from) / 8);
281 "#define $from" . "\t" x ($t < 3 ? 3 - $t : 1) . "$to\n";
284 sub bincompat_var ($$) {
285 my ($pfx, $sym) = @_;
286 my $arg = ($pfx eq 'G' ? 'NULL' : 'aTHX');
287 undefine("PL_$sym") . hide("PL_$sym", "(*Perl_${pfx}${sym}_ptr($arg))");
291 my ($sym,$pre,$ptr) = @_;
292 hide("PL_$sym", "($ptr$pre$sym)");
297 return hide("PL_$pre$sym", "PL_$sym");
301 open(EM, '> embed.h') or die "Can't create embed.h: $!\n";
307 * Copyright (c) 1997-2002, Larry Wall
309 * You may distribute under the terms of either the GNU General Public
310 * License or the Artistic License, as specified in the README file.
312 * !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
313 * This file is built by embed.pl from data in embed.pl, pp.sym, intrpvar.h,
314 * perlvars.h and thrdvar.h. Any changes made here will be lost!
317 /* (Doing namespace management portably in C is really gross.) */
319 /* NO_EMBED is no longer supported. i.e. EMBED is always active. */
321 /* provide binary compatible (but inconsistent) names */
322 #if defined(PERL_BINCOMPAT_5005)
323 # define Perl_call_atexit perl_atexit
324 # define Perl_eval_sv perl_eval_sv
325 # define Perl_eval_pv perl_eval_pv
326 # define Perl_call_argv perl_call_argv
327 # define Perl_call_method perl_call_method
328 # define Perl_call_pv perl_call_pv
329 # define Perl_call_sv perl_call_sv
330 # define Perl_get_av perl_get_av
331 # define Perl_get_cv perl_get_cv
332 # define Perl_get_hv perl_get_hv
333 # define Perl_get_sv perl_get_sv
334 # define Perl_init_i18nl10n perl_init_i18nl10n
335 # define Perl_init_i18nl14n perl_init_i18nl14n
336 # define Perl_new_collate perl_new_collate
337 # define Perl_new_ctype perl_new_ctype
338 # define Perl_new_numeric perl_new_numeric
339 # define Perl_require_pv perl_require_pv
340 # define Perl_safesyscalloc Perl_safecalloc
341 # define Perl_safesysfree Perl_safefree
342 # define Perl_safesysmalloc Perl_safemalloc
343 # define Perl_safesysrealloc Perl_saferealloc
344 # define Perl_set_numeric_local perl_set_numeric_local
345 # define Perl_set_numeric_standard perl_set_numeric_standard
346 /* malloc() pollution was the default in earlier versions, so enable
347 * it for bincompat; but not for systems that used to do prevent that,
348 * or when they ask for {HIDE,EMBED}MYMALLOC */
349 # if !defined(EMBEDMYMALLOC) && !defined(HIDEMYMALLOC)
350 # if !defined(NeXT) && !defined(__NeXT) && !defined(__MACHTEN__) && \
352 # define PERL_POLLUTE_MALLOC
357 /* Hide global symbols */
359 #if !defined(PERL_IMPLICIT_CONTEXT)
367 $ret .= "$arg\n" if $arg =~ /^#\s*(if|ifn?def|else|endif)\b/;
370 my ($flags,$retval,$func,@args) = @_;
371 unless ($flags =~ /[om]/) {
373 $ret .= hide($func,"S_$func");
375 elsif ($flags =~ /p/) {
376 $ret .= hide($func,"Perl_$func");
383 for $sym (sort keys %ppsym) {
385 print EM hide($sym, "Perl_$sym");
390 #else /* PERL_IMPLICIT_CONTEXT */
400 $ret .= "$arg\n" if $arg =~ /^#\s*(if|ifn?def|else|endif)\b/;
403 my ($flags,$retval,$func,@args) = @_;
404 unless ($flags =~ /[om]/) {
405 my $args = scalar @args;
406 if ($args and $args[$args-1] =~ /\.\.\./) {
407 # we're out of luck for varargs functions under CPP
409 elsif ($flags =~ /n/) {
411 $ret .= hide($func,"S_$func");
413 elsif ($flags =~ /p/) {
414 $ret .= hide($func,"Perl_$func");
418 my $alist = join(",", @az[0..$args-1]);
419 $ret = "#define $func($alist)";
420 my $t = int(length($ret) / 8);
421 $ret .= "\t" x ($t < 4 ? 4 - $t : 1);
423 $ret .= "S_$func(aTHX";
425 elsif ($flags =~ /p/) {
426 $ret .= "Perl_$func(aTHX";
428 $ret .= "_ " if $alist;
429 $ret .= $alist . ")\n";
436 for $sym (sort keys %ppsym) {
438 if ($sym =~ /^ck_/) {
439 print EM hide("$sym(a)", "Perl_$sym(aTHX_ a)");
441 elsif ($sym =~ /^pp_/) {
442 print EM hide("$sym()", "Perl_$sym(aTHX)");
445 warn "Illegal symbol '$sym' in pp.sym";
451 #endif /* PERL_IMPLICIT_CONTEXT */
457 /* Compatibility stubs. Compile extensions with -DPERL_NOCOMPAT to
461 #if !defined(PERL_CORE)
462 # define sv_setptrobj(rv,ptr,name) sv_setref_iv(rv,name,PTR2IV(ptr))
463 # define sv_setptrref(rv,ptr) sv_setref_iv(rv,Nullch,PTR2IV(ptr))
466 #if !defined(PERL_CORE) && !defined(PERL_NOCOMPAT) && !defined(PERL_BINCOMPAT_5005)
468 /* Compatibility for various misnamed functions. All functions
469 in the API that begin with "perl_" (not "Perl_") take an explicit
470 interpreter context pointer.
471 The following are not like that, but since they had a "perl_"
472 prefix in previous versions, we provide compatibility macros.
474 # define perl_atexit(a,b) call_atexit(a,b)
475 # define perl_call_argv(a,b,c) call_argv(a,b,c)
476 # define perl_call_pv(a,b) call_pv(a,b)
477 # define perl_call_method(a,b) call_method(a,b)
478 # define perl_call_sv(a,b) call_sv(a,b)
479 # define perl_eval_sv(a,b) eval_sv(a,b)
480 # define perl_eval_pv(a,b) eval_pv(a,b)
481 # define perl_require_pv(a) require_pv(a)
482 # define perl_get_sv(a,b) get_sv(a,b)
483 # define perl_get_av(a,b) get_av(a,b)
484 # define perl_get_hv(a,b) get_hv(a,b)
485 # define perl_get_cv(a,b) get_cv(a,b)
486 # define perl_init_i18nl10n(a) init_i18nl10n(a)
487 # define perl_init_i18nl14n(a) init_i18nl14n(a)
488 # define perl_new_ctype(a) new_ctype(a)
489 # define perl_new_collate(a) new_collate(a)
490 # define perl_new_numeric(a) new_numeric(a)
492 /* varargs functions can't be handled with CPP macros. :-(
493 This provides a set of compatibility functions that don't take
494 an extra argument but grab the context pointer using the macro
497 #if defined(PERL_IMPLICIT_CONTEXT)
498 # define croak Perl_croak_nocontext
499 # define deb Perl_deb_nocontext
500 # define die Perl_die_nocontext
501 # define form Perl_form_nocontext
502 # define load_module Perl_load_module_nocontext
503 # define mess Perl_mess_nocontext
504 # define newSVpvf Perl_newSVpvf_nocontext
505 # define sv_catpvf Perl_sv_catpvf_nocontext
506 # define sv_setpvf Perl_sv_setpvf_nocontext
507 # define warn Perl_warn_nocontext
508 # define warner Perl_warner_nocontext
509 # define sv_catpvf_mg Perl_sv_catpvf_mg_nocontext
510 # define sv_setpvf_mg Perl_sv_setpvf_mg_nocontext
513 #endif /* !defined(PERL_CORE) && !defined(PERL_NOCOMPAT) */
515 #if !defined(PERL_IMPLICIT_CONTEXT)
516 /* undefined symbols, point them back at the usual ones */
517 # define Perl_croak_nocontext Perl_croak
518 # define Perl_die_nocontext Perl_die
519 # define Perl_deb_nocontext Perl_deb
520 # define Perl_form_nocontext Perl_form
521 # define Perl_load_module_nocontext Perl_load_module
522 # define Perl_mess_nocontext Perl_mess
523 # define Perl_newSVpvf_nocontext Perl_newSVpvf
524 # define Perl_sv_catpvf_nocontext Perl_sv_catpvf
525 # define Perl_sv_setpvf_nocontext Perl_sv_setpvf
526 # define Perl_warn_nocontext Perl_warn
527 # define Perl_warner_nocontext Perl_warner
528 # define Perl_sv_catpvf_mg_nocontext Perl_sv_catpvf_mg
529 # define Perl_sv_setpvf_mg_nocontext Perl_sv_setpvf_mg
537 open(EM, '> embedvar.h')
538 or die "Can't create embedvar.h: $!\n";
544 * Copyright (c) 1997-2002, Larry Wall
546 * You may distribute under the terms of either the GNU General Public
547 * License or the Artistic License, as specified in the README file.
550 * !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
551 * This file is built by embed.pl from data in embed.pl, pp.sym, intrpvar.h,
552 * perlvars.h and thrdvar.h. Any changes made here will be lost!
555 /* (Doing namespace management portably in C is really gross.) */
558 The following combinations of MULTIPLICITY, USE_5005THREADS
559 and PERL_IMPLICIT_CONTEXT are supported:
561 2) MULTIPLICITY # supported for compatibility
562 3) MULTIPLICITY && PERL_IMPLICIT_CONTEXT
563 4) USE_5005THREADS && PERL_IMPLICIT_CONTEXT
564 5) MULTIPLICITY && USE_5005THREADS && PERL_IMPLICIT_CONTEXT
566 All other combinations of these flags are errors.
568 #3, #4, #5, and #6 are supported directly, while #2 is a special
569 case of #3 (supported by redefining vTHX appropriately).
572 #if defined(MULTIPLICITY)
573 /* cases 2, 3 and 5 above */
575 # if defined(PERL_IMPLICIT_CONTEXT)
578 # define vTHX PERL_GET_INTERP
583 for $sym (sort keys %thread) {
584 print EM multon($sym,'T','vTHX->');
589 # if defined(USE_5005THREADS)
594 for $sym (sort keys %intrp) {
595 print EM multon($sym,'I','PERL_GET_INTERP->');
600 # else /* !USE_5005THREADS */
601 /* cases 2 and 3 above */
605 for $sym (sort keys %intrp) {
606 print EM multon($sym,'I','vTHX->');
611 # endif /* USE_5005THREADS */
613 #else /* !MULTIPLICITY */
615 /* cases 1 and 4 above */
619 for $sym (sort keys %intrp) {
620 print EM multoff($sym,'I');
625 # if defined(USE_5005THREADS)
630 for $sym (sort keys %thread) {
631 print EM multon($sym,'T','aTHX->');
636 # else /* !USE_5005THREADS */
641 for $sym (sort keys %thread) {
642 print EM multoff($sym,'T');
647 # endif /* USE_5005THREADS */
648 #endif /* MULTIPLICITY */
650 #if defined(PERL_GLOBAL_STRUCT)
654 for $sym (sort keys %globvar) {
655 print EM multon($sym,'G','PL_Vars.');
660 #else /* !PERL_GLOBAL_STRUCT */
664 for $sym (sort keys %globvar) {
665 print EM multoff($sym,'G');
670 #endif /* PERL_GLOBAL_STRUCT */
672 #ifdef PERL_POLLUTE /* disabled by default in 5.6.0 */
676 for $sym (sort @extvars) {
677 print EM hide($sym,"PL_$sym");
682 #endif /* PERL_POLLUTE */
689 open(CAPI, '> perlapi.c') or die "Can't create perlapi.c: $!\n";
690 open(CAPIH, '> perlapi.h') or die "Can't create perlapi.h: $!\n";
696 * Copyright (c) 1997-2002, Larry Wall
698 * You may distribute under the terms of either the GNU General Public
699 * License or the Artistic License, as specified in the README file.
702 * !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
703 * This file is built by embed.pl from data in embed.pl, pp.sym, intrpvar.h,
704 * perlvars.h and thrdvar.h. Any changes made here will be lost!
707 /* declare accessor functions for Perl variables */
708 #ifndef __perlapi_h__
709 #define __perlapi_h__
711 #if defined (MULTIPLICITY)
719 #define PERLVAR(v,t) EXTERN_C t* Perl_##v##_ptr(pTHX);
720 #define PERLVARA(v,n,t) typedef t PL_##v##_t[n]; \
721 EXTERN_C PL_##v##_t* Perl_##v##_ptr(pTHX);
722 #define PERLVARI(v,t,i) PERLVAR(v,t)
723 #define PERLVARIC(v,t,i) PERLVAR(v, const t)
726 #include "intrpvar.h"
727 #include "perlvars.h"
736 #if defined(PERL_CORE)
738 /* accessor functions for Perl variables (provide binary compatibility) */
740 /* these need to be mentioned here, or most linkers won't put them in
741 the perl executable */
743 #ifndef PERL_NO_FORCE_LINK
748 EXT void *PL_force_link_funcs[];
750 EXT void *PL_force_link_funcs[] = {
755 #define PERLVAR(v,t) (void*)Perl_##v##_ptr,
756 #define PERLVARA(v,n,t) PERLVAR(v,t)
757 #define PERLVARI(v,t,i) PERLVAR(v,t)
758 #define PERLVARIC(v,t,i) PERLVAR(v,t)
761 #include "intrpvar.h"
762 #include "perlvars.h"
773 #endif /* PERL_NO_FORCE_LINK */
775 #else /* !PERL_CORE */
779 foreach $sym (sort keys %intrp) {
780 print CAPIH bincompat_var('I',$sym);
783 foreach $sym (sort keys %thread) {
784 print CAPIH bincompat_var('T',$sym);
787 foreach $sym (sort keys %globvar) {
788 print CAPIH bincompat_var('G',$sym);
793 #endif /* !PERL_CORE */
794 #endif /* MULTIPLICITY */
796 #endif /* __perlapi_h__ */
805 * Copyright (c) 1997-2002, Larry Wall
807 * You may distribute under the terms of either the GNU General Public
808 * License or the Artistic License, as specified in the README file.
811 * !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
812 * This file is built by embed.pl from data in embed.pl, pp.sym, intrpvar.h,
813 * perlvars.h and thrdvar.h. Any changes made here will be lost!
820 #if defined (MULTIPLICITY)
822 /* accessor functions for Perl variables (provides binary compatibility) */
830 #define PERLVAR(v,t) t* Perl_##v##_ptr(pTHX) \
831 { return &(aTHX->v); }
832 #define PERLVARA(v,n,t) PL_##v##_t* Perl_##v##_ptr(pTHX) \
833 { return &(aTHX->v); }
835 #define PERLVARI(v,t,i) PERLVAR(v,t)
836 #define PERLVARIC(v,t,i) PERLVAR(v, const t)
839 #include "intrpvar.h"
843 #define PERLVAR(v,t) t* Perl_##v##_ptr(pTHX) \
844 { return &(PL_##v); }
845 #define PERLVARA(v,n,t) PL_##v##_t* Perl_##v##_ptr(pTHX) \
846 { return &(PL_##v); }
848 #define PERLVARIC(v,t,i) const t* Perl_##v##_ptr(pTHX) \
849 { return (const t *)&(PL_##v); }
850 #include "perlvars.h"
859 #endif /* MULTIPLICITY */
864 # functions that take va_list* for implementing vararg functions
865 # NOTE: makedef.pl must be updated if you add symbols to %vfuncs
866 # XXX %vfuncs currently unused
868 Perl_croak Perl_vcroak
870 Perl_warner Perl_vwarner
873 Perl_load_module Perl_vload_module
876 Perl_newSVpvf Perl_vnewSVpvf
877 Perl_sv_setpvf Perl_sv_vsetpvf
878 Perl_sv_setpvf_mg Perl_sv_vsetpvf_mg
879 Perl_sv_catpvf Perl_sv_vcatpvf
880 Perl_sv_catpvf_mg Perl_sv_vcatpvf_mg
881 Perl_dump_indent Perl_dump_vindent
882 Perl_default_protect Perl_vdefault_protect