| Index: third_party/dpkg-dev/scripts/Dpkg/Shlibs/Symbol.pm
 | 
| diff --git a/third_party/dpkg-dev/scripts/Dpkg/Shlibs/Symbol.pm b/third_party/dpkg-dev/scripts/Dpkg/Shlibs/Symbol.pm
 | 
| new file mode 100644
 | 
| index 0000000000000000000000000000000000000000..c39624e56f73dcc9a6b5842d7de29471eb228ee7
 | 
| --- /dev/null
 | 
| +++ b/third_party/dpkg-dev/scripts/Dpkg/Shlibs/Symbol.pm
 | 
| @@ -0,0 +1,507 @@
 | 
| +# Copyright © 2007 Raphaël Hertzog <hertzog@debian.org>
 | 
| +# Copyright © 2009-2010 Modestas Vainius <modax@debian.org>
 | 
| +#
 | 
| +# This program is free software; you can redistribute it and/or modify
 | 
| +# it under the terms of the GNU General Public License as published by
 | 
| +# the Free Software Foundation; either version 2 of the License, or
 | 
| +# (at your option) any later version.
 | 
| +#
 | 
| +# This program is distributed in the hope that it will be useful,
 | 
| +# but WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
| +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 | 
| +# GNU General Public License for more details.
 | 
| +#
 | 
| +# You should have received a copy of the GNU General Public License
 | 
| +# along with this program.  If not, see <https://www.gnu.org/licenses/>.
 | 
| +
 | 
| +package Dpkg::Shlibs::Symbol;
 | 
| +
 | 
| +use strict;
 | 
| +use warnings;
 | 
| +
 | 
| +our $VERSION = '0.01';
 | 
| +
 | 
| +use Dpkg::Gettext;
 | 
| +use Dpkg::Deps;
 | 
| +use Dpkg::ErrorHandling;
 | 
| +use Dpkg::Util qw(:list);
 | 
| +use Dpkg::Version;
 | 
| +use Storable ();
 | 
| +use Dpkg::Shlibs::Cppfilt;
 | 
| +
 | 
| +# Supported alias types in the order of matching preference
 | 
| +use constant ALIAS_TYPES => qw(c++ symver);
 | 
| +
 | 
| +sub new {
 | 
| +    my $this = shift;
 | 
| +    my $class = ref($this) || $this;
 | 
| +    my %args = @_;
 | 
| +    my $self = bless {
 | 
| +	symbol => undef,
 | 
| +	symbol_templ => undef,
 | 
| +	minver => undef,
 | 
| +	dep_id => 0,
 | 
| +	deprecated => 0,
 | 
| +	tags => {},
 | 
| +	tagorder => [],
 | 
| +    }, $class;
 | 
| +    $self->{$_} = $args{$_} foreach keys %args;
 | 
| +    return $self;
 | 
| +}
 | 
| +
 | 
| +# Deep clone
 | 
| +sub clone {
 | 
| +    my $self = shift;
 | 
| +    my $clone = Storable::dclone($self);
 | 
| +    if (@_) {
 | 
| +	my %args=@_;
 | 
| +	$clone->{$_} = $args{$_} foreach keys %args;
 | 
| +    }
 | 
| +    return $clone;
 | 
| +}
 | 
| +
 | 
| +sub parse_tagspec {
 | 
| +    my ($self, $tagspec) = @_;
 | 
| +
 | 
| +    if ($tagspec =~ /^\s*\((.*?)\)(.*)$/ && $1) {
 | 
| +	# (tag1=t1 value|tag2|...|tagN=tNp)
 | 
| +	# Symbols ()|= cannot appear in the tag names and values
 | 
| +	my $tagspec = $1;
 | 
| +	my $rest = ($2) ? $2 : '';
 | 
| +	my @tags = split(/\|/, $tagspec);
 | 
| +
 | 
| +	# Parse each tag
 | 
| +	for my $tag (@tags) {
 | 
| +	    if ($tag =~ /^(.*)=(.*)$/) {
 | 
| +		# Tag with value
 | 
| +		$self->add_tag($1, $2);
 | 
| +	    } else {
 | 
| +		# Tag without value
 | 
| +		$self->add_tag($tag, undef);
 | 
| +	    }
 | 
| +	}
 | 
| +	return $rest;
 | 
| +    }
 | 
| +    return;
 | 
| +}
 | 
| +
 | 
| +sub parse_symbolspec {
 | 
| +    my ($self, $symbolspec, %opts) = @_;
 | 
| +    my $symbol;
 | 
| +    my $symbol_templ;
 | 
| +    my $symbol_quoted;
 | 
| +    my $rest;
 | 
| +
 | 
| +    if (defined($symbol = $self->parse_tagspec($symbolspec))) {
 | 
| +	# (tag1=t1 value|tag2|...|tagN=tNp)"Foo::Bar::foobar()"@Base 1.0 1
 | 
| +	# Symbols ()|= cannot appear in the tag names and values
 | 
| +
 | 
| +	# If the tag specification exists symbol name template might be quoted too
 | 
| +	if ($symbol =~ /^(['"])/ && $symbol =~ /^($1)(.*?)$1(.*)$/) {
 | 
| +	    $symbol_quoted = $1;
 | 
| +	    $symbol_templ = $2;
 | 
| +	    $symbol = $2;
 | 
| +	    $rest = $3;
 | 
| +	} else {
 | 
| +	    if ($symbol =~ m/^(\S+)(.*)$/) {
 | 
| +		$symbol_templ = $1;
 | 
| +		$symbol = $1;
 | 
| +		$rest = $2;
 | 
| +	    }
 | 
| +	}
 | 
| +	error(_g('symbol name unspecified: %s'), $symbolspec) if (!$symbol);
 | 
| +    } else {
 | 
| +	# No tag specification. Symbol name is up to the first space
 | 
| +	# foobarsymbol@Base 1.0 1
 | 
| +	if ($symbolspec =~ m/^(\S+)(.*)$/) {
 | 
| +	    $symbol = $1;
 | 
| +	    $rest = $2;
 | 
| +	} else {
 | 
| +	    return 0;
 | 
| +	}
 | 
| +    }
 | 
| +    $self->{symbol} = $symbol;
 | 
| +    $self->{symbol_templ} = $symbol_templ;
 | 
| +    $self->{symbol_quoted} = $symbol_quoted if ($symbol_quoted);
 | 
| +
 | 
| +    # Now parse "the rest" (minver and dep_id)
 | 
| +    if ($rest =~ /^\s(\S+)(?:\s(\d+))?/) {
 | 
| +	$self->{minver} = $1;
 | 
| +	$self->{dep_id} = defined($2) ? $2 : 0;
 | 
| +    } elsif (defined $opts{default_minver}) {
 | 
| +	$self->{minver} = $opts{default_minver};
 | 
| +	$self->{dep_id} = 0;
 | 
| +    } else {
 | 
| +	return 0;
 | 
| +    }
 | 
| +    return 1;
 | 
| +}
 | 
| +
 | 
| +# A hook for symbol initialization (typically processing of tags). The code
 | 
| +# here may even change symbol name. Called from
 | 
| +# Dpkg::Shlibs::SymbolFile::create_symbol().
 | 
| +sub initialize {
 | 
| +    my $self = shift;
 | 
| +
 | 
| +    # Look for tags marking symbol patterns. The pattern may match multiple
 | 
| +    # real symbols.
 | 
| +    my $type;
 | 
| +    if ($self->has_tag('c++')) {
 | 
| +	# Raw symbol name is always demangled to the same alias while demangled
 | 
| +	# symbol name cannot be reliably converted back to raw symbol name.
 | 
| +	# Therefore, we can use hash for mapping.
 | 
| +	$type = 'alias-c++';
 | 
| +    }
 | 
| +
 | 
| +    # Support old style wildcard syntax. That's basically a symver
 | 
| +    # with an optional tag.
 | 
| +    if ($self->get_symbolname() =~ /^\*@(.*)$/) {
 | 
| +	$self->add_tag('symver') unless $self->has_tag('symver');
 | 
| +	$self->add_tag('optional') unless $self->has_tag('optional');
 | 
| +	$self->{symbol} = $1;
 | 
| +    }
 | 
| +
 | 
| +    if ($self->has_tag('symver')) {
 | 
| +	# Each symbol is matched against its version rather than full
 | 
| +	# name@version string.
 | 
| +	$type = (defined $type) ? 'generic' : 'alias-symver';
 | 
| +	if ($self->get_symbolname() eq 'Base') {
 | 
| +	    error(_g("you can't use symver tag to catch unversioned symbols: %s"),
 | 
| +	          $self->get_symbolspec(1));
 | 
| +	}
 | 
| +    }
 | 
| +
 | 
| +    # As soon as regex is involved, we need to match each real
 | 
| +    # symbol against each pattern (aka 'generic' pattern).
 | 
| +    if ($self->has_tag('regex')) {
 | 
| +	$type = 'generic';
 | 
| +	# Pre-compile regular expression for better performance.
 | 
| +	my $regex = $self->get_symbolname();
 | 
| +	$self->{pattern}{regex} = qr/$regex/;
 | 
| +    }
 | 
| +    if (defined $type) {
 | 
| +	$self->init_pattern($type);
 | 
| +    }
 | 
| +}
 | 
| +
 | 
| +sub get_symbolname {
 | 
| +    return $_[0]->{symbol};
 | 
| +}
 | 
| +
 | 
| +sub get_symboltempl {
 | 
| +    return $_[0]->{symbol_templ} || $_[0]->{symbol};
 | 
| +}
 | 
| +
 | 
| +sub set_symbolname {
 | 
| +    my ($self, $name, $templ, $quoted) = @_;
 | 
| +    unless (defined $name) {
 | 
| +	$name = $self->{symbol};
 | 
| +    }
 | 
| +    if (!defined $templ && $name =~ /\s/) {
 | 
| +	$templ = $name;
 | 
| +    }
 | 
| +    if (!defined $quoted && defined $templ && $templ =~ /\s/) {
 | 
| +	$quoted = '"';
 | 
| +    }
 | 
| +    $self->{symbol} = $name;
 | 
| +    $self->{symbol_templ} = $templ;
 | 
| +    if ($quoted) {
 | 
| +	$self->{symbol_quoted} = $quoted;
 | 
| +    } else {
 | 
| +	delete $self->{symbol_quoted};
 | 
| +    }
 | 
| +}
 | 
| +
 | 
| +sub has_tags {
 | 
| +    my $self = shift;
 | 
| +    return scalar (@{$self->{tagorder}});
 | 
| +}
 | 
| +
 | 
| +sub add_tag {
 | 
| +    my ($self, $tagname, $tagval) = @_;
 | 
| +    if (exists $self->{tags}{$tagname}) {
 | 
| +	$self->{tags}{$tagname} = $tagval;
 | 
| +	return 0;
 | 
| +    } else {
 | 
| +	$self->{tags}{$tagname} = $tagval;
 | 
| +	push @{$self->{tagorder}}, $tagname;
 | 
| +    }
 | 
| +    return 1;
 | 
| +}
 | 
| +
 | 
| +sub delete_tag {
 | 
| +    my ($self, $tagname) = @_;
 | 
| +    if (exists $self->{tags}{$tagname}) {
 | 
| +	delete $self->{tags}{$tagname};
 | 
| +        $self->{tagorder} = [ grep { $_ ne $tagname } @{$self->{tagorder}} ];
 | 
| +	return 1;
 | 
| +    }
 | 
| +    return 0;
 | 
| +}
 | 
| +
 | 
| +sub has_tag {
 | 
| +    my ($self, $tag) = @_;
 | 
| +    return exists $self->{tags}{$tag};
 | 
| +}
 | 
| +
 | 
| +sub get_tag_value {
 | 
| +    my ($self, $tag) = @_;
 | 
| +    return $self->{tags}{$tag};
 | 
| +}
 | 
| +
 | 
| +# Checks if the symbol is equal to another one (by name and optionally,
 | 
| +# tag sets, versioning info (minver and depid))
 | 
| +sub equals {
 | 
| +    my ($self, $other, %opts) = @_;
 | 
| +    $opts{versioning} = 1 unless exists $opts{versioning};
 | 
| +    $opts{tags} = 1 unless exists $opts{tags};
 | 
| +
 | 
| +    return 0 if $self->{symbol} ne $other->{symbol};
 | 
| +
 | 
| +    if ($opts{versioning}) {
 | 
| +	return 0 if $self->{minver} ne $other->{minver};
 | 
| +	return 0 if $self->{dep_id} ne $other->{dep_id};
 | 
| +    }
 | 
| +
 | 
| +    if ($opts{tags}) {
 | 
| +	return 0 if scalar(@{$self->{tagorder}}) != scalar(@{$other->{tagorder}});
 | 
| +
 | 
| +	for my $i (0 .. scalar(@{$self->{tagorder}}) - 1) {
 | 
| +	    my $tag = $self->{tagorder}->[$i];
 | 
| +	    return 0 if $tag ne $other->{tagorder}->[$i];
 | 
| +	    if (defined $self->{tags}{$tag} && defined $other->{tags}{$tag}) {
 | 
| +		return 0 if $self->{tags}{$tag} ne $other->{tags}{$tag};
 | 
| +	    } elsif (defined $self->{tags}{$tag} || defined $other->{tags}{$tag}) {
 | 
| +		return 0;
 | 
| +	    }
 | 
| +	}
 | 
| +    }
 | 
| +
 | 
| +    return 1;
 | 
| +}
 | 
| +
 | 
| +
 | 
| +sub is_optional {
 | 
| +    my $self = shift;
 | 
| +    return $self->has_tag('optional');
 | 
| +}
 | 
| +
 | 
| +sub is_arch_specific {
 | 
| +    my $self = shift;
 | 
| +    return $self->has_tag('arch');
 | 
| +}
 | 
| +
 | 
| +sub arch_is_concerned {
 | 
| +    my ($self, $arch) = @_;
 | 
| +    my $arches = $self->{tags}{arch};
 | 
| +
 | 
| +    if (defined $arch && defined $arches) {
 | 
| +	my $dep = Dpkg::Deps::Simple->new();
 | 
| +	my @arches = split(/[\s,]+/, $arches);
 | 
| +	$dep->{package} = 'dummy';
 | 
| +	$dep->{arches} = \@arches;
 | 
| +	return $dep->arch_is_concerned($arch);
 | 
| +    }
 | 
| +
 | 
| +    return 1;
 | 
| +}
 | 
| +
 | 
| +# Get reference to the pattern the symbol matches (if any)
 | 
| +sub get_pattern {
 | 
| +    return $_[0]->{matching_pattern};
 | 
| +}
 | 
| +
 | 
| +### NOTE: subroutines below require (or initialize) $self to be a pattern ###
 | 
| +
 | 
| +# Initializes this symbol as a pattern of the specified type.
 | 
| +sub init_pattern {
 | 
| +    my ($self, $type) = @_;
 | 
| +
 | 
| +    $self->{pattern}{type} = $type;
 | 
| +    # To be filled with references to symbols matching this pattern.
 | 
| +    $self->{pattern}{matches} = [];
 | 
| +}
 | 
| +
 | 
| +# Is this symbol a pattern or not?
 | 
| +sub is_pattern {
 | 
| +    return exists $_[0]->{pattern};
 | 
| +}
 | 
| +
 | 
| +# Get pattern type if this symbol is a pattern.
 | 
| +sub get_pattern_type {
 | 
| +    return $_[0]->{pattern}{type} || '';
 | 
| +}
 | 
| +
 | 
| +# Get (sub)type of the alias pattern. Returns empty string if current
 | 
| +# pattern is not alias.
 | 
| +sub get_alias_type {
 | 
| +    return ($_[0]->get_pattern_type() =~ /^alias-(.+)/ && $1) || '';
 | 
| +}
 | 
| +
 | 
| +# Get a list of symbols matching this pattern if this symbol is a pattern
 | 
| +sub get_pattern_matches {
 | 
| +    return @{$_[0]->{pattern}{matches}};
 | 
| +}
 | 
| +
 | 
| +# Create a new symbol based on the pattern (i.e. $self)
 | 
| +# and add it to the pattern matches list.
 | 
| +sub create_pattern_match {
 | 
| +    my $self = shift;
 | 
| +    return unless $self->is_pattern();
 | 
| +
 | 
| +    # Leave out 'pattern' subfield while deep-cloning
 | 
| +    my $pattern_stuff = $self->{pattern};
 | 
| +    delete $self->{pattern};
 | 
| +    my $newsym = $self->clone(@_);
 | 
| +    $self->{pattern} = $pattern_stuff;
 | 
| +
 | 
| +    # Clean up symbol name related internal fields
 | 
| +    $newsym->set_symbolname();
 | 
| +
 | 
| +    # Set newsym pattern reference, add to pattern matches list
 | 
| +    $newsym->{matching_pattern} = $self;
 | 
| +    push @{$self->{pattern}{matches}}, $newsym;
 | 
| +    return $newsym;
 | 
| +}
 | 
| +
 | 
| +### END of pattern subroutines ###
 | 
| +
 | 
| +# Given a raw symbol name the call returns its alias according to the rules of
 | 
| +# the current pattern ($self). Returns undef if the supplied raw name is not
 | 
| +# transformable to alias.
 | 
| +sub convert_to_alias {
 | 
| +    my ($self, $rawname, $type) = @_;
 | 
| +    $type = $self->get_alias_type() unless $type;
 | 
| +
 | 
| +    if ($type) {
 | 
| +	if ($type eq 'symver') {
 | 
| +	    # In case of symver, alias is symbol version. Extract it from the
 | 
| +	    # rawname.
 | 
| +	    return "$1" if ($rawname =~ /\@([^@]+)$/);
 | 
| +	} elsif ($rawname =~ /^_Z/ && $type eq 'c++') {
 | 
| +	    return cppfilt_demangle_cpp($rawname);
 | 
| +	}
 | 
| +    }
 | 
| +    return;
 | 
| +}
 | 
| +
 | 
| +sub get_tagspec {
 | 
| +    my ($self) = @_;
 | 
| +    if ($self->has_tags()) {
 | 
| +	my @tags;
 | 
| +	for my $tagname (@{$self->{tagorder}}) {
 | 
| +	    my $tagval = $self->{tags}{$tagname};
 | 
| +	    if (defined $tagval) {
 | 
| +		push @tags, $tagname . '='  . $tagval;
 | 
| +	    } else {
 | 
| +		push @tags, $tagname;
 | 
| +	    }
 | 
| +	}
 | 
| +	return '(' . join('|', @tags) . ')';
 | 
| +    }
 | 
| +    return '';
 | 
| +}
 | 
| +
 | 
| +sub get_symbolspec {
 | 
| +    my $self = shift;
 | 
| +    my $template_mode = shift;
 | 
| +    my $spec = '';
 | 
| +    $spec .= "#MISSING: $self->{deprecated}#" if $self->{deprecated};
 | 
| +    $spec .= ' ';
 | 
| +    if ($template_mode) {
 | 
| +	if ($self->has_tags()) {
 | 
| +	    $spec .= sprintf('%s%3$s%s%3$s', $self->get_tagspec(),
 | 
| +		$self->get_symboltempl(), $self->{symbol_quoted} || '');
 | 
| +	} else {
 | 
| +	    $spec .= $self->get_symboltempl();
 | 
| +	}
 | 
| +    } else {
 | 
| +	$spec .= $self->get_symbolname();
 | 
| +    }
 | 
| +    $spec .= " $self->{minver}";
 | 
| +    $spec .= " $self->{dep_id}" if $self->{dep_id};
 | 
| +    return $spec;
 | 
| +}
 | 
| +
 | 
| +# Sanitize the symbol when it is confirmed to be found in
 | 
| +# the respective library.
 | 
| +sub mark_found_in_library {
 | 
| +    my ($self, $minver, $arch) = @_;
 | 
| +
 | 
| +    if ($self->{deprecated}) {
 | 
| +	# Symbol reappeared somehow
 | 
| +	$self->{deprecated} = 0;
 | 
| +	$self->{minver} = $minver if (not $self->is_optional());
 | 
| +    } else {
 | 
| +	# We assume that the right dependency information is already
 | 
| +	# there.
 | 
| +	if (version_compare($minver, $self->{minver}) < 0) {
 | 
| +	    $self->{minver} = $minver;
 | 
| +	}
 | 
| +    }
 | 
| +    # Never remove arch tags from patterns
 | 
| +    if (not $self->is_pattern()) {
 | 
| +	if (not $self->arch_is_concerned($arch)) {
 | 
| +	    # Remove arch tag because it is incorrect.
 | 
| +	    $self->delete_tag('arch');
 | 
| +	}
 | 
| +    }
 | 
| +}
 | 
| +
 | 
| +# Sanitize the symbol when it is confirmed to be NOT found in
 | 
| +# the respective library.
 | 
| +# Mark as deprecated those that are no more provided (only if the
 | 
| +# minver is later than the version where the symbol was introduced)
 | 
| +sub mark_not_found_in_library {
 | 
| +    my ($self, $minver, $arch) = @_;
 | 
| +
 | 
| +    # Ignore symbols from foreign arch
 | 
| +    return if not $self->arch_is_concerned($arch);
 | 
| +
 | 
| +    if ($self->{deprecated}) {
 | 
| +	# Bump deprecated if the symbol is optional so that it
 | 
| +	# keeps reappering in the diff while it's missing
 | 
| +	$self->{deprecated} = $minver if $self->is_optional();
 | 
| +    } elsif (version_compare($minver, $self->{minver}) > 0) {
 | 
| +	$self->{deprecated} = $minver;
 | 
| +    }
 | 
| +}
 | 
| +
 | 
| +# Checks if the symbol (or pattern) is legitimate as a real symbol for the
 | 
| +# specified architecture.
 | 
| +sub is_legitimate {
 | 
| +    my ($self, $arch) = @_;
 | 
| +    return ! $self->{deprecated} &&
 | 
| +           $self->arch_is_concerned($arch);
 | 
| +}
 | 
| +
 | 
| +# Determine whether a supplied raw symbol name matches against current ($self)
 | 
| +# symbol or pattern.
 | 
| +sub matches_rawname {
 | 
| +    my ($self, $rawname) = @_;
 | 
| +    my $target = $rawname;
 | 
| +    my $ok = 1;
 | 
| +    my $do_eq_match = 1;
 | 
| +
 | 
| +    if ($self->is_pattern()) {
 | 
| +	# Process pattern tags in the order they were specified.
 | 
| +	for my $tag (@{$self->{tagorder}}) {
 | 
| +	    if (any { $tag eq $_ } ALIAS_TYPES) {
 | 
| +		$ok = not not ($target = $self->convert_to_alias($target, $tag));
 | 
| +	    } elsif ($tag eq 'regex') {
 | 
| +		# Symbol name is a regex. Match it against the target
 | 
| +		$do_eq_match = 0;
 | 
| +		$ok = ($target =~ $self->{pattern}{regex});
 | 
| +	    }
 | 
| +	    last if not $ok;
 | 
| +	}
 | 
| +    }
 | 
| +
 | 
| +    # Equality match by default
 | 
| +    if ($ok && $do_eq_match) {
 | 
| +	$ok = $target eq $self->get_symbolname();
 | 
| +    }
 | 
| +    return $ok;
 | 
| +}
 | 
| +
 | 
| +1;
 | 
| 
 |