#!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:
# Pass a review job (clearing it for integration).
 
use strict;
use English;
use P4;
 
# Takes (optional) job id.
sub usage {
    P4::crash("Usage: p4rpass [<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, 'p4rpass');
 
# 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 a failure (possibly by another reviewer),
# or even a job which has been declared OK by another reviewer. In
# short, the last reviewer's entry wins.
my $status = $record{status};
P4::verify_job_status($job, \%record, 'review', 'fail', 'pass');
 
# 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} = 'pass';
P4::update_job($job, \%record);
 
# Release obtained locks.
P4::unlock();
 
# Notify caller.
my $user = $record{user};
my $retry = $record{retry};
print "Work on job $job (attempt #$retry) ",
	"by $user has been submitted for integration.\n";
 
# Be nice.
1;