Blame util/ck_errf.pl

Packit Service 084de1
#! /usr/bin/env perl
Packit Service 084de1
# Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved.
Packit Service 084de1
#
Packit Service 084de1
# Licensed under the OpenSSL license (the "License").  You may not use
Packit Service 084de1
# this file except in compliance with the License.  You can obtain a copy
Packit Service 084de1
# in the file LICENSE in the source distribution or at
Packit Service 084de1
# https://www.openssl.org/source/license.html
Packit Service 084de1
Packit Service 084de1
# This is just a quick script to scan for cases where the 'error'
Packit Service 084de1
# function name in a XXXerr() macro is wrong.
Packit Service 084de1
#
Packit Service 084de1
# Run in the top level by going
Packit Service 084de1
# perl util/ck_errf.pl */*.c */*/*.c
Packit Service 084de1
#
Packit Service 084de1
Packit Service 084de1
use strict;
Packit Service 084de1
use warnings;
Packit Service 084de1
Packit Service 084de1
my $config;
Packit Service 084de1
my $err_strict = 0;
Packit Service 084de1
my $debug      = 0;
Packit Service 084de1
my $internal   = 0;
Packit Service 084de1
Packit Service 084de1
sub help
Packit Service 084de1
{
Packit Service 084de1
    print STDERR <<"EOF";
Packit Service 084de1
mkerr.pl [options] [files...]
Packit Service 084de1
Packit Service 084de1
Options:
Packit Service 084de1
Packit Service 084de1
    -conf FILE  Use the named config file FILE instead of the default.
Packit Service 084de1
Packit Service 084de1
    -debug      Verbose output debugging on stderr.
Packit Service 084de1
Packit Service 084de1
    -internal   Generate code that is to be built as part of OpenSSL itself.
Packit Service 084de1
                Also scans internal list of files.
Packit Service 084de1
Packit Service 084de1
    -strict     If any error was found, fail with exit code 1, otherwise 0.
Packit Service 084de1
Packit Service 084de1
    -help       Show this help text.
Packit Service 084de1
Packit Service 084de1
    ...         Additional arguments are added to the file list to scan,
Packit Service 084de1
                if '-internal' was NOT specified on the command line.
Packit Service 084de1
Packit Service 084de1
EOF
Packit Service 084de1
}
Packit Service 084de1
Packit Service 084de1
while ( @ARGV ) {
Packit Service 084de1
    my $arg = $ARGV[0];
Packit Service 084de1
    last unless $arg =~ /-.*/;
Packit Service 084de1
    $arg = $1 if $arg =~ /-(-.*)/;
Packit Service 084de1
    if ( $arg eq "-conf" ) {
Packit Service 084de1
        $config = $ARGV[1];
Packit Service 084de1
        shift @ARGV;
Packit Service 084de1
    } elsif ( $arg eq "-debug" ) {
Packit Service 084de1
        $debug = 1;
Packit Service 084de1
    } elsif ( $arg eq "-internal" ) {
Packit Service 084de1
        $internal = 1;
Packit Service 084de1
    } elsif ( $arg eq "-strict" ) {
Packit Service 084de1
        $err_strict = 1;
Packit Service 084de1
    } elsif ( $arg =~ /-*h(elp)?/ ) {
Packit Service 084de1
        &help();
Packit Service 084de1
        exit;
Packit Service 084de1
    } elsif ( $arg =~ /-.*/ ) {
Packit Service 084de1
        die "Unknown option $arg; use -h for help.\n";
Packit Service 084de1
    }
Packit Service 084de1
    shift @ARGV;
Packit Service 084de1
}
Packit Service 084de1
Packit Service 084de1
my @source;
Packit Service 084de1
if ( $internal ) {
Packit Service 084de1
    die "Extra parameters given.\n" if @ARGV;
Packit Service 084de1
    $config = "crypto/err/openssl.ec" unless defined $config;
Packit Service 084de1
    @source = ( glob('crypto/*.c'), glob('crypto/*/*.c'),
Packit Service 084de1
                glob('ssl/*.c'), glob('ssl/*/*.c') );
Packit Service 084de1
} else {
Packit Service 084de1
    die "Configuration file not given.\nSee '$0 -help' for information\n"
Packit Service 084de1
        unless defined $config;
Packit Service 084de1
    @source = @ARGV;
Packit Service 084de1
}
Packit Service 084de1
Packit Service 084de1
# To detect if there is any error generation for a libcrypto/libssl libs
Packit Service 084de1
# we don't know, we need to find out what libs we do know.  That list is
Packit Service 084de1
# readily available in crypto/err/openssl.ec, in form of lines starting
Packit Service 084de1
# with "L ".  Note that we always rely on the modules SYS and ERR to be
Packit Service 084de1
# generally available.
Packit Service 084de1
my %libs       = ( SYS => 1, ERR => 1 );
Packit Service 084de1
open my $cfh, $config or die "Trying to read $config: $!\n";
Packit Service 084de1
while (<$cfh>) {
Packit Service 084de1
    s|\R$||;                    # Better chomp
Packit Service 084de1
    next unless m|^L ([0-9A-Z_]+)\s|;
Packit Service 084de1
    next if $1 eq "NONE";
Packit Service 084de1
    $libs{$1} = 1;
Packit Service 084de1
}
Packit Service 084de1
Packit Service 084de1
my $bad = 0;
Packit Service 084de1
foreach my $file (@source) {
Packit Service 084de1
    open( IN, "<$file" ) || die "Can't open $file, $!";
Packit Service 084de1
    my $func = "";
Packit Service 084de1
    while (<IN>) {
Packit Service 084de1
        if ( !/;$/ && /^\**([a-zA-Z_].*[\s*])?([A-Za-z_0-9]+)\(.*([),]|$)/ ) {
Packit Service 084de1
            /^([^()]*(\([^()]*\)[^()]*)*)\(/;
Packit Service 084de1
            $1 =~ /([A-Za-z_0-9]*)$/;
Packit Service 084de1
            $func = $1;
Packit Service 084de1
            $func =~ tr/A-Z/a-z/;
Packit Service 084de1
        }
Packit Service 084de1
        if ( /([A-Z0-9_]+[A-Z0-9])err\(([^,]+)/ && !/ckerr_ignore/ ) {
Packit Service 084de1
            my $errlib = $1;
Packit Service 084de1
            my $n      = $2;
Packit Service 084de1
Packit Service 084de1
            unless ( $libs{$errlib} ) {
Packit Service 084de1
                print "$file:$.:$errlib not listed in $config\n";
Packit Service 084de1
                $libs{$errlib} = 1; # To not display it again
Packit Service 084de1
                $bad = 1;
Packit Service 084de1
            }
Packit Service 084de1
Packit Service 084de1
            if ( $func eq "" ) {
Packit Service 084de1
                print "$file:$.:???:$n\n";
Packit Service 084de1
                $bad = 1;
Packit Service 084de1
                next;
Packit Service 084de1
            }
Packit Service 084de1
Packit Service 084de1
            if ( $n !~ /^(.+)_F_(.+)$/ ) {
Packit Service 084de1
                #print "check -$file:$.:$func:$n\n";
Packit Service 084de1
                next;
Packit Service 084de1
            }
Packit Service 084de1
            my $lib = $1;
Packit Service 084de1
            $n   = $2;
Packit Service 084de1
Packit Service 084de1
            if ( $lib ne $errlib ) {
Packit Service 084de1
                print "$file:$.:$func:$n [${errlib}err]\n";
Packit Service 084de1
                $bad = 1;
Packit Service 084de1
                next;
Packit Service 084de1
            }
Packit Service 084de1
Packit Service 084de1
            $n =~ tr/A-Z/a-z/;
Packit Service 084de1
            if ( $n ne $func && $errlib ne "SYS" ) {
Packit Service 084de1
                print "$file:$.:$func:$n\n";
Packit Service 084de1
                $bad = 1;
Packit Service 084de1
                next;
Packit Service 084de1
            }
Packit Service 084de1
Packit Service 084de1
            #		print "$func:$1\n";
Packit Service 084de1
        }
Packit Service 084de1
    }
Packit Service 084de1
    close(IN);
Packit Service 084de1
}
Packit Service 084de1
Packit Service 084de1
if ( $bad && $err_strict ) {
Packit Service 084de1
    print STDERR "FATAL: error discrepancy\n";
Packit Service 084de1
    exit 1;
Packit Service 084de1
}