This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Permit tie ?foo,$object
[perl5.git] / installperl
1 #!./perl
2
3 BEGIN {
4     require 5.004;
5     @INC = 'lib';
6     $ENV{PERL5LIB} = 'lib';
7 }
8
9 use File::Find;
10 use File::Compare;
11 use File::Copy ();
12 use File::Path ();
13 use Config;
14 use subs qw(unlink link chmod);
15
16 # override the ones in the rest of the script
17 sub mkpath {
18     File::Path::mkpath(@_) unless $nonono;
19 }
20
21 $mainperldir = "/usr/bin";
22 $exe_ext = $Config{exe_ext};
23
24 while (@ARGV) {
25     $nonono = 1 if $ARGV[0] eq '-n';
26     $versiononly = 1 if $ARGV[0] eq '-v';
27     shift;
28 }
29
30 umask 022;
31
32 @scripts = qw(  utils/c2ph utils/h2ph utils/h2xs
33                 utils/perlbug utils/perldoc utils/pl2pm utils/splain
34                 x2p/s2p x2p/find2perl
35                 pod/pod2man pod/pod2html pod/pod2latex pod/pod2text);
36
37 @pods = (<pod/*.pod>);
38
39 %archpms = (Config => 1, FileHandle => 1, overload => 1);
40
41 if ($^O eq 'dos') {
42     push(@scripts,'djgpp/fixpmain');
43     $archpms{config} = $archpms{filehand} = 1;
44 }
45
46 find(sub {
47         if ("$File::Find::dir/$_" =~ m{^ext/[^/]+/(.*)\.pm$}) {
48             (my $pm = $1) =~ s{^lib/}{};
49             $archpms{$pm} = 1;
50         }
51     }, 'ext');
52
53 $ver = $];
54 $release = substr($ver,0,3);   # Not used presently.
55 $patchlevel = substr($ver,3,2);
56 die "Patchlevel of perl ($patchlevel)",
57     "and patchlevel of config.sh ($Config{'PATCHLEVEL'}) don't match\n"
58         if $patchlevel != $Config{'PATCHLEVEL'};
59
60 # Fetch some frequently-used items from %Config
61 $installbin = $Config{installbin};
62 $installscript = $Config{installscript};
63 $installprivlib = $Config{installprivlib};
64 $installarchlib = $Config{installarchlib};
65 $installsitelib = $Config{installsitelib};
66 $installsitearch = $Config{installsitearch};
67 $installman1dir = $Config{installman1dir};
68 $man1ext = $Config{man1ext};
69 $libperl = $Config{libperl};
70 # Shared library and dynamic loading suffixes.
71 $so = $Config{so};
72 $dlext = $Config{dlext};
73
74 $d_dosuid = $Config{d_dosuid};
75 $binexp = $Config{binexp};
76
77 # Do some quick sanity checks.
78
79 if ($d_dosuid && $>) { die "You must run as root to install suidperl\n"; }
80
81    $installbin          || die "No installbin directory in config.sh\n";
82 -d $installbin          || mkpath($installbin, 1, 0777);
83 -d $installbin          || $nonono || die "$installbin is not a directory\n";
84 -w $installbin          || $nonono || die "$installbin is not writable by you\n"
85         unless $installbin =~ m#^/afs/# || $nonono;
86
87 -x 'perl' . $exe_ext    || die "perl isn't executable!\n";
88 -x 'suidperl' . $exe_ext|| die "suidperl isn't executable!\n" if $d_dosuid;
89
90 -x 't/TEST'             || warn "WARNING: You've never run 'make test'!!!",
91         "  (Installing anyway.)\n";
92
93 if ($^O eq 'MSWin32') {
94
95 -f 'perl.' . $dlext || die "No perl DLL built\n";
96
97 # Install the DLL
98
99 safe_unlink("$installbin/perl.$dlext");
100 copy("perl.$dlext", "$installbin/perl.$dlext");
101 chmod(0755, "$installbin/perl.$dlext");
102 }
103
104 # First we install the version-numbered executables.
105
106 if ($^O ne 'dos') {
107     safe_unlink("$installbin/perl$ver$exe_ext");
108     copy("perl$exe_ext", "$installbin/perl$ver$exe_ext");
109     chmod(0755, "$installbin/perl$ver$exe_ext");
110 } else {
111     safe_unlink("$installbin/perl.exe");
112     copy("perl.exe", "$installbin/perl.exe");
113 }
114
115 safe_unlink("$installbin/sperl$ver$exe_ext");
116 if ($d_dosuid) {
117     copy("suidperl$exe_ext", "$installbin/sperl$ver$exe_ext");
118     chmod(04711, "$installbin/sperl$ver$exe_ext");
119 }
120
121 # Install library files.
122
123 $do_installarchlib = $do_installprivlib = 0;
124     
125 mkpath($installprivlib, 1, 0777);
126 mkpath($installarchlib, 1, 0777);
127 mkpath($installsitelib, 1, 0777) if ($installsitelib);
128 mkpath($installsitearch, 1, 0777) if ($installsitearch);
129
130 if (chdir "lib") {
131     $do_installarchlib = ! samepath($installarchlib, '.');
132     $do_installprivlib = ! samepath($installprivlib, '.');
133     $do_installprivlib = 0 if $versiononly && !($installprivlib =~ m/\Q$]/);
134
135     if ($do_installarchlib || $do_installprivlib) {
136         find(\&installlib, '.');
137     }
138     chdir ".." || die "Can't cd back to source directory: $!\n";
139 }
140 else {
141     warn "Can't cd to lib to install lib files: $!\n";
142 }
143
144 # Install header files and libraries.
145 mkpath("$installarchlib/CORE", 1, 0777);
146 @corefiles = <*.h libperl*.*>;
147 # AIX needs perl.exp installed as well.
148 push(@corefiles,'perl.exp') if $^O eq 'aix';
149 # If they have built sperl.o...
150 push(@corefiles,'sperl.o') if -f 'sperl.o';
151 foreach $file (@corefiles) {
152     # HP-UX (at least) needs to maintain execute permissions
153     # on dynamically-loadable libraries. So we do it for all.
154     copy_if_diff($file,"$installarchlib/CORE/$file")
155         and chmod($file =~ /\.(so|\Q$dlext\E)$/ ? 0555 : 0444,
156                    "$installarchlib/CORE/$file");
157 }
158
159 # Offer to install perl in a "standard" location
160
161 $mainperl_is_instperl = 0;
162
163 if (!$versiononly && !$nonono && -t STDIN && -t STDERR
164         && -w $mainperldir && ! samepath($mainperldir, $installbin)) {
165     local($usrbinperl)  = "$mainperldir/perl$exe_ext";
166     local($instperl)    = "$installbin/perl$exe_ext";
167     local($expinstperl) = "$binexp/perl$exe_ext";
168
169     # First make sure $usrbinperl is not already the same as the perl we
170     # just installed.
171     if (-x $usrbinperl) {
172         # Try to be clever about mainperl being a symbolic link
173         # to binexp/perl if binexp and installbin are different.
174         $mainperl_is_instperl =
175             samepath($usrbinperl, $instperl) ||
176             samepath($usrbinperl, $expinstperl) ||
177              (($binexp ne $installbin) &&
178               (-l $usrbinperl) &&
179               ((readlink $usrbinperl) eq $expinstperl));
180     }
181     if ((! $mainperl_is_instperl) &&
182         (yn("Many scripts expect perl to be installed as $usrbinperl.\n" . 
183              "Do you wish to have $usrbinperl be the same as\n" .
184              "$expinstperl? [y] ")))
185     {   
186         unlink($usrbinperl);
187         eval { CORE::link $instperl, $usrbinperl } ||
188             eval { symlink $expinstperl, $usrbinperl } ||
189                 copy($instperl, $usrbinperl);
190         $mainperl_is_instperl = 1;
191     }
192 }
193
194 # Make links to ordinary names if installbin directory isn't current directory.
195
196 if (! $versiononly && ! samepath($installbin, '.') && ($^O ne 'dos')) {
197     safe_unlink("$installbin/perl$exe_ext", "$installbin/suidperl$exe_ext");
198     link("$installbin/perl$ver$exe_ext", "$installbin/perl$exe_ext");
199     link("$installbin/sperl$ver$exe_ext", "$installbin/suidperl$exe_ext") 
200       if $d_dosuid;
201 }
202
203 if (!$versiononly && ! samepath($installbin, 'x2p')) {
204     safe_unlink("$installbin/a2p$exe_ext");
205     copy("x2p/a2p$exe_ext", "$installbin/a2p$exe_ext");
206     chmod(0755, "$installbin/a2p$exe_ext");
207 }
208
209 # cppstdin is just a script, but it is architecture-dependent, so
210 # it can't safely be shared.  Place it in $installbin.
211 # Note that Configure doesn't build cppstin if it isn't needed, so
212 # we skip this if cppstdin doesn't exist.
213 if (! $versiononly && (-f 'cppstdin') && (! samepath($installbin, '.'))) {
214     safe_unlink("$installbin/cppstdin");
215     copy("cppstdin", "$installbin/cppstdin");
216     chmod(0755, "$installbin/cppstdin");
217 }
218
219 # Install scripts.
220
221 mkpath($installscript, 1, 0777);
222
223 if (! $versiononly) {
224     for (@scripts) {
225         (my $base = $_) =~ s#.*/##;
226         copy($_, "$installscript/$base");
227         chmod(0755, "$installscript/$base");
228     }
229 }
230
231 # pstruct should be a link to c2ph
232
233 if (! $versiononly) {
234     safe_unlink("$installscript/pstruct");
235     if ($^O eq 'dos') {
236         copy("$installscript/c2ph","$installscript/pstruct"); 
237     } else {
238         link("$installscript/c2ph","$installscript/pstruct");
239     }
240 }
241
242 # Install pod pages.  Where? I guess in $installprivlib/pod.
243
244 if (! $versiononly || !($installprivlib =~ m/\Q$]/)) {
245     mkpath("${installprivlib}/pod", 1, 0777);
246
247     # If Perl 5.003's perldiag.pod is there, rename it.
248     if (open POD, "${installprivlib}/pod/perldiag.pod") {
249         read POD, $_, 4000;
250         close POD;
251         # Some of Perl 5.003's diagnostic messages ended with periods.
252         if (/^=.*\.$/m) {
253             my ($from, $to) = ("${installprivlib}/pod/perldiag.pod",
254                                "${installprivlib}/pod/perldiag-5.003.pod");
255             print STDERR "  rename $from $to";
256             rename($from, $to)
257                 or warn "Couldn't rename $from to $to: $!\n"
258                 unless $nonono;
259         }
260     }
261
262     foreach $file (@pods) {
263         # $file is a name like  pod/perl.pod
264         copy_if_diff($file, "${installprivlib}/${file}");
265     }
266
267     # Link perldiag.pod into archlib
268     my ($from, $to) = ("${installprivlib}/pod/perldiag.pod",
269                        "${installarchlib}/pod/perldiag.pod");
270     if (compare($from, $to) || $nonono) {
271         mkpath("${installarchlib}/pod", 1, 0777);
272         unlink($to);
273         link($from, $to) if ($^O ne 'dos');
274     }
275 }
276
277 # Check to make sure there aren't other perls around in installer's
278 # path.  This is probably UNIX-specific.  Check all absolute directories
279 # in the path except for where public executables are supposed to live.
280 # Also skip $mainperl if the user opted to have it be a link to the
281 # installed perl.
282
283 if (!$versiononly) {
284
285     $dirsep = ($^O eq 'os2' || $^O eq 'MSWin32') ? ';' : ':' ;
286     ($path = $ENV{"PATH"}) =~ s:\\:/:g ;
287     @path = split(/$dirsep/, $path);
288     @otherperls = ();
289     for (@path) {
290         next unless m,^/,;
291         # Use &samepath here because some systems have other dirs linked
292         # to $mainperldir (like SunOS)
293         next if samepath($_, $binexp);
294         next if ($mainperl_is_instperl && samepath($_, $mainperldir));
295         push(@otherperls, "$_/perl$exe_ext")
296             if (-x "$_/perl$exe_ext" && ! -d "$_/perl$exe_ext");
297     }
298     if (@otherperls) {
299         print STDERR "\nWarning: perl appears in your path in the following " .
300             "locations beyond where\nwe just installed it:\n";
301         for (@otherperls) {
302             print STDERR "    ", $_, "\n";
303         }
304         print STDERR "\n";
305     }
306
307 }
308
309 print STDERR "  Installation complete\n";
310
311 exit 0;
312
313 ###############################################################################
314
315 sub yn {
316     local($prompt) = @_;
317     local($answer);
318     local($default) = $prompt =~ m/\[([yn])\]\s*$/i;
319     print STDERR $prompt;
320     chop($answer = <STDIN>);
321     $answer = $default if $answer =~ m/^\s*$/;
322     ($answer =~ m/^[yY]/);
323 }
324
325 sub unlink {
326     local(@names) = @_;
327     my($cnt) = 0;
328
329     foreach $name (@names) {
330         next unless -e $name;
331         chmod 0777, $name if ($^O eq 'os2' || $^O eq 'MSWin32');
332         print STDERR "  unlink $name\n";
333         ( CORE::unlink($name) and ++$cnt 
334           or warn "Couldn't unlink $name: $!\n" ) unless $nonono;
335     }
336     return $cnt;
337 }
338
339 sub safe_unlink {
340     return if $nonono;
341     local @names = @_;
342     foreach $name (@names) {
343         next unless -e $name;
344         chmod 0777, $name if ($^O eq 'os2' || $^O eq 'MSWin32');
345         print STDERR "  unlink $name\n";
346         next if CORE::unlink($name);
347         warn "Couldn't unlink $name: $!\n";
348         if ($! =~ /busy/i) {
349             print STDERR "  mv $name $name.old\n";
350             safe_rename($name, "$name.old")
351                 or warn "Couldn't rename $name: $!\n";
352         }
353     }
354 }
355
356 sub safe_rename {
357     local($from,$to) = @_;
358     if (-f $to and not unlink($to)) {
359         my($i);
360         for ($i = 1; $i < 50; $i++) {
361             last if rename($to, "$to.$i");
362         }
363         warn("Cannot rename to `$to.$i': $!"), return 0 
364            if $i >= 50; # Give up!
365     }
366     link($from,$to) || return 0;
367     unlink($from);
368 }
369
370 sub link {
371     my($from,$to) = @_;
372     my($success) = 0;
373
374     print STDERR "  ln $from $to\n";
375     eval {
376         CORE::link($from, $to)
377             ? $success++
378             : ($from =~ m#^/afs/# || $to =~ m#^/afs/#)
379               ? die "AFS"  # okay inside eval {}
380               : warn "Couldn't link $from to $to: $!\n"
381           unless $nonono;
382     };
383     if ($@) {
384         File::Copy::copy($from, $to)
385             ? $success++
386             : warn "Couldn't copy $from to $to: $!\n"
387           unless $nonono;
388     }
389     $success;
390 }
391
392 sub chmod {
393     local($mode,$name) = @_;
394
395     return if ($^O eq 'dos');
396     printf STDERR "  chmod %o %s\n", $mode, $name;
397     CORE::chmod($mode,$name)
398         || warn sprintf("Couldn't chmod %o %s: $!\n", $mode, $name)
399       unless $nonono;
400 }
401
402 sub copy {
403     my($from,$to) = @_;
404
405     print STDERR "  cp $from $to\n";
406     File::Copy::copy($from, $to)
407         || warn "Couldn't copy $from to $to: $!\n"
408       unless $nonono;
409 }
410
411 sub samepath {
412     local($p1, $p2) = @_;
413
414     return (lc($p1) eq lc($p2)) if ($^O eq 'MSWin32');
415
416     if ($p1 ne $p2) {
417         local($dev1, $ino1, $dev2, $ino2);
418         ($dev1, $ino1) = stat($p1);
419         ($dev2, $ino2) = stat($p2);
420         ($dev1 == $dev2 && $ino1 == $ino2);
421     }
422     else {
423         1;
424     }
425 }
426
427 sub installlib {
428     my $dir = $File::Find::dir;
429     $dir =~ s#^\.(?![^/])/?##;
430     local($depth) = $dir ? "lib/$dir" : "lib";
431
432     my $name = $_;
433
434     if ($name eq 'CVS' && -d $name) {
435         $File::Find::prune = 1;
436         return;
437     }
438     
439     # ignore patch backups and the .exists files.
440     return if $name =~ m{\.orig$|~$|^\.exists};
441
442     $name = "$dir/$name" if $dir ne '';
443
444     my $installlib = $installprivlib;
445     if ($dir =~ /^auto/ ||
446           ($name =~ /^(.*)\.(?:pm|pod)$/ && $archpms{$1}) ||
447           ($name =~ /^(.*)\.(?:h|lib)$/i && $^O eq 'MSWin32')
448        ) {
449         $installlib = $installarchlib;
450         return unless $do_installarchlib;
451     } else {
452         return unless $do_installprivlib;
453     }
454
455     if (-f $_) {
456         if (/\.(?:al|ix)$/ && !($dir =~ m[^auto/(.*)$] && $archpms{$1})) {
457             $installlib = $installprivlib;
458             #We're installing *.al and *.ix files into $installprivlib,
459             #but we have to delete old *.al and *.ix files from the 5.000
460             #distribution:
461             #This might not work because $archname might have changed.
462             unlink("$installarchlib/$name");
463         }
464         if (compare($_, "$installlib/$name") || $nonono) {
465             unlink("$installlib/$name");
466             mkpath("$installlib/$dir", 1, 0777);
467             # HP-UX (at least) needs to maintain execute permissions
468             # on dynamically-loaded libraries.
469             copy_if_diff($_, "$installlib/$name")
470                 and chmod($name =~ /\.(so|$dlext)$/o ? 0555 : 0444,
471                            "$installlib/$name");
472         }
473     } elsif (-d $_) {
474         mkpath("$installlib/$name", 1, 0777);
475     }
476 }
477
478 # Copy $from to $to, only if $from is different than $to.
479 # Also preserve modification times for .a libraries.
480 # On some systems, if you do
481 #   ranlib libperl.a
482 #   cp libperl.a /usr/local/lib/perl5/archlib/CORE/libperl.a
483 # and then try to link against the installed libperl.a, you might
484 # get an error message to the effect that the symbol table is older
485 # than the library.
486 # Return true if copying occurred.
487
488 sub copy_if_diff {
489     my($from,$to)=@_;
490     -f $from || die "$0: $from not found";
491     if (compare($from, $to) || $nonono) {
492         safe_unlink($to);   # In case we don't have write permissions.
493         if ($nonono) {
494             $from = $depth . "/" . $from if $depth;
495         }
496         copy($from, $to);
497         # Restore timestamps if it's a .a library or for OS/2.
498         if (!$nonono && ($^O eq 'os2' || $to =~ /\.a$/)) {
499             my ($atime, $mtime) = (stat $from)[8,9];
500             utime $atime, $mtime, $to;
501         }
502         1;
503     }
504 }