Blame parts/inc/ppphbin

Packit 7d6a7d
################################################################################
Packit 7d6a7d
##
Packit 7d6a7d
##  Version 3.x, Copyright (C) 2004-2013, Marcus Holland-Moritz.
Packit 7d6a7d
##  Version 2.x, Copyright (C) 2001, Paul Marquess.
Packit 7d6a7d
##  Version 1.x, Copyright (C) 1999, Kenneth Albanowski.
Packit 7d6a7d
##
Packit 7d6a7d
##  This program is free software; you can redistribute it and/or
Packit 7d6a7d
##  modify it under the same terms as Perl itself.
Packit 7d6a7d
##
Packit 7d6a7d
################################################################################
Packit 7d6a7d
Packit 7d6a7d
=provides
Packit 7d6a7d
Packit 7d6a7d
=implementation
Packit 7d6a7d
Packit 7d6a7d
use strict;
Packit 7d6a7d
Packit 7d6a7d
# Disable broken TRIE-optimization
Packit 7d6a7d
BEGIN { eval '${^RE_TRIE_MAXBUF} = -1' if $] >= 5.009004 && $] <= 5.009005 }
Packit 7d6a7d
Packit 7d6a7d
my $VERSION = __VERSION__;
Packit 7d6a7d
Packit 7d6a7d
my %opt = (
Packit 7d6a7d
  quiet     => 0,
Packit 7d6a7d
  diag      => 1,
Packit 7d6a7d
  hints     => 1,
Packit 7d6a7d
  changes   => 1,
Packit 7d6a7d
  cplusplus => 0,
Packit 7d6a7d
  filter    => 1,
Packit 7d6a7d
  strip     => 0,
Packit 7d6a7d
  version   => 0,
Packit 7d6a7d
);
Packit 7d6a7d
Packit 7d6a7d
my($ppport) = $0 =~ /([\w.]+)$/;
Packit 7d6a7d
my $LF = '(?:\r\n|[\r\n])';   # line feed
Packit 7d6a7d
my $HS = "[ \t]";             # horizontal whitespace
Packit 7d6a7d
Packit 7d6a7d
# Never use C comments in this file!
Packit 7d6a7d
my $ccs  = '/'.'*';
Packit 7d6a7d
my $cce  = '*'.'/';
Packit 7d6a7d
my $rccs = quotemeta $ccs;
Packit 7d6a7d
my $rcce = quotemeta $cce;
Packit 7d6a7d
Packit 7d6a7d
eval {
Packit 7d6a7d
  require Getopt::Long;
Packit 7d6a7d
  Getopt::Long::GetOptions(\%opt, qw(
Packit 7d6a7d
    help quiet diag! filter! hints! changes! cplusplus strip version
Packit 7d6a7d
    patch=s copy=s diff=s compat-version=s
Packit 7d6a7d
    list-provided list-unsupported api-info=s
Packit 7d6a7d
  )) or usage();
Packit 7d6a7d
};
Packit 7d6a7d
Packit 7d6a7d
if ($@ and grep /^-/, @ARGV) {
Packit 7d6a7d
  usage() if "@ARGV" =~ /^--?h(?:elp)?$/;
Packit 7d6a7d
  die "Getopt::Long not found. Please don't use any options.\n";
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
if ($opt{version}) {
Packit 7d6a7d
  print "This is $0 $VERSION.\n";
Packit 7d6a7d
  exit 0;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
usage() if $opt{help};
Packit 7d6a7d
strip() if $opt{strip};
Packit 7d6a7d
Packit 7d6a7d
if (exists $opt{'compat-version'}) {
Packit 7d6a7d
  my($r,$v,$s) = eval { parse_version($opt{'compat-version'}) };
Packit 7d6a7d
  if ($@) {
Packit 7d6a7d
    die "Invalid version number format: '$opt{'compat-version'}'\n";
Packit 7d6a7d
  }
Packit 7d6a7d
  die "Only Perl 5 is supported\n" if $r != 5;
Packit 7d6a7d
  die "Invalid version number: $opt{'compat-version'}\n" if $v >= 1000 || $s >= 1000;
Packit 7d6a7d
  $opt{'compat-version'} = sprintf "%d.%03d%03d", $r, $v, $s;
Packit 7d6a7d
}
Packit 7d6a7d
else {
Packit 7d6a7d
  $opt{'compat-version'} = 5;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
my %API = map { /^(\w+)\|([^|]*)\|([^|]*)\|(\w*)$/
Packit 7d6a7d
                ? ( $1 => {
Packit 7d6a7d
                      ($2                  ? ( base     => $2 ) : ()),
Packit 7d6a7d
                      ($3                  ? ( todo     => $3 ) : ()),
Packit 7d6a7d
                      (index($4, 'v') >= 0 ? ( varargs  => 1  ) : ()),
Packit 7d6a7d
                      (index($4, 'p') >= 0 ? ( provided => 1  ) : ()),
Packit 7d6a7d
                      (index($4, 'n') >= 0 ? ( nothxarg => 1  ) : ()),
Packit 7d6a7d
                    } )
Packit 7d6a7d
                : die "invalid spec: $_" } qw(
Packit 7d6a7d
__PERL_API__
Packit 7d6a7d
);
Packit 7d6a7d
Packit 7d6a7d
if (exists $opt{'list-unsupported'}) {
Packit 7d6a7d
  my $f;
Packit 7d6a7d
  for $f (sort { lc $a cmp lc $b } keys %API) {
Packit 7d6a7d
    next unless $API{$f}{todo};
Packit 7d6a7d
    print "$f ", '.'x(40-length($f)), " ", format_version($API{$f}{todo}), "\n";
Packit 7d6a7d
  }
Packit 7d6a7d
  exit 0;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
# Scan for possible replacement candidates
Packit 7d6a7d
Packit 7d6a7d
my(%replace, %need, %hints, %warnings, %depends);
Packit 7d6a7d
my $replace = 0;
Packit 7d6a7d
my($hint, $define, $function);
Packit 7d6a7d
Packit 7d6a7d
sub find_api
Packit 7d6a7d
{
Packit 7d6a7d
  my $code = shift;
Packit 7d6a7d
  $code =~ s{
Packit 7d6a7d
    / (?: \*[^*]*\*+(?:[^$ccs][^*]*\*+)* / | /[^\r\n]*)
Packit 7d6a7d
  | "[^"\\]*(?:\\.[^"\\]*)*"
Packit 7d6a7d
  | '[^'\\]*(?:\\.[^'\\]*)*' }{}egsx;
Packit 7d6a7d
  grep { exists $API{$_} } $code =~ /(\w+)/mg;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
while (<DATA>) {
Packit 7d6a7d
  if ($hint) {
Packit 7d6a7d
    my $h = $hint->[0] eq 'Hint' ? \%hints : \%warnings;
Packit 7d6a7d
    if (m{^\s*\*\s(.*?)\s*$}) {
Packit 7d6a7d
      for (@{$hint->[1]}) {
Packit 7d6a7d
        $h->{$_} ||= '';  # suppress warning with older perls
Packit 7d6a7d
        $h->{$_} .= "$1\n";
Packit 7d6a7d
      }
Packit 7d6a7d
    }
Packit 7d6a7d
    else { undef $hint }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  $hint = [$1, [split /,?\s+/, $2]]
Packit 7d6a7d
      if m{^\s*$rccs\s+(Hint|Warning):\s+(\w+(?:,?\s+\w+)*)\s*$};
Packit 7d6a7d
Packit 7d6a7d
  if ($define) {
Packit 7d6a7d
    if ($define->[1] =~ /\\$/) {
Packit 7d6a7d
      $define->[1] .= $_;
Packit 7d6a7d
    }
Packit 7d6a7d
    else {
Packit 7d6a7d
      if (exists $API{$define->[0]} && $define->[1] !~ /^DPPP_\(/) {
Packit 7d6a7d
        my @n = find_api($define->[1]);
Packit 7d6a7d
        push @{$depends{$define->[0]}}, @n if @n
Packit 7d6a7d
      }
Packit 7d6a7d
      undef $define;
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  $define = [$1, $2] if m{^\s*#\s*define\s+(\w+)(?:\([^)]*\))?\s+(.*)};
Packit 7d6a7d
Packit 7d6a7d
  if ($function) {
Packit 7d6a7d
    if (/^}/) {
Packit 7d6a7d
      if (exists $API{$function->[0]}) {
Packit 7d6a7d
        my @n = find_api($function->[1]);
Packit 7d6a7d
        push @{$depends{$function->[0]}}, @n if @n
Packit 7d6a7d
      }
Packit 7d6a7d
      undef $function;
Packit 7d6a7d
    }
Packit 7d6a7d
    else {
Packit 7d6a7d
      $function->[1] .= $_;
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  $function = [$1, ''] if m{^DPPP_\(my_(\w+)\)};
Packit 7d6a7d
Packit 7d6a7d
  $replace     = $1 if m{^\s*$rccs\s+Replace:\s+(\d+)\s+$rcce\s*$};
Packit 7d6a7d
  $replace{$2} = $1 if $replace and m{^\s*#\s*define\s+(\w+)(?:\([^)]*\))?\s+(\w+)};
Packit 7d6a7d
  $replace{$2} = $1 if m{^\s*#\s*define\s+(\w+)(?:\([^)]*\))?\s+(\w+).*$rccs\s+Replace\s+$rcce};
Packit 7d6a7d
  $replace{$1} = $2 if m{^\s*$rccs\s+Replace (\w+) with (\w+)\s+$rcce\s*$};
Packit 7d6a7d
Packit 7d6a7d
  if (m{^\s*$rccs\s+(\w+(\s*,\s*\w+)*)\s+depends\s+on\s+(\w+(\s*,\s*\w+)*)\s+$rcce\s*$}) {
Packit 7d6a7d
    my @deps = map { s/\s+//g; $_ } split /,/, $3;
Packit 7d6a7d
    my $d;
Packit 7d6a7d
    for $d (map { s/\s+//g; $_ } split /,/, $1) {
Packit 7d6a7d
      push @{$depends{$d}}, @deps;
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  $need{$1} = 1 if m{^#if\s+defined\(NEED_(\w+)(?:_GLOBAL)?\)};
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
for (values %depends) {
Packit 7d6a7d
  my %s;
Packit 7d6a7d
  $_ = [sort grep !$s{$_}++, @$_];
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
if (exists $opt{'api-info'}) {
Packit 7d6a7d
  my $f;
Packit 7d6a7d
  my $count = 0;
Packit 7d6a7d
  my $match = $opt{'api-info'} =~ m!^/(.*)/$! ? $1 : "^\Q$opt{'api-info'}\E\$";
Packit 7d6a7d
  for $f (sort { lc $a cmp lc $b } keys %API) {
Packit 7d6a7d
    next unless $f =~ /$match/;
Packit 7d6a7d
    print "\n=== $f ===\n\n";
Packit 7d6a7d
    my $info = 0;
Packit 7d6a7d
    if ($API{$f}{base} || $API{$f}{todo}) {
Packit 7d6a7d
      my $base = format_version($API{$f}{base} || $API{$f}{todo});
Packit 7d6a7d
      print "Supported at least starting from perl-$base.\n";
Packit 7d6a7d
      $info++;
Packit 7d6a7d
    }
Packit 7d6a7d
    if ($API{$f}{provided}) {
Packit 7d6a7d
      my $todo = $API{$f}{todo} ? format_version($API{$f}{todo}) : "__MIN_PERL__";
Packit 7d6a7d
      print "Support by $ppport provided back to perl-$todo.\n";
Packit 7d6a7d
      print "Support needs to be explicitly requested by NEED_$f.\n" if exists $need{$f};
Packit 7d6a7d
      print "Depends on: ", join(', ', @{$depends{$f}}), ".\n" if exists $depends{$f};
Packit 7d6a7d
      print "\n$hints{$f}" if exists $hints{$f};
Packit 7d6a7d
      print "\nWARNING:\n$warnings{$f}" if exists $warnings{$f};
Packit 7d6a7d
      $info++;
Packit 7d6a7d
    }
Packit 7d6a7d
    print "No portability information available.\n" unless $info;
Packit 7d6a7d
    $count++;
Packit 7d6a7d
  }
Packit 7d6a7d
  $count or print "Found no API matching '$opt{'api-info'}'.";
Packit 7d6a7d
  print "\n";
Packit 7d6a7d
  exit 0;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
if (exists $opt{'list-provided'}) {
Packit 7d6a7d
  my $f;
Packit 7d6a7d
  for $f (sort { lc $a cmp lc $b } keys %API) {
Packit 7d6a7d
    next unless $API{$f}{provided};
Packit 7d6a7d
    my @flags;
Packit 7d6a7d
    push @flags, 'explicit' if exists $need{$f};
Packit 7d6a7d
    push @flags, 'depend'   if exists $depends{$f};
Packit 7d6a7d
    push @flags, 'hint'     if exists $hints{$f};
Packit 7d6a7d
    push @flags, 'warning'  if exists $warnings{$f};
Packit 7d6a7d
    my $flags = @flags ? '  ['.join(', ', @flags).']' : '';
Packit 7d6a7d
    print "$f$flags\n";
Packit 7d6a7d
  }
Packit 7d6a7d
  exit 0;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
my @files;
Packit 7d6a7d
my @srcext = qw( .xs .c .h .cc .cpp -c.inc -xs.inc );
Packit 7d6a7d
my $srcext = join '|', map { quotemeta $_ } @srcext;
Packit 7d6a7d
Packit 7d6a7d
if (@ARGV) {
Packit 7d6a7d
  my %seen;
Packit 7d6a7d
  for (@ARGV) {
Packit 7d6a7d
    if (-e) {
Packit 7d6a7d
      if (-f) {
Packit 7d6a7d
        push @files, $_ unless $seen{$_}++;
Packit 7d6a7d
      }
Packit 7d6a7d
      else { warn "'$_' is not a file.\n" }
Packit 7d6a7d
    }
Packit 7d6a7d
    else {
Packit 7d6a7d
      my @new = grep { -f } glob $_
Packit 7d6a7d
          or warn "'$_' does not exist.\n";
Packit 7d6a7d
      push @files, grep { !$seen{$_}++ } @new;
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
}
Packit 7d6a7d
else {
Packit 7d6a7d
  eval {
Packit 7d6a7d
    require File::Find;
Packit 7d6a7d
    File::Find::find(sub {
Packit 7d6a7d
      $File::Find::name =~ /($srcext)$/i
Packit 7d6a7d
          and push @files, $File::Find::name;
Packit 7d6a7d
    }, '.');
Packit 7d6a7d
  };
Packit 7d6a7d
  if ($@) {
Packit 7d6a7d
    @files = map { glob "*$_" } @srcext;
Packit 7d6a7d
  }
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
if (!@ARGV || $opt{filter}) {
Packit 7d6a7d
  my(@in, @out);
Packit 7d6a7d
  my %xsc = map { /(.*)\.xs$/ ? ("$1.c" => 1, "$1.cc" => 1) : () } @files;
Packit 7d6a7d
  for (@files) {
Packit 7d6a7d
    my $out = exists $xsc{$_} || /\b\Q$ppport\E$/i || !/($srcext)$/i;
Packit 7d6a7d
    push @{ $out ? \@out : \@in }, $_;
Packit 7d6a7d
  }
Packit 7d6a7d
  if (@ARGV && @out) {
Packit 7d6a7d
    warning("Skipping the following files (use --nofilter to avoid this):\n| ", join "\n| ", @out);
Packit 7d6a7d
  }
Packit 7d6a7d
  @files = @in;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
die "No input files given!\n" unless @files;
Packit 7d6a7d
Packit 7d6a7d
my(%files, %global, %revreplace);
Packit 7d6a7d
%revreplace = reverse %replace;
Packit 7d6a7d
my $filename;
Packit 7d6a7d
my $patch_opened = 0;
Packit 7d6a7d
Packit 7d6a7d
for $filename (@files) {
Packit 7d6a7d
  unless (open IN, "<$filename") {
Packit 7d6a7d
    warn "Unable to read from $filename: $!\n";
Packit 7d6a7d
    next;
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  info("Scanning $filename ...");
Packit 7d6a7d
Packit 7d6a7d
  my $c = do { local $/; <IN> };
Packit 7d6a7d
  close IN;
Packit 7d6a7d
Packit 7d6a7d
  my %file = (orig => $c, changes => 0);
Packit 7d6a7d
Packit 7d6a7d
  # Temporarily remove C/XS comments and strings from the code
Packit 7d6a7d
  my @ccom;
Packit 7d6a7d
Packit 7d6a7d
  $c =~ s{
Packit 7d6a7d
    ( ^$HS*\#$HS*include\b[^\r\n]+\b(?:\Q$ppport\E|XSUB\.h)\b[^\r\n]*
Packit 7d6a7d
    | ^$HS*\#$HS*(?:define|elif|if(?:def)?)\b[^\r\n]* )
Packit 7d6a7d
  | ( ^$HS*\#[^\r\n]*
Packit 7d6a7d
    | "[^"\\]*(?:\\.[^"\\]*)*"
Packit 7d6a7d
    | '[^'\\]*(?:\\.[^'\\]*)*'
Packit 7d6a7d
    | / (?: \*[^*]*\*+(?:[^$ccs][^*]*\*+)* / | /[^\r\n]* ) )
Packit 7d6a7d
  }{ defined $2 and push @ccom, $2;
Packit 7d6a7d
     defined $1 ? $1 : "$ccs$#ccom$cce" }mgsex;
Packit 7d6a7d
Packit 7d6a7d
  $file{ccom} = \@ccom;
Packit 7d6a7d
  $file{code} = $c;
Packit 7d6a7d
  $file{has_inc_ppport} = $c =~ /^$HS*#$HS*include[^\r\n]+\b\Q$ppport\E\b/m;
Packit 7d6a7d
Packit 7d6a7d
  my $func;
Packit 7d6a7d
Packit 7d6a7d
  for $func (keys %API) {
Packit 7d6a7d
    my $match = $func;
Packit 7d6a7d
    $match .= "|$revreplace{$func}" if exists $revreplace{$func};
Packit 7d6a7d
    if ($c =~ /\b(?:Perl_)?($match)\b/) {
Packit 7d6a7d
      $file{uses_replace}{$1}++ if exists $revreplace{$func} && $1 eq $revreplace{$func};
Packit 7d6a7d
      $file{uses_Perl}{$func}++ if $c =~ /\bPerl_$func\b/;
Packit 7d6a7d
      if (exists $API{$func}{provided}) {
Packit 7d6a7d
        $file{uses_provided}{$func}++;
Packit 7d6a7d
        if (!exists $API{$func}{base} || $API{$func}{base} > $opt{'compat-version'}) {
Packit 7d6a7d
          $file{uses}{$func}++;
Packit 7d6a7d
          my @deps = rec_depend($func);
Packit 7d6a7d
          if (@deps) {
Packit 7d6a7d
            $file{uses_deps}{$func} = \@deps;
Packit 7d6a7d
            for (@deps) {
Packit 7d6a7d
              $file{uses}{$_} = 0 unless exists $file{uses}{$_};
Packit 7d6a7d
            }
Packit 7d6a7d
          }
Packit 7d6a7d
          for ($func, @deps) {
Packit 7d6a7d
            $file{needs}{$_} = 'static' if exists $need{$_};
Packit 7d6a7d
          }
Packit 7d6a7d
        }
Packit 7d6a7d
      }
Packit 7d6a7d
      if (exists $API{$func}{todo} && $API{$func}{todo} > $opt{'compat-version'}) {
Packit 7d6a7d
        if ($c =~ /\b$func\b/) {
Packit 7d6a7d
          $file{uses_todo}{$func}++;
Packit 7d6a7d
        }
Packit 7d6a7d
      }
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  while ($c =~ /^$HS*#$HS*define$HS+(NEED_(\w+?)(_GLOBAL)?)\b/mg) {
Packit 7d6a7d
    if (exists $need{$2}) {
Packit 7d6a7d
      $file{defined $3 ? 'needed_global' : 'needed_static'}{$2}++;
Packit 7d6a7d
    }
Packit 7d6a7d
    else { warning("Possibly wrong #define $1 in $filename") }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  for (qw(uses needs uses_todo needed_global needed_static)) {
Packit 7d6a7d
    for $func (keys %{$file{$_}}) {
Packit 7d6a7d
      push @{$global{$_}{$func}}, $filename;
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  $files{$filename} = \%file;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
# Globally resolve NEED_'s
Packit 7d6a7d
my $need;
Packit 7d6a7d
for $need (keys %{$global{needs}}) {
Packit 7d6a7d
  if (@{$global{needs}{$need}} > 1) {
Packit 7d6a7d
    my @targets = @{$global{needs}{$need}};
Packit 7d6a7d
    my @t = grep $files{$_}{needed_global}{$need}, @targets;
Packit 7d6a7d
    @targets = @t if @t;
Packit 7d6a7d
    @t = grep /\.xs$/i, @targets;
Packit 7d6a7d
    @targets = @t if @t;
Packit 7d6a7d
    my $target = shift @targets;
Packit 7d6a7d
    $files{$target}{needs}{$need} = 'global';
Packit 7d6a7d
    for (@{$global{needs}{$need}}) {
Packit 7d6a7d
      $files{$_}{needs}{$need} = 'extern' if $_ ne $target;
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
for $filename (@files) {
Packit 7d6a7d
  exists $files{$filename} or next;
Packit 7d6a7d
Packit 7d6a7d
  info("=== Analyzing $filename ===");
Packit 7d6a7d
Packit 7d6a7d
  my %file = %{$files{$filename}};
Packit 7d6a7d
  my $func;
Packit 7d6a7d
  my $c = $file{code};
Packit 7d6a7d
  my $warnings = 0;
Packit 7d6a7d
Packit 7d6a7d
  for $func (sort keys %{$file{uses_Perl}}) {
Packit 7d6a7d
    if ($API{$func}{varargs}) {
Packit 7d6a7d
      unless ($API{$func}{nothxarg}) {
Packit 7d6a7d
        my $changes = ($c =~ s{\b(Perl_$func\s*\(\s*)(?!aTHX_?)(\)|[^\s)]*\))}
Packit 7d6a7d
                              { $1 . ($2 eq ')' ? 'aTHX' : 'aTHX_ ') . $2 }ge);
Packit 7d6a7d
        if ($changes) {
Packit 7d6a7d
          warning("Doesn't pass interpreter argument aTHX to Perl_$func");
Packit 7d6a7d
          $file{changes} += $changes;
Packit 7d6a7d
        }
Packit 7d6a7d
      }
Packit 7d6a7d
    }
Packit 7d6a7d
    else {
Packit 7d6a7d
      warning("Uses Perl_$func instead of $func");
Packit 7d6a7d
      $file{changes} += ($c =~ s{\bPerl_$func(\s*)\((\s*aTHX_?)?\s*}
Packit 7d6a7d
                                {$func$1(}g);
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  for $func (sort keys %{$file{uses_replace}}) {
Packit 7d6a7d
    warning("Uses $func instead of $replace{$func}");
Packit 7d6a7d
    $file{changes} += ($c =~ s/\b$func\b/$replace{$func}/g);
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  for $func (sort keys %{$file{uses_provided}}) {
Packit 7d6a7d
    if ($file{uses}{$func}) {
Packit 7d6a7d
      if (exists $file{uses_deps}{$func}) {
Packit 7d6a7d
        diag("Uses $func, which depends on ", join(', ', @{$file{uses_deps}{$func}}));
Packit 7d6a7d
      }
Packit 7d6a7d
      else {
Packit 7d6a7d
        diag("Uses $func");
Packit 7d6a7d
      }
Packit 7d6a7d
    }
Packit 7d6a7d
    $warnings += hint($func);
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  unless ($opt{quiet}) {
Packit 7d6a7d
    for $func (sort keys %{$file{uses_todo}}) {
Packit 7d6a7d
      print "*** WARNING: Uses $func, which may not be portable below perl ",
Packit 7d6a7d
            format_version($API{$func}{todo}), ", even with '$ppport'\n";
Packit 7d6a7d
      $warnings++;
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  for $func (sort keys %{$file{needed_static}}) {
Packit 7d6a7d
    my $message = '';
Packit 7d6a7d
    if (not exists $file{uses}{$func}) {
Packit 7d6a7d
      $message = "No need to define NEED_$func if $func is never used";
Packit 7d6a7d
    }
Packit 7d6a7d
    elsif (exists $file{needs}{$func} && $file{needs}{$func} ne 'static') {
Packit 7d6a7d
      $message = "No need to define NEED_$func when already needed globally";
Packit 7d6a7d
    }
Packit 7d6a7d
    if ($message) {
Packit 7d6a7d
      diag($message);
Packit 7d6a7d
      $file{changes} += ($c =~ s/^$HS*#$HS*define$HS+NEED_$func\b.*$LF//mg);
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  for $func (sort keys %{$file{needed_global}}) {
Packit 7d6a7d
    my $message = '';
Packit 7d6a7d
    if (not exists $global{uses}{$func}) {
Packit 7d6a7d
      $message = "No need to define NEED_${func}_GLOBAL if $func is never used";
Packit 7d6a7d
    }
Packit 7d6a7d
    elsif (exists $file{needs}{$func}) {
Packit 7d6a7d
      if ($file{needs}{$func} eq 'extern') {
Packit 7d6a7d
        $message = "No need to define NEED_${func}_GLOBAL when already needed globally";
Packit 7d6a7d
      }
Packit 7d6a7d
      elsif ($file{needs}{$func} eq 'static') {
Packit 7d6a7d
        $message = "No need to define NEED_${func}_GLOBAL when only used in this file";
Packit 7d6a7d
      }
Packit 7d6a7d
    }
Packit 7d6a7d
    if ($message) {
Packit 7d6a7d
      diag($message);
Packit 7d6a7d
      $file{changes} += ($c =~ s/^$HS*#$HS*define$HS+NEED_${func}_GLOBAL\b.*$LF//mg);
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  $file{needs_inc_ppport} = keys %{$file{uses}};
Packit 7d6a7d
Packit 7d6a7d
  if ($file{needs_inc_ppport}) {
Packit 7d6a7d
    my $pp = '';
Packit 7d6a7d
Packit 7d6a7d
    for $func (sort keys %{$file{needs}}) {
Packit 7d6a7d
      my $type = $file{needs}{$func};
Packit 7d6a7d
      next if $type eq 'extern';
Packit 7d6a7d
      my $suffix = $type eq 'global' ? '_GLOBAL' : '';
Packit 7d6a7d
      unless (exists $file{"needed_$type"}{$func}) {
Packit 7d6a7d
        if ($type eq 'global') {
Packit 7d6a7d
          diag("Files [@{$global{needs}{$func}}] need $func, adding global request");
Packit 7d6a7d
        }
Packit 7d6a7d
        else {
Packit 7d6a7d
          diag("File needs $func, adding static request");
Packit 7d6a7d
        }
Packit 7d6a7d
        $pp .= "#define NEED_$func$suffix\n";
Packit 7d6a7d
      }
Packit 7d6a7d
    }
Packit 7d6a7d
Packit 7d6a7d
    if ($pp && ($c =~ s/^(?=$HS*#$HS*define$HS+NEED_\w+)/$pp/m)) {
Packit 7d6a7d
      $pp = '';
Packit 7d6a7d
      $file{changes}++;
Packit 7d6a7d
    }
Packit 7d6a7d
Packit 7d6a7d
    unless ($file{has_inc_ppport}) {
Packit 7d6a7d
      diag("Needs to include '$ppport'");
Packit 7d6a7d
      $pp .= qq(#include "$ppport"\n)
Packit 7d6a7d
    }
Packit 7d6a7d
Packit 7d6a7d
    if ($pp) {
Packit 7d6a7d
      $file{changes} += ($c =~ s/^($HS*#$HS*define$HS+NEED_\w+.*?)^/$1$pp/ms)
Packit 7d6a7d
                     || ($c =~ s/^(?=$HS*#$HS*include.*\Q$ppport\E)/$pp/m)
Packit 7d6a7d
                     || ($c =~ s/^($HS*#$HS*include.*XSUB.*\s*?)^/$1$pp/m)
Packit 7d6a7d
                     || ($c =~ s/^/$pp/);
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
  else {
Packit 7d6a7d
    if ($file{has_inc_ppport}) {
Packit 7d6a7d
      diag("No need to include '$ppport'");
Packit 7d6a7d
      $file{changes} += ($c =~ s/^$HS*?#$HS*include.*\Q$ppport\E.*?$LF//m);
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  # put back in our C comments
Packit 7d6a7d
  my $ix;
Packit 7d6a7d
  my $cppc = 0;
Packit 7d6a7d
  my @ccom = @{$file{ccom}};
Packit 7d6a7d
  for $ix (0 .. $#ccom) {
Packit 7d6a7d
    if (!$opt{cplusplus} && $ccom[$ix] =~ s!^//!!) {
Packit 7d6a7d
      $cppc++;
Packit 7d6a7d
      $file{changes} += $c =~ s/$rccs$ix$rcce/$ccs$ccom[$ix] $cce/;
Packit 7d6a7d
    }
Packit 7d6a7d
    else {
Packit 7d6a7d
      $c =~ s/$rccs$ix$rcce/$ccom[$ix]/;
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  if ($cppc) {
Packit 7d6a7d
    my $s = $cppc != 1 ? 's' : '';
Packit 7d6a7d
    warning("Uses $cppc C++ style comment$s, which is not portable");
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  my $s = $warnings != 1 ? 's' : '';
Packit 7d6a7d
  my $warn = $warnings ? " ($warnings warning$s)" : '';
Packit 7d6a7d
  info("Analysis completed$warn");
Packit 7d6a7d
Packit 7d6a7d
  if ($file{changes}) {
Packit 7d6a7d
    if (exists $opt{copy}) {
Packit 7d6a7d
      my $newfile = "$filename$opt{copy}";
Packit 7d6a7d
      if (-e $newfile) {
Packit 7d6a7d
        error("'$newfile' already exists, refusing to write copy of '$filename'");
Packit 7d6a7d
      }
Packit 7d6a7d
      else {
Packit 7d6a7d
        local *F;
Packit 7d6a7d
        if (open F, ">$newfile") {
Packit 7d6a7d
          info("Writing copy of '$filename' with changes to '$newfile'");
Packit 7d6a7d
          print F $c;
Packit 7d6a7d
          close F;
Packit 7d6a7d
        }
Packit 7d6a7d
        else {
Packit 7d6a7d
          error("Cannot open '$newfile' for writing: $!");
Packit 7d6a7d
        }
Packit 7d6a7d
      }
Packit 7d6a7d
    }
Packit 7d6a7d
    elsif (exists $opt{patch} || $opt{changes}) {
Packit 7d6a7d
      if (exists $opt{patch}) {
Packit 7d6a7d
        unless ($patch_opened) {
Packit 7d6a7d
          if (open PATCH, ">$opt{patch}") {
Packit 7d6a7d
            $patch_opened = 1;
Packit 7d6a7d
          }
Packit 7d6a7d
          else {
Packit 7d6a7d
            error("Cannot open '$opt{patch}' for writing: $!");
Packit 7d6a7d
            delete $opt{patch};
Packit 7d6a7d
            $opt{changes} = 1;
Packit 7d6a7d
            goto fallback;
Packit 7d6a7d
          }
Packit 7d6a7d
        }
Packit 7d6a7d
        mydiff(\*PATCH, $filename, $c);
Packit 7d6a7d
      }
Packit 7d6a7d
      else {
Packit 7d6a7d
fallback:
Packit 7d6a7d
        info("Suggested changes:");
Packit 7d6a7d
        mydiff(\*STDOUT, $filename, $c);
Packit 7d6a7d
      }
Packit 7d6a7d
    }
Packit 7d6a7d
    else {
Packit 7d6a7d
      my $s = $file{changes} == 1 ? '' : 's';
Packit 7d6a7d
      info("$file{changes} potentially required change$s detected");
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
  else {
Packit 7d6a7d
    info("Looks good");
Packit 7d6a7d
  }
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
close PATCH if $patch_opened;
Packit 7d6a7d
Packit 7d6a7d
exit 0;
Packit 7d6a7d
Packit 7d6a7d
#######################################################################
Packit 7d6a7d
Packit 7d6a7d
sub try_use { eval "use @_;"; return $@ eq '' }
Packit 7d6a7d
Packit 7d6a7d
sub mydiff
Packit 7d6a7d
{
Packit 7d6a7d
  local *F = shift;
Packit 7d6a7d
  my($file, $str) = @_;
Packit 7d6a7d
  my $diff;
Packit 7d6a7d
Packit 7d6a7d
  if (exists $opt{diff}) {
Packit 7d6a7d
    $diff = run_diff($opt{diff}, $file, $str);
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  if (!defined $diff and try_use('Text::Diff')) {
Packit 7d6a7d
    $diff = Text::Diff::diff($file, \$str, { STYLE => 'Unified' });
Packit 7d6a7d
    $diff = <
Packit 7d6a7d
--- $file
Packit 7d6a7d
+++ $file.patched
Packit 7d6a7d
HEADER
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  if (!defined $diff) {
Packit 7d6a7d
    $diff = run_diff('diff -u', $file, $str);
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  if (!defined $diff) {
Packit 7d6a7d
    $diff = run_diff('diff', $file, $str);
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  if (!defined $diff) {
Packit 7d6a7d
    error("Cannot generate a diff. Please install Text::Diff or use --copy.");
Packit 7d6a7d
    return;
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  print F $diff;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
sub run_diff
Packit 7d6a7d
{
Packit 7d6a7d
  my($prog, $file, $str) = @_;
Packit 7d6a7d
  my $tmp = 'dppptemp';
Packit 7d6a7d
  my $suf = 'aaa';
Packit 7d6a7d
  my $diff = '';
Packit 7d6a7d
  local *F;
Packit 7d6a7d
Packit 7d6a7d
  while (-e "$tmp.$suf") { $suf++ }
Packit 7d6a7d
  $tmp = "$tmp.$suf";
Packit 7d6a7d
Packit 7d6a7d
  if (open F, ">$tmp") {
Packit 7d6a7d
    print F $str;
Packit 7d6a7d
    close F;
Packit 7d6a7d
Packit 7d6a7d
    if (open F, "$prog $file $tmp |") {
Packit 7d6a7d
      while (<F>) {
Packit 7d6a7d
        s/\Q$tmp\E/$file.patched/;
Packit 7d6a7d
        $diff .= $_;
Packit 7d6a7d
      }
Packit 7d6a7d
      close F;
Packit 7d6a7d
      unlink $tmp;
Packit 7d6a7d
      return $diff;
Packit 7d6a7d
    }
Packit 7d6a7d
Packit 7d6a7d
    unlink $tmp;
Packit 7d6a7d
  }
Packit 7d6a7d
  else {
Packit 7d6a7d
    error("Cannot open '$tmp' for writing: $!");
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  return undef;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
sub rec_depend
Packit 7d6a7d
{
Packit 7d6a7d
  my($func, $seen) = @_;
Packit 7d6a7d
  return () unless exists $depends{$func};
Packit 7d6a7d
  $seen = {%{$seen||{}}};
Packit 7d6a7d
  return () if $seen->{$func}++;
Packit 7d6a7d
  my %s;
Packit 7d6a7d
  grep !$s{$_}++, map { ($_, rec_depend($_, $seen)) } @{$depends{$func}};
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
sub parse_version
Packit 7d6a7d
{
Packit 7d6a7d
  my $ver = shift;
Packit 7d6a7d
Packit 7d6a7d
  if ($ver =~ /^(\d+)\.(\d+)\.(\d+)$/) {
Packit 7d6a7d
    return ($1, $2, $3);
Packit 7d6a7d
  }
Packit 7d6a7d
  elsif ($ver !~ /^\d+\.[\d_]+$/) {
Packit 7d6a7d
    die "cannot parse version '$ver'\n";
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  $ver =~ s/_//g;
Packit 7d6a7d
  $ver =~ s/$/000000/;
Packit 7d6a7d
Packit 7d6a7d
  my($r,$v,$s) = $ver =~ /(\d+)\.(\d{3})(\d{3})/;
Packit 7d6a7d
Packit 7d6a7d
  $v = int $v;
Packit 7d6a7d
  $s = int $s;
Packit 7d6a7d
Packit 7d6a7d
  if ($r < 5 || ($r == 5 && $v < 6)) {
Packit 7d6a7d
    if ($s % 10) {
Packit 7d6a7d
      die "cannot parse version '$ver'\n";
Packit 7d6a7d
    }
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  return ($r, $v, $s);
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
sub format_version
Packit 7d6a7d
{
Packit 7d6a7d
  my $ver = shift;
Packit 7d6a7d
Packit 7d6a7d
  $ver =~ s/$/000000/;
Packit 7d6a7d
  my($r,$v,$s) = $ver =~ /(\d+)\.(\d{3})(\d{3})/;
Packit 7d6a7d
Packit 7d6a7d
  $v = int $v;
Packit 7d6a7d
  $s = int $s;
Packit 7d6a7d
Packit 7d6a7d
  if ($r < 5 || ($r == 5 && $v < 6)) {
Packit 7d6a7d
    if ($s % 10) {
Packit 7d6a7d
      die "invalid version '$ver'\n";
Packit 7d6a7d
    }
Packit 7d6a7d
    $s /= 10;
Packit 7d6a7d
Packit 7d6a7d
    $ver = sprintf "%d.%03d", $r, $v;
Packit 7d6a7d
    $s > 0 and $ver .= sprintf "_%02d", $s;
Packit 7d6a7d
Packit 7d6a7d
    return $ver;
Packit 7d6a7d
  }
Packit 7d6a7d
Packit 7d6a7d
  return sprintf "%d.%d.%d", $r, $v, $s;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
sub info
Packit 7d6a7d
{
Packit 7d6a7d
  $opt{quiet} and return;
Packit 7d6a7d
  print @_, "\n";
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
sub diag
Packit 7d6a7d
{
Packit 7d6a7d
  $opt{quiet} and return;
Packit 7d6a7d
  $opt{diag} and print @_, "\n";
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
sub warning
Packit 7d6a7d
{
Packit 7d6a7d
  $opt{quiet} and return;
Packit 7d6a7d
  print "*** ", @_, "\n";
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
sub error
Packit 7d6a7d
{
Packit 7d6a7d
  print "*** ERROR: ", @_, "\n";
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
my %given_hints;
Packit 7d6a7d
my %given_warnings;
Packit 7d6a7d
sub hint
Packit 7d6a7d
{
Packit 7d6a7d
  $opt{quiet} and return;
Packit 7d6a7d
  my $func = shift;
Packit 7d6a7d
  my $rv = 0;
Packit 7d6a7d
  if (exists $warnings{$func} && !$given_warnings{$func}++) {
Packit 7d6a7d
    my $warn = $warnings{$func};
Packit 7d6a7d
    $warn =~ s!^!*** !mg;
Packit 7d6a7d
    print "*** WARNING: $func\n", $warn;
Packit 7d6a7d
    $rv++;
Packit 7d6a7d
  }
Packit 7d6a7d
  if ($opt{hints} && exists $hints{$func} && !$given_hints{$func}++) {
Packit 7d6a7d
    my $hint = $hints{$func};
Packit 7d6a7d
    $hint =~ s/^/   /mg;
Packit 7d6a7d
    print "   --- hint for $func ---\n", $hint;
Packit 7d6a7d
  }
Packit 7d6a7d
  $rv;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
sub usage
Packit 7d6a7d
{
Packit 7d6a7d
  my($usage) = do { local(@ARGV,$/)=($0); <> } =~ /^=head\d$HS+SYNOPSIS\s*^(.*?)\s*^=/ms;
Packit 7d6a7d
  my %M = ( 'I' => '*' );
Packit 7d6a7d
  $usage =~ s/^\s*perl\s+\S+/$^X $0/;
Packit 7d6a7d
  $usage =~ s/([A-Z])<([^>]+)>/$M{$1}$2$M{$1}/g;
Packit 7d6a7d
Packit 7d6a7d
  print <
Packit 7d6a7d
Packit 7d6a7d
Usage: $usage
Packit 7d6a7d
Packit 7d6a7d
See perldoc $0 for details.
Packit 7d6a7d
Packit 7d6a7d
ENDUSAGE
Packit 7d6a7d
Packit 7d6a7d
  exit 2;
Packit 7d6a7d
}
Packit 7d6a7d
Packit 7d6a7d
sub strip
Packit 7d6a7d
{
Packit 7d6a7d
  my $self = do { local(@ARGV,$/)=($0); <> };
Packit 7d6a7d
  my($copy) = $self =~ /^=head\d\s+COPYRIGHT\s*^(.*?)^=\w+/ms;
Packit 7d6a7d
  $copy =~ s/^(?=\S+)/    /gms;
Packit 7d6a7d
  $self =~ s/^$HS+Do NOT edit.*?(?=^-)/$copy/ms;
Packit 7d6a7d
  $self =~ s/^SKIP.*(?=^__DATA__)/SKIP
Packit 7d6a7d
if (\@ARGV && \$ARGV[0] eq '--unstrip') {
Packit 7d6a7d
  eval { require Devel::PPPort };
Packit 7d6a7d
  \$@ and die "Cannot require Devel::PPPort, please install.\\n";
Packit 7d6a7d
  if (eval \$Devel::PPPort::VERSION < $VERSION) {
Packit 7d6a7d
    die "$0 was originally generated with Devel::PPPort $VERSION.\\n"
Packit 7d6a7d
      . "Your Devel::PPPort is only version \$Devel::PPPort::VERSION.\\n"
Packit 7d6a7d
      . "Please install a newer version, or --unstrip will not work.\\n";
Packit 7d6a7d
  }
Packit 7d6a7d
  Devel::PPPort::WriteFile(\$0);
Packit 7d6a7d
  exit 0;
Packit 7d6a7d
}
Packit 7d6a7d
print <
Packit 7d6a7d
Packit 7d6a7d
Sorry, but this is a stripped version of \$0.
Packit 7d6a7d
Packit 7d6a7d
To be able to use its original script and doc functionality,
Packit 7d6a7d
please try to regenerate this file using:
Packit 7d6a7d
Packit 7d6a7d
  \$^X \$0 --unstrip
Packit 7d6a7d
Packit 7d6a7d
END
Packit 7d6a7d
/ms;
Packit 7d6a7d
  my($pl, $c) = $self =~ /(.*^__DATA__)(.*)/ms;
Packit 7d6a7d
  $c =~ s{
Packit 7d6a7d
    / (?: \*[^*]*\*+(?:[^$ccs][^*]*\*+)* / | /[^\r\n]*)
Packit 7d6a7d
  | ( "[^"\\]*(?:\\.[^"\\]*)*"
Packit 7d6a7d
    | '[^'\\]*(?:\\.[^'\\]*)*' )
Packit 7d6a7d
  | ($HS+) }{ defined $2 ? ' ' : ($1 || '') }gsex;
Packit 7d6a7d
  $c =~ s!\s+$!!mg;
Packit 7d6a7d
  $c =~ s!^$LF!!mg;
Packit 7d6a7d
  $c =~ s!^\s*#\s*!#!mg;
Packit 7d6a7d
  $c =~ s!^\s+!!mg;
Packit 7d6a7d
Packit 7d6a7d
  open OUT, ">$0" or die "cannot strip $0: $!\n";
Packit 7d6a7d
  print OUT "$pl$c\n";
Packit 7d6a7d
Packit 7d6a7d
  exit 0;
Packit 7d6a7d
}