This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
install pods to 'pods' rather than 'pod' on cygwin (modified
[perl5.git] / makedef.pl
1 #
2 # Create the export list for perl.
3 #
4 # Needed by WIN32 and OS/2 for creating perl.dll
5 # and by AIX for creating libperl.a when -Dusershrplib is in effect.
6 #
7 # reads global.sym, pp.sym, perlvars.h, intrpvar.h, thrdvar.h, config.h
8 # On OS/2 reads miniperl.map as well
9
10 my $PLATFORM;
11 my $CCTYPE;
12
13 my %bincompat5005 =
14       (Perl_call_argv           =>      "perl_call_argv",
15        Perl_call_method         =>      "perl_call_method",
16        Perl_call_pv             =>      "perl_call_pv",
17        Perl_call_sv             =>      "perl_call_sv",
18        Perl_get_av              =>      "perl_get_av",
19        Perl_get_cv              =>      "perl_get_cv",
20        Perl_get_hv              =>      "perl_get_hv",
21        Perl_get_sv              =>      "perl_get_sv",
22        Perl_init_i18nl10n       =>      "perl_init_i18nl10n",
23        Perl_init_i18nl14n       =>      "perl_init_i18nl14n",
24        Perl_new_collate         =>      "perl_new_collate",
25        Perl_new_ctype           =>      "perl_new_ctype",
26        Perl_new_numeric         =>      "perl_new_numeric",
27        Perl_require_pv          =>      "perl_require_pv",
28        Perl_safesyscalloc       =>      "Perl_safecalloc",
29        Perl_safesysfree         =>      "Perl_safefree",
30        Perl_safesysmalloc       =>      "Perl_safemalloc",
31        Perl_safesysrealloc      =>      "Perl_saferealloc",
32        Perl_set_numeric_local   =>      "perl_set_numeric_local",
33        Perl_set_numeric_standard  =>    "perl_set_numeric_standard");
34
35 my $bincompat5005 = join("|", keys %bincompat5005);
36
37 while (@ARGV)
38  {
39   my $flag = shift;
40   $define{$1} = 1 if ($flag =~ /^-D(\w+)$/);
41   $define{$1} = $2 if ($flag =~ /^-D(\w+)=(.+)$/);
42   $CCTYPE   = $1 if ($flag =~ /^CCTYPE=(\w+)$/);
43   $PLATFORM = $1 if ($flag =~ /^PLATFORM=(\w+)$/);
44  } 
45
46 my @PLATFORM = qw(aix win32 os2);
47 my %PLATFORM;
48 @PLATFORM{@PLATFORM} = ();
49
50 defined $PLATFORM || die "PLATFORM undefined, must be one of: @PLATFORM\n";
51 exists $PLATFORM{$PLATFORM} || die "PLATFORM must be one of: @PLATFORM\n"; 
52
53 my $config_sh   = "config.sh";
54 my $config_h    = "config.h";
55 my $thrdvar_h   = "thrdvar.h";
56 my $intrpvar_h  = "intrpvar.h";
57 my $perlvars_h  = "perlvars.h";
58 my $global_sym  = "global.sym";
59 my $pp_sym      = "pp.sym";
60 my $globvar_sym = "globvar.sym";
61 my $perlio_sym  = "perlio.sym";
62
63 if ($PLATFORM eq 'aix') { 
64     # Nothing for now.
65 } elsif ($PLATFORM eq 'win32') {
66     $CCTYPE = "MSVC" unless defined $CCTYPE;
67     foreach ($thrdvar_h, $intrpvar_h, $perlvars_h, $global_sym, $pp_sym, $globvar_sym) {
68         s!^!..\\!;
69     }
70 }
71
72 unless ($PLATFORM eq 'win32') {
73     open(CFG,$config_sh) || die "Cannot open $config_sh: $!\n";
74     while (<CFG>)
75     {
76         if (/^(?:ccflags|optimize)='(.+)'$/) {
77             $_ = $1;
78             $define{$1} = 1 while /-D(\w+)/g;
79         }
80         if ($PLATFORM eq 'os2') {
81             $CONFIG_ARGS = $1 if /^(?:config_args)='(.+)'$/;
82             $ARCHNAME = $1 if /^(?:archname)='(.+)'$/;
83         }
84     }
85     close(CFG);
86 }
87
88 open(CFG,$config_h) || die "Cannot open $config_h: $!\n";
89 while (<CFG>)
90  {
91   $define{$1} = 1 if /^\s*#\s*define\s+(MYMALLOC)\b/;
92   $define{$1} = 1 if /^\s*#\s*define\s+(USE_THREADS)\b/;
93   $define{$1} = 1 if /^\s*#\s*define\s+(USE_PERLIO)\b/;
94   $define{$1} = 1 if /^\s*#\s*define\s+(MULTIPLICITY)\b/;
95   $define{$1} = 1 if /^\s*#\s*define\s+(PERL_BINCOMPAT_5005)\b/;
96  }
97 close(CFG);
98
99 if ($PLATFORM eq 'win32') {
100     warn join(' ',keys %define)."\n";
101     if ($define{PERL_OBJECT}) {
102         print "LIBRARY Perl56\n";
103         print "DESCRIPTION 'Perl interpreter'\n";
104         print "EXPORTS\n";
105 #    output_symbol("perl_alloc");
106         output_symbol("perl_get_host_info");
107         output_symbol("perl_alloc_using");
108 #    output_symbol("perl_construct");
109 #    output_symbol("perl_destruct");
110 #    output_symbol("perl_free");
111 #    output_symbol("perl_parse");
112 #    output_symbol("perl_run");
113 #    output_symbol("RunPerl");
114 #    exit(0);
115     }
116     else {
117         if ($CCTYPE ne 'GCC') {
118             print "LIBRARY Perl\n";
119             print "DESCRIPTION 'Perl interpreter, export autogenerated'\n";
120         }
121         else {
122             $define{'PERL_GLOBAL_STRUCT'} = 1;
123             $define{'MULTIPLICITY'} = 1;
124         }
125         print "EXPORTS\n";
126     } 
127 } elsif ($PLATFORM eq 'os2') {
128     ($v = $]) =~ s/(\d\.\d\d\d)(\d\d)$/$1_$2/;
129     $v .= '-thread' if $ARCHNAME =~ /-thread/;
130     #$sum = 0;
131     #for (split //, $v) {
132     #   $sum = ($sum * 33) + ord;
133     #   $sum &= 0xffffff;
134     #}
135     #$sum += $sum >> 5;
136     #$sum &= 0xffff;
137     #$sum = printf '%X', $sum;
138     ($dll = $define{PERL_DLL}) =~ s/\.dll$//i;
139     # print STDERR "'$dll' <= '$define{PERL_DLL}'\n";
140     print <<"---EOP---";
141 LIBRARY '$dll' INITINSTANCE TERMINSTANCE
142 DESCRIPTION '\@#perl5-porters\@perl.org:$v#\@ Perl interpreter, configured as $CONFIG_ARGS'
143 STACKSIZE 32768
144 CODE LOADONCALL
145 DATA LOADONCALL NONSHARED MULTIPLE
146 EXPORTS
147 ---EOP---
148 } elsif ($PLATFORM eq 'aix') {
149     print "#!\n";
150 }
151
152 my %skip;
153 my %export;
154
155 sub skip_symbols {
156     my $list = shift;
157     foreach my $symbol (@$list) {
158         $skip{$symbol} = 1;
159     }
160 }
161
162 sub emit_symbols {
163     my $list = shift;
164     foreach my $symbol (@$list) {
165         my $skipsym = $symbol;
166         # XXX hack
167         if ($define{PERL_OBJECT}) {
168             $skipsym =~ s/^Perl_[GIT](\w+)_ptr$/PL_$1/;
169         }
170         emit_symbol($symbol) unless exists $skip{$skipsym};
171     }
172 }
173
174 if ($PLATFORM eq 'win32') {
175 skip_symbols [qw(
176 PL_statusvalue_vms
177 PL_archpat_auto
178 PL_cryptseen
179 PL_DBcv
180 PL_generation
181 PL_lastgotoprobe
182 PL_linestart
183 PL_modcount
184 PL_pending_ident
185 PL_sortcxix
186 PL_sublex_info
187 PL_timesbuf
188 main
189 Perl_ErrorNo
190 Perl_GetVars
191 Perl_do_exec3
192 Perl_do_ipcctl
193 Perl_do_ipcget
194 Perl_do_msgrcv
195 Perl_do_msgsnd
196 Perl_do_semop
197 Perl_do_shmio
198 Perl_dump_fds
199 Perl_init_thread_intern
200 Perl_my_bzero
201 Perl_my_htonl
202 Perl_my_ntohl
203 Perl_my_swap
204 Perl_my_chsize
205 Perl_same_dirent
206 Perl_setenv_getix
207 Perl_unlnk
208 Perl_watch
209 Perl_safexcalloc
210 Perl_safexmalloc
211 Perl_safexfree
212 Perl_safexrealloc
213 Perl_my_memcmp
214 Perl_my_memset
215 PL_cshlen
216 PL_cshname
217 PL_opsave
218 )];
219 } elsif ($PLATFORM eq 'aix') {
220     skip_symbols([qw(
221 Perl_dump_fds
222 Perl_ErrorNo
223 Perl_GetVars
224 Perl_my_bcopy
225 Perl_my_bzero
226 Perl_my_chsize
227 Perl_my_htonl
228 Perl_my_memcmp
229 Perl_my_memset
230 Perl_my_ntohl
231 Perl_my_swap
232 Perl_safexcalloc
233 Perl_safexfree
234 Perl_safexmalloc
235 Perl_safexrealloc
236 Perl_same_dirent
237 Perl_unlnk
238 PL_cryptseen
239 PL_opsave
240 PL_statusvalue_vms
241 PL_sys_intern
242 )]);
243 }
244
245 if ($PLATFORM eq 'os2') {
246     emit_symbols([qw(
247 ctermid
248 get_sysinfo
249 Perl_OS2_init
250 OS2_Perl_data
251 dlopen
252 dlsym
253 dlerror
254 my_tmpfile
255 my_tmpnam
256 my_flock
257 malloc_mutex
258 threads_mutex
259 nthreads
260 nthreads_cond
261 os2_cond_wait
262 pthread_join
263 pthread_create
264 pthread_detach
265 XS_Cwd_change_drive
266 XS_Cwd_current_drive
267 XS_Cwd_extLibpath
268 XS_Cwd_extLibpath_set
269 XS_Cwd_sys_abspath
270 XS_Cwd_sys_chdir
271 XS_Cwd_sys_cwd
272 XS_Cwd_sys_is_absolute
273 XS_Cwd_sys_is_relative
274 XS_Cwd_sys_is_rooted
275 XS_DynaLoader_mod2fname
276 XS_File__Copy_syscopy
277 Perl_Register_MQ
278 Perl_Deregister_MQ
279 Perl_Serve_Messages
280 Perl_Process_Messages
281 init_PMWIN_entries
282 PMWIN_entries
283 Perl_hab_GET
284 )]);
285 }
286
287 if ($define{'PERL_OBJECT'}) {
288   skip_symbols [qw(
289     Perl_getenv_len
290     Perl_my_popen
291     Perl_my_pclose
292     )];
293 }
294 else {
295   skip_symbols [qw(
296     PL_Dir
297     PL_Env
298     PL_LIO
299     PL_Mem
300     PL_Proc
301     PL_Sock
302     PL_StdIO
303     )];
304 }
305
306 if ($define{'MYMALLOC'})
307  {
308   emit_symbols [qw(
309     Perl_dump_mstats
310     Perl_malloc
311     Perl_mfree
312     Perl_realloc
313     Perl_calloc)];
314  }
315 else
316  {
317   skip_symbols [qw(
318     Perl_dump_mstats
319     Perl_malloc
320     Perl_mfree
321     Perl_realloc
322     Perl_calloc
323     Perl_malloced_size)];
324  }
325
326 unless ($define{'USE_THREADS'})
327  {
328   skip_symbols [qw(
329 PL_thr_key
330 PL_sv_mutex
331 PL_strtab_mutex
332 PL_svref_mutex
333 PL_malloc_mutex
334 PL_cred_mutex
335 PL_eval_mutex
336 PL_eval_cond
337 PL_eval_owner
338 PL_threads_mutex
339 PL_nthreads
340 PL_nthreads_cond
341 PL_threadnum
342 PL_threadsv_names
343 PL_thrsv
344 PL_vtbl_mutex
345 Perl_getTHR
346 Perl_setTHR
347 Perl_condpair_magic
348 Perl_new_struct_thread
349 Perl_per_thread_magicals
350 Perl_thread_create
351 Perl_find_threadsv
352 Perl_unlock_condpair
353 Perl_magic_mutexfree
354 )];
355  }
356 unless ($define{'USE_THREADS'} or $define{'PERL_IMPLICIT_CONTEXT'}
357         or $define{'PERL_OBJECT'})
358 {
359   skip_symbols [qw(
360                    Perl_croak_nocontext
361                    Perl_die_nocontext
362                    Perl_deb_nocontext
363                    Perl_form_nocontext
364                    Perl_warn_nocontext
365                    Perl_warner_nocontext
366                    Perl_newSVpvf_nocontext
367                    Perl_sv_catpvf_nocontext
368                    Perl_sv_setpvf_nocontext
369                    Perl_sv_catpvf_mg_nocontext
370                    Perl_sv_setpvf_mg_nocontext
371                    )];
372  }
373
374 unless ($define{'FAKE_THREADS'})
375  {
376   skip_symbols [qw(PL_curthr)];
377  }
378
379 sub readvar
380 {
381  my $file = shift;
382  my $proc = shift || sub { "PL_$_[2]" };
383  open(VARS,$file) || die "Cannot open $file: $!\n";
384  my @syms;
385  while (<VARS>)
386   {
387    # All symbols have a Perl_ prefix because that's what embed.h
388    # sticks in front of them.
389    push(@syms, &$proc($1,$2,$3)) if (/\bPERLVAR(A?I?C?)\(([IGT])(\w+)/);
390   } 
391  close(VARS); 
392  return \@syms;
393 }
394
395 if ($define{'USE_THREADS'} || $define{'MULTIPLICITY'})
396  {
397   my $thrd = readvar($thrdvar_h);
398   skip_symbols $thrd;
399  } 
400
401 if ($define{'MULTIPLICITY'})
402  {
403   my $interp = readvar($intrpvar_h);
404   skip_symbols $interp;
405  } 
406
407 if ($define{'PERL_GLOBAL_STRUCT'})
408  {
409   my $global = readvar($perlvars_h);
410   skip_symbols $global;
411   emit_symbols [qw(Perl_GetVars)];
412   emit_symbols [qw(PL_Vars PL_VarsPtr)] unless $CCTYPE eq 'GCC';
413  } 
414
415 unless ($define{'DEBUGGING'})
416  {
417   skip_symbols [qw(
418     Perl_deb
419     Perl_deb_growlevel
420     Perl_debop
421     Perl_debprofdump
422     Perl_debstack
423     Perl_debstackptrs
424     Perl_runops_debug
425     Perl_sv_peek
426     PL_block_type
427     PL_watchaddr
428     PL_watchok)];
429  }
430
431 if ($PLATFORM eq 'win32' && $define{'HAVE_DES_FCRYPT'})
432  {
433   emit_symbols [qw(win32_crypt)];
434  }
435
436 # functions from *.sym files
437
438 my @syms = ($global_sym, $pp_sym, $globvar_sym);
439
440 if ($define{'USE_PERLIO'})
441  {
442      push @syms, $perlio_sym;
443  }
444
445 for my $syms (@syms)
446  {
447   open (GLOBAL, "<$syms") || die "failed to open $syms: $!\n";
448   while (<GLOBAL>) 
449    {
450     next if (!/^[A-Za-z]/);
451     # Functions have a Perl_ prefix
452     # Variables have a PL_ prefix
453     chomp($_);
454     my $symbol = ($syms =~ /var\.sym$/i ? "PL_" : "");
455     $symbol .= $_;
456     emit_symbol($symbol) unless exists $skip{$symbol};
457    }
458   close(GLOBAL);
459  }
460
461 # variables
462
463 if ($define{'PERL_OBJECT'}) {
464     for my $f ($perlvars_h, $intrpvar_h, $thrdvar_h) {
465         my $glob = readvar($f, sub { "Perl_" . $_[1] . $_[2] . "_ptr" });
466         emit_symbols $glob;
467     }
468 }
469 else {
470     unless ($define{'PERL_GLOBAL_STRUCT'}) {
471         my $glob = readvar($perlvars_h);
472         emit_symbols $glob;
473     } 
474     unless ($define{'MULTIPLICITY'}) {
475         my $glob = readvar($intrpvar_h);
476         emit_symbols $glob;
477     } 
478
479     unless ($define{'MULTIPLICITY'} || $define{'USE_THREADS'}) {
480         my $glob = readvar($thrdvar_h);
481         emit_symbols $glob;
482     } 
483 }
484
485 sub try_symbol {
486     my $symbol = shift;
487
488     return if $symbol !~ /^[A-Za-z]/;
489     return if $symbol =~ /^\#/;
490     $symbol =~s/\r//g;
491     chomp($symbol);
492     return if exists $skip{$symbol};
493     emit_symbol($symbol);
494 }
495
496 while (<DATA>) {
497     try_symbol($_);
498 }
499
500 if ($PLATFORM eq 'win32') {
501     foreach my $symbol (qw(
502 boot_DynaLoader
503 Perl_getTHR
504 Perl_init_os_extras
505 Perl_setTHR
506 Perl_thread_create
507 Perl_win32_init
508 RunPerl
509 GetPerlInterpreter
510 SetPerlInterpreter
511 win32_errno
512 win32_environ
513 win32_stdin
514 win32_stdout
515 win32_stderr
516 win32_ferror
517 win32_feof
518 win32_strerror
519 win32_fprintf
520 win32_printf
521 win32_vfprintf
522 win32_vprintf
523 win32_fread
524 win32_fwrite
525 win32_fopen
526 win32_fdopen
527 win32_freopen
528 win32_fclose
529 win32_fputs
530 win32_fputc
531 win32_ungetc
532 win32_getc
533 win32_fileno
534 win32_clearerr
535 win32_fflush
536 win32_ftell
537 win32_fseek
538 win32_fgetpos
539 win32_fsetpos
540 win32_rewind
541 win32_tmpfile
542 win32_abort
543 win32_fstat
544 win32_stat
545 win32_pipe
546 win32_popen
547 win32_pclose
548 win32_rename
549 win32_setmode
550 win32_lseek
551 win32_tell
552 win32_dup
553 win32_dup2
554 win32_open
555 win32_close
556 win32_eof
557 win32_read
558 win32_write
559 win32_spawnvp
560 win32_mkdir
561 win32_rmdir
562 win32_chdir
563 win32_flock
564 win32_execv
565 win32_execvp
566 win32_htons
567 win32_ntohs
568 win32_htonl
569 win32_ntohl
570 win32_inet_addr
571 win32_inet_ntoa
572 win32_socket
573 win32_bind
574 win32_listen
575 win32_accept
576 win32_connect
577 win32_send
578 win32_sendto
579 win32_recv
580 win32_recvfrom
581 win32_shutdown
582 win32_closesocket
583 win32_ioctlsocket
584 win32_setsockopt
585 win32_getsockopt
586 win32_getpeername
587 win32_getsockname
588 win32_gethostname
589 win32_gethostbyname
590 win32_gethostbyaddr
591 win32_getprotobyname
592 win32_getprotobynumber
593 win32_getservbyname
594 win32_getservbyport
595 win32_select
596 win32_endhostent
597 win32_endnetent
598 win32_endprotoent
599 win32_endservent
600 win32_getnetent
601 win32_getnetbyname
602 win32_getnetbyaddr
603 win32_getprotoent
604 win32_getservent
605 win32_sethostent
606 win32_setnetent
607 win32_setprotoent
608 win32_setservent
609 win32_getenv
610 win32_putenv
611 win32_perror
612 win32_setbuf
613 win32_setvbuf
614 win32_flushall
615 win32_fcloseall
616 win32_fgets
617 win32_gets
618 win32_fgetc
619 win32_putc
620 win32_puts
621 win32_getchar
622 win32_putchar
623 win32_malloc
624 win32_calloc
625 win32_realloc
626 win32_free
627 win32_sleep
628 win32_times
629 win32_alarm
630 win32_open_osfhandle
631 win32_get_osfhandle
632 win32_ioctl
633 win32_utime
634 win32_uname
635 win32_wait
636 win32_waitpid
637 win32_kill
638 win32_str_os_error
639 win32_opendir
640 win32_readdir
641 win32_telldir
642 win32_seekdir
643 win32_rewinddir
644 win32_closedir
645 win32_longpath
646 win32_os_id
647                            )) {
648         try_symbol($symbol);
649     }
650 }
651 elsif ($PLATFORM eq 'os2') {
652   open MAP, 'miniperl.map' or die 'Cannot read miniperl.map';
653   /^\s*[\da-f:]+\s+(\w+)/i and $mapped{$1}++ foreach <MAP>;
654   close MAP or die 'Cannot close miniperl.map';
655   
656   @missing = grep { !exists $mapped{$_} } keys %export;
657   delete $export{$_} foreach @missing;
658 }
659
660 # Now all symbols should be defined because
661 # next we are going to output them.
662
663 foreach my $symbol (sort keys %export)
664  {
665    output_symbol($symbol);
666  }
667
668 sub emit_symbol {
669         my $symbol = shift;
670         chomp($symbol); 
671         $export{$symbol} = 1;
672 }
673
674 sub output_symbol {
675     my $symbol = shift;
676     $symbol = $bincompat5005{$symbol}
677         if $define{PERL_BINCOMPAT_5005} and $symbol =~ /^($bincompat5005)$/;
678     if ($PLATFORM eq 'win32') {
679         $symbol = "_$symbol" if $CCTYPE eq 'BORLAND';
680         print "\t$symbol\n";
681 # XXX: binary compatibility between compilers is an exercise
682 # in frustration :-(
683 #        if ($CCTYPE eq "BORLAND") {
684 #           # workaround Borland quirk by exporting both the straight
685 #           # name and a name with leading underscore.  Note the
686 #           # alias *must* come after the symbol itself, if both
687 #           # are to be exported. (Linker bug?)
688 #           print "\t_$symbol\n";
689 #           print "\t$symbol = _$symbol\n";
690 #       }
691 #       elsif ($CCTYPE eq 'GCC') {
692 #           # Symbols have leading _ whole process is $%@"% slow
693 #           # so skip aliases for now
694 #           nprint "\t$symbol\n";
695 #       }
696 #       else {
697 #           # for binary coexistence, export both the symbol and
698 #           # alias with leading underscore
699 #           print "\t$symbol\n";
700 #           print "\t_$symbol = $symbol\n";
701 #       }
702     } elsif ($PLATFORM eq 'os2') {
703         print qq(    "$symbol"\n);
704     } elsif ($PLATFORM eq 'aix') {
705         print "$symbol\n";
706     }
707 }
708
709 1;
710 __DATA__
711 # extra globals not included above.
712 perl_alloc
713 perl_construct
714 perl_destruct
715 perl_free
716 perl_parse
717 perl_run