This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Integrate:
[perl5.git] / installperl
1 #!./perl
2
3 BEGIN {
4     require 5.004;
5     chdir '..' if !-d 'lib' and -d '..\lib';
6     @INC = 'lib';
7     $ENV{PERL5LIB} = 'lib';
8 }
9
10 use strict;
11 my ($Is_VMS, $Is_W32, $Is_OS2, $Is_Cygwin, $Is_Darwin,
12     $nonono, $dostrip, $versiononly, $silent, $verbose, $force,
13     $otherperls, $archname, $Is_NetWare, $nwinstall, $nopods);
14 use vars qw /$depth/;
15
16 BEGIN {
17     $Is_VMS = $^O eq 'VMS';
18     $Is_W32 = $^O eq 'MSWin32';
19     $Is_OS2 = $^O eq 'os2';
20     $Is_Cygwin = $^O eq 'cygwin';
21     $Is_Darwin = $^O eq 'darwin';
22     if ($Is_VMS) { eval 'use VMS::Filespec;' }
23 }
24
25 my $scr_ext = ($Is_VMS ? '.Com' : $Is_W32 ? '.bat' : '');
26
27 use File::Find;
28 use File::Compare;
29 use File::Copy ();
30 use File::Path ();
31 use ExtUtils::Packlist;
32 use Config;
33 use subs qw(unlink link chmod);
34
35 if ($Config{d_umask}) {
36     umask(022); # umasks like 077 aren't that useful for installations
37 }
38
39 $Is_NetWare = $Config{osname} eq 'NetWare';
40 if ($Is_NetWare) {
41     $Is_W32 = 0;
42     $scr_ext = '.pl';
43 }
44
45 # override the ones in the rest of the script
46 sub mkpath {
47     File::Path::mkpath(@_) unless $nonono;
48 }
49
50 my $mainperldir = "/usr/bin";
51 my $exe_ext = $Config{exe_ext};
52
53 # Allow ``make install PERLNAME=something_besides_perl'':
54 my $perl = defined($ENV{PERLNAME}) ? $ENV{PERLNAME} : 'perl';
55
56 # This is the base used for versioned names, like "perl5.6.0".
57 # It's separate because a common use of $PERLNAME is to install
58 # perl as "perl5", if that's used as base for versioned files you
59 # get "perl55.6.0".
60 my $perl_verbase = defined($ENV{PERLNAME_VERBASE})
61                     ? $ENV{PERLNAME_VERBASE}
62                     : $perl;
63
64 $otherperls = 1;
65 my $destdir = '';
66 while (@ARGV) {
67     $nonono = 1 if $ARGV[0] eq '-n';
68     $dostrip = 1 if $ARGV[0] eq '-s';
69     $versiononly = 1 if $ARGV[0] eq '-v';
70     $versiononly = 0 if $ARGV[0] eq '+v';
71     $silent = 1 if $ARGV[0] eq '-S';
72     $otherperls = 0 if $ARGV[0] eq '-o';
73     $force = 1 if $ARGV[0] eq '-f';
74     $verbose = 1 if $ARGV[0] eq '-V' || $ARGV [0] eq '-n';
75     $archname = 1 if $ARGV[0] eq '-A';
76     $nwinstall = 1 if $ARGV[0] eq '-netware';
77     $nopods = 1 if $ARGV[0] eq '-p';
78     $destdir = $1 if $ARGV[0] =~ /^-?-destdir=(.*)$/;
79     if ($ARGV[0] eq '-?' or $ARGV[0] =~ /^-?-h/) {
80         print <<"EOT";
81 Usage $0: [switches]
82   -n        Don't actually run any commands; just print them.
83   -s        Run strip on installed binaries.
84   -v        Only install perl as a binary with the version number in the name.
85             (Override whatever config.sh says)
86   +v        Install perl as "perl" and as a binary with the version number in
87             the name.  (Override whatever config.sh says)
88   -S        Silent mode.
89   -f        Force installation (don't check if same version is there)
90   -o        Skip checking for other copies of perl in your PATH.
91   -V        Verbose mode.
92   -A        Also install perl with the architecture's name in the perl binary's
93             name.
94   -p        Don't install the pod files. [This will break use diagnostics;]
95   -netware  Install correctly on a Netware server.
96 EOT
97         exit;
98     }
99     shift;
100 }
101
102 $versiononly = 1 if $Config{versiononly} && !defined $versiononly;
103 my (@scripts, @tolink);
104 open SCRIPTS, "utils.lst" or die "Can't open utils.lst: $!";
105 while (<SCRIPTS>) {
106     next if /^#/;
107     s/\s*#\s*pod\s*=.*//; # install script regardless of pod location
108     next if /a2p/; # a2p is binary, to be installed separately
109     chomp;
110     if (/(\S*)\s*#\s*link\s*=\s*(\S*)/) {
111         push @scripts, $1;
112         push @tolink, [$1, $2];
113     } else {
114         push @scripts, $_;
115     }
116 }
117 close SCRIPTS;
118
119 if ($scr_ext) { @scripts = map { "$_$scr_ext" } @scripts; }
120
121 my @pods = $nopods ? () : (<pod/*.pod>);
122
123 # Specify here any .pm files that are actually architecture-dependent.
124 # (Those included with XS extensions under ext/ are automatically
125 # added later.)
126 # Now that the default privlib has the full perl version number included,
127 # we no longer have to play the trick of sticking version-specific .pm
128 # files under the archlib directory.
129 my %archpms = (
130     Config => 1,
131     lib => 1,
132     Cwd => 1,
133 );
134
135 if ($^O eq 'dos') {
136     push(@scripts,'djgpp/fixpmain');
137     $archpms{config} = $archpms{filehand} = 1;
138 }
139
140 if ((-e "testcompile") && (defined($ENV{'COMPILE'}))) {
141     push(@scripts, map("$_.exe", @scripts));
142 }
143
144 find(sub {
145     if ("$File::Find::dir/$_" =~ m{^ext\b(.*)/([^/]+)\.pm$}) {
146         my($path, $modname) = ($1,$2);
147
148         # strip trailing component first
149         $path =~ s{/[^/]*$}{};
150
151         # strip optional "/lib";
152         $path =~ s{/lib\b}{};
153
154         # strip any leading /
155         $path =~ s{^/}{};
156
157         # reconstitute canonical module name
158         $modname = "$path/$modname" if length $path;
159
160         # remember it
161         $archpms{$modname} = 1;
162     }
163 }, 'ext');
164
165 # print "[$_]\n" for sort keys %archpms;
166
167 my $ver = $Config{version};
168 my $release = substr($],0,3);   # Not used currently.
169 my $patchlevel = substr($],3,2);
170 die "Patchlevel of perl ($patchlevel)",
171     "and patchlevel of config.sh ($Config{'PERL_VERSION'}) don't match\n"
172         if $patchlevel != $Config{'PERL_VERSION'};
173
174 # Fetch some frequently-used items from %Config
175 my $installbin = "$destdir$Config{installbin}";
176 my $installscript = "$destdir$Config{installscript}";
177 my $installprivlib = "$destdir$Config{installprivlib}";
178 my $installarchlib = "$destdir$Config{installarchlib}";
179 my $installsitelib = "$destdir$Config{installsitelib}";
180 my $installsitearch = "$destdir$Config{installsitearch}";
181 my $installman1dir = "$destdir$Config{installman1dir}";
182 my $man1ext = $Config{man1ext};
183 my $libperl = $Config{libperl};
184 # Shared library and dynamic loading suffixes.
185 my $so = $Config{so};
186 my $dlext = $Config{dlext};
187 my $dlsrc = $Config{dlsrc};
188 if ($^O eq 'os390') {
189     my $pwd;
190     chomp($pwd=`pwd`);
191     my $archlibexp = $Config{archlibexp};
192     my $usedl = $Config{usedl};
193     if ($usedl eq 'define') {
194         `./$^X -pibak -e 's{$pwd\/libperl.x}{$archlibexp/CORE/libperl.x}' lib/Config.pm`;
195     }
196 }
197
198 if ($nwinstall) {
199     # This is required only if we are installing on a NetWare server
200     $installscript = $Config{installnwscripts};
201     $installprivlib = $Config{installnwlib};
202     $installarchlib = $Config{installnwlib};
203     $installsitelib = $Config{installnwlib};
204 }
205
206 my $d_dosuid = $Config{d_dosuid};
207 my $binexp = $Config{binexp};
208
209 if ($Is_VMS) {  # Hang in there until File::Spec hits the big time
210     foreach ( \$installbin,     \$installscript,  \$installprivlib,
211               \$installarchlib, \$installsitelib, \$installsitearch,
212               \$installman1dir ) {
213         $$_ = unixify($$_);  $$_ =~ s:/$::;
214     }
215 }
216
217 # Do some quick sanity checks.
218
219 if (!$nonono && $d_dosuid && $>) { die "You must run as root to install suidperl\n"; }
220
221    $installbin          || die "No installbin directory in config.sh\n";
222 -d $installbin          || mkpath($installbin, $verbose, 0777);
223 -d $installbin          || $nonono || die "$installbin is not a directory\n";
224 -w $installbin          || $nonono || die "$installbin is not writable by you\n"
225         unless $installbin =~ m#^/afs/# || $nonono;
226
227 if (!$Is_NetWare) {
228 -x 'perl' . $exe_ext    || die "perl isn't executable!\n";
229 -x 'suidperl' . $exe_ext|| die "suidperl isn't executable!\n" if $d_dosuid;
230
231 -f 't/rantests'         || $Is_W32
232                         || warn "WARNING: You've never run 'make test' or",
233                                 " some tests failed! (Installing anyway.)\n";
234 } #if (!$Is_NetWare)
235
236 if (($Is_W32 and ! $Is_NetWare) or $Is_Cygwin) {
237     my $perldll;
238
239     if ($Is_Cygwin) {
240         $perldll = $libperl;
241         my $v_e_r_s = $ver; $v_e_r_s =~ tr/./_/;
242         $perldll =~ s/(\..*)?$/$v_e_r_s.$dlext/;
243         $perldll =~ s/^lib/cyg/;
244         if ($Config{useshrplib} eq 'true') {
245             # install ld2 and perlld as well
246             foreach ('ld2', 'perlld') {
247                 safe_unlink("$installbin/$_");
248                 copy("$_", "$installbin/$_");
249                 chmod(0755, "$installbin/$_");
250             };
251             open (LD2, ">$installbin/ld2");
252             print LD2 <<SHELL;
253 #!/bin/sh
254 #
255 # ld wrapper, passes all args to perlld;
256 #
257 for trythis in $installbin/perl
258 do
259   if [ -x \$trythis ]
260   then
261     \$trythis $installbin/perlld "\$\@"
262     exit \$?
263   fi
264 done
265 # hard luck!
266 echo I see no perl executable around there
267 echo perl is required to build dynamic libraries
268 echo look if the path to perl in /bin/ld2 is correct
269 exit 1
270 SHELL
271             close LD2;
272             chmod(0755, "$installbin/ld2");
273         };
274     } else {
275         $perldll = 'perl58.' . $dlext;
276     }
277
278     if ($dlsrc ne "dl_none.xs") {
279         -f $perldll || die "No perl DLL built\n";
280     }
281
282     # Install the DLL
283     safe_unlink("$installbin/$perldll");
284     copy("$perldll", "$installbin/$perldll");
285     chmod(0755, "$installbin/$perldll");
286 } # if (($Is_W32 and ! $Is_NetWare) or $Is_Cygwin)
287
288 # This will be used to store the packlist
289 my $packlist = ExtUtils::Packlist->new("$installarchlib/.packlist");
290
291 # First we install the version-numbered executables.
292
293 if ($Is_VMS) {
294     safe_unlink("$installbin/$perl$exe_ext");
295     copy("perl$exe_ext", "$installbin/$perl$exe_ext");
296     chmod(0755, "$installbin/$perl$exe_ext");
297     safe_unlink("$installbin/${perl}shr$exe_ext");
298     copy("perlshr$exe_ext", "$installbin/${perl}shr$exe_ext");
299     chmod(0755, "$installbin/${perl}shr$exe_ext");
300 }
301 elsif ($^O eq 'mpeix') {
302     # MPE lacks hard links and requires that executables with special
303     # capabilities reside in the MPE namespace.
304     safe_unlink("$installbin/perl$ver$exe_ext", $Config{perlpath});
305     # Install the primary executable into the MPE namespace as perlpath.
306     copy("perl$exe_ext", $Config{perlpath});
307     chmod(0755, $Config{perlpath});
308     # Create a backup copy with the version number.
309     link($Config{perlpath}, "$installbin/perl$ver$exe_ext");
310 }
311 elsif ($^O ne 'dos') {
312     if (!$Is_NetWare) {
313         safe_unlink("$installbin/$perl_verbase$ver$exe_ext");
314         copy("perl$exe_ext", "$installbin/$perl_verbase$ver$exe_ext");
315         strip("$installbin/$perl_verbase$ver$exe_ext");
316         chmod(0755, "$installbin/$perl_verbase$ver$exe_ext");
317     }
318     else {
319         # If installing onto a NetWare server
320         if ($nwinstall) {
321             # Copy perl.nlm, echo.nlm, type.nlm, a2p.nlm & cgi2perl.nlm
322             mkpath($Config{installnwsystem}, 1, 0777);
323             copy("netware\\".$ENV{'MAKE_TYPE'}."\\perl.nlm", $Config{installnwsystem});
324             copy("netware\\testnlm\\echo\\echo.nlm", $Config{installnwsystem});
325             copy("netware\\testnlm\\type\\type.nlm", $Config{installnwsystem});
326             copy("x2p\\a2p.nlm", $Config{installnwsystem});
327             chmod(0755, "$Config{installnwsystem}\\perl.nlm");
328             mkpath($Config{installnwlcgi}, 1, 0777);
329             copy("lib\\auto\\cgi2perl\\cgi2perl.nlm", $Config{installnwlcgi});
330         }
331     } #if (!$Is_NetWare)
332 }
333 else {
334     safe_unlink("$installbin/$perl.exe");
335     copy("perl.exe", "$installbin/$perl.exe");
336 }
337
338 safe_unlink("$installbin/s$perl_verbase$ver$exe_ext");
339 if ($d_dosuid) {
340     copy("suidperl$exe_ext", "$installbin/s$perl_verbase$ver$exe_ext");
341     chmod(04711, "$installbin/s$perl_verbase$ver$exe_ext");
342 }
343
344 # Install library files.
345
346 my ($do_installarchlib, $do_installprivlib) = (0, 0);
347
348 mkpath($installprivlib, $verbose, 0777);
349 mkpath($installarchlib, $verbose, 0777);
350 mkpath($installsitelib, $verbose, 0777) if ($installsitelib);
351 mkpath($installsitearch, $verbose, 0777) if ($installsitearch);
352
353 if (chdir "lib") {
354     $do_installarchlib = ! samepath($installarchlib, '.');
355     $do_installprivlib = ! samepath($installprivlib, '.');
356     $do_installprivlib = 0 if $versiononly && !($installprivlib =~ m/\Q$ver/);
357
358     if ($do_installarchlib || $do_installprivlib) {
359         find(\&installlib, '.');
360     }
361     chdir ".." || die "Can't cd back to source directory: $!\n";
362 }
363 else {
364     warn "Can't cd to lib to install lib files: $!\n";
365 }
366
367 # Install header files and libraries.
368 mkpath("$installarchlib/CORE", $verbose, 0777);
369 my @corefiles;
370 if ($Is_VMS) {  # We did core file selection during build
371     my $coredir = "lib/$Config{archname}/$ver/CORE";
372     $coredir =~ tr/./_/;
373     map { s|^$coredir/||i; } @corefiles = <$coredir/*.*>;
374 }
375 else {
376     # [als] hard-coded 'libperl' name... not good!
377     @corefiles = <*.h libperl*.*>;
378
379     # AIX needs perl.exp installed as well.
380     push(@corefiles,'perl.exp') if $^O eq 'aix';
381     if ($^O eq 'mpeix') {
382         # MPE needs mpeixish.h installed as well.
383         mkpath("$installarchlib/CORE/mpeix", $verbose, 0777);
384         push(@corefiles,'mpeix/mpeixish.h');
385     }
386     # If they have built sperl.o...
387     push(@corefiles,'sperl.o') if -f 'sperl.o';
388 }
389 foreach my $file (@corefiles) {
390     # HP-UX (at least) needs to maintain execute permissions
391     # on dynamically-loadable libraries. So we do it for all.
392     if (copy_if_diff($file,"$installarchlib/CORE/$file")) {
393         if ($file =~ /\.(\Q$so\E|\Q$dlext\E)$/) {
394             strip("-S", "$installarchlib/CORE/$file") if $^O =~ /^(rhapsody|darwin)$/;
395             chmod(0555, "$installarchlib/CORE/$file");
396         } else {
397             chmod(0444, "$installarchlib/CORE/$file");
398         }
399     }
400 }
401
402 # Switch in the 5.005-threads versions of he threadsafe queue and semaphore
403 # modules if so needed.
404 if ($Config{use5005threads}) {
405     for my $m (qw(Queue Semaphore)) {
406         my $t = "$installprivlib/Thread/$m.pm";
407         unlink $t;
408         copy("ext/Thread/$m.pmx", $t);
409         chmod(0444, $t);
410     }
411 }
412
413 # Install main perl executables
414 # Make links to ordinary names if installbin directory isn't current directory.
415
416 if (! $versiononly && ! samepath($installbin, '.') && ($^O ne 'dos') && ! $Is_VMS && ! $Is_NetWare) {
417     safe_unlink("$installbin/$perl$exe_ext", "$installbin/suid$perl$exe_ext");
418     if ($^O eq 'mpeix') {
419         # MPE doesn't support hard links, so use a symlink.
420         # We don't want another cloned copy.
421         symlink($Config{perlpath}, "$installbin/perl$exe_ext");
422     } elsif ($^O eq 'vos') {
423         # VOS doesn't support hard links, so use a symlink.
424         symlink("$installbin/$perl_verbase$ver$exe_ext",
425                 "$installbin/$perl$exe_ext");
426     } else {
427         link("$installbin/$perl_verbase$ver$exe_ext",
428                 "$installbin/$perl$exe_ext");
429     }
430     link("$installbin/s$perl_verbase$ver$exe_ext",
431             "$installbin/suid$perl$exe_ext")
432       if $d_dosuid;
433 }
434
435 # For development purposes it can be very useful to have multiple perls
436 # build for different "architectures" (eg threading or not) simultaneously.
437 if ($archname && ! samepath($installbin, '.') && ($^O ne 'dos') && ! $Is_VMS) {
438     my $archperl = "$perl_verbase$ver-$Config{archname}$exe_ext";
439     safe_unlink("$installbin/$archperl");
440     if ($^O eq 'mpeix') {
441         # MPE doesn't support hard links, so use a symlink.
442         # We don't want another cloned copy.
443         symlink($Config{perlpath}, "$installbin/$archperl");
444     } elsif ($^O eq 'vos') {
445         # VOS doesn't support hard links, so use a symlink.
446         symlink("$installbin/$perl_verbase$ver$exe_ext",
447                 "$installbin/$archperl");
448     } else {
449         link("$installbin/$perl_verbase$ver$exe_ext", "$installbin/$archperl");
450     }
451 }
452
453 # Offer to install perl in a "standard" location
454
455 my $mainperl_is_instperl = 0;
456
457 if ($Config{installusrbinperl} && $Config{installusrbinperl} eq 'define' &&
458     !$versiononly && !$nonono && !$Is_W32 && !$Is_NetWare && !$Is_VMS && -t STDIN && -t STDERR
459         && -w $mainperldir && ! samepath($mainperldir, $installbin)) {
460     my($usrbinperl)     = "$mainperldir/$perl$exe_ext";
461     my($instperl)       = "$installbin/$perl$exe_ext";
462     my($expinstperl)    = "$binexp/$perl$exe_ext";
463
464     # First make sure $usrbinperl is not already the same as the perl we
465     # just installed.
466     if (-x $usrbinperl) {
467         # Try to be clever about mainperl being a symbolic link
468         # to binexp/perl if binexp and installbin are different.
469         $mainperl_is_instperl =
470             samepath($usrbinperl, $instperl) ||
471             samepath($usrbinperl, $expinstperl) ||
472              (($binexp ne $installbin) &&
473               (-l $usrbinperl) &&
474               ((readlink $usrbinperl) eq $expinstperl));
475     }
476     if (! $mainperl_is_instperl) {
477         unlink($usrbinperl);
478         ( $Config{'d_link'} eq 'define' &&
479           eval { CORE::link $instperl, $usrbinperl } )  ||
480         eval { symlink $expinstperl, $usrbinperl }      ||
481         copy($instperl, $usrbinperl);
482
483         $mainperl_is_instperl = 1;
484     }
485 }
486
487 # Make links to ordinary names if installbin directory isn't current directory.
488 if (!$Is_NetWare) {
489     if (! samepath($installbin, 'x2p')) {
490         my $base = 'a2p';
491         $base .= $ver if $versiononly;
492         safe_unlink("$installbin/$base$exe_ext");
493         copy("x2p/a2p$exe_ext", "$installbin/$base$exe_ext");
494         strip("$installbin/$base$exe_ext");
495         chmod(0755, "$installbin/$base$exe_ext");
496     }
497 }
498
499 # cppstdin is just a script, but it is architecture-dependent, so
500 # it can't safely be shared.  Place it in $installbin.
501 # Note that Configure doesn't build cppstin if it isn't needed, so
502 # we skip this if cppstdin doesn't exist.
503 if (! $versiononly && (-f 'cppstdin') && (! samepath($installbin, '.'))) {
504     safe_unlink("$installbin/cppstdin");
505     copy("cppstdin", "$installbin/cppstdin");
506     chmod(0755, "$installbin/cppstdin");
507 }
508
509 sub script_alias {
510     my ($installscript, $orig, $alias, $scr_ext) = @_;
511
512     safe_unlink("$installscript/$alias$scr_ext");
513     if ($^O eq 'dos' or $Is_VMS or $^O eq 'transit') {
514         copy("$installscript/$orig$scr_ext",
515              "$installscript/$alias$scr_ext");
516     } elsif ($^O eq 'vos') {
517         symlink("$installscript/$orig$scr_ext",
518                 "$installscript/$alias$scr_ext");
519     } else {
520         link("$installscript/$orig$scr_ext",
521              "$installscript/$alias$scr_ext");
522     }
523 }
524
525 # Install scripts.
526 mkpath($installscript, $verbose, 0777);
527 if ($versiononly) {
528     for (@scripts) {
529         (my $base = $_) =~ s#.*/##;
530         $base .= $ver;
531         copy($_,    "$installscript/$base");
532         chmod(0755, "$installscript/$base");
533     }
534
535     for (@tolink) {
536         my ($from, $to) = map { "$_$ver" } @$_;
537         (my $frbase = $from) =~ s#.*/##;
538         (my $tobase = $to) =~ s#.*/##;
539         script_alias($installscript, $frbase, $tobase, $scr_ext);
540     }
541 } else {
542     for (@scripts) {
543         (my $base = $_) =~ s#.*/##;
544         copy($_, "$installscript/$base");
545         chmod(0755, "$installscript/$base");
546     }
547
548     for (@tolink) {
549         my ($from, $to) = @$_;
550         (my $frbase = $from) =~ s#.*/##;
551         (my $tobase = $to) =~ s#.*/##;
552         script_alias($installscript, $frbase, $tobase, $scr_ext);
553     }
554 }
555
556 # Install pod pages.  Where? I guess in $installprivlib/pod
557 # ($installprivlib/pods for cygwin).
558
559 my $pod = ($Is_Cygwin || $Is_Darwin) ? 'pods' : 'pod';
560 if ( !$versiononly || ($installprivlib =~ m/\Q$ver/)) {
561     mkpath("${installprivlib}/$pod", $verbose, 0777);
562
563     # If Perl 5.003's perldiag.pod is there, rename it.
564     if (open POD, "${installprivlib}/$pod/perldiag.pod") {
565         read POD, $_, 4000;
566         close POD;
567         # Some of Perl 5.003's diagnostic messages ended with periods.
568         if (/^=.*\.$/m) {
569             my ($from, $to) = ("${installprivlib}/$pod/perldiag.pod",
570                                "${installprivlib}/$pod/perldiag-5.003.pod");
571             print "  rename $from $to";
572             rename($from, $to)
573                 or warn "Couldn't rename $from to $to: $!\n"
574                 unless $nonono;
575         }
576     }
577
578     for (@pods) {
579         # $_ is a name like  pod/perl.pod
580         (my $base = $_) =~ s#.*/##;
581         copy_if_diff($_, "${installprivlib}/$pod/${base}");
582     }
583
584 }
585
586 # Check to make sure there aren't other perls around in installer's
587 # path.  This is probably UNIX-specific.  Check all absolute directories
588 # in the path except for where public executables are supposed to live.
589 # Also skip $mainperl if the user opted to have it be a link to the
590 # installed perl.
591
592 if (!$versiononly && $otherperls) {
593     my ($path, @path);
594     my $dirsep = ($Is_OS2 || $Is_W32 || $Is_NetWare) ? ';' : ':' ;
595     ($path = $ENV{"PATH"}) =~ s:\\:/:g ;
596     @path = split(/$dirsep/, $path);
597     if ($Is_VMS) {
598         my $i = 0;
599         while (exists $ENV{'DCL$PATH' . $i}) {
600             my $dir = unixpath($ENV{'DCL$PATH' . $i});  $dir =~ s-/$--;
601             push(@path,$dir);
602         }
603     }
604     my @otherperls;
605     my %otherperls;
606     for (@path) {
607         next unless m,^/,;
608         # Use &samepath here because some systems have other dirs linked
609         # to $mainperldir (like SunOS)
610         next if samepath($_, $binexp);
611         next if ($mainperl_is_instperl && samepath($_, $mainperldir));
612         my $otherperl = "$_/$perl$exe_ext";
613         next if $otherperls{$otherperl}++;
614         push(@otherperls, $otherperl)
615             if (-x $otherperl && ! -d $otherperl);
616     }
617     if (@otherperls) {
618         warn "\nWarning: $perl appears in your path in the following " .
619             "locations beyond where\nwe just installed it:\n";
620         for (@otherperls) {
621             warn "    ", $_, "\n";
622         }
623         warn "\n";
624     }
625
626 }
627
628 $packlist->write() unless $nonono;
629 print "  Installation complete\n" if $verbose;
630
631 exit 0;
632
633 ###############################################################################
634
635 sub yn {
636     my($prompt) = @_;
637     my($answer);
638     my($default) = $prompt =~ m/\[([yn])\]\s*$/i;
639     print STDERR $prompt;
640     chop($answer = <STDIN>);
641     $answer = $default if $answer =~ m/^\s*$/;
642     ($answer =~ m/^[yY]/);
643 }
644
645 sub unlink {
646     my(@names) = @_;
647     my($cnt) = 0;
648
649     return scalar(@names) if $Is_VMS;
650
651     foreach my $name (@names) {
652         next unless -e $name;
653         chmod 0777, $name if ($Is_OS2 || $Is_W32 || $Is_Cygwin || $Is_NetWare);
654         print "  unlink $name\n" if $verbose;
655         ( CORE::unlink($name) and ++$cnt
656           or warn "Couldn't unlink $name: $!\n" ) unless $nonono;
657     }
658     return $cnt;
659 }
660
661 sub safe_unlink {
662     return if $nonono or $Is_VMS;
663     my @names = @_;
664     foreach my $name (@names) {
665         next unless -e $name;
666         chmod 0777, $name if ($Is_OS2 || $Is_W32 || $Is_NetWare);
667         print "  unlink $name\n" if $verbose;
668         next if CORE::unlink($name);
669         warn "Couldn't unlink $name: $!\n";
670         if ($! =~ /busy/i) {
671             print "  mv $name $name.old\n" if $verbose;
672             safe_rename($name, "$name.old")
673                 or warn "Couldn't rename $name: $!\n";
674         }
675     }
676 }
677
678 sub safe_rename {
679     my($from,$to) = @_;
680     if (-f $to and not unlink($to)) {
681         my($i);
682         for ($i = 1; $i < 50; $i++) {
683             last if rename($to, "$to.$i");
684         }
685         warn("Cannot rename to `$to.$i': $!"), return 0
686            if $i >= 50; # Give up!
687     }
688     link($from,$to) || return 0;
689     unlink($from);
690 }
691
692 sub link {
693     my($from,$to) = @_;
694     my($success) = 0;
695
696     my $xfrom = $from;
697     $xfrom =~ s/^\Q$destdir\E// if $destdir;
698     my $xto = $to;
699     $xto =~ s/^\Q$destdir\E// if $destdir;
700     print $verbose ? "  ln $xfrom $xto\n" : "  $xto\n" unless $silent;
701     eval {
702         CORE::link($from, $to)
703             ? $success++
704             : ($from =~ m#^/afs/# || $to =~ m#^/afs/#)
705               ? die "AFS"  # okay inside eval {}
706               : die "Couldn't link $from to $to: $!\n"
707           unless $nonono;
708         $packlist->{$xto} = { from => $xfrom, type => 'link' };
709     };
710     if ($@) {
711         warn $@;
712         print $verbose ? "  cp $from $xto\n" : "  $xto\n" unless $silent;
713         print "  creating new version of $xto\n"
714                  if $Is_VMS and -e $to and !$silent;
715         File::Copy::copy($from, $to)
716             ? $success++
717             : warn "Couldn't copy $from to $to: $!\n"
718           unless $nonono;
719         $packlist->{$xto} = { type => 'file' };
720     }
721     $success;
722 }
723
724 sub chmod {
725     my($mode,$name) = @_;
726
727     return if ($^O eq 'dos');
728     printf "  chmod %o %s\n", $mode, $name if $verbose;
729     CORE::chmod($mode,$name)
730         || warn sprintf("Couldn't chmod %o %s: $!\n", $mode, $name)
731       unless $nonono;
732 }
733
734 sub copy {
735     my($from,$to) = @_;
736
737     my $xto = $to;
738     $xto =~ s/^\Q$destdir\E// if $destdir;
739     print $verbose ? "  cp $from $xto\n" : "  $xto\n" unless $silent;
740     print "  creating new version of $xto\n" if $Is_VMS and -e $to and !$silent;
741     File::Copy::copy($from, $to)
742         || warn "Couldn't copy $from to $to: $!\n"
743       unless $nonono;
744     $packlist->{$xto} = { type => 'file' };
745 }
746
747 sub samepath {
748     my($p1, $p2) = @_;
749
750     return (lc($p1) eq lc($p2)) if ($Is_W32 || $Is_NetWare);
751
752     if ($p1 ne $p2) {
753         my($dev1, $ino1, $dev2, $ino2);
754         ($dev1, $ino1) = stat($p1);
755         ($dev2, $ino2) = stat($p2);
756         ($dev1 == $dev2 && $ino1 == $ino2);
757     }
758     else {
759         1;
760     }
761 }
762
763 sub installlib {
764     my $dir = $File::Find::dir;
765     $dir =~ s#^\.(?![^/])/?##;
766     local($depth) = $dir ? "lib/$dir" : "lib";
767
768     my $name = $_;
769
770     # Ignore version control directories.
771     if (($name eq 'CVS' or $name eq 'RCS' or $name eq '.svn') and -d $name) {
772         $File::Find::prune = 1;
773         return;
774     }
775
776     # ignore patch backups, RCS files, emacs backup & temp files and the
777     # .exists files, .PL files, and test files.
778     return if $name =~ m{\.orig$|\.rej$|~$|^#.+#$|,v$|^\.exists|\.PL$|\.plc$|\.t$|^test\.pl$} ||
779               $dir  =~ m{/t(?:/|$)};
780     # ignore the cpan script in lib/CPAN/bin (installed later with other utils)
781     return if $name eq 'cpan';
782     # ignore the test extensions
783     return if $dir =~ m{ext/XS/(?:APItest|Typemap)/};
784
785     $name = "$dir/$name" if $dir ne '';
786
787     my $installlib = $installprivlib;
788     if ($dir =~ /^auto/ ||
789           ($name =~ /^(.*)\.(?:pm|pod)$/ && $archpms{$1}) ||
790           ($name =~ /^(.*)\.(?:h|lib)$/i && ($Is_W32 || $Is_NetWare))
791        ) {
792         $installlib = $installarchlib;
793         return unless $do_installarchlib;
794     } else {
795         return unless $do_installprivlib;
796     }
797
798     if (-f $_) {
799         if (/\.(?:al|ix)$/ && !($dir =~ m[^auto/(.*)$] && $archpms{$1})) {
800             $installlib = $installprivlib;
801             #We're installing *.al and *.ix files into $installprivlib,
802             #but we have to delete old *.al and *.ix files from the 5.000
803             #distribution:
804             #This might not work because $archname might have changed.
805             unlink("$installarchlib/$name");
806         }
807         my $xname = "$installlib/$name";
808         $xname =~ s/^\Q$destdir\E// if $destdir;
809         $packlist->{$xname} = { type => 'file' };
810         if ($force || compare($_, "$installlib/$name") || $nonono) {
811             unlink("$installlib/$name");
812             mkpath("$installlib/$dir", $verbose, 0777);
813             # HP-UX (at least) needs to maintain execute permissions
814             # on dynamically-loaded libraries.
815             if ($Is_NetWare && !$nwinstall) {
816                 # Don't copy .nlp,.nlm files, doesn't make sense on Windows and also
817                 # if copied will give problems when building new extensions.
818                 # Has to be copied if we are installing on a NetWare server and hence
819                 # the check !$nwinstall
820                 if (!(/\.(?:nlp|nlm|bs)$/)) {
821                     copy_if_diff($_, "$installlib/$name")
822                         and chmod($name =~ /\.(so|$dlext)$/o ? 0555 : 0444,
823                                   "$installlib/$name");
824                 }
825            } else {
826                 if (copy_if_diff($_, "$installlib/$name")) {
827                     if ($name =~ /\.(so|$dlext)$/o) {
828                         strip("-S", "$installlib/$name") if $^O =~ /^(rhapsody|darwin)$/;
829                         chmod(0555, "$installlib/$name");
830                     } else {
831                         strip("-S", "$installlib/$name")
832                             if ($name =~ /\.a$/o and $^O =~ /^(rhapsody|darwin)$/);
833                         chmod(0444, "$installlib/$name");
834                     }
835                 }
836             } #if ($Is_NetWare)
837         }
838     }
839 }
840
841 # Copy $from to $to, only if $from is different than $to.
842 # Also preserve modification times for .a libraries.
843 # On some systems, if you do
844 #   ranlib libperl.a
845 #   cp libperl.a /usr/local/lib/perl5/archlib/CORE/libperl.a
846 # and then try to link against the installed libperl.a, you might
847 # get an error message to the effect that the symbol table is older
848 # than the library.
849 # Return true if copying occurred.
850
851 sub copy_if_diff {
852     my($from,$to)=@_;
853     return 1 if (($^O eq 'VMS') && (-d $from));
854     my $xto = $to;
855     $xto =~ s/^\Q$destdir\E// if $destdir;
856     my $perlpodbadsymlink;
857     if ($from =~ m!^pod/perl[\w-]+\.pod$! &&
858         -l $from &&
859         ! -e $from) {
860         # Some Linux implementations have problems traversing over
861         # multiple symlinks (when going over NFS?) and fail to read
862         # the symlink target.  Combine this with the fact that some
863         # of the pod files (the perl$OS.pod) are symlinks (to ../README.$OS),
864         # and you end up with those pods not getting installed.
865         $perlpodbadsymlink = 1;
866     }
867     -f $from || $perlpodbadsymlink || warn "$0: $from not found";
868     $packlist->{$xto} = { type => 'file' };
869     if ($force || compare($from, $to) || $nonono) {
870         safe_unlink($to);   # In case we don't have write permissions.
871         if ($nonono) {
872             $from = $depth . "/" . $from if $depth;
873         }
874         if ($perlpodbadsymlink && $from =~ m!^pod/perl(.+)\.pod$!) {
875             $from = "README.$1";
876         }
877         copy($from, $to);
878         # Restore timestamps if it's a .a library or for OS/2.
879         if (!$nonono && ($Is_OS2 || $to =~ /\.a$/)) {
880             my ($atime, $mtime) = (stat $from)[8,9];
881             utime $atime, $mtime, $to;
882         }
883         1;
884     }
885 }
886
887 sub strip
888 {
889     my(@args) = @_;
890
891     return unless $dostrip;
892
893     my @opts;
894     while (@args && $args[0] =~ /^(-\w+)$/) {
895         push @opts, shift @args;
896     }
897
898     foreach my $file (@args) {
899         if (-f $file) {
900             if ($verbose) {
901                 print "  strip " . join(' ', @opts);
902                 print " " if (@opts);
903                 print "$file\n";
904             }
905             system("strip", @opts, $file);
906         } else {
907             print "# file '$file' skipped\n" if $verbose;
908         }
909     }
910 }