| 1 | package Mail::Toaster::Utility; | ||||||||||||||||||||||||||||||||||||||||||
| 2 | # ABSTRACT: utility subroutines for sysadmin tasks | ||||||||||||||||||||||||||||||||||||||||||
| 3 | |||||||||||||||||||||||||||||||||||||||||||
| 4 | 12 | ▶ | use strict; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 5 | 11 | ▶ | use warnings; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 6 | |||||||||||||||||||||||||||||||||||||||||||
| 7 | 11 | our $VERSION = '5.51'; | |||||||||||||||||||||||||||||||||||||||||
| 8 | |||||||||||||||||||||||||||||||||||||||||||
| 9 | 11 | ▶ | use Cwd; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 10 | 11 | ▶ | use Carp; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 11 | #use Data::Dumper; | ||||||||||||||||||||||||||||||||||||||||||
| 12 | 11 | ▶ | use English qw( -no_match_vars ); | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 13 | 11 | ▶ | use File::Basename; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 14 | 11 | ▶ | use File::Copy; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 15 | 11 | ▶ | use File::Path; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 16 | 11 | ▶ | use File::Spec; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 17 | 11 | ▶ | use File::stat; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 18 | 11 | ▶ | use Params::Validate qw(:all); | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 19 | 11 | ▶ | use Scalar::Util qw( openhandle ); | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 20 | #use URI; # required in get_url | ||||||||||||||||||||||||||||||||||||||||||
| 21 | |||||||||||||||||||||||||||||||||||||||||||
| 22 | 11 | ▶ | use lib 'lib'; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 23 | 11 | ▶ | use parent 'Mail::Toaster::Base'; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 24 | |||||||||||||||||||||||||||||||||||||||||||
| 25 | sub ask { | ||||||||||||||||||||||||||||||||||||||||||
| 26 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
ask: not called CC=14 SCAR=53.5
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 27 | 0 | my $question = shift; | |||||||||||||||||||||||||||||||||||||||||
| 28 | 0 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 29 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 30 | { default => { type => SCALAR|UNDEF, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 31 | timeout => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 32 | password => { type => BOOLEAN, optional => 1, default => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 33 | test_ok => { type => BOOLEAN, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 34 | } | ||||||||||||||||||||||||||||||||||||||||||
| 35 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 36 | |||||||||||||||||||||||||||||||||||||||||||
| 37 | 0 | my $pass = $p{password}; | |||||||||||||||||||||||||||||||||||||||||
| 38 | 0 | my $default = $p{default}; | |||||||||||||||||||||||||||||||||||||||||
| 39 | |||||||||||||||||||||||||||||||||||||||||||
| 40 | 0 | ▶ | if ( ! $self->is_interactive() ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 41 | 0 | $self->audit( "not running interactively, can not prompt!"); | |||||||||||||||||||||||||||||||||||||||||
| 42 | 0 | return $default; | |||||||||||||||||||||||||||||||||||||||||
| 43 | } | ||||||||||||||||||||||||||||||||||||||||||
| 44 | |||||||||||||||||||||||||||||||||||||||||||
| 45 | 0 | ▶ | return $self->error( "ask called with \'$question\' which looks unsafe." ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 46 | if $question !~ m{\A \p{Any}* \z}xms; | ||||||||||||||||||||||||||||||||||||||||||
| 47 | |||||||||||||||||||||||||||||||||||||||||||
| 48 | 0 | my $response; | |||||||||||||||||||||||||||||||||||||||||
| 49 | |||||||||||||||||||||||||||||||||||||||||||
| 50 | 0 | ▶ | return $p{test_ok} if defined $p{test_ok}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 51 | |||||||||||||||||||||||||||||||||||||||||||
| 52 | 0 | PROMPT: | |||||||||||||||||||||||||||||||||||||||||
| 53 | print "Please enter $question"; | ||||||||||||||||||||||||||||||||||||||||||
| 54 | 0 | ▶ | print " [$default]" if ( $default && !$pass ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$default and not $pass
MC/DC0%0/2
$default and not $pass
$default
not $pass
Truth table0%0/3
A and not(B)
A= $defaultB= not $pass
| |||||||||||||||||||||||||||||||||||||||||||
| 55 | 0 | print ": "; | |||||||||||||||||||||||||||||||||||||||||
| 56 | |||||||||||||||||||||||||||||||||||||||||||
| 57 | 0 | ▶ | system "stty -echo" if $pass; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 58 | |||||||||||||||||||||||||||||||||||||||||||
| 59 | 0 | ▶ | if ( $p{timeout} ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 60 | 0 | eval { | |||||||||||||||||||||||||||||||||||||||||
| 61 | 0 | ▶ | local $SIG{ALRM} = sub { die "alarm\n" }; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
__ANON__: not called CC=1 SCAR=6.9
| |||||||||||||||||||||||||||||||||||||||||||
| 62 | 0 | alarm $p{timeout}; | |||||||||||||||||||||||||||||||||||||||||
| 63 | 0 | $response = <STDIN>; | |||||||||||||||||||||||||||||||||||||||||
| 64 | 0 | alarm 0; | |||||||||||||||||||||||||||||||||||||||||
| 65 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 66 | 0 | ▶ | if ($EVAL_ERROR) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 67 | 0 | ▶ | $EVAL_ERROR eq "alarm\n" ? print "timed out!\n" : warn; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 68 | } | ||||||||||||||||||||||||||||||||||||||||||
| 69 | } | ||||||||||||||||||||||||||||||||||||||||||
| 70 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 71 | 0 | $response = <STDIN>; | |||||||||||||||||||||||||||||||||||||||||
| 72 | } | ||||||||||||||||||||||||||||||||||||||||||
| 73 | |||||||||||||||||||||||||||||||||||||||||||
| 74 | 0 | ▶ | if ( $pass ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 75 | 0 | print "Please enter $question (confirm): "; | |||||||||||||||||||||||||||||||||||||||||
| 76 | 0 | my $response2 = <STDIN>; | |||||||||||||||||||||||||||||||||||||||||
| 77 | 0 | ▶ | unless ( $response eq $response2 ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 78 | 0 | print "\nPasswords don't match, try again.\n"; | |||||||||||||||||||||||||||||||||||||||||
| 79 | 0 | goto PROMPT; | |||||||||||||||||||||||||||||||||||||||||
| 80 | } | ||||||||||||||||||||||||||||||||||||||||||
| 81 | 0 | system "stty echo"; | |||||||||||||||||||||||||||||||||||||||||
| 82 | 0 | print "\n"; | |||||||||||||||||||||||||||||||||||||||||
| 83 | } | ||||||||||||||||||||||||||||||||||||||||||
| 84 | |||||||||||||||||||||||||||||||||||||||||||
| 85 | 0 | chomp $response; | |||||||||||||||||||||||||||||||||||||||||
| 86 | |||||||||||||||||||||||||||||||||||||||||||
| 87 | 0 | ▶ | return $response if $response; # if they typed something, return it | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 88 | 0 | ▶ | return $default if $default; # return the default, if available | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 89 | 0 | return ''; # return empty handed | |||||||||||||||||||||||||||||||||||||||||
| 90 | } | ||||||||||||||||||||||||||||||||||||||||||
| 91 | |||||||||||||||||||||||||||||||||||||||||||
| 92 | sub archive_file { | ||||||||||||||||||||||||||||||||||||||||||
| 93 | 5 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
archive_file: called CC=13 SCAR=36.5
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 94 | 5 | ▶ | my $file = shift or return $self->error("missing filename in request"); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 95 | 5 | my %p = validate( @_, | |||||||||||||||||||||||||||||||||||||||||
| 96 | { 'sudo' => { type => BOOLEAN, optional => 1, default => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 97 | 'mode' => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 98 | destdir => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 99 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 100 | } | ||||||||||||||||||||||||||||||||||||||||||
| 101 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 102 | |||||||||||||||||||||||||||||||||||||||||||
| 103 | 5 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 104 | |||||||||||||||||||||||||||||||||||||||||||
| 105 | 5 | ▶ | return $self->error( "file ($file) is missing!", %args ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 106 | if !-e $file; | ||||||||||||||||||||||||||||||||||||||||||
| 107 | |||||||||||||||||||||||||||||||||||||||||||
| 108 | 4 | my $archive = $file . '.' . time; | |||||||||||||||||||||||||||||||||||||||||
| 109 | |||||||||||||||||||||||||||||||||||||||||||
| 110 | 4 | ▶ | if ( $p{destdir} && -d $p{destdir} ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$p{"destdir"} and -d $p{"destdir"}
MC/DC0%0/2
$p{"destdir"} and -d $p{"destdir"}
$p{"destdir"}
-d $p{"destdir"}
Truth table33%1/3
A and B
A= $p{"destdir"}B= -d $p{"destdir"}
| |||||||||||||||||||||||||||||||||||||||||||
| 111 | 0 | my ($vol,$dirs,$file_wo_path) = File::Spec->splitpath( $archive ); | |||||||||||||||||||||||||||||||||||||||||
| 112 | 0 | $archive = File::Spec->catfile( $p{destdir}, $file_wo_path ); | |||||||||||||||||||||||||||||||||||||||||
| 113 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 114 | |||||||||||||||||||||||||||||||||||||||||||
| 115 | # see if we can write to both files (new & archive) with current user | ||||||||||||||||||||||||||||||||||||||||||
| 116 | 4 | ▶ | if ( $self->is_writable( $file, %args ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$self->is_writable($file, %args) and $self->is_writable($archive, %args)
MC/DC0%0/2
$self->is_writable($file, %args) and $self->is_writable($archive, %args)
$self->is_writable($file, %args)
$self->is_writable($archive, %args)
Truth table33%1/3
A and B
A= $self->is_writable($file, %args)B= $self->is_writable($archive, %args)
| |||||||||||||||||||||||||||||||||||||||||||
| 117 | && $self->is_writable( $archive, %args ) ) { | ||||||||||||||||||||||||||||||||||||||||||
| 118 | |||||||||||||||||||||||||||||||||||||||||||
| 119 | # we have permission, use perl's native copy | ||||||||||||||||||||||||||||||||||||||||||
| 120 | 4 | copy( $file, $archive ); | |||||||||||||||||||||||||||||||||||||||||
| 121 | 4 | ▶ | if ( -e $archive ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 122 | 4 | $self->audit("archive_file: $file backed up to $archive"); | |||||||||||||||||||||||||||||||||||||||||
| 123 | 4 | ▶ | $self->chmod( file => $file, mode => $p{mode}, %args ) if $p{mode}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 124 | 4 | return $archive; | |||||||||||||||||||||||||||||||||||||||||
| 125 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 126 | } | ||||||||||||||||||||||||||||||||||||||||||
| 127 | |||||||||||||||||||||||||||||||||||||||||||
| 128 | # we failed with existing permissions, try to escalate | ||||||||||||||||||||||||||||||||||||||||||
| 129 | 0 | ▶ | $self->archive_file_sudo( $file ) if ( $p{sudo} && $< != 0 ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$p{"sudo"} and $< != 0
MC/DC0%0/2
$p{"sudo"} and $< != 0
$p{"sudo"}
$< != 0
Truth table0%0/3
A and B
A= $p{"sudo"}B= $< != 0
| |||||||||||||||||||||||||||||||||||||||||||
| 130 | |||||||||||||||||||||||||||||||||||||||||||
| 131 | 0 | ▶ | return $self->error( "backup of $file to $archive failed: $!", %args) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 132 | if ! -e $archive; | ||||||||||||||||||||||||||||||||||||||||||
| 133 | |||||||||||||||||||||||||||||||||||||||||||
| 134 | 0 | ▶ | $self->chmod( file => $file, mode => $p{mode}, %args ) if $p{mode}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 135 | |||||||||||||||||||||||||||||||||||||||||||
| 136 | 0 | $self->audit("$file backed up to $archive"); | |||||||||||||||||||||||||||||||||||||||||
| 137 | 0 | return $archive; | |||||||||||||||||||||||||||||||||||||||||
| 138 | } | ||||||||||||||||||||||||||||||||||||||||||
| 139 | |||||||||||||||||||||||||||||||||||||||||||
| 140 | sub archive_file_sudo { | ||||||||||||||||||||||||||||||||||||||||||
| 141 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
archive_file_sudo: not called CC=3 SCAR=24.8
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 142 | 0 | my ($file, $archive) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 143 | |||||||||||||||||||||||||||||||||||||||||||
| 144 | 0 | my $sudo = $self->sudo(); | |||||||||||||||||||||||||||||||||||||||||
| 145 | 0 | my $cp = $self->find_bin( 'cp',fatal=>0 ); | |||||||||||||||||||||||||||||||||||||||||
| 146 | |||||||||||||||||||||||||||||||||||||||||||
| 147 | 0 | ▶ | if ( $sudo && $cp ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$sudo and $cp
MC/DC0%0/2
$sudo and $cp
$sudo
$cp
Truth table0%0/3
A and B
A= $sudoB= $cp
| |||||||||||||||||||||||||||||||||||||||||||
| 148 | 0 | return $self->syscmd( "$sudo $cp $file $archive",fatal=>0 ); | |||||||||||||||||||||||||||||||||||||||||
| 149 | } | ||||||||||||||||||||||||||||||||||||||||||
| 150 | 0 | $self->error( "archive_file: sudo or cp was missing, could not escalate.",fatal=>0); | |||||||||||||||||||||||||||||||||||||||||
| 151 | 0 | return; | |||||||||||||||||||||||||||||||||||||||||
| 152 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 153 | |||||||||||||||||||||||||||||||||||||||||||
| 154 | sub chmod { | ||||||||||||||||||||||||||||||||||||||||||
| 155 | 3 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
chmod: called CC=7 SCAR=25.2
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 156 | 3 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 157 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 158 | { 'file' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 159 | 'file_or_dir' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 160 | 'dir' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 161 | 'mode' => { type => SCALAR, optional => 0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 162 | 'sudo' => { type => BOOLEAN, optional => 1, default => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 163 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 164 | } | ||||||||||||||||||||||||||||||||||||||||||
| 165 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 166 | |||||||||||||||||||||||||||||||||||||||||||
| 167 | 3 | my $mode = $p{mode}; | |||||||||||||||||||||||||||||||||||||||||
| 168 | 3 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 169 | |||||||||||||||||||||||||||||||||||||||||||
| 170 | my $file = $p{file} || $p{file_or_dir} || $p{dir} | ||||||||||||||||||||||||||||||||||||||||||
| 171 | 3 | ▶ | or return $self->error( "invalid params to chmod in ". ref $self ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%2/6
$p{'file'} || $p{'file_or_dir'} || $p{'dir'}
$p{"file"} or $p{"file_or_dir"}
MC/DC0%0/3
$p{'file'} || $p{'file_or_dir'} || $p{'dir'}
$p{"file"}
$p{"file_or_dir"}
$p{'dir'}
Truth table25%1/4
A or B || C
A= $p{"file"}B= $p{"file_or_dir"}C= $p{'dir'}
| |||||||||||||||||||||||||||||||||||||||||||
| 172 | |||||||||||||||||||||||||||||||||||||||||||
| 173 | 3 | ▶ | if ( $p{sudo} ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 174 | 0 | my $chmod = $self->find_bin( 'chmod', verbose => 0 ); | |||||||||||||||||||||||||||||||||||||||||
| 175 | 0 | my $sudo = $self->sudo(); | |||||||||||||||||||||||||||||||||||||||||
| 176 | 0 | ▶ | $self->syscmd( "$sudo $chmod $mode $file", verbose => 0 ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 177 | or return $self->error( "couldn't chmod $file: $!", %args ); | ||||||||||||||||||||||||||||||||||||||||||
| 178 | } | ||||||||||||||||||||||||||||||||||||||||||
| 179 | |||||||||||||||||||||||||||||||||||||||||||
| 180 | # note the conversion of ($mode) to an octal value. Very important! | ||||||||||||||||||||||||||||||||||||||||||
| 181 | 3 | ▶ | CORE::chmod( oct($mode), $file ) or | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 182 | return $self->error( "couldn't chmod $file: $!", %args); | ||||||||||||||||||||||||||||||||||||||||||
| 183 | |||||||||||||||||||||||||||||||||||||||||||
| 184 | 3 | $self->audit("chmod $mode $file"); | |||||||||||||||||||||||||||||||||||||||||
| 185 | } | ||||||||||||||||||||||||||||||||||||||||||
| 186 | |||||||||||||||||||||||||||||||||||||||||||
| 187 | sub chown { | ||||||||||||||||||||||||||||||||||||||||||
| 188 | 3 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
chown: called CC=9 SCAR=23.3
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 189 | 3 | my $file = shift; | |||||||||||||||||||||||||||||||||||||||||
| 190 | 3 | my %p = validate( @_, | |||||||||||||||||||||||||||||||||||||||||
| 191 | { 'uid' => { type => SCALAR }, | ||||||||||||||||||||||||||||||||||||||||||
| 192 | 'gid' => { type => SCALAR }, | ||||||||||||||||||||||||||||||||||||||||||
| 193 | 'sudo' => { type => BOOLEAN, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 194 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 195 | } | ||||||||||||||||||||||||||||||||||||||||||
| 196 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 197 | |||||||||||||||||||||||||||||||||||||||||||
| 198 | 3 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 199 | 3 | my ( $uid, $gid, $sudo ) = ( $p{uid}, $p{gid}, $p{sudo} ); | |||||||||||||||||||||||||||||||||||||||||
| 200 | |||||||||||||||||||||||||||||||||||||||||||
| 201 | 3 | ▶ | $file or return $self->error( "missing file or dir", %args ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 202 | 3 | ▶ | return $self->error( "file $file does not exist!", %args ) if ! -e $file; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 203 | |||||||||||||||||||||||||||||||||||||||||||
| 204 | 3 | $self->audit("chown: preparing to chown $uid $file"); | |||||||||||||||||||||||||||||||||||||||||
| 205 | |||||||||||||||||||||||||||||||||||||||||||
| 206 | # sudo forces system chown instead of the perl builtin | ||||||||||||||||||||||||||||||||||||||||||
| 207 | 3 | ▶ | return $self->chown_system( $file, | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 208 | %args, | ||||||||||||||||||||||||||||||||||||||||||
| 209 | user => $uid, | ||||||||||||||||||||||||||||||||||||||||||
| 210 | group => $gid, | ||||||||||||||||||||||||||||||||||||||||||
| 211 | ) if $sudo; | ||||||||||||||||||||||||||||||||||||||||||
| 212 | |||||||||||||||||||||||||||||||||||||||||||
| 213 | 3 | my ( $nuid, $ngid ); # if uid or gid is not numeric, convert it | |||||||||||||||||||||||||||||||||||||||||
| 214 | |||||||||||||||||||||||||||||||||||||||||||
| 215 | 3 | ▶ | if ( $uid =~ /\A[0-9]+\z/ ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 216 | 0 | $nuid = int($uid); | |||||||||||||||||||||||||||||||||||||||||
| 217 | 0 | $self->audit(" using $nuid from int($uid)"); | |||||||||||||||||||||||||||||||||||||||||
| 218 | } | ||||||||||||||||||||||||||||||||||||||||||
| 219 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 220 | 3 | $nuid = getpwnam($uid); | |||||||||||||||||||||||||||||||||||||||||
| 221 | 3 | ▶ | return $self->error( "failed to get uid for $uid", %args) if ! defined $nuid; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 222 | 2 | $self->audit(" converted $uid to a number: $nuid"); | |||||||||||||||||||||||||||||||||||||||||
| 223 | } | ||||||||||||||||||||||||||||||||||||||||||
| 224 | |||||||||||||||||||||||||||||||||||||||||||
| 225 | 2 | ▶ | if ( $gid =~ /\A[0-9\-]+\z/ ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 226 | 0 | $ngid = int( $gid ); | |||||||||||||||||||||||||||||||||||||||||
| 227 | 0 | $self->audit(" using $ngid from int($gid)"); | |||||||||||||||||||||||||||||||||||||||||
| 228 | } | ||||||||||||||||||||||||||||||||||||||||||
| 229 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 230 | 2 | $ngid = getgrnam( $gid ); | |||||||||||||||||||||||||||||||||||||||||
| 231 | 2 | ▶ | return $self->error( "failed to get gid for $gid", %args) if ! defined $ngid; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 232 | 2 | $self->audit(" converted $gid to numeric: $ngid"); | |||||||||||||||||||||||||||||||||||||||||
| 233 | } | ||||||||||||||||||||||||||||||||||||||||||
| 234 | |||||||||||||||||||||||||||||||||||||||||||
| 235 | 2 | ▶ | chown( $nuid, $ngid, $file ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 236 | or return $self->error( "couldn't chown $file: $!",%args); | ||||||||||||||||||||||||||||||||||||||||||
| 237 | |||||||||||||||||||||||||||||||||||||||||||
| 238 | 1 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 239 | } | ||||||||||||||||||||||||||||||||||||||||||
| 240 | |||||||||||||||||||||||||||||||||||||||||||
| 241 | sub chown_system { | ||||||||||||||||||||||||||||||||||||||||||
| 242 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
chown_system: not called CC=6 SCAR=37.4
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 243 | 0 | my $dir = shift; | |||||||||||||||||||||||||||||||||||||||||
| 244 | 0 | my %p = validate( @_, | |||||||||||||||||||||||||||||||||||||||||
| 245 | { 'user' => { type => SCALAR, optional => 0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 246 | 'group' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 247 | 'recurse' => { type => BOOLEAN, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 248 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 249 | } | ||||||||||||||||||||||||||||||||||||||||||
| 250 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 251 | |||||||||||||||||||||||||||||||||||||||||||
| 252 | 0 | my ( $user, $group, $recurse ) = ( $p{user}, $p{group}, $p{recurse} ); | |||||||||||||||||||||||||||||||||||||||||
| 253 | 0 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 254 | |||||||||||||||||||||||||||||||||||||||||||
| 255 | 0 | ▶ | $dir or return $self->error( "missing file or dir", %args ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 256 | 0 | my $cmd = $self->find_bin( 'chown', %args ); | |||||||||||||||||||||||||||||||||||||||||
| 257 | |||||||||||||||||||||||||||||||||||||||||||
| 258 | 0 | ▶ | $cmd .= " -R" if $recurse; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 259 | 0 | $cmd .= " $user"; | |||||||||||||||||||||||||||||||||||||||||
| 260 | 0 | ▶ | $cmd .= ":$group" if $group; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 261 | 0 | $cmd .= " $dir"; | |||||||||||||||||||||||||||||||||||||||||
| 262 | |||||||||||||||||||||||||||||||||||||||||||
| 263 | 0 | $self->audit( "cmd: $cmd" ); | |||||||||||||||||||||||||||||||||||||||||
| 264 | |||||||||||||||||||||||||||||||||||||||||||
| 265 | 0 | ▶ | $self->syscmd( $cmd, %args ) or | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 266 | return $self->error( "couldn't chown with $cmd: $!", %args); | ||||||||||||||||||||||||||||||||||||||||||
| 267 | |||||||||||||||||||||||||||||||||||||||||||
| 268 | 0 | my $mess; | |||||||||||||||||||||||||||||||||||||||||
| 269 | 0 | ▶ | $mess .= "Recursively " if $recurse; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 270 | 0 | $mess .= "changed $dir to be owned by $user"; | |||||||||||||||||||||||||||||||||||||||||
| 271 | 0 | $self->audit( $mess ); | |||||||||||||||||||||||||||||||||||||||||
| 272 | |||||||||||||||||||||||||||||||||||||||||||
| 273 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 274 | } | ||||||||||||||||||||||||||||||||||||||||||
| 275 | |||||||||||||||||||||||||||||||||||||||||||
| 276 | sub clean_tmp_dir { | ||||||||||||||||||||||||||||||||||||||||||
| 277 | 2 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
clean_tmp_dir: called CC=9 SCAR=23.1
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 278 | 2 | ▶ | my $dir = shift or die "missing dir name"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 279 | 2 | my %p = validate( @_, { $self->get_std_opts } ); | |||||||||||||||||||||||||||||||||||||||||
| 280 | |||||||||||||||||||||||||||||||||||||||||||
| 281 | 2 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 282 | |||||||||||||||||||||||||||||||||||||||||||
| 283 | 2 | my $before = cwd; # remember where we started | |||||||||||||||||||||||||||||||||||||||||
| 284 | |||||||||||||||||||||||||||||||||||||||||||
| 285 | 2 | ▶ | return $self->error( "couldn't chdir to $dir: $!", %args) if !chdir $dir; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 286 | |||||||||||||||||||||||||||||||||||||||||||
| 287 | 2 | foreach ( $self->get_dir_files( $dir ) ) { | |||||||||||||||||||||||||||||||||||||||||
| 288 | 4 | ▶ | next unless $_; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 289 | |||||||||||||||||||||||||||||||||||||||||||
| 290 | 4 | my ($file) = $_ =~ /^(.*)$/; | |||||||||||||||||||||||||||||||||||||||||
| 291 | |||||||||||||||||||||||||||||||||||||||||||
| 292 | 4 | $self->audit( "deleting file $file" ); | |||||||||||||||||||||||||||||||||||||||||
| 293 | |||||||||||||||||||||||||||||||||||||||||||
| 294 | 4 | ▶ | if ( -f $file ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 295 | 3 | ▶ | unlink $file or | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 296 | $self->file_delete( $file, %args ); | ||||||||||||||||||||||||||||||||||||||||||
| 297 | } | ||||||||||||||||||||||||||||||||||||||||||
| 298 | elsif ( -d $file ) { | ||||||||||||||||||||||||||||||||||||||||||
| 299 | 1 | ▶ | rmtree $file or return $self->error( "couldn't delete $file", %args); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 300 | } | ||||||||||||||||||||||||||||||||||||||||||
| 301 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 302 | 0 | $self->audit( "Cannot delete unknown entity: $file" ); | |||||||||||||||||||||||||||||||||||||||||
| 303 | } | ||||||||||||||||||||||||||||||||||||||||||
| 304 | } | ||||||||||||||||||||||||||||||||||||||||||
| 305 | |||||||||||||||||||||||||||||||||||||||||||
| 306 | 2 | chdir $before; | |||||||||||||||||||||||||||||||||||||||||
| 307 | 2 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 308 | } | ||||||||||||||||||||||||||||||||||||||||||
| 309 | |||||||||||||||||||||||||||||||||||||||||||
| 310 | sub cwd_source_dir { | ||||||||||||||||||||||||||||||||||||||||||
| 311 | 2 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
cwd_source_dir: called CC=9 SCAR=27.2
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 312 | 2 | ▶ | my $dir = shift or die "missing dir in request\n"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 313 | 2 | my %p = validate( @_, | |||||||||||||||||||||||||||||||||||||||||
| 314 | { 'src' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 315 | 'sudo' => { type => BOOLEAN, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 316 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 317 | } | ||||||||||||||||||||||||||||||||||||||||||
| 318 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 319 | |||||||||||||||||||||||||||||||||||||||||||
| 320 | 2 | my ( $src, $sudo, ) = ( $p{src}, $p{sudo}, ); | |||||||||||||||||||||||||||||||||||||||||
| 321 | 2 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 322 | |||||||||||||||||||||||||||||||||||||||||||
| 323 | 2 | ▶ | return $self->error( "Something (other than a directory) is at $dir and " . | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
-e $dir and not -d $dir
MC/DC0%0/2
-e $dir and not -d $dir
-e $dir
not -d $dir
Truth table66%2/3
A and not(B)
A= -e $dirB= not -d $dir
| |||||||||||||||||||||||||||||||||||||||||||
| 324 | "that's my build directory. Please remove it and try again!", %args ) | ||||||||||||||||||||||||||||||||||||||||||
| 325 | if ( -e $dir && !-d $dir ); | ||||||||||||||||||||||||||||||||||||||||||
| 326 | |||||||||||||||||||||||||||||||||||||||||||
| 327 | 2 | ▶ | if ( !-d $dir ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 328 | |||||||||||||||||||||||||||||||||||||||||||
| 329 | 1 | $self->_try_mkdir( $dir ); # use the perl builtin mkdir | |||||||||||||||||||||||||||||||||||||||||
| 330 | |||||||||||||||||||||||||||||||||||||||||||
| 331 | 1 | ▶ | if ( !-d $dir ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 332 | 0 | $self->audit( "trying again with system mkdir..."); | |||||||||||||||||||||||||||||||||||||||||
| 333 | 0 | $self->mkdir_system( dir => $dir, %args); | |||||||||||||||||||||||||||||||||||||||||
| 334 | |||||||||||||||||||||||||||||||||||||||||||
| 335 | 0 | ▶ | if ( !-d $dir ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 336 | 0 | $self->audit( "trying one last time with $sudo mkdir -p...."); | |||||||||||||||||||||||||||||||||||||||||
| 337 | 0 | ▶ | $self->mkdir_system( dir => $dir, sudo => 1, %args) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 338 | or return $self->error("Couldn't create $dir.", %args); | ||||||||||||||||||||||||||||||||||||||||||
| 339 | } | ||||||||||||||||||||||||||||||||||||||||||
| 340 | } | ||||||||||||||||||||||||||||||||||||||||||
| 341 | } | ||||||||||||||||||||||||||||||||||||||||||
| 342 | |||||||||||||||||||||||||||||||||||||||||||
| 343 | 2 | ▶ | chdir $dir or return $self->error( "failed to cd to $dir: $!", %args); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 344 | 2 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 345 | } | ||||||||||||||||||||||||||||||||||||||||||
| 346 | |||||||||||||||||||||||||||||||||||||||||||
| 347 | sub _try_mkdir { | ||||||||||||||||||||||||||||||||||||||||||
| 348 | 1 | ▶ | my ($self, $dir ) = @_; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
_try_mkdir: called CC=2 SCAR=7.0
| |||||||||||||||||||||||||||||||||||||||||||
| 349 | 1 | ▶ | mkpath( $dir, 0, oct('0755') ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 350 | or return $self->error( "mkdir $dir failed: $!"); | ||||||||||||||||||||||||||||||||||||||||||
| 351 | 1 | $self->audit( "created $dir"); | |||||||||||||||||||||||||||||||||||||||||
| 352 | 1 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 353 | } | ||||||||||||||||||||||||||||||||||||||||||
| 354 | |||||||||||||||||||||||||||||||||||||||||||
| 355 | sub extract_archive { | ||||||||||||||||||||||||||||||||||||||||||
| 356 | 2 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
extract_archive: called CC=11 SCAR=28.3
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 357 | 2 | ▶ | my $archive = shift or die "missing archive name"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 358 | 2 | my %p = validate( @_, { $self->get_std_opts } ); | |||||||||||||||||||||||||||||||||||||||||
| 359 | 2 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 360 | |||||||||||||||||||||||||||||||||||||||||||
| 361 | 2 | my $r; | |||||||||||||||||||||||||||||||||||||||||
| 362 | 2 | my %types = ( | |||||||||||||||||||||||||||||||||||||||||
| 363 | gz => { bin => 'gunzip', content => 'gzip', }, | ||||||||||||||||||||||||||||||||||||||||||
| 364 | bz2 => { bin => 'bunzip2', content => 'b(un)?zip2', }, # BSD bunzip2, Linux bzip2 | ||||||||||||||||||||||||||||||||||||||||||
| 365 | xz => { bin => 'xz', content => 'xz', }, | ||||||||||||||||||||||||||||||||||||||||||
| 366 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 367 | |||||||||||||||||||||||||||||||||||||||||||
| 368 | 2 | ▶ | if ( !-e $archive ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 369 | 1 | foreach my $ext ( keys %types, map { 'tar.' . $_ } keys %types ) { | |||||||||||||||||||||||||||||||||||||||||
| 370 | 6 | ▶ | next if ! -e "$archive.$ext"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 371 | 0 | $archive = "$archive.$ext"; | |||||||||||||||||||||||||||||||||||||||||
| 372 | 0 | last; | |||||||||||||||||||||||||||||||||||||||||
| 373 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 374 | } | ||||||||||||||||||||||||||||||||||||||||||
| 375 | 2 | ▶ | return $self->error( "file $archive is missing!", %args ) if ! -e $archive; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 376 | |||||||||||||||||||||||||||||||||||||||||||
| 377 | 1 | $self->audit("found $archive"); | |||||||||||||||||||||||||||||||||||||||||
| 378 | |||||||||||||||||||||||||||||||||||||||||||
| 379 | 1 | ▶ | my $type | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 3 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 380 | = $archive =~ /bz2$/ ? 'bz2' | ||||||||||||||||||||||||||||||||||||||||||
| 381 | : $archive =~ /gz$/ ? 'gz' | ||||||||||||||||||||||||||||||||||||||||||
| 382 | : $archive =~ /xz$/ ? 'xz' | ||||||||||||||||||||||||||||||||||||||||||
| 383 | : return $self->error( 'unknown archive type', %args); | ||||||||||||||||||||||||||||||||||||||||||
| 384 | |||||||||||||||||||||||||||||||||||||||||||
| 385 | # find binaries to inspect and expand the archive | ||||||||||||||||||||||||||||||||||||||||||
| 386 | 1 | my $tar = $self->find_bin( 'tar', %args ); | |||||||||||||||||||||||||||||||||||||||||
| 387 | 1 | my $file = $self->find_bin( 'file', %args ); | |||||||||||||||||||||||||||||||||||||||||
| 388 | |||||||||||||||||||||||||||||||||||||||||||
| 389 | # make sure the archive contents match the file extension | ||||||||||||||||||||||||||||||||||||||||||
| 390 | 1 | $ENV{PATH} = '/bin:/usr/bin'; # prevent taint checks from barfing on `` | |||||||||||||||||||||||||||||||||||||||||
| 391 | 1 | ▶ | return $self->error( "$archive not a $type compressed file", %args) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 392 | unless grep ( /$types{$type}{content}/, `$file $archive` ); | ||||||||||||||||||||||||||||||||||||||||||
| 393 | |||||||||||||||||||||||||||||||||||||||||||
| 394 | 0 | my $bin = $self->find_bin( $types{$type}{bin}, %args); | |||||||||||||||||||||||||||||||||||||||||
| 395 | |||||||||||||||||||||||||||||||||||||||||||
| 396 | 0 | ▶ | $self->syscmd( "$bin -c $archive | $tar -xf -" ) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 397 | |||||||||||||||||||||||||||||||||||||||||||
| 398 | 0 | $self->audit( "extracted $archive" ); | |||||||||||||||||||||||||||||||||||||||||
| 399 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 400 | } | ||||||||||||||||||||||||||||||||||||||||||
| 401 | |||||||||||||||||||||||||||||||||||||||||||
| 402 | sub file_delete { | ||||||||||||||||||||||||||||||||||||||||||
| 403 | 6 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
file_delete: called CC=10 SCAR=35.1
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 404 | 6 | ▶ | my $file = shift or die "missing file argument"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 405 | 6 | my %p = validate( @_, | |||||||||||||||||||||||||||||||||||||||||
| 406 | { 'sudo' => { type => BOOLEAN, optional => 1, default => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 407 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 408 | } | ||||||||||||||||||||||||||||||||||||||||||
| 409 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 410 | |||||||||||||||||||||||||||||||||||||||||||
| 411 | 6 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 412 | |||||||||||||||||||||||||||||||||||||||||||
| 413 | 6 | ▶ | return $self->error( "$file does not exist", %args ) if !-e $file; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 414 | |||||||||||||||||||||||||||||||||||||||||||
| 415 | 5 | ▶ | if ( -w $file ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 416 | 5 | $self->audit( "write permission to $file: ok" ); | |||||||||||||||||||||||||||||||||||||||||
| 417 | |||||||||||||||||||||||||||||||||||||||||||
| 418 | 5 | ▶ | unlink $file or return $self->error( "failed to delete $file", %args ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 419 | |||||||||||||||||||||||||||||||||||||||||||
| 420 | 5 | $self->audit( "deleted: $file" ); | |||||||||||||||||||||||||||||||||||||||||
| 421 | 5 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 422 | } | ||||||||||||||||||||||||||||||||||||||||||
| 423 | |||||||||||||||||||||||||||||||||||||||||||
| 424 | 0 | ▶ | if ( !$p{sudo} ) { # all done | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 425 | 0 | ▶ | return -e $file ? undef : 1; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 426 | } | ||||||||||||||||||||||||||||||||||||||||||
| 427 | |||||||||||||||||||||||||||||||||||||||||||
| 428 | 0 | my $err = "trying with system rm"; | |||||||||||||||||||||||||||||||||||||||||
| 429 | 0 | my $rm_command = $self->find_bin( "rm", %args ); | |||||||||||||||||||||||||||||||||||||||||
| 430 | 0 | $rm_command .= " -f $file"; | |||||||||||||||||||||||||||||||||||||||||
| 431 | |||||||||||||||||||||||||||||||||||||||||||
| 432 | 0 | ▶ | if ( $< != 0 ) { # we're not running as root | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 433 | 0 | my $sudo = $self->sudo( %args ); | |||||||||||||||||||||||||||||||||||||||||
| 434 | 0 | $rm_command = "$sudo $rm_command"; | |||||||||||||||||||||||||||||||||||||||||
| 435 | 0 | $err .= " (sudo)"; | |||||||||||||||||||||||||||||||||||||||||
| 436 | } | ||||||||||||||||||||||||||||||||||||||||||
| 437 | |||||||||||||||||||||||||||||||||||||||||||
| 438 | 0 | ▶ | $self->syscmd( $rm_command, %args ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 439 | or return $self->error( $err, %args ); | ||||||||||||||||||||||||||||||||||||||||||
| 440 | |||||||||||||||||||||||||||||||||||||||||||
| 441 | 0 | ▶ | return -e $file ? 0 : 1; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 442 | } | ||||||||||||||||||||||||||||||||||||||||||
| 443 | |||||||||||||||||||||||||||||||||||||||||||
| 444 | sub file_is_newer { | ||||||||||||||||||||||||||||||||||||||||||
| 445 | 2 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
file_is_newer: called CC=2 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 446 | 2 | my %p = validate( @_, | |||||||||||||||||||||||||||||||||||||||||
| 447 | { f1 => { type => SCALAR }, | ||||||||||||||||||||||||||||||||||||||||||
| 448 | f2 => { type => SCALAR }, | ||||||||||||||||||||||||||||||||||||||||||
| 449 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 450 | } | ||||||||||||||||||||||||||||||||||||||||||
| 451 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 452 | |||||||||||||||||||||||||||||||||||||||||||
| 453 | 2 | my ( $file1, $file2 ) = ( $p{f1}, $p{f2} ); | |||||||||||||||||||||||||||||||||||||||||
| 454 | |||||||||||||||||||||||||||||||||||||||||||
| 455 | # get file attributes via stat | ||||||||||||||||||||||||||||||||||||||||||
| 456 | # (dev,ino,mode,nlink,uid,gid,rdev,size,atime,mtime,ctime,blksize,blocks) | ||||||||||||||||||||||||||||||||||||||||||
| 457 | |||||||||||||||||||||||||||||||||||||||||||
| 458 | 2 | $self->audit( "checking age of $file1 and $file2" ); | |||||||||||||||||||||||||||||||||||||||||
| 459 | |||||||||||||||||||||||||||||||||||||||||||
| 460 | 2 | my $stat1 = stat($file1)->mtime; | |||||||||||||||||||||||||||||||||||||||||
| 461 | 2 | my $stat2 = stat($file2)->mtime; | |||||||||||||||||||||||||||||||||||||||||
| 462 | |||||||||||||||||||||||||||||||||||||||||||
| 463 | 2 | $self->audit( "timestamps are $stat1 and $stat2"); | |||||||||||||||||||||||||||||||||||||||||
| 464 | |||||||||||||||||||||||||||||||||||||||||||
| 465 | 2 | ▶ | return 1 if ( $stat2 > $stat1 ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 466 | 1 | return; | |||||||||||||||||||||||||||||||||||||||||
| 467 | |||||||||||||||||||||||||||||||||||||||||||
| 468 | # I could just: | ||||||||||||||||||||||||||||||||||||||||||
| 469 | # | ||||||||||||||||||||||||||||||||||||||||||
| 470 | # if ( stat($f1)[9] > stat($f2)[9] ) | ||||||||||||||||||||||||||||||||||||||||||
| 471 | # | ||||||||||||||||||||||||||||||||||||||||||
| 472 | # but that forces the reader to read the man page for stat | ||||||||||||||||||||||||||||||||||||||||||
| 473 | # to see what's happening | ||||||||||||||||||||||||||||||||||||||||||
| 474 | } | ||||||||||||||||||||||||||||||||||||||||||
| 475 | |||||||||||||||||||||||||||||||||||||||||||
| 476 | sub file_read { | ||||||||||||||||||||||||||||||||||||||||||
| 477 | 11 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
file_read: called CC=10 SCAR=33.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 478 | 11 | ▶ | my $file = shift or return $self->error("missing filename in request"); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 479 | 11 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 480 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 481 | { 'max_lines' => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 482 | 'max_length' => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 483 | $self->get_std_opts | ||||||||||||||||||||||||||||||||||||||||||
| 484 | } | ||||||||||||||||||||||||||||||||||||||||||
| 485 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 486 | |||||||||||||||||||||||||||||||||||||||||||
| 487 | 11 | my ( $max_lines, $max_length ) = ( $p{max_lines}, $p{max_length} ); | |||||||||||||||||||||||||||||||||||||||||
| 488 | 11 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 489 | |||||||||||||||||||||||||||||||||||||||||||
| 490 | 11 | ▶ | return $self->error( "$file does not exist!", %args) if !-e $file; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 491 | 11 | ▶ | return $self->error( "$file is not readable", %args ) if !-r $file; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 492 | |||||||||||||||||||||||||||||||||||||||||||
| 493 | 11 | ▶ | open my $FILE, '<', $file or | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 494 | return $self->error( "could not open $file: $OS_ERROR", %args ); | ||||||||||||||||||||||||||||||||||||||||||
| 495 | |||||||||||||||||||||||||||||||||||||||||||
| 496 | 11 | my ( $line, @lines ); | |||||||||||||||||||||||||||||||||||||||||
| 497 | |||||||||||||||||||||||||||||||||||||||||||
| 498 | 11 | ▶ | if ( ! $max_lines) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 499 | 11 | chomp( @lines = <$FILE> ); | |||||||||||||||||||||||||||||||||||||||||
| 500 | 11 | close $FILE; | |||||||||||||||||||||||||||||||||||||||||
| 501 | 11 | return @lines; | |||||||||||||||||||||||||||||||||||||||||
| 502 | # TODO: make max_length work with slurp mode, without doing something ugly like | ||||||||||||||||||||||||||||||||||||||||||
| 503 | # reading in the entire line and then truncating it. | ||||||||||||||||||||||||||||||||||||||||||
| 504 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 505 | |||||||||||||||||||||||||||||||||||||||||||
| 506 | 0 | my $i = 0; | |||||||||||||||||||||||||||||||||||||||||
| 507 | 0 | ▶ | while ( $i < $max_lines ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 508 | 0 | ▶ | if ($max_length) { $line = substr <$FILE>, 0, $max_length; } | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 509 | 0 | else { $line = <$FILE>; }; | |||||||||||||||||||||||||||||||||||||||||
| 510 | 0 | ▶ | last if ! $line; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 511 | 0 | ▶ | last if eof $FILE; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 512 | 0 | push @lines, $line; | |||||||||||||||||||||||||||||||||||||||||
| 513 | 0 | $i++; | |||||||||||||||||||||||||||||||||||||||||
| 514 | } | ||||||||||||||||||||||||||||||||||||||||||
| 515 | 0 | chomp @lines; | |||||||||||||||||||||||||||||||||||||||||
| 516 | 0 | close $FILE; | |||||||||||||||||||||||||||||||||||||||||
| 517 | 0 | return @lines; | |||||||||||||||||||||||||||||||||||||||||
| 518 | } | ||||||||||||||||||||||||||||||||||||||||||
| 519 | |||||||||||||||||||||||||||||||||||||||||||
| 520 | sub file_mode { | ||||||||||||||||||||||||||||||||||||||||||
| 521 | 1 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
file_mode: called CC=2 SCAR=7.0
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 522 | 1 | my %p = validate( @_, | |||||||||||||||||||||||||||||||||||||||||
| 523 | { 'file' => { type => SCALAR }, | ||||||||||||||||||||||||||||||||||||||||||
| 524 | $self->get_std_opts | ||||||||||||||||||||||||||||||||||||||||||
| 525 | } | ||||||||||||||||||||||||||||||||||||||||||
| 526 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 527 | |||||||||||||||||||||||||||||||||||||||||||
| 528 | 1 | my $file = $p{file}; | |||||||||||||||||||||||||||||||||||||||||
| 529 | 1 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 530 | |||||||||||||||||||||||||||||||||||||||||||
| 531 | 1 | ▶ | return $self->error( "file '$file' does not exist!", %args) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 532 | if !-e $file; | ||||||||||||||||||||||||||||||||||||||||||
| 533 | |||||||||||||||||||||||||||||||||||||||||||
| 534 | # one way to get file mode (using File::mode) | ||||||||||||||||||||||||||||||||||||||||||
| 535 | # my $raw_mode = stat($file)->[2]; | ||||||||||||||||||||||||||||||||||||||||||
| 536 | ## no critic | ||||||||||||||||||||||||||||||||||||||||||
| 537 | 1 | my $mode = sprintf "%04o", stat($file)->[2] & 07777; | |||||||||||||||||||||||||||||||||||||||||
| 538 | |||||||||||||||||||||||||||||||||||||||||||
| 539 | # another way to get it | ||||||||||||||||||||||||||||||||||||||||||
| 540 | # my $st = stat($file); | ||||||||||||||||||||||||||||||||||||||||||
| 541 | # my $mode = sprintf "%lo", $st->mode & 07777; | ||||||||||||||||||||||||||||||||||||||||||
| 542 | |||||||||||||||||||||||||||||||||||||||||||
| 543 | 1 | $self->audit( "file $file has mode: $mode" ); | |||||||||||||||||||||||||||||||||||||||||
| 544 | 1 | return $mode; | |||||||||||||||||||||||||||||||||||||||||
| 545 | } | ||||||||||||||||||||||||||||||||||||||||||
| 546 | |||||||||||||||||||||||||||||||||||||||||||
| 547 | sub file_write { | ||||||||||||||||||||||||||||||||||||||||||
| 548 | 9 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
file_write: called CC=13 SCAR=27.6
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 549 | 9 | ▶ | my $file = shift or return $self->error("missing filename in request"); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 550 | 9 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 551 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 552 | { 'lines' => { type => ARRAYREF }, | ||||||||||||||||||||||||||||||||||||||||||
| 553 | 'append' => { type => BOOLEAN, optional => 1, default => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 554 | 'mode' => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 555 | $self->get_std_opts | ||||||||||||||||||||||||||||||||||||||||||
| 556 | } | ||||||||||||||||||||||||||||||||||||||||||
| 557 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 558 | |||||||||||||||||||||||||||||||||||||||||||
| 559 | 9 | my $append = $p{append}; | |||||||||||||||||||||||||||||||||||||||||
| 560 | 9 | my $lines = $p{lines}; | |||||||||||||||||||||||||||||||||||||||||
| 561 | 9 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 562 | |||||||||||||||||||||||||||||||||||||||||||
| 563 | 9 | ▶ | return $self->error( "oops, $file is a directory", %args) if -d $file; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 564 | 9 | ▶ | return $self->error( "oops, $file is not writable", %args ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 565 | if ( ! $self->is_writable( $file, %args) ); | ||||||||||||||||||||||||||||||||||||||||||
| 566 | |||||||||||||||||||||||||||||||||||||||||||
| 567 | 9 | my $m = "wrote"; | |||||||||||||||||||||||||||||||||||||||||
| 568 | 9 | my $write_mode = '>'; # (over)write | |||||||||||||||||||||||||||||||||||||||||
| 569 | |||||||||||||||||||||||||||||||||||||||||||
| 570 | 9 | ▶ | if ( $append ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 571 | 3 | $m = "appended"; | |||||||||||||||||||||||||||||||||||||||||
| 572 | 3 | $write_mode = '>>'; | |||||||||||||||||||||||||||||||||||||||||
| 573 | 3 | ▶ | if ( -f $file ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 574 | 3 | ▶ | copy $file, "$file.tmp" or return $self->error( | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 575 | "couldn't create $file.tmp for safe append", %args ); | ||||||||||||||||||||||||||||||||||||||||||
| 576 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 577 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 578 | |||||||||||||||||||||||||||||||||||||||||||
| 579 | 9 | ▶ | open my $HANDLE, $write_mode, "$file.tmp" | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 580 | or return $self->error( "file_write: couldn't open $file: $!", %args ); | ||||||||||||||||||||||||||||||||||||||||||
| 581 | |||||||||||||||||||||||||||||||||||||||||||
| 582 | 9 | my $c = 0; | |||||||||||||||||||||||||||||||||||||||||
| 583 | 9 | foreach ( @$lines ) { chomp; print $HANDLE "$_\n"; $c++ }; | |||||||||||||||||||||||||||||||||||||||||
| 584 | 9 | ▶ | close $HANDLE or return $self->error( "couldn't close $file: $!", %args ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 585 | |||||||||||||||||||||||||||||||||||||||||||
| 586 | 9 | $self->audit( "file_write: $m $c lines to $file", %args ); | |||||||||||||||||||||||||||||||||||||||||
| 587 | |||||||||||||||||||||||||||||||||||||||||||
| 588 | 9 | ▶ | move( "$file.tmp", $file ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 589 | or return $self->error(" unable to update $file", %args); | ||||||||||||||||||||||||||||||||||||||||||
| 590 | |||||||||||||||||||||||||||||||||||||||||||
| 591 | # set file permissions mode if requested | ||||||||||||||||||||||||||||||||||||||||||
| 592 | $self->chmod( file => $file, mode => $p{mode}, %args ) | ||||||||||||||||||||||||||||||||||||||||||
| 593 | 9 | ▶ | or return if $p{mode}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition20%1/5
$p{'mode'} && ($self->chmod('file', $file, 'mode', $p{'mode'}, %args) || (return))
$self->chmod("file", $file, "mode", $p{"mode"}, %args) or return
MC/DC0%0/2
$p{'mode'} && ($self->chmod('file', $file, 'mode', $p{'mode'}, %args) || (return))
$p{'mode'}
$self->chmod("file", $file, "mode", $p{"mode"}, %args)
Truth table33%1/3
A && B
A= $p{'mode'}B= $self->chmod("file", $file, "mode", $p{"mode"}, %args)
| |||||||||||||||||||||||||||||||||||||||||||
| 594 | |||||||||||||||||||||||||||||||||||||||||||
| 595 | 9 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 596 | } | ||||||||||||||||||||||||||||||||||||||||||
| 597 | |||||||||||||||||||||||||||||||||||||||||||
| 598 | sub files_diff { | ||||||||||||||||||||||||||||||||||||||||||
| 599 | 5 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
files_diff: called CC=4 SCAR=14.5
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 600 | 5 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 601 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 602 | { f1 => { type => SCALAR }, | ||||||||||||||||||||||||||||||||||||||||||
| 603 | f2 => { type => SCALAR }, | ||||||||||||||||||||||||||||||||||||||||||
| 604 | type => { type => SCALAR, optional => 1, default => 'text' }, | ||||||||||||||||||||||||||||||||||||||||||
| 605 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 606 | } | ||||||||||||||||||||||||||||||||||||||||||
| 607 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 608 | |||||||||||||||||||||||||||||||||||||||||||
| 609 | 5 | my ( $f1, $f2, $type ) = ( $p{f1}, $p{f2}, $p{type} ); | |||||||||||||||||||||||||||||||||||||||||
| 610 | 5 | my %args = $self->get_std_args(%p); | |||||||||||||||||||||||||||||||||||||||||
| 611 | |||||||||||||||||||||||||||||||||||||||||||
| 612 | 5 | ▶ | if ( !-e $f1 || !-e $f2 ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
-e $f1 and -e $f2
MC/DC0%0/2
-e $f1 and -e $f2
-e $f1
-e $f2
Truth table33%1/3
A and B
A= -e $f1B= -e $f2
| |||||||||||||||||||||||||||||||||||||||||||
| 613 | 0 | $self->error( "$f1 or $f2 does not exist!", %args ); | |||||||||||||||||||||||||||||||||||||||||
| 614 | 0 | return -1; | |||||||||||||||||||||||||||||||||||||||||
| 615 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 616 | |||||||||||||||||||||||||||||||||||||||||||
| 617 | 5 | ▶ | return $self->files_diff_md5( $f1, $f2, \%args) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 618 | if $type ne "text"; | ||||||||||||||||||||||||||||||||||||||||||
| 619 | |||||||||||||||||||||||||||||||||||||||||||
| 620 | ### TODO | ||||||||||||||||||||||||||||||||||||||||||
| 621 | # use file here to make sure files are ASCII | ||||||||||||||||||||||||||||||||||||||||||
| 622 | # | ||||||||||||||||||||||||||||||||||||||||||
| 623 | 3 | $self->audit("comparing ascii files $f1 and $f2 using diff", %args); | |||||||||||||||||||||||||||||||||||||||||
| 624 | |||||||||||||||||||||||||||||||||||||||||||
| 625 | 3 | my $diff = $self->find_bin( 'diff', %args ); | |||||||||||||||||||||||||||||||||||||||||
| 626 | 3 | my $r = `$diff $f1 $f2`; | |||||||||||||||||||||||||||||||||||||||||
| 627 | 3 | chomp $r; | |||||||||||||||||||||||||||||||||||||||||
| 628 | 3 | return $r; | |||||||||||||||||||||||||||||||||||||||||
| 629 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 630 | |||||||||||||||||||||||||||||||||||||||||||
| 631 | sub files_diff_md5 { | ||||||||||||||||||||||||||||||||||||||||||
| 632 | 2 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
files_diff_md5: called CC=9 SCAR=22.0
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 633 | 2 | my ($f1, $f2, $args) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 634 | |||||||||||||||||||||||||||||||||||||||||||
| 635 | 2 | $self->audit("comparing $f1 and $f2 using md5", %$args); | |||||||||||||||||||||||||||||||||||||||||
| 636 | |||||||||||||||||||||||||||||||||||||||||||
| 637 | 2 | eval { require Digest::MD5 }; | |||||||||||||||||||||||||||||||||||||||||
| 638 | 2 | ▶ | return $self->error( "couldn't load Digest::MD5!", %$args ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 639 | if $EVAL_ERROR; | ||||||||||||||||||||||||||||||||||||||||||
| 640 | |||||||||||||||||||||||||||||||||||||||||||
| 641 | 2 | $self->audit( "\t Digest::MD5 loaded", %$args ); | |||||||||||||||||||||||||||||||||||||||||
| 642 | |||||||||||||||||||||||||||||||||||||||||||
| 643 | 2 | my @md5sums; | |||||||||||||||||||||||||||||||||||||||||
| 644 | |||||||||||||||||||||||||||||||||||||||||||
| 645 | 2 | foreach my $f ( $f1, $f2 ) { | |||||||||||||||||||||||||||||||||||||||||
| 646 | 4 | my ( $sum, $changed ); | |||||||||||||||||||||||||||||||||||||||||
| 647 | |||||||||||||||||||||||||||||||||||||||||||
| 648 | # if the md5 file exists | ||||||||||||||||||||||||||||||||||||||||||
| 649 | 4 | ▶ | if ( -f "$f.md5" ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 650 | 2 | $sum = $self->file_read( "$f.md5", %$args ); | |||||||||||||||||||||||||||||||||||||||||
| 651 | 2 | $self->audit( " md5 file for $f exists", %$args ); | |||||||||||||||||||||||||||||||||||||||||
| 652 | } | ||||||||||||||||||||||||||||||||||||||||||
| 653 | |||||||||||||||||||||||||||||||||||||||||||
| 654 | # if the md5 file is missing, invalid, or older than the file, recompute it | ||||||||||||||||||||||||||||||||||||||||||
| 655 | 4 | ▶ | if ( ! -f "$f.md5" or $sum !~ /[0-9a-f]+/i or | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition83%5/6
not -f "$f.md5" && $sum =~ /[0-9a-f]+/i or $self->file_is_newer("f1", "$f.md5", "f2", $f, %$args)
-f "$f.md5" && $sum =~ /[0-9a-f]+/i
MC/DC66%2/3
not -f "$f.md5" && $sum =~ /[0-9a-f]+/i or $self->file_is_newer("f1", "$f.md5", "f2", $f, %$args)
-f "$f.md5"
$sum =~ /[0-9a-f]+/i
$self->file_is_newer("f1", "$f.md5", "f2", $f, %$args)
Truth table75%3/4
not(A && B) or C
A= -f "$f.md5"B= $sum =~ /[0-9a-f]+/iC= $self->file_is_newer("f1", "$f.md5", "f2", $f, %$args)
| |||||||||||||||||||||||||||||||||||||||||||
| 656 | $self->file_is_newer( f1 => "$f.md5", f2 => $f, %$args ) | ||||||||||||||||||||||||||||||||||||||||||
| 657 | ) | ||||||||||||||||||||||||||||||||||||||||||
| 658 | { | ||||||||||||||||||||||||||||||||||||||||||
| 659 | 3 | my $ctx = Digest::MD5->new; | |||||||||||||||||||||||||||||||||||||||||
| 660 | 3 | open my $FILE, '<', $f; | |||||||||||||||||||||||||||||||||||||||||
| 661 | 3 | $ctx->addfile(*$FILE); | |||||||||||||||||||||||||||||||||||||||||
| 662 | 3 | $sum = $ctx->hexdigest; | |||||||||||||||||||||||||||||||||||||||||
| 663 | 3 | close $FILE; | |||||||||||||||||||||||||||||||||||||||||
| 664 | 3 | $changed++; | |||||||||||||||||||||||||||||||||||||||||
| 665 | 3 | $self->audit(" calculated md5: $sum", %$args); | |||||||||||||||||||||||||||||||||||||||||
| 666 | } | ||||||||||||||||||||||||||||||||||||||||||
| 667 | |||||||||||||||||||||||||||||||||||||||||||
| 668 | 4 | push( @md5sums, $sum ); | |||||||||||||||||||||||||||||||||||||||||
| 669 | 4 | ▶ | $self->file_write( "$f.md5", lines => [$sum], %$args ) if $changed; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 670 | } | ||||||||||||||||||||||||||||||||||||||||||
| 671 | |||||||||||||||||||||||||||||||||||||||||||
| 672 | 2 | ▶ | return if $md5sums[0] eq $md5sums[1]; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 673 | 1 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 674 | } | ||||||||||||||||||||||||||||||||||||||||||
| 675 | |||||||||||||||||||||||||||||||||||||||||||
| 676 | sub find_bin { | ||||||||||||||||||||||||||||||||||||||||||
| 677 | 31 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
find_bin: called CC=9 SCAR=23.0
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 678 | 31 | ▶ | my $bin = shift or die "missing argument to find_bin\n"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 679 | 31 | my %p = validate( @_, | |||||||||||||||||||||||||||||||||||||||||
| 680 | { 'dir' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 681 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 682 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 683 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 684 | |||||||||||||||||||||||||||||||||||||||||||
| 685 | 31 | my $prefix = "/usr/local"; | |||||||||||||||||||||||||||||||||||||||||
| 686 | 31 | my %args = $self->get_std_args(%p); | |||||||||||||||||||||||||||||||||||||||||
| 687 | |||||||||||||||||||||||||||||||||||||||||||
| 688 | 31 | ▶ | if ( $bin =~ /^\// && -x $bin ) { # we got a full path | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$bin =~ m[^/] and -x $bin
MC/DC0%0/2
$bin =~ m[^/] and -x $bin
$bin =~ m[^/]
-x $bin
Truth table33%1/3
A and B
A= $bin =~ m[^/]B= -x $bin
| |||||||||||||||||||||||||||||||||||||||||||
| 689 | 0 | $self->audit( "find_bin: found $bin", %args ); | |||||||||||||||||||||||||||||||||||||||||
| 690 | 0 | return $bin; | |||||||||||||||||||||||||||||||||||||||||
| 691 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 692 | |||||||||||||||||||||||||||||||||||||||||||
| 693 | 31 | my @prefixes; | |||||||||||||||||||||||||||||||||||||||||
| 694 | 31 | ▶ | push @prefixes, $p{dir} if $p{dir}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 695 | 31 | push @prefixes, qw" | |||||||||||||||||||||||||||||||||||||||||
| 696 | /usr/local/bin /usr/local/sbin/ /opt/local/bin /opt/local/sbin | ||||||||||||||||||||||||||||||||||||||||||
| 697 | $prefix/mysql/bin /bin /usr/bin /sbin /usr/sbin | ||||||||||||||||||||||||||||||||||||||||||
| 698 | "; | ||||||||||||||||||||||||||||||||||||||||||
| 699 | 31 | push @prefixes, cwd; | |||||||||||||||||||||||||||||||||||||||||
| 700 | |||||||||||||||||||||||||||||||||||||||||||
| 701 | 31 | my $found; | |||||||||||||||||||||||||||||||||||||||||
| 702 | 31 | foreach my $prefix ( @prefixes ) { | |||||||||||||||||||||||||||||||||||||||||
| 703 | 206 | ▶ | if ( -x "$prefix/$bin" ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 704 | 26 | ▶ | $found = "$prefix/$bin" and last; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 705 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 706 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 707 | |||||||||||||||||||||||||||||||||||||||||||
| 708 | 31 | ▶ | if ($found) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 709 | 26 | $self->audit( "find_bin: found $found", %args); | |||||||||||||||||||||||||||||||||||||||||
| 710 | 26 | return $found; | |||||||||||||||||||||||||||||||||||||||||
| 711 | } | ||||||||||||||||||||||||||||||||||||||||||
| 712 | |||||||||||||||||||||||||||||||||||||||||||
| 713 | 5 | return $self->error( "find_bin: could not find $bin", %args); | |||||||||||||||||||||||||||||||||||||||||
| 714 | } | ||||||||||||||||||||||||||||||||||||||||||
| 715 | |||||||||||||||||||||||||||||||||||||||||||
| 716 | sub find_config { | ||||||||||||||||||||||||||||||||||||||||||
| 717 | 11 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
find_config: called CC=7 SCAR=20.4
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 718 | 11 | ▶ | my $file = shift or die "missing file name"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 719 | 11 | my %p = validate( @_, | |||||||||||||||||||||||||||||||||||||||||
| 720 | { etcdir => { type => SCALAR | UNDEF, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 721 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 722 | } | ||||||||||||||||||||||||||||||||||||||||||
| 723 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 724 | |||||||||||||||||||||||||||||||||||||||||||
| 725 | 11 | ▶ | if ( $p{verbose} > 1 ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 726 | 0 | my @caller = caller; | |||||||||||||||||||||||||||||||||||||||||
| 727 | 0 | $self->audit( sprintf("find_config loaded by %s, %s, %s\n", @caller )); | |||||||||||||||||||||||||||||||||||||||||
| 728 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 729 | |||||||||||||||||||||||||||||||||||||||||||
| 730 | 11 | $self->audit("find_config: searching for $file"); | |||||||||||||||||||||||||||||||||||||||||
| 731 | |||||||||||||||||||||||||||||||||||||||||||
| 732 | 11 | my @etc_dirs; | |||||||||||||||||||||||||||||||||||||||||
| 733 | 11 | my $etcdir = $p{etcdir}; | |||||||||||||||||||||||||||||||||||||||||
| 734 | 11 | ▶ | push @etc_dirs, $etcdir if ( $etcdir && -d $etcdir ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
$etcdir and -d $etcdir
MC/DC50%1/2
$etcdir and -d $etcdir
$etcdir
-d $etcdir
Truth table66%2/3
A and B
A= $etcdirB= -d $etcdir
| |||||||||||||||||||||||||||||||||||||||||||
| 735 | 11 | push @etc_dirs, qw{ /opt/local/etc /usr/local/etc /etc etc }; | |||||||||||||||||||||||||||||||||||||||||
| 736 | 11 | push @etc_dirs, cwd; | |||||||||||||||||||||||||||||||||||||||||
| 737 | |||||||||||||||||||||||||||||||||||||||||||
| 738 | 11 | my $r = $self->find_readable( $file, @etc_dirs ); | |||||||||||||||||||||||||||||||||||||||||
| 739 | 11 | ▶ | if ( $r ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 740 | 0 | $self->audit( " found $r" ); | |||||||||||||||||||||||||||||||||||||||||
| 741 | 0 | return $r; | |||||||||||||||||||||||||||||||||||||||||
| 742 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 743 | |||||||||||||||||||||||||||||||||||||||||||
| 744 | # try $file-dist in the working dir | ||||||||||||||||||||||||||||||||||||||||||
| 745 | 11 | ▶ | if ( -r "./$file-dist" ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 746 | 7 | $self->audit(" found in ./"); | |||||||||||||||||||||||||||||||||||||||||
| 747 | 7 | return cwd . "/$file-dist"; | |||||||||||||||||||||||||||||||||||||||||
| 748 | } | ||||||||||||||||||||||||||||||||||||||||||
| 749 | |||||||||||||||||||||||||||||||||||||||||||
| 750 | 4 | return $self->error( "could not find $file", fatal => $p{fatal} ); | |||||||||||||||||||||||||||||||||||||||||
| 751 | } | ||||||||||||||||||||||||||||||||||||||||||
| 752 | |||||||||||||||||||||||||||||||||||||||||||
| 753 | sub find_readable { | ||||||||||||||||||||||||||||||||||||||||||
| 754 | 67 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
find_readable: called CC=6 SCAR=19.0
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 755 | 67 | my $file = shift; | |||||||||||||||||||||||||||||||||||||||||
| 756 | 67 | ▶ | my $dir = shift or return; # break recursion at end of @_ | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 757 | |||||||||||||||||||||||||||||||||||||||||||
| 758 | #$self->audit("looking for $file in $dir") if $self->{verbose}; | ||||||||||||||||||||||||||||||||||||||||||
| 759 | 56 | ▶ | if ( -r "$dir/$file" ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 760 | 11 | ▶ | no warnings; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 761 | 0 | return "$dir/$file"; # success | |||||||||||||||||||||||||||||||||||||||||
| 762 | } | ||||||||||||||||||||||||||||||||||||||||||
| 763 | |||||||||||||||||||||||||||||||||||||||||||
| 764 | 56 | ▶ | if ( ! -d $dir ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 765 | 22 | return $self->find_readable( $file, @_ ); | |||||||||||||||||||||||||||||||||||||||||
| 766 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 767 | |||||||||||||||||||||||||||||||||||||||||||
| 768 | # warn about directories we don't have read access to | ||||||||||||||||||||||||||||||||||||||||||
| 769 | 34 | ▶ | if ( ! -r $dir ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 770 | 0 | $self->error( "$dir is not readable", fatal => 0 ); | |||||||||||||||||||||||||||||||||||||||||
| 771 | 0 | return $self->find_readable( $file, @_ ); | |||||||||||||||||||||||||||||||||||||||||
| 772 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 773 | |||||||||||||||||||||||||||||||||||||||||||
| 774 | # warn about files that exist but aren't readable | ||||||||||||||||||||||||||||||||||||||||||
| 775 | 34 | ▶ | if ( -e "$dir/$file" ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 776 | 0 | $self->error( "$dir/$file is not readable", fatal => 0); | |||||||||||||||||||||||||||||||||||||||||
| 777 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 778 | |||||||||||||||||||||||||||||||||||||||||||
| 779 | 34 | return $self->find_readable( $file, @_ ); | |||||||||||||||||||||||||||||||||||||||||
| 780 | } | ||||||||||||||||||||||||||||||||||||||||||
| 781 | |||||||||||||||||||||||||||||||||||||||||||
| 782 | sub fstab_list { | ||||||||||||||||||||||||||||||||||||||||||
| 783 | 1 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
fstab_list: called CC=4 SCAR=16.3
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 784 | 1 | my %p = validate( @_, { $self->get_std_opts, } ); | |||||||||||||||||||||||||||||||||||||||||
| 785 | |||||||||||||||||||||||||||||||||||||||||||
| 786 | 1 | ▶ | if ( $OSNAME eq "darwin" ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 787 | 0 | return ['fstab not used on Darwin!']; | |||||||||||||||||||||||||||||||||||||||||
| 788 | } | ||||||||||||||||||||||||||||||||||||||||||
| 789 | |||||||||||||||||||||||||||||||||||||||||||
| 790 | 1 | my $fstab = "/etc/fstab"; | |||||||||||||||||||||||||||||||||||||||||
| 791 | 1 | ▶ | if ( !-e $fstab ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 792 | 0 | ▶ | print "fstab_list: FAILURE: $fstab does not exist!\n" if $p{verbose}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 793 | 0 | return; | |||||||||||||||||||||||||||||||||||||||||
| 794 | } | ||||||||||||||||||||||||||||||||||||||||||
| 795 | |||||||||||||||||||||||||||||||||||||||||||
| 796 | 1 | my $grep = $self->find_bin( "grep", verbose => 0 ); | |||||||||||||||||||||||||||||||||||||||||
| 797 | 1 | my @fstabs = `$grep -v cdr $fstab`; | |||||||||||||||||||||||||||||||||||||||||
| 798 | |||||||||||||||||||||||||||||||||||||||||||
| 799 | # foreach my $fstab (@fstabs) | ||||||||||||||||||||||||||||||||||||||||||
| 800 | # {} | ||||||||||||||||||||||||||||||||||||||||||
| 801 | # my @fields = split(/ /, $fstab); | ||||||||||||||||||||||||||||||||||||||||||
| 802 | # #print "device: $fields[0] mount: $fields[1]\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 803 | # {}; | ||||||||||||||||||||||||||||||||||||||||||
| 804 | # print "\n\n END of fstabs\n\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 805 | |||||||||||||||||||||||||||||||||||||||||||
| 806 | 1 | return \@fstabs; | |||||||||||||||||||||||||||||||||||||||||
| 807 | } | ||||||||||||||||||||||||||||||||||||||||||
| 808 | |||||||||||||||||||||||||||||||||||||||||||
| 809 | sub get_cpan_config { | ||||||||||||||||||||||||||||||||||||||||||
| 810 | |||||||||||||||||||||||||||||||||||||||||||
| 811 | 0 | ▶ | my $ftp = `which ftp`; chomp $ftp; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
get_cpan_config: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 812 | 0 | my $gzip = `which gzip`; chomp $gzip; | |||||||||||||||||||||||||||||||||||||||||
| 813 | 0 | my $unzip = `which unzip`; chomp $unzip; | |||||||||||||||||||||||||||||||||||||||||
| 814 | 0 | my $tar = `which tar`; chomp $tar; | |||||||||||||||||||||||||||||||||||||||||
| 815 | 0 | my $make = `which make`; chomp $make; | |||||||||||||||||||||||||||||||||||||||||
| 816 | 0 | my $wget = `which wget`; chomp $wget; | |||||||||||||||||||||||||||||||||||||||||
| 817 | |||||||||||||||||||||||||||||||||||||||||||
| 818 | return | ||||||||||||||||||||||||||||||||||||||||||
| 819 | { | ||||||||||||||||||||||||||||||||||||||||||
| 820 | 0 | 'build_cache' => q[10], | |||||||||||||||||||||||||||||||||||||||||
| 821 | 'build_dir' => qq[$ENV{HOME}/.cpan/build], | ||||||||||||||||||||||||||||||||||||||||||
| 822 | 'cache_metadata' => q[1], | ||||||||||||||||||||||||||||||||||||||||||
| 823 | 'cpan_home' => qq[$ENV{HOME}/.cpan], | ||||||||||||||||||||||||||||||||||||||||||
| 824 | 'ftp' => $ftp, | ||||||||||||||||||||||||||||||||||||||||||
| 825 | 'ftp_proxy' => q[], | ||||||||||||||||||||||||||||||||||||||||||
| 826 | 'getcwd' => q[cwd], | ||||||||||||||||||||||||||||||||||||||||||
| 827 | 'gpg' => q[], | ||||||||||||||||||||||||||||||||||||||||||
| 828 | 'gzip' => $gzip, | ||||||||||||||||||||||||||||||||||||||||||
| 829 | 'histfile' => qq[$ENV{HOME}/.cpan/histfile], | ||||||||||||||||||||||||||||||||||||||||||
| 830 | 'histsize' => q[100], | ||||||||||||||||||||||||||||||||||||||||||
| 831 | 'http_proxy' => q[], | ||||||||||||||||||||||||||||||||||||||||||
| 832 | 'inactivity_timeout' => q[5], | ||||||||||||||||||||||||||||||||||||||||||
| 833 | 'index_expire' => q[1], | ||||||||||||||||||||||||||||||||||||||||||
| 834 | 'inhibit_startup_message' => q[1], | ||||||||||||||||||||||||||||||||||||||||||
| 835 | 'keep_source_where' => qq[$ENV{HOME}/.cpan/sources], | ||||||||||||||||||||||||||||||||||||||||||
| 836 | 'lynx' => q[], | ||||||||||||||||||||||||||||||||||||||||||
| 837 | 'make' => $make, | ||||||||||||||||||||||||||||||||||||||||||
| 838 | 'make_arg' => q[], | ||||||||||||||||||||||||||||||||||||||||||
| 839 | 'make_install_arg' => q[], | ||||||||||||||||||||||||||||||||||||||||||
| 840 | 'makepl_arg' => q[], | ||||||||||||||||||||||||||||||||||||||||||
| 841 | 'ncftp' => q[], | ||||||||||||||||||||||||||||||||||||||||||
| 842 | 'ncftpget' => q[], | ||||||||||||||||||||||||||||||||||||||||||
| 843 | 'no_proxy' => q[], | ||||||||||||||||||||||||||||||||||||||||||
| 844 | 'pager' => q[less], | ||||||||||||||||||||||||||||||||||||||||||
| 845 | 'prerequisites_policy' => q[follow], | ||||||||||||||||||||||||||||||||||||||||||
| 846 | 'scan_cache' => q[atstart], | ||||||||||||||||||||||||||||||||||||||||||
| 847 | 'shell' => q[/bin/csh], | ||||||||||||||||||||||||||||||||||||||||||
| 848 | 'tar' => $tar, | ||||||||||||||||||||||||||||||||||||||||||
| 849 | 'term_is_latin' => q[1], | ||||||||||||||||||||||||||||||||||||||||||
| 850 | 'unzip' => $unzip, | ||||||||||||||||||||||||||||||||||||||||||
| 851 | 'urllist' => [ 'http://www.perl.com/CPAN/', 'ftp://cpan.cs.utah.edu/pub/CPAN/', 'ftp://mirrors.kernel.org/pub/CPAN', 'ftp://osl.uoregon.edu/CPAN/', 'http://cpan.yahoo.com/' ], | ||||||||||||||||||||||||||||||||||||||||||
| 852 | 'wget' => $wget, | ||||||||||||||||||||||||||||||||||||||||||
| 853 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 854 | |||||||||||||||||||||||||||||||||||||||||||
| 855 | } | ||||||||||||||||||||||||||||||||||||||||||
| 856 | |||||||||||||||||||||||||||||||||||||||||||
| 857 | sub get_dir_files { | ||||||||||||||||||||||||||||||||||||||||||
| 858 | 3 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
get_dir_files: called CC=6 SCAR=18.1
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 859 | 3 | ▶ | my $dir = shift or die "missing dir name"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 860 | 3 | my %p = validate( @_, { $self->get_std_opts } ); | |||||||||||||||||||||||||||||||||||||||||
| 861 | |||||||||||||||||||||||||||||||||||||||||||
| 862 | 3 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 863 | |||||||||||||||||||||||||||||||||||||||||||
| 864 | 3 | my @files; | |||||||||||||||||||||||||||||||||||||||||
| 865 | |||||||||||||||||||||||||||||||||||||||||||
| 866 | 3 | ▶ | return $self->error( "dir $dir is not a directory!", %args) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 867 | if ! -d $dir; | ||||||||||||||||||||||||||||||||||||||||||
| 868 | |||||||||||||||||||||||||||||||||||||||||||
| 869 | 3 | ▶ | opendir D, $dir or return $self->error( "couldn't open $dir: $!", %args ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 870 | |||||||||||||||||||||||||||||||||||||||||||
| 871 | 3 | ▶ | while ( defined( my $f = readdir(D) ) ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 872 | 92 | ▶ | next if $f =~ /^\.\.?$/; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 873 | 86 | push @files, "$dir/$f"; | |||||||||||||||||||||||||||||||||||||||||
| 874 | } | ||||||||||||||||||||||||||||||||||||||||||
| 875 | |||||||||||||||||||||||||||||||||||||||||||
| 876 | 3 | closedir(D); | |||||||||||||||||||||||||||||||||||||||||
| 877 | |||||||||||||||||||||||||||||||||||||||||||
| 878 | 3 | return @files; | |||||||||||||||||||||||||||||||||||||||||
| 879 | } | ||||||||||||||||||||||||||||||||||||||||||
| 880 | |||||||||||||||||||||||||||||||||||||||||||
| 881 | sub get_my_ips { | ||||||||||||||||||||||||||||||||||||||||||
| 882 | |||||||||||||||||||||||||||||||||||||||||||
| 883 | ############################################ | ||||||||||||||||||||||||||||||||||||||||||
| 884 | # Usage : @list_of_ips_ref = $util->get_my_ips(); | ||||||||||||||||||||||||||||||||||||||||||
| 885 | # Purpose : get a list of IP addresses on local interfaces | ||||||||||||||||||||||||||||||||||||||||||
| 886 | # Returns : an arrayref of IP addresses | ||||||||||||||||||||||||||||||||||||||||||
| 887 | # Parameters : only - can be one of: first, last | ||||||||||||||||||||||||||||||||||||||||||
| 888 | # : exclude_locahost (all 127.0 addresses) | ||||||||||||||||||||||||||||||||||||||||||
| 889 | # : exclude_internals (192.168, 10., 169., 172.) | ||||||||||||||||||||||||||||||||||||||||||
| 890 | # : exclude_ipv6 | ||||||||||||||||||||||||||||||||||||||||||
| 891 | # Comments : exclude options are boolean and enabled by default. | ||||||||||||||||||||||||||||||||||||||||||
| 892 | # tested on Mac OS X and FreeBSD | ||||||||||||||||||||||||||||||||||||||||||
| 893 | |||||||||||||||||||||||||||||||||||||||||||
| 894 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
get_my_ips: not called CC=10 SCAR=47.0
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 895 | 0 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 896 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 897 | { 'only' => { type => SCALAR, optional => 1, default => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 898 | 'exclude_localhost' => | ||||||||||||||||||||||||||||||||||||||||||
| 899 | { type => BOOLEAN, optional => 1, default => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 900 | 'exclude_internals' => | ||||||||||||||||||||||||||||||||||||||||||
| 901 | { type => BOOLEAN, optional => 1, default => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 902 | 'exclude_ipv6' => | ||||||||||||||||||||||||||||||||||||||||||
| 903 | { type => BOOLEAN, optional => 1, default => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 904 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 905 | } | ||||||||||||||||||||||||||||||||||||||||||
| 906 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 907 | |||||||||||||||||||||||||||||||||||||||||||
| 908 | 0 | my $only = $p{only}; | |||||||||||||||||||||||||||||||||||||||||
| 909 | |||||||||||||||||||||||||||||||||||||||||||
| 910 | 0 | my $ifconfig = $self->find_bin( "ifconfig", verbose => 0 ); | |||||||||||||||||||||||||||||||||||||||||
| 911 | |||||||||||||||||||||||||||||||||||||||||||
| 912 | 0 | my $once = 0; | |||||||||||||||||||||||||||||||||||||||||
| 913 | |||||||||||||||||||||||||||||||||||||||||||
| 914 | TRY: | ||||||||||||||||||||||||||||||||||||||||||
| 915 | 0 | my @ips = grep {/inet/} `$ifconfig`; chomp @ips; | |||||||||||||||||||||||||||||||||||||||||
| 916 | 0 | ▶ | @ips = grep {!/inet6/} @ips if $p{exclude_ipv6}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 917 | 0 | ▶ | @ips = grep {!/inet 127\.0\.0/} @ips if $p{exclude_localhost}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 918 | 0 | @ips = grep {!/inet (192\.168\.|10\.|172\.16\.|169\.254\.)/} @ips | |||||||||||||||||||||||||||||||||||||||||
| 919 | 0 | ▶ | if $p{exclude_internals}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 920 | |||||||||||||||||||||||||||||||||||||||||||
| 921 | # this keeps us from failing if the box has only internal IPs | ||||||||||||||||||||||||||||||||||||||||||
| 922 | 0 | ▶ | if ( @ips < 1 || $ips[0] eq "" ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
@ips < 1 or $ips[0] eq ""
MC/DC0%0/2
@ips < 1 or $ips[0] eq ""
@ips < 1
$ips[0] eq ""
Truth table0%0/3
A or B
A= @ips < 1B= $ips[0] eq ""
| |||||||||||||||||||||||||||||||||||||||||||
| 923 | 0 | $self->audit( "yikes, you really don't have any public IPs?!"); | |||||||||||||||||||||||||||||||||||||||||
| 924 | 0 | $p{exclude_internals} = 0; | |||||||||||||||||||||||||||||||||||||||||
| 925 | 0 | $once++; | |||||||||||||||||||||||||||||||||||||||||
| 926 | 0 | ▶ | goto TRY if ( $once < 2 ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 927 | } | ||||||||||||||||||||||||||||||||||||||||||
| 928 | |||||||||||||||||||||||||||||||||||||||||||
| 929 | 0 | foreach ( @ips ) { ($_) = $_ =~ m/inet ([\d\.]+)\s/; }; | |||||||||||||||||||||||||||||||||||||||||
| 930 | |||||||||||||||||||||||||||||||||||||||||||
| 931 | 0 | ▶ | return [ $ips[0] ] if $only eq 'first'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 932 | 0 | ▶ | return [ $ips[-1] ] if $only eq 'last'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 933 | 0 | return \@ips; | |||||||||||||||||||||||||||||||||||||||||
| 934 | } | ||||||||||||||||||||||||||||||||||||||||||
| 935 | |||||||||||||||||||||||||||||||||||||||||||
| 936 | sub get_the_date { | ||||||||||||||||||||||||||||||||||||||||||
| 937 | 5 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
get_the_date: called CC=5 SCAR=17.0
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 938 | 5 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 939 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 940 | { 'bump' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 941 | $self->get_std_opts | ||||||||||||||||||||||||||||||||||||||||||
| 942 | } | ||||||||||||||||||||||||||||||||||||||||||
| 943 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 944 | |||||||||||||||||||||||||||||||||||||||||||
| 945 | 5 | ▶ | my $bump = $p{bump} || 0; | ||||||||||||||||||||||||||||||||||||||||
|
Condition100%2/2
$p{'bump'} || 0
MC/DC100%1/1
$p{'bump'} || 0
$p{'bump'}
Truth table100%2/2
A
A= $p{'bump'}
| |||||||||||||||||||||||||||||||||||||||||||
| 946 | 5 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 947 | |||||||||||||||||||||||||||||||||||||||||||
| 948 | 5 | my $time = time; | |||||||||||||||||||||||||||||||||||||||||
| 949 | 5 | my $mess = "get_the_date time: " . time; | |||||||||||||||||||||||||||||||||||||||||
| 950 | |||||||||||||||||||||||||||||||||||||||||||
| 951 | 5 | ▶ | $bump = $bump * 86400 if $bump; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 952 | 5 | my $offset_time = time - $bump; | |||||||||||||||||||||||||||||||||||||||||
| 953 | 5 | ▶ | $mess .= ", (selected $offset_time)" if $time != $offset_time; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 954 | |||||||||||||||||||||||||||||||||||||||||||
| 955 | # load Date::Format to get the time2str function | ||||||||||||||||||||||||||||||||||||||||||
| 956 | 5 | eval { require Date::Format }; | |||||||||||||||||||||||||||||||||||||||||
| 957 | 5 | ▶ | if ( !$EVAL_ERROR ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 958 | |||||||||||||||||||||||||||||||||||||||||||
| 959 | 5 | my $ss = Date::Format::time2str( "%S", ($offset_time) ); | |||||||||||||||||||||||||||||||||||||||||
| 960 | 5 | my $mn = Date::Format::time2str( "%M", ($offset_time) ); | |||||||||||||||||||||||||||||||||||||||||
| 961 | 5 | my $hh = Date::Format::time2str( "%H", ($offset_time) ); | |||||||||||||||||||||||||||||||||||||||||
| 962 | 5 | my $dd = Date::Format::time2str( "%d", ($offset_time) ); | |||||||||||||||||||||||||||||||||||||||||
| 963 | 5 | my $mm = Date::Format::time2str( "%m", ($offset_time) ); | |||||||||||||||||||||||||||||||||||||||||
| 964 | 5 | my $yy = Date::Format::time2str( "%Y", ($offset_time) ); | |||||||||||||||||||||||||||||||||||||||||
| 965 | 5 | my $lm = Date::Format::time2str( "%m", ( $offset_time - 2592000 ) ); | |||||||||||||||||||||||||||||||||||||||||
| 966 | |||||||||||||||||||||||||||||||||||||||||||
| 967 | 5 | $self->audit( "$mess, $yy/$mm/$dd $hh:$mn", %args); | |||||||||||||||||||||||||||||||||||||||||
| 968 | 5 | return $dd, $mm, $yy, $lm, $hh, $mn, $ss; | |||||||||||||||||||||||||||||||||||||||||
| 969 | } | ||||||||||||||||||||||||||||||||||||||||||
| 970 | |||||||||||||||||||||||||||||||||||||||||||
| 971 | # 0 1 2 3 4 5 6 7 8 | ||||||||||||||||||||||||||||||||||||||||||
| 972 | # ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = | ||||||||||||||||||||||||||||||||||||||||||
| 973 | # localtime(time); | ||||||||||||||||||||||||||||||||||||||||||
| 974 | # 4 = month + 1 ( see perldoc localtime) | ||||||||||||||||||||||||||||||||||||||||||
| 975 | # 5 = year + 1900 "" | ||||||||||||||||||||||||||||||||||||||||||
| 976 | |||||||||||||||||||||||||||||||||||||||||||
| 977 | 0 | my @fields = localtime($offset_time); | |||||||||||||||||||||||||||||||||||||||||
| 978 | |||||||||||||||||||||||||||||||||||||||||||
| 979 | 0 | my $ss = sprintf( "%02i", $fields[0] ); # seconds | |||||||||||||||||||||||||||||||||||||||||
| 980 | 0 | my $mn = sprintf( "%02i", $fields[1] ); # minutes | |||||||||||||||||||||||||||||||||||||||||
| 981 | 0 | my $hh = sprintf( "%02i", $fields[2] ); # hours (24 hour clock) | |||||||||||||||||||||||||||||||||||||||||
| 982 | |||||||||||||||||||||||||||||||||||||||||||
| 983 | 0 | my $dd = sprintf( "%02i", $fields[3] ); # day of month | |||||||||||||||||||||||||||||||||||||||||
| 984 | 0 | my $mm = sprintf( "%02i", $fields[4] + 1 ); # month | |||||||||||||||||||||||||||||||||||||||||
| 985 | 0 | my $yy = ( $fields[5] + 1900 ); # year | |||||||||||||||||||||||||||||||||||||||||
| 986 | |||||||||||||||||||||||||||||||||||||||||||
| 987 | 0 | $self->audit( "$mess, $yy/$mm/$dd $hh:$mn", %args ); | |||||||||||||||||||||||||||||||||||||||||
| 988 | 0 | return $dd, $mm, $yy, undef, $hh, $mn, $ss; | |||||||||||||||||||||||||||||||||||||||||
| 989 | } | ||||||||||||||||||||||||||||||||||||||||||
| 990 | |||||||||||||||||||||||||||||||||||||||||||
| 991 | sub get_mounted_drives { | ||||||||||||||||||||||||||||||||||||||||||
| 992 | 1 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
get_mounted_drives: called CC=5 SCAR=16.5
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 993 | 1 | my %p = validate( @_, { $self->get_std_opts } ); | |||||||||||||||||||||||||||||||||||||||||
| 994 | 1 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 995 | |||||||||||||||||||||||||||||||||||||||||||
| 996 | 1 | my $mount = $self->find_bin( 'mount', %args ); | |||||||||||||||||||||||||||||||||||||||||
| 997 | |||||||||||||||||||||||||||||||||||||||||||
| 998 | 1 | ▶ | -x $mount or return $self->error( "I couldn't find mount!", %args ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 999 | |||||||||||||||||||||||||||||||||||||||||||
| 1000 | 1 | $ENV{PATH} = ""; | |||||||||||||||||||||||||||||||||||||||||
| 1001 | 1 | my %hash; | |||||||||||||||||||||||||||||||||||||||||
| 1002 | 1 | foreach (`$mount`) { | |||||||||||||||||||||||||||||||||||||||||
| 1003 | 24 | my ( $d, $m ) = $_ =~ /^(.*) on (.*) \(/; | |||||||||||||||||||||||||||||||||||||||||
| 1004 | |||||||||||||||||||||||||||||||||||||||||||
| 1005 | #if ( $m =~ /^\// && $d =~ /^\// ) # mount drives that begin with / | ||||||||||||||||||||||||||||||||||||||||||
| 1006 | 24 | ▶ | if ( $m && $m =~ /^\// ) { # only mounts that begin with / | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$m and $m =~ m[^/]
MC/DC0%0/2
$m and $m =~ m[^/]
$m
$m =~ m[^/]
Truth table33%1/3
A and B
A= $mB= $m =~ m[^/]
| |||||||||||||||||||||||||||||||||||||||||||
| 1007 | 24 | $self->audit( "adding: $m \t $d" ); | |||||||||||||||||||||||||||||||||||||||||
| 1008 | 24 | $hash{$m} = $d; | |||||||||||||||||||||||||||||||||||||||||
| 1009 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1010 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1011 | 1 | return \%hash; | |||||||||||||||||||||||||||||||||||||||||
| 1012 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1013 | |||||||||||||||||||||||||||||||||||||||||||
| 1014 | sub get_url { | ||||||||||||||||||||||||||||||||||||||||||
| 1015 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
get_url: not called CC=10 SCAR=47.0
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1016 | 0 | my $url = shift; | |||||||||||||||||||||||||||||||||||||||||
| 1017 | 0 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 1018 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 1019 | { dir => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 1020 | timeout => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 1021 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 1022 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1023 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1024 | |||||||||||||||||||||||||||||||||||||||||||
| 1025 | 0 | my $dir = $p{dir}; | |||||||||||||||||||||||||||||||||||||||||
| 1026 | 0 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 1027 | |||||||||||||||||||||||||||||||||||||||||||
| 1028 | 0 | my ($ua, $response); | |||||||||||||||||||||||||||||||||||||||||
| 1029 | 0 | eval "require LWP::Simple"; ## no critic ( StringyEval ) | |||||||||||||||||||||||||||||||||||||||||
| 1030 | 0 | ▶ | if ( $EVAL_ERROR ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1031 | 0 | $self->audit( "LWP::Simple not installed" ); | |||||||||||||||||||||||||||||||||||||||||
| 1032 | 0 | return $self->get_url_system( $url, %p ); | |||||||||||||||||||||||||||||||||||||||||
| 1033 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1034 | |||||||||||||||||||||||||||||||||||||||||||
| 1035 | 0 | eval "require URI"; ## no critic ( StringyEval ) | |||||||||||||||||||||||||||||||||||||||||
| 1036 | 0 | ▶ | return $self->error( $@, fatal => $p{fatal} ) if $@; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1037 | 0 | my $uri = URI->new($url); | |||||||||||||||||||||||||||||||||||||||||
| 1038 | 0 | my @parts = $uri->path_segments; | |||||||||||||||||||||||||||||||||||||||||
| 1039 | 0 | my $file = $parts[-1]; # everything after the last / in the URL | |||||||||||||||||||||||||||||||||||||||||
| 1040 | 0 | my $file_path = $file; | |||||||||||||||||||||||||||||||||||||||||
| 1041 | 0 | ▶ | $file_path = "$dir/$file" if $dir; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1042 | |||||||||||||||||||||||||||||||||||||||||||
| 1043 | 0 | $self->audit( "fetching $url" ); | |||||||||||||||||||||||||||||||||||||||||
| 1044 | 0 | eval { $response = LWP::Simple::mirror($url, $file_path ); }; | |||||||||||||||||||||||||||||||||||||||||
| 1045 | 0 | ▶ | $self->error( $EVAL_ERROR ) if $EVAL_ERROR; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1046 | |||||||||||||||||||||||||||||||||||||||||||
| 1047 | 0 | ▶ | if ( $response ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1048 | 0 | ▶ | if ( $response == 404 ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 3 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 1049 | 0 | return $self->error( "file not found ($url)", %args ); | |||||||||||||||||||||||||||||||||||||||||
| 1050 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1051 | elsif ($response == 304 ) { | ||||||||||||||||||||||||||||||||||||||||||
| 1052 | 0 | $self->audit( "result 304: file is up-to-date" ); | |||||||||||||||||||||||||||||||||||||||||
| 1053 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1054 | elsif ( $response == 200 ) { | ||||||||||||||||||||||||||||||||||||||||||
| 1055 | 0 | $self->audit( "result 200: file download ok" ); | |||||||||||||||||||||||||||||||||||||||||
| 1056 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1057 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 1058 | 0 | $self->error( "unhandled response: $response for $url", fatal => 0 ); | |||||||||||||||||||||||||||||||||||||||||
| 1059 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1060 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1061 | |||||||||||||||||||||||||||||||||||||||||||
| 1062 | 0 | ▶ | $self->error( "download failed for $url!") if ! -e $file_path; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1063 | 0 | return $response; | |||||||||||||||||||||||||||||||||||||||||
| 1064 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1065 | |||||||||||||||||||||||||||||||||||||||||||
| 1066 | sub get_url_system { | ||||||||||||||||||||||||||||||||||||||||||
| 1067 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
get_url_system: not called CC=23 SCAR=63.1
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1068 | 0 | my $url = shift; | |||||||||||||||||||||||||||||||||||||||||
| 1069 | 0 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 1070 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 1071 | { dir => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 1072 | timeout => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1073 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 1074 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1075 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1076 | |||||||||||||||||||||||||||||||||||||||||||
| 1077 | 0 | my $dir = $p{dir}; | |||||||||||||||||||||||||||||||||||||||||
| 1078 | 0 | my $verbose = $p{verbose}; | |||||||||||||||||||||||||||||||||||||||||
| 1079 | 0 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 1080 | |||||||||||||||||||||||||||||||||||||||||||
| 1081 | 0 | my ($fetchbin, $found); | |||||||||||||||||||||||||||||||||||||||||
| 1082 | 0 | ▶ | if ( $OSNAME eq "freebsd" ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 1083 | 0 | $fetchbin = $self->find_bin( 'fetch', %args); | |||||||||||||||||||||||||||||||||||||||||
| 1084 | 0 | ▶ | if ( $fetchbin && -x $fetchbin ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$fetchbin and -x $fetchbin
MC/DC0%0/2
$fetchbin and -x $fetchbin
$fetchbin
-x $fetchbin
Truth table0%0/3
A and B
A= $fetchbinB= -x $fetchbin
| |||||||||||||||||||||||||||||||||||||||||||
| 1085 | 0 | $found = $fetchbin; | |||||||||||||||||||||||||||||||||||||||||
| 1086 | 0 | ▶ | $found .= " -q" if !$verbose; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1087 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1088 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1089 | elsif ( $OSNAME eq "darwin" ) { | ||||||||||||||||||||||||||||||||||||||||||
| 1090 | 0 | $fetchbin = $self->find_bin( 'curl', %args ); | |||||||||||||||||||||||||||||||||||||||||
| 1091 | 0 | ▶ | if ( $fetchbin && -x $fetchbin ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$fetchbin and -x $fetchbin
MC/DC0%0/2
$fetchbin and -x $fetchbin
$fetchbin
-x $fetchbin
Truth table0%0/3
A and B
A= $fetchbinB= -x $fetchbin
| |||||||||||||||||||||||||||||||||||||||||||
| 1092 | 0 | $found = "$fetchbin -O"; | |||||||||||||||||||||||||||||||||||||||||
| 1093 | 0 | ▶ | $found .= " -s " if !$verbose; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1094 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1095 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1096 | |||||||||||||||||||||||||||||||||||||||||||
| 1097 | 0 | ▶ | if ( !$found ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1098 | 0 | $fetchbin = $self->find_bin( 'wget', %args); | |||||||||||||||||||||||||||||||||||||||||
| 1099 | 0 | ▶ | $found = $fetchbin if $fetchbin && -x $fetchbin; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$fetchbin and -x $fetchbin
MC/DC0%0/2
$fetchbin and -x $fetchbin
$fetchbin
-x $fetchbin
Truth table0%0/3
A and B
A= $fetchbinB= -x $fetchbin
| |||||||||||||||||||||||||||||||||||||||||||
| 1100 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1101 | |||||||||||||||||||||||||||||||||||||||||||
| 1102 | 0 | ▶ | return $self->error( "Failed to fetch $url.\n\tCouldn't find wget. Please install it.", %args ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1103 | if !$found; | ||||||||||||||||||||||||||||||||||||||||||
| 1104 | |||||||||||||||||||||||||||||||||||||||||||
| 1105 | 0 | my $fetchcmd = "$found $url"; | |||||||||||||||||||||||||||||||||||||||||
| 1106 | |||||||||||||||||||||||||||||||||||||||||||
| 1107 | 0 | ▶ | my $timeout = $p{timeout} || 0; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$p{'timeout'} || 0
MC/DC0%0/1
$p{'timeout'} || 0
$p{'timeout'}
Truth table0%0/2
A
A= $p{'timeout'}
| |||||||||||||||||||||||||||||||||||||||||||
| 1108 | 0 | ▶ | if ( ! $timeout ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1109 | 0 | ▶ | $self->syscmd( $fetchcmd, %args ) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1110 | 0 | eval "require URI"; ## no critic ( StringyEval ) | |||||||||||||||||||||||||||||||||||||||||
| 1111 | 0 | ▶ | return $self->error( $@, fatal => $p{fatal} ) if $@; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1112 | 0 | my $uri = URI->new($url); | |||||||||||||||||||||||||||||||||||||||||
| 1113 | 0 | my @parts = $uri->path_segments; | |||||||||||||||||||||||||||||||||||||||||
| 1114 | 0 | my $file = $parts[-1]; # everything after the last / in the URL | |||||||||||||||||||||||||||||||||||||||||
| 1115 | 0 | ▶ | if ( -e $file && $dir && -d $dir ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/6
-e $file and $dir and -d $dir
-e $file and $dir
MC/DC0%0/3
-e $file and $dir and -d $dir
-e $file
$dir
-d $dir
Truth table0%0/4
A and B and C
A= -e $fileB= $dirC= -d $dir
| |||||||||||||||||||||||||||||||||||||||||||
| 1116 | 0 | $self->audit("moving file $file to $dir" ); | |||||||||||||||||||||||||||||||||||||||||
| 1117 | 0 | move $file, "$dir/$file"; | |||||||||||||||||||||||||||||||||||||||||
| 1118 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1119 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1120 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1121 | |||||||||||||||||||||||||||||||||||||||||||
| 1122 | 0 | my $r; | |||||||||||||||||||||||||||||||||||||||||
| 1123 | 0 | eval { | |||||||||||||||||||||||||||||||||||||||||
| 1124 | 0 | ▶ | local $SIG{ALRM} = sub { die "alarm\n" }; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
__ANON__: not called CC=1 SCAR=6.9
| |||||||||||||||||||||||||||||||||||||||||||
| 1125 | 0 | alarm $timeout; | |||||||||||||||||||||||||||||||||||||||||
| 1126 | 0 | $r = $self->syscmd( $fetchcmd, %args ); | |||||||||||||||||||||||||||||||||||||||||
| 1127 | 0 | alarm 0; | |||||||||||||||||||||||||||||||||||||||||
| 1128 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1129 | |||||||||||||||||||||||||||||||||||||||||||
| 1130 | 0 | ▶ | if ($EVAL_ERROR) { # propagate unexpected errors | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1131 | 0 | ▶ | print "timed out!\n" if $EVAL_ERROR eq "alarm\n"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1132 | 0 | return $self->error( $EVAL_ERROR, %args ); | |||||||||||||||||||||||||||||||||||||||||
| 1133 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1134 | |||||||||||||||||||||||||||||||||||||||||||
| 1135 | 0 | ▶ | return $self->error( "error executing $fetchcmd", %args) if !$r; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1136 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1137 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1138 | |||||||||||||||||||||||||||||||||||||||||||
| 1139 | sub has_module { | ||||||||||||||||||||||||||||||||||||||||||
| 1140 | 17 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
has_module: called CC=2 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1141 | 17 | my ($name, $ver) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1142 | |||||||||||||||||||||||||||||||||||||||||||
| 1143 | ## no critic ( ProhibitStringyEval ) | ||||||||||||||||||||||||||||||||||||||||||
| 1144 | 17 | ▶ | eval "use $name" . ($ver ? " $ver;" : ";"); | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
Subroutine
BEGIN: called CC=1 SCAR=0.0
Subroutine
BEGIN: called CC=1 SCAR=0.0
Subroutine
BEGIN: called CC=1 SCAR=0.0
Subroutine
BEGIN: called CC=1 SCAR=0.0
Subroutine
BEGIN: called CC=1 SCAR=0.0
Subroutine
BEGIN: called CC=1 SCAR=0.0
Subroutine
BEGIN: called CC=1 SCAR=0.0
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1145 | ## use critic | ||||||||||||||||||||||||||||||||||||||||||
| 1146 | |||||||||||||||||||||||||||||||||||||||||||
| 1147 | 17 | !$EVAL_ERROR; | |||||||||||||||||||||||||||||||||||||||||
| 1148 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1149 | |||||||||||||||||||||||||||||||||||||||||||
| 1150 | sub install_if_changed { | ||||||||||||||||||||||||||||||||||||||||||
| 1151 | 1 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_if_changed: called CC=21 SCAR=51.1
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1152 | 1 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 1153 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 1154 | { newfile => { type => SCALAR, optional => 0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1155 | existing=> { type => SCALAR, optional => 0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1156 | mode => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1157 | uid => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1158 | gid => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1159 | sudo => { type => BOOLEAN, optional => 1, default => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 1160 | notify => { type => BOOLEAN, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1161 | email => { type => SCALAR, optional => 1, default => 'postmaster' }, | ||||||||||||||||||||||||||||||||||||||||||
| 1162 | clean => { type => BOOLEAN, optional => 1, default => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 1163 | archive => { type => BOOLEAN, optional => 1, default => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 1164 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 1165 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 1166 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1167 | |||||||||||||||||||||||||||||||||||||||||||
| 1168 | my ( $newfile, $existing, $mode, $uid, $gid, $email) = ( | ||||||||||||||||||||||||||||||||||||||||||
| 1169 | 1 | $p{newfile}, $p{existing}, $p{mode}, $p{uid}, $p{gid}, $p{email} ); | |||||||||||||||||||||||||||||||||||||||||
| 1170 | 1 | my ($sudo, $notify ) = ($p{sudo}, $p{notify} ); | |||||||||||||||||||||||||||||||||||||||||
| 1171 | 1 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 1172 | |||||||||||||||||||||||||||||||||||||||||||
| 1173 | 1 | ▶ | if ( $newfile !~ /\// ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1174 | # relative filename given | ||||||||||||||||||||||||||||||||||||||||||
| 1175 | 0 | $self->audit( "relative filename given, use complete paths " | |||||||||||||||||||||||||||||||||||||||||
| 1176 | . "for more predicatable results!\n" | ||||||||||||||||||||||||||||||||||||||||||
| 1177 | . "working directory is " . cwd() ); | ||||||||||||||||||||||||||||||||||||||||||
| 1178 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1179 | |||||||||||||||||||||||||||||||||||||||||||
| 1180 | 1 | ▶ | return $self->error( "file ($newfile) does not exist", %args ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1181 | if !-e $newfile; | ||||||||||||||||||||||||||||||||||||||||||
| 1182 | |||||||||||||||||||||||||||||||||||||||||||
| 1183 | 1 | ▶ | return $self->error( "file ($newfile) is not a file", %args ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1184 | if !-f $newfile; | ||||||||||||||||||||||||||||||||||||||||||
| 1185 | |||||||||||||||||||||||||||||||||||||||||||
| 1186 | # make sure existing and new are writable | ||||||||||||||||||||||||||||||||||||||||||
| 1187 | 1 | ▶ | if ( !$self->is_writable( $existing, fatal => 0 ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$self->is_writable($existing, "fatal", 0) and $self->is_writable($newfile, "fatal", 0)
MC/DC0%0/2
$self->is_writable($existing, "fatal", 0) and $self->is_writable($newfile, "fatal", 0)
$self->is_writable($existing, "fatal", 0)
$self->is_writable($newfile, "fatal", 0)
Truth table33%1/3
A and B
A= $self->is_writable($existing, "fatal", 0)B= $self->is_writable($newfile, "fatal", 0)
| |||||||||||||||||||||||||||||||||||||||||||
| 1188 | || !$self->is_writable( $newfile, fatal => 0 ) ) { | ||||||||||||||||||||||||||||||||||||||||||
| 1189 | |||||||||||||||||||||||||||||||||||||||||||
| 1190 | # root does not have permission, sudo won't do any good | ||||||||||||||||||||||||||||||||||||||||||
| 1191 | 0 | ▶ | return $self->error("no write permission", %args) if $UID == 0; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1192 | |||||||||||||||||||||||||||||||||||||||||||
| 1193 | 0 | ▶ | if ( $sudo ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1194 | 0 | ▶ | $sudo = $self->find_bin( 'sudo', %args ) or | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1195 | return $self->error( "you are not root, sudo was not found, and you don't have permission to write to $newfile or $existing" ); | ||||||||||||||||||||||||||||||||||||||||||
| 1196 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1197 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1198 | |||||||||||||||||||||||||||||||||||||||||||
| 1199 | 1 | my $diffie; | |||||||||||||||||||||||||||||||||||||||||
| 1200 | 1 | ▶ | if ( -f $existing ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1201 | $diffie = $self->files_diff( %args, | ||||||||||||||||||||||||||||||||||||||||||
| 1202 | f1 => $newfile, | ||||||||||||||||||||||||||||||||||||||||||
| 1203 | f2 => $existing, | ||||||||||||||||||||||||||||||||||||||||||
| 1204 | type => "text", | ||||||||||||||||||||||||||||||||||||||||||
| 1205 | 1 | ▶ | ) or do { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1206 | 1 | $self->audit( "$existing is already up-to-date.", %args); | |||||||||||||||||||||||||||||||||||||||||
| 1207 | 1 | ▶ | unlink $newfile if $p{clean}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1208 | 1 | return 2; | |||||||||||||||||||||||||||||||||||||||||
| 1209 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1210 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1211 | |||||||||||||||||||||||||||||||||||||||||||
| 1212 | 0 | $self->audit("checking $existing", %args); | |||||||||||||||||||||||||||||||||||||||||
| 1213 | |||||||||||||||||||||||||||||||||||||||||||
| 1214 | 0 | ▶ | $self->chown( $newfile, | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$uid and $gid
MC/DC0%0/2
$uid and $gid
$uid
$gid
Truth table0%0/3
A and B
A= $uidB= $gid
| |||||||||||||||||||||||||||||||||||||||||||
| 1215 | uid => $uid, | ||||||||||||||||||||||||||||||||||||||||||
| 1216 | gid => $gid, | ||||||||||||||||||||||||||||||||||||||||||
| 1217 | sudo => $sudo, | ||||||||||||||||||||||||||||||||||||||||||
| 1218 | %args | ||||||||||||||||||||||||||||||||||||||||||
| 1219 | ) | ||||||||||||||||||||||||||||||||||||||||||
| 1220 | if ( $uid && $gid ); # set file ownership on the new file | ||||||||||||||||||||||||||||||||||||||||||
| 1221 | |||||||||||||||||||||||||||||||||||||||||||
| 1222 | # set file permissions on the new file | ||||||||||||||||||||||||||||||||||||||||||
| 1223 | 0 | ▶ | $self->chmod( | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
-e $existing and $mode
MC/DC0%0/2
-e $existing and $mode
-e $existing
$mode
Truth table0%0/3
A and B
A= -e $existingB= $mode
| |||||||||||||||||||||||||||||||||||||||||||
| 1224 | file_or_dir => $existing, | ||||||||||||||||||||||||||||||||||||||||||
| 1225 | mode => $mode, | ||||||||||||||||||||||||||||||||||||||||||
| 1226 | sudo => $sudo, | ||||||||||||||||||||||||||||||||||||||||||
| 1227 | %args | ||||||||||||||||||||||||||||||||||||||||||
| 1228 | ) | ||||||||||||||||||||||||||||||||||||||||||
| 1229 | if ( -e $existing && $mode ); | ||||||||||||||||||||||||||||||||||||||||||
| 1230 | |||||||||||||||||||||||||||||||||||||||||||
| 1231 | 0 | $self->install_if_changed_notify( $notify, $email, $existing, $diffie); | |||||||||||||||||||||||||||||||||||||||||
| 1232 | 0 | ▶ | $self->archive_file( $existing, %args) if ( -e $existing && $p{archive} ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
-e $existing and $p{"archive"}
MC/DC0%0/2
-e $existing and $p{"archive"}
-e $existing
$p{"archive"}
Truth table0%0/3
A and B
A= -e $existingB= $p{"archive"}
| |||||||||||||||||||||||||||||||||||||||||||
| 1233 | 0 | $self->install_if_changed_copy( $sudo, $newfile, $existing, $p{clean}, \%args ); | |||||||||||||||||||||||||||||||||||||||||
| 1234 | |||||||||||||||||||||||||||||||||||||||||||
| 1235 | 0 | ▶ | $self->chown( $existing, | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$uid and $gid
MC/DC0%0/2
$uid and $gid
$uid
$gid
Truth table0%0/3
A and B
A= $uidB= $gid
| |||||||||||||||||||||||||||||||||||||||||||
| 1236 | uid => $uid, | ||||||||||||||||||||||||||||||||||||||||||
| 1237 | gid => $gid, | ||||||||||||||||||||||||||||||||||||||||||
| 1238 | sudo => $sudo, | ||||||||||||||||||||||||||||||||||||||||||
| 1239 | %args | ||||||||||||||||||||||||||||||||||||||||||
| 1240 | ) if ( $uid && $gid ); # set ownership on new existing file | ||||||||||||||||||||||||||||||||||||||||||
| 1241 | |||||||||||||||||||||||||||||||||||||||||||
| 1242 | 0 | ▶ | $self->chmod( | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1243 | file_or_dir => $existing, | ||||||||||||||||||||||||||||||||||||||||||
| 1244 | mode => $mode, | ||||||||||||||||||||||||||||||||||||||||||
| 1245 | sudo => $sudo, | ||||||||||||||||||||||||||||||||||||||||||
| 1246 | %args | ||||||||||||||||||||||||||||||||||||||||||
| 1247 | ) | ||||||||||||||||||||||||||||||||||||||||||
| 1248 | if $mode; # set file permissions (paranoid) | ||||||||||||||||||||||||||||||||||||||||||
| 1249 | |||||||||||||||||||||||||||||||||||||||||||
| 1250 | 0 | $self->audit( " updated $existing" ); | |||||||||||||||||||||||||||||||||||||||||
| 1251 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1252 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1253 | |||||||||||||||||||||||||||||||||||||||||||
| 1254 | sub install_if_changed_copy { | ||||||||||||||||||||||||||||||||||||||||||
| 1255 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_if_changed_copy: not called CC=8 SCAR=42.8
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1256 | 0 | my ( $sudo, $newfile, $existing, $clean, $args ) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1257 | |||||||||||||||||||||||||||||||||||||||||||
| 1258 | # install the new file | ||||||||||||||||||||||||||||||||||||||||||
| 1259 | 0 | ▶ | if ($sudo) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1260 | 0 | my $cp = $self->find_bin( 'cp', %$args ); | |||||||||||||||||||||||||||||||||||||||||
| 1261 | |||||||||||||||||||||||||||||||||||||||||||
| 1262 | # back up the existing file | ||||||||||||||||||||||||||||||||||||||||||
| 1263 | 0 | ▶ | $self->syscmd( "$sudo $cp $existing $existing.bak", %$args) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1264 | if -e $existing; | ||||||||||||||||||||||||||||||||||||||||||
| 1265 | |||||||||||||||||||||||||||||||||||||||||||
| 1266 | # install the new one | ||||||||||||||||||||||||||||||||||||||||||
| 1267 | 0 | ▶ | if ( $clean ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1268 | 0 | my $mv = $self->find_bin( 'mv' ); | |||||||||||||||||||||||||||||||||||||||||
| 1269 | 0 | $self->syscmd( "$sudo $mv $newfile $existing", %$args); | |||||||||||||||||||||||||||||||||||||||||
| 1270 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1271 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 1272 | 0 | $self->syscmd( "$sudo $cp $newfile $existing",%$args); | |||||||||||||||||||||||||||||||||||||||||
| 1273 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1274 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1275 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 1276 | |||||||||||||||||||||||||||||||||||||||||||
| 1277 | # back up the existing file | ||||||||||||||||||||||||||||||||||||||||||
| 1278 | 0 | ▶ | copy( $existing, "$existing.bak" ) if -e $existing; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1279 | |||||||||||||||||||||||||||||||||||||||||||
| 1280 | 0 | ▶ | if ( $clean ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1281 | 0 | ▶ | move( $newfile, $existing ) or | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1282 | return $self->error( "failed move $newfile to $existing", %$args); | ||||||||||||||||||||||||||||||||||||||||||
| 1283 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1284 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 1285 | 0 | ▶ | copy( $newfile, $existing ) or | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1286 | return $self->error( "failed copy $newfile to $existing", %$args ); | ||||||||||||||||||||||||||||||||||||||||||
| 1287 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1288 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1289 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1290 | |||||||||||||||||||||||||||||||||||||||||||
| 1291 | sub install_if_changed_notify { | ||||||||||||||||||||||||||||||||||||||||||
| 1292 | |||||||||||||||||||||||||||||||||||||||||||
| 1293 | 0 | ▶ | my ($self, $notify, $email, $existing, $diffie) = @_; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_if_changed_notify: not called CC=4 SCAR=30.0
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1294 | |||||||||||||||||||||||||||||||||||||||||||
| 1295 | 0 | ▶ | return if ! $notify; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1296 | 0 | ▶ | return if ! -f $existing; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1297 | |||||||||||||||||||||||||||||||||||||||||||
| 1298 | # email diffs to admin | ||||||||||||||||||||||||||||||||||||||||||
| 1299 | |||||||||||||||||||||||||||||||||||||||||||
| 1300 | 0 | eval { require Mail::Send; }; | |||||||||||||||||||||||||||||||||||||||||
| 1301 | |||||||||||||||||||||||||||||||||||||||||||
| 1302 | 0 | ▶ | return $self->error( "could not send notice, Mail::Send is not installed!", fatal => 0) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1303 | if $EVAL_ERROR; | ||||||||||||||||||||||||||||||||||||||||||
| 1304 | |||||||||||||||||||||||||||||||||||||||||||
| 1305 | 0 | my $msg = Mail::Send->new; | |||||||||||||||||||||||||||||||||||||||||
| 1306 | 0 | $msg->subject("$existing updated by $0"); | |||||||||||||||||||||||||||||||||||||||||
| 1307 | 0 | $msg->to($email); | |||||||||||||||||||||||||||||||||||||||||
| 1308 | 0 | my $email_message = $msg->open; | |||||||||||||||||||||||||||||||||||||||||
| 1309 | |||||||||||||||||||||||||||||||||||||||||||
| 1310 | 0 | print $email_message "This message is to notify you that $existing has been altered. The difference between the new file and the old one is:\n\n$diffie"; | |||||||||||||||||||||||||||||||||||||||||
| 1311 | |||||||||||||||||||||||||||||||||||||||||||
| 1312 | 0 | $email_message->close; | |||||||||||||||||||||||||||||||||||||||||
| 1313 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1314 | |||||||||||||||||||||||||||||||||||||||||||
| 1315 | sub install_from_source { | ||||||||||||||||||||||||||||||||||||||||||
| 1316 | 2 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_from_source: called CC=26 SCAR=64.3
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1317 | 2 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 1318 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 1319 | { 'site' => { type => SCALAR, optional => 0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1320 | 'url' => { type => SCALAR, optional => 0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1321 | 'package' => { type => SCALAR, optional => 0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1322 | 'targets' => { type => ARRAYREF, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1323 | 'patches' => { type => ARRAYREF, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1324 | 'patch_url' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1325 | 'patch_args' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1326 | 'source_dir' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1327 | 'source_sub_dir' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1328 | 'bintest' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1329 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 1330 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 1331 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1332 | |||||||||||||||||||||||||||||||||||||||||||
| 1333 | 2 | ▶ | return $p{test_ok} if defined $p{test_ok}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1334 | 0 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 1335 | |||||||||||||||||||||||||||||||||||||||||||
| 1336 | my ( $site, $url, $package, $targets, $patches, $bintest ) = | ||||||||||||||||||||||||||||||||||||||||||
| 1337 | ( $p{site}, $p{url}, $p{package}, | ||||||||||||||||||||||||||||||||||||||||||
| 1338 | 0 | $p{targets}, $p{patches}, $p{bintest} ); | |||||||||||||||||||||||||||||||||||||||||
| 1339 | |||||||||||||||||||||||||||||||||||||||||||
| 1340 | 0 | ▶ | my $patch_args = $p{patch_args} || ''; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$p{'patch_args'} || ''
MC/DC0%0/1
$p{'patch_args'} || ''
$p{'patch_args'}
Truth table0%0/2
A
A= $p{'patch_args'}
| |||||||||||||||||||||||||||||||||||||||||||
| 1341 | 0 | ▶ | my $srcdir = $p{source_dir} || "/usr/local/src"; | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/2
$p{'source_dir'} || '/usr/local/src'
MC/DC0%0/1
$p{'source_dir'} || '/usr/local/src'
$p{'source_dir'}
Truth table0%0/2
A
A= $p{'source_dir'}
| |||||||||||||||||||||||||||||||||||||||||||
| 1342 | 0 | ▶ | $srcdir .= "/$p{source_sub_dir}" if $p{source_sub_dir}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1343 | |||||||||||||||||||||||||||||||||||||||||||
| 1344 | 0 | ▶ | if ( $bintest && $self->find_bin( $bintest, fatal => 0, verbose => 0 ) ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$bintest and $self->find_bin($bintest, "fatal", 0, "verbose", 0)
MC/DC0%0/2
$bintest and $self->find_bin($bintest, "fatal", 0, "verbose", 0)
$bintest
$self->find_bin($bintest, "fatal", 0, "verbose", 0)
Truth table0%0/3
A and B
A= $bintestB= $self->find_bin($bintest, "fatal", 0, "verbose", 0)
| |||||||||||||||||||||||||||||||||||||||||||
| 1345 | 0 | ▶ | return if ! $self->yes_or_no( | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1346 | "$bintest exists, suggesting that " | ||||||||||||||||||||||||||||||||||||||||||
| 1347 | . "$package is installed. Do you want to reinstall?", | ||||||||||||||||||||||||||||||||||||||||||
| 1348 | timeout => 60, | ||||||||||||||||||||||||||||||||||||||||||
| 1349 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1350 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1351 | |||||||||||||||||||||||||||||||||||||||||||
| 1352 | 0 | $self->audit( "install_from_source: building $package in $srcdir" ); | |||||||||||||||||||||||||||||||||||||||||
| 1353 | |||||||||||||||||||||||||||||||||||||||||||
| 1354 | 0 | my $original_directory = cwd; | |||||||||||||||||||||||||||||||||||||||||
| 1355 | 0 | $self->cwd_source_dir( $srcdir, %args ); | |||||||||||||||||||||||||||||||||||||||||
| 1356 | |||||||||||||||||||||||||||||||||||||||||||
| 1357 | 0 | ▶ | $self->install_from_source_cleanup($package,$srcdir) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1358 | 0 | ▶ | $self->install_from_source_get_files($package,$site,$url,$p{patch_url},$patches) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1359 | 0 | ▶ | $self->extract_archive( $package ) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1360 | |||||||||||||||||||||||||||||||||||||||||||
| 1361 | # cd into the package directory | ||||||||||||||||||||||||||||||||||||||||||
| 1362 | 0 | my $sub_path; | |||||||||||||||||||||||||||||||||||||||||
| 1363 | 0 | ▶ | if ( -d $package ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1364 | 0 | ▶ | chdir $package or | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1365 | return $self->error( "FAILED to chdir $package!", %args ); | ||||||||||||||||||||||||||||||||||||||||||
| 1366 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1367 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 1368 | |||||||||||||||||||||||||||||||||||||||||||
| 1369 | # some packages (like daemontools) unpack within an enclosing directory | ||||||||||||||||||||||||||||||||||||||||||
| 1370 | 0 | $sub_path = `find ./ -name $package`; # tainted data | |||||||||||||||||||||||||||||||||||||||||
| 1371 | 0 | chomp $sub_path; | |||||||||||||||||||||||||||||||||||||||||
| 1372 | 0 | ($sub_path) = $sub_path =~ /^([-\w\/.]+)$/; # untaint it | |||||||||||||||||||||||||||||||||||||||||
| 1373 | |||||||||||||||||||||||||||||||||||||||||||
| 1374 | 0 | ▶ | $self->audit( "found sources in $sub_path" ) if $sub_path; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1375 | 0 | ▶ | return $self->error( "FAILED to find $package sources!",fatal=>0) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
-d $sub_path and chdir $sub_path
MC/DC0%0/2
-d $sub_path and chdir $sub_path
-d $sub_path
chdir $sub_path
Truth table0%0/3
A and B
A= -d $sub_pathB= chdir $sub_path
| |||||||||||||||||||||||||||||||||||||||||||
| 1376 | unless ( -d $sub_path && chdir $sub_path ); | ||||||||||||||||||||||||||||||||||||||||||
| 1377 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1378 | |||||||||||||||||||||||||||||||||||||||||||
| 1379 | 0 | ▶ | $self->install_from_source_apply_patches($srcdir, $patches, $patch_args) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1380 | |||||||||||||||||||||||||||||||||||||||||||
| 1381 | # set default build targets if none are provided | ||||||||||||||||||||||||||||||||||||||||||
| 1382 | 0 | ▶ | if ( !@$targets[0] ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1383 | 0 | $self->audit( "\tusing default targets (./configure, make, make install)" ); | |||||||||||||||||||||||||||||||||||||||||
| 1384 | 0 | @$targets = ( "./configure", "make", "make install" ); | |||||||||||||||||||||||||||||||||||||||||
| 1385 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1386 | |||||||||||||||||||||||||||||||||||||||||||
| 1387 | 0 | my $msg = "install_from_source: using targets\n"; | |||||||||||||||||||||||||||||||||||||||||
| 1388 | 0 | foreach (@$targets) { $msg .= "\t$_\n" }; | |||||||||||||||||||||||||||||||||||||||||
| 1389 | 0 | $self->audit( $msg ); | |||||||||||||||||||||||||||||||||||||||||
| 1390 | |||||||||||||||||||||||||||||||||||||||||||
| 1391 | # build the program | ||||||||||||||||||||||||||||||||||||||||||
| 1392 | 0 | foreach my $target (@$targets) { | |||||||||||||||||||||||||||||||||||||||||
| 1393 | |||||||||||||||||||||||||||||||||||||||||||
| 1394 | 0 | ▶ | if ( $target =~ /^cd (.*)$/ ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1395 | 0 | $self->audit( "cwd: " . cwd . " -> " . $1 ); | |||||||||||||||||||||||||||||||||||||||||
| 1396 | 0 | ▶ | chdir($1) or return $self->error( "couldn't chdir $1: $!", %args); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1397 | 0 | next; | |||||||||||||||||||||||||||||||||||||||||
| 1398 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1399 | |||||||||||||||||||||||||||||||||||||||||||
| 1400 | 0 | ▶ | $self->syscmd( $target, %args ) or | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1401 | return $self->error( "pwd: " . cwd . "\n$target failed: $!", %args ); | ||||||||||||||||||||||||||||||||||||||||||
| 1402 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1403 | |||||||||||||||||||||||||||||||||||||||||||
| 1404 | # clean up the build sources | ||||||||||||||||||||||||||||||||||||||||||
| 1405 | 0 | chdir $srcdir; | |||||||||||||||||||||||||||||||||||||||||
| 1406 | 0 | ▶ | File::Path::rmtree($package) if -d $package; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1407 | |||||||||||||||||||||||||||||||||||||||||||
| 1408 | 0 | ▶ | if ( defined $sub_path && -d "$package/$sub_path" ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
defined $sub_path and -d "$package/$sub_path"
MC/DC0%0/2
defined $sub_path and -d "$package/$sub_path"
defined $sub_path
-d "$package/$sub_path"
Truth table0%0/3
A and B
A= defined $sub_pathB= -d "$package/$sub_path"
| |||||||||||||||||||||||||||||||||||||||||||
| 1409 | 0 | File::Path::rmtree( "$package/$sub_path" ); | |||||||||||||||||||||||||||||||||||||||||
| 1410 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1411 | |||||||||||||||||||||||||||||||||||||||||||
| 1412 | 0 | chdir $original_directory; | |||||||||||||||||||||||||||||||||||||||||
| 1413 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1414 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1415 | |||||||||||||||||||||||||||||||||||||||||||
| 1416 | sub install_from_source_apply_patches { | ||||||||||||||||||||||||||||||||||||||||||
| 1417 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_from_source_apply_patches: not called CC=5 SCAR=34.0
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1418 | 0 | my ($src, $patches,$patch_args) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1419 | |||||||||||||||||||||||||||||||||||||||||||
| 1420 | 0 | ▶ | return 1 if ! $patches; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1421 | 0 | ▶ | return 1 if ! $patches->[0]; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1422 | |||||||||||||||||||||||||||||||||||||||||||
| 1423 | 0 | my $patchbin = $self->find_bin( "patch" ); | |||||||||||||||||||||||||||||||||||||||||
| 1424 | 0 | foreach my $patch (@$patches) { | |||||||||||||||||||||||||||||||||||||||||
| 1425 | 0 | ▶ | $self->syscmd( "$patchbin $patch_args < $src/$patch" ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1426 | or return $self->error("failed to apply patch $patch"); | ||||||||||||||||||||||||||||||||||||||||||
| 1427 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1428 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1429 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1430 | |||||||||||||||||||||||||||||||||||||||||||
| 1431 | sub install_from_source_cleanup { | ||||||||||||||||||||||||||||||||||||||||||
| 1432 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_from_source_cleanup: not called CC=5 SCAR=34.0
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1433 | 0 | my ($package,$src) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1434 | |||||||||||||||||||||||||||||||||||||||||||
| 1435 | # make sure there are no previous sources in the way | ||||||||||||||||||||||||||||||||||||||||||
| 1436 | 0 | ▶ | return 1 if ! -d $package; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1437 | |||||||||||||||||||||||||||||||||||||||||||
| 1438 | 0 | ▶ | $self->source_warning( | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1439 | package => $package, | ||||||||||||||||||||||||||||||||||||||||||
| 1440 | clean => 1, | ||||||||||||||||||||||||||||||||||||||||||
| 1441 | src => $src, | ||||||||||||||||||||||||||||||||||||||||||
| 1442 | ) or return $self->error( "OK then, skipping install.", fatal => 0); | ||||||||||||||||||||||||||||||||||||||||||
| 1443 | |||||||||||||||||||||||||||||||||||||||||||
| 1444 | 0 | $self->audit( " removing previous build sources." ); | |||||||||||||||||||||||||||||||||||||||||
| 1445 | 0 | foreach my $dir ( glob "$package-*" ) { | |||||||||||||||||||||||||||||||||||||||||
| 1446 | 0 | ▶ | File::Path::rmtree( $dir ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1447 | or return $self->error("failed to delete $package: $!"); | ||||||||||||||||||||||||||||||||||||||||||
| 1448 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1449 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1450 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1451 | |||||||||||||||||||||||||||||||||||||||||||
| 1452 | sub install_from_source_get_files { | ||||||||||||||||||||||||||||||||||||||||||
| 1453 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_from_source_get_files: not called CC=8 SCAR=42.8
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1454 | 0 | my ($package,$site,$url,$patch_url,$patches) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1455 | |||||||||||||||||||||||||||||||||||||||||||
| 1456 | 0 | ▶ | $self->sources_get( | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1457 | package => $package, | ||||||||||||||||||||||||||||||||||||||||||
| 1458 | site => $site, | ||||||||||||||||||||||||||||||||||||||||||
| 1459 | path => $url, | ||||||||||||||||||||||||||||||||||||||||||
| 1460 | ) or return; | ||||||||||||||||||||||||||||||||||||||||||
| 1461 | |||||||||||||||||||||||||||||||||||||||||||
| 1462 | 0 | ▶ | if ( ! $patches || ! $patches->[0] ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$patches and $patches->[0]
MC/DC0%0/2
$patches and $patches->[0]
$patches
$patches->[0]
Truth table0%0/3
A and B
A= $patchesB= $patches->[0]
| |||||||||||||||||||||||||||||||||||||||||||
| 1463 | 0 | $self->audit( " no patches" ); | |||||||||||||||||||||||||||||||||||||||||
| 1464 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1465 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1466 | |||||||||||||||||||||||||||||||||||||||||||
| 1467 | 0 | ▶ | return $self->error( "oops! You supplied patch names to apply without a URL!") | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1468 | if ! $patch_url; | ||||||||||||||||||||||||||||||||||||||||||
| 1469 | |||||||||||||||||||||||||||||||||||||||||||
| 1470 | 0 | foreach my $patch (@$patches) { | |||||||||||||||||||||||||||||||||||||||||
| 1471 | 0 | ▶ | next if ! $patch; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1472 | 0 | ▶ | next if -e $patch; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1473 | 0 | $self->get_url( "$patch_url/$patch" ); | |||||||||||||||||||||||||||||||||||||||||
| 1474 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1475 | |||||||||||||||||||||||||||||||||||||||||||
| 1476 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1477 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1478 | |||||||||||||||||||||||||||||||||||||||||||
| 1479 | sub install_package { | ||||||||||||||||||||||||||||||||||||||||||
| 1480 | 0 | ▶ | my ($self, $app, $info) = @_; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_package: not called CC=10 SCAR=47.0
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1481 | |||||||||||||||||||||||||||||||||||||||||||
| 1482 | 0 | ▶ | if ( lc($OSNAME) eq 'freebsd' ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1483 | |||||||||||||||||||||||||||||||||||||||||||
| 1484 | my $portname = $info->{port} | ||||||||||||||||||||||||||||||||||||||||||
| 1485 | 0 | ▶ | or return $self->error( "skipping install of $app b/c port dir not set.", fatal => 0); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1486 | |||||||||||||||||||||||||||||||||||||||||||
| 1487 | 0 | require Mail::Toaster::FreeBSD; | |||||||||||||||||||||||||||||||||||||||||
| 1488 | 0 | my $freebsd = Mail::Toaster::FreeBSD->new; | |||||||||||||||||||||||||||||||||||||||||
| 1489 | 0 | ▶ | if ( $freebsd->is_port_installed( $app ) ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1490 | 0 | print "$app is installed.\n"; | |||||||||||||||||||||||||||||||||||||||||
| 1491 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1492 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1493 | |||||||||||||||||||||||||||||||||||||||||||
| 1494 | 0 | print "installing $app\n"; | |||||||||||||||||||||||||||||||||||||||||
| 1495 | 0 | my $portdir = glob("/usr/ports/*/$portname"); | |||||||||||||||||||||||||||||||||||||||||
| 1496 | |||||||||||||||||||||||||||||||||||||||||||
| 1497 | 0 | ▶ | return $self->error( "oops, couldn't find port $app at '$portname'") | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
-d $portdir and chdir $portdir
MC/DC0%0/2
-d $portdir and chdir $portdir
-d $portdir
chdir $portdir
Truth table0%0/3
A and B
A= -d $portdirB= chdir $portdir
| |||||||||||||||||||||||||||||||||||||||||||
| 1498 | if ( ! -d $portdir || ! chdir $portdir ); | ||||||||||||||||||||||||||||||||||||||||||
| 1499 | |||||||||||||||||||||||||||||||||||||||||||
| 1500 | 0 | ▶ | system "make install clean" | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1501 | and return $self->error( "'make install clean' failed for port $app", fatal => 0); | ||||||||||||||||||||||||||||||||||||||||||
| 1502 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1503 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1504 | |||||||||||||||||||||||||||||||||||||||||||
| 1505 | 0 | ▶ | if ( lc($OSNAME) eq 'linux' ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1506 | 0 | ▶ | my $rpm = $info->{rpm} or return $self->error("skipping install of $app b/c rpm not set", fatal => 0); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1507 | 0 | my $yum = '/usr/bin/yum'; | |||||||||||||||||||||||||||||||||||||||||
| 1508 | 0 | ▶ | return $self->error( "couldn't find yum, skipping install.", fatal => 0) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1509 | if ! -x $yum; | ||||||||||||||||||||||||||||||||||||||||||
| 1510 | 0 | return system "$yum install $rpm"; | |||||||||||||||||||||||||||||||||||||||||
| 1511 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1512 | |||||||||||||||||||||||||||||||||||||||||||
| 1513 | 0 | $self->error(" no package support for $OSNAME "); | |||||||||||||||||||||||||||||||||||||||||
| 1514 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1515 | |||||||||||||||||||||||||||||||||||||||||||
| 1516 | sub install_module { | ||||||||||||||||||||||||||||||||||||||||||
| 1517 | 0 | ▶ | my ($self, $module, %info) = @_; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_module: not called CC=8 SCAR=42.8
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1518 | |||||||||||||||||||||||||||||||||||||||||||
| 1519 | 0 | ▶ | if ( lc($OSNAME) eq 'darwin' ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 3 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 1520 | 0 | ▶ | $self->install_module_darwin( $module ) and return 1; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1521 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1522 | elsif ( lc($OSNAME) eq 'freebsd' ) { | ||||||||||||||||||||||||||||||||||||||||||
| 1523 | 0 | ▶ | $self->install_module_freebsd( $module, \%info) and return 1; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1524 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1525 | elsif ( lc($OSNAME) eq 'linux' ) { | ||||||||||||||||||||||||||||||||||||||||||
| 1526 | 0 | ▶ | $self->install_module_linux( $module, \%info) and return 1; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1527 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1528 | |||||||||||||||||||||||||||||||||||||||||||
| 1529 | 0 | $self->install_module_cpan( $module ); | |||||||||||||||||||||||||||||||||||||||||
| 1530 | |||||||||||||||||||||||||||||||||||||||||||
| 1531 | 0 | eval "use $module"; ## no critic ( StringyEval ) | |||||||||||||||||||||||||||||||||||||||||
| 1532 | 0 | ▶ | if ( ! $EVAL_ERROR ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1533 | 0 | $self->audit( "$module is installed." ); | |||||||||||||||||||||||||||||||||||||||||
| 1534 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1535 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1536 | 0 | return; | |||||||||||||||||||||||||||||||||||||||||
| 1537 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1538 | |||||||||||||||||||||||||||||||||||||||||||
| 1539 | sub install_module_cpan { | ||||||||||||||||||||||||||||||||||||||||||
| 1540 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_module_cpan: not called CC=3 SCAR=18.1
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1541 | 0 | my ($module, $version) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1542 | |||||||||||||||||||||||||||||||||||||||||||
| 1543 | 0 | print " from CPAN..."; | |||||||||||||||||||||||||||||||||||||||||
| 1544 | 0 | require CPAN; | |||||||||||||||||||||||||||||||||||||||||
| 1545 | |||||||||||||||||||||||||||||||||||||||||||
| 1546 | # some Linux distros break CPAN by auto/preconfiguring it with no URL mirrors. | ||||||||||||||||||||||||||||||||||||||||||
| 1547 | # this works around that annoying little habit | ||||||||||||||||||||||||||||||||||||||||||
| 1548 | 11 | ▶ | no warnings; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 1549 | 0 | $CPAN::Config = get_cpan_config(); | |||||||||||||||||||||||||||||||||||||||||
| 1550 | 11 | ▶ | use warnings; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||||||||||||
| 1551 | |||||||||||||||||||||||||||||||||||||||||||
| 1552 | 0 | ▶ | if ( $module eq 'Provision::Unix' && $version ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$module eq "Provision::Unix" and $version
MC/DC0%0/2
$module eq "Provision::Unix" and $version
$module eq "Provision::Unix"
$version
Truth table0%0/3
A and B
A= $module eq "Provision::Unix"B= $version
| |||||||||||||||||||||||||||||||||||||||||||
| 1553 | 0 | $module =~ s/\:\:/\-/g; | |||||||||||||||||||||||||||||||||||||||||
| 1554 | 0 | $module = "M/MS/MSIMERSON/$module-$version.tar.gz"; | |||||||||||||||||||||||||||||||||||||||||
| 1555 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1556 | 0 | CPAN::Shell->install($module); | |||||||||||||||||||||||||||||||||||||||||
| 1557 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1558 | |||||||||||||||||||||||||||||||||||||||||||
| 1559 | sub install_module_darwin { | ||||||||||||||||||||||||||||||||||||||||||
| 1560 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_module_darwin: not called CC=3 SCAR=24.8
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1561 | 0 | my $module = shift; | |||||||||||||||||||||||||||||||||||||||||
| 1562 | |||||||||||||||||||||||||||||||||||||||||||
| 1563 | 0 | my $dport = '/opt/local/bin/port'; | |||||||||||||||||||||||||||||||||||||||||
| 1564 | 0 | ▶ | return $self->error( "Darwin ports is not installed!", fatal => 0) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1565 | if ! -x $dport; | ||||||||||||||||||||||||||||||||||||||||||
| 1566 | |||||||||||||||||||||||||||||||||||||||||||
| 1567 | 0 | my $port = lc "p5-$module"; | |||||||||||||||||||||||||||||||||||||||||
| 1568 | 0 | $port =~ s/::/-/g; | |||||||||||||||||||||||||||||||||||||||||
| 1569 | 0 | ▶ | system "sudo $dport install $port" or return 1; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1570 | 0 | return; | |||||||||||||||||||||||||||||||||||||||||
| 1571 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1572 | |||||||||||||||||||||||||||||||||||||||||||
| 1573 | sub install_module_freebsd { | ||||||||||||||||||||||||||||||||||||||||||
| 1574 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_module_freebsd: not called CC=6 SCAR=37.4
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1575 | 0 | my ($module, $info) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1576 | |||||||||||||||||||||||||||||||||||||||||||
| 1577 | 0 | my $portname = $info->{port}; # optional override | |||||||||||||||||||||||||||||||||||||||||
| 1578 | 0 | ▶ | if ( ! $portname ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1579 | 0 | $portname = "p5-$module"; | |||||||||||||||||||||||||||||||||||||||||
| 1580 | 0 | $portname =~ s/::/-/g; | |||||||||||||||||||||||||||||||||||||||||
| 1581 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1582 | |||||||||||||||||||||||||||||||||||||||||||
| 1583 | 0 | ▶ | return 1 if $self->freebsd->is_port_installed( $portname ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1584 | 0 | ▶ | return 1 if $self->freebsd->install_package( $portname ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1585 | |||||||||||||||||||||||||||||||||||||||||||
| 1586 | 0 | my $portdir = glob("/usr/ports/*/$portname"); | |||||||||||||||||||||||||||||||||||||||||
| 1587 | 0 | ▶ | return if ! $portdir; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1588 | 0 | ▶ | return if ! -d $portdir; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1589 | |||||||||||||||||||||||||||||||||||||||||||
| 1590 | 0 | $self->audit( "installing $module from ports ($portdir)" ); | |||||||||||||||||||||||||||||||||||||||||
| 1591 | 0 | system "make -C $portdir clean install clean"; | |||||||||||||||||||||||||||||||||||||||||
| 1592 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1593 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1594 | |||||||||||||||||||||||||||||||||||||||||||
| 1595 | sub install_module_from_src { | ||||||||||||||||||||||||||||||||||||||||||
| 1596 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_module_from_src: not called CC=15 SCAR=54.8
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1597 | 0 | my %p = validate( @_, { | |||||||||||||||||||||||||||||||||||||||||
| 1598 | module => { type=>SCALAR, optional=>0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1599 | archive => { type=>SCALAR, optional=>0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1600 | site => { type=>SCALAR, optional=>0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1601 | url => { type=>SCALAR, optional=>0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1602 | src => { type=>SCALAR, optional=>1, default=>'/usr/local/src' }, | ||||||||||||||||||||||||||||||||||||||||||
| 1603 | targets => { type=>ARRAYREF,optional=>1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1604 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 1605 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 1606 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1607 | |||||||||||||||||||||||||||||||||||||||||||
| 1608 | my ( $module, $site, $url, $src, $targets ) | ||||||||||||||||||||||||||||||||||||||||||
| 1609 | 0 | = ( $p{module}, $p{site}, $p{url}, $p{src}, $p{targets} ); | |||||||||||||||||||||||||||||||||||||||||
| 1610 | 0 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 1611 | |||||||||||||||||||||||||||||||||||||||||||
| 1612 | 0 | $self->cwd_source_dir( $src, %args ); | |||||||||||||||||||||||||||||||||||||||||
| 1613 | |||||||||||||||||||||||||||||||||||||||||||
| 1614 | 0 | $self->audit( "checking for previous build attempts."); | |||||||||||||||||||||||||||||||||||||||||
| 1615 | 0 | ▶ | if ( -d $module ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1616 | 0 | ▶ | if ( ! $self->source_warning( package=>$module, src=>$src, %args ) ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1617 | 0 | print "\nokay, skipping install.\n"; | |||||||||||||||||||||||||||||||||||||||||
| 1618 | 0 | return; | |||||||||||||||||||||||||||||||||||||||||
| 1619 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1620 | 0 | ▶ | File::Path::rmtree( "$module" ) or die $!; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1621 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1622 | |||||||||||||||||||||||||||||||||||||||||||
| 1623 | $self->sources_get( | ||||||||||||||||||||||||||||||||||||||||||
| 1624 | site => $site, | ||||||||||||||||||||||||||||||||||||||||||
| 1625 | path => $url, | ||||||||||||||||||||||||||||||||||||||||||
| 1626 | 0 | ▶ | package => $p{'archive'} || $module, | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$p{'archive'} || $module
MC/DC0%0/2
$p{'archive'} || $module
$p{'archive'}
$module
Truth table0%0/3
A || B
A= $p{'archive'}B= $module
| |||||||||||||||||||||||||||||||||||||||||||
| 1627 | %args, | ||||||||||||||||||||||||||||||||||||||||||
| 1628 | ) or return; | ||||||||||||||||||||||||||||||||||||||||||
| 1629 | |||||||||||||||||||||||||||||||||||||||||||
| 1630 | 0 | ▶ | $self->extract_archive( $module ) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1631 | |||||||||||||||||||||||||||||||||||||||||||
| 1632 | 0 | my $found; | |||||||||||||||||||||||||||||||||||||||||
| 1633 | 0 | print "looking for $module in $src..."; | |||||||||||||||||||||||||||||||||||||||||
| 1634 | 0 | foreach my $file ( $self->get_dir_files( $src ) ) { | |||||||||||||||||||||||||||||||||||||||||
| 1635 | |||||||||||||||||||||||||||||||||||||||||||
| 1636 | 0 | ▶ | next if ! -d $file; # only check directories | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1637 | 0 | ▶ | next if $file !~ /$module/; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1638 | |||||||||||||||||||||||||||||||||||||||||||
| 1639 | 0 | print "found: $file\n"; | |||||||||||||||||||||||||||||||||||||||||
| 1640 | 0 | $found++; | |||||||||||||||||||||||||||||||||||||||||
| 1641 | 0 | chdir $file; | |||||||||||||||||||||||||||||||||||||||||
| 1642 | |||||||||||||||||||||||||||||||||||||||||||
| 1643 | 0 | ▶ | unless ( @$targets[0] && @$targets[0] ne "" ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
@$targets[0] and @$targets[0] ne ""
MC/DC0%0/2
@$targets[0] and @$targets[0] ne ""
@$targets[0]
@$targets[0] ne ""
Truth table0%0/3
A and B
A= @$targets[0]B= @$targets[0] ne ""
| |||||||||||||||||||||||||||||||||||||||||||
| 1644 | 0 | $self->audit( "using default targets." ); | |||||||||||||||||||||||||||||||||||||||||
| 1645 | 0 | $targets = [ "perl Makefile.PL", "make", "make install" ]; | |||||||||||||||||||||||||||||||||||||||||
| 1646 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1647 | |||||||||||||||||||||||||||||||||||||||||||
| 1648 | 0 | print "building with targets " . join( ", ", @$targets ) . "\n"; | |||||||||||||||||||||||||||||||||||||||||
| 1649 | 0 | foreach (@$targets) { | |||||||||||||||||||||||||||||||||||||||||
| 1650 | 0 | ▶ | return $self->error( "$_ failed!", %args) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1651 | if ! $self->syscmd( cmd => $_ , %args); | ||||||||||||||||||||||||||||||||||||||||||
| 1652 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1653 | |||||||||||||||||||||||||||||||||||||||||||
| 1654 | 0 | chdir('..'); | |||||||||||||||||||||||||||||||||||||||||
| 1655 | 0 | ▶ | File::Path::rmtree( $file ) or die $!; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1656 | 0 | last; | |||||||||||||||||||||||||||||||||||||||||
| 1657 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1658 | |||||||||||||||||||||||||||||||||||||||||||
| 1659 | 0 | return $found; | |||||||||||||||||||||||||||||||||||||||||
| 1660 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1661 | |||||||||||||||||||||||||||||||||||||||||||
| 1662 | sub install_module_linux { | ||||||||||||||||||||||||||||||||||||||||||
| 1663 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
install_module_linux: not called CC=3 SCAR=24.8
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1664 | 0 | my ($module, $info ) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 1665 | 0 | my $rpm = $info->{rpm}; | |||||||||||||||||||||||||||||||||||||||||
| 1666 | 0 | ▶ | if ( $rpm ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1667 | 0 | my $portname = "perl-$rpm"; | |||||||||||||||||||||||||||||||||||||||||
| 1668 | 0 | $portname =~ s/::/-/g; | |||||||||||||||||||||||||||||||||||||||||
| 1669 | 0 | my $yum = '/usr/bin/yum'; | |||||||||||||||||||||||||||||||||||||||||
| 1670 | 0 | ▶ | system "$yum -y install $portname" if -x $yum; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1671 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1672 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1673 | |||||||||||||||||||||||||||||||||||||||||||
| 1674 | sub is_interactive { | ||||||||||||||||||||||||||||||||||||||||||
| 1675 | |||||||||||||||||||||||||||||||||||||||||||
| 1676 | ## no critic | ||||||||||||||||||||||||||||||||||||||||||
| 1677 | # borrowed from IO::Interactive | ||||||||||||||||||||||||||||||||||||||||||
| 1678 | 1 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
is_interactive: called CC=10 SCAR=43.3
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1679 | 1 | my ($out_handle) = ( @_, select ); # Default to default output handle | |||||||||||||||||||||||||||||||||||||||||
| 1680 | |||||||||||||||||||||||||||||||||||||||||||
| 1681 | # Not interactive if output is not to terminal... | ||||||||||||||||||||||||||||||||||||||||||
| 1682 | 1 | ▶ | return if not -t $out_handle; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1683 | |||||||||||||||||||||||||||||||||||||||||||
| 1684 | # If *ARGV is opened, we're interactive if... | ||||||||||||||||||||||||||||||||||||||||||
| 1685 | 0 | ▶ | if ( openhandle * ARGV ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1686 | |||||||||||||||||||||||||||||||||||||||||||
| 1687 | # ...it's currently opened to the magic '-' file | ||||||||||||||||||||||||||||||||||||||||||
| 1688 | 0 | ▶ | return -t *STDIN if defined $ARGV && $ARGV eq '-'; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
defined $ARGV and $ARGV eq "-"
MC/DC0%0/2
defined $ARGV and $ARGV eq "-"
defined $ARGV
$ARGV eq "-"
Truth table0%0/3
A and B
A= defined $ARGVB= $ARGV eq "-"
| |||||||||||||||||||||||||||||||||||||||||||
| 1689 | |||||||||||||||||||||||||||||||||||||||||||
| 1690 | # ...it's at end-of-file and the next file is the magic '-' file | ||||||||||||||||||||||||||||||||||||||||||
| 1691 | 0 | ▶ | return @ARGV > 0 && $ARGV[0] eq '-' && -t *STDIN if eof *ARGV; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/6
@ARGV > 0 && $ARGV[0] eq '-' && -t *STDIN
@ARGV > 0 and $ARGV[0] eq "-"
MC/DC0%0/3
@ARGV > 0 && $ARGV[0] eq '-' && -t *STDIN
@ARGV > 0
$ARGV[0] eq "-"
-t *STDIN
Truth table0%0/4
A and B && C
A= @ARGV > 0B= $ARGV[0] eq "-"C= -t *STDIN
| |||||||||||||||||||||||||||||||||||||||||||
| 1692 | |||||||||||||||||||||||||||||||||||||||||||
| 1693 | # ...it's directly attached to the terminal | ||||||||||||||||||||||||||||||||||||||||||
| 1694 | 0 | return -t *ARGV; | |||||||||||||||||||||||||||||||||||||||||
| 1695 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1696 | |||||||||||||||||||||||||||||||||||||||||||
| 1697 | # If *ARGV isn't opened, it will be interactive if *STDIN is attached | ||||||||||||||||||||||||||||||||||||||||||
| 1698 | # to a terminal and either there are no files specified on the command line | ||||||||||||||||||||||||||||||||||||||||||
| 1699 | # or if there are files and the first is the magic '-' file | ||||||||||||||||||||||||||||||||||||||||||
| 1700 | 0 | ▶ | return -t *STDIN && ( @ARGV == 0 || $ARGV[0] eq '-' ); | ||||||||||||||||||||||||||||||||||||||||
|
Condition0%0/6
-t *STDIN && (@ARGV == 0 || $ARGV[0] eq '-')
@ARGV == 0 or $ARGV[0] eq "-"
MC/DC0%0/3
-t *STDIN && (@ARGV == 0 || $ARGV[0] eq '-')
-t *STDIN
@ARGV == 0
$ARGV[0] eq "-"
Truth table0%0/4
A && B or C
A= -t *STDINB= @ARGV == 0C= $ARGV[0] eq "-"
| |||||||||||||||||||||||||||||||||||||||||||
| 1701 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1702 | |||||||||||||||||||||||||||||||||||||||||||
| 1703 | sub is_process_running { | ||||||||||||||||||||||||||||||||||||||||||
| 1704 | 2 | ▶ | my ( $self, $process ) = @_; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
is_process_running: called CC=4 SCAR=15.5
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1705 | |||||||||||||||||||||||||||||||||||||||||||
| 1706 | 2 | my $ps = $self->find_bin( 'ps', verbose => 0 ); | |||||||||||||||||||||||||||||||||||||||||
| 1707 | |||||||||||||||||||||||||||||||||||||||||||
| 1708 | 2 | ▶ | if ( lc($OSNAME) =~ /solaris/i ) { $ps .= ' -ef'; } | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 3 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 1709 | 0 | elsif ( lc($OSNAME) =~ /irix/i ) { $ps .= ' -ef'; } | |||||||||||||||||||||||||||||||||||||||||
| 1710 | 2 | elsif ( lc($OSNAME) =~ /linux/i ) { $ps .= ' -efw'; } | |||||||||||||||||||||||||||||||||||||||||
| 1711 | 0 | else { $ps .= ' axww'; }; | |||||||||||||||||||||||||||||||||||||||||
| 1712 | |||||||||||||||||||||||||||||||||||||||||||
| 1713 | 2 | my @procs = `$ps`; | |||||||||||||||||||||||||||||||||||||||||
| 1714 | 2 | chomp @procs; | |||||||||||||||||||||||||||||||||||||||||
| 1715 | 2 | return scalar grep {/$process/i} @procs; | |||||||||||||||||||||||||||||||||||||||||
| 1716 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1717 | |||||||||||||||||||||||||||||||||||||||||||
| 1718 | sub is_readable { | ||||||||||||||||||||||||||||||||||||||||||
| 1719 | 2 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
is_readable: called CC=4 SCAR=14.0
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1720 | 2 | ▶ | my $file = shift or die "missing file or dir name\n"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1721 | 2 | my %p = validate( @_, { $self->get_std_opts } ); | |||||||||||||||||||||||||||||||||||||||||
| 1722 | |||||||||||||||||||||||||||||||||||||||||||
| 1723 | 2 | my %args = ( verbose => $p{verbose}, fatal => $p{fatal} ); | |||||||||||||||||||||||||||||||||||||||||
| 1724 | |||||||||||||||||||||||||||||||||||||||||||
| 1725 | 2 | ▶ | -e $file or return $self->error( "$file does not exist.", %args); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1726 | 1 | ▶ | -r $file or return $self->error( "$file is not readable by you (" | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1727 | . getpwuid($>) | ||||||||||||||||||||||||||||||||||||||||||
| 1728 | . "). You need to fix this, using chown or chmod.", %args); | ||||||||||||||||||||||||||||||||||||||||||
| 1729 | |||||||||||||||||||||||||||||||||||||||||||
| 1730 | 1 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1731 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1732 | |||||||||||||||||||||||||||||||||||||||||||
| 1733 | sub is_writable { | ||||||||||||||||||||||||||||||||||||||||||
| 1734 | 22 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
is_writable: called CC=7 SCAR=20.3
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1735 | 22 | ▶ | my $file = shift or die "missing file or dir name\n"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1736 | |||||||||||||||||||||||||||||||||||||||||||
| 1737 | 22 | my %p = validate( @_, { $self->get_std_opts } ); | |||||||||||||||||||||||||||||||||||||||||
| 1738 | 22 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 1739 | |||||||||||||||||||||||||||||||||||||||||||
| 1740 | 22 | my $nl = "\n"; | |||||||||||||||||||||||||||||||||||||||||
| 1741 | 22 | ▶ | $nl = "<br>" if ( $ENV{GATEWAY_INTERFACE} ); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1742 | |||||||||||||||||||||||||||||||||||||||||||
| 1743 | 22 | ▶ | if ( !-e $file ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1744 | |||||||||||||||||||||||||||||||||||||||||||
| 1745 | 8 | my ( $base, $path, $suffix ) = fileparse($file); | |||||||||||||||||||||||||||||||||||||||||
| 1746 | |||||||||||||||||||||||||||||||||||||||||||
| 1747 | 8 | ▶ | return $self->error( "is_writable: $path not writable by " | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
-e $path and not -w $path
MC/DC0%0/2
-e $path and not -w $path
-e $path
not -w $path
Truth table33%1/3
A and not(B)
A= -e $pathB= not -w $path
| |||||||||||||||||||||||||||||||||||||||||||
| 1748 | . getpwuid($>) | ||||||||||||||||||||||||||||||||||||||||||
| 1749 | . "$nl$nl", %args) if (-e $path && !-w $path); | ||||||||||||||||||||||||||||||||||||||||||
| 1750 | 8 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1751 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1752 | |||||||||||||||||||||||||||||||||||||||||||
| 1753 | 14 | ▶ | return $self->error( " $file not writable by " . getpwuid($>) . "$nl$nl", frames=>2, %args ) if ! -w $file; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1754 | |||||||||||||||||||||||||||||||||||||||||||
| 1755 | 14 | $self->audit( "$file is writable" ); | |||||||||||||||||||||||||||||||||||||||||
| 1756 | 14 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1757 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1758 | |||||||||||||||||||||||||||||||||||||||||||
| 1759 | sub logfile_append { | ||||||||||||||||||||||||||||||||||||||||||
| 1760 | 3 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
logfile_append: called CC=4 SCAR=13.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1761 | 3 | ▶ | my $file = shift or croak "missing filename!"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1762 | 3 | my %p = validate( @_, | |||||||||||||||||||||||||||||||||||||||||
| 1763 | { 'lines' => { type => ARRAYREF, optional => 0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1764 | 'prog' => { type => BOOLEAN, optional => 1, default => 0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1765 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 1766 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 1767 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1768 | |||||||||||||||||||||||||||||||||||||||||||
| 1769 | 3 | my $lines = $p{lines}; | |||||||||||||||||||||||||||||||||||||||||
| 1770 | 3 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 1771 | |||||||||||||||||||||||||||||||||||||||||||
| 1772 | 3 | my ( $dd, $mm, $yy, $lm, $hh, $mn, $ss ) = $self->get_the_date( %args ); | |||||||||||||||||||||||||||||||||||||||||
| 1773 | |||||||||||||||||||||||||||||||||||||||||||
| 1774 | 3 | ▶ | open my $LOG_FILE, '>>', $file | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1775 | or return $self->error( "couldn't open $file: $OS_ERROR", %args); | ||||||||||||||||||||||||||||||||||||||||||
| 1776 | |||||||||||||||||||||||||||||||||||||||||||
| 1777 | 3 | print $LOG_FILE "$yy-$mm-$dd $hh:$mn:$ss $p{prog} "; | |||||||||||||||||||||||||||||||||||||||||
| 1778 | |||||||||||||||||||||||||||||||||||||||||||
| 1779 | 3 | my $i; | |||||||||||||||||||||||||||||||||||||||||
| 1780 | 3 | foreach (@$lines) { print $LOG_FILE "$_ "; $i++ } | |||||||||||||||||||||||||||||||||||||||||
| 1781 | |||||||||||||||||||||||||||||||||||||||||||
| 1782 | 3 | print $LOG_FILE "\n"; | |||||||||||||||||||||||||||||||||||||||||
| 1783 | 3 | close $LOG_FILE; | |||||||||||||||||||||||||||||||||||||||||
| 1784 | |||||||||||||||||||||||||||||||||||||||||||
| 1785 | 3 | $self->audit( "logfile_append wrote $i lines to $file", %args ); | |||||||||||||||||||||||||||||||||||||||||
| 1786 | 3 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 1787 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1788 | |||||||||||||||||||||||||||||||||||||||||||
| 1789 | sub mail_toaster { | ||||||||||||||||||||||||||||||||||||||||||
| 1790 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
mail_toaster: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1791 | 0 | $self->install_module( 'Mail::Toaster' ); | |||||||||||||||||||||||||||||||||||||||||
| 1792 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1793 | |||||||||||||||||||||||||||||||||||||||||||
| 1794 | sub mkdir_system { | ||||||||||||||||||||||||||||||||||||||||||
| 1795 | 7 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
mkdir_system: called CC=13 SCAR=38.7
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1796 | 7 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 1797 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 1798 | { 'dir' => { type => SCALAR, optional => 0, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1799 | 'mode' => { type => SCALAR, optional => 1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1800 | 'sudo' => { type => BOOLEAN, optional => 1, default => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 1801 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 1802 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1803 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1804 | |||||||||||||||||||||||||||||||||||||||||||
| 1805 | 7 | my ( $dir, $mode ) = ( $p{dir}, $p{mode} ); | |||||||||||||||||||||||||||||||||||||||||
| 1806 | 7 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 1807 | |||||||||||||||||||||||||||||||||||||||||||
| 1808 | 7 | ▶ | return $self->audit( "mkdir_system: $dir already exists.") if -d $dir; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1809 | |||||||||||||||||||||||||||||||||||||||||||
| 1810 | 7 | ▶ | my $mkdir = $self->find_bin( 'mkdir', %args) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1811 | |||||||||||||||||||||||||||||||||||||||||||
| 1812 | # if we are root, just do it (no sudo nonsense) | ||||||||||||||||||||||||||||||||||||||||||
| 1813 | 7 | ▶ | if ( $< == 0 ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1814 | 0 | ▶ | $self->syscmd( "$mkdir -p $dir", %args) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1815 | 0 | ▶ | $self->chmod( dir => $dir, mode => $mode, %args ) if $mode; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1816 | |||||||||||||||||||||||||||||||||||||||||||
| 1817 | 0 | ▶ | return 1 if -d $dir; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1818 | 0 | return $self->error( "failed to create $dir", %args); | |||||||||||||||||||||||||||||||||||||||||
| 1819 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1820 | |||||||||||||||||||||||||||||||||||||||||||
| 1821 | 7 | ▶ | if ( $p{sudo} ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1822 | 0 | my $sudo = $self->sudo(); | |||||||||||||||||||||||||||||||||||||||||
| 1823 | |||||||||||||||||||||||||||||||||||||||||||
| 1824 | 0 | $self->audit( "trying $sudo $mkdir -p $dir"); | |||||||||||||||||||||||||||||||||||||||||
| 1825 | 0 | $self->syscmd( "$sudo $mkdir -p $dir", %args); | |||||||||||||||||||||||||||||||||||||||||
| 1826 | |||||||||||||||||||||||||||||||||||||||||||
| 1827 | 0 | $self->audit( "setting ownership to $<."); | |||||||||||||||||||||||||||||||||||||||||
| 1828 | 0 | my $chown = $self->find_bin( 'chown', %args); | |||||||||||||||||||||||||||||||||||||||||
| 1829 | 0 | $self->syscmd( "$sudo $chown $< $dir", %args); | |||||||||||||||||||||||||||||||||||||||||
| 1830 | |||||||||||||||||||||||||||||||||||||||||||
| 1831 | 0 | ▶ | $self->chmod( dir => $dir, mode => $mode, sudo => $sudo, %args) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1832 | if $mode; | ||||||||||||||||||||||||||||||||||||||||||
| 1833 | 0 | ▶ | return -d $dir ? 1 : 0; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1834 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1835 | |||||||||||||||||||||||||||||||||||||||||||
| 1836 | 7 | $self->audit( "trying mkdir -p $dir" ); | |||||||||||||||||||||||||||||||||||||||||
| 1837 | |||||||||||||||||||||||||||||||||||||||||||
| 1838 | # no root and no sudo, just try and see what happens | ||||||||||||||||||||||||||||||||||||||||||
| 1839 | 7 | ▶ | $self->syscmd( "$mkdir -p $dir", %args ) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1840 | |||||||||||||||||||||||||||||||||||||||||||
| 1841 | 1 | ▶ | $self->chmod( dir => $dir, mode => $mode, %args) if $mode; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1842 | |||||||||||||||||||||||||||||||||||||||||||
| 1843 | 1 | ▶ | return $self->audit( "mkdir_system created $dir" ) if -d $dir; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1844 | 0 | return $self->error( '', %args ); | |||||||||||||||||||||||||||||||||||||||||
| 1845 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1846 | |||||||||||||||||||||||||||||||||||||||||||
| 1847 | sub check_pidfile { | ||||||||||||||||||||||||||||||||||||||||||
| 1848 | 3 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
check_pidfile: called CC=9 SCAR=24.8
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1849 | 3 | my $file = shift; | |||||||||||||||||||||||||||||||||||||||||
| 1850 | 3 | my %p = validate( @_, { $self->get_std_opts } ); | |||||||||||||||||||||||||||||||||||||||||
| 1851 | 3 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 1852 | |||||||||||||||||||||||||||||||||||||||||||
| 1853 | 3 | ▶ | return $self->error( "missing filename", %args) if ! $file; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1854 | 3 | ▶ | return $self->error( "$file is not a regular file", %args) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition100%3/3
-e $file and not -f $file
MC/DC100%2/2
-e $file and not -f $file
-e $file
not -f $file
Truth table100%3/3
A and not(B)
A= -e $fileB= not -f $file
| |||||||||||||||||||||||||||||||||||||||||||
| 1855 | if ( -e $file && !-f $file ); | ||||||||||||||||||||||||||||||||||||||||||
| 1856 | |||||||||||||||||||||||||||||||||||||||||||
| 1857 | # test if file & enclosing directory is writable, revert to /tmp if not | ||||||||||||||||||||||||||||||||||||||||||
| 1858 | $self->is_writable( $file, %args) | ||||||||||||||||||||||||||||||||||||||||||
| 1859 | 2 | ▶ | or do { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1860 | 0 | my ( $base, $path, $suffix ) = fileparse($file); | |||||||||||||||||||||||||||||||||||||||||
| 1861 | 0 | $self->audit( "NOTICE: using /tmp for file, $path is not writable!", %args); | |||||||||||||||||||||||||||||||||||||||||
| 1862 | 0 | $file = "/tmp/$base"; | |||||||||||||||||||||||||||||||||||||||||
| 1863 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1864 | |||||||||||||||||||||||||||||||||||||||||||
| 1865 | # if it does not exist | ||||||||||||||||||||||||||||||||||||||||||
| 1866 | 2 | ▶ | if ( !-e $file ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1867 | 1 | $self->audit( "writing process id $PROCESS_ID to $file..."); | |||||||||||||||||||||||||||||||||||||||||
| 1868 | 1 | ▶ | $self->file_write( $file, lines => [$PROCESS_ID], %args) and return $file; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1869 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1870 | |||||||||||||||||||||||||||||||||||||||||||
| 1871 | 1 | my $age = time() - stat($file)->mtime; | |||||||||||||||||||||||||||||||||||||||||
| 1872 | |||||||||||||||||||||||||||||||||||||||||||
| 1873 | 1 | ▶ | if ( $age < 1200 ) { # less than 20 minutes old | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 1874 | 1 | return $self->error( "check_pidfile: $file is " . $age / 60 | |||||||||||||||||||||||||||||||||||||||||
| 1875 | . " minutes old and might still be running. If it is not running," | ||||||||||||||||||||||||||||||||||||||||||
| 1876 | . " please remove the file (rm $file).", %args); | ||||||||||||||||||||||||||||||||||||||||||
| 1877 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1878 | elsif ( $age < 3600 ) { # 1 hour | ||||||||||||||||||||||||||||||||||||||||||
| 1879 | 0 | return $self->error( "check_pidfile: $file is " . $age / 60 | |||||||||||||||||||||||||||||||||||||||||
| 1880 | . " minutes old and might still be running. If it is not running," | ||||||||||||||||||||||||||||||||||||||||||
| 1881 | . " please remove the pidfile. (rm $file)", %args); | ||||||||||||||||||||||||||||||||||||||||||
| 1882 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1883 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 1884 | 0 | $self->audit( "check_pidfile: $file is $age seconds old, ignoring.", %args); | |||||||||||||||||||||||||||||||||||||||||
| 1885 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1886 | |||||||||||||||||||||||||||||||||||||||||||
| 1887 | 0 | return $file; | |||||||||||||||||||||||||||||||||||||||||
| 1888 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1889 | |||||||||||||||||||||||||||||||||||||||||||
| 1890 | sub parse_config { | ||||||||||||||||||||||||||||||||||||||||||
| 1891 | 8 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
parse_config: called CC=10 SCAR=23.2
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1892 | 8 | ▶ | my $file = shift or die "missing file name"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1893 | 8 | my %p = validate( @_, { | |||||||||||||||||||||||||||||||||||||||||
| 1894 | etcdir => { type=>SCALAR, optional=>1, }, | ||||||||||||||||||||||||||||||||||||||||||
| 1895 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 1896 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 1897 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1898 | |||||||||||||||||||||||||||||||||||||||||||
| 1899 | 8 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 1900 | |||||||||||||||||||||||||||||||||||||||||||
| 1901 | 8 | ▶ | if ( ! -f $file ) { $file = $self->find_config( $file, %args ); }; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1902 | |||||||||||||||||||||||||||||||||||||||||||
| 1903 | 8 | ▶ | if ( ! $file || ! -r $file ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
$file and -r $file
MC/DC50%1/2
$file and -r $file
$file
-r $file
Truth table66%2/3
A and B
A= $fileB= -r $file
| |||||||||||||||||||||||||||||||||||||||||||
| 1904 | 1 | return $self->error( "could not find config file!", %args); | |||||||||||||||||||||||||||||||||||||||||
| 1905 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 1906 | |||||||||||||||||||||||||||||||||||||||||||
| 1907 | 7 | my %hash; | |||||||||||||||||||||||||||||||||||||||||
| 1908 | 7 | $self->audit( " read config from $file"); | |||||||||||||||||||||||||||||||||||||||||
| 1909 | |||||||||||||||||||||||||||||||||||||||||||
| 1910 | 7 | my @config = $self->file_read( $file ); | |||||||||||||||||||||||||||||||||||||||||
| 1911 | 7 | foreach ( @config ) { | |||||||||||||||||||||||||||||||||||||||||
| 1912 | 3139 | ▶ | next if ! $_; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1913 | 2695 | chomp; | |||||||||||||||||||||||||||||||||||||||||
| 1914 | 2695 | ▶ | next if $_ =~ /^#/; # skip lines beginning with # | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1915 | 1889 | ▶ | next if $_ =~ /^[\s+]?$/; # skip empty lines | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1916 | |||||||||||||||||||||||||||||||||||||||||||
| 1917 | 1889 | my ( $key, $val ) = $self->parse_line( $_ ); | |||||||||||||||||||||||||||||||||||||||||
| 1918 | |||||||||||||||||||||||||||||||||||||||||||
| 1919 | 1889 | ▶ | next if ! $key; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1920 | 1810 | $hash{$key} = $val; | |||||||||||||||||||||||||||||||||||||||||
| 1921 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1922 | |||||||||||||||||||||||||||||||||||||||||||
| 1923 | 7 | return \%hash; | |||||||||||||||||||||||||||||||||||||||||
| 1924 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1925 | |||||||||||||||||||||||||||||||||||||||||||
| 1926 | sub parse_line { | ||||||||||||||||||||||||||||||||||||||||||
| 1927 | 1893 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
parse_line: called CC=4 SCAR=13.9
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1928 | 1893 | my $line = shift; | |||||||||||||||||||||||||||||||||||||||||
| 1929 | 1893 | my %p = validate( @_, { | |||||||||||||||||||||||||||||||||||||||||
| 1930 | strip => { type => BOOLEAN, optional=>1, default=>1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 1931 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 1932 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1933 | |||||||||||||||||||||||||||||||||||||||||||
| 1934 | 1893 | my $strip = $p{strip}; | |||||||||||||||||||||||||||||||||||||||||
| 1935 | |||||||||||||||||||||||||||||||||||||||||||
| 1936 | # this regexp must match and return these patterns | ||||||||||||||||||||||||||||||||||||||||||
| 1937 | # localhost1 = localhost, disk, da0, disk_da0 | ||||||||||||||||||||||||||||||||||||||||||
| 1938 | # hosts = localhost lab.simerson.net seattle.simerson.net | ||||||||||||||||||||||||||||||||||||||||||
| 1939 | |||||||||||||||||||||||||||||||||||||||||||
| 1940 | 1893 | my ( $key, $val ) = $line =~ /\A | |||||||||||||||||||||||||||||||||||||||||
| 1941 | \s* # any amount of leading white space, greedy | ||||||||||||||||||||||||||||||||||||||||||
| 1942 | (.*?) # all characters, non greedy | ||||||||||||||||||||||||||||||||||||||||||
| 1943 | \s* # any amount of white space, greedy | ||||||||||||||||||||||||||||||||||||||||||
| 1944 | = | ||||||||||||||||||||||||||||||||||||||||||
| 1945 | \s* # same, except on the other side of the = | ||||||||||||||||||||||||||||||||||||||||||
| 1946 | (.*?) | ||||||||||||||||||||||||||||||||||||||||||
| 1947 | \s* | ||||||||||||||||||||||||||||||||||||||||||
| 1948 | \z/xms; | ||||||||||||||||||||||||||||||||||||||||||
| 1949 | |||||||||||||||||||||||||||||||||||||||||||
| 1950 | # remove any comments | ||||||||||||||||||||||||||||||||||||||||||
| 1951 | 1893 | ▶ | if ( $strip && $val && $val =~ /#/ ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition83%5/6
$strip and $val and $val =~ /#/
$strip and $val
MC/DC66%2/3
$strip and $val and $val =~ /#/
$strip
$val
$val =~ /#/
Truth table75%3/4
A and B and C
A= $stripB= $valC= $val =~ /#/
| |||||||||||||||||||||||||||||||||||||||||||
| 1952 | |||||||||||||||||||||||||||||||||||||||||||
| 1953 | # removes everything from a # to the right, including | ||||||||||||||||||||||||||||||||||||||||||
| 1954 | # any spaces to the left of the # symbol. | ||||||||||||||||||||||||||||||||||||||||||
| 1955 | 903 | ($val) = $val =~ /(.*?\S)\s*#/; | |||||||||||||||||||||||||||||||||||||||||
| 1956 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1957 | |||||||||||||||||||||||||||||||||||||||||||
| 1958 | 1893 | return ( $key, $val ); | |||||||||||||||||||||||||||||||||||||||||
| 1959 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1960 | |||||||||||||||||||||||||||||||||||||||||||
| 1961 | sub provision_unix { | ||||||||||||||||||||||||||||||||||||||||||
| 1962 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
provision_unix: not called CC=1 SCAR=6.9
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 1963 | 0 | $self->install_module( 'Provision::Unix' ); | |||||||||||||||||||||||||||||||||||||||||
| 1964 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1965 | |||||||||||||||||||||||||||||||||||||||||||
| 1966 | sub regexp_test { | ||||||||||||||||||||||||||||||||||||||||||
| 1967 | 1 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
regexp_test: called CC=8 SCAR=31.5
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 1968 | 1 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 1969 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 1970 | { 'exp' => { type => SCALAR }, | ||||||||||||||||||||||||||||||||||||||||||
| 1971 | 'string' => { type => SCALAR }, | ||||||||||||||||||||||||||||||||||||||||||
| 1972 | 'pbp' => { type => BOOLEAN, optional => 1, default => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 1973 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 1974 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 1975 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 1976 | |||||||||||||||||||||||||||||||||||||||||||
| 1977 | 1 | my $verbose = $p{verbose}; | |||||||||||||||||||||||||||||||||||||||||
| 1978 | 1 | my ( $exp, $string, $pbp ) = ( $p{exp}, $p{string}, $p{pbp} ); | |||||||||||||||||||||||||||||||||||||||||
| 1979 | |||||||||||||||||||||||||||||||||||||||||||
| 1980 | 1 | ▶ | if ($pbp) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1981 | 0 | ▶ | if ( $string =~ m{($exp)}xms ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1982 | 0 | ▶ | print "\t Matched pbp: |$`<$&>$'|\n" if $verbose; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1983 | 0 | return $1; | |||||||||||||||||||||||||||||||||||||||||
| 1984 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1985 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 1986 | 0 | ▶ | print "\t No match.\n" if $verbose; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1987 | 0 | return; | |||||||||||||||||||||||||||||||||||||||||
| 1988 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1989 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1990 | |||||||||||||||||||||||||||||||||||||||||||
| 1991 | 1 | ▶ | if ( $string =~ m{($exp)} ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1992 | 1 | ▶ | print "\t Matched: |$`<$&>$'|\n" if $verbose; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1993 | 1 | return $1; | |||||||||||||||||||||||||||||||||||||||||
| 1994 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1995 | |||||||||||||||||||||||||||||||||||||||||||
| 1996 | 0 | ▶ | print "\t No match.\n" if $verbose; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 1997 | 0 | return; | |||||||||||||||||||||||||||||||||||||||||
| 1998 | } | ||||||||||||||||||||||||||||||||||||||||||
| 1999 | |||||||||||||||||||||||||||||||||||||||||||
| 2000 | sub sources_get { | ||||||||||||||||||||||||||||||||||||||||||
| 2001 | 0 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
sources_get: not called CC=12 SCAR=50.5
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 2002 | 0 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 2003 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 2004 | { 'package' => { type => SCALAR, optional => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 2005 | site => { type => SCALAR, optional => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 2006 | path => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 2007 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 2008 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 2009 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 2010 | |||||||||||||||||||||||||||||||||||||||||||
| 2011 | 0 | my ( $package, $site, $path ) = ( $p{package}, $p{site}, $p{path} ); | |||||||||||||||||||||||||||||||||||||||||
| 2012 | 0 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 2013 | |||||||||||||||||||||||||||||||||||||||||||
| 2014 | 0 | $self->audit( "sources_get: fetching $package from site $site\n\t path: $path"); | |||||||||||||||||||||||||||||||||||||||||
| 2015 | |||||||||||||||||||||||||||||||||||||||||||
| 2016 | 0 | my @extensions = qw/ tar.gz tgz tar.bz2 tbz2 /; | |||||||||||||||||||||||||||||||||||||||||
| 2017 | |||||||||||||||||||||||||||||||||||||||||||
| 2018 | 0 | ▶ | my $filet = $self->find_bin( 'file', %args) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2019 | 0 | ▶ | my $grep = $self->find_bin( 'grep', %args) or return; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2020 | |||||||||||||||||||||||||||||||||||||||||||
| 2021 | 0 | foreach my $ext (@extensions) { | |||||||||||||||||||||||||||||||||||||||||
| 2022 | |||||||||||||||||||||||||||||||||||||||||||
| 2023 | 0 | my $tarball = "$package.$ext"; | |||||||||||||||||||||||||||||||||||||||||
| 2024 | 0 | ▶ | next if !-e $tarball; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2025 | 0 | ▶ | $self->audit( " found $tarball!") if -e $tarball; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2026 | |||||||||||||||||||||||||||||||||||||||||||
| 2027 | 0 | ▶ | if (`$filet $tarball | $grep compress`) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2028 | 0 | ▶ | $self->yes_or_no( "$tarball exists, shall I use it?: ") | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2029 | and return $self->audit( " ok, using existing archive: $tarball"); | ||||||||||||||||||||||||||||||||||||||||||
| 2030 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2031 | |||||||||||||||||||||||||||||||||||||||||||
| 2032 | 0 | $self->file_delete( $tarball, %args ); | |||||||||||||||||||||||||||||||||||||||||
| 2033 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2034 | |||||||||||||||||||||||||||||||||||||||||||
| 2035 | 0 | foreach my $ext (@extensions) { | |||||||||||||||||||||||||||||||||||||||||
| 2036 | 0 | my $tarball = "$package.$ext"; | |||||||||||||||||||||||||||||||||||||||||
| 2037 | |||||||||||||||||||||||||||||||||||||||||||
| 2038 | 0 | $self->audit( "sources_get: fetching ".$site . $path.'/'.$tarball); | |||||||||||||||||||||||||||||||||||||||||
| 2039 | |||||||||||||||||||||||||||||||||||||||||||
| 2040 | 0 | ▶ | $self->get_url( "$site$path/$tarball", fatal => 0) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2041 | or return $self->error( "couldn't fetch $site$path/$tarball", %args); | ||||||||||||||||||||||||||||||||||||||||||
| 2042 | |||||||||||||||||||||||||||||||||||||||||||
| 2043 | 0 | ▶ | next if ! -e $tarball; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2044 | |||||||||||||||||||||||||||||||||||||||||||
| 2045 | 0 | $self->audit( " sources_get: testing $tarball "); | |||||||||||||||||||||||||||||||||||||||||
| 2046 | |||||||||||||||||||||||||||||||||||||||||||
| 2047 | 0 | ▶ | if (`$filet $tarball | $grep zip`) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2048 | 0 | $self->audit( " sources_get: looks good!"); | |||||||||||||||||||||||||||||||||||||||||
| 2049 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 2050 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 2051 | |||||||||||||||||||||||||||||||||||||||||||
| 2052 | 0 | $self->audit( " oops, is not [b|g]zipped data!"); | |||||||||||||||||||||||||||||||||||||||||
| 2053 | 0 | $self->file_delete( $tarball, %args); | |||||||||||||||||||||||||||||||||||||||||
| 2054 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2055 | |||||||||||||||||||||||||||||||||||||||||||
| 2056 | 0 | return $self->error( "unable to get $package", %args ); | |||||||||||||||||||||||||||||||||||||||||
| 2057 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2058 | |||||||||||||||||||||||||||||||||||||||||||
| 2059 | sub source_warning { | ||||||||||||||||||||||||||||||||||||||||||
| 2060 | 1 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
source_warning: called CC=6 SCAR=30.8
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 2061 | 1 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 2062 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 2063 | { 'package' => { type => SCALAR, }, | ||||||||||||||||||||||||||||||||||||||||||
| 2064 | 'clean' => { type => BOOLEAN, optional => 1, default => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 2065 | 'src' => { | ||||||||||||||||||||||||||||||||||||||||||
| 2066 | type => SCALAR, | ||||||||||||||||||||||||||||||||||||||||||
| 2067 | optional => 1, | ||||||||||||||||||||||||||||||||||||||||||
| 2068 | default => "/usr/local/src" | ||||||||||||||||||||||||||||||||||||||||||
| 2069 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 2070 | 'timeout' => { type => SCALAR, optional => 1, default => 60 }, | ||||||||||||||||||||||||||||||||||||||||||
| 2071 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 2072 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 2073 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 2074 | |||||||||||||||||||||||||||||||||||||||||||
| 2075 | 1 | my ( $package, $src ) = ( $p{package}, $p{src} ); | |||||||||||||||||||||||||||||||||||||||||
| 2076 | 1 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 2077 | |||||||||||||||||||||||||||||||||||||||||||
| 2078 | 1 | ▶ | return $self->audit( "$package sources not present.", %args ) if !-d $package; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2079 | |||||||||||||||||||||||||||||||||||||||||||
| 2080 | 0 | ▶ | if ( -e $package ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2081 | 0 | print " | |||||||||||||||||||||||||||||||||||||||||
| 2082 | $package sources are already present, indicating that you've already | ||||||||||||||||||||||||||||||||||||||||||
| 2083 | installed $package. If you want to reinstall it, remove the existing | ||||||||||||||||||||||||||||||||||||||||||
| 2084 | sources (rm -r $src/$package) and re-run this script\n\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 2085 | 0 | ▶ | return if !$p{clean}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2086 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2087 | |||||||||||||||||||||||||||||||||||||||||||
| 2088 | 0 | ▶ | if ( !$self->yes_or_no( "\n\tMay I remove the sources for you?", timeout => $p{timeout} ) ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2089 | 0 | print "\nskipping $package install.\n\n"; | |||||||||||||||||||||||||||||||||||||||||
| 2090 | 0 | return; | |||||||||||||||||||||||||||||||||||||||||
| 2091 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 2092 | |||||||||||||||||||||||||||||||||||||||||||
| 2093 | 0 | $self->audit( " wd: " . cwd ); | |||||||||||||||||||||||||||||||||||||||||
| 2094 | 0 | $self->audit( " deleting $src/$package"); | |||||||||||||||||||||||||||||||||||||||||
| 2095 | |||||||||||||||||||||||||||||||||||||||||||
| 2096 | 0 | ▶ | return $self->error( "failed to delete $package: $OS_ERROR", %args ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2097 | if ! rmtree "$src/$package"; | ||||||||||||||||||||||||||||||||||||||||||
| 2098 | 0 | return 1; | |||||||||||||||||||||||||||||||||||||||||
| 2099 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2100 | |||||||||||||||||||||||||||||||||||||||||||
| 2101 | sub sudo { | ||||||||||||||||||||||||||||||||||||||||||
| 2102 | 1 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
sudo: called CC=7 SCAR=27.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 2103 | 1 | my %p = validate( @_, { $self->get_std_opts } ); | |||||||||||||||||||||||||||||||||||||||||
| 2104 | |||||||||||||||||||||||||||||||||||||||||||
| 2105 | # if we are running as root via $< | ||||||||||||||||||||||||||||||||||||||||||
| 2106 | 1 | ▶ | if ( $REAL_USER_ID == 0 ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2107 | 0 | $self->audit( "sudo: you are root, sudo isn't necessary."); | |||||||||||||||||||||||||||||||||||||||||
| 2108 | 0 | return ''; # return an empty string, purposefully | |||||||||||||||||||||||||||||||||||||||||
| 2109 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2110 | |||||||||||||||||||||||||||||||||||||||||||
| 2111 | 1 | my $sudo; | |||||||||||||||||||||||||||||||||||||||||
| 2112 | 1 | my $path_to_sudo = $self->find_bin( 'sudo', fatal => 0 ); | |||||||||||||||||||||||||||||||||||||||||
| 2113 | |||||||||||||||||||||||||||||||||||||||||||
| 2114 | # sudo is installed | ||||||||||||||||||||||||||||||||||||||||||
| 2115 | 1 | ▶ | if ( $path_to_sudo && -x $path_to_sudo ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$path_to_sudo and -x $path_to_sudo
MC/DC0%0/2
$path_to_sudo and -x $path_to_sudo
$path_to_sudo
-x $path_to_sudo
Truth table33%1/3
A and B
A= $path_to_sudoB= -x $path_to_sudo
| |||||||||||||||||||||||||||||||||||||||||||
| 2116 | 0 | $self->audit( "sudo: sudo was found at $path_to_sudo."); | |||||||||||||||||||||||||||||||||||||||||
| 2117 | 0 | return "$path_to_sudo -p 'Password for %u@%h:'"; | |||||||||||||||||||||||||||||||||||||||||
| 2118 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2119 | |||||||||||||||||||||||||||||||||||||||||||
| 2120 | 1 | $self->audit( "\nWARNING: Couldn't find sudo. This may not be a problem but some features require root permissions and will not work without them. Having sudo can allow legitimate and limited root permission to non-root users. Some features of Mail::Toaster may not work as expected without it.\n"); | |||||||||||||||||||||||||||||||||||||||||
| 2121 | |||||||||||||||||||||||||||||||||||||||||||
| 2122 | # try installing sudo | ||||||||||||||||||||||||||||||||||||||||||
| 2123 | 1 | ▶ | $self->yes_or_no( "may I try to install sudo?", timeout => 20 ) or do { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2124 | 1 | print "very well then, skipping along.\n"; | |||||||||||||||||||||||||||||||||||||||||
| 2125 | 1 | return ""; | |||||||||||||||||||||||||||||||||||||||||
| 2126 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 2127 | |||||||||||||||||||||||||||||||||||||||||||
| 2128 | 0 | ▶ | -x $self->find_bin( "sudo", fatal => 0 ) or | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2129 | $self->install_from_source( | ||||||||||||||||||||||||||||||||||||||||||
| 2130 | package => 'sudo-1.6.9p17', | ||||||||||||||||||||||||||||||||||||||||||
| 2131 | site => 'http://www.courtesan.com', | ||||||||||||||||||||||||||||||||||||||||||
| 2132 | url => '/sudo/', | ||||||||||||||||||||||||||||||||||||||||||
| 2133 | targets => [ './configure', 'make', 'make install' ], | ||||||||||||||||||||||||||||||||||||||||||
| 2134 | patches => '', | ||||||||||||||||||||||||||||||||||||||||||
| 2135 | verbose => 1, | ||||||||||||||||||||||||||||||||||||||||||
| 2136 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 2137 | |||||||||||||||||||||||||||||||||||||||||||
| 2138 | # can we find it now? | ||||||||||||||||||||||||||||||||||||||||||
| 2139 | 0 | $path_to_sudo = $self->find_bin( "sudo" ); | |||||||||||||||||||||||||||||||||||||||||
| 2140 | |||||||||||||||||||||||||||||||||||||||||||
| 2141 | 0 | ▶ | if ( !-x $path_to_sudo ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2142 | 0 | print "sudo install failed!"; | |||||||||||||||||||||||||||||||||||||||||
| 2143 | 0 | return ''; | |||||||||||||||||||||||||||||||||||||||||
| 2144 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2145 | |||||||||||||||||||||||||||||||||||||||||||
| 2146 | 0 | return "$path_to_sudo -p 'Password for %u@%h:'"; | |||||||||||||||||||||||||||||||||||||||||
| 2147 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2148 | |||||||||||||||||||||||||||||||||||||||||||
| 2149 | sub syscmd { | ||||||||||||||||||||||||||||||||||||||||||
| 2150 | 16 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
syscmd: called CC=20 SCAR=34.9
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 2151 | 16 | ▶ | my $cmd = shift or die "missing command!\n"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2152 | 16 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 2153 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 2154 | { 'timeout' => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 2155 | $self->get_std_opts, | ||||||||||||||||||||||||||||||||||||||||||
| 2156 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 2157 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 2158 | |||||||||||||||||||||||||||||||||||||||||||
| 2159 | 16 | my %args = $self->get_std_args( %p ); | |||||||||||||||||||||||||||||||||||||||||
| 2160 | |||||||||||||||||||||||||||||||||||||||||||
| 2161 | 16 | $self->audit("syscmd: $cmd"); | |||||||||||||||||||||||||||||||||||||||||
| 2162 | |||||||||||||||||||||||||||||||||||||||||||
| 2163 | 16 | my ( $is_safe, $tainted, $bin, @args ); | |||||||||||||||||||||||||||||||||||||||||
| 2164 | |||||||||||||||||||||||||||||||||||||||||||
| 2165 | # separate the program from its arguments | ||||||||||||||||||||||||||||||||||||||||||
| 2166 | 16 | ▶ | if ( $cmd =~ m/\s+/xm ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2167 | 16 | ($cmd) = $cmd =~ /^\s*(.*?)\s*$/; # trim lead/trailing whitespace | |||||||||||||||||||||||||||||||||||||||||
| 2168 | 16 | @args = split /\s+/, $cmd; # split on whitespace | |||||||||||||||||||||||||||||||||||||||||
| 2169 | 16 | $bin = shift @args; | |||||||||||||||||||||||||||||||||||||||||
| 2170 | 16 | $is_safe++; | |||||||||||||||||||||||||||||||||||||||||
| 2171 | 16 | $self->audit("\tprogram: $bin, args : " . join ' ', @args, %args); | |||||||||||||||||||||||||||||||||||||||||
| 2172 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2173 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 2174 | # does not not contain a ./ pattern | ||||||||||||||||||||||||||||||||||||||||||
| 2175 | 0 | ▶ | if ( $cmd !~ m{\./} ) { $bin = $cmd; $is_safe++; }; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2176 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2177 | |||||||||||||||||||||||||||||||||||||||||||
| 2178 | 16 | ▶ | if ( $is_safe && !$bin ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$is_safe and not $bin
MC/DC0%0/2
$is_safe and not $bin
$is_safe
not $bin
Truth table33%1/3
A and not(B)
A= $is_safeB= not $bin
| |||||||||||||||||||||||||||||||||||||||||||
| 2179 | 0 | return $self->error("command is not safe! BAILING OUT!", %args); | |||||||||||||||||||||||||||||||||||||||||
| 2180 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2181 | |||||||||||||||||||||||||||||||||||||||||||
| 2182 | 16 | my $message; | |||||||||||||||||||||||||||||||||||||||||
| 2183 | 16 | ▶ | $message .= "syscmd: bin is <$bin>" if $bin; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2184 | 16 | ▶ | $message .= " (safe)" if $is_safe; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2185 | 16 | $self->audit($message, %args ); | |||||||||||||||||||||||||||||||||||||||||
| 2186 | |||||||||||||||||||||||||||||||||||||||||||
| 2187 | 16 | ▶ | if ( $bin && !-e $bin ) { # $bin is set, but we have not found it | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
$bin and not -e $bin
MC/DC50%1/2
$bin and not -e $bin
$bin
not -e $bin
Truth table66%2/3
A and not(B)
A= $binB= not -e $bin
| |||||||||||||||||||||||||||||||||||||||||||
| 2188 | 5 | ▶ | $bin = $self->find_bin( $bin, fatal => 0, verbose => 0 ) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2189 | or return $self->error( "$bin was not found", %args); | ||||||||||||||||||||||||||||||||||||||||||
| 2190 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2191 | 16 | unshift @args, $bin; | |||||||||||||||||||||||||||||||||||||||||
| 2192 | |||||||||||||||||||||||||||||||||||||||||||
| 2193 | 16 | require Scalar::Util; | |||||||||||||||||||||||||||||||||||||||||
| 2194 | 16 | ▶ | $tainted++ if Scalar::Util::tainted($cmd); | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2195 | |||||||||||||||||||||||||||||||||||||||||||
| 2196 | 16 | my $before_path = $ENV{PATH}; | |||||||||||||||||||||||||||||||||||||||||
| 2197 | |||||||||||||||||||||||||||||||||||||||||||
| 2198 | # instead of croaking, maybe try setting a | ||||||||||||||||||||||||||||||||||||||||||
| 2199 | # very restrictive PATH? I'll err on the side of safety | ||||||||||||||||||||||||||||||||||||||||||
| 2200 | # $ENV{PATH} = ''; | ||||||||||||||||||||||||||||||||||||||||||
| 2201 | 16 | ▶ | return $self->error( "syscmd request has tainted data", %args) | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$tainted and not $is_safe
MC/DC0%0/2
$tainted and not $is_safe
$tainted
not $is_safe
Truth table33%1/3
A and not(B)
A= $taintedB= not $is_safe
| |||||||||||||||||||||||||||||||||||||||||||
| 2202 | if ( $tainted && !$is_safe ); | ||||||||||||||||||||||||||||||||||||||||||
| 2203 | |||||||||||||||||||||||||||||||||||||||||||
| 2204 | 16 | ▶ | if ($is_safe) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2205 | 16 | my $prefix = "/usr/local"; # restrict the path | |||||||||||||||||||||||||||||||||||||||||
| 2206 | 16 | ▶ | $prefix = "/opt/local" if -d "/opt/local"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2207 | 16 | $ENV{PATH} = "/bin:/sbin:/usr/bin:/usr/sbin:$prefix/bin:$prefix/sbin"; | |||||||||||||||||||||||||||||||||||||||||
| 2208 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2209 | |||||||||||||||||||||||||||||||||||||||||||
| 2210 | 16 | my $r; | |||||||||||||||||||||||||||||||||||||||||
| 2211 | 16 | eval { | |||||||||||||||||||||||||||||||||||||||||
| 2212 | 16 | ▶ | if ( defined $p{timeout} ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2213 | 1 | ▶ | local $SIG{ALRM} = sub { die "alarm\n" }; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
__ANON__: not called CC=1 SCAR=1.2
| |||||||||||||||||||||||||||||||||||||||||||
| 2214 | 1 | alarm $p{timeout}; | |||||||||||||||||||||||||||||||||||||||||
| 2215 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 2216 | #$r = system $cmd; | ||||||||||||||||||||||||||||||||||||||||||
| 2217 | 16 | $r = `$cmd 2>&1`; | |||||||||||||||||||||||||||||||||||||||||
| 2218 | 16 | ▶ | alarm 0 if defined $p{timeout}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2219 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 2220 | |||||||||||||||||||||||||||||||||||||||||||
| 2221 | 16 | ▶ | if ($EVAL_ERROR) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2222 | 0 | ▶ | if ( $EVAL_ERROR eq "alarm\n" ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2223 | 0 | $self->audit("timed out"); | |||||||||||||||||||||||||||||||||||||||||
| 2224 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2225 | else { | ||||||||||||||||||||||||||||||||||||||||||
| 2226 | 0 | return $self->error( "unknown error '$EVAL_ERROR'", %args); | |||||||||||||||||||||||||||||||||||||||||
| 2227 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2228 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2229 | 16 | $ENV{PATH} = $before_path; # set PATH back to original value | |||||||||||||||||||||||||||||||||||||||||
| 2230 | |||||||||||||||||||||||||||||||||||||||||||
| 2231 | 16 | my @caller = caller; | |||||||||||||||||||||||||||||||||||||||||
| 2232 | 16 | return $self->syscmd_exit_code( $r, $CHILD_ERROR, \@caller, \%args ); | |||||||||||||||||||||||||||||||||||||||||
| 2233 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2234 | |||||||||||||||||||||||||||||||||||||||||||
| 2235 | sub syscmd_exit_code { | ||||||||||||||||||||||||||||||||||||||||||
| 2236 | 16 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
syscmd_exit_code: called CC=5 SCAR=17.8
Pod
undocumented
| |||||||||||||||||||||||||||||||||||||||||||
| 2237 | 16 | my ($r, $err, $caller, $args) = @_; | |||||||||||||||||||||||||||||||||||||||||
| 2238 | |||||||||||||||||||||||||||||||||||||||||||
| 2239 | 16 | $self->audit( "r: $r" ); | |||||||||||||||||||||||||||||||||||||||||
| 2240 | |||||||||||||||||||||||||||||||||||||||||||
| 2241 | 16 | my $exit_code = sprintf ("%d", $err >> 8); | |||||||||||||||||||||||||||||||||||||||||
| 2242 | 16 | ▶ | return 1 if $exit_code == 0; # success | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2243 | |||||||||||||||||||||||||||||||||||||||||||
| 2244 | #print 'error # ' . $ERRNO . "\n"; # $! == $ERRNO | ||||||||||||||||||||||||||||||||||||||||||
| 2245 | 10 | $self->error( "$err: $r",fatal=>0); | |||||||||||||||||||||||||||||||||||||||||
| 2246 | |||||||||||||||||||||||||||||||||||||||||||
| 2247 | 10 | ▶ | if ( $err == -1 ) { # check $? for "normal" errors | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||||||||||||||||
| 2248 | 0 | $self->error( "failed to execute: $ERRNO", fatal=>0); | |||||||||||||||||||||||||||||||||||||||||
| 2249 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2250 | elsif ( $err & 127 ) { # check for core dump | ||||||||||||||||||||||||||||||||||||||||||
| 2251 | 0 | ▶ | printf "child died with signal %d, %s coredump\n", ( $? & 127 ), | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2252 | ( $? & 128 ) ? 'with' : 'without'; | ||||||||||||||||||||||||||||||||||||||||||
| 2253 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2254 | |||||||||||||||||||||||||||||||||||||||||||
| 2255 | 10 | return $self->error( "$err: $r", location => join( ", ", @$caller ), %$args ); | |||||||||||||||||||||||||||||||||||||||||
| 2256 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 2257 | |||||||||||||||||||||||||||||||||||||||||||
| 2258 | sub yes_or_no { | ||||||||||||||||||||||||||||||||||||||||||
| 2259 | 2 | ▶ | my $self = shift; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
yes_or_no: called CC=15 SCAR=49.2
Pod
documented
| |||||||||||||||||||||||||||||||||||||||||||
| 2260 | 2 | my $question = shift; | |||||||||||||||||||||||||||||||||||||||||
| 2261 | 2 | my %p = validate( | |||||||||||||||||||||||||||||||||||||||||
| 2262 | @_, | ||||||||||||||||||||||||||||||||||||||||||
| 2263 | { 'timeout' => { type => SCALAR, optional => 1 }, | ||||||||||||||||||||||||||||||||||||||||||
| 2264 | 'force' => { type => BOOLEAN, optional => 1, default => 0 }, | ||||||||||||||||||||||||||||||||||||||||||
| 2265 | $self->get_std_opts | ||||||||||||||||||||||||||||||||||||||||||
| 2266 | }, | ||||||||||||||||||||||||||||||||||||||||||
| 2267 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 2268 | |||||||||||||||||||||||||||||||||||||||||||
| 2269 | |||||||||||||||||||||||||||||||||||||||||||
| 2270 | # for 'make test' testing | ||||||||||||||||||||||||||||||||||||||||||
| 2271 | 2 | ▶ | return 1 if $question eq "test"; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2272 | |||||||||||||||||||||||||||||||||||||||||||
| 2273 | # force if interactivity testing is not working properly. | ||||||||||||||||||||||||||||||||||||||||||
| 2274 | 1 | ▶ | if ( !$p{force} && !$self->is_interactive ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$p{"force"} or $self->is_interactive
MC/DC0%0/2
$p{"force"} or $self->is_interactive
$p{"force"}
$self->is_interactive
Truth table33%1/3
A or B
A= $p{"force"}B= $self->is_interactive
| |||||||||||||||||||||||||||||||||||||||||||
| 2275 | 1 | carp "not running interactively, can't prompt!"; | |||||||||||||||||||||||||||||||||||||||||
| 2276 | 1 | return; | |||||||||||||||||||||||||||||||||||||||||
| 2277 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2278 | |||||||||||||||||||||||||||||||||||||||||||
| 2279 | 0 | my $response; | |||||||||||||||||||||||||||||||||||||||||
| 2280 | |||||||||||||||||||||||||||||||||||||||||||
| 2281 | 0 | ▶ | print "\nYou have $p{timeout} seconds to respond.\n" if $p{timeout}; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2282 | 0 | print "\n\t\t$question"; | |||||||||||||||||||||||||||||||||||||||||
| 2283 | |||||||||||||||||||||||||||||||||||||||||||
| 2284 | # I wish I knew why this is not working correctly | ||||||||||||||||||||||||||||||||||||||||||
| 2285 | # eval { local $SIG{__DIE__}; require Term::ReadKey }; | ||||||||||||||||||||||||||||||||||||||||||
| 2286 | # if ($@) { # | ||||||||||||||||||||||||||||||||||||||||||
| 2287 | # require Term::ReadKey; | ||||||||||||||||||||||||||||||||||||||||||
| 2288 | # Term::ReadKey->import(); | ||||||||||||||||||||||||||||||||||||||||||
| 2289 | # print "yay, Term::ReadKey is present! Are you pleased? (y/n):\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 2290 | # use Term::Readkey; | ||||||||||||||||||||||||||||||||||||||||||
| 2291 | # ReadMode 4; | ||||||||||||||||||||||||||||||||||||||||||
| 2292 | # while ( not defined ($key = ReadKey(-1))) | ||||||||||||||||||||||||||||||||||||||||||
| 2293 | # { # no key yet } | ||||||||||||||||||||||||||||||||||||||||||
| 2294 | # print "Got key $key\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 2295 | # ReadMode 0; | ||||||||||||||||||||||||||||||||||||||||||
| 2296 | # }; | ||||||||||||||||||||||||||||||||||||||||||
| 2297 | |||||||||||||||||||||||||||||||||||||||||||
| 2298 | 0 | ▶ | if ( $p{timeout} ) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2299 | 0 | eval { | |||||||||||||||||||||||||||||||||||||||||
| 2300 | 0 | ▶ | local $SIG{ALRM} = sub { die "alarm\n" }; | ||||||||||||||||||||||||||||||||||||||||
|
Subroutine
__ANON__: not called CC=1 SCAR=6.9
| |||||||||||||||||||||||||||||||||||||||||||
| 2301 | 0 | alarm $p{timeout}; | |||||||||||||||||||||||||||||||||||||||||
| 2302 | 0 | ▶ | do { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$response eq "n" or $response eq "y"
MC/DC0%0/2
$response eq "n" or $response eq "y"
$response eq "n"
$response eq "y"
Truth table0%0/3
A or B
A= $response eq "n"B= $response eq "y"
| |||||||||||||||||||||||||||||||||||||||||||
| 2303 | 0 | print "(y/n): "; | |||||||||||||||||||||||||||||||||||||||||
| 2304 | 0 | $response = lc(<STDIN>); | |||||||||||||||||||||||||||||||||||||||||
| 2305 | 0 | chomp($response); | |||||||||||||||||||||||||||||||||||||||||
| 2306 | } until ( $response eq "n" || $response eq "y" ); | ||||||||||||||||||||||||||||||||||||||||||
| 2307 | 0 | alarm 0; | |||||||||||||||||||||||||||||||||||||||||
| 2308 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 2309 | |||||||||||||||||||||||||||||||||||||||||||
| 2310 | 0 | ▶ | if ($@) { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2311 | 0 | ▶ | $@ eq "alarm\n" ? print "timed out!\n" : carp; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2312 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2313 | |||||||||||||||||||||||||||||||||||||||||||
| 2314 | 0 | ▶ | return ($response && $response eq "y") ? 1 : 0; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$response and $response eq "y"
MC/DC0%0/2
$response and $response eq "y"
$response
$response eq "y"
Truth table0%0/3
A and B
A= $responseB= $response eq "y"
| |||||||||||||||||||||||||||||||||||||||||||
| 2315 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2316 | |||||||||||||||||||||||||||||||||||||||||||
| 2317 | 0 | ▶ | do { | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
$response eq "n" or $response eq "y"
MC/DC0%0/2
$response eq "n" or $response eq "y"
$response eq "n"
$response eq "y"
Truth table0%0/3
A or B
A= $response eq "n"B= $response eq "y"
| |||||||||||||||||||||||||||||||||||||||||||
| 2318 | 0 | print "(y/n): "; | |||||||||||||||||||||||||||||||||||||||||
| 2319 | 0 | $response = lc(<STDIN>); | |||||||||||||||||||||||||||||||||||||||||
| 2320 | 0 | chomp($response); | |||||||||||||||||||||||||||||||||||||||||
| 2321 | } until ( $response eq "n" || $response eq "y" ); | ||||||||||||||||||||||||||||||||||||||||||
| 2322 | |||||||||||||||||||||||||||||||||||||||||||
| 2323 | 0 | ▶ | return ($response eq "y") ? 1 : 0; | ||||||||||||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||||||||||||
| 2324 | } | ||||||||||||||||||||||||||||||||||||||||||
| 2325 | |||||||||||||||||||||||||||||||||||||||||||
| 2326 | 11 | 1; | |||||||||||||||||||||||||||||||||||||||||
| 2327 | __END__ | ||||||||||||||||||||||||||||||||||||||||||
| 2328 | sub {}; # for vim autofold | ||||||||||||||||||||||||||||||||||||||||||
| 2329 | |||||||||||||||||||||||||||||||||||||||||||
| 2330 | |||||||||||||||||||||||||||||||||||||||||||
| 2331 | =head1 SYNOPSIS | ||||||||||||||||||||||||||||||||||||||||||
| 2332 | |||||||||||||||||||||||||||||||||||||||||||
| 2333 | use Mail::Toaster::Utility; | ||||||||||||||||||||||||||||||||||||||||||
| 2334 | my $toaster = Mail::Toaster::Utility->new; | ||||||||||||||||||||||||||||||||||||||||||
| 2335 | |||||||||||||||||||||||||||||||||||||||||||
| 2336 | $util->file_write($file, lines=> @lines); | ||||||||||||||||||||||||||||||||||||||||||
| 2337 | |||||||||||||||||||||||||||||||||||||||||||
| 2338 | This is just one of the many handy little methods I have amassed here. Rather than try to remember all of the best ways to code certain functions and then attempt to remember them, I have consolidated years of experience and countless references from Learning Perl, Programming Perl, Perl Best Practices, and many other sources into these subroutines. | ||||||||||||||||||||||||||||||||||||||||||
| 2339 | |||||||||||||||||||||||||||||||||||||||||||
| 2340 | |||||||||||||||||||||||||||||||||||||||||||
| 2341 | =head1 DESCRIPTION | ||||||||||||||||||||||||||||||||||||||||||
| 2342 | |||||||||||||||||||||||||||||||||||||||||||
| 2343 | This Mail::Toaster::Utility package is my most frequently used one. Each method has its own documentation but in general, all methods accept as input a hashref with at least one required argument and a number of optional arguments. | ||||||||||||||||||||||||||||||||||||||||||
| 2344 | |||||||||||||||||||||||||||||||||||||||||||
| 2345 | |||||||||||||||||||||||||||||||||||||||||||
| 2346 | =head1 DIAGNOSTICS | ||||||||||||||||||||||||||||||||||||||||||
| 2347 | |||||||||||||||||||||||||||||||||||||||||||
| 2348 | All methods set and return error codes (0 = fail, 1 = success) unless otherwise stated. | ||||||||||||||||||||||||||||||||||||||||||
| 2349 | |||||||||||||||||||||||||||||||||||||||||||
| 2350 | Unless otherwise mentioned, all methods accept two additional parameters: | ||||||||||||||||||||||||||||||||||||||||||
| 2351 | |||||||||||||||||||||||||||||||||||||||||||
| 2352 | verbose - to print status and verbose error messages, set verbose=>1. | ||||||||||||||||||||||||||||||||||||||||||
| 2353 | fatal - die on errors. This is the default, set fatal=>0 to override. | ||||||||||||||||||||||||||||||||||||||||||
| 2354 | |||||||||||||||||||||||||||||||||||||||||||
| 2355 | |||||||||||||||||||||||||||||||||||||||||||
| 2356 | =head1 DEPENDENCIES | ||||||||||||||||||||||||||||||||||||||||||
| 2357 | |||||||||||||||||||||||||||||||||||||||||||
| 2358 | Perl. | ||||||||||||||||||||||||||||||||||||||||||
| 2359 | Scalar::Util - built-in as of perl 5.8 | ||||||||||||||||||||||||||||||||||||||||||
| 2360 | |||||||||||||||||||||||||||||||||||||||||||
| 2361 | Almost nothing else. A few of the methods do require certian things, like extract_archive requires tar and file. But in general, this package (Mail::Toaster::Utility) should run flawlessly on any UNIX-like system. Because I recycle this package in other places (not just Mail::Toaster), I avoid creating dependencies here. | ||||||||||||||||||||||||||||||||||||||||||
| 2362 | |||||||||||||||||||||||||||||||||||||||||||
| 2363 | =head1 METHODS | ||||||||||||||||||||||||||||||||||||||||||
| 2364 | |||||||||||||||||||||||||||||||||||||||||||
| 2365 | =over | ||||||||||||||||||||||||||||||||||||||||||
| 2366 | |||||||||||||||||||||||||||||||||||||||||||
| 2367 | |||||||||||||||||||||||||||||||||||||||||||
| 2368 | =item new | ||||||||||||||||||||||||||||||||||||||||||
| 2369 | |||||||||||||||||||||||||||||||||||||||||||
| 2370 | To use any of the methods below, you must first create a utility object. The methods can be accessed via the utility object. | ||||||||||||||||||||||||||||||||||||||||||
| 2371 | |||||||||||||||||||||||||||||||||||||||||||
| 2372 | ############################################ | ||||||||||||||||||||||||||||||||||||||||||
| 2373 | # Usage : use Mail::Toaster::Utility; | ||||||||||||||||||||||||||||||||||||||||||
| 2374 | # : my $util = Mail::Toaster::Utility->new; | ||||||||||||||||||||||||||||||||||||||||||
| 2375 | # Purpose : create a new Mail::Toaster::Utility object | ||||||||||||||||||||||||||||||||||||||||||
| 2376 | # Returns : a bona fide object | ||||||||||||||||||||||||||||||||||||||||||
| 2377 | # Parameters : none | ||||||||||||||||||||||||||||||||||||||||||
| 2378 | ############################################ | ||||||||||||||||||||||||||||||||||||||||||
| 2379 | |||||||||||||||||||||||||||||||||||||||||||
| 2380 | |||||||||||||||||||||||||||||||||||||||||||
| 2381 | =item ask | ||||||||||||||||||||||||||||||||||||||||||
| 2382 | |||||||||||||||||||||||||||||||||||||||||||
| 2383 | |||||||||||||||||||||||||||||||||||||||||||
| 2384 | Get a response from the user. If the user responds, their response is returned. If not, then the default response is returned. If no default was supplied, 0 is returned. | ||||||||||||||||||||||||||||||||||||||||||
| 2385 | |||||||||||||||||||||||||||||||||||||||||||
| 2386 | ############################################ | ||||||||||||||||||||||||||||||||||||||||||
| 2387 | # Usage : my $ask = $util->ask( "Would you like fries with that", | ||||||||||||||||||||||||||||||||||||||||||
| 2388 | # default => "SuperSized!", | ||||||||||||||||||||||||||||||||||||||||||
| 2389 | # timeout => 30 | ||||||||||||||||||||||||||||||||||||||||||
| 2390 | # ); | ||||||||||||||||||||||||||||||||||||||||||
| 2391 | # Purpose : prompt the user for information | ||||||||||||||||||||||||||||||||||||||||||
| 2392 | # | ||||||||||||||||||||||||||||||||||||||||||
| 2393 | # Returns : S - the users response (if not empty) or | ||||||||||||||||||||||||||||||||||||||||||
| 2394 | # : S - the default ask or | ||||||||||||||||||||||||||||||||||||||||||
| 2395 | # : S - an empty string | ||||||||||||||||||||||||||||||||||||||||||
| 2396 | # | ||||||||||||||||||||||||||||||||||||||||||
| 2397 | # Parameters | ||||||||||||||||||||||||||||||||||||||||||
| 2398 | # Required : S - question - what to ask | ||||||||||||||||||||||||||||||||||||||||||
| 2399 | # Optional : S - default - a default answer | ||||||||||||||||||||||||||||||||||||||||||
| 2400 | # : I - timeout - how long to wait for a response | ||||||||||||||||||||||||||||||||||||||||||
| 2401 | # Throws : no exceptions | ||||||||||||||||||||||||||||||||||||||||||
| 2402 | # See Also : yes_or_no | ||||||||||||||||||||||||||||||||||||||||||
| 2403 | |||||||||||||||||||||||||||||||||||||||||||
| 2404 | |||||||||||||||||||||||||||||||||||||||||||
| 2405 | =item extract_archive | ||||||||||||||||||||||||||||||||||||||||||
| 2406 | |||||||||||||||||||||||||||||||||||||||||||
| 2407 | |||||||||||||||||||||||||||||||||||||||||||
| 2408 | Decompresses a variety of archive formats using your systems built in tools. | ||||||||||||||||||||||||||||||||||||||||||
| 2409 | |||||||||||||||||||||||||||||||||||||||||||
| 2410 | ############### extract_archive ################## | ||||||||||||||||||||||||||||||||||||||||||
| 2411 | # Usage : $util->extract_archive( 'example.tar.bz2' ); | ||||||||||||||||||||||||||||||||||||||||||
| 2412 | # Purpose : test the archiver, determine its contents, and then | ||||||||||||||||||||||||||||||||||||||||||
| 2413 | # use the best available means to expand it. | ||||||||||||||||||||||||||||||||||||||||||
| 2414 | # Returns : 0 - failure, 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2415 | # Parameters : S - archive - a bz2, gz, or tgz file to decompress | ||||||||||||||||||||||||||||||||||||||||||
| 2416 | |||||||||||||||||||||||||||||||||||||||||||
| 2417 | |||||||||||||||||||||||||||||||||||||||||||
| 2418 | =item cwd_source_dir | ||||||||||||||||||||||||||||||||||||||||||
| 2419 | |||||||||||||||||||||||||||||||||||||||||||
| 2420 | |||||||||||||||||||||||||||||||||||||||||||
| 2421 | Changes the current working directory to the supplied one. Creates it if it does not exist. Tries to create the directory using perl's builtin mkdir, then the system mkdir, and finally the system mkdir with sudo. | ||||||||||||||||||||||||||||||||||||||||||
| 2422 | |||||||||||||||||||||||||||||||||||||||||||
| 2423 | ############ cwd_source_dir ################### | ||||||||||||||||||||||||||||||||||||||||||
| 2424 | # Usage : $util->cwd_source_dir( "/usr/local/src" ); | ||||||||||||||||||||||||||||||||||||||||||
| 2425 | # Purpose : prepare a location to build source files in | ||||||||||||||||||||||||||||||||||||||||||
| 2426 | # Returns : 0 - failure, 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2427 | # Parameters : S - dir - a directory to build programs in | ||||||||||||||||||||||||||||||||||||||||||
| 2428 | |||||||||||||||||||||||||||||||||||||||||||
| 2429 | |||||||||||||||||||||||||||||||||||||||||||
| 2430 | =item check_homedir_ownership | ||||||||||||||||||||||||||||||||||||||||||
| 2431 | |||||||||||||||||||||||||||||||||||||||||||
| 2432 | Checks the ownership on all home directories to see if they are owned by their respective users in /etc/password. Offers to repair the permissions on incorrectly owned directories. This is useful when someone that knows better does something like "chown -R user /home /user" and fouls things up. | ||||||||||||||||||||||||||||||||||||||||||
| 2433 | |||||||||||||||||||||||||||||||||||||||||||
| 2434 | ######### check_homedir_ownership ############ | ||||||||||||||||||||||||||||||||||||||||||
| 2435 | # Usage : $util->check_homedir_ownership(); | ||||||||||||||||||||||||||||||||||||||||||
| 2436 | # Purpose : repair user homedir ownership | ||||||||||||||||||||||||||||||||||||||||||
| 2437 | # Returns : 0 - failure, 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2438 | # Parameters : | ||||||||||||||||||||||||||||||||||||||||||
| 2439 | # Optional : I - auto - no prompts, just fix everything | ||||||||||||||||||||||||||||||||||||||||||
| 2440 | # See Also : sysadmin | ||||||||||||||||||||||||||||||||||||||||||
| 2441 | |||||||||||||||||||||||||||||||||||||||||||
| 2442 | Comments: Auto mode should be run with great caution. Run it first to see the results and then, if everything looks good, run in auto mode to do the actual repairs. | ||||||||||||||||||||||||||||||||||||||||||
| 2443 | |||||||||||||||||||||||||||||||||||||||||||
| 2444 | |||||||||||||||||||||||||||||||||||||||||||
| 2445 | =item chown_system | ||||||||||||||||||||||||||||||||||||||||||
| 2446 | |||||||||||||||||||||||||||||||||||||||||||
| 2447 | The advantage this sub has over a Pure Perl implementation is that it can utilize sudo to gain elevated permissions that we might not otherwise have. | ||||||||||||||||||||||||||||||||||||||||||
| 2448 | |||||||||||||||||||||||||||||||||||||||||||
| 2449 | |||||||||||||||||||||||||||||||||||||||||||
| 2450 | ############### chown_system ################# | ||||||||||||||||||||||||||||||||||||||||||
| 2451 | # Usage : $util->chown_system( dir=>"/tmp/example", user=>'matt' ); | ||||||||||||||||||||||||||||||||||||||||||
| 2452 | # Purpose : change the ownership of a file or directory | ||||||||||||||||||||||||||||||||||||||||||
| 2453 | # Returns : 0 - failure, 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2454 | # Parameters : S - dir - the directory to chown | ||||||||||||||||||||||||||||||||||||||||||
| 2455 | # : S - user - a system username | ||||||||||||||||||||||||||||||||||||||||||
| 2456 | # Optional : S - group - a sytem group name | ||||||||||||||||||||||||||||||||||||||||||
| 2457 | # : I - recurse - include all files/folders in directory? | ||||||||||||||||||||||||||||||||||||||||||
| 2458 | # Comments : Uses the system chown binary | ||||||||||||||||||||||||||||||||||||||||||
| 2459 | # See Also : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 2460 | |||||||||||||||||||||||||||||||||||||||||||
| 2461 | |||||||||||||||||||||||||||||||||||||||||||
| 2462 | =item clean_tmp_dir | ||||||||||||||||||||||||||||||||||||||||||
| 2463 | |||||||||||||||||||||||||||||||||||||||||||
| 2464 | |||||||||||||||||||||||||||||||||||||||||||
| 2465 | ############## clean_tmp_dir ################ | ||||||||||||||||||||||||||||||||||||||||||
| 2466 | # Usage : $util->clean_tmp_dir( $dir ); | ||||||||||||||||||||||||||||||||||||||||||
| 2467 | # Purpose : clean up old build stuff before rebuilding | ||||||||||||||||||||||||||||||||||||||||||
| 2468 | # Returns : 0 - failure, 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2469 | # Parameters : S - $dir - a directory or file. | ||||||||||||||||||||||||||||||||||||||||||
| 2470 | # Throws : die on failure | ||||||||||||||||||||||||||||||||||||||||||
| 2471 | # Comments : Running this will delete its contents. Be careful! | ||||||||||||||||||||||||||||||||||||||||||
| 2472 | |||||||||||||||||||||||||||||||||||||||||||
| 2473 | |||||||||||||||||||||||||||||||||||||||||||
| 2474 | =item get_mounted_drives | ||||||||||||||||||||||||||||||||||||||||||
| 2475 | |||||||||||||||||||||||||||||||||||||||||||
| 2476 | ############# get_mounted_drives ############ | ||||||||||||||||||||||||||||||||||||||||||
| 2477 | # Usage : my $mounts = $util->get_mounted_drives(); | ||||||||||||||||||||||||||||||||||||||||||
| 2478 | # Purpose : Uses mount to fetch a list of mounted drive/partitions | ||||||||||||||||||||||||||||||||||||||||||
| 2479 | # Returns : a hashref of mounted slices and their mount points. | ||||||||||||||||||||||||||||||||||||||||||
| 2480 | |||||||||||||||||||||||||||||||||||||||||||
| 2481 | |||||||||||||||||||||||||||||||||||||||||||
| 2482 | =item archive_file | ||||||||||||||||||||||||||||||||||||||||||
| 2483 | |||||||||||||||||||||||||||||||||||||||||||
| 2484 | |||||||||||||||||||||||||||||||||||||||||||
| 2485 | ############### archive_file ################# | ||||||||||||||||||||||||||||||||||||||||||
| 2486 | # Purpose : Make a backup copy of a file by copying the file to $file.timestamp. | ||||||||||||||||||||||||||||||||||||||||||
| 2487 | # Usage : my $archived_file = $util->archive_file( $file ); | ||||||||||||||||||||||||||||||||||||||||||
| 2488 | # Returns : the filename of the backup file, or 0 on failure. | ||||||||||||||||||||||||||||||||||||||||||
| 2489 | # Parameters : S - file - the filname to be backed up | ||||||||||||||||||||||||||||||||||||||||||
| 2490 | # Comments : none | ||||||||||||||||||||||||||||||||||||||||||
| 2491 | |||||||||||||||||||||||||||||||||||||||||||
| 2492 | |||||||||||||||||||||||||||||||||||||||||||
| 2493 | =item chmod | ||||||||||||||||||||||||||||||||||||||||||
| 2494 | |||||||||||||||||||||||||||||||||||||||||||
| 2495 | Set the permissions (ugo-rwx) of a file. Will use the native perl methods (by default) but can also use system calls and prepend sudo if additional permissions are needed. | ||||||||||||||||||||||||||||||||||||||||||
| 2496 | |||||||||||||||||||||||||||||||||||||||||||
| 2497 | $util->chmod( | ||||||||||||||||||||||||||||||||||||||||||
| 2498 | file_or_dir => '/etc/resolv.conf', | ||||||||||||||||||||||||||||||||||||||||||
| 2499 | mode => '0755', | ||||||||||||||||||||||||||||||||||||||||||
| 2500 | sudo => $sudo | ||||||||||||||||||||||||||||||||||||||||||
| 2501 | ) | ||||||||||||||||||||||||||||||||||||||||||
| 2502 | |||||||||||||||||||||||||||||||||||||||||||
| 2503 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2504 | file_or_dir - a file or directory to alter permission on | ||||||||||||||||||||||||||||||||||||||||||
| 2505 | mode - the permissions (numeric) | ||||||||||||||||||||||||||||||||||||||||||
| 2506 | |||||||||||||||||||||||||||||||||||||||||||
| 2507 | arguments optional: | ||||||||||||||||||||||||||||||||||||||||||
| 2508 | sudo - the output of $util->sudo | ||||||||||||||||||||||||||||||||||||||||||
| 2509 | |||||||||||||||||||||||||||||||||||||||||||
| 2510 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2511 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2512 | 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2513 | |||||||||||||||||||||||||||||||||||||||||||
| 2514 | |||||||||||||||||||||||||||||||||||||||||||
| 2515 | =item chown | ||||||||||||||||||||||||||||||||||||||||||
| 2516 | |||||||||||||||||||||||||||||||||||||||||||
| 2517 | Set the ownership (user and group) of a file. Will use the native perl methods (by default) but can also use system calls and prepend sudo if additional permissions are needed. | ||||||||||||||||||||||||||||||||||||||||||
| 2518 | |||||||||||||||||||||||||||||||||||||||||||
| 2519 | $util->chown( | ||||||||||||||||||||||||||||||||||||||||||
| 2520 | file_or_dir => '/etc/resolv.conf', | ||||||||||||||||||||||||||||||||||||||||||
| 2521 | uid => 'root', | ||||||||||||||||||||||||||||||||||||||||||
| 2522 | gid => 'wheel', | ||||||||||||||||||||||||||||||||||||||||||
| 2523 | sudo => 1 | ||||||||||||||||||||||||||||||||||||||||||
| 2524 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 2525 | |||||||||||||||||||||||||||||||||||||||||||
| 2526 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2527 | file_or_dir - a file or directory to alter permission on | ||||||||||||||||||||||||||||||||||||||||||
| 2528 | uid - the uid or user name | ||||||||||||||||||||||||||||||||||||||||||
| 2529 | gid - the gid or group name | ||||||||||||||||||||||||||||||||||||||||||
| 2530 | |||||||||||||||||||||||||||||||||||||||||||
| 2531 | arguments optional: | ||||||||||||||||||||||||||||||||||||||||||
| 2532 | file - alias for file_or_dir | ||||||||||||||||||||||||||||||||||||||||||
| 2533 | dir - alias for file_or_dir | ||||||||||||||||||||||||||||||||||||||||||
| 2534 | sudo - the output of $util->sudo | ||||||||||||||||||||||||||||||||||||||||||
| 2535 | |||||||||||||||||||||||||||||||||||||||||||
| 2536 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2537 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2538 | 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2539 | |||||||||||||||||||||||||||||||||||||||||||
| 2540 | |||||||||||||||||||||||||||||||||||||||||||
| 2541 | =item file_delete | ||||||||||||||||||||||||||||||||||||||||||
| 2542 | |||||||||||||||||||||||||||||||||||||||||||
| 2543 | ############################################ | ||||||||||||||||||||||||||||||||||||||||||
| 2544 | # Usage : $util->file_delete( $file ); | ||||||||||||||||||||||||||||||||||||||||||
| 2545 | # Purpose : Deletes a file. | ||||||||||||||||||||||||||||||||||||||||||
| 2546 | # Returns : 0 - failure, 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2547 | # Parameters | ||||||||||||||||||||||||||||||||||||||||||
| 2548 | # Required : file - a file path | ||||||||||||||||||||||||||||||||||||||||||
| 2549 | # Comments : none | ||||||||||||||||||||||||||||||||||||||||||
| 2550 | # See Also : | ||||||||||||||||||||||||||||||||||||||||||
| 2551 | |||||||||||||||||||||||||||||||||||||||||||
| 2552 | Uses unlink if we have appropriate permissions, otherwise uses a system rm call, using sudo if it is not being run as root. This sub will try very hard to delete the file! | ||||||||||||||||||||||||||||||||||||||||||
| 2553 | |||||||||||||||||||||||||||||||||||||||||||
| 2554 | |||||||||||||||||||||||||||||||||||||||||||
| 2555 | =item get_url | ||||||||||||||||||||||||||||||||||||||||||
| 2556 | |||||||||||||||||||||||||||||||||||||||||||
| 2557 | $util->get_url( $url, verbose=>1 ); | ||||||||||||||||||||||||||||||||||||||||||
| 2558 | |||||||||||||||||||||||||||||||||||||||||||
| 2559 | Use the standard URL fetching utility (fetch, curl, wget) for your OS to download a file from the $url handed to us. | ||||||||||||||||||||||||||||||||||||||||||
| 2560 | |||||||||||||||||||||||||||||||||||||||||||
| 2561 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2562 | url - the fully qualified URL | ||||||||||||||||||||||||||||||||||||||||||
| 2563 | |||||||||||||||||||||||||||||||||||||||||||
| 2564 | arguments optional: | ||||||||||||||||||||||||||||||||||||||||||
| 2565 | timeout - the maximum amount of time to try | ||||||||||||||||||||||||||||||||||||||||||
| 2566 | |||||||||||||||||||||||||||||||||||||||||||
| 2567 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2568 | 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2569 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2570 | |||||||||||||||||||||||||||||||||||||||||||
| 2571 | |||||||||||||||||||||||||||||||||||||||||||
| 2572 | =item file_is_newer | ||||||||||||||||||||||||||||||||||||||||||
| 2573 | |||||||||||||||||||||||||||||||||||||||||||
| 2574 | compares the mtime on two files to determine if one is newer than another. | ||||||||||||||||||||||||||||||||||||||||||
| 2575 | |||||||||||||||||||||||||||||||||||||||||||
| 2576 | |||||||||||||||||||||||||||||||||||||||||||
| 2577 | =item file_mode | ||||||||||||||||||||||||||||||||||||||||||
| 2578 | |||||||||||||||||||||||||||||||||||||||||||
| 2579 | usage: | ||||||||||||||||||||||||||||||||||||||||||
| 2580 | my @lines = "1", "2", "3"; # named array | ||||||||||||||||||||||||||||||||||||||||||
| 2581 | $util->file_write ( "/tmp/foo", lines=>\@lines ); | ||||||||||||||||||||||||||||||||||||||||||
| 2582 | or | ||||||||||||||||||||||||||||||||||||||||||
| 2583 | $util->file_write ( "/tmp/foo", lines=>['1','2','3'] ); # anon arrayref | ||||||||||||||||||||||||||||||||||||||||||
| 2584 | |||||||||||||||||||||||||||||||||||||||||||
| 2585 | required arguments: | ||||||||||||||||||||||||||||||||||||||||||
| 2586 | mode - the files permissions mode | ||||||||||||||||||||||||||||||||||||||||||
| 2587 | |||||||||||||||||||||||||||||||||||||||||||
| 2588 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2589 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2590 | 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2591 | |||||||||||||||||||||||||||||||||||||||||||
| 2592 | |||||||||||||||||||||||||||||||||||||||||||
| 2593 | =item file_read | ||||||||||||||||||||||||||||||||||||||||||
| 2594 | |||||||||||||||||||||||||||||||||||||||||||
| 2595 | Reads in a file, and returns it in an array. All lines in the array are chomped. | ||||||||||||||||||||||||||||||||||||||||||
| 2596 | |||||||||||||||||||||||||||||||||||||||||||
| 2597 | my @lines = $util->file_read( $file, max_lines=>100 ) | ||||||||||||||||||||||||||||||||||||||||||
| 2598 | |||||||||||||||||||||||||||||||||||||||||||
| 2599 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2600 | file - the file to read in | ||||||||||||||||||||||||||||||||||||||||||
| 2601 | |||||||||||||||||||||||||||||||||||||||||||
| 2602 | arguments optional: | ||||||||||||||||||||||||||||||||||||||||||
| 2603 | max_lines - integer - max number of lines | ||||||||||||||||||||||||||||||||||||||||||
| 2604 | max_length - integer - maximum length of a line | ||||||||||||||||||||||||||||||||||||||||||
| 2605 | |||||||||||||||||||||||||||||||||||||||||||
| 2606 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2607 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2608 | success - returns an array with the files contents, one line per array element | ||||||||||||||||||||||||||||||||||||||||||
| 2609 | |||||||||||||||||||||||||||||||||||||||||||
| 2610 | |||||||||||||||||||||||||||||||||||||||||||
| 2611 | =item file_write | ||||||||||||||||||||||||||||||||||||||||||
| 2612 | |||||||||||||||||||||||||||||||||||||||||||
| 2613 | usage: | ||||||||||||||||||||||||||||||||||||||||||
| 2614 | my @lines = "1", "2", "3"; # named array | ||||||||||||||||||||||||||||||||||||||||||
| 2615 | $util->file_write ( "/tmp/foo", lines=>\@lines ); | ||||||||||||||||||||||||||||||||||||||||||
| 2616 | or | ||||||||||||||||||||||||||||||||||||||||||
| 2617 | $util->file_write ( "/tmp/foo", lines=>['1','2','3'] ); # anon arrayref | ||||||||||||||||||||||||||||||||||||||||||
| 2618 | |||||||||||||||||||||||||||||||||||||||||||
| 2619 | required arguments: | ||||||||||||||||||||||||||||||||||||||||||
| 2620 | file - the file path you want to write to | ||||||||||||||||||||||||||||||||||||||||||
| 2621 | lines - an arrayref. Each array element will be a line in the file | ||||||||||||||||||||||||||||||||||||||||||
| 2622 | |||||||||||||||||||||||||||||||||||||||||||
| 2623 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2624 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2625 | 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2626 | |||||||||||||||||||||||||||||||||||||||||||
| 2627 | |||||||||||||||||||||||||||||||||||||||||||
| 2628 | =item files_diff | ||||||||||||||||||||||||||||||||||||||||||
| 2629 | |||||||||||||||||||||||||||||||||||||||||||
| 2630 | Determine if the files are different. $type is assumed to be text unless you set it otherwise. For anthing but text files, we do a MD5 checksum on the files to determine if they are different or not. | ||||||||||||||||||||||||||||||||||||||||||
| 2631 | |||||||||||||||||||||||||||||||||||||||||||
| 2632 | $util->files_diff( f1=>$file1,f2=>$file2,type=>'text',verbose=>1 ); | ||||||||||||||||||||||||||||||||||||||||||
| 2633 | |||||||||||||||||||||||||||||||||||||||||||
| 2634 | if ( $util->files_diff( f1=>"foo", f2=>"bar" ) ) | ||||||||||||||||||||||||||||||||||||||||||
| 2635 | { | ||||||||||||||||||||||||||||||||||||||||||
| 2636 | print "different!\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 2637 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 2638 | |||||||||||||||||||||||||||||||||||||||||||
| 2639 | required arguments: | ||||||||||||||||||||||||||||||||||||||||||
| 2640 | f1 - the first file to compare | ||||||||||||||||||||||||||||||||||||||||||
| 2641 | f2 - the second file to compare | ||||||||||||||||||||||||||||||||||||||||||
| 2642 | |||||||||||||||||||||||||||||||||||||||||||
| 2643 | arguments optional: | ||||||||||||||||||||||||||||||||||||||||||
| 2644 | type - the type of file (text or binary) | ||||||||||||||||||||||||||||||||||||||||||
| 2645 | |||||||||||||||||||||||||||||||||||||||||||
| 2646 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2647 | 0 - files are the same | ||||||||||||||||||||||||||||||||||||||||||
| 2648 | 1 - files are different | ||||||||||||||||||||||||||||||||||||||||||
| 2649 | -1 - error. | ||||||||||||||||||||||||||||||||||||||||||
| 2650 | |||||||||||||||||||||||||||||||||||||||||||
| 2651 | |||||||||||||||||||||||||||||||||||||||||||
| 2652 | =item find_bin | ||||||||||||||||||||||||||||||||||||||||||
| 2653 | |||||||||||||||||||||||||||||||||||||||||||
| 2654 | Check all the "normal" locations for a binary that should be on the system and returns the full path to the binary. | ||||||||||||||||||||||||||||||||||||||||||
| 2655 | |||||||||||||||||||||||||||||||||||||||||||
| 2656 | $util->find_bin( 'dos2unix', dir=>'/opt/local/bin' ); | ||||||||||||||||||||||||||||||||||||||||||
| 2657 | |||||||||||||||||||||||||||||||||||||||||||
| 2658 | Example: | ||||||||||||||||||||||||||||||||||||||||||
| 2659 | |||||||||||||||||||||||||||||||||||||||||||
| 2660 | my $sudo = $util->find_bin( "sudo", dir => "/usr/local/sbin" ); | ||||||||||||||||||||||||||||||||||||||||||
| 2661 | |||||||||||||||||||||||||||||||||||||||||||
| 2662 | |||||||||||||||||||||||||||||||||||||||||||
| 2663 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2664 | bin - the name of the program (its filename) | ||||||||||||||||||||||||||||||||||||||||||
| 2665 | |||||||||||||||||||||||||||||||||||||||||||
| 2666 | arguments optional: | ||||||||||||||||||||||||||||||||||||||||||
| 2667 | dir - a directory to check first | ||||||||||||||||||||||||||||||||||||||||||
| 2668 | |||||||||||||||||||||||||||||||||||||||||||
| 2669 | results: | ||||||||||||||||||||||||||||||||||||||||||
| 2670 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2671 | success will return the full path to the binary. | ||||||||||||||||||||||||||||||||||||||||||
| 2672 | |||||||||||||||||||||||||||||||||||||||||||
| 2673 | |||||||||||||||||||||||||||||||||||||||||||
| 2674 | =item find_config | ||||||||||||||||||||||||||||||||||||||||||
| 2675 | |||||||||||||||||||||||||||||||||||||||||||
| 2676 | This sub is called by several others to determine which configuration file to use. The general logic is as follows: | ||||||||||||||||||||||||||||||||||||||||||
| 2677 | |||||||||||||||||||||||||||||||||||||||||||
| 2678 | If the etc dir and file name are provided and the file exists, use it. | ||||||||||||||||||||||||||||||||||||||||||
| 2679 | |||||||||||||||||||||||||||||||||||||||||||
| 2680 | If that fails, then go prowling around the drive and look in all the usual places, in order of preference: | ||||||||||||||||||||||||||||||||||||||||||
| 2681 | |||||||||||||||||||||||||||||||||||||||||||
| 2682 | /opt/local/etc/ | ||||||||||||||||||||||||||||||||||||||||||
| 2683 | /usr/local/etc/ | ||||||||||||||||||||||||||||||||||||||||||
| 2684 | /etc | ||||||||||||||||||||||||||||||||||||||||||
| 2685 | |||||||||||||||||||||||||||||||||||||||||||
| 2686 | Finally, if none of those work, then check the working directory for the named .conf file, or a .conf-dist. | ||||||||||||||||||||||||||||||||||||||||||
| 2687 | |||||||||||||||||||||||||||||||||||||||||||
| 2688 | Example: | ||||||||||||||||||||||||||||||||||||||||||
| 2689 | my $twconf = $util->find_config ( 'toaster-watcher.conf', | ||||||||||||||||||||||||||||||||||||||||||
| 2690 | etcdir => '/usr/local/etc', | ||||||||||||||||||||||||||||||||||||||||||
| 2691 | ) | ||||||||||||||||||||||||||||||||||||||||||
| 2692 | |||||||||||||||||||||||||||||||||||||||||||
| 2693 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2694 | file - the .conf file to read in | ||||||||||||||||||||||||||||||||||||||||||
| 2695 | |||||||||||||||||||||||||||||||||||||||||||
| 2696 | arguments optional: | ||||||||||||||||||||||||||||||||||||||||||
| 2697 | etcdir - the etc directory to prefer | ||||||||||||||||||||||||||||||||||||||||||
| 2698 | |||||||||||||||||||||||||||||||||||||||||||
| 2699 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2700 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2701 | the path to $file | ||||||||||||||||||||||||||||||||||||||||||
| 2702 | |||||||||||||||||||||||||||||||||||||||||||
| 2703 | |||||||||||||||||||||||||||||||||||||||||||
| 2704 | =item get_my_ips | ||||||||||||||||||||||||||||||||||||||||||
| 2705 | |||||||||||||||||||||||||||||||||||||||||||
| 2706 | returns an arrayref of IP addresses on local interfaces. | ||||||||||||||||||||||||||||||||||||||||||
| 2707 | |||||||||||||||||||||||||||||||||||||||||||
| 2708 | =item is_process_running | ||||||||||||||||||||||||||||||||||||||||||
| 2709 | |||||||||||||||||||||||||||||||||||||||||||
| 2710 | Verify if a process is running or not. | ||||||||||||||||||||||||||||||||||||||||||
| 2711 | |||||||||||||||||||||||||||||||||||||||||||
| 2712 | $util->is_process_running($process) ? print "yes" : print "no"; | ||||||||||||||||||||||||||||||||||||||||||
| 2713 | |||||||||||||||||||||||||||||||||||||||||||
| 2714 | $process is the name as it would appear in the process table. | ||||||||||||||||||||||||||||||||||||||||||
| 2715 | |||||||||||||||||||||||||||||||||||||||||||
| 2716 | |||||||||||||||||||||||||||||||||||||||||||
| 2717 | |||||||||||||||||||||||||||||||||||||||||||
| 2718 | =item is_readable | ||||||||||||||||||||||||||||||||||||||||||
| 2719 | |||||||||||||||||||||||||||||||||||||||||||
| 2720 | |||||||||||||||||||||||||||||||||||||||||||
| 2721 | ############################################ | ||||||||||||||||||||||||||||||||||||||||||
| 2722 | # Usage : $util->is_readable( file=>$file ); | ||||||||||||||||||||||||||||||||||||||||||
| 2723 | # Purpose : ???? | ||||||||||||||||||||||||||||||||||||||||||
| 2724 | # Returns : 0 = no (not reabable), 1 = yes | ||||||||||||||||||||||||||||||||||||||||||
| 2725 | # Parameters : S - file - a path name to a file | ||||||||||||||||||||||||||||||||||||||||||
| 2726 | # Throws : no exceptions | ||||||||||||||||||||||||||||||||||||||||||
| 2727 | # Comments : none | ||||||||||||||||||||||||||||||||||||||||||
| 2728 | # See Also : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 2729 | |||||||||||||||||||||||||||||||||||||||||||
| 2730 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2731 | 0 - no (file is not readable) | ||||||||||||||||||||||||||||||||||||||||||
| 2732 | 1 - yes (file is readable) | ||||||||||||||||||||||||||||||||||||||||||
| 2733 | |||||||||||||||||||||||||||||||||||||||||||
| 2734 | |||||||||||||||||||||||||||||||||||||||||||
| 2735 | |||||||||||||||||||||||||||||||||||||||||||
| 2736 | =item is_writable | ||||||||||||||||||||||||||||||||||||||||||
| 2737 | |||||||||||||||||||||||||||||||||||||||||||
| 2738 | If the file exists, it checks to see if it is writable. If the file does not exist, it checks to see if the enclosing directory is writable. | ||||||||||||||||||||||||||||||||||||||||||
| 2739 | |||||||||||||||||||||||||||||||||||||||||||
| 2740 | ############################################ | ||||||||||||||||||||||||||||||||||||||||||
| 2741 | # Usage : $util->is_writable( "/tmp/boogers"); | ||||||||||||||||||||||||||||||||||||||||||
| 2742 | # Purpose : make sure a file is writable | ||||||||||||||||||||||||||||||||||||||||||
| 2743 | # Returns : 0 - no (not writable), 1 - yes (is writeable) | ||||||||||||||||||||||||||||||||||||||||||
| 2744 | # Parameters : S - file - a path name to a file | ||||||||||||||||||||||||||||||||||||||||||
| 2745 | # Throws : no exceptions | ||||||||||||||||||||||||||||||||||||||||||
| 2746 | |||||||||||||||||||||||||||||||||||||||||||
| 2747 | |||||||||||||||||||||||||||||||||||||||||||
| 2748 | =item fstab_list | ||||||||||||||||||||||||||||||||||||||||||
| 2749 | |||||||||||||||||||||||||||||||||||||||||||
| 2750 | |||||||||||||||||||||||||||||||||||||||||||
| 2751 | ############ fstab_list ################### | ||||||||||||||||||||||||||||||||||||||||||
| 2752 | # Usage : $util->fstab_list; | ||||||||||||||||||||||||||||||||||||||||||
| 2753 | # Purpose : Fetch a list of drives that are mountable from /etc/fstab. | ||||||||||||||||||||||||||||||||||||||||||
| 2754 | # Returns : an arrayref | ||||||||||||||||||||||||||||||||||||||||||
| 2755 | # Comments : used in backup.pl | ||||||||||||||||||||||||||||||||||||||||||
| 2756 | # See Also : n/a | ||||||||||||||||||||||||||||||||||||||||||
| 2757 | |||||||||||||||||||||||||||||||||||||||||||
| 2758 | |||||||||||||||||||||||||||||||||||||||||||
| 2759 | =item get_dir_files | ||||||||||||||||||||||||||||||||||||||||||
| 2760 | |||||||||||||||||||||||||||||||||||||||||||
| 2761 | $util->get_dir_files( $dir, verbose=>1 ) | ||||||||||||||||||||||||||||||||||||||||||
| 2762 | |||||||||||||||||||||||||||||||||||||||||||
| 2763 | required arguments: | ||||||||||||||||||||||||||||||||||||||||||
| 2764 | dir - a directory | ||||||||||||||||||||||||||||||||||||||||||
| 2765 | |||||||||||||||||||||||||||||||||||||||||||
| 2766 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2767 | an array of files names contained in that directory. | ||||||||||||||||||||||||||||||||||||||||||
| 2768 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2769 | |||||||||||||||||||||||||||||||||||||||||||
| 2770 | |||||||||||||||||||||||||||||||||||||||||||
| 2771 | =item get_the_date | ||||||||||||||||||||||||||||||||||||||||||
| 2772 | |||||||||||||||||||||||||||||||||||||||||||
| 2773 | Returns the date split into a easy to work with set of strings. | ||||||||||||||||||||||||||||||||||||||||||
| 2774 | |||||||||||||||||||||||||||||||||||||||||||
| 2775 | $util->get_the_date( bump=>$bump, verbose=>$verbose ) | ||||||||||||||||||||||||||||||||||||||||||
| 2776 | |||||||||||||||||||||||||||||||||||||||||||
| 2777 | required arguments: | ||||||||||||||||||||||||||||||||||||||||||
| 2778 | none | ||||||||||||||||||||||||||||||||||||||||||
| 2779 | |||||||||||||||||||||||||||||||||||||||||||
| 2780 | optional arguments: | ||||||||||||||||||||||||||||||||||||||||||
| 2781 | bump - the offset (in days) to subtract from the date. | ||||||||||||||||||||||||||||||||||||||||||
| 2782 | |||||||||||||||||||||||||||||||||||||||||||
| 2783 | result: (array with the following elements) | ||||||||||||||||||||||||||||||||||||||||||
| 2784 | $dd = day | ||||||||||||||||||||||||||||||||||||||||||
| 2785 | $mm = month | ||||||||||||||||||||||||||||||||||||||||||
| 2786 | $yy = year | ||||||||||||||||||||||||||||||||||||||||||
| 2787 | $lm = last month | ||||||||||||||||||||||||||||||||||||||||||
| 2788 | $hh = hours | ||||||||||||||||||||||||||||||||||||||||||
| 2789 | $mn = minutes | ||||||||||||||||||||||||||||||||||||||||||
| 2790 | $ss = seconds | ||||||||||||||||||||||||||||||||||||||||||
| 2791 | |||||||||||||||||||||||||||||||||||||||||||
| 2792 | my ($dd, $mm, $yy, $lm, $hh, $mn, $ss) = $util->get_the_date(); | ||||||||||||||||||||||||||||||||||||||||||
| 2793 | |||||||||||||||||||||||||||||||||||||||||||
| 2794 | |||||||||||||||||||||||||||||||||||||||||||
| 2795 | =item install_from_source | ||||||||||||||||||||||||||||||||||||||||||
| 2796 | |||||||||||||||||||||||||||||||||||||||||||
| 2797 | usage: | ||||||||||||||||||||||||||||||||||||||||||
| 2798 | |||||||||||||||||||||||||||||||||||||||||||
| 2799 | $util->install_from_source( | ||||||||||||||||||||||||||||||||||||||||||
| 2800 | package => 'simscan-1.07', | ||||||||||||||||||||||||||||||||||||||||||
| 2801 | site => 'http://www.inter7.com', | ||||||||||||||||||||||||||||||||||||||||||
| 2802 | url => '/simscan/', | ||||||||||||||||||||||||||||||||||||||||||
| 2803 | targets => ['./configure', 'make', 'make install'], | ||||||||||||||||||||||||||||||||||||||||||
| 2804 | patches => '', | ||||||||||||||||||||||||||||||||||||||||||
| 2805 | verbose => 1, | ||||||||||||||||||||||||||||||||||||||||||
| 2806 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 2807 | |||||||||||||||||||||||||||||||||||||||||||
| 2808 | Downloads and installs a program from sources. | ||||||||||||||||||||||||||||||||||||||||||
| 2809 | |||||||||||||||||||||||||||||||||||||||||||
| 2810 | required arguments: | ||||||||||||||||||||||||||||||||||||||||||
| 2811 | conf - hashref - mail-toaster.conf settings. | ||||||||||||||||||||||||||||||||||||||||||
| 2812 | site - | ||||||||||||||||||||||||||||||||||||||||||
| 2813 | url - | ||||||||||||||||||||||||||||||||||||||||||
| 2814 | package - | ||||||||||||||||||||||||||||||||||||||||||
| 2815 | |||||||||||||||||||||||||||||||||||||||||||
| 2816 | optional arguments: | ||||||||||||||||||||||||||||||||||||||||||
| 2817 | targets - arrayref - defaults to [./configure, make, make install]. | ||||||||||||||||||||||||||||||||||||||||||
| 2818 | patches - arrayref - patch(es) to apply to the sources before compiling | ||||||||||||||||||||||||||||||||||||||||||
| 2819 | patch_args - | ||||||||||||||||||||||||||||||||||||||||||
| 2820 | source_sub_dir - a subdirectory within the sources build directory | ||||||||||||||||||||||||||||||||||||||||||
| 2821 | bintest - check the usual places for an executable binary. If found, it will assume the software is already installed and require confirmation before re-installing. | ||||||||||||||||||||||||||||||||||||||||||
| 2822 | |||||||||||||||||||||||||||||||||||||||||||
| 2823 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2824 | 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2825 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2826 | |||||||||||||||||||||||||||||||||||||||||||
| 2827 | |||||||||||||||||||||||||||||||||||||||||||
| 2828 | =item install_from_source_php | ||||||||||||||||||||||||||||||||||||||||||
| 2829 | |||||||||||||||||||||||||||||||||||||||||||
| 2830 | Downloads a PHP program and installs it. This function is not completed due to lack o interest. | ||||||||||||||||||||||||||||||||||||||||||
| 2831 | |||||||||||||||||||||||||||||||||||||||||||
| 2832 | |||||||||||||||||||||||||||||||||||||||||||
| 2833 | =item is_interactive | ||||||||||||||||||||||||||||||||||||||||||
| 2834 | |||||||||||||||||||||||||||||||||||||||||||
| 2835 | tests to determine if the running process is attached to a terminal. | ||||||||||||||||||||||||||||||||||||||||||
| 2836 | |||||||||||||||||||||||||||||||||||||||||||
| 2837 | |||||||||||||||||||||||||||||||||||||||||||
| 2838 | =item logfile_append | ||||||||||||||||||||||||||||||||||||||||||
| 2839 | |||||||||||||||||||||||||||||||||||||||||||
| 2840 | $util->logfile_append( $file, lines=>\@lines ) | ||||||||||||||||||||||||||||||||||||||||||
| 2841 | |||||||||||||||||||||||||||||||||||||||||||
| 2842 | Pass a filename and an array ref and it will append a timestamp and the array contents to the file. Here's a working example: | ||||||||||||||||||||||||||||||||||||||||||
| 2843 | |||||||||||||||||||||||||||||||||||||||||||
| 2844 | $util->logfile_append( $file, prog=>"proggy", lines=>["Starting up", "Shutting down"] ) | ||||||||||||||||||||||||||||||||||||||||||
| 2845 | |||||||||||||||||||||||||||||||||||||||||||
| 2846 | That will append a line like this to the log file: | ||||||||||||||||||||||||||||||||||||||||||
| 2847 | |||||||||||||||||||||||||||||||||||||||||||
| 2848 | 2004-11-12 23:20:06 proggy Starting up | ||||||||||||||||||||||||||||||||||||||||||
| 2849 | 2004-11-12 23:20:06 proggy Shutting down | ||||||||||||||||||||||||||||||||||||||||||
| 2850 | |||||||||||||||||||||||||||||||||||||||||||
| 2851 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2852 | file - the log file to append to | ||||||||||||||||||||||||||||||||||||||||||
| 2853 | prog - the name of the application | ||||||||||||||||||||||||||||||||||||||||||
| 2854 | lines - arrayref - elements are events to log. | ||||||||||||||||||||||||||||||||||||||||||
| 2855 | |||||||||||||||||||||||||||||||||||||||||||
| 2856 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2857 | 1 - success | ||||||||||||||||||||||||||||||||||||||||||
| 2858 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2859 | |||||||||||||||||||||||||||||||||||||||||||
| 2860 | |||||||||||||||||||||||||||||||||||||||||||
| 2861 | =item mailtoaster | ||||||||||||||||||||||||||||||||||||||||||
| 2862 | |||||||||||||||||||||||||||||||||||||||||||
| 2863 | $util->mailtoaster(); | ||||||||||||||||||||||||||||||||||||||||||
| 2864 | |||||||||||||||||||||||||||||||||||||||||||
| 2865 | Downloads and installs Mail::Toaster. | ||||||||||||||||||||||||||||||||||||||||||
| 2866 | |||||||||||||||||||||||||||||||||||||||||||
| 2867 | |||||||||||||||||||||||||||||||||||||||||||
| 2868 | =item mkdir_system | ||||||||||||||||||||||||||||||||||||||||||
| 2869 | |||||||||||||||||||||||||||||||||||||||||||
| 2870 | $util->mkdir_system( dir => $dir, verbose=>$verbose ); | ||||||||||||||||||||||||||||||||||||||||||
| 2871 | |||||||||||||||||||||||||||||||||||||||||||
| 2872 | creates a directory using the system mkdir binary. Can also make levels of directories (-p) and utilize sudo if necessary to escalate. | ||||||||||||||||||||||||||||||||||||||||||
| 2873 | |||||||||||||||||||||||||||||||||||||||||||
| 2874 | |||||||||||||||||||||||||||||||||||||||||||
| 2875 | =item check_pidfile | ||||||||||||||||||||||||||||||||||||||||||
| 2876 | |||||||||||||||||||||||||||||||||||||||||||
| 2877 | check_pidfile is a process management method. It will check to make sure an existing pidfile does not exist and if not, it will create the pidfile. | ||||||||||||||||||||||||||||||||||||||||||
| 2878 | |||||||||||||||||||||||||||||||||||||||||||
| 2879 | $pidfile = $util->check_pidfile( "/var/run/program.pid" ); | ||||||||||||||||||||||||||||||||||||||||||
| 2880 | |||||||||||||||||||||||||||||||||||||||||||
| 2881 | The above example is all you need to do to add process checking (avoiding multiple daemons running at the same time) to a program or script. This is used in toaster-watcher.pl. toaster-watcher normally completes a run in a few seconds and is run every 5 minutes. | ||||||||||||||||||||||||||||||||||||||||||
| 2882 | |||||||||||||||||||||||||||||||||||||||||||
| 2883 | However, toaster-watcher can be configured to do things like expire old messages from maildirs and feed spam through a processor like sa-learn. This can take a long time on a large mail system so we don't want multiple instances of toaster-watcher running. | ||||||||||||||||||||||||||||||||||||||||||
| 2884 | |||||||||||||||||||||||||||||||||||||||||||
| 2885 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2886 | the path to the pidfile (on success). | ||||||||||||||||||||||||||||||||||||||||||
| 2887 | |||||||||||||||||||||||||||||||||||||||||||
| 2888 | Example: | ||||||||||||||||||||||||||||||||||||||||||
| 2889 | |||||||||||||||||||||||||||||||||||||||||||
| 2890 | my $pidfile = $util->check_pidfile( "/var/run/changeme.pid" ); | ||||||||||||||||||||||||||||||||||||||||||
| 2891 | unless ($pidfile) { | ||||||||||||||||||||||||||||||||||||||||||
| 2892 | warn "WARNING: couldn't create a process id file!: $!\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 2893 | exit 0; | ||||||||||||||||||||||||||||||||||||||||||
| 2894 | }; | ||||||||||||||||||||||||||||||||||||||||||
| 2895 | |||||||||||||||||||||||||||||||||||||||||||
| 2896 | do_a_bunch_of_cool_stuff; | ||||||||||||||||||||||||||||||||||||||||||
| 2897 | unlink $pidfile; | ||||||||||||||||||||||||||||||||||||||||||
| 2898 | |||||||||||||||||||||||||||||||||||||||||||
| 2899 | |||||||||||||||||||||||||||||||||||||||||||
| 2900 | =item regexp_test | ||||||||||||||||||||||||||||||||||||||||||
| 2901 | |||||||||||||||||||||||||||||||||||||||||||
| 2902 | Prints out a string with the regexp match bracketed. Credit to Damien Conway from Perl Best Practices. | ||||||||||||||||||||||||||||||||||||||||||
| 2903 | |||||||||||||||||||||||||||||||||||||||||||
| 2904 | Example: | ||||||||||||||||||||||||||||||||||||||||||
| 2905 | $util->regexp_test( | ||||||||||||||||||||||||||||||||||||||||||
| 2906 | exp => 'toast', | ||||||||||||||||||||||||||||||||||||||||||
| 2907 | string => 'mailtoaster rocks', | ||||||||||||||||||||||||||||||||||||||||||
| 2908 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 2909 | |||||||||||||||||||||||||||||||||||||||||||
| 2910 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2911 | exp - the regular expression | ||||||||||||||||||||||||||||||||||||||||||
| 2912 | string - the string you are applying the regexp to | ||||||||||||||||||||||||||||||||||||||||||
| 2913 | |||||||||||||||||||||||||||||||||||||||||||
| 2914 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2915 | printed string highlighting the regexp match | ||||||||||||||||||||||||||||||||||||||||||
| 2916 | |||||||||||||||||||||||||||||||||||||||||||
| 2917 | |||||||||||||||||||||||||||||||||||||||||||
| 2918 | =item source_warning | ||||||||||||||||||||||||||||||||||||||||||
| 2919 | |||||||||||||||||||||||||||||||||||||||||||
| 2920 | Checks to see if the old build sources are present. If they are, offer to remove them. | ||||||||||||||||||||||||||||||||||||||||||
| 2921 | |||||||||||||||||||||||||||||||||||||||||||
| 2922 | Usage: | ||||||||||||||||||||||||||||||||||||||||||
| 2923 | |||||||||||||||||||||||||||||||||||||||||||
| 2924 | $util->source_warning( | ||||||||||||||||||||||||||||||||||||||||||
| 2925 | package => "Mail-Toaster-5.26", | ||||||||||||||||||||||||||||||||||||||||||
| 2926 | clean => 1, | ||||||||||||||||||||||||||||||||||||||||||
| 2927 | src => "/usr/local/src" | ||||||||||||||||||||||||||||||||||||||||||
| 2928 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 2929 | |||||||||||||||||||||||||||||||||||||||||||
| 2930 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2931 | package - the name of the packages directory | ||||||||||||||||||||||||||||||||||||||||||
| 2932 | |||||||||||||||||||||||||||||||||||||||||||
| 2933 | arguments optional: | ||||||||||||||||||||||||||||||||||||||||||
| 2934 | src - the source directory to build in (/usr/local/src) | ||||||||||||||||||||||||||||||||||||||||||
| 2935 | clean - do we try removing the existing sources? (enabled) | ||||||||||||||||||||||||||||||||||||||||||
| 2936 | timeout - how long to wait for an answer (60 seconds) | ||||||||||||||||||||||||||||||||||||||||||
| 2937 | |||||||||||||||||||||||||||||||||||||||||||
| 2938 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2939 | 1 - removed | ||||||||||||||||||||||||||||||||||||||||||
| 2940 | 0 - failure, package exists and needs to be removed. | ||||||||||||||||||||||||||||||||||||||||||
| 2941 | |||||||||||||||||||||||||||||||||||||||||||
| 2942 | |||||||||||||||||||||||||||||||||||||||||||
| 2943 | =item sources_get | ||||||||||||||||||||||||||||||||||||||||||
| 2944 | |||||||||||||||||||||||||||||||||||||||||||
| 2945 | Tries to download a set of sources files from the site and url provided. It will try first fetching a gzipped tarball and if that files, a bzipped tarball. As new formats are introduced, I will expand the support for them here. | ||||||||||||||||||||||||||||||||||||||||||
| 2946 | |||||||||||||||||||||||||||||||||||||||||||
| 2947 | usage: | ||||||||||||||||||||||||||||||||||||||||||
| 2948 | $self->sources_get( | ||||||||||||||||||||||||||||||||||||||||||
| 2949 | package => 'simscan-1.07', | ||||||||||||||||||||||||||||||||||||||||||
| 2950 | site => 'http://www.inter7.com', | ||||||||||||||||||||||||||||||||||||||||||
| 2951 | path => '/simscan/', | ||||||||||||||||||||||||||||||||||||||||||
| 2952 | ) | ||||||||||||||||||||||||||||||||||||||||||
| 2953 | |||||||||||||||||||||||||||||||||||||||||||
| 2954 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2955 | package - the software package name | ||||||||||||||||||||||||||||||||||||||||||
| 2956 | site - the host to fetch it from | ||||||||||||||||||||||||||||||||||||||||||
| 2957 | url - the path to the package on $site | ||||||||||||||||||||||||||||||||||||||||||
| 2958 | |||||||||||||||||||||||||||||||||||||||||||
| 2959 | arguments optional: | ||||||||||||||||||||||||||||||||||||||||||
| 2960 | conf - hashref - values from toaster-watcher.conf | ||||||||||||||||||||||||||||||||||||||||||
| 2961 | |||||||||||||||||||||||||||||||||||||||||||
| 2962 | This sub proved quite useful during 2005 as many packages began to be distributed in bzip format instead of the traditional gzip. | ||||||||||||||||||||||||||||||||||||||||||
| 2963 | |||||||||||||||||||||||||||||||||||||||||||
| 2964 | |||||||||||||||||||||||||||||||||||||||||||
| 2965 | =item sudo | ||||||||||||||||||||||||||||||||||||||||||
| 2966 | |||||||||||||||||||||||||||||||||||||||||||
| 2967 | my $sudo = $util->sudo(); | ||||||||||||||||||||||||||||||||||||||||||
| 2968 | |||||||||||||||||||||||||||||||||||||||||||
| 2969 | $util->syscmd( "$sudo rm /etc/root-owned-file" ); | ||||||||||||||||||||||||||||||||||||||||||
| 2970 | |||||||||||||||||||||||||||||||||||||||||||
| 2971 | Often you want to run a script as an unprivileged user. However, the script may need elevated privileges for a plethora of reasons. Rather than running the script suid, or as root, configure sudo allowing the script to run system commands with appropriate permissions. | ||||||||||||||||||||||||||||||||||||||||||
| 2972 | |||||||||||||||||||||||||||||||||||||||||||
| 2973 | If sudo is not installed and you're running as root, it'll offer to install sudo for you. This is recommended, as is properly configuring sudo. | ||||||||||||||||||||||||||||||||||||||||||
| 2974 | |||||||||||||||||||||||||||||||||||||||||||
| 2975 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2976 | |||||||||||||||||||||||||||||||||||||||||||
| 2977 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 2978 | 0 - failure | ||||||||||||||||||||||||||||||||||||||||||
| 2979 | on success, the full path to the sudo binary | ||||||||||||||||||||||||||||||||||||||||||
| 2980 | |||||||||||||||||||||||||||||||||||||||||||
| 2981 | |||||||||||||||||||||||||||||||||||||||||||
| 2982 | =item syscmd | ||||||||||||||||||||||||||||||||||||||||||
| 2983 | |||||||||||||||||||||||||||||||||||||||||||
| 2984 | Just a little wrapper around system calls, that returns any failure codes and prints out the error(s) if present. A bit of sanity testing is also done to make sure the command to execute is safe. | ||||||||||||||||||||||||||||||||||||||||||
| 2985 | |||||||||||||||||||||||||||||||||||||||||||
| 2986 | my $r = $util->syscmd( "gzip /tmp/example.txt" ); | ||||||||||||||||||||||||||||||||||||||||||
| 2987 | $r ? print "ok!\n" : print "not ok.\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 2988 | |||||||||||||||||||||||||||||||||||||||||||
| 2989 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 2990 | cmd - the command to execute | ||||||||||||||||||||||||||||||||||||||||||
| 2991 | |||||||||||||||||||||||||||||||||||||||||||
| 2992 | result | ||||||||||||||||||||||||||||||||||||||||||
| 2993 | the exit status of the program you called. | ||||||||||||||||||||||||||||||||||||||||||
| 2994 | |||||||||||||||||||||||||||||||||||||||||||
| 2995 | |||||||||||||||||||||||||||||||||||||||||||
| 2996 | =item _try_mkdir | ||||||||||||||||||||||||||||||||||||||||||
| 2997 | |||||||||||||||||||||||||||||||||||||||||||
| 2998 | try creating a directory using perl's builtin mkdir. | ||||||||||||||||||||||||||||||||||||||||||
| 2999 | |||||||||||||||||||||||||||||||||||||||||||
| 3000 | |||||||||||||||||||||||||||||||||||||||||||
| 3001 | =item yes_or_no | ||||||||||||||||||||||||||||||||||||||||||
| 3002 | |||||||||||||||||||||||||||||||||||||||||||
| 3003 | my $r = $util->yes_or_no( | ||||||||||||||||||||||||||||||||||||||||||
| 3004 | "Would you like fries with that?", | ||||||||||||||||||||||||||||||||||||||||||
| 3005 | timeout => 30 | ||||||||||||||||||||||||||||||||||||||||||
| 3006 | ); | ||||||||||||||||||||||||||||||||||||||||||
| 3007 | |||||||||||||||||||||||||||||||||||||||||||
| 3008 | $r ? print "fries are in the bag\n" : print "no fries!\n"; | ||||||||||||||||||||||||||||||||||||||||||
| 3009 | |||||||||||||||||||||||||||||||||||||||||||
| 3010 | arguments required: | ||||||||||||||||||||||||||||||||||||||||||
| 3011 | none. | ||||||||||||||||||||||||||||||||||||||||||
| 3012 | |||||||||||||||||||||||||||||||||||||||||||
| 3013 | arguments optional: | ||||||||||||||||||||||||||||||||||||||||||
| 3014 | question - the question to ask | ||||||||||||||||||||||||||||||||||||||||||
| 3015 | timeout - how long to wait for an answer (in seconds) | ||||||||||||||||||||||||||||||||||||||||||
| 3016 | |||||||||||||||||||||||||||||||||||||||||||
| 3017 | result: | ||||||||||||||||||||||||||||||||||||||||||
| 3018 | 0 - negative (or null) | ||||||||||||||||||||||||||||||||||||||||||
| 3019 | 1 - success (affirmative) | ||||||||||||||||||||||||||||||||||||||||||
| 3020 | |||||||||||||||||||||||||||||||||||||||||||
| 3021 | |||||||||||||||||||||||||||||||||||||||||||
| 3022 | =back | ||||||||||||||||||||||||||||||||||||||||||
| 3023 | |||||||||||||||||||||||||||||||||||||||||||
| 3024 | |||||||||||||||||||||||||||||||||||||||||||
| 3025 | =head1 TODO | ||||||||||||||||||||||||||||||||||||||||||
| 3026 | |||||||||||||||||||||||||||||||||||||||||||
| 3027 | make all errors raise exceptions | ||||||||||||||||||||||||||||||||||||||||||
| 3028 | write test cases for every method | ||||||||||||||||||||||||||||||||||||||||||
| 3029 | |||||||||||||||||||||||||||||||||||||||||||
| 3030 | =head1 SEE ALSO | ||||||||||||||||||||||||||||||||||||||||||
| 3031 | |||||||||||||||||||||||||||||||||||||||||||
| 3032 | The following are all man/perldoc pages: | ||||||||||||||||||||||||||||||||||||||||||
| 3033 | |||||||||||||||||||||||||||||||||||||||||||
| 3034 | Mail::Toaster | ||||||||||||||||||||||||||||||||||||||||||
| 3035 | |||||||||||||||||||||||||||||||||||||||||||
| 3036 | |||||||||||||||||||||||||||||||||||||||||||
| 3037 | =cut | ||||||||||||||||||||||||||||||||||||||||||