%PDF-
%PDF-
Mini Shell
Mini Shell
# Copyright © 2008-2010, 2012-2015 Guillem Jover <guillem@debian.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <https://www.gnu.org/licenses/>.
=encoding utf8
=head1 NAME
Dpkg::Source::Functions - miscellaneous source package handling functions
=head1 DESCRIPTION
This module provides a set of miscellaneous helper functions to handle
source packages.
B<Note>: This is a private module, its API can change at any time.
=cut
package Dpkg::Source::Functions 0.01;
use strict;
use warnings;
our @EXPORT_OK = qw(
erasedir
fixperms
chmod_if_needed
fs_time
is_binary
);
use Exporter qw(import);
use Errno qw(ENOENT);
use Dpkg::ErrorHandling;
use Dpkg::Gettext;
use Dpkg::File;
use Dpkg::IPC;
sub erasedir {
my $dir = shift;
if (not lstat($dir)) {
return if $! == ENOENT;
syserr(g_('cannot stat directory %s (before removal)'), $dir);
}
system 'rm', '-rf', '--', $dir;
subprocerr("rm -rf $dir") if $?;
if (not stat($dir)) {
return if $! == ENOENT;
syserr(g_("unable to check for removal of directory '%s'"), $dir);
}
error(g_("rm -rf failed to remove '%s'"), $dir);
}
sub fixperms {
my $dir = shift;
my ($mode, $modes_set);
# Unfortunately tar insists on applying our umask _to the original
# permissions_ rather than mostly-ignoring the original
# permissions. We fix it up with chmod -R (which saves us some
# work) but we have to construct a u+/- string which is a bit
# of a palaver. (Numeric doesn't work because we need [ugo]+X
# and [ugo]=<stuff> doesn't work because that unsets sgid on dirs.)
$mode = 0777 & ~umask;
for my $i (0 .. 2) {
$modes_set .= ',' if $i;
$modes_set .= qw(u g o)[$i];
for my $j (0 .. 2) {
$modes_set .= $mode & (0400 >> ($i * 3 + $j)) ? '+' : '-';
$modes_set .= qw(r w X)[$j];
}
}
system('chmod', '-R', '--', $modes_set, $dir);
subprocerr("chmod -R -- $modes_set $dir") if $?;
}
# Only change the pathname permissions if they differ from the desired.
#
# To be able to build a source tree, a user needs write permissions on it,
# but not necessarily ownership of those files.
sub chmod_if_needed {
my ($newperms, $pathname) = @_;
my $oldperms = (stat $pathname)[2] & 07777;
return 1 if $oldperms == $newperms;
return chmod $newperms, $pathname;
}
# Touch the file and read the resulting mtime.
#
# If the file doesn't exist, create it, read the mtime and unlink it.
#
# Use this instead of time() when the timestamp is going to be
# used to set file timestamps. This avoids confusion when an
# NFS server and NFS client disagree about what time it is.
sub fs_time($) {
my $file = shift;
my $is_temp = 0;
if (not -e $file) {
file_touch($file);
$is_temp = 1;
} else {
utime(undef, undef, $file) or
syserr(g_('cannot change timestamp for %s'), $file);
}
stat($file) or syserr(g_('cannot read timestamp from %s'), $file);
my $mtime = (stat(_))[9];
unlink($file) if $is_temp;
return $mtime;
}
sub is_binary($) {
my $file = shift;
# Perform the same check as diff(1), look for a NUL character in the first
# 4 KiB of the file.
open my $fh, '<', $file
or syserr(g_('cannot open file %s for binary detection'), $file);
read $fh, my $buf, 4096, 0;
my $res = index $buf, "\0";
close $fh;
return $res >= 0;
}
=head1 CHANGES
=head2 Version 0.xx
This is a private module.
=cut
1;
Zerion Mini Shell 1.0