#!/usr/bin/perl
# Build log hardening check, checks build logs for missing hardening flags.
# Copyright (C) 2012 Simon Ruderich
#
# 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 3 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 .
use strict;
use warnings;
use Getopt::Long ();
use Term::ANSIColor ();
use Text::ParseWords ();
our $VERSION = '0.01';
# CONSTANTS/VARIABLES
# Regex to catch compiler commands.
my $cc_regex = qr/
(? 1 } (
@source_no_preprocess,
);
my %extensions_preprocess = map { $_ => 1 } (
@header_preprocess,
@source_preprocess,
);
my %extensions_compile_link = map { $_ => 1 } (
@source_preprocess,
@source_no_preprocess,
);
my %extensions_compile = map { $_ => 1 } (
@source_preprocess_compile,
@source_no_preprocess_compile,
);
my %extensions_no_compile = map { $_ => 1 } (
@source_preprocess_no_compile,
@source_no_preprocess_no_compile,
);
my %extensions_compile_cpp = map { $_ => 1 } (
@source_preprocess_compile_cpp,
@source_no_preprocess_compile_cpp,
);
my %extension = map { $_ => 1 } (
@source_no_preprocess,
@header_preprocess,
@source_preprocess,
);
# Regexp to match file extensions.
my $file_extension_regex = qr/
\s
\S+ # Filename without extension.
\.
([^\\.,;:\s]+) # File extension.
(?=\s|\\) # At end of word. Can't use \b because some files have non
# word characters at the end and because \b matches double
# extensions (like .cpp.o). Works always as all lines are
# terminated with "\n".
/x;
# Expected (hardening) flags. All flags are used as regexps.
my @def_cflags = (
'-g',
'-O(?:2|3)',
);
my @def_cflags_format = (
'-Wformat',
'-Wformat-security',
'-Werror=format-security',
);
my @def_cflags_fortify = (
# fortify needs at least -O1, but -O2 is recommended anyway
);
my @def_cflags_stack = (
'-fstack-protector',
'--param=ssp-buffer-size=4',
);
my @def_cflags_pie = (
'-fPIE',
);
my @def_cxxflags = (
@def_cflags,
);
# @def_cxxflags_* is the same as @def_cflags_*.
my @def_cppflags = ();
my @def_cppflags_fortify = (
'-D_FORTIFY_SOURCE=2',
);
my @def_ldflags = ();
my @def_ldflags_relro = (
'-Wl,(?:-z,)?relro',
);
my @def_ldflags_bindnow = (
'-Wl,(?:-z,)?now',
);
my @def_ldflags_pie = (
'-fPIE',
'-pie',
);
my @def_ldflags_pic = (
'-fPIC',
'-fpic',
'-shared',
);
# Renaming rules for the output so the regex parts are not visible. Also
# stores string values of flag regexps above, see compile_flag_regexp().
my %flag_renames = (
'-O(?:2|3)' => '-O2',
'-Wl,(?:-z,)?relro' => '-Wl,-z,relro',
'-Wl,(?:-z,)?now' => '-Wl,-z,now',
);
my %exit_code = (
no_compiler_commands => 1 << 0,
# used by POD::Usage => 1 << 1,
non_verbose_build => 1 << 2,
flags_missing => 1 << 3,
hardening_wrapper => 1 << 4,
invalid_cmake => 1 << 5,
);
# Statistics of missing flags and non-verbose build commands. Used for
# $option_buildd.
my %statistics = (
preprocess => 0,
preprocess_missing => 0,
compile => 0,
compile_missing => 0,
compile_cpp => 0,
compile_cpp_missing => 0,
link => 0,
link_missing => 0,
commands => 0,
commands_nonverbose => 0,
);
# Use colored (ANSI) output?
my $option_color;
# FUNCTIONS
sub error_flags {
my ($message, $missing_flags_ref, $flag_renames_ref, $line) = @_;
# Get string value of qr//-escaped regexps and if requested rename them.
my @missing_flags = map {
$flag_renames_ref->{$_}
} @{$missing_flags_ref};
my $flags = join ' ', @missing_flags;
printf "%s (%s)%s %s",
error_color($message, 'red'), $flags, error_color(':', 'yellow'),
$line;
}
sub error_non_verbose_build {
my ($line) = @_;
printf "%s%s %s",
error_color('NONVERBOSE BUILD', 'red'),
error_color(':', 'yellow'),
$line;
}
sub error_invalid_cmake {
my ($version) = @_;
printf "%s%s %s\n",
error_color('INVALID CMAKE', 'red'),
error_color(':', 'yellow'),
$version;
}
sub error_hardening_wrapper {
printf "%s%s %s\n",
error_color('HARDENING WRAPPER', 'red'),
error_color(':', 'yellow'),
'no checks possible, aborting';
}
sub error_color {
my ($message, $color) = @_;
if ($option_color) {
return Term::ANSIColor::colored($message, $color);
} else {
return $message;
}
}
sub any_flags_used {
my ($line, @flags) = @_;
foreach my $flag (@flags) {
return 1 if $line =~ /$flag/;
}
return 0;
}
sub all_flags_used {
my ($line, $missing_flags_ref, @flags) = @_;
my @missing_flags = ();
foreach my $flag (@flags) {
if (not $line =~ /$flag/) {
push @missing_flags, $flag;
}
}
return 1 if scalar @missing_flags == 0;
@{$missing_flags_ref} = @missing_flags;
return 0;
}
# Modifies $missing_flags_ref array.
sub pic_pie_conflict {
my ($line, $pie, $missing_flags_ref, @flags_pie) = @_;
return 0 if not $pie;
return 0 if not any_flags_used($line, @def_ldflags_pic);
my %flags = map { $_ => 1 } @flags_pie;
# Remove all PIE flags from @missing_flags as they are not required with
# -fPIC.
my @result = grep {
not exists $flags{$_}
} @{$missing_flags_ref};
@{$missing_flags_ref} = @result;
# We got a conflict when no flags are left, thus only PIE flags were
# missing. If other flags were missing abort because the conflict is not
# the problem.
return scalar @result == 0;
}
sub is_non_verbose_build {
my ($line, $next_line, $skip_ref) = @_;
if (not ($line =~ /^checking if you want to see long compiling messages\.\.\. no/
or $line =~ /^\s*\[?(?:CC|CCLD|C\+\+|CXX|CXXLD|LD|LINK)\]?\s+(.+?)$/
or $line =~ /^\s*(?:C|c)ompiling\s+(.+?)(?:\.\.\.)?$/
or $line =~ /^\s*(?:B|b)uilding (?:program|shared library)\s+(.+?)$/
or $line =~ /^\s*\[[\d ]+%\] Building (?:C|CXX) object (.+?)$/)) {
return 0;
}
# False positives.
return 0 if $line =~ /^\s*C\+\+.+?:\s+(?:yes|no)\s*$/;
my $file = $1;
# On the first pass we only check if this line is verbose or not.
return 1 if not defined $next_line;
# Second pass, we have access to the next line.
${$skip_ref} = 0;
# CMake and other build systems print the non-verbose messages also when
# building verbose. If a compiler and the file name occurs in the next
# line, treat it as verbose build.
if (defined $file) {
# Get filename, we can't use the complete path as only parts of it are
# used in the real compiler command.
$file =~ m{/([^/\s]+)$};
$file = $1;
if ($next_line =~ /\Q$file\E/ and $next_line =~ /$cc_regex/o) {
# We still have to skip the current line as it doesn't contain any
# compiler commands.
${$skip_ref} = 1;
return 0;
}
}
return 1;
}
sub compile_flag_regexp {
my ($flag_renames_ref, @flags) = @_;
my @result = ();
foreach my $flag (@flags) {
# Store flag name in replacement string for correct flags in messages
# with qr//ed flag regexps.
$flag_renames_ref->{qr/\s$flag(?:\s|\\)/}
= (exists $flag_renames_ref->{$flag})
? $flag_renames_ref->{$flag}
: $flag;
# Compile flag regexp for faster execution.
push @result, qr/\s$flag(?:\s|\\)/;
}
return @result;
}
sub extension_found {
my ($extensions_ref, @extensions) = @_;
my $found = 0;
foreach my $extension (@extensions) {
if (exists $extensions_ref->{$extension}) {
$found = 1;
last;
}
}
return $found;
}
# MAIN
# Parse command line arguments.
my $option_help = 0;
my $option_version = 0;
my $option_pie = 0;
my $option_bindnow = 0;
my $option_all = 0;
my $option_arch = undef;
my $option_buildd = 0;
$option_color = 0;
if (not Getopt::Long::GetOptions(
'help|h|?' => \$option_help,
'version' => \$option_version,
# Hardening options.
'pie' => \$option_pie,
'bindnow' => \$option_bindnow,
'all' => \$option_all,
# Misc.
'color' => \$option_color,
'arch=s' => \$option_arch,
'buildd' => \$option_buildd,
)) {
require Pod::Usage;
Pod::Usage::pod2usage(2);
}
if ($option_help) {
require Pod::Usage;
Pod::Usage::pod2usage(1);
}
if ($option_version) {
print "blhc $VERSION Copyright (C) 2012 Simon Ruderich
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 3 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 .
";
exit 0;
}
if ($option_all) {
$option_pie = 1;
$option_bindnow = 1;
}
# Precompile all flag regexps. any_flags_used(), all_flags_used() get a lot
# faster with this.
@def_cflags = compile_flag_regexp(\%flag_renames, @def_cflags);
@def_cflags_format = compile_flag_regexp(\%flag_renames, @def_cflags_format);
@def_cflags_fortify = compile_flag_regexp(\%flag_renames, @def_cflags_fortify);
@def_cflags_stack = compile_flag_regexp(\%flag_renames, @def_cflags_stack);
@def_cflags_pie = compile_flag_regexp(\%flag_renames, @def_cflags_pie);
@def_cxxflags = compile_flag_regexp(\%flag_renames, @def_cxxflags);
@def_cppflags = compile_flag_regexp(\%flag_renames, @def_cppflags);
@def_cppflags_fortify = compile_flag_regexp(\%flag_renames, @def_cppflags_fortify);
@def_ldflags = compile_flag_regexp(\%flag_renames, @def_ldflags);
@def_ldflags_relro = compile_flag_regexp(\%flag_renames, @def_ldflags_relro);
@def_ldflags_bindnow = compile_flag_regexp(\%flag_renames, @def_ldflags_bindnow);
@def_ldflags_pie = compile_flag_regexp(\%flag_renames, @def_ldflags_pie);
@def_ldflags_pic = compile_flag_regexp(\%flag_renames, @def_ldflags_pic);
# Final exit code.
my $exit = 0;
FILE: foreach my $file (@ARGV) {
print "checking '$file'...\n" if scalar @ARGV > 1;
open my $fh, '<', $file or die "$!: $file";
# Architecture of this file.
my $arch = $option_arch;
# Hardening options. Not all architectures support all hardening options.
my $harden_format = 1;
my $harden_fortify = 1;
my $harden_stack = 1;
my $harden_relro = 1;
my $harden_bindnow = $option_bindnow; # defaults to 0
my $harden_pie = $option_pie; # defaults to 0
while (my $line = <$fh>) {
# dpkg-buildflags only provides hardening flags since 1.16.1, don't
# check for hardening flags in buildd mode if an older dpkg-dev is
# used. Default flags (-g -O2) are still checked.
#
# Packages which were built before 1.16.1 but used their own hardening
# flags are not checked.
if ($option_buildd and $line =~ /^Toolchain package versions: /) {
require Dpkg::Version;
if ($line !~ /\bdpkg-dev_(\S+)/
or Dpkg::Version::version_compare($1, '1.16.1') < 0) {
$harden_format = 0;
$harden_fortify = 0;
$harden_stack = 0;
$harden_relro = 0;
$harden_bindnow = 0;
$harden_pie = 0;
}
}
# The following two versions of CMake in Debian obeyed CPPFLAGS, but
# this was later dropped because upstream rejected the patch. Thus
# build logs with these versions will have fortify hardening flags
# enabled, even though they may be not correctly set and are missing
# when build with later CMake versions. Thanks to Aron Xu for letting
# me know.
if ($line =~ /^Package versions: /
and $line =~ /\bcmake_(\S+)/
and ($1 eq '2.8.7-1' or $1 eq '2.8.7-2')) {
if (not $option_buildd) {
error_invalid_cmake($1);
} else {
print "W-invalid-cmake-used $1\n";
}
$exit |= $exit_code{invalid_cmake};
}
# If hardening wrapper is used (wraps calls to gcc and adds hardening
# flags automatically) we can't perform any checks, abort.
if ($line =~ /^Build-Depends: .*\bhardening-wrapper\b/) {
if (not $option_buildd) {
error_hardening_wrapper();
} else {
print "I-hardening-wrapper-used\n";
}
$exit |= $exit_code{hardening_wrapper};
next FILE;
}
# We skip over unimportant lines at the beginning of the log to
# prevent false positives.
last if $line =~ /^dpkg-buildpackage:/;
}
# Input lines, contain only the lines with compiler commands.
my @input = ();
my $continuation = 0;
my $complete_line = undef;
while (my $line = <$fh>) {
# And stop at the end of the build log. Package details (reported by
# the buildd logs) are not important for us. This also prevents false
# positives.
last if $line =~ /^Build finished at \d{8}-\d{4}$/;
# Detect architecture automatically unless overridden.
if (not $arch
and $line =~ /^dpkg-buildpackage: host architecture (.+)$/) {
$arch = $1;
}
# Ignore compiler warnings for now.
next if $line =~ /$warning_regex/o;
if ($line =~ /\033/) { # esc
# Remove all ANSI color sequences which are sometimes used in
# non-verbose builds.
$line = Term::ANSIColor::colorstrip($line);
# Also strip '\0xf' (delete previous character), used by Elinks'
# build system.
$line =~ s/\x0f//g;
# And "ESC(B" which seems to be used on armhf and hurd (not sure
# what it does).
$line =~ s/\033\(B//g;
}
# Check if this line indicates a non verbose build.
my $non_verbose = is_non_verbose_build($line);
# One line may contain multiple commands (";"). Treat each one as
# single line. parse_line() is slow, only use it when necessary.
my @line = (not $line =~ /;/)
? ($line)
: map {
# Ensure newline at the line end - necessary for
# correct parsing later.
$_ =~ s/\s+$//;
$_ .= "\n";
} Text::ParseWords::parse_line(';', 1, $line);
foreach $line (@line) {
if ($continuation) {
$continuation = 0;
# Join lines, but leave the "\" in place so it's clear where
# the original line break was.
chomp $complete_line;
$complete_line .= ' ' . $line;
}
# Line continuation, line ends with "\".
if ($line =~ /\\\s*$/) {
$continuation = 1;
# Start line continuation.
if (not defined $complete_line) {
$complete_line = $line;
}
next;
}
if (not $continuation) {
# Use the complete line if a line continuation occurred.
if (defined $complete_line) {
$line = $complete_line;
$complete_line = undef;
}
# Ignore lines with no compiler commands.
next if not $non_verbose
and not $line =~ /\b$cc_regex(?:\s|\\)/o;
# Ignore lines with no filenames with extensions. May miss
# some non-verbose builds (e.g. "gcc -o test" [sic!]), but
# shouldn't be a problem as the log will most likely contain
# other non-verbose commands which are detected.
next if not $non_verbose
and not $line =~ /$file_extension_regex/o;
# Ignore false positives.
#
# `./configure` output.
next if not $non_verbose
and $line =~ /^(?:checking|(?:C|c)onfigure:) /;
next if $line =~ /^\s*(?:Host\s+)?(?:C(?:\+\+)?\s+)?
(?:C|c)ompiler[\s.]*:?\s+
/xo;
next if $line =~ /^\s*(?:- )?(?:HOST_)?(?:CC|CXX)\s*=\s*$cc_regex_full\s*$/o;
# Check if additional hardening options were used. Used to
# ensure they are used for the complete build.
$harden_pie = 1 if any_flags_used($line, @def_cflags_pie, @def_ldflags_pie);
$harden_bindnow = 1 if any_flags_used($line, @def_ldflags_bindnow);
push @input, $line;
}
}
}
close $fh;
if (scalar @input == 0) {
if (not $option_buildd) {
print "No compiler commands!\n";
} else {
print "W-no-compiler-commands\n";
}
$exit |= $exit_code{no_compiler_commands};
next FILE;
}
if ($option_buildd) {
$statistics{commands} += scalar @input;
}
# Option or auto detected.
if ($arch) {
# The following was partially copied from dpkg-dev 1.16.1.2
# (/usr/share/perl5/Dpkg/Vendor/Debian.pm, add_hardening_flags()),
# copyright Raphaƫl Hertzog , Kees Cook
# , Canonical, Ltd. licensed under GPL version 2 or
# later. Keep it in sync.
require Dpkg::Arch;
my ($abi, $os, $cpu) = Dpkg::Arch::debarch_to_debtriplet($arch);
# Disable unsupported hardening options.
if ($cpu =~ /^(ia64|alpha|mips|mipsel|hppa)$/ or $arch eq 'arm') {
$harden_stack = 0;
}
if ($cpu =~ /^(ia64|hppa|avr32)$/) {
$harden_relro = 0;
$harden_bindnow = 0;
}
}
# Default values.
my @cflags = @def_cflags;
my @cxxflags = @def_cxxflags;
my @cppflags = @def_cppflags;
my @ldflags = @def_ldflags;
# Check the specified hardening options, same order as dpkg-buildflags.
if ($harden_pie) {
@cflags = (@cflags, @def_cflags_pie);
@cxxflags = (@cxxflags, @def_cflags_pie);
@ldflags = (@ldflags, @def_ldflags_pie);
}
if ($harden_stack) {
@cflags = (@cflags, @def_cflags_stack);
@cxxflags = (@cxxflags, @def_cflags_stack);
}
if ($harden_fortify) {
@cflags = (@cflags, @def_cflags_fortify);
@cxxflags = (@cxxflags, @def_cflags_fortify);
@cppflags = (@cppflags, @def_cppflags_fortify);
}
if ($harden_format) {
@cflags = (@cflags, @def_cflags_format);
@cxxflags = (@cxxflags, @def_cflags_format);
}
if ($harden_relro) {
@ldflags = (@ldflags, @def_ldflags_relro);
}
if ($harden_bindnow) {
@ldflags = (@ldflags, @def_ldflags_bindnow);
}
for (my $i = 0; $i < scalar @input; $i++) {
my $line = $input[$i];
my $skip = 0;
if (is_non_verbose_build($line, $input[$i + 1], \$skip)) {
if (not $option_buildd) {
error_non_verbose_build($line);
} else {
$statistics{commands_nonverbose}++;
}
$exit |= $exit_code{non_verbose_build};
next;
}
# Even if it's a verbose build, we might have to skip this line.
next if $skip;
# Remove everything until and including the compiler command. Makes
# checks easier and faster.
$line =~ s/^.*?$cc_regex//o;
# "([...] test.c)" is not detected as 'test.c' - fix this by removing
# the brace and similar characters.
$line =~ s/['")]+$//;
# Skip unnecessary tests when only preprocessing.
my $flag_preprocess = 0;
my $dependency = 0;
my $preprocess = 0;
my $compile = 0;
my $link = 0;
# Preprocess, compile, assemble.
if ($line =~ /\s(-E|-S|-c)\b/) {
$preprocess = 1;
$flag_preprocess = 1 if $1 eq '-E';
$compile = 1 if $1 eq '-S' or $1 eq '-c';
# Dependency generation for Makefiles. The other flags (-MF -MG -MP
# -MT -MQ) are always used with -M/-MM.
} elsif ($line =~ /\s(?:-M|-MM)\b/) {
$dependency = 1;
# Otherwise assume we are linking.
} else {
$link = 1;
}
# -MD/-MMD also cause dependency generation, but they don't imply -E!
if ($line =~ /\s(?:-MD|-MMD)\b/) {
$dependency = 0;
$flag_preprocess = 0;
}
# Dependency generation for Makefiles, no preprocessing or other flags
# needed.
next if $dependency;
# Get all file extensions on this line.
my @extensions = $line =~ /$file_extension_regex/go;
# Ignore all unknown extensions to speedup the search below.
@extensions = grep { exists $extension{$_} } @extensions;
# These file types don't require preprocessing.
if (extension_found(\%extensions_no_preprocess, @extensions)) {
$preprocess = 0;
}
# These file types require preprocessing.
if (extension_found(\%extensions_preprocess, @extensions)) {
$preprocess = 1;
}
# If there are source files then it's compiling/linking in one step
# and we must check both. We only check for source files here, because
# header files cause too many false positives.
if (not $flag_preprocess
and extension_found(\%extensions_compile_link, @extensions)) {
# Assembly files don't need CFLAGS.
if (not extension_found(\%extensions_compile, @extensions)
and extension_found(\%extensions_no_compile, @extensions)) {
$compile = 0;
# But the rest does.
} else {
$compile = 1;
}
}
# Assume CXXFLAGS are required when a C++ file is specified in the
# compiler line.
my $compile_cpp = 0;
if ($compile
and extension_found(\%extensions_compile_cpp, @extensions)) {
$compile = 0;
$compile_cpp = 1;
}
if ($option_buildd) {
$statistics{preprocess}++ if $preprocess;
$statistics{compile}++ if $compile;
$statistics{compile_cpp}++ if $compile_cpp;
$statistics{link}++ if $link;
}
# Check hardening flags.
my @missing;
if ($compile and not all_flags_used($line, \@missing, @cflags)
# Libraries linked with -fPIC don't have to (and can't) be
# linked with -fPIE as well. It's no error if only PIE flags
# are missing.
and not pic_pie_conflict($line, $harden_pie, \@missing, @def_cflags_pie)
# Assume dpkg-buildflags returns the correct flags.
and not $line =~ /`dpkg-buildflags --get CFLAGS`/) {
if (not $option_buildd) {
error_flags('CFLAGS missing', \@missing, \%flag_renames, $input[$i]);
} else {
$statistics{compile_missing}++;
}
$exit |= $exit_code{flags_missing};
} elsif ($compile_cpp and not all_flags_used($line, \@missing, @cflags)
# Libraries linked with -fPIC don't have to (and can't) be
# linked with -fPIE as well. It's no error if only PIE flags
# are missing.
and not pic_pie_conflict($line, $harden_pie, \@missing, @def_cflags_pie)
# Assume dpkg-buildflags returns the correct flags.
and not $line =~ /`dpkg-buildflags --get CXXFLAGS`/) {
if (not $option_buildd) {
error_flags('CXXFLAGS missing', \@missing, \%flag_renames, $input[$i]);
} else {
$statistics{compile_cpp_missing}++;
}
$exit |= $exit_code{flags_missing};
}
if ($preprocess and not all_flags_used($line, \@missing, @cppflags)
# Assume dpkg-buildflags returns the correct flags.
and not $line =~ /`dpkg-buildflags --get CPPFLAGS`/) {
if (not $option_buildd) {
error_flags('CPPFLAGS missing', \@missing, \%flag_renames, $input[$i]);
} else {
$statistics{preprocess_missing}++;
}
$exit |= $exit_code{flags_missing};
}
if ($link and not all_flags_used($line, \@missing, @ldflags)
# Same here, -fPIC conflicts with -fPIE.
and not pic_pie_conflict($line, $harden_pie, \@missing, @def_ldflags_pie)
# Assume dpkg-buildflags returns the correct flags.
and not $line =~ /`dpkg-buildflags --get LDFLAGS`/) {
if (not $option_buildd) {
error_flags('LDFLAGS missing', \@missing, \%flag_renames, $input[$i]);
} else {
$statistics{link_missing}++;
}
$exit |= $exit_code{flags_missing};
}
}
}
# Print statistics for buildd mode, only output in this mode.
if ($option_buildd) {
my @warning;
if ($statistics{preprocess_missing}) {
push @warning, sprintf "CPPFLAGS %d (of %d)",
$statistics{preprocess_missing},
$statistics{preprocess};
}
if ($statistics{compile_missing}) {
push @warning, sprintf "CFLAGS %d (of %d)",
$statistics{compile_missing},
$statistics{compile};
}
if ($statistics{compile_cpp_missing}) {
push @warning, sprintf "CXXFLAGS %d (of %d)",
$statistics{compile_cpp_missing},
$statistics{compile_cpp};
}
if ($statistics{link_missing}) {
push @warning, sprintf "LDFLAGS %d (of %d)",
$statistics{link_missing},
$statistics{link};
}
if (scalar @warning) {
local $" = ', '; # array join string
print "W-dpkg-buildflags-missing @warning missing\n";
}
if ($statistics{commands_nonverbose}) {
printf "W-compiler-flags-hidden %d (of %d) hidden\n",
$statistics{commands_nonverbose},
$statistics{commands},
}
}
exit $exit;
__END__
=head1 NAME
blhc - build log hardening check, checks build logs for missing hardening flags
=head1 SYNOPSIS
B [I] Idpkg-buildpackage build log fileE..>
=head1 DESCRIPTION
blhc is a small tool which checks build logs for missing hardening flags and
other important warnings. It's licensed under the GPL 3 or later.
=head1 OPTIONS
=over 8
=item B<--all>
Force check for all +all (+pie, +bindnow) hardening flags. By default it's
auto detected.
=item B<--arch> I
Set the specific architecture (e.g. amd64, armel, etc.), automatically
disables hardening flags not available on this architecture. Is detected
automatically if dpkg-buildpackage is used.
=item B<--bindnow>
Force check for all +bindnow hardening flags. By default it's auto detected.
=item B<--buildd>
Special mode for buildds when automatically parsing log files. The following
changes are in effect:
=over 2
=item
Don't check hardening flags in old log files (if dpkg-dev << 1.16.1 is
detected).
=back
=item B<--color>
Use colored (ANSI) output for warning messages.
=item B<--pie>
Force check for all +pie hardening flags. By default it's auto detected.
=item B<-h -? --help>
Print available options.
=item B<--version>
Print version number and license.
=back
Auto detection for B<--pie> and B<--bindnow> only works if at least one
command uses the required hardening flag (e.g. -fPIE). Then it's required for
all other commands as well.
=head1 EXIT STATUS
The exit status is a "bit mask", each listed status is ORed when the error
condition occurs to get the result.
=over 4
=item B<0>
Success.
=item B<1>
No compiler commands were found.
=item B<2>
Invalid arguments/options given to blhc.
=item B<4>
Non verbose build.
=item B<8>
Missing hardening flags.
=item B<16>
Hardening wrapper detected, no tests performed.
=back
=head1 AUTHOR
Simon Ruderich, Esimon@ruderich.orgE
=head1 COPYRIGHT AND LICENSE
Copyright (C) 2012 by Simon Ruderich
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 3 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 .
=cut