#!./miniperl -w
sub
usage {
die
<<EOF }
usage: $0 [ options ]
--no-glossary don't include Porting/Glossary in lib/Config.pod
--chdir=dir change directory before writing files
EOF
our
(
%Config
,
$Config_SH_expanded
);
my
$how_many_common
= 22;
my
%Common
;
while
(
$how_many_common
--) {
$_
= <DATA>;
chomp
;
/^(\S+):\s*(\d+)$/ or
die
"Malformed line '$_'"
;
$Common
{$1} = $1;
}
$Common
{
$_
} =
$_
foreach
qw(dlext so)
;
my
%Extensions
=
map
{(
$_
,
$_
)}
qw(dynamic_ext static_ext extensions known_extensions)
;
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})
(.{1,64})\
/$1\n /gx;
my
%Allowed_Opts
= (
'glossary'
=> 1,
'chdir'
=>
''
,
);
sub
opts {
my
%given_opts
= (
(
map
{/^--([\-_\w]+)=(.*)$/}
@ARGV
),
(
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();
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
;
our
( %
%Config
,
$VERSION
);
$VERSION
=
"%s"
;
%s
@Config::EXPORT
=
qw(%%Config)
;
@Config::EXPORT_OK
=
keys
%
%Export_Cache
;
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
my
@non_v
= ();
my
@v_others
= ();
my
$in_v
= 0;
my
%Data
= ();
my
$quote
;
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
(<CONFIG_SH>) {
next
if
m:^
s/^(\w+)=(true|\d+)\s*$/$1=
'$2'
\n/ or m/^(\w+)=
'(.*)'
$/;
my
(
$k
,
$v
) = ($1, $2);
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"
;
}
}
unless
(
$in_v
or m/^(\w+)=(['"])(.*\n)/){
push
(
@non_v
,
"#$_"
); # not a name=
'value'
line
next
;
}
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;
}
my
$fetch_string
=
<<'EOT';
# Search for it in the big string
sub fetch_string {
my($self, $key) = @_;
EOT
if
(
$seen_quotes
{
'"'
}) {
$fetch_string
.=
<<'EOT';
return undef unless my ($quote_type, $value) = $Config_SH_expanded =~ /\n$key=(['"])(.*?)\1\n/s;
# 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
{
$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
}
eval
$fetch_string
;
die
if
$@;
$Config_SH_expanded
=
join
"\n"
,
''
,
@v_others
;
my
$t
= fetch_string ({},
'ivtype'
);
my
$s
= fetch_string ({},
'ivsize'
);
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
;
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
;
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"
;
$heavy_txt
.=
"our \$summary = <<'!END!';\n"
;
open
(MYCONFIG,
'<'
,
'myconfig.SH'
) ||
die
"open myconfig.SH failed: $!"
;
1
while
defined
(
$_
= <MYCONFIG>) && !/^Summary of/;
do
{
$heavy_txt
.=
$_
}
until
!
defined
(
$_
= <MYCONFIG>) || /^\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
my
%seen_var
;
$heavy_txt
.=
join
(
''
,
map
{
$_
->[-1] }
sort
{
$a
->[0] cmp
$b
->[0] }
grep
{ !
$seen_var
{
$_
->[0] }++ }
map
{
/^([^=]+)/ ? [ $1,
$_
]
: [
$_
,
$_
]
}
@v_others
,
@v_forced
) .
"!END!\n"
;
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
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;
substr($Config_SH_expanded, 1, index($Config_SH_expanded, '=') - 1 );
}
sub NEXTKEY {
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
{
$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 > 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 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 config_re {
my $re = shift;
return map { chomp; $_ } grep eval{ /^(?:$re)=/ }, split /^/,
$Config_SH_expanded;
}
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
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
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
.=
<<ENDOFSET if $dll;
\$preconfig{dll_name} = '$dll';
ENDOFSET
}
else
{
$config_txt
.=
<<'ENDOFSET';
sub TIEHASH {
bless $_[1], $_[0];
}
ENDOFSET
}
foreach
my
$key
(
keys
%Common
) {
my
$value
= fetch_string ({},
$key
);
my
$qkey
=
$key
=~ /^[A-Za-z_][A-Za-z0-9_]*$/ ?
$key
:
"'$key'"
;
if
(
defined
$value
) {
$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
;
$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,
'>:raw'
,
$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<Configure> program at Perl build time (over 900 values).
Shell variables from the F<config.sh> 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<exists> 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:
=over 4
=item myconfig()
Returns a textual summary of the major perl configuration values.
See also C<-V> in L<perlrun/Command Switches>.
=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<name='UNKNOWN';>.
See also C<-V:name> in L<perlrun/Command Switches>.
=item bincompat_options()
Returns a list of C pre-processor options used when compiling this F<perl>
binary, which affect its binary compatibility with extensions.
C<bincompat_options()> and C<non_bincompat_options()> are shown together in
the output of C<perl -V> as I<Compile-time options>.
=item non_bincompat_options()
Returns a list of C pre-processor options used when compiling this F<perl>
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<perl -V>
=item local_patches()
Returns a list of the names of locally applied patches, equivalent to what
is shown by C<perl -V>.
=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<Config> variables are determined by the C<Configure> script
on platforms supported by it (which is most UNIX platforms). Some
platforms have custom-made C<Config> 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
<<EOF if $text;
=back
EOF
print
CONFIG_POD
<<EOF;
=head2 $c
=over 4
EOF
$text
= 1;
}
}
elsif
(!
$text
|| !/\A\t/) {
warn
"Expected a Configure variable header"
,
(
$text
?
" or another paragraph of description"
: () ),
", instead we got:\n$_"
;
$errors
++;
}
s/n
't/n\00t/g; # leave can'
t, won't etc untouched
s/^\t\s+(.*)/\n$1/gm;
s/^(?<!\n\n)\t(.*)/$1/gm;
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{
(?<! [\w./<\'\"\$] )
(?! e \. g \. )
(?! \. \. \. )
(?! \d )
(?!
read
/ )
(?! etc\. )
(?! I/O )
(
\$ ?
[\w./]* [./] [\w./]*
)
(?<! \. (?= [\s)] ) )
(?! [\w/] )
}
(F<$1>)xg;
s/((?<=\s)~\w*)/F<$1>/g;
s/(?<![.<\'\"])\b([A-Z_]{2,})\b(?![\'\"])/C<$1>/g;
s/(?<![.<\'\"])\b(?!the\b)(\w+)\s+macro\b/C<$1> macro/g;
s/n[\0]t/n
't/g; # undo can'
t, won't damage
}
if
(
$Opts
{glossary}) {
<GLOS>;
<GLOS>;
while
(<GLOS>) {
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"
;
}
unshift
(
@INC
,
'lib'
);
require
$Config_PM
;
require
$Config_heavy
;
import
Config;
die
"$0: $Config_PM not valid"
unless
$Config
{
'PERL_CONFIG_SH'
} eq
'true'
;
die
"$0: error processing $Config_PM"
if
defined
(
$Config
{
'an impossible name'
})
or
$Config
{
'PERL_CONFIG_SH'
} ne
'true'
;
die
"$0: error processing $Config_PM"
if
eval
'$Config{"cc"} = 1'
or
eval
'delete $Config{"cc"}'
;
exit
0;