This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Promote v5.36 usage and feature bundles doc
[perl5.git] / 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 #    makedef.lis VMS
33
34 use strict;
35 use Config;
36
37 my $fold;
38 my %ARGS;
39 my %define;
40
41 BEGIN {
42     %ARGS = (CCTYPE => 'MSVC', TARG_DIR => '');
43
44     sub process_cc_flags {
45         foreach (map {split /\s+/, $_} @_) {
46             $define{$1} = $2 // 1 if /^-D(\w+)(?:=(.+))?/;
47         }
48     }
49
50     while (@ARGV) {
51         my $flag = shift;
52         if ($flag =~ /^(?:CC_FLAGS=)?(-D\w.*)/) {
53             process_cc_flags($1);
54         } elsif ($flag =~ /^(CCTYPE|FILETYPE|PLATFORM|TARG_DIR)=(.+)$/) {
55             $ARGS{$1} = $2;
56         } elsif ($flag eq '--sort-fold') {
57             ++$fold;
58         }
59     }
60     my @PLATFORM = qw(aix win32 os2 vms test);
61     my %PLATFORM;
62     @PLATFORM{@PLATFORM} = ();
63
64     die "PLATFORM undefined, must be one of: @PLATFORM\n"
65         unless defined $ARGS{PLATFORM};
66     die "PLATFORM must be one of: @PLATFORM\n"
67         unless exists $PLATFORM{$ARGS{PLATFORM}};
68 }
69 use constant PLATFORM => $ARGS{PLATFORM};
70
71 require "./$ARGS{TARG_DIR}regen/embed_lib.pl";
72
73 # Is the following guard strictly necessary? Added during refactoring
74 # to keep the same behaviour when merging other code into here.
75 process_cc_flags(@Config{qw(ccflags optimize)})
76     if $ARGS{PLATFORM} ne 'win32';
77
78 # Add the compile-time options that miniperl was built with to %define.
79 # On Win32 these are not the same options as perl itself will be built
80 # with since miniperl is built with a canned config (one of the win32/
81 # config_H.*) and none of the BUILDOPT's that are set in the makefiles,
82 # but they do include some #define's that are hard-coded in various
83 # source files and header files and don't include any BUILDOPT's that
84 # the user might have chosen to disable because the canned configs are
85 # minimal configs that don't include any of those options.
86
87 my @options = sort(Config::bincompat_options(), Config::non_bincompat_options());
88 print STDERR "Options: (@options)\n" unless $ARGS{PLATFORM} eq 'test';
89 $define{$_} = 1 foreach @options;
90
91 my %exportperlmalloc =
92     (
93        Perl_malloc              =>      "malloc",
94        Perl_mfree               =>      "free",
95        Perl_realloc             =>      "realloc",
96        Perl_calloc              =>      "calloc",
97     );
98
99 my $exportperlmalloc = $ARGS{PLATFORM} eq 'os2';
100
101 my $config_h = 'config.h';
102 open(CFG, '<', $config_h) || die "Cannot open $config_h: $!\n";
103 while (<CFG>) {
104     $define{$1} = 1 if /^\s*\#\s*define\s+(MYMALLOC|MULTIPLICITY
105                                            |KILL_BY_SIGPRC
106                                            |(?:PERL|USE|HAS)_\w+)\b/x;
107 }
108 close(CFG);
109
110 # perl.h logic duplication begins
111
112 if ($define{USE_ITHREADS}) {
113     if (!$define{MULTIPLICITY}) {
114         $define{MULTIPLICITY} = 1;
115     }
116 }
117
118 $define{MULTIPLICITY} ||=
119     $define{USE_ITHREADS} ||
120     $define{PERL_IMPLICIT_CONTEXT} ;
121
122 if ($define{USE_ITHREADS} && $ARGS{PLATFORM} ne 'win32') {
123     $define{USE_REENTRANT_API} = 1;
124 }
125
126 if (! $define{NO_LOCALE}) {
127     if ( ! $define{NO_POSIX_2008_LOCALE}
128         && $define{HAS_NEWLOCALE}
129         && $define{HAS_USELOCALE}
130         && $define{HAS_DUPLOCALE}
131         && $define{HAS_FREELOCALE})
132     {
133         $define{HAS_POSIX_2008_LOCALE} = 1;
134         $define{USE_LOCALE} = 1;
135     }
136     elsif ($define{HAS_SETLOCALE}) {
137         $define{USE_LOCALE} = 1;
138     }
139 }
140
141 # https://en.wikipedia.org/wiki/Microsoft_Visual_C%2B%2B#Internal_version_numbering
142 my $cctype = $ARGS{CCTYPE} =~ s/MSVC//r;
143 if ($define{USE_ITHREADS} && ! $define{NO_LOCALE_THREADS}) {
144     $define{USE_LOCALE_THREADS} = 1;
145 }
146 if (! $define{HAS_SETLOCALE} && $define{HAS_POSIX_2008_LOCALE}) {
147     $define{USE_POSIX_2008_LOCALE} = 1;
148     $define{USE_THREAD_SAFE_LOCALE} = 1;
149 }
150 elsif (   ($define{USE_LOCALE_THREADS} || $define{USE_THREAD_SAFE_LOCALE})
151        && (    $define{HAS_POSIX_2008_LOCALE}
152            || ($ARGS{PLATFORM} eq 'win32' && (   $cctype !~ /\D/
153                                               && $cctype >= 80)))
154        && ! $define{NO_THREAD_SAFE_LOCALE})
155 {
156     $define{USE_THREAD_SAFE_LOCALE} = 1 unless $define{USE_THREAD_SAFE_LOCALE};
157     $define{USE_POSIX_2008_LOCALE} = 1 if $define{HAS_POSIX_2008_LOCALE};
158 }
159
160 if (   $ARGS{PLATFORM} eq 'win32'
161     && $define{USE_THREAD_SAFE_LOCALE}
162     && $cctype < 140)
163 {
164     $define{TS_W32_BROKEN_LOCALECONV} = 1;
165 }
166
167 # perl.h logic duplication ends
168
169 print STDERR "Defines: (" . join(' ', sort keys %define) . ")\n"
170      unless $ARGS{PLATFORM} eq 'test';
171
172 my $sym_ord = 0;
173 my %ordinal;
174
175 if ($ARGS{PLATFORM} eq 'os2') {
176     if (open my $fh, '<', 'perl5.def') {
177       while (<$fh>) {
178         last if /^\s*EXPORTS\b/;
179       }
180       while (<$fh>) {
181         $ordinal{$1} = $2 if /^\s*"(\w+)"\s*(?:=\s*"\w+"\s*)?\@(\d+)\s*$/;
182         # This allows skipping ordinals which were used in older versions
183         $sym_ord = $1 if /^\s*;\s*LAST_ORDINAL\s*=\s*(\d+)\s*$/;
184       }
185       $sym_ord < $_ and $sym_ord = $_ for values %ordinal; # Take the max
186     }
187 }
188
189 my %skip;
190 # All platforms export boot_DynaLoader unconditionally.
191 my %export = ( boot_DynaLoader => 1 );
192
193 # d_thread_local not perl_thread_local - see hints/darwin.sh
194 ++$export{PL_current_context}
195     if defined $Config{d_thread_local} && $define{USE_ITHREADS};
196
197 sub try_symbols {
198     foreach my $symbol (@_) {
199         ++$export{$symbol} unless exists $skip{$symbol};
200     }
201 }
202
203 sub readvar {
204     # $hash is the hash that we're adding to. For one of our callers, it will
205     # actually be the skip hash but that doesn't affect the intent of what
206     # we're doing, as in that case we skip adding something to the skip hash
207     # for the second time.
208
209     my $file = $ARGS{TARG_DIR} . shift;
210     my $hash = shift;
211     my $proc = shift;
212     open my $vars, '<', $file or die "Cannot open $file: $!\n";
213
214     while (<$vars>) {
215         # All symbols have a Perl_ prefix because that's what embed.h sticks
216         # in front of them.  The A?I?S?C? is strictly speaking wrong.
217         next unless /\bPERLVAR(A?I?S?C?)\(([IGT]),\s*(\w+)/;
218
219         my $var = "PL_$3";
220         my $symbol = $proc ? &$proc($1,$2,$3) : $var;
221         ++$hash->{$symbol} unless exists $skip{$var};
222     }
223 }
224
225 if ($ARGS{PLATFORM} ne 'os2') {
226     ++$skip{$_} foreach qw(
227                      PL_opsave
228                      Perl_dump_fds
229                      Perl_my_bcopy
230                      Perl_my_bzero
231                      Perl_my_chsize
232                      Perl_my_htonl
233                      Perl_my_memcmp
234                      Perl_my_memset
235                      Perl_my_ntohl
236                      Perl_my_swap
237                          );
238     if ($ARGS{PLATFORM} eq 'vms') {
239         ++$skip{PL_statusvalue_posix};
240         # This is a wrapper if we have symlink, not a replacement
241         # if we don't.
242         ++$skip{Perl_my_symlink} unless $Config{d_symlink};
243     } else {
244         ++$skip{PL_statusvalue_vms};
245         ++$skip{PL_perllib_sep};
246         if ($ARGS{PLATFORM} ne 'aix') {
247             ++$skip{$_} foreach qw(
248                                 PL_DBcv
249                                 PL_generation
250                                 PL_lastgotoprobe
251                                 PL_modcount
252                                 main
253                                  );
254         }
255     }
256 }
257
258 if ($ARGS{PLATFORM} ne 'vms') {
259     # VMS does its own thing for these symbols.
260     ++$skip{$_} foreach qw(
261                         PL_sig_handlers_initted
262                         PL_sig_ignoring
263                         PL_sig_defaulting
264                          );
265     if ($ARGS{PLATFORM} ne 'win32') {
266         ++$skip{$_} foreach qw(
267                             Perl_do_spawn
268                             Perl_do_spawn_nowait
269                             Perl_do_aspawn
270                              );
271     }
272 }
273
274 if ($ARGS{PLATFORM} ne 'win32') {
275     ++$skip{$_} foreach qw(
276                     Perl_my_setlocale
277                          );
278 }
279
280 unless ($define{UNLINK_ALL_VERSIONS}) {
281     ++$skip{Perl_unlnk};
282 }
283
284 unless ($define{'DEBUGGING'}) {
285     ++$skip{$_} foreach qw(
286                     Perl_debop
287                     Perl_debprofdump
288                     Perl_debstack
289                     Perl_debstackptrs
290                     Perl_pad_sv
291                     Perl_pad_setsv
292                     Perl__setlocale_debug_string
293                     Perl_set_padlist
294                     Perl_hv_assert
295                     PL_watchaddr
296                     PL_watchok
297                          );
298 }
299
300 if ($define{'PERL_IMPLICIT_SYS'}) {
301     ++$skip{$_} foreach qw(
302                     Perl_my_popen
303                     Perl_my_pclose
304                          );
305     ++$export{$_} foreach qw(perl_get_host_info perl_alloc_override);
306     ++$export{perl_clone_host} if $define{USE_ITHREADS};
307 }
308 else {
309     ++$skip{$_} foreach qw(
310                     PL_Mem
311                     PL_MemShared
312                     PL_MemParse
313                     PL_Env
314                     PL_StdIO
315                     PL_LIO
316                     PL_Dir
317                     PL_Sock
318                     PL_Proc
319                     perl_alloc_using
320                     perl_clone_using
321                          );
322 }
323
324 if (!$define{'PERL_COPY_ON_WRITE'} || $define{'PERL_NO_COW'}) {
325     ++$skip{Perl_sv_setsv_cow};
326 }
327
328 unless ($define{PERL_SAWAMPERSAND}) {
329     ++$skip{PL_sawampersand};
330 }
331
332 unless ($define{'USE_REENTRANT_API'}) {
333     ++$skip{PL_reentrant_buffer};
334 }
335
336 if ($define{'MYMALLOC'}) {
337     try_symbols(qw(
338                     Perl_dump_mstats
339                     Perl_get_mstats
340                     Perl_strdup
341                     Perl_putenv
342                     MallocCfg_ptr
343                     MallocCfgP_ptr
344                     ));
345     unless ($define{USE_ITHREADS}) {
346         ++$skip{PL_malloc_mutex}
347     }
348 }
349 else {
350     ++$skip{$_} foreach qw(
351                     PL_malloc_mutex
352                     Perl_dump_mstats
353                     Perl_get_mstats
354                     MallocCfg_ptr
355                     MallocCfgP_ptr
356                          );
357 }
358
359 unless ($define{'USE_ITHREADS'}) {
360     ++$skip{PL_thr_key};
361     ++$skip{PL_user_prop_mutex};
362     ++$skip{PL_user_def_props_aTHX};
363 }
364
365 unless ($define{'USE_ITHREADS'}) {
366     ++$skip{$_} foreach qw(
367                     PL_keyword_plugin_mutex
368                     PL_check_mutex
369                     PL_op_mutex
370                     PL_regex_pad
371                     PL_regex_padav
372                     PL_dollarzero_mutex
373                     PL_env_mutex
374                     PL_hints_mutex
375                     PL_locale_mutex
376                     PL_lc_numeric_mutex
377                     PL_lc_numeric_mutex_depth
378                     PL_my_ctx_mutex
379                     PL_perlio_mutex
380                     PL_stashpad
381                     PL_stashpadix
382                     PL_stashpadmax
383                     Perl_alloccopstash
384                     Perl_allocfilegv
385                     Perl_clone_params_del
386                     Perl_clone_params_new
387                     Perl_parser_dup
388                     Perl_dirp_dup
389                     Perl_cx_dup
390                     Perl_si_dup
391                     Perl_any_dup
392                     Perl_ss_dup
393                     Perl_fp_dup
394                     Perl_gp_dup
395                     Perl_he_dup
396                     Perl_mg_dup
397                     Perl_re_dup_guts
398                     Perl_sv_dup
399                     Perl_sv_dup_inc
400                     Perl_rvpv_dup
401                     Perl_hek_dup
402                     Perl_sys_intern_dup
403                     perl_clone
404                     perl_clone_using
405                     Perl_stashpv_hvname_match
406                     Perl_regdupe_internal
407                     Perl_newPADOP
408                          );
409 }
410
411 unless ($define{USE_POSIX_2008_LOCALE})
412 {
413     ++$skip{$_} foreach qw(
414         PL_C_locale_obj
415         PL_scratch_locale_obj
416         PL_underlying_numeric_obj
417     );
418 }
419 unless ($define{USE_POSIX_2008_LOCALE} && ! $define{HAS_QUERY_LOCALE})
420 {
421     ++$skip{$_} foreach qw(
422         PL_curlocales
423     );
424 }
425
426 unless ($define{'MULTIPLICITY'}) {
427     ++$skip{$_} foreach qw(
428                     PL_my_cxt_index
429                     PL_my_cxt_list
430                     PL_my_cxt_size
431                     PL_my_cxt_keys
432                     PL_my_cxt_keys_size
433                     Perl_croak_nocontext
434                     Perl_die_nocontext
435                     Perl_deb_nocontext
436                     Perl_form_nocontext
437                     Perl_load_module_nocontext
438                     Perl_mess_nocontext
439                     Perl_warn_nocontext
440                     Perl_warner_nocontext
441                     Perl_newSVpvf_nocontext
442                     Perl_sv_catpvf_nocontext
443                     Perl_sv_setpvf_nocontext
444                     Perl_sv_catpvf_mg_nocontext
445                     Perl_sv_setpvf_mg_nocontext
446                     Perl_my_cxt_init
447                     Perl_my_cxt_index
448                          );
449 }
450
451 if ($define{USE_THREAD_SAFE_LOCALE}) {
452     ++$skip{PL_lc_numeric_mutex};
453     ++$skip{PL_lc_numeric_mutex_depth};
454 }
455
456 unless ($define{'USE_DTRACE'}) {
457     ++$skip{$_} foreach qw(
458                     Perl_dtrace_probe_call
459                     Perl_dtrace_probe_load
460                     Perl_dtrace_probe_op
461                     Perl_dtrace_probe_phase
462                 );
463 }
464
465 unless ($define{'DEBUG_LEAKING_SCALARS'}) {
466     ++$skip{PL_sv_serial};
467 }
468
469 unless ($define{'DEBUG_LEAKING_SCALARS_FORK_DUMP'}) {
470     ++$skip{PL_dumper_fd};
471 }
472
473 unless ($define{'PERL_DONT_CREATE_GVSV'}) {
474     ++$skip{Perl_gv_SVadd};
475 }
476
477 unless ($define{'PERL_USES_PL_PIDSTATUS'}) {
478     ++$skip{PL_pidstatus};
479 }
480
481 unless ($define{'PERL_TRACK_MEMPOOL'}) {
482     ++$skip{PL_memory_debug_header};
483 }
484
485 unless ($define{'PERL_MEM_LOG'}) {
486     ++$skip{$_} foreach qw(
487                     PL_mem_log
488                     Perl_mem_log_alloc
489                     Perl_mem_log_realloc
490                     Perl_mem_log_free
491                     Perl_mem_log_new_sv
492                     Perl_mem_log_del_sv
493                 );
494 }
495
496 unless ($define{'MULTIPLICITY'}) {
497     ++$skip{$_} foreach qw(
498                     PL_interp_size
499                     PL_interp_size_5_18_0
500                     PL_sv_yes
501                     PL_sv_undef
502                     PL_sv_no
503                     PL_sv_zero
504                          );
505 }
506
507 unless ($define{HAS_MMAP}) {
508     ++$skip{PL_mmap_page_size};
509 }
510
511 if ($define{HAS_SIGACTION}) {
512     ++$skip{PL_sig_trapped};
513
514     if ($ARGS{PLATFORM} eq 'vms') {
515         # FAKE_PERSISTENT_SIGNAL_HANDLERS defined as !defined(HAS_SIGACTION)
516         ++$skip{PL_sig_ignoring};
517         ++$skip{PL_sig_handlers_initted} unless $define{KILL_BY_SIGPRC};
518     }
519 }
520
521 if ($ARGS{PLATFORM} eq 'vms' && !$define{KILL_BY_SIGPRC}) {
522     # FAKE_DEFAULT_SIGNAL_HANDLERS defined as KILL_BY_SIGPRC
523     ++$skip{Perl_csighandler_init};
524     ++$skip{Perl_my_kill};
525     ++$skip{Perl_sig_to_vmscondition};
526     ++$skip{PL_sig_defaulting};
527     ++$skip{PL_sig_handlers_initted} unless !$define{HAS_SIGACTION};
528 }
529
530 if ($define{'HAS_STRNLEN'})
531 {
532     ++$skip{Perl_my_strnlen};
533 }
534
535 unless ($define{USE_LOCALE_COLLATE}) {
536     ++$skip{$_} foreach qw(
537                     PL_collation_ix
538                     PL_collation_name
539                     PL_collation_standard
540                     PL_collxfrm_base
541                     PL_collxfrm_mult
542                     Perl_sv_collxfrm
543                     Perl_sv_collxfrm_flags
544                     PL_strxfrm_NUL_replacement
545                     PL_strxfrm_is_behaved
546                     PL_strxfrm_max_cp
547                          );
548 }
549
550 unless ($define{USE_LOCALE_NUMERIC}) {
551     ++$skip{$_} foreach qw(
552                     PL_underlying_numeric_obj
553                          );
554 }
555
556 unless ($define{'USE_C_BACKTRACE'}) {
557     ++$skip{Perl_get_c_backtrace_dump};
558     ++$skip{Perl_dump_c_backtrace};
559 }
560
561 unless ($define{HAVE_INTERP_INTERN}) {
562     ++$skip{$_} foreach qw(
563                     Perl_sys_intern_clear
564                     Perl_sys_intern_dup
565                     Perl_sys_intern_init
566                     PL_sys_intern
567                          );
568 }
569
570 if ($define{HAS_SIGNBIT}) {
571     ++$skip{Perl_signbit};
572 }
573
574 ++$skip{PL_op_exec_cnt}
575     unless $define{PERL_TRACE_OPS};
576
577 ++$skip{PL_hash_chars}
578     unless $define{PERL_USE_SINGLE_CHAR_HASH_CACHE};
579
580 # functions from *.sym files
581
582 my @syms = qw(globvar.sym);
583
584 # Symbols that are the public face of the PerlIO layers implementation
585 # These are in _addition to_ the public face of the abstraction
586 # and need to be exported to allow XS modules to implement layers
587 my @layer_syms = qw(
588                     PerlIOBase_binmode
589                     PerlIOBase_clearerr
590                     PerlIOBase_close
591                     PerlIOBase_dup
592                     PerlIOBase_eof
593                     PerlIOBase_error
594                     PerlIOBase_fileno
595                     PerlIOBase_open
596                     PerlIOBase_noop_fail
597                     PerlIOBase_noop_ok
598                     PerlIOBase_popped
599                     PerlIOBase_pushed
600                     PerlIOBase_read
601                     PerlIOBase_setlinebuf
602                     PerlIOBase_unread
603                     PerlIOBuf_bufsiz
604                     PerlIOBuf_close
605                     PerlIOBuf_dup
606                     PerlIOBuf_fill
607                     PerlIOBuf_flush
608                     PerlIOBuf_get_base
609                     PerlIOBuf_get_cnt
610                     PerlIOBuf_get_ptr
611                     PerlIOBuf_open
612                     PerlIOBuf_popped
613                     PerlIOBuf_pushed
614                     PerlIOBuf_read
615                     PerlIOBuf_seek
616                     PerlIOBuf_set_ptrcnt
617                     PerlIOBuf_tell
618                     PerlIOBuf_unread
619                     PerlIOBuf_write
620                     PerlIO_allocate
621                     PerlIO_apply_layera
622                     PerlIO_apply_layers
623                     PerlIO_arg_fetch
624                     PerlIO_debug
625                     PerlIO_define_layer
626                     PerlIO_find_layer
627                     PerlIO_isutf8
628                     PerlIO_layer_fetch
629                     PerlIO_list_alloc
630                     PerlIO_list_free
631                     PerlIO_modestr
632                     PerlIO_parse_layers
633                     PerlIO_pending
634                     PerlIO_perlio
635                     PerlIO_pop
636                     PerlIO_push
637                     PerlIO_sv_dup
638                     Perl_PerlIO_clearerr
639                     Perl_PerlIO_close
640                     Perl_PerlIO_context_layers
641                     Perl_PerlIO_eof
642                     Perl_PerlIO_error
643                     Perl_PerlIO_fileno
644                     Perl_PerlIO_fill
645                     Perl_PerlIO_flush
646                     Perl_PerlIO_get_base
647                     Perl_PerlIO_get_bufsiz
648                     Perl_PerlIO_get_cnt
649                     Perl_PerlIO_get_ptr
650                     Perl_PerlIO_read
651                     Perl_PerlIO_restore_errno
652                     Perl_PerlIO_save_errno
653                     Perl_PerlIO_seek
654                     Perl_PerlIO_set_cnt
655                     Perl_PerlIO_set_ptrcnt
656                     Perl_PerlIO_setlinebuf
657                     Perl_PerlIO_stderr
658                     Perl_PerlIO_stdin
659                     Perl_PerlIO_stdout
660                     Perl_PerlIO_tell
661                     Perl_PerlIO_unread
662                     Perl_PerlIO_write
663 );
664
665 # Export the symbols that make up the PerlIO abstraction, regardless
666 # of its implementation - read from a file
667 push @syms, 'perlio.sym';
668
669 # PerlIO with layers - export implementation
670 try_symbols(@layer_syms, 'perlsio_binmode');
671
672
673 unless ($define{'USE_QUADMATH'}) {
674   ++$skip{Perl_quadmath_format_needed};
675   ++$skip{Perl_quadmath_format_single};
676 }
677
678 unless ($Config{d_mbrlen}) {
679     ++$skip{PL_mbrlen_ps};
680 }
681
682 unless ($Config{d_mbrtowc}) {
683     ++$skip{PL_mbrtowc_ps};
684 }
685
686 unless ($Config{d_wcrtomb}) {
687     ++$skip{PL_wcrtomb_ps};
688 }
689
690 ###############################################################################
691
692 # At this point all skip lists should be completed, as we are about to test
693 # many symbols against them.
694
695 {
696     my %seen;
697     my ($embed) = setup_embed($ARGS{TARG_DIR});
698     my $excludedre = $define{'NO_MATHOMS'} ? qr/[emiIsb]/ : qr/[emiIs]/;
699
700     foreach (@$embed) {
701         my ($flags, $retval, $func, @args) = @$_;
702         next unless $func;
703         if (($flags =~ /[AXC]/ && $flags !~ $excludedre)
704             || (!$define{'NO_MATHOMS'} && $flags =~ /b/))
705         {
706             # public API, so export
707
708             # If a function is defined twice, for example before and after
709             # an #else, only export its name once. Important to do this test
710             # within the block, as the *first* definition may have flags which
711             # mean "don't export"
712             next if $seen{$func}++;
713             # Should we also skip adding the Perl_ prefix if $flags =~ /o/ ?
714             $func = "Perl_$func" if ($flags =~ /[psX]/ && $func !~ /^Perl_/);
715             ++$export{$func} unless exists $skip{$func};
716         }
717     }
718 }
719
720 foreach (@syms) {
721     my $syms = $ARGS{TARG_DIR} . $_;
722     open my $global, '<', $syms or die "failed to open $syms: $!\n";
723     while (<$global>) {
724         next unless /^([A-Za-z].*)/;
725         my $symbol = "$1";
726         ++$export{$symbol} unless exists $skip{$symbol};
727     }
728 }
729
730 # variables
731
732 readvar('perlvars.h', \%export);
733 unless ($define{MULTIPLICITY}) {
734     readvar('intrpvar.h', \%export);
735 }
736
737 # Oddities from PerlIO
738 # All have alternate implementations in perlio.c, so always exist.
739 # Should they be considered to be part of the API?
740 try_symbols(qw(
741                     PerlIO_binmode
742                     PerlIO_getpos
743                     PerlIO_init
744                     PerlIO_setpos
745                     PerlIO_tmpfile
746              ));
747
748 if ($ARGS{PLATFORM} eq 'win32') {
749     try_symbols(qw(
750                     win32_free_childdir
751                     win32_free_childenv
752                     win32_get_childdir
753                     win32_get_childenv
754                     win32_spawnvp
755                     Perl_init_os_extras
756                     Perl_win32_init
757                     Perl_win32_term
758                     RunPerl
759                     win32_async_check
760                     win32_errno
761                     win32_environ
762                     win32_abort
763                     win32_fstat
764                     win32_stat
765                     win32_pipe
766                     win32_popen
767                     win32_pclose
768                     win32_rename
769                     win32_setmode
770                     win32_chsize
771                     win32_lseek
772                     win32_tell
773                     win32_dup
774                     win32_dup2
775                     win32_open
776                     win32_close
777                     win32_eof
778                     win32_isatty
779                     win32_read
780                     win32_write
781                     win32_mkdir
782                     win32_rmdir
783                     win32_chdir
784                     win32_flock
785                     win32_execv
786                     win32_execvp
787                     win32_htons
788                     win32_ntohs
789                     win32_htonl
790                     win32_ntohl
791                     win32_inet_addr
792                     win32_inet_ntoa
793                     win32_socket
794                     win32_bind
795                     win32_listen
796                     win32_accept
797                     win32_connect
798                     win32_send
799                     win32_sendto
800                     win32_recv
801                     win32_recvfrom
802                     win32_shutdown
803                     win32_closesocket
804                     win32_ioctlsocket
805                     win32_setsockopt
806                     win32_getsockopt
807                     win32_getpeername
808                     win32_getsockname
809                     win32_gethostname
810                     win32_gethostbyname
811                     win32_gethostbyaddr
812                     win32_getprotobyname
813                     win32_getprotobynumber
814                     win32_getservbyname
815                     win32_getservbyport
816                     win32_select
817                     win32_endhostent
818                     win32_endnetent
819                     win32_endprotoent
820                     win32_endservent
821                     win32_getnetent
822                     win32_getnetbyname
823                     win32_getnetbyaddr
824                     win32_getprotoent
825                     win32_getservent
826                     win32_sethostent
827                     win32_setnetent
828                     win32_setprotoent
829                     win32_setservent
830                     win32_getenv
831                     win32_putenv
832                     win32_perror
833                     win32_malloc
834                     win32_calloc
835                     win32_realloc
836                     win32_free
837                     win32_sleep
838                     win32_pause
839                     win32_times
840                     win32_access
841                     win32_alarm
842                     win32_chmod
843                     win32_open_osfhandle
844                     win32_get_osfhandle
845                     win32_ioctl
846                     win32_link
847                     win32_unlink
848                     win32_utime
849                     win32_gettimeofday
850                     win32_uname
851                     win32_wait
852                     win32_waitpid
853                     win32_kill
854                     win32_str_os_error
855                     win32_opendir
856                     win32_readdir
857                     win32_telldir
858                     win32_seekdir
859                     win32_rewinddir
860                     win32_closedir
861                     win32_longpath
862                     win32_ansipath
863                     win32_os_id
864                     win32_getpid
865                     win32_crypt
866                     win32_dynaload
867                     win32_clearenv
868                     win32_stdin
869                     win32_stdout
870                     win32_stderr
871                     win32_ferror
872                     win32_feof
873                     win32_strerror
874                     win32_fprintf
875                     win32_printf
876                     win32_vfprintf
877                     win32_vprintf
878                     win32_fread
879                     win32_fwrite
880                     win32_fopen
881                     win32_fdopen
882                     win32_freopen
883                     win32_fclose
884                     win32_fputs
885                     win32_fputc
886                     win32_ungetc
887                     win32_getc
888                     win32_fileno
889                     win32_clearerr
890                     win32_fflush
891                     win32_ftell
892                     win32_fseek
893                     win32_fgetpos
894                     win32_fsetpos
895                     win32_rewind
896                     win32_tmpfile
897                     win32_setbuf
898                     win32_setvbuf
899                     win32_flushall
900                     win32_fcloseall
901                     win32_fgets
902                     win32_gets
903                     win32_fgetc
904                     win32_putc
905                     win32_puts
906                     win32_getchar
907                     win32_putchar
908                     win32_symlink
909                     win32_lstat
910                     win32_readlink
911                  ));
912 }
913 elsif ($ARGS{PLATFORM} eq 'vms') {
914     try_symbols(qw(
915                       Perl_cando
916                       Perl_cando_by_name
917                       Perl_closedir
918                       Perl_csighandler_init
919                       Perl_do_rmdir
920                       Perl_fileify_dirspec
921                       Perl_fileify_dirspec_ts
922                       Perl_fileify_dirspec_utf8
923                       Perl_fileify_dirspec_utf8_ts
924                       Perl_flex_fstat
925                       Perl_flex_lstat
926                       Perl_flex_stat
927                       Perl_kill_file
928                       Perl_my_chdir
929                       Perl_my_chmod
930                       Perl_my_crypt
931                       Perl_my_endpwent
932                       Perl_my_fclose
933                       Perl_my_fdopen
934                       Perl_my_fgetname
935                       Perl_my_flush
936                       Perl_my_fwrite
937                       Perl_my_gconvert
938                       Perl_my_getenv
939                       Perl_my_getenv_len
940                       Perl_my_getpwnam
941                       Perl_my_getpwuid
942                       Perl_my_gmtime
943                       Perl_my_kill
944                       Perl_my_killpg
945                       Perl_my_localtime
946                       Perl_my_mkdir
947                       Perl_my_sigaction
948                       Perl_my_symlink
949                       Perl_my_time
950                       Perl_my_tmpfile
951                       Perl_my_trnlnm
952                       Perl_my_utime
953                       Perl_my_waitpid
954                       Perl_opendir
955                       Perl_pathify_dirspec
956                       Perl_pathify_dirspec_ts
957                       Perl_pathify_dirspec_utf8
958                       Perl_pathify_dirspec_utf8_ts
959                       Perl_readdir
960                       Perl_readdir_r
961                       Perl_rename
962                       Perl_rmscopy
963                       Perl_rmsexpand
964                       Perl_rmsexpand_ts
965                       Perl_rmsexpand_utf8
966                       Perl_rmsexpand_utf8_ts
967                       Perl_seekdir
968                       Perl_sig_to_vmscondition
969                       Perl_telldir
970                       Perl_tounixpath
971                       Perl_tounixpath_ts
972                       Perl_tounixpath_utf8
973                       Perl_tounixpath_utf8_ts
974                       Perl_tounixspec
975                       Perl_tounixspec_ts
976                       Perl_tounixspec_utf8
977                       Perl_tounixspec_utf8_ts
978                       Perl_tovmspath
979                       Perl_tovmspath_ts
980                       Perl_tovmspath_utf8
981                       Perl_tovmspath_utf8_ts
982                       Perl_tovmsspec
983                       Perl_tovmsspec_ts
984                       Perl_tovmsspec_utf8
985                       Perl_tovmsspec_utf8_ts
986                       Perl_trim_unixpath
987                       Perl_vms_case_tolerant
988                       Perl_vms_do_aexec
989                       Perl_vms_do_exec
990                       Perl_vms_image_init
991                       Perl_vms_realpath
992                       Perl_vmssetenv
993                       Perl_vmssetuserlnm
994                       Perl_vmstrnenv
995                       PerlIO_openn
996                  ));
997 }
998 elsif ($ARGS{PLATFORM} eq 'os2') {
999     try_symbols(qw(
1000                       ctermid
1001                       get_sysinfo
1002                       Perl_OS2_init
1003                       Perl_OS2_init3
1004                       Perl_OS2_term
1005                       OS2_Perl_data
1006                       dlopen
1007                       dlsym
1008                       dlerror
1009                       dlclose
1010                       dup2
1011                       dup
1012                       my_tmpfile
1013                       my_tmpnam
1014                       my_flock
1015                       my_rmdir
1016                       my_mkdir
1017                       my_getpwuid
1018                       my_getpwnam
1019                       my_getpwent
1020                       my_setpwent
1021                       my_endpwent
1022                       fork_with_resources
1023                       croak_with_os2error
1024                       setgrent
1025                       endgrent
1026                       getgrent
1027                       malloc_mutex
1028                       threads_mutex
1029                       nthreads
1030                       nthreads_cond
1031                       os2_cond_wait
1032                       os2_stat
1033                       os2_execname
1034                       async_mssleep
1035                       msCounter
1036                       InfoTable
1037                       pthread_join
1038                       pthread_create
1039                       pthread_detach
1040                       XS_Cwd_change_drive
1041                       XS_Cwd_current_drive
1042                       XS_Cwd_extLibpath
1043                       XS_Cwd_extLibpath_set
1044                       XS_Cwd_sys_abspath
1045                       XS_Cwd_sys_chdir
1046                       XS_Cwd_sys_cwd
1047                       XS_Cwd_sys_is_absolute
1048                       XS_Cwd_sys_is_relative
1049                       XS_Cwd_sys_is_rooted
1050                       XS_DynaLoader_mod2fname
1051                       XS_File__Copy_syscopy
1052                       Perl_Register_MQ
1053                       Perl_Deregister_MQ
1054                       Perl_Serve_Messages
1055                       Perl_Process_Messages
1056                       init_PMWIN_entries
1057                       PMWIN_entries
1058                       Perl_hab_GET
1059                       loadByOrdinal
1060                       pExtFCN
1061                       os2error
1062                       ResetWinError
1063                       CroakWinError
1064                       PL_do_undump
1065                  ));
1066 }
1067
1068 # When added this code was only run for Win32 (and WinCE at the time)
1069 # Currently only Win32 links static extensions into the shared library.
1070 # For *nix (and presumably OS/2) with a shared libperl, Makefile.SH compiles
1071 # static extensions with -fPIC, but links them to perl, not libperl.so
1072 # The VMS build scripts don't yet implement static extensions at all.
1073
1074 if ($ARGS{PLATFORM} eq 'win32') {
1075     # records of type boot_module for statically linked modules (except Dynaloader)
1076     my $static_ext = $Config{static_ext} // "";
1077     $static_ext =~ s/\//__/g;
1078     $static_ext =~ s/\bDynaLoader\b//;
1079     try_symbols(map {"boot_$_"} grep {/\S/} split /\s+/, $static_ext);
1080     try_symbols("init_Win32CORE") if $static_ext =~ /\bWin32CORE\b/;
1081 }
1082
1083 if ($ARGS{PLATFORM} eq 'os2') {
1084     my (%mapped, @missing);
1085     open MAP, '<', 'miniperl.map' or die 'Cannot read miniperl.map';
1086     /^\s*[\da-f:]+\s+(\w+)/i and $mapped{$1}++ foreach <MAP>;
1087     close MAP or die 'Cannot close miniperl.map';
1088
1089     @missing = grep { !exists $mapped{$_} }
1090                     keys %export;
1091     @missing = grep { !exists $exportperlmalloc{$_} } @missing;
1092     delete $export{$_} foreach @missing;
1093 }
1094
1095 ###############################################################################
1096
1097 # Now all symbols should be defined because next we are going to output them.
1098
1099 # Start with platform specific headers:
1100
1101 if ($ARGS{PLATFORM} eq 'win32') {
1102     my $dll = $define{PERL_DLL} ? $define{PERL_DLL} =~ s/\.dll$//ir
1103         : "perl$Config{api_revision}$Config{api_version}";
1104     print "LIBRARY $dll\n";
1105     # The DESCRIPTION module definition file statement is not supported
1106     # by VC7 onwards.
1107     if ($ARGS{CCTYPE} eq 'GCC') {
1108         print "DESCRIPTION 'Perl interpreter'\n";
1109     }
1110     print "EXPORTS\n";
1111 }
1112 elsif ($ARGS{PLATFORM} eq 'os2') {
1113     (my $v = $]) =~ s/(\d\.\d\d\d)(\d\d)$/$1_$2/;
1114     $v .= '-thread' if $Config{archname} =~ /-thread/;
1115     (my $dll = $define{PERL_DLL}) =~ s/\.dll$//i;
1116     $v .= "\@$Config{perl_patchlevel}" if $Config{perl_patchlevel};
1117     my $d = "DESCRIPTION '\@#perl5-porters\@perl.org:$v#\@ Perl interpreter, configured as $Config{config_args}'";
1118     $d = substr($d, 0, 249) . "...'" if length $d > 253;
1119     print <<"---EOP---";
1120 LIBRARY '$dll' INITINSTANCE TERMINSTANCE
1121 $d
1122 STACKSIZE 32768
1123 CODE LOADONCALL
1124 DATA LOADONCALL NONSHARED MULTIPLE
1125 EXPORTS
1126 ---EOP---
1127 }
1128 elsif ($ARGS{PLATFORM} eq 'aix') {
1129     my $OSVER = `uname -v`;
1130     chop $OSVER;
1131     my $OSREL = `uname -r`;
1132     chop $OSREL;
1133     if ($OSVER > 4 || ($OSVER == 4 && $OSREL >= 3)) {
1134         print "#! ..\n";
1135     } else {
1136         print "#!\n";
1137     }
1138 }
1139
1140 # Then the symbols
1141
1142 my @symbols = $fold ? sort {lc $a cmp lc $b} keys %export : sort keys %export;
1143 foreach my $symbol (@symbols) {
1144     if (PLATFORM eq 'win32') {
1145         # Remembering the origin file of each symbol is an alternative to PL_ matching
1146         if (substr($symbol, 0, 3) eq 'PL_') {
1147             print "\t$symbol DATA\n";
1148         }
1149         else {
1150             print "\t$symbol\n";
1151         }
1152     }
1153     elsif (PLATFORM eq 'os2') {
1154         printf qq(    %-31s \@%s\n),
1155           qq("$symbol"), $ordinal{$symbol} || ++$sym_ord;
1156         printf qq(    %-31s \@%s\n),
1157           qq("$exportperlmalloc{$symbol}" = "$symbol"),
1158           $ordinal{$exportperlmalloc{$symbol}} || ++$sym_ord
1159           if $exportperlmalloc and exists $exportperlmalloc{$symbol};
1160     } else {
1161         print "$symbol\n";
1162     }
1163 }
1164
1165 # Then platform specific footers.
1166
1167 if ($ARGS{PLATFORM} eq 'os2') {
1168     print <<EOP;
1169     dll_perlmain=main
1170     fill_extLibpath
1171     dir_subst
1172     Perl_OS2_handler_install
1173
1174 ; LAST_ORDINAL=$sym_ord
1175 EOP
1176 }
1177
1178 1;