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