#!perl -w
# Copyright (C) 1997 Capella Computers Ltd.
#
# 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, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
# :FILE:
# Fail a reviewed job; additional work should be done by the developer.
use strict;
use English;
use P4;
# Takes (optional) job id.
sub usage {
P4::crash("Usage: p4rfail [<job>]");
}
# Parse command line.
my $job;
if ($#ARGV < 0) {
$job = P4::current_job();
} elsif ($ARGV[0] eq '-h') {
usage();
} elsif ($ARGV[0] =~ /^\d+$/) {
$job = shift(@ARGV);
}
if ($#ARGV >= 0) {
usage();
}
# Verify quick pre-conditions.
P4::verify_current_user(0, 'integ');
# Lock job to avoid race conditions.
P4::lock($job, 'p4rfail');
# Obtain the job record.
my %record = P4::job_record($job);
# Verify pre-conditions. Note that we allow a reviewer to OK a job
# which has been declared OK (possibly by another reviewer), or even
# a job which has been declared a failure by another reviewer. In
# short, the last reviewer's entry wins.
my $status = $record{status};
P4::verify_job_status($job, \%record, 'review', 'pass', 'fail');
# We should really prevent a user from reviewing himself. However,
# since it is trivial to hack the system (e.g., by just setting P4USER
# to someone else), there wouldn't be much point in it.
# Update the job record, overwriting the state and the reviewer's identity.
my $reviewer = P4::current_user();
$record{reviewer} = $reviewer;
$record{status} = 'fail';
P4::update_job($job, \%record);
# Release obtained locks.
P4::unlock();
# Notify caller.
my $user = $record{user};
my $retry = $record{retry};
print "Job $job (attempt #$retry) ",
"has been returned to $user for further work.\n";
# Be nice.
1;