X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/fec02dd38faf8f83471b031857d89cb76fea1ca0..0f81c2fe26735b125e33091cb008003b2510c0ba:/configpm diff --git a/configpm b/configpm index bee74a9..0451f2d 100755 --- a/configpm +++ b/configpm @@ -1,127 +1,1263 @@ #!./miniperl -w +# +# configpm +# +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, +# 2002, 2003, 2004, 2005, 2006, 2007 Larry Wall and others. +# +# +# Regenerate the files +# +# lib/Config.pm +# lib/Config_heavy.pl +# lib/Config.pod +# +# +# from the contents of the static files +# +# Porting/Glossary +# myconfig.SH +# +# and from the contents of the Configure-generated file +# +# config.sh +# +# +# It will only update Config.pm and Config_heavy.pl if the contents of +# either file would be different. Note that *both* files are updated in +# this case, since for example an extension makefile that has a dependency +# on Config.pm should trigger even if only Config_heavy.pl has changed. -$config_pm = $ARGV[0] || 'lib/Config.pm'; -@ARGV = "./config.sh"; +sub usage { die <; + chomp; + /^(\S+):\s*(\d+)$/ or die "Malformed line '$_'"; + $Common{$1} = $1; +} + +# Post 37589e1eefb1bd62 DynaLoader defaults to reading these at runtime. +# Ideally we're redo the data below, but Fotango's build system made it +# wonderfully easy to instrument, and no longer exists. +$Common{$_} = $_ foreach qw(dlext so); # names of things which may need to have slashes changed to double-colons -@extensions = qw(dynamic_ext static_ext extensions known_extensions); +my %Extensions = map {($_,$_)} + qw(dynamic_ext static_ext extensions known_extensions); +# The plan is that this information is used by ExtUtils::MakeMaker to generate +# Makefile dependencies, rather than hardcoding a list, which has become out +# of date. However, currently, MM_Unix.pm and MM_VMS.pm have *different* lists, +# *and* descrip_mms.template doesn't actually install all the headers. +# The "Unix" list seems to (attempt to) avoid the generated headers, which I'm +# not sure is the right thing to do. Also, not certain whether it would be +# easier to parse MANIFEST to get these (adding config.h, and potentially +# removing others), but for now, stick to a hard coded list. -open CONFIG, ">$config_pm" or die "Can't open $config_pm: $!\n"; -$myver = sprintf("%.3f", $]); -print CONFIG <<"ENDOFBEG"; -package Config; -require Exporter; -\@ISA = (Exporter); -\@EXPORT = qw(%Config); +# Could use a map to add ".h", but I suspect that it's easier to use literals, +# so that anyone using grep will find them +# This is the list from MM_VMS, plus pad.h, parser.h, utf8.h +# which it installs. It *doesn't* install perliol.h - FIXME. +my @header_files = qw(EXTERN.h INTERN.h XSUB.h av.h config.h cop.h cv.h + embed.h embedvar.h form.h gv.h handy.h hv.h hv_func.h intrpvar.h + iperlsys.h keywords.h mg.h nostdio.h op.h opcode.h + pad.h parser.h patchlevel.h perl.h perlio.h perlsdio.h + perlvars.h perly.h pp.h pp_proto.h proto.h + regcomp.h regexp.h regnodes.h scope.h sv.h thread.h utf8.h + util.h); + +push @header_files, + $^O eq 'VMS' ? 'vmsish.h' : qw(dosish.h perliol.h time64.h unixish.h); + +my $header_files = ' return qw(' . join(' ', sort @header_files) . ');'; +$header_files =~ s/(?=.{64}) # If line is still overlength + (.{1,64})\ # Split at the last convenient space + /$1\n /gx; + +# allowed opts as well as specifies default and initial values +my %Allowed_Opts = ( + 'glossary' => 1, # --no-glossary - no glossary file inclusion, + # for compactness + 'chdir' => '', # --chdir=dir - change directory before writing files +); + +sub opts { + # user specified options + my %given_opts = ( + # --opt=smth + (map {/^--([\-_\w]+)=(.*)$/} @ARGV), + # --opt --no-opt --noopt + (map {/^no-?(.*)$/i?($1=>0):($_=>1)} map {/^--([\-_\w]+)$/} @ARGV), + ); + + my %opts = (%Allowed_Opts, %given_opts); + + for my $opt (grep {!exists $Allowed_Opts{$_}} keys %given_opts) { + warn "option '$opt' is not recognized"; + usage; + } + @ARGV = grep {!/^--/} @ARGV; + + return %opts; +} + + +my %Opts = opts(); -\$] == $myver or die sprintf - "Perl lib version ($myver) doesn't match executable version (%.3f)\\n", \$]; +if ($Opts{chdir}) { + chdir $Opts{chdir} or die "$0: could not chdir $Opts{chdir}: $!" +} + +my ($Config_SH, $Config_PM, $Config_heavy, $Config_POD); +my $Glossary = 'Porting/Glossary'; + +$Config_PM = "lib/Config.pm"; +$Config_POD = "lib/Config.pod"; +$Config_SH = "config.sh"; + +($Config_heavy = $Config_PM) =~ s/\.pm$/_heavy.pl/; +die "Can't automatically determine name for Config_heavy.pl from '$Config_PM'" + if $Config_heavy eq $Config_PM; + +my $config_txt; +my $heavy_txt; +my $export_funcs = <<'EOT'; +my %Export_Cache = (myconfig => 1, config_sh => 1, config_vars => 1, + config_re => 1, compile_date => 1, local_patches => 1, + bincompat_options => 1, non_bincompat_options => 1, + header_files => 1); +EOT + +my %export_ok = eval $export_funcs or die; + +$config_txt .= sprintf << 'EOT', $], $export_funcs; # This file was created by configpm when Perl was built. Any changes # made to this file will be lost the next time perl is built. +# for a description of the variables, please have a look at the +# Glossary file, as written in the Porting folder, or use the url: +# https://github.com/Perl/perl5/blob/blead/Porting/Glossary + +package Config; +use strict; +use warnings; +our ( %%Config, $VERSION ); + +$VERSION = "%s"; + +# Skip @Config::EXPORT because it only contains %%Config, which we special +# case below as it's not a function. @Config::EXPORT won't change in the +# lifetime of Perl 5. +%s +@Config::EXPORT = qw(%%Config); +@Config::EXPORT_OK = keys %%Export_Cache; + +# Need to stub all the functions to make code such as print Config::config_sh +# keep working + +EOT + +$config_txt .= "sub $_;\n" foreach sort keys %export_ok; + +my $myver = sprintf "%vd", $^V; + +$config_txt .= sprintf <<'ENDOFBEG', ($myver) x 3; + +# Define our own import method to avoid pulling in the full Exporter: +sub import { + shift; + @_ = @Config::EXPORT unless @_; + + my @funcs = grep $_ ne '%%Config', @_; + my $export_Config = @funcs < @_ ? 1 : 0; + + no strict 'refs'; + my $callpkg = caller(0); + foreach my $func (@funcs) { + die qq{"$func" is not exported by the Config module\n} + unless $Export_Cache{$func}; + *{$callpkg.'::'.$func} = \&{$func}; + } + + *{"$callpkg\::Config"} = \%%Config if $export_Config; + return; +} + +die "$0: Perl lib version (%s) doesn't match executable '$^X' version ($])" + unless $^V; + +$^V eq %s + or die sprintf "%%s: Perl lib version (%s) doesn't match executable '$^X' version (%%vd)", $0, $^V; + ENDOFBEG -@fast{@fast} = @fast; -@extensions{@extensions} = @extensions; -@non_v=(); -@v_fast=(); -@v_others=(); -while (<>) { +my @non_v = (); +my @v_others = (); +my $in_v = 0; +my %Data = (); +my $quote; + +# These variables were set in older versions of Perl, but are no longer needed +# by the core. However, some CPAN modules may rely on them; in particular, Tk +# (at least up to version 804.034) fails to build without them. We force them +# to be emitted to Config_heavy.pl for backcompat with such modules (and we may +# find that this set needs to be extended in future). See RT#132347. +my @v_forced = map "$_\n", split /\n+/, <<'EOT'; +i_limits='define' +i_stdlib='define' +i_string='define' +i_time='define' +prototype='define' +EOT + + +my %seen_quotes; +{ + my ($name, $val); + open(CONFIG_SH, '<', $Config_SH) || die "Can't open $Config_SH: $!"; + while () { next if m:^#!/bin/sh:; - # Catch CONFIG=true and PATCHLEVEL=n line from Configure. - s/^(\w+)=(true|\d+)\s*$/$1='$2'\n/; - unless (m/^(\w+)='(.*)'\s*$/){ + + # Catch PERL_CONFIG_SH=true and PERL_VERSION=n line from Configure. + s/^(\w+)=(true|\d+)\s*$/$1='$2'\n/ or m/^(\w+)='(.*)'$/; + my($k, $v) = ($1, $2); + + # grandfather PATCHLEVEL and SUBVERSION and CONFIG + if ($k) { + if ($k eq 'PERL_VERSION') { + push @v_others, "PATCHLEVEL='$v'\n"; + } + elsif ($k eq 'PERL_SUBVERSION') { + push @v_others, "SUBVERSION='$v'\n"; + } + elsif ($k eq 'PERL_CONFIG_SH') { + push @v_others, "CONFIG='$v'\n"; + } + } + + # We can delimit things in config.sh with either ' or ". + unless ($in_v or m/^(\w+)=(['"])(.*\n)/){ push(@non_v, "#$_"); # not a name='value' line next; } - $name = $1; - if ($extensions{$name}) { s,/,::,g } - if (!$fast{$name}){ push(@v_others, $_); next; } - push(@v_fast,$_); + if ($in_v) { + $val .= $_; + } + else { + $quote = $2; + ($name,$val) = ($1,$3); + if ($name eq 'cc') { + $val =~ s{^(['"]?+).*\bccache\s+}{$1}; + } + } + $in_v = $val !~ /$quote\n/; + next if $in_v; + + s,/,::,g if $Extensions{$name}; + + $val =~ s/$quote\n?\z//; + + my $line = "$name=$quote$val$quote\n"; + push(@v_others, $line); + $seen_quotes{$quote}++; + } + close CONFIG_SH; } -foreach(@non_v){ print CONFIG $_ } +# This is somewhat grim, but I want the code for parsing config.sh here and +# now so that I can expand $Config{ivsize} and $Config{ivtype} + +my $fetch_string = <<'EOT'; + +# Search for it in the big string +sub fetch_string { + my($self, $key) = @_; + +EOT + +if ($seen_quotes{'"'}) { + # We need the full ' and " code + +$fetch_string .= <<'EOT'; + return undef unless my ($quote_type, $value) = $Config_SH_expanded =~ /\n$key=(['"])(.*?)\1\n/s; -print CONFIG "\n", - "\$config_sh=<<'!END!OF!CONFIG!';\n", - join("", @v_fast, sort @v_others), - "!END!OF!CONFIG!\n\n"; + # If we had a double-quote, we'd better eval it so escape + # sequences and such can be interpolated. Since the incoming + # value is supposed to follow shell rules and not perl rules, + # we escape any perl variable markers + # Historically, since " 'support' was added in change 1409, the + # interpolation was done before the undef. Stick to this arguably buggy + # behaviour as we're refactoring. + if ($quote_type eq '"') { + $value =~ s/\$/\\\$/g; + $value =~ s/\@/\\\@/g; + eval "\$value = \"$value\""; + } + + # So we can say "if $Config{'foo'}". + $self->{$key} = $value eq 'undef' ? undef : $value; # cache it +} +EOT + +} else { + # We only have ' delimited. -print CONFIG <<'ENDOFEND'; +$fetch_string .= <<'EOT'; + return undef unless $Config_SH_expanded =~ /\n$key=\'(.*?)\'\n/s; + # So we can say "if $Config{'foo'}". + $self->{$key} = $1 eq 'undef' ? undef : $1; +} +EOT -tie %Config, Config; -sub TIEHASH { bless {} } -sub FETCH { - # check for cached value (which maybe undef so we use exists not defined) - return $_[0]->{$_[1]} if (exists $_[0]->{$_[1]}); - - my($value); # search for the item in the big $config_sh string - return undef unless (($value) = $config_sh =~ m/^$_[1]='(.*)'\s*$/m); - - $value = undef if $value eq 'undef'; # So we can say "if $Config{'foo'}". - $_[0]->{$_[1]} = $value; # cache it - return $value; } - + +eval $fetch_string; +die if $@; + +# Calculation for the keys for byteorder +# This is somewhat grim, but I need to run fetch_string here. +$Config_SH_expanded = join "\n", '', @v_others; + +my $t = fetch_string ({}, 'ivtype'); +my $s = fetch_string ({}, 'ivsize'); + +# byteorder does exist on its own but we overlay a virtual +# dynamically recomputed value. + +# However, ivtype and ivsize will not vary for sane fat binaries + +my $f = $t eq 'long' ? 'L!' : $s == 8 ? 'Q': 'I'; + +my $byteorder_code; +if ($s == 4 || $s == 8) { + my $list = join ',', reverse(1..$s-1); + my $format = 'a'x$s; + $byteorder_code = <<"EOT"; + +my \$i = ord($s); +foreach my \$c ($list) { \$i <<= 8; \$i |= ord(\$c); } +our \$byteorder = join('', unpack('$format', pack('$f', \$i))); +EOT +} else { + $byteorder_code = "our \$byteorder = '?'x$s;\n"; +} + +my @need_relocation; + +if (fetch_string({},'userelocatableinc')) { + foreach my $what (qw(prefixexp + + archlibexp + html1direxp + html3direxp + man1direxp + man3direxp + privlibexp + scriptdirexp + sitearchexp + sitebinexp + sitehtml1direxp + sitehtml3direxp + sitelibexp + siteman1direxp + siteman3direxp + sitescriptexp + vendorarchexp + vendorbinexp + vendorhtml1direxp + vendorhtml3direxp + vendorlibexp + vendorman1direxp + vendorman3direxp + vendorscriptexp + + siteprefixexp + sitelib_stem + vendorlib_stem + + installarchlib + installhtml1dir + installhtml3dir + installman1dir + installman3dir + installprefix + installprefixexp + installprivlib + installscript + installsitearch + installsitebin + installsitehtml1dir + installsitehtml3dir + installsitelib + installsiteman1dir + installsiteman3dir + installsitescript + installvendorarch + installvendorbin + installvendorhtml1dir + installvendorhtml3dir + installvendorlib + installvendorman1dir + installvendorman3dir + installvendorscript + )) { + push @need_relocation, $what if fetch_string({}, $what) =~ m!^\.\.\./!; + } +} + +my %need_relocation; +@need_relocation{@need_relocation} = @need_relocation; + +# This can have .../ anywhere: +if (fetch_string({}, 'otherlibdirs') =~ m!\.\.\./!) { + $need_relocation{otherlibdirs} = 'otherlibdirs'; +} + +my $relocation_code = <<'EOT'; + +sub relocate_inc { + my $libdir = shift; + return $libdir unless $libdir =~ s!^\.\.\./!!; + my $prefix = $^X; + if ($prefix =~ s!/[^/]*$!!) { + while ($libdir =~ m!^\.\./!) { + # Loop while $libdir starts "../" and $prefix still has a trailing + # directory + last unless $prefix =~ s!/([^/]+)$!!; + # but bail out if the directory we picked off the end of $prefix is . + # or .. + if ($1 eq '.' or $1 eq '..') { + # Undo! This should be rare, hence code it this way rather than a + # check each time before the s!!! above. + $prefix = "$prefix/$1"; + last; + } + # Remove that leading ../ and loop again + substr ($libdir, 0, 3, ''); + } + $libdir = "$prefix/$libdir"; + } + $libdir; +} +EOT + +my $osname = fetch_string({}, 'osname'); +my $from = $osname eq 'VMS' ? 'PERLSHR image' : 'binary (from libperl)'; +my $env_cygwin = $osname eq 'cygwin' + ? 'push @env, "CYGWIN=\"$ENV{CYGWIN}\"" if $ENV{CYGWIN};' . "\n" : ""; + +$heavy_txt .= sprintf <<'ENDOFBEG', $osname, $osname, $from, $osname, $env_cygwin; +# This file was created by configpm when Perl was built. Any changes +# made to this file will be lost the next time perl is built. + +package Config; +use strict; +use warnings; +our %%Config; + +sub bincompat_options { + return split ' ', (Internals::V())[0]; +} + +sub non_bincompat_options { + return split ' ', (Internals::V())[1]; +} + +sub compile_date { + return (Internals::V())[2] +} + +sub local_patches { + my (undef, undef, undef, @patches) = Internals::V(); + return @patches; +} + +sub _V { + die "Perl lib was built for '%s' but is being run on '$^O'" + unless "%s" eq $^O; + + my ($bincompat, $non_bincompat, $date, @patches) = Internals::V(); + + my @opts = sort split ' ', "$bincompat $non_bincompat"; + + print Config::myconfig(); + print "\nCharacteristics of this %s: \n"; + + print " Compile-time options:\n"; + print " $_\n" for @opts; + + if (@patches) { + print " Locally applied patches:\n"; + print " $_\n" foreach @patches; + } + + print " Built under %s\n"; + + print " $date\n" if defined $date; + + my @env = map { "$_=\"$ENV{$_}\"" } sort grep {/^PERL/} keys %%ENV; +%s + if (@env) { + print " \%%ENV:\n"; + print " $_\n" foreach @env; + } + print " \@INC:\n"; + print " $_\n" foreach @INC; +} + +sub header_files { +ENDOFBEG + +$heavy_txt .= $header_files . "\n}\n\n"; + +if (%need_relocation) { + my $relocations_in_common; + # otherlibdirs only features in the hash + foreach (keys %need_relocation) { + $relocations_in_common++ if $Common{$_}; + } + if ($relocations_in_common) { + $config_txt .= $relocation_code; + } else { + $heavy_txt .= $relocation_code; + } +} + +$heavy_txt .= join('', @non_v) . "\n"; + +# copy config summary format from the myconfig.SH script +$heavy_txt .= "our \$summary = <<'!END!';\n"; +open(MYCONFIG,'<','myconfig.SH') || die "open myconfig.SH failed: $!"; +1 while defined($_ = ) && !/^Summary of/; +do { $heavy_txt .= $_ } until !defined($_ = ) || /^\s*$/; +close(MYCONFIG); + +$heavy_txt .= "\n!END!\n" . <<'EOT'; +my $summary_expanded; + +sub myconfig { + return $summary_expanded if $summary_expanded; + ($summary_expanded = $summary) =~ s{\$(\w+)} + { + my $c; + if ($1 eq 'git_ancestor_line') { + if ($Config::Config{git_ancestor}) { + $c= "\n Ancestor: $Config::Config{git_ancestor}"; + } else { + $c= ""; + } + } else { + $c = $Config::Config{$1}; + } + defined($c) ? $c : 'undef' + }ge; + $summary_expanded; +} + +local *_ = \my $a; +$_ = <<'!END!'; +EOT +#proper lexicographical order of the keys +my %seen_var; +$heavy_txt .= join('', + map { $_->[-1] } + sort {$a->[0] cmp $b->[0] } + grep { !$seen_var{ $_->[0] }++ } + map { + /^([^=]+)/ ? [ $1, $_ ] + : [ $_, $_ ] # shouldnt happen + } @v_others, @v_forced +) . "!END!\n"; + +# Only need the dynamic byteorder code in Config.pm if 'byteorder' is one of +# the precached keys +if ($Common{byteorder}) { + $config_txt .= $byteorder_code; +} else { + $heavy_txt .= $byteorder_code; +} + +if (@need_relocation) { +$heavy_txt .= 'foreach my $what (qw(' . join (' ', @need_relocation) . + ")) {\n" . <<'EOT'; + s/^($what=)(['"])(.*?)\2/$1 . $2 . relocate_inc($3) . $2/me; +} +EOT +# Currently it only makes sense to do the ... relocation on Unix, so there's +# no need to emulate the "which separator for this platform" logic in perl.c - +# ':' will always be applicable +if ($need_relocation{otherlibdirs}) { +$heavy_txt .= << 'EOT'; +s{^(otherlibdirs=)(['"])(.*?)\2} + {$1 . $2 . join ':', map {relocate_inc($_)} split ':', $3 . $2}me; +EOT +} +} + +$heavy_txt .= <<'EOT'; +s/(byteorder=)(['"]).*?\2/$1$2$Config::byteorder$2/m; + +my $config_sh_len = length $_; + +our $Config_SH_expanded = "\n$_" . << 'EOVIRTUAL'; +EOT + +foreach my $prefix (qw(ccflags ldflags)) { + my $value = fetch_string ({}, $prefix); + my $withlargefiles = fetch_string ({}, $prefix . "_uselargefiles"); + if (defined $withlargefiles) { + $value =~ s/\Q$withlargefiles\E\b//; + $heavy_txt .= "${prefix}_nolargefiles='$value'\n"; + } +} + +foreach my $prefix (qw(libs libswanted)) { + my $value = fetch_string ({}, $prefix); + my $withlf = fetch_string ({}, 'libswanted_uselargefiles'); + next unless defined $withlf; + my @lflibswanted + = split(' ', fetch_string ({}, 'libswanted_uselargefiles')); + if (@lflibswanted) { + my %lflibswanted; + @lflibswanted{@lflibswanted} = (); + if ($prefix eq 'libs') { + my @libs = grep { /^-l(.+)/ && + not exists $lflibswanted{$1} } + split(' ', fetch_string ({}, 'libs')); + $value = join(' ', @libs); + } else { + my @libswanted = grep { not exists $lflibswanted{$_} } + split(' ', fetch_string ({}, 'libswanted')); + $value = join(' ', @libswanted); + } + } + $heavy_txt .= "${prefix}_nolargefiles='$value'\n"; +} + +if (open(my $fh, '<', 'cflags')) { + my $ccwarnflags; + my $ccstdflags; + while (<$fh>) { + if (/^warn="(.+)"$/) { + $ccwarnflags = $1; + } elsif (/^stdflags="(.+)"$/) { + $ccstdflags = $1; + } + } + if (defined $ccwarnflags) { + $heavy_txt .= "ccwarnflags='$ccwarnflags'\n"; + } + if (defined $ccstdflags) { + $heavy_txt .= "ccstdflags='$ccstdflags'\n"; + } +} + +$heavy_txt .= "EOVIRTUAL\n"; + +$heavy_txt .= <<'ENDOFGIT'; +eval { + # do not have hairy conniptions if this isnt available + require 'Config_git.pl'; + $Config_SH_expanded .= $Config::Git_Data; + 1; +} or warn "Warning: failed to load Config_git.pl, something strange about this perl...\n"; +ENDOFGIT + +$heavy_txt .= $fetch_string; + +$config_txt .= <<'ENDOFEND'; + +sub FETCH { + my($self, $key) = @_; + + # check for cached value (which may be undef so we use exists not defined) + return exists $self->{$key} ? $self->{$key} : $self->fetch_string($key); +} + +ENDOFEND + +$heavy_txt .= <<'ENDOFEND'; + +my $prevpos = 0; + sub FIRSTKEY { $prevpos = 0; - my $key; - ($key) = $config_sh =~ m/^(.*)=/; - $key; + substr($Config_SH_expanded, 1, index($Config_SH_expanded, '=') - 1 ); } sub NEXTKEY { - my ($pos, $len); - $pos = $prevpos; - $pos = index( $config_sh, "\n", $pos) + 1; +ENDOFEND +if ($seen_quotes{'"'}) { +$heavy_txt .= <<'ENDOFEND'; + # Find out how the current key's quoted so we can skip to its end. + my $quote = substr($Config_SH_expanded, + index($Config_SH_expanded, "=", $prevpos)+1, 1); + my $pos = index($Config_SH_expanded, qq($quote\n), $prevpos) + 2; +ENDOFEND +} else { + # Just ' quotes, so it's much easier. +$heavy_txt .= <<'ENDOFEND'; + my $pos = index($Config_SH_expanded, qq('\n), $prevpos) + 2; +ENDOFEND +} +$heavy_txt .= <<'ENDOFEND'; + my $len = index($Config_SH_expanded, "=", $pos) - $pos; $prevpos = $pos; - $len = index( $config_sh, "=", $pos) - $pos; - $len > 0 ? substr( $config_sh, $pos, $len) : undef; + $len > 0 ? substr($Config_SH_expanded, $pos, $len) : undef; +} + +sub EXISTS { + return 1 if exists($_[0]->{$_[1]}); + + return(index($Config_SH_expanded, "\n$_[1]='") != -1 +ENDOFEND +if ($seen_quotes{'"'}) { +$heavy_txt .= <<'ENDOFEND'; + or index($Config_SH_expanded, "\n$_[1]=\"") != -1 +ENDOFEND +} +$heavy_txt .= <<'ENDOFEND'; + ); } -sub EXISTS{ - exists($_[0]->{$_[1]}) or $config_sh =~ m/^$_[1]=/m; +sub STORE { die "\%Config::Config is read-only\n" } +*DELETE = *CLEAR = \*STORE; # Typeglob aliasing uses less space + +sub config_sh { + substr $Config_SH_expanded, 1, $config_sh_len; } -sub readonly { die "\%Config::Config is read-only\n" } +sub config_re { + my $re = shift; + return map { chomp; $_ } grep eval{ /^(?:$re)=/ }, split /^/, + $Config_SH_expanded; +} -sub STORE { &readonly } -sub DELETE{ &readonly } -sub CLEAR { &readonly } +sub config_vars { + # implements -V:cfgvar option (see perlrun -V:) + foreach (@_) { + # find optional leading, trailing colons; and query-spec + my ($notag,$qry,$lncont) = m/^(:)?(.*?)(:)?$/; # flags fore and aft, + # map colon-flags to print decorations + my $prfx = $notag ? '': "$qry="; # tag-prefix for print + my $lnend = $lncont ? ' ' : ";\n"; # line ending for print + # all config-vars are by definition \w only, any \W means regex + if ($qry =~ /\W/) { + my @matches = config_re($qry); + print map "$_$lnend", @matches ? @matches : "$qry: not found" if !$notag; + print map { s/\w+=//; "$_$lnend" } @matches ? @matches : "$qry: not found" if $notag; + } else { + my $v = (exists $Config::Config{$qry}) ? $Config::Config{$qry} + : 'UNKNOWN'; + $v = 'undef' unless defined $v; + print "${prfx}'${v}'$lnend"; + } + } +} + +# Called by the real AUTOLOAD +sub launcher { + undef &AUTOLOAD; + goto \&$Config::AUTOLOAD; +} 1; ENDOFEND -close(CONFIG); +if ($^O eq 'os2') { + $config_txt .= <<'ENDOFSET'; +my %preconfig; +if ($OS2::is_aout) { + my ($value, $v) = $Config_SH_expanded =~ m/^used_aout='(.*)'\s*$/m; + for (split ' ', $value) { + ($v) = $Config_SH_expanded =~ m/^aout_$_='(.*)'\s*$/m; + $preconfig{$_} = $v eq 'undef' ? undef : $v; + } +} +$preconfig{d_fork} = undef unless $OS2::can_fork; # Some funny cases can't +sub TIEHASH { bless {%preconfig} } +ENDOFSET + # Extract the name of the DLL from the makefile to avoid duplication + my ($f) = grep -r, qw(GNUMakefile Makefile); + my $dll; + if (open my $fh, '<', $f) { + while (<$fh>) { + $dll = $1, last if /^PERL_DLL_BASE\s*=\s*(\S*)\s*$/; + } + } + $config_txt .= < ? + my $qkey = $key =~ /^[A-Za-z_][A-Za-z0-9_]*$/ ? $key : "'$key'"; + if (defined $value) { + # Quote things for a '' string + $value =~ s!\\!\\\\!g; + $value =~ s!'!\\'!g; + $value = "'$value'"; + if ($key eq 'otherlibdirs') { + $value = "join (':', map {relocate_inc(\$_)} split (':', $value))"; + } elsif ($need_relocation{$key}) { + $value = "relocate_inc($value)"; + } + } else { + $value = "undef"; + } + $Common{$key} = "$qkey => $value"; +} + +if ($Common{byteorder}) { + $Common{byteorder} = 'byteorder => $byteorder'; +} +my $fast_config = join '', map { " $_,\n" } sort values %Common; + +# Sanity check needed to stop an infinite loop if Config_heavy.pl fails to +# define &launcher for some reason (eg it got truncated) +$config_txt .= sprintf <<'ENDOFTIE', $fast_config; + +sub DESTROY { } + +sub AUTOLOAD { + require 'Config_heavy.pl'; + goto \&launcher unless $Config::AUTOLOAD =~ /launcher$/; + die "&Config::AUTOLOAD failed on $Config::AUTOLOAD"; +} + +# tie returns the object, so the value returned to require will be true. +tie %%Config, 'Config', { +%s}; +ENDOFTIE + + +open(CONFIG_POD, '>', $Config_POD) or die "Can't open $Config_POD: $!"; +print CONFIG_POD <<'ENDOFTAIL'; +=head1 NAME + +=for comment Generated by configpm. Any changes made here will be lost! + +Config - access Perl configuration information + +=head1 SYNOPSIS + + use Config; + if ($Config{usethreads}) { + print "has thread support\n" + } + + use Config qw(myconfig config_sh config_vars config_re); + + print myconfig(); + + print config_sh(); + + print config_re(); + + config_vars(qw(osname archname)); + + +=head1 DESCRIPTION + +The Config module contains all the information that was available to +the C program at Perl build time (over 900 values). + +Shell variables from the F file (written by Configure) are +stored in the readonly-variable C<%Config>, indexed by their names. + +Values stored in config.sh as 'undef' are returned as undefined +values. The perl C function can be used to check if a +named variable exists. + +For a description of the variables, please have a look at the +Glossary file, as written in the Porting folder, or use the url: +https://github.com/Perl/perl5/blob/blead/Porting/Glossary + +=over 4 + +=item myconfig() + +Returns a textual summary of the major perl configuration values. +See also C<-V> in L. + +=item config_sh() + +Returns the entire perl configuration information in the form of the +original config.sh shell variable assignment script. + +=item config_re($regex) + +Like config_sh() but returns, as a list, only the config entries who's +names match the $regex. + +=item config_vars(@names) + +Prints to STDOUT the values of the named configuration variable. Each is +printed on a separate line in the form: + + name='value'; + +Names which are unknown are output as C. +See also C<-V:name> in L. + +=item bincompat_options() + +Returns a list of C pre-processor options used when compiling this F +binary, which affect its binary compatibility with extensions. +C and C are shown together in +the output of C as I. + +=item non_bincompat_options() + +Returns a list of C pre-processor options used when compiling this F +binary, which do not affect binary compatibility with extensions. + +=item compile_date() + +Returns the compile date (as a string), equivalent to what is shown by +C + +=item local_patches() + +Returns a list of the names of locally applied patches, equivalent to what +is shown by C. + +=item header_files() + +Returns a list of the header files that should be used as dependencies for +XS code, for this version of Perl on this platform. + +=back + +=head1 EXAMPLE + +Here's a more sophisticated example of using %Config: + + use Config; + use strict; + + my %sig_num; + my @sig_name; + unless($Config{sig_name} && $Config{sig_num}) { + die "No sigs?"; + } else { + my @names = split ' ', $Config{sig_name}; + @sig_num{@names} = split ' ', $Config{sig_num}; + foreach (@names) { + $sig_name[$sig_num{$_}] ||= $_; + } + } + + print "signal #17 = $sig_name[17]\n"; + if ($sig_num{ALRM}) { + print "SIGALRM is $sig_num{ALRM}\n"; + } + +=head1 WARNING + +Because this information is not stored within the perl executable +itself it is possible (but unlikely) that the information does not +relate to the actual perl binary which is being used to access it. + +The Config module is installed into the architecture and version +specific library directory ($Config{installarchlib}) and it checks the +perl version number when loaded. + +The values stored in config.sh may be either single-quoted or +double-quoted. Double-quoted strings are handy for those cases where you +need to include escape sequences in the strings. To avoid runtime variable +interpolation, any C<$> and C<@> characters are replaced by C<\$> and +C<\@>, respectively. This isn't foolproof, of course, so don't embed C<\$> +or C<\@> in double-quoted strings unless you're willing to deal with the +consequences. (The slashes will end up escaped and the C<$> or C<@> will +trigger variable interpolation) + +=head1 GLOSSARY + +Most C variables are determined by the C script +on platforms supported by it (which is most UNIX platforms). Some +platforms have custom-made C variables, and may thus not have +some of the variables described below, or may have extraneous variables +specific to that particular port. See the port specific documentation +in such cases. + +=cut + +ENDOFTAIL + +if ($Opts{glossary}) { + open(GLOS, '<', $Glossary) or die "Can't open $Glossary: $!"; +} +my %seen = (); +my $text = 0; +$/ = ''; +my $errors= 0; + +sub process { + if (s/\A(\w*)\s+\(([\w.]+)\):\s*\n(\t?)/=item C<$1>\n\nFrom F<$2>:\n\n/m) { + my $c = substr $1, 0, 1; + unless ($seen{$c}++) { + print CONFIG_POD < new paragraph + s/^(? text + s{([\'\"])(?=[^\'\"\s]*[./][^\'\"\s]*\1)([^\'\"\s]+)\1}(F<$2>)g; # '.o' + s{([\'\"])([^\'\"\s]+)\1}(C<$2>)g; # "date" command + s{\'([A-Za-z_\- *=/]+)\'}(C<$1>)g; # 'ln -s' + s{ + (?)xg; # /usr/local + s/((?<=\s)~\w*)/F<$1>/g; # ~name + s/(?/g; # UNISTD + s/(? macro/g; # FILE_cnt macro + s/n[\0]t/n't/g; # undo can't, won't damage +} + +if ($Opts{glossary}) { + ; # Skip the "DO NOT EDIT" + ; # Skip the preamble + while () { + process; + print CONFIG_POD; + } + if ($errors) { + die "Errors encountered while processing $Glossary. ", + "Header lines are expected to be of the form:\n", + "NAME (CLASS):\n", + "Maybe there is a malformed header?\n", + ; + } +} + +print CONFIG_POD <<'ENDOFTAIL'; + +=back + +=head1 GIT DATA + +Information on the git commit from which the current perl binary was compiled +can be found in the variable C<$Config::Git_Data>. The variable is a +structured string that looks something like this: + + git_commit_id='ea0c2dbd5f5ac6845ecc7ec6696415bf8e27bd52' + git_describe='GitLive-blead-1076-gea0c2db' + git_branch='smartmatch' + git_uncommitted_changes='' + git_commit_id_title='Commit id:' + git_commit_date='2009-05-09 17:47:31 +0200' + +Its format is not guaranteed not to change over time. + +=head1 NOTE + +This module contains a good example of how to use tie to implement a +cache and an example of how to make a tied variable readonly to those +outside of it. + +=cut + +ENDOFTAIL + +close(GLOS) if $Opts{glossary}; +close(CONFIG_POD); +print "written $Config_POD\n"; + +my $orig_config_txt = ""; +my $orig_heavy_txt = ""; +{ + local $/; + my $fh; + $orig_config_txt = <$fh> if open $fh, "<", $Config_PM; + $orig_heavy_txt = <$fh> if open $fh, "<", $Config_heavy; +} + +if ($orig_config_txt ne $config_txt or $orig_heavy_txt ne $heavy_txt) { + open CONFIG, ">", $Config_PM or die "Can't open $Config_PM: $!\n"; + open CONFIG_HEAVY, ">", $Config_heavy or die "Can't open $Config_heavy: $!\n"; + print CONFIG $config_txt; + print CONFIG_HEAVY $heavy_txt; + close(CONFIG_HEAVY); + close(CONFIG); + print "updated $Config_PM\n"; + print "updated $Config_heavy\n"; +} # Now do some simple tests on the Config.pm file we have created unshift(@INC,'lib'); -require $config_pm; +require $Config_PM; +require $Config_heavy; import Config; -die "$0: $config_pm not valid" - unless $Config{'CONFIG'} eq 'true'; +die "$0: $Config_PM not valid" + unless $Config{'PERL_CONFIG_SH'} eq 'true'; -die "$0: error processing $config_pm" +die "$0: error processing $Config_PM" if defined($Config{'an impossible name'}) - or $Config{'CONFIG'} ne 'true' # test cache + or $Config{'PERL_CONFIG_SH'} ne 'true' # test cache ; -die "$0: error processing $config_pm" +die "$0: error processing $Config_PM" if eval '$Config{"cc"} = 1' or eval 'delete $Config{"cc"}' ; exit 0; +# Popularity of various entries in %Config, based on a large build and test +# run of code in the Fotango build system: +__DATA__ +path_sep: 8490 +d_readlink: 7101 +d_symlink: 7101 +archlibexp: 4318 +sitearchexp: 4305 +sitelibexp: 4305 +privlibexp: 4163 +ldlibpthname: 4041 +libpth: 2134 +archname: 1591 +exe_ext: 1256 +scriptdir: 1155 +version: 1116 +useithreads: 1002 +osvers: 982 +osname: 851 +inc_version_list: 783 +dont_use_nlink: 779 +intsize: 759 +usevendorprefix: 642 +dlsrc: 624 +cc: 541 +lib_ext: 520 +so: 512 +ld: 501 +ccdlflags: 500 +ldflags: 495 +obj_ext: 495 +cccdlflags: 493 +lddlflags: 493 +ar: 492 +dlext: 492 +libc: 492 +ranlib: 492 +full_ar: 491 +vendorarchexp: 491 +vendorlibexp: 491 +installman1dir: 489 +installman3dir: 489 +installsitebin: 489 +installsiteman1dir: 489 +installsiteman3dir: 489 +installvendorman1dir: 489 +installvendorman3dir: 489 +d_flexfnam: 474 +eunicefix: 360 +d_link: 347 +installsitearch: 344 +installscript: 341 +installprivlib: 337 +binexp: 336 +installarchlib: 336 +installprefixexp: 336 +installsitelib: 336 +installstyle: 336 +installvendorarch: 336 +installvendorbin: 336 +installvendorlib: 336 +man1ext: 336 +man3ext: 336 +sh: 336 +siteprefixexp: 336 +installbin: 335 +usedl: 332 +ccflags: 285 +startperl: 232 +optimize: 231 +usemymalloc: 229 +cpprun: 228 +sharpbang: 228 +perllibs: 225 +usesfio: 224 +usethreads: 220 +perlpath: 218 +extensions: 217 +usesocks: 208 +shellflags: 198 +make: 191 +d_pwage: 189 +d_pwchange: 189 +d_pwclass: 189 +d_pwcomment: 189 +d_pwexpire: 189 +d_pwgecos: 189 +d_pwpasswd: 189 +d_pwquota: 189 +gccversion: 189 +libs: 186 +useshrplib: 186 +cppflags: 185 +ptrsize: 185 +shrpenv: 185 +static_ext: 185 +uselargefiles: 185 +alignbytes: 184 +byteorder: 184 +ccversion: 184 +config_args: 184 +cppminus: 184