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