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