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