#!/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 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', ); # References to all flags checked by the parser. my @flag_refs = ( \@def_cflags, \@def_cflags_format, \@def_cflags_fortify, \@def_cflags_stack, \@def_cflags_pie, \@def_cxxflags, \@def_cppflags, \@def_cppflags_fortify, \@def_ldflags, \@def_ldflags_relro, \@def_ldflags_bindnow, ); # References to all used flags. my @flag_refs_all = ( @flag_refs, \@def_ldflags_pie, \@def_ldflags_pic, ); # 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. # # C++ compiler setting. return 0 if $line =~ /^\s*C\+\+.+?:\s+(?:yes|no)\s*$/; # "Compiling" with no file name. if ($line =~ /^\s*(?:C|c)ompiling\s+(.+?)(?:\.\.\.)?$/) { # $file_extension_regex may need spaces around the filename. return 0 if not " $1 " =~ /$file_extension_regex/o; } 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, ) or scalar @ARGV == 0) { 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; } # Don't load Term::ANSIColor in buildd mode because Term::ANSIColor is not # installed on Debian's buildds. if (not $option_buildd) { require Term::ANSIColor; } 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. foreach my $flags (@flag_refs_all) { @{$flags} = compile_flag_regexp(\%flag_renames, @{$flags}); } # 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 (not $option_buildd and $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; } # 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 Print tags instead of normal warnings, see README file for a list of possible tags. =item Don't check hardening flags in old log files (if dpkg-dev << 1.16.1 is detected). =item Don't require Term::ANSIColor. =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