1 package ExtUtils::MM_Win32;
6 ExtUtils::MM_Win32 - methods to override UN*X behaviour in ExtUtils::MakeMaker
10 use ExtUtils::MM_Win32; # Done internally by ExtUtils::MakeMaker if needed
14 See ExtUtils::MM_Unix for a documentation of the methods provided
15 there. This package overrides the implementation of these methods, not
25 use ExtUtils::MakeMaker qw( neatvalue );
27 use vars qw(@ISA $VERSION $BORLAND $GCC $DMAKE $NMAKE $PERLMAKE);
29 require ExtUtils::MM_Any;
30 require ExtUtils::MM_Unix;
31 @ISA = qw( ExtUtils::MM_Any ExtUtils::MM_Unix );
34 $ENV{EMXSHELL} = 'sh'; # to run `commands`
36 $BORLAND = 1 if $Config{'cc'} =~ /^bcc/i;
37 $GCC = 1 if $Config{'cc'} =~ /^gcc/i;
38 $DMAKE = 1 if $Config{'make'} =~ /^dmake/i;
39 $NMAKE = 1 if $Config{'make'} =~ /^nmake/i;
40 $PERLMAKE = 1 if $Config{'make'} =~ /^pmake/i;
43 my($self,%attribs) = @_;
45 my($funcs) = $attribs{DL_FUNCS} || $self->{DL_FUNCS} || {};
46 my($vars) = $attribs{DL_VARS} || $self->{DL_VARS} || [];
47 my($funclist) = $attribs{FUNCLIST} || $self->{FUNCLIST} || [];
48 my($imports) = $attribs{IMPORTS} || $self->{IMPORTS} || {};
50 (my $boot = $self->{NAME}) =~ s/:/_/g;
52 if (not $self->{SKIPHASH}{'dynamic'}) {
54 $self->{BASEEXT}.def: Makefile.PL
56 q! $(PERLRUN) -MExtUtils::Mksymlists \\
57 -e "Mksymlists('NAME'=>\"!, $self->{NAME},
58 q!\", 'DLBASE' => '!,$self->{DLBASE},
59 # The above two lines quoted differently to work around
60 # a bug in the 4DOS/4NT command line interpreter. The visible
61 # result of the bug was files named q('extension_name',) *with the
62 # single quotes and the comma* in the extension build directories.
63 q!', 'DL_FUNCS' => !,neatvalue($funcs),
64 q!, 'FUNCLIST' => !,neatvalue($funclist),
65 q!, 'IMPORTS' => !,neatvalue($imports),
66 q!, 'DL_VARS' => !, neatvalue($vars), q!);"
72 sub replace_manpage_separator {
80 my @e = exists($ENV{'PATHEXT'})
81 ? split(/;/, $ENV{PATHEXT})
82 : qw(.com .exe .bat .cmd);
84 for (@e) { $e .= "\Q$_\E|" }
86 # see if file ends in one of the known extensions
87 if ($file =~ /($e)$/i) {
88 return $file if -e $file;
92 return "$file$_" if -e "$file$_";
100 my($self, $ver, $names, $dirs, $trace) = @_;
105 print "Looking for perl $ver by these names:
111 foreach $dir (@$dirs){
112 next unless defined $dir; # $self->{PERL_SRC} may be undefined
113 foreach $name (@$names){
115 if (File::Spec->file_name_is_absolute($name)) { # /foo/bar
117 } elsif (File::Spec->canonpath($name) eq
118 File::Spec->canonpath(basename($name))) # foo
120 $abs = File::Spec->catfile($dir, $name);
122 $abs = File::Spec->canonpath(
123 File::Spec->catfile(File::Spec->curdir, $name)
126 print "Checking $abs\n" if ($trace >= 2);
127 next unless $self->maybe_command($abs);
128 print "Executing $abs\n" if ($trace >= 2);
129 (my($safe_abs) = $abs) =~ s{(\s)}{\\$1}g;
130 $val = `$safe_abs -e "require $ver;" 2>&1`;
132 print "Using PERL=$abs\n" if $trace;
134 } elsif ($trace >= 2) {
135 print "Result: `$val'\n";
139 print STDOUT "Unable to find a perl $ver (by these names: @$names, in these dirs: @$dirs)\n";
140 0; # false and not empty
146 $self->SUPER::init_others;
147 $self->{'TOUCH'} = '$(PERLRUN) -MExtUtils::Command -e touch';
148 $self->{'CHMOD'} = '$(PERLRUN) -MExtUtils::Command -e chmod';
149 $self->{'CP'} = '$(PERLRUN) -MExtUtils::Command -e cp';
150 $self->{'RM_F'} = '$(PERLRUN) -MExtUtils::Command -e rm_f';
151 $self->{'RM_RF'} = '$(PERLRUN) -MExtUtils::Command -e rm_rf';
152 $self->{'MV'} = '$(PERLRUN) -MExtUtils::Command -e mv';
153 $self->{'NOOP'} = 'rem';
154 $self->{'TEST_F'} = '$(PERLRUN) -MExtUtils::Command -e test_f';
155 $self->{'LD'} = $Config{'ld'} || 'link';
156 $self->{'AR'} = $Config{'ar'} || 'lib';
157 $self->{'LDLOADLIBS'} ||= $Config{'libs'};
158 # -Lfoo must come first for Borland, so we put it in LDDLFLAGS
160 my $libs = $self->{'LDLOADLIBS'};
162 while ($libs =~ s/(?:^|\s)(("?)-L.+?\2)(?:\s|$)/ /) {
163 $libpath .= ' ' if length $libpath;
166 $self->{'LDLOADLIBS'} = $libs;
167 $self->{'LDDLFLAGS'} ||= $Config{'lddlflags'};
168 $self->{'LDDLFLAGS'} .= " $libpath";
170 $self->{'DEV_NULL'} = '> NUL';
176 Initializes lots of constants and .SUFFIXES and .PHONY
186 AR_STATIC_ARGS NAME DISTNAME NAME_SYM VERSION
187 VERSION_SYM XS_VERSION INST_BIN INST_LIB
188 INST_ARCHLIB INST_SCRIPT PREFIX INSTALLDIRS
189 INSTALLPRIVLIB INSTALLARCHLIB INSTALLSITELIB
190 INSTALLSITEARCH INSTALLBIN INSTALLSCRIPT PERL_LIB
191 PERL_ARCHLIB SITELIBEXP SITEARCHEXP LIBPERL_A MYEXTLIB
192 FIRST_MAKEFILE MAKE_APERL_FILE PERLMAINCC PERL_SRC
193 PERL_INC PERL FULLPERL PERLRUN FULLPERLRUN PERLRUNINST
194 FULLPERLRUNINST ABSPERL ABSPERLRUN ABSPERLRUNINST
198 next unless defined $self->{$tmp};
199 push @m, "$tmp = $self->{$tmp}\n";
203 VERSION_MACRO = VERSION
204 DEFINE_VERSION = -D\$(VERSION_MACRO)=\\\"\$(VERSION)\\\"
205 XS_VERSION_MACRO = XS_VERSION
206 XS_DEFINE_VERSION = -D\$(XS_VERSION_MACRO)=\\\"\$(XS_VERSION)\\\"
210 MAKEMAKER = $INC{'ExtUtils/MakeMaker.pm'}
211 MM_VERSION = $ExtUtils::MakeMaker::VERSION
215 # FULLEXT = Pathname for extension directory (eg Foo/Bar/Oracle).
216 # BASEEXT = Basename part of FULLEXT. May be just equal FULLEXT. (eg Oracle)
217 # PARENT_NAME = NAME without BASEEXT and no trailing :: (eg Foo::Bar)
218 # DLBASE = Basename part of dynamic library. May be just equal BASEEXT.
222 FULLEXT BASEEXT PARENT_NAME DLBASE VERSION_FROM INC DEFINE OBJECT
225 next unless defined $self->{$tmp};
226 push @m, "$tmp = $self->{$tmp}\n";
230 # Handy lists of source code files:
231 XS_FILES= ".join(" \\\n\t", sort keys %{$self->{XS}})."
232 C_FILES = ".join(" \\\n\t", @{$self->{C}})."
233 O_FILES = ".join(" \\\n\t", @{$self->{O_FILES}})."
234 H_FILES = ".join(" \\\n\t", @{$self->{H}})."
235 MAN1PODS = ".join(" \\\n\t", sort keys %{$self->{MAN1PODS}})."
236 MAN3PODS = ".join(" \\\n\t", sort keys %{$self->{MAN3PODS}})."
240 INST_MAN1DIR INSTALLMAN1DIR MAN1EXT
241 INST_MAN3DIR INSTALLMAN3DIR MAN3EXT
243 next unless defined $self->{$tmp};
244 push @m, "$tmp = $self->{$tmp}\n";
252 .NO_CONFIG_REC: Makefile
253 } if $ENV{CLEARCASE_ROOT};
255 # why not q{} ? -- emacs
257 # work around a famous dec-osf make(1) feature(?):
260 .SUFFIXES: .xs .c .C .cpp .cxx .cc \$(OBJ_EXT)
262 # Nick wanted to get rid of .PRECIOUS. I don't remember why. I seem to
263 # recall, that some make implementations will delete the Makefile when we
264 # rebuild it. Because we call false(1) when we rebuild it. So make(1) is
265 # not completely wrong when it does so. Our milage may vary.
266 # .PRECIOUS: Makefile # seems to be not necessary anymore
268 .PHONY: all config static dynamic test linkext manifest
270 # Where is the Config information that we are using/depend on
271 CONFIGDEP = \$(PERL_ARCHLIB)\\Config.pm \$(PERL_INC)\\config.h
274 my @parentdir = split(/::/, $self->{PARENT_NAME});
276 # Where to put things:
277 INST_LIBDIR = }. File::Spec->catdir('$(INST_LIB)',@parentdir) .q{
278 INST_ARCHLIBDIR = }. File::Spec->catdir('$(INST_ARCHLIB)',@parentdir) .q{
280 INST_AUTODIR = }. File::Spec->catdir('$(INST_LIB)','auto','$(FULLEXT)') .q{
281 INST_ARCHAUTODIR = }. File::Spec->catdir('$(INST_ARCHLIB)','auto','$(FULLEXT)') .q{
284 if ($self->has_link_code()) {
286 INST_STATIC = $(INST_ARCHAUTODIR)\$(BASEEXT)$(LIB_EXT)
287 INST_DYNAMIC = $(INST_ARCHAUTODIR)\$(DLBASE).$(DLEXT)
288 INST_BOOT = $(INST_ARCHAUTODIR)\$(BASEEXT).bs
298 $tmp = $self->export_list;
302 $tmp = $self->perl_archive;
308 TO_INST_PM = }.join(" \\\n\t", sort keys %{$self->{PM}}).q{
310 PM_TO_BLIB = }.join(" \\\n\t", %{$self->{PM}}).q{
319 Defines how to produce the *.a (or equivalent) files.
325 # Come to think of it, if there are subdirs with linkcode, we still have no INST_STATIC
326 # return '' unless $self->needs_linking(); #might be because of a subdir
328 return '' unless $self->has_link_code;
332 $(INST_STATIC): $(OBJECT) $(MYEXTLIB) $(INST_ARCHAUTODIR)\.exists
335 # If this extension has its own library (eg SDBM_File)
336 # then copy that to $(INST_STATIC) and add $(OBJECT) into it.
337 push(@m, "\t$self->{CP} \$(MYEXTLIB) \$\@\n") if $self->{MYEXTLIB};
340 q{ $(AR) }.($BORLAND ? '$@ $(OBJECT:^"+")'
341 : ($GCC ? '-ru $@ $(OBJECT)'
342 : '-out:$@ $(OBJECT)')).q{
343 }.$self->{NOECHO}.q{echo "$(EXTRALIBS)" > $(INST_ARCHAUTODIR)\extralibs.ld
347 # Old mechanism - still available:
349 push @m, "\t$self->{NOECHO}".q{echo "$(EXTRALIBS)" >> $(PERL_SRC)\ext.libs}."\n\n"
350 if $self->{PERL_SRC};
352 push @m, $self->dir_target('$(INST_ARCHAUTODIR)');
358 Defines targets for bootstrap files.
363 my($self, %attribs) = @_;
366 ' unless $self->has_link_code();
369 BOOTSTRAP = '."$self->{BASEEXT}.bs".'
371 # As Mkbootstrap might not write a file (if none is required)
372 # we use touch to prevent make continually trying to remake it.
373 # The DynaLoader only reads a non-empty file.
374 $(BOOTSTRAP): '."$self->{MAKEFILE} $self->{BOOTDEP}".' $(INST_ARCHAUTODIR)\.exists
375 '.$self->{NOECHO}.'echo "Running Mkbootstrap for $(NAME) ($(BSLOADLIBS))"
376 '.$self->{NOECHO}.'$(PERLRUN) \
377 -MExtUtils::Mkbootstrap \
378 -e "Mkbootstrap(\'$(BASEEXT)\',\'$(BSLOADLIBS)\');"
379 '.$self->{NOECHO}.'$(TOUCH) $(BOOTSTRAP)
382 $(INST_BOOT): $(BOOTSTRAP) $(INST_ARCHAUTODIR)\.exists
383 '."$self->{NOECHO}$self->{RM_RF}".' $(INST_BOOT)
384 -'.$self->{CP}.' $(BOOTSTRAP) $(INST_BOOT)
389 =item dynamic_lib (o)
391 Defines how to produce the *.so (or equivalent) files.
396 my($self, %attribs) = @_;
397 return '' unless $self->needs_linking(); #might be because of a subdir
399 return '' unless $self->has_link_code;
401 my($otherldflags) = $attribs{OTHERLDFLAGS} || ($BORLAND ? 'c0d32.obj': '');
402 my($inst_dynamic_dep) = $attribs{INST_DYNAMIC_DEP} || "";
403 my($ldfrom) = '$(LDFROM)';
406 # one thing for GCC/Mingw32:
407 # we try to overcome non-relocateable-DLL problems by generating
408 # a (hopefully unique) image-base from the dll's name
411 my $dllname = $self->{BASEEXT} . "." . $self->{DLEXT};
412 $dllname =~ /(....)(.{0,4})/;
413 my $baseaddr = unpack("n", $1 ^ $2);
414 $otherldflags .= sprintf("-Wl,--image-base,0x%x0000 ", $baseaddr);
418 # This section creates the dynamically loadable $(INST_DYNAMIC)
419 # from $(OBJECT) and possibly $(MYEXTLIB).
420 OTHERLDFLAGS = '.$otherldflags.'
421 INST_DYNAMIC_DEP = '.$inst_dynamic_dep.'
423 $(INST_DYNAMIC): $(OBJECT) $(MYEXTLIB) $(BOOTSTRAP) $(INST_ARCHAUTODIR)\.exists $(EXPORT_LIST) $(PERL_ARCHIVE) $(INST_DYNAMIC_DEP)
427 q{ dlltool --def $(EXPORT_LIST) --output-exp dll.exp
428 $(LD) -o $@ -Wl,--base-file -Wl,dll.base $(LDDLFLAGS) }.$ldfrom.q{ $(OTHERLDFLAGS) $(MYEXTLIB) $(PERL_ARCHIVE) $(LDLOADLIBS) dll.exp
429 dlltool --def $(EXPORT_LIST) --base-file dll.base --output-exp dll.exp
430 $(LD) -o $@ $(LDDLFLAGS) }.$ldfrom.q{ $(OTHERLDFLAGS) $(MYEXTLIB) $(PERL_ARCHIVE) $(LDLOADLIBS) dll.exp });
433 q{ $(LD) $(LDDLFLAGS) $(OTHERLDFLAGS) }.$ldfrom.q{,$@,,}
434 .($DMAKE ? q{$(PERL_ARCHIVE:s,/,\,) $(LDLOADLIBS:s,/,\,) }
435 .q{$(MYEXTLIB:s,/,\,),$(EXPORT_LIST:s,/,\,)}
436 : q{$(subst /,\,$(PERL_ARCHIVE)) $(subst /,\,$(LDLOADLIBS)) }
437 .q{$(subst /,\,$(MYEXTLIB)),$(subst /,\,$(EXPORT_LIST))})
441 q{ $(LD) -out:$@ $(LDDLFLAGS) }.$ldfrom.q{ $(OTHERLDFLAGS) }
442 .q{$(MYEXTLIB) $(PERL_ARCHIVE) $(LDLOADLIBS) -def:$(EXPORT_LIST)});
448 push @m, $self->dir_target('$(INST_ARCHAUTODIR)');
455 my $s = $self->SUPER::clean(@_);
456 my $clean = $GCC ? 'dll.base dll.exp' : '*.pdb';
470 return '$(PERL_INC)\\'.$Config{'libperl'};
476 return "$self->{BASEEXT}.def";
481 Takes one argument, a file name, and returns the file name, if the
482 argument is likely to be a perl script. On MM_Unix this is true for
483 any ordinary, readable file.
488 my($self,$file) = @_;
489 return $file if -r $file && -f _;
490 return "$file.pl" if -r "$file.pl" && -f _;
491 return "$file.bat" if -r "$file.bat" && -f _;
497 Defines target that copies all files in the hash PM to their
498 destination and autosplits them. See L<ExtUtils::Install/DESCRIPTION>
504 my($autodir) = File::Spec->catdir('$(INST_LIB)','auto');
506 pm_to_blib: $(TO_INST_PM)
507 }.$self->{NOECHO}.q{$(PERLRUNINST) -MExtUtils::Install \
509 ($NMAKE ? 'qw[ <<pmfiles.dat ],'
510 : $DMAKE ? 'qw[ $(mktmp,pmfiles.dat $(PM_TO_BLIB:s,\\,\\\\,)\n) ],'
511 : '{ qw[$(PM_TO_BLIB)] },'
512 ).q{'}.$autodir.q{','$(PM_FILTER)')"
516 } : '') . $self->{NOECHO}.q{$(TOUCH) $@
521 =item tool_autosplit (override)
523 Use Win32 quoting on command line.
528 my($self, %attribs) = @_;
530 $asl = "\$AutoSplit::Maxlen=$attribs{MAXLEN};" if $attribs{MAXLEN};
532 # Usage: $(AUTOSPLITFILE) FileToSplit AutoDirToSplitInto
533 AUTOSPLITFILE = $(PERLRUN) -MAutoSplit }.$asl.q{ -e "autosplit($$ARGV[0], $$ARGV[1], 0, 1, 1);"
537 =item tools_other (o)
541 Defines SHELL, LD, TOUCH, CP, MV, RM_F, RM_RF, CHMOD, UMASK_NULL in
542 the Makefile. Also defines the perl programs MKPATH,
543 WARN_IF_OLD_PACKLIST, MOD_INSTALL. DOC_INSTALL, and UNINSTALL.
550 my $bin_sh = $Config{sh} || 'cmd /c';
553 } unless $DMAKE; # dmake determines its own shell
555 for (qw/ CHMOD CP LD MV NOOP RM_F RM_RF TEST_F TOUCH UMASK_NULL DEV_NULL/ ) {
556 push @m, "$_ = $self->{$_}\n";
560 # The following is a portable way to say mkdir -p
561 # To see which directories are created, change the if 0 to if 1
562 MKPATH = $(PERLRUN) -MExtUtils::Command -e mkpath
564 # This helps us to minimize the effect of the .exists files A yet
565 # better solution would be to have a stable file in the perl
566 # distribution with a timestamp of zero. But this solution doesn't
567 # need any changes to the core distribution and works with older perls
568 EQUALIZE_TIMESTAMP = $(PERLRUN) -MExtUtils::Command -e eqtime
572 return join "", @m if $self->{PARENT};
575 # Here we warn users that an old packlist file was found somewhere,
576 # and that they should call some uninstall routine
577 WARN_IF_OLD_PACKLIST = $(PERL) -lwe "exit unless -f $$ARGV[0];" \\
578 -e "print 'WARNING: I have found an old package in';" \\
579 -e "print ' ', $$ARGV[0], '.';" \\
580 -e "print 'Please make sure the two installations are not conflicting';"
585 MOD_INSTALL = $(PERL) -I$(INST_LIB) -I$(PERL_LIB) -MExtUtils::Install \
586 -e "install({ @ARGV },'$(VERBINST)',0,'$(UNINST)');"
588 DOC_INSTALL = $(PERL) -e "$$\=\"\n\n\";" \
589 -e "print '=head2 ', scalar(localtime), ': C<', shift, '>', ' L<', $$arg=shift, '|', $$arg, '>';" \
590 -e "print '=over 4';" \
591 -e "while (defined($$key = shift) and defined($$val = shift)) { print '=item *';print 'C<', \"$$key: $$val\", '>'; }" \
594 UNINSTALL = $(PERL) -MExtUtils::Install \
595 -e "uninstall($$ARGV[0],1,1); print \"\nUninstall is deprecated. Please check the";" \
596 -e "print \" packlist above carefully.\n There may be errors. Remove the\";" \
597 -e "print \" appropriate files manually.\n Sorry for the inconveniences.\n\""
605 Defines suffix rules to go from XS to object files directly. This is
606 only intended for broken make implementations.
610 sub xs_o { # many makes are too dumb to use xs_c then c_o
615 =item top_targets (o)
617 Defines the targets all, subdirs, config, and O_FILES
622 # --- Target Sections ---
628 all :: pure_all manifypods
629 '.$self->{NOECHO}.'$(NOOP)
631 unless $self->{SKIPHASH}{'all'};
634 pure_all :: config pm_to_blib subdirs linkext
635 '.$self->{NOECHO}.'$(NOOP)
637 subdirs :: $(MYEXTLIB)
638 '.$self->{NOECHO}.'$(NOOP)
640 config :: '.$self->{MAKEFILE}.' $(INST_LIBDIR)\.exists
641 '.$self->{NOECHO}.'$(NOOP)
643 config :: $(INST_ARCHAUTODIR)\.exists
644 '.$self->{NOECHO}.'$(NOOP)
646 config :: $(INST_AUTODIR)\.exists
647 '.$self->{NOECHO}.'$(NOOP)
650 push @m, $self->dir_target(qw[$(INST_AUTODIR) $(INST_LIBDIR) $(INST_ARCHAUTODIR)]);
652 if (%{$self->{MAN1PODS}}) {
654 config :: \$(INST_MAN1DIR)\\.exists
655 $self->{NOECHO}\$(NOOP)
658 push @m, $self->dir_target(qw[$(INST_MAN1DIR)]);
660 if (%{$self->{MAN3PODS}}) {
662 config :: \$(INST_MAN3DIR)\\.exists
663 $self->{NOECHO}\$(NOOP)
666 push @m, $self->dir_target(qw[$(INST_MAN3DIR)]);
670 $(O_FILES): $(H_FILES)
671 ' if @{$self->{O_FILES} || []} && @{$self->{H} || []};
675 perldoc ExtUtils::MakeMaker
683 We don't want manpage process.
689 return "\nmanifypods :\n\t$self->{NOECHO}\$(NOOP)\n";
694 Same as MM_Unix version (changes command-line quoting).
703 $(PERLRUN) -MExtUtils::Manifest=maniread \\
704 -e "@all = keys %{ maniread() };" \\
705 -e "print(\"Executing $(CI) @all\n\"); system(\"$(CI) @all\");" \\
706 -e "print(\"Executing $(RCS_LABEL) ...\n\"); system(\"$(RCS_LABEL) @all\");"
713 Same as MM_Unix version (changes command-line quoting).
721 dist : $(DIST_DEFAULT)
722 }.$self->{NOECHO}.q{$(PERL) -le "print \"Warning: Makefile possibly out of date with $$vf\" if " \
723 -e "-e ($$vf=\"$(VERSION_FROM)\") and -M $$vf < -M \"}.$self->{MAKEFILE}.q{\";"
725 tardist : $(DISTVNAME).tar$(SUFFIX)
727 zipdist : $(DISTVNAME).zip
729 $(DISTVNAME).tar$(SUFFIX) : distdir
732 $(TAR) $(TARFLAGS) $(DISTVNAME).tar $(DISTVNAME)
733 $(RM_RF) $(DISTVNAME)
734 $(COMPRESS) $(DISTVNAME).tar
737 $(DISTVNAME).zip : distdir
739 $(ZIP) $(ZIPFLAGS) $(DISTVNAME).zip $(DISTVNAME)
740 $(RM_RF) $(DISTVNAME)
743 uutardist : $(DISTVNAME).tar$(SUFFIX)
744 uuencode $(DISTVNAME).tar$(SUFFIX) \\
745 $(DISTVNAME).tar$(SUFFIX) > \\
746 $(DISTVNAME).tar$(SUFFIX)_uu
750 $(SHAR) $(DISTVNAME) > $(DISTVNAME).shar
751 $(RM_RF) $(DISTVNAME)
759 Defines the string that is passed to recursive make calls in
766 return "PASTHRU = " . ($NMAKE ? "-nologo" : "");