Method isValidCandidate

src/function_context.py:559–585

Check if the given binary context is a valid match candidate. Args: bin_ctx (ComparableContext): context representing a binary function (potential match) Return Value: False iff the binary context was found as an invalid match candidate

(self, bin_ctx)

        return None

    def isValidCandidate(self, bin_ctx):
        """Check if the given binary context is a valid match candidate.

        Args:
            bin_ctx (ComparableContext): context representing a binary function (potential match)

        Return Value:
            False iff the binary context was found as an invalid match candidate
        """
        # 0. Both must be in the game
        if not self.active() or not bin_ctx.active():
            return False

        # 1. They must be in the same file
        if not bin_ctx.isFileSuitable(self):
            return False

        # 2. A static function can not have an xref from outside the library (weak because of possible inlining)
        if self.is_static and not bin_ctx.is_static:
            return False

        # 3. A collision candidate must not conflict with the previous matches
        if not bin_ctx.isPartial() and bin_ctx.matched() and self.hash != bin_ctx.match.hash:
            return False

        # If reached this line, the candidate is probably fine
        return True

    def compare(self, bin_ctx, logger):
        """Compare our (source) function to a potential binary match.