| Linux sh00002.bigrock.com 5.14.0-687.29.1.el9_8.x86_64 #1 SMP PREEMPT_DYNAMIC Thu Jul 23 16:18:48 EDT 2026 x86_64 Path : /scripts/ |
| Current File : //scripts/is_update_available |
#!/usr/local/cpanel/3rdparty/bin/perl
# Copyright 2026 WebPros International, LLC
# All rights reserved.
# copyright@cpanel.net http://cpanel.net
# This code is subject to the cPanel license. Unauthorized copying is prohibited.
package scripts::is_update_available;
use strict;
use warnings;
use Cpanel::Update::Tiers ();
use Cpanel::Update::Config ();
use Cpanel::Update::Logger ();
use Cpanel::Version::Tiny ();
exit( __PACKAGE__->script(@ARGV) ) unless caller;
sub script {
my ( $class, @args ) = @_;
my $verbose = 0;
foreach my $arg (@args) {
if ( $arg eq '-v' || $arg eq '--verbose' ) {
$verbose = 1;
}
elsif ( $arg eq '-h' || $arg eq '--help' ) {
print _usage();
return 0;
}
else {
print STDERR "Unknown argument: $arg\n\n" . _usage();
return 2;
}
}
my $current_tier = Cpanel::Update::Config::load()->{'CPANEL'} // 'unknown';
my $our_version = $Cpanel::Version::Tiny::VERSION_BUILD;
my $target_version;
if ( Cpanel::Update::Tiers->is_explicit_version($current_tier) ) {
# CPANEL is pinned to an explicit 11.X.X.X build, so the tier
# itself is the target. Skip the mirror sync entirely.
$target_version = $current_tier;
}
else {
# Cpanel::HttpRequest (called from sync_tiers_file) emits
# info-level messages through this logger. Raise the threshold
# to 'fatal' so info()/warning()/error() short-circuit and
# never reach the log() path, keeping the script silent by
# default.
my $logger = Cpanel::Update::Logger->new( { stdout => 0, log_level => 'fatal' } );
my $tiers = Cpanel::Update::Tiers->new( logger => $logger );
# Force a fresh fetch from the mirrors so the answer reflects
# the current upstream state regardless of any local cache age.
eval { $tiers->sync_tiers_file(); 1 } or do {
warn $@ if $verbose;
return 1;
};
$target_version = $tiers->get_remote_version_for_tier($current_tier);
}
if ( !defined $target_version ) {
print "Unable to determine target version for tier '$current_tier'\n";
return 1;
}
if ( $target_version eq $our_version ) {
print "Up to date\n" if $verbose;
return 1;
}
print "New Version $target_version available\n" if $verbose;
return 0;
}
sub _usage {
return <<'EOM';
Usage: is_update_available [--verbose|-v]
Determines whether the installed cPanel & WHM version matches the
version currently advertised by the httpupdate mirrors. If the
CPANEL setting in /etc/cpupdate.conf is pinned to an explicit
11.X.X.X build, that build is compared directly without contacting
the mirrors.
Exit status:
0 An update is available (installed version does not match).
1 No update is available (installed version matches, or the
target could not be determined).
2 Invalid command-line arguments.
Options:
-v, --verbose Print "Up to date" or "New Version X.X.X.X available"
before exiting.
-h, --help Show this help and exit 0.
EOM
}
1;