3 # commonly used names to put first (and hence lookup fastest)
4 my %Common = map {($_,$_)}
5 qw(archname osname osvers prefix libs libpth
6 dynamic_ext static_ext dlsrc so
8 privlibexp archlibexp installprivlib installarchlib
9 sharpbang startsh shsharp
12 # names of things which may need to have slashes changed to double-colons
13 my %Extensions = map {($_,$_)}
14 qw(dynamic_ext static_ext extensions known_extensions);
16 # allowed opts as well as specifies default and initial values
18 'cross' => '', # --cross=PALTFORM - crosscompiling for PLATFORM
19 'glossary' => 1, # --no-glossary - no glossary file inclusion,
24 # user specified options
27 (map {/^--([\-_\w]+)=(.*)$/} @ARGV),
28 # --opt --no-opt --noopt
29 (map {/^no-?(.*)$/i?($1=>0):($_=>1)} map {/^--([\-_\w]+)$/} @ARGV),
32 my %opts = (%Allowed_Opts, %given_opts);
34 for my $opt (grep {!exists $Allowed_Opts{$_}} keys %given_opts) {
35 die "option '$opt' is not recognized";
37 @ARGV = grep {!/^--/} @ARGV;
46 my $Glossary = $ARGV[1] || ($^O eq 'MacOS' ? '::Porting:Glossary' : 'Porting/Glossary');
49 # creating cross-platform config file
51 mkdir "xlib/$Opts{cross}";
52 $Config_PM = $ARGV[0] || "xlib/$Opts{cross}/Config.pm";
55 $Config_PM = $ARGV[0] || ($^O eq 'MacOS' ? ':lib:Config.pm' : 'lib/Config.pm');
59 open CONFIG, ">$Config_PM" or die "Can't open $Config_PM: $!\n";
61 my $myver = sprintf "v%vd", $^V;
63 printf CONFIG <<'ENDOFBEG', ($myver) x 3;
64 # This file was created by configpm when Perl was built. Any changes
65 # made to this file will be lost the next time perl is built.
68 @EXPORT = qw(%%Config);
69 @EXPORT_OK = qw(myconfig config_sh config_vars config_re);
71 my %%Export_Cache = map {($_ => 1)} (@EXPORT, @EXPORT_OK);
73 # Define our own import method to avoid pulling in the full Exporter:
76 @_ = @EXPORT unless @_;
78 my @funcs = grep $_ ne '%%Config', @_;
79 my $export_Config = @funcs < @_ ? 1 : 0;
81 my $callpkg = caller(0);
82 foreach my $func (@funcs) {
83 die sprintf qq{"%%s" is not exported by the %%s module\n},
84 $func, __PACKAGE__ unless $Export_Cache{$func};
85 *{$callpkg.'::'.$func} = \&{$func};
88 *{"$callpkg\::Config"} = \%%Config if $export_Config;
92 die "Perl lib version (%s) doesn't match executable version ($])"
96 or die "Perl lib version (%s) doesn't match executable version (" .
97 sprintf("v%%vd",$^V) . ")";
109 # This is somewhat grim, but I want the code for parsing config.sh here and
110 # now so that I can expand $Config{ivsize} and $Config{ivtype}
112 my $fetch_string = <<'EOT';
114 # Search for it in the big string
116 my($self, $key) = @_;
118 my $quote_type = "'";
119 my $marker = "$key=";
121 # Check for the common case, ' delimited
122 my $start = index($Config_SH, "\n$marker$quote_type");
123 # If that failed, check for " delimited
126 $start = index($Config_SH, "\n$marker$quote_type");
128 return undef if ( ($start == -1) && # in case it's first
129 (substr($Config_SH, 0, length($marker)) ne $marker) );
131 # It's the very first thing we found. Skip $start forward
132 # and figure out the quote mark after the =.
133 $start = length($marker) + 1;
134 $quote_type = substr($Config_SH, $start - 1, 1);
137 $start += length($marker) + 2;
140 my $value = substr($Config_SH, $start,
141 index($Config_SH, "$quote_type\n", $start) - $start);
143 # If we had a double-quote, we'd better eval it so escape
144 # sequences and such can be interpolated. Since the incoming
145 # value is supposed to follow shell rules and not perl rules,
146 # we escape any perl variable markers
147 if ($quote_type eq '"') {
148 $value =~ s/\$/\\\$/g;
149 $value =~ s/\@/\\\@/g;
150 eval "\$value = \"$value\"";
153 # So we can say "if $Config{'foo'}".
154 $value = undef if $value eq 'undef';
155 $self->{$key} = $value; # cache it
162 open(CONFIG_SH, 'config.sh') || die "Can't open config.sh: $!";
163 while (<CONFIG_SH>) {
164 next if m:^#!/bin/sh:;
166 # Catch PERL_CONFIG_SH=true and PERL_VERSION=n line from Configure.
167 s/^(\w+)=(true|\d+)\s*$/$1='$2'\n/ or m/^(\w+)='(.*)'$/;
168 my($k, $v) = ($1, $2);
170 # grandfather PATCHLEVEL and SUBVERSION and CONFIG
172 if ($k eq 'PERL_VERSION') {
173 push @v_others, "PATCHLEVEL='$v'\n";
175 elsif ($k eq 'PERL_SUBVERSION') {
176 push @v_others, "SUBVERSION='$v'\n";
178 elsif ($k eq 'PERL_CONFIG_SH') {
179 push @v_others, "CONFIG='$v'\n";
183 # We can delimit things in config.sh with either ' or ".
184 unless ($in_v or m/^(\w+)=(['"])(.*\n)/){
185 push(@non_v, "#$_"); # not a name='value' line
193 ($name,$val) = ($1,$3);
195 $in_v = $val !~ /$quote\n/;
198 s,/,::,g if $Extensions{$name};
200 $val =~ s/$quote\n?\z//;
202 my $line = "$name=$quote$val$quote\n";
203 if (!$Common{$name}){
204 push(@v_others, $line);
207 push(@v_fast, $line);
208 $v_fast{$name} = "'$name' => $quote$val$quote";
213 print CONFIG @non_v, "\n";
215 # copy config summary format from the myconfig.SH script
216 print CONFIG "my \$summary = <<'!END!';\n";
218 open(MYCONFIG, ($^O eq 'MacOS' ? "<::myconfig.SH" : "<myconfig.SH"))
219 || die "open myconfig.SH failed: $!";
220 1 while defined($_ = <MYCONFIG>) && !/^Summary of/;
221 do { print CONFIG $_ } until !defined($_ = <MYCONFIG>) || /^\s*$/;
224 print CONFIG "\n!END!\n", <<'EOT';
225 my $summary_expanded = 0;
228 return $summary if $summary_expanded;
229 $summary =~ s{\$(\w+)}
230 { my $c = $Config{$1}; defined($c) ? $c : 'undef' }ge;
231 $summary_expanded = 1;
235 our $Config_SH : unique = <<'!END!';
238 print CONFIG join("", @v_fast, sort @v_others);
240 print CONFIG "!END!\n", $fetch_string;
242 print CONFIG <<'ENDOFEND';
245 my($self, $key) = @_;
249 if ($key =~ /^((?:cc|ld)flags|libs(?:wanted)?)_nolargefiles/) {
250 # These are purely virtual, they do not exist, but need to
251 # be computed on demand for largefile-incapable extensions.
252 my $new_key = "${1}_uselargefiles";
253 $value = $Config{$1};
254 my $withlargefiles = $Config{$new_key};
255 if ($new_key =~ /^(?:cc|ld)flags_/) {
256 $value =~ s/\Q$withlargefiles\E\b//;
257 } elsif ($new_key =~ /^libs/) {
258 my @lflibswanted = split(' ', $Config{libswanted_uselargefiles});
261 @lflibswanted{@lflibswanted} = ();
262 if ($new_key =~ /^libs_/) {
263 my @libs = grep { /^-l(.+)/ &&
264 not exists $lflibswanted{$1} }
265 split(' ', $Config{libs});
266 $Config{libs} = join(' ', @libs);
267 } elsif ($new_key =~ /^libswanted_/) {
268 my @libswanted = grep { not exists $lflibswanted{$_} }
269 split(' ', $Config{libswanted});
270 $Config{libswanted} = join(' ', @libswanted);
276 $self->{$key} = $value;
280 my($self, $key) = @_;
282 # check for cached value (which may be undef so we use exists not defined)
283 return $self->{$key} if exists $self->{$key};
285 $self->fetch_string($key);
286 return $self->{$key} if exists $self->{$key};
287 $self->fetch_virtual($key);
289 # Might not exist, in which undef is correct.
290 return $self->{$key};
297 substr($Config_SH, 0, index($Config_SH, '=') );
301 # Find out how the current key's quoted so we can skip to its end.
302 my $quote = substr($Config_SH, index($Config_SH, "=", $prevpos)+1, 1);
303 my $pos = index($Config_SH, qq($quote\n), $prevpos) + 2;
304 my $len = index($Config_SH, "=", $pos) - $pos;
306 $len > 0 ? substr($Config_SH, $pos, $len) : undef;
310 return 1 if exists($_[0]->{$_[1]});
312 return(index($Config_SH, "\n$_[1]='") != -1 or
313 substr($Config_SH, 0, length($_[1])+2) eq "$_[1]='" or
314 index($Config_SH, "\n$_[1]=\"") != -1 or
315 substr($Config_SH, 0, length($_[1])+2) eq "$_[1]=\"" or
316 $_[1] =~ /^(?:(?:cc|ld)flags|libs(?:wanted)?)_nolargefiles$/
320 sub STORE { die "\%Config::Config is read-only\n" }
331 return map { chomp; $_ } grep /^$re=/, split /^/, $Config_SH;
337 my @matches = config_re($_);
338 print map "$_\n", @matches ? @matches : "$_: not found";
340 my $v = (exists $Config{$_}) ? $Config{$_} : 'UNKNOWN';
341 $v = 'undef' unless defined $v;
350 print CONFIG <<'ENDOFSET';
353 my ($value, $v) = $Config_SH =~ m/^used_aout='(.*)'\s*$/m;
354 for (split ' ', $value) {
355 ($v) = $Config_SH =~ m/^aout_$_='(.*)'\s*$/m;
356 $preconfig{$_} = $v eq 'undef' ? undef : $v;
359 $preconfig{d_fork} = undef unless $OS2::can_fork; # Some funny cases can't
360 sub TIEHASH { bless {%preconfig} }
362 # Extract the name of the DLL from the makefile to avoid duplication
363 my ($f) = grep -r, qw(GNUMakefile Makefile);
365 if (open my $fh, '<', $f) {
367 $dll = $1, last if /^PERL_DLL_BASE\s*=\s*(\S*)\s*$/;
370 print CONFIG <<ENDOFSET if $dll;
371 \$preconfig{dll_name} = '$dll';
373 } elsif ($^O eq 'MacOS') {
374 print CONFIG <<'ENDOFSET';
378 my $inst = ($ENV{MACPERL} || "") . "site_perl:";
379 my $arch = $MacPerl::Architecture || "";
380 my $cc = $MacPerl::Compiler || "";
383 installsitelib => $inst,
384 installsitearch => "$inst$arch:",
391 sub TIEHASH { bless { %preconfig } }
394 print CONFIG <<'ENDOFSET';
402 # Calculation for the keys for byteorder
403 # This is somewhat grim, but I need to run fetch_string here.
404 our $Config_SH = join "\n", @v_fast, @v_others;
406 my $t = fetch_string ({}, 'ivtype');
407 my $s = fetch_string ({}, 'ivsize');
409 # byteorder does exist on its own but we overlay a virtual
410 # dynamically recomputed value.
412 # However, ivtype and ivsize will not vary for sane fat binaries
414 my $f = $t eq 'long' ? 'L!' : $s == 8 ? 'Q': 'I';
417 if ($s == 4 || $s == 8) {
418 my $list = join ',', reverse(2..$s);
420 $byteorder_code = <<"EOT";
422 foreach my \$c ($list) { \$i |= ord(\$c); \$i <<= 8 }
424 my \$value = join('', unpack('$format', pack('$f', \$i)));
427 $byteorder_code = "\$value = '?'x$s;\n";
430 my $fast_config = join '', map { " $_,\n" }
431 values (%v_fast), 'byteorder => $value' ;
433 print CONFIG sprintf <<'ENDOFTIE', $byteorder_code, $fast_config;
435 # avoid Config..Exporter..UNIVERSAL search for DESTROY then AUTOLOAD
440 tie %%Config, 'Config', {
448 my $podfile = $^O eq 'MacOS' ? '::lib:Config.pod' : 'lib/Config.pod';
449 open(CONFIG_POD, ">$podfile") or die "Can't open $podfile: $!";
450 print CONFIG_POD <<'ENDOFTAIL';
453 Config - access Perl configuration information
458 if ($Config{'cc'} =~ /gcc/) {
459 print "built by gcc\n";
462 use Config qw(myconfig config_sh config_vars config_re);
470 config_vars(qw(osname archname));
475 The Config module contains all the information that was available to
476 the C<Configure> program at Perl build time (over 900 values).
478 Shell variables from the F<config.sh> file (written by Configure) are
479 stored in the readonly-variable C<%Config>, indexed by their names.
481 Values stored in config.sh as 'undef' are returned as undefined
482 values. The perl C<exists> function can be used to check if a
483 named variable exists.
489 Returns a textual summary of the major perl configuration values.
490 See also C<-V> in L<perlrun/Switches>.
494 Returns the entire perl configuration information in the form of the
495 original config.sh shell variable assignment script.
497 =item config_re($regex)
499 Like config_sh() but returns, as a list, only the config entries who's
500 names match the $regex.
502 =item config_vars(@names)
504 Prints to STDOUT the values of the named configuration variable. Each is
505 printed on a separate line in the form:
509 Names which are unknown are output as C<name='UNKNOWN';>.
510 See also C<-V:name> in L<perlrun/Switches>.
516 Here's a more sophisticated example of using %Config:
523 unless($Config{sig_name} && $Config{sig_num}) {
526 my @names = split ' ', $Config{sig_name};
527 @sig_num{@names} = split ' ', $Config{sig_num};
529 $sig_name[$sig_num{$_}] ||= $_;
533 print "signal #17 = $sig_name[17]\n";
534 if ($sig_num{ALRM}) {
535 print "SIGALRM is $sig_num{ALRM}\n";
540 Because this information is not stored within the perl executable
541 itself it is possible (but unlikely) that the information does not
542 relate to the actual perl binary which is being used to access it.
544 The Config module is installed into the architecture and version
545 specific library directory ($Config{installarchlib}) and it checks the
546 perl version number when loaded.
548 The values stored in config.sh may be either single-quoted or
549 double-quoted. Double-quoted strings are handy for those cases where you
550 need to include escape sequences in the strings. To avoid runtime variable
551 interpolation, any C<$> and C<@> characters are replaced by C<\$> and
552 C<\@>, respectively. This isn't foolproof, of course, so don't embed C<\$>
553 or C<\@> in double-quoted strings unless you're willing to deal with the
554 consequences. (The slashes will end up escaped and the C<$> or C<@> will
555 trigger variable interpolation)
559 Most C<Config> variables are determined by the C<Configure> script
560 on platforms supported by it (which is most UNIX platforms). Some
561 platforms have custom-made C<Config> variables, and may thus not have
562 some of the variables described below, or may have extraneous variables
563 specific to that particular port. See the port specific documentation
568 if ($Opts{glossary}) {
569 open(GLOS, "<$Glossary") or die "Can't open $Glossary: $!";
576 if (s/\A(\w*)\s+\(([\w.]+)\):\s*\n(\t?)/=item C<$1>\n\nFrom F<$2>:\n\n/m) {
577 my $c = substr $1, 0, 1;
578 unless ($seen{$c}++) {
579 print CONFIG_POD <<EOF if $text;
583 print CONFIG_POD <<EOF;
592 elsif (!$text || !/\A\t/) {
593 warn "Expected a Configure variable header",
594 ($text ? " or another paragraph of description" : () );
596 s/n't/n\00t/g; # leave can't, won't etc untouched
597 s/^\t\s+(.*)/\n$1/gm; # Indented lines ===> new paragraph
598 s/^(?<!\n\n)\t(.*)/$1/gm; # Not indented lines ===> text
599 s{([\'\"])(?=[^\'\"\s]*[./][^\'\"\s]*\1)([^\'\"\s]+)\1}(F<$2>)g; # '.o'
600 s{([\'\"])([^\'\"\s]+)\1}(C<$2>)g; # "date" command
601 s{\'([A-Za-z_\- *=/]+)\'}(C<$1>)g; # 'ln -s'
603 (?<! [\w./<\'\"] ) # Only standalone file names
604 (?! e \. g \. ) # Not e.g.
605 (?! \. \. \. ) # Not ...
607 (?! read/ ) # Not read/write
608 (?! etc\. ) # Not etc.
611 \$ ? # Allow leading $
612 [\w./]* [./] [\w./]* # Require . or / inside
614 (?<! \. (?= [\s)] ) ) # Do not include trailing dot
615 (?! [\w/] ) # Include all of it
617 (F<$1>)xg; # /usr/local
618 s/((?<=\s)~\w*)/F<$1>/g; # ~name
619 s/(?<![.<\'\"])\b([A-Z_]{2,})\b(?![\'\"])/C<$1>/g; # UNISTD
620 s/(?<![.<\'\"])\b(?!the\b)(\w+)\s+macro\b/C<$1> macro/g; # FILE_cnt macro
621 s/n[\0]t/n't/g; # undo can't, won't damage
624 if ($Opts{glossary}) {
625 <GLOS>; # Skip the "DO NOT EDIT"
626 <GLOS>; # Skip the preamble
633 print CONFIG_POD <<'ENDOFTAIL';
639 This module contains a good example of how to use tie to implement a
640 cache and an example of how to make a tied variable readonly to those
651 # Now create Cross.pm if needed
653 open CROSS, ">lib/Cross.pm" or die "Can not open >lib/Cross.pm: $!";
655 # typical invocation:
656 # perl -MCross Makefile.PL
657 # perl -MCross=wince -V:cc
661 my ($package,$platform) = @_;
662 unless (defined $platform) {
663 # if $platform is not specified, then use last one when
664 # 'configpm; was invoked with --cross option
665 $platform = '***replace-marker***';
667 @INC = map {/\blib\b/?(do{local $_=$_;s/\blib\b/xlib\/$platform/;$_},$_):($_)} @INC;
668 $::Cross::platform = $platform;
673 $cross =~ s/\*\*\*replace-marker\*\*\*/$Opts{cross}/g;
678 # Now do some simple tests on the Config.pm file we have created
683 die "$0: $Config_PM not valid"
684 unless $Config{'PERL_CONFIG_SH'} eq 'true';
686 die "$0: error processing $Config_PM"
687 if defined($Config{'an impossible name'})
688 or $Config{'PERL_CONFIG_SH'} ne 'true' # test cache
691 die "$0: error processing $Config_PM"
692 if eval '$Config{"cc"} = 1'
693 or eval 'delete $Config{"cc"}'