makedef.pl

   1 #./perl -w
   2 #
   3 # Create the export list for perl.
   4 #
   5 # Needed by WIN32 and OS/2 for creating perl.dll,
   6 # and by AIX for creating libperl.a when -Duseshrplib is in effect,
   7 # and by VMS for creating perlshr.exe.
   8 #
   9 # Reads from information stored in
  10 #
  11 #    %Config::Config (ie config.sh)
  12 #    config.h
  13 #    embed.fnc
  14 #    globvar.sym
  15 #    intrpvar.h
  16 #    miniperl.map (on OS/2)
  17 #    perl5.def    (on OS/2; this is the old version of the file being made)
  18 #    perlio.sym
  19 #    perlvars.h
  20 #    regen/opcodes
  21 #
  22 # plus long lists of function names hard-coded directly in this script.
  23 #
  24 # Writes the result to STDOUT.
  25 #
  26 # Normally this script is invoked from a makefile (e.g. win32/Makefile),
  27 # which redirects STDOUT to a suitable file, such as:
  28 #
  29 #    perl5.def   OS/2
  30 #    perldll.def Windows
  31 #    perl.exp    AIX
  32 #    perl.imp    NetWare
  33 #    makedef.lis VMS
  34
  35 BEGIN { unshift @INC, "lib" }
  36 use Config;
  37 use strict;
  38
  39 my %ARGS = (CCTYPE => 'MSVC', TARG_DIR => '');
  40
  41 my %define;
  42
  43 my $fold;
  44
  45 sub process_cc_flags {
  46     foreach (map {split /\s+/, $_} @_) {
  47         $define{$1} = $2 // 1 if /^-D(\w+)(?:=(.+))?/;
  48     }
  49 }
  50
  51 while (@ARGV) {
  52     my $flag = shift;
  53     if ($flag =~ /^(?:CC_FLAGS=)?(-D\w.*)/) {
  54         process_cc_flags($1);
  55     } elsif ($flag =~ /^(CCTYPE|FILETYPE|PLATFORM|TARG_DIR)=(.+)$/) {
  56         $ARGS{$1} = $2;
  57     } elsif ($flag eq '--sort-fold') {
  58         ++$fold;
  59     }
  60 }
  61
  62 require "$ARGS{TARG_DIR}regen/embed_lib.pl";
  63
  64 {
  65     my @PLATFORM = qw(aix win32 wince os2 netware vms test);
  66     my %PLATFORM;
  67     @PLATFORM{@PLATFORM} = ();
  68
  69     die "PLATFORM undefined, must be one of: @PLATFORM\n"
  70         unless defined $ARGS{PLATFORM};
  71     die "PLATFORM must be one of: @PLATFORM\n"
  72         unless exists $PLATFORM{$ARGS{PLATFORM}};
  73 }
  74
  75 # Is the following guard strictly necessary? Added during refactoring
  76 # to keep the same behaviour when merging other code into here.
  77 process_cc_flags(@Config{qw(ccflags optimize)})
  78     if $ARGS{PLATFORM} ne 'win32' && $ARGS{PLATFORM} ne 'wince'
  79     && $ARGS{PLATFORM} ne 'netware';
  80
  81 # Add the compile-time options that miniperl was built with to %define.
  82 # On Win32 these are not the same options as perl itself will be built
  83 # with since miniperl is built with a canned config (one of the win32/
  84 # config_H.*) and none of the BUILDOPT's that are set in the makefiles,
  85 # but they do include some #define's that are hard-coded in various
  86 # source files and header files and don't include any BUILDOPT's that
  87 # the user might have chosen to disable because the canned configs are
  88 # minimal configs that don't include any of those options.
  89
  90 my @options = sort(Config::bincompat_options(), Config::non_bincompat_options());
  91 print STDERR "Options: (@options)\n" unless $ARGS{PLATFORM} eq 'test';
  92 $define{$_} = 1 foreach @options;
  93
  94 my %exportperlmalloc =
  95     (
  96        Perl_malloc              =>      "malloc",
  97        Perl_mfree               =>      "free",
  98        Perl_realloc             =>      "realloc",
  99        Perl_calloc              =>      "calloc",
 100     );
 101
 102 my $exportperlmalloc = $ARGS{PLATFORM} eq 'os2';
 103
 104 open(CFG, '<', 'config.h') || die "Cannot open config.h: $!\n";
 105 while (<CFG>) {
 106     $define{$1} = 1 if /^\s*\#\s*define\s+(MYMALLOC|MULTIPLICITY
 107                                            |SPRINTF_RETURNS_STRLEN
 108                                            |(?:PERL|USE|HAS)_\w+)\b/x;
 109 }
 110 close(CFG);
 111
 112 # perl.h logic duplication begins
 113
 114 if ($define{USE_ITHREADS}) {
 115     if (!$define{MULTIPLICITY}) {
 116         $define{MULTIPLICITY} = 1;
 117     }
 118 }
 119
 120 $define{PERL_IMPLICIT_CONTEXT} ||=
 121     $define{USE_ITHREADS} ||
 122     $define{MULTIPLICITY} ;
 123
 124 if ($define{USE_ITHREADS} && $ARGS{PLATFORM} ne 'win32' && $^O ne 'darwin') {
 125     $define{USE_REENTRANT_API} = 1;
 126 }
 127
 128 # perl.h logic duplication ends
 129
 130 print STDERR "Defines: (" . join(' ', sort keys %define) . ")\n"
 131      unless $ARGS{PLATFORM} eq 'test';
 132
 133 my $sym_ord = 0;
 134 my %ordinal;
 135
 136 if ($ARGS{PLATFORM} eq 'os2') {
 137     if (open my $fh, '<', 'perl5.def') {
 138       while (<$fh>) {
 139         last if /^\s*EXPORTS\b/;
 140       }
 141       while (<$fh>) {
 142         $ordinal{$1} = $2 if /^\s*"(\w+)"\s*(?:=\s*"\w+"\s*)?\@(\d+)\s*$/;
 143         # This allows skipping ordinals which were used in older versions
 144         $sym_ord = $1 if /^\s*;\s*LAST_ORDINAL\s*=\s*(\d+)\s*$/;
 145       }
 146       $sym_ord < $_ and $sym_ord = $_ for values %ordinal; # Take the max
 147     }
 148 }
 149
 150 my %skip;
 151 # All platforms export boot_DynaLoader unconditionally.
 152 my %export = ( boot_DynaLoader => 1 );
 153
 154 sub try_symbols {
 155     foreach my $symbol (@_) {
 156         ++$export{$symbol} unless exists $skip{$symbol};
 157     }
 158 }
 159
 160 sub readvar {
 161     # $hash is the hash that we're adding to. For one of our callers, it will
 162     # actually be the skip hash but that doesn't affect the intent of what
 163     # we're doing, as in that case we skip adding something to the skip hash
 164     # for the second time.
 165
 166     my $file = $ARGS{TARG_DIR} . shift;
 167     my $hash = shift;
 168     my $proc = shift;
 169     open my $vars, '<', $file or die die "Cannot open $file: $!\n";
 170
 171     while (<$vars>) {
 172         # All symbols have a Perl_ prefix because that's what embed.h sticks
 173         # in front of them.  The A?I?S?C? is strictly speaking wrong.
 174         next unless /\bPERLVAR(A?I?S?C?)\(([IGT]),\s*(\w+)/;
 175
 176         my $var = "PL_$3";
 177         my $symbol = $proc ? &$proc($1,$2,$3) : $var;
 178         ++$hash->{$symbol} unless exists $skip{$var};
 179     }
 180 }
 181
 182 if ($ARGS{PLATFORM} ne 'os2') {
 183     ++$skip{$_} foreach qw(
 184                      PL_cryptseen
 185                      PL_opsave
 186                      Perl_GetVars
 187                      Perl_dump_fds
 188                      Perl_my_bcopy
 189                      Perl_my_bzero
 190                      Perl_my_chsize
 191                      Perl_my_htonl
 192                      Perl_my_memcmp
 193                      Perl_my_memset
 194                      Perl_my_ntohl
 195                      Perl_my_swap
 196                          );
 197     if ($ARGS{PLATFORM} eq 'vms') {
 198         ++$skip{PL_statusvalue_posix};
 199         # This is a wrapper if we have symlink, not a replacement
 200         # if we don't.
 201         ++$skip{Perl_my_symlink} unless $Config{d_symlink};
 202     } else {
 203         ++$skip{PL_statusvalue_vms};
 204         if ($ARGS{PLATFORM} ne 'aix') {
 205             ++$skip{$_} foreach qw(
 206                                 PL_DBcv
 207                                 PL_generation
 208                                 PL_lastgotoprobe
 209                                 PL_modcount
 210                                 PL_timesbuf
 211                                 main
 212                                  );
 213         }
 214     }
 215 }
 216
 217 if ($ARGS{PLATFORM} ne 'vms') {
 218     # VMS does its own thing for these symbols.
 219     ++$skip{$_} foreach qw(
 220                         PL_sig_handlers_initted
 221                         PL_sig_ignoring
 222                         PL_sig_defaulting
 223                          );
 224     if ($ARGS{PLATFORM} ne 'win32') {
 225         ++$skip{$_} foreach qw(
 226                             Perl_do_spawn
 227                             Perl_do_spawn_nowait
 228                             Perl_do_aspawn
 229                              );
 230     }
 231 }
 232
 233 unless ($define{UNLINK_ALL_VERSIONS}) {
 234     ++$skip{Perl_unlnk};
 235 }
 236
 237 unless ($define{'DEBUGGING'}) {
 238     ++$skip{$_} foreach qw(
 239                     Perl_debop
 240                     Perl_debprofdump
 241                     Perl_debstack
 242                     Perl_debstackptrs
 243                     Perl_pad_sv
 244                     Perl_pad_setsv
 245                     Perl_hv_assert
 246                     PL_watchaddr
 247                     PL_watchok
 248                     PL_watch_pvx
 249                          );
 250 }
 251
 252 if ($define{'PERL_IMPLICIT_SYS'}) {
 253     ++$skip{$_} foreach qw(
 254                     Perl_my_popen
 255                     Perl_my_pclose
 256                          );
 257     ++$export{$_} foreach qw(perl_get_host_info perl_alloc_override);
 258     ++$export{perl_clone_host} if $define{USE_ITHREADS};
 259 }
 260 else {
 261     ++$skip{$_} foreach qw(
 262                     PL_Mem
 263                     PL_MemShared
 264                     PL_MemParse
 265                     PL_Env
 266                     PL_StdIO
 267                     PL_LIO
 268                     PL_Dir
 269                     PL_Sock
 270                     PL_Proc
 271                     perl_alloc_using
 272                     perl_clone_using
 273                          );
 274 }
 275
 276 unless ($define{'PERL_OLD_COPY_ON_WRITE'}) {
 277     ++$skip{Perl_sv_setsv_cow};
 278 }
 279
 280 unless ($define{'USE_REENTRANT_API'}) {
 281     ++$skip{PL_reentrant_buffer};
 282 }
 283
 284 if ($define{'MYMALLOC'}) {
 285     try_symbols(qw(
 286                     Perl_dump_mstats
 287                     Perl_get_mstats
 288                     Perl_strdup
 289                     Perl_putenv
 290                     MallocCfg_ptr
 291                     MallocCfgP_ptr
 292                     ));
 293     unless ($define{USE_ITHREADS}) {
 294         ++$skip{PL_malloc_mutex}
 295     }
 296 }
 297 else {
 298     ++$skip{$_} foreach qw(
 299                     PL_malloc_mutex
 300                     Perl_dump_mstats
 301                     Perl_get_mstats
 302                     MallocCfg_ptr
 303                     MallocCfgP_ptr
 304                          );
 305 }
 306
 307 if ($define{'PERL_USE_SAFE_PUTENV'}) {
 308     ++$skip{PL_use_safe_putenv};
 309 }
 310
 311 unless ($define{'USE_ITHREADS'}) {
 312     ++$skip{PL_thr_key};
 313 }
 314
 315 # USE_5005THREADS symbols. Kept as reference for easier removal
 316 ++$skip{$_} foreach qw(
 317                     PL_sv_mutex
 318                     PL_strtab_mutex
 319                     PL_svref_mutex
 320                     PL_cred_mutex
 321                     PL_eval_mutex
 322                     PL_fdpid_mutex
 323                     PL_sv_lock_mutex
 324                     PL_eval_cond
 325                     PL_eval_owner
 326                     PL_threads_mutex
 327                     PL_nthreads
 328                     PL_nthreads_cond
 329                     PL_threadnum
 330                     PL_threadsv_names
 331                     PL_thrsv
 332                     PL_vtbl_mutex
 333                     Perl_condpair_magic
 334                     Perl_new_struct_thread
 335                     Perl_per_thread_magicals
 336                     Perl_thread_create
 337                     Perl_find_threadsv
 338                     Perl_unlock_condpair
 339                     Perl_magic_mutexfree
 340                     Perl_sv_lock
 341                      );
 342
 343 unless ($define{'USE_ITHREADS'}) {
 344     ++$skip{$_} foreach qw(
 345                     PL_check_mutex
 346                     PL_op_mutex
 347                     PL_regex_pad
 348                     PL_regex_padav
 349                     PL_dollarzero_mutex
 350                     PL_hints_mutex
 351                     PL_my_ctx_mutex
 352                     PL_perlio_mutex
 353                     PL_stashpad
 354                     PL_stashpadix
 355                     PL_stashpadmax
 356                     Perl_alloccopstash
 357                     Perl_clone_params_del
 358                     Perl_clone_params_new
 359                     Perl_parser_dup
 360                     Perl_dirp_dup
 361                     Perl_cx_dup
 362                     Perl_si_dup
 363                     Perl_any_dup
 364                     Perl_ss_dup
 365                     Perl_fp_dup
 366                     Perl_gp_dup
 367                     Perl_he_dup
 368                     Perl_mg_dup
 369                     Perl_re_dup_guts
 370                     Perl_sv_dup
 371                     Perl_sv_dup_inc
 372                     Perl_rvpv_dup
 373                     Perl_hek_dup
 374                     Perl_sys_intern_dup
 375                     perl_clone
 376                     perl_clone_using
 377                     Perl_stashpv_hvname_match
 378                     Perl_regdupe_internal
 379                     Perl_newPADOP
 380                          );
 381 }
 382
 383 unless ($define{'PERL_IMPLICIT_CONTEXT'}) {
 384     ++$skip{$_} foreach qw(
 385                     PL_my_cxt_index
 386                     PL_my_cxt_list
 387                     PL_my_cxt_size
 388                     PL_my_cxt_keys
 389                     Perl_croak_nocontext
 390                     Perl_die_nocontext
 391                     Perl_deb_nocontext
 392                     Perl_form_nocontext
 393                     Perl_load_module_nocontext
 394                     Perl_mess_nocontext
 395                     Perl_warn_nocontext
 396                     Perl_warner_nocontext
 397                     Perl_newSVpvf_nocontext
 398                     Perl_sv_catpvf_nocontext
 399                     Perl_sv_setpvf_nocontext
 400                     Perl_sv_catpvf_mg_nocontext
 401                     Perl_sv_setpvf_mg_nocontext
 402                     Perl_my_cxt_init
 403                     Perl_my_cxt_index
 404                          );
 405 }
 406
 407 unless ($define{'PERL_NEED_APPCTX'}) {
 408     ++$skip{PL_appctx};
 409 }
 410
 411 unless ($define{'PERL_NEED_TIMESBASE'}) {
 412     ++$skip{PL_timesbase};
 413 }
 414
 415 unless ($define{'DEBUG_LEAKING_SCALARS'}) {
 416     ++$skip{PL_sv_serial};
 417 }
 418
 419 unless ($define{'DEBUG_LEAKING_SCALARS_FORK_DUMP'}) {
 420     ++$skip{PL_dumper_fd};
 421 }
 422
 423 unless ($define{'PERL_DONT_CREATE_GVSV'}) {
 424     ++$skip{Perl_gv_SVadd};
 425 }
 426
 427 if ($define{'SPRINTF_RETURNS_STRLEN'}) {
 428     ++$skip{Perl_my_sprintf};
 429 }
 430
 431 unless ($define{'PERL_USES_PL_PIDSTATUS'}) {
 432     ++$skip{PL_pidstatus};
 433 }
 434
 435 unless ($define{'PERL_TRACK_MEMPOOL'}) {
 436     ++$skip{PL_memory_debug_header};
 437 }
 438
 439 unless ($define{PERL_MAD}) {
 440     ++$skip{$_} foreach qw(
 441                     PL_madskills
 442                     PL_xmlfp
 443                          );
 444 }
 445
 446 unless ($define{'MULTIPLICITY'}) {
 447     ++$skip{$_} foreach qw(
 448                     PL_interp_size
 449                     PL_interp_size_5_16_0
 450                          );
 451 }
 452
 453 unless ($define{'PERL_GLOBAL_STRUCT'}) {
 454     ++$skip{PL_global_struct_size};
 455 }
 456
 457 unless ($define{'PERL_GLOBAL_STRUCT_PRIVATE'}) {
 458     ++$skip{$_} foreach qw(
 459                     PL_my_cxt_keys
 460                     Perl_my_cxt_index
 461                          );
 462 }
 463
 464 unless ($define{HAS_MMAP}) {
 465     ++$skip{PL_mmap_page_size};
 466 }
 467
 468 if ($define{HAS_SIGACTION}) {
 469     ++$skip{PL_sig_trapped};
 470
 471     if ($ARGS{PLATFORM} eq 'vms') {
 472         # FAKE_PERSISTENT_SIGNAL_HANDLERS defined as !defined(HAS_SIGACTION)
 473         ++$skip{PL_sig_ignoring};
 474     }
 475 }
 476
 477 unless ($define{USE_LOCALE_COLLATE}) {
 478     ++$skip{$_} foreach qw(
 479                     PL_collation_ix
 480                     PL_collation_name
 481                     PL_collation_standard
 482                     PL_collxfrm_base
 483                     PL_collxfrm_mult
 484                     Perl_sv_collxfrm
 485                     Perl_sv_collxfrm_flags
 486                          );
 487 }
 488
 489 unless ($define{USE_LOCALE_NUMERIC}) {
 490     ++$skip{$_} foreach qw(
 491                     PL_numeric_local
 492                     PL_numeric_name
 493                     PL_numeric_radix_sv
 494                     PL_numeric_standard
 495                          );
 496 }
 497
 498 unless ($define{HAVE_INTERP_INTERN}) {
 499     ++$skip{$_} foreach qw(
 500                     Perl_sys_intern_clear
 501                     Perl_sys_intern_dup
 502                     Perl_sys_intern_init
 503                     PL_sys_intern
 504                          );
 505 }
 506
 507 if ($define{HAS_SIGNBIT}) {
 508     ++$skip{Perl_signbit};
 509 }
 510
 511 if ($define{'PERL_GLOBAL_STRUCT'}) {
 512     readvar('perlvars.h', \%skip);
 513     # This seems like the least ugly way to cope with the fact that PL_sh_path
 514     # is mentioned in perlvar.h and globvar.sym, and always exported.
 515     delete $skip{PL_sh_path};
 516     ++$export{Perl_GetVars};
 517     try_symbols(qw(PL_Vars PL_VarsPtr)) unless $ARGS{CCTYPE} eq 'GCC';
 518 } else {
 519     ++$skip{$_} foreach qw(Perl_init_global_struct Perl_free_global_struct);
 520 }
 521
 522 # functions from *.sym files
 523
 524 my @syms = qw(globvar.sym);
 525
 526 # Symbols that are the public face of the PerlIO layers implementation
 527 # These are in _addition to_ the public face of the abstraction
 528 # and need to be exported to allow XS modules to implement layers
 529 my @layer_syms = qw(
 530                     PerlIOBase_binmode
 531                     PerlIOBase_clearerr
 532                     PerlIOBase_close
 533                     PerlIOBase_dup
 534                     PerlIOBase_eof
 535                     PerlIOBase_error
 536                     PerlIOBase_fileno
 537                     PerlIOBase_open
 538                     PerlIOBase_noop_fail
 539                     PerlIOBase_noop_ok
 540                     PerlIOBase_popped
 541                     PerlIOBase_pushed
 542                     PerlIOBase_read
 543                     PerlIOBase_setlinebuf
 544                     PerlIOBase_unread
 545                     PerlIOBuf_bufsiz
 546                     PerlIOBuf_close
 547                     PerlIOBuf_dup
 548                     PerlIOBuf_fill
 549                     PerlIOBuf_flush
 550                     PerlIOBuf_get_base
 551                     PerlIOBuf_get_cnt
 552                     PerlIOBuf_get_ptr
 553                     PerlIOBuf_open
 554                     PerlIOBuf_popped
 555                     PerlIOBuf_pushed
 556                     PerlIOBuf_read
 557                     PerlIOBuf_seek
 558                     PerlIOBuf_set_ptrcnt
 559                     PerlIOBuf_tell
 560                     PerlIOBuf_unread
 561                     PerlIOBuf_write
 562                     PerlIO_allocate
 563                     PerlIO_apply_layera
 564                     PerlIO_apply_layers
 565                     PerlIO_arg_fetch
 566                     PerlIO_debug
 567                     PerlIO_define_layer
 568                     PerlIO_find_layer
 569                     PerlIO_isutf8
 570                     PerlIO_layer_fetch
 571                     PerlIO_list_alloc
 572                     PerlIO_list_free
 573                     PerlIO_modestr
 574                     PerlIO_parse_layers
 575                     PerlIO_pending
 576                     PerlIO_perlio
 577                     PerlIO_pop
 578                     PerlIO_push
 579                     PerlIO_sv_dup
 580                     Perl_PerlIO_clearerr
 581                     Perl_PerlIO_close
 582                     Perl_PerlIO_context_layers
 583                     Perl_PerlIO_eof
 584                     Perl_PerlIO_error
 585                     Perl_PerlIO_fileno
 586                     Perl_PerlIO_fill
 587                     Perl_PerlIO_flush
 588                     Perl_PerlIO_get_base
 589                     Perl_PerlIO_get_bufsiz
 590                     Perl_PerlIO_get_cnt
 591                     Perl_PerlIO_get_ptr
 592                     Perl_PerlIO_read
 593                     Perl_PerlIO_seek
 594                     Perl_PerlIO_set_cnt
 595                     Perl_PerlIO_set_ptrcnt
 596                     Perl_PerlIO_setlinebuf
 597                     Perl_PerlIO_stderr
 598                     Perl_PerlIO_stdin
 599                     Perl_PerlIO_stdout
 600                     Perl_PerlIO_tell
 601                     Perl_PerlIO_unread
 602                     Perl_PerlIO_write
 603 );
 604 if ($ARGS{PLATFORM} eq 'netware') {
 605     push(@layer_syms,'PL_def_layerlist','PL_known_layers','PL_perlio');
 606 }
 607
 608 if ($define{'USE_PERLIO'}) {
 609     # Export the symols that make up the PerlIO abstraction, regardless
 610     # of its implementation - read from a file
 611     push @syms, 'perlio.sym';
 612
 613     # This part is then dependent on how the abstraction is implemented
 614     if ($define{'USE_SFIO'}) {
 615         # Old legacy non-stdio "PerlIO"
 616         ++$skip{$_} foreach @layer_syms;
 617         ++$skip{perlsio_binmode};
 618         # SFIO defines most of the PerlIO routines as macros
 619         # So undo most of what $perlio_sym has just done - d'oh !
 620         # Perhaps it would be better to list the ones which do exist
 621         # And emit them
 622         ++$skip{$_} foreach qw(
 623                          PerlIO_canset_cnt
 624                          PerlIO_clearerr
 625                          PerlIO_close
 626                          PerlIO_eof
 627                          PerlIO_error
 628                          PerlIO_exportFILE
 629                          PerlIO_fast_gets
 630                          PerlIO_fdopen
 631                          PerlIO_fileno
 632                          PerlIO_findFILE
 633                          PerlIO_flush
 634                          PerlIO_get_base
 635                          PerlIO_get_bufsiz
 636                          PerlIO_get_cnt
 637                          PerlIO_get_ptr
 638                          PerlIO_getc
 639                          PerlIO_getname
 640                          PerlIO_has_base
 641                          PerlIO_has_cntptr
 642                          PerlIO_importFILE
 643                          PerlIO_open
 644                          PerlIO_printf
 645                          PerlIO_putc
 646                          PerlIO_puts
 647                          PerlIO_read
 648                          PerlIO_releaseFILE
 649                          PerlIO_reopen
 650                          PerlIO_rewind
 651                          PerlIO_seek
 652                          PerlIO_set_cnt
 653                          PerlIO_set_ptrcnt
 654                          PerlIO_setlinebuf
 655                          PerlIO_sprintf
 656                          PerlIO_stderr
 657                          PerlIO_stdin
 658                          PerlIO_stdout
 659                          PerlIO_stdoutf
 660                          PerlIO_tell
 661                          PerlIO_ungetc
 662                          PerlIO_vprintf
 663                          PerlIO_write
 664                          PerlIO_perlio
 665                          Perl_PerlIO_clearerr
 666                          Perl_PerlIO_close
 667                          Perl_PerlIO_eof
 668                          Perl_PerlIO_error
 669                          Perl_PerlIO_fileno
 670                          Perl_PerlIO_fill
 671                          Perl_PerlIO_flush
 672                          Perl_PerlIO_get_base
 673                          Perl_PerlIO_get_bufsiz
 674                          Perl_PerlIO_get_cnt
 675                          Perl_PerlIO_get_ptr
 676                          Perl_PerlIO_read
 677                          Perl_PerlIO_seek
 678                          Perl_PerlIO_set_cnt
 679                          Perl_PerlIO_set_ptrcnt
 680                          Perl_PerlIO_setlinebuf
 681                          Perl_PerlIO_stderr
 682                          Perl_PerlIO_stdin
 683                          Perl_PerlIO_stdout
 684                          Perl_PerlIO_tell
 685                          Perl_PerlIO_unread
 686                          Perl_PerlIO_write
 687                          PL_def_layerlist
 688                          PL_known_layers
 689                          PL_perlio
 690                              );
 691     }
 692     else {
 693         # PerlIO with layers - export implementation
 694         try_symbols(@layer_syms, 'perlsio_binmode');
 695     }
 696 } else {
 697         # -Uuseperlio
 698         # Skip the PerlIO layer symbols - although
 699         # nothing should have exported them anyway.
 700         ++$skip{$_} foreach @layer_syms;
 701         ++$skip{$_} foreach qw(
 702                         perlsio_binmode
 703                         PL_def_layerlist
 704                         PL_known_layers
 705                         PL_perlio
 706                         PL_perlio_debug_fd
 707                         PL_perlio_fd_refcnt
 708                         PL_perlio_fd_refcnt_size
 709                         PL_perlio_mutex
 710                              );
 711
 712         # Also do NOT add abstraction symbols from $perlio_sym
 713         # abstraction is done as #define to stdio
 714         # Remaining remnants that _may_ be functions are handled below.
 715 }
 716
 717 ###############################################################################
 718
 719 # At this point all skip lists should be completed, as we are about to test
 720 # many symbols against them.
 721
 722 {
 723     my %seen;
 724     my ($embed) = setup_embed($ARGS{TARG_DIR});
 725
 726     foreach (@$embed) {
 727         my ($flags, $retval, $func, @args) = @$_;
 728         next unless $func;
 729         if ($flags =~ /[AX]/ && $flags !~ /[xm]/ || $flags =~ /b/) {
 730             # public API, so export
 731
 732             # If a function is defined twice, for example before and after
 733             # an #else, only export its name once. Important to do this test
 734             # within the block, as the *first* definition may have flags which
 735             # mean "don't export"
 736             next if $seen{$func}++;
 737             $func = "Perl_$func" if $flags =~ /[pbX]/;
 738             ++$export{$func} unless exists $skip{$func};
 739         }
 740     }
 741 }
 742
 743 foreach (@syms) {
 744     my $syms = $ARGS{TARG_DIR} . $_;
 745     open my $global, '<', $syms or die "failed to open $syms: $!\n";
 746     # Functions already have a Perl_ prefix
 747     # Variables need a PL_ prefix
 748     my $prefix = $syms =~ /var\.sym$/i ? 'PL_' : '';
 749     while (<$global>) {
 750         next unless /^([A-Za-z].*)/;
 751         my $symbol = "$prefix$1";
 752         ++$export{$symbol} unless exists $skip{$symbol};
 753     }
 754 }
 755
 756 # variables
 757
 758 if ($define{'MULTIPLICITY'} && $define{PERL_GLOBAL_STRUCT}) {
 759     readvar('perlvars.h', \%export, sub { "Perl_" . $_[1] . $_[2] . "_ptr" });
 760     # XXX AIX seems to want the perlvars.h symbols, for some reason
 761     if ($ARGS{PLATFORM} eq 'aix' or $ARGS{PLATFORM} eq 'os2') { # OS/2 needs PL_thr_key
 762         readvar('perlvars.h', \%export);
 763     }
 764 }
 765 else {
 766     unless ($define{'PERL_GLOBAL_STRUCT'}) {
 767         readvar('perlvars.h', \%export);
 768     }
 769     unless ($define{MULTIPLICITY}) {
 770         readvar('intrpvar.h', \%export);
 771     }
 772 }
 773
 774 # Oddities from PerlIO
 775 # All have alternate implementations in perlio.c, so always exist.
 776 # Should they be considered to be part of the API?
 777 try_symbols(qw(
 778                     PerlIO_binmode
 779                     PerlIO_getpos
 780                     PerlIO_init
 781                     PerlIO_setpos
 782                     PerlIO_sprintf
 783                     PerlIO_tmpfile
 784                     PerlIO_vsprintf
 785              ));
 786
 787 if ($ARGS{PLATFORM} eq 'win32') {
 788     try_symbols(qw(
 789                                  setgid
 790                                  setuid
 791                                  win32_free_childdir
 792                                  win32_free_childenv
 793                                  win32_get_childdir
 794                                  win32_get_childenv
 795                                  win32_spawnvp
 796                  ));
 797 }
 798
 799 if ($ARGS{PLATFORM} =~ /^win(?:32|ce)$/) {
 800     try_symbols(qw(
 801                             Perl_init_os_extras
 802                             Perl_thread_create
 803                             Perl_win32_init
 804                             Perl_win32_term
 805                             RunPerl
 806                             win32_async_check
 807                             win32_errno
 808                             win32_environ
 809                             win32_abort
 810                             win32_fstat
 811                             win32_stat
 812                             win32_pipe
 813                             win32_popen
 814                             win32_pclose
 815                             win32_rename
 816                             win32_setmode
 817                             win32_chsize
 818                             win32_lseek
 819                             win32_tell
 820                             win32_dup
 821                             win32_dup2
 822                             win32_open
 823                             win32_close
 824                             win32_eof
 825                             win32_isatty
 826                             win32_read
 827                             win32_write
 828                             win32_mkdir
 829                             win32_rmdir
 830                             win32_chdir
 831                             win32_flock
 832                             win32_execv
 833                             win32_execvp
 834                             win32_htons
 835                             win32_ntohs
 836                             win32_htonl
 837                             win32_ntohl
 838                             win32_inet_addr
 839                             win32_inet_ntoa
 840                             win32_socket
 841                             win32_bind
 842                             win32_listen
 843                             win32_accept
 844                             win32_connect
 845                             win32_send
 846                             win32_sendto
 847                             win32_recv
 848                             win32_recvfrom
 849                             win32_shutdown
 850                             win32_closesocket
 851                             win32_ioctlsocket
 852                             win32_setsockopt
 853                             win32_getsockopt
 854                             win32_getpeername
 855                             win32_getsockname
 856                             win32_gethostname
 857                             win32_gethostbyname
 858                             win32_gethostbyaddr
 859                             win32_getprotobyname
 860                             win32_getprotobynumber
 861                             win32_getservbyname
 862                             win32_getservbyport
 863                             win32_select
 864                             win32_endhostent
 865                             win32_endnetent
 866                             win32_endprotoent
 867                             win32_endservent
 868                             win32_getnetent
 869                             win32_getnetbyname
 870                             win32_getnetbyaddr
 871                             win32_getprotoent
 872                             win32_getservent
 873                             win32_sethostent
 874                             win32_setnetent
 875                             win32_setprotoent
 876                             win32_setservent
 877                             win32_getenv
 878                             win32_putenv
 879                             win32_perror
 880                             win32_malloc
 881                             win32_calloc
 882                             win32_realloc
 883                             win32_free
 884                             win32_sleep
 885                             win32_times
 886                             win32_access
 887                             win32_alarm
 888                             win32_chmod
 889                             win32_open_osfhandle
 890                             win32_get_osfhandle
 891                             win32_ioctl
 892                             win32_link
 893                             win32_unlink
 894                             win32_utime
 895                             win32_gettimeofday
 896                             win32_uname
 897                             win32_wait
 898                             win32_waitpid
 899                             win32_kill
 900                             win32_str_os_error
 901                             win32_opendir
 902                             win32_readdir
 903                             win32_telldir
 904                             win32_seekdir
 905                             win32_rewinddir
 906                             win32_closedir
 907                             win32_longpath
 908                             win32_ansipath
 909                             win32_os_id
 910                             win32_getpid
 911                             win32_crypt
 912                             win32_dynaload
 913                             win32_clearenv
 914                             win32_stdin
 915                             win32_stdout
 916                             win32_stderr
 917                             win32_ferror
 918                             win32_feof
 919                             win32_strerror
 920                             win32_fprintf
 921                             win32_printf
 922                             win32_vfprintf
 923                             win32_vprintf
 924                             win32_fread
 925                             win32_fwrite
 926                             win32_fopen
 927                             win32_fdopen
 928                             win32_freopen
 929                             win32_fclose
 930                             win32_fputs
 931                             win32_fputc
 932                             win32_ungetc
 933                             win32_getc
 934                             win32_fileno
 935                             win32_clearerr
 936                             win32_fflush
 937                             win32_ftell
 938                             win32_fseek
 939                             win32_fgetpos
 940                             win32_fsetpos
 941                             win32_rewind
 942                             win32_tmpfile
 943                             win32_setbuf
 944                             win32_setvbuf
 945                             win32_flushall
 946                             win32_fcloseall
 947                             win32_fgets
 948                             win32_gets
 949                             win32_fgetc
 950                             win32_putc
 951                             win32_puts
 952                             win32_getchar
 953                             win32_putchar
 954                  ));
 955 }
 956 elsif ($ARGS{PLATFORM} eq 'vms') {
 957     try_symbols(qw(
 958                       Perl_cando
 959                       Perl_cando_by_name
 960                       Perl_closedir
 961                       Perl_csighandler_init
 962                       Perl_do_rmdir
 963                       Perl_fileify_dirspec
 964                       Perl_fileify_dirspec_ts
 965                       Perl_fileify_dirspec_utf8
 966                       Perl_fileify_dirspec_utf8_ts
 967                       Perl_flex_fstat
 968                       Perl_flex_lstat
 969                       Perl_flex_stat
 970                       Perl_kill_file
 971                       Perl_my_chdir
 972                       Perl_my_chmod
 973                       Perl_my_crypt
 974                       Perl_my_endpwent
 975                       Perl_my_fclose
 976                       Perl_my_fdopen
 977                       Perl_my_fgetname
 978                       Perl_my_flush
 979                       Perl_my_fwrite
 980                       Perl_my_gconvert
 981                       Perl_my_getenv
 982                       Perl_my_getenv_len
 983                       Perl_my_getlogin
 984                       Perl_my_getpwnam
 985                       Perl_my_getpwuid
 986                       Perl_my_gmtime
 987                       Perl_my_kill
 988                       Perl_my_localtime
 989                       Perl_my_mkdir
 990                       Perl_my_sigaction
 991                       Perl_my_symlink
 992                       Perl_my_time
 993                       Perl_my_tmpfile
 994                       Perl_my_trnlnm
 995                       Perl_my_utime
 996                       Perl_my_waitpid
 997                       Perl_opendir
 998                       Perl_pathify_dirspec
 999                       Perl_pathify_dirspec_ts
1000                       Perl_pathify_dirspec_utf8
1001                       Perl_pathify_dirspec_utf8_ts
1002                       Perl_readdir
1003                       Perl_readdir_r
1004                       Perl_rename
1005                       Perl_rmscopy
1006                       Perl_rmsexpand
1007                       Perl_rmsexpand_ts
1008                       Perl_rmsexpand_utf8
1009                       Perl_rmsexpand_utf8_ts
1010                       Perl_seekdir
1011                       Perl_sig_to_vmscondition
1012                       Perl_telldir
1013                       Perl_tounixpath
1014                       Perl_tounixpath_ts
1015                       Perl_tounixpath_utf8
1016                       Perl_tounixpath_utf8_ts
1017                       Perl_tounixspec
1018                       Perl_tounixspec_ts
1019                       Perl_tounixspec_utf8
1020                       Perl_tounixspec_utf8_ts
1021                       Perl_tovmspath
1022                       Perl_tovmspath_ts
1023                       Perl_tovmspath_utf8
1024                       Perl_tovmspath_utf8_ts
1025                       Perl_tovmsspec
1026                       Perl_tovmsspec_ts
1027                       Perl_tovmsspec_utf8
1028                       Perl_tovmsspec_utf8_ts
1029                       Perl_trim_unixpath
1030                       Perl_vms_case_tolerant
1031                       Perl_vms_do_aexec
1032                       Perl_vms_do_exec
1033                       Perl_vms_image_init
1034                       Perl_vms_realpath
1035                       Perl_vmssetenv
1036                       Perl_vmssetuserlnm
1037                       Perl_vmstrnenv
1038                       PerlIO_openn
1039                  ));
1040 }
1041 elsif ($ARGS{PLATFORM} eq 'os2') {
1042     try_symbols(qw(
1043                       ctermid
1044                       get_sysinfo
1045                       Perl_OS2_init
1046                       Perl_OS2_init3
1047                       Perl_OS2_term
1048                       OS2_Perl_data
1049                       dlopen
1050                       dlsym
1051                       dlerror
1052                       dlclose
1053                       dup2
1054                       dup
1055                       my_tmpfile
1056                       my_tmpnam
1057                       my_flock
1058                       my_rmdir
1059                       my_mkdir
1060                       my_getpwuid
1061                       my_getpwnam
1062                       my_getpwent
1063                       my_setpwent
1064                       my_endpwent
1065                       fork_with_resources
1066                       croak_with_os2error
1067                       setgrent
1068                       endgrent
1069                       getgrent
1070                       malloc_mutex
1071                       threads_mutex
1072                       nthreads
1073                       nthreads_cond
1074                       os2_cond_wait
1075                       os2_stat
1076                       os2_execname
1077                       async_mssleep
1078                       msCounter
1079                       InfoTable
1080                       pthread_join
1081                       pthread_create
1082                       pthread_detach
1083                       XS_Cwd_change_drive
1084                       XS_Cwd_current_drive
1085                       XS_Cwd_extLibpath
1086                       XS_Cwd_extLibpath_set
1087                       XS_Cwd_sys_abspath
1088                       XS_Cwd_sys_chdir
1089                       XS_Cwd_sys_cwd
1090                       XS_Cwd_sys_is_absolute
1091                       XS_Cwd_sys_is_relative
1092                       XS_Cwd_sys_is_rooted
1093                       XS_DynaLoader_mod2fname
1094                       XS_File__Copy_syscopy
1095                       Perl_Register_MQ
1096                       Perl_Deregister_MQ
1097                       Perl_Serve_Messages
1098                       Perl_Process_Messages
1099                       init_PMWIN_entries
1100                       PMWIN_entries
1101                       Perl_hab_GET
1102                       loadByOrdinal
1103                       pExtFCN
1104                       os2error
1105                       ResetWinError
1106                       CroakWinError
1107                       PL_do_undump
1108                  ));
1109 }
1110 elsif ($ARGS{PLATFORM} eq 'netware') {
1111     try_symbols(qw(
1112                         Perl_init_os_extras
1113                         Perl_thread_create
1114                         Perl_nw5_init
1115                         RunPerl
1116                         AllocStdPerl
1117                         FreeStdPerl
1118                         do_spawn2
1119                         do_aspawn
1120                         nw_uname
1121                         nw_stdin
1122                         nw_stdout
1123                         nw_stderr
1124                         nw_feof
1125                         nw_ferror
1126                         nw_fopen
1127                         nw_fclose
1128                         nw_clearerr
1129                         nw_getc
1130                         nw_fgets
1131                         nw_fputc
1132                         nw_fputs
1133                         nw_fflush
1134                         nw_ungetc
1135                         nw_fileno
1136                         nw_fdopen
1137                         nw_freopen
1138                         nw_fread
1139                         nw_fwrite
1140                         nw_setbuf
1141                         nw_setvbuf
1142                         nw_vfprintf
1143                         nw_ftell
1144                         nw_fseek
1145                         nw_rewind
1146                         nw_tmpfile
1147                         nw_fgetpos
1148                         nw_fsetpos
1149                         nw_dup
1150                         nw_access
1151                         nw_chmod
1152                         nw_chsize
1153                         nw_close
1154                         nw_dup2
1155                         nw_flock
1156                         nw_isatty
1157                         nw_link
1158                         nw_lseek
1159                         nw_stat
1160                         nw_mktemp
1161                         nw_open
1162                         nw_read
1163                         nw_rename
1164                         nw_setmode
1165                         nw_unlink
1166                         nw_utime
1167                         nw_write
1168                         nw_chdir
1169                         nw_rmdir
1170                         nw_closedir
1171                         nw_opendir
1172                         nw_readdir
1173                         nw_rewinddir
1174                         nw_seekdir
1175                         nw_telldir
1176                         nw_htonl
1177                         nw_htons
1178                         nw_ntohl
1179                         nw_ntohs
1180                         nw_accept
1181                         nw_bind
1182                         nw_connect
1183                         nw_endhostent
1184                         nw_endnetent
1185                         nw_endprotoent
1186                         nw_endservent
1187                         nw_gethostbyaddr
1188                         nw_gethostbyname
1189                         nw_gethostent
1190                         nw_gethostname
1191                         nw_getnetbyaddr
1192                         nw_getnetbyname
1193                         nw_getnetent
1194                         nw_getpeername
1195                         nw_getprotobyname
1196                         nw_getprotobynumber
1197                         nw_getprotoent
1198                         nw_getservbyname
1199                         nw_getservbyport
1200                         nw_getservent
1201                         nw_getsockname
1202                         nw_getsockopt
1203                         nw_inet_addr
1204                         nw_listen
1205                         nw_socket
1206                         nw_recv
1207                         nw_recvfrom
1208                         nw_select
1209                         nw_send
1210                         nw_sendto
1211                         nw_sethostent
1212                         nw_setnetent
1213                         nw_setprotoent
1214                         nw_setservent
1215                         nw_setsockopt
1216                         nw_inet_ntoa
1217                         nw_shutdown
1218                         nw_crypt
1219                         nw_execvp
1220                         nw_kill
1221                         nw_Popen
1222                         nw_Pclose
1223                         nw_Pipe
1224                         nw_times
1225                         nw_waitpid
1226                         nw_getpid
1227                         nw_spawnvp
1228                         nw_os_id
1229                         nw_open_osfhandle
1230                         nw_get_osfhandle
1231                         nw_abort
1232                         nw_sleep
1233                         nw_wait
1234                         nw_dynaload
1235                         nw_strerror
1236                         fnFpSetMode
1237                         fnInsertHashListAddrs
1238                         fnGetHashListAddrs
1239                         Perl_deb
1240                         Perl_sv_setsv
1241                         Perl_sv_catsv
1242                         Perl_sv_catpvn
1243                         Perl_sv_2pv
1244                         nw_freeenviron
1245                         Remove_Thread_Ctx
1246                  ));
1247 }
1248
1249 # When added this code was only run for Win32 and WinCE
1250 # Currently only Win32 links static extensions into the shared library.
1251 # The WinCE makefile doesn't appear to support static extensions, so this code
1252 # can't have any effect there.
1253 # The NetWare Makefile doesn't support static extensions (and hardcodes the
1254 # list of dynamic extensions, and the rules to build them)
1255 # For *nix (and presumably OS/2) with a shared libperl, Makefile.SH compiles
1256 # static extensions with -fPIC, but links them to perl, not libperl.so
1257 # The VMS build scripts don't yet implement static extensions at all.
1258
1259 if ($ARGS{PLATFORM} =~ /^win(?:32|ce)$/) {
1260     # records of type boot_module for statically linked modules (except Dynaloader)
1261     my $static_ext = $Config{static_ext} // "";
1262     $static_ext =~ s/\//__/g;
1263     $static_ext =~ s/\bDynaLoader\b//;
1264     try_symbols(map {"boot_$_"} grep {/\S/} split /\s+/, $static_ext);
1265     try_symbols("init_Win32CORE") if $static_ext =~ /\bWin32CORE\b/;
1266 }
1267
1268 if ($ARGS{PLATFORM} eq 'os2') {
1269     my (%mapped, @missing);
1270     open MAP, 'miniperl.map' or die 'Cannot read miniperl.map';
1271     /^\s*[\da-f:]+\s+(\w+)/i and $mapped{$1}++ foreach <MAP>;
1272     close MAP or die 'Cannot close miniperl.map';
1273
1274     @missing = grep { !exists $mapped{$_} }
1275                     keys %export;
1276     @missing = grep { !exists $exportperlmalloc{$_} } @missing;
1277     delete $export{$_} foreach @missing;
1278 }
1279
1280 ###############################################################################
1281
1282 # Now all symbols should be defined because next we are going to output them.
1283
1284 # Start with platform specific headers:
1285
1286 if ($ARGS{PLATFORM} =~ /^win(?:32|ce)$/) {
1287     my $dll = $define{PERL_DLL} ? $define{PERL_DLL} =~ s/\.dll$//ir
1288         : "perl$Config{api_revision}$Config{api_version}";
1289     print "LIBRARY $dll\n";
1290     # The DESCRIPTION module definition file statement is not supported
1291     # by VC7 onwards.
1292     if ($ARGS{CCTYPE} =~ /^(?:MSVC60|GCC)$/) {
1293         print "DESCRIPTION 'Perl interpreter'\n";
1294     }
1295     print "EXPORTS\n";
1296 }
1297 elsif ($ARGS{PLATFORM} eq 'os2') {
1298     (my $v = $]) =~ s/(\d\.\d\d\d)(\d\d)$/$1_$2/;
1299     $v .= '-thread' if $Config{archname} =~ /-thread/;
1300     (my $dll = $define{PERL_DLL}) =~ s/\.dll$//i;
1301     $v .= "\@$Config{perl_patchlevel}" if $Config{perl_patchlevel};
1302     my $d = "DESCRIPTION '\@#perl5-porters\@perl.org:$v#\@ Perl interpreter, configured as $Config{config_args}'";
1303     $d = substr($d, 0, 249) . "...'" if length $d > 253;
1304     print <<"---EOP---";
1305 LIBRARY '$dll' INITINSTANCE TERMINSTANCE
1306 $d
1307 STACKSIZE 32768
1308 CODE LOADONCALL
1309 DATA LOADONCALL NONSHARED MULTIPLE
1310 EXPORTS
1311 ---EOP---
1312 }
1313 elsif ($ARGS{PLATFORM} eq 'aix') {
1314     my $OSVER = `uname -v`;
1315     chop $OSVER;
1316     my $OSREL = `uname -r`;
1317     chop $OSREL;
1318     if ($OSVER > 4 || ($OSVER == 4 && $OSREL >= 3)) {
1319         print "#! ..\n";
1320     } else {
1321         print "#!\n";
1322     }
1323 }
1324 elsif ($ARGS{PLATFORM} eq 'netware') {
1325         if ($ARGS{FILETYPE} eq 'def') {
1326         print "LIBRARY perl$Config{api_revision}$Config{api_version}\n";
1327         print "DESCRIPTION 'Perl interpreter for NetWare'\n";
1328         print "EXPORTS\n";
1329         }
1330 }
1331
1332 # Then the symbols
1333
1334 my @symbols = $fold ? sort {lc $a cmp lc $b} keys %export : sort keys %export;
1335 foreach my $symbol (@symbols) {
1336     if ($ARGS{PLATFORM} =~ /^win(?:32|ce)$/) {
1337         print "\t$symbol\n";
1338     }
1339     elsif ($ARGS{PLATFORM} eq 'os2') {
1340         printf qq(    %-31s \@%s\n),
1341           qq("$symbol"), $ordinal{$symbol} || ++$sym_ord;
1342         printf qq(    %-31s \@%s\n),
1343           qq("$exportperlmalloc{$symbol}" = "$symbol"),
1344           $ordinal{$exportperlmalloc{$symbol}} || ++$sym_ord
1345           if $exportperlmalloc and exists $exportperlmalloc{$symbol};
1346     }
1347     elsif ($ARGS{PLATFORM} eq 'netware') {
1348         print "\t$symbol,\n";
1349     } else {
1350         print "$symbol\n";
1351     }
1352 }
1353
1354 # Then platform specific footers.
1355
1356 if ($ARGS{PLATFORM} eq 'os2') {
1357     print <<EOP;
1358     dll_perlmain=main
1359     fill_extLibpath
1360     dir_subst
1361     Perl_OS2_handler_install
1362
1363 ; LAST_ORDINAL=$sym_ord
1364 EOP
1365 }
1366
1367 1;