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 |
deleted file mode 100644 |
index c39624e56f73dcc9a6b5842d7de29471eb228ee7..0000000000000000000000000000000000000000 |
--- a/third_party/dpkg-dev/scripts/Dpkg/Shlibs/Symbol.pm |
+++ /dev/null |
@@ -1,507 +0,0 @@ |
-# 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; |