#!/usr/bin/perl # This Source Code Form is subject to the terms of the Mozilla Public # License, v. 2.0. If a copy of the MPL was not distributed with this # file, You can obtain one at http://mozilla.org/MPL/2.0/. # # This Source Code Form is "Incompatible With Secondary Licenses", as # defined by the Mozilla Public License, v. 2.0. use 5.10.1; use strict; use warnings; use lib qw(. lib local/lib/perl5); use Bugzilla; use Bugzilla::Constants; use Bugzilla::Error; use Bugzilla::User; use Bugzilla::Mailer; use Getopt::Long; use Pod::Usage; my $verbose = 0; # Return all comments if true, else errors only. my $login = ''; # Login name of the user which is used to call sanitycheck.cgi. my $help = 0; # Has user asked for help on this script? my $result = GetOptions('verbose' => \$verbose, 'login=s' => \$login, 'help|h|?' => \$help); pod2usage({-verbose => 1, -exitval => 1}) if $help; # Be sure a login name if given. $login || ThrowUserError('invalid_username'); my $user = new Bugzilla::User({ name => $login }) || ThrowUserError('invalid_username', { name => $login }); my $cgi = Bugzilla->cgi; my $template = Bugzilla->template; # Authenticate using this user account. Bugzilla->set_user($user); # Pass this param to sanitycheck.cgi. $cgi->param('verbose', $verbose); require 'sanitycheck.cgi'; # Now it's time to send an email to the user if there is something to notify. if ($cgi->param('output')) { my $message; my $vars = {}; $vars->{'addressee'} = $user->email; $vars->{'output'} = $cgi->param('output'); $vars->{'error_found'} = $cgi->param('error_found') ? 1 : 0; $template->process('email/sanitycheck.txt.tmpl', $vars, \$message) || ThrowTemplateError($template->error()); MessageToMTA($message); } __END__ =head1 NAME sanitycheck.pl - Perl script to perform a sanity check at the command line =head1 SYNOPSIS ./sanitycheck.pl [--help] ./sanitycheck.pl [--verbose] --login =head1 OPTIONS =over =item B<--help> Displays this help text =item B<--verbose> Causes this script to be more verbose in its output. Without this option, the script will return only errors. With the option, the script will append all output to the email. =item B<--login> This should be passed the email address of a user that is capable of running the Sanity Check process, a user with the editcomponents priv. This user will receive an email with the results of the script run. =back =head1 DESCRIPTION This script provides a way of running a 'Sanity Check' on the database via either a CLI or cron. It is equivalent to calling sanitycheck.cgi via a web browser.