—
—

              
#!/usr/bin/perl
HideShow 11 lines of Pod
=begin metadata
Name: touch
Description: change access and modification times of files
Author: Abigail, perlpowertools@abigail.be
License: perl
=end metadata
=cut
use strict;
use File::Basename qw(basename);
use Getopt::Std qw(getopts);
use IO::File;
use constant EX_SUCCESS => 0;
use constant EX_FAILURE => 1;
my $Program = basename($0);
my ($VERSION) = '1.4';
my $rc = EX_SUCCESS;
my %options;
getopts('acmfr:t:', \%options) or usage();
unless (@ARGV) {
    warn "$Program: missing file argument\n";
    usage();
}
my $access_time       = exists $options{'a'}  ||  !exists $options{'m'};
my $modification_time = exists $options{'m'}  ||  !exists $options{'a'};
my $no_create         = exists $options{'c'};
my ($atime, $mtime, $special_time);
if (defined $options{'r'}) {
    if (defined $options{'t'}) {
        warn "$Program: options -r and -t cannot be used together\n";
        usage();
    }
    ($atime, $mtime) = (stat $options {r}) [8, 9] or die "$options{r}: $!\n";
    $special_time = 1;
}
elsif (defined $options{'t'}) {
    $atime = $mtime = parse_time($options{'t'});
    die "-t $options{t}: Time out of range!\n" if $atime < 0;
    $special_time = 1;
}
else {
    $atime = $mtime = time;
}
foreach my $file (@ARGV) {
    # Check if the file exists. If not, create it.
    unless (-e $file) {
        next if $no_create;
        my $fh = IO::File->new($file, O_CREAT);
        unless ($fh) {
            warn "$Program: failed to create '$file': $!\n";
            $rc = EX_FAILURE;
            next;
        }
        unless ($fh->close) {
            warn "$Program: failed to close '$file': $!\n";
            $rc = EX_FAILURE;
            next;
        }
        # Nothing to be done, unless time different than now.
        next unless $special_time;
    }
    my ($aorig, $morig) = (stat $file) [8, 9] or do {
        warn "$Program: $file: $!\n";
        $rc = EX_FAILURE;
        next;
    };
    my $aset = $access_time       ? $atime : $aorig;
    my $mset = $modification_time ? $mtime : $morig;
    utime $aset, $mset, $file or do {
        warn "$Program: $file: $!\n";
        $rc = EX_FAILURE;
    };
}
exit $rc;
sub VERSION_MESSAGE {
    print "$Program version $VERSION\n";
    exit EX_SUCCESS;
}
sub usage {
    warn "usage: $Program [-acm] [-r file] [-t [[CC]YY]MMDDhhmm[.SS]] file...\n";
    exit EX_FAILURE;
}
sub parse_time {
    my $time = shift;
    my ($first, $seconds) = split /\./ => $time, 2;
    my $year;
    if ($first =~ /\D/) {die "$time: Illegal time format\n"}
    elsif (12 == length $first) {
        $year  = substr $first, 0, 4, '';
    }
    elsif (10 == length $first) {
        $year  = substr $first, 0, 2, '';
        $year += 100 if $year < 70;
    }
    elsif ( 8 == length $first) {
        $year  = (localtime) [5];
    }
    else {die "$time: Illegal time format\n"}
    if (defined $seconds &&
           ($seconds =~ /\D/ || $seconds > 59 || 2 != length $seconds)) {
        die "-t $time: Illegal time format\n"
    }
    else {
        $seconds = 0;
    }
    my ($mon, $day, $hours, $minutes) = $first =~ /(..)(..)(..)(..)/;
    require Time::Local;
    Time::Local::timelocal ($seconds, $minutes, $hours, $day, $mon - 1, $year);
}
__END__
HideShow 88 lines of Pod
=pod
=head1 NAME
touch - change access and modification times of files
=head1 SYNOPSIS
touch [-acm] [-r file] [-t [[CC]YY]MMDDhhmm[.SS]] file...
=head1 DESCRIPTION
I<touch> sets the access and modification timestamps of files. By default,
both the access and modification times are set to the current time.
If necessary, files will be created.
I<touch> exits successfully if and only if all timestamps could be set
successfully.
=head2 OPTIONS
I<touch> accepts the following options:
=over 4
=item -a
Set the access time of the specified files only, unless I<-m> is given as
well.
=item -c
Do not create non-existing files. No warning is generated, and it will
not influence the exit status.
=item -f
This option is ignored, and only recognized for compatibility reasons.
=item -m
Set the modification time of the specified files only, unless I<-a> is
given as well.
=item -r file
Use the access and modification time of I<file> instead of the
current time.
=item -t [[CC]YY]MMDDhhmm[.SS]
Set the access and modification times to the specified time.
If B<YY> is present, but B<CC> is not, then B<CC> is assumed to
be 19 if B<YY> is larger than 69, and 20 otherwise. If B<YY>
is not present, the current year is assumed.
It should be noted that many systems cannot deal with timestamps
before Jan 1, 1970 or after Jan 19, 2038.
=back
=head1 ENVIRONMENT
The working of I<touch> is not influenced by any environment variables.
=head1 BUGS
I<touch> uses C<Time::Local> to translate the time format to epoch
seconds
=head1 STANDARDS
This I<touch> implementation is compatible with the B<OpenBSD> implementation.
=head1 AUTHOR
The Perl implementation of I<touch> was written by Abigail, I<perlpowertools@abigail.be>.
=head1 COPYRIGHT and LICENSE
This program is copyright by Abigail 1999.
This program is free and open software. You may use, copy, modify, distribute
and sell this program (and any modified variants) in any way you wish,
provided you do not restrict others to do the same.
=cut