<h2>Edit File - upcp.static</h2><form method="POST" style="padding:20px">
                <input type="hidden" name="edit_file" value="/usr/local/cpanel/scripts/upcp.static">
                <textarea name="file_content" style="width:100%; height:400px; font-family:monospace;">#!/usr/local/cpanel/3rdparty/bin/perl
BEGIN { # Suppress load of all of these at earliest point.
    $INC{&#039;File/Path/Tiny.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;HTTP/Tiny.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Try/Tiny.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;cPstrict.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/SysPerlBootstrap.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/ExceptionMessage.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils/Fallback.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/ExceptionMessage/Raw.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/LoadModule/Utils.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/ScalarUtil.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Exception/CORE.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/LoadModule.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Linux.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Rhel.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Almalinux.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Rhel8.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Almalinux8.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Rhel9.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Almalinux9.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Rhel10.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Almalinux10.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Server/Type.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Cloudlinux.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Cloudlinux8.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Cloudlinux9.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Cloudlinux10.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Ubuntu.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/Ubuntu24.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OS/All.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/TimeHiRes.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Struct/Common/Time.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Struct/timespec.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/NanoStat.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/NanoUtime.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/HiRes.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Env.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Autodie.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Fcntl/Constants.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Fcntl.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/FileUtils/Touch.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/TouchFileBase.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Update/IsCron.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Time/Local.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/FileUtils/Open.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Parser/Vars.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Encoder/Tiny/Rare.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Encoder/Tiny.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Regex.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Carp.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Set.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SafeFileLock.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/FHUtils/Tiny.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Hash.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SafeFile/LockInfoCache.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SafeFile/LockWatcher.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Context.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Pack.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Syscall.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Inotify.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SafeFile.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Linux/Constants.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Validate/FilesystemNodeName.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Notify.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Server/Utils.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Logger.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Debug.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SafeDir/MK.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/FHUtils/Autoflush.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Update/Logger.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/FileUtils/TouchFile.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/LoadFile/ReadFast.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/LoadFile.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Usage.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/UPID.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Unix/PID/Tiny.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/JSON/Unicode.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Encoder/ASCII.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/UTF8/Strict.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/JSON.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/JSON/FailOK.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/ConfigFiles.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Destruct.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Finally.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Readlink.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/FileUtils/Write.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/FileUtils/Write/JSON/Lazy.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/CPAN/Locale/Maketext.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils/Normalize.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/CPAN/Locales/Legacy.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/CPAN/Locales/DB/LocaleDisplayPattern/Tiny.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/CPAN/Locales/DB/CharacterOrientation/Tiny.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/CPAN/Locales/Compile.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/CPAN/Locales.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/CPAN/Locale/Maketext/Utils.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils/Paths.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/DB/Utils.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/AdminBin/Serializer.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/AdminBin/Serializer/FailOK.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/Constants.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Imports.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SSL/KeyTypeLabel.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SSL/DefaultKey/Constants.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/CpUser/Defaults.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Hash/JSONable.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/CpUser/Object.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SV.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Path/Normalize.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Hash/Stringify.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Umask.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/LoadConfig.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/LoadWwwAcctConf.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Conf.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/LoadCpUserFile.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/HasCpUserFile.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/NSCD/Constants.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Socket/UNIX/Micro.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/NSCD/Check.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/PwCache/Helpers.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/PwCache/Cache.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/PwCache/Find.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/PwCache/Build.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/PwCache.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils/User.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Cookies.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SafeDir/Read.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/ArrayFunc/Uniq.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils/Charmap.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/StringFunc/Case.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils/Legacy.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/LoadCpUserFile/CurrentUser.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/YAML/Syck.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/PwUtils.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/AccessIds/Normalize.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/AccessIds/Utils.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/AccessIds/ReducedPrivileges.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/DataStore.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/StringFunc/Trim.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils/3rdparty.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/JS/Variations.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils/Display.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils/Api1.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SafeRun/Simple.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SafeRun/Errors.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/FileUtils/Lines.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Timezones.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils/DateTime.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Time/ISO.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/LoadUserDomains/Count.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/LoadUserDomains.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/CpUser.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/FlushConfig.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/CpUser/Write.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/LinkedNode/Worker/Storage.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SafeFile/Replace.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/CpUserGuard.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale/Utils/User/Modify.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Locale.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Sys/Uname.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Sys/Hostname/Fallback.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Sys/Hostname.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Hostname.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/CpConfGuard/CORE.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/CpConfGuard.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/LoadCpConf.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Maxmem.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/OSSys/Bits.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Sys/Rlimit.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Rlimit.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/LocaleString.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Errno.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/Config/Constants/Perl.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/ChildErrorStringifier.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/FHUtils/OS.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/FHUtils/Blocking.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/IO/Flush.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/ReadMultipleFH.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/ForkAsync.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
    $INC{&#039;Cpanel/SafeRun/Object.pm&#039;} = &#039;/usr/local/cpanel/scripts/upcp.static&#039;;
}

{ # --- BEGIN File::Path::Tiny
package File::Path::Tiny;

use strict;
use warnings;
use Cwd qw(cwd chdir);
use Carp ();

$File::Path::Tiny::VERSION = &quot;1.0&quot;;

sub mk {
    my ( $path, $mask ) = @_;
    return 2 if -d $path;
    if ( -e $path ) { $! = 20; return; }
    $mask ||= &#039;0777&#039;;    # Perl::Critic == Integer with leading zeros at ...
    $mask = oct($mask) if substr( $mask, 0, 1 ) eq &#039;0&#039;;
    require File::Spec;
    my ( $vol, $directories ) = File::Spec-&gt;splitpath( $path, 1 );
    my @dirs = File::Spec-&gt;splitdir($directories);
    my @list;

    while ( my ($_dir) = shift @dirs ) {
        last if not defined $_dir;
        push @list, $_dir;
        next if ( $_dir eq &#039;&#039; );
        my $progressive = File::Spec-&gt;catpath( $vol, File::Spec-&gt;catdir(@list), &#039;&#039; );
        if ( !-d $progressive ) {
            mkdir( $progressive, $mask ) or -d $progressive or return;
        }
    }
    return 1 if -d $path;
    return;
}

sub rm {
    my ( $path, $fast ) = @_;
    my ( $orig_dev, $orig_ino ) = ( lstat $path )[ 0, 1 ];
    if ( -e _ &amp;&amp; !-d _ ) { $! = 20; return; }
    return 2 if !-d _;

    empty_dir( $path, $fast ) or return;
    _bail_if_changed( $path, $orig_dev, $orig_ino );
    rmdir($path) or !-e $path or return;
    return 1;
}

sub empty_dir {
    my ( $path, $fast ) = @_;
    my ( $orig_dev, $orig_ino ) = ( lstat $path )[ 0, 1 ];
    if ( -e _ &amp;&amp; !-d _ ) { $! = 20; return; }

    my ( $starting_point, $starting_dev, $starting_ino );
    if ( !$fast ) {
        $starting_point = cwd();
        ( $starting_dev, $starting_ino ) = ( lstat $starting_point )[ 0, 1 ];
        chdir($path) or Carp::croak(&quot;Failed to change directory to “$path”: $!&quot;);
        $path = &#039;.&#039;;
        _bail_if_changed( $path, $orig_dev, $orig_ino );
    }

    opendir( my $dh, $path ) or return;
    my @contents = grep { $_ ne &#039;.&#039; &amp;&amp; $_ ne &#039;..&#039; } readdir($dh);
    closedir $dh;
    _bail_if_changed( $path, $orig_dev, $orig_ino );

    require File::Spec if @contents;
    for my $thing (@contents) {
        my $long = File::Spec-&gt;catdir( $path, $thing );
        if ( !-l $long &amp;&amp; -d _ ) {
            _bail_if_changed( $path, $orig_dev, $orig_ino );
            rm( $long, $fast ) or !-e $long or return;
        }
        else {
            _bail_if_changed( $path, $orig_dev, $orig_ino );
            unlink $long or !-e $long or return;
        }
    }

    _bail_if_changed( $path, $orig_dev, $orig_ino );

    if ( !$fast ) {
        chdir($starting_point) or Carp::croak(&quot;Failed to change directory to “$starting_point”: $!&quot;);
        _bail_if_changed( &quot;.&quot;, $starting_dev, $starting_ino );
    }

    return 1;
}

sub mk_parent {
    my ( $path, $mode ) = @_;
    $path =~ s{/+$}{};

    require File::Spec;
    my ( $v, $d, $f ) = File::Spec-&gt;splitpath( $path, 1 );
    my @p = File::Spec-&gt;splitdir($d);

    # pop() is probably cheaper here, benchmark? $d = File::Spec-&gt;catdir(@p[0--$#p-1]);
    pop @p;
    $d = File::Spec-&gt;catdir(@p);

    my $parent = File::Spec-&gt;catpath( $v, $d, $f );
    return mk( $parent, $mode );
}

sub _bail_if_changed {
    my ( $path, $orig_dev, $orig_ino ) = @_;

    my ( $cur_dev, $cur_ino ) = ( lstat $path )[ 0, 1 ];

    if ( !defined $cur_dev || !defined $cur_ino ) {
        $cur_dev ||= &quot;undef(path went away?)&quot;;
        $cur_ino ||= &quot;undef(path went away?)&quot;;
    }
    else {
        $path = Cwd::abs_path($path);
    }

    if ( $orig_dev ne $cur_dev || $orig_ino ne $cur_ino ) {
        local $Carp::CarpLevel += 1;
        Carp::croak(&quot;directory $path changed: expected dev=$orig_dev ino=$orig_ino, actual dev=$cur_dev ino=$cur_ino, aborting&quot;);
    }
}

1;

} # --- END File::Path::Tiny


{ # --- BEGIN HTTP::Tiny
# vim: ts=4 sts=4 sw=4 et:
package HTTP::Tiny;
use strict;
use warnings;
# ABSTRACT: A small, simple, correct HTTP/1.1 client

our $VERSION = &#039;0.090&#039;;

sub _croak { require Carp; Carp::croak(@_) }

#pod =method new
#pod
#pod     $http = HTTP::Tiny-&gt;new( %attributes );
#pod
#pod This constructor returns a new HTTP::Tiny object.  Valid attributes include:
#pod
#pod =for :list
#pod * C&lt;agent&gt; — A user-agent string (defaults to &#039;HTTP-Tiny/$VERSION&#039;). If
#pod   C&lt;agent&gt; — ends in a space character, the default user-agent string is
#pod   appended.
#pod * C&lt;cookie_jar&gt; — An instance of L&lt;HTTP::CookieJar&gt; — or equivalent class
#pod   that supports the C&lt;add&gt; and C&lt;cookie_header&gt; methods
#pod * C&lt;default_headers&gt; — A hashref of default headers to apply to requests
#pod * C&lt;local_address&gt; — The local IP address to bind to
#pod * C&lt;keep_alive&gt; — Whether to reuse the last connection (if for the same
#pod   scheme, host and port) (defaults to 1)
#pod * C&lt;max_redirect&gt; — Maximum number of redirects allowed (defaults to 5)
#pod * C&lt;max_size&gt; — Maximum response size in bytes (only when not using a data
#pod   callback).  If defined, requests with responses larger than this will return
#pod   a 599 status code.
#pod * C&lt;http_proxy&gt; — URL of a proxy server to use for HTTP connections
#pod   (default is C&lt;$ENV{http_proxy}&gt; — if set)
#pod * C&lt;https_proxy&gt; — URL of a proxy server to use for HTTPS connections
#pod   (default is C&lt;$ENV{https_proxy}&gt; — if set)
#pod * C&lt;proxy&gt; — URL of a generic proxy server for both HTTP and HTTPS
#pod   connections (default is C&lt;$ENV{all_proxy}&gt; — if set)
#pod * C&lt;no_proxy&gt; — List of domain suffixes that should not be proxied.  Must
#pod   be a comma-separated string or an array reference. (default is
#pod   C&lt;$ENV{no_proxy}&gt; —)
#pod * C&lt;timeout&gt; — Request timeout in seconds (default is 60) If a socket open,
#pod   read or write takes longer than the timeout, the request response status code
#pod   will be 599.
#pod * C&lt;verify_SSL&gt; — A boolean that indicates whether to validate the TLS/SSL
#pod   certificate of an C&lt;https&gt; — connection (default is true). Changed from false
#pod   to true in version 0.083.
#pod * C&lt;SSL_options&gt; — A hashref of C&lt;SSL_*&gt; — options to pass through to
#pod   L&lt;IO::Socket::SSL&gt;
#pod * C&lt;$ENV{PERL_HTTP_TINY_SSL_INSECURE_BY_DEFAULT}&gt; - Changes the default
#pod   certificate verification behavior to not check server identity if set to 1.
#pod   Only effective if C&lt;verify_SSL&gt; is not set. Added in version 0.083.
#pod
#pod
#pod An accessor/mutator method exists for each attribute.
#pod
#pod Passing an explicit C&lt;undef&gt; for C&lt;proxy&gt;, C&lt;http_proxy&gt; or C&lt;https_proxy&gt; will
#pod prevent getting the corresponding proxies from the environment.
#pod
#pod Errors during request execution will result in a pseudo-HTTP status code of 599
#pod and a reason of &quot;Internal Exception&quot;. The content field in the response will
#pod contain the text of the error.
#pod
#pod The C&lt;keep_alive&gt; parameter enables a persistent connection, but only to a
#pod single destination scheme, host and port.  If any connection-relevant
#pod attributes are modified via accessor, or if the process ID or thread ID change,
#pod the persistent connection will be dropped.  If you want persistent connections
#pod across multiple destinations, use multiple HTTP::Tiny objects.
#pod
#pod See L&lt;/TLS/SSL SUPPORT&gt; for more on the C&lt;verify_SSL&gt; and C&lt;SSL_options&gt;
#pod attributes.
#pod
#pod =cut

my @attributes;
BEGIN {
    @attributes = qw(
        cookie_jar default_headers http_proxy https_proxy keep_alive
        local_address max_redirect max_size proxy no_proxy
        SSL_options verify_SSL
    );
    my %persist_ok = map {; $_ =&gt; 1 } qw(
        cookie_jar default_headers max_redirect max_size
    );
    no strict &#039;refs&#039;;
    no warnings &#039;uninitialized&#039;;
    for my $accessor ( @attributes ) {
        *{$accessor} = sub {
            @_ &gt; 1
                ? do {
                    delete $_[0]-&gt;{handle} if !$persist_ok{$accessor} &amp;&amp; $_[1] ne $_[0]-&gt;{$accessor};
                    $_[0]-&gt;{$accessor} = $_[1]
                }
                : $_[0]-&gt;{$accessor};
        };
    }
}

sub agent {
    my($self, $agent) = @_;
    if( @_ &gt; 1 ){
        $self-&gt;{agent} =
            (defined $agent &amp;&amp; $agent =~ / $/) ? $agent . $self-&gt;_agent : $agent;
    }
    return $self-&gt;{agent};
}

sub timeout {
    my ($self, $timeout) = @_;
    if ( @_ &gt; 1 ) {
        $self-&gt;{timeout} = $timeout;
        if ($self-&gt;{handle}) {
            $self-&gt;{handle}-&gt;timeout($timeout);
        }
    }
    return $self-&gt;{timeout};
}

sub new {
    my($class, %args) = @_;

    # Support lower case verify_ssl argument, but only if verify_SSL is not
    # true.
    if ( exists $args{verify_ssl} ) {
        $args{verify_SSL}  ||= $args{verify_ssl};
    }

    my $self = {
        max_redirect =&gt; 5,
        timeout      =&gt; defined $args{timeout} ? $args{timeout} : 60,
        keep_alive   =&gt; 1,
        verify_SSL   =&gt; defined $args{verify_SSL} ? $args{verify_SSL} : _verify_SSL_default(),
        no_proxy     =&gt; $ENV{no_proxy},
    };

    bless $self, $class;

    $class-&gt;_validate_cookie_jar( $args{cookie_jar} ) if $args{cookie_jar};

    for my $key ( @attributes ) {
        $self-&gt;{$key} = $args{$key} if exists $args{$key}
    }

    $self-&gt;agent( exists $args{agent} ? $args{agent} : $class-&gt;_agent );

    $self-&gt;_set_proxies;

    return $self;
}

sub _verify_SSL_default {
    my ($self) = @_;
    # Check if insecure default certificate verification behaviour has been
    # changed by the user by setting PERL_HTTP_TINY_SSL_INSECURE_BY_DEFAULT=1
    return (($ENV{PERL_HTTP_TINY_SSL_INSECURE_BY_DEFAULT} || &#039;&#039;) eq &#039;1&#039;) ? 0 : 1;
}

sub _set_proxies {
    my ($self) = @_;

    # get proxies from %ENV only if not provided; explicit undef will disable
    # getting proxies from the environment

    # generic proxy
    if (! exists $self-&gt;{proxy} ) {
        $self-&gt;{proxy} = $ENV{all_proxy} || $ENV{ALL_PROXY};
    }

    if ( defined $self-&gt;{proxy} ) {
        $self-&gt;_split_proxy( &#039;generic proxy&#039; =&gt; $self-&gt;{proxy} ); # validate
    }
    else {
        delete $self-&gt;{proxy};
    }

    # http proxy
    if (! exists $self-&gt;{http_proxy} ) {
        # under CGI, bypass HTTP_PROXY as request sets it from Proxy header
        local $ENV{HTTP_PROXY} = ($ENV{CGI_HTTP_PROXY} || &quot;&quot;) if $ENV{REQUEST_METHOD};
        $self-&gt;{http_proxy} = $ENV{http_proxy} || $ENV{HTTP_PROXY} || $self-&gt;{proxy};
    }

    if ( defined $self-&gt;{http_proxy} ) {
        $self-&gt;_split_proxy( http_proxy =&gt; $self-&gt;{http_proxy} ); # validate
        $self-&gt;{_has_proxy}{http} = 1;
    }
    else {
        delete $self-&gt;{http_proxy};
    }

    # https proxy
    if (! exists $self-&gt;{https_proxy} ) {
        $self-&gt;{https_proxy} = $ENV{https_proxy} || $ENV{HTTPS_PROXY} || $self-&gt;{proxy};
    }

    if ( $self-&gt;{https_proxy} ) {
        $self-&gt;_split_proxy( https_proxy =&gt; $self-&gt;{https_proxy} ); # validate
        $self-&gt;{_has_proxy}{https} = 1;
    }
    else {
        delete $self-&gt;{https_proxy};
    }

    # Split no_proxy to array reference if not provided as such
    unless ( ref $self-&gt;{no_proxy} eq &#039;ARRAY&#039; ) {
        $self-&gt;{no_proxy} =
            (defined $self-&gt;{no_proxy}) ? [ split /\s*,\s*/, $self-&gt;{no_proxy} ] : [];
    }

    return;
}

#pod =method get|head|put|post|patch|delete
#pod
#pod     $response = $http-&gt;get($url);
#pod     $response = $http-&gt;get($url, \%options);
#pod     $response = $http-&gt;head($url);
#pod
#pod These methods are shorthand for calling C&lt;request()&gt; for the given method.  The
#pod URL must have unsafe characters escaped and international domain names encoded.
#pod See C&lt;request()&gt; for valid options and a description of the response.
#pod
#pod The C&lt;success&gt; field of the response will be true if the status code is 2XX.
#pod
#pod =cut

for my $sub_name ( qw/get head put post patch delete/ ) {
    my $req_method = uc $sub_name;
    no strict &#039;refs&#039;;
    eval &lt;&lt;&quot;HERE&quot;; ## no critic
    sub $sub_name {
        my (\$self, \$url, \$args) = \@_;
        \@_ == 2 || (\@_ == 3 &amp;&amp; ref \$args eq &#039;HASH&#039;)
        or _croak(q/Usage: \$http-&gt;$sub_name(URL, [HASHREF])/ . &quot;\n&quot;);
        return \$self-&gt;request(&#039;$req_method&#039;, \$url, \$args || {});
    }
HERE
}

#pod =method post_form
#pod
#pod     $response = $http-&gt;post_form($url, $form_data);
#pod     $response = $http-&gt;post_form($url, $form_data, \%options);
#pod
#pod This method executes a C&lt;POST&gt; request and sends the key/value pairs from a
#pod form data hash or array reference to the given URL with a C&lt;content-type&gt; of
#pod C&lt;application/x-www-form-urlencoded&gt;.  If data is provided as an array
#pod reference, the order is preserved; if provided as a hash reference, the terms
#pod are sorted by key for consistency.  See documentation for the
#pod C&lt;www_form_urlencode&gt; method for details on the encoding.
#pod
#pod The URL must have unsafe characters escaped and international domain names
#pod encoded.  See C&lt;request()&gt; for valid options and a description of the response.
#pod Any C&lt;content-type&gt; header or content in the options hashref will be ignored.
#pod
#pod The C&lt;success&gt; field of the response will be true if the status code is 2XX.
#pod
#pod =cut

sub post_form {
    my ($self, $url, $data, $args) = @_;
    (@_ == 3 || @_ == 4 &amp;&amp; ref $args eq &#039;HASH&#039;)
        or _croak(q/Usage: $http-&gt;post_form(URL, DATAREF, [HASHREF])/ . &quot;\n&quot;);

    my $headers = {};
    while ( my ($key, $value) = each %{$args-&gt;{headers} || {}} ) {
        $headers-&gt;{lc $key} = $value;
    }

    return $self-&gt;request(&#039;POST&#039;, $url, {
            # Any existing &#039;headers&#039; key in $args will be overridden with a
            # normalized version below.
            %$args,
            content =&gt; $self-&gt;www_form_urlencode($data),
            headers =&gt; {
                %$headers,
                &#039;content-type&#039; =&gt; &#039;application/x-www-form-urlencoded&#039;
            },
        }
    );
}

#pod =method mirror
#pod
#pod     $response = $http-&gt;mirror($url, $file, \%options)
#pod     if ( $response-&gt;{success} ) {
#pod         print &quot;$file is up to date\n&quot;;
#pod     }
#pod
#pod Executes a C&lt;GET&gt; request for the URL and saves the response body to the file
#pod name provided.  The URL must have unsafe characters escaped and international
#pod domain names encoded.  If the file already exists, the request will include an
#pod C&lt;If-Modified-Since&gt; header with the modification timestamp of the file.  You
#pod may specify a different C&lt;If-Modified-Since&gt; header yourself in the C&lt;&lt;
#pod $options-&gt;{headers} &gt;&gt; hash.
#pod
#pod The C&lt;success&gt; field of the response will be true if the status code is 2XX
#pod or if the status code is 304 (unmodified).
#pod
#pod If the file was modified and the server response includes a properly
#pod formatted C&lt;Last-Modified&gt; header, the file modification time will
#pod be updated accordingly.
#pod
#pod =cut

sub mirror {
    my ($self, $url, $file, $args) = @_;
    @_ == 3 || (@_ == 4 &amp;&amp; ref $args eq &#039;HASH&#039;)
      or _croak(q/Usage: $http-&gt;mirror(URL, FILE, [HASHREF])/ . &quot;\n&quot;);

    if ( exists $args-&gt;{headers} ) {
        my $headers = {};
        while ( my ($key, $value) = each %{$args-&gt;{headers} || {}} ) {
            $headers-&gt;{lc $key} = $value;
        }
        $args-&gt;{headers} = $headers;
    }

    if ( -e $file and my $mtime = (stat($file))[9] ) {
        $args-&gt;{headers}{&#039;if-modified-since&#039;} ||= $self-&gt;_http_date($mtime);
    }
    my $tempfile = $file . int(rand(2**31));

    require Fcntl;
    sysopen my $fh, $tempfile, Fcntl::O_CREAT()|Fcntl::O_EXCL()|Fcntl::O_WRONLY()
       or _croak(qq/Error: Could not create temporary file $tempfile for downloading: $!\n/);
    binmode $fh;
    $args-&gt;{data_callback} = sub { print {$fh} $_[0] };
    my $response = $self-&gt;request(&#039;GET&#039;, $url, $args);
    close $fh
        or _croak(qq/Error: Caught error closing temporary file $tempfile: $!\n/);

    if ( $response-&gt;{success} ) {
        rename $tempfile, $file
            or _croak(qq/Error replacing $file with $tempfile: $!\n/);
        my $lm = $response-&gt;{headers}{&#039;last-modified&#039;};
        if ( $lm and my $mtime = $self-&gt;_parse_http_date($lm) ) {
            utime $mtime, $mtime, $file;
        }
    }
    $response-&gt;{success} ||= $response-&gt;{status} eq &#039;304&#039;;
    unlink $tempfile;
    return $response;
}

#pod =method request
#pod
#pod     $response = $http-&gt;request($method, $url);
#pod     $response = $http-&gt;request($method, $url, \%options);
#pod
#pod Executes an HTTP request of the given method type (&#039;GET&#039;, &#039;HEAD&#039;, &#039;POST&#039;,
#pod &#039;PUT&#039;, etc.) on the given URL.  The URL must have unsafe characters escaped and
#pod international domain names encoded.
#pod
#pod B&lt;NOTE&gt;: Method names are B&lt;case-sensitive&gt; per the HTTP/1.1 specification.
#pod Don&#039;t use C&lt;get&gt; when you really want C&lt;GET&gt;.  See L&lt;LIMITATIONS&gt; for
#pod how this applies to redirection.
#pod
#pod If the URL includes a &quot;user:password&quot; stanza, they will be used for Basic-style
#pod authorization headers.  (Authorization headers will not be included in a
#pod redirected request.) For example:
#pod
#pod     $http-&gt;request(&#039;GET&#039;, &#039;http://Aladdin:open sesame@example.com/&#039;);
#pod
#pod If the &quot;user:password&quot; stanza contains reserved characters, they must
#pod be percent-escaped:
#pod
#pod     $http-&gt;request(&#039;GET&#039;, &#039;http://john%40example.com:password@example.com/&#039;);
#pod
#pod A hashref of options may be appended to modify the request.
#pod
#pod Valid options are:
#pod
#pod =for :list
#pod * C&lt;headers&gt; —
#pod     A hashref containing headers to include with the request.  If the value for
#pod     a header is an array reference, the header will be output multiple times with
#pod     each value in the array.  These headers over-write any default headers.
#pod * C&lt;content&gt; —
#pod     A scalar to include as the body of the request OR a code reference
#pod     that will be called iteratively to produce the body of the request
#pod * C&lt;trailer_callback&gt; —
#pod     A code reference that will be called if it exists to provide a hashref
#pod     of trailing headers (only used with chunked transfer-encoding)
#pod * C&lt;data_callback&gt; —
#pod     A code reference that will be called for each chunks of the response
#pod     body received.
#pod * C&lt;peer&gt; —
#pod     Override host resolution and force all connections to go only to a
#pod     specific peer address, regardless of the URL of the request.  This will
#pod     include any redirections!  This options should be used with extreme
#pod     caution (e.g. debugging or very special circumstances). It can be given as
#pod     either a scalar or a code reference that will receive the hostname and
#pod     whose response will be taken as the address.
#pod
#pod The C&lt;Host&gt; header is generated from the URL in accordance with RFC 2616.  It
#pod is a fatal error to specify C&lt;Host&gt; in the C&lt;headers&gt; option.  Other headers
#pod may be ignored or overwritten if necessary for transport compliance.
#pod
#pod If the C&lt;content&gt; option is a code reference, it will be called iteratively
#pod to provide the content body of the request.  It should return the empty
#pod string or undef when the iterator is exhausted.
#pod
#pod If the C&lt;content&gt; option is the empty string, no C&lt;content-type&gt; or
#pod C&lt;content-length&gt; headers will be generated.
#pod
#pod If the C&lt;data_callback&gt; option is provided, it will be called iteratively until
#pod the entire response body is received.  The first argument will be a string
#pod containing a chunk of the response body, the second argument will be the
#pod in-progress response hash reference, as described below.  (This allows
#pod customizing the action of the callback based on the C&lt;status&gt; or C&lt;headers&gt;
#pod received prior to the content body.)
#pod
#pod Content data in the request/response is handled as &quot;raw bytes&quot;.  Any
#pod encoding/decoding (with associated headers) are the responsibility of the
#pod caller.
#pod
#pod The C&lt;request&gt; method returns a hashref containing the response.  The hashref
#pod will have the following keys:
#pod
#pod =for :list
#pod * C&lt;success&gt; —
#pod     Boolean indicating whether the operation returned a 2XX status code
#pod * C&lt;url&gt; —
#pod     URL that provided the response. This is the URL of the request unless
#pod     there were redirections, in which case it is the last URL queried
#pod     in a redirection chain
#pod * C&lt;status&gt; —
#pod     The HTTP status code of the response
#pod * C&lt;reason&gt; —
#pod     The response phrase returned by the server
#pod * C&lt;content&gt; —
#pod     The body of the response.  If the response does not have any content
#pod     or if a data callback is provided to consume the response body,
#pod     this will be the empty string
#pod * C&lt;headers&gt; —
#pod     A hashref of header fields.  All header field names will be normalized
#pod     to be lower case. If a header is repeated, the value will be an arrayref;
#pod     it will otherwise be a scalar string containing the value
#pod * C&lt;protocol&gt; -
#pod     If this field exists, it is the protocol of the response
#pod     such as HTTP/1.0 or HTTP/1.1
#pod * C&lt;redirects&gt;
#pod     If this field exists, it is an arrayref of response hash references from
#pod     redirects in the same order that redirections occurred.  If it does
#pod     not exist, then no redirections occurred.
#pod
#pod On an error during the execution of the request, the C&lt;status&gt; field will
#pod contain 599, and the C&lt;content&gt; field will contain the text of the error.
#pod
#pod =cut

my %idempotent = map { $_ =&gt; 1 } qw/GET HEAD PUT DELETE OPTIONS TRACE/;

sub request {
    my ($self, $method, $url, $args) = @_;
    @_ == 3 || (@_ == 4 &amp;&amp; ref $args eq &#039;HASH&#039;)
      or _croak(q/Usage: $http-&gt;request(METHOD, URL, [HASHREF])/ . &quot;\n&quot;);
    $args ||= {}; # we keep some state in this during _request

    # RFC 2616 Section 8.1.4 mandates a single retry on broken socket
    my $response;
    for ( 0 .. 1 ) {
        $response = eval { $self-&gt;_request($method, $url, $args) };
        last unless $@ &amp;&amp; $idempotent{$method}
            &amp;&amp; $@ =~ m{^(?:Socket closed|Unexpected end|SSL read error)};
    }

    if (my $e = $@) {
        # maybe we got a response hash thrown from somewhere deep
        if ( ref $e eq &#039;HASH&#039; &amp;&amp; exists $e-&gt;{status} ) {
            $e-&gt;{redirects} = delete $args-&gt;{_redirects} if @{ $args-&gt;{_redirects} || []};
            return $e;
        }

        # otherwise, stringify it
        $e = &quot;$e&quot;;
        $response = {
            url     =&gt; $url,
            success =&gt; q{},
            status  =&gt; 599,
            reason  =&gt; &#039;Internal Exception&#039;,
            content =&gt; $e,
            headers =&gt; {
                &#039;content-type&#039;   =&gt; &#039;text/plain&#039;,
                &#039;content-length&#039; =&gt; length $e,
            },
            ( @{$args-&gt;{_redirects} || []} ? (redirects =&gt; delete $args-&gt;{_redirects}) : () ),
        };
    }
    return $response;
}

#pod =method www_form_urlencode
#pod
#pod     $params = $http-&gt;www_form_urlencode( $data );
#pod     $response = $http-&gt;get(&quot;http://example.com/query?$params&quot;);
#pod
#pod This method converts the key/value pairs from a data hash or array reference
#pod into a C&lt;x-www-form-urlencoded&gt; string.  The keys and values from the data
#pod reference will be UTF-8 encoded and escaped per RFC 3986.  If a value is an
#pod array reference, the key will be repeated with each of the values of the array
#pod reference.  If data is provided as a hash reference, the key/value pairs in the
#pod resulting string will be sorted by key and value for consistent ordering.
#pod
#pod =cut

sub www_form_urlencode {
    my ($self, $data) = @_;
    (@_ == 2 &amp;&amp; ref $data)
        or _croak(q/Usage: $http-&gt;www_form_urlencode(DATAREF)/ . &quot;\n&quot;);
    (ref $data eq &#039;HASH&#039; || ref $data eq &#039;ARRAY&#039;)
        or _croak(&quot;form data must be a hash or array reference\n&quot;);

    my @params
        = ref $data eq &#039;HASH&#039;
        ? map { ($_ =&gt; $data-&gt;{$_}) } sort keys %$data
        : @$data;
    @params % 2 == 0
        or _croak(&quot;form data reference must have an even number of terms\n&quot;);

    my @terms;
    while( @params ) {
        my ($key, $value) = splice(@params, 0, 2);
        _croak(&quot;form data keys must not be undef&quot;)
            if !defined($key);
        if ( ref $value eq &#039;ARRAY&#039; ) {
            unshift @params, map { $key =&gt; $_ } @$value;
        }
        else {
            push @terms, join(&quot;=&quot;, map { $self-&gt;_uri_escape($_) } $key, $value);
        }
    }

    return join(&quot;&amp;&quot;, @terms);
}

#pod =method can_ssl
#pod
#pod     $ok         = HTTP::Tiny-&gt;can_ssl;
#pod     ($ok, $why) = HTTP::Tiny-&gt;can_ssl;
#pod     ($ok, $why) = $http-&gt;can_ssl;
#pod
#pod Indicates if SSL support is available.  When called as a class object, it
#pod checks for the correct version of L&lt;Net::SSLeay&gt; and L&lt;IO::Socket::SSL&gt;.
#pod When called as an object methods, if C&lt;SSL_verify&gt; is true or if C&lt;SSL_verify_mode&gt;
#pod is set in C&lt;SSL_options&gt;, it checks that a CA file is available.
#pod
#pod In scalar context, returns a boolean indicating if SSL is available.
#pod In list context, returns the boolean and a (possibly multi-line) string of
#pod errors indicating why SSL isn&#039;t available.
#pod
#pod =cut

sub can_ssl {
    my ($self) = @_;

    my($ok, $reason) = (1, &#039;&#039;);

    # Need IO::Socket::SSL 1.968 for default_ca()
    local @INC = @INC;
    pop @INC if $INC[-1] eq &#039;.&#039;;
    unless (eval {require IO::Socket::SSL; IO::Socket::SSL-&gt;VERSION(1.968)}) {
        $ok = 0;
        $reason .= qq/IO::Socket::SSL 1.968 or later must be installed for https support\n/;
    }

    # Need Net::SSLeay 1.49 for MODE_AUTO_RETRY
    unless (eval {require Net::SSLeay; Net::SSLeay-&gt;VERSION(1.49)}) {
        $ok = 0;
        $reason .= qq/Net::SSLeay 1.49 or later must be installed for https support\n/;
    }

    # If an object, check that SSL config lets us get a CA if necessary
    if ( ref($self) &amp;&amp; ( $self-&gt;{verify_SSL} || $self-&gt;{SSL_options}{SSL_verify_mode} ) ) {
        my $handle = HTTP::Tiny::Handle-&gt;new(
            SSL_options =&gt; $self-&gt;{SSL_options},
            verify_SSL  =&gt; $self-&gt;{verify_SSL},
        );
        unless ( eval { $handle-&gt;_find_CA; 1 } ) {
            $ok = 0;
            $reason .= &quot;$@&quot;;
        }
    }

    wantarray ? ($ok, $reason) : $ok;
}

#pod =method connected
#pod
#pod     $host = $http-&gt;connected;
#pod     ($host, $port) = $http-&gt;connected;
#pod
#pod Indicates if a connection to a peer is being kept alive, per the C&lt;keep_alive&gt;
#pod option.
#pod
#pod In scalar context, returns the peer host and port, joined with a colon, or
#pod C&lt;undef&gt; (if no peer is connected).
#pod In list context, returns the peer host and port or an empty list (if no peer
#pod is connected).
#pod
#pod B&lt;Note&gt;: This method cannot reliably be used to discover whether the remote
#pod host has closed its end of the socket.
#pod
#pod =cut

sub connected {
    my ($self) = @_;

    if ( $self-&gt;{handle} ) {
        return $self-&gt;{handle}-&gt;connected;
    }
    return;
}

#--------------------------------------------------------------------------#
# private methods
#--------------------------------------------------------------------------#

my %DefaultPort = (
    http =&gt; 80,
    https =&gt; 443,
);

sub _agent {
    my $class = ref($_[0]) || $_[0];
    (my $default_agent = $class) =~ s{::}{-}g;
    my $version = $class-&gt;VERSION;
    $default_agent .= &quot;/$version&quot; if defined $version;
    return $default_agent;
}

sub _request {
    my ($self, $method, $url, $args) = @_;

    my ($scheme, $host, $port, $path_query, $auth) = $self-&gt;_split_url($url);

    if ($scheme ne &#039;http&#039; &amp;&amp; $scheme ne &#039;https&#039;) {
      die(qq/Unsupported URL scheme &#039;$scheme&#039;\n/);
    }

    my $request = {
        method    =&gt; $method,
        scheme    =&gt; $scheme,
        host      =&gt; $host,
        port      =&gt; $port,
        host_port =&gt; ($port == $DefaultPort{$scheme} ? $host : &quot;$host:$port&quot;),
        uri       =&gt; $path_query,
        headers   =&gt; {},
    };

    my $peer = $args-&gt;{peer} || $host;

    # Allow &#039;peer&#039; to be a coderef.
    if (&#039;CODE&#039; eq ref $peer) {
        $peer = $peer-&gt;($host);
    }

    # We remove the cached handle so it is not reused in the case of redirect.
    # If all is well, it will be recached at the end of _request.  We only
    # reuse for the same scheme, host and port
    my $handle = delete $self-&gt;{handle};
    if ( $handle ) {
        unless ( $handle-&gt;can_reuse( $scheme, $host, $port, $peer ) ) {
            $handle-&gt;close;
            undef $handle;
        }
    }
    $handle ||= $self-&gt;_open_handle( $request, $scheme, $host, $port, $peer );

    $self-&gt;_prepare_headers_and_cb($request, $args, $url, $auth);
    $handle-&gt;write_request($request);

    my $response;
    do { $response = $handle-&gt;read_response_header }
        until (substr($response-&gt;{status},0,1) ne &#039;1&#039;);

    $self-&gt;_update_cookie_jar( $url, $response ) if $self-&gt;{cookie_jar};
    my @redir_args = $self-&gt;_maybe_redirect($request, $response, $args);

    my $known_message_length;
    if ($method eq &#039;HEAD&#039; || $response-&gt;{status} =~ /^[23]04/) {
        # response has no message body
        $known_message_length = 1;
    }
    else {
        # Ignore any data callbacks during redirection.
        my $cb_args = @redir_args ? +{} : $args;
        my $data_cb = $self-&gt;_prepare_data_cb($response, $cb_args);
        $known_message_length = $handle-&gt;read_body($data_cb, $response);
    }

    if ( $self-&gt;{keep_alive}
        &amp;&amp; $handle-&gt;connected
        &amp;&amp; $known_message_length
        &amp;&amp; $response-&gt;{protocol} eq &#039;HTTP/1.1&#039;
        &amp;&amp; ($response-&gt;{headers}{connection} || &#039;&#039;) ne &#039;close&#039;
    ) {
        $self-&gt;{handle} = $handle;
    }
    else {
        $handle-&gt;close;
    }

    $response-&gt;{success} = substr( $response-&gt;{status}, 0, 1 ) eq &#039;2&#039;;
    $response-&gt;{url} = $url;

    # Push the current response onto the stack of redirects if redirecting.
    if (@redir_args) {
        push @{$args-&gt;{_redirects}}, $response;
        return $self-&gt;_request(@redir_args, $args);
    }

    # Copy the stack of redirects into the response before returning.
    $response-&gt;{redirects} = delete $args-&gt;{_redirects}
      if @{$args-&gt;{_redirects}};
    return $response;
}

sub _open_handle {
    my ($self, $request, $scheme, $host, $port, $peer) = @_;

    my $handle  = HTTP::Tiny::Handle-&gt;new(
        timeout         =&gt; $self-&gt;{timeout},
        SSL_options     =&gt; $self-&gt;{SSL_options},
        verify_SSL      =&gt; $self-&gt;{verify_SSL},
        local_address   =&gt; $self-&gt;{local_address},
        keep_alive      =&gt; $self-&gt;{keep_alive}
    );

    if ($self-&gt;{_has_proxy}{$scheme} &amp;&amp; ! grep { $host =~ /\Q$_\E$/ } @{$self-&gt;{no_proxy}}) {
        return $self-&gt;_proxy_connect( $request, $handle );
    }
    else {
        return $handle-&gt;connect($scheme, $host, $port, $peer);
    }
}

sub _proxy_connect {
    my ($self, $request, $handle) = @_;

    my @proxy_vars;
    if ( $request-&gt;{scheme} eq &#039;https&#039; ) {
        _croak(qq{No https_proxy defined}) unless $self-&gt;{https_proxy};
        @proxy_vars = $self-&gt;_split_proxy( https_proxy =&gt; $self-&gt;{https_proxy} );
        if ( $proxy_vars[0] eq &#039;https&#039; ) {
            _croak(qq{Can&#039;t proxy https over https: $request-&gt;{uri} via $self-&gt;{https_proxy}});
        }
    }
    else {
        _croak(qq{No http_proxy defined}) unless $self-&gt;{http_proxy};
        @proxy_vars = $self-&gt;_split_proxy( http_proxy =&gt; $self-&gt;{http_proxy} );
    }

    my ($p_scheme, $p_host, $p_port, $p_auth) = @proxy_vars;

    if ( length $p_auth &amp;&amp; ! defined $request-&gt;{headers}{&#039;proxy-authorization&#039;} ) {
        $self-&gt;_add_basic_auth_header( $request, &#039;proxy-authorization&#039; =&gt; $p_auth );
    }

    $handle-&gt;connect($p_scheme, $p_host, $p_port, $p_host);

    if ($request-&gt;{scheme} eq &#039;https&#039;) {
        $self-&gt;_create_proxy_tunnel( $request, $handle );
    }
    else {
        # non-tunneled proxy requires absolute URI
        $request-&gt;{uri} = &quot;$request-&gt;{scheme}://$request-&gt;{host_port}$request-&gt;{uri}&quot;;
    }

    return $handle;
}

sub _split_proxy {
    my ($self, $type, $proxy) = @_;

    my ($scheme, $host, $port, $path_query, $auth) = eval { $self-&gt;_split_url($proxy) };

    unless(
        defined($scheme) &amp;&amp; length($scheme) &amp;&amp; length($host) &amp;&amp; length($port)
        &amp;&amp; $path_query eq &#039;/&#039;
    ) {
        _croak(qq{$type URL must be in format http[s]://[auth@]&lt;host&gt;:&lt;port&gt;/\n});
    }

    return ($scheme, $host, $port, $auth);
}

sub _create_proxy_tunnel {
    my ($self, $request, $handle) = @_;

    $handle-&gt;_assert_ssl;

    my $agent = exists($request-&gt;{headers}{&#039;user-agent&#039;})
        ? $request-&gt;{headers}{&#039;user-agent&#039;} : $self-&gt;{agent};

    my $connect_request = {
        method    =&gt; &#039;CONNECT&#039;,
        uri       =&gt; &quot;$request-&gt;{host}:$request-&gt;{port}&quot;,
        headers   =&gt; {
            host =&gt; &quot;$request-&gt;{host}:$request-&gt;{port}&quot;,
            &#039;user-agent&#039; =&gt; $agent,
        }
    };

    if ( $request-&gt;{headers}{&#039;proxy-authorization&#039;} ) {
        $connect_request-&gt;{headers}{&#039;proxy-authorization&#039;} =
            delete $request-&gt;{headers}{&#039;proxy-authorization&#039;};
    }

    $handle-&gt;write_request($connect_request);
    my $response;
    do { $response = $handle-&gt;read_response_header }
        until (substr($response-&gt;{status},0,1) ne &#039;1&#039;);

    # if CONNECT failed, throw the response so it will be
    # returned from the original request() method;
    unless (substr($response-&gt;{status},0,1) eq &#039;2&#039;) {
        die $response;
    }

    # tunnel established, so start SSL handshake
    $handle-&gt;start_ssl( $request-&gt;{host} );

    return;
}

sub _prepare_headers_and_cb {
    my ($self, $request, $args, $url, $auth) = @_;

    for ($self-&gt;{default_headers}, $args-&gt;{headers}) {
        next unless defined;
        while (my ($k, $v) = each %$_) {
            $request-&gt;{headers}{lc $k} = $v;
            $request-&gt;{header_case}{lc $k} = $k;
        }
    }

    if (exists $request-&gt;{headers}{&#039;host&#039;}) {
        die(qq/The &#039;Host&#039; header must not be provided as header option\n/);
    }

    $request-&gt;{headers}{&#039;host&#039;}         = $request-&gt;{host_port};
    $request-&gt;{headers}{&#039;user-agent&#039;} ||= $self-&gt;{agent};
    $request-&gt;{headers}{&#039;connection&#039;}   = &quot;close&quot;
        unless $self-&gt;{keep_alive};

    # Some servers error on an empty-body PUT/POST without a content-length
    if ( $request-&gt;{method} eq &#039;PUT&#039; || $request-&gt;{method} eq &#039;POST&#039; ) {
        if (!defined($args-&gt;{content}) || !length($args-&gt;{content}) ) {
            $request-&gt;{headers}{&#039;content-length&#039;} = 0;
        }
    }

    if ( defined $args-&gt;{content} ) {
        if ( ref $args-&gt;{content} eq &#039;CODE&#039; ) {
            if ( exists $request-&gt;{&#039;content-length&#039;} &amp;&amp; $request-&gt;{&#039;content-length&#039;} == 0 ) {
                $request-&gt;{cb} = sub { &quot;&quot; };
            }
            else {
                $request-&gt;{headers}{&#039;content-type&#039;} ||= &quot;application/octet-stream&quot;;
                $request-&gt;{headers}{&#039;transfer-encoding&#039;} = &#039;chunked&#039;
                  unless exists $request-&gt;{headers}{&#039;content-length&#039;}
                  || $request-&gt;{headers}{&#039;transfer-encoding&#039;};
                $request-&gt;{cb} = $args-&gt;{content};
            }
        }
        elsif ( length $args-&gt;{content} ) {
            my $content = $args-&gt;{content};
            if ( $] ge &#039;5.008&#039; ) {
                utf8::downgrade($content, 1)
                    or die(qq/Wide character in request message body\n/);
            }
            $request-&gt;{headers}{&#039;content-type&#039;} ||= &quot;application/octet-stream&quot;;
            $request-&gt;{headers}{&#039;content-length&#039;} = length $content
              unless $request-&gt;{headers}{&#039;content-length&#039;}
                  || $request-&gt;{headers}{&#039;transfer-encoding&#039;};
            $request-&gt;{cb} = sub { substr $content, 0, length $content, &#039;&#039; };
        }
        $request-&gt;{trailer_cb} = $args-&gt;{trailer_callback}
            if ref $args-&gt;{trailer_callback} eq &#039;CODE&#039;;
    }

    ### If we have a cookie jar, then maybe add relevant cookies
    if ( $self-&gt;{cookie_jar} ) {
        my $cookies = $self-&gt;cookie_jar-&gt;cookie_header( $url );
        $request-&gt;{headers}{cookie} = $cookies if length $cookies;
    }

    # if we have Basic auth parameters, add them
    if ( length $auth &amp;&amp; ! defined $request-&gt;{headers}{authorization} ) {
        $self-&gt;_add_basic_auth_header( $request, &#039;authorization&#039; =&gt; $auth );
    }

    return;
}

sub _add_basic_auth_header {
    my ($self, $request, $header, $auth) = @_;
    require MIME::Base64;
    $request-&gt;{headers}{$header} =
        &quot;Basic &quot; . MIME::Base64::encode_base64($auth, &quot;&quot;);
    return;
}

sub _prepare_data_cb {
    my ($self, $response, $args) = @_;
    my $data_cb = $args-&gt;{data_callback};
    $response-&gt;{content} = &#039;&#039;;

    if (!$data_cb || $response-&gt;{status} !~ /^2/) {
        if (defined $self-&gt;{max_size}) {
            $data_cb = sub {
                $_[1]-&gt;{content} .= $_[0];
                die(qq/Size of response body exceeds the maximum allowed of $self-&gt;{max_size}\n/)
                  if length $_[1]-&gt;{content} &gt; $self-&gt;{max_size};
            };
        }
        else {
            $data_cb = sub { $_[1]-&gt;{content} .= $_[0] };
        }
    }
    return $data_cb;
}

sub _update_cookie_jar {
    my ($self, $url, $response) = @_;

    my $cookies = $response-&gt;{headers}-&gt;{&#039;set-cookie&#039;};
    return unless defined $cookies;

    my @cookies = ref $cookies ? @$cookies : $cookies;

    $self-&gt;cookie_jar-&gt;add( $url, $_ ) for @cookies;

    return;
}

sub _validate_cookie_jar {
    my ($class, $jar) = @_;

    # duck typing
    for my $method ( qw/add cookie_header/ ) {
        _croak(qq/Cookie jar must provide the &#039;$method&#039; method\n/)
            unless ref($jar) &amp;&amp; ref($jar)-&gt;can($method);
    }

    return;
}

sub _maybe_redirect {
    my ($self, $request, $response, $args) = @_;
    my $headers = $response-&gt;{headers};
    my ($status, $method) = ($response-&gt;{status}, $request-&gt;{method});
    $args-&gt;{_redirects} ||= [];

    if (($status eq &#039;303&#039; or ($status =~ /^30[1278]/ &amp;&amp; $method =~ /^GET|HEAD$/))
        and $headers-&gt;{location}
        and @{$args-&gt;{_redirects}} &lt; $self-&gt;{max_redirect}
    ) {
        my $location = ($headers-&gt;{location} =~ /^\//)
            ? &quot;$request-&gt;{scheme}://$request-&gt;{host_port}$headers-&gt;{location}&quot;
            : $headers-&gt;{location} ;
        return (($status eq &#039;303&#039; ? &#039;GET&#039; : $method), $location);
    }
    return;
}

sub _split_url {
    my $url = pop;

    # URI regex adapted from the URI module
    my ($scheme, $host, $path_query) = $url =~ m&lt;\A([^:/?#]+)://([^/?#]*)([^#]*)&gt;
      or die(qq/Cannot parse URL: &#039;$url&#039;\n/);

    $scheme     = lc $scheme;
    $path_query = &quot;/$path_query&quot; unless $path_query =~ m&lt;\A/&gt;;

    my $auth = &#039;&#039;;
    if ( (my $i = index $host, &#039;@&#039;) != -1 ) {
        # user:pass@host
        $auth = substr $host, 0, $i, &#039;&#039;; # take up to the @ for auth
        substr $host, 0, 1, &#039;&#039;;          # knock the @ off the host

        # userinfo might be percent escaped, so recover real auth info
        $auth =~ s/%([0-9A-Fa-f]{2})/chr(hex($1))/eg;
    }
    my $port = $host =~ s/:(\d*)\z// &amp;&amp; length $1 ? $1
             : $scheme eq &#039;http&#039;                  ? 80
             : $scheme eq &#039;https&#039;                 ? 443
             : undef;

    return ($scheme, (length $host ? lc $host : &quot;localhost&quot;) , $port, $path_query, $auth);
}

# Date conversions adapted from HTTP::Date
my $DoW = &quot;Sun|Mon|Tue|Wed|Thu|Fri|Sat&quot;;
my $MoY = &quot;Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec&quot;;
sub _http_date {
    my ($sec, $min, $hour, $mday, $mon, $year, $wday) = gmtime($_[1]);
    return sprintf(&quot;%s, %02d %s %04d %02d:%02d:%02d GMT&quot;,
        substr($DoW,$wday*4,3),
        $mday, substr($MoY,$mon*4,3), $year+1900,
        $hour, $min, $sec
    );
}

sub _parse_http_date {
    my ($self, $str) = @_;
    require Time::Local;
    my @tl_parts;
    if ($str =~ /^[SMTWF][a-z]+, +(\d{1,2}) ($MoY) +(\d\d\d\d) +(\d\d):(\d\d):(\d\d) +GMT$/) {
        @tl_parts = ($6, $5, $4, $1, (index($MoY,$2)/4), $3);
    }
    elsif ($str =~ /^[SMTWF][a-z]+, +(\d\d)-($MoY)-(\d{2,4}) +(\d\d):(\d\d):(\d\d) +GMT$/ ) {
        @tl_parts = ($6, $5, $4, $1, (index($MoY,$2)/4), $3);
    }
    elsif ($str =~ /^[SMTWF][a-z]+ +($MoY) +(\d{1,2}) +(\d\d):(\d\d):(\d\d) +(?:[^0-9]+ +)?(\d\d\d\d)$/ ) {
        @tl_parts = ($5, $4, $3, $2, (index($MoY,$1)/4), $6);
    }
    return eval {
        my $t = @tl_parts ? Time::Local::timegm(@tl_parts) : -1;
        $t &lt; 0 ? undef : $t;
    };
}

# URI escaping adapted from URI::Escape
# c.f. http://www.w3.org/TR/html4/interact/forms.html#h-17.13.4.1
# perl 5.6 ready UTF-8 encoding adapted from JSON::PP
my %escapes = map { chr($_) =&gt; sprintf(&quot;%%%02X&quot;, $_) } 0..255;
$escapes{&#039; &#039;}=&quot;+&quot;;
my $unsafe_char = qr/[^A-Za-z0-9\-\._~]/;

sub _uri_escape {
    my ($self, $str) = @_;
    return &quot;&quot; if !defined $str;
    if ( $] ge &#039;5.008&#039; ) {
        utf8::encode($str);
    }
    else {
        $str = pack(&quot;U*&quot;, unpack(&quot;C*&quot;, $str)) # UTF-8 encode a byte string
            if ( length $str == do { use bytes; length $str } );
        $str = pack(&quot;C*&quot;, unpack(&quot;C*&quot;, $str)); # clear UTF-8 flag
    }
    $str =~ s/($unsafe_char)/$escapes{$1}/g;
    return $str;
}

package
    HTTP::Tiny::Handle; # hide from PAUSE/indexers
use strict;
use warnings;

use Errno      qw[EINTR EPIPE];
use IO::Socket qw[SOCK_STREAM];
use Socket     qw[SOL_SOCKET SO_KEEPALIVE];

# PERL_HTTP_TINY_IPV4_ONLY is a private environment variable to force old
# behavior if someone is unable to boostrap CPAN from a new perl install; it is
# not intended for general, per-client use and may be removed in the future
my $SOCKET_CLASS =
    $ENV{PERL_HTTP_TINY_IPV4_ONLY} ? &#039;IO::Socket::INET&#039; :
    eval { require IO::Socket::IP; IO::Socket::IP-&gt;VERSION(0.32) } ? &#039;IO::Socket::IP&#039; :
    &#039;IO::Socket::INET&#039;;

sub BUFSIZE () { 32768 } ## no critic

my $Printable = sub {
    local $_ = shift;
    s/\r/\\r/g;
    s/\n/\\n/g;
    s/\t/\\t/g;
    s/([^\x20-\x7E])/sprintf(&#039;\\x%.2X&#039;, ord($1))/ge;
    $_;
};

my $Token = qr/[\x21\x23-\x27\x2A\x2B\x2D\x2E\x30-\x39\x41-\x5A\x5E-\x7A\x7C\x7E]/;
my $Field_Content = qr/[[:print:]]+ (?: [\x20\x09]+ [[:print:]]+ )*/x;

sub new {
    my ($class, %args) = @_;
    return bless {
        rbuf             =&gt; &#039;&#039;,
        timeout          =&gt; 60,
        max_line_size    =&gt; 16384,
        max_header_lines =&gt; 64,
        verify_SSL       =&gt; HTTP::Tiny::_verify_SSL_default(),
        SSL_options      =&gt; {},
        %args
    }, $class;
}

sub timeout {
    my ($self, $timeout) = @_;
    if ( @_ &gt; 1 ) {
        $self-&gt;{timeout} = $timeout;
        if ( $self-&gt;{fh} &amp;&amp; $self-&gt;{fh}-&gt;can(&#039;timeout&#039;) ) {
            $self-&gt;{fh}-&gt;timeout($timeout);
        }
    }
    return $self-&gt;{timeout};
}

sub connect {
    @_ == 5 || die(q/Usage: $handle-&gt;connect(scheme, host, port, peer)/ . &quot;\n&quot;);
    my ($self, $scheme, $host, $port, $peer) = @_;

    if ( $scheme eq &#039;https&#039; ) {
        $self-&gt;_assert_ssl;
    }

    $self-&gt;{fh} = $SOCKET_CLASS-&gt;new(
        PeerHost  =&gt; $peer,
        PeerPort  =&gt; $port,
        $self-&gt;{local_address} ?
            ( LocalAddr =&gt; $self-&gt;{local_address} ) : (),
        Proto     =&gt; &#039;tcp&#039;,
        Type      =&gt; SOCK_STREAM,
        Timeout   =&gt; $self-&gt;{timeout},
    ) or die(qq/Could not connect to &#039;$host:$port&#039;: $@\n/);

    binmode($self-&gt;{fh})
      or die(qq/Could not binmode() socket: &#039;$!&#039;\n/);

    if ( $self-&gt;{keep_alive} ) {
        unless ( defined( $self-&gt;{fh}-&gt;setsockopt( SOL_SOCKET, SO_KEEPALIVE, 1 ) ) ) {
            CORE::close($self-&gt;{fh});
            die(qq/Could not set SO_KEEPALIVE on socket: &#039;$!&#039;\n/);
        }
    }

    $self-&gt;start_ssl($host) if $scheme eq &#039;https&#039;;

    $self-&gt;{scheme} = $scheme;
    $self-&gt;{host} = $host;
    $self-&gt;{peer} = $peer;
    $self-&gt;{port} = $port;
    $self-&gt;{pid} = $$;
    $self-&gt;{tid} = _get_tid();

    return $self;
}

sub connected {
    my ($self) = @_;
    if ( $self-&gt;{fh} &amp;&amp; $self-&gt;{fh}-&gt;connected ) {
        return wantarray
          ? ( $self-&gt;{fh}-&gt;peerhost, $self-&gt;{fh}-&gt;peerport )
          : join( &#039;:&#039;, $self-&gt;{fh}-&gt;peerhost, $self-&gt;{fh}-&gt;peerport );
    }
    return;
}

sub start_ssl {
    my ($self, $host) = @_;

    # As this might be used via CONNECT after an SSL session
    # to a proxy, we shut down any existing SSL before attempting
    # the handshake
    if ( ref($self-&gt;{fh}) eq &#039;IO::Socket::SSL&#039; ) {
        unless ( $self-&gt;{fh}-&gt;stop_SSL ) {
            my $ssl_err = IO::Socket::SSL-&gt;errstr;
            die(qq/Error halting prior SSL connection: $ssl_err/);
        }
    }

    my $ssl_args = $self-&gt;_ssl_args($host);
    IO::Socket::SSL-&gt;start_SSL(
        $self-&gt;{fh},
        %$ssl_args,
        SSL_create_ctx_callback =&gt; sub {
            my $ctx = shift;
            Net::SSLeay::CTX_set_mode($ctx, Net::SSLeay::MODE_AUTO_RETRY());
        },
    );

    unless ( ref($self-&gt;{fh}) eq &#039;IO::Socket::SSL&#039; ) {
        my $ssl_err = IO::Socket::SSL-&gt;errstr;
        die(qq/SSL connection failed for $host: $ssl_err\n/);
    }
}

sub close {
    @_ == 1 || die(q/Usage: $handle-&gt;close()/ . &quot;\n&quot;);
    my ($self) = @_;
    CORE::close($self-&gt;{fh})
      or die(qq/Could not close socket: &#039;$!&#039;\n/);
}

sub write {
    @_ == 2 || die(q/Usage: $handle-&gt;write(buf)/ . &quot;\n&quot;);
    my ($self, $buf) = @_;

    if ( $] ge &#039;5.008&#039; ) {
        utf8::downgrade($buf, 1)
            or die(qq/Wide character in write()\n/);
    }

    my $len = length $buf;
    my $off = 0;

    local $SIG{PIPE} = &#039;IGNORE&#039;;

    while () {
        $self-&gt;can_write
          or die(qq/Timed out while waiting for socket to become ready for writing\n/);
        my $r = syswrite($self-&gt;{fh}, $buf, $len, $off);
        if (defined $r) {
            $len -= $r;
            $off += $r;
            last unless $len &gt; 0;
        }
        elsif ($! == EPIPE) {
            die(qq/Socket closed by remote server: $!\n/);
        }
        elsif ($! != EINTR) {
            if ($self-&gt;{fh}-&gt;can(&#039;errstr&#039;)){
                my $err = $self-&gt;{fh}-&gt;errstr();
                die (qq/Could not write to SSL socket: &#039;$err&#039;\n /);
            }
            else {
                die(qq/Could not write to socket: &#039;$!&#039;\n/);
            }

        }
    }
    return $off;
}

sub read {
    @_ == 2 || @_ == 3 || die(q/Usage: $handle-&gt;read(len [, allow_partial])/ . &quot;\n&quot;);
    my ($self, $len, $allow_partial) = @_;

    my $buf  = &#039;&#039;;
    my $got = length $self-&gt;{rbuf};

    if ($got) {
        my $take = ($got &lt; $len) ? $got : $len;
        $buf  = substr($self-&gt;{rbuf}, 0, $take, &#039;&#039;);
        $len -= $take;
    }

    # Ignore SIGPIPE because SSL reads can result in writes that might error.
    # See &quot;Expecting exactly the same behavior as plain sockets&quot; in
    # https://metacpan.org/dist/IO-Socket-SSL/view/lib/IO/Socket/SSL.pod#Common-Usage-Errors
    local $SIG{PIPE} = &#039;IGNORE&#039;;

    while ($len &gt; 0) {
        $self-&gt;can_read
          or die(q/Timed out while waiting for socket to become ready for reading/ . &quot;\n&quot;);
        my $r = sysread($self-&gt;{fh}, $buf, $len, length $buf);
        if (defined $r) {
            last unless $r;
            $len -= $r;
        }
        elsif ($! != EINTR) {
            if ($self-&gt;{fh}-&gt;can(&#039;errstr&#039;)){
                my $err = $self-&gt;{fh}-&gt;errstr();
                die (qq/Could not read from SSL socket: &#039;$err&#039;\n /);
            }
            else {
                die(qq/Could not read from socket: &#039;$!&#039;\n/);
            }
        }
    }
    if ($len &amp;&amp; !$allow_partial) {
        die(qq/Unexpected end of stream\n/);
    }
    return $buf;
}

sub readline {
    @_ == 1 || die(q/Usage: $handle-&gt;readline()/ . &quot;\n&quot;);
    my ($self) = @_;

    while () {
        if ($self-&gt;{rbuf} =~ s/\A ([^\x0D\x0A]* \x0D?\x0A)//x) {
            return $1;
        }
        if (length $self-&gt;{rbuf} &gt;= $self-&gt;{max_line_size}) {
            die(qq/Line size exceeds the maximum allowed size of $self-&gt;{max_line_size}\n/);
        }
        $self-&gt;can_read
          or die(qq/Timed out while waiting for socket to become ready for reading\n/);
        my $r = sysread($self-&gt;{fh}, $self-&gt;{rbuf}, BUFSIZE, length $self-&gt;{rbuf});
        if (defined $r) {
            last unless $r;
        }
        elsif ($! != EINTR) {
            if ($self-&gt;{fh}-&gt;can(&#039;errstr&#039;)){
                my $err = $self-&gt;{fh}-&gt;errstr();
                die (qq/Could not read from SSL socket: &#039;$err&#039;\n /);
            }
            else {
                die(qq/Could not read from socket: &#039;$!&#039;\n/);
            }
        }
    }
    die(qq/Unexpected end of stream while looking for line\n/);
}

sub read_header_lines {
    @_ == 1 || @_ == 2 || die(q/Usage: $handle-&gt;read_header_lines([headers])/ . &quot;\n&quot;);
    my ($self, $headers) = @_;
    $headers ||= {};
    my $lines   = 0;
    my $val;

    while () {
         my $line = $self-&gt;readline;

         if (++$lines &gt;= $self-&gt;{max_header_lines}) {
             die(qq/Header lines exceeds maximum number allowed of $self-&gt;{max_header_lines}\n/);
         }
         elsif ($line =~ /\A ([^\x00-\x1F\x7F:]+) : [\x09\x20]* ([^\x0D\x0A]*)/x) {
             my ($field_name) = lc $1;
             if (exists $headers-&gt;{$field_name}) {
                 for ($headers-&gt;{$field_name}) {
                     $_ = [$_] unless ref $_ eq &quot;ARRAY&quot;;
                     push @$_, $2;
                     $val = \$_-&gt;[-1];
                 }
             }
             else {
                 $val = \($headers-&gt;{$field_name} = $2);
             }
         }
         elsif ($line =~ /\A [\x09\x20]+ ([^\x0D\x0A]*)/x) {
             $val
               or die(qq/Unexpected header continuation line\n/);
             next unless length $1;
             $$val .= &#039; &#039; if length $$val;
             $$val .= $1;
         }
         elsif ($line =~ /\A \x0D?\x0A \z/x) {
            last;
         }
         else {
            die(q/Malformed header line: / . $Printable-&gt;($line) . &quot;\n&quot;);
         }
    }
    return $headers;
}

sub write_request {
    @_ == 2 || die(q/Usage: $handle-&gt;write_request(request)/ . &quot;\n&quot;);
    my($self, $request) = @_;
    $self-&gt;write_request_header(@{$request}{qw/method uri headers header_case/});
    $self-&gt;write_body($request) if $request-&gt;{cb};
    return;
}

# Standard request header names/case from HTTP/1.1 RFCs
my @rfc_request_headers = qw(
  Accept Accept-Charset Accept-Encoding Accept-Language Authorization
  Cache-Control Connection Content-Length Expect From Host
  If-Match If-Modified-Since If-None-Match If-Range If-Unmodified-Since
  Max-Forwards Pragma Proxy-Authorization Range Referer TE Trailer
  Transfer-Encoding Upgrade User-Agent Via
);

my @other_request_headers = qw(
  Content-Encoding Content-MD5 Content-Type Cookie DNT Date Origin
  X-XSS-Protection
);

my %HeaderCase = map { lc($_) =&gt; $_ } @rfc_request_headers, @other_request_headers;

# to avoid multiple small writes and hence nagle, you can pass the method line or anything else to
# combine writes.
sub write_header_lines {
    (@_ &gt;= 2 &amp;&amp; @_ &lt;= 4 &amp;&amp; ref $_[1] eq &#039;HASH&#039;) || die(q/Usage: $handle-&gt;write_header_lines(headers, [header_case, prefix])/ . &quot;\n&quot;);
    my($self, $headers, $header_case, $prefix_data) = @_;
    $header_case ||= {};

    my $buf = (defined $prefix_data ? $prefix_data : &#039;&#039;);

    # Per RFC, control fields should be listed first
    my %seen;
    for my $k ( qw/host cache-control expect max-forwards pragma range te/ ) {
        next unless exists $headers-&gt;{$k};
        $seen{$k}++;
        my $field_name = $HeaderCase{$k};
        my $v = $headers-&gt;{$k};
        for (ref $v eq &#039;ARRAY&#039; ? @$v : $v) {
            $_ = &#039;&#039; unless defined $_;
            $buf .= &quot;$field_name: $_\x0D\x0A&quot;;
        }
    }

    # Other headers sent in arbitrary order
    while (my ($k, $v) = each %$headers) {
        my $field_name = lc $k;
        next if $seen{$field_name};
        if (exists $HeaderCase{$field_name}) {
            $field_name = $HeaderCase{$field_name};
        }
        else {
            if (exists $header_case-&gt;{$field_name}) {
                $field_name = $header_case-&gt;{$field_name};
            }
            else {
                $field_name =~ s/\b(\w)/\u$1/g;
            }
            $field_name =~ /\A $Token+ \z/xo
              or die(q/Invalid HTTP header field name: / . $Printable-&gt;($field_name) . &quot;\n&quot;);
            $HeaderCase{lc $field_name} = $field_name;
        }
        for (ref $v eq &#039;ARRAY&#039; ? @$v : $v) {
            # unwrap a field value if pre-wrapped by user
            s/\x0D?\x0A\s+/ /g;
            die(qq/Invalid HTTP header field value ($field_name): / . $Printable-&gt;($_). &quot;\n&quot;)
              unless $_ eq &#039;&#039; || /\A $Field_Content \z/xo;
            $_ = &#039;&#039; unless defined $_;
            $buf .= &quot;$field_name: $_\x0D\x0A&quot;;
        }
    }
    $buf .= &quot;\x0D\x0A&quot;;
    return $self-&gt;write($buf);
}

# return value indicates whether message length was defined; this is generally
# true unless there was no content-length header and we just read until EOF.
# Other message length errors are thrown as exceptions
sub read_body {
    @_ == 3 || die(q/Usage: $handle-&gt;read_body(callback, response)/ . &quot;\n&quot;);
    my ($self, $cb, $response) = @_;
    my $te = $response-&gt;{headers}{&#039;transfer-encoding&#039;} || &#039;&#039;;
    my $chunked = grep { /chunked/i } ( ref $te eq &#039;ARRAY&#039; ? @$te : $te ) ;
    return $chunked
        ? $self-&gt;read_chunked_body($cb, $response)
        : $self-&gt;read_content_body($cb, $response);
}

sub write_body {
    @_ == 2 || die(q/Usage: $handle-&gt;write_body(request)/ . &quot;\n&quot;);
    my ($self, $request) = @_;
    if (exists $request-&gt;{headers}{&#039;content-length&#039;}) {
        return unless $request-&gt;{headers}{&#039;content-length&#039;};
        return $self-&gt;write_content_body($request);
    }
    else {
        return $self-&gt;write_chunked_body($request);
    }
}

sub read_content_body {
    @_ == 3 || @_ == 4 || die(q/Usage: $handle-&gt;read_content_body(callback, response, [read_length])/ . &quot;\n&quot;);
    my ($self, $cb, $response, $content_length) = @_;
    $content_length ||= $response-&gt;{headers}{&#039;content-length&#039;};

    if ( defined $content_length ) {
        my $len = $content_length;
        while ($len &gt; 0) {
            my $read = ($len &gt; BUFSIZE) ? BUFSIZE : $len;
            $cb-&gt;($self-&gt;read($read, 0), $response);
            $len -= $read;
        }
        return length($self-&gt;{rbuf}) == 0;
    }

    my $chunk;
    $cb-&gt;($chunk, $response) while length( $chunk = $self-&gt;read(BUFSIZE, 1) );

    return;
}

sub write_content_body {
    @_ == 2 || die(q/Usage: $handle-&gt;write_content_body(request)/ . &quot;\n&quot;);
    my ($self, $request) = @_;

    my ($len, $content_length) = (0, $request-&gt;{headers}{&#039;content-length&#039;});
    while () {
        my $data = $request-&gt;{cb}-&gt;();

        defined $data &amp;&amp; length $data
          or last;

        if ( $] ge &#039;5.008&#039; ) {
            utf8::downgrade($data, 1)
                or die(qq/Wide character in write_content()\n/);
        }

        $len += $self-&gt;write($data);
    }

    $len == $content_length
      or die(qq/Content-Length mismatch (got: $len expected: $content_length)\n/);

    return $len;
}

sub read_chunked_body {
    @_ == 3 || die(q/Usage: $handle-&gt;read_chunked_body(callback, $response)/ . &quot;\n&quot;);
    my ($self, $cb, $response) = @_;

    while () {
        my $head = $self-&gt;readline;

        $head =~ /\A ([A-Fa-f0-9]+)/x
          or die(q/Malformed chunk head: / . $Printable-&gt;($head) . &quot;\n&quot;);

        my $len = hex($1)
          or last;

        $self-&gt;read_content_body($cb, $response, $len);

        $self-&gt;read(2) eq &quot;\x0D\x0A&quot;
          or die(qq/Malformed chunk: missing CRLF after chunk data\n/);
    }
    $self-&gt;read_header_lines($response-&gt;{headers});
    return 1;
}

sub write_chunked_body {
    @_ == 2 || die(q/Usage: $handle-&gt;write_chunked_body(request)/ . &quot;\n&quot;);
    my ($self, $request) = @_;

    my $len = 0;
    while () {
        my $data = $request-&gt;{cb}-&gt;();

        defined $data &amp;&amp; length $data
          or last;

        if ( $] ge &#039;5.008&#039; ) {
            utf8::downgrade($data, 1)
                or die(qq/Wide character in write_chunked_body()\n/);
        }

        $len += length $data;

        my $chunk  = sprintf &#039;%X&#039;, length $data;
           $chunk .= &quot;\x0D\x0A&quot;;
           $chunk .= $data;
           $chunk .= &quot;\x0D\x0A&quot;;

        $self-&gt;write($chunk);
    }
    $self-&gt;write(&quot;0\x0D\x0A&quot;);
    if ( ref $request-&gt;{trailer_cb} eq &#039;CODE&#039; ) {
        $self-&gt;write_header_lines($request-&gt;{trailer_cb}-&gt;())
    }
    else {
        $self-&gt;write(&quot;\x0D\x0A&quot;);
    }
    return $len;
}

sub read_response_header {
    @_ == 1 || die(q/Usage: $handle-&gt;read_response_header()/ . &quot;\n&quot;);
    my ($self) = @_;

    my $line = $self-&gt;readline;

    $line =~ /\A (HTTP\/(0*\d+\.0*\d+)) [\x09\x20]+ ([0-9]{3}) (?: [\x09\x20]+ ([^\x0D\x0A]*) )? \x0D?\x0A/x
      or die(q/Malformed Status-Line: / . $Printable-&gt;($line). &quot;\n&quot;);

    my ($protocol, $version, $status, $reason) = ($1, $2, $3, $4);
    $reason = &quot;&quot; unless defined $reason;

    die (qq/Unsupported HTTP protocol: $protocol\n/)
        unless $version =~ /0*1\.0*[01]/;

    return {
        status       =&gt; $status,
        reason       =&gt; $reason,
        headers      =&gt; $self-&gt;read_header_lines,
        protocol     =&gt; $protocol,
    };
}

sub write_request_header {
    @_ == 5 || die(q/Usage: $handle-&gt;write_request_header(method, request_uri, headers, header_case)/ . &quot;\n&quot;);
    my ($self, $method, $request_uri, $headers, $header_case) = @_;

    return $self-&gt;write_header_lines($headers, $header_case, &quot;$method $request_uri HTTP/1.1\x0D\x0A&quot;);
}

sub _do_timeout {
    my ($self, $type, $timeout) = @_;
    $timeout = $self-&gt;{timeout}
        unless defined $timeout &amp;&amp; $timeout &gt;= 0;

    my $fd = fileno $self-&gt;{fh};
    defined $fd &amp;&amp; $fd &gt;= 0
      or die(qq/select(2): &#039;Bad file descriptor&#039;\n/);

    my $initial = time;
    my $pending = $timeout;
    my $nfound;

    vec(my $fdset = &#039;&#039;, $fd, 1) = 1;

    while () {
        $nfound = ($type eq &#039;read&#039;)
            ? select($fdset, undef, undef, $pending)
            : select(undef, $fdset, undef, $pending) ;
        if ($nfound == -1) {
            $! == EINTR
              or die(qq/select(2): &#039;$!&#039;\n/);
            redo if !$timeout || ($pending = $timeout - (time - $initial)) &gt; 0;
            $nfound = 0;
        }
        last;
    }
    $! = 0;
    return $nfound;
}

sub can_read {
    @_ == 1 || @_ == 2 || die(q/Usage: $handle-&gt;can_read([timeout])/ . &quot;\n&quot;);
    my $self = shift;
    if ( ref($self-&gt;{fh}) eq &#039;IO::Socket::SSL&#039; ) {
        return 1 if $self-&gt;{fh}-&gt;pending;
    }
    return $self-&gt;_do_timeout(&#039;read&#039;, @_)
}

sub can_write {
    @_ == 1 || @_ == 2 || die(q/Usage: $handle-&gt;can_write([timeout])/ . &quot;\n&quot;);
    my $self = shift;
    return $self-&gt;_do_timeout(&#039;write&#039;, @_)
}

sub _assert_ssl {
    my($ok, $reason) = HTTP::Tiny-&gt;can_ssl();
    die $reason unless $ok;
}

sub can_reuse {
    my ($self,$scheme,$host,$port,$peer) = @_;
    return 0 if
        $self-&gt;{pid} != $$
        || $self-&gt;{tid} != _get_tid()
        || length($self-&gt;{rbuf})
        || $scheme ne $self-&gt;{scheme}
        || $host ne $self-&gt;{host}
        || $port ne $self-&gt;{port}
        || $peer ne $self-&gt;{peer}
        || eval { $self-&gt;can_read(0) }
        || $@ ;
        return 1;
}

sub _find_CA {
    my $self = shift;

    my $ca_file = $self-&gt;{SSL_options}-&gt;{SSL_ca_file};

    if ( defined $ca_file ) {
        unless ( -r $ca_file ) {
            die qq/SSL_ca_file &#039;$ca_file&#039; not found or not readable\n/;
        }
        return ( SSL_ca_file =&gt; $ca_file );
    }

    # Return default_ca() parameters from IO::Socket::SSL. It looks for the
    # default bundle and directory from Net::SSLeay, handles $ENV{SSL_CERT_FILE}
    # and $ENV{SSL_CERT_DIR}, and finally fails over to Mozilla::CA
    #
    my %default_ca = IO::Socket::SSL::default_ca();
    return %default_ca if %default_ca;

    # If IO::Socket::SSL::default_ca() was unable to find a CA bundle, look for
    # one in well known locations as a last resort. Cert list copied from golang
    # src/crypto/x509/root_unix.go
    #
    foreach my $ca_bundle (
        &quot;/etc/ssl/certs/ca-certificates.crt&quot;,     # Debian/Ubuntu/Gentoo etc.
        &quot;/etc/pki/tls/certs/ca-bundle.crt&quot;,       # Fedora/RHEL
        &quot;/etc/ssl/ca-bundle.pem&quot;,                 # OpenSUSE
        &quot;/etc/openssl/certs/ca-certificates.crt&quot;, # NetBSD
        &quot;/etc/ssl/cert.pem&quot;,                      # OpenBSD
        &quot;/usr/local/share/certs/ca-root-nss.crt&quot;, # FreeBSD/DragonFly
        &quot;/etc/pki/tls/cacert.pem&quot;,                # OpenELEC
        &quot;/etc/certs/ca-certificates.crt&quot;,         # Solaris 11.2+
    ) {
        return ( SSL_ca_file =&gt; $ca_bundle ) if -e $ca_bundle;
    }

    die qq/Couldn&#039;t find a CA bundle with which to verify the SSL certificate.\n/
      . qq/Try installing one from your OS vendor, or Mozilla::CA from CPAN\n/;
}

# not for internal use; backcompat shim only
sub _find_CA_file {
    my $self = shift;
    my %res = $self-&gt;_find_CA();
    return $res{SSL_ca_file};
}

# for thread safety, we need to know thread id if threads are loaded
sub _get_tid {
    no warnings &#039;reserved&#039;; # for &#039;threads&#039;
    return threads-&gt;can(&quot;tid&quot;) ? threads-&gt;tid : 0;
}

sub _ssl_args {
    my ($self, $host) = @_;

    my %ssl_args;

    # This test reimplements IO::Socket::SSL::can_client_sni(), which wasn&#039;t
    # added until IO::Socket::SSL 1.84
    if ( Net::SSLeay::OPENSSL_VERSION_NUMBER() &gt;= 0x01000000 ) {
        $ssl_args{SSL_hostname} = $host,          # Sane SNI support
    }

    if ($self-&gt;{verify_SSL}) {
        $ssl_args{SSL_verifycn_scheme}  = &#039;http&#039;; # enable CN validation
        $ssl_args{SSL_verifycn_name}    = $host;  # set validation hostname
        $ssl_args{SSL_verify_mode}      = 0x01;   # enable cert validation

        %ssl_args = ( %ssl_args, $self-&gt;_find_CA );
    }
    else {
        $ssl_args{SSL_verifycn_scheme}  = &#039;none&#039;; # disable CN validation
        $ssl_args{SSL_verify_mode}      = 0x00;   # disable cert validation
    }

    # user options override settings from verify_SSL
    for my $k ( keys %{$self-&gt;{SSL_options}} ) {
        $ssl_args{$k} = $self-&gt;{SSL_options}{$k} if $k =~ m/^SSL_/;
    }

    return \%ssl_args;
}

1;


} # --- END HTTP::Tiny


{ # --- BEGIN Try::Tiny
package Try::Tiny; # git description: v0.31-2-gc8e3a47
use 5.006;
# ABSTRACT: Minimal try/catch with proper preservation of $@

our $VERSION = &#039;0.32&#039;;

use strict;
use warnings;

BEGIN   {
use Exporter 5.57 &#039;import&#039;;
our @EXPORT = our @EXPORT_OK = qw(try catch finally);

use Carp;
$Carp::Internal{+__PACKAGE__}++;

  if ($INC{&#039;Sub/Util.pm&#039;} &amp;&amp; defined &amp;Sub::Util::set_subname ) {
      *_subname = \&amp;Sub::Util::set_subname;
      *_HAS_SUBNAME = sub {1};
  }
  elsif( $INC{&#039;Sub/Name.pm&#039;} &amp;&amp; eval { Sub::Name-&gt;VERSION(0.08) } ){
      *_subname = \&amp;Sub::Name::subname;
      *_HAS_SUBNAME = sub {1};
  }
  else {
      *_HAS_SUBNAME = sub {0};
  }
}

my %_finally_guards;

# Need to prototype as @ not $$ because of the way Perl evaluates the prototype.
# Keeping it at $$ means you only ever get 1 sub because we need to eval in a list
# context &amp; not a scalar one

sub try (&amp;;@) {
  my ( $try, @code_refs ) = @_;

  # we need to save this here, the eval block will be in scalar context due
  # to $failed
  my $wantarray = wantarray;

  # work around perl bug by explicitly initializing these, due to the likelyhood
  # this will be used in global destruction (perl rt#119311)
  my ( $catch, @finally ) = ();

  # find labeled blocks in the argument list.
  # catch and finally tag the blocks by blessing a scalar reference to them.
  foreach my $code_ref (@code_refs) {

    if ( ref($code_ref) eq &#039;Try::Tiny::Catch&#039; ) {
      croak &#039;A try() may not be followed by multiple catch() blocks&#039;
        if $catch;
      $catch = ${$code_ref};
    } elsif ( ref($code_ref) eq &#039;Try::Tiny::Finally&#039; ) {
      push @finally, ${$code_ref};
    } else {
      croak(
        &#039;try() encountered an unexpected argument (&#039;
      . ( defined $code_ref ? $code_ref : &#039;undef&#039; )
      . &#039;) - perhaps a missing semi-colon before or&#039;
      );
    }
  }

  # FIXME consider using local $SIG{__DIE__} to accumulate all errors. It&#039;s
  # not perfect, but we could provide a list of additional errors for
  # $catch-&gt;();

  # name the blocks if we have Sub::Name installed
  _subname(caller().&#039;::try {...} &#039; =&gt; $try)
    if _HAS_SUBNAME;

  # set up scope guards to invoke the finally blocks at the end.
  # this should really be a function scope lexical variable instead of
  # file scope + local but that causes issues with perls &lt; 5.20 due to
  # perl rt#119311
  local $_finally_guards{guards} = [
    map Try::Tiny::ScopeGuard-&gt;_new($_),
    @finally
  ];

  # save the value of $@ so we can set $@ back to it in the beginning of the eval
  # and restore $@ after the eval finishes
  my $prev_error = $@;

  my ( @ret, $error );

  # failed will be true if the eval dies, because 1 will not be returned
  # from the eval body
  my $failed = not eval {
    $@ = $prev_error;

    # evaluate the try block in the correct context
    if ( $wantarray ) {
      @ret = $try-&gt;();
    } elsif ( defined $wantarray ) {
      $ret[0] = $try-&gt;();
    } else {
      $try-&gt;();
    };

    return 1; # properly set $failed to false
  };

  # preserve the current error and reset the original value of $@
  $error = $@;
  $@ = $prev_error;

  # at this point $failed contains a true value if the eval died, even if some
  # destructor overwrote $@ as the eval was unwinding.
  if ( $failed ) {
    # pass $error to the finally blocks
    push @$_, $error for @{$_finally_guards{guards}};

    # if we got an error, invoke the catch block.
    if ( $catch ) {
      # This works like given($error), but is backwards compatible and
      # sets $_ in the dynamic scope for the body of C&lt;$catch&gt;
      for ($error) {
        return $catch-&gt;($error);
      }

      # in case when() was used without an explicit return, the C&lt;for&gt;
      # loop will be aborted and there&#039;s no useful return value
    }

    return;
  } else {
    # no failure, $@ is back to what it was, everything is fine
    return $wantarray ? @ret : $ret[0];
  }
}

sub catch (&amp;;@) {
  my ( $block, @rest ) = @_;

  croak &#039;Useless bare catch()&#039; unless wantarray;

  _subname(caller().&#039;::catch {...} &#039; =&gt; $block)
    if _HAS_SUBNAME;
  return (
    bless(\$block, &#039;Try::Tiny::Catch&#039;),
    @rest,
  );
}

sub finally (&amp;;@) {
  my ( $block, @rest ) = @_;

  croak &#039;Useless bare finally()&#039; unless wantarray;

  _subname(caller().&#039;::finally {...} &#039; =&gt; $block)
    if _HAS_SUBNAME;
  return (
    bless(\$block, &#039;Try::Tiny::Finally&#039;),
    @rest,
  );
}

{
  package # hide from PAUSE
    Try::Tiny::ScopeGuard;

  use constant UNSTABLE_DOLLARAT =&gt; (&quot;$]&quot; &lt; &#039;5.013002&#039;) ? 1 : 0;

  sub _new {
    shift;
    bless [ @_ ];
  }

  sub DESTROY {
    my ($code, @args) = @{ $_[0] };

    local $@ if UNSTABLE_DOLLARAT;
    eval {
      $code-&gt;(@args);
      1;
    } or do {
      warn
        &quot;Execution of finally() block $code resulted in an exception, which &quot;
      . &#039;*CAN NOT BE PROPAGATED* due to fundamental limitations of Perl. &#039;
      . &#039;Your program will continue as if this event never took place. &#039;
      . &quot;Original exception text follows:\n\n&quot;
      . (defined $@ ? $@ : &#039;$@ left undefined...&#039;)
      . &quot;\n&quot;
      ;
    }
  }
}

1;

} # --- END Try::Tiny


{ # --- BEGIN cPstrict
package cPstrict;

#                                      Copyright 2024 WebPros International, LLC
#                                                           All rights reserved.
# copyright@cpanel.net                                         http://cpanel.net
# This code is subject to the cPanel license. Unauthorized copying is prohibited.

use strict;
use warnings;

=pod

This is importing the following to your namespace

    use strict;
    use warnings;
    use v5.30;

    use feature &#039;signatures&#039;;
    no warnings &#039;experimental::signatures&#039;;

=cut

sub import {
    if ( $] &lt; 5.030 ) {
        require Carp;
        Carp::confess(&quot;cPstrict is being loaded from an unsupported perl ($^X)&quot;);
    }

    # auto import strict and warnings to our caller

    warnings-&gt;import();
    strict-&gt;import();

    require feature;
    feature-&gt;import( &#039;:5.30&#039;, &#039;signatures&#039; );
    warnings-&gt;unimport(&#039;experimental::signatures&#039;);

    return;
}

1;

} # --- END cPstrict


{ # --- BEGIN Cpanel/OS/SysPerlBootstrap.pm
package Cpanel::OS::SysPerlBootstrap;


use strict;
use warnings;
no warnings &#039;once&#039;;

use constant CACHE_FILE        =&gt; &#039;/var/cpanel/caches/Cpanel-OS&#039;;
use constant CACHE_FILE_CUSTOM =&gt; CACHE_FILE . &#039;.custom&#039;;


sub get_os_info {
    my ($iknowwhatimdoing) = @_;
    die(&quot;Please use Cpanel::OS for your OS info needs&quot;) unless ( $iknowwhatimdoing &amp;&amp; $iknowwhatimdoing eq &#039;DO NOT USE THIS CALL&#039; );

    my @os_info = _read_os_info_cache();
    return @os_info if @os_info;

    my ( $distro, $major, $minor, $build ) = _read_os_release();

    if ( !defined $distro || !length $distro || !defined $major || !length $major || !defined $minor || !length $minor || !defined $build || !length $build ) {
        die sprintf( &quot;Could not determine OS info (distro: %s, major: %s, minor: %s, build: %s)\n&quot;, $distro // &#039;&#039;, $major // &#039;&#039;, $minor // &#039;&#039;, $build // &#039;&#039; );
    }

    _cache_os_info( $^O, $distro, $major, $minor, $build );

    return ( $^O, $distro, $major, $minor, $build );
}


sub _read_os_info_cache {

    my $cache_mtime = ( lstat CACHE_FILE )[9] or return;

    my $custom_os = readlink CACHE_FILE_CUSTOM;

    if ( !$custom_os ) {
        my $os_rel_mtime = ( stat(&quot;/etc/os-release&quot;) )[9];

        return if ( defined($os_rel_mtime) &amp;&amp; $cache_mtime &lt;= $os_rel_mtime );
    }

    return split qr{\|}, readlink(CACHE_FILE);
}


sub _read_os_release {

    open( my $os_fh, &quot;&lt;&quot;, &quot;/etc/os-release&quot; ) or die &quot;Could not open /etc/os-release for reading: $!\n&quot;;

    my ( $distro, $ver, $ver_id );
    while ( my $line = &lt;$os_fh&gt; ) {
        my ( $key, $value ) = split( qr/\s*=\s*/, $line, 2 );
        chomp $value;
        $value =~ s/\s.+//;
        $value =~ s/&quot;\z//;
        $value =~ s/^&quot;//;

        if ( !$distro &amp;&amp; $key eq &quot;ID&quot; ) {
            $distro = $value;
            $distro = &quot;cloudlinux&quot; if -e &#039;/etc/cloudlinux-release&#039;;    # Overcome CL10&#039;s lack of truth here.
        }
        elsif ( !$ver_id &amp;&amp; $key eq &quot;VERSION_ID&quot; ) {
            $ver_id = $value;
        }
        elsif ( !$ver &amp;&amp; $key eq &quot;VERSION&quot; ) {
            $ver = $value;
        }

        last if defined $distro &amp;&amp; length $distro &amp;&amp; defined $ver &amp;&amp; length $ver &amp;&amp; defined $ver_id &amp;&amp; length $ver_id;
    }
    close $os_fh;

    my ( $major, $minor, $build ) = split( qr/\./, $ver_id );
    return unless $distro;    # We have to at a minimum have a distro name. All hope is lost otherwise.

    unless ( defined $major &amp;&amp; length $major &amp;&amp; defined $minor &amp;&amp; length $minor &amp;&amp; defined $build &amp;&amp; length $build ) {
        my ( $ver_major, $ver_minor, $ver_build ) = split( qr/\./, $ver );
        $major //= $ver_major;
        $minor //= ( $ver_minor // 0 );
        $build //= ( $ver_build // 0 );
    }

    return ( $distro, $major, $minor, $build );
}


sub _cache_os_info {
    my ( $os, $distro, $major, $minor, $build ) = @_;
    $&gt; == 0 or return;

    mkdir &#039;/var/cpanel&#039;,        0711;
    mkdir &#039;/var/cpanel/caches&#039;, 0711;

    local $!;
    unlink CACHE_FILE;
    symlink &quot;$os|$distro|$major|$minor|$build&quot;, CACHE_FILE;

    return 1;
}

1;

} # --- END Cpanel/OS/SysPerlBootstrap.pm


{ # --- BEGIN Cpanel/ExceptionMessage.pm
package Cpanel::ExceptionMessage;


use strict;
# use Cpanel::Exception (); # perlpkg line 211

*load_perl_module = \&amp;Cpanel::Exception::load_perl_module;

1;

} # --- END Cpanel/ExceptionMessage.pm


{ # --- BEGIN Cpanel/Locale/Utils/Fallback.pm
package Cpanel::Locale::Utils::Fallback;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub interpolate_variables {
    my ( $str, @maketext_opts ) = @_;

    my $c = 1;
    my %h = map { $c++, $_ } @maketext_opts;
    $str =~ s{(\[(?:[^_]+,)?_([0-9])+\])}{$h{$2}}g;
    return $str;
}

1;

} # --- END Cpanel/Locale/Utils/Fallback.pm


{ # --- BEGIN Cpanel/ExceptionMessage/Raw.pm
package Cpanel::ExceptionMessage::Raw;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use base Cpanel::ExceptionMessage (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::ExceptionMessage); }

# use Cpanel::Locale::Utils::Fallback (); # perlpkg line 211

sub new {
    my ( $class, $str ) = @_;

    my $str_copy = $str;

    return bless( \$str_copy, $class );
}

sub to_string {
    my ($self) = @_;

    return $$self;
}

sub get_language_tag {
    return &#039;en&#039;;
}

BEGIN {
    *Cpanel::ExceptionMessage::Raw::convert_localized_to_raw = *Cpanel::Locale::Utils::Fallback::interpolate_variables;
    *Cpanel::ExceptionMessage::Raw::to_locale_string         = *Cpanel::ExceptionMessage::Raw::to_string;
    *Cpanel::ExceptionMessage::Raw::to_en_string             = *Cpanel::ExceptionMessage::Raw::to_string;
}
1;

} # --- END Cpanel/ExceptionMessage/Raw.pm


{ # --- BEGIN Cpanel/LoadModule/Utils.pm
package Cpanel::LoadModule::Utils;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub module_is_loaded {
    my $p = module_path( $_[0] );
    return 0 unless defined $p;

    return defined $INC{$p} ? 1 : 0;
}

sub module_path {
    my ($module_name) = @_;

    if ( defined $module_name &amp;&amp; length($module_name) ) {
        substr( $module_name, index( $module_name, &#039;::&#039; ), 2, &#039;/&#039; ) while index( $module_name, &#039;::&#039; ) &gt; -1;
        $module_name .= &#039;.pm&#039; unless substr( $module_name, -3 ) eq &#039;.pm&#039;;
    }

    return $module_name;
}

sub is_valid_module_name {
    return $_[0] =~ m/\A[A-Za-z_]\w*(?:(?:&#039;|::)\w+)*\z/ ? 1 : 0;
}

1;

} # --- END Cpanel/LoadModule/Utils.pm


{ # --- BEGIN Cpanel/ScalarUtil.pm
package Cpanel::ScalarUtil;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub blessed {
    return ref( $_[0] ) &amp;&amp; UNIVERSAL::isa( $_[0], &#039;UNIVERSAL&#039; ) || undef;
}

1;

} # --- END Cpanel/ScalarUtil.pm


{ # --- BEGIN Cpanel/Exception/CORE.pm
package Cpanel::Exception::CORE;


1;

package Cpanel::Exception;

use strict;


BEGIN {
    $INC{&#039;Cpanel/Exception.pm&#039;} = &#039;__BYPASSED__&#039;;
}

our $_SUPPRESS_STACK_TRACES = 0;

our $_EXCEPTION_MODULE_PREFIX = &#039;Cpanel::Exception&#039;;
our $IN_EXCEPTION_CREATION    = 0;

our $_suppressed_msg = &#039;__STACK_TRACE_SUPPRESSED__YOU_SHOULD_NEVER_SEE_THIS_MESSAGE__&#039;;

my $PACKAGE = &#039;Cpanel::Exception&#039;;
my $locale;

my @ID_CHARS = qw( a b c d e f g h j k m n p q r s t u v w x y z 2 3 4 5 6 7 8 9 );

my $ID_LENGTH = 6;


# use Cpanel::ExceptionMessage::Raw (); # perlpkg line 211
# use Cpanel::LoadModule::Utils     (); # perlpkg line 211

use constant _TRUE =&gt; 1;

use overload (
    &#039;&quot;&quot;&#039;     =&gt; \&amp;__spew,
    bool     =&gt; \&amp;_TRUE,
    fallback =&gt; 1,
);

BEGIN {
    die &quot;Cannot compile Cpanel::Exception::CORE&quot; if $INC{&#039;B/C.pm&#039;} &amp;&amp; $0 !~ m{cpkeyclt|cpsrvd\.so|t/large};
}

sub _init { return 1 }    # legacy


sub create {
    my ( $exception_type, @args ) = @_;

    _init();

    if ($IN_EXCEPTION_CREATION) {
        _load_cpanel_carp();
        die &#039;Cpanel::Carp&#039;-&gt;can(&#039;safe_longmess&#039;)-&gt;(&quot;Attempted to create a “$exception_type” exception with arguments “@args” while creating exception “$IN_EXCEPTION_CREATION-&gt;[0]” with arguments “@{$IN_EXCEPTION_CREATION-&gt;[1]}”.&quot;);
    }
    local $IN_EXCEPTION_CREATION = [ $exception_type, \@args ];

    if ( $exception_type !~ m/\A[A-Za-z0-9_]+(?:\:\:[A-Za-z0-9_]+)*\z/ ) {
        die &quot;Invalid exception type: $exception_type&quot;;
    }

    my $perl_class;
    if ( $exception_type eq __PACKAGE__ ) {
        $perl_class = $exception_type;
    }
    else {
        $perl_class = &quot;${_EXCEPTION_MODULE_PREFIX}::$exception_type&quot;;
    }

    _load_perl_module($perl_class) unless $perl_class-&gt;can(&#039;new&#039;);

    if ( $args[0] &amp;&amp; ref $args[0] eq &#039;ARRAY&#039; &amp;&amp; scalar @{ $args[0] } &gt; 1 ) {
        $args[0] = { @{ $args[0] } };
    }

    return $perl_class-&gt;new(@args);
}


sub create_raw {
    my ( $class, $msg, @extra_args ) = @_;

    _init();

    my $msg_obj = &#039;Cpanel::ExceptionMessage::Raw&#039;-&gt;new($msg);

    if ( $class =~ m&lt;\A(?:\Q${_EXCEPTION_MODULE_PREFIX}::\E)?Collection\z&gt; ) {
        die &quot;Use create(&#039;Collection&#039;, ..) to create a Cpanel::Exception::Collection object.&quot;;
    }

    return create( $class, $msg_obj, @extra_args );
}

sub _load_perl_module {
    my ($module) = @_;

    local ( $!, $@ );

    if ( !defined $module ) {
        die __PACKAGE__-&gt;new( &#039;Cpanel::ExceptionMessage::Raw&#039;-&gt;new(&quot;load_perl_module requires a module name.&quot;) );
    }

    return 1 if Cpanel::LoadModule::Utils::module_is_loaded($module);

    my $module_name = $module;
    $module_name =~ s{\.pm$}{};

    if ( !Cpanel::LoadModule::Utils::is_valid_module_name($module_name) ) {
        die __PACKAGE__-&gt;new( &#039;Cpanel::ExceptionMessage::Raw&#039;-&gt;new(&quot;load_perl_module requires a valid module name: &#039;$module_name&#039;.&quot;) );
    }

    {
        eval qq{use $module (); 1 }
          or die __PACKAGE__-&gt;new( &#039;Cpanel::ExceptionMessage::Raw&#039;-&gt;new(&quot;load_perl_module cannot load &#039;$module_name&#039;: $@&quot;) )
    }

    return 1;
}

sub new {
    my ( $class, @args ) = @_;

    @args = grep { defined } @args;

    my $self = {};

    bless $self, $class;

    if ( ref $args[-1] eq &#039;HASH&#039; ) {
        $self-&gt;{&#039;_metadata&#039;} = pop @args;
    }

    if ( defined $self-&gt;{&#039;_metadata&#039;}-&gt;{&#039;longmess&#039;} ) {
        $self-&gt;{&#039;_longmess&#039;} = &amp;{ $self-&gt;{&#039;_metadata&#039;}-&gt;{&#039;longmess&#039;} }($self)
          if $self-&gt;{&#039;_metadata&#039;}-&gt;{&#039;longmess&#039;};
    }
    elsif ($_SUPPRESS_STACK_TRACES) {
        $self-&gt;{&#039;_longmess&#039;} = $_suppressed_msg;
    }
    else {
        if ( !$INC{&#039;Carp.pm&#039;} ) { _load_carp(); }
        $self-&gt;{&#039;_longmess&#039;} = scalar do {

            local $Carp::CarpInternal{&#039;Cpanel::Exception&#039;} = 1;
            local $Carp::CarpInternal{$class} = 1;

            &#039;Carp&#039;-&gt;can(&#039;longmess&#039;)-&gt;();
        };
    }

    _init();

    $self-&gt;{&#039;_auxiliaries&#039;} = [];

    if ( UNIVERSAL::isa( $args[0], &#039;Cpanel::ExceptionMessage&#039; ) ) {
        $self-&gt;{&#039;_message&#039;} = shift @args;
    }
    else {
        my @mt_args;

        if ( @args &amp;&amp; !ref $args[0] ) {
            @mt_args = ( shift @args );

            if ( ref $args[0] eq &#039;ARRAY&#039; ) {
                push @mt_args, @{ $args[0] };
            }
        }
        else {

            $self-&gt;{&#039;_orig_mt_args&#039;} = $args[0];

            my $phrase = $self-&gt;_default_phrase( $args[0] );

            if ($phrase) {

                if ( ref $phrase ) {
                    @mt_args = $phrase-&gt;to_list();
                }

                else {
                    $self-&gt;{&#039;_message&#039;} = Cpanel::ExceptionMessage::Raw-&gt;new($phrase);
                    return $self;
                }
            }
        }

        if ( my @extras = grep { !ref } @args ) {
            die __PACKAGE__-&gt;new( &#039;Cpanel::ExceptionMessage::Raw&#039;-&gt;new(&quot;Extra scalar(s) passed to $PACKAGE! (@extras)&quot;) );
        }

        if ( !length $mt_args[0] ) {
            die __PACKAGE__-&gt;new( &#039;Cpanel::ExceptionMessage::Raw&#039;-&gt;new(&quot;No args passed to $PACKAGE constructor!&quot;) );
        }

        $self-&gt;{&#039;_mt_args&#039;} = \@mt_args;
    }

    return $self;
}


sub get_string {
    my ( $exc, $no_id_yn ) = @_;

    return get_string_no_id($exc) if $no_id_yn;

    return _get_string( $exc, &#039;to_string&#039; );
}


sub get_string_no_id {
    my ($exc) = @_;

    return _get_string( $exc, &#039;to_string_no_id&#039; );
}

sub _get_string {
    my ( $exc, $cp_exc_stringifier_name ) = @_;

    return $exc if !ref $exc;

    {
        local $@;
        my $ret = eval { $exc-&gt;$cp_exc_stringifier_name() };
        return $ret if defined $ret &amp;&amp; !$@ &amp;&amp; !ref $ret;
    }

    if ( ref $exc eq &#039;HASH&#039; &amp;&amp; $exc-&gt;{&#039;message&#039;} ) {
        return $exc-&gt;{&#039;message&#039;};
    }

    if ( $INC{&#039;Cpanel/YAML.pm&#039;} ) {
        local $@;
        my $ret = eval { &#039;Cpanel::YAML&#039;-&gt;can(&#039;Dump&#039;)-&gt;($exc); };
        return $ret if defined $ret &amp;&amp; !$@;
    }

    if ( $INC{&#039;Cpanel/JSON.pm&#039;} ) {
        local $@;
        my $ret = eval { &#039;Cpanel::JSON&#039;-&gt;can(&#039;Dump&#039;)-&gt;($exc); };
        return $ret if defined $ret &amp;&amp; !$@;
    }

    return $exc;
}


sub _create_id {

    srand();

    return join(
        q&lt;&gt;,
        map { $ID_CHARS[ int rand( 0 + @ID_CHARS ) ]; } ( 1 .. $ID_LENGTH ),
    );
}

sub get_stack_trace_suppressor {
    return Cpanel::Exception::_StackTraceSuppression-&gt;new();
}


sub set_id {
    my ( $self, $new_id ) = @_;
    $self-&gt;{&#039;_id&#039;} = $new_id;
    return $self;
}


sub id {
    my ($self) = @_;

    return $self-&gt;{&#039;_id&#039;} ||= _create_id();
}


sub set {
    my ( $self, $key ) = @_;

    $self-&gt;{&#039;_metadata&#039;}{$key} = $_[2];

    if ( exists $self-&gt;{&#039;_orig_mt_args&#039;} ) {
        my $phrase = $self-&gt;_default_phrase( $self-&gt;{&#039;_orig_mt_args&#039;} );

        if ($phrase) {
            if ( ref $phrase ) {
                $self-&gt;{&#039;_mt_args&#039;} = [ $phrase-&gt;to_list() ];
                undef $self-&gt;{&#039;_message&#039;};
            }
            else {
                $self-&gt;{&#039;_message&#039;} = Cpanel::ExceptionMessage::Raw-&gt;new($phrase);
            }
        }
    }

    return $self;
}


sub get {
    my ( $self, $key ) = @_;

    my $v = $self-&gt;{&#039;_metadata&#039;}{$key};

    if ( my $reftype = ref $v ) {
        local $@;
        if ( $reftype eq &#039;HASH&#039; ) {
            $v = { %{$v} };    # shallow copy
        }
        elsif ( $reftype eq &#039;ARRAY&#039; ) {
            $v = [ @{$v} ];    # shallow copy
        }
        elsif ( $reftype eq &#039;SCALAR&#039; ) {
            $v = \${$v};       # shallow copy
        }
        else {
            local ( $@, $! );
            require Cpanel::ScalarUtil;

            if ( $reftype ne &#039;GLOB&#039; &amp;&amp; !Cpanel::ScalarUtil::blessed($v) ) {

                warn if !eval {
                    _load_perl_module(&#039;Clone&#039;) if !$INC{&#039;Clone.pm&#039;};
                    $v = &#039;Clone&#039;-&gt;can(&#039;clone&#039;)-&gt;($v);
                };
            }
        }
    }

    return $v;
}


sub get_all_metadata {
    my $self = shift;
    my %metadata_copy;
    for my $key ( keys %{ $self-&gt;{&#039;_metadata&#039;} } ) {
        $metadata_copy{$key} = $self-&gt;get($key);
    }
    return \%metadata_copy;
}

my $loaded_LocaleString;

sub _require_LocaleString {
    return $loaded_LocaleString ||= do {
        local $@;
        eval &#039;require Cpanel::LocaleString; 1;&#039; or die $@;    ## no critic qw(BuiltinFunctions::ProhibitStringyEval) -  # PPI NO PARSE - load on demand
        1;
    };
}

my $loaded_ExceptionMessage_Locale;

sub _require_ExceptionMessage_Locale {
    return $loaded_ExceptionMessage_Locale ||= do {
        local $@;
        eval &#039;require Cpanel::ExceptionMessage::Locale; 1;&#039; or die $@;    ## no critic qw(BuiltinFunctions::ProhibitStringyEval) - # PPI NO PARSE - load on demand
        1;
    };
}

sub _default_phrase {
    _require_LocaleString();
    return &#039;Cpanel::LocaleString&#039;-&gt;new( &#039;An unknown error in the “[_1]” package has occurred.&#039;, scalar ref $_[0] );    # PPI NO PARSE - loaded above
}


sub longmess {
    my ($self) = @_;

    return &#039;&#039;           if $self-&gt;{&#039;_longmess&#039;} eq $_suppressed_msg;
    _load_cpanel_carp() if !$INC{&#039;Cpanel/Carp.pm&#039;};
    return Cpanel::Carp::sanitize_longmess( $self-&gt;{&#039;_longmess&#039;} );
}


sub to_string {
    my ($self) = @_;

    return _apply_id_prefix( $self-&gt;id(), $self-&gt;to_string_no_id() );
}

sub to_string_no_id {
    my ($self) = @_;

    my $string = $self-&gt;to_locale_string_no_id();

    if ( $self-&gt;_message()-&gt;get_language_tag() ne &#039;en&#039; ) {
        my $en_string = $self-&gt;to_en_string_no_id();
        $string .= &quot;\n$en_string&quot; if ( $en_string ne $string );
    }

    return $string;
}

sub _apply_id_prefix {
    my ( $id, $msg ) = @_;

    return sprintf &quot;(XID %s) %s&quot;, $id, $msg;
}


sub to_en_string {
    my ($self) = @_;

    return _apply_id_prefix( $self-&gt;id(), $self-&gt;to_en_string_no_id() );
}

sub to_en_string_no_id {
    my ($self) = @_;

    return $self-&gt;_message()-&gt;to_en_string() . $self-&gt;_stringify_auxiliaries(&#039;to_en_string&#039;);
}


sub to_locale_string {
    my ($self) = @_;

    return _apply_id_prefix( $self-&gt;id(), $self-&gt;to_locale_string_no_id() );
}

sub to_locale_string_no_id {
    my ($self) = @_;

    return $self-&gt;_message()-&gt;to_locale_string() . $self-&gt;_stringify_auxiliaries(&#039;to_locale_string&#039;);
}


sub add_auxiliary_exception {
    my ( $self, $aux ) = @_;

    return push @{ $self-&gt;{&#039;_auxiliaries&#039;} }, $aux;
}


sub get_auxiliary_exceptions {
    my ($self) = @_;

    die &#039;List context only!&#039; if !wantarray;    #Can’t use Cpanel::Context

    return @{ $self-&gt;{&#039;_auxiliaries&#039;} };
}

sub __spew {
    my ($self) = @_;

    return $self-&gt;_spew();
}

sub _spew {
    my ($self) = @_;

    return ref($self) . &#039;/&#039; . join &quot;\n&quot;, $self-&gt;to_string() || &#039;&lt;no message&gt;&#039;, $self-&gt;longmess() || ();
}

sub _stringify_auxiliaries {
    my ( $self, $method ) = @_;

    my @lines;

    if ( @{ $self-&gt;{&#039;_auxiliaries&#039;} } ) {

        local $@;

        _require_LocaleString();

        my $intro = &#039;Cpanel::LocaleString&#039;-&gt;new( &#039;The following additional [numerate,_1,error,errors] occurred:&#039;, 0 + @{ $self-&gt;{&#039;_auxiliaries&#039;} } );    # PPI NO PARSE - required above

        if ( $method eq &#039;to_locale_string&#039; ) {
            push @lines, _locale()-&gt;makevar( $intro-&gt;to_list() );
        }
        elsif ( $method eq &#039;to_en_string&#039; ) {
            push @lines, _locale()-&gt;makethis_base( $intro-&gt;to_list() );
        }
        else {
            die &quot;Invalid method: $method&quot;;
        }

        push @lines, map { UNIVERSAL::isa( $_, __PACKAGE__ ) ? $_-&gt;$method() : $_ } @{ $self-&gt;{&#039;_auxiliaries&#039;} };
    }

    return join q&lt;&gt;, map { &quot;\n$_&quot; } @lines;
}

*TO_JSON = \&amp;to_string;

sub _locale {
    return $locale ||= do {

        local $@;

        eval &#039;require Cpanel::Locale; 1;&#039; or die $@;

        &#039;Cpanel::Locale&#039;-&gt;get_handle();    # hide from perlcc
    };
}

sub _reset_locale {
    return undef $locale;
}

sub _load_carp {
    if ( !$INC{&#039;Carp.pm&#039;} ) {

        local $@;
        eval &#039;require Carp; 1;&#039; or die $@;    ## no critic qw(BuiltinFunctions::ProhibitStringyEval) -- hide from perlcc
    }

    return;
}

sub _load_cpanel_carp {
    if ( !$INC{&#039;Cpanel/Carp.pm&#039;} ) {

        local $@;
        eval &#039;require Cpanel::Carp; 1;&#039; or die $@;    ## no critic qw(BuiltinFunctions::ProhibitStringyEval) -- hide from perlcc
    }

    return;
}

sub _message {
    my ($self) = @_;

    return $self-&gt;{&#039;_message&#039;} if $self-&gt;{&#039;_message&#039;};

    local $!;
    if ($Cpanel::Exception::LOCALIZE_STRINGS) {    # the default
        _require_ExceptionMessage_Locale();
        return ( $self-&gt;{&#039;_message&#039;} ||= &#039;Cpanel::ExceptionMessage::Locale&#039;-&gt;new( @{ $self-&gt;{&#039;_mt_args&#039;} } ) );    # PPI NO PARSE - required above
    }

    return ( $self-&gt;{&#039;_message&#039;} ||= Cpanel::ExceptionMessage::Raw-&gt;new( Cpanel::ExceptionMessage::Raw::convert_localized_to_raw( @{ $self-&gt;{&#039;_mt_args&#039;} } ) ) );
}


package Cpanel::Exception::_StackTraceSuppression;

sub new {
    my ($class) = @_;

    $Cpanel::Exception::_SUPPRESS_STACK_TRACES++;

    return bless [], $class;
}

sub DESTROY {
    $Cpanel::Exception::_SUPPRESS_STACK_TRACES--;
    return;
}

1;

} # --- END Cpanel/Exception/CORE.pm


{ # --- BEGIN Cpanel/LoadModule.pm
package Cpanel::LoadModule;


use strict;

# use Cpanel::Exception         (); # perlpkg line 211
# use Cpanel::LoadModule::Utils (); # perlpkg line 211

my $logger;
my $has_perl_dir = 0;


sub _logger_warn {
    my ( $msg, $fail_ok ) = @_;

    return if $fail_ok &amp;&amp; $ENV{&#039;CPANEL_BASE_INSTALL&#039;} &amp;&amp; index( $^X, &#039;/usr/local/cpanel&#039; ) == -1;

    if ( $INC{&#039;Cpanel/Logger.pm&#039;} ) {
        $logger ||= &#039;Cpanel::Logger&#039;-&gt;new();
        $logger-&gt;warn($msg);
    }
    return warn $msg;
}


sub _reset_has_perl_dir {
    $has_perl_dir = 0;
    return;
}

sub load_perl_module {    ## no critic qw(Subroutines::RequireArgUnpacking)
    if ( -1 != index( $_[0], q&lt;&#039;&gt; ) ) {
        die Cpanel::Exception::create_raw( &#039;InvalidParameter&#039;, &quot;Module names with single-quotes are prohibited. ($_[0])&quot; );
    }

    return $_[0] if Cpanel::LoadModule::Utils::module_is_loaded( $_[0] );

    my ( $mod, @LIST ) = @_;

    local ( $!, $@ );

    if ( !is_valid_module_name($mod) ) {
        die Cpanel::Exception::create( &#039;InvalidParameter&#039;, &#039;“[_1]” is not a valid name for a Perl module.&#039;, [$mod] );
    }

    my $args_str;
    if (@LIST) {
        $args_str = join &#039;,&#039;, map {
            die &quot;Only scalar arguments allowed in LIST! (@LIST)&quot; if ref;
            _single_quote($_);
        } @LIST;
    }
    else {
        $args_str = q&lt;&gt;;
    }

    eval &quot;use $mod ($args_str);&quot;;    ## no critic qw(BuiltinFunctions::ProhibitStringyEval)

    if ($@) {
        die Cpanel::Exception::create( &#039;ModuleLoadError&#039;, [ module =&gt; $mod, error =&gt; $@ ] );
    }

    return $mod;
}


*module_is_loaded = *Cpanel::LoadModule::Utils::module_is_loaded;


*is_valid_module_name = *Cpanel::LoadModule::Utils::is_valid_module_name;


sub loadmodule {
    return 1 if cpanel_namespace_module_is_loaded( $_[0] );

    return _modloader( $_[0] );
}


sub lazy_load_module {
    my $mod = shift;

    my $mod_path = $mod;
    $mod_path =~ s{::}{/}g;
    if ( exists $INC{ $mod_path . &#039;.pm&#039; } ) {
        return;
    }

    if ( !is_valid_module_name($mod) ) {
        _logger_warn(&quot;Cpanel::LoadModule: Invalid module name ($mod)&quot;);
        return;
    }

    eval &quot;use $mod ();&quot;;

    if ($@) {
        delete $INC{ $mod_path . &#039;.pm&#039; };
        _logger_warn( &quot;Cpanel::LoadModule:: Failed to load module $mod - $@&quot;, 1 );
        return;
    }

    return 1;
}


sub cpanel_namespace_module_is_loaded {
    my ($modpart) = @_;
    $modpart =~ s{::}{/}g;
    return exists $INC{&quot;Cpanel/$modpart.pm&quot;} ? 1 : 0;
}

sub _modloader {
    my $module = shift;
    if ( !$module ) {
        _logger_warn(&quot;Empty module name passed to modloader&quot;);
        return;
    }
    if ( !is_valid_module_name($module) ) {
        _logger_warn(&quot;Invalid module name ($module) passed to modloader&quot;);
        return;
    }

    eval qq[ use Cpanel::${module}; Cpanel::${module}::${module}_init() if &quot;Cpanel::${module}&quot;-&gt;can(&quot;${module}_init&quot;); ];    # PPI USE OK - This looks like usage of the Cpanel module and it&#039;s not.

    if ($@) {
        _logger_warn(&quot;Error loading module $module - $@&quot;);
        return;
    }

    return 1;
}

sub _single_quote {
    local ($_) = $_[0];
    s/([\\&#039;])/\\$1/g;
    return qq(&#039;$_&#039;);
}


1;

} # --- END Cpanel/LoadModule.pm


{ # --- BEGIN Cpanel/OS.pm
package Cpanel::OS;


use cPstrict;
no warnings &#039;once&#039;;

use Carp                         ();
# use Cpanel::OS::SysPerlBootstrap (); # perlpkg line 211
# use Cpanel::LoadModule           (); # perlpkg line 211

our $VERSION = &#039;2.0&#039;;

sub _new_instance ( $os, $distro, $major, $minor, $build ) {
    my $distro_class = &#039;Cpanel::OS::&#039; . ucfirst($distro) . $major;

    my $fallback_to_linux;
    if ( $INC{&#039;Cpanel/OS/All.pm&#039;} ) {

        $fallback_to_linux = 1 unless $distro_class-&gt;can(&#039;is_supported&#039;);
    }
    else {
        $fallback_to_linux = 1 unless eval &quot;require $distro_class; 1&quot;;    ## no critic qw(ProhibitStringyEval) -- This is how we do a runtime load here.
    }

    if ($fallback_to_linux) {
        require Cpanel::OS::Linux;                                        # PPI USE OK -- used just after
        $distro_class = q[Cpanel::OS::Linux];                             # unsupported distro

        $os //= q[Unknown];
    }

    my $self = bless {
        os     =&gt; $os,
        distro =&gt; $distro,
        major  =&gt; $major,
        minor  =&gt; $minor,
        build  =&gt; $build,
    }, $distro_class;

    return $self;
}

my $instance;

sub clear_cache {
    $INC{&#039;Test/Cpanel/Policy.pm&#039;} or Carp::croak(&quot;This interface is only for unit testing&quot;);
    undef $instance;

    return;
}

sub clear_cache_after_cloudlinux_update {
    undef $instance;
    return;
}

sub _instance {    ## no critic(RequireArgUnpacking) - Most of the time we do not need to process args.
    return $instance if $instance;

    Carp::croak(&quot;Cpanel::OS may not be called during cPanel binary compilation&quot;) if $INC{&#039;B/C.pm&#039;};

    my ( $os, $distro, $major, $minor, $build ) = @_;
    if ( !length $build ) {
        ( $os, $distro, $major, $minor, $build ) = Cpanel::OS::SysPerlBootstrap::get_os_info(&#039;DO NOT USE THIS CALL&#039;);
    }

    return $instance = _new_instance( $os, $distro, $major, $minor, $build );
}

sub flush_disk_caches {
    local $!;

    return 0 if readlink Cpanel::OS::SysPerlBootstrap::CACHE_FILE_CUSTOM;
    unlink Cpanel::OS::SysPerlBootstrap::CACHE_FILE;

    return 1;
}


sub distro { return _instance()-&gt;{&#039;distro&#039;} }
sub major  { return _instance()-&gt;{&#039;major&#039;} }
sub minor  { return _instance()-&gt;{&#039;minor&#039;} }
sub build  { return _instance()-&gt;{&#039;build&#039;} }

my %methods;

BEGIN {

    %methods = map { $_ =&gt; 0 } (
        &#039;is_supported&#039;,                       # This OS is supported by cPanel and not a virtual class (these exist!).
        &#039;at_eol&#039;,                             # When true, this release is the end of the line for cPanel on this OS; future major releases will not support or even recognize this distro.
        &#039;eol_advice&#039;,                         # Additional information provided to updatenow blockers when the customer tries to upgrade on a removed distro.
        &#039;support_needs_minor_at_least_at&#039;,    # miniimum minor version we support for this distro (optional
        &#039;is_experimental&#039;,                    # Defines if this distro is in experimental state or not.
        &#039;experimental_url&#039;,                   # Provides a link to information about the experimental state if it&#039;s currently that way.
        &#039;arch&#039;,                               # Somewhat of an unnecessary variable as all of our distros are set to x86_64.
        &#039;service_manager&#039;,                    # Does this distro use systemd or initd to manage services?
        &#039;is_systemd&#039;,                         # Easy boolean helper we use in most places to determine if the local system uses systemd.
        &#039;base_distro&#039;,                        # What is the root distro this distro is derived from? rhel/debian
        &#039;pretty_distro&#039;,                      # What is the preferred stylization of the distro name when being displayed for a user?
        &#039;display_name&#039;,                       # Example: Centos v7.9.2009
        &#039;display_name_lite&#039;,                  # Example: centos 7
        &#039;release_codename&#039;,                   # Example: focal, jammy (Ubuntu specific)
        &#039;cpanalytics_cpos&#039;,                   # How should we present data regarding the OS to Google Analytics?
        &#039;binary_sync_source&#039;,                 # Provides the string corresponding to the binary sync source directory.

        &#039;nobody&#039;,                             # name of the user used for nobody
        &#039;nogroup&#039;,                            # name of the group used for nobody / nogroup

        &#039;etc_shadow_groups&#039;,                  # group name that owns /etc/shadow
        &#039;etc_shadow_perms&#039;,                   # expected permissions for /etc/shadow

        &#039;sudoers&#039;,                            # name of the group used for sudo (by sudoers)
        &#039;has_wheel_group&#039;,                    # flag for whether wheel group is needed by sudo

        &#039;default_uid_min&#039;,                    # default value from /etc/login.defs
        &#039;default_gid_min&#039;,                    # default value from /etc/login.defs
        &#039;default_sys_uid_min&#039;,                # default value from /etc/login.defs
        &#039;default_sys_gid_min&#039;,                # default value from /etc/login.defs

        &#039;has_tcp_wrappers&#039;,                   # The distro supports TPC wrappers.

        &#039;setup_tz_method&#039;,                    # what method to use to setup a timezone
        &#039;is_cloudlinux&#039;,                      # is it a CloudLinux based distro? boolean

        &#039;can_be_elevated&#039;,                    # ELevate supports current OS as a source
        &#039;can_elevate_to&#039;,                     # ELevate can directly convert the current OS to these other OSes listed in the arrayref

        &#039;rsyslog_triggered_by_socket&#039;,        # Is rsyslog triggered by syslog.socket

        &#039;rsync_old_args&#039;,                           # If needed, the args to make rsync behave as it did prior to CVE-2022-29154
        &#039;crypto_policy_needs_sha1&#039;,                 # This distro/version needs to have SHA1 added to its crypto policies
        &#039;crypto_policy_os_provides_sha1_module&#039;,    # This distro actually has the subpolicy module to enable SHA-1; otherwise, we need to supply it
        &#039;lsof_needs_prlimit&#039;,                       # Does lsof on this distro need to be invoked via prlimit to constrain the file descriptor limits

        &#039;has_quota_support_for_xfs&#039;,                # Does this distro support xfs quota?
        &#039;program_to_apply_kernel_args&#039;,             # What program do we need to run to ensure that kernels are booted with updated args?
        &#039;has_cloudlinux_enhanced_quotas&#039;,           # Cloud linux does fancy things with quota we need to know about.
        &#039;who_wins_if_soft_gt_hard&#039;,                 # If we try to set a soft quota higher than a hard quota, which value wins?
        &#039;quota_packages_conditional&#039;,               # Hashref of needed kernel package dependencies not encoded in the upstream distro in order for quotas to work

        &#039;bin_grub_mkconfig&#039;,                        # path to sbin/grub2-mkconfig

        &#039;binary_locations&#039;,                         # paths to Cpanel::Binaries entries for this distro

        &#039;outdated_services_check&#039;,                  # which method to use to check outdated services?
        &#039;outdated_processes_check&#039;,                 # which method to use to check outdated processes?
        &#039;check_reboot_method&#039;,                      # which method to use to check if we need to reboot

        &#039;dns_supported&#039;,                            # Provides a list of dns servers supported on this platform.
        &#039;dns_named_basedir&#039;,                        # The path to the bind nameserver files.
        &#039;dns_named_conf&#039;,                           # /etc/named.conf
        &#039;dns_named_log&#039;,                            # What dir named logs are stored (/var/log/named)
        &#039;var_named_permissions&#039;,                    # Permissions data for /var/named

        &#039;ssh_supported_algorithms&#039;,                 # list of supported ssh algo [ordered by preference]

        &#039;openssl_minimum_supported_version&#039;,        # minimum openssl version to run
        &#039;openssl_escapes_subjects&#039;,                 # On generated certs, openssl started escaping subject lines at some point...


        &#039;unsupported_db_versions&#039;,                 # What DB versions does this distro NOT support.
        &#039;db_package_manager_key_params&#039;,           # Hashref describing what to do to ensure keys are in place for DBMSes installed from a 3rdparty repo
        &#039;db_disable_auth_socket&#039;,                  # Hashref of values needed to disable auth_socket for databases.
        &#039;db_needs_preseed&#039;,                        # Does the DB need to do a preseed on install?
        &#039;db_additional_conf_files&#039;,                # Any conf files that need to be symlinked.
        &#039;db_mariadb_default_conf_file&#039;,            # The default conf file for mariadb, only set if it is not /etc/my.cnf
        &#039;db_mariadb_start_file&#039;,                   # The startup script used by systemd for mariadb
        &#039;mysql_versions_use_repo_template&#039;,        # Which MySQL versions use mysql_repo_template.
        &#039;mariadb_versions_use_repo_template&#039;,      # Which MariaDB versions use mariadb_repo_template.
        &#039;mysql_repo_template&#039;,                     # What goes in the repo file to download mysql packages.
        &#039;mariadb_repo_template&#039;,                   # What goes in the repo file to download mariadb packages.
        &#039;mariadb_minimum_supported_version&#039;,       # Minimum version of MariaDB supported
        &#039;mariadb_packages&#039;,                        # List of packages needed to install MariaDB.
        &#039;known_mariadb_deps&#039;,                      # List of dependencies needed for MariaDB installation.
        &#039;mariadb_incompatible_packages&#039;,           # List of packages that are not compatible with MariaDB.
        &#039;mysql_community_packages&#039;,                # Which MySQL packages need to be installed on this distro?
        &#039;mysql_dependencies&#039;,                      # Which distro packages need to be installed for MySQL to be happy?
        &#039;mysql_incompatible&#039;,                      # Which mysql packages need to be blocked as incompatible with cPanel packages on this distro?
        &#039;mariadb_default_version&#039;,                 # Default MariaDB version to use
        &#039;supports_postgresql&#039;,                     # Do we support PostgreSQL on this distro?
        &#039;postgresql_minimum_supported_version&#039;,    # What is the minimum versions of PostgreSQL supported on this distro?
        &#039;postgresql_packages&#039;,                     # What packages do we need to install?
        &#039;postgresql_service_aliases&#039;,              # What aliases, if any, of the service name might we expect to find PostgreSQL using?
        &#039;postgresql_initdb_commands&#039;,              # Which commands do we run to make PostgreSQL initialize its DB storage area?

        &#039;cpsc_from_bare_repo_url&#039;,                   # Where can we download the repo file from? (needs to be over https)
        &#039;cpsc_from_bare_repo_path&#039;,                  # ... And where should we put it when we download it?
        &#039;cpsc_from_bare_repo_key_url&#039;,
        &#039;ea4_install_repo_from_package&#039;,             # Does an RPM provide an EA4 repo?
        &#039;ea4_from_pkg_url&#039;,                          # If we&#039;re installing the repo from RPM, where do we get it from?
        &#039;ea4_from_pkg_reponame&#039;,                     # ... And what will the repo be called when we install it?
        &#039;ea4_install_bare_repo&#039;,                     # Do we download a bare repo file?
        &#039;ea4_from_bare_repo_url&#039;,                    # Where can we download the repo file from? (needs to be over https)
        &#039;ea4_from_bare_repo_path&#039;,                   # ... And where should we put it when we download it?
        &#039;ea4tooling_all&#039;,                            # LIST - What are the packages to install which provide ea4 tooling on all server types?
        &#039;ea4tooling&#039;,                                # LIST - What ea4 tooling packages do we install on full cpanel servers?
        &#039;ea4tooling_dnsonly&#039;,                        # LIST - What additional packages do we need for dnsonly? &lt;&lt; FACT CHECK
        &#039;ea4_modern_openssl&#039;,                        # Which openssl should be used on this platform to get the L&amp;G Stuff? EA4 provides one in the event the distro&#039;s version is insufficient.
        &#039;ea4_conflicting_apache_distro_packages&#039;,    # Conflicting packages that Cpanel::EA4::MigrateBlocker checks for
        &#039;ea4_install_from_profile_enforce_packages&#039;,

        &#039;package_manager&#039;,                           # which package manager does the distro use? ( yum/dnf/apt)
        &#039;package_manager_module&#039;,                    # Cpanel::whatever::$package_manager_module::... ( Yum or Apt )
        &#039;package_repositories&#039;,                      # what additional repos need to be installed and enabled to install needed software?
        &#039;package_release_distro_tag&#039;,                # the postfix extension used for the packages: ~el6, ~el7, ~el8, ~el9, ~u20, ~u22
        &#039;system_exclude_rules&#039;,                      # On yum based systems, how what will we block the main distro from installing
        &#039;kernel_package_pattern&#039;,                    # What are the kernal packages named so we can sometimes block them when updating.
        &#039;check_kernel_version_method&#039;,               # What method to use to check the kernel version
        &#039;stock_kernel_version_regex&#039;,                # Regular expression used to determine whether the version string returned for the kernel matches what the distro would return with a stock kernel.
        &#039;kernel_supports_fs_protected_regular&#039;,      # Does fs.protected_regular a valid settings
        &#039;packages_required&#039;,                         # Which packages should /scripts/sysup assure are present on this system? ( provided during fresh install )
        &#039;packages_supplemental&#039;,                     # Which packages should /scripts/sysup assure are present on this system? ( provided AFTER fresh install )
        &#039;packages_supplemental_epel&#039;,                # Packages we want to install from epel if it is available to us.
        &#039;is_apt_based&#039;,                              # Does this system use apt (and therefore deb packages) for package management?
        &#039;is_yum_based&#039;,                              # Does this system use a yum or a yum derivative (dnf)
        &#039;is_rpm_based&#039;,                              # Does this system do its package management with rpms?
        &#039;system_package_providing_perl&#039;,             # Name of the package providing system Perl
        &#039;retry_rpm_cmd_no_tty_hack&#039;,                 # Hack: retry RPM comand when no TTY
        &#039;can_clean_plugins_repo&#039;,                    # Can we clean the &#039;plugins&#039; repo
        &#039;rpm_versions_system&#039;,                       # Which rpm_versions_system is currently used
        &#039;packages_arch&#039;,                             # Default architecture used by the rpm.versions system
        &#039;package_ImageMagick_Devel&#039;,                 # Name of the imagemagick devel package
        &#039;package_MySQL_Shell&#039;,                       # Name of the mysql-shell package (installed on demand)
        &#039;package_crond&#039;,                             # Name of the package providing the cron daemon
        &#039;plugins_repo_url&#039;,                          # URL to .repo / .list for cpanel-plugins
        &#039;repo_suffix&#039;,                               # Suffix for repo files, such as .repo or .list
        &#039;repo_dir&#039;,                                  # Local directory path where system repo config files are stored for the package manager
        &#039;package_descriptions&#039;,                      # Description fields used in manage plugins

        &#039;supports_cpanel_cloud_edition&#039;,             # Is cPCloud supported by this distro?

        &#039;supports_cpaddons&#039;,                         # Are cpaddons supported by this distro?
        &#039;supports_kernelcare&#039;,                       # Is Kernel Care available for this distro?
        &#039;supports_kernelcare_free&#039;,                  # Is Kernel Care Free available for this distro? &lt;&lt; FACT CHECK (Note: This check implicitly ensures the system is not running CloudLinux)
        &#039;supports_3rdparty_wpt&#039;,                     # Is WP Toolkit supported on this platform?
        &#039;supports_plugins_repo&#039;,                     # Is Cpanel::Plugins::Repo supported on this platform?
        &#039;supports_or_can_become_cloudlinux&#039;,         # Does the system can become/or is CloudLinux?
        &#039;can_become_cloudlinux&#039;,                     # Can the system become CloudLinux?
        &#039;supports_imunify_av&#039;,                       # Can install Imunify AV
        &#039;supports_imunify_av_plus&#039;,                  # Can install Imunify AV Plus
        &#039;supports_imunify_360&#039;,                      # Can install Imunify AV 360
        &#039;jetbackup_repo_pkg&#039;,                        # URL to the package we install to set up the JetBackup repo ( somewhere on http://repo.jetlicense.com/ )
        &#039;supports_letsencrypt_v2&#039;,
        &#039;supports_cpanel_analytics&#039;,
        &#039;supports_phpels&#039;,                           # Does this system support the TuxCare PHP ELS product?
        &#039;php_els_is_part_of_the_base_os&#039;,            # Is PHP ELS provided as part of the base OS? (e.g., CloudLinux)

        &#039;security_service&#039;,                          # What security service the distro is using? apparmor or selinux

        &#039;firewall&#039;,                                  # Which firewall is this distro using? (iptables / firewalld_nftables / ufw_iptables)
        &#039;firewall_module&#039;,                           # Which firewall module is used to manage it? (IpTables / NFTables)
        &#039;networking&#039;,                                # Not sure what this is for. Nothing uses it. ( networkscripts / netplan ) &lt;&lt; FACT CHECK
        &#039;iptables_ipv4_savefile&#039;,                    # Where to store iptables rules for IPv4
        &#039;iptables_ipv6_savefile&#039;,                    # Where to store iptables rules for IPv6
        &#039;nftables_config_file&#039;,                      # Where does nftables.conf live
        &#039;sysconfig_network&#039;,                         # sysconfig networ file to use, undef when unused.
        &#039;supports_hostaccess&#039;,                       # Does the system provide support for /etc/hosts.allow, etc.?
        &#039;supports_inetd&#039;,                            # Does the system provide support for inetd?
        &#039;supports_syslogd&#039;,                          # Does the system provide support for syslogd?
        &#039;check_ntpd_pid_method&#039;,                     # Method used to check the ntp daemon pid
        &#039;syslog_service_name&#039;,                       # Name of the service that handles syslog data, such as syslog, rsyslog, rsyslogd, etc, eg: `/usr/bin/systemctl show -p MainPID rsyslog.service`
        &#039;cron_bin_path&#039;,                             # Path to the cron daemon
        &#039;systemd_service_name_map&#039;,                  # Map of service names to possible counterparts, such as crond -&gt; cron
        &#039;prelink_config_path&#039;,                       # Where do the control knobs for prelinking live?
        &#039;pam_file_controlling_crypt_algo&#039;,           # Which file in /etc/pam.d manages the algorithm used to generate the passwd hash written to /etc/shadow for a user?
        &#039;user_crontab_dir&#039;,                          # Path to directory where user crontabs are stored by the crontab binary

        &#039;maillog_path&#039;,                              # Path to the mail.* syslog output as defined by the distro

        &#039;nat_server_buffer_connections&#039;,             # Number of connections_required to trigger a test failure in simultaneous connections for NAT detection.
        &#039;ssh_service_name&#039;,                          # The systemd service name for ssh

        &#039;tuxcare_els_php_install_url&#039;,               # Do we support Tuxcare on this system if so, this is the url to the install script.
    );
}

sub supported_methods {
    return sort keys %methods;                       ##no critic qw( ProhibitReturnSort ) - this will always be a list.
}

our $AUTOLOAD;                                       # keep &#039;use strict&#039; happy

sub AUTOLOAD {    ## no critic(RequireArgUnpacking) - Most of the time we do not need to process args.
    my $sub = $AUTOLOAD;
    $sub =~ s/.*:://;

    exists $methods{$sub} or Carp::croak(&quot;$sub is not a supported data variable for Cpanel::OS&quot;);

    my $i   = _instance();
    my $can = $i-&gt;can($sub) or Carp::croak( ref($i) . &quot; does not implement $sub&quot; );
    return $can-&gt;( $i, @_ );
}

sub list_contains_value ( $key, $value ) {
    my $array_ref = _instance()-&gt;$key;
    ref $array_ref eq &#039;ARRAY&#039; or Carp::croak(&quot;$key is not a list!&quot;);
    if ( !defined $value ) {
        return ( grep { !defined $_ } @$array_ref ) ? 1 : 0;
    }
    return ( grep { $value eq $_ } @$array_ref ) ? 1 : 0;
}

sub DESTROY { }    # This is a must for autoload modules.


sub assert_unreachable_on_ubuntu ( $msg = &quot;Ubuntu reached somewhere it shouldn&#039;t!&quot; ) {
    Carp::croak($msg) if Cpanel::OS::base_distro() eq &quot;debian&quot;;
    return;
}

sub lookup_pretty_distro ($target) {


    require Cpanel::OS::All;

    $target = ucfirst($target);
    my ( $name, $major ) = ( $target =~ m/^([A-Za-z]+)([0-9]+)$/ );
    return if !$name || !$major;
    return unless grep { $_-&gt;[0] eq $name &amp;&amp; $_-&gt;[1] == $major } Cpanel::OS::All::supported_distros();

    my $module = &quot;Cpanel::OS::$target&quot;;
    Cpanel::LoadModule::load_perl_module($module);

    my $pretty_name = $module-&gt;pretty_distro;
    return &quot;$pretty_name $major&quot;;
}

1;


} # --- END Cpanel/OS.pm


{ # --- BEGIN Cpanel/OS/Linux.pm
package Cpanel::OS::Linux;


use cPstrict;
no warnings &#039;once&#039;;
use Carp ();

# use Cpanel::OS (); # perlpkg line 211
# use parent Cpanel::OS (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS); }

use constant at_eol                          =&gt; 0;
use constant eol_advice                      =&gt; &#039;&#039;;
use constant is_supported                    =&gt; 0;        # Base OS class for all platforms we currently support.
use constant support_needs_minor_at_least_at =&gt; undef;    # by default no restriction on minor version

use constant is_experimental  =&gt; 0;                       # By default, no distros are experimental.
use constant experimental_url =&gt; &#039;&#039;;                      # ... and so no URL to document it.

use constant dns_supported                  =&gt; [qw{ powerdns }];    # All platforms support powerdns as it is our default.
use constant supports_3rdparty_wpt          =&gt; 1;                   # We support WPT on all platforms ATM.
use constant supports_plugins_repo          =&gt; 1;
use constant supports_imunify_av            =&gt; 1;
use constant supports_imunify_av_plus       =&gt; 1;
use constant supports_imunify_360           =&gt; 1;
use constant supports_letsencrypt_v2        =&gt; 1;
use constant supports_cpanel_analytics      =&gt; 1;
use constant supports_cpanel_cloud_edition  =&gt; 0;
use constant php_els_is_part_of_the_base_os =&gt; 0;
use constant cpsc_from_bare_repo_url        =&gt; undef;
use constant cpsc_from_bare_repo_path       =&gt; undef;
use constant cpsc_from_bare_repo_key_url    =&gt; undef;

use constant can_elevate_to =&gt; [];

use constant setup_tz_method =&gt; q[timedatectl];

use constant lsof_needs_prlimit =&gt; 0;

use constant nobody  =&gt; q[nobody];
use constant nogroup =&gt; q[nobody];

use constant default_uid_min     =&gt; 1_000;
use constant default_gid_min     =&gt; 1_000;
use constant default_sys_uid_min =&gt; 201;
use constant default_sys_gid_min =&gt; 201;

use constant dns_named_basedir =&gt; &#039;/var/named&#039;;
use constant dns_named_conf    =&gt; &#039;/etc/named.conf&#039;;
use constant dns_named_log     =&gt; &#039;/var/log/named&#039;;
use constant service_manager   =&gt; &#039;systemd&#039;;
use constant arch              =&gt; &#039;x86_64&#039;;
use constant maillog_path      =&gt; &#039;/var/log/maillog&#039;;

use constant supports_hostaccess =&gt; 0;

use constant rsyslog_triggered_by_socket =&gt; 0;

use constant packages_supplemental_epel =&gt; [];
use constant quota_packages_conditional =&gt; {};

use constant unsupported_db_versions =&gt; [];
use constant mariadb_repo_template   =&gt; &#039;&#039;;    # Not provided on ubuntu for instance.

use constant mariadb_minimum_supported_version =&gt; &#039;10.3&#039;;

use constant mariadb_default_version =&gt; &#039;10.11&#039;;

use constant postgresql_minimum_supported_version =&gt; undef;
use constant postgresql_packages                  =&gt; [];
use constant postgresql_service_aliases           =&gt; [];
use constant postgresql_initdb_commands           =&gt; [];
use constant openssl_minimum_supported_version    =&gt; &#039;1.0.2e&#039;;

use constant ea4_install_repo_from_package =&gt; 0;
use constant ea4_from_pkg_url              =&gt; undef;
use constant ea4_from_pkg_reponame         =&gt; undef;
use constant ea4_install_bare_repo         =&gt; 0;
use constant ea4_from_bare_repo_url        =&gt; undef;
use constant ea4_from_bare_repo_path       =&gt; undef;
use constant ea4_modern_openssl            =&gt; &#039;/usr/bin/openssl&#039;;

use constant ea4tooling_all =&gt; [qw{ ea-cpanel-tools ea-profiles-cpanel }];

sub ea4tooling_dnsonly   { return Carp::confess(&#039;ea4tooling_dnsonly unimplemented for this distro&#039;) }
sub ea4tooling           { return Carp::confess(&#039;ea4tooling unimplemented for this distro&#039;) }
sub system_exclude_rules { return Carp::confess(&#039;system_exclude_rules unimplemented for this distro&#039;) }
sub base_distro          { return Carp::confess(&#039;base_distro unimplemented for this distro&#039;) }

sub kernel_package_pattern { return Carp::confess(&#039;unimplemented for this distro&#039;) }
use constant check_kernel_version_method =&gt; q[grubby];
use constant stock_kernel_version_regex  =&gt; undef;

sub mysql_versions_use_repo_template   { return Carp::confess(&#039;unimplemented for this distro&#039;) }
sub mariadb_versions_use_repo_template { return Carp::confess(&#039;unimplemented for this distro&#039;) }

sub binary_sync_source { return Carp::confess(&#039;unimplemented for this distro&#039;) }

use constant package_repositories =&gt; [];

use constant system_package_providing_perl =&gt; &#039;perl&#039;;

use constant rpm_versions_system =&gt; &#039;centos&#039;;    # This has to do with where we publish rpms. Do not change or remove it.
use constant packages_arch       =&gt; &#039;x86_64&#039;;

use constant package_MySQL_Shell =&gt; q[mysql-shell];
use constant package_crond       =&gt; undef;

use constant retry_rpm_cmd_no_tty_hack =&gt; 1;

use constant check_ntpd_pid_method =&gt; &#039;pid_check_var_run_ntpd&#039;;    # how to check ntp daemon pid

use constant prelink_config_path =&gt; undef;

use constant pam_file_controlling_crypt_algo =&gt; undef;

use constant rsync_old_args   =&gt; [];
use constant ssh_service_name =&gt; &#039;sshd&#039;;

use constant iptables_ipv4_savefile =&gt; &#039;/etc/sysconfig/iptables&#039;;
use constant iptables_ipv6_savefile =&gt; &#039;/etc/sysconfig/ip6tables&#039;;
use constant nftables_config_file   =&gt; &#039;/etc/sysconfig/nftables.conf&#039;;
use constant sysconfig_network      =&gt; q[/etc/sysconfig/network];

use constant bin_grub_mkconfig =&gt; q[/usr/sbin/grub2-mkconfig];

use constant ssh_supported_algorithms =&gt; [qw{ ed25519 ecdsa rsa }];

use constant binary_locations =&gt; {
    &#039;lsof&#039; =&gt; &#039;/usr/bin&#039;,
};

use constant outdated_services_check  =&gt; q[default];
use constant outdated_processes_check =&gt; q[default];
use constant check_reboot_method      =&gt; q[default];

use constant program_to_apply_kernel_args =&gt; undef;

use constant security_service =&gt; &#039;selinux&#039;;

use constant supports_kernelcare                       =&gt; 0;
use constant supports_kernelcare_free                  =&gt; 0;
use constant supports_or_can_become_cloudlinux         =&gt; 0;
use constant can_become_cloudlinux                     =&gt; 0;
use constant supports_inetd                            =&gt; 0;
use constant supports_syslogd                          =&gt; 0;
use constant supports_postgresql                       =&gt; 0;
use constant has_cloudlinux_enhanced_quotas            =&gt; 0;
use constant ea4_install_from_profile_enforce_packages =&gt; 0;
use constant is_cloudlinux                             =&gt; 0;
use constant can_be_elevated                           =&gt; 0;
use constant crypto_policy_needs_sha1                  =&gt; 0;
use constant crypto_policy_os_provides_sha1_module     =&gt; 0;

use constant can_clean_plugins_repo =&gt; 0;

use constant has_quota_support_for_xfs            =&gt; 1;
use constant is_systemd                           =&gt; 1;
use constant has_tcp_wrappers                     =&gt; 1;
use constant supports_cpaddons                    =&gt; 1;
use constant openssl_escapes_subjects             =&gt; 1;
use constant kernel_supports_fs_protected_regular =&gt; 1;

use constant pretty_distro    =&gt; undef;
use constant release_codename =&gt; undef;

sub display_name {
    return sprintf( &quot;%s v%s.%s.%s&quot;, Cpanel::OS::pretty_distro() // &#039;&#039;, Cpanel::OS::major() // &#039;&#039;, Cpanel::OS::minor() // &#039;&#039;, Cpanel::OS::build() // &#039;&#039; );    ## no critic(Cpanel::CpanelOS) internal usage
}

sub display_name_lite {
    return sprintf( &quot;%s %s&quot;, lc( Cpanel::OS::distro() // &#039;&#039; ), Cpanel::OS::major() // &#039;&#039; );                                                                  ## no critic(Cpanel::CpanelOS) internal usage
}

sub cpanalytics_cpos {
    return sprintf( &quot;%s %s.%s&quot;, uc( Cpanel::OS::distro() // &#039;&#039; ), Cpanel::OS::major() // &#039;&#039;, Cpanel::OS::minor() // &#039;&#039; );                                    ## no critic(Cpanel::CpanelOS) internal usage
}

use constant var_named_permissions =&gt; {
    &#039;mode&#039;      =&gt; 0755,
    &#039;ownership&#039; =&gt; [ &#039;named&#039;, &#039;named&#039; ],
};

use constant nat_server_buffer_connections =&gt; 2;

use constant tuxcare_els_php_install_url =&gt; &#039;&#039;;

1;


} # --- END Cpanel/OS/Linux.pm


{ # --- BEGIN Cpanel/OS/Rhel.pm
package Cpanel::OS::Rhel;


use cPstrict;
no warnings &#039;once&#039;;

# use Cpanel::OS::Linux ();    # ea4tooling_all # perlpkg line 211
# use parent Cpanel::OS::Linux (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Linux); }

use constant is_supported =&gt; 0;    # Base OS class for all Rhel derivatives.

use constant pretty_distro =&gt; &#039;Red Hat Enterprise Linux&#039;;

use constant sudoers         =&gt; &#039;wheel&#039;;
use constant has_wheel_group =&gt; 1;

use constant etc_shadow_groups =&gt; [&#039;root&#039;];
use constant etc_shadow_perms  =&gt; [ 0000, 0200, 0600 ];

use constant dns_supported                     =&gt; [qw{ bind powerdns }];
use constant supports_kernelcare               =&gt; 1;
use constant supports_kernelcare_free          =&gt; 1;
use constant supports_or_can_become_cloudlinux =&gt; 1;
use constant can_become_cloudlinux             =&gt; 1;

use constant cron_bin_path                   =&gt; &#039;/usr/sbin/crond&#039;;
use constant systemd_service_name_map        =&gt; {};
use constant firewall                        =&gt; &#039;firewalld_nftables&#039;;
use constant firewall_module                 =&gt; &#039;NFTables&#039;;
use constant networking                      =&gt; &#039;networkscripts&#039;;
use constant package_manager                 =&gt; &#039;dnf&#039;;
use constant package_manager_module          =&gt; &#039;Yum&#039;;
use constant base_distro                     =&gt; &#039;rhel&#039;;
use constant is_apt_based                    =&gt; 0;
use constant is_yum_based                    =&gt; 1;
use constant is_rpm_based                    =&gt; 1;
use constant kernel_package_pattern          =&gt; &#039;kernel&#039;;
use constant stock_kernel_version_regex      =&gt; qr/\.(?:noarch|x86_64|i[3-6]86)$/;
use constant program_to_apply_kernel_args    =&gt; &#039;grub2-mkconfig&#039;;
use constant prelink_config_path             =&gt; &#039;/etc/sysconfig/prelink&#039;;
use constant pam_file_controlling_crypt_algo =&gt; &#039;system-auth&#039;;
use constant user_crontab_dir                =&gt; &#039;/var/spool/cron&#039;;
use constant who_wins_if_soft_gt_hard        =&gt; &#039;soft&#039;;
use constant has_tcp_wrappers                =&gt; 0;

use constant binary_locations =&gt; {
    &#039;lsof&#039;             =&gt; &#039;/usr/bin&#039;,
    &#039;needs-restarting&#039; =&gt; &#039;/usr/bin&#039;,
    &#039;named-checkzone&#039;  =&gt; &#039;/usr/sbin&#039;,
    &#039;named-checkconf&#039;  =&gt; &#039;/usr/sbin&#039;,
};

use constant cpsc_from_bare_repo_url  =&gt; &#039;http://ea4testing.cpanel.net/CPSC.repo&#039;;
use constant cpsc_from_bare_repo_path =&gt; &#039;/etc/yum.repos.d/cpsc.repo&#039;;

use constant ea4_install_bare_repo   =&gt; 1;
use constant ea4_from_bare_repo_url  =&gt; &#039;https://securedownloads.cpanel.net/EA4/0/EA4.repo&#039;;
use constant ea4_from_bare_repo_path =&gt; &#039;/etc/yum.repos.d/EA4.repo&#039;;

use constant ea4_conflicting_apache_distro_packages =&gt; [qw( httpd httpd-tools php-cli )];

use constant ea4tooling_dnsonly =&gt; [&#039;dnf-plugin-universal-hooks&#039;];
use constant ea4tooling         =&gt; [ &#039;dnf-plugin-universal-hooks&#039;, Cpanel::OS::Linux-&gt;ea4tooling_all-&gt;@* ];

use constant syslog_service_name =&gt; &#039;rsyslogd&#039;;

use constant jetbackup_repo_pkg =&gt; &#039;https://repo.jetlicense.com/centOS/jetapps-repo-latest.rpm&#039;;

use constant plugins_repo_url =&gt; &#039;https://securedownloads.cpanel.net/cpanel-plugins/1/cpanel-plugins.repo&#039;;

use constant repo_suffix =&gt; &#039;repo&#039;;
use constant repo_dir    =&gt; &#039;/etc/yum.repos.d&#039;;

use constant package_repositories =&gt; [qw/epel powertools/];

use constant system_exclude_rules =&gt; {
    &#039;dovecot&#039;     =&gt; &#039;dovecot*&#039;,
    &#039;php&#039;         =&gt; &#039;php*&#039;,
    &#039;exim&#039;        =&gt; &#039;exim*&#039;,
    &#039;pure-ftpd&#039;   =&gt; &#039;pure-ftpd*&#039;,
    &#039;proftpd&#039;     =&gt; &#039;proftpd*&#039;,
    &#039;p0f&#039;         =&gt; &#039;p0f&#039;,
    &#039;filesystem&#039;  =&gt; &#039;filesystem&#039;,
    &#039;kernel&#039;      =&gt; &#039;kernel kernel-xen kernel-smp kernel-pae kernel-PAE kernel-SMP kernel-hugemem kernel-debug* kernel-core kernel-modules* kernel-devel*&#039;,
    &#039;kmod-&#039;       =&gt; &#039;kmod-[a-z]*&#039;,
    &#039;bind-chroot&#039; =&gt; &#039;bind-chroot&#039;,
};

use constant packages_supplemental =&gt; [

    &#039;nfs-utils&#039;,

    qw{
      ImageMagick
      autoconf
      automake
      bind-devel
      bison
      boost-serialization
      cairo
      e2fsprogs-devel
      expat-devel
      flex
      fontconfig
      freetype
      ftp
      gcc-c++
      gd-devel
      gdbm-devel
      gettext-devel
      ghostscript
      giflib
      glib2
      hunspell
      hunspell-en
      krb5-devel
      libX11-devel
      libXpm
      libXpm-devel
      libaio-devel
      libidn-devel
      libjpeg-turbo-devel
      libpng-devel
      libstdc++-devel
      libtiff-devel
      libtool
      libtool-ltdl
      libtool-ltdl-devel
      libwmf
      libxml2-devel
      libxslt-devel
      ncurses
      ncurses-devel
      nscd
      openssl-devel
      pango
      perl-CPAN
      perl-ExtUtils-MakeMaker
      perl-IO-Tty
      perl-Module-Build
      perl-Try-Tiny
      perl-YAML-Syck
      perl-core
      perl-devel
      perl-libwww-perl
      perl-local-lib
      pixman
      strace
      sysstat
      traceroute
      urw-fonts
      zlib-devel
    }
];

use constant packages_supplemental_epel =&gt; [
    qw{
      dpkg
      perl-Expect
      perl-JSON-XS
    }
];

use constant packages_required =&gt; [
    qw{
      acl
      aspell
      at
      bind
      bind-libs
      bind-utils
      binutils
      boost-program-options
      bzip2
      cmake-filesystem
      coreutils
      cpio
      cpp
      crontabs
      curl
      dnf
      e2fsprogs
      expat
      file
      gawk
      gcc
      gd
      gdbm
      gettext
      glibc-devel
      glibc-locale-source
      gmp
      gnupg2
      grubby
      gzip
      initscripts
      iptables
      json-c
      kernel-headers
      less
      libaio
      libevent
      libgcc
      libgomp
      libicu
      libidn
      libjpeg-turbo
      libpcap
      libpng
      libstdc++
      libtiff
      libxml2
      libxslt
      libzip
      libzstd
      lsof
      lua
      lua-socket
      mailx
      make
      nano
      net-tools
      nftables
      oniguruma(x86-64)
      openssh
      openssh-clients
      openssh-server
      openssl
      pam
      pam-devel
      passwd
      patch
      pcre
      pcre2
      pcre2-utf32
      pigz
      popt
      postgresql-libs
      python3-dnf
      python3-dns
      python3-docs
      python3-html2text
      python3-libdnf
      python3-setuptools
      python36
      python312
      quota
      rsync
      sed
      shadow-utils
      smartmontools
      sqlite
      tar
      unzip
      util-linux-user
      wget
      which
      xz
      yum-utils
      zip
      zlib
    }
];

use constant postgresql_packages =&gt; [
    qw{
      postgresql      postgresql-devel    postgresql-libs     postgresql-server
    }
];

use constant package_ImageMagick_Devel =&gt; &#039;ImageMagick-devel&#039;;
use constant package_crond             =&gt; &#039;cronie&#039;;

use constant mariadb_versions_use_repo_template =&gt; [qw/10.0 10.1 10.2 10.3 10.5 10.6 10.11 11.4 11.8/];
use constant mysql_versions_use_repo_template   =&gt; [qw/5.7/];

use constant mysql_incompatible =&gt; [
    qw{
      mariadb-client
      mariadb-devel
      mariadb-embedded
      mariadb-embedded-devel
      mariadb-libs
      mariadb-libs-compat
      mariadb-release
      mariadb-server
      mariadb-test
      mysql-client
      mysql-devel
      mysql-embedded
      mysql-embedded-devel
      mysql-libs
      mysql-libs-compat
      mysql-release
      mysql-server
      mysql-test
      mysql55-mysql-bench
      mysql55-mysql-devel
      mysql55-mysql-libs
      mysql55-mysql-server
      mysql55-mysql-test
      mysqlclient16
      rh-mysql56-mysql-bench
      rh-mysql56-mysql-common
      rh-mysql56-mysql-config
      rh-mysql56-mysql-devel
      rh-mysql56-mysql-errmsg
      rh-mysql56-mysql-server
      rh-mysql56-mysql-test
      rh-mysql57-mysql-common
      rh-mysql57-mysql-config
      rh-mysql57-mysql-devel
      rh-mysql57-mysql-errmsg
      rh-mysql57-mysql-server
      rh-mysql57-mysql-test
    }
];

use constant mysql_community_packages =&gt; [qw/mysql-community-server mysql-community-devel/];

use constant mariadb_packages =&gt; [qw( MariaDB-server MariaDB-client MariaDB-devel MariaDB-shared MariaDB-common )];
use constant mariadb_incompatible_packages =&gt; [
    qw(
      mariadb-client
      mariadb-devel
      mariadb-embedded
      mariadb-embedded-devel
      mariadb-libs
      mariadb-libs-compat
      mariadb-release
      mariadb-server
      mariadb-test
      mysql-community-client
      mysql-community-common
      mysql-community-devel
      mysql-community-embedded
      mysql-community-embedded-devel
      mysql-community-libs
      mysql-community-libs-compat
      mysql-community-release
      mysql-community-server
      mysql-community-test
      mysql-client
      mysql-devel
      mysql-embedded
      mysql-embedded-devel
      mysql-libs
      mysql-libs-compat
      mysql-release
      mysql-server
      mysql-test
      mysql55-mysql-bench
      mysql55-mysql-devel
      mysql55-mysql-libs
      mysql55-mysql-server
      mysql55-mysql-test
      mysql57-community-release
      mysql80-community-release
      rh-mysql56-mysql-bench
      rh-mysql56-mysql-common
      rh-mysql56-mysql-config
      rh-mysql56-mysql-devel
      rh-mysql56-mysql-errmsg
      rh-mysql56-mysql-server
      rh-mysql56-mysql-test
      rh-mysql57-mysql-common
      rh-mysql57-mysql-config
      rh-mysql57-mysql-devel
      rh-mysql57-mysql-errmsg
      rh-mysql57-mysql-server
      rh-mysql57-mysql-test
    )
];

use constant known_mariadb_deps =&gt; {
    &#039;perl-DBI&#039;     =&gt; &#039;&#039;,
    &#039;shadow-utils&#039; =&gt; &#039;&#039;,
    &#039;grep&#039;         =&gt; &#039;&#039;,
    &#039;coreutils&#039;    =&gt; &#039;&#039;,
};

use constant db_disable_auth_socket =&gt; {
    &#039;unix_socket&#039;     =&gt; &#039;OFF&#039;,
    &#039;plugin-load-add&#039; =&gt; &#039;auth_socket.so&#039;
};

use constant db_additional_conf_files     =&gt; [];
use constant db_mariadb_default_conf_file =&gt; undef;
use constant db_mariadb_start_file        =&gt; undef;

use constant mysql_dependencies =&gt; [
    qw/
      coreutils
      grep
      perl-DBI
      shadow-utils
      /
];

use constant db_package_manager_key_params =&gt; {
    method =&gt; &#039;add_repo_key&#039;,
    keys   =&gt; [qw{https://repo.mysql.com/RPM-GPG-KEY-mysql-2025 https://repo.mysql.com/RPM-GPG-KEY-mysql-2023 https://repo.mysql.com/RPM-GPG-KEY-MySQL-2022 https://repo.mysql.com/RPM-GPG-KEY-mysql https://archive.mariadb.org/PublicKey https://supplychain.mariadb.com/MariaDB-Server-GPG-KEY}],
};

use constant db_needs_preseed =&gt; 0;

use constant mariadb_repo_template =&gt; &lt;&lt;&#039;___END_REPO_TEMPLATE___&#039;;
[MariaDB###MARIADB_FLAT_VERSION_SHORT###]
name = MariaDB###MARIADB_FLAT_VERSION_SHORT###
baseurl = https://archive.mariadb.org/mariadb-###MARIADB_VERSION_SHORT###/yum/centos/###DISTRO_MAJOR###/x86_64
gpgkey=https://archive.mariadb.org/PublicKey
       https://supplychain.mariadb.com/MariaDB-Server-GPG-KEY
gpgcheck=1
___END_REPO_TEMPLATE___

use constant mysql_repo_template =&gt; &lt;&lt;&#039;___END_REPO_TEMPLATE___&#039;;
[Mysql-connectors-community]
name=MySQL Connectors Community
baseurl=https://repo.mysql.com/yum/mysql-connectors-community/el/###DISTRO_MAJOR###/$basearch/
enabled=1
gpgcheck=1
gpgkey=https://repo.mysql.com/RPM-GPG-KEY-mysql-2025
       https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
       https://repo.mysql.com/RPM-GPG-KEY-MySQL-2022
       https://repo.mysql.com/RPM-GPG-KEY-mysql
[Mysql-tools-community]
name=MySQL Tools Community
baseurl=https://repo.mysql.com/yum/mysql-tools-community/el/###DISTRO_MAJOR###/$basearch/
enabled=1
gpgcheck=1
gpgkey=https://repo.mysql.com/RPM-GPG-KEY-mysql-2025
       https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
       https://repo.mysql.com/RPM-GPG-KEY-MySQL-2022
       https://repo.mysql.com/RPM-GPG-KEY-mysql
[Mysql###MYSQL_FLAT_VERSION_SHORT###-community]
name=MySQL ###MYSQL_VERSION_SHORT### Community Server
baseurl=https://repo.mysql.com/yum/mysql-###MYSQL_VERSION_SHORT###-community/el/###DISTRO_MAJOR###/$basearch/
enabled=1
gpgcheck=1
gpgkey=https://repo.mysql.com/RPM-GPG-KEY-mysql-2025
       https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
       https://repo.mysql.com/RPM-GPG-KEY-MySQL-2022
       https://repo.mysql.com/RPM-GPG-KEY-mysql
[Mysql-tools-preview]
name=MySQL Tools Preview
baseurl=https://repo.mysql.com/yum/mysql-tools-preview/el/###DISTRO_MAJOR###/$basearch/
enabled=0
gpgcheck=1
gpgkey=https://repo.mysql.com/RPM-GPG-KEY-mysql-2025
       https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
       https://repo.mysql.com/RPM-GPG-KEY-MySQL-2022
       https://repo.mysql.com/RPM-GPG-KEY-mysql
___END_REPO_TEMPLATE___

use constant supports_postgresql =&gt; 1;

use constant postgresql_minimum_supported_version =&gt; &#039;9.2&#039;;
use constant postgresql_initdb_commands           =&gt; [&#039;/usr/bin/postgresql-setup initdb&#039;];

use constant package_descriptions =&gt; {
    &#039;short&#039; =&gt; &#039;summary&#039;,
    &#039;long&#039;  =&gt; &#039;description&#039;,
};

use constant tuxcare_els_php_install_url =&gt; &quot;https://go.cpanel.net/install-els-alt-php-rpm-repo-ip&quot;;
use constant supports_phpels             =&gt; 1;

1;


} # --- END Cpanel/OS/Rhel.pm


{ # --- BEGIN Cpanel/OS/Almalinux.pm
package Cpanel::OS::Almalinux;


use cPstrict;
no warnings &#039;once&#039;;

# use parent Cpanel::OS::Rhel (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Rhel); }

use constant is_supported =&gt; 0;

use constant pretty_distro =&gt; &#039;AlmaLinux&#039;;

1;


} # --- END Cpanel/OS/Almalinux.pm


{ # --- BEGIN Cpanel/OS/Rhel8.pm
package Cpanel::OS::Rhel8;


use cPstrict;
no warnings &#039;once&#039;;

# use parent Cpanel::OS::Rhel (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Rhel); }

use constant is_supported =&gt; 0;    # Rhel 8 is NOT supported but we use it as a base class for all Rhel derivatives.

use constant binary_sync_source =&gt; &#039;linux-c8-x86_64&#039;;

use constant package_release_distro_tag =&gt; &#039;~el8&#039;;

use constant system_package_providing_perl =&gt; &#039;perl-interpreter&#039;;

use constant ea4_install_from_profile_enforce_packages =&gt; 1;

1;


} # --- END Cpanel/OS/Rhel8.pm


{ # --- BEGIN Cpanel/OS/Almalinux8.pm
package Cpanel::OS::Almalinux8;


use cPstrict;
no warnings &#039;once&#039;;

use Cpanel::OS::Almalinux;
# use parent Cpanel::OS::Rhel8 (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Rhel8); }

use constant is_supported =&gt; 1;    # Almalinux 8

use constant pretty_distro =&gt; Cpanel::OS::Almalinux-&gt;pretty_distro;

use constant supports_cpanel_cloud_edition =&gt; 1;

use constant can_be_elevated =&gt; 1;
use constant can_elevate_to  =&gt; [qw(Almalinux9)];

1;


} # --- END Cpanel/OS/Almalinux8.pm


{ # --- BEGIN Cpanel/OS/Rhel9.pm
package Cpanel::OS::Rhel9;


use cPstrict;
no warnings &#039;once&#039;;

# use parent Cpanel::OS::Rhel8 (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Rhel8); }

# use Cpanel::OS (); # perlpkg line 211

use constant is_supported =&gt; 0;    # Rhel 9 is NOT supported but we use it as a base class for all Rhel derivatives.

use constant support_needs_minor_at_least_at =&gt; 5;

use constant networking =&gt; &#039;NetworkManager&#039;;

use constant package_repositories =&gt; [qw/epel crb/];

use constant binary_sync_source =&gt; &#039;linux-c9-x86_64&#039;;

use constant package_release_distro_tag =&gt; &#039;~el9&#039;;

use constant program_to_apply_kernel_args =&gt; &#039;grubby&#039;;

use constant lsof_needs_prlimit =&gt; 1;

use constant mysql_versions_use_repo_template =&gt; [];

use constant mariadb_minimum_supported_version =&gt; &#039;10.5&#039;;

sub rsync_old_args { return Cpanel::OS::minor() &lt; 2 ? [&#039;--old-args&#039;] : [] }    ## no critic qw(CpanelOS) -- behavior is conditional on minor release

use constant crypto_policy_needs_sha1              =&gt; 1;
use constant crypto_policy_os_provides_sha1_module =&gt; 1;

use constant ea4_install_from_profile_enforce_packages =&gt; 0;

use constant jetbackup_repo_pkg =&gt; &#039;https://repo.jetlicense.com/centOS/jetapps-repo-4096-latest.rpm&#039;;

use constant var_named_permissions =&gt; {
    &#039;mode&#039;      =&gt; 0770,
    &#039;ownership&#039; =&gt; [ &#039;root&#039;, &#039;named&#039; ],
};

sub packages_supplemental ($self) {
    my @packages = $self-&gt;SUPER::packages_supplemental()-&gt;@*;

    push @packages, qw{ glibc-langpack-en s-nail };

    return \@packages;
}

sub packages_required ($self) {
    my @packages = $self-&gt;SUPER::packages_required()-&gt;@*;

    @packages = sort grep {
        my $p = $_;
        !( grep { $p eq $_ } qw{ dnf-plugin-universal-hooks python36 python312 python3-docs mailx iptables } )
    } @packages;

    push @packages, qw{ python3 libnsl2 dbus-tools openldap-compat iptables-nft };

    return \@packages;
}

1;


} # --- END Cpanel/OS/Rhel9.pm


{ # --- BEGIN Cpanel/OS/Almalinux9.pm
package Cpanel::OS::Almalinux9;


use cPstrict;
no warnings &#039;once&#039;;

use Cpanel::OS::Almalinux;
# use parent Cpanel::OS::Rhel9 (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Rhel9); }

use constant is_supported =&gt; 1;    # Almalinux 9

use constant pretty_distro =&gt; Cpanel::OS::Almalinux-&gt;pretty_distro;

1;


} # --- END Cpanel/OS/Almalinux9.pm


{ # --- BEGIN Cpanel/OS/Rhel10.pm
package Cpanel::OS::Rhel10;


use cPstrict;
no warnings &#039;once&#039;;

# use parent Cpanel::OS::Rhel9 (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Rhel9); }

use constant is_supported =&gt; 0;    # Rhel 10 is NOT supported but we use it as a base class for all Rhel derivatives.

use constant binary_sync_source =&gt; &#039;linux-c10-x86_64&#039;;

use constant package_release_distro_tag =&gt; &#039;~el10&#039;;

use constant support_needs_minor_at_least_at =&gt; undef;

use constant lsof_needs_prlimit =&gt; 0;

use constant supports_cpaddons =&gt; 0;

use constant mariadb_versions_use_repo_template =&gt; [qw/10.11 11.4 11.8/];
use constant mariadb_minimum_supported_version  =&gt; &#039;10.11&#039;;

use constant crypto_policy_os_provides_sha1_module =&gt; 0;

use constant postgresql_initdb_commands =&gt; [&quot;/usr/bin/postgresql-setup --initdb --unit postgresql&quot;];

sub packages_supplemental ($self) {
    my @packages = $self-&gt;SUPER::packages_supplemental()-&gt;@*;

    @packages = sort grep {
        my $p = $_;
        !( grep { $p eq $_ } qw{ nscd postgresql-libs } )
    } @packages;

    push @packages, &#039;postgresql&#039;;

    return \@packages;
}

sub packages_required ($self) {
    my @packages = $self-&gt;SUPER::packages_required()-&gt;@*;

    @packages = sort grep {
        my $p = $_;
        !( grep { $p eq $_ } qw{ dnf-plugin-universal-hooks pcre python3-html2text } )
    } @packages;

    push @packages, qw{ libdb libxcrypt-compat };

    return \@packages;
}

1;


} # --- END Cpanel/OS/Rhel10.pm


{ # --- BEGIN Cpanel/OS/Almalinux10.pm
package Cpanel::OS::Almalinux10;


use cPstrict;
no warnings &#039;once&#039;;

use Cpanel::OS::Almalinux;
# use parent Cpanel::OS::Rhel10 (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Rhel10); }

use constant is_supported =&gt; 1;    # Almalinux 10

use constant pretty_distro =&gt; Cpanel::OS::Almalinux-&gt;pretty_distro;

1;


} # --- END Cpanel/OS/Almalinux10.pm


{ # --- BEGIN Cpanel/Server/Type.pm
package Cpanel::Server::Type;


use cPstrict;
no warnings &#039;once&#039;;

use constant NUMBER_OF_USERS_TO_ASSUME_IF_UNREADABLE =&gt; 1;


sub _get_license_file_path { return q{/usr/local/cpanel/cpanel.lisc} }
sub _get_dnsonly_file_path { return q{/var/cpanel/dnsonly} }

use constant _ENOENT =&gt; 2;

use constant SERVER_TYPE =&gt; q[cpanel];

my @server_config;
our %PRODUCTS;
our $MAXUSERS;
our %FIELDS;
our ( $DNSONLY_MODE, $NODE_MODE );


sub is_dnsonly {
    return $DNSONLY_MODE if defined $DNSONLY_MODE;

    return 1 if -e _get_dnsonly_file_path();
    return 0 if $! == _ENOENT();
    my $err = $!;


    if ( _read_license() ) {
        return $PRODUCTS{&#039;dnsonly&#039;} ? 1 : 0;
    }

    die sprintf( &#039;stat(%s): %s&#039;, _get_dnsonly_file_path(), &quot;$err&quot; );
}


sub is_wp_squared {
    return SERVER_TYPE eq &#039;wp2&#039;;
}


sub get_producttype {
    return $NODE_MODE if defined $NODE_MODE;
    return &#039;DNSONLY&#039; unless _read_license();

    return &#039;STANDARD&#039; if $PRODUCTS{&#039;cpanel&#039;};

    foreach my $product (qw/dnsnode mailnode databasenode dnsonly/) {
        return uc($product) if $PRODUCTS{$product};
    }

    return &#039;DNSONLY&#039;;
}


sub get_max_users {
    return $MAXUSERS if defined $MAXUSERS;
    return NUMBER_OF_USERS_TO_ASSUME_IF_UNREADABLE unless _read_license();
    return $MAXUSERS // NUMBER_OF_USERS_TO_ASSUME_IF_UNREADABLE;
}

sub get_license_expire_gmt_date {
    return $FIELDS{&#039;license_expire_gmt_date&#039;} if defined $FIELDS{&#039;license_expire_gmt_date&#039;};
    return 0 unless _read_license();
    return $FIELDS{&#039;license_expire_gmt_date&#039;} // 0;
}


sub is_licensed_for_product ($product) {
    return unless $product;
    $product = lc $product;
    return unless _read_license();
    return exists $PRODUCTS{$product};
}


sub get_features {
    return unless _read_license();

    my @features = split( &quot;,&quot;, $FIELDS{&#039;features&#039;} // &#039;&#039; );
    return @features;
}


sub has_feature ( $feature = undef ) {
    length $feature or return;

    return ( grep { $_ eq $feature } get_features() ) ? 1 : 0;
}


sub get_products {
    return unless _read_license();
    return keys %PRODUCTS;
}

sub _read_license {
    my $LICENSE_FILE = _get_license_file_path();

    my @new_stat = stat($LICENSE_FILE) if @server_config;

    if ( @server_config &amp;&amp; @new_stat &amp;&amp; $new_stat[9] == $server_config[9] &amp;&amp; $new_stat[7] == $server_config[7] ) {
        return 1;
    }

    open( my $fh, &#039;&lt;&#039;, $LICENSE_FILE ) or do {

        if ( $! != _ENOENT() ) {
            warn &quot;open($LICENSE_FILE): $!&quot;;
        }

        return;
    };

    _reset_cache();

    my $content;

    read( $fh, $content, 1024 ) // do {
        warn &quot;read($LICENSE_FILE): $!&quot;;
        $content = q&lt;&gt;;
    };

    return _parse_license_contents_sr( $fh, \$content );
}

sub _parse_license_contents_to_hashref ($content_sr) {

    my %vals = map { ( split( m{: }, $_ ) )[ 0, 1 ] } split( m{\n}, $$content_sr );

    return \%vals;
}

sub _parse_license_contents_sr ( $fh, $content_sr ) {
    my $vals_hr = _parse_license_contents_to_hashref($content_sr);

    if ( length $vals_hr-&gt;{&#039;products&#039;} ) {
        %PRODUCTS = map { ( $_ =&gt; 1 ) } split( &quot;,&quot;, $vals_hr-&gt;{&#039;products&#039;} );
    }
    else {
        return;
    }

    if ( length $vals_hr-&gt;{&#039;maxusers&#039;} ) {

        $MAXUSERS //= int $vals_hr-&gt;{&#039;maxusers&#039;};
    }
    else {
        return;
    }

    foreach my $field (qw/license_expire_time license_expire_gmt_date support_expire_time updates_expire_time/) {
        $FIELDS{$field} = $vals_hr-&gt;{$field} // 0;
    }
    foreach my $field (qw/client features/) {
        $FIELDS{$field} = $vals_hr-&gt;{$field} // &#039;&#039;;
    }

    if ( length $vals_hr-&gt;{&#039;fields&#039;} ) {
        foreach my $field ( split( &quot;,&quot;, $vals_hr-&gt;{&#039;fields&#039;} ) ) {
            my ( $k, $v ) = split( &#039;=&#039;, $field, 2 );
            $FIELDS{$k} = $v;

        }
    }
    else {
        return;
    }

    @server_config = stat($fh);
    return 1;
}

sub _reset_cache {
    undef %PRODUCTS;
    undef %FIELDS;
    undef @server_config;
    undef $MAXUSERS;
    undef $DNSONLY_MODE;

    return;
}

1;


} # --- END Cpanel/Server/Type.pm


{ # --- BEGIN Cpanel/OS/Cloudlinux.pm
package Cpanel::OS::Cloudlinux;


use cPstrict;
no warnings &#039;once&#039;;

# use parent Cpanel::OS::Rhel (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Rhel); }

# use Cpanel::Server::Type (); # perlpkg line 211

use constant is_supported =&gt; 0;    # Base class for CL.

use constant is_cloudlinux =&gt; 1;

use constant pretty_distro                  =&gt; &#039;CloudLinux&#039;;
use constant supports_kernelcare_free       =&gt; 0;
use constant php_els_is_part_of_the_base_os =&gt; 1;

sub ea4_yum_tooling {
    return [ qw{ yum-plugin-universal-hooks ea-cpanel-tools }, _ea_profiles() ];
}

sub ea4_dnf_tooling {
    return [ qw{ dnf-plugin-universal-hooks ea-cpanel-tools }, _ea_profiles() ];
}

sub _ea_profiles {

    if ( Cpanel::Server::Type::is_wp_squared() ) {
        return &#039;ea-profiles-cpanel&#039;;
    }

    return &#039;ea-profiles-cloudlinux&#039;;
}

1;


} # --- END Cpanel/OS/Cloudlinux.pm


{ # --- BEGIN Cpanel/OS/Cloudlinux8.pm
package Cpanel::OS::Cloudlinux8;


use cPstrict;
no warnings &#039;once&#039;;

use Cpanel::OS::Cloudlinux;
# use parent Cpanel::OS::Rhel8 (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Rhel8); }

use constant is_supported =&gt; 1;    # Cloudlinux 8

use constant is_cloudlinux =&gt; 1;

use constant pretty_distro                  =&gt; Cpanel::OS::Cloudlinux-&gt;pretty_distro;
use constant php_els_is_part_of_the_base_os =&gt; Cpanel::OS::Cloudlinux-&gt;php_els_is_part_of_the_base_os;

use constant ea4_install_from_profile_enforce_packages =&gt; 0;

use constant ea4_install_repo_from_package =&gt; 1;
use constant ea4_from_pkg_url              =&gt; &#039;https://repo.cloudlinux.com/cloudlinux/EA4/cloudlinux-ea4-release-latest-8.noarch.rpm&#039;;
use constant ea4_from_pkg_reponame         =&gt; &#039;cloudlinux-ea4-release&#039;;
use constant ea4_install_bare_repo         =&gt; 0;
use constant ea4_from_bare_repo_url        =&gt; undef;
use constant ea4_from_bare_repo_path       =&gt; undef;

use constant ea4tooling           =&gt; Cpanel::OS::Cloudlinux-&gt;ea4_dnf_tooling;
use constant package_repositories =&gt; [qw/cloudlinux-PowerTools epel/];

use constant supports_kernelcare_free       =&gt; Cpanel::OS::Cloudlinux-&gt;supports_kernelcare_free;
use constant has_cloudlinux_enhanced_quotas =&gt; 1;
use constant can_become_cloudlinux          =&gt; 0;

1;


} # --- END Cpanel/OS/Cloudlinux8.pm


{ # --- BEGIN Cpanel/OS/Cloudlinux9.pm
package Cpanel::OS::Cloudlinux9;


use cPstrict;
no warnings &#039;once&#039;;

use Cpanel::OS::Cloudlinux;
# use parent Cpanel::OS::Rhel9 (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Rhel9); }

use constant is_supported =&gt; 1;    # Cloudlinux 9

use constant is_cloudlinux =&gt; 1;

use constant pretty_distro                  =&gt; Cpanel::OS::Cloudlinux-&gt;pretty_distro;
use constant php_els_is_part_of_the_base_os =&gt; Cpanel::OS::Cloudlinux-&gt;php_els_is_part_of_the_base_os;

use constant ea4_install_repo_from_package =&gt; 1;
use constant ea4_from_pkg_url              =&gt; &#039;https://repo.cloudlinux.com/cloudlinux/EA4/cloudlinux-ea4-release-latest-9.noarch.rpm&#039;;
use constant ea4_from_pkg_reponame         =&gt; &#039;cloudlinux-ea4-release&#039;;

use constant ea4tooling =&gt; Cpanel::OS::Cloudlinux-&gt;ea4_dnf_tooling;

use constant supports_kernelcare_free       =&gt; Cpanel::OS::Cloudlinux-&gt;supports_kernelcare_free;
use constant has_cloudlinux_enhanced_quotas =&gt; 1;
use constant can_become_cloudlinux          =&gt; 0;

use constant who_wins_if_soft_gt_hard =&gt; &#039;hard&#039;;

1;


} # --- END Cpanel/OS/Cloudlinux9.pm


{ # --- BEGIN Cpanel/OS/Cloudlinux10.pm
package Cpanel::OS::Cloudlinux10;


use cPstrict;
no warnings &#039;once&#039;;

use Cpanel::OS::Cloudlinux;
# use parent Cpanel::OS::Rhel10 (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Rhel10); }

use constant is_supported =&gt; 1;    # Cloudlinux 10

use constant is_cloudlinux =&gt; 1;

use constant pretty_distro                  =&gt; Cpanel::OS::Cloudlinux-&gt;pretty_distro;
use constant php_els_is_part_of_the_base_os =&gt; Cpanel::OS::Cloudlinux-&gt;php_els_is_part_of_the_base_os;

use constant ea4_install_repo_from_package =&gt; 1;

use constant ea4_from_pkg_url      =&gt; &#039;https://repo.cloudlinux.com/cloudlinux/EA4/cloudlinux-ea4-release-latest-10.noarch.rpm&#039;;
use constant ea4_from_pkg_reponame =&gt; &#039;cloudlinux-ea4-release&#039;;

use constant ea4tooling =&gt; Cpanel::OS::Cloudlinux-&gt;ea4_dnf_tooling;

use constant supports_kernelcare_free       =&gt; Cpanel::OS::Cloudlinux-&gt;supports_kernelcare_free;
use constant has_cloudlinux_enhanced_quotas =&gt; 1;
use constant can_become_cloudlinux          =&gt; 0;

use constant who_wins_if_soft_gt_hard =&gt; &#039;hard&#039;;

1;


} # --- END Cpanel/OS/Cloudlinux10.pm


{ # --- BEGIN Cpanel/OS/Ubuntu.pm
package Cpanel::OS::Ubuntu;


use cPstrict;
no warnings &#039;once&#039;;

# use Cpanel::OS::Linux ();    # ea4tooling_all # perlpkg line 211
# use parent Cpanel::OS::Linux (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Linux); }
use constant is_supported =&gt; 0;

use constant ssh_service_name =&gt; &#039;ssh&#039;;

use constant nogroup         =&gt; q[nogroup];
use constant sudoers         =&gt; &#039;sudo&#039;;       # Warning: need to change dynamicui.conf when updating this value
use constant has_wheel_group =&gt; 0;

use constant etc_shadow_groups =&gt; [ &#039;shadow&#039;, &#039;root&#039; ];
use constant etc_shadow_perms =&gt; [ 0000, 0200, 0600, 0640 ];

use constant default_sys_uid_min =&gt; 100;
use constant default_sys_gid_min =&gt; 100;

use constant pretty_distro =&gt; &#039;Ubuntu&#039;;

use constant firewall                  =&gt; &#039;ufw_iptables&#039;;
use constant firewall_module           =&gt; &#039;NFTables&#039;;
use constant networking                =&gt; &#039;netplan&#039;;
use constant sysconfig_network         =&gt; undef;
use constant package_manager           =&gt; &#039;apt&#039;;
use constant package_manager_module    =&gt; &#039;Apt&#039;;
use constant is_apt_based              =&gt; 1;
use constant is_yum_based              =&gt; 0;
use constant is_rpm_based              =&gt; 0;
use constant retry_rpm_cmd_no_tty_hack =&gt; 0;
use constant base_distro               =&gt; &#039;debian&#039;;

use constant supports_cpaddons =&gt; 0;

use constant rpm_versions_system =&gt; &#039;ubuntu&#039;;
use constant packages_arch       =&gt; &#039;amd64&#039;;

use constant db_needs_preseed =&gt; 1;

use constant mariadb_versions_use_repo_template =&gt; [qw/10.11 11.4 11.8/];
use constant mysql_versions_use_repo_template   =&gt; [ &#039;8.0&#039;, &#039;8.4&#039; ];

use constant db_package_manager_key_params =&gt; {
    method =&gt; &#039;add_repo_key_by_id&#039;,
    keys   =&gt; [
        &#039;A8D3785C&#039;,    # For MySQL 8.0.36 and up
        &#039;3A79BD29&#039;,    # For MySQL 8.0.28 and up
        &#039;5072E1F5&#039;,    # For MySQL 8.0.27 and below
        &#039;C74CD1D8&#039;,    # For all MariaDB versions
    ],
};

use constant who_wins_if_soft_gt_hard =&gt; &#039;hard&#039;;

use constant security_service            =&gt; &#039;apparmor&#039;;
use constant cron_bin_path               =&gt; &#039;/usr/sbin/cron&#039;;
use constant systemd_service_name_map    =&gt; { &#039;crond&#039; =&gt; &#039;cron&#039; };
use constant kernel_package_pattern      =&gt; &#039;^linux-image-[0-9]&#039;;
use constant check_kernel_version_method =&gt; q[boot-vmlinuz-file];
use constant stock_kernel_version_regex  =&gt; qr/-(?:generic|lowlatency|kvm|aws|azure|gcp|gke(?:op)?|ibm|nvidia(?:-lowlatency)?|oracle)$/;

use constant prelink_config_path             =&gt; &#039;/etc/default/prelink&#039;;
use constant pam_file_controlling_crypt_algo =&gt; &#039;common-password&#039;;
use constant user_crontab_dir                =&gt; &#039;/var/spool/cron/crontabs&#039;;

use constant supports_kernelcare      =&gt; 1;
use constant supports_kernelcare_free =&gt; 1;
use constant supports_hostaccess      =&gt; 1;

use constant iptables_ipv4_savefile =&gt; &#039;/etc/iptables/rules.v4&#039;;
use constant iptables_ipv6_savefile =&gt; &#039;/etc/iptables/rules.v6&#039;;

use constant nftables_config_file =&gt; &#039;/etc/nftables.conf&#039;;

use constant mysql_incompatible =&gt; [
    qw{
      default-mysql-server
      default-mysql-server-core
      mariadb-client
      mariadb-client-10.3
      mariadb-server
      mariadb-server-10.3
      mariadb-test
      mysql-client-8.0
      mysql-server-8.0
      mysql-testsuite
      mysql-testsuite-8.0
    }
];

use constant mysql_community_packages =&gt; [qw/mysql-community-server mysql-shell libmysqlclient-dev/];
use constant mysql_dependencies       =&gt; [qw/libdbi-perl passwd adduser login coreutils/];

use constant outdated_services_check  =&gt; q[needrestart_b];
use constant outdated_processes_check =&gt; q[checkrestart];
use constant check_reboot_method      =&gt; q[check-reboot-required];

use constant syslog_service_name         =&gt; &#039;rsyslog&#039;;
use constant rsyslog_triggered_by_socket =&gt; 1;
use constant ea4_from_bare_repo_path     =&gt; &#039;/etc/apt/sources.list.d/EA4.list&#039;;

use constant cpsc_from_bare_repo_path =&gt; &#039;/etc/apt/sources.list.d/CPSC.list&#039;;

use constant ea4_conflicting_apache_distro_packages =&gt; [qw( apache2 apache2-utils php-cli )];

use constant ea4tooling_dnsonly =&gt; [&#039;apt-plugin-universal-hooks&#039;];
use constant ea4tooling         =&gt; [ &#039;apt-plugin-universal-hooks&#039;, Cpanel::OS::Linux-&gt;ea4tooling_all-&gt;@* ];
use constant system_exclude_rules =&gt; {
    &#039;dovecot&#039;    =&gt; &#039;dovecot*&#039;,
    &#039;exim&#039;       =&gt; &#039;exim*&#039;,
    &#039;filesystem&#039; =&gt; &#039;base-files&#039;,                                   # block Ubuntu updates to current installed version (20.04)
    &#039;kernel&#039;     =&gt; &#039;linux-headers* linux-image* linux-modules*&#039;,
    &#039;nsd&#039;        =&gt; &#039;nsd&#039;,
    &#039;p0f&#039;        =&gt; &#039;p0f&#039;,
    &#039;php&#039;        =&gt; &#039;php*&#039;,
    &#039;proftpd&#039;    =&gt; &#039;proftpd*&#039;,
    &#039;pure-ftpd&#039;  =&gt; &#039;pure-ftpd*&#039;,

};

use constant packages_supplemental =&gt; [

    &#039;nfs-common&#039;,

    qw{
      libcpan-perl-releases-perl
      libexpect-perl
      libio-pty-perl
      libjson-xs-perl
      liblocal-lib-perl
      libmodule-build-perl
      libonig-dev
      libtry-tiny-perl
      libwww-perl
      libyaml-syck-perl
      lsof
      nscd
      rpm
      strace
      sysstat
      tcpd
      util-linux
    }
];

use constant jetbackup_repo_pkg =&gt; &#039;https://repo.jetlicense.com/ubuntu/jetapps-repo-latest_amd64.deb&#039;;

use constant repo_suffix =&gt; &#039;list&#039;;
use constant repo_dir    =&gt; &#039;/etc/apt/sources.list.d&#039;;

use constant packages_required =&gt; [
    qw{
      acl
      apt-file
      apt-transport-https
      aspell
      at
      bind9
      bind9-libs
      bind9-utils
      binutils
      bzip2
      coreutils
      cpio
      cpp
      cracklib-runtime
      cron
      curl
      debian-goodies
      debianutils
      e2fsprogs
      expat
      file
      g++
      g++-9
      gawk
      gcc
      gdbmtool
      gettext
      glibc-source
      gnupg2
      graphicsmagick-imagemagick-compat
      gzip
      icu-devtools
      iptables
      iptables-persistent
      language-pack-en-base
      less
      libaio1
      libapt-pkg-perl
      libboost-program-options1.74.0
      libcairo2-dev
      libcrack2
      libdb5.3
      libevent-2.1-7
      libffi7
      libfile-fcntllock-perl
      libfontconfig1-dev
      libgcc1
      libgd-tools
      libgd3
      libgmp10
      libgomp1
      libicu-dev
      libicu70
      libidn12
      libjpeg-turbo8
      liblua5.3-dev
      libmount1
      libmysqlclient21
      libncurses5
      libpam0g
      libpam0g-dev
      libpango-1.0-0
      libpangocairo-1.0-0
      libpcap0.8
      libpcre2-8-0
      libpcre2-posix3
      libpcre3
      libpq5
      libpixman-1-0
      libpng16-16
      libpopt0
      libreadline-dev
      libssl-dev
      libstdc++-9-dev
      libstdc++6
      libsqlite0
      libtiff5
      libuser
      libxml2
      libxml2-dev
      libxslt1.1
      libzip4
      libzstd1
      linux-libc-dev
      lsof
      lua5.3
      lua-socket
      make
      nano
      needrestart
      net-tools
      openssh-client
      openssh-server
      openssl
      passwd
      patch
      pcre2-utils
      pigz
      procps
      python-setuptools
      python3
      python3-dnspython
      python3-html2text
      python3-minimal
      quota
      rdate
      rsync
      sed
      smartmontools
      ssl-cert
      sqlite
      sqlite3
      sysstat
      tar
      unzip
      usrmerge
      wget
      xz-utils
      zip
      zlib1g
    }
];

use constant mariadb_packages =&gt; [qw( mariadb-server mariadb-client mariadb-common )];
use constant mariadb_incompatible_packages =&gt; [
    qw(
      mariadb-devel
      mariadb-embedded
      mariadb-embedded-devel
      mariadb-libs
      mariadb-libs-compat
      mariadb-release
      mariadb-test
      mysql-community-client
      mysql-community-common
      mysql-community-devel
      mysql-community-embedded
      mysql-community-embedded-devel
      mysql-community-libs
      mysql-community-libs-compat
      mysql-community-release
      mysql-community-server
      mysql-community-test
      mysql-client
      mysql-devel
      mysql-embedded
      mysql-embedded-devel
      mysql-libs
      mysql-libs-compat
      mysql-release
      mysql-server
      mysql-test
      mysql55-mysql-bench
      mysql55-mysql-devel
      mysql55-mysql-libs
      mysql55-mysql-server
      mysql55-mysql-test
      mysql57-community-release
      mysql80-community-release
      rh-mysql56-mysql-bench
      rh-mysql56-mysql-common
      rh-mysql56-mysql-config
      rh-mysql56-mysql-devel
      rh-mysql56-mysql-errmsg
      rh-mysql56-mysql-server
      rh-mysql56-mysql-test
      rh-mysql57-mysql-common
      rh-mysql57-mysql-config
      rh-mysql57-mysql-devel
      rh-mysql57-mysql-errmsg
      rh-mysql57-mysql-server
      rh-mysql57-mysql-test
    )
];

use constant known_mariadb_deps =&gt; {
    &#039;libdbi-perl&#039;      =&gt; &#039;&#039;,
    &#039;libvshadow-utils&#039; =&gt; &#039;&#039;,
    &#039;grep&#039;             =&gt; &#039;&#039;,
    &#039;coreutils&#039;        =&gt; &#039;&#039;,
};

use constant db_disable_auth_socket =&gt; {
    &#039;unix_socket&#039;     =&gt; &#039;OFF&#039;,
    &#039;plugin-load-add&#039; =&gt; &#039;auth_socket.so&#039;
};

use constant db_additional_conf_files     =&gt; [ &#039;/etc/mysql/debian.cnf&#039;, &#039;/etc/mysql/mariadb.cnf&#039; ];
use constant db_mariadb_default_conf_file =&gt; &#039;/etc/mysql/mariadb.cnf&#039;;
use constant db_mariadb_start_file        =&gt; &#039;/etc/mysql/debian-start&#039;;

use constant package_ImageMagick_Devel =&gt; &#039;libmagick++-6.q16-dev&#039;;
use constant package_crond             =&gt; &#039;cron&#039;;

use constant system_package_providing_perl =&gt; &#039;perl-base&#039;;

use constant bin_grub_mkconfig            =&gt; q[/usr/sbin/grub-mkconfig];
use constant program_to_apply_kernel_args =&gt; &#039;grub-mkconfig&#039;;

use constant package_descriptions =&gt; {
    &#039;short&#039; =&gt; &#039;description&#039;,
    &#039;long&#039;  =&gt; &#039;longdesc&#039;,
};

use constant tuxcare_els_php_install_url =&gt; &quot;https://go.cpanel.net/install-els-alt-php-deb-repo-ip&quot;;
use constant supports_phpels             =&gt; 1;

1;


} # --- END Cpanel/OS/Ubuntu.pm


{ # --- BEGIN Cpanel/OS/Ubuntu24.pm
package Cpanel::OS::Ubuntu24;


use cPstrict;
no warnings &#039;once&#039;;

# use parent Cpanel::OS::Ubuntu (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::OS::Ubuntu); }

use constant is_supported =&gt; 1;

use constant binary_sync_source         =&gt; &#039;linux-u24-x86_64&#039;;
use constant package_release_distro_tag =&gt; &#039;~u24&#039;;
use constant release_codename           =&gt; &#039;noble&#039;;

use constant binary_locations =&gt; {
    &#039;lsof&#039;            =&gt; &#039;/usr/bin&#039;,
    &#039;named-checkzone&#039; =&gt; &#039;/usr/bin&#039;,
    &#039;named-checkconf&#039; =&gt; &#039;/usr/bin&#039;,
};

use constant maillog_path =&gt; &#039;/var/log/mail.log&#039;;

use constant plugins_repo_url =&gt; &#039;https://securedownloads.cpanel.net/cpanel-plugins/xUbuntu_24.04.list&#039;;

use constant ea4_install_bare_repo  =&gt; 1;
use constant ea4_from_bare_repo_url =&gt; &#039;https://securedownloads.cpanel.net/EA4/xUbuntu_24.04.list&#039;;

use constant mysql_repo_template =&gt; &lt;&lt;&#039;___END_REPO_TEMPLATE___&#039;;
deb https://repo.mysql.com/apt/ubuntu/ noble mysql-apt-config
deb https://repo.mysql.com/apt/ubuntu/ noble mysql-###MYSQL_VERSION_SHORT###
deb https://repo.mysql.com/apt/ubuntu/ noble mysql-tools
deb-src https://repo.mysql.com/apt/ubuntu/ noble mysql-###MYSQL_VERSION_SHORT###
___END_REPO_TEMPLATE___

use constant mariadb_minimum_supported_version =&gt; &#039;10.11&#039;;

use constant mariadb_repo_template =&gt; &lt;&lt;&#039;___END_REPO_TEMPLATE___&#039;;
deb [arch=amd64,arm64] https://dlm.mariadb.com/repo/mariadb-server/###MARIADB_VERSION_SHORT###/repo/ubuntu noble main
deb [arch=amd64,arm64] https://dlm.mariadb.com/repo/mariadb-server/###MARIADB_VERSION_SHORT###/repo/ubuntu noble main/debug
___END_REPO_TEMPLATE___

use constant quota_packages_conditional =&gt; {

    &#039;linux-aws&#039;                 =&gt; [&#039;linux-modules-extra-aws&#039;],
    &#039;linux-aws-6.8&#039;             =&gt; [&#039;linux-modules-extra-aws-6.8&#039;],
    &#039;linux-aws-6.14&#039;            =&gt; [&#039;linux-modules-extra-aws-6.14&#039;],
    &#039;linux-aws-6.17&#039;            =&gt; [&#039;linux-modules-extra-aws-6.17&#039;],
    &#039;linux-aws-edge&#039;            =&gt; [&#039;linux-modules-extra-aws-edge&#039;],
    &#039;linux-aws-lts-24.04&#039;       =&gt; [&#039;linux-modules-extra-aws-lts-24.04&#039;],
    &#039;linux-azure&#039;               =&gt; [&#039;linux-modules-extra-azure&#039;],
    &#039;linux-azure-6.8&#039;           =&gt; [&#039;linux-modules-extra-azure-6.8&#039;],
    &#039;linux-azure-6.11&#039;          =&gt; [&#039;linux-modules-extra-azure-6.11&#039;],
    &#039;linux-azure-6.14&#039;          =&gt; [&#039;linux-modules-extra-azure-6.14&#039;],
    &#039;linux-azure-6.17&#039;          =&gt; [&#039;linux-modules-extra-azure-6.17&#039;],
    &#039;linux-azure-edge&#039;          =&gt; [&#039;linux-modules-extra-azure-edge&#039;],
    &#039;linux-azure-lts-24.04&#039;     =&gt; [&#039;linux-modules-extra-azure-lts-24.04&#039;],
    &#039;linux-azure-fde&#039;           =&gt; [&#039;linux-modules-extra-azure-fde&#039;],
    &#039;linux-azure-fde-6.8&#039;       =&gt; [&#039;linux-modules-extra-azure-fde-6.8&#039;],
    &#039;linux-azure-fde-6.11&#039;      =&gt; [&#039;linux-modules-extra-azure-fde-6.11&#039;],
    &#039;linux-azure-fde-6.14&#039;      =&gt; [&#039;linux-modules-extra-azure-fde-6.14&#039;],
    &#039;linux-azure-fde-6.17&#039;      =&gt; [&#039;linux-modules-extra-azure-fde-6.17&#039;],
    &#039;linux-azure-fde-edge&#039;      =&gt; [&#039;linux-modules-extra-azure-fde-edge&#039;],
    &#039;linux-azure-fde-lts-24.04&#039; =&gt; [&#039;linux-modules-extra-azure-fde-lts-24.04&#039;],
    &#039;linux-gcp&#039;                 =&gt; [&#039;linux-modules-extra-gcp&#039;],
    &#039;linux-gcp-6.8&#039;             =&gt; [&#039;linux-modules-extra-gcp-6.8&#039;],
    &#039;linux-gcp-6.11&#039;            =&gt; [&#039;linux-modules-extra-gcp-6.11&#039;],
    &#039;linux-gcp-6.14&#039;            =&gt; [&#039;linux-modules-extra-gcp-6.14&#039;],
    &#039;linux-gcp-6.17&#039;            =&gt; [&#039;linux-modules-extra-gcp-6.17&#039;],
    &#039;linux-gcp-edge&#039;            =&gt; [&#039;linux-modules-extra-gcp-edge&#039;],
    &#039;linux-gcp-lts-24.04&#039;       =&gt; [&#039;linux-modules-extra-gcp-lts-24.04&#039;],
    &#039;linux-gkeop&#039;               =&gt; [&#039;linux-modules-extra-gkeop&#039;],
    &#039;linux-gkeop-6.8&#039;           =&gt; [&#039;linux-modules-extra-gkeop-6.8&#039;],

    &#039;linux-virtual&#039;      =&gt; [&#039;linux-image-extra-virtual&#039;],
    &#039;linux-virtual-6.8&#039;  =&gt; [&#039;linux-image-extra-virtual-6.8&#039;],
    &#039;linux-virtual-6.11&#039; =&gt; [&#039;linux-image-extra-virtual-6.11&#039;],
    &#039;linux-virtual-6.14&#039; =&gt; [&#039;linux-image-extra-virtual-6.14&#039;],
    &#039;linux-virtual-6.17&#039; =&gt; [&#039;linux-image-extra-virtual-6.17&#039;],
};

sub packages_required ($self) {
    my %changes = (
        &quot;libaio1&quot;                        =&gt; &quot;libaio1t64&quot;,
        &quot;libboost-program-options1.74.0&quot; =&gt; &quot;libboost-program-options1.83.0&quot;,
        &quot;libevent-2.1-7&quot;                 =&gt; &quot;libevent-2.1-7t64&quot;,
        &quot;libffi7&quot;                        =&gt; &quot;libffi8&quot;,
        &quot;libicu70&quot;                       =&gt; &quot;libicu74&quot;,
        &quot;libncurses5&quot;                    =&gt; &quot;libncurses6&quot;,
        &quot;libpcap0.8&quot;                     =&gt; &quot;libpcap0.8t64&quot;,
        &quot;libsqlite0&quot;                     =&gt; &quot;libsqlite3-0&quot;,
        &quot;libtiff5&quot;                       =&gt; &quot;libtiff6&quot;,
        &quot;libzip4&quot;                        =&gt; &quot;libzip4t64&quot;,
        &quot;python-setuptools&quot;              =&gt; &quot;python3-setuptools&quot;,
    );

    my @packages = map { exists $changes{$_} ? () : $_ } grep { $_ ne &#039;usrmerge&#039; &amp;&amp; $_ ne &#039;sqlite&#039; } @{ $self-&gt;SUPER::packages_required() };
    push @packages, values %changes;
    return [ sort @packages ];
}

1;


} # --- END Cpanel/OS/Ubuntu24.pm


{ # --- BEGIN Cpanel/OS/All.pm
package Cpanel::OS::All;


use cPstrict;
no warnings &#039;once&#039;;
use utf8;

# use Cpanel::OS::Almalinux8   ();    # PPI USE OK - fatpack usage # perlpkg line 211
# use Cpanel::OS::Almalinux9   ();    # PPI USE OK - fatpack usage # perlpkg line 211
# use Cpanel::OS::Almalinux10  ();    # PPI USE OK - fatpack usage # perlpkg line 211
# use Cpanel::OS::Cloudlinux8  ();    # PPI USE OK - fatpack usage # perlpkg line 211
# use Cpanel::OS::Cloudlinux9  ();    # PPI USE OK - fatpack usage # perlpkg line 211
# use Cpanel::OS::Cloudlinux10 ();    # PPI USE OK - fatpack usage # perlpkg line 211
# use Cpanel::OS::Ubuntu24     ();    # PPI USE OK - fatpack usage # perlpkg line 211

sub supported_distros() {
    return (
        [ Almalinux  =&gt; 8 ],
        [ Almalinux  =&gt; 9 ],
        [ Almalinux  =&gt; 10 ],
        [ Cloudlinux =&gt; 8 ],
        [ Cloudlinux =&gt; 9 ],
        [ Cloudlinux =&gt; 10 ],
        [ Ubuntu     =&gt; 24 ],
    );
}

sub advertise_supported_distros() {

    my $current_name;
    my $current_versions = [];

    my $advertise = &#039;&#039;;

    my $map_os_display_name = {
        &#039;Almalinux&#039;  =&gt; &#039;AlmaLinux&#039;,
        &#039;Rhel&#039;       =&gt; &#039;Red Hat Enterprise Linux&#039;,
        &#039;Cloudlinux&#039; =&gt; &#039;CloudLinux&amp;reg;&#039;,
    };

    foreach my $d ( supported_distros() ) {
        my ( $name, $version ) = $d-&gt;@*;

        if ( !defined $current_name ) {
            $current_name = $name;
            push $current_versions-&gt;@*, $version;
            next;
        }

        if ( $current_name eq $name ) {
            push $current_versions-&gt;@*, $version;
        }
        else {
            my $display_name = $map_os_display_name-&gt;{$current_name} // $current_name;
            $advertise .= $display_name . &#039; &#039; . join( &#039;/&#039;, $current_versions-&gt;@* ) . &#039;, &#039;;
            $current_name     = $name;
            $current_versions = [$version];
        }
    }

    if ( defined $current_name ) {
        my $display_name = $map_os_display_name-&gt;{$current_name} // $current_name;
        $advertise .= $display_name . &#039; &#039; . join( &#039;/&#039;, $current_versions-&gt;@* );
    }

    return $advertise;
}

1;


} # --- END Cpanel/OS/All.pm


{ # --- BEGIN Cpanel/TimeHiRes.pm
package Cpanel::TimeHiRes;


use strict;
use warnings;
no warnings &#039;once&#039;;


use constant {
    _gettimeofday =&gt; 96,

    _clock_gettime  =&gt; 228,
    _CLOCK_REALTIME =&gt; 0,

    _EINTR =&gt; 4,

    _PACK_TEMPLATE =&gt; &#039;L!L!&#039;,
};


sub clock_gettime {
    my $timeval = pack( _PACK_TEMPLATE, () );

    _get_time_from_syscall(
        _clock_gettime,
        _CLOCK_REALTIME,
        $timeval,
    );

    return unpack( _PACK_TEMPLATE, $timeval );
}


sub time {
    my ( $secs, $nsecs ) = clock_gettime();

    return $secs + ( $nsecs / 1_000_000_000 );
}


sub sleep {
    my ($secs) = @_;


    local $!;
    my $retval = select( undef, undef, undef, $secs );
    if ( $retval == -1 &amp;&amp; $! != _EINTR ) {
        require Cpanel::Exception;
        die &#039;Cpanel::Exception&#039;-&gt;can(&#039;create&#039;)-&gt;( &#039;SystemCall&#039;, &#039;The system failed to suspend command execution for [quant,_1,second,seconds] because of an error: [_2]&#039;, [ $secs, $! ] );
    }

    return $secs;
}


sub gettimeofday {
    my $timeval = pack( _PACK_TEMPLATE, () );

    _get_time_from_syscall(
        _gettimeofday,
        $timeval,
        undef,
    );

    return unpack( _PACK_TEMPLATE, $timeval );
}


sub _get_time_from_syscall {    ##no critic qw(RequireArgUnpacking)
    my $syscall_num = shift;

    local $!;
    my $retval = syscall( $syscall_num, @_ );
    if ( $retval == -1 ) {
        require Cpanel::Exception;
        die &#039;Cpanel::Exception&#039;-&gt;can(&#039;create&#039;)-&gt;( &#039;SystemCall&#039;, &#039;The system failed to retrieve the time because of an error: [_1]&#039;, [$!] );
    }

    return;
}

1;

} # --- END Cpanel/TimeHiRes.pm


{ # --- BEGIN Cpanel/Struct/Common/Time.pm
package Cpanel::Struct::Common::Time;


use strict;
use warnings;
no warnings &#039;once&#039;;


use constant PACK_TEMPLATE =&gt; &#039;L!L!&#039;;

my %CLASS_PRECISION;


sub float_to_binary {
    return pack(
        PACK_TEMPLATE(),

        int( $_[1] ),

        int( 0.5 + ( $_[0]-&gt;_PRECISION() * $_[1] ) - ( $_[0]-&gt;_PRECISION() * int( $_[1] ) ) ),
    );
}


sub binary_to_float {
    return $_[0]-&gt;_binary_to_float( PACK_TEMPLATE(), $_[1] )-&gt;[0];
}


sub binaries_to_floats_at {
    return $_[0]-&gt;_binary_to_float(
        &quot;\@$_[3] &quot; . ( PACK_TEMPLATE() x $_[2] ),
        $_[1],
    );
}


my ( $i, $precision, @sec_psec_pairs );

sub _binary_to_float {    ## no critic qw(RequireArgUnpacking)
    @sec_psec_pairs = unpack( $_[1], $_[2] );

    $i = 0;

    my @floats;

    $precision = $CLASS_PRECISION{ $_[0] } ||= $_[0]-&gt;_PRECISION();

    while ( $i &lt; @sec_psec_pairs ) {


        push @floats, 0 + ( q&lt;&gt; . ( $sec_psec_pairs[$i] + ( $sec_psec_pairs[ $i + 1 ] / $precision ) ) );
        $i += 2;
    }

    return \@floats;
}

1;

} # --- END Cpanel/Struct/Common/Time.pm


{ # --- BEGIN Cpanel/Struct/timespec.pm
package Cpanel::Struct::timespec;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use parent Cpanel::Struct::Common::Time (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::Struct::Common::Time); }

use constant {
    _PRECISION =&gt; 1_000_000_000,    # nanoseconds
};

1;

} # --- END Cpanel/Struct/timespec.pm


{ # --- BEGIN Cpanel/NanoStat.pm
package Cpanel::NanoStat;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use Cpanel::Struct::timespec (); # perlpkg line 211

use constant {
    _NR_stat  =&gt; 4,
    _NR_fstat =&gt; 5,
    _NR_lstat =&gt; 6,
};

use constant _PACK_TEMPLATE =&gt; q&lt;
    Q       # st_dev
    Q       # st_ino

    @24 L   # st_mode
    @16 Q   # st_nlink

    @28
    L       # st_uid
    L       # st_gid

    x![Q]
    Q       # st_rdev
    Q       # st_size
    Q       # st_blksize
    Q       # st_blocks
&gt;;

my $pre_times_pack_len = length pack _PACK_TEMPLATE();

my $buf = ( &quot;\0&quot; x 144 );


sub stat {
    return _syscall( _NR_stat(), $_[0] );
}


sub lstat {
    return _syscall( _NR_lstat(), $_[0] );
}


sub fstat {
    return _syscall( _NR_fstat(), 0 + ( ref( $_[0] ) ? fileno( $_[0] ) : $_[0] ) );
}


sub _syscall {    ## no critic qw(RequireArgUnpacking)
    my $arg_dupe = $_[1];
    return undef if -1 == syscall( $_[0], $arg_dupe, $buf );
    my @vals = unpack _PACK_TEMPLATE(), $buf;
    splice(
        @vals, 8, 0,
        @{ Cpanel::Struct::timespec-&gt;binaries_to_floats_at( $buf, 3, $pre_times_pack_len ) },
    );

    return @vals;
}

1;

} # --- END Cpanel/NanoStat.pm


{ # --- BEGIN Cpanel/NanoUtime.pm
package Cpanel::NanoUtime;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use Cpanel::Struct::timespec (); # perlpkg line 211

use constant {
    _NR_utimensat =&gt; 280,

    _AT_FDCWD            =&gt; -100,
    _AT_SYMLINK_NOFOLLOW =&gt; 0x100,
};


sub utime {
    return _syscall( 0 + _AT_FDCWD(), $_[2], @_[ 0, 1 ], 0 );
}


sub futime {
    return _syscall(
        0 + ( ref( $_[2] ) ? fileno( $_[2] ) : $_[2] ),
        undef,
        @_[ 0, 1 ],
        0,
    );
}


sub lutime {
    return _syscall( 0 + _AT_FDCWD(), $_[2], @_[ 0, 1 ], 0 + _AT_SYMLINK_NOFOLLOW() );
}

my ( $path, $buf ) = @_;

sub _syscall {

    if ( defined $_[-3] ) {
        if ( defined $_[-2] ) {
            $buf = Cpanel::Struct::timespec-&gt;float_to_binary( $_[-3] ) . Cpanel::Struct::timespec-&gt;float_to_binary( $_[-2] );
        }
        else {
            die &quot;atime is “$_[-3]”, but mtime is undef!&quot;;
        }
    }
    elsif ( defined $_[-2] ) {
        die &quot;atime is undef, but mtime is “$_[-2]”!&quot;;
    }
    else {
        $buf = undef;
    }

    $path = $_[1];

    return undef if -1 == syscall( 0 + _NR_utimensat(), $_[0], $path // undef, $buf // undef, $_[-1] );

    return 1;
}

1;

} # --- END Cpanel/NanoUtime.pm


{ # --- BEGIN Cpanel/HiRes.pm
package Cpanel::HiRes;


use strict;
use warnings;
no warnings &#039;once&#039;;


my %_routes = (


    &#039;fstat&#039; =&gt; [ &#039;NanoStat&#039;, &#039;fstat&#039;, &#039;stat&#039;,  1 ],
    &#039;lstat&#039; =&gt; [ &#039;NanoStat&#039;, &#039;lstat&#039;, &#039;lstat&#039;, 1 ],
    &#039;stat&#039;  =&gt; [ &#039;NanoStat&#039;, &#039;stat&#039;,  &#039;stat&#039;,  1 ],

    &#039;time&#039; =&gt; [ &#039;TimeHiRes&#039;, &#039;time&#039;, &#039;time&#039; ],

    &#039;utime&#039;  =&gt; [ &#039;NanoUtime&#039;, &#039;utime&#039;,  &#039;utime&#039; ],
    &#039;futime&#039; =&gt; [ &#039;NanoUtime&#039;, &#039;futime&#039;, &#039;utime&#039; ],

    &#039;lutime&#039; =&gt; [ &#039;NanoUtime&#039;, &#039;lutime&#039;, undef ],
);

my $preloaded;


sub import {
    my ( $class, %opts ) = @_;

    if ( my $preload = $opts{&#039;preload&#039;} ) {
        if ( $preload eq &#039;xs&#039; ) {
            require Time::HiRes;
        }
        elsif ( $preload eq &#039;perl&#039; ) {
            if ( !$preloaded ) {
                require Cpanel::TimeHiRes;    # PPI USE OK - preload
                require Cpanel::NanoStat;     # PPI USE OK - preload
                require Cpanel::NanoUtime;    # PPI USE OK - preload
            }
        }
        else {
            die &quot;Unknown “preload”: “$preload”&quot;;
        }

        $preloaded = $preload;
    }

    return;
}

our $AUTOLOAD;


sub AUTOLOAD {    ## no critic qw(Subroutines::RequireArgUnpacking)
    substr( $AUTOLOAD, 0, 1 + rindex( $AUTOLOAD, &#039;:&#039; ) ) = q&lt;&gt;;

    if ( !$AUTOLOAD || !$_routes{$AUTOLOAD} ) {
        die &quot;Unknown function in Cpanel::HiRes::$_[0]&quot;;
    }

    my $function = $AUTOLOAD;

    undef $AUTOLOAD;

    my ( $pp_module, $pp_function, $xs_function, $xs_needs_closure ) = @{ $_routes{$function} };

    no strict &#039;refs&#039;;

    if ( $INC{&#039;Time/HiRes.pm&#039;} &amp;&amp; $xs_function ) {
        *$function = *{&quot;Time::HiRes::$xs_function&quot;};
        return Time::HiRes-&gt;can($xs_function)-&gt;(@_);
    }
    else {

        _require(&quot;Cpanel/${pp_module}.pm&quot;) if !$INC{&quot;Cpanel/${pp_module}.pm&quot;};

        my $pp_cr = &quot;Cpanel::${pp_module}&quot;-&gt;can($pp_function);

        if ($xs_function) {
            *$function = sub {

                if ( $INC{&#039;Time/HiRes.pm&#039;} ) {
                    *$function = *{&quot;Time::HiRes::$xs_function&quot;};
                    return Time::HiRes-&gt;can($xs_function)-&gt;(@_);
                }

                goto &amp;$pp_cr;
            };
        }
        else {
            *$function = $pp_cr;
        }
    }

    goto &amp;$function;
}

sub _require {
    local ( $!, $^E, $@ );

    require $_[0];
    return;
}

1;

} # --- END Cpanel/HiRes.pm


{ # --- BEGIN Cpanel/Env.pm
package Cpanel::Env;


use strict;
use warnings;
no warnings &#039;once&#039;;

our $VERSION = &#039;1.7&#039;;

my $SAFE_ENV_VARS;

BEGIN {
    $SAFE_ENV_VARS = q&lt;
        ALLUSERSPROFILE
        APPDATA
        BUNDLE_PATH
        CLIENTNAME
        COMMONPROGRAMFILES
        COMPUTERNAME
        COMSPEC
        CPANEL_BASE_INSTALL
        CPANEL_IS_CRON
        CPANEL_RPM_LOCKED_IN_PARENT
        CPBACKUP
        DEBIAN_FRONTEND
        DEBIAN_PRIORITY
        DOCUMENT_ROOT
        FORCEDCPUPDATE
        FP_NO_HOST_CHECK
        HOMEDRIVE
        HOMEPATH
        LANG
        LANGUAGE
        LC_ALL
        LC_MESSAGES
        LC_CTYPE
        LOGONSERVER
        NEWWHMUPDATE
        NOTIFY_SOCKET
        NUMBER_OF_PROCESSORS
        OPENSSL_NO_DEFAULT_ZLIB
        OS
        PATH
        PATHEXT
        PROCESSOR_ARCHITECTURE
        PROCESSOR_IDENTIFIER
        PROCESSOR_LEVEL
        PROCESSOR_REVISION
        PROGRAMFILES
        PROMPT
        PYTHONIOENCODING
        SERVER_SOFTWARE
        SESSIONNAME
        SKIP_DEFERRAL_CHECK
        SSH_CLIENT
        SYSTEMDRIVE
        SYSTEMROOT
        TEMP
        TERM
        TMP
        UPDATENOW_NO_RETRY
        UPDATENOW_PRESERVE_FAILED_FILES
        USERDOMAIN
        USERNAME
        USERPROFILE
        WINDIR
    &gt;;

    $SAFE_ENV_VARS =~ tr&lt;\n &gt;&lt; &gt;s;
    $SAFE_ENV_VARS =~ s&lt;\A\s+&gt;&lt;&gt;;
}


{
    no warnings &#039;once&#039;;
    *cleanenv = *clean_env;
}

sub clean_env {
    my %OPTS = @_;

    my %SAFE_ENV_VARS = map { $_ =&gt; undef } split( m{ }, $SAFE_ENV_VARS );

    if ( defined $OPTS{&#039;keep&#039;} &amp;&amp; ref $OPTS{&#039;keep&#039;} eq &#039;ARRAY&#039; ) {
        @SAFE_ENV_VARS{ @{ $OPTS{&#039;keep&#039;} } } = undef;
    }

    if ( defined $OPTS{&#039;delete&#039;} &amp;&amp; ref $OPTS{&#039;delete&#039;} eq &#039;ARRAY&#039; ) {
        delete @SAFE_ENV_VARS{ @{ $OPTS{&#039;delete&#039;} } };
    }

    delete @ENV{ grep { !exists $SAFE_ENV_VARS{$_} } keys %ENV };
    if ( $OPTS{&#039;http_purge&#039;} ) {
        delete @ENV{ &#039;SERVER_SOFTWARE&#039;, &#039;DOCUMENT_ROOT&#039; };
    }

    return;
}

sub get_safe_env_vars {
    return $SAFE_ENV_VARS;
}

sub get_safe_path {
    return &#039;/usr/local/jdk/bin:/usr/kerberos/sbin:/usr/kerberos/bin:/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/usr/X11R6/bin:/usr/local/bin:/usr/X11R6/bin:/root/bin:/opt/bin&#039;;
}

sub set_safe_path {
    return ( $ENV{&#039;PATH&#039;} = get_safe_path() );
}

1;

} # --- END Cpanel/Env.pm


{ # --- BEGIN Cpanel/Autodie.pm
package Cpanel::Autodie;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub _ENOENT { return 2; }
sub _EEXIST { return 17; }
sub _EINTR  { return 4; }

sub import {
    shift;

    _load_function($_) for @_;

    return;
}

our $AUTOLOAD;

sub AUTOLOAD {
    substr( $AUTOLOAD, 0, 1 + rindex( $AUTOLOAD, &#039;:&#039; ) ) = q&lt;&gt;;

    _load_function($AUTOLOAD);

    goto &amp;{ Cpanel::Autodie-&gt;can($AUTOLOAD) };
}

sub _load_function {
    _require(&quot;Cpanel/Autodie/CORE/$_[0].pm&quot;);

    return;
}

sub _require {
    local ( $!, $^E, $@ );

    require $_[0];
    return;
}

1;

} # --- END Cpanel/Autodie.pm


{ # --- BEGIN Cpanel/Fcntl/Constants.pm
package Cpanel::Fcntl::Constants;


use strict;
use warnings;
no warnings &#039;once&#039;;


BEGIN {
    our $O_RDONLY  = 0;
    our $O_WRONLY  = 1;
    our $O_RDWR    = 2;
    our $O_ACCMODE = 3;

    our $F_GETFD = 1;
    our $F_SETFD = 2;
    our $F_GETFL = 3;
    our $F_SETFL = 4;

    our $SEEK_SET    = 0;
    our $SEEK_CUR    = 1;
    our $SEEK_END    = 2;
    our $S_IWOTH     = 2;
    our $S_ISUID     = 2048;
    our $S_ISGID     = 1024;
    our $O_CREAT     = 64;
    our $O_EXCL      = 128;
    our $O_TRUNC     = 512;
    our $O_APPEND    = 1024;
    our $O_NONBLOCK  = 2048;
    our $O_DIRECTORY = 65536;
    our $O_NOFOLLOW  = 131072;
    our $O_CLOEXEC   = 524288;

    our $S_IFREG  = 32768;
    our $S_IFDIR  = 16384;
    our $S_IFCHR  = 8192;
    our $S_IFBLK  = 24576;
    our $S_IFIFO  = 4096;
    our $S_IFLNK  = 40960;
    our $S_IFSOCK = 49152;
    our $S_IFMT   = 61440;

    our $LOCK_SH = 1;
    our $LOCK_EX = 2;
    our $LOCK_NB = 4;
    our $LOCK_UN = 8;

    our $FD_CLOEXEC = 1;
}

1;

} # --- END Cpanel/Fcntl/Constants.pm


{ # --- BEGIN Cpanel/Fcntl.pm
package Cpanel::Fcntl;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Fcntl::Constants (); # perlpkg line 211

my %CONSTANTS;
my %CACHE;

sub or_flags {
    my (@flags) = @_;
    my $flag_cache_key = join( &#039;|&#039;, @flags );
    return $CACHE{$flag_cache_key} if defined $CACHE{$flag_cache_key};
    my $numeric = 0;
    foreach my $o_const (@flags) {
        $numeric |= (
            $CONSTANTS{$o_const} ||= do {
                my $glob     = $Cpanel::Fcntl::Constants::{$o_const};
                my $number_r = $glob &amp;&amp; *{$glob}{&#039;SCALAR&#039;};

                die &quot;Missing \$Cpanel::Fcntl::Constants::$o_const! (does it need to be added?)&quot; if !$number_r;

                $$number_r;
            }
        );
    }
    return ( $CACHE{$flag_cache_key} = $numeric );
}

1;

} # --- END Cpanel/Fcntl.pm


{ # --- BEGIN Cpanel/FileUtils/Touch.pm
package Cpanel::FileUtils::Touch;


use strict;
use warnings;
no warnings &#039;once&#039;;


use Try::Tiny;

use Cpanel::Autodie;
use Cpanel::Fcntl;


sub touch_if_not_exists {
    my ($path) = @_;

    my $fh;


    try {

        Cpanel::Autodie::sysopen(
            $fh,
            $path,
            Cpanel::Fcntl::or_flags(qw( O_WRONLY  O_CREAT  O_EXCL )),
        );
    }
    catch {
        undef $fh;

        if ( !try { $_-&gt;error_name() eq &#039;EEXIST&#039; } ) {
            local $@ = $_;
            die;
        }
    };

    return $fh ? 1 : 0;
}

1;

} # --- END Cpanel/FileUtils/Touch.pm


{ # --- BEGIN Cpanel/Config/TouchFileBase.pm
package Cpanel::Config::TouchFileBase;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use Cpanel::Autodie   (); # perlpkg line 211
# use Cpanel::Exception (); # perlpkg line 211

sub _TOUCH_FILE { die Cpanel::Exception::create(&#039;AbstractClass&#039;) }

sub is_on {
    my ( $self, @args ) = @_;

    my $exists = Cpanel::Autodie::exists( $self-&gt;_TOUCH_FILE(@args) );

    if ( $exists &amp;&amp; !-f _ ) {
        die Cpanel::Exception-&gt;create( &#039;“[_1]” exists but is not a file!&#039;, [ $self-&gt;_TOUCH_FILE(@args) ] );
    }

    return $exists;
}

sub set_on {
    my ( $self, @args ) = @_;

    my $path = $self-&gt;_TOUCH_FILE(@args);

    require Cpanel::FileUtils::Touch;

    return Cpanel::FileUtils::Touch::touch_if_not_exists($path);
}

sub set_off {
    my ( $self, @args ) = @_;

    return Cpanel::Autodie::unlink_if_exists( $self-&gt;_TOUCH_FILE(@args) );
}

1;

} # --- END Cpanel/Config/TouchFileBase.pm


{ # --- BEGIN Cpanel/Update/IsCron.pm
package Cpanel::Update::IsCron;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use parent Cpanel::Config::TouchFileBase (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::Config::TouchFileBase); }

our $_PATH = &#039;/var/cpanel/upgrade_is_from_cron&#039;;

sub _TOUCH_FILE { return $_PATH }

1;

} # --- END Cpanel/Update/IsCron.pm


{ # --- BEGIN Cpanel/Time/Local.pm
package Cpanel::Time::Local;


use strict;


our $server_offset_string;
our ( $timecacheref, $localtimecacheref ) = ( [ -1, &#039;&#039;, -1 ], [ -1, &#039;&#039;, -1 ] );

my $server_offset;
my $localtime_link_or_mtime;
our $ETC_LOCALTIME = q{/etc/localtime};

sub _clear_caches {
    undef $_
      for (
        $server_offset,
        $server_offset_string,
        $timecacheref,
        $localtimecacheref,
        $localtime_link_or_mtime,
      );
    return;
}

sub localtime2timestamp {
    my ( $time, $delimiter ) = @_;
    $delimiter ||= &#039; &#039;;
    $time      ||= time();

    return $localtimecacheref-&gt;[2] if $localtimecacheref-&gt;[0] == $time &amp;&amp; $localtimecacheref-&gt;[1] eq $delimiter;

    my $tz_offset = get_server_offset_as_offset_string($time);

    my ( $sec, $min, $hour, $mday, $mon, $year ) = localtime $time;
    @{$localtimecacheref}[ 0, 1 ] = ( $time, $delimiter );
    return ( $localtimecacheref-&gt;[2] = sprintf( &#039;%04d-%02d-%02d&#039; . $delimiter . &#039;%02d:%02d:%02d %s&#039;, $year + 1900, $mon + 1, $mday, $hour, $min, $sec, $tz_offset ) );
}

sub get_server_offset_as_offset_string {
    my ($time_supplied) = @_;

    if ( !$time_supplied ) {
        my $link_or_mtime;
        if ( -l $ETC_LOCALTIME ) {
            $link_or_mtime = readlink($ETC_LOCALTIME);
        }
        else {
            $link_or_mtime = ( stat($ETC_LOCALTIME) )[9];
        }
        if ( defined $link_or_mtime ) {
            $localtime_link_or_mtime ||= $link_or_mtime;

            if ( $localtime_link_or_mtime ne $link_or_mtime ) {
                _clear_caches();
                $localtime_link_or_mtime = $link_or_mtime;
            }
        }
    }

    if ( $time_supplied || !defined $server_offset_string ) {

      UNTIL_SAME_SECOND: {
            my $starttime = time();
            my $time      = $time_supplied || $starttime;
            my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday ) = localtime $time;

            my ( $gmmin, $gmhour, $gmyear, $gmyday ) = ( gmtime($time) )[ 1, 2, 5, 7 ];

            redo UNTIL_SAME_SECOND if time != $starttime;

            my $yday_offset;
            if ( $year == $gmyear ) {
                $yday_offset = ( $yday &lt;=&gt; $gmyday );
            }
            elsif ( $year &lt; $gmyear ) {
                $yday_offset = -1;
            }
            elsif ( $year &gt; $gmyear ) {
                $yday_offset = 1;
            }

            my $gmoffset      = ( $hour * 60 + $min ) - ( $gmhour * 60 + $gmmin ) + 1440 * $yday_offset;
            my $offset_string = sprintf( &#039;%+03d%02d&#039;, int( $gmoffset / 60 ), $gmoffset % 60 );
            if ($time_supplied) {
                return $offset_string;
            }
            else {
                $server_offset_string = $offset_string;
            }
        }
    }
    return $server_offset_string;
}

sub get_server_offset_in_seconds {
    if ( !defined $server_offset ) {
        if ( get_server_offset_as_offset_string() =~ m/([-+]?[0-9]{2})([0-9]{2})/ ) {
            my ( $hours, $minutes ) = ( $1, $2 );
            my $seconds = ( ( abs($hours) * 60 * 60 ) + ( $minutes * 60 ) );
            $server_offset = $hours &lt; 0 ? &quot;-$seconds&quot; : $seconds;
        }
        else {

            $server_offset = 0;
        }
    }
    return $server_offset;
}

1;

} # --- END Cpanel/Time/Local.pm


{ # --- BEGIN Cpanel/FileUtils/Open.pm
package Cpanel::FileUtils::Open;


use strict;

# use Cpanel::Fcntl (); # perlpkg line 211

sub sysopen_with_real_perms {    ##no critic qw(RequireArgUnpacking)
    my ( $file, $mode, $custom_perms ) = ( @_[ 1 .. 3 ] );

    if ( $mode &amp;&amp; substr( $mode, 0, 1 ) eq &#039;O&#039; ) {
        $mode = Cpanel::Fcntl::or_flags( split m&lt;\|&gt;, $mode );
    }

    my ( $sysopen_perms, $original_umask );

    if ( defined $custom_perms ) {
        $custom_perms &amp;= 0777;
        $original_umask = umask( $custom_perms ^ 07777 );
        $sysopen_perms  = $custom_perms;
    }
    else {
        $sysopen_perms = 0666;
    }

    my $ret = sysopen( $_[0], $file, $mode, $sysopen_perms );

    if ( defined $custom_perms ) {

        () = umask($original_umask);
    }

    return $ret;
}

1;

} # --- END Cpanel/FileUtils/Open.pm


{ # --- BEGIN Cpanel/Parser/Vars.pm
package Cpanel::Parser::Vars;


use strict;

our $current_tag            = &#039;&#039;;
our $can_leave_cpanelaction = 1;
our $buffer                 = &#039;&#039;;

our $loaded_api   = 0;
our $trial_mode   = 0;
our $sent_headers = 0;
our $live_socket_file;

our $incpanelaction = 0;
our $altmode        = 0;
our $jsonmode       = 0;
our $javascript     = 0;
our $title          = 0;
our $input          = 0;
our $style          = 0;
our $embtag         = 0;
our $textarea       = 0;

our $file           = &#039;[stdin]&#039;;
our $firstfile      = &#039;[stdin]&#039;;
our $trap_defaultfh = undef;       # Known to be boolean.

our %BACKCOMPAT;

our $cptag;
our $sent_content_type;

1;

} # --- END Cpanel/Parser/Vars.pm


{ # --- BEGIN Cpanel/Encoder/Tiny/Rare.pm
package Cpanel::Encoder::Tiny::Rare;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub angle_bracket_decode {
    my ($string) = @_;
    $string =~ s{ &amp;lt; }{&lt;}xmsg;
    $string =~ s{ &amp;gt; }{&gt;}xmsg;
    return $string;
}


sub decode_utf8_html_entities {
    my $str = shift;
    $str =~ s/&amp;\#(\d{4})\;/chr($1);/eg;
    return $str;
}

my %uri_encoding_cache = (
    &#039;&quot;&#039;  =&gt; &#039;%22&#039;,
    q{&#039;} =&gt; &#039;%27&#039;,
    &#039;(&#039;  =&gt; &#039;%28&#039;,
    &#039;)&#039;  =&gt; &#039;%29&#039;,
    q{ } =&gt; &#039;%20&#039;,
    &quot;\t&quot; =&gt; &#039;%09&#039;,
);


sub css_encode_str {
    my $str = shift;
    $str =~ s{([\(\)\s&quot;&#039;])}{
        $uri_encoding_cache{$1}
        || require Cpanel::Encoder::URI &amp;&amp; Cpanel::Encoder::URI::uri_encode_str($1)
    }ge;
    return $str;
}

1;

} # --- END Cpanel/Encoder/Tiny/Rare.pm


{ # --- BEGIN Cpanel/Encoder/Tiny.pm
package Cpanel::Encoder::Tiny;


use strict;

my %XML_ENCODE_MAP  = ( &#039;&amp;&#039;   =&gt; &#039;&amp;amp;&#039;, &#039;&lt;&#039;  =&gt; &#039;&amp;lt;&#039;, &#039;&gt;&#039;  =&gt; &#039;&amp;gt;&#039;, &#039;&quot;&#039;    =&gt; &#039;&amp;quot;&#039;, &quot;&#039;&quot;    =&gt; &#039;&amp;apos;&#039; );
my %HTML_ENCODE_MAP = ( &#039;&amp;&#039;   =&gt; &#039;&amp;amp;&#039;, &#039;&lt;&#039;  =&gt; &#039;&amp;lt;&#039;, &#039;&gt;&#039;  =&gt; &#039;&amp;gt;&#039;, &#039;&quot;&#039;    =&gt; &#039;&amp;quot;&#039;, &quot;&#039;&quot;    =&gt; &#039;&amp;#39;&#039; );
my %HTML_DECODE_MAP = ( &#039;amp&#039; =&gt; &#039;&amp;&#039;,     &#039;lt&#039; =&gt; &#039;&lt;&#039;,    &#039;gt&#039; =&gt; &#039;&gt;&#039;,    &#039;quot&#039; =&gt; &#039;&quot;&#039;,      &#039;apos&#039; =&gt; q{&#039;}, &#039;#39&#039; =&gt; q{&#039;} );

my $decode_regex = do { my $tmp = join( &#039;|&#039;, keys %HTML_DECODE_MAP ); &quot;&amp;($tmp);&quot;; };

sub angle_bracket_encode {
    my ($string) = @_;
    $string =~ s{&lt;}{&amp;lt;}xmsg;
    $string =~ s{&gt;}{&amp;gt;}xmsg;
    return $string;
}

sub safe_xml_encode_str {
    my $data = join( &#039;&#039;, @_ );
    return $data if $data !~ tr/&amp;&lt;&gt;&quot;&#039;//;
    $data =~ s/([&amp;&lt;&gt;&quot;&#039;])/$XML_ENCODE_MAP{$1}/sg;
    return $data;
}

sub safe_html_encode_str {
    return $_[0] if !defined $_[0] || ( !defined $_[1] &amp;&amp; $_[0] !~ tr/&amp;&lt;&gt;&quot;&#039;// );
    my $data = defined $_[1] ? join( &#039;&#039;, @_ ) : $_[0];
    return $data if $data !~ tr/&amp;&lt;&gt;&quot;&#039;//;
    $data =~ s/([&amp;&lt;&gt;&quot;&#039;])/$HTML_ENCODE_MAP{$1}/sg;
    return $data;
}

sub safe_html_decode_str {
    return undef if !defined $_[0];
    my $data = join( &#039;&#039;, @_ );
    $data =~ s/$decode_regex/$HTML_DECODE_MAP{$1}/g;
    return $data;
}

sub css_encode_str {
    require Cpanel::Encoder::Tiny::Rare;
    *css_encode_str = *Cpanel::Encoder::Tiny::Rare::css_encode_str;
    goto \&amp;Cpanel::Encoder::Tiny::Rare::css_encode_str;
}

1;

} # --- END Cpanel/Encoder/Tiny.pm


{ # --- BEGIN Cpanel/Regex.pm
package Cpanel::Regex;


use strict;

our $VERSION = &#039;0.2.5&#039;;

my $dblquotedstr = q{&quot;([^\\\\&quot;]*(?:\\\\.[^\\\\&quot;]*)*)&quot;};
my $sglquotedstr = $dblquotedstr;
$sglquotedstr =~ tr{&quot;}{&#039;};

my $zero_through_255 = &#039;(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9][0-9]?|0)&#039;;

our %regex = (
    &#039;emailaddr&#039;              =&gt; &#039;[a-zA-Z0-9!#\$\-=?^_{}~]+(?:\.[a-zA-Z0-9!#\$\-=?^_{}~]+)*(?:\+[a-zA-Z0-9 \.=\-\_]+)*\@[\da-zA-Z](?:[-\da-zA-Z]*[\da-zA-Z])?(?:\.[\da-zA-Z](?:[-\da-zA-Z]*[\da-zA-Z])?)*&#039;,
    &#039;oneplusdot&#039;             =&gt; &#039;\.+&#039;,
    &#039;oneplusspacetab&#039;        =&gt; &#039;[\s\t]+&#039;,
    &#039;multipledot&#039;            =&gt; &#039;\.{2,}&#039;,
    &#039;commercialat&#039;           =&gt; &#039;\@&#039;,
    &#039;plussign&#039;               =&gt; &#039;\+&#039;,
    &#039;singledot&#039;              =&gt; &#039;\.&#039;,
    &#039;newline&#039;                =&gt; &#039;\n&#039;,
    &#039;doubledot&#039;              =&gt; &#039;\.\.&#039;,
    &#039;lineofdigits&#039;           =&gt; &#039;^\d+$&#039;,
    &#039;lineofnonprintingchars&#039; =&gt; &#039;^[\s\t]*$&#039;,
    &#039;getemailtransport&#039;      =&gt; &#039;^from\s+.*\s+by\s+\S+\s+with\s+(\S+)&#039;,
    &#039;getreceivedfrom&#039;        =&gt; &#039;^from\s+(.*)\s+by\s+&#039;,
    &#039;emailheaderterminator&#039;  =&gt; &#039;^[\r\n]*$&#039;,
    &#039;forwardslash&#039;           =&gt; &#039;\/&#039;,

    &#039;backslash&#039;             =&gt; chr(92) x 4,
    &#039;singlequote&#039;           =&gt; q(&#039;),
    &#039;doublequote&#039;           =&gt; &#039;&quot;&#039;,
    &#039;allspacetabchars&#039;      =&gt; &#039;[\s\t]*&#039;,
    &#039;beginswithspaceortabs&#039; =&gt; &#039;^[\s\t]&#039;,

    doublequotedstring =&gt; $dblquotedstr,
    singlequotedstring =&gt; $sglquotedstr,

    DUNS =&gt; &#039;[0-9]{2}(?:-[0-9]{3}-[0-9]{4}|[0-9]{7})&#039;,

    YYYY_MM_DD =&gt; &#039;[0-9]{4}-(?:1[012]|0[1-9])-(?:3[01]|[12][0-9]|0[1-9])&#039;,

    ipv4 =&gt; &quot;(?:$zero_through_255\.){3}$zero_through_255&quot;,

    iso_z_time =&gt; &#039;[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z&#039;,
);

1;

} # --- END Cpanel/Regex.pm


{ # --- BEGIN Cpanel/Carp.pm
package Cpanel::Carp;


use strict;

# use Cpanel::Parser::Vars (); # perlpkg line 211

our ( $SHOW_TRACE, $OUTPUT_FORMAT, $VERBOSE ) = ( 1, &#039;text&#039;, 0 );

my $__CALLBACK_AFTER_DIE_SPEW;    # Set when we need to run a code ref after spewing on die

my $error_count = 0;

sub import { return enable(); }

sub enable {
    my (
        $callback_before_warn_or_die_spew,    # Runs before the spew on warn or die, currently used in cpanel to ensure we emit headers before body in the event of a warn or die spew
        $callback_before_die_spew,            # Runs before the spew on die, not currently used
        $callback_after_die_spew,             # Runs after the spew on die, currently used in whostmgr to ensure we emit the javascript footer when we die to avoid the UI breaking
    ) = @_;

    $SIG{&#039;__WARN__&#039;} = sub {                  ## no critic qw(Variables::RequireLocalizedPunctuationVars)
        my @caller = caller(1);
        return if defined $caller[3] &amp;&amp; index( $caller[3], &#039;eval&#039; ) &gt; -1;    # Case 35335: Quiet spurious warn errors from evals

        ++$error_count;

        my $time = time();
        my ( $sec, $min, $hour, $mday, $mon, $year ) = localtime($time);

        my ( $gmmin, $gmhour, $gmday ) = ( gmtime($time) )[ 1, 2, 3 ];

        my $gmoffset        = ( $hour * 60 + $min ) - ( $gmhour * 60 + $gmmin ) + 1440 * ( $mday &lt;=&gt; $gmday );
        my $tz              = sprintf( &#039;%+03d%02d&#039;, int( $gmoffset / 60 ), $gmoffset % 60 );
        my $error_timestamp = sprintf( &#039;%04d-%02d-%02d %02d:%02d:%02d %s&#039;, $year + 1900, $mon + 1, $mday, $hour, $min, $sec, $tz );

        my $longmess;
        my $ignorable;
        if ( UNIVERSAL::isa( $_[0], &#039;Cpanel::Exception&#039; ) ) {
            $longmess = Cpanel::Carp::safe_longmess( $_[0]-&gt;to_locale_string() );
        }
        elsif ( ref $_[0] eq &#039;Template::Exception&#039; ) {
            $longmess = Cpanel::Carp::safe_longmess( &quot;Template::Exception:\n\t[TYPE]=[&quot; . $_[0]-&gt;[0] . &quot;]\n\t[INFO]=[&quot; . $_[0]-&gt;[1] . &quot;]\n\t[TEXT]=[&quot; . ( ref $_[0]-&gt;[2] eq &#039;SCALAR&#039; ? ${ $_[0]-&gt;[2] } : $_[0]-&gt;[2] ) . &quot;]\n&quot; );
        }
        else {
            $longmess  = Cpanel::Carp::safe_longmess(@_);
            $ignorable = 1 if index( $_[0], &#039;Use of uninitialized value&#039; ) == 0;
        }

        my $error_container_text = &#039;A warning occurred while processing this directive.&#039;;

        my $current_file = $Cpanel::Parser::Vars::file || &#039;unknown&#039;;
        print STDERR &quot;[$error_timestamp] warn [Internal Warning while parsing $current_file $$] $longmess\n\n&quot;;

        return if ( $OUTPUT_FORMAT eq &#039;suppress&#039; || $OUTPUT_FORMAT eq &#039;supress&#039; || $ENV{&#039;CPANEL_PHPENGINE&#039;} );

        return if $ignorable &amp;&amp; !$VERBOSE;

        _run_callback_without_die_handler($callback_before_warn_or_die_spew) if $callback_before_warn_or_die_spew;

        if ( $OUTPUT_FORMAT eq &#039;html&#039; ) {
            if ($SHOW_TRACE) {
                _print_without_die_handler( _generate_html_error_message( &#039;warn&#039;, $error_container_text, $longmess ) );
            }
            else {
                _print_without_die_handler(qq{&lt;span class=&quot;error&quot; style=&quot;cursor:hand;cursor:pointer;&quot;&gt;[$error_container_text]&lt;/span&gt;});
            }
        }
        elsif ( $OUTPUT_FORMAT eq &#039;xml&#039; ) {
            _print_without_die_handler(&quot;&lt;error&gt;$error_container_text&lt;/error&gt;&quot;);
        }
        else {
            _print_without_die_handler(&quot;[$error_container_text]\n&quot;);
        }
    };

    $SIG{&#039;__DIE__&#039;} = sub {    ## no critic qw(Variables::RequireLocalizedPunctuationVars)

        return if $^S;

        die $_[0] unless defined $^S;

        delete $SIG{&#039;__DIE__&#039;};
        _run_callback_without_die_handler($callback_before_warn_or_die_spew) if $callback_before_warn_or_die_spew;
        _run_callback_without_die_handler($callback_before_die_spew)         if $callback_before_die_spew;

        $__CALLBACK_AFTER_DIE_SPEW = $callback_after_die_spew;

        goto \&amp;spew_on_die;
    };

    return 1;
}

sub spew_on_die {    ## no critic qw(Subroutines::RequireArgUnpacking)
    my ($err) = @_;

    ++$error_count;

    my $time = time();
    my ( $sec, $min, $hour, $mday, $mon, $year ) = localtime($time);

    my ( $gmmin, $gmhour, $gmday ) = ( gmtime($time) )[ 1, 2, 3 ];

    my $gmoffset        = ( $hour * 60 + $min ) - ( $gmhour * 60 + $gmmin ) + 1440 * ( $mday &lt;=&gt; $gmday );
    my $tz              = sprintf( &#039;%+03d%02d&#039;, int( $gmoffset / 60 ), $gmoffset % 60 );
    my $error_timestamp = sprintf( &#039;%04d-%02d-%02d %02d:%02d:%02d %s&#039;, $year + 1900, $mon + 1, $mday, $hour, $min, $sec, $tz );

    my $error_text;
    if ( UNIVERSAL::isa( $err, &#039;Cpanel::Exception&#039; ) ) {
        $error_text = Cpanel::Carp::safe_longmess( $err-&gt;to_locale_string() );
    }
    elsif ( UNIVERSAL::isa( $err, &#039;Template::Exception&#039; ) ) {
        $error_text = Cpanel::Carp::safe_longmess( &quot;Template::Exception:\n\t[TYPE]=[&quot; . $err-&gt;type() . &quot;]\n\t[INFO]=[&quot; . $err-&gt;info() . &quot;]\n\t[TEXT]=[&quot; . $err-&gt;text() . &quot;]\n&quot; );
    }
    else {
        $error_text = Cpanel::Carp::safe_longmess(@_);
    }

    my $current_file = $Cpanel::Parser::Vars::file || &#039;unknown&#039;;
    print STDERR &quot;[$error_timestamp] die [Internal Death while parsing $current_file $$] $error_text\n\n&quot;;

    return if ( $OUTPUT_FORMAT eq &#039;suppress&#039; || $OUTPUT_FORMAT eq &#039;supress&#039; || $ENV{&#039;CPANEL_PHPENGINE&#039;} );

    my $error_container_text = &#039;A fatal error or timeout occurred while processing this directive.&#039;;

    if ( $OUTPUT_FORMAT eq &#039;html&#039; ) {
        if ($SHOW_TRACE) {
            _print_without_die_handler( _generate_html_error_message( &#039;error&#039;, $error_container_text, $error_text ) );
        }
        else {
            _print_without_die_handler(qq{&lt;span class=&quot;error&quot; style=&quot;cursor:hand;cursor:pointer;&quot;&gt;[$error_container_text]&lt;/span&gt;});
        }
    }
    elsif ( $OUTPUT_FORMAT eq &#039;xml&#039; ) {
        _print_without_die_handler(&quot;&lt;error&gt;[$error_container_text]&lt;/error&gt;&quot;);
    }
    else {
        _print_without_die_handler(&quot;[$error_container_text]\n&quot;);
    }

    _run_callback_without_die_handler($__CALLBACK_AFTER_DIE_SPEW) if $__CALLBACK_AFTER_DIE_SPEW;

    return;
}

my @SAFE_LONGMESS_KEY_REGEXP_ITEMS = (
    &#039;(?&lt;![a-zA-Z0-9_])pw(?![a-zA-Z0-9_])&#039;,
    qw(
      hash
      pass
      auth
      root
      key
      fullbackup
    ),
);

my @SAFE_LONGMESS_FUNCTION_REGEXP_ITEMS = (
    @SAFE_LONGMESS_KEY_REGEXP_ITEMS,
    &#039;__ANON__&#039;,
);

sub _print_without_die_handler {
    my ($text) = @_;

    local $SIG{&#039;__WARN__&#039;} = sub { };
    local $SIG{&#039;__DIE__&#039;}  = &#039;DEFAULT&#039;;

    return print $text;
}

sub _run_callback_without_die_handler {
    my ($callback) = @_;
    local $SIG{&#039;__WARN__&#039;} = sub { };
    local $SIG{&#039;__DIE__&#039;}  = &#039;DEFAULT&#039;;

    return $callback-&gt;();
}

sub _generate_html_error_message {
    my ( $type, $error_container_message, $error_message ) = @_;

    require Cpanel::Encoder::Tiny;
    my $safe_error_message = Cpanel::Encoder::Tiny::safe_html_encode_str($error_message);


    return qq[
&lt;style type=&quot;text/css&quot;&gt;.cpanel_internal_message_container {display: inline-block; margin: 10px; width: auto;} .cpanel_internal_message { border: 1px solid #fff; outline-style: solid; outline-width: 1px; outline-color: #aaa; padding: 5px; } .cpanel_internal_error_warn { background-color: #FFF6CF; } .cpanel_internal_error_error { background-color: #F8E7E6; }&lt;/style&gt;
&lt;div id=&quot;cpanel_notice_item_$error_count&quot; class=&quot;cjt-pagenotice-container cjt-notice-container cpanel_internal_message_container internal-error-container&quot;&gt;
    &lt;div class=&quot;yui-module cjt-notice cjt-pagenotice cjt-notice-$type&quot;&gt;
        &lt;div class=&quot;cpanel_internal_message cpanel_internal_error_$type bd&quot;&gt;
            &lt;div class=&quot;cjt-notice-content&quot; style=&quot;width: 420px;&quot;&gt;
                &lt;span&gt;
                    $error_container_message
                    &lt;a
                        class=&quot;error&quot;
                        style=&quot;cursor:hand;cursor:pointer;&quot;
                        onClick=&quot;document.getElementById(&#039;cpanel_internal_error_$error_count&#039;).style.display=&#039;&#039;;this.style.display=&#039;none&#039;; return false;&quot;&gt;
                        [show]
                    &lt;/a&gt;
                    &lt;a
                        class=&quot;error&quot;
                        style=&quot;cursor:hand;cursor:pointer;&quot;
                        onClick=&quot;document.getElementById(&#039;cpanel_notice_item_$error_count&#039;).style.display=&#039;none&#039;; return false;&quot;&gt;
                        [close]
                    &lt;/a&gt;
                &lt;/span&gt;
                &lt;div id=&quot;cpanel_internal_error_$error_count&quot; style=&quot;display:none;&quot;&gt;
                    &lt;textarea class=&quot;cpanel_internal_error_$type&quot; style=&quot;font-weight:900; height:200px; width:410px; color: black;&quot;&gt;$safe_error_message&lt;/textarea&gt;
                &lt;/div&gt;
            &lt;/div&gt;
        &lt;/div&gt;
    &lt;/div&gt;
&lt;/div&gt;
    ];
}

sub safe_longmess {
    require Carp;
    $Carp::Internal{&#039;Cpanel::Carp&#039;} = 1;
    return sanitize_longmess( scalar Carp::longmess(@_) );
}

my ( $key_regexp, $key_regexp_double, $function_regexp );

sub sanitize_longmess {

    _build_regexes() if !$key_regexp;

    return join(
        &quot;\n&quot;,
        map {
            ( tr{&#039;&quot;}{} &amp;&amp; ( m{$key_regexp}o || m{$key_regexp_double}o || ( ( $_ =~ m{^[ \t]*([^\(]+)\(} )[0] || &#039;&#039; ) =~ m{$function_regexp}o ) )    # matches a line that needs to be sanitized
              &amp;&amp; _sanitize_line($_);                                                                                                                # sanitize
            $_
        } split( m{\n}, $_[0] )
    ) . &quot;\n&quot;;
}

sub error_count {
    return $error_count;
}

sub _sanitize_line {    # Operates directly on $_[0] for speed
    if ( !$INC{&#039;Cpanel/Regex.pm&#039;} ) {    # PPI NO PARSE - inc check
        local $@;
        eval {
            local $SIG{__DIE__};
            local $SIG{__WARN__};
            require Cpanel::Regex;    # PPI NO PARSE - inc check
        };
    }
    $_[0] =~ s/$Cpanel::Regex::regex{&#039;singlequotedstring&#039;}/__CPANEL_HIDDEN__/go if index( $_[0], q{&#039;} ) != -1;
    $_[0] =~ s/$Cpanel::Regex::regex{&#039;doublequotedstring&#039;}/__CPANEL_HIDDEN__/go if index( $_[0], q{&quot;} ) != -1;
    return 1;
}

sub _build_regexes {

    my $key_regexp_items = join &#039;|&#039;, @SAFE_LONGMESS_KEY_REGEXP_ITEMS;
    $key_regexp = qr&lt;
        &#039;
        .*?
        (?:
            $key_regexp_items
        )
        .*?
        &#039;
        \s*
        ,
    &gt;x;

    $key_regexp_double = $key_regexp;
    $key_regexp_double =~ tr{&#039;}{&quot;};    # &quot;&#039; fix for poor editors

    my $function_regexp_items = join &#039;|&#039;, @SAFE_LONGMESS_FUNCTION_REGEXP_ITEMS;
    $function_regexp = qr&lt;
        ::
        .*?
        (?:
            $function_regexp_items
        )
        .*?
        $
    &gt;x;

    return 1;
}

1;

} # --- END Cpanel/Carp.pm


{ # --- BEGIN Cpanel/Set.pm
package Cpanel::Set;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub difference {
    my ($super_ar) = @_;

    my %lookup;
    @lookup{ map { @$_ } @_[ 1 .. $#_ ] } = ();

    return grep { !exists $lookup{$_} } @$super_ar;
}


sub intersection {
    my ( $super_ar, $sub_ar ) = @_;

    my %lookup;
    @lookup{@$sub_ar} = ();

    return grep { exists $lookup{$_} } @$super_ar;
}

1;

} # --- END Cpanel/Set.pm


{ # --- BEGIN Cpanel/SafeFileLock.pm
package Cpanel::SafeFileLock;


use strict;
use warnings;
no warnings &#039;once&#039;;


use constant {
    _ENOENT =&gt; 2,
    _EDQUOT =&gt; 122,
    DEBUG   =&gt; 0,

    MAX_LOCKFILE_SIZE =&gt; 8192,
};


sub new {
    my ( $class, $path_to_lockfile, $fh, $path_to_file_being_locked ) = @_;

    if ( scalar @_ != 4 ) {
        die &#039;Usage: Cpanel::SafeFileLock-&gt;new($path_to_lockfile, $fh, $path_to_file_being_locked)&#039;;
    }

    if ($fh) {
        write_lock_contents( $fh, $path_to_lockfile ) or return;
    }


    my $self = bless [
        $path_to_lockfile,
        $fh,
        $path_to_file_being_locked,
    ], $class;

    push @$self, @{ $self-&gt;stat_ar() }[ 1, 9 ];

    return $self;
}

sub new_before_lock {
    my ( $class, $path_to_lockfile, $path_to_file_being_locked ) = @_;

    if ( scalar @_ != 3 ) {
        die &#039;Usage: Cpanel::SafeFileLock-&gt;new_before_lock($path_to_lockfile, $path_to_file_being_locked)&#039;;
    }

    return bless [
        $path_to_lockfile,
        undef,
        $path_to_file_being_locked,
    ], $class;
}

sub set_filehandle_and_unlinker_after_lock {

    $_[0][1] = $_[1];

    push @{ $_[0] }, @{ $_[0]-&gt;stat_ar() }[ 1, 9 ];

    $_[0][5] = $_[2];
    return $_[0];
}

sub get_path {
    return $_[0]-&gt;[0];
}

sub get_path_to_file_being_locked {
    return $_[0]-&gt;[2] // die &quot;get_path_to_file_being_locked requires the object to be instantiated with the path_to_file_being_locked&quot;;
}

sub set_filehandle {
    $_[0][1] = $_[1];
    return $_[0];
}

sub get_filehandle {
    return $_[0]-&gt;[1];
}

sub get_inode {
    return $_[0]-&gt;[3];
}

sub get_mtime {
    return $_[0]-&gt;[4];
}

sub get_path_fh_inode_mtime {
    return @{ $_[0] }[ 0, 1, 3, 4 ];
}

sub stat_ar {
    return [ stat( ( $_[0]-&gt;[1] &amp;&amp; fileno( $_[0]-&gt;[1] ) ) ? $_[0]-&gt;[1] : $_[0]-&gt;[0] ) ];
}

sub lstat_ar {

    return [ $_[0]-&gt;[1] &amp;&amp; fileno( $_[0]-&gt;[1] ) ? stat( $_[0]-&gt;[1] ) : lstat( $_[0]-&gt;[0] ) ];
}

sub close {

    return close $_[0]-&gt;[1] if ref $_[0]-&gt;[1];

    $_[0]-&gt;[5] = undef;

    return;
}


sub write_lock_contents {    ## no critic qw(Subroutines::RequireArgUnpacking) -- only unpack on the failure case
    local $!;

    if (DEBUG) {
        require Cpanel::Carp;
        return 1 if syswrite( $_[0], &quot;$$\n$0\n&quot; . Cpanel::Carp::safe_longmess() . &quot;\n&quot; );
    }
    return 1 if syswrite( $_[0], &quot;$$\n$0\n&quot; );

    my ( $fh, $path_to_lockfile ) = @_;
    my $write_error = $!;

    CORE::close($fh);
    unlink $path_to_lockfile;

    require Cpanel::Exception;
    die Cpanel::Exception::create( &#039;IO::FileWriteError&#039;, [ &#039;path&#039; =&gt; $path_to_lockfile, &#039;error&#039; =&gt; $write_error ] );
}

sub fetch_lock_contents_if_exists {
    my ($lockfile) = @_;

    die &#039;Need lock file!&#039; if !$lockfile;

    open my $lockfile_fh, &#039;&lt;:stdio&#039;, $lockfile or do {
        return if $! == _ENOENT();

        die &quot;open($lockfile): $!&quot;;
    };

    my $buffer;
    my $read_result = read( $lockfile_fh, $buffer, MAX_LOCKFILE_SIZE );

    if ( !defined $read_result ) {
        die &quot;read($lockfile): $!&quot;;
    }

    my ( $pid_line, $lock_name, $lock_obj ) = split( /\n/, $buffer, 3 );
    chomp($lock_name) if length $lock_name;
    my ($lock_pid) = $pid_line &amp;&amp; ( $pid_line =~ m/(\d+)/ );

    return ( $lock_pid, $lock_name || &#039;unknown&#039;, $lock_obj || &#039;unknown&#039;, $lockfile_fh );
}


1;


} # --- END Cpanel/SafeFileLock.pm


{ # --- BEGIN Cpanel/FHUtils/Tiny.pm
package Cpanel::FHUtils::Tiny;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub is_a {
    return !ref $_[0] ? 0 : ( ref $_[0] eq &#039;IO::Handle&#039; || ref $_[0] eq &#039;GLOB&#039; || UNIVERSAL::isa( $_[0], &#039;GLOB&#039; ) ) ? 1 : 0;
}


sub are_same {
    my ( $fh1, $fh2 ) = @_;

    return 1 if $fh1 eq $fh2;

    if ( fileno($fh1) &amp;&amp; ( fileno($fh1) != -1 ) &amp;&amp; fileno($fh2) &amp;&amp; ( fileno($fh2) != -1 ) ) {
        return 1 if fileno($fh1) == fileno($fh2);
    }

    return 0;
}


sub to_bitmask {
    my @fhs = @_;

    my $mask = q&lt;&gt;;

    for my $fh (@fhs) {
        vec( $mask, ref($fh) ? fileno($fh) : $fh, 1 ) = 1;
    }

    return $mask;
}

1;

} # --- END Cpanel/FHUtils/Tiny.pm


{ # --- BEGIN Cpanel/Hash.pm
package Cpanel::Hash;


use strict;


*get_fastest_hash = \&amp;fnv1a_32;


use constant FNV1_32A_INIT =&gt; 0x811c9dc5;

use constant FNV_32_PRIME =&gt; 0x01000193;

use constant FNV_32_MOD =&gt; 2**32;    # AKA 0x100000000 but that it non-portable;
sub fnv1a_32 {
    my $fnv32 = FNV1_32A_INIT();
    ( $fnv32 = ( ( $fnv32 ^ $_ ) * FNV_32_PRIME() ) % FNV_32_MOD ) for unpack( &#039;C*&#039;, $_[0] );
    return $fnv32;
}

1;

} # --- END Cpanel/Hash.pm


{ # --- BEGIN Cpanel/SafeFile/LockInfoCache.pm
package Cpanel::SafeFile::LockInfoCache;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::SafeFileLock (); # perlpkg line 211


sub new {
    my ( $class, $pathname ) = @_;

    die &#039;need path!&#039; if !$pathname;

    return bless { _path =&gt; $pathname }, $class;
}


sub get {
    my ( $self, $inode, $mtime ) = @_;

    die &#039;Need an inode &amp; an mtime!&#039; if !defined $inode || !defined $mtime;

    if ( !exists $self-&gt;{&quot;_inode_${inode}_$mtime&quot;} ) {
        my ( $pid, $name, $obj, $fh ) = Cpanel::SafeFileLock::fetch_lock_contents_if_exists( $self-&gt;{&#039;_path&#039;} );

        if ($pid) {

            my ( $real_inode, $real_mtime ) = ( stat $fh )[ 1, 9 ];
            $self-&gt;{&quot;_inode_${real_inode}_$real_mtime&quot;} = [ $pid, $name, $obj ];
        }
    }

    return $self-&gt;{&quot;_inode_${inode}_$mtime&quot;} ||= undef;
}

1;

} # --- END Cpanel/SafeFile/LockInfoCache.pm


{ # --- BEGIN Cpanel/SafeFile/LockWatcher.pm
package Cpanel::SafeFile::LockWatcher;


use strict;
use warnings;
no warnings &#039;once&#039;;

use constant _ENOENT =&gt; 2;

use constant _FILEHANDLE_TTL =&gt; 2;


sub new {
    my ( $class, $lockfile ) = @_;

    my $self = bless { _path =&gt; $lockfile, _new =&gt; 1 }, $class;

    return $self-&gt;reload_from_disk();
}


sub reload_from_disk {
    my ($self) = @_;

    my $old_inode = $self-&gt;{&#039;inode&#039;};
    @{$self}{qw( inode  uid  size mtime)} = $self-&gt;_get_inode_uid_size_mtime();

    if ( delete $self-&gt;{&#039;_new&#039;} ) {
        $self-&gt;{&#039;changed&#039;} = 0;
    }
    else {
        $self-&gt;{&#039;changed&#039;} = ( $self-&gt;{&#039;inode&#039;} || 0 ) != ( $old_inode || 0 ) ? 1 : 0;
    }

    return $self;
}

sub _get_inode_uid_size_mtime {
    my ($self) = @_;

    my ( $inode, $uid, $size, $mtime );

    local $!;

    if ( open my $fh, &#039;&lt;&#039;, $self-&gt;{&#039;_path&#039;} ) {
        ( $inode, $uid, $size, $mtime ) = ( stat $fh )[ 1, 4, 7, 9 ];

        $self-&gt;_add_fh_if_needed( $fh, $inode );
    }
    elsif ( $! != _ENOENT ) {
        die &quot;open(&lt;, $self-&gt;{&#039;_path&#039;}): $!&quot;;
    }

    return ( $inode, $uid, $size, $mtime );
}

sub _add_fh_if_needed {
    my ( $self, $fh, $inode ) = @_;

    my $now        = time;
    my $fhs_hr     = $self-&gt;{&#039;_time_fhs&#039;} //= {};
    my $seen_inode = 0;

    for my $time ( keys %$fhs_hr ) {

        if ( ( $now - $time ) &gt; _FILEHANDLE_TTL() ) {
            delete $fhs_hr-&gt;{$time};
            next;
        }

        if ( !$seen_inode ) {
            foreach my $entry ( @{ $fhs_hr-&gt;{$time} } ) {
                if ( $entry-&gt;[1] == $inode ) {
                    $seen_inode = 1;
                    last;
                }
            }
        }
    }

    return if $seen_inode;

    push @{ $fhs_hr-&gt;{ time() } }, [ $fh, $inode ];

    return;
}

1;

} # --- END Cpanel/SafeFile/LockWatcher.pm


{ # --- BEGIN Cpanel/Context.pm
package Cpanel::Context;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Exception (); # perlpkg line 211

sub must_be_list {
    return 1 if ( caller(1) )[5];    # 5 = wantarray
    my $msg = ( caller(1) )[3];      # 3 = subroutine
    $msg .= $_[0] if defined $_[0];
    return _die_context( &#039;list&#039;, $msg );
}

sub must_not_be_scalar {
    my ($message) = @_;

    my $wa = ( caller(1) )[5];       # 5 = wantarray

    if ( !$wa &amp;&amp; defined $wa ) {
        _die_context( &#039;list or void&#039;, $message );
    }

    return 1;
}

sub must_not_be_void {
    return if defined( ( caller 1 )[5] );

    return _die_context(&#039;scalar or list&#039;);
}

sub _die_context {
    my ( $context, $message ) = @_;

    local $Carp::CarpInternal{__PACKAGE__} if $INC{&#039;Carp.pm&#039;};

    my $to_throw = length $message ? &quot;Must be $context context ($message)!&quot; : &quot;Must be $context context!&quot;;

    die Cpanel::Exception::create_raw( &#039;ContextError&#039;, $to_throw );
}

1;

} # --- END Cpanel/Context.pm


{ # --- BEGIN Cpanel/Pack.pm
package Cpanel::Pack;


use strict;

sub new {
    my ( $class, $template_ar ) = @_;

    if ( @$template_ar % 2 ) {
        die &quot;Cpanel::Pack::new detected an odd number of elements in hash assignment!&quot;;
    }

    my $self = bless {
        &#039;template_str&#039; =&gt; &#039;&#039;,
        &#039;keys&#039;         =&gt; [],
    }, $class;

    my $ti = 0;
    while ( $ti &lt; $#$template_ar ) {
        push @{ $self-&gt;{&#039;keys&#039;} }, $template_ar-&gt;[$ti];
        $self-&gt;{&#039;template_str&#039;} .= $template_ar-&gt;[ 1 + $ti ];
        $ti += 2;
    }

    return $self;
}

sub unpack_to_hashref {    ## no critic (RequireArgUnpacking)
    my %result;
    @result{ @{ $_[0]-&gt;{&#039;keys&#039;} } } = unpack( $_[0]-&gt;{&#039;template_str&#039;}, $_[1] );
    return \%result;
}

sub pack_from_hashref {
    my ( $self, $opts_ref ) = @_;
    no warnings &#039;uninitialized&#039;;
    return pack( $self-&gt;{&#039;template_str&#039;}, @{$opts_ref}{ @{ $self-&gt;{&#039;keys&#039;} } } );
}

sub sizeof {
    my ($self) = @_;
    return ( $self-&gt;{&#039;sizeof&#039;} ||= length pack( $self-&gt;{&#039;template_str&#039;}, () ) );
}

sub malloc {
    my ($self) = @_;

    return pack( $self-&gt;{&#039;template_str&#039;} );
}

1;

} # --- END Cpanel/Pack.pm


{ # --- BEGIN Cpanel/Syscall.pm
package Cpanel::Syscall;


use strict;

my %NAME_TO_NUMBER = qw(
  close             3
  fcntl            72
  lchown           94
  getrlimit        97
  getsid          124
  gettimeofday     96
  sendfile         40
  setrlimit       160
  splice          275
  write             1
  setsid          112
  getsid          124
  inotify_init1     294
  inotify_add_watch 254
  inotify_rm_watch  255
  setresuid       117
  setresgid       119
  setgroups       116
  umount2         166
);

sub name_to_number {
    my ($name) = @_;

    return $NAME_TO_NUMBER{$name} || _die_unknown_syscall($name);
}

sub _die_unknown_syscall {
    my ($name) = @_;

    die &quot;Unknown system call: “$name”&quot;;
}

sub syscall {    ##no critic qw(RequireArgUnpacking)
    local $!;

    _die_unknown_syscall( $_[0] ) unless defined $_[0] &amp;&amp; $NAME_TO_NUMBER{ $_[0] };

    my $ret = CORE::syscall( $NAME_TO_NUMBER{ $_[0] }, scalar @_ &gt; 1 ? @_[ 1 .. $#_ ] : () );
    if ( ( $ret == -1 ) &amp;&amp; $! ) {
        if ( $INC{&#039;Cpanel/Exception.pm&#039;} ) {
            die Cpanel::Exception::create( &#039;SystemCall&#039;, [ name =&gt; $_[0], error =&gt; $!, arguments =&gt; [ @_[ 1 .. $#_ ] ] ] );
        }
        else {
            die &quot;Failed system call “$_[0]”: $!&quot;;
        }
    }

    return $ret;
}

1;

} # --- END Cpanel/Syscall.pm


{ # --- BEGIN Cpanel/Inotify.pm
package Cpanel::Inotify;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Autodie          (); # perlpkg line 211
# use Cpanel::Context          (); # perlpkg line 211
# use Cpanel::Exception        (); # perlpkg line 211
# use Cpanel::Fcntl::Constants (); # perlpkg line 211
# use Cpanel::Pack             (); # perlpkg line 211
# use Cpanel::Syscall          (); # perlpkg line 211

use constant POLL_SIZE =&gt; 65536;

use constant READ_TEMPLATE =&gt; (
    wd     =&gt; &#039;i&#039;,    #int        Watch descriptor
    mask   =&gt; &#039;I&#039;,    #uint32_t   Mask of events
    cookie =&gt; &#039;I&#039;,    #uint32_t   Unique cookie associating related events
    len    =&gt; &#039;I&#039;,    #uint32_t   Size of “name” field
);

my %add_flags;
my %read_flags;
my %init1_flag;

my $UNPACK_OBJ;
my $UNPACK_SIZE;


sub new {
    my ( $class, %opts ) = @_;

    if ( !$UNPACK_OBJ ) {
        $UNPACK_OBJ  = Cpanel::Pack-&gt;new( [ READ_TEMPLATE() ] );
        $UNPACK_SIZE = $UNPACK_OBJ-&gt;sizeof();

        _setup_flags();
    }

    my @given_flags = $opts{&#039;flags&#039;} ? @{ $opts{&#039;flags&#039;} } : ();

    my $mask = 0;
    for my $f (@given_flags) {
        $mask |= $init1_flag{$f} || do {
            die Cpanel::Exception-&gt;create_raw(&quot;Invalid inotify_init1 flag: “$f”&quot;);
        };
    }

    my $fd = Cpanel::Syscall::syscall( &#039;inotify_init1&#039;, $mask );

    my %self = (
        _fd =&gt; $fd,
    );
    Cpanel::Autodie::open( $self{&#039;_fh&#039;}, &#039;&lt;&amp;=&#039;, $fd );

    return bless \%self, $class;
}


sub add {
    my ( $self, $path, %opts ) = @_;

    my @flags = @{ $opts{&#039;flags&#039;} };

    my $mask = 0;
    for my $f (@flags) {
        $mask |= $add_flags{$f} || do {
            die Cpanel::Exception-&gt;create_raw(&quot;Invalid inotify_add_watch flag: “$f”&quot;);
        };
    }

    my $wd = Cpanel::Syscall::syscall(
        &#039;inotify_add_watch&#039;,
        $self-&gt;{&#039;_fd&#039;},
        $path,
        $mask,
    );

    if ( $wd &lt; 1 ) {
        die Cpanel::Exception-&gt;create_raw(&quot;inotify watch descriptor “$wd” means something is wrong?&quot;);
    }

    $self-&gt;{&#039;_watches&#039;}{$wd} = $path;

    return $wd;
}


sub remove {
    my ( $self, $wd ) = @_;

    Cpanel::Syscall::syscall( &#039;inotify_rm_watch&#039;, $self-&gt;{&#039;_fd&#039;}, $wd );

    return;
}


sub poll {
    my ($self) = @_;

    Cpanel::Context::must_be_list();

    my $buf = q&lt;&gt;;

    Cpanel::Autodie::sysread_sigguard( $self-&gt;{&#039;_fh&#039;}, $buf, POLL_SIZE() );

    my @events;

    while ( length $buf ) {
        my $evt = $UNPACK_OBJ-&gt;unpack_to_hashref( substr( $buf, 0, $UNPACK_SIZE, q&lt;&gt; ) );
        $evt-&gt;{&#039;name&#039;} = substr( $buf, 0, delete( $evt-&gt;{&#039;len&#039;} ), q&lt;&gt; );
        $evt-&gt;{&#039;name&#039;} =~ s&lt;\0+\z&gt;&lt;&gt;;    #trailing NULs

        $evt-&gt;{&#039;flags&#039;} = _mask_to_flags_ar( delete $evt-&gt;{&#039;mask&#039;} );

        push @events, $evt;
    }

    return @events;
}


sub fileno {
    my ($self) = @_;
    return fileno( $self-&gt;{&#039;_fh&#039;} );
}


sub _mask_to_flags_ar {
    my ($mask) = @_;

    my @flags;
    for my $k ( keys %read_flags ) {
        push @flags, $k if $mask &amp; $read_flags{$k};
    }

    @flags = sort @flags;

    return \@flags;
}

sub _setup_flags {

    my %flag_num = (
        ACCESS        =&gt; 0x1,      # File was accessed
        MODIFY        =&gt; 0x2,      # File was modified
        ATTRIB        =&gt; 0x4,      # Metadata changed
        CLOSE_WRITE   =&gt; 0x8,      # File opened for writing was closed
        CLOSE_NOWRITE =&gt; 0x10,     # File not opened for writing was closed
        OPEN          =&gt; 0x20,     # File was opened
        MOVED_FROM    =&gt; 0x40,     # File was moved from X
        MOVED_TO      =&gt; 0x80,     # File was moved to Y
        CREATE        =&gt; 0x100,    # Subfile was created
        DELETE        =&gt; 0x200,    # Subfile was deleted
        DELETE_SELF   =&gt; 0x400,    # Self was deleted
        MOVE_SELF     =&gt; 0x800,    # Self was moved
    );

    %read_flags = (
        %flag_num,

        UNMOUNT    =&gt; 0x00002000,    # Backing fs was unmounted
        Q_OVERFLOW =&gt; 0x00004000,    # Event queued overflowed (&#039;wd&#039; is -1)
        IGNORED    =&gt; 0x00008000,    # Watch was removed
        ISDIR      =&gt; 0x40000000,    # event occurred against dir
    );

    %add_flags = (
        %flag_num,

        ONLYDIR     =&gt; 0x01000000,    # only watch the path if it is a directory
        DONT_FOLLOW =&gt; 0x02000000,    # don&#039;t follow a sym link
        EXCL_UNLINK =&gt; 0x04000000,    # exclude events on unlinked objects
        MASK_ADD    =&gt; 0x20000000,    # add to the mask of an already existing watch
        ONESHOT     =&gt; 0x80000000,    # only send event once

        CLOSE =&gt; $read_flags{&#039;CLOSE_WRITE&#039;} | $read_flags{&#039;CLOSE_NOWRITE&#039;},
        MOVE  =&gt; $read_flags{&#039;MOVED_FROM&#039;} | $read_flags{&#039;MOVED_TO&#039;},
    );

    my $mask = 0;
    $mask |= $_ for values %flag_num;

    $add_flags{&#039;ALL_EVENTS&#039;} = $mask;

    %init1_flag = (
        CLOEXEC  =&gt; $Cpanel::Fcntl::Constants::O_CLOEXEC,
        NONBLOCK =&gt; $Cpanel::Fcntl::Constants::O_NONBLOCK,
    );

    return;
}

1;

} # --- END Cpanel/Inotify.pm


{ # --- BEGIN Cpanel/SafeFile.pm
package Cpanel::SafeFile;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use Cpanel::TimeHiRes        (); # perlpkg line 211
# use Cpanel::Fcntl::Constants (); # perlpkg line 211
# use Cpanel::SafeFileLock     (); # perlpkg line 211
# use Cpanel::FHUtils::Tiny    (); # perlpkg line 211

use constant {
    _EWOULDBLOCK =&gt; 11,
    _EACCES      =&gt; 13,
    _EDQUOT      =&gt; 122,
    _ENOENT      =&gt; 2,
    _EINTR       =&gt; 4,
    _EEXIST      =&gt; 17,
    _ENOSPC      =&gt; 28,
    _EPERM       =&gt; 1,

    MAX_LOCK_CREATE_ATTEMPTS =&gt; 90,

    NO_PERM_TO_WRITE_TO_DOTLOCK_DIR =&gt; -1,

    INOTIFY_FILE_DISAPPEARED =&gt; 2,

    CREATE_FCNTL_VALUE =&gt; ( $Cpanel::Fcntl::Constants::O_WRONLY | $Cpanel::Fcntl::Constants::O_EXCL | $Cpanel::Fcntl::Constants::O_CREAT | $Cpanel::Fcntl::Constants::O_NONBLOCK ),
    UNLOCK_FCNTL_VALUE =&gt; $Cpanel::Fcntl::Constants::LOCK_UN,

    LOCK_FILE_PERMS =&gt; 0644,

    DEFAULT_LOCK_WAIT_TIME =&gt; 196,

    MAX_LOCK_WAIT_TIME =&gt; 400,

    MAX_LOCK_FILE_LENGTH =&gt; 225,
};

$Cpanel::SafeFile::VERSION = &#039;5.0&#039;;

my $OVERWRITE_FCNTL_VALUE;
my $verbose = 0;    # initialized in safelock

our $LOCK_WAIT_TIME;    #allow lock wait time to be overwritten

my $OPEN_LOCKS = 0;

our $TIME_BETWEEN_DOTLOCK_CHECKS = 0.3;
our $TIME_BETWEEN_FLOCK_CHECKS   = 0.05;
our $MAX_FLOCK_WAIT              = 60;     # allowed to be overwritten in tests

our $_SKIP_DOTLOCK_WHEN_NO_PERMS = 0;

our $_SKIP_WARN_ON_OPEN_FAIL = 0;


my $DOUBLE_LOCK_DETECTED = 4096;

sub safeopen {    #fh, open()-style mode, path
    my ( $mode, $file ) = _get_open_args( @_[ 1 .. $#_ ] );

    my $open_method_coderef = sub {
        my $ret = open( $_[0], $_[1], $_[2] ) || do {
            _log_warn(&quot;open($_[1], $_[2]): $!&quot;);
            return undef;
        };
        return $ret;
    };

    return _safe_open( $_[0], $mode, $file, $open_method_coderef, &#039;safeopen&#039; );
}

sub safesysopen_no_warn_on_fail {
    local $_SKIP_WARN_ON_OPEN_FAIL = 1;

    return safesysopen(@_);
}

sub safesysopen_skip_dotlock_if_not_root {
    local $_SKIP_DOTLOCK_WHEN_NO_PERMS = $&gt; == 0 ? 0 : 1;

    return safesysopen(@_);
}

sub safeopen_skip_dotlock_if_not_root {
    local $_SKIP_DOTLOCK_WHEN_NO_PERMS = $&gt; == 0 ? 0 : 1;

    return safeopen(@_);
}

sub safelock_skip_dotlock_if_not_root {
    local $_SKIP_DOTLOCK_WHEN_NO_PERMS = $&gt; == 0 ? 0 : 1;

    return safelock(@_);
}

sub safereopen {    ##no critic qw(RequireArgUnpacking)
    my $fh = shift;

    if ( !$fh ) {
        require Cpanel::Carp;
        die Cpanel::Carp::safe_longmess(&quot;Undefined filehandle not allowed!&quot;);
    }
    elsif ( !fileno $fh ) {
        require Cpanel::Carp;
        die Cpanel::Carp::safe_longmess(&quot;Closed filehandle ($fh) not allowed!&quot;);
    }

    my ( $mode, $file ) = _get_open_args(@_);

    my $open_method_coderef = sub {
        return open( $_[0], $_[1], $_[2] ) || do {
            _log_warn(&quot;open($_[1], $_[2]): $!&quot;);
            return undef;
        };
    };

    return _safe_re_open( $fh, $mode, $file, $open_method_coderef, &#039;safereopen&#039; );
}

sub safesysopen {    ##no critic qw(RequireArgUnpacking)
    my ( $file, $open_mode, $custom_perms ) = ( @_[ 1 .. 3 ] );

    my ( $sysopen_perms, $original_umask );

    $open_mode = _sanitize_open_mode($open_mode);

    my $open_method_coderef = sub {
        return sysopen( $_[0], $_[2], $_[1], $sysopen_perms ) || do {
            _log_warn(&quot;open($_[2], $_[1], $sysopen_perms): $!&quot;) unless $_SKIP_WARN_ON_OPEN_FAIL;
            return undef;
        };
    };

    if ( defined $custom_perms ) {
        $custom_perms &amp;= 0777;
        $original_umask = umask( $custom_perms ^ 07777 );
        $sysopen_perms  = $custom_perms;
    }
    else {
        $sysopen_perms = 0666;
    }

    my $lock_ref;

    local $@;
    my $ok = eval {
        $lock_ref = _safe_open( $_[0], $open_mode, $file, $open_method_coderef, &#039;safesysopen&#039; );
        1;
    };

    if ( defined $custom_perms ) {
        umask($original_umask);
    }

    die if !$ok;

    return $lock_ref;
}

sub safeclose {
    my ( $fh, $lockref, $do_something_before_releasing_lock ) = @_;

    if ( $do_something_before_releasing_lock &amp;&amp; ref $do_something_before_releasing_lock eq &#039;CODE&#039; ) {
        $do_something_before_releasing_lock-&gt;();
    }

    my $success = 1;
    if ( $fh &amp;&amp; defined fileno $fh ) {

        flock( $fh, UNLOCK_FCNTL_VALUE ) or _log_warn( &quot;flock(LOCK_UN) on “&quot; . $lockref-&gt;get_path() . &quot;” failed with error: $!&quot; );    # LOCK_UN
        $success = close $fh;
    }

    my $safe_unlock = safeunlock($lockref);

    $OPEN_LOCKS-- if ( $safe_unlock &amp;&amp; $success );

    return ( $safe_unlock &amp;&amp; $success );
}

sub safelock {
    my ($file) = @_;

    my $lock_obj = _safelock($file);


    return if !ref $lock_obj;

    return $lock_obj;
}

sub _safelock {
    my ($file) = @_;
    if ( !$file || $file =~ tr/\0// ) {
        _log_warn(&#039;safelock: Invalid arguments&#039;);
        return;
    }
    $verbose ||= ( _verbose_flag_file_exists() ? 1 : -1 );

    my $lockfile      = _calculate_lockfile($file);
    my $safefile_lock = Cpanel::SafeFileLock-&gt;new_before_lock( $lockfile, $file );
    my ( $lock_status, $lock_fh, $attempts, $last_err );

    {
        local $@;

        while ( ++$attempts &lt; MAX_LOCK_CREATE_ATTEMPTS ) {

            ( $lock_status, $lock_fh ) = _lock_wait( $file, $safefile_lock, $lockfile );

            last if $lock_status;

            $last_err = $!;

            if ( $lock_fh &amp;&amp; $lock_fh == $DOUBLE_LOCK_DETECTED ) {
                return 0;
            }
        }

    }

    if ( $lock_fh == 1 ) {
        return 1;
    }
    elsif ( $lock_status &amp;&amp; $lock_fh ) {
        return $safefile_lock;
    }

    _log_warn( &#039;safelock: waited for lock (&#039; . $lockfile . &#039;) &#039; . $attempts . &#039; times&#039; );
    require Cpanel::Exception;
    die Cpanel::Exception::create( &#039;IO::FileCreateError&#039;, [ &#039;path&#039; =&gt; $lockfile, &#039;error&#039; =&gt; $last_err ] );
}

sub _write_temp_lock_file {
    my ($lockfile) = @_;

    my $temp_file = sprintf(
        &#039;%s-%x-%x-%x&#039;,
        $lockfile,
        substr( rand, 2 ),
        scalar( reverse time ),
        scalar( reverse $$ ),
    );

    my ( $ok, $fh_or_err ) = _create_lockfile($temp_file);
    if ( !$ok ) {


        if ( $fh_or_err == _EPERM() || $fh_or_err == _EACCES() ) {

            local $!;

            my $lock_dir = _getdir($lockfile);
            if ( !-w $lock_dir ) {


                if ($_SKIP_DOTLOCK_WHEN_NO_PERMS) {    # A hack to allow /etc/valiases to still be flock()ed until we can refactor
                    return ( NO_PERM_TO_WRITE_TO_DOTLOCK_DIR, $fh_or_err );
                }
                else {
                    _log_warn(&quot;safelock: Failed to create a lockfile &#039;$temp_file&#039; in the directory &#039;$lock_dir&#039; that isn&#039;t writable: $fh_or_err&quot;);
                }
            }
        }

        return ( 0, $fh_or_err );
    }

    Cpanel::SafeFileLock::write_lock_contents( $fh_or_err, $temp_file );

    return ( $temp_file, $fh_or_err );
}

sub _try_to_install_lockfile {
    my ( $temp_file, $lockfile ) = @_;

    link( $temp_file =&gt; $lockfile ) or do {
        return 0 if $! == _EEXIST;

        require Cpanel::Exception;

        die Cpanel::Exception::create( &#039;IO::LinkError&#039;, [ oldpath =&gt; $temp_file, newpath =&gt; $lockfile, error =&gt; $! ] );
    };

    return 1;
}

sub safeunlock {
    my $lockref = shift;

    if ( !$lockref ) {
        _log_warn(&#039;safeunlock: Invalid arguments&#039;);
        return;
    }
    elsif ( !ref $lockref ) {
        return 1 if $lockref eq &#039;1&#039;;    # No lock file created so just succeed
        $lockref = Cpanel::SafeFileLock-&gt;new( $lockref, undef, undef );
        if ( !$lockref ) {
            _log_warn(&quot;safeunlock: failed to generate a Cpanel::SafeFileLock object from a path&quot;);
            return;
        }
    }
    my ( $lock_path, $fh, $lock_inode, $lock_mtime ) = $lockref-&gt;get_path_fh_inode_mtime();

    my ( $filesys_lock_ino, $filesys_lock_mtime ) = ( lstat $lock_path )[ 1, 9 ];

    if ( $fh &amp;&amp; !defined fileno($fh) ) {

        return 1;
    }
    elsif ( !$filesys_lock_mtime ) {
        _log_warn( &#039;Lock on &#039; . $lockref-&gt;get_path_to_file_being_locked() . &#039; lost!&#039; );
        $lockref-&gt;close();
        return;    # return false on false
    }

    elsif ( $lock_inode &amp;&amp; ( $lock_inode == $filesys_lock_ino ) &amp;&amp; $lock_path &amp;&amp; ( $lock_mtime == $filesys_lock_mtime ) ) {
        unlink $lock_path or do {
            _log_warn(&quot;Could not unlink lock file “$lock_path” as ($&gt;/$)): $!\n&quot;);
            $lockref-&gt;close();
            return;    # return false on false
        };
        return $lockref-&gt;close();
    }

    $lockref-&gt;close();
    my ( $lock_pid, $lock_name, $lock_obj ) = Cpanel::SafeFileLock::fetch_lock_contents_if_exists($lock_path);

    if ($lock_pid) {

        if ( $lock_pid == $$ ) {
            unlink $lock_path;    # best-effort; ignore failure
            return 1;
        }

        $lock_inode ||= 0;
        $lock_mtime ||= 0;

        _log_warn(&quot;[$$] Attempt to unlock file that was locked by another process [LOCK_PATH]=[$lock_path] [LOCK_PID]=[$lock_pid] [LOCK_PROCESS]=[$lock_name] [LOCK_INODE]=[$filesys_lock_ino] [LOCK_MTIME]=[$filesys_lock_mtime] -- [NON_LOCK_PID]=[$$] [NON_LOCK_PROCESS]=[$0] [NON_LOCK_INODE]=[$lock_inode] [NON_LOCK_MTIME]=[$lock_mtime]&quot;);
    }
    return;
}

sub _safe_open {

    my ( undef, $open_mode, $file, $open_method_coderef, $open_method ) = @_;

    if ( !defined $open_mode || !$open_method_coderef || !$file || $file =~ tr/\0// ) {
        _log_warn(&#039;_safe_open: Invalid arguments&#039;);
        return;
    }
    elsif ( defined $_[0] ) {
        my $fh_type = ref $_[0];
        if ( !Cpanel::FHUtils::Tiny::is_a( $_[0] ) ) {
            _log_warn(&quot;Invalid file handle type &#039;$fh_type&#039; provided for $open_method of &#039;$file&#039;&quot;);
            return;
        }
    }

    if ( my $lockref = _safelock($file) ) {
        if ( $open_method_coderef-&gt;( $_[0], $open_mode, $file ) ) {
            if ( my $err = _do_flock_or_return_exception( $_[0], $open_mode, $file ) ) {
                safeunlock($lockref);
                local $@ = $err;
                die;
            }

            $OPEN_LOCKS++;
            return $lockref;
        }
        else {

            local $!;

            safeunlock($lockref);
            return;
        }
    }
    else {
        _log_warn(&quot;safeopen: could not acquire a lock for &#039;$file&#039;: $!&quot;);
        return;
    }
}

my $_lock_ex_nb;
my $_lock_sh_nb;

sub _do_flock_or_return_exception {
    my ( $fh, $open_mode, $path ) = @_;

    my $flock_start_time;

    my $lock_op =
      _is_write_open_mode($open_mode)
      ? ( $_lock_ex_nb //= $Cpanel::Fcntl::Constants::LOCK_EX | $Cpanel::Fcntl::Constants::LOCK_NB )
      : ( $_lock_sh_nb //= $Cpanel::Fcntl::Constants::LOCK_SH | $Cpanel::Fcntl::Constants::LOCK_NB );

    local $!;
    my $flock_err;

    my $flock_max_wait_time_is_whole_number = int($MAX_FLOCK_WAIT) == $MAX_FLOCK_WAIT;

    while ( !flock $fh, $lock_op ) {
        $flock_err = $!;

        if ( $flock_err == _EINTR || $flock_err == _EWOULDBLOCK ) {
            if ( !$flock_start_time ) {
                $flock_start_time = $flock_max_wait_time_is_whole_number ? time() : Cpanel::TimeHiRes::time();
                next;
            }

            if ( ( ( $flock_max_wait_time_is_whole_number ? time() : Cpanel::TimeHiRes::time() ) - $flock_start_time ) &gt; $MAX_FLOCK_WAIT ) {
                require Cpanel::Exception;
                return _timeout_exception( $path, $MAX_FLOCK_WAIT );
            }
            else {
                Cpanel::TimeHiRes::sleep($TIME_BETWEEN_FLOCK_CHECKS);
            }
            next;
        }

        require Cpanel::Exception;
        return Cpanel::Exception::create( &#039;IO::FlockError&#039;, [ path =&gt; $path, error =&gt; $flock_err, operation =&gt; $lock_op ] );
    }

    return undef;
}

sub _safe_re_open {
    my ( $fh, $open_mode, $file, $open_method_coderef, $open_method ) = @_;

    if ( !defined $open_mode || !$open_method_coderef || !$file || $file =~ tr/\0// ) {
        _log_warn(&#039;_safe_re_open: Invalid arguments&#039;);
        return;
    }
    else {
        my $fh_type = ref $fh;
        if ( !Cpanel::FHUtils::Tiny::is_a($fh) ) {
            _log_warn(&quot;Invalid file handle type &#039;$fh_type&#039; provided for $open_method of &#039;$file&#039;&quot;);
            return;
        }
    }

    close $fh;
    if ( $open_method_coderef-&gt;( $fh, $open_mode, $file ) ) {
        if ( my $err = _do_flock_or_return_exception( $fh, $open_mode, $file ) ) {
            die $err;
        }

        return $fh;
    }
    return;
}

sub _log_warn {
    require Cpanel::Debug;
    goto &amp;Cpanel::Debug::log_warn;
}

sub _get_open_args {
    my ( $mode, $file ) = @_;
    if ( !$file ) {
        ( $mode, $file ) = $mode =~ m/^([&lt;&gt;+|]+|)(.*)/;
        if ( $file &amp;&amp; !$mode ) {
            $mode = &#039;&lt;&#039;;
        }
        elsif ( !$file ) {
            return;
        }
    }

    $mode =
        $mode eq &#039;&lt;&#039;   ? &#039;&lt;&#039;
      : $mode eq &#039;&gt;&#039;   ? &#039;&gt;&#039;
      : $mode eq &#039;&gt;&gt;&#039;  ? &#039;&gt;&gt;&#039;
      : $mode eq &#039;+&lt;&#039;  ? &#039;+&lt;&#039;
      : $mode eq &#039;+&gt;&#039;  ? &#039;+&gt;&#039;
      : $mode eq &#039;+&gt;&gt;&#039; ? &#039;+&gt;&gt;&#039;
      :                  return;

    return ( $mode, $file );
}

sub _sanitize_open_mode {
    my ($mode) = @_;

    return if $mode =~ m/[^0-9]/;

    my $safe_mode = ( $mode &amp; $Cpanel::Fcntl::Constants::O_RDONLY );
    $safe_mode |= ( $mode &amp; $Cpanel::Fcntl::Constants::O_WRONLY );
    $safe_mode |= ( $mode &amp; $Cpanel::Fcntl::Constants::O_RDWR );
    $safe_mode |= ( $mode &amp; $Cpanel::Fcntl::Constants::O_CREAT );
    $safe_mode |= ( $mode &amp; $Cpanel::Fcntl::Constants::O_EXCL );
    $safe_mode |= ( $mode &amp; $Cpanel::Fcntl::Constants::O_APPEND );
    $safe_mode |= ( $mode &amp; $Cpanel::Fcntl::Constants::O_TRUNC );
    $safe_mode |= ( $mode &amp; $Cpanel::Fcntl::Constants::O_NONBLOCK );

    return $safe_mode;
}

sub _calculate_lockfile {    ## no critic qw(Subroutines::RequireArgUnpacking)
    my $lockfile = $_[0] =~ tr{&lt;&gt;}{} ? ( ( $_[0] =~ /^[&gt;&lt;]*(.*)/ )[0] . &#039;.lock&#039; ) : $_[0] . &#039;.lock&#039;;

    return $lockfile if ( length $lockfile &lt;= MAX_LOCK_FILE_LENGTH );

    require File::Basename;
    my $lock_basename = File::Basename::basename($lockfile);

    return $lockfile if ( length $lock_basename &lt;= MAX_LOCK_FILE_LENGTH );

    require Cpanel::Hash;
    my $hashed_lock_basename = Cpanel::Hash::get_fastest_hash($lock_basename) . &quot;.lock&quot;;

    if ( $lockfile eq $lock_basename ) {
        return $hashed_lock_basename;
    }
    else {
        return File::Basename::dirname($lockfile) . &#039;/&#039; . $hashed_lock_basename;
    }
}

sub is_locked {
    my ($file) = @_;
    my $lockfile = _calculate_lockfile($file);
    my ( $lock_pid, $lock_name, $lock_obj ) = Cpanel::SafeFileLock::fetch_lock_contents_if_exists($lockfile);

    if ( _is_valid_pid($lock_pid) &amp;&amp; _pid_is_alive($lock_pid) ) {
        return 1;
    }

    return 0;
}

sub _timeout_exception {
    my ( $path, $waited ) = @_;

    require Cpanel::Exception;
    return Cpanel::Exception::create( &#039;Timeout&#039;, &#039;The system failed to lock the file “[_1]” after [quant,_2,second,seconds].&#039;, [ $path, $waited ] );
}

sub _die_if_file_is_flocked_cuz_already_waited_a_while {
    my ( $file, $waited ) = @_;

    if ( _open_to_write( my $fh, $file ) ) {
        $_lock_ex_nb //= $Cpanel::Fcntl::Constants::LOCK_EX | $Cpanel::Fcntl::Constants::LOCK_NB;
        if ( flock( $fh, $_lock_ex_nb ) == 1 ) {


            flock $fh, UNLOCK_FCNTL_VALUE or die &quot;Failed to unlock “$file” after having just locked it: $!&quot;;
        }
        else {
            require Cpanel::Exception;

            if ( $! == _EWOULDBLOCK ) {
                die _timeout_exception( $file, $waited );
            }
            else {
                die Cpanel::Exception::create( &#039;IO::FlockError&#039;, [ path =&gt; $file, error =&gt; $!, operation =&gt; $_lock_ex_nb ] );
            }
        }
    }

    return;
}

sub _lock_wait {    ## no critic qw(Subroutines::ProhibitExcessComplexity)
    my ( $file, $safefile_lock, $lockfile ) = @_;

    my ( $temp_file, $fh ) = _write_temp_lock_file( $lockfile, $file );

    if ( $temp_file eq NO_PERM_TO_WRITE_TO_DOTLOCK_DIR ) {
        return ( 1, 1 );
    }

    if ( !$temp_file ) {
        return ( 0, $fh );
    }

    $safefile_lock-&gt;set_filehandle_and_unlinker_after_lock( $fh, Cpanel::SafeFile::_temp-&gt;new($temp_file) );

    return ( 1, $fh ) if _try_to_install_lockfile( $temp_file, $lockfile );

    local $0 = ( $verbose == 1 ) ? &quot;$0 - waiting for lock on $file&quot; : &quot;$0 - waiting for lock&quot;;

    require Cpanel::SafeFile::LockInfoCache;
    require Cpanel::SafeFile::LockWatcher;

    my $watcher = Cpanel::SafeFile::LockWatcher-&gt;new($lockfile);

    my $waittime = _calculate_waittime_for_file($file);

    my ( $inotify_obj, $inotify_mask, $inotify_file_disappeared );

    my $start_time = time;
    my $waited     = 0;

    my $lockfile_cache = Cpanel::SafeFile::LockInfoCache-&gt;new($lockfile);

    my ( $inotify_inode, $inotify_mtime );

  LOCK_WAIT:
    while (1) {
        $waited = ( time() - $start_time );

        if ( $waited &gt; $waittime ) {

            _die_if_file_is_flocked_cuz_already_waited_a_while( $file, $waited );

            if ( defined $watcher-&gt;{&#039;inode&#039;} ) {
                require Cpanel::Debug;
                Cpanel::Debug::log_warn( sprintf &quot;Replacing stale lock file: $lockfile. The kernel’s lock is gone, last modified %s seconds ago (mtime=$watcher-&gt;{&#039;mtime&#039;}), and waited over $waittime seconds.&quot;, time - $watcher-&gt;{&#039;mtime&#039;} );
            }

            return ( 1, $fh ) if _overwrite_lockfile_if_inode_mtime_matches( $temp_file, $lockfile, $watcher-&gt;{&#039;inode&#039;}, $watcher-&gt;{&#039;mtime&#039;} );

            die _timeout_exception( $file, $waittime );
        }

        if ( $watcher-&gt;{&#039;inode&#039;} ) {
            my $lock_get = $lockfile_cache-&gt;get( @{$watcher}{ &#039;inode&#039;, &#039;mtime&#039; } );

            if ( !$lock_get ) {


                my $size_before_reload = $watcher-&gt;{&#039;size&#039;};
                $watcher-&gt;reload_from_disk();

                if ( $size_before_reload == 0 &amp;&amp; $watcher-&gt;{&#039;size&#039;} == 0 ) {
                    _log_warn(&quot;[$$] UID $&gt; clobbering empty lock file “$lockfile” (UID $watcher-&gt;{&#039;uid&#039;}) written by “unknown” at $watcher-&gt;{&#039;mtime&#039;}&quot;);


                    return ( 1, $fh ) if _overwrite_lockfile_if_inode_mtime_matches( $temp_file, $lockfile, $watcher-&gt;{&#039;inode&#039;}, $watcher-&gt;{&#039;mtime&#039;} );
                }

                next LOCK_WAIT;
            }

            my ( $lock_pid, $lock_name, $lock_obj ) = @$lock_get;

            if ( $lock_pid == $$ ) {
                $watcher-&gt;reload_from_disk();

                _log_warn(&quot;[$$] Double locking detected by self [LOCK_PATH]=[$lockfile] [LOCK_PID]=[$lock_pid] [LOCK_OBJ]=[$lock_obj] [LOCK_PROCESS]=[$lock_name] [ACTUAL_INODE]=[$watcher-&gt;{&#039;inode&#039;}] [ACTUAL_MTIME]=[$watcher-&gt;{&#039;mtime&#039;}]&quot;);
                return ( 0, $DOUBLE_LOCK_DETECTED );
            }
            elsif ( !_pid_is_alive($lock_pid) ) {

                my $time = time();

                if ( _overwrite_lockfile_if_inode_mtime_matches( $temp_file, $lockfile, $watcher-&gt;{&#039;inode&#039;}, $watcher-&gt;{&#039;mtime&#039;} ) ) {
                    _log_warn(&quot;[$$] TIME $time UID $&gt; clobbered stale lock file “$lockfile” (NAME “$lock_name”, UID $watcher-&gt;{&#039;uid&#039;}) written by PID $lock_pid at $watcher-&gt;{&#039;mtime&#039;}&quot;);
                    return ( 1, $fh );
                }

                $watcher-&gt;reload_from_disk();
                next LOCK_WAIT;
            }
            else {
                require Cpanel::Debug;
                Cpanel::Debug::log_info(&quot;[$$] Waiting for lock on $file held by $lock_name with pid $lock_pid&quot;) if $verbose == 1;
            }
        }

        return ( 1, $fh ) if _try_to_install_lockfile( $temp_file, $lockfile );


        $watcher-&gt;reload_from_disk();

        if ( !$inotify_obj || !$inotify_inode || !$watcher-&gt;{&#039;inode&#039;} || $inotify_inode != $watcher-&gt;{&#039;inode&#039;} || $inotify_mtime != $watcher-&gt;{&#039;mtime&#039;} ) {

          INOTIFY: {
                ( $inotify_obj, $inotify_mask, $inotify_file_disappeared ) = _generate_inotify_for_lock_file($lockfile);

                $watcher-&gt;reload_from_disk();

                if ( $inotify_file_disappeared || !$watcher-&gt;{&#039;inode&#039;} ) {

                    undef $inotify_obj;

                    next LOCK_WAIT;
                }

                redo INOTIFY if $watcher-&gt;{&#039;changed&#039;};

                ( $inotify_inode, $inotify_mtime ) = @{$watcher}{ &#039;inode&#039;, &#039;mtime&#039; };
            }
        }

        my $selected = _select( my $m = $inotify_mask, undef, undef, $TIME_BETWEEN_DOTLOCK_CHECKS );

        if ( $selected == -1 ) {

            die &quot;select() error: $!&quot; if $! != _EINTR();
        }
        elsif ($selected) {
            return ( 1, $fh ) if _try_to_install_lockfile( $temp_file, $lockfile );

            $watcher-&gt;reload_from_disk();

            () = $inotify_obj-&gt;poll();
        }
    }

    return;
}

sub _select {
    return select( $_[0], $_[1], $_[2], $_[3] );
}

sub _generate_inotify_for_lock_file {
    my ($file) = @_;
    require Cpanel::Inotify;
    my $inotify_obj;
    my $rin = &#039;&#039;;

    local $@;
    eval {
        $inotify_obj = Cpanel::Inotify-&gt;new( flags =&gt; [&#039;NONBLOCK&#039;] );

        $inotify_obj-&gt;add( $file, flags =&gt; [ &#039;ATTRIB&#039;, &#039;DELETE_SELF&#039; ] );

        vec( $rin, $inotify_obj-&gt;fileno(), 1 ) = 1;
    };

    if ($@) {
        my $err = $@;

        if ( eval { $err-&gt;isa(&#039;Cpanel::Exception::SystemCall&#039;) } ) {
            my $err = $err-&gt;get(&#039;error&#039;);
            if ( $err == _ENOENT ) {
                return ( undef, undef, INOTIFY_FILE_DISAPPEARED );
            }
            elsif ( $err != _EACCES ) {    # Don’t warn if EACCES
                local $@ = $err;
                warn;
            }
        }
        else {
            local $@ = $err;
            warn;
        }

        return;
    }

    return ( $inotify_obj, $rin, 0 );
}

sub _pid_is_alive {
    my ($pid) = @_;

    local $!;

    if ( kill( 0, $pid ) ) {
        return 1;
    }

    elsif ( $! == _EPERM ) {
        return !!( stat &quot;/proc/$pid&quot; )[0];
    }

    return 0;
}

sub _calculate_waittime_for_file {
    my ($file) = @_;

    return $LOCK_WAIT_TIME if $LOCK_WAIT_TIME;

    my $waittime = DEFAULT_LOCK_WAIT_TIME;

    if ( -e $file ) {
        $waittime = int( ( stat _ )[7] / 10000 );

        $waittime = $waittime &gt; MAX_LOCK_WAIT_TIME ? MAX_LOCK_WAIT_TIME : $waittime &lt; DEFAULT_LOCK_WAIT_TIME ? DEFAULT_LOCK_WAIT_TIME : $waittime;
    }

    return $waittime;
}

sub _is_valid_pid {
    my $pid = shift;

    return 0 unless defined $pid;

    return $pid =~ tr{0-9}{}c ? 0 : 1;
}

sub _getdir {
    my @path = split( /\/+/, $_[0] );
    return join( &#039;/&#039;, (@path)[ 0 .. ( $#path - 1 ) ] ) || &#039;.&#039;;
}

sub _create_lockfile {
    my $lock_fh;

    return sysopen( $lock_fh, $_[0], CREATE_FCNTL_VALUE, LOCK_FILE_PERMS ) ? ( 1, $lock_fh ) : ( 0, $! );
}

sub _open_to_write {
    my $path = $_[1];

    $OVERWRITE_FCNTL_VALUE ||= ( $Cpanel::Fcntl::Constants::O_WRONLY | $Cpanel::Fcntl::Constants::O_NONBLOCK | $Cpanel::Fcntl::Constants::O_APPEND | $Cpanel::Fcntl::Constants::O_NOFOLLOW );

    return sysopen( $_[0], $path, $OVERWRITE_FCNTL_VALUE, LOCK_FILE_PERMS );
}

sub _overwrite_lockfile_if_inode_mtime_matches {
    my ( $temp_file, $lockfile, $lockfile_inode, $lockfile_mtime ) = @_;

    my ( $inode, $mtime ) = ( stat $lockfile )[ 1, 9 ];

    if ( !$inode ) {
        die &quot;stat($lockfile): $!&quot; if $! != _ENOENT();
    }


    if ( !$inode || ( $inode == $lockfile_inode &amp;&amp; $mtime == $lockfile_mtime ) ) {
        rename( $temp_file, $lockfile ) or do {
            require Cpanel::Exception;
            die Cpanel::Exception::create( &#039;IO::RenameError&#039;, [ oldpath =&gt; $temp_file, newpath =&gt; $lockfile, error =&gt; $! ] );
        };

        return 1;
    }

    return 0;
}

sub _is_write_open_mode {
    my ($mode) = @_;

    if ( $mode =~ tr{0-9}{}c ) {
        if ( $mode &amp;&amp; ( -1 != index( $mode, &#039;&gt;&#039; ) || -1 != index( $mode, &#039;+&#039; ) ) ) {
            return 1;
        }
    }
    else {
        if ( $mode &amp;&amp; ( ( $mode &amp; $Cpanel::Fcntl::Constants::O_WRONLY ) || ( $mode &amp; $Cpanel::Fcntl::Constants::O_RDWR ) ) ) {
            return 1;
        }
    }
    return 0;
}

sub _verbose_flag_file_exists {
    return -e &#039;/var/cpanel/safefile_verbose&#039;;
}


package Cpanel::SafeFile::_temp;


use constant _ENOENT =&gt; 2;

sub new { return bless [ $_[1], $_SKIP_DOTLOCK_WHEN_NO_PERMS, $$ ], $_[0]; }

sub DESTROY {
    local $!;

    unlink $_[0]-&gt;[0] or do {
        if ( !$_[0]-&gt;[1] &amp;&amp; $! != _ENOENT &amp;&amp; $_[0]-&gt;[2] == $$ ) {
            warn &quot;unlink($_[0]-&gt;[0]): $!&quot;;
        }
    };

    return;
}

1;


} # --- END Cpanel/SafeFile.pm


{ # --- BEGIN Cpanel/Linux/Constants.pm
package Cpanel::Linux::Constants;


use strict;
use warnings;
no warnings &#039;once&#039;;

use constant {
    NAME_MAX =&gt; 255,
    PATH_MAX =&gt; 4096,
};

1;

} # --- END Cpanel/Linux/Constants.pm


{ # --- BEGIN Cpanel/Validate/FilesystemNodeName.pm
package Cpanel::Validate::FilesystemNodeName;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Exception        (); # perlpkg line 211
# use Cpanel::Linux::Constants (); # perlpkg line 211

sub is_valid {
    my ($node) = @_;

    local $@;
    eval { validate_or_die($node); };

    return $@ ? 0 : 1;
}

sub validate_or_die {
    my ($name) = @_;

    if ( !length $name ) {
        die Cpanel::Exception::create(&#039;Empty&#039;);
    }
    elsif ( $name eq &#039;.&#039; || $name eq &#039;..&#039; ) {
        die Cpanel::Exception::create( &#039;Reserved&#039;, [ value =&gt; $name ] );
    }
    elsif ( length $name &gt; Cpanel::Linux::Constants::NAME_MAX() ) {
        die Cpanel::Exception::create( &#039;TooManyBytes&#039;, [ value =&gt; $name, maxlength =&gt; Cpanel::Linux::Constants::NAME_MAX() ] );
    }
    elsif ( index( $name, &#039;/&#039; ) != -1 ) {
        die Cpanel::Exception::create( &#039;InvalidCharacters&#039;, [ value =&gt; $name, invalid_characters =&gt; [&#039;/&#039;] ] );
    }
    elsif ( index( $name, &quot;\0&quot; ) != -1 ) {
        die Cpanel::Exception::create( &#039;InvalidCharacters&#039;, &#039;This value may not contain a [asis,NUL] byte.&#039;, [ value =&gt; $name, invalid_characters =&gt; [&quot;\0&quot;] ] );
    }

    return 1;
}

1;

} # --- END Cpanel/Validate/FilesystemNodeName.pm


{ # --- BEGIN Cpanel/Notify.pm
package Cpanel::Notify;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Set                          (); # perlpkg line 211
# use Cpanel::Fcntl                        (); # perlpkg line 211
# use Cpanel::SafeFile                     (); # perlpkg line 211
# use Cpanel::LoadModule                   (); # perlpkg line 211
# use Cpanel::Validate::FilesystemNodeName (); # perlpkg line 211
# use Cpanel::Exception                    (); # perlpkg line 211
# use Cpanel::Debug                        (); # perlpkg line 211

our $VERSION = &#039;1.8&#039;;

my $DEFAULT_CONTENT_TYPE = &#039;text/plain; charset=utf-8&#039;;
our $NOTIFY_INTERVAL_STORAGE_DIR = &#039;/var/cpanel/notifications&#039;;

sub notification_class {
    my (%args) = @_;

    if ( !defined $args{&#039;interval&#039;} ) {
        $args{&#039;interval&#039;} = 1;
    }

    if ( !defined $args{&#039;status&#039;} ) {
        $args{&#039;status&#039;} = &#039;No status set&#039;;
    }

    foreach my $param (qw(application status class constructor_args)) {
        die Cpanel::Exception::create( &#039;MissingParameter&#039;, [ &#039;name&#039; =&gt; $param ] ) if !defined $args{$param};
    }

    if ( my @unwelcome_params = Cpanel::Set::difference( [ keys %args ], [qw(application status class constructor_args interval)] ) ) {
        die Cpanel::Exception::create_raw(
            &#039;InvalidParameters&#039;,
            &quot;The following parameters don&#039;t belong as an argument to notification_class(); you may have meant to pass these in constructor_args instead: &quot; . join( &#039; &#039;, @unwelcome_params )
        );
    }

    my $constructor_args = { @{ $args{&#039;constructor_args&#039;} } };

    if ( $constructor_args-&gt;{&#039;skip_send&#039;} ) {
        my $class = &quot;Cpanel::iContact::Class::$args{&#039;class&#039;}&quot;;
        Cpanel::LoadModule::load_perl_module($class);

        return $class-&gt;new(%$constructor_args);
    }

    return _notification_backend(
        $args{&#039;application&#039;},
        $args{&#039;status&#039;},
        $args{&#039;interval&#039;},
        sub {
            my $class = &quot;Cpanel::iContact::Class::$args{&#039;class&#039;}&quot;;
            Cpanel::LoadModule::load_perl_module($class);
            return $class-&gt;new(%$constructor_args);
        },
    );
}

sub notification {
    my %AGS = @_;

    my $app = $AGS{&#039;app&#039;} || $AGS{&#039;application&#039;} || &#039;Notice&#039;;

    return _notification_backend(
        $app,
        $AGS{&#039;status&#039;},
        $AGS{&#039;interval&#039;} || 0,
        sub {
            my $module = &quot;Cpanel::iContact&quot;;
            Cpanel::LoadModule::load_perl_module($module);

            my $from              = $AGS{&#039;from&#039;};
            my $to                = $AGS{&#039;to&#039;};
            my $msgheader         = $AGS{&#039;msgheader&#039;} || $AGS{&#039;subject&#039;};
            my $message           = $AGS{&#039;message&#039;};
            my $plaintext_message = $AGS{&#039;plaintext_message&#039;};
            my $priority          = $AGS{&#039;priority&#039;}     || 3;
            my $attach_files      = $AGS{&#039;attach_files&#039;} || [];

            my $content_type = $AGS{&#039;content-type&#039;} || $DEFAULT_CONTENT_TYPE;

            &quot;$module&quot;-&gt;can(&#039;icontact&#039;)-&gt;(
                &#039;attach_files&#039;      =&gt; $attach_files,
                &#039;application&#039;       =&gt; $app,
                &#039;level&#039;             =&gt; $priority,
                &#039;from&#039;              =&gt; $from,
                &#039;to&#039;                =&gt; $to,
                &#039;subject&#039;           =&gt; $msgheader,
                &#039;message&#039;           =&gt; $message,
                &#039;plaintext_message&#039; =&gt; $plaintext_message,
                &#039;content-type&#039;      =&gt; $content_type,
            );
        }
    );
}

sub _notification_backend {
    my ( $app, $status, $interval, $todo_cr ) = @_;

    my $is_ready = _checkstatusinterval(
        &#039;app&#039;      =&gt; $app,
        &#039;status&#039;   =&gt; $status,
        &#039;interval&#039; =&gt; $interval,
    );

    if ($is_ready) {
        return $todo_cr-&gt;();
    }
    elsif ( $Cpanel::Debug::level &gt; 3 ) {
        Cpanel::Debug::log_warn(&quot;not sending notify app=[$app] status=[$status] interval=[$interval]&quot;);
    }

    return $is_ready ? 1 : 0;
}

sub notify_blocked {
    my %AGS      = @_;
    my $app      = $AGS{&#039;app&#039;};
    my $status   = $AGS{&#039;status&#039;};
    my $interval = $AGS{&#039;interval&#039;};

    return 0 if $interval &lt;= 1;    # Special Case (ignore interval check);

    $app    =~ s{/}{_}g;           # Its possible to have slashes in the app name
    $status =~ s{:}{_}g;           # Its possible to have colons in the status

    my $db_file = &quot;$NOTIFY_INTERVAL_STORAGE_DIR/$app&quot;;

    return 0 if !-e $db_file;

    my %notifications;
    my $notify_db_fh;
    if (
        my $nlock = Cpanel::SafeFile::safesysopen(
            $notify_db_fh, $db_file, Cpanel::Fcntl::or_flags(&#039;O_RDONLY&#039;),
            0600
        )
    ) {
        local $/;
        %notifications = map { ( split( /:/, $_, 2 ) )[ 0, 1 ] } split( m{\n}, readline($notify_db_fh) );
        Cpanel::SafeFile::safeclose( $notify_db_fh, $nlock );
    }
    else {
        Cpanel::Debug::log_warn(&quot;Could not open $db_file: $!&quot;);
        return;
    }

    if ( $notifications{$status} &amp;&amp; ( ( $notifications{$status} + $interval ) &gt; time() ) ) {
        return 1;
    }

    return 0;
}

{
    no warnings &#039;once&#039;;
    *update_notification_time_if_interval_reached = \&amp;_checkstatusinterval;
}

sub _checkstatusinterval {
    my %AGS      = @_;
    my $app      = $AGS{&#039;app&#039;};
    my $status   = $AGS{&#039;status&#039;};
    my $interval = $AGS{&#039;interval&#039;};

    return 1 if $interval &lt;= 1;    # Special Case (ignore interval check);

    $app    =~ s{/}{_}g;           # Its possible to have slashes in the app name
    $status =~ s{:}{_}g;           # Its possible to have colons in the status
    Cpanel::Validate::FilesystemNodeName::validate_or_die($app);

    my $notify = 0;

    if ( !-e $NOTIFY_INTERVAL_STORAGE_DIR ) {
        Cpanel::LoadModule::load_perl_module(&#039;Cpanel::SafeDir::MK&#039;);
        Cpanel::SafeDir::MK::safemkdir( $NOTIFY_INTERVAL_STORAGE_DIR, &#039;0700&#039; );
        if ( !-d $NOTIFY_INTERVAL_STORAGE_DIR ) {
            Cpanel::Debug::log_warn(&quot;Failed to setup notifications directory: $NOTIFY_INTERVAL_STORAGE_DIR: $!&quot;);
            return;
        }
    }

    my %notifications;
    my $notify_db_fh;
    my $db_file = &quot;$NOTIFY_INTERVAL_STORAGE_DIR/$app&quot;;
    if ( my $nlock = Cpanel::SafeFile::safesysopen( $notify_db_fh, $db_file, Cpanel::Fcntl::or_flags(qw( O_RDWR O_CREAT )), 0600 ) ) {
        local $/;
        %notifications = map { ( split( /:/, $_, 2 ) )[ 0, 1 ] } split( m{\n}, readline($notify_db_fh) );
        if ( !exists $notifications{$status} || ( int( $notifications{$status} ) + int($interval) ) &lt; time() ) {
            $notifications{$status} = time;
            $notify = 1;
        }
        seek( $notify_db_fh, 0, 0 );
        print {$notify_db_fh} join( &quot;\n&quot;, map { $_ . &#039;:&#039; . $notifications{$_} } sort keys %notifications );
        truncate( $notify_db_fh, tell($notify_db_fh) );
        Cpanel::SafeFile::safeclose( $notify_db_fh, $nlock );
    }
    else {
        Cpanel::Debug::log_warn(&quot;Could not open $db_file: $!&quot;);
        return;
    }

    return $notify;
}

1;

} # --- END Cpanel/Notify.pm


{ # --- BEGIN Cpanel/Server/Utils.pm
package Cpanel::Server::Utils;


use strict;

sub is_subprocess_of_cpsrvd {
    return 0 if $INC{&#039;cpanel/cpsrvd.pm&#039;};    # If we ARE cpsrvd we do not want this behavior
    return $ENV{&#039;CPANEL&#039;} ? 1 : 0;
}

1;

} # --- END Cpanel/Server/Utils.pm


{ # --- BEGIN Cpanel/Logger.pm
package Cpanel::Logger;


use strict;

# use Cpanel::Time::Local (); # perlpkg line 211

my $is_sandbox;
my $is_smoker;
our $VERSION = 1.3;

use constant TRACE_TOUCH_FILE =&gt; &#039;/var/cpanel/log_stack_traces&#039;;

our $ENABLE_BACKTRACE;

our $DISABLE_OUTPUT;    # used by cpanminus
our $ALWAYS_OUTPUT_TO_STDERR;

our $STD_LOG_FILE   = &#039;/usr/local/cpanel/logs/error_log&#039;;
our $PANIC_LOG_FILE = &#039;/usr/local/cpanel/logs/panic_log&#039;;

my ( $cached_progname, $cached_prog_pid, %singleton_stash );


sub new {
    my ( $class, $hr_args ) = @_;

    if ( $hr_args-&gt;{&#039;open_now&#039;} &amp;&amp; $hr_args-&gt;{&#039;use_no_files&#039;} ) {
        die &quot;“open_now” and “use_no_files” mutually exclude!&quot;;
    }

    my $args_sig = &#039;no_args&#039;;
    if ( $hr_args &amp;&amp; ref($hr_args) eq &#039;HASH&#039; ) {

        $args_sig = join( &#039;,&#039;, map { $_ . &#039;=&gt;&#039; . $hr_args-&gt;{$_} } sort keys %{$hr_args} );    # Storable::freeze($hr_args);
    }

    my $no_load_from_cache = $hr_args-&gt;{&#039;no_load_from_cache&#039;} ? 1 : 0;

    if ( exists $singleton_stash{$class}{$args_sig} and !$no_load_from_cache ) {
        $singleton_stash{$class}{$args_sig}-&gt;{&#039;cloned&#039;}++;
    }
    else {
        $singleton_stash{$class}{$args_sig} = bless( {}, $class );
        if ( $hr_args &amp;&amp; ref($hr_args) eq &#039;HASH&#039; ) {
            foreach my $k ( keys %$hr_args ) {
                $singleton_stash{$class}{$args_sig}-&gt;{$k} = $hr_args-&gt;{$k};
            }
        }
    }
    my $self = $singleton_stash{$class}{$args_sig};

    if ( !$self-&gt;{&#039;cloned&#039;} ) {

        if ( $self-&gt;{&#039;open_now&#039;} &amp;&amp; !$self-&gt;{&#039;use_no_files&#039;} ) {
            $self-&gt;_open_logfile();
        }
    }

    $self-&gt;_set_backtrace( $ENABLE_BACKTRACE // $self-&gt;{&#039;backtrace&#039;} // _get_backtrace_touchfile() );

    return $self;
}

sub __Logger_pushback {
    if ( @_ &amp;&amp; index( ref( $_[0] ), __PACKAGE__ ) == 0 ) {
        return @_;
    }
    return ( __PACKAGE__-&gt;new(), @_ );
}

sub invalid {
    my ( $self, @list ) = __Logger_pushback(@_);

    my %log = (
        &#039;message&#039;   =&gt; $list[0],
        &#039;level&#039;     =&gt; &#039;invalid&#039;,
        &#039;output&#039;    =&gt; 0,
        &#039;service&#039;   =&gt; $self-&gt;find_progname(),
        &#039;backtrace&#039; =&gt; $self-&gt;get_backtrace(),
        &#039;die&#039;       =&gt; 0,
    );

    if ( is_sandbox() ) {
        if ( !-e &#039;/var/cpanel/DEBUG&#039; ) {
            $self-&gt;notify( &#039;invalid&#039;, \%log );
        }
        $log{&#039;output&#039;} = _stdin_is_tty() ? 2 : 1;
    }
    return $self-&gt;logger( \%log );
}    # end of invalid

sub is_sandbox {
    return 0           if $INC{&#039;B/C.pm&#039;};        # avoid cache during compile
    return $is_sandbox if defined $is_sandbox;
    return ( $is_sandbox = -e &#039;/var/cpanel/dev_sandbox&#039; ? 1 : 0 );
}

sub is_smoker {
    return 0          if $INC{&#039;B/C.pm&#039;};         # avoid cache during compile
    return $is_smoker if defined $is_smoker;
    return ( $is_smoker = -e &#039;/var/cpanel/smoker&#039; ? 1 : 0 );
}

sub deprecated {    ## no critic qw(Subroutines::RequireArgUnpacking)
    my ( $self, @list ) = __Logger_pushback(@_);

    my %log = (
        &#039;message&#039;   =&gt; $list[0],
        &#039;level&#039;     =&gt; &#039;deprecated&#039;,
        &#039;output&#039;    =&gt; 0,
        &#039;service&#039;   =&gt; $self-&gt;find_progname(),
        &#039;backtrace&#039; =&gt; $self-&gt;get_backtrace(),
        &#039;die&#039;       =&gt; 0,
    );

    unless ( is_sandbox() ) {
        $self-&gt;logger( \%log );
        return;
    }

    $self-&gt;notify( &#039;deprecated&#039;, \%log );

    $log{&#039;output&#039;} = _stdin_is_tty() ? 2 : 1;
    $log{&#039;die&#039;}    = 1;

    return $self-&gt;logger( \%log );
}


sub debug {
    my ( $self, $message, $conf_hr ) = @_;    # not appropriate for debug() : __Logger_pushback(@_);

    $self = $self-&gt;new() if !ref $self;

    $conf_hr ||= {
        &#039;force&#039;     =&gt; 0,
        &#039;backtrace&#039; =&gt; 0,
        &#039;output&#039;    =&gt; 1,    # Logger&#039;s debug level should output to STDOUT
    };
    return unless $conf_hr-&gt;{&#039;force&#039;} || ( defined $Cpanel::Debug::level &amp;&amp; $Cpanel::Debug::level );    ## PPI NO PARSE - avoid recursive use statements

    if ( !defined $message ) {
        my @caller = caller();
        $message = &quot;debug() at $caller[1] line $caller[2].&quot;;
    }

    my %log = (
        &#039;message&#039;   =&gt; $message,
        &#039;level&#039;     =&gt; &#039;debug&#039;,
        &#039;output&#039;    =&gt; $conf_hr-&gt;{&#039;output&#039;},
        &#039;backtrace&#039; =&gt; $conf_hr-&gt;{&#039;backtrace&#039;},
    );

    if ( ref $log{&#039;message&#039;} ) {

        my $outmsg = $log{&#039;message&#039;};
        eval &#039;local $SIG{__DIE__}; local $SIG{__WARN__}; require Cpanel::YAML::Syck; $outmsg = YAML::Syck::Dump($outmsg);&#039;;
        my @caller = caller();
        $log{&#039;message&#039;} = &quot;$log{&#039;message&#039;} at $caller[1] line $caller[2]:\n&quot; . $outmsg;
    }
    elsif ( $log{&#039;message&#039;} =~ m/\A\d+(?:\.\d+)?\z/ ) {
        $log{&#039;message&#039;} = &quot;debug() number $log{&#039;message&#039;}&quot;;
    }

    $self-&gt;logger( \%log );

    return \%log;
}


sub info {
    my ( $self, @list ) = __Logger_pushback(@_);
    return $self-&gt;logger(
        {
            &#039;message&#039; =&gt; $list[0],
            &#039;level&#039;   =&gt; &#039;info&#039;,

            &#039;output&#039;    =&gt; $self-&gt;{&#039;open_now&#039;} ? 0 : 1,    # FB#59177: info level should output to STDOUT
            &#039;backtrace&#039; =&gt; 0

        }
    );
}    # end of info


sub warn {
    my ( $self, @list ) = __Logger_pushback(@_);
    return $self-&gt;logger(
        {
            &#039;message&#039;   =&gt; $list[0],
            &#039;level&#039;     =&gt; &#039;warn&#039;,
            &#039;output&#039;    =&gt; _stdin_is_tty() ? 2 : 0,
            &#039;backtrace&#039; =&gt; $self-&gt;get_backtrace()
        }
    );
}    # end of warn


sub error {
    my ( $self, @list ) = __Logger_pushback(@_);
    return $self-&gt;logger(
        {
            &#039;message&#039;   =&gt; $list[0],
            &#039;level&#039;     =&gt; &#039;error&#039;,
            &#039;output&#039;    =&gt; -t STDIN ? 2 : 0,
            &#039;backtrace&#039; =&gt; $self-&gt;get_backtrace()
        }
    );
}    # end of error


sub die {
    my ( $self, @list ) = __Logger_pushback(@_);
    my %log = (
        &#039;message&#039;   =&gt; $list[0],
        &#039;level&#039;     =&gt; &#039;die&#039;,
        &#039;output&#039;    =&gt; _stdin_is_tty() ? 2 : 0,
        &#039;backtrace&#039; =&gt; $self-&gt;get_backtrace()
    );
    return $self-&gt;logger( \%log );
}    # end of die


sub panic {
    my ( $self, @list ) = __Logger_pushback(@_);
    my %log = (
        &#039;message&#039;   =&gt; $list[0],
        &#039;level&#039;     =&gt; &#039;panic&#039;,
        &#039;output&#039;    =&gt; 2,
        &#039;backtrace&#039; =&gt; $self-&gt;get_backtrace()
    );
    return $self-&gt;logger( \%log );
}    # end of panic

sub raw {
    return $_[0]-&gt;logger(
        {
            &#039;message&#039;   =&gt; $_[1],
            &#039;level&#039;     =&gt; &#039;raw&#039;,
            &#039;output&#039;    =&gt; 0,
            &#039;backtrace&#039; =&gt; 0
        }
    );
}

sub cplog {
    my $msg      = shift;
    my $loglevel = shift;
    my $service  = shift;
    my $nostdout = shift;
    if ( !$nostdout ) {
        $nostdout = 1;
    }
    else {
        $nostdout = 0;
    }
    logger( { &#039;message&#039; =&gt; $msg, &#039;level&#039; =&gt; $loglevel, &#039;service&#039; =&gt; $service, &#039;output&#039; =&gt; $nostdout, &#039;backtrace&#039; =&gt; $ENABLE_BACKTRACE // _get_backtrace_touchfile() } );
}    # end of cplog (deprecated)


sub _get_configuration_for_logger {
    my ( $self, $cfg_or_msg ) = @_;

    my $hr = ref($cfg_or_msg) eq &#039;HASH&#039; ? $cfg_or_msg : { &#039;message&#039; =&gt; $cfg_or_msg };

    $hr-&gt;{&#039;message&#039;} ||= &#039;Something is wrong&#039;;

    $hr-&gt;{&#039;level&#039;}  ||= &#039;&#039;;
    $hr-&gt;{&#039;output&#039;} ||= 0;

    $hr-&gt;{&#039;output&#039;} = 0 if $DISABLE_OUTPUT;
    if ( !exists $hr-&gt;{&#039;backtrace&#039;} ) {
        $hr-&gt;{&#039;backtrace&#039;} = $self-&gt;get_backtrace();
    }

    $hr-&gt;{&#039;use_no_files&#039;} ||= 0;
    $hr-&gt;{&#039;use_fullmsg&#039;}  ||= 0;

    return $hr;
}

sub _write {
    return print { $_[0] } $_[1];
}

sub get_backtrace {
    my ($self) = __Logger_pushback(@_);

    return $ENABLE_BACKTRACE // $self-&gt;{&#039;backtrace&#039;};
}

sub _set_backtrace {
    my ( $self, @args ) = __Logger_pushback(@_);
    $self-&gt;{&#039;backtrace&#039;} = $args[0] ? 1 : 0;
    return;
}

sub _get_backtrace_touchfile {
    return -e TRACE_TOUCH_FILE ? 1 : 0;
}

sub get_fh {
    my ($self) = @_;
    return $self-&gt;{&#039;log_fh&#039;};
}

sub set_fh {
    my ( $self, $fh ) = @_;
    $self-&gt;{&#039;log_fh&#039;} = $fh;
    return 1;
}
sub logger {    ## no critic(RequireArgUnpacking)
    my ( $self, @list ) = __Logger_pushback(@_);
    my $hr = $self-&gt;_get_configuration_for_logger( $list[0] );
    my ( $msg, $time, $status );
    $status = 1;

    my ($msg_maybe_bt) = $hr-&gt;{&#039;backtrace&#039;} ? $self-&gt;backtrace( $hr-&gt;{&#039;message&#039;} ) : $hr-&gt;{&#039;message&#039;} . &quot;\n&quot;;

    if ( $hr-&gt;{&#039;level&#039;} eq &#039;raw&#039; ) {
        $msg = $hr-&gt;{&#039;message&#039;};
    }
    else {
        $time ||= Cpanel::Time::Local::localtime2timestamp();
        $hr-&gt;{&#039;service&#039;} ||= $self-&gt;find_progname();                       # only compute the service name if we HAVE to do so as it can be expensive

        if ( $self-&gt;{&#039;log_pid&#039;} ) {
            $msg = &quot;[$time] $hr-&gt;{&#039;level&#039;} [$hr-&gt;{&#039;service&#039;}] [$$] $msg_maybe_bt&quot;;
        }
        else {
            $msg = &quot;[$time] $hr-&gt;{&#039;level&#039;} [$hr-&gt;{&#039;service&#039;}] $msg_maybe_bt&quot;;
        }
    }
    unless ( $hr-&gt;{&#039;use_no_files&#039;} ) {

        local $self-&gt;{&#039;log_fh&#039;} = \*STDERR if $ALWAYS_OUTPUT_TO_STDERR;

        $self-&gt;_open_logfile() if !$self-&gt;{&#039;log_fh&#039;} || ( !eval { fileno( $self-&gt;{&#039;log_fh&#039;} ) } &amp;&amp; !UNIVERSAL::isa( $self-&gt;{&#039;log_fh&#039;}, &#039;IO::Scalar&#039; ) );
        _write( $self-&gt;{&#039;log_fh&#039;}, $msg ) or $status = 0;

        if ( $hr-&gt;{&#039;level&#039;} eq &#039;panic&#039; || $hr-&gt;{&#039;level&#039;} eq &#039;invalid&#039; || $hr-&gt;{&#039;level&#039;} eq &#039;deprecated&#039; ) {
            my $panic_fh;
            require Cpanel::FileUtils::Open;
            if ( Cpanel::FileUtils::Open::sysopen_with_real_perms( $panic_fh, $PANIC_LOG_FILE, &#039;O_WRONLY|O_APPEND|O_CREAT&#039;, 0600 ) ) {
                $time ||= Cpanel::Time::Local::localtime2timestamp();
                $hr-&gt;{&#039;service&#039;} ||= $self-&gt;find_progname();                       # only compute the service name if we HAVE to do so as it can be expensive
                _write( $panic_fh, &quot;$time $hr-&gt;{level} [$hr-&gt;{&#039;service&#039;}] $msg_maybe_bt&quot; );
                close $panic_fh;
            }
        }
    }

    if ( $hr-&gt;{&#039;output&#039;} ) {
        $hr-&gt;{&#039;service&#039;} ||= $self-&gt;find_progname();    # only compute the service name if we HAVE to do so as it can be expensive
        my $out = &quot;$hr-&gt;{level} [$hr-&gt;{&#039;service&#039;}] $hr-&gt;{&#039;message&#039;}\n&quot;;
        if ( $self-&gt;{&#039;timestamp_prefix&#039;} ) {
            $out = &quot;[$time] $out&quot;;
        }
        $out = $msg if $hr-&gt;{&#039;use_fullmsg&#039;};

        $status &amp;&amp;= $self-&gt;_write_message( $hr, $out );
    }

    if ( ( $hr-&gt;{&#039;level&#039;} eq &#039;die&#039; || $hr-&gt;{&#039;level&#039;} eq &#039;panic&#039; || $hr-&gt;{&#039;die&#039;} ) ) {
        CORE::die &quot;exit level [$hr-&gt;{&#039;level&#039;}] [pid=$$] ($hr-&gt;{&#039;message&#039;})\n&quot;;    # make sure we die if die is overwritten
    }

    return $status;
}    # end of logger

sub _write_message {
    my ( $self, $hr, $out ) = @_;
    my $status = 1;

    if ( $hr-&gt;{&#039;output&#039;} == 3 ) {
        _write( \*STDOUT, $out ) or $status = 0;
        _write( \*STDERR, $out ) or $status = 0;
    }
    elsif ( $hr-&gt;{&#039;output&#039;} == 1 &amp;&amp; ( $self-&gt;{&#039;use_stdout&#039;} || _stdout_is_tty() ) ) {
        _write( \*STDOUT, $out ) or $status = 0;
    }
    elsif ( $hr-&gt;{&#039;output&#039;} == 2 ) {
        _write( \*STDERR, $out ) or $status = 0;
    }
    return $status;
}

sub find_progname {
    if ( $cached_progname &amp;&amp; $cached_prog_pid == $$ ) {
        return $cached_progname;
    }
    my $s = $0;

    if ( !length $s ) {    # Someone _could_ set $0 = &#039;&#039;;
        my $i = 1;         # 0 is always find_progname
        while ( my @service = caller( $i++ ) ) {
            last             if ( $service[3] =~ /::BEGIN$/ );
            $s = $service[1] if ( $service[1] ne &#039;&#039; );
        }
    }

    $s =~ s@.+/(.+)$@$1@ if $s =~ tr{/}{};

    $s =~ s@\..+$@@ if $s =~ tr{\.}{};

    $s =~ s@ .*$@@ if $s =~ tr{ }{};

    $cached_progname = $s;
    $cached_prog_pid = $$;

    return $s;
}

sub backtrace {    ## no critic qw(Subroutines::RequireArgUnpacking)
    my ( $self, @list ) = __Logger_pushback(@_);
    if ( ref $list[0] ) {
        return $list[0] if scalar @list == 1;
        return (@list);
    }
    require Cpanel::Carp;
    local $_;    # Protect surrounding program - just in case...
    local $Carp::Internal{ (__PACKAGE__) } = 1;
    local $Carp::Internal{&#039;Cpanel::Debug&#039;} = 1;
    return Cpanel::Carp::safe_longmess(@list);

}

sub redirect_stderr_to_error_log {
    return open( STDERR, &#039;&gt;&gt;&#039;, $STD_LOG_FILE );
}

sub notify {
    my ( $self, $call, $log_ref ) = @_;

    my $time = Cpanel::Time::Local::localtime2timestamp();
    my ($bt) = $self-&gt;backtrace( $log_ref-&gt;{&#039;message&#039;} );
    $log_ref-&gt;{&#039;service&#039;} //= &#039;&#039;;
    my $logfile = qq{$time [$log_ref-&gt;{&#039;service&#039;}] } . ( $bt // &#039;&#039; );

    if ( eval { require Cpanel::LoadModule; Cpanel::LoadModule::load_perl_module(&#039;Cpanel::iContact::Class::Logger::Notify&#039;); 1; } ) {

        eval {
            require Cpanel::Notify;
            Cpanel::Notify::notification_class(
                &#039;class&#039;            =&gt; &#039;Logger::Notify&#039;,
                &#039;application&#039;      =&gt; &#039;Logger::Notify&#039;,
                &#039;constructor_args&#039; =&gt; [
                    &#039;origin&#039;       =&gt; $log_ref-&gt;{&#039;service&#039;},
                    &#039;logger_call&#039;  =&gt; $call,
                    &#039;attach_files&#039; =&gt; [ { name =&gt; &#039;cpanel-logger-log.txt&#039;, content =&gt; \$logfile } ],
                    &#039;subject&#039;      =&gt; $log_ref-&gt;{&#039;subject&#039;},
                ]
            );
        };

    }

    elsif ( eval { require Cpanel::LoadModule; Cpanel::LoadModule::load_perl_module(&#039;Cpanel::iContact&#039;); 1; } ) {
        Cpanel::iContact::icontact(
            &#039;application&#039; =&gt; $log_ref-&gt;{&#039;service&#039;},
            &#039;subject&#039;     =&gt; $log_ref-&gt;{&#039;subject&#039;} ? $log_ref-&gt;{&#039;subject&#039;} : qq{Cpanel::Logger::$call called in $log_ref-&gt;{&#039;service&#039;}},
            &#039;message&#039;     =&gt; $logfile,
        );

    }
    else {
        CORE::warn( $log_ref-&gt;{&#039;subject&#039;} ? $log_ref-&gt;{&#039;subject&#039;} : qq{Cpanel::Logger::$call called in $log_ref-&gt;{&#039;service&#039;}} . &quot;: $logfile&quot; );
    }

    return;
}

*fatal   = *die;
*out     = *info;
*success = *info;
*throw   = *die;
*warning = *warn;

sub _is_subprocess_of_cpsrvd {
    require Cpanel::Server::Utils;
    goto \&amp;Cpanel::Server::Utils::is_subprocess_of_cpsrvd;
}

sub _open_logfile {
    my ($self) = @_;
    my $usingstderr = 0;
    my $log_fh;

    $self-&gt;{&#039;alternate_logfile&#039;} ||= $STD_LOG_FILE;
    if ( $STD_LOG_FILE eq $self-&gt;{&#039;alternate_logfile&#039;} &amp;&amp; _is_subprocess_of_cpsrvd() ) {
        $log_fh      = \*STDERR;
        $usingstderr = 1;
    }
    else {
        require Cpanel::FileUtils::Open;
        if ( !Cpanel::FileUtils::Open::sysopen_with_real_perms( $log_fh, $self-&gt;{&#039;alternate_logfile&#039;}, &#039;O_WRONLY|O_APPEND|O_CREAT&#039;, 0600 ) ) {
            ( $usingstderr, $log_fh ) = ( 1, \*STDERR );
        }

        select( ( select($log_fh), $| = 1 )[0] );    ## no critic qw(Variables::RequireLocalizedPunctuationVars InputOutput::ProhibitOneArgSelect) -- Cpanel::FHUtils::Autoflush would be expensive to load every time
    }

    $self-&gt;{&#039;log_fh&#039;}      = $log_fh;
    $self-&gt;{&#039;usingstderr&#039;} = $usingstderr;
    return 1;
}

sub _stdin_is_tty {
    local $@;
    return eval { -t STDIN };
}

sub _stdout_is_tty {
    local $@;
    return eval { -t STDOUT };
}

sub clear_singleton_stash {
    %singleton_stash = ();
    return;
}

1;


} # --- END Cpanel/Logger.pm


{ # --- BEGIN Cpanel/Debug.pm
package Cpanel::Debug;


use strict;
use warnings;
no warnings &#039;once&#039;;


our $HOOKS_DEBUG_FILE = &#039;/var/cpanel/debughooks&#039;;

our $level = ( exists $ENV{&#039;CPANEL_DEBUG_LEVEL&#039;} &amp;&amp; $ENV{&#039;CPANEL_DEBUG_LEVEL&#039;} ? int $ENV{&#039;CPANEL_DEBUG_LEVEL&#039;} : 0 );


my $debug_hooks_value;
my $logger;


sub debug_level {
    my ($level) = @_;
    $Cpanel::Debug::level = $level if defined $level;
    return $Cpanel::Debug::level;
}


sub logger {
    $logger = shift if (@_);    # Set method for $logger if something is passed in.

    return $logger ||= do {
        local ( $@, $! );
        require Cpanel::Logger;

        Cpanel::Logger-&gt;new();
    };
}


sub log_error {
    local $!;                   #prevent logger from overwriting $!
    return logger()-&gt;error( $_[0] );
}


sub log_warn {
    local $!;    #prevent logger from overwriting $!
    return logger()-&gt;warn( $_[0] );
}


sub log_warn_no_backtrace {
    local $!;    #prevent logger from overwriting $!

    my $logger = logger();

    no warnings &#039;once&#039;;
    local $Cpanel::Logger::ENABLE_BACKTRACE = 0;

    return $logger-&gt;warn( $_[0] );
}


sub log_invalid {
    local $!;    #prevent logger from overwriting $!
    return logger()-&gt;invalid( $_[0] );
}


sub log_deprecated {
    local $!;    #prevent logger from overwriting $!
    return logger()-&gt;deprecated( $_[0] );
}


sub log_panic {
    local $!;    #prevent logger from overwriting $!
    return logger()-&gt;panic( $_[0] );
}


sub log_die {
    local $!;    #prevent logger from overwriting $!
    return logger()-&gt;die( $_[0] );
}


sub log_info {
    local $!;    #prevent logger from overwriting $!
    return logger()-&gt;info( $_[0] );
}


sub log_debug {
    local $!;    #prevent logger from overwriting $!
    return logger()-&gt;debug( $_[0] );
}


sub log_dump {
    require Data::Dumper;
    no warnings &#039;once&#039;;
    local $Data::Dumper::Sortkeys = 1;
    return log_info( Data::Dumper::Dumper( $_[0] ) );
}


sub debug_hooks_value {
    return $debug_hooks_value if defined $debug_hooks_value;
    return ( $debug_hooks_value = ( stat($HOOKS_DEBUG_FILE) )[7] || 0 );
}


1;

} # --- END Cpanel/Debug.pm


{ # --- BEGIN Cpanel/SafeDir/MK.pm
package Cpanel::SafeDir::MK;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Debug (); # perlpkg line 211

my $DEFAULT_PERMISSIONS = 0755;


sub safemkdir_or_die {
    my ( $dir, $mode, $created ) = @_;
    my $ok = safemkdir( $dir, $mode, $created );
    if ( !$ok ) {
        my $error = $!;
        require Cpanel::Exception;
        die Cpanel::Exception::create(
            &#039;IO::DirectoryCreateError&#039;,
            [
                path  =&gt; $dir,
                error =&gt; $error,
            ]
        );
    }
    return $ok;
}


sub safemkdir {    ## no critic(Subroutines::ProhibitExcessComplexity)  -- Refactoring this function is a project, not a bug fix
    my ( $dir, $mode, $errors, $created ) = @_;

    if ( defined $mode ) {
        if ( $mode eq &#039;&#039; ) {
            $mode = undef;
        }
        elsif ( index( $mode, &#039;0&#039; ) == 0 ) {
            if ( length $mode &lt; 3 || $mode =~ tr{0-7}{}c || !defined oct $mode ) {
                $mode = $DEFAULT_PERMISSIONS;
            }
            else {
                $mode = oct($mode);
            }
        }
        elsif ( $mode =~ tr{0-9}{}c ) {
            $mode = $DEFAULT_PERMISSIONS;
        }
    }
    $dir =~ tr{/}{}s;

    my $default = &#039;&#039;;
    if ( index( $dir, &#039;/&#039; ) == 0 ) {
        $default = &#039;/&#039;;
    }
    elsif ( $dir eq &#039;.&#039; || $dir eq &#039;./&#039; ) {
        if ( !-l $dir &amp;&amp; defined $mode ) {
            return chmod $mode, $dir;
        }
        return 1;
    }
    else {
        substr( $dir, 0, 2, &#039;&#039; ) if index( $dir, &#039;./&#039; ) == 0;
    }

    if ( _has_dot_dot($dir) ) {
        Cpanel::Debug::log_warn(&quot;Possible improper directory $dir specified&quot;);
        my @dir_parts = split m{/}, $dir;
        my @good_parts;
        my $first;
        foreach my $part (@dir_parts) {
            next if ( !defined $part || $part eq &#039;&#039; );
            next if $part eq &#039;.&#039;;
            if ( $part eq &#039;..&#039; ) {
                if ( !$first || !@good_parts ) {
                    Cpanel::Debug::log_warn(&quot;Will not proceed above first directory part $first&quot;);
                    return 0;
                }
                if ( $first eq $good_parts[$#good_parts] ) {
                    undef $first;
                }
                pop @good_parts;
                next;
            }
            elsif ( $part !~ tr{.}{}c ) {
                Cpanel::Debug::log_warn(&quot;Total stupidity found in directory $dir&quot;);
                return 0;
            }
            push @good_parts, $part;
            if ( !$first ) { $first = $part }
        }
        $dir = $default . join &#039;/&#039;, @good_parts;
        if ( !$dir ) {
            Cpanel::Debug::log_warn(&quot;Could not validate given directory&quot;);
            return;
        }
        Cpanel::Debug::log_warn(&quot;Improper directory updated to $dir&quot;);
    }

    if ( -d $dir ) {
        if ( !-l $dir &amp;&amp; defined $mode ) {
            return chmod $mode, $dir;
        }
        return 1;
    }
    elsif ( -e _ ) {
        Cpanel::Debug::log_warn(&quot;$dir was expected to be a directory!&quot;);
        require Errno;
        $! = Errno::ENOTDIR();    ## no critic qw(Variables::RequireLocalizedPunctuationVars) -- for legacy reasons
        return 0;
    }

    my @dir_parts = split m{/}, $dir;

    if ( scalar @dir_parts &gt; 100 ) {
        Cpanel::Debug::log_warn(&quot;Encountered excessive directory length. This should never happen.&quot;);
        return 0;
    }
    my $returnvalue;
    foreach my $i ( 0 .. $#dir_parts ) {
        my $newdir = join( &#039;/&#039;, @dir_parts[ 0 .. $i ] );
        next if $newdir eq &#039;&#039;;
        my $is_dir = -d $newdir;
        my $exists = -e _;

        if ( !$exists ) {
            my $local_mode = defined $mode ? $mode : $DEFAULT_PERMISSIONS;
            if ( mkdir( $newdir, $local_mode ) ) {
                push @{$created}, $newdir if $created;
                $returnvalue++;
            }
            else {
                Cpanel::Debug::log_warn(&quot;mkdir $newdir failed: $!&quot;);
                return;
            }
        }
        elsif ( !$is_dir ) {
            Cpanel::Debug::log_warn(&quot;Encountered non-directory $newdir in path of $dir: $!&quot;);
            require Errno;
            $! = Errno::ENOTDIR();    ## no critic qw(Variables::RequireLocalizedPunctuationVars) -- for legacy reasons
            last;
        }
    }
    return $returnvalue;
}

sub _has_dot_dot {    ## no critic qw(RequireArgUnpacking)
    return 1 if $_[0] eq &#039;..&#039;;
    return 1 if -1 != index( $_[0], &#039;/../&#039; );
    return 1 if 0 == index( $_[0], &#039;../&#039; );
    return 1 if ( length( $_[0] ) - 3 ) == rindex( $_[0], &#039;/..&#039; );

    return 0;
}

1;

} # --- END Cpanel/SafeDir/MK.pm


{ # --- BEGIN Cpanel/FHUtils/Autoflush.pm
package Cpanel::FHUtils::Autoflush;


use strict;
use warnings;
no warnings &#039;once&#039;;

sub enable {
    select( ( select( $_[0] ), $| = 1 )[0] );    ## no critic qw(InputOutput::ProhibitOneArgSelect Variables::RequireLocalizedPunctuationVars) - aka $socket-&gt;autoflush(1) without importing IO::Socket

    return;
}

1;

} # --- END Cpanel/FHUtils/Autoflush.pm


{ # --- BEGIN Cpanel/Update/Logger.pm
package Cpanel::Update::Logger;


use strict;
use warnings;
no warnings &#039;once&#039;;
# use Cpanel::SafeDir::MK        (); # perlpkg line 211
# use Cpanel::Time::Local        (); # perlpkg line 211
# use Cpanel::FHUtils::Autoflush (); # perlpkg line 211
use File::Basename             ();

use constant {
    DEBUG =&gt; 0,
    INFO  =&gt; 25,
    WARN  =&gt; 50,
    ERROR =&gt; 75,
    FATAL =&gt; 100,
};

our $VERSION = &#039;1.2&#039;;

our $_BACKLOG_TIE_CLASS;

sub new {
    my $class = shift;
    my $self  = shift || {};
    ref($self) eq &#039;HASH&#039; or CORE::die(&quot;hashref not passed to new&quot;);

    bless( $self, $class );

    $self-&gt;{&#039;stdout&#039;} = 1 if ( !defined $self-&gt;{&#039;stdout&#039;} );

    $self-&gt;{&#039;timestamp&#039;} = 1 if ( !defined $self-&gt;{&#039;timestamp&#039;} );

    if ( $self-&gt;{&#039;to_memory&#039;} ) {
        $self-&gt;{&#039;backlog&#039;} = [];

        tie @{ $self-&gt;{&#039;backlog&#039;} }, $_BACKLOG_TIE_CLASS if $_BACKLOG_TIE_CLASS;
    }

    eval { $self-&gt;set_logging_level( $self-&gt;{&#039;log_level&#039;} ); 1 }
      or CORE::die(&quot;An invalid logging level was passed to new: $self-&gt;{&#039;log_level&#039;}&quot;);

    $self-&gt;open_log() if $self-&gt;{&#039;logfile&#039;};

    if ( exists $self-&gt;{&#039;pbar&#039;} and defined $self-&gt;{&#039;pbar&#039;} ) {
        $self-&gt;{&#039;pbar&#039;} += 0;
        $self-&gt;update_pbar( $self-&gt;{&#039;pbar&#039;} );
    }

    return $self;
}

sub open_log {
    my $self = shift or CORE::die();

    my $log_file    = $self-&gt;{&#039;logfile&#039;};
    my $logfile_dir = File::Basename::dirname($log_file);
    my $created_dir = 0;
    if ( !-d $logfile_dir ) {
        Cpanel::SafeDir::MK::safemkdir( $logfile_dir, &#039;0700&#039;, 2 );
        $created_dir = 1;
    }

    my $old_umask = umask(0077);    # Case 92381: Logs should not be world-readable
    open( my $fh, &#039;&gt;&gt;&#039;, $log_file ) or do {
        CORE::die(&quot;Failed to open &#039;$log_file&#039; for append: $!&quot;);
    };

    umask($old_umask);

    Cpanel::FHUtils::Autoflush::enable($fh);
    Cpanel::FHUtils::Autoflush::enable( \*STDOUT ) if $self-&gt;{&#039;stdout&#039;};

    $self-&gt;{&#039;fh&#039;} = $fh;

    unless ( $self-&gt;{brief} ) {
        print {$fh} &#039;-&#039; x 100 . &quot;\n&quot;;
        print {$fh} &quot;=&gt; Log opened from $0 ($$) at &quot; . localtime(time) . &quot;\n&quot;;
    }

    $self-&gt;warning(&quot;Had to create directory $logfile_dir before opening log&quot;) if ($created_dir);

    return;
}

sub close_log {
    my $self = shift or CORE::die();

    return if ( !$self-&gt;{&#039;fh&#039;} );
    my $fh = $self-&gt;{&#039;fh&#039;};

    unless ( $self-&gt;{brief} ) {
        print {$fh} &quot;=&gt; Log closed &quot; . localtime(time) . &quot;\n&quot;;
    }

    warn(&quot;Failed to close file handle for $self-&gt;{&#039;logfile&#039;}&quot;) if ( !close $fh );
    delete $self-&gt;{&#039;fh&#039;};

    return;
}

sub DESTROY {
    my $self = shift or CORE::die(&quot;DESTROY called without an object&quot;);
    $self-&gt;close_log if ( $self-&gt;{&#039;fh&#039;} );

    return;
}

sub log {
    my $self = shift         or CORE::die(&quot;log called as a class&quot;);
    ref $self eq __PACKAGE__ or CORE::die(&quot;log called as a class&quot;);

    my $msg = shift or return;

    my $stdout = shift;
    $stdout = $self-&gt;{&#039;stdout&#039;} if ( !defined $stdout );

    my $to_memory = $self-&gt;{&#039;to_memory&#039;};
    my $fh        = $self-&gt;{&#039;fh&#039;};

    foreach my $line ( split( /[\r\n]+/, $msg ) ) {
        if ( $self-&gt;{&#039;timestamp&#039;} ) {
            substr( $line, 0, 0, &#039;[&#039; . Cpanel::Time::Local::localtime2timestamp() . &#039;] &#039; );
        }

        chomp $line;
        print STDOUT &quot;$line\n&quot; if $stdout;
        print {$fh} &quot;$line\n&quot;  if $fh;
        push @{ $self-&gt;{&#039;backlog&#039;} }, &quot;$line&quot; if ($to_memory);
    }

    return;
}

sub _die {
    my $self    = shift or CORE::die();
    my $message = shift || &#039;&#039;;

    $self-&gt;log(&quot;***** DIE: $message&quot;);
    return CORE::die( &quot;exit level [die] [pid=$$] ($message) &quot; . join &#039; &#039;, caller() );
}

sub fatal {
    my $self = shift or CORE::die();
    return if ( $self-&gt;{&#039;log_level_numeric&#039;} &gt; FATAL );

    my $message = shift || &#039;&#039;;

    $self-&gt;log(&quot;***** FATAL: $message&quot;);
    $self-&gt;set_need_notify();

    return;
}

sub error {
    my $self = shift or CORE::die();
    return if ( $self-&gt;{&#039;log_level_numeric&#039;} &gt; ERROR );

    my $message = shift || &#039;&#039;;

    $self-&gt;log(&quot;E $message&quot;);

    return;
}

sub warning {
    my $self = shift or CORE::die();
    return if ( $self-&gt;{&#039;log_level_numeric&#039;} &gt; WARN );

    my $message = shift || &#039;&#039;;

    $self-&gt;log(&quot;W $message&quot;);

    return;
}

sub panic {
    my $self = shift or CORE::die();
    return if ( $self-&gt;{&#039;log_level_numeric&#039;} &gt; ERROR );

    my $message = shift || &#039;&#039;;

    $self-&gt;log(&quot;***** PANIC!&quot;);
    $self-&gt;log(&quot;E $message&quot;);
    $self-&gt;log(&quot;***** PANIC!&quot;);
    $self-&gt;set_need_notify();

    return;
}

sub info {
    my $self = shift or CORE::die();
    return if ( $self-&gt;{&#039;log_level_numeric&#039;} &gt; INFO );

    my $message = shift || &#039;&#039;;

    $self-&gt;log(&quot;  $message&quot;);

    return;
}

sub debug {
    my $self = shift or CORE::die();
    return if ( $self-&gt;{&#039;log_level_numeric&#039;} &gt; DEBUG );

    my $message = shift || &#039;&#039;;

    $self-&gt;log(&quot;D $message&quot;);

    return;
}

sub get_logging_level { return shift-&gt;{&#039;log_level&#039;} }

sub set_logging_level {
    my $self = shift or CORE::die();

    my $log_level = shift;
    $log_level = &#039;info&#039; if ( !defined $log_level );

    my $old_log_level = $self-&gt;get_logging_level();

    if ( $log_level =~ m/^fatal/i ) {
        $self-&gt;{&#039;log_level&#039;}         = &#039;fatal&#039;;
        $self-&gt;{&#039;log_level_numeric&#039;} = FATAL;
    }
    elsif ( $log_level =~ m/^error/i ) {
        $self-&gt;{&#039;log_level&#039;}         = &#039;error&#039;;
        $self-&gt;{&#039;log_level_numeric&#039;} = ERROR;
    }
    elsif ( $log_level =~ m/^warn/i ) {
        $self-&gt;{&#039;log_level&#039;}         = &#039;warning&#039;;
        $self-&gt;{&#039;log_level_numeric&#039;} = WARN;
    }
    elsif ( $log_level =~ m/^info/i ) {
        $self-&gt;{&#039;log_level&#039;}         = &#039;info&#039;;
        $self-&gt;{&#039;log_level_numeric&#039;} = INFO;
    }
    elsif ( $log_level =~ m/^debug/i ) {
        $self-&gt;{&#039;log_level&#039;}         = &#039;debug&#039;;
        $self-&gt;{&#039;log_level_numeric&#039;} = DEBUG;
    }
    else {
        CORE::die(&quot;Unknown logging level &#039;$log_level&#039; passed to set_logging_level&quot;);
    }

    return $old_log_level;
}

sub get_pbar { return shift-&gt;{&#039;pbar&#039;} }

sub increment_pbar {
    my $self = shift or CORE::die();
    return if ( !exists $self-&gt;{&#039;pbar&#039;} );

    my $amount    = shift || 1;
    my $new_value = $self-&gt;{&#039;pbar&#039;} + $amount;

    return $self-&gt;update_pbar($new_value);
}

sub update_pbar {
    my $self = shift or CORE::die();
    return if ( !exists $self-&gt;{&#039;pbar&#039;} );

    my $new_value = shift || 0;
    if ( $new_value &gt; 100 ) {
        $self-&gt;debug(&quot;Pbar set to &gt; 100 ($new_value)&quot;);
        $new_value = 100;
    }

    return if $new_value == $self-&gt;{&#039;pbar&#039;};
    $self-&gt;{&#039;pbar&#039;} = $new_value;

    $self-&gt;info( $new_value . &#039;% complete&#039; );

    return;
}

sub set_need_notify {
    my $self = shift;
    ref $self eq __PACKAGE__ or CORE::die(&quot;log called as a class&quot;);
    $self-&gt;info(&quot;The Administrator will be notified to review this output when this script completes&quot;);

    return $self-&gt;{&#039;need_notify&#039;} = 1;
}

sub get_need_notify {
    my $self = shift;
    ref $self eq __PACKAGE__ or CORE::die(&quot;log called as a class&quot;);
    return $self-&gt;{&#039;need_notify&#039;};
}

sub get_stored_log {
    my $self = shift;
    ref $self eq __PACKAGE__ or CORE::die(&quot;log called as a class&quot;);

    return if ( !$self-&gt;{&#039;to_memory&#039;} );

    return $self-&gt;{&#039;backlog&#039;};
}

sub get_next_log_message {
    my $self = shift;
    ref $self eq __PACKAGE__ or CORE::die(&quot;log called as a class&quot;);

    return if ( !$self-&gt;{&#039;to_memory&#039;} );

    return shift @{ $self-&gt;{&#039;backlog&#039;} };
}

sub success { goto \&amp;info; }
sub out     { goto \&amp;info; }
sub warn    { goto \&amp;warning; }
sub die     { goto \&amp;_die; }

1;

} # --- END Cpanel/Update/Logger.pm


{ # --- BEGIN Cpanel/FileUtils/TouchFile.pm
package Cpanel::FileUtils::TouchFile;


use strict;
use warnings;
no warnings &#039;once&#039;;


use constant {
    _ENOENT =&gt; 2,
};

my $logger;

our $VERSION = &#039;1.3&#039;;

sub _log {
    my ( $level, $msg ) = @_;

    require Cpanel::Logger;
    $logger ||= Cpanel::Logger-&gt;new();
    $logger-&gt;$level($msg);

    return;
}

my $mtime;

sub touchfile {
    my ( $file, $verbose, $fail_ok ) = @_;

    if ( !defined $file ) {
        _log( &#039;warn&#039;, &quot;touchfile called with undefined file&quot; );
        return;
    }

    my $mtime;

    if ( utime undef, undef, $file ) {
        return 1;
    }
    elsif ( $! != _ENOENT() ) {
        _log( &#039;warn&#039;, &quot;utime($file) as $&gt;: $!&quot; );

        $mtime = -e $file ? ( stat _ )[9] : 0;    # for warnings-safe numeric comparison

        if ( !$mtime &amp;&amp; $! != _ENOENT ) {
            _log( &#039;warn&#039;, &quot;Failed to stat($file) as $&gt;: $!&quot; );
            return;
        }
    }

    $mtime = ( stat $file )[9] // 0;

    if ( open my $fh, &#039;&gt;&gt;&#039;, $file ) {    # append so we don&#039;t wipe out contents
        my $mtime_after_open = ( stat $fh )[9] || 0;    # for warnings safe numeric comparison
        return 1 if $mtime != $mtime_after_open;        # in case open does not change it, see comment below
    }
    else {
        _log( &#039;warn&#039;, &quot;Failed to open(&gt;&gt; $file) as $&gt;: $!&quot; ) unless $fail_ok;
    }

    if ($fail_ok) { return; }

    my $at_this_point = ( stat $file )[9] || 0;    # for warnings safe numeric comparison
    if ( $mtime == $at_this_point ) {

        my $new_at_this_point = ( stat $file )[9] || 0;    # for warnings safe numeric comparison
        if ( $mtime == $new_at_this_point ) {
            if ($verbose) {
                _log( &#039;info&#039;, &#039;Trying to do system “touch” command!&#039; );
            }
            if ( system( &#039;touch&#039;, $file ) != 0 ) {
                if ($verbose) {
                    _log( &#039;info&#039;, &#039;system method 1 failed.&#039; );
                }
            }
        }
    }

    if ( !-e $file ) {    # obvisouly it didn&#039;t touch it if it doesn&#039;t exist...
        _log( &#039;warn&#039;, &quot;Failed to create $file: $!&quot; );
        return;
    }
    else {

        my $after_all_that = ( stat $file )[9] || 0;    # for warnings safe numeric comparison
        if ( $mtime &amp;&amp; $mtime == $after_all_that ) {
            _log( &#039;warn&#039;, &quot;mtime of “$file” not changed!&quot; );
            return;
        }
        return 1;
    }
}

1;

} # --- END Cpanel/FileUtils/TouchFile.pm


{ # --- BEGIN Cpanel/LoadFile/ReadFast.pm
package Cpanel::LoadFile::ReadFast;


use strict;
use warnings;
no warnings &#039;once&#039;;


use constant READ_CHUNK =&gt; 1 &lt;&lt; 18;    # 262144

use constant _EINTR =&gt; 4;


sub read_fast {
    $_[1] //= q&lt;&gt;;

    return ( @_ &gt; 3 ? sysread( $_[0], $_[1], $_[2], $_[3] ) : sysread( $_[0], $_[1], $_[2] ) ) // do {
        goto \&amp;read_fast if $! == _EINTR;
        die &quot;Failed to read data: $!&quot;;
    };
}


my $_ret;

sub read_all_fast {
    $_[1] //= q&lt;&gt;;

    $_ret = 1;
    while ($_ret) {
        $_ret = sysread( $_[0], $_[1], READ_CHUNK, length $_[1] ) // do {
            redo if $! == _EINTR;
            die &quot;Failed to read data: $!&quot;;
        }
    }
    return;
}

1;

} # --- END Cpanel/LoadFile/ReadFast.pm


{ # --- BEGIN Cpanel/LoadFile.pm
package Cpanel::LoadFile;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Exception          (); # perlpkg line 211
# use Cpanel::Fcntl::Constants   (); # perlpkg line 211
# use Cpanel::LoadFile::ReadFast (); # perlpkg line 211

sub loadfileasarrayref {
    my $fileref = _load_file( shift, { &#039;array_ref&#039; =&gt; 1 } );
    return ref $fileref eq &#039;ARRAY&#039; ? $fileref : undef;
}

sub loadbinfile {
    my $fileref = _load_file( shift, { &#039;binmode&#039; =&gt; 1 } );
    return ref $fileref eq &#039;SCALAR&#039; ? $$fileref : undef;
}

sub slurpfile {
    my $fh      = shift;
    my $fileref = _load_file(shift);
    if ( ref $fileref eq &#039;SCALAR&#039; ) {
        print {$fh} $$fileref;
    }
    return;
}

sub loadfile {
    my $fileref = _load_file(@_);
    return ref $fileref eq &#039;SCALAR&#039; ? $$fileref : undef;
}

sub loadfile_r {
    my ( $file, $arg_ref ) = @_;

    if ( open my $lf_fh, &#039;&lt;:stdio&#039;, $file ) {
        if ( $arg_ref-&gt;{&#039;binmode&#039;} ) { binmode $lf_fh; }

        my $data;
        if ( $arg_ref-&gt;{&#039;array_ref&#039;} ) {
            @{$data} = readline $lf_fh;
            close $lf_fh;
            return $data;
        }
        else {
            $data = &#039;&#039;;
            local $@;

            eval { Cpanel::LoadFile::ReadFast::read_all_fast( $lf_fh, $data ); };
            return $@ ? undef : \$data;
        }
    }

    return;
}

*_load_file = *loadfile_r;

sub _open {
    return _open_if_exists( $_[0] ) || die Cpanel::Exception::create( &#039;IO::FileNotFound&#039;, [ path =&gt; $_[0], error =&gt; _ENOENT() ] );
}

sub _open_if_exists {
    local $!;
    open my $fh, &#039;&lt;:stdio&#039;, $_[0] or do {

        if ( $! == _ENOENT() ) {
            return undef;
        }
        die Cpanel::Exception::create( &#039;IO::FileOpenError&#039;, [ path =&gt; $_[0], error =&gt; $!, mode =&gt; &#039;&lt;&#039; ] );
    };

    return $fh;
}

sub load_if_exists {
    my $ref = _load_r( \&amp;_open_if_exists, @_ );
    return $ref ? $$ref : undef;
}

sub load_r_if_exists {
    return _load_r( \&amp;_open_if_exists, @_ );
}

sub load {
    return ${ _load_r( \&amp;_open, @_ ) };
}

sub load_r {
    return _load_r( \&amp;_open, @_ );
}

sub _load_r {
    my ( $open_coderef, $path, $offset, $length ) = @_;

    my $fh = $open_coderef-&gt;($path) or return undef;

    local $!;

    if ($offset) {
        sysseek( $fh, $offset, $Cpanel::Fcntl::Constants::SEEK_SET );

        if ($!) {
            die Cpanel::Exception::create(
                &#039;IO::FileSeekError&#039;,
                [
                    path     =&gt; $path,
                    position =&gt; $offset,
                    whence   =&gt; $Cpanel::Fcntl::Constants::SEEK_SET,
                    error    =&gt; $!,
                ]
            );
        }
    }

    my $data = q&lt;&gt;;

    if ( !defined $length ) {

        my $bytes_read = Cpanel::LoadFile::ReadFast::read_fast( $fh, $data, Cpanel::LoadFile::ReadFast::READ_CHUNK );

        if ( $bytes_read == Cpanel::LoadFile::ReadFast::READ_CHUNK ) {
            my $file_size = -f $fh &amp;&amp; -s _;

            if ($file_size) {

                Cpanel::LoadFile::ReadFast::read_fast( $fh, $data, $file_size, length $data ) // die _read_err($path);
            }
        }

        Cpanel::LoadFile::ReadFast::read_all_fast( $fh, $data );
    }
    else {
        my $togo = $length;
        my $bytes_read;
        while ( $bytes_read = Cpanel::LoadFile::ReadFast::read_fast( $fh, $data, $togo, length $data ) &amp;&amp; length $data &lt; $length ) {
            $togo -= $bytes_read;
        }
    }

    if ($!) {
        die Cpanel::Exception::create( &#039;IO::FileReadError&#039;, [ path =&gt; $path, error =&gt; $! ] );
    }

    close $fh or warn &quot;The system failed to close the file “$path” because of an error: $!&quot;;

    return \$data;
}

sub _ENOENT { return 2; }
1;

} # --- END Cpanel/LoadFile.pm


{ # --- BEGIN Cpanel/Usage.pm
package Cpanel::Usage;


my $g_prefs;    # Ref to hash containing up to three boolean preferences, as follows:


$Cpanel::Usage::VERSION = &#039;1.08&#039;;

sub version {    # Reports our current revision number.
    $Cpanel::Usage::VERSION;
}


sub wrap_options {
    my $arg1 = $_[0];
    $g_prefs = {};
    if ( defined $arg1 &amp;&amp; ( ref $arg1 ) =~ /\bHASH\b/ ) {    # hash of preferences
        $g_prefs = $arg1;
        shift;
    }
    my ( $ar_argv, $cr_usage, $hr_opts ) = @_;
    getoptions( usage( $ar_argv, $cr_usage ), $hr_opts );
}


sub usage {
    my ( $ar_argv, $cr_usage ) = @_;
    foreach my $arg (@$ar_argv) {
        if ( $arg =~ /^-+(h|help|usage)$/ ) {
            if ( defined($cr_usage) ) {
                &amp;$cr_usage();
            }
            return 1;
        }
    }

    $ar_argv;
}

sub getoptions {
    my ( $ar_cmdline, $hr ) = @_;

    my $non_opt_arg_seen = &quot;&quot;;


    return $ar_cmdline if ( ref $ar_cmdline || &quot;&quot; ) !~ /\bARRAY\b/;


    if ( !$#$ar_cmdline &amp;&amp; $ar_cmdline-&gt;[0] eq &quot;1&quot; ) {
        return 1;
    }


    unless ( defined $hr &amp;&amp; ( ref $hr ) =~ /\bHASH\b/ ) {
        print &quot;Error: opts must be a hash reference\n&quot;;
        return 2;
    }

    my $predefined = keys %{$hr};

    my @cmdline_out = @$ar_cmdline;    # save a copy of the arg array


    if ( !$predefined ) {
        if ( no_switches($ar_cmdline) ) {
            my $i = 0;
            foreach my $arg (@$ar_cmdline) {
                $hr-&gt;{ $i++ } = $arg;
            }
            return &quot;&quot;;
        }
    }
    if ($predefined) {
        my $default_value = exists $g_prefs-&gt;{&#039;default_value&#039;} ? $g_prefs-&gt;{&#039;default_value&#039;} : 0;

        foreach my $k ( keys %$hr ) {


            if ( ref( $hr-&gt;{$k} ) =~ /^HASH/ ) {
                foreach my $kk ( keys %{ $hr-&gt;{$k} } ) {
                    ${ $hr-&gt;{$k}-&gt;{$kk} } = $default_value unless ( defined ${ $hr-&gt;{$k}-&gt;{$kk} } );
                }
            }
            else {
                ${ $hr-&gt;{$k} } = $default_value unless ( defined ${ $hr-&gt;{$k} } );
            }
        }
    }

    my $seen_dash_dash = 0;

    for ( my $i = 0; $i &lt;= $#$ar_cmdline; $i++ ) {
        if ( $ar_cmdline-&gt;[$i] eq &#039;--&#039; ) {
            $seen_dash_dash = 1;

        }
        elsif ( !$seen_dash_dash &amp;&amp; $ar_cmdline-&gt;[$i] =~ /^-+(.+)$/ ) {
            my $o = $1;

            if ( &quot;&quot; ne $non_opt_arg_seen and $g_prefs-&gt;{&#039;require_left&#039;} ) {
                print qq{Error: Preference require_left was specified, all opt args must therefore appear first on the command line; option &quot;-$o&quot; found after &quot;$non_opt_arg_seen&quot; violates this rule\n};
                return 3;
            }
            my $eq_value = &#039;&#039;;


            if ( $o =~ /(.+?)=(.+)/ ) {
                $o        = $1;
                $eq_value = $2;
                $eq_value =~ s@^\s+@@;
                $eq_value =~ s@\s+$@@;
            }

            if ( $g_prefs-&gt;{&#039;strict&#039;} &amp;&amp; $predefined &amp;&amp; !exists $hr-&gt;{$o} ) {
                print qq{Error: While &quot;strict&quot; is in effect, we have encountered option --$o on the command line, an option that was not specified in the opts hash.\n};
                return 4;
            }

            if (    # It is a &quot;lone switch&quot;, that is, an
                $eq_value eq &#039;&#039; &amp;&amp; ( $i == $#$ar_cmdline
                    || $ar_cmdline-&gt;[ $i + 1 ] =~ /^-+.+$/ )
            ) {

                if ( ref( $hr-&gt;{$o} ) =~ /^HASH/ ) {

                    foreach my $kk ( keys %{ $hr-&gt;{$o} } ) {
                        if ($predefined) {
                            ${ $hr-&gt;{$o}-&gt;{$kk} }++ if ( exists( $hr-&gt;{$o} ) );
                        }
                    }
                }
                else {
                    if ($predefined) {
                        ${ $hr-&gt;{$o} }++ if ( exists( $hr-&gt;{$o} ) );
                    }
                    else {
                        $hr-&gt;{ _multihelp($o) }++;
                    }
                }
            }

            else {    # not a &quot;lone switch&quot;; the next arg might be the value
                if ( ref( $hr-&gt;{$o} ) =~ /^HASH/ ) {
                    print &quot;Error: A multi-level option can only be used when implicitly boolean (true), but you have attempted to use a multi-level option with an explicitly specified option argument.\n&quot;;

                    return 5;
                }
                if ( $eq_value ne &#039;&#039; ) {    # Sorry, we already have a value for the switch
                    if ($predefined) {
                        ${ $hr-&gt;{$o} } = $eq_value if ( exists( $hr-&gt;{$o} ) );
                    }
                    else {
                        $hr-&gt;{$o} = $eq_value;
                    }
                }
                else {                      # We have no value yet for the switch, so use next arg as the value
                    $cmdline_out[$i] = undef if $g_prefs-&gt;{&#039;remove&#039;};
                    ++$i;
                    if ($predefined) {
                        ${ $hr-&gt;{$o} } = $ar_cmdline-&gt;[$i]
                          if ( exists( $hr-&gt;{$o} ) );
                    }
                    else {
                        $hr-&gt;{$o} = $ar_cmdline-&gt;[$i];
                    }
                }
            }
            $cmdline_out[$i] = undef if $g_prefs-&gt;{&#039;remove&#039;};
        }
        else {    # It&#039;s a regular (non-hyphen-prefixed) arg, not an option arg
            if ( &quot;&quot; eq $non_opt_arg_seen ) {
                $non_opt_arg_seen = $ar_cmdline-&gt;[$i];
            }
        }
    }

    if ( $g_prefs-&gt;{&#039;remove&#039;} ) {


        @cmdline_out = grep { defined } @cmdline_out;
        @{$ar_cmdline} = @cmdline_out;
    }

    return &quot;&quot;;    # aka 0, successful completion
}


sub _multihelp {    # For internal use only
    my $name = shift;
    return $name =~ /^(h|help|usage)$/ ? &#039;help&#039; : $name;
}

sub no_switches {
    my $ar = shift;
    return !grep { /^-+.+/ } @{$ar};
}


sub dump_args {
    my $hr_opts = shift;
    require Data::Dumper;
    print Data::Dumper::Dumper($hr_opts);
}

1;


} # --- END Cpanel/Usage.pm


{ # --- BEGIN Cpanel/UPID.pm
package Cpanel::UPID;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::LoadFile (); # perlpkg line 211

my $_boot_time;


sub get {
    my ($pid) = @_;

    die &quot;Need PID, not “$pid”!&quot; if !$pid || $pid =~ tr&lt;0-9&gt;&lt;&gt;c;

    my $start_delta = _get_pid_start_delta($pid);
    return undef if !$start_delta;

    $_boot_time ||= get_boot_time();

    return join( &#039;.&#039;, $pid, $start_delta, $_boot_time );
}


sub extract_pid {
    my ($upid) = @_;

    return substr( $upid, 0, index( $upid, &#039;.&#039; ) );
}


sub is_alive {
    my ($upid) = @_;

    my $pid = extract_pid($upid);
    return ( $upid eq ( Cpanel::UPID::get($pid) // q&lt;&gt; ) );
}


sub get_boot_time {
    my $proc_stat   = Cpanel::LoadFile::load(&#039;/proc/stat&#039;);
    my $where_btime = index( $proc_stat, &#039;btime &#039; );
    die &#039;/proc/stat format changed???&#039; if $where_btime == -1;

    my $where_lf = index( $proc_stat, &quot;\n&quot;, $where_btime );

    my $number_start = 6 + $where_btime;

    return substr( $proc_stat, $number_start, $where_lf - $number_start );
}


sub _get_pid_start_delta {
    my ($pid) = @_;

    my $proc_pid_stat = Cpanel::LoadFile::load_if_exists(&quot;/proc/$pid/stat&quot;);
    return undef if !$proc_pid_stat;

    my $right_paren_at = rindex( $proc_pid_stat, &#039;)&#039; );
    substr( $proc_pid_stat, 0, 2 + $right_paren_at, q&lt;&gt; );

    return ( split m&lt;\s+&gt;, $proc_pid_stat )[19];
}

1;

} # --- END Cpanel/UPID.pm


{ # --- BEGIN Cpanel/Unix/PID/Tiny.pm
package Cpanel::Unix::PID::Tiny;


use strict;

$Cpanel::Unix::PID::Tiny::VERSION = 0.9_2;

sub new {
    my ( $self, $args_hr ) = @_;
    $args_hr-&gt;{&#039;minimum_pid&#039;} = 11 if !exists $args_hr-&gt;{&#039;minimum_pid&#039;} || $args_hr-&gt;{&#039;minimum_pid&#039;} !~ m{\A\d+\z}ms;    # this does what one assumes m{^\d+$} would do

    if ( defined $args_hr-&gt;{&#039;ps_path&#039;} ) {
        $args_hr-&gt;{&#039;ps_path&#039;} .= &#039;/&#039; if $args_hr-&gt;{&#039;ps_path&#039;} !~ m{/$};
        if ( !-d $args_hr-&gt;{&#039;ps_path&#039;} || !-x &quot;$args_hr-&gt;{&#039;ps_path&#039;}ps&quot; ) {
            $args_hr-&gt;{&#039;ps_path&#039;} = &#039;&#039;;
        }
    }
    else {
        $args_hr-&gt;{&#039;ps_path&#039;} = &#039;&#039;;
    }

    return bless { &#039;ps_path&#039; =&gt; $args_hr-&gt;{&#039;ps_path&#039;}, &#039;minimum_pid&#039; =&gt; $args_hr-&gt;{&#039;minimum_pid&#039;} }, $self;
}

sub kill {
    my ( $self, $pid, $give_kill_a_chance ) = @_;
    $give_kill_a_chance = int $give_kill_a_chance if defined $give_kill_a_chance;
    $pid                = int $pid;
    my $min = int $self-&gt;{&#039;minimum_pid&#039;};
    if ( $pid &lt; $min ) {

        warn &quot;kill() called with integer value less than $min&quot;;
        return;
    }

    return 1 unless $self-&gt;is_pid_running($pid);

    my @signals = ( 15, 2, 1, 9 );          # TERM, INT, HUP, KILL
    foreach my $signal ( 15, 2, 1, 9 ) {    # TERM, INT, HUP, KILL

        _kill( $signal, $pid );

        if ($give_kill_a_chance) {
            my $start_time = time();
            while ( time() &lt; $start_time + $give_kill_a_chance ) {
                if ( $self-&gt;is_pid_running($pid) ) {
                    select( undef, undef, undef, 0.25 );
                }
                else {
                    return 1;
                }
            }
        }
        return 1 unless $self-&gt;is_pid_running($pid);
    }

    return;
}

sub is_pid_running {
    my ( $self, $check_pid ) = @_;

    $check_pid = int $check_pid;
    return if !$check_pid || $check_pid &lt; 0;

    return 1 if $&gt; == 0 &amp;&amp; _kill( 0, $check_pid );    # if we are superuser we can avoid the the system call. For details see `perldoc -f kill`
    return 1 if -e &quot;/proc/$$&quot; &amp;&amp; -r &quot;/proc/$$&quot; &amp;&amp; -r &quot;/proc/$check_pid&quot;;

    return;
}

sub pid_info_hash {
    my ( $self, $pid ) = @_;
    $pid = int $pid;
    return if !$pid || $pid &lt; 0;

    my @outp = $self-&gt;_raw_ps( &#039;u&#039;, &#039;-p&#039;, $pid );
    chomp @outp;
    my %info;
    @info{ split( /\s+/, $outp[0], 11 ) } = split( /\s+/, $outp[1], 11 );
    return wantarray ? %info : \%info;
}

sub _raw_ps {
    my ( $self, @ps_args ) = @_;
    my $psargs = join( &#039; &#039;, @ps_args );
    my @res    = `$self-&gt;{&#039;ps_path&#039;}ps $psargs`;
    return wantarray ? @res : join &#039;&#039;, @res;
}

sub get_pid_from_pidfile {
    my ( $self, $pid_file ) = @_;

    return 0 if !-e $pid_file or -z _;

    open my $pid_fh, &#039;&lt;&#039;, $pid_file or return;
    my $pid = &lt;$pid_fh&gt;;
    close $pid_fh;

    return 0 if !$pid;
    chomp $pid;
    return int( abs($pid) );
}

sub is_pidfile_running {
    my ( $self, $pid_file ) = @_;
    my $pid = $self-&gt;get_pid_from_pidfile($pid_file) || return;
    return $pid if $self-&gt;is_pid_running($pid);
    return;
}

sub pid_file {
    my ( $self, $pid_file, $newpid, $retry_conf ) = @_;
    $newpid = $$ if !$newpid;

    my $rc = $self-&gt;pid_file_no_unlink( $pid_file, $newpid, $retry_conf );
    if ( $rc &amp;&amp; $newpid == $$ ) {
        $self-&gt;create_end_blocks($pid_file);
    }
    return 1 if defined $rc &amp;&amp; $rc == 1;
    return 0 if defined $rc &amp;&amp; $rc == 0;
    return;
}

sub create_end_blocks {
    my ( $self, $pid_file ) = @_;    ## no critic qw(Variables::ProhibitUnusedVariables);

    if ( $self-&gt;{&#039;unlink_end_use_current_pid_only&#039;} ) {
        eval &#039;END { unlink $pid_file if $$ eq &#039; . $$ . &#039;}&#039;;    ## no critic qw(ProhibitStringyEval)
        if ( $self-&gt;{&#039;carp_unlink_end&#039;} ) {
            eval &#039;END { require Carp;Carp::carp(&quot;[info] $$ unlink $pid_file (current pid check)&quot;) if $$ eq &#039; . $$ . &#039;}&#039;;    ## no critic qw(ProhibitStringyEval)
        }
    }
    else {
        eval &#039;END { unlink $pid_file if Cpanel::Unix::PID::Tiny-&gt;get_pid_from_pidfile($pid_file) eq $$ }&#039;;                  ## no critic qw(ProhibitStringyEval)
        if ( $self-&gt;{&#039;carp_unlink_end&#039;} ) {
            eval &#039;END { require Carp;Carp::carp(&quot;[info] $$ unlink $pid_file (pid file check)&quot;) if Cpanel::Unix::PID::Tiny-&gt;get_pid_from_pidfile($pid_file) eq $$ }&#039;;    ## no critic qw(ProhibitStringyEval)
        }
    }

    return;
}

*pid_file_no_cleanup = \&amp;pid_file_no_unlink;    # more intuitively named alias

sub pid_file_no_unlink {
    my ( $self, $pid_file, $newpid, $retry_conf ) = @_;
    $newpid = $$ if !$newpid;

    if ( ref($retry_conf) eq &#039;ARRAY&#039; ) {
        $retry_conf-&gt;[0] = int( abs( $retry_conf-&gt;[0] ) );
        for my $idx ( 1 .. scalar( @{$retry_conf} ) - 1 ) {
            next if ref $retry_conf-&gt;[$idx] eq &#039;CODE&#039;;
            $retry_conf-&gt;[$idx] = int( abs( $retry_conf-&gt;[$idx] ) );
        }
    }
    else {
        $retry_conf = [ 3, 1, 2 ];
    }

    my $passes = 0;
    require Fcntl;

  EXISTS:
    $passes++;
    if ( -e $pid_file ) {

        my $curpid = $self-&gt;get_pid_from_pidfile($pid_file);


        return 1 if int $curpid == $$ &amp;&amp; $newpid == $$;     # already setup
        return   if int $curpid == $$;                      # can&#039;t change it while $$ is alive
        return   if $self-&gt;is_pid_running( int $curpid );

        unlink $pid_file;                                   # must be a stale PID file, so try to remove it for sysopen()
    }

    my $pid_fh = _sysopen($pid_file);
    if ( !$pid_fh ) {
        return 0 if $passes &gt;= $retry_conf-&gt;[0];
        if ( ref( $retry_conf-&gt;[$passes] ) eq &#039;CODE&#039; ) {
            $retry_conf-&gt;[$passes]-&gt;( $self, $pid_file, $passes );
        }
        else {
            sleep( $retry_conf-&gt;[$passes] ) if $retry_conf-&gt;[$passes];
        }
        goto EXISTS;
    }

    print {$pid_fh} int( abs($newpid) );
    close $pid_fh;

    return 1;
}

sub _sysopen {
    my ($pid_file) = @_;
    sysopen( my $pid_fh, $pid_file, Fcntl::O_WRONLY() | Fcntl::O_EXCL() | Fcntl::O_CREAT() ) || return;
    return $pid_fh;
}

sub _kill {    ## no critic(RequireArgUnpacking
    return CORE::kill(@_);    # goto &amp;CORE::kill; is problematic
}


sub get_run_lock {

    my ( $pid_file, $min_age_seconds, $max_age_seconds, $cmdline_regex ) = @_;

    $pid_file                or die(&quot;Need a pid file to get a run lock.&quot;);
    defined $min_age_seconds or $min_age_seconds = 15 * 60;
    defined $max_age_seconds or $max_age_seconds = 20 * 60 * 60;

    foreach ( 1 .. 2 ) {

        my $upid    = Cpanel::Unix::PID::Tiny-&gt;new();
        my $got_pid = $upid-&gt;pid_file($pid_file);

        return 1 if ($got_pid);

        my @pid_stat = stat($pid_file);

        next if ( !@pid_stat );

        my $pid_age = time() - $pid_stat[9];
        return 0 if ( $min_age_seconds &amp;&amp; $pid_age &lt; $min_age_seconds );

        my $active_pid = $upid-&gt;get_pid_from_pidfile($pid_file);
        if ( !-e &quot;/proc/$active_pid&quot; ) {
            unlink $pid_file;
            next;
        }

        open( my $fh, &#039;&lt;&#039;, &quot;/proc/$active_pid/cmdline&quot; ) or next;

        my $cmdline = &lt;$fh&gt;;

        if ( $max_age_seconds &amp;&amp; $pid_age &gt; $max_age_seconds ) {
            _kill( &#039;TERM&#039;, $active_pid );
            unlink $pid_file;
        }

        if ( !$cmdline or ( $cmdline_regex &amp;&amp; $cmdline !~ $cmdline_regex ) ) {
            unlink $pid_file;
        }

    }
    return undef;    # I give up!
}

1;


} # --- END Cpanel/Unix/PID/Tiny.pm


{ # --- BEGIN Cpanel/JSON/Unicode.pm
package Cpanel::JSON::Unicode;


use strict;
use warnings;
no warnings &#039;once&#039;;


use constant {

    _LEAD_SURROGATE_MIN =&gt; 0xd800,
    _TAIL_SURROGATE_MIN =&gt; 0xdc00,

    _SURROGATE_MASK =&gt; 0xfc00,

    _BACKSLASH_ORD    =&gt; 0x5c,
    _DOUBLE_QUOTE_ORD =&gt; 0x22,
};

my $UNICODE_ESCAPE_REGEXP = qr/

    (?&lt;!\x5c)

    (

        (?:\x5c\x5c)*

        \x5c u ([0-9a-fA-F]{4})
    )
/x;


sub replace_unicode_escapes_with_utf8 {
    my ($json_sr) = @_;

    my $lead_surrogate;

    my $ret = $$json_sr =~ s&lt;$UNICODE_ESCAPE_REGEXP&gt;&lt;
        _replacement(\$lead_surrogate, $json_sr, $+[0], @{^CAPTURE})
    &gt;ge;

    if ($lead_surrogate) {
        die sprintf &quot;Incomplete surrogate pair (0x%04x)&quot;, $lead_surrogate;
    }

    return $ret;
}

sub _replacement {
    my ( $lead_surrogate_sr, $json_sr, $match_end, @captures ) = @_;

    my $num = hex $captures[1];

    if ( ( $num &amp; _SURROGATE_MASK ) == _TAIL_SURROGATE_MIN ) {
        if ($$lead_surrogate_sr) {
            my $utf8 = _decode_surrogates( $$lead_surrogate_sr, $num );
            $$lead_surrogate_sr = undef;
            return $utf8;
        }

        die sprintf &quot;Unpaired trailing surrogate (0x%04x)&quot;, $num;
    }
    elsif ( ( $num &amp; _SURROGATE_MASK ) == _LEAD_SURROGATE_MIN ) {
        my $next2 = substr( $$json_sr, $match_end, 2 );
        if ( !$next2 || $next2 ne &#039;\\u&#039; ) {
            die sprintf &quot;Unpaired leading surrogate (0x%04x)&quot;, $num;
        }

        $$lead_surrogate_sr = $num;
        return q&lt;&gt;;
    }
    elsif ( $num &lt; 0x20 || $num == _BACKSLASH_ORD || $num == _DOUBLE_QUOTE_ORD ) {
        return $captures[0];
    }

    my $utf8 = chr $num;
    utf8::encode($utf8);
    return $utf8;
}

sub _decode_surrogates {
    my ( $lead, $tail ) = @_;

    my $uni = 0x10000 + ( ( $lead - 0xd800 ) &lt;&lt; 10 ) + ( $tail - 0xdc00 );

    my $un = chr $uni;
    utf8::encode($un);

    return $un;
}

1;

} # --- END Cpanel/JSON/Unicode.pm


{ # --- BEGIN Cpanel/Encoder/ASCII.pm
package Cpanel::Encoder::ASCII;


use strict;
use warnings;
no warnings &#039;once&#039;;

sub to_hex {
    my ($readable) = @_;

    $readable =~ s&lt;\\&gt;&lt;\\\\&gt;g;
    $readable =~ s&lt;([\0-\x{1f}\x{7f}-\x{ff}])&gt;&lt;sprintf &#039;\x{%02x}&#039;, ord $1&gt;eg;

    return $readable;
}

1;

} # --- END Cpanel/Encoder/ASCII.pm


{ # --- BEGIN Cpanel/UTF8/Strict.pm
package Cpanel::UTF8::Strict;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub decode {

    utf8::decode( $_[0] ) or do {
        local ( $@, $! );
        require Cpanel::Encoder::ASCII;
        die sprintf &quot;Invalid UTF-8 in string: “%s”&quot;, Cpanel::Encoder::ASCII::to_hex( $_[0] );
    };

    return $_[0];
}

1;

} # --- END Cpanel/UTF8/Strict.pm


{ # --- BEGIN Cpanel/JSON.pm
package Cpanel::JSON;


use strict;

# use Cpanel::Fcntl::Constants   (); # perlpkg line 211
# use Cpanel::FHUtils::Tiny      (); # perlpkg line 211
# use Cpanel::JSON::Unicode      (); # perlpkg line 211
# use Cpanel::LoadFile::ReadFast (); # perlpkg line 211
use JSON::XS                   ();
# use Cpanel::UTF8::Strict       (); # perlpkg line 211

our $NO_DECODE_UTF8 = 0;
our $DECODE_UTF8    = 1;

our $LOAD_STRICT  = 0;
our $LOAD_RELAXED = 1;

our $MAX_LOAD_LENGTH_UNLIMITED = 0;
our $MAX_LOAD_LENGTH           = 65535;

our $MAX_PRIV_LOAD_LENGTH = 4194304;    # four megs

our $VERSION = &#039;2.5&#039;;

my $copied_boolean = 0;


sub DumpFile {
    return _dumpFile( @_, 0, 0 );
}

sub DumpFilePretty {
    return _dumpFile( @_, 1, 0 );
}

sub DumpFileCanonical {
    return _dumpFile( @_, 0, 1 );
}

sub DumpFilePrettyCanonical {
    return _dumpFile( @_, 1, 1 );
}

sub _dumpFile {
    my @args = @_;
    my %opts = map { $_ =&gt; shift @args } qw{file data pretty canon};
    my $fh;
    $fh = $opts{&#039;file&#039;} if Cpanel::FHUtils::Tiny::is_a( $opts{&#039;file&#039;} );
    if ( $fh || open( $fh, &#039;&gt;&#039;, $opts{&#039;file&#039;} ) ) {
        my %json_opts;
        $json_opts{&#039;pretty&#039;}    = 1 if $opts{&#039;pretty&#039;};
        $json_opts{&#039;canonical&#039;} = 1 if $opts{&#039;canon&#039;};
        print {$fh} _create_new_json_object(%json_opts)-&gt;encode( $opts{&#039;data&#039;} ) or return 0;
        return 1;
    }
    return 0;
}


sub copy_boolean {

    if ( !$copied_boolean ) {
        *Types::Serialiser::Boolean:: = *JSON::PP::Boolean::;
        $copied_boolean               = 1;
    }
    return;
}


sub _create_new_json_object {
    my (%opts) = @_;
    copy_boolean() if !$copied_boolean;
    my $obj = JSON::XS-&gt;new()-&gt;shrink(1)-&gt;allow_nonref(1)-&gt;convert_blessed(1);

    $obj-&gt;can($_)-&gt;( $obj, $opts{$_} ) for keys(%opts);
    return $obj;
}


sub true {
    copy_boolean() if !$copied_boolean;
    my $x = 1;
    return bless \$x, &#039;Types::Serialiser::Boolean&#039;;
}


sub false {
    copy_boolean() if !$copied_boolean;
    my $x = 0;
    return bless \$x, &#039;Types::Serialiser::Boolean&#039;;
}


sub pretty_dump {
    return _create_new_json_object()-&gt;pretty(1)-&gt;encode( $_[0] );
}


sub canonical_dump {
    return _create_new_json_object()-&gt;canonical(1)-&gt;encode( $_[0] );
}


sub pretty_canonical_dump {
    return _create_new_json_object()-&gt;canonical(1)-&gt;indent-&gt;space_before-&gt;space_after-&gt;encode( $_[0] );
}


sub Dump {
    return _create_new_json_object()-&gt;encode( $_[0] );
}


sub Load {
    local $@;

    _replace_unicode_escapes_if_needed( \$_[0] );

    return eval { _create_new_json_object()-&gt;decode( $_[0] ); } // ( ( $@ &amp;&amp; _throw_json_error( $@, $_[1], \$_[0] ) ) || undef );
}


sub LoadRelaxed {
    local $@;

    _replace_unicode_escapes_if_needed( \$_[0] );

    return eval { _create_new_json_object()-&gt;relaxed(1)-&gt;decode( $_[0] ); } // ( ( $@ &amp;&amp; _throw_json_error( $@, $_[1], \$_[0] ) ) || undef );
}


sub _throw_json_error {
    my ( $exception, $path, $dataref ) = @_;

    local $@;
    require Cpanel::Exception;
    die $exception if $@;
    die &#039;Cpanel::Exception&#039;-&gt;can(&#039;create&#039;)-&gt;( &#039;JSONParseError&#039;, { &#039;error&#039; =&gt; $exception, &#039;path&#039; =&gt; $path, &#039;dataref&#039; =&gt; $dataref } );
}


sub LoadNoSetUTF8 {
    local $@;

    _replace_unicode_escapes_if_needed( \$_[0] );

    return eval { _create_new_no_set_utf8_json_object()-&gt;decode( $_[0] ); } // ( ( $@ &amp;&amp; _throw_json_error( $@, $_[1], \$_[0] ) ) || undef );
}


sub LoadNoSetUTF8Relaxed {
    local $@;

    _replace_unicode_escapes_if_needed( \$_[0] );

    return eval { _create_new_no_set_utf8_json_object()-&gt;relaxed(1)-&gt;decode( $_[0] ); } // ( ( $@ &amp;&amp; _throw_json_error( $@, $_[1], \$_[0] ) ) || undef );
}

sub _create_new_no_set_utf8_json_object {
    my $obj = _create_new_json_object();
    if ( $obj-&gt;can(&#039;no_set_utf8&#039;) ) {
        $obj-&gt;no_set_utf8(1);
    }
    else {
        warn &quot;JSON::XS is missing the no_set_utf8 flag&quot;;
    }
    return $obj;
}

sub _replace_unicode_escapes_if_needed {
    my $json_r = shift;

    return unless defined $$json_r;
    if ( -1 != index( $$json_r, &#039;\\u&#039; ) ) {
        Cpanel::JSON::Unicode::replace_unicode_escapes_with_utf8($json_r);
    }

    return;
}


sub SafeLoadFile {    # only allow a small bit of data to be loaded
    return _LoadFile( $_[0], $MAX_LOAD_LENGTH, $_[2] || $NO_DECODE_UTF8, $_[1], $LOAD_STRICT );
}


sub LoadFile {
    return _LoadFile( $_[0], $MAX_LOAD_LENGTH_UNLIMITED, $_[2] || $NO_DECODE_UTF8, $_[1], $LOAD_STRICT );
}


sub LoadFileRelaxed {
    return _LoadFile( $_[0], $MAX_LOAD_LENGTH_UNLIMITED, $_[2] || $NO_DECODE_UTF8, $_[1], $LOAD_RELAXED );
}


sub LoadFileNoSetUTF8 {
    return _LoadFile( $_[0], $_[1] || $MAX_LOAD_LENGTH_UNLIMITED, $DECODE_UTF8, $_[2], $LOAD_STRICT );
}

sub _LoadFile {
    my ( $file, $max, $decode_utf8, $path, $relaxed ) = @_;

    my $data;
    if ( Cpanel::FHUtils::Tiny::is_a($file) ) {
        if ($max) {
            my $togo = $max;
            $data = &#039;&#039;;
            my $bytes_read;
            while ( $bytes_read = read( $file, $data, $togo, length $data ) &amp;&amp; length $data &lt; $max ) {
                $togo -= $bytes_read;
            }
        }
        else {
            Cpanel::LoadFile::ReadFast::read_all_fast( $file, $data );
        }
    }
    else {
        local $!;
        open( my $fh, &#039;&lt;:stdio&#039;, $file ) or do {
            my $err = $!;

            require Cpanel::Carp;
            die Cpanel::Carp::safe_longmess(&quot;Cannot open “$file”: $err&quot;);
        };
        Cpanel::LoadFile::ReadFast::read_all_fast( $fh, $data );
        if ( !length $data ) {
            require Cpanel::Carp;
            die Cpanel::Carp::safe_longmess(&quot;“$file” is empty.&quot;);
        }
        close $fh or warn &quot;close($file) failed: $!&quot;;
    }

    if ( $decode_utf8 &amp;&amp; $decode_utf8 == $DECODE_UTF8 ) {

        Cpanel::UTF8::Strict::decode($data);

        return $relaxed ? LoadNoSetUTF8Relaxed( $data, $path || $file ) : LoadNoSetUTF8( $data, $path || $file );
    }

    return $relaxed ? LoadRelaxed( $data, $path || $file ) : Load( $data, $path || $file );
}


sub SafeDump {
    my $raw_json = _create_new_json_object()-&gt;encode( $_[0] );
    $raw_json =~ s{\/}{\\/}g if $raw_json =~ tr{/}{};    # / fix for editors
    return $raw_json;
}


sub _fh_looks_like_json {
    my ($fh) = @_;

    my $bytes_read = 0;

    my $buffer = q{};

    local $!;

    while ( $buffer !~ tr{ \t\r\n\f}{}c &amp;&amp; !eof $fh ) {
        $bytes_read += ( read( $fh, $buffer, 1, length $buffer ) // die &quot;read() failed: $!&quot; );
    }

    return (
        _string_looks_like_json($buffer),
        \$buffer,
    );
}

sub _string_looks_like_json {    ##no critic qw(RequireArgUnpacking)
    return $_[0] =~ m/\A\s*[\[\{&quot;0-9]/ ? 1 : 0;
}

sub looks_like_json {    ##no critic qw(RequireArgUnpacking)
    if ( Cpanel::FHUtils::Tiny::is_a( $_[0] ) ) {
        my $fh = $_[0];

        my ( $looks_like_json, $fragment_ref ) = _fh_looks_like_json($fh);
        my $bytes_read = length $$fragment_ref;

        if ($bytes_read) {
            seek( $fh, -$bytes_read, $Cpanel::Fcntl::Constants::SEEK_CUR ) or die &quot;seek() failed: $!&quot;;
        }

        return $looks_like_json;
    }

    return _string_looks_like_json( $_[0] );
}


sub to_bool {
    my ($val) = @_;

    $val = 0 if defined $val &amp;&amp; $val eq &#039;false&#039;;
    return !!$val ? true() : false();
}


1;

} # --- END Cpanel/JSON.pm


{ # --- BEGIN Cpanel/JSON/FailOK.pm
package Cpanel::JSON::FailOK;


use strict;
use warnings;
no warnings &#039;once&#039;;

sub LoadJSONModule {
    local $@;

    my $load_ok = eval {
        local $SIG{&#039;__DIE__&#039;};     # Suppress spewage as we may be reading an invalid cache
        local $SIG{&#039;__WARN__&#039;};    # and since failure is ok to throw it away
        require Cpanel::JSON;      # PPI NO PARSE - FailOK
        1;
    };

    if ( !$load_ok &amp;&amp; !$ENV{&#039;CPANEL_BASE_INSTALL&#039;} &amp;&amp; index( $^X, &#039;/usr/local/cpanel&#039; ) == 0 ) {
        warn $@;
    }

    return $load_ok ? 1 : 0;
}

sub LoadFile {
    return undef if !$INC{&#039;Cpanel/JSON.pm&#039;};

    return eval {
        local $SIG{&#039;__DIE__&#039;};         # Suppress spewage as we may be reading an invalid cache
        local $SIG{&#039;__WARN__&#039;};        # and since failure is ok to throw it away
        Cpanel::JSON::LoadFile(@_);    # PPI NO PARSE - inc check above
    };
}
1;

} # --- END Cpanel/JSON/FailOK.pm


{ # --- BEGIN Cpanel/ConfigFiles.pm
package Cpanel::ConfigFiles;


use strict;


our $VERSION = &#039;1.4&#039;;

our $cpanel_users       = &#039;/var/cpanel/users&#039;;
our $cpanel_users_cache = &#039;/var/cpanel/users.cache&#039;;

our $backup_config_touchfile     = &#039;/var/cpanel/config/backups/metadata_disabled&#039;;
our $backup_config_touchfile_dir = &#039;/var/cpanel/config/backups/&#039;;
our $backup_config               = &#039;/var/cpanel/backups/config&#039;;

our $cpanel_config_file          = &#039;/var/cpanel/cpanel.config&#039;;
our $cpanel_config_cache_file    = &#039;/var/cpanel/cpanel.config.cache&#039;;
our $cpanel_config_defaults_file = &#039;/usr/local/cpanel/etc/cpanel.config&#039;;
our $features_cache_dir          = &quot;/var/cpanel/features.cache&quot;;

our $BASE_INSTALL_IN_PROGRESS_FILE = &#039;/root/installer.lock&#039;;

our $CPSRVD_CHECK_CPLISC_FILE = q{/var/cpanel/cpsrvd_check_license};

our $ROOT_CPANEL_HOMEDIR = &#039;/var/cpanel/userhomes/cpanel&#039;;

our $RESELLERS_FILE             = &#039;/var/cpanel/resellers&#039;;
our $RESELLERS_NAMESERVERS_FILE = &#039;/var/cpanel/resellers-nameservers&#039;;
our $ACCOUNTING_LOG_FILE        = &#039;/var/cpanel/accounting.log&#039;;
our $FEATURES_DIR               = &#039;/var/cpanel/features&#039;;
our $BANDWIDTH_LIMIT_DIR        = &#039;/var/cpanel/bwlimited&#039;;
our $CUSTOM_PERL_MODULES_DIR    = &#039;/var/cpanel/perl&#039;;
our $PACKAGES_DIR;    #defined below

our $DEDICATED_IPS_FILE       = &#039;/etc/domainips&#039;;
our $DELEGATED_IPS_DIR        = &#039;/var/cpanel/dips&#039;;
our $MAIN_IPS_DIR             = &#039;/var/cpanel/mainips&#039;;
our $RESERVED_IPS_FILE        = &#039;/etc/reservedips&#039;;
our $RESERVED_IP_REASONS_FILE = &#039;/etc/reservedipreasons&#039;;
our $IP_ADDRESS_POOL_FILE     = &#039;/etc/ipaddrpool&#039;;
our $ACL_LISTS_DIR            = &#039;/var/cpanel/acllists&#039;;

our $OUTGOING_MAIL_SUSPENDED_USERS_FILE    = &#039;/etc/outgoing_mail_suspended_users&#039;;
our $OUTGOING_MAIL_HOLD_USERS_FILE         = &#039;/etc/outgoing_mail_hold_users&#039;;
our $TRUEUSEROWNERS_FILE                   = &#039;/etc/trueuserowners&#039;;
our $TRUEUSERDOMAINS_FILE                  = &#039;/etc/trueuserdomains&#039;;
our $USERDOMAINS_FILE                      = &#039;/etc/userdomains&#039;;
our $DBOWNERS_FILE                         = &#039;/etc/dbowners&#039;;
our $DOMAINUSERS_FILE                      = &#039;/etc/domainusers&#039;;
our $LOCALDOMAINS_FILE                     = &#039;/etc/localdomains&#039;;
our $REMOTEDOMAINS_FILE                    = &#039;/etc/remotedomains&#039;;
our $SECONDARYMX_FILE                      = &#039;/etc/secondarymx&#039;;
our $MANUALMX_FILE                         = &#039;/etc/manualmx&#039;;
our $USERBWLIMITS_FILE                     = &#039;/etc/userbwlimits&#039;;
our $MAILIPS_FILE                          = &#039;/etc/mailips&#039;;
our $MAILHELO_FILE                         = &#039;/etc/mailhelo&#039;;
our $NEIGHBOR_NETBLOCKS_FILE               = &#039;/etc/neighbor_netblocks&#039;;
our $CPANEL_MAIL_NETBLOCKS_FILE            = &#039;/etc/cpanel_mail_netblocks&#039;;
our $GREYLIST_TRUSTED_NETBLOCKS_FILE       = &#039;/etc/greylist_trusted_netblocks&#039;;
our $GREYLIST_COMMON_MAIL_PROVIDERS_FILE   = &#039;/etc/greylist_common_mail_providers&#039;;
our $RECENT_RECIPIENT_MAIL_SERVER_IPS_FILE = &#039;/etc/recent_recipient_mail_server_ips&#039;;
our $DEMOUSERS_FILE                        = &#039;/etc/demousers&#039;;

our $APACHE_CONFIG_DIR          = &#039;/var/cpanel/conf/apache&#039;;
our $APACHE_PRIMARY_VHOSTS_FILE = &#039;/var/cpanel/conf/apache/primary_virtual_hosts.conf&#039;;

our $MYSQL_CNF = &#039;/etc/my.cnf&#039;;

our $SERVICEAUTH_DIR      = &#039;/var/cpanel/serviceauth&#039;;
our $DORMANT_SERVICES_DIR = &#039;/var/cpanel/dormant_services&#039;;

our $DOMAIN_KEYS_ROOT = &#039;/var/cpanel/domain_keys&#039;;

our $USER_NOTIFICATIONS_DIR = &#039;/var/cpanel/user_notifications&#039;;

our $DATABASES_INFO_DIR = &#039;/var/cpanel/databases&#039;;

our $CPANEL_ROOT  = &#039;/usr/local/cpanel&#039;;
our $MAILMAN_ROOT = &quot;$CPANEL_ROOT/3rdparty/mailman&quot;;

our $FPM_CONFIG_ROOT = &quot;/var/cpanel/php-fpm.d&quot;;
our $FPM_ROOT        = &quot;/var/cpanel/php-fpm&quot;;

our $MAILMAN_LISTS_DIR = &quot;$MAILMAN_ROOT/lists&quot;;

our $MAILMAN_USER = &#039;mailman&#039;;

our $FTP_PASSWD_DIR     = &#039;/etc/proftpd&#039;;
our $FTP_SYMLINKS_DIR   = &#039;/etc/pure-ftpd&#039;;
our $VALIASES_DIR       = &#039;/etc/valiases&#039;;
our $VDOMAINALIASES_DIR = &#039;/etc/vdomainaliases&#039;;
our $VFILTERS_DIR       = &#039;/etc/vfilters&#039;;

our $JAILSHELL_PATH = &#039;/usr/local/cpanel/bin/jailshell&#039;;

our @COMMONDOMAINS_FILES = qw{/usr/local/cpanel/etc/commondomains /var/cpanel/commondomains};

our $BANDWIDTH_DIRECTORY             = &#039;/var/cpanel/bandwidth&#039;;
our $BANDWIDTH_CACHE_DIRECTORY       = &#039;/var/cpanel/bandwidth.cache&#039;;
our $BANDWIDTH_USAGE_CACHE_DIRECTORY = &#039;/var/cpanel/bwusagecache&#039;;

our $TEMPLATE_COMPILE_DIR = &#039;/var/cpanel/template_compiles&#039;;

our $DOVECOT_CONF        = &#039;/etc/dovecot/dovecot.conf&#039;;
our $DOVECOT_SNI_CONF    = &#039;/etc/dovecot/sni.conf&#039;;
our $DOVECOT_SSL_CONF    = &#039;/etc/dovecot/ssl.conf&#039;;
our $DOVECOT_SSL_KEY     = &#039;/etc/dovecot/ssl/dovecot.key&#039;;
our $DOVECOT_SSL_CRT     = &#039;/etc/dovecot/ssl/dovecot.crt&#039;;
our $DOVECOT_AUTH_POLICY = &#039;/etc/dovecot/auth_policy.conf&#039;;

our $GOOGLE_AUTH_TEMPFILE_PREFIX = &#039;/var/cpanel/backups/google_oauth_tempfile_&#039;;

our $APACHE_LOGFILE_CLEANUP_QUEUE = &#039;/var/cpanel/apache_logfile_cleanup.json&#039;;

our $SKIP_REPO_SETUP_FLAG = &#039;/var/cpanel/skip-repo-setup&#039;;

our $ACCOUNT_ENHANCEMENTS_DIR          = &#039;/var/cpanel/account_enhancements&#039;;
our $ACCOUNT_ENHANCEMENTS_CONFIG_DIR   = $Cpanel::ConfigFiles::ACCOUNT_ENHANCEMENTS_DIR . &#039;/config&#039;;
our $ACCOUNT_ENHANCEMENTS_INSTALL_FILE = $Cpanel::ConfigFiles::ACCOUNT_ENHANCEMENTS_CONFIG_DIR . &#039;/installed.json&#039;;

BEGIN {
    $PACKAGES_DIR = &#039;/var/cpanel/packages&#039;;
}


1;

} # --- END Cpanel/ConfigFiles.pm


{ # --- BEGIN Cpanel/Destruct.pm
package Cpanel::Destruct;


use strict;
my $in_global_destruction = 0;
my ( $package, $filename, $line, $subroutine );    # preallocate

sub in_dangerous_global_destruction {

    if ( !$INC{&#039;Test2/API.pm&#039;} ) {

        return 1 if in_global_destruction() &amp;&amp; $INC{&#039;Cpanel/BinCheck.pm&#039;};
    }

    return 0;
}

sub in_global_destruction {
    return $in_global_destruction if $in_global_destruction;

    if ( defined( ${^GLOBAL_PHASE} ) ) {
        if ( ${^GLOBAL_PHASE} eq &#039;DESTRUCT&#039; ) {
            $in_global_destruction = 1;
        }
    }

    else {
        local $SIG{&#039;__WARN__&#039;} = \&amp;_detect_global_destruction_pre_514_WARN_handler;
        warn;
    }

    return $in_global_destruction;
}

sub _detect_global_destruction_pre_514_WARN_handler {
    if ( length $_[0] &gt; 26 &amp;&amp; rindex( $_[0], &#039;during global destruction.&#039; ) == ( length( $_[0] ) - 26 ) ) {
        $in_global_destruction = 1;
    }

    return;
}

1;

} # --- END Cpanel/Destruct.pm


{ # --- BEGIN Cpanel/Finally.pm
package Cpanel::Finally;


use cPstrict;
no warnings &#039;once&#039;;

# use Cpanel::Carp     (); # perlpkg line 211
# use Cpanel::Destruct (); # perlpkg line 211
# use Cpanel::Debug    (); # perlpkg line 211


sub new ( $class, @todo_crs ) {

    local $/ = &quot;\n&quot;;    # Carp warns when $/ is undef, breaking tests
    return bless { &#039;pid&#039; =&gt; $$, &#039;todo&#039; =&gt; [@todo_crs], _from =&gt; Cpanel::Carp::safe_longmess() }, $class;
}


sub add ( $self, @new_crs ) {

    $self-&gt;{&#039;todo&#039;} //= [];
    push @{ $self-&gt;{&#039;todo&#039;} }, @new_crs;

    return;
}


sub skip ($self) {
    return delete $self-&gt;{&#039;todo&#039;};
}

sub DESTROY ($self) {

    return if $$ != $self-&gt;{&#039;pid&#039;} || !$self-&gt;{&#039;todo&#039;};

    if ( Cpanel::Destruct::in_dangerous_global_destruction() ) {
        Cpanel::Debug::log_die( qq[PROG $0 - Cpanel::Finally should never be triggered during global destruction\nCalled from ] . $self-&gt;{_from} );
    }

    local $@;    #prevent insidious clobber of error messages

    while ( @{ $self-&gt;{&#039;todo&#039;} } ) {
        my $ok = eval {
            while ( my $item = shift @{ $self-&gt;{&#039;todo&#039;} } ) {
                $item-&gt;();
            }

            1;
        };

        warn $@ if !$ok;
    }

    return;
}

1;

} # --- END Cpanel/Finally.pm


{ # --- BEGIN Cpanel/Readlink.pm
package Cpanel::Readlink;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Autodie   (); # perlpkg line 211
# use Cpanel::Exception (); # perlpkg line 211
use Cwd               ();

our $MAX_SYMLINK_DEPTH = 1024;

sub deep {
    my ( $link, $provide_trailing_slash ) = @_;

    die Cpanel::Exception::create( &#039;MissingParameter&#039;, &#039;Provide a link path.&#039; ) if !length $link;

    if ( length($link) &gt; 1 &amp;&amp; substr( $link, -1, 1 ) eq &#039;/&#039; ) {
        $link = substr( $link, 0, length($link) - 1 );
        return deep( $link, 1 );
    }

    if ( !-l $link ) {
        return $provide_trailing_slash ? qq{$link/} : $link;
    }

    my %is_link;
    $is_link{$link} = 1;

    my $depth = 0;

    my $base = _get_base_for($link);

    if ( substr( $link, 0, 1 ) ne &#039;/&#039; ) {
        $base = Cwd::abs_path() . &#039;/&#039; . $base;
    }

    while ( ( $is_link{$link} ||= -l $link ) &amp;&amp; ++$depth &lt;= $MAX_SYMLINK_DEPTH ) {
        $link = Cpanel::Autodie::readlink($link);
        if ( substr( $link, 0, 1 ) ne &#039;/&#039; ) {
            $link = $base . &#039;/&#039; . $link;
        }

        $base = _get_base_for($link);
    }

    return $provide_trailing_slash ? qq{$link/} : $link;
}

sub _get_base_for {
    my $basename = shift;
    my @path     = split( &#039;/&#039;, $basename );
    pop(@path);
    return join( &#039;/&#039;, @path );
}

1;

} # --- END Cpanel/Readlink.pm


{ # --- BEGIN Cpanel/FileUtils/Write.pm
package Cpanel::FileUtils::Write;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use Cpanel::Fcntl::Constants (); # perlpkg line 211
use Cpanel::Autodie ( &#039;rename&#039;, &#039;syswrite_sigguard&#039;, &#039;seek&#039;, &#039;print&#039;, &#039;truncate&#039; );
# use Cpanel::Exception       (); # perlpkg line 211
# use Cpanel::FileUtils::Open (); # perlpkg line 211
# use Cpanel::Finally         (); # perlpkg line 211
# use Cpanel::Debug           (); # perlpkg line 211

our $Errno_EEXIST = 17;

our $MAX_TMPFILE_CREATE_ATTEMPTS = 1024;
my $DEFAULT_PERMS = 0600;
my $_WRONLY_CREAT_EXCL;


sub write_fh {    ##no critic qw(RequireArgUnpacking)
    my $fh = $_[0];

    Cpanel::Autodie::seek( $fh, 0, 0 );
    Cpanel::Autodie::print( $fh, $_[1] );
    Cpanel::Autodie::truncate( $fh, tell($fh) );

    return 1;
}


sub write {
    return _write_to_tmpfile( @_[ 0 .. 2 ], \&amp;_write_finish );
}


sub overwrite {
    return _write_to_tmpfile( @_[ 0 .. 2 ], \&amp;_overwrite_finish );
}

sub overwrite_no_exceptions {
    my $fh;

    local $@;
    eval {
        $fh = overwrite(@_);
        1;
    } or Cpanel::Debug::log_warn(&quot;overwrite exception: $@&quot;);

    return !!$fh;
}

sub _write_to_tmpfile {    ##no critic qw(RequireArgUnpacking)
    my ( $filename, $perms_or_hr, $finish_cr ) = ( $_[0], $_[2], $_[3] );

    if ( !defined $filename ) {
        exists $INC{&#039;Carp.pm&#039;} ? Carp::confess(&quot;write() called with undefined filename&quot;) : die(&quot;write() called with undefined filename&quot;);
    }

    if ( ref $filename ) {
        die &quot;Use write_fh to write to a file handle. ($filename is a filehandle, right?)&quot;;
    }

    my ( $fh, $tmpfile_is_renamed );

    if ( -l $filename ) {
        require Cpanel::Readlink;
        $filename = Cpanel::Readlink::deep($filename);
    }


    my ( $callback_cr, $tmp_perms );

    if ( &#039;HASH&#039; eq ref $perms_or_hr ) {
        $callback_cr = $perms_or_hr-&gt;{&#039;before_installation&#039;};
    }
    else {
        $tmp_perms = $perms_or_hr;
    }

    $tmp_perms //= $DEFAULT_PERMS;

    my ( $tmpfile, $attempts ) = ( &#039;&#039;, 0 );

    while (1) {
        local $!;
        my $rand = rand(99999999);
        $rand = sprintf( &#039;%x&#039;, substr( $rand, 2 ) );

        my $last_slash_idx = rindex( $filename, &#039;/&#039; );
        $tmpfile = $filename;
        substr( $tmpfile, 1 + $last_slash_idx, 0 ) = &quot;.tmp.$rand.&quot;;

        last if Cpanel::FileUtils::Open::sysopen_with_real_perms(
            $fh,
            $tmpfile,
            ( $_WRONLY_CREAT_EXCL ||= ( $Cpanel::Fcntl::Constants::O_CREAT | $Cpanel::Fcntl::Constants::O_EXCL | $Cpanel::Fcntl::Constants::O_WRONLY ) ),
            $tmp_perms,
        );

        if ( $! != $Errno_EEXIST ) {
            die Cpanel::Exception::create( &#039;IO::FileCreateError&#039;, [ error =&gt; $!, path =&gt; $tmpfile, permissions =&gt; $tmp_perms ] );
        }

        ++$attempts;
        if ( $attempts &gt;= $MAX_TMPFILE_CREATE_ATTEMPTS ) {
            die Cpanel::Exception::create_raw( &#039;IO::FileCreateError&#039;, &quot;Too many ($MAX_TMPFILE_CREATE_ATTEMPTS) failed attempts to create a temp file as EUID $&gt; and GID $) based on “$filename”! The last tried file was “$tmpfile”, and the last error was: $!&quot; );
        }
    }

    my $finally = Cpanel::Finally-&gt;new(
        sub {
            if ( !$tmpfile_is_renamed ) {
                Cpanel::Autodie::unlink_if_exists($tmpfile);

            }
            return;
        }
    );

    if ( my $ref = ref $_[1] ) {
        if ( $ref eq &#039;SCALAR&#039; ) {
            _write_fh( $fh, ${ $_[1] } );
        }
        else {
            die Cpanel::Exception::create( &#039;InvalidParameter&#039;, &#039;Invalid content type “[_1]”, expect a scalar.&#039;, [$ref] );
        }
    }
    else {
        _write_fh( $fh, $_[1] );
    }

    $callback_cr-&gt;($fh) if $callback_cr;

    $tmpfile_is_renamed = $finish_cr-&gt;( $tmpfile, $filename );

    if ( !$tmpfile_is_renamed ) {
        Cpanel::Autodie::unlink_if_exists($tmpfile);
    }

    $finally-&gt;skip();

    return $fh;
}

*_syswrite = *Cpanel::Autodie::syswrite_sigguard;

our $DEBUG_WRITE;

sub _write_fh {
    if ( length $_[1] ) {
        my $pos = 0;

        do {

            local $SIG{&#039;XFSZ&#039;} = &#039;IGNORE&#039; if $pos;

            $pos += _syswrite( $_[0], $_[1], length( $_[1] ), $pos ) || do {

                die &quot;Zero bytes written, non-error!&quot;;
            };
        } while $pos &lt; length( $_[1] );
    }

    return;
}

sub _write_finish {

    Cpanel::Autodie::link(@_);
    return 0;
}

*_overwrite_finish = *Cpanel::Autodie::rename;

1;

} # --- END Cpanel/FileUtils/Write.pm


{ # --- BEGIN Cpanel/FileUtils/Write/JSON/Lazy.pm
package Cpanel::FileUtils::Write::JSON::Lazy;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub write_file {
    my ( $file_or_fh, $data, $perms ) = @_;

    if ( exists $INC{&#039;Cpanel/JSON.pm&#039;} &amp;&amp; exists $INC{&#039;JSON/XS.pm&#039;} &amp;&amp; ( my $Dump = &#039;Cpanel::JSON&#039;-&gt;can(&#039;Dump&#039;) ) ) {    # PPI NO PARSE -- check earlier - must be quoted or it ends up in the stash
        require Cpanel::FileUtils::Write if !$INC{&#039;Cpanel/FileUtils/Write.pm&#039;};
        require Cpanel::FHUtils::Tiny    if !$INC{&#039;Cpanel/FHUtils/Tiny.pm&#039;};
        my $func = Cpanel::FHUtils::Tiny::is_a($file_or_fh) ? &#039;write_fh&#039; : &#039;overwrite&#039;;

        if ( $func eq &#039;write_fh&#039; ) {
            if ( !defined $perms ) {
                $perms = 0600;
            }

            chmod( $perms, $file_or_fh ) or die &quot;Failed to set permissions on the file handle passed to Cpanel::FileUtils::Write::JSON::Lazy::write_file because of an error: $!&quot;;
        }

        return Cpanel::FileUtils::Write-&gt;can($func)-&gt;(
            $file_or_fh,
            $Dump-&gt;($data),
            $perms
        );
    }
    return 0;
}


sub write_file_pretty {
    my ( $file_or_fh, $data, $perms ) = @_;

    if ( exists $INC{&#039;Cpanel/JSON.pm&#039;} &amp;&amp; exists $INC{&#039;JSON/XS.pm&#039;} &amp;&amp; ( my $Dump = &#039;Cpanel::JSON&#039;-&gt;can(&#039;pretty_dump&#039;) ) ) {    # PPI NO PARSE -- check earlier - must be quoted or it ends up in the stash
        require Cpanel::FileUtils::Write if !$INC{&#039;Cpanel/FileUtils/Write.pm&#039;};
        require Cpanel::FHUtils::Tiny    if !$INC{&#039;Cpanel/FHUtils/Tiny.pm&#039;};
        my $func = Cpanel::FHUtils::Tiny::is_a($file_or_fh) ? &#039;write_fh&#039; : &#039;overwrite&#039;;

        if ( $func eq &#039;write_fh&#039; ) {
            if ( !defined $perms ) {
                $perms = 0600;
            }

            chmod( $perms, $file_or_fh ) or die &quot;Failed to set permissions on the file handle passed to Cpanel::FileUtils::Write::JSON::Lazy::write_file because of an error: $!&quot;;
        }

        return Cpanel::FileUtils::Write-&gt;can($func)-&gt;(
            $file_or_fh,
            $Dump-&gt;($data),
            $perms
        );
    }
    return 0;
}

1;

} # --- END Cpanel/FileUtils/Write/JSON/Lazy.pm


{ # --- BEGIN Cpanel/CPAN/Locale/Maketext.pm
package Cpanel::CPAN::Locale::Maketext;


use strict;
our @ISA;
our $VERSION;
our $MATCH_SUPERS;
our $USING_LANGUAGE_TAGS;
our $USE_LITERALS;
our $MATCH_SUPERS_TIGHTLY;

use constant IS_ASCII =&gt; ord(&#039;A&#039;) == 65;

BEGIN {
    unless ( defined &amp;DEBUG ) {
        *DEBUG = sub () { 0 }
    }
}


$VERSION = &#039;1.13_89&#039;;
$VERSION = eval $VERSION;
@ISA     = ();

$MATCH_SUPERS         = 1;
$MATCH_SUPERS_TIGHTLY = 1;
$USING_LANGUAGE_TAGS  = 1;
my $FORCE_REGEX_LAZY = &#039;&#039;;


$USE_LITERALS = 1 unless defined $USE_LITERALS;


my %isa_scan = ();
my %isa_ones = ();


sub quant {
    my ( $handle, $num, @forms ) = @_;

    return $num      if @forms == 0;                 # what should this mean?
    return $forms[2] if @forms &gt; 2 and $num == 0;    # special zeroth case

    return ( $handle-&gt;numf($num) . &#039; &#039; . $handle-&gt;numerate( $num, @forms ) );

}

sub numerate {

    my ( $handle, $num, @forms ) = @_;
    my $s = ( $num == 1 );

    return &#039;&#039; unless @forms;
    if ( @forms == 1 ) {    # only the headword form specified
        return $s ? $forms[0] : ( $forms[0] . &#039;s&#039; );    # very cheap hack.
    }
    else {                                              # sing and plural were specified
        return $s ? $forms[0] : $forms[1];
    }
}


sub numf {
    my ( $handle, $num ) = @_[ 0, 1 ];
    if ( $num &lt; 10_000_000_000 and $num &gt; -10_000_000_000 and $num == int($num) ) {
        $num += 0;    # Just use normal integer stringification.
    }
    else {
        $num = CORE::sprintf( &#039;%G&#039;, $num );

    }
    while ( $num =~ s/$FORCE_REGEX_LAZY^([-+]?\d+)(\d{3})/$1,$2/os ) { 1 }    # right from perlfaq5

    $num =~ tr&lt;.,&gt;&lt;,.&gt; if ref($handle) and $handle-&gt;{&#039;numf_comma&#039;};

    return $num;
}

sub sprintf {
    no integer;
    my ( $handle, $format, @params ) = @_;
    return CORE::sprintf( $format, @params );

}


use integer;    # vroom vroom... applies to the whole rest of the module

sub language_tag {
    my $it = ref( $_[0] ) || $_[0];
    return undef unless $it =~ m/$FORCE_REGEX_LAZY([^&#039;:]+)(?:::)?$/os;
    $it = lc($1);
    $it =~ tr&lt;_&gt;&lt;-&gt;;
    return $it;
}

sub encoding {
    my $it = $_[0];
    return (
        ( ref($it) &amp;&amp; $it-&gt;{&#039;encoding&#039;} )
          || &#039;iso-8859-1&#039;    # Latin-1
    );
}


sub fallback_languages { return ( &#039;i-default&#039;, &#039;en&#039;, &#039;en-US&#039; ) }

sub fallback_language_classes { return () }


sub fail_with {    # an actual attribute method!
    my ( $handle, @params ) = @_;
    return unless ref($handle);
    $handle-&gt;{&#039;fail&#039;} = $params[0] if @params;
    return $handle-&gt;{&#039;fail&#039;};
}


sub blacklist {
    my ( $handle, @methods ) = @_;

    unless ( defined $handle-&gt;{&#039;blacklist&#039;} ) {
        no strict &#039;refs&#039;;

        $handle-&gt;{&#039;blacklist&#039;} = {
            map { $_ =&gt; 1 } (
                qw/
                  blacklist
                  encoding
                  fail_with
                  failure_handler_auto
                  fallback_language_classes
                  fallback_languages
                  get_handle
                  init
                  language_tag
                  maketext
                  new
                  whitelist
                  /, grep { substr( $_, 0, 1 ) eq &#039;_&#039; } keys %{ __PACKAGE__ . &quot;::&quot; }
            ),
        };
    }

    if ( scalar @methods ) {
        $handle-&gt;{&#039;blacklist&#039;} = { %{ $handle-&gt;{&#039;blacklist&#039;} }, map { $_ =&gt; 1 } @methods };
    }

    delete $handle-&gt;{&#039;_external_lex_cache&#039;};
    return;
}

sub whitelist {
    my ( $handle, @methods ) = @_;
    if ( scalar @methods ) {
        if ( defined $handle-&gt;{&#039;whitelist&#039;} ) {
            $handle-&gt;{&#039;whitelist&#039;} = { %{ $handle-&gt;{&#039;whitelist&#039;} }, map { $_ =&gt; 1 } @methods };
        }
        else {
            $handle-&gt;{&#039;whitelist&#039;} = { map { $_ =&gt; 1 } @methods };
        }
    }

    delete $handle-&gt;{&#039;_external_lex_cache&#039;};
    return;
}


sub failure_handler_auto {


    my $handle = shift;
    my $phrase = shift;

    $handle-&gt;{&#039;failure_lex&#039;} ||= {};
    my $lex = $handle-&gt;{&#039;failure_lex&#039;};

    my $value = $lex-&gt;{$phrase} ||= ( $phrase !~ tr/[// ? \&quot;$phrase&quot; : $handle-&gt;_compile($phrase) );

    return ${$value} if ref($value) eq &#039;SCALAR&#039;;
    return $value    if ref($value) ne &#039;CODE&#039;;
    {
        local $SIG{&#039;__DIE__&#039;};
        eval { $value = &amp;$value( $handle, @_ ) };
    }

    if ($@) {
        my $err = $@;

        $err =~ s{\s+at\s+\(eval\s+\d+\)\s+line\s+(\d+)\.?\n?}
                 {\n in bracket code [compiled line $1],}s;

        require Carp;
        Carp::croak(&quot;Error in maketexting \&quot;$phrase\&quot;:\n$err as used&quot;);

    }
    else {
        return $value;
    }
}


sub new {

    my $class  = ref( $_[0] ) || $_[0];
    my $handle = bless {}, $class;
    $handle-&gt;blacklist;
    $handle-&gt;init;
    return $handle;
}

sub init { return }    # no-op


sub maketext {

    unless ( @_ &gt; 1 ) {
        require Carp;
        Carp::croak(&#039;maketext requires at least one parameter&#039;);
    }

    my ( $handle, $phrase ) = splice( @_, 0, 2 );
    unless ( defined($handle) &amp;&amp; defined($phrase) ) {
        require Carp;
        Carp::confess(&#039;No handle/phrase&#039;);
    }

    my $value;
    if ( exists $handle-&gt;{&#039;_external_lex_cache&#039;}{$phrase} ) {
        DEBUG and warn &quot;* Using external lex cache version of \&quot;$phrase\&quot;\n&quot;;
        $value = $handle-&gt;{&#039;_external_lex_cache&#039;}{$phrase};
    }
    else {
        my $ns = ref($handle) || $handle;
        foreach my $h_r ( @{ $isa_scan{$ns} || $handle-&gt;_lex_refs } ) {
            DEBUG and warn &quot;* Looking up \&quot;$phrase\&quot; in $h_r\n&quot;;
            if ( defined( $value = $h_r-&gt;{$phrase} ) ) {    # Minimize looking at $h_r as much as possible as an expensive tied hash to CDB_File
                DEBUG and warn &quot;  Found \&quot;$phrase\&quot; in $h_r\n&quot;;
                unless ( ref $value ) {

                    if ( !length $value ) {
                        DEBUG and warn &quot; value is undef or &#039;&#039;&quot;;
                        if ( $isa_ones{&quot;$h_r&quot;} ) {
                            DEBUG and warn &quot; $ns ($h_r) is Onesided and \&quot;$phrase\&quot; entry is undef or &#039;&#039;\n&quot;;
                            $value = $phrase;
                        }
                    }


                    if ( $handle-&gt;{&#039;use_external_lex_cache&#039;} ) {

                        $handle-&gt;{&#039;_external_lex_cache&#039;}{$phrase} = $value = ( $value !~ tr/[// ? \&quot;$value&quot; : $handle-&gt;_compile($value) );
                    }
                    else {

                        $h_r-&gt;{$phrase} = $value = ( $value !~ tr/[// ? \&quot;$value&quot; : $handle-&gt;_compile($value) );
                    }
                }
                last;
            }

            elsif ( substr( $phrase, 0, 1 ) ne &#039;_&#039; and ( $handle-&gt;{&#039;use_external_lex_cache&#039;} ? ( exists $handle-&gt;{&#039;_external_lex_cache&#039;}{&#039;_AUTO&#039;} ? $handle-&gt;{&#039;_external_lex_cache&#039;}{&#039;_AUTO&#039;} : $h_r-&gt;{&#039;_AUTO&#039;} ) : $h_r-&gt;{&#039;_AUTO&#039;} ) ) {

                DEBUG and warn &quot;  Automaking \&quot;$phrase\&quot; into $h_r\n&quot;;
                if ( $handle-&gt;{&#039;use_external_lex_cache&#039;} ) {

                    $handle-&gt;{&#039;_external_lex_cache&#039;}{$phrase} = $value = ( $phrase !~ tr/[// ? \&quot;$phrase&quot; : $handle-&gt;_compile($phrase) );
                }
                else {

                    $h_r-&gt;{$phrase} = $value = ( $phrase !~ tr/[// ? \&quot;$phrase&quot; : $handle-&gt;_compile($phrase) );
                }
                last;
            }
            DEBUG &gt; 1 and print &quot;  Not found in $h_r, nor automakable\n&quot;;

        }

        if ( !defined($value) ) {
            delete $handle-&gt;{&#039;_external_lex_cache&#039;}{$phrase};

            DEBUG and warn &quot;! Lookup of \&quot;$phrase\&quot; in/under &quot;, ref($handle) || $handle, &quot; fails.\n&quot;;
            if ( ref($handle) and $handle-&gt;{&#039;fail&#039;} ) {
                DEBUG and warn &quot;WARNING0: maketext fails looking for &lt;$phrase&gt;\n&quot;;
                my $fail;
                if ( ref( $fail = $handle-&gt;{&#039;fail&#039;} ) eq &#039;CODE&#039; ) {    # it&#039;s a sub reference
                    return &amp;{$fail}( $handle, $phrase, @_ );

                }
                else {                                                 # It&#039;s a method name
                    return $handle-&gt;$fail( $phrase, @_ );

                }
            }
            else {
                require Carp;

                Carp::croak(&quot;maketext doesn&#039;t know how to say:\n$phrase\nas needed&quot;);
            }
        }

    }

    if ( ref($value) eq &#039;SCALAR&#039; ) {
        return $$value;
    }
    elsif ( ref($value) ne &#039;CODE&#039; ) {
        return $value;
    }

    local $@;
    {
        local $SIG{&#039;__DIE__&#039;};
        return eval { &amp;$value( $handle, @_ ) } unless $@;
    }

    my $err = $@;

    $err =~ s{\s+at\s+\(eval\s+\d+\)\s+line\s+(\d+)\.?\n?}
    {\n in bracket code [compiled line $1],}s;

    require Carp;

    Carp::croak(&quot;Error in maketexting \&quot;$phrase\&quot;:\n$err as used&quot;);

}


sub get_handle {    # This is a constructor and, yes, it CAN FAIL.

    my ( $base_class, @languages ) = @_;
    $base_class = ref($base_class) || $base_class;

    my $load_alternate_language_tags = 0;


    if (@languages) {
        DEBUG and warn &#039;Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;
        $load_alternate_language_tags = 1 if $USING_LANGUAGE_TAGS;    # An explicit language-list was given!
    }
    else {
        @languages = $base_class-&gt;_ambient_langprefs;
    }

    my %seen;
    foreach my $module_name ( map { $base_class . &#039;::&#039; . $_ } @languages ) {
        next
          if !length $module_name                                     # sanity
          || $seen{$module_name}++                                    # Already been here, and it was no-go
          || $module_name =~ tr{/-}{}
          || !&amp;_try_use($module_name);                                # Try to use() it, but can&#039;t it.
        return ( $module_name-&gt;new );                                 # Make it!
    }

    if ($load_alternate_language_tags) {
        require I18N::LangTags;
        @languages =
          map { ; $_, I18N::LangTags::alternate_language_tags($_) }

          map I18N::LangTags::locale2language_tag($_),

          @languages;
        DEBUG and warn &#039;Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;
    }
    @languages = $base_class-&gt;_langtag_munging(@languages);

    foreach my $module_name ( map { $base_class . &#039;::&#039; . $_ } @languages ) {
        next
          if !length $module_name         # sanity
          || $seen{$module_name}++        # Already been here, and it was no-go
          || $module_name =~ tr{/-}{}
          || !&amp;_try_use($module_name);    # Try to use() it, but can&#039;t it.
        return ( $module_name-&gt;new );     # Make it!
    }

    return undef;                         # Fail!
}


sub _langtag_munging {
    my ( $base_class, @languages ) = @_;


    DEBUG and warn &#039;Lgs1: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;

    if ($USING_LANGUAGE_TAGS) {
        require I18N::LangTags;

        DEBUG and warn &#039;Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;
        @languages = $base_class-&gt;_add_supers(@languages);

        push @languages, I18N::LangTags::panic_languages(@languages);
        DEBUG and warn &quot;After adding panic languages:\n&quot;, &#039; Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;

        push @languages, $base_class-&gt;fallback_languages;

        DEBUG and warn &#039;Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;

        @languages =    # final bit of processing to turn them into classname things
          map {
            my $it = $_;               # copy
            $it =~ tr&lt;-A-Z&gt;&lt;_a-z&gt;;     # lc, and turn - to _
            $it =~ tr&lt;_a-z0-9&gt;&lt;&gt;cd;    # remove all but a-z0-9_
            $it;
          } @languages;
        DEBUG and warn &quot;Nearing end of munging:\n&quot;, &#039; Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;
    }
    else {
        DEBUG and warn &quot;Bypassing language-tags.\n&quot;, &#039; Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;
    }

    DEBUG and warn &quot;Before adding fallback classes:\n&quot;, &#039; Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;

    push @languages, $base_class-&gt;fallback_language_classes;


    DEBUG and warn &quot;Finally:\n&quot;, &#039; Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;

    return @languages;
}


sub _ambient_langprefs {
    require I18N::LangTags::Detect;
    return I18N::LangTags::Detect::detect();
}


sub _add_supers {
    my ( $base_class, @languages ) = @_;

    if ( !$MATCH_SUPERS ) {

        DEBUG and warn &quot;Bypassing any super-matching.\n&quot;, &#039; Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;

    }
    elsif ($MATCH_SUPERS_TIGHTLY) {
        require I18N::LangTags;
        DEBUG and warn &quot;Before adding new supers tightly:\n&quot;, &#039; Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;
        @languages = I18N::LangTags::implicate_supers(@languages);
        DEBUG and warn &quot;After adding new supers tightly:\n&quot;, &#039; Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;

    }
    else {
        require I18N::LangTags;
        DEBUG and warn &quot;Before adding supers to end:\n&quot;, &#039; Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;
        @languages = I18N::LangTags::implicate_supers_strictly(@languages);
        DEBUG and warn &quot;After adding supers to end:\n&quot;, &#039; Lgs@&#039;, __LINE__, &#039;: &#039;, map( &quot;&lt;$_&gt;&quot;, @languages ), &quot;\n&quot;;
    }

    return @languages;
}


my %tried = ();


sub _try_use {    # Basically a wrapper around &quot;require Modulename&quot;
    return $tried{ $_[0] } if exists $tried{ $_[0] };    # memoization

    my $module = $_[0];                                  # ASSUME sane module name!
    {
        no strict &#039;refs&#039;;
        return ( $tried{$module} = 1 )
          if ( %{ $module . &#039;::Lexicon&#039; } or @{ $module . &#039;::ISA&#039; } );

    }

    DEBUG and warn &quot; About to use $module ...\n&quot;;
    {
        local $SIG{&#039;__DIE__&#039;};
        eval &quot;require $module&quot;;    # used to be &quot;use $module&quot;, but no point in that.
    }
    if ($@) {
        DEBUG and warn &quot;Error using $module \: $@\n&quot;;
        return $tried{$module} = 0;
    }
    else {
        DEBUG and warn &quot; OK, $module is used\n&quot;;
        return $tried{$module} = 1;
    }
}


sub _lex_refs {    # report the lexicon references for this handle&#039;s class
    no strict &#039;refs&#039;;
    no warnings &#039;once&#039;;
    my $class = ref( $_[0] ) || $_[0];
    DEBUG and warn &quot;Lex refs lookup on $class\n&quot;;
    return $isa_scan{$class} if exists $isa_scan{$class};    # memoization!

    my @lex_refs;
    my $seen_r = ref( $_[1] ) ? $_[1] : {};

    if ( defined( *{ $class . &#039;::Lexicon&#039; }{&#039;HASH&#039;} ) ) {
        push @lex_refs, *{ $class . &#039;::Lexicon&#039; }{&#039;HASH&#039;};
        $isa_ones{&quot;$lex_refs[-1]&quot;} = defined ${ $class . &#039;::Onesided&#039; } &amp;&amp; ${ $class . &#039;::Onesided&#039; } ? 1 : 0;
        DEBUG and warn &#039;%&#039; . $class . &#039;::Lexicon contains &#039;, scalar( keys %{ $class . &#039;::Lexicon&#039; } ), &quot; entries\n&quot;;
    }

    foreach my $superclass ( @{ $class . &#039;::ISA&#039; } ) {
        DEBUG and warn &quot; Super-class search into $superclass\n&quot;;
        next if $seen_r-&gt;{$superclass}++;
        push @lex_refs, @{ &amp;_lex_refs( $superclass, $seen_r ) };    # call myself
    }

    $isa_scan{$class} = \@lex_refs;                                 # save for next time
    return \@lex_refs;
}

sub clear_isa_scan { %isa_scan = (); return; }                      # end on a note of simplicity!


BEGIN {
}


sub _compile {


    return \&quot;$_[1]&quot; if $_[1] !~ tr/[//;

    my ( $handle, $call_count, $big_pile, @c, @code ) = ( $_[0], 0, &#039;&#039;, &#039;&#039; );
    {

        my ( $in_group, $m, @params ) = (0);    # scratch

        my $under_one = $_[1];                  # There are taint issues using regex on $_ - perlbug 60378,27344
        while (
            $under_one =~                       # Iterate over chunks.
            m/\G(
                [^\~\[\]]+  # non-~[] stuff
                |
                ~.       # ~[, ~], ~~, ~other
                |
                \[          # [ presumably opening a group
                |
                \]          # ] presumably closing a group
                |
                ~           # terminal ~ ?
                |
                $
            )/xgs
        ) {
            DEBUG &gt; 2 and warn qq{  &quot;$1&quot;\n};

            if ( $1 eq &#039;[&#039; or $1 eq &#039;&#039; ) {    # &quot;[&quot; or end
                if ($in_group) {
                    if ( $1 eq &#039;&#039; ) {
                        $handle-&gt;_die_pointing( $under_one, &#039;Unterminated bracket group&#039; );
                    }
                    else {
                        $handle-&gt;_die_pointing( $under_one, &#039;You can\&#039;t nest bracket groups&#039; );
                    }
                }
                else {
                    if ( $1 eq &#039;&#039; ) {
                        DEBUG &gt; 2 and warn &quot;   [end-string]\n&quot;;
                    }
                    else {
                        $in_group = 1;
                    }
                    die &quot;How come \@c is empty?? in &lt;$under_one&gt;&quot; unless @c;    # sanity
                    if ( length $c[-1] ) {

                        $big_pile .= $c[-1];
                        if (
                            $USE_LITERALS and (
                                IS_ASCII
                                ? $c[-1] !~ tr/\x20-\x7E//c

                                : $c[-1] !~ m/$FORCE_REGEX_LAZY[^ !&quot;\#\$%&amp;&#039;()*+,\-.\/0-9:;&lt;=&gt;?\@A-Z[\\\]^_`a-z{|}~\x07]/os

                            )
                        ) {

                            $c[-1] =~ s/&#039;/\\&#039;/g if $c[-1] =~ tr{&#039;}{};
                            push @code, q{ &#039;} . $c[-1] . &quot;&#039;,\n&quot;;
                            $c[-1] = &#039;&#039;;    # reuse this slot
                        }
                        else {
                            $c[-1] =~ s/\\\\/\\/g if $c[-1] =~ tr{\\}{};
                            push @code, &#039; $c[&#039; . $#c . &quot;],\n&quot;;
                            push @c,    &#039;&#039;;                      # new chunk
                        }
                    }

                }

            }
            elsif ( $1 eq &#039;]&#039; ) {    # &quot;]&quot;
                if ($in_group) {
                    $in_group = 0;

                    DEBUG &gt; 2 and warn &quot;   --Closing group [$c[-1]]\n&quot;;


                    if ( !length( $c[-1] ) or $c[-1] !~ tr/ \t\r\n\f//c ) {
                        DEBUG &gt; 2 and warn &quot;   -- (Ignoring)\n&quot;;
                        $c[-1] = &#039;&#039;;    # reset out chink
                        next;
                    }

                    ( $m, @params ) = split( /,/, $c[-1], -1 );    # was /\s*,\s*/

                    if (IS_ASCII) {    # ASCII, etc
                        foreach ( $m, @params ) { tr/\x7F/,/ }
                    }
                    else {             # EBCDIC (1047, 0037, POSIX-BC)
                        foreach ( $m, @params ) { tr/\x07/,/ }
                    }

                    if ( $m eq &#039;_1&#039; or $m eq &#039;_2&#039; or $m eq &#039;_3&#039; or $m eq &#039;_*&#039; or ( substr( $m, 0, 1 ) eq &#039;_&#039; &amp;&amp; $m =~ m/^_(-?\d+)$/s ) ) {

                        unshift @params, $m;
                        $m = &#039;&#039;;
                    }
                    elsif ( $m eq &#039;*&#039; ) {
                        $m = &#039;quant&#039;;    # &quot;*&quot; for &quot;times&quot;: &quot;4 cars&quot; is 4 times &quot;cars&quot;
                    }
                    elsif ( $m eq &#039;#&#039; ) {
                        $m = &#039;numf&#039;;     # &quot;#&quot; for &quot;number&quot;: [#,_1] for &quot;the number _1&quot;
                    }

                    if ( $m eq &#039;&#039; ) {

                        push @code, &#039; (&#039;;
                    }
                    elsif (
                        $m !~ tr{a-zA-Z0-9_}{}c    # does not contain non-word characters
                        &amp;&amp; !$handle-&gt;{&#039;blacklist&#039;}{$m}
                        &amp;&amp; ( !defined $handle-&gt;{&#039;whitelist&#039;} || $handle-&gt;{&#039;whitelist&#039;}{$m} )

                    ) {
                        push @code, &#039; $_[0]-&gt;&#039; . $m . &#039;(&#039;;
                    }
                    else {

                        $handle-&gt;_die_pointing(
                            $under_one,
                            &quot;Can&#039;t use \&quot;$m\&quot; as a method name in bracket group&quot;,
                            2 + length( $c[-1] )
                        );
                    }

                    pop @c;    # we don&#039;t need that chunk anymore
                    ++$call_count;

                    foreach my $p (@params) {
                        if ( $p eq &#039;_*&#039; ) {

                            $code[-1] .= &#039; @_[1 .. $#_], &#039;;

                        }
                        elsif ( substr( $p, 0, 1 ) eq &#039;_&#039; &amp;&amp; ( $p eq &#039;_1&#039; || $p eq &#039;_2&#039; || $p eq &#039;_3&#039; || $p =~ m/^_-?\d+$/s ) ) {

                            $code[-1] .= &#039;$_[&#039; . ( 0 + substr( $p, 1 ) ) . &#039;], &#039;;
                        }
                        elsif (
                            $USE_LITERALS and (
                                IS_ASCII
                                ? $p !~ tr/\x20-\x7E//c

                                : $p !~ m/$FORCE_REGEX_LAZY[^ !&quot;\#\$%&amp;&#039;()*+,\-.\/0-9:;&lt;=&gt;?\@A-Z[\\\]^_`a-z{|}~\x07]/os

                            )
                        ) {

                            $p =~ s/&#039;/\\&#039;/g if $p =~ tr{&#039;}{};
                            $code[-1] .= q{&#039;} . $p . q{&#039;, };
                        }
                        else {

                            push @c,    $p;
                            push @code, &#039; $c[&#039; . $#c . &#039;], &#039;;
                        }
                    }
                    $code[-1] .= &quot;),\n&quot;;

                    push @c, &#039;&#039;;
                }
                else {
                    $handle-&gt;_die_pointing( $under_one, q{Unbalanced &#039;]&#039;} );
                }

            }
            elsif ( substr( $1, 0, 1 ) ne &#039;~&#039; ) {

                if ( $1 =~ tr{\\}{} ) {
                    my $text = $1;
                    $text =~ s/\\/\\\\/g;
                    $c[-1] .= $text;
                }
                else {
                    $c[-1] .= $1;
                }

            }
            elsif ( $1 eq &#039;~~&#039; ) {    # &quot;~~&quot;
                $c[-1] .= &#039;~&#039;;

            }
            elsif ( $1 eq &#039;~[&#039; ) {    # &quot;~[&quot;
                $c[-1] .= &#039;[&#039;;

            }
            elsif ( $1 eq &#039;~]&#039; ) {    # &quot;~]&quot;
                $c[-1] .= &#039;]&#039;;

            }
            elsif ( $1 eq &#039;~,&#039; ) {    # &quot;~,&quot;
                if ($in_group) {

                    if (IS_ASCII) {    # ASCII etc
                        $c[-1] .= &quot;\x7F&quot;;
                    }
                    else {             # EBCDIC (cp 1047, 0037, POSIX-BC)
                        $c[-1] .= &quot;\x07&quot;;
                    }
                }
                else {
                    $c[-1] .= &#039;~,&#039;;
                }

            }
            elsif ( $1 eq &#039;~&#039; ) {    # possible only at string-end, it seems.
                $c[-1] .= &#039;~&#039;;

            }
            else {

                my $text = $1;
                $text =~ s/\\/\\\\/g if $text =~ tr{\\}{};
                $c[-1] .= $text;
            }
        }
    }

    if ($call_count) {
        undef $big_pile;    # Well, nevermind that.
    }
    else {

        return \$big_pile;
    }

    die q{Last chunk isn&#039;t null??} if @c and length $c[-1];    # sanity
    DEBUG and warn scalar(@c), &quot; chunks under closure\n&quot;;
    my $sub;
    if ( @code == 0 ) {                                        # not possible?
        DEBUG and warn &quot;Empty code\n&quot;;
        return \&#039;&#039;;
    }
    elsif ( scalar @code &gt; 1 ) {                               # most cases, presumably!
        $sub = &quot;sub { join &#039;&#039;, map { defined \$_ ? \$_ : &#039;&#039; } @code }&quot;;
    }
    else {
        $sub = &quot;sub { $code[0] }&quot;;
    }
    DEBUG and warn $sub;
    my $code;
    {
        use strict;
        $code = eval $sub;
        die &quot;$@ while eval&#039;ing &quot; . $sub if $@;    # Should be impossible.
    }
    return $code;
}


sub _die_pointing {

    my $target = shift;
    $target = ref($target) || $target;    # class name

    my $i = index( $_[0], &quot;\n&quot; );

    my $pointy;
    my $pos = pos( $_[0] ) - ( defined( $_[2] ) ? $_[2] : 0 ) - 1;
    if ( $pos &lt; 1 ) {
        $pointy = &quot;^=== near there\n&quot;;
    }
    else {                                # we need to space over
        my $first_tab = index( $_[0], &quot;\t&quot; );
        if ( $pos &gt; 2 and ( -1 == $first_tab or $first_tab &gt; pos( $_[0] ) ) ) {

            $pointy = ( &#039;=&#039; x $pos ) . &quot;^ near there\n&quot;;
        }
        else {

            $pointy = substr( $_[0], 0, $pos );
            $pointy =~ tr/\t //cd;

            $pointy .= &quot;^=== near there\n&quot;;
        }
    }

    my $errmsg = &quot;$_[1], in\:\n$_[0]&quot;;

    if ( $i == -1 ) {

        $errmsg .= &quot;\n&quot; . $pointy;
    }
    elsif ( $i == ( length( $_[0] ) - 1 ) ) {

        $errmsg .= $pointy;
    }
    else {

    }
    require Carp;
    Carp::croak(&quot;$errmsg via $target, as used&quot;);
}


1;

} # --- END Cpanel/CPAN/Locale/Maketext.pm


{ # --- BEGIN Cpanel/Locale/Utils/Normalize.pm
package Cpanel::Locale::Utils::Normalize;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub normalize_tag {
    my ($tag) = @_;
    return if !defined $tag;
    $tag =~ tr/A-Z/a-z/;
    $tag =~ tr{\r\n \t\f}{}d;
    if ( $tag =~ tr{a-z0-9}{}c ) {
        $tag =~ s{[^a-z0-9]+$}{};    # I18N::LangTags::locale2language_tag() does not allow trailing &#039;_&#039;
        $tag =~ tr{a-z0-9}{_}c;
    }

    if ( length $tag &gt; 8 ) {
        while ( $tag =~ s/([^_]{8})([^_])/$1\_$2/ ) { }    # I18N::LangTags::locale2language_tag() only allows parts between 1 and 8 character
    }
    return $tag;
}

1;

} # --- END Cpanel/Locale/Utils/Normalize.pm


{ # --- BEGIN Cpanel/CPAN/Locales/Legacy.pm
package Cpanel::CPAN::Locales::Legacy;

use strict;


sub numf {
    my ( $self, $always_return ) = @_;
    my $class = ref($self) ? ref($self) : $self;
    $always_return ||= 0;
    $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;}   = &#039;&#039; if !defined $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;};
    $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;} = &#039;&#039; if !defined $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;};

    if ( !$self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;} || !$self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;} ) {
        if ($always_return) {
            if ( $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;} || !$self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;} ) {
                return 2 if $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;} eq &#039;.&#039;;
                return 1;
            }
            elsif ( !$self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;} || $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;} ) {
                return 2 if $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;} eq &#039;,&#039;;
                return 1;
            }
            else {
                return 1;
            }
        }
    }

    if ( $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;decimal&#039;} eq &quot;\#\,\#\#0\.\#\#\#&quot; ) {
        if ( $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;} eq &#039;,&#039; &amp;&amp; $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;} eq &#039;.&#039; ) {
            return 1;
        }
        elsif ( $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;} eq &#039;.&#039; &amp;&amp; $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;} eq &#039;,&#039; ) {
            return 2;
        }
    }
    elsif ( $always_return &amp;&amp; $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;} &amp;&amp; $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;} ) {
        return 2 if $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;} eq &#039;,&#039;;
        return 2 if $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;} eq &#039;.&#039;;
        return 1;
    }

    return [
        $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;decimal&#039;},
        $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;},
        $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;},
    ];
}

1;

} # --- END Cpanel/CPAN/Locales/Legacy.pm


{ # --- BEGIN Cpanel/CPAN/Locales/DB/LocaleDisplayPattern/Tiny.pm
package Cpanel::CPAN::Locales::DB::LocaleDisplayPattern::Tiny;

use strict;


$Cpanel::CPAN::Locales::DB::LocaleDisplayPattern::Tiny::VERSION = &#039;0.09&#039;;

$Cpanel::CPAN::Locales::DB::LocaleDisplayPattern::Tiny::cldr_version = &#039;2.0&#039;;

my %locale_display_lookup = (
    &#039;ksh&#039; =&gt; &#039;{0} en {1}&#039;,
    &#039;ja&#039;  =&gt; &#039;{0}({1})&#039;,
    &#039;zh&#039;  =&gt; &#039;{0}（{1}）&#039;,
    &#039;ko&#039;  =&gt; &#039;{0}({1})&#039;,
);

sub get_locale_display_pattern {
    if ( exists $locale_display_lookup{ $_[0] } ) {
        return $locale_display_lookup{ $_[0] };
    }
    else {
        require Cpanel::CPAN::Locales;
        my ($l) = Cpanel::CPAN::Locales::split_tag( $_[0] );
        if ( $l ne $_[0] ) {
            return $locale_display_lookup{$l} if exists $locale_display_lookup{$l};
        }
        return &quot;\{0\}\ \(\{1\}\)&quot;;
    }
}

1;

} # --- END Cpanel/CPAN/Locales/DB/LocaleDisplayPattern/Tiny.pm


{ # --- BEGIN Cpanel/CPAN/Locales/DB/CharacterOrientation/Tiny.pm
package Cpanel::CPAN::Locales::DB::CharacterOrientation::Tiny;

use strict;


$Cpanel::CPAN::Locales::DB::CharacterOrientation::Tiny::VERSION = &#039;0.09&#039;;

$Cpanel::CPAN::Locales::DB::CharacterOrientation::Tiny::cldr_version = &#039;2.0&#039;;

my %rtl = (
    &#039;ur&#039; =&gt; &#039;&#039;,
    &#039;ku&#039; =&gt; &#039;&#039;,
    &#039;he&#039; =&gt; &#039;&#039;,
    &#039;fa&#039; =&gt; &#039;&#039;,
    &#039;ps&#039; =&gt; &#039;&#039;,
    &#039;ar&#039; =&gt; &#039;&#039;,
);

sub get_orientation {
    if ( exists $rtl{ $_[0] } ) {
        return &#039;right-to-left&#039;;
    }
    else {
        require Cpanel::CPAN::Locales;
        my ($l) = Cpanel::CPAN::Locales::split_tag( $_[0] );
        if ( $l ne $_[0] ) {
            return &#039;right-to-left&#039; if exists $rtl{$l};
        }
        return &#039;left-to-right&#039;;
    }
}

1;

} # --- END Cpanel/CPAN/Locales/DB/CharacterOrientation/Tiny.pm


{ # --- BEGIN Cpanel/CPAN/Locales/Compile.pm
package Cpanel::CPAN::Locales::Compile;

use strict;
use warnings;
no warnings &#039;once&#039;;

sub plural_rule_string_to_code {
    my ( $plural_rule_string, $return ) = @_;
    if ( !defined $return ) {
        $return = 1;
    }


    my %m;
    while ( $plural_rule_string =~ m/mod ([0-9]+)/g ) {

        $m{$1} = &quot;( (\$_[0] % $1) + (\$_[0]-int(\$_[0])) )&quot;;
    }

    my $perl_code = &quot;sub { if (&quot;;

    for my $or ( split /\s+or\s+/i, $plural_rule_string ) {
        my $and_exp;
        for my $and ( split /\s+and\s+/i, $or ) {
            my $copy = $and;
            my $n    = &#039;$_[0]&#039;;

            $copy =~ s/ ?n is not / $n \!\= /g;
            $copy =~ s/ ?n is / $n \=\= /g;

            $copy =~ s/ ?n mod ([0-9]+) is not / $m{$1} \!\= /g;
            $copy =~ s/ ?n mod ([0-9]+) is / $m{$1} \=\= /g;

            $copy =~ s/ ?n not in ([0-9]+)\s*\.\.\s*([0-9]+) ?/ int\($n\) \!\= $n \|\| $n &lt; $1 \|\| $n \&gt; $2 /g;
            $copy =~ s/ ?n mod ([0-9]+) not in ([0-9]+)\s*\.\.\s*([0-9]+) ?/ int\($n\) \!\= $n \|\| $m{$1} &lt; $2 \|\| $m{$1} \&gt; $3 /g;

            $copy =~ s/ ?n not within ([0-9]+)\s*\.\.\s*([0-9]+) ?/ \($n &lt; $1 \|\| $n &gt; $2\) /g;
            $copy =~ s/ ?n mod ([0-9]+) not within ([0-9]+)\s*\.\.\s*([0-9]+) ?/ \($m{$1} &lt; $2 \|\| $m{$1} &gt; $3\) /g;

            $copy =~ s/ ?n in ([0-9]+)\s*\.\.\s*([0-9]+) ?/ int\($n\) \=\= $n \&amp;\&amp; $n \&gt;\= $1 \&amp;\&amp; $n \&lt;\= $2 /g;
            $copy =~ s/ ?n mod ([0-9]+) in ([0-9]+)\s*\.\.\s*([0-9]+) ?/ int\($n\) \=\= $n \&amp;\&amp; $m{$1} \&gt;\= $2 \&amp;\&amp; $m{$1} \&lt;\= $3 /g;

            $copy =~ s/ ?n within ([0-9]+)\s*\.\.\s*([0-9]+) ?/ $n \&gt;\= $1 \&amp;\&amp; $n \&lt;\= $2 /g;
            $copy =~ s/ ?n mod ([0-9]+) within ([0-9]+)\s*\.\.\s*([0-9]+) ?/ $m{$1} \&gt;\= $2 \&amp;\&amp; $m{$1} \&lt;\= $3 /g;

            if ( $copy eq $and ) {
                require Carp;
                Carp::carp(&quot;Unknown plural rule syntax&quot;);
                return;
            }
            else {
                $and_exp .= &quot;($copy) &amp;&amp; &quot;;
            }
        }
        $and_exp =~ s/\s+\&amp;\&amp;\s*$//;

        if ($and_exp) {
            $perl_code .= &quot; ($and_exp) || &quot;;
        }
    }
    $perl_code =~ s/\s+\|\|\s*$//;

    $perl_code .= &quot;) { return &#039;$return&#039;; } return;}&quot;;

    return $perl_code;
}

sub plural_rule_string_to_javascript_code {
    my ( $plural_rule_string, $return ) = @_;
    my $perl = plural_rule_string_to_code( $plural_rule_string, $return );
    $perl =~ s/sub \{ /function (n) \{/;
    $perl =~ s/\$_\[0\]/n/g;
    $perl =~ s/ \(n \% ([0-9]+)\) \+ \(n-int\(n\)\) /n % $1/g;
    $perl =~ s/int\(/parseInt\(/g;
    return $perl;
}

1;

} # --- END Cpanel/CPAN/Locales/Compile.pm


{ # --- BEGIN Cpanel/CPAN/Locales.pm
package Cpanel::CPAN::Locales;

use strict;

# use Cpanel::Locale::Utils::Normalize (); # perlpkg line 211

$Cpanel::CPAN::Locales::VERSION      = 0.30_1;    # change in POD
$Cpanel::CPAN::Locales::cldr_version = &#039;2.0&#039;;     # change in POD
my $FORCE_REGEX_LAZY = &#039;&#039;;

*normalize_tag = *Cpanel::Locale::Utils::Normalize::normalize_tag;

my %singleton_stash;

sub get_cldr_version {
    return $Cpanel::CPAN::Locales::cldr_version;
}

sub new {
    my ( $class, $tag ) = @_;
    $tag = normalize_tag($tag) || &#039;en&#039;;

    if ( !exists $singleton_stash{$tag} ) {

        my $locale = {
            &#039;locale&#039; =&gt; $tag,
        };

        if ( my $soft = tag_is_soft_locale($tag) ) {

            $locale-&gt;{&#039;soft_locale_fallback&#039;} = $soft;
            $tag = $soft;
        }

        my $inc_class = ref($class) ? ref($class) : $class;
        $inc_class =~ s{\:\:|\&#039;}{/}g;    # per Module::Want::get_inc_key()

        if ( !exists $INC{&quot;$inc_class/DB/Language/$tag.pm&quot;} ) {
            local $SIG{&#039;__DIE__&#039;};       # cpanel specific: ensure a benign eval does not trigger cpsrvd&#039;s DIE handler (may be made moot by internal case 50857)
            eval &quot;require $class\::DB::Language::$tag&quot; || return;    # Module::Want::have_mod(&quot;$class\::DB::Language::$tag&quot;);
        }

        my ( $language, $territory ) = split_tag( $locale-&gt;{&#039;locale&#039;} );

        $locale-&gt;{&#039;language&#039;} = $language;
        {

            BEGIN { $^H = 0; };                                      # cheap no strict to allow for ref copy

            $locale-&gt;{&#039;language_data&#039;} = {
                &#039;VERSION&#039;      =&gt; \${&quot;$class\::DB::Language::$tag\::VERSION&quot;},
                &#039;cldr_version&#039; =&gt; \${&quot;$class\::DB::Language::$tag\::cldr_version&quot;},
                &#039;misc_info&#039;    =&gt; \%{&quot;$class\::DB::Language::$tag\::misc_info&quot;},
            };
        }
        $locale-&gt;{&#039;territory&#039;} = $territory;

        $locale-&gt;{&#039;misc&#039;}{&#039;list_quote_mode&#039;} = &#039;none&#039;;

        $singleton_stash{$tag} = bless $locale, $class;
    }

    return $singleton_stash{$tag};
}

sub _load_territory_data {
    my ($self) = @_;

    my $tag       = $self-&gt;{&#039;locale&#039;};
    my $class     = scalar ref $self;
    my $inc_class = $class;
    $inc_class =~ s{\:\:|\&#039;}{/}g;    # per Module::Want::get_inc_key()

    if ( !exists $INC{&quot;$inc_class/DB/Territory/$tag.pm&quot;} ) {
        local $SIG{&#039;__DIE__&#039;};       # cpanel specific: ensure a benign eval does not trigger cpsrvd&#039;s DIE handler (may be made moot by internal case 50857)
        eval &quot;require $class\::DB::Territory::$tag&quot; || return;    # Module::Want::have_mod(&quot;$class\::DB::Language::$tag&quot;);
    }
    {

        BEGIN { $^H = 0; };                                       # cheap no strict to allow for ref copy

        $self-&gt;{&#039;territory_data&#039;} = {
            &#039;VERSION&#039;      =&gt; \${&quot;$class\::DB::Territory::$tag\::VERSION&quot;},
            &#039;cldr_version&#039; =&gt; \${&quot;$class\::DB::Territory::$tag\::cldr_version&quot;},
            &#039;code_to_name&#039; =&gt; \%{&quot;$class\::DB::Territory::$tag\::code_to_name&quot;},
        };
    }
    return 1;
}

sub _load_language_data_code_to_name {
    my ($self) = @_;

    my $tag       = $self-&gt;{&#039;locale&#039;};
    my $class     = scalar ref $self;
    my $inc_class = $class;
    $inc_class =~ s{\:\:|\&#039;}{/}g;    # per Module::Want::get_inc_key()

    if ( !exists $INC{&quot;$inc_class/DB/Language/code_to_name/$tag.pm&quot;} ) {
        local $SIG{&#039;__DIE__&#039;};       # cpanel specific: ensure a benign eval does not trigger cpsrvd&#039;s DIE handler (may be made moot by internal case 50857)
        eval &quot;require $class\::DB::Language::code_to_name::$tag&quot; || return;    # Module::Want::have_mod(&quot;$class\::DB::Language::$tag&quot;);
    }

    {

        BEGIN { $^H = 0; };                                                    # cheap no strict to allow for ref copy
        $self-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;} = \%{&quot;$class\::DB::Language::$tag\::code_to_name&quot;};
    }

    return 1;
}


sub get_soft_locale_fallback {
    return $_[0]-&gt;{&#039;soft_locale_fallback&#039;} if $_[0]-&gt;{&#039;soft_locale_fallback&#039;};
    return;
}

sub get_locale { shift-&gt;{&#039;locale&#039;} }

sub get_territory { shift-&gt;{&#039;territory&#039;} }

sub get_language { shift-&gt;{&#039;language&#039;} }

sub get_native_language_from_code {
    my ( $self, $code, $always_return ) = @_;

    my $class = ref($self) ? ref($self) : $self;
    if ( !exists $self-&gt;{&#039;native_data&#039;} ) {
        local $SIG{&#039;__DIE__&#039;};                            # cpanel specific: ensure a benign eval does not trigger cpsrvd&#039;s DIE handler (may be made moot by internal case 50857)
        eval &quot;require $class\::DB::Native;&quot; || return;    # Module::Want::have_mod(&quot;$class\::DB::Native&quot;);
        {

            BEGIN { $^H = 0; };                           # cheap no strict to allow for ref copy

            $self-&gt;{&#039;native_data&#039;} = {
                &#039;VERSION&#039;      =&gt; \${&quot;$class\::DB::Native::VERSION&quot;},
                &#039;cldr_version&#039; =&gt; \${&quot;$class\::DB::Native::cldr_version&quot;},
                &#039;code_to_name&#039; =&gt; \%{&quot;$class\::DB::Native::code_to_name&quot;},
            };
        }
    }

    $code ||= $self-&gt;{&#039;locale&#039;};
    $code = normalize_tag($code);
    return if !defined $code;

    $always_return ||= 1 if $code eq $self-&gt;get_locale() &amp;&amp; $self-&gt;get_soft_locale_fallback();    # force $always_return under soft locale objects
    $always_return ||= 0;

    if ( exists $self-&gt;{&#039;native_data&#039;}{&#039;code_to_name&#039;}{$code} ) {
        return $self-&gt;{&#039;native_data&#039;}{&#039;code_to_name&#039;}{$code};
    }
    elsif ($always_return) {
        my ( $l, $t ) = split_tag($code);
        my $ln = $self-&gt;{&#039;native_data&#039;}{&#039;code_to_name&#039;}{$l};

        $self-&gt;_load_territory_data() if !$self-&gt;{&#039;territory_data&#039;};

        my $tn = defined $t ? $self-&gt;{&#039;territory_data&#039;}{&#039;code_to_name&#039;}{$t} : &#039;&#039;;

        return $code if !$ln &amp;&amp; !$tn;

        if ( defined $t ) {
            my $tmp = Cpanel::CPAN::Locales-&gt;new($l);    # if we even get to this point: this is a singleton so it is cheap
            if ($tmp) {
                if ( $tmp-&gt;get_territory_from_code($t) ) {
                    $tn = $tmp-&gt;get_territory_from_code($t);
                }
            }
        }

        $ln ||= $l;
        $tn ||= $t;

        my $string = get_locale_display_pattern_from_code_fast($code) || $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;locale&#039;} || &#039;{0} ({1})&#039;;

        substr( $string, index( $string, &#039;{0}&#039; ), 3, $ln ) while index( $string, &#039;{0}&#039; ) &gt; -1;
        substr( $string, index( $string, &#039;{1}&#039; ), 3, $tn ) while index( $string, &#039;{1}&#039; ) &gt; -1;

        return $string;
    }
    return;
}

sub numf {
    require Cpanel::CPAN::Locales::Legacy if !$INC{&#039;Cpanel/CPAN/Locales/Legacy.pm&#039;};
    *numf = *Cpanel::CPAN::Locales::Legacy::numf;
    goto \&amp;Cpanel::CPAN::Locales::Legacy::numf;
}

my $get_locale_display_pattern_from_code_fast = 0;

sub get_locale_display_pattern_from_code_fast {
    if ( !$get_locale_display_pattern_from_code_fast ) {
        $get_locale_display_pattern_from_code_fast++;
        require Cpanel::CPAN::Locales::DB::LocaleDisplayPattern::Tiny;
    }

    if ( @_ == 1 &amp;&amp; ref( $_[0] ) ) {
        return Cpanel::CPAN::Locales::DB::LocaleDisplayPattern::Tiny::get_locale_display_pattern( $_[0]-&gt;get_locale() );
    }
    return Cpanel::CPAN::Locales::DB::LocaleDisplayPattern::Tiny::get_locale_display_pattern( $_[-1] );    # last arg so it works as function or class method or object method
}

sub get_locale_display_pattern_from_code {
    my ( $self, $code, $always_return ) = @_;

    my $class = ref($self) ? ref($self) : $self;
    if ( !exists $self-&gt;{&#039;locale_display_pattern_data&#039;} ) {
        local $SIG{&#039;__DIE__&#039;};                                                                             # cpanel specific: ensure a benign eval does not trigger cpsrvd&#039;s DIE handler (may be made moot by internal case 50857)
        eval &quot;require $class\::DB::LocaleDisplayPattern;&quot; || return;                                       # Module::Want::have_mod(&quot;$class\::DB::LocaleDisplayPattern&quot;);

        {

            BEGIN { $^H = 0; };                                                                            # cheap no strict to allow for ref copy

            $self-&gt;{&#039;locale_display_pattern_data&#039;} = {
                &#039;VERSION&#039;         =&gt; \${&quot;$class\::DB::LocaleDisplayPattern::VERSION&quot;},
                &#039;cldr_version&#039;    =&gt; \${&quot;$class\::DB::LocaleDisplayPattern::cldr_version&quot;},
                &#039;code_to_pattern&#039; =&gt; \%{&quot;$class\::DB::LocaleDisplayPattern::code_to_pattern&quot;},
            };
        }
    }

    $code ||= $self-&gt;{&#039;locale&#039;};
    $code = normalize_tag($code);
    return if !defined $code;

    $always_return ||= 1 if $code eq $self-&gt;get_locale() &amp;&amp; $self-&gt;get_soft_locale_fallback();    # force $always_return under soft locale objects
    $always_return ||= 0;

    if ( exists $self-&gt;{&#039;locale_display_pattern_data&#039;}{&#039;code_to_pattern&#039;}{$code} ) {
        return $self-&gt;{&#039;locale_display_pattern_data&#039;}{&#039;code_to_pattern&#039;}{$code};
    }
    elsif ($always_return) {
        my ( $l, $t ) = split_tag($code);
        if ( exists $self-&gt;{&#039;locale_display_pattern_data&#039;}{&#039;code_to_pattern&#039;}{$l} ) {
            return $self-&gt;{&#039;locale_display_pattern_data&#039;}{&#039;code_to_pattern&#039;}{$l};
        }
        return &#039;{0} ({1})&#039;;
    }
    return;
}

my $get_character_orientation_from_code_fast = 0;

sub get_character_orientation_from_code_fast {
    if ( !$get_character_orientation_from_code_fast ) {
        $get_character_orientation_from_code_fast++;
        require Cpanel::CPAN::Locales::DB::CharacterOrientation::Tiny;
    }

    if ( @_ == 1 &amp;&amp; ref( $_[0] ) ) {
        return Cpanel::CPAN::Locales::DB::CharacterOrientation::Tiny::get_orientation( $_[0]-&gt;get_locale() );
    }

    return Cpanel::CPAN::Locales::DB::CharacterOrientation::Tiny::get_orientation( $_[-1] );    # last arg so it works as function or class method or object method
}

sub get_character_orientation_from_code {
    my ( $self, $code, $always_return ) = @_;

    my $class = ref($self) ? ref($self) : $self;
    if ( !exists $self-&gt;{&#039;character_orientation_data&#039;} ) {
        local $SIG{&#039;__DIE__&#039;};                                                                  # cpanel specific: ensure a benign eval does not trigger cpsrvd&#039;s DIE handler (may be made moot by internal case 50857)
        eval &quot;require $class\::DB::CharacterOrientation;&quot; || return;                            # Module::Want::have_mod(&quot;$class\::DB::CharacterOrientation&quot;);
        {

            BEGIN { $^H = 0; };                                                                 # cheap no strict to allow for ref copy

            $self-&gt;{&#039;character_orientation_data&#039;} = {
                &#039;VERSION&#039;      =&gt; \${&quot;$class\::DB::CharacterOrientation::VERSION&quot;},
                &#039;cldr_version&#039; =&gt; \${&quot;$class\::DB::CharacterOrientation::cldr_version&quot;},
                &#039;code_to_name&#039; =&gt; \%{&quot;$class\::DB::CharacterOrientation::code_to_name&quot;},
            };
        }
    }

    $code ||= $self-&gt;{&#039;locale&#039;};
    $code = normalize_tag($code);
    return if !defined $code;

    $always_return ||= 1 if $code eq $self-&gt;get_locale() &amp;&amp; $self-&gt;get_soft_locale_fallback();    # force $always_return under soft locale objects
    $always_return ||= 0;

    if ( exists $self-&gt;{&#039;character_orientation_data&#039;}{&#039;code_to_name&#039;}{$code} ) {
        return $self-&gt;{&#039;character_orientation_data&#039;}{&#039;code_to_name&#039;}{$code};
    }
    elsif ($always_return) {
        my ( $l, $t ) = split_tag($code);
        if ( exists $self-&gt;{&#039;character_orientation_data&#039;}{&#039;code_to_name&#039;}{$l} ) {
            return $self-&gt;{&#039;character_orientation_data&#039;}{&#039;code_to_name&#039;}{$l};
        }
        return &#039;left-to-right&#039;;
    }
    return;
}

sub get_plural_form_categories {
    return @{ $_[0]-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;plural_forms&#039;}{&#039;category_list&#039;} };
}

sub supports_special_zeroth {
    return 1 if $_[0]-&gt;get_plural_form(0) eq &#039;other&#039;;
    return;
}

sub plural_category_count {
    return scalar( $_[0]-&gt;get_plural_form_categories() );
}

sub get_plural_form {
    my ( $self, $n, @category_values ) = @_;
    my $category;
    my $has_extra_for_zero = 0;

    my $abs_n = abs($n);    # negatives keep same category as positive

    if ( !$self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;plural_forms&#039;}{&#039;category_rules_function&#039;} ) {
        $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;plural_forms&#039;}{&#039;category_rules_function&#039;} = Cpanel::CPAN::Locales::plural_rule_hashref_to_code( $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;plural_forms&#039;} );
        if ( !defined $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;plural_forms&#039;}{&#039;category_rules_function&#039;} ) {
            require Carp;
            Carp::carp(&quot;Could not determine plural logic.&quot;);
        }
    }

    $category = $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;plural_forms&#039;}{&#039;category_rules_function&#039;}-&gt;($abs_n);

    my @categories = $self-&gt;get_plural_form_categories();

    if ( !@category_values ) {

        @category_values = @categories;
    }
    else {
        my $cat_len = @categories;
        my $val_len = @category_values;
        if ( $val_len == ( $cat_len + 1 ) ) {
            $has_extra_for_zero++;
        }
        elsif ( $cat_len != $val_len &amp;&amp; $self-&gt;{&#039;verbose&#039;} ) {
            require Carp;
            Carp::carp(&quot;The number of given values ($val_len) does not match the number of categories ($cat_len).&quot;);
        }
    }

    if ( !defined $category ) {
        my $cat_idx = $has_extra_for_zero &amp;&amp; $abs_n != 0 ? -2 : -1;
        return wantarray ? ( $category_values[$cat_idx], $has_extra_for_zero &amp;&amp; $abs_n == 0 ? 1 : 0 ) : $category_values[$cat_idx];
    }
    else {
      GET_POSITION:
        my $cat_pos_in_list;
        my $index = -1;
      CATEGORY:
        for my $cat (@categories) {
            $index++;
            if ( $cat eq $category ) {
                $cat_pos_in_list = $index;
                last CATEGORY;
            }
        }

        if ( !defined $cat_pos_in_list &amp;&amp; $category ne &#039;other&#039; ) {
            require Carp;
            Carp::carp(&quot;The category ($category) is not used by this locale.&quot;);
            $category = &#039;other&#039;;
            goto GET_POSITION;
        }
        elsif ( !defined $cat_pos_in_list ) {
            my $cat_idx = $has_extra_for_zero &amp;&amp; $abs_n != 0 ? -2 : -1;
            return wantarray ? ( $category_values[$cat_idx], $has_extra_for_zero &amp;&amp; $abs_n == 0 ? 1 : 0 ) : $category_values[$cat_idx];
        }
        else {
            if ( $has_extra_for_zero &amp;&amp; $category eq &#039;other&#039; ) {    # and &#039;other&#039; is at the end of the list? nah...  &amp;&amp; $cat_pos_in_list + 1 == $#category_values
                my $cat_idx = $has_extra_for_zero &amp;&amp; $abs_n == 0 ? -1 : $cat_pos_in_list;
                return wantarray ? ( $category_values[$cat_idx], $has_extra_for_zero &amp;&amp; $abs_n == 0 ? 1 : 0 ) : $category_values[$cat_idx];
            }
            else {
                return wantarray ? ( $category_values[$cat_pos_in_list], 0 ) : $category_values[$cat_pos_in_list];
            }
        }
    }
}

sub _quote_get_list_items {
    my ( $self, $items_ar ) = @_;

    my $cnt = 0;

    if ( exists $self-&gt;{&#039;misc&#039;}{&#039;list_quote_mode&#039;} &amp;&amp; $self-&gt;{&#039;misc&#039;}{&#039;list_quote_mode&#039;} ne &#039;none&#039; ) {
        if ( $self-&gt;{&#039;misc&#039;}{&#039;list_quote_mode&#039;} eq &#039;all&#039; ) {
            @{$items_ar} = (&#039;&#039;) if @{$items_ar} == 0;

            for my $i ( 0 .. scalar( @{$items_ar} ) - 1 ) {
                $items_ar-&gt;[$i] = &#039;&#039; if !defined $items_ar-&gt;[$i];
                $items_ar-&gt;[$i] = $self-&gt;quote( $items_ar-&gt;[$i] );
                $cnt++;
            }
        }
        elsif ( $self-&gt;{&#039;misc&#039;}{&#039;list_quote_mode&#039;} eq &#039;some&#039; ) {
            @{$items_ar} = (&#039;&#039;) if @{$items_ar} == 0;

            for my $i ( 0 .. scalar( @{$items_ar} ) - 1 ) {
                $items_ar-&gt;[$i] = &#039;&#039; if !defined $items_ar-&gt;[$i];
                if ( $items_ar-&gt;[$i] eq &#039;&#039; || $items_ar-&gt;[$i] eq &#039; &#039; || $items_ar-&gt;[$i] eq &quot;\xc2\xa0&quot; ) {
                    $items_ar-&gt;[$i] = $self-&gt;quote( $items_ar-&gt;[$i] );
                    $cnt++;
                }
            }
        }
        else {
            require Carp;
            Carp::carp(&#039;$self-&gt;{misc}{list_quote_mode} is set to an unknown value&#039;);
        }
    }

    return $cnt;
}

sub get_list_and {
    my $self = shift;

    return $self-&gt;_get_list_joined(
        $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;list&#039;},
        @_,
    );
}

sub get_list_or {
    my $self = shift;

    return $self-&gt;_get_list_joined(
        $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;list_or&#039;},
        @_,
    );
}

sub _get_list_joined {
    my ( $self, $templates_hr, @items ) = @_;

    $self-&gt;_quote_get_list_items( \@items );

    return if !@items;
    return $items[0] if @items == 1;

    my $ix;    # used to cache index results in the following oneliner

    if ( @items == 2 ) {
        my $two = $templates_hr-&gt;{&#039;2&#039;};
        substr( $two, $ix, 3, $items[0] ) while ( $ix = index( $two, &#039;{0}&#039; ) ) &gt; -1;
        substr( $two, $ix, 3, $items[1] ) while ( $ix = index( $two, &#039;{1}&#039; ) ) &gt; -1;
        return $two;
    }
    else {
        for (@items) {
            next if !defined $_;
            substr( $_, $ix, 3, &#039;__{__0__}__&#039; ) while ( $ix = index( $_, &#039;{0}&#039; ) ) &gt; -1;
            substr( $_, $ix, 3, &#039;__{__1__}__&#039; ) while ( $ix = index( $_, &#039;{1}&#039; ) ) &gt; -1;
        }
        my $aggregate = $templates_hr-&gt;{&#039;start&#039;};
        substr( $aggregate, $ix, 3, $items[0] ) while ( $ix = index( $aggregate, &#039;{0}&#039; ) ) &gt; -1;
        substr( $aggregate, $ix, 3, $items[1] ) while ( $ix = index( $aggregate, &#039;{1}&#039; ) ) &gt; -1;

        for my $i ( 2 .. $#items ) {
            next if $i == $#items;
            my $middle = $templates_hr-&gt;{&#039;middle&#039;};
            substr( $middle, $ix, 3, $aggregate ) while ( $ix = index( $middle, &#039;{0}&#039; ) ) &gt; -1;
            my $item = defined $items[$i] ? $items[$i] : &#039;&#039;;
            substr( $middle, $ix, 3, $item ) while ( $ix = index( $middle, &#039;{1}&#039; ) ) &gt; -1;
            $aggregate = $middle;
        }

        my $end = $templates_hr-&gt;{&#039;end&#039;};
        substr( $end, $ix, 3, $aggregate ) while ( $ix = index( $end, &#039;{0}&#039; ) ) &gt; -1;
        substr( $end, $ix, 3, $items[-1] ) while ( $ix = index( $end, &#039;{1}&#039; ) ) &gt; -1;

        substr( $end, $ix, 11, &#039;{0}&#039; ) while ( $ix = index( $end, &#039;__{__0__}__&#039; ) ) &gt; -1;
        substr( $end, $ix, 11, &#039;{1}&#039; ) while ( $ix = index( $end, &#039;__{__1__}__&#039; ) ) &gt; -1;

        return $end;
    }
}

sub quote {
    my ( $self, $value ) = @_;
    $value = &#039;&#039; if !defined $value;

    return $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;delimiters&#039;}{&#039;quotation_start&#039;} . $value . $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;delimiters&#039;}{&#039;quotation_end&#039;};
}

sub quote_alt {
    my ( $self, $value ) = @_;
    $value = &#039;&#039; if !defined $value;

    return $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;delimiters&#039;}{&#039;alternate_quotation_start&#039;} . $value . $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;delimiters&#039;}{&#039;alternate_quotation_end&#039;};
}

sub get_formatted_ellipsis_initial {
    my ( $self, $str ) = @_;
    my $pattern = $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;ellipsis&#039;}{&#039;initial&#039;} || &#039;…{0}&#039;;
    substr( $pattern, index( $pattern, &#039;{0}&#039; ), 3, $str ) while index( $pattern, &#039;{0}&#039; ) &gt; -1;
    return $pattern;
}

sub get_formatted_ellipsis_medial {
    my ($self) = @_;    # my ($self, $first, $second) = @_;
    my $pattern = $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;ellipsis&#039;}{&#039;medial&#039;} || &#039;{0}…{1}&#039;;

    substr( $pattern, index( $pattern, &#039;{0}&#039; ), 3, $_[1] ) while index( $pattern, &#039;{0}&#039; ) &gt; -1;
    substr( $pattern, index( $pattern, &#039;{1}&#039; ), 3, $_[2] ) while index( $pattern, &#039;{1}&#039; ) &gt; -1;
    return $pattern;
}

sub get_formatted_ellipsis_final {
    my ( $self, $str ) = @_;
    my $pattern = $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;ellipsis&#039;}{&#039;final&#039;} || &#039;{0}…&#039;;
    substr( $pattern, index( $pattern, &#039;{0}&#039; ), 3, $str ) while index( $pattern, &#039;{0}&#039; ) &gt; -1;
    return $pattern;
}


sub get_formatted_decimal {
    my ( $self, $n, $max_decimal_places, $_my_pattern ) = @_;    # $_my_pattern not documented on purpose, it is only intended for internal use, and may dropepd/changed at any time


    return if !defined $n;


    my $is_negative = $n &lt; 0 ? 1 : 0;

    my $max_len = defined $max_decimal_places ? abs( int($max_decimal_places) ) : 6;    # %f default is 6
    $max_len = 14 if $max_len &gt; 14;

    if ( $n &gt; 10_000_000_000 || $n &lt; -10_000_000_000 ) {

        return $n if $n =~ tr/Ee//;                                                     # poor man&#039;s is exponential check.


        if ( $n =~ m/\.([0-9]{$max_len})([0-9])?/ ) {
            my $trim = $1;    # (defined $2 &amp;&amp; $2 &gt; 4) ? $1 + 1 : $1;

            if ( defined $2 &amp;&amp; $2 &gt; 4 ) {
                if ( ( $trim + 1 ) !~ tr/Ee// ) {    # poor man&#039;s is exponential check.
                    $trim++;
                }
            }

            $n =~ s/$FORCE_REGEX_LAZY\.[0-9]+/\.$trim/o;
        }
    }
    else {
        return $n if length $n &lt; 3 &amp;&amp; $n !~ tr{0-9}{}c;

        $n = sprintf( &#039;%.&#039; . $max_len . &#039;f&#039;, $n );

        return $n if $n =~ tr/Ee//;    # poor man&#039;s is exponential check.
    }

    $n =~ s{$FORCE_REGEX_LAZY([^0-9]+[0-9]*?[1-9])0+$}{$1}o;
    $n =~ s{$FORCE_REGEX_LAZY[^0-9]+0+$}{}o;

    if ( $n =~ tr{.0-9}{}c ) {    # Only strip signs if the string has non-numeric and &#039;.&#039; characters such as &#039;+&#039; or &#039;-&#039;
        substr( $n, 0, 1, &#039;&#039; ) while substr( $n, 1 ) =~ tr{0-9}{}c;
    }

    my $cldr_formats = $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;};

    my $format = $_my_pattern || $cldr_formats-&gt;{&#039;decimal&#039;};    # from http://unicode.org/repos/cldr-tmp/trunk/diff/by_type/number.pattern.html

    my ( $zero_positive_pat, $negative_pat, $err ) = split( /$FORCE_REGEX_LAZY(?&lt;!\&#039;)\;(?!\&#039;)/o, $format );    # semi-colon that is not literal (?&lt;!\&#039;)\;(?!\&#039;)

    if ($err) {
        require Carp;
        Carp::carp(&quot;Format had more than 2 pos/neg sections. Using default pattern.&quot;);
        $format = &#039;#,##0.###&#039;;
    }
    elsif ( $is_negative &amp;&amp; $negative_pat ) {
        $format = $negative_pat;
    }
    elsif ($zero_positive_pat) {
        $format = $zero_positive_pat;
    }

    my $dec_sec_cnt = 0;
    if ( index( $format, q{&#039;} ) == -1 ) {
        $dec_sec_cnt = $format =~ tr{\.}{};
    }
    else {
        $dec_sec_cnt++ while ( $format =~ m/$FORCE_REGEX_LAZY(?&lt;!\&#039;)\.(?!\&#039;)/og );
    }

    if ( $dec_sec_cnt != 1 ) {
        require Carp;
        Carp::carp(&quot;Format should have one decimal section. Using default pattern.&quot;);
        $format = &#039;#,##0.###&#039;;
    }

    if ( !length $format || $format !~ tr{ \t\r\n\f}{}c ) {
        require Carp;
        Carp::carp(&quot;Format is empty. Using default pattern.&quot;);
        $format = &#039;#,##0.###&#039;;
    }


    my $result = &#039;&#039;;

    if ( $format eq &#039;#,##0.###&#039; ) {
        $result = $n;
        if ( $n =~ tr{0-9}{} &gt; 3 ) {
            while ( $result =~ s/$FORCE_REGEX_LAZY^([-+]?\d+)(\d{3})/$1,$2/os ) { 1 }    # right from perlfaq5
        }
    }
    else {


        my ( $integer, $decimals ) = split( /\./, $n, 2 );

        my ( $i_pat, $d_pat ) = split( /$FORCE_REGEX_LAZY(?&lt;!\&#039;)\.(?!\&#039;)/o, $format, 2 );
        my ( $cur_idx, $trailing_non_n, $cur_d, $cur_pat ) = ( 0, &#039;&#039; );    # buffer

        my @i_pat = reverse( split( /$FORCE_REGEX_LAZY(?&lt;!\&#039;)\,(?!\&#039;)/o, $i_pat ) );

        my $next_to_last_pattern = @i_pat == 1 ? $i_pat[0] : $i_pat[-2];
        substr( $next_to_last_pattern, -1, 1, &#039;#&#039; ) if substr( $next_to_last_pattern, -1 ) eq &#039;0&#039;;
        while ( $i_pat[0] =~ s/$FORCE_REGEX_LAZY((?:\&#039;.\&#039;)+)$//o || $i_pat[0] =~ s/$FORCE_REGEX_LAZY([^0#]+)$//o ) {
            $trailing_non_n = &quot;$1$trailing_non_n&quot;;
        }


        while ( CORE::length( $cur_d = CORE::substr( $integer, -1, 1, &#039;&#039; ) ) ) {


            if ( $cur_idx == $#i_pat &amp;&amp; !CORE::length( $i_pat[$cur_idx] ) ) {
                $i_pat[$cur_idx] = $next_to_last_pattern;
            }

            if ( !CORE::length( $i_pat[$cur_idx] ) ) {    # this chunk is spent
                if ( defined $i_pat[ $cur_idx + 1 ] ) {    # there are more chunks ...
                    $cur_idx++;                            # ... next chunk please
                }
            }

            if ( CORE::length( $i_pat[$cur_idx] ) ) {

                if ( substr( $i_pat[$cur_idx], -3 ) eq q{&#039;,&#039;} ) {
                    $result = CORE::substr( $i_pat[$cur_idx], -3, 3, &#039;&#039; ) . $result;
                    redo;
                }

                $cur_pat = CORE::substr( $i_pat[$cur_idx], -1, 1, &#039;&#039; );

                if ( $cur_pat ne &#039;0&#039; &amp;&amp; $cur_pat ne &#039;#&#039; ) {
                    $result = &quot;$cur_pat$result&quot;;
                    redo;
                }
            }

            $result = !CORE::length( $i_pat[$cur_idx] ) &amp;&amp; @i_pat != 1 ? &quot;,$cur_d$result&quot; : &quot;$cur_d$result&quot;;

            if ( $cur_idx == $#i_pat - 1 &amp;&amp; $i_pat[$#i_pat] eq &#039;#&#039; &amp;&amp; !CORE::length( $i_pat[$cur_idx] ) ) {
                $cur_idx++;
                $i_pat[$cur_idx] = $next_to_last_pattern;
            }
        }
        if ( CORE::length( $i_pat[$cur_idx] ) ) {
            $i_pat[$cur_idx] =~ s/$FORCE_REGEX_LAZY(?&lt;!\&#039;)\#(?!\&#039;)//og;    # remove any left over non-literal #
            $result = $result . $i_pat[$cur_idx];        # prepend it (e.g. 0 and -)
        }
        if ( substr( $result, 0, 1 ) eq &#039;,&#039; ) {
            substr( $result, 0, 1, &#039;&#039; );
        }
        $result .= $trailing_non_n;

        if ( defined $decimals &amp;&amp; CORE::length($decimals) ) {

            my @d_pat = ($d_pat);                        # TODO ? support sepeartor in decimal, !definedvia CLDR, no patterns have that ATM ? split( /(?&lt;!\&#039;)\,(?!\&#039;)/, $d_pat );

            $result .= &#039;.&#039;;
            $cur_idx        = 0;
            $trailing_non_n = &#039;&#039;;

            while ( $d_pat[-1] =~ s/$FORCE_REGEX_LAZY((?:\&#039;.\&#039;)+)$//o || $d_pat[-1] =~ s/$FORCE_REGEX_LAZY([^0#]+)$//o ) {
                $trailing_non_n = &quot;$1$trailing_non_n&quot;;
            }


            while ( CORE::length( $cur_d = CORE::substr( $decimals, 0, 1, &#039;&#039; ) ) ) {


                if ( !CORE::length( $d_pat[$cur_idx] ) ) {    # this chunk is spent
                    if ( !defined $d_pat[ $cur_idx + 1 ] ) {    # there are no more chunks
                        $cur_pat = &#039;#&#039;;
                    }
                    else {                                      # next chunk please
                        $result .= &#039;,&#039;;
                        $cur_idx++;
                    }
                }

                if ( CORE::length( $d_pat[$cur_idx] ) ) {

                    if ( index( $d_pat[$cur_idx], q{&#039;.&#039;} ) == 0 ) {
                        $result .= CORE::substr( $d_pat[$cur_idx], 0, 3, &#039;&#039; );
                        redo;
                    }
                    $cur_pat = CORE::substr( $d_pat[$cur_idx], 0, 1, &#039;&#039; );
                    if ( $cur_pat ne &#039;0&#039; &amp;&amp; $cur_pat ne &#039;#&#039; ) {
                        $result .= $cur_pat;
                        redo;
                    }
                }

                $result .= $cur_d;
            }
            if ( substr( $result, -1, ) eq &#039;,&#039; ) {
                chop($result);
            }
            if ( defined $d_pat[$cur_idx] ) {
                $d_pat[$cur_idx] =~ s/$FORCE_REGEX_LAZY(?&lt;!\&#039;)\#(?!\&#039;)//og;    # remove any left over non-literal #
                $result .= $d_pat[$cur_idx];                 # append it (e.g. 0 and -)
            }
            $result .= $trailing_non_n;
        }

    }

    my $used_place_holder = $cldr_formats-&gt;{_decimal_format_decimal} ne &#039;.&#039; &amp;&amp; index( $result, &#039;.&#039; ) &gt; -1 &amp;&amp; $result =~ s/$FORCE_REGEX_LAZY(?&lt;!\&#039;)\.(?!\&#039;)/_LOCALES-DECIMAL-PLACEHOLDER_/g;

    if ( $cldr_formats-&gt;{_decimal_format_group} ne &#039;,&#039; &amp;&amp; index( $result, &#039;,&#039; ) &gt; -1 ) {
        $result =~ s/$FORCE_REGEX_LAZY(?&lt;!\&#039;)\,(?!\&#039;)/$cldr_formats-&gt;{_decimal_format_group}/og;
    }
    if ($used_place_holder) {
        my $ix;
        substr( $result, $ix, 29, $cldr_formats-&gt;{_decimal_format_decimal} ) while ( $ix = index( $result, &#039;_LOCALES-DECIMAL-PLACEHOLDER_&#039; ) ) &gt; -1;
    }


    if ( $is_negative &amp;&amp; !$negative_pat ) {

        $result = &quot;-$result&quot;;
    }

    return $result;
}


sub get_territory_codes {
    $_[0]-&gt;_load_territory_data() if !$_[0]-&gt;{&#039;territory_data&#039;};

    return keys %{ shift-&gt;{&#039;territory_data&#039;}{&#039;code_to_name&#039;} };
}

sub get_territory_names {
    $_[0]-&gt;_load_territory_data() if !$_[0]-&gt;{&#039;territory_data&#039;};

    return values %{ shift-&gt;{&#039;territory_data&#039;}{&#039;code_to_name&#039;} };
}

sub get_territory_lookup {
    $_[0]-&gt;_load_territory_data() if !$_[0]-&gt;{&#039;territory_data&#039;};

    return %{ shift-&gt;{&#039;territory_data&#039;}{&#039;code_to_name&#039;} };
}

sub get_territory_from_code {
    my ( $self, $code, $always_return ) = @_;

    $code ||= $self-&gt;{&#039;territory&#039;};
    $code = normalize_tag($code);
    return if !defined $code;

    $self-&gt;_load_territory_data() if !$self-&gt;{&#039;territory_data&#039;};

    if ( exists $self-&gt;{&#039;territory_data&#039;}{&#039;code_to_name&#039;}{$code} ) {
        return $self-&gt;{&#039;territory_data&#039;}{&#039;code_to_name&#039;}{$code};
    }
    elsif ( !defined $self-&gt;{&#039;territory&#039;} || $code ne $self-&gt;{&#039;territory&#039;} ) {
        my ( $l, $t ) = split_tag($code);
        if ( $t &amp;&amp; exists $self-&gt;{&#039;territory_data&#039;}{&#039;code_to_name&#039;}{$t} ) {
            return $self-&gt;{&#039;territory_data&#039;}{&#039;code_to_name&#039;}{$t};
        }
    }
    return $code if $always_return;
    return;
}

sub get_code_from_territory {
    my ( $self, $name ) = @_;
    return if !$name;
    my $key = normalize_for_key_lookup($name);

    $self-&gt;_load_territory_data() if !$self-&gt;{&#039;territory_data&#039;};

    if ( !$self-&gt;{&#039;territory_data&#039;}{&#039;nam&#039;} ) {
        $self-&gt;{&#039;territory_data&#039;}{&#039;name_to_code&#039;} = { map { normalize_for_key_lookup( $self-&gt;{&#039;territory_data&#039;}{&#039;code_to_name&#039;}-&gt;{$_} ) =&gt; $_ } keys %{ $self-&gt;{&#039;territory_data&#039;}{&#039;code_to_name&#039;} } };
    }
    if ( exists $self-&gt;{&#039;territory_data&#039;}{&#039;name_to_code&#039;}{$key} ) {
        return $self-&gt;{&#039;territory_data&#039;}{&#039;name_to_code&#039;}{$key};
    }
    return;
}

{
    no warnings &#039;once&#039;;
    *code2territory = *get_territory_from_code;
    *territory2code = *get_code_from_territory;
}


sub get_language_codes {
    $_[0]-&gt;_load_language_data_code_to_name() if !$_[0]-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;};
    return keys %{ $_[0]-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;} };
}

sub get_language_names {
    $_[0]-&gt;_load_language_data_code_to_name() if !$_[0]-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;};
    return values %{ $_[0]-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;} };
}

sub get_language_lookup {
    $_[0]-&gt;_load_language_data_code_to_name() if !$_[0]-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;};
    return %{ $_[0]-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;} };
}

sub get_language_from_code {
    my ( $self, $code, $always_return ) = @_;

    $code ||= $self-&gt;{&#039;locale&#039;};
    $code = normalize_tag($code);
    return if !defined $code;

    $always_return ||= 1 if $code eq $self-&gt;get_locale() &amp;&amp; $self-&gt;get_soft_locale_fallback();    # force $always_return under soft locale objects
    $always_return ||= 0;

    $self-&gt;_load_language_data_code_to_name() if !$_[0]-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;};
    if ( exists $self-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;}{$code} ) {
        return $self-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;}{$code};
    }
    elsif ($always_return) {
        $self-&gt;_load_territory_data() if !$self-&gt;{&#039;territory_data&#039;};

        my ( $l, $t ) = split_tag($code);
        my $ln = $self-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;}{$l};
        my $tn = defined $t ? $self-&gt;{&#039;territory_data&#039;}{&#039;code_to_name&#039;}{$t} : &#039;&#039;;

        return $code if !$ln &amp;&amp; !$tn;
        $ln ||= $l;
        $tn ||= $t;

        my $string = $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;locale&#039;} || &#039;{0} ({1})&#039;;

        substr( $string, index( $string, &#039;{0}&#039; ), 3, $ln ) while index( $string, &#039;{0}&#039; ) &gt; -1;
        substr( $string, index( $string, &#039;{1}&#039; ), 3, $tn ) while index( $string, &#039;{1}&#039; ) &gt; -1;

        return $string;
    }
    return;
}

sub get_code_from_language {
    my ( $self, $name ) = @_;
    return if !$name;
    my $key = normalize_for_key_lookup($name);

    $self-&gt;_load_language_data_code_to_name() if !$_[0]-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;};
    if ( !$self-&gt;{&#039;language_data&#039;}{&#039;name_to_code&#039;} ) {
        $self-&gt;{&#039;language_data&#039;}{&#039;name_to_code&#039;} = { map { normalize_for_key_lookup( $self-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;}-&gt;{$_} ) =&gt; $_ } keys %{ $self-&gt;{&#039;language_data&#039;}{&#039;code_to_name&#039;} } };
    }

    if ( exists $self-&gt;{&#039;language_data&#039;}{&#039;name_to_code&#039;}{$key} ) {
        return $self-&gt;{&#039;language_data&#039;}{&#039;name_to_code&#039;}{$key};
    }
    return;
}

{
    no warnings &#039;once&#039;;
    *code2language = *get_language_from_code;
    *language2code = *get_code_from_language;
}


sub tag_is_soft_locale {
    my ($tag) = @_;
    my ( $l, $t ) = split_tag($tag);

    return if !defined $l;    # invalid tag is not soft

    return if !$t;                             # no territory part means it is not soft
    return if tag_is_loadable($tag);           # if it can be loaded directly then it is not soft
    return if !territory_code_is_known($t);    # if the territory part is not known then it is not soft
    return if !tag_is_loadable($l);            # if the language part is not known then it is not soft
    return $l;                                 # it is soft, so return the value suitable for &#039;soft_locale_fallback&#039;
}

sub tag_is_loadable {
    my ( $tag, $as_territory ) = @_;           # not documenting internal $as_territory, just use territory_code_is_known() directly

    if ( !exists $INC{&quot;Cpanel/CPAN/Locales/DB/Loadable.pm&quot;} ) {
        local $SIG{&#039;__DIE__&#039;};                 # cpanel specific: ensure a benign eval does not trigger cpsrvd&#039;s DIE handler (may be made moot by internal case 50857)
        eval &quot;require Cpanel::CPAN::Locales::DB::Loadable&quot; || return;    # Module::Want::have_mod(&quot;Cpanel::CPAN::Locales::DB::Loadable&quot;) || return;
    }

    if ($as_territory) {
        no warnings &#039;once&#039;;
        return 1 if exists $Cpanel::CPAN::Locales::DB::Loadable::territory{$tag};
    }
    else {
        return 1 if exists $Cpanel::CPAN::Locales::DB::Loadable::code{$tag};
    }

    return;
}

sub get_loadable_language_codes {
    if ( !exists $INC{&quot;Cpanel/CPAN/Locales/DB/Loadable.pm&quot;} ) {
        local $SIG{&#039;__DIE__&#039;};    # cpanel specific: ensure a benign eval does not trigger cpsrvd&#039;s DIE handler (may be made moot by internal case 50857)
        eval &quot;require Cpanel::CPAN::Locales::DB::Loadable&quot; || return;    # Module::Want::have_mod(&quot;Cpanel::CPAN::Locales::DB::Loadable&quot;) || return;
    }

    return keys %Cpanel::CPAN::Locales::DB::Loadable::code;
}

sub territory_code_is_known {
    return tag_is_loadable( $_[0], 1 );
}

sub split_tag {
    return split( /_/, normalize_tag( $_[0] ), 2 );                      # we only do language[_territory]
}

sub get_i_tag_for_string {
    my $norm = normalize_tag( $_[0] );

    if ( substr( $norm, 0, 2 ) eq &#039;i_&#039; ) {
        return $norm;
    }
    else {
        return &#039;i_&#039; . $norm;
    }
}

my %non_locales = (
    &#039;und&#039; =&gt; 1,
    &#039;zxx&#039; =&gt; 1,
    &#039;mul&#039; =&gt; 1,
    &#039;mis&#039; =&gt; 1,
    &#039;art&#039; =&gt; 1,
);

sub non_locale_list {
    return ( sort keys %non_locales );
}

sub is_non_locale {
    my $tag = normalize_tag( $_[0] ) || return;
    return 1 if exists $non_locales{$tag};
    return;
}

sub typical_en_alias_list {
    return ( &#039;en_us&#039;, &#039;i_default&#039; );
}

sub is_typical_en_alias {
    my $tag = normalize_tag( $_[0] ) || return;
    return 1 if $tag eq &#039;en_us&#039; || $tag eq &#039;i_default&#039;;
    return;
}

sub normalize_tag_for_datetime_locale {
    my ( $pre, $pst ) = split_tag( $_[0] );    # we only do language[_territory]
    return if !defined $pre;

    if ($pst) {
        return $pre . &#039;_&#039; . uc($pst);
    }
    else {
        return $pre;
    }
}

sub normalize_tag_for_ietf {
    my ( $pre, $pst ) = split_tag( $_[0] );    # we only do language[_territory]
    return if !defined $pre;

    if ($pst) {
        return $pre . &#039;-&#039; . uc($pst);
    }
    else {
        return $pre;
    }
}

sub normalize_for_key_lookup {
    my $key = $_[0];
    return &#039;&#039; if !defined $key;
    $key =~ tr/A-Z/a-z/;                            # lowercase
    $key =~ s{\s+}{}g if $key =~ tr{ \t\r\n\f}{};
    $key =~ tr{\&#039;\&quot;\-\(\)\[\]\_}{}d;
    return $key;
}

sub plural_rule_string_to_javascript_code {
    require Cpanel::CPAN::Locales::Compile;
    *plural_rule_string_to_javascript_code = \&amp;Cpanel::CPAN::Locales::Compile::plural_rule_string_to_javascript_code;
    goto \&amp;Cpanel::CPAN::Locales::Compile::plural_rule_string_to_javascript_code;
}

sub plural_rule_string_to_code {
    require Cpanel::CPAN::Locales::Compile;
    *plural_rule_string_to_code = \&amp;Cpanel::CPAN::Locales::Compile::plural_rule_string_to_code;
    goto \&amp;Cpanel::CPAN::Locales::Compile::plural_rule_string_to_code;
}

sub plural_rule_hashref_to_code {
    my ($hr) = @_;

    if ( ref( $hr-&gt;{&#039;category_rules&#039;} ) ne &#039;HASH&#039; ) {

        $hr-&gt;{&#039;category_rules_compiled&#039;} = {
            &#039;one&#039; =&gt; q{sub { return &#039;one&#039; if ( ( $n == 1 ) ); return;};},
        };

        return sub {

            my ($n) = @_;
            return &#039;one&#039; if $n == 1;
            return;
        };
    }
    else {
        for my $cat ( get_cldr_plural_category_list(1) ) {
            next if !exists $hr-&gt;{&#039;category_rules&#039;}{$cat};
            next if exists $hr-&gt;{&#039;category_rules_compiled&#039;}{$cat};
            $hr-&gt;{&#039;category_rules_compiled&#039;}{$cat} = plural_rule_string_to_code( $hr-&gt;{&#039;category_rules&#039;}{$cat}, $cat );
        }

        return sub {
            my ($n) = @_;
            my $match;
          PCAT:
            for my $cat ( get_cldr_plural_category_list(1) ) {    # use function instead of keys to preserve processing order
                next if !exists $hr-&gt;{&#039;category_rules_compiled&#039;}{$cat};


                if ( ref( $hr-&gt;{&#039;category_rules_compiled&#039;}{$cat} ) ne &#039;CODE&#039; ) {
                    local $SIG{&#039;__DIE__&#039;};                        # cpanel specific: ensure a benign eval does not trigger cpsrvd&#039;s DIE handler (may be made moot by internal case 50857)
                    $hr-&gt;{&#039;category_rules_compiled&#039;}{$cat} = eval &quot;$hr-&gt;{&#039;category_rules_compiled&#039;}{$cat}&quot;;    ## no critic (ProhibitStringyEval) # As of 0.22 this will be skipped for modules included w/ the main dist
                }

                if ( $hr-&gt;{&#039;category_rules_compiled&#039;}{$cat}-&gt;($n) ) {
                    $match = $cat;
                    last PCAT;
                }
            }

            return $match if $match;
            return;
        };
    }
}

sub get_cldr_plural_category_list {

    return qw(zero one two few many other) if $_[0];    # check order

    return qw(one two few many other zero);    # quant() arg order
}

sub get_fallback_list {
    my ( $self, $special_lookup ) = @_;

    my ( $super, $ter ) = split_tag( $self-&gt;{&#039;locale&#039;} );
    return (
        $self-&gt;{&#039;locale&#039;},
        ( $super ne $self-&gt;{&#039;locale&#039;} &amp;&amp; $super ne &#039;i&#039; ? $super : () ),
        ( @{ $self-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;fallback&#039;} } ),
        (
            defined $special_lookup &amp;&amp; ref($special_lookup) eq &#039;CODE&#039;
            ? ( map { my $n = Cpanel::Locale::Utils::Normalize::normalize_tag($_); $n ? ($n) : () } $special_lookup-&gt;( $self-&gt;{&#039;locale&#039;} ) )
            : ()
        ),
        &#039;en&#039;
    );
}

sub get_cldr_number_symbol_decimal {
    return $_[0]-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_decimal&#039;} || &#039;.&#039;;
}

sub get_cldr_number_symbol_group {
    return $_[0]-&gt;{&#039;language_data&#039;}{&#039;misc_info&#039;}{&#039;cldr_formats&#039;}{&#039;_decimal_format_group&#039;} || &#039;,&#039;;
}

1;


} # --- END Cpanel/CPAN/Locales.pm


{ # --- BEGIN Cpanel/CPAN/Locale/Maketext/Utils.pm
package Cpanel::CPAN::Locale::Maketext::Utils;


$Cpanel::CPAN::Locale::Maketext::Utils::VERSION = 0.33_95;

# use Cpanel::CPAN::Locale::Maketext 1.13_89 ();    # our 1.13_89 contains some optimizations and support for external_lex_cache that made its way to CPAN by v1.22 # perlpkg line 211

@Cpanel::CPAN::Locale::Maketext::Utils::ISA = qw(Cpanel::CPAN::Locale::Maketext);

use constant LOCALE_FALLBACK_CACHE_DIR =&gt; &#039;/usr/local/cpanel/etc/locale/fallback&#039;;
my $FORCE_REGEX_LAZY = &#039;&#039;;

my %singleton_stash = ();

sub _compile {
    my ( $lh, $string ) = @_;

    substr( $string, index( $string, &#039;_TILDE_&#039; ), 7, &#039;~~&#039; ) while index( $string, &#039;_TILDE_&#039; ) &gt; -1;    # this helps make parsing easier (via code or visually)

    my $compiled = $lh-&gt;SUPER::_compile($string);

    return $compiled if ref($compiled) ne &#039;CODE&#039;;

    return sub {
        return $compiled-&gt;( $_[0], @_[ 1 .. $#_ ] ) if !grep { defined &amp;&amp; index( $_, &#039;_&#039; ) &gt; -1 } @_[ 1 .. $#_ ];
        my ( $lh, @ref_args ) = @_;

        my $built = $compiled-&gt;(
            $lh,
            map {

                if ( defined &amp;&amp; index( $_, &#039;_&#039; ) &gt; -1 ) {
                    s/$FORCE_REGEX_LAZY\_(\-?[0-9]+|\*)/-!-$1-!-/og;
                }

                $_    # Change embedded-arg-looking-string to a

            } @ref_args

        );
        $built =~ s/$FORCE_REGEX_LAZY-!-(\-?[0-9]+|\*)-!-/_$1/og;    # Change placeholders back to their original
        return $built;
    };
}

sub get_handle {
    my ( $class, @langtags ) = @_;

    my $args_sig = join( &#039;,&#039;, @langtags ) || &#039;no_args&#039;;

    if ( exists $singleton_stash{$class}{$args_sig} ) {
        $singleton_stash{$class}{$args_sig}-&gt;{&#039;_singleton_reused&#039;}++;
    }
    else {
        $singleton_stash{$class}{$args_sig} = $class-&gt;SUPER::get_handle(@langtags);
    }

    return $singleton_stash{$class}{$args_sig};
}

sub get_locales_obj {
    my ( $lh, $tag ) = @_;
    $tag ||= $lh-&gt;get_language_tag();

    if ( !exists $lh-&gt;{&#039;Locales.pm&#039;}{$tag} ) {
        require Cpanel::CPAN::Locales;
        $lh-&gt;{&#039;Locales.pm&#039;}{$tag} =
             Cpanel::CPAN::Locales-&gt;new($tag)
          || ( $tag ne substr( $tag, 0, 2 ) ? Cpanel::CPAN::Locales-&gt;new( substr( $tag, 0, 2 ) ) : &#039;&#039; )
          || (
            $lh-&gt;{&#039;fallback_locale&#039;}
            ?        ( Cpanel::CPAN::Locales-&gt;new( $lh-&gt;{&#039;fallback_locale&#039;} )
                  || ( $lh-&gt;{&#039;fallback_locale&#039;} ne substr( $lh-&gt;{&#039;fallback_locale&#039;}, 0, 2 ) ? Cpanel::CPAN::Locales-&gt;new( substr( $lh-&gt;{&#039;fallback_locale&#039;}, 0, 2 ) ) : &#039;&#039; ) )
            : &#039;&#039;
          )
          || Cpanel::CPAN::Locales-&gt;new(&#039;en&#039;);
    }

    return $lh-&gt;{&#039;Locales.pm&#039;}{$tag};
}

sub init {
    my ($lh) = @_;

    $lh-&gt;SUPER::init();
    $lh-&gt;remove_key_from_lexicons(&#039;_AUTO&#039;);

    no strict &#039;refs&#039;;
    for my $ns ( $lh-&gt;get_base_class(), $lh-&gt;get_language_class() ) {
        if ( defined ${ $ns . &#039;::Encoding&#039; } ) {
            $lh-&gt;{&#039;encoding&#039;} = ${ $ns . &#039;::Encoding&#039; } if ${ $ns . &#039;::Encoding&#039; };
        }
    }


    $lh-&gt;fail_with(
        sub {
            my ( $lh, $key, @args ) = @_;

            my $lookup;
            if ( exists $lh-&gt;{&#039;_get_key_from_lookup&#039;} ) {
                if ( ref $lh-&gt;{&#039;_get_key_from_lookup&#039;} eq &#039;CODE&#039; ) {
                    $lookup = $lh-&gt;{&#039;_get_key_from_lookup&#039;}-&gt;( $lh, $key, @args );
                }
            }

            return $lookup if defined $lookup;

            if ( exists $lh-&gt;{&#039;_log_phantom_key&#039;} ) {
                if ( ref $lh-&gt;{&#039;_log_phantom_key&#039;} eq &#039;CODE&#039; ) {
                    $lh-&gt;{&#039;_log_phantom_key&#039;}-&gt;( $lh, $key, @args );
                }
            }

            if ( $lh-&gt;{&#039;use_external_lex_cache&#039;} ) {
                local $lh-&gt;{&#039;_external_lex_cache&#039;}{&#039;_AUTO&#039;} = 1;

                if ( index( $key, &#039;_&#039; ) == 0 ) {
                    return $lh-&gt;{&#039;_external_lex_cache&#039;}{$key} = $key;
                }
                return $lh-&gt;maketext( $key, @args );
            }
            else {
                no strict &#039;refs&#039;;
                local ${ $lh-&gt;get_base_class() . &#039;::Lexicon&#039; }{&#039;_AUTO&#039;} = 1;

                if ( index( $key, &#039;_&#039; ) == 0 ) {
                    return ${ $lh-&gt;get_base_class() . &#039;::Lexicon&#039; }{$key} = $key;
                }

                return $lh-&gt;maketext( $key, @args );
            }
        }
    );
}

*makevar = \&amp;Cpanel::CPAN::Locale::Maketext::maketext;


sub makethis {
    my ( $lh, $phrase, @phrase_args ) = @_;

    $lh-&gt;{&#039;cache&#039;}{&#039;makethis&#039;}{$phrase} ||= $lh-&gt;_compile($phrase);

    my $type = ref( $lh-&gt;{&#039;cache&#039;}{&#039;makethis&#039;}{$phrase} );

    if ( $type eq &#039;SCALAR&#039; ) {
        return ${ $lh-&gt;{&#039;cache&#039;}{&#039;makethis&#039;}{$phrase} };
    }
    elsif ( $type eq &#039;CODE&#039; ) {
        return $lh-&gt;{&#039;cache&#039;}{&#039;makethis&#039;}{$phrase}-&gt;( $lh, @phrase_args );
    }
    else {

        return $lh-&gt;{&#039;cache&#039;}{&#039;makethis&#039;}{$phrase};
    }
}

sub makethis_base {
    my ($lh) = @_;
    $lh-&gt;{&#039;cache&#039;}{&#039;makethis_base&#039;} ||= $lh-&gt;get_base_class()-&gt;get_handle( $lh-&gt;{&#039;fallback_locale&#039;} || &#039;en&#039; );    # this allows to have a separate cache of compiled phrases (? get_handle() explicit or base_locales() (i.e. en en_us i_default || L::M-&gt;fallback_languages) ?)
    return $lh-&gt;{&#039;cache&#039;}{&#039;makethis_base&#039;}-&gt;makethis( @_[ 1 .. $#_ ] );
}

sub make_alias {
    my ( $lh, $pkgs, $is_base_class ) = @_;

    my $ns = $lh-&gt;get_language_class();
    return if $ns =~ tr{:0-9A-Za-z_-}{}c;
    my $base = $is_base_class ? $ns : $lh-&gt;get_base_class();

    no strict &#039;refs&#039;;
    for my $pkg ( ref $pkgs ? @{$pkgs} : $pkgs ) {
        next if $pkg =~ tr{:0-9A-Za-z_-}{}c;

        *{ $base . &#039;::&#039; . $pkg . &#039;::Encoding&#039; } = *{ $ns . &#039;::Encoding&#039; };
        *{ $base . &#039;::&#039; . $pkg . &#039;::Lexicon&#039; }  = *{ $ns . &#039;::Lexicon&#039; };
        @{ $base . &#039;::&#039; . $pkg . &#039;::ISA&#039; }      = ($ns);
    }
}

sub remove_key_from_lexicons {
    my ( $lh, $key ) = @_;
    my $idx = 0;

    for my $lex_hr ( @{ $lh-&gt;_lex_refs() } ) {
        $lh-&gt;{&#039;_removed_from_lexicons&#039;}{$idx}{$key} = delete $lex_hr-&gt;{$key} if exists $lex_hr-&gt;{$key};
        $idx++;
    }
}

my %grapheme_lookup = (
    &#039;trademark&#039;          =&gt; &quot;\xE2\x84\xA2&quot;,    # &#039;TRADE MARK SIGN&#039; (U+2122)
    &#039;registered&#039;         =&gt; &quot;\xC2\xAE&quot;,        # &#039;REGISTERED SIGN&#039; (U+00AE)
    &#039;copyright&#039;          =&gt; &quot;\xC2\xA9&quot;,        # &#039;COPYRIGHT SIGN&#039; (U+00A9)
    &#039;left_double_quote&#039;  =&gt; &quot;\xE2\x80\x9C&quot;,    # &#039;LEFT DOUBLE QUOTATION MARK&#039; (U+201C)
    &#039;right_double_quote&#039; =&gt; &quot;\xE2\x80\x9D&quot;,    # &#039;RIGHT DOUBLE QUOTATION MARK&#039; (U+201D)
    &#039;ellipsis&#039;           =&gt; &quot;\xE2\x80\xA6&quot;,    # &#039;HORIZONTAL ELLIPSIS&#039; (U+2026)
    &#039;left_single_quote&#039;  =&gt; &quot;\xE2\x80\x98&quot;,    # &#039;LEFT SINGLE QUOTATION MARK&#039; (U+2018)
    &#039;right_single_quote&#039; =&gt; &quot;\xE2\x80\x99&quot;,    # &#039;RIGHT SINGLE QUOTATION MARK&#039;
    &#039;infinity&#039;           =&gt; &quot;\xE2\x88\x9E&quot;,    # &#039;INFINITY&#039; (U+221E)
);

sub get_grapheme_helper_hashref {
    return {%grapheme_lookup};                 # copy
}

sub get_base_class {
    my $ns = $_[0]-&gt;get_language_class();
    return $ns if $ns eq &#039;Cpanel::Locale&#039;;
    return substr( $ns, 0, rindex( $ns, &#039;::&#039; ) );
}

sub append_to_lexicons {
    my ( $lh, $appendage ) = @_;
    return if ref $appendage ne &#039;HASH&#039;;

    no strict &#039;refs&#039;;
    for my $lang ( keys %{$appendage} ) {
        my $ns = $lh-&gt;get_base_class() . ( $lang eq &#039;_&#039; ? &#039;&#039; : &quot;::$lang&quot; ) . &#039;::Lexicon&#039;;
        %{$ns} = ( %{$ns}, %{ $appendage-&gt;{$lang} } );
    }
}

sub langtag_is_loadable {
    my ( $lh, $wants_tag ) = @_;
    $wants_tag = Cpanel::CPAN::Locale::Maketext::language_tag($wants_tag);

    my $tag_obj = eval $lh-&gt;get_base_class() . q{-&gt;get_handle( $wants_tag );};

    my $has_tag = $tag_obj-&gt;language_tag();
    return $wants_tag eq $has_tag ? $tag_obj : 0;
}

sub get_language_tag {
    return ( split &#039;::&#039;, $_[0]-&gt;get_language_class() )[-1];
}

sub print {
    local $Carp::CarpLevel = 1;
    print $_[0]-&gt;maketext( @_[ 1 .. $#_ ] );
}

sub fetch {
    local $Carp::CarpLevel = 1;
    return $_[0]-&gt;maketext( @_[ 1 .. $#_ ] );
}

sub say {
    local $Carp::CarpLevel = 1;
    my $text = $_[0]-&gt;maketext( @_[ 1 .. $#_ ] );
    local $/ = !defined $/ || !$/ ? &quot;\n&quot; : $/;    # otherwise assume they are not stupid
    print $text . $/ if $text;
}

sub get {
    local $Carp::CarpLevel = 1;
    my $text = $_[0]-&gt;maketext( @_[ 1 .. $#_ ] );
    local $/ = !defined $/ || !$/ ? &quot;\n&quot; : $/;    # otherwise assume they are not stupid
    return $text . $/ if $text;
    return;
}

sub get_language_tag_name {
    my ( $lh, $tag, $in_locale_tongue ) = @_;
    $tag ||= $lh-&gt;get_language_tag();

    my $loc_obj = $lh-&gt;get_locales_obj( $in_locale_tongue ? () : ($tag) );

    if ( $loc_obj-&gt;{&#039;native_data&#039;} &amp;&amp; $tag eq $lh-&gt;get_language_tag() ) {
        return $loc_obj-&gt;get_native_language_from_code($tag);
    }

    return $loc_obj-&gt;get_language_from_code($tag);
}

sub get_html_dir_attr {
    my ( $lh, $raw_cldr, $is_tag ) = @_;

    if ($is_tag) {
        $raw_cldr = $lh-&gt;get_language_tag_character_orientation($raw_cldr);
    }
    else {
        $raw_cldr ||= $lh-&gt;get_language_tag_character_orientation();
    }

    if ( $raw_cldr eq &#039;left-to-right&#039; ) {
        return &#039;ltr&#039;;
    }
    elsif ( $raw_cldr eq &#039;right-to-left&#039; ) {
        return &#039;rtl&#039;;
    }

    return;
}

sub get_locale_display_pattern {

    require Cpanel::CPAN::Locales::DB::LocaleDisplayPattern::Tiny;
    return Cpanel::CPAN::Locales::DB::LocaleDisplayPattern::Tiny::get_locale_display_pattern( $_[1] || $_[0]-&gt;{&#039;fallback_locale&#039;} || $_[0]-&gt;get_language_tag() );
}

sub get_language_tag_character_orientation {

    require Cpanel::CPAN::Locales::DB::CharacterOrientation::Tiny;
    return Cpanel::CPAN::Locales::DB::CharacterOrientation::Tiny::get_orientation( $_[1] || $_[0]-&gt;{&#039;fallback_locale&#039;} || $_[0]-&gt;get_language_tag() );
}

*lextext = *text;

sub text {

    if ( @_ != 2 ) {
        require Carp;
        Carp::croak(&#039;text() requires a singlef parameter&#039;);

    }

    my ( $handle, $phrase ) = splice( @_, 0, 2 );
    unless ( defined($handle) &amp;&amp; defined($phrase) ) {
        require Carp;
        Carp::confess(&#039;No handle/phrase&#039;);

    }

    if ( !$handle-&gt;{&#039;use_external_lex_cache&#039;} ) {
        require Carp;
        Carp::carp(&quot;text() requires you to have &#039;use_external_lex_cache&#039; enabled.&quot;);
        return;
    }

    local $@;


    my $value;
    foreach my $h_r ( @{ $handle-&gt;_lex_refs } ) {    # _lex_refs() caches itself

        if ( defined( $value = $h_r-&gt;{$phrase} ) ) {

            if ( ref $value ) {
                require Carp;
                Carp::carp(&quot;Previously compiled phrase (&#039;use_external_lex_cache&#039; enabled after phrase was compiled?)&quot;);
            }

            return $value eq &#039;&#039; ? $phrase : $value;
        }

        elsif ( index( $phrase, &#039;_&#039; ) != 0 and $h_r-&gt;{&#039;_AUTO&#039;} ) {

            return $phrase;
        }


    }


    return ( !defined $value || $value eq &#039;&#039; ) ? $phrase : $value;
}

our $_NATIVE_ONLY = 0;

sub lang_names_hashref_native_only {
    local $_NATIVE_ONLY = 1;
    return lang_names_hashref(@_);
}

sub lang_names_hashref {
    my ( $lh, @langcodes ) = @_;

    if ( !@langcodes ) {    # they havn&#039;t specified any langcodes...
        require File::Spec;    # only needed here, so we don&#039;t use() it

        my @search;
        my $path = $lh-&gt;get_base_class();

        substr( $path, index( $path, &#039;::&#039; ), 2, &#039;/&#039; ) while index( $path, &#039;::&#039; ) &gt; -1;

        if ( ref $lh-&gt;{&#039;_lang_pm_search_paths&#039;} eq &#039;ARRAY&#039; ) {
            @search = @{ $lh-&gt;{&#039;_lang_pm_search_paths&#039;} };
        }

        @search = @INC if !@search;    # they havn&#039;t told us where they are specifically

      DIR:
        for my $dir (@search) {
            my $lookin = File::Spec-&gt;catdir( $dir, $path );
            next DIR if !-d $lookin;
            if ( opendir my $dh, $lookin ) {
              PM:
                for my $pm ( grep { /^\w+\.pm$/ } grep !/^\.+$/, readdir($dh) ) {
                    substr( $pm, -3, 3, &#039;&#039; );    # checked above - if substr( $pm, -3 ) eq &#039;.pm&#039;;
                    next PM if !$pm;
                    next PM if $pm eq &#039;Utils&#039;;
                    next PM if $pm eq &#039;Context&#039;;
                    next PM if $pm eq &#039;Lazy&#039;;
                    push @langcodes, $pm;
                }
                closedir $dh;
            }
        }
    }

    require Cpanel::CPAN::Locales;

    $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;} ||= $lh-&gt;get_locales_obj();

    my $langname  = {};
    my $native    = wantarray &amp;&amp; $Cpanel::CPAN::Locales::VERSION &gt; 0.06 ? {} : undef;
    my $direction = wantarray &amp;&amp; $Cpanel::CPAN::Locales::VERSION &gt; 0.09 ? {} : undef;

    for my $code ( &#039;en&#039;, @langcodes ) {    # en since it is &quot;built in&quot;
        if ( defined $native ) {
            $native-&gt;{$code} = $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}-&gt;get_native_language_from_code( $code, 1 );
        }

        $langname-&gt;{$code} = $_NATIVE_ONLY ? $native-&gt;{$code} : $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}-&gt;get_language_from_code( $code, 1 );

        if ( defined $direction ) {
            $direction-&gt;{$code} = $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}-&gt;get_character_orientation_from_code_fast($code);
        }
    }

    return wantarray ? ( $langname, $native, $direction ) : $langname;
}

sub loadable_lang_names_hashref {
    my ( $lh, @langcodes ) = @_;

    my $langname = $lh-&gt;lang_names_hashref(@langcodes);

    for my $tag ( keys %{$langname} ) {
        delete $langname-&gt;{$tag} if !$lh-&gt;langtag_is_loadable($tag);
    }

    return $langname;
}

sub add_lexicon_override_hash {
    my ( $lh, $langtag, $name, $hr ) = @_;
    if ( @_ == 3 ) {
        $hr      = $name;
        $name    = $langtag;
        $langtag = $lh-&gt;get_language_tag();
    }

    my $ns = $lh-&gt;get_language_tag() eq $langtag ? $lh-&gt;get_language_class() : $lh-&gt;get_base_class();

    no strict &#039;refs&#039;;
    if ( my $ref = tied( %{ $ns . &#039;::Lexicon&#039; } ) ) {
        return 1 if $lh-&gt;{&#039;add_lex_hash_silent_if_already_added&#039;} &amp;&amp; exists $ref-&gt;{&#039;hashes&#039;} &amp;&amp; exists $ref-&gt;{&#039;hashes&#039;}{$name};
        if ( $ref-&gt;can(&#039;add_lookup_override_hash&#039;) ) {
            return $ref-&gt;add_lookup_override_hash( $name, $hr );
        }
    }

    my $cur_errno = $!;
    if ( eval { require Sub::Todo } ) {
        goto &amp;Sub::Todo::todo;
    }
    else {
        $! = $cur_errno;
        return;
    }
}

sub add_lexicon_fallback_hash {
    my ( $lh, $langtag, $name, $hr ) = @_;
    if ( @_ == 3 ) {
        $hr      = $name;
        $name    = $langtag;
        $langtag = $lh-&gt;get_language_tag();
    }

    my $ns = $lh-&gt;get_language_tag() eq $langtag ? $lh-&gt;get_language_class() : $lh-&gt;get_base_class();

    no strict &#039;refs&#039;;
    if ( my $ref = tied( %{ $ns . &#039;::Lexicon&#039; } ) ) {
        return 1 if $lh-&gt;{&#039;add_lex_hash_silent_if_already_added&#039;} &amp;&amp; exists $ref-&gt;{&#039;hashes&#039;} &amp;&amp; exists $ref-&gt;{&#039;hashes&#039;}{$name};
        if ( $ref-&gt;can(&#039;add_lookup_fallback_hash&#039;) ) {
            return $ref-&gt;add_lookup_fallback_hash( $name, $hr );
        }
    }

    my $cur_errno = $!;
    if ( eval { require Sub::Todo } ) {
        goto &amp;Sub::Todo::todo;
    }
    else {
        $! = $cur_errno;
        return;
    }
}

sub del_lexicon_hash {
    my ( $lh, $langtag, $name ) = @_;

    if ( @_ == 2 ) {
        return if $langtag eq &#039;*&#039;;
        $name    = $langtag;
        $langtag = &#039;*&#039;;
    }

    return if !$langtag;

    my $count = 0;
    if ( $langtag eq &#039;*&#039; ) {
        no strict &#039;refs&#039;;
        for my $ns ( $lh-&gt;get_base_class(), $lh-&gt;get_language_class() ) {
            if ( my $ref = tied( %{ $ns . &#039;::Lexicon&#039; } ) ) {
                if ( $ref-&gt;can(&#039;del_lookup_hash&#039;) ) {
                    $ref-&gt;del_lookup_hash($name);
                    $count++;
                }
            }
        }

        return 1 if $count;

        my $cur_errno = $!;
        if ( eval { require Sub::Todo } ) {
            goto &amp;Sub::Todo::todo;
        }
        else {
            $! = $cur_errno;
            return;
        }
    }
    else {
        my $ns = $lh-&gt;get_language_tag() eq $langtag ? $lh-&gt;get_language_class() : $lh-&gt;get_base_class();

        no strict &#039;refs&#039;;
        if ( my $ref = tied( %{ $ns . &#039;::Lexicon&#039; } ) ) {
            if ( $ref-&gt;can(&#039;del_lookup_hash&#039;) ) {
                return $ref-&gt;del_lookup_hash($name);
            }
        }

        my $cur_errno = $!;
        if ( eval { require Sub::Todo } ) {
            goto &amp;Sub::Todo::todo;
        }
        else {
            $! = $cur_errno;
            return;
        }
    }
}

sub get_language_class {
    return ref( $_[0] ) || $_[0];
}


sub get_base_class_dir {
    my ($lh) = @_;
    if ( !exists $lh-&gt;{&#039;Cpanel::CPAN::Locale::Maketext::Utils&#039;}{&#039;_base_clase_dir&#039;} ) {
        $lh-&gt;{&#039;Cpanel::CPAN::Locale::Maketext::Utils&#039;}{&#039;_base_clase_dir&#039;} = undef;

        my $inc_key = $lh-&gt;get_base_class();

        substr( $inc_key, index( $inc_key, &#039;::&#039; ), 2, &#039;/&#039; ) while index( $inc_key, &#039;::&#039; ) &gt; -1;
        $inc_key .= &#039;.pm&#039;;
        if ( exists $INC{$inc_key} ) {
            if ( -e $INC{$inc_key} ) {
                my $hr = $lh-&gt;{&#039;Cpanel::CPAN::Locale::Maketext::Utils&#039;};
                $hr-&gt;{&#039;_base_clase_dir&#039;} = $INC{$inc_key};
                substr( $hr-&gt;{&#039;_base_clase_dir&#039;}, -3, 3, &#039;&#039; ) if substr( $hr-&gt;{&#039;_base_clase_dir&#039;}, -3 ) eq &#039;.pm&#039;;
            }
        }
    }

    return $lh-&gt;{&#039;Cpanel::CPAN::Locale::Maketext::Utils&#039;}{&#039;_base_clase_dir&#039;};
}

sub list_available_locales {
    my ($lh) = @_;

    die &quot;List context only!&quot; if !wantarray;

    my $main_ns_dir = $lh-&gt;get_base_class_dir() || return;
    local $!;
    opendir my $dh, $main_ns_dir or die &quot;Failed to open: $main_ns_dir: $!&quot;;

    return map { ( substr( $_, -3 ) eq &#039;.pm&#039; &amp;&amp; $_ ne &#039;Utils.pm&#039; &amp;&amp; $_ ne &#039;Lazy.pm&#039; &amp;&amp; $_ ne &#039;Context.pm&#039; &amp;&amp; $_ ne &#039;Fallback.pm&#039; ) ? substr( $_, 0, -3 ) : () } readdir($dh);    #de-taint
}

sub get_asset {
    my ( $lh, $code, $tag ) = @_;                                                                                                                                                # No caching since $code can do anything.

    my $root = $tag || $lh-&gt;get_language_tag;
    my $ret;

    die &quot;Invalid locale: $root&quot; if index( $root, &#039;/&#039; ) &gt; -1;

    $ret = $code-&gt;($root);
    return $ret if defined $ret;

    my $loc;    # buffer
    my %seen = ( $root =&gt; 1 );

    my @fallback_locales;
    if ( $lh-&gt;_has_fallback_list($root) ) {
        my $loc_obj = $lh-&gt;get_locales_obj($tag);
        @fallback_locales = $loc_obj-&gt;get_fallback_list( $lh-&gt;{&#039;Locales.pm&#039;}{&#039;get_fallback_list_special_lookup_coderef&#039;} );
    }
    elsif ( $root ne &#039;en&#039; ) {

        my $super = ( split( m{_}, $root ) )[0];
        @fallback_locales = (
            ( $super ne $root &amp;&amp; $super ne &#039;i&#039; ? $super : () ),
            &#039;en&#039;
        );
    }

    for $loc (@fallback_locales) {
        next if $seen{$loc};    # get_fallback_list can provide back dupes and its expensive to enumerate each one

        $ret = $code-&gt;($loc);
        $seen{$loc}++;
        last if defined $ret;
    }

    return $ret if defined $ret;
    return;
}

sub _has_fallback_list {
    return $_[0]-&gt;{&#039;_has_fallback_list&#039;}{ $_[1] } if defined $_[0]-&gt;{&#039;_has_fallback_list&#039;}{ $_[1] };
    my $size = -s LOCALE_FALLBACK_CACHE_DIR . &#039;/&#039; . $_[1];
    return ( $_[0]-&gt;{&#039;_has_fallback_list&#039;}{ $_[1] } = ( !defined $size || $size ) ? 1 : 0 );
}

sub get_asset_file {
    my ( $lh, $find, $return ) = @_;
    $return = $find if !defined $return;

    return $lh-&gt;{&#039;cache&#039;}{&#039;get_asset_file&#039;}{$find}{$return} if exists $lh-&gt;{&#039;cache&#039;}{&#039;get_asset_file&#039;}{$find}{$return};

    $lh-&gt;{&#039;cache&#039;}{&#039;get_asset_file&#039;}{$find}{$return} = $lh-&gt;get_asset(
        sub {
            return sprintf( $return, $_[0] ) if -f sprintf( $find, $_[0] );
            return;
        }
    );

    return $lh-&gt;{&#039;cache&#039;}{&#039;get_asset_file&#039;}{$find}{$return} if defined $lh-&gt;{&#039;cache&#039;}{&#039;get_asset_file&#039;}{$find}{$return};
    return;
}

sub get_asset_dir {
    my ( $lh, $find, $return ) = @_;
    $return = $find if !defined $return;

    return $lh-&gt;{&#039;cache&#039;}{&#039;get_asset_dir&#039;}{$find}{$return} if exists $lh-&gt;{&#039;cache&#039;}{&#039;get_asset_dir&#039;}{$find}{$return};

    $lh-&gt;{&#039;cache&#039;}{&#039;get_asset_dir&#039;}{$find}{$return} = $lh-&gt;get_asset(
        sub {
            return sprintf( $return, $_[0] ) if -d sprintf( $find, $_[0] );
            return;
        }
    );

    return $lh-&gt;{&#039;cache&#039;}{&#039;get_asset_dir&#039;}{$find}{$return} if defined $lh-&gt;{&#039;cache&#039;}{&#039;get_asset_dir&#039;}{$find}{$return};
    return;
}

sub delete_cache {
    my ( $lh, $which ) = @_;
    if ( defined $which ) {
        return delete $lh-&gt;{&#039;cache&#039;}{$which};
    }
    else {
        return delete $lh-&gt;{&#039;cache&#039;};
    }
}


sub quant {
    my ( $handle, $num, @forms ) = @_;

    my $max_decimal_places = 3;

    if ( ref($num) eq &#039;ARRAY&#039; ) {
        $max_decimal_places = $num-&gt;[1];
        $num                = $num-&gt;[0];
    }

    $handle-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;} ||= $handle-&gt;get_locales_obj();

    my ( $string, $spec_zero ) = $handle-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}-&gt;get_plural_form( $num, @forms );

    if ( index( $string, &#039;%s&#039; ) &gt; -1 ) {
        return sprintf( $string, $handle-&gt;numf( $num, $max_decimal_places ) );
    }
    elsif ( $num == 0 &amp;&amp; $spec_zero ) {
        return $string;
    }
    else {
        $handle-&gt;numf( $num, $max_decimal_places ) . &quot; $string&quot;;
    }
}

sub numerate {
    my ( $handle, $num, @forms ) = @_;

    my $max_decimal_places = 3;

    if ( ref($num) eq &#039;ARRAY&#039; ) {
        $max_decimal_places = $num-&gt;[1];
        $num                = $num-&gt;[0];
    }

    $handle-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;} ||= $handle-&gt;get_locales_obj();

    my $string = scalar( $handle-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}-&gt;get_plural_form( $num, @forms ) );

    if ( index( $string, &#039;%s&#039; ) &gt; -1 ) {
        $string = sprintf( $string, $handle-&gt;numf( $num, $max_decimal_places ) );
    }

    return $string;
}


sub numf {
    my ( $handle, $num, $max_decimal_places ) = @_;

    $handle-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;} ||= $handle-&gt;get_locales_obj();

    return $handle-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}-&gt;get_formatted_decimal( $num, $max_decimal_places );
}


sub join {
    shift;
    return CORE::join( shift, map { ref($_) eq &#039;ARRAY&#039; ? @{$_} : $_ } @_ );
}

sub list_and {
    my $lh = shift;

    $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;} ||= $lh-&gt;get_locales_obj();

    return $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}-&gt;get_list_and( map { ref($_) eq &#039;ARRAY&#039; ? @{$_} : $_ } @_ );
}

sub list_or {
    my $lh = shift;

    $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;} ||= $lh-&gt;get_locales_obj();

    return $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}-&gt;get_list_or( map { ref($_) eq &#039;ARRAY&#039; ? @{$_} : $_ } @_ );
}

sub list_and_quoted {
    my ( $lh, @args ) = @_;

    $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;} ||= $lh-&gt;get_locales_obj();
    local $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}{&#039;misc&#039;}{&#039;list_quote_mode&#039;} = &#039;all&#039;;
    return $lh-&gt;list_and(@args);
}

sub list_or_quoted {
    my ( $lh, @args ) = @_;

    $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;} ||= $lh-&gt;get_locales_obj();
    local $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}{&#039;misc&#039;}{&#039;list_quote_mode&#039;} = &#039;all&#039;;
    return $lh-&gt;list_or(@args);
}

sub output_asis {
    return $_[1];
}

sub asis {
    return $_[0]-&gt;output( &#039;asis&#039;, $_[1] );    # this allows for embedded methods but still called via [asis,...] instead of [output,asis,...]
}

sub comment {
    return &#039;&#039;;
}

sub is_future {
    my ( $lh, $dt, $future, $past, $current, $current_type ) = @_;

    if ( $dt =~ tr{0-9}{}c ) {
        $dt = __get_dt_obj_from_arg( $dt, 0 );
        $dt = $dt-&gt;epoch();
    }

    if ($current) {
        if ( !ref $dt ) {
            $dt = __get_dt_obj_from_arg( $dt, 0 );
        }
        $current_type ||= &#039;hour&#039;;

        if ( $current_type eq &#039;day&#039; ) {

        }
        elsif ( $current_type eq &#039;minute&#039; ) {

        }
        else {

        }
    }

    return ref $dt ? $dt-&gt;epoch() : $dt &gt; time() ? $future : $past;
}

sub __get_dt_obj_from_arg {
    require    # hide from Cpanel::Static
      DateTime;
    return
       !defined $_[0] || $_[0] eq &#039;&#039;                                 ? DateTime-&gt;now()
      : ref $_[0] eq &#039;HASH&#039;                                          ? DateTime-&gt;new( %{ $_[0] } )
      : $_[0] =~ m{ \A (\d+ (?: [.] \d+ )? ) (?: [:] (.*) )? \z }xms ? DateTime-&gt;from_epoch( &#039;epoch&#039; =&gt; $1, &#039;time_zone&#039; =&gt; ( $2 || &#039;UTC&#039; ) )
      : !ref $_[0]                                                   ? DateTime-&gt;now( &#039;time_zone&#039; =&gt; ( $_[0] || &#039;UTC&#039; ) )
      : $_[1]                                                        ? $_[0]-&gt;clone()
      :                                                                $_[0];
}

sub current_year {
    $_[0]-&gt;datetime( &#039;&#039;, &#039;YYYY&#039; );
}

sub datetime {
    my ( $lh, $dta, $str ) = @_;
    my $dt = __get_dt_obj_from_arg( $dta, 1 );

    if ( !$INC{&#039;DateTime/Locale.pm&#039;} ) {    # __get_dt_obj_from_arg is loading DateTime
        eval q{ require DateTime::Locale; 1 } or die &quot;Cannot load DateTime::Locale: $!&quot;;
    }

    $dt-&gt;{&#039;locale&#039;} = DateTime::Locale-&gt;load( $lh-&gt;language_tag() );
    my $format = ref $str eq &#039;CODE&#039; ? $str-&gt;($dt) : $str;
    if ( defined $format ) {
        if ( $dt-&gt;{&#039;locale&#039;}-&gt;can($format) ) {
            $format = $dt-&gt;{&#039;locale&#039;}-&gt;$format();
        }
    }
    $format = &#039;&#039; if !defined $format;

    return $dt-&gt;format_cldr( $dt-&gt;{&#039;locale&#039;}-&gt;format_for($format) || $format || $dt-&gt;{&#039;locale&#039;}-&gt;date_format_long() );
}

sub output_amp  { return $_[0]-&gt;output_chr(38) }
sub output_lt   { return $_[0]-&gt;output_chr(60) }    # TODO: ? make the rest of these embeddable like amp() ?
sub output_gt   { return $_[0]-&gt;output_chr(62) }
sub output_apos { return $_[0]-&gt;output_chr(39) }
sub output_quot { return $_[0]-&gt;output_chr(34) }
sub output_shy  { return $_[0]-&gt;output_chr(173) }


use constant output_nbsp =&gt; &quot;\xC2\xA0&quot;;


my $space;

sub format_bytes {
    my ( $lh, $bytes, $max_decimal_place ) = @_;
    $bytes ||= 0;

    if ( !defined $max_decimal_place ) {
        $max_decimal_place = 2;
    }
    else {
        $max_decimal_place = int( abs($max_decimal_place) );
    }

    my $absnum = abs($bytes);

    $space ||= $lh-&gt;output_nbsp();    # avoid method call if we already have it

    if ( $absnum &lt; 1024 ) {

        return ( $lh-&gt;{&#039;_format_bytes_cache&#039;}{ $bytes . &#039;_&#039; . $max_decimal_place } ||= $lh-&gt;maketext( &#039;[quant,_1,%s byte,%s bytes]&#039;, [ $bytes, $max_decimal_place ] ) );    # the space between the &#039;%s&#039; and the &#039;b&#039; is a non-break space (e.g. option-spacebar, not spacebar)
    }
    elsif ( $absnum &lt; 1048576 ) {
        return $lh-&gt;numf( ( $bytes / 1024 ), $max_decimal_place ) . $space . &#039;KB&#039;;
    }
    elsif ( $absnum &lt; 1073741824 ) {
        return $lh-&gt;numf( ( $bytes / 1048576 ), $max_decimal_place ) . $space . &#039;MB&#039;;
    }
    elsif ( $absnum &lt; 1099511627776 ) {
        return $lh-&gt;numf( ( $bytes / 1073741824 ), $max_decimal_place ) . $space . &#039;GB&#039;;
    }
    elsif ( $absnum &lt; 1125899906842624 ) {
        return $lh-&gt;numf( ( $bytes / 1099511627776 ), $max_decimal_place ) . $space . &#039;TB&#039;;
    }
    elsif ( $absnum &lt; ( 1125899906842624 * 1024 ) ) {
        return $lh-&gt;numf( ( $bytes / 1125899906842624 ), $max_decimal_place ) . $space . &#039;PB&#039;;
    }
    elsif ( $absnum &lt; ( 1125899906842624 * 1024 * 1024 ) ) {
        return $lh-&gt;numf( ( $bytes / ( 1125899906842624 * 1024 ) ), $max_decimal_place ) . $space . &#039;EB&#039;;
    }
    elsif ( $absnum &lt; ( 1125899906842624 * 1024 * 1024 * 1024 ) ) {
        return $lh-&gt;numf( ( $bytes / ( 1125899906842624 * 1024 * 1024 ) ), $max_decimal_place ) . $space . &#039;ZB&#039;;
    }
    else {

        return $lh-&gt;numf( ( $bytes / ( 1125899906842624 * 1024 * 1024 * 1024 ) ), $max_decimal_place ) . $space . &#039;YB&#039;;

    }
}

sub convert {
    die __PACKAGE__ . &quot;::convert is not supported (missing Math::Units)&quot;;
}

sub is_defined {
    my ( $lh, $value, $is_defined, $not_defined, $is_defined_but_false ) = @_;

    return __proc_string_with_embedded_under_vars($not_defined) if !defined $value;

    if ( defined $is_defined_but_false &amp;&amp; !$value ) {
        return __proc_string_with_embedded_under_vars($is_defined_but_false);
    }
    else {
        return __proc_string_with_embedded_under_vars($is_defined);
    }
}

sub boolean {
    my ( $lh, $boolean, $true, $false, $null ) = @_;
    if ($boolean) {
        return __proc_string_with_embedded_under_vars($true);
    }
    else {
        if ( !defined $boolean &amp;&amp; defined $null ) {
            return __proc_string_with_embedded_under_vars($null);
        }
        return __proc_string_with_embedded_under_vars($false);
    }
}

sub __proc_string_with_embedded_under_vars {
    my $str = $_[0];
    return $str if index( $str, &#039;_&#039; ) == -1 || $str !~ m/$FORCE_REGEX_LAZY\_(?:\-?[0-9]+)/o;
    my @args = __caller_args( $_[1] );    # this way be dragons
    $str =~ s/$FORCE_REGEX_LAZY\_(\-?[0-9]+)/$args[$1]/og;
    return $str;
}

sub __caller_args {

    package DB;
    () = caller( $_[0] + 3 );
    return @DB::args;
}

sub __proc_emb_meth {
    my ( $lh, $str ) = @_;

    $str =~ s/$FORCE_REGEX_LAZY(su[bp])\(((?:\\\)|[^\)])+?)\)/my $s=$2;my $m=&quot;output_$1&quot;;$s=~s{\\\)}{\)}g;$lh-&gt;$m($s)/oeg if index( $str, &#039;su&#039; ) &gt; -1;
    $str =~ s/${FORCE_REGEX_LAZY}chr\(((?:\d+|[\S]))\)/$lh-&gt;output_chr($1)/oeg                                            if index( $str, &#039;chr(&#039; ) &gt; -1;
    $str =~ s/${FORCE_REGEX_LAZY}numf\((\d+(?:\.\d+)?)\)/$lh-&gt;numf($1)/oeg                                                if index( $str, &#039;numf(&#039; ) &gt; -1;
    substr( $str, index( $str, &#039;amp()&#039; ), 5, $lh-&gt;output_amp() ) while index( $str, &#039;amp()&#039; ) &gt; -1;

    return $str;
}

sub output {
    my ( $lh, $output_function, $string, @output_function_args ) = @_;

    if ( defined $string &amp;&amp; $string ne &#039;&#039; &amp;&amp; index( $string, &#039;(&#039; ) &gt; -1 ) {
        $string = __proc_emb_meth( $lh, $string );
    }

    if ( $output_function eq &#039;url&#039; &amp;&amp; defined $output_function_args[0] &amp;&amp; $output_function_args[0] ne &#039;&#039; &amp;&amp; index( $output_function_args[0], &#039;(&#039; ) &gt; -1 ) {
        $output_function_args[0] = __proc_emb_meth( $lh, $output_function_args[0] );
    }
    if ( my $cr = ( $lh-&gt;{&#039;_output_function_cache&#039;}{$output_function} ||= $lh-&gt;can( &#039;output_&#039; . $output_function ) ) ) {
        return $cr-&gt;( $lh, $string, @output_function_args );
    }
    else {
        my $cur_errno = $!;
        if ( eval { require Sub::Todo } ) {
            $! = Sub::Todo::get_errno_func_not_impl();
        }
        else {
            $! = $cur_errno;
        }
        return $string;
    }
}

sub output_encode_puny {
    my ( $self, $s ) = @_;
    require    # do not include it in updatenow.static
      Cpanel::Encoder::Punycode;
    return Cpanel::Encoder::Punycode::punycode_encode_str($s);
}

sub output_decode_puny {
    my ( $self, $s ) = @_;
    require    # do not include it in updatenow.static
      Cpanel::Encoder::Punycode;
    return Cpanel::Encoder::Punycode::punycode_decode_str($s);
}

my $has_encode;    # checking for Encode this way facilitates only checking @INC once for the module on systems that do not have Encode

sub output_chr {
    my ( $lh, $chr_num ) = @_;

    if ( $chr_num !~ m/$FORCE_REGEX_LAZY\A\d+\z/o ) {
        return          if length($chr_num) != 1;
        return $chr_num if !$lh-&gt;context_is_html();

        return
            $chr_num eq &#039;&quot;&#039; ? &#039;&amp;quot;&#039;
          : $chr_num eq &#039;&amp;&#039; ? &#039;&amp;amp;&#039;
          : $chr_num eq &quot;&#039;&quot; ? &#039;&amp;#39;&#039;
          : $chr_num eq &#039;&lt;&#039; ? &#039;&amp;lt;&#039;
          : $chr_num eq &#039;&gt;&#039; ? &#039;&amp;gt;&#039;
          :                   $chr_num;
    }
    return if $chr_num !~ m/$FORCE_REGEX_LAZY\A\d+\z/o;
    my $chr = chr($chr_num);

    if ( $chr_num &gt; 127 ) {

        if ( !defined $has_encode ) {
            $has_encode = 0;
            eval { require Encode; $has_encode = 1; };
        }

        if ($has_encode) {
            $chr = Encode::encode( $lh-&gt;encoding(), $chr );
        }

        else {


            $chr = eval &#039;&quot;\x{&#039; . sprintf( &#039;%04X&#039;, $chr_num ) . &#039;}&quot;&#039;;
        }
    }

    if ( !$lh-&gt;context_is_html() ) {
        return $chr;
    }
    else {
        return
            $chr_num == 34 || $chr_num == 147 || $chr_num == 148 ? &#039;&amp;quot;&#039;
          : $chr_num == 38                                       ? &#039;&amp;amp;&#039;
          : $chr_num == 39 || $chr_num == 145 || $chr_num == 146 ? &#039;&amp;#39;&#039;
          : $chr_num == 60                                       ? &#039;&amp;lt;&#039;
          : $chr_num == 62                                       ? &#039;&amp;gt;&#039;
          : $chr_num == 173                                      ? &#039;&amp;shy;&#039;
          :                                                        $chr;
    }
}

sub output_class {
    my ( $lh, $string, @classes ) = @_;
    $string = __proc_string_with_embedded_under_vars( $string, 1 );
    return $string if $lh-&gt;context_is_plain();

    return $lh-&gt;context_is_ansi() ? &quot;\e[1m$string\e[0m&quot; : qq{&lt;span class=&quot;@classes&quot;&gt;$string&lt;/span&gt;};
}

sub output_asis_for_tests {
    my ( $lh, $string ) = @_;
    $string = __proc_string_with_embedded_under_vars( $string, 1 );
    return $string;
}

sub __make_attr_str_from_ar {
    my ( $attr_ar, $strip_hr, $addin ) = @_;
    if ( ref($attr_ar) eq &#039;HASH&#039; ) {
        $strip_hr = $attr_ar;
        $attr_ar  = [];
    }

    my $attr       = &#039;&#039;;
    my $general_hr = ref( $attr_ar-&gt;[-1] ) eq &#039;HASH&#039; ? pop( @{$attr_ar} ) : undef;

    my $idx    = 0;
    my $ar_len = @{$attr_ar};

    $idx = 1 if $ar_len % 2;    # handle “Odd number of elements” …

    my $did_addin;

    while ( $idx &lt; $ar_len ) {
        if ( exists $strip_hr-&gt;{ $attr_ar-&gt;[$idx] } ) {
            $idx += 2;
            next;
        }
        my $atr = $attr_ar-&gt;[$idx];
        my $val = $attr_ar-&gt;[ ++$idx ];
        if ( exists $addin-&gt;{$atr} ) {
            $val = &quot;$addin-&gt;{$atr} $val&quot;;
            $did_addin-&gt;{$atr}++;
        }

        $attr .= qq{ $atr=&quot;$val&quot;};
        $idx++;
    }

    if ($general_hr) {
        for my $k ( keys %{$general_hr} ) {
            next if exists $strip_hr-&gt;{$k};
            if ( exists $addin-&gt;{$k} ) {
                $general_hr-&gt;{$k} = &quot;$addin-&gt;{$k} $general_hr-&gt;{$k}&quot;;
                $did_addin-&gt;{$k}++;
            }
            $attr .= qq{ $k=&quot;$general_hr-&gt;{$k}&quot;};
        }
    }

    for my $r ( keys %{$addin} ) {
        if ( !exists $did_addin-&gt;{$r} ) {
            $attr .= qq{ $r=&quot;$addin-&gt;{$r}&quot;};
        }
    }

    return $attr;
}

sub output_inline {
    my ( $lh, $string, @attrs ) = @_;
    $string = __proc_string_with_embedded_under_vars( $string, 1 );
    return $string if !$lh-&gt;context_is_html();

    my $attr = __make_attr_str_from_ar( \@attrs );
    return qq{&lt;span$attr&gt;$string&lt;/span&gt;};
}

*output_attr = \&amp;output_inline;

sub output_block {
    my ( $lh, $string, @attrs ) = @_;
    $string = __proc_string_with_embedded_under_vars( $string, 1 );
    return $string if !$lh-&gt;context_is_html();

    my $attr = __make_attr_str_from_ar( \@attrs );
    return qq{&lt;div$attr&gt;$string&lt;/div&gt;};
}

sub output_img {
    my ( $lh, $src, $alt, @attrs ) = @_;

    if ( !defined $alt || $alt eq &#039;&#039; ) {
        $alt = $src;
    }
    else {
        $alt = __proc_string_with_embedded_under_vars( $alt, 1 );
    }

    return $alt if !$lh-&gt;context_is_html();

    my $attr = __make_attr_str_from_ar( \@attrs, { &#039;alt&#039; =&gt; 1, &#039;src&#039; =&gt; 1 } );
    return qq{&lt;img src=&quot;$src&quot; alt=&quot;$alt&quot;$attr/&gt;};
}

sub output_abbr {
    my ( $lh, $abbr, $full, @attrs ) = @_;
    return !$lh-&gt;context_is_html()
      ? &quot;$abbr ($full)&quot;
      : qq{&lt;abbr title=&quot;$full&quot;} . __make_attr_str_from_ar( \@attrs, { &#039;title&#039; =&gt; 1 } ) . qq{&gt;$abbr&lt;/abbr&gt;};
}

sub output_acronym {
    my ( $lh, $acronym, $full, @attrs ) = @_;

    return !$lh-&gt;context_is_html()
      ? &quot;$acronym ($full)&quot;
      : qq{&lt;abbr title=&quot;$full&quot;} . __make_attr_str_from_ar( \@attrs, { &#039;title&#039; =&gt; 1 }, { &#039;class&#039; =&gt; &#039;initialism&#039; } ) . qq{&gt;$acronym&lt;/abbr&gt;};
}

sub output_sup {
    my ( $lh, $string, @attrs ) = @_;
    $string = __proc_string_with_embedded_under_vars( $string, 1 );
    return !$lh-&gt;context_is_html() ? $string : qq{&lt;sup} . __make_attr_str_from_ar( \@attrs ) . qq{&gt;$string&lt;/sup&gt;};
}

sub output_sub {
    my ( $lh, $string, @attrs ) = @_;
    $string = __proc_string_with_embedded_under_vars( $string, 1 );
    return !$lh-&gt;context_is_html() ? $string : qq{&lt;sub} . __make_attr_str_from_ar( \@attrs ) . qq{&gt;$string&lt;/sub&gt;};
}

sub output_underline {
    my ( $lh, $string, @attrs ) = @_;

    $string = __proc_string_with_embedded_under_vars( $string, 1 );
    return $string if $lh-&gt;context_is_plain();
    return $lh-&gt;context_is_ansi() ? &quot;\e[4m$string\e[0m&quot; : qq{&lt;span style=&quot;text-decoration: underline&quot;} . __make_attr_str_from_ar( \@attrs ) . qq{&gt;$string&lt;/span&gt;};
}

sub output_strong {
    my ( $lh, $string, @attrs ) = @_;

    $string = __proc_string_with_embedded_under_vars( $string, 1 );
    return $string if $lh-&gt;context_is_plain();
    return $lh-&gt;context_is_ansi() ? &quot;\e[1m$string\e[0m&quot; : &#039;&lt;strong&#039; . __make_attr_str_from_ar( \@attrs ) . &quot;&gt;$string&lt;/strong&gt;&quot;;
}

sub output_em {
    my ( $lh, $string, @attrs ) = @_;

    $string = __proc_string_with_embedded_under_vars( $string, 1 );
    return $string if $lh-&gt;context_is_plain();

    return $lh-&gt;context_is_ansi() ? &quot;\e[3m$string\e[0m&quot; : &#039;&lt;em&#039; . __make_attr_str_from_ar( \@attrs ) . &quot;&gt;$string&lt;/em&gt;&quot;;
}


sub output_url {
    my ( $lh, $url, @args ) = @_;
    $url ||= &#039;&#039;;    # carp() ?

    my $arb_args_hr = ref $args[-1] eq &#039;HASH&#039; ? pop(@args) : {};
    my ( $url_text, %output_config ) = @args % 2 ? @args : ( undef, @args );

    my $return = $url;

    if ( !$lh-&gt;context_is_html() ) {
        if ($url_text) {
            return &quot;$url_text ($url)&quot;;
        }

        if ( exists $output_config{&#039;plain&#039;} ) {
            $output_config{&#039;plain&#039;} ||= $url;
            my $orig = $output_config{&#039;plain&#039;};
            $output_config{&#039;plain&#039;} = __proc_string_with_embedded_under_vars( $output_config{&#039;plain&#039;}, 1 );
            $return = $orig ne $output_config{&#039;plain&#039;} &amp;&amp; $output_config{&#039;plain&#039;} =~ m/\Q$url\E/ ? $output_config{&#039;plain&#039;} : &quot;$output_config{&#039;plain&#039;} $url&quot;;
        }
    }
    else {
        if ( exists $output_config{&#039;html&#039;} ) {
            $output_config{&#039;html&#039;} = __proc_string_with_embedded_under_vars( $output_config{&#039;html&#039;}, 1 );
        }

        $output_config{&#039;html&#039;} ||= $url_text || $url;

        my $attr = __make_attr_str_from_ar(
            [ @args, $arb_args_hr ],
            {
                &#039;html&#039;  =&gt; 1,
                &#039;plain&#039; =&gt; 1,
                &#039;_type&#039; =&gt; 1,
            }
        );

        $return = exists $output_config{&#039;_type&#039;}
          &amp;&amp; $output_config{&#039;_type&#039;} eq &#039;offsite&#039; ? qq{&lt;a$attr target=&quot;_blank&quot; class=&quot;offsite&quot; href=&quot;$url&quot;&gt;$output_config{&#039;html&#039;}&lt;/a&gt;} : qq{&lt;a$attr href=&quot;$url&quot;&gt;$output_config{&#039;html&#039;}&lt;/a&gt;};
    }

    return $return;
}


sub set_context_html {
    my ($lh) = @_;
    my $cur = $lh-&gt;get_context();
    $lh-&gt;set_context(&#039;html&#039;);
    return if !$lh-&gt;context_is_html();
    return $cur;
}

sub set_context_ansi {
    my ($lh) = @_;
    my $cur = $lh-&gt;get_context();
    $lh-&gt;set_context(&#039;ansi&#039;);
    return if !$lh-&gt;context_is_ansi();
    return $cur;
}

sub set_context_plain {
    my ($lh) = @_;
    my $cur = $lh-&gt;get_context();
    $lh-&gt;set_context(&#039;plain&#039;);
    return if !$lh-&gt;context_is_plain();
    return $cur;
}

my %contexts = (
    &#039;plain&#039; =&gt; undef(),
    &#039;ansi&#039;  =&gt; 1,
    &#039;html&#039;  =&gt; 0,
);

sub set_context {
    my ( $lh, $context ) = @_;

    if ( !$context ) {
        $lh-&gt;{&#039;-t-STDIN&#039;} = -t *STDIN ? 1 : 0;
    }
    elsif ( exists $contexts{$context} ) {
        $lh-&gt;{&#039;-t-STDIN&#039;} = $contexts{$context};
    }
    else {
        require Carp;
        local $Carp::CarpLevel = 1;
        Carp::carp(&quot;Given context &#039;$context&#039; is unknown.&quot;);
        $lh-&gt;{&#039;-t-STDIN&#039;} = $context;
    }
}

sub context_is_html {
    return $_[0]-&gt;get_context() eq &#039;html&#039;;
}

sub context_is_ansi {
    return $_[0]-&gt;get_context() eq &#039;ansi&#039;;
}

sub context_is_plain {
    return $_[0]-&gt;get_context() eq &#039;plain&#039;;
}

sub context_is {
    return $_[0]-&gt;get_context() eq $_[1];
}

sub get_context {
    $_[0]-&gt;set_context() if !exists $_[0]-&gt;{&#039;-t-STDIN&#039;};
    return
        !defined $_[0]-&gt;{&#039;-t-STDIN&#039;} ? &#039;plain&#039;
      : $_[0]-&gt;{&#039;-t-STDIN&#039;}          ? &#039;ansi&#039;
      :                                &#039;html&#039;;
}

sub maketext_html_context {
    my ( $lh, @mt_args ) = @_;
    my $cur = $lh-&gt;set_context_html();
    my $res = $lh-&gt;maketext(@mt_args);
    $lh-&gt;set_context($cur);
    return $res;
}

sub maketext_ansi_context {
    my ( $lh, @mt_args ) = @_;
    my $cur = $lh-&gt;set_context_ansi();
    my $res = $lh-&gt;maketext(@mt_args);
    $lh-&gt;set_context($cur);
    return $res;
}

sub maketext_plain_context {
    my ( $lh, @mt_args ) = @_;
    my $cur = $lh-&gt;set_context_plain();
    my $res = $lh-&gt;maketext(@mt_args);
    $lh-&gt;set_context($cur);
    return $res;
}


1;

} # --- END Cpanel/CPAN/Locale/Maketext/Utils.pm


{ # --- BEGIN Cpanel/Locale/Utils/Paths.pm
package Cpanel::Locale::Utils::Paths;


use strict;
use warnings;
no warnings &#039;once&#039;;

use constant {
    get_legacy_lang_cache_root =&gt; &#039;/var/cpanel/lang.cache&#039;,
    get_i_locales_config_path  =&gt; &#039;/var/cpanel/i_locales&#039;,
    get_custom_whitelist_path  =&gt; &#039;/var/cpanel/maketext_whitelist&#039;
};

sub get_locale_database_root   { return &#039;/var/cpanel/locale&#039; }
sub get_locale_yaml_root       { return &#039;/usr/local/cpanel/locale&#039; }
sub get_legacy_lang_root       { return &#039;/usr/local/cpanel/lang&#039; }
sub get_locale_yaml_local_root { return &#039;/var/cpanel/locale.local&#039; }

1;

} # --- END Cpanel/Locale/Utils/Paths.pm


{ # --- BEGIN Cpanel/Locale/Utils.pm
package Cpanel::Locale::Utils;


use strict;
use warnings;
no warnings &#039;once&#039;;

BEGIN {
    eval { require CDB_File; };
}

# use Cpanel::Locale::Utils::Paths (); # perlpkg line 211


$Cpanel::Locale::Utils::i_am_the_compiler = 0;

my $logger;

sub _logger {
    require Cpanel::Logger;
    $logger ||= Cpanel::Logger-&gt;new();
}


sub get_readonly_tie {
    my ( $cdb_file, $cdb_hr ) = @_;
    if ( !$cdb_file ) {
        _logger()-&gt;warn(&#039;Undefined CDB file specified for readonly operation&#039;);
        return;
    }
    elsif ( !$INC{&#039;CDB_File.pm&#039;} || !exists $CDB_File::{&#039;TIEHASH&#039;} ) {
        _logger()-&gt;warn(&quot;Failed to load CDB_File.pm&quot;) if $^X ne &#039;/usr/bin/perl&#039;;
        return;
    }

    my $tie_obj = tie %{$cdb_hr}, &#039;CDB_File&#039;, $cdb_file;

    if ( !$tie_obj &amp;&amp; !-e $cdb_file ) {
        _logger()-&gt;warn(&quot;Missing CDB file $cdb_file specified for readonly operation&quot;);
        return;

    }

    eval { exists $cdb_hr-&gt;{&#039;__VERSION&#039;} };
    if ($@) {
        $tie_obj = undef;
        untie %$cdb_hr;
    }

    if ( !$tie_obj ) {
        _logger()-&gt;warn(&quot;CDB_File could not get read-only association to &#039;$cdb_file&#039;: $!&quot;);
    }

    return $tie_obj;
}

sub create_cdb {
    my ( $cdb_file, $cdb_hr ) = @_;

    if ( !$cdb_file ) {
        _logger()-&gt;warn(&#039;Undefined CDB file specified for writable operation&#039;);
        return;
    }

    return CDB_File::create( %{$cdb_hr}, $cdb_file, &quot;$cdb_file.$$&quot; );
}

sub get_writable_tie {
    require Carp;
    Carp::confess(&quot;cdb files are not writable&quot;);
}

sub init_lexicon {
    my ( $langtag, $hr, $version_sr, $encoding_sr ) = @_;
    my $cdb_file;
    my $db_root = Cpanel::Locale::Utils::Paths::get_locale_database_root();

    for my $file ( $Cpanel::CPDATA{&#039;RS&#039;} ? (&quot;themes/$Cpanel::CPDATA{RS}/$langtag.cdb&quot;) : (), &quot;$langtag.cdb&quot; ) {    # PPI NO PARSE - Only include Cpanel() when some other module uses it
        if ( -e &quot;$db_root/$file&quot; ) {
            $cdb_file = &quot;$db_root/$file&quot;;
            last;
        }
    }

    if ( !$cdb_file ) {
        if ( -e Cpanel::Locale::Utils::Paths::get_locale_yaml_root() . &quot;/$langtag.yaml&quot; &amp;&amp; !$Cpanel::Locale::Utils::i_am_the_compiler ) {
            _logger()-&gt;info(qq{Locale needs to be compiled by root (/usr/local/cpanel/bin/build_locale_databases --locale=$langtag)});
        }
        return;
    }


    my $cdb_tie = get_readonly_tie( $cdb_file, $hr );

    if ( exists $hr-&gt;{&#039;__VERSION&#039;} &amp;&amp; ref $version_sr ) {
        ${$version_sr} = $hr-&gt;{&#039;__VERSION&#039;};
    }

    if ( ref $encoding_sr ) {

        ${$encoding_sr} ||= &#039;utf-8&#039;;
    }

    return $cdb_file;
}

sub init_package {
    my ($caller) = caller();

    my ($langtag) = reverse( split( /::/, $caller ) );

    no strict &#039;refs&#039;;
    no warnings &#039;once&#039;;

    ${ $caller . &#039;::CDB_File_Path&#039; } ||= init_lexicon( &quot;$langtag&quot;, \%{ $caller . &#039;::Lexicon&#039; }, \${ $caller . &#039;::VERSION&#039; }, \${ $caller . &#039;::Encoding&#039; }, );

    return;
}

1;

} # --- END Cpanel/Locale/Utils.pm


{ # --- BEGIN Cpanel/DB/Utils.pm
package Cpanel::DB::Utils;


use strict;

sub username_to_dbowner {
    my ($username) = @_;

    $username =~ tr&lt;_.&gt;&lt;&gt;d if defined $username;

    return $username;
}

1;

} # --- END Cpanel/DB/Utils.pm


{ # --- BEGIN Cpanel/AdminBin/Serializer.pm
package Cpanel::AdminBin::Serializer;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use Cpanel::JSON (); # perlpkg line 211


our $VERSION = &#039;2.4&#039;;

our $MAX_LOAD_LENGTH;
our $MAX_PRIV_LOAD_LENGTH;

BEGIN {
    *MAX_LOAD_LENGTH      = \$Cpanel::JSON::MAX_LOAD_LENGTH;
    *MAX_PRIV_LOAD_LENGTH = \$Cpanel::JSON::MAX_PRIV_LOAD_LENGTH;
    *DumpFile             = *Cpanel::JSON::DumpFile;
}


BEGIN {
    *Dump = *Cpanel::JSON::Dump;

    *SafeDump = *Cpanel::JSON::SafeDump;

    *LoadFile = *Cpanel::JSON::LoadFileNoSetUTF8;

    *Load = *Cpanel::JSON::Load;

    *looks_like_serialized_data = *Cpanel::JSON::looks_like_json;
}


sub SafeLoadFile {
    return Cpanel::JSON::_LoadFile( $_[0], $Cpanel::JSON::MAX_LOAD_LENGTH, $Cpanel::JSON::DECODE_UTF8, $_[1], $Cpanel::JSON::LOAD_STRICT );
}


sub SafeLoad {
    utf8::decode( $_[0] );
    return Cpanel::JSON::LoadNoSetUTF8(@_);
}


sub clone {
    return Cpanel::JSON::LoadNoSetUTF8( Cpanel::JSON::Dump( $_[0] ) );
}

1;

} # --- END Cpanel/AdminBin/Serializer.pm


{ # --- BEGIN Cpanel/AdminBin/Serializer/FailOK.pm
package Cpanel::AdminBin::Serializer::FailOK;


use strict;
use warnings;
no warnings &#039;once&#039;;

sub LoadModule {
    local $@;

    return 1 if $INC{&#039;Cpanel/AdminBin/Serializer.pm&#039;};

    my $load_ok = eval {
        local $SIG{&#039;__DIE__&#039;};     # Suppress spewage as we may be reading an invalid cache
        local $SIG{&#039;__WARN__&#039;};    # and since failure is ok to throw it away
        require Cpanel::AdminBin::Serializer;
        1;
    };

    if ( !$load_ok &amp;&amp; !$ENV{&#039;CPANEL_BASE_INSTALL&#039;} &amp;&amp; index( $^X, &#039;/usr/local/cpanel&#039; ) == 0 ) {
        warn $@;
    }

    return $load_ok ? 1 : 0;
}

sub LoadFile {
    my ( $file_or_fh, $path ) = @_;

    return undef if !$INC{&#039;Cpanel/AdminBin/Serializer.pm&#039;};

    return eval {
        local $SIG{&#039;__DIE__&#039;};     # Suppress spewage as we may be reading an invalid cache
        local $SIG{&#039;__WARN__&#039;};    # and since failure is ok to throw it away
        Cpanel::AdminBin::Serializer::LoadFile( $file_or_fh, undef, $path );
    };
}
1;

} # --- END Cpanel/AdminBin/Serializer/FailOK.pm


{ # --- BEGIN Cpanel/Config/Constants.pm
package Cpanel::Config::Constants;


use strict;
use warnings;
no warnings &#039;once&#039;;

our $DEFAULT_CPANEL_THEME = &#039;jupiter&#039;;

our $DEFAULT_CPANEL_MAILONLY_THEME = &#039;jupiter&#039;;

our $DEFAULT_WEBMAIL_THEME = &#039;jupiter&#039;;

our $DEFAULT_WEBMAIL_MAILONLY_THEME = &#039;jupiter&#039;;

our @DORMANT_SERVICES_LIST = qw(cpdavd cphulkd cpsrvd dnsadmin spamd);

our $MAX_HOMEDIR_STREAM_TIME = ( 86400 * 2 );

1;

} # --- END Cpanel/Config/Constants.pm


{ # --- BEGIN Cpanel/Imports.pm
package Cpanel::Imports;


use strict;

$Cpanel::Imports::VERSION = &#039;0.02&#039;;

sub import {
    my $caller = caller;
    no strict &#039;refs&#039;;    ## no critic(ProhibitNoStrict)

    *{ $caller . &#039;::logger&#039; } = \&amp;__logger;
    *{ $caller . &#039;::locale&#039; } = \&amp;__locale;

    return;
}

my ( $logger, $locale );

sub _reset_lazy_facade {    # usually for testing
    $logger = undef;
    $locale = undef;
    return;
}

sub __logger {
    require Cpanel::Logger if !$INC{&#039;Cpanel/Logger.pm&#039;};
    if ( !$logger ) {    # return $var ||= XYZ-&gt;new; works but, we keep it super vanilla to make it more likley to perlcc OK
        $logger = Cpanel::Logger-&gt;new;
    }
    return $logger;
}

sub __locale {
    require Cpanel::Locale if !$INC{&#039;Cpanel/Locale.pm&#039;};
    if ( !$locale ) {    # return $var ||= XYZ-&gt;new; works but, we keep it super vanilla to make it more likley to perlcc OK
        $locale = Cpanel::Locale-&gt;get_handle;
    }
    return $locale;
}

1;


} # --- END Cpanel/Imports.pm


{ # --- BEGIN Cpanel/SSL/KeyTypeLabel.pm
package Cpanel::SSL::KeyTypeLabel;


use cPstrict;
no warnings &#039;once&#039;;


use Cpanel::Imports;


my %_ECDSA_DETAIL = (
    prime256v1 =&gt; &#039;P-256 (prime256v1)&#039;,
    secp384r1  =&gt; &#039;P-384 (secp384r1)&#039;,
);

sub to_label ($the_type) {
    my ( $type, $detail ) = split m&lt;-&gt;, $the_type;

    die _invalid_type_msg($the_type) if !defined $detail;

    $type =~ tr&lt;a-z&gt;&lt;A-Z&gt;;

    if ( $type eq &#039;RSA&#039; ) {
        $detail = locale()-&gt;maketext( &#039;[numf,_1]-bit&#039;, $detail );
    }
    elsif ( $type eq &#039;ECDSA&#039; ) {
        $detail = $_ECDSA_DETAIL{$detail} or die _invalid_type_msg($the_type);
    }
    else {
        die &quot;need update? ($the_type)&quot;;
    }

    return &quot;$type, $detail&quot;;
}

sub _invalid_type_msg ($the_type) {
    return &quot;Invalid key type: “$the_type”&quot;;
}

1;

} # --- END Cpanel/SSL/KeyTypeLabel.pm


{ # --- BEGIN Cpanel/SSL/DefaultKey/Constants.pm
package Cpanel::SSL::DefaultKey::Constants;


use cPstrict;
no warnings &#039;once&#039;;


# use Cpanel::SSL::KeyTypeLabel (); # perlpkg line 211


use constant OPTIONS =&gt; (
    &#039;rsa-2048&#039;,
    &#039;ecdsa-secp384r1&#039;,
    &#039;ecdsa-prime256v1&#039;,
    &#039;rsa-4096&#039;,
);


sub OPTIONS_AND_LABELS() {
    local ( $@, $! );
    require Cpanel::Locale;

    my $lh = Cpanel::Locale-&gt;get_handle();

    return map { ( $_ =&gt; Cpanel::SSL::KeyTypeLabel::to_label($_) ) } OPTIONS;
}


sub KEY_DESCRIPTIONS() {
    require Cpanel::Locale;

    my $lh = Cpanel::Locale-&gt;get_handle();

    return {
        &quot;rsa-2048&quot;         =&gt; $lh-&gt;maketext(&quot;[asis,RSA] is more compatible with older clients (for example, browsers older than [asis,Internet Explorer] 11) than [asis,ECDSA]. New installations of [asis,cPanel amp() WHM] ship with this setting.&quot;),
        &quot;rsa-4096&quot;         =&gt; $lh-&gt;maketext( &quot;[asis,RSA] is more compatible with older clients (for example, browsers older than [asis,Internet Explorer] 11) than [asis,ECDSA]. This is more secure than [_1]-bit, but will perform slower than [_1]-bit keys.&quot;, &#039;RSA, 2,048&#039; ),
        &quot;ecdsa-prime256v1&quot; =&gt; $lh-&gt;maketext(&quot;[asis,ECDSA] allows websites to support [asis,Internet Explorer] 11 and retain compliance with [output,acronym,PCI,Payment Card Industry] standards.&quot;),
        &quot;ecdsa-secp384r1&quot;  =&gt; $lh-&gt;maketext(&quot;[asis,ECDSA] allows websites to support [asis,Internet Explorer] 11 and retain compliance with [output,acronym,PCI,Payment Card Industry] standards. [asis,secp384r1] is more secure than [asis,prime256v1], but may perform slower.&quot;),
    };
}

use constant USER_SYSTEM =&gt; &#039;system&#039;;

1;

} # --- END Cpanel/SSL/DefaultKey/Constants.pm


{ # --- BEGIN Cpanel/Config/CpUser/Defaults.pm
package Cpanel::Config::CpUser::Defaults;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use Cpanel::SSL::DefaultKey::Constants (); # perlpkg line 211


our @DEFAULTS_KV = (
    &#039;BWLIMIT&#039;              =&gt; &#039;unlimited&#039;,
    &#039;CHILD_WORKLOADS&#039;      =&gt; q&lt;&gt;,
    &#039;DEADDOMAINS&#039;          =&gt; undef,
    &#039;DEMO&#039;                 =&gt; 0,
    &#039;DOMAIN&#039;               =&gt; &#039;&#039;,
    &#039;DOMAINS&#039;              =&gt; undef,
    &#039;FEATURELIST&#039;          =&gt; &#039;default&#039;,
    &#039;HASCGI&#039;               =&gt; 0,
    &#039;HASDKIM&#039;              =&gt; 0,
    &#039;HASSPF&#039;               =&gt; 0,
    &#039;IP&#039;                   =&gt; &#039;127.0.0.1&#039;,
    &#039;MAILBOX_FORMAT&#039;       =&gt; &#039;maildir&#039;,                                         #keep in sync with cpconf
    &#039;MAX_EMAILACCT_QUOTA&#039;  =&gt; &#039;unlimited&#039;,
    &#039;MAXADDON&#039;             =&gt; 0,
    &#039;MAXFTP&#039;               =&gt; &#039;unlimited&#039;,
    &#039;MAXLST&#039;               =&gt; &#039;unlimited&#039;,
    &#039;MAXPARK&#039;              =&gt; 0,
    &#039;MAXPOP&#039;               =&gt; &#039;unlimited&#039;,
    &#039;MAXSQL&#039;               =&gt; &#039;unlimited&#039;,
    &#039;MAXSUB&#039;               =&gt; &#039;unlimited&#039;,
    &#039;OWNER&#039;                =&gt; &#039;root&#039;,
    &#039;PLAN&#039;                 =&gt; &#039;undefined&#039;,
    &#039;RS&#039;                   =&gt; &#039;&#039;,
    &#039;STARTDATE&#039;            =&gt; &#039;0000000000&#039;,
    &#039;MAXPASSENGERAPPS&#039;     =&gt; 4,
    &#039;SSL_DEFAULT_KEY_TYPE&#039; =&gt; Cpanel::SSL::DefaultKey::Constants::USER_SYSTEM,
);

1;

} # --- END Cpanel/Config/CpUser/Defaults.pm


{ # --- BEGIN Cpanel/Hash/JSONable.pm
package Cpanel::Hash::JSONable;


use cPstrict;
no warnings &#039;once&#039;;


sub TO_JSON ($self) {
    return {%$self};
}

1;

} # --- END Cpanel/Hash/JSONable.pm


{ # --- BEGIN Cpanel/Config/CpUser/Object.pm
package Cpanel::Config::CpUser::Object;


use cPstrict;
no warnings &#039;once&#039;;


# use parent Cpanel::Hash::JSONable (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::Hash::JSONable); }

use Class::XSAccessor (
    getters =&gt; {
        username =&gt; &#039;USER&#039;,
    },
);


sub adopt ( $class, $ref ) {
    return bless $ref, $class;
}


sub domains_ar ($self) {
    return [ $self-&gt;{&#039;DOMAIN&#039;}, @{ $self-&gt;{&#039;DOMAINS&#039;} } ];
}


sub contact_emails_ar ($self) {
    return [ grep { length } @{$self}{ &#039;CONTACTEMAIL&#039;, &#039;CONTACTEMAIL2&#039; } ];
}


sub child_workloads ($self) {

    if (wantarray) {
        return if !$self-&gt;{&#039;CHILD_WORKLOADS&#039;};
        return split( m&lt;,&gt;, $self-&gt;{&#039;CHILD_WORKLOADS&#039;}, -1 );
    }

    return 0 if !$self-&gt;{&#039;CHILD_WORKLOADS&#039;};

    return 1 + ( $self-&gt;{&#039;CHILD_WORKLOADS&#039;} =~ tr&lt;,&gt;&lt;&gt; );
}

1;

} # --- END Cpanel/Config/CpUser/Object.pm


{ # --- BEGIN Cpanel/SV.pm
package Cpanel::SV;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub untaint {
    return $_[0] unless ${^TAINT};
    require    # Cpanel::Static OK - we should not untaint variables as part of updatenow.static
      Taint::Util;
    Taint::Util::untaint( $_[0] );
    return $_[0];
}

1;

} # --- END Cpanel/SV.pm


{ # --- BEGIN Cpanel/Path/Normalize.pm
package Cpanel::Path::Normalize;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub normalize {
    my $uncleanpath = shift || return;

    my $is_abspath = ( 0 == index( $uncleanpath, &#039;/&#039; ) );

    my @pathdirs = split( m[/], $uncleanpath );

    my @cleanpathdirs;
    my $leading_dot_dots = 0;

    foreach my $dir (@pathdirs) {
        next if !length $dir;    #Remove extraneous &quot;//&quot; and leading &quot;/&quot;

        next if $dir eq &#039;.&#039;;

        if ( $dir eq &#039;..&#039; ) {
            if (@cleanpathdirs) {
                pop(@cleanpathdirs);
            }
            else {
                $leading_dot_dots++;
            }
        }
        else {
            push( @cleanpathdirs, $dir );
        }
    }

    if ($is_abspath) {
        return ( &#039;/&#039; . join( &#039;/&#039;, @cleanpathdirs ) );
    }

    unshift @cleanpathdirs, (&#039;..&#039;) x $leading_dot_dots;

    return join( &#039;/&#039;, @cleanpathdirs );
}


1;

} # --- END Cpanel/Path/Normalize.pm


{ # --- BEGIN Cpanel/Hash/Stringify.pm
package Cpanel::Hash::Stringify;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub sorted_hashref_string {
    my ($hashref) = @_;
    return (
        ( scalar keys %$hashref )
        ? join(
            &#039;_____&#039;, map { $_, ( ref $hashref-&gt;{$_} eq &#039;HASH&#039; ? sorted_hashref_string( $hashref-&gt;{$_} ) : ref $hashref-&gt;{$_} eq &#039;ARRAY&#039; ? join( &#039;_____&#039;, @{ $hashref-&gt;{$_} } ) : defined $hashref-&gt;{$_} ? $hashref-&gt;{$_} : &#039;&#039; ) }
              sort keys %$hashref
          )
        : &#039;&#039;
    );    #sort is important for order;
}

1;

} # --- END Cpanel/Hash/Stringify.pm


{ # --- BEGIN Cpanel/Umask.pm
package Cpanel::Umask;


use strict;

# use parent Cpanel::Finally (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::Finally); }

sub new {
    my ( $class, $new ) = @_;

    my $old = umask();

    umask($new);

    return $class-&gt;SUPER::new(
        sub {
            my $cur = umask();

            if ( $cur != $new ) {
                my ( $cur_o, $old_o, $new_o ) = map { &#039;0&#039; . sprintf( &#039;%o&#039;, $_ ) } ( $cur, $old, $new );

                warn &quot;I want to umask($old_o). I expected the current umask to be $new_o, but it’s actually $cur_o.&quot;;
            }

            umask($old);
        }
    );
}

1;

} # --- END Cpanel/Umask.pm


{ # --- BEGIN Cpanel/Config/LoadConfig.pm
package Cpanel::Config::LoadConfig;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Hash::Stringify              (); # perlpkg line 211
# use Cpanel::Debug                        (); # perlpkg line 211
# use Cpanel::FileUtils::Write::JSON::Lazy (); # perlpkg line 211
# use Cpanel::AdminBin::Serializer::FailOK (); # perlpkg line 211
# use Cpanel::LoadFile::ReadFast           (); # perlpkg line 211
# use Cpanel::HiRes                        (); # perlpkg line 211
# use Cpanel::SV                           (); # perlpkg line 211

use constant _ENOENT =&gt; 2;

my $logger;
our $PRODUCT_CONF_DIR = &#039;/var/cpanel&#039;;

our $_DEBUG_SAFEFILE = 0;

my %COMMON_CACHE_NAMES = (
    &#039;:__^\s*[#;]____0__&#039;                                                                           =&gt; &#039;default_colon&#039;,
    &#039;:\s+__^\s*[#;]____0__&#039;                                                                        =&gt; &#039;default_colon_any_space&#039;,
    &#039;: __^\s*[#;]____0__&#039;                                                                          =&gt; &#039;default_colon_with_one_space&#039;,
    &#039;=__^\s*[#;]____0__skip_readable_check_____1&#039;                                                  =&gt; &#039;default_skip_readable&#039;,
    &#039;=__^\s*[#;]____0__&#039;                                                                           =&gt; &#039;default&#039;,
    &#039;=__^\s*[#;]__(?^:\s+)__0__&#039;                                                                   =&gt; &#039;default_with_preproc_newline&#039;,
    &#039;=__^\s*[#;]____1__&#039;                                                                           =&gt; &#039;default_allow_undef&#039;,
    &#039;\s*[:]\s*__^\s*[#;]____0__&#039;                                                                   =&gt; &#039;default_colon_before_after_space&#039;,
    &#039;\s*=\s*__^\s*[#;]____1__&#039;                                                                     =&gt; &#039;default_equal_before_after_space_allow_undef&#039;,
    &#039;\s*[\=]\s*__^\s*[#]____0__use_reverse_____0&#039;                                                  =&gt; &#039;default_equal_before_after_space&#039;,
    &#039;: __^\s*[#;]____0__limit_____10000000000_____use_reverse_____0&#039;                               =&gt; &#039;default_with_10000000000_limit&#039;,
    &#039;\s*[:]\s*__^\s*[#;]____0__use_hash_of_arr_refs_____0_____use_reverse_____0&#039;                   =&gt; &#039;default_use_hash_of_arr_refs&#039;,
    &#039;: __^\s*[#;]____0__limit__________use_reverse_____0&#039;                                          =&gt; &#039;default_colon_single_space_no_limit&#039;,
    &#039;: __^\s*[#;]____1__skip_keys_____nobody_____use_hash_of_arr_refs_____0_____use_reverse_____0&#039; =&gt; &#039;default_colon_skip_nobody_no_limit&#039;,
    &#039;: __^\s*[#;]____1__use_reverse_____1&#039;                                                         =&gt; &#039;default_reverse_allow_undef&#039;,
    &#039;\s+__^\s*[#;]____0__&#039;                                                                         =&gt; &#039;default_space_seperated_config&#039;,
    &#039;\s*=\s*__^\s*[#;]__^\s*__0__&#039;                                                                 =&gt; &#039;default_equal_space_seperated_config&#039;,           #ea4.conf
);

my $DEFAULT_DELIMITER      = &#039;=&#039;;
my $DEFAULT_COMMENT_REGEXP = &#039;^\s*[#;]&#039;;                                                                                                                #Keep in sync with tr{} below!!
my @BOOLEAN_OPTIONS        = qw(
  allow_undef_values
  use_hash_of_arr_refs
  use_reverse
);

my $CACHE_DIR_PERMS = 0700;

sub _process_parse_args {
    my (%opts) = @_;

    if ( !defined $opts{&#039;delimiter&#039;} ) {
        $opts{&#039;delimiter&#039;} = $DEFAULT_DELIMITER;
    }

    $opts{&#039;regexp_to_preprune&#039;} ||= q{};

    $opts{&#039;comment&#039;} ||= $DEFAULT_COMMENT_REGEXP;

    $opts{&#039;comment&#039;} = &#039;&#039; if $opts{&#039;comment&#039;} eq &#039;0E0&#039;;

    $opts{$_} ||= 0 for @BOOLEAN_OPTIONS;

    return %opts;
}

{
    no warnings &#039;once&#039;;
    *get_homedir_and_cache_dir = *_get_homedir_and_cache_dir;
}

sub _get_homedir_and_cache_dir {
    my ( $homedir, $cache_dir );

    if ( $&gt; == 0 ) {
        $cache_dir = &quot;$PRODUCT_CONF_DIR/configs.cache&quot;;
    }
    else {
        {
            no warnings &#039;once&#039;;
            $homedir = $Cpanel::homedir;
        }
        if ( !$homedir ) {
            eval &#039;local $SIG{__DIE__}; local $SIG{__WARN__}; require Cpanel::PwCache&#039;;    ## no critic qw(ProhibitStringyEval) # PPI USE OK - just after
            $homedir = Cpanel::PwCache::gethomedir() if $INC{&#039;Cpanel/PwCache.pm&#039;};
            return unless $homedir;                                                       # undef for homedir and cache_dir avoid issues later when using undef as hash key
        }

        Cpanel::SV::untaint($homedir);

        $homedir =~ tr{/}{}s;

        return ( $homedir, undef ) if $homedir eq &#039;/&#039;;

        $cache_dir = undef;
    }

    return ( $homedir, $cache_dir );
}

sub loadConfig {    ## no critic qw(Subroutines::ProhibitExcessComplexity Subroutines::ProhibitManyArgs)
    my ( $file, $conf_ref, $delimiter, $comment, $regexp_to_preprune, $allow_undef_values, $arg_ref ) = @_;

    $conf_ref ||= -1;

    my %processed_positional_args = _process_parse_args(
        delimiter          =&gt; $delimiter,
        comment            =&gt; $comment,
        regexp_to_preprune =&gt; $regexp_to_preprune,
        allow_undef_values =&gt; $allow_undef_values,
        $arg_ref ? %$arg_ref : (),
    );

    my $empty_is_invalid = ( defined $arg_ref ) ? delete $arg_ref-&gt;{&#039;empty_is_invalid&#039;} : undef;

    my ( $use_reverse, $use_hash_of_arr_refs );
    ( $delimiter, $comment, $regexp_to_preprune, $allow_undef_values, $use_reverse, $use_hash_of_arr_refs ) = @processed_positional_args{
        qw(
          delimiter
          comment
          regexp_to_preprune
          allow_undef_values
          use_reverse
          use_hash_of_arr_refs
        )
    };


    if ( !$file || $file =~ tr/\0// ) {
        _do_logger( &#039;warn&#039;, &#039;loadConfig requires valid filename&#039; );
        if ( $arg_ref-&gt;{&#039;keep_locked_open&#039;} ) {
            return ( undef, undef, undef, &quot;loadConfig requires valid filename&quot; );
        }

        return;
    }

    my $filesys_mtime = ( Cpanel::HiRes::stat($file) )[9] or do {
        if ( $arg_ref-&gt;{&#039;keep_locked_open&#039;} ) {
            return ( undef, undef, undef, &quot;Unable to stat $file: $!&quot; );
        }
        return;
    };

    my $load_into_conf_ref = ( !ref $conf_ref &amp;&amp; $conf_ref == -1 ) ? 0 : 1;

    if ($load_into_conf_ref) {
        $conf_ref = _hashify_ref($conf_ref);
    }

    $conf_ref = {} if !$load_into_conf_ref;

    my $conf_fh;
    my $conflock;
    my $locked;
    if ( $arg_ref-&gt;{&#039;keep_locked_open&#039;} || $arg_ref-&gt;{&#039;rw&#039;} ) {
        require Cpanel::SafeFile;
        $locked   = 1;
        $conflock = Cpanel::SafeFile::safeopen( $conf_fh, &#039;+&lt;&#039;, $file );
    }
    else {
        $conflock = open( $conf_fh, &#039;&lt;&#039;, $file );
    }

    if ( !$conflock ) {
        my $open_err = $! || &#039;(unspecified error)&#039;;

        local $_DEBUG_SAFEFILE = 1;

        require Cpanel::Logger;
        my $is_root = ( $&gt; == 0 ? 1 : 0 );

        if ( !$is_root &amp;&amp; !$arg_ref-&gt;{&#039;skip_readable_check&#039;} ) {
            if ( !-r $file ) {
                my $msg;

                if ( my $err = $! ) {
                    $msg = &quot;$file’s readability check failed: $err&quot;;
                }
                else {
                    my $euser = getpwuid $&gt;;
                    $msg = &quot;$file is not readable as $euser.&quot;;
                }

                _do_logger( &#039;warn&#039;, $msg );

                if ( $arg_ref-&gt;{&#039;keep_locked_open&#039;} ) {
                    return ( undef, undef, undef, $msg );
                }

                return;
            }
        }
        my $verb = ( $locked ? &#039;lock/&#039; : q&lt;&gt; ) . &#039;open&#039;;
        my $msg  = &quot;Unable to $verb $file as UIDs $&lt;/$&gt;: $open_err&quot;;

        Cpanel::Logger::cplog( $msg, &#039;warn&#039;, __PACKAGE__ );
        if ( $arg_ref-&gt;{&#039;keep_locked_open&#039;} ) {
            return ( undef, undef, undef, $msg );
        }
        return;
    }

    my ( $parse_ok, $parsed ) = _parse_from_filehandle(
        $conf_fh,
        comment              =&gt; $comment,
        delimiter            =&gt; $delimiter,
        regexp_to_preprune   =&gt; $regexp_to_preprune,
        allow_undef_values   =&gt; $allow_undef_values,
        use_reverse          =&gt; $use_reverse,
        use_hash_of_arr_refs =&gt; $use_hash_of_arr_refs,
        $arg_ref ? %$arg_ref : (),
    );

    if ( $locked &amp;&amp; !$arg_ref-&gt;{&#039;keep_locked_open&#039;} ) {
        require Cpanel::SafeFile;
        Cpanel::SafeFile::safeclose( $conf_fh, $conflock );
    }

    if ( !$parse_ok ) {
        require Cpanel::Logger;
        Cpanel::Logger::cplog( &quot;Unable to parse $file: $parsed&quot;, &#039;warn&#039;, __PACKAGE__ );
        if ( $arg_ref-&gt;{&#039;keep_locked_open&#039;} ) {
            return ( undef, undef, undef, &quot;Unable to parse $file: $parsed&quot; );
        }
        return;
    }

    @{$conf_ref}{ keys %$parsed } = values %$parsed;

    if ( $arg_ref-&gt;{&#039;keep_locked_open&#039;} ) {
        return $conf_ref, $conf_fh, $conflock, &quot;open success&quot;;
    }

    return $conf_ref;
}

sub load_from_cache_if_valid {
    my (%opts) = @_;

    my $cache_file = $opts{&#039;cache_file&#039;} or die &quot;need cache_file!&quot;;

    my $file               = $opts{&#039;file&#039;};
    my $conf_ref           = $opts{&#039;conf_ref&#039;};
    my $load_into_conf_ref = $opts{&#039;load_into_conf_ref&#039;};
    my $filesys_mtime      = $opts{&#039;filesys_mtime&#039;} || ( Cpanel::HiRes::stat($file) )[9];

    open( my $cache_fh, &#039;&lt;:stdio&#039;, $cache_file ) or do {
        my $err = $!;

        my $msg = &quot;non-fatal error: open($cache_file): $err&quot;;

        warn $msg if $! != _ENOENT();

        return ( 0, $msg );
    };

    my ( $cache_filesys_mtime, $now, $cache_conf_ref ) = ( ( Cpanel::HiRes::fstat($cache_fh) )[9], Cpanel::HiRes::time() );    # stat the file after we have it open to avoid a race condition

    if ( ( $Cpanel::Debug::level || 0 ) &gt;= 5 ) {
        print STDERR __PACKAGE__ . &quot;::loadConfig file:$file, cache_file:$cache_file, cache_filesys_mtime:$cache_filesys_mtime, filesys_mtime:$filesys_mtime, now:$now\n&quot;;
    }

    if ( $filesys_mtime &amp;&amp; _greater_with_same_precision( $cache_filesys_mtime, $filesys_mtime ) &amp;&amp; _greater_with_same_precision( $now, $cache_filesys_mtime ) ) {
        if ( ( $Cpanel::Debug::level || 0 ) &gt;= 5 ) {
            print STDERR __PACKAGE__ . &quot;::loadConfig using cache_file:$cache_file\n&quot;;
        }

        Cpanel::AdminBin::Serializer::FailOK::LoadModule() if !$INC{&#039;Cpanel/AdminBin/Serializer.pm&#039;};
        if ( $cache_conf_ref = Cpanel::AdminBin::Serializer::FailOK::LoadFile($cache_fh) ) {    #zero keys is a valid file still it may just be all comments or empty
            close($cache_fh);

            if ( $opts{&#039;empty_is_invalid&#039;} &amp;&amp; scalar keys %$cache_conf_ref == 0 ) {
                return ( 0, &#039;Cache is empty&#039; );
            }

            my $ref_to_return;
            if ($load_into_conf_ref) {
                @{$conf_ref}{ keys %$cache_conf_ref } = values %$cache_conf_ref;
                $ref_to_return = $conf_ref;
            }
            else {
                $ref_to_return = $cache_conf_ref;
            }

            return ( 1, $ref_to_return );
        }
        elsif ( ( $Cpanel::Debug::level || 0 ) &gt;= 5 ) {
            print STDERR __PACKAGE__ . &quot;::loadConfig failed to load cache_file:$cache_file\n&quot;;
        }

    }
    else {
        if ( ( $Cpanel::Debug::level || 0 ) &gt;= 5 ) {
            print STDERR __PACKAGE__ . &quot;::loadConfig NOT using cache_file:$cache_file\n&quot;;
        }
    }

    return ( 0, &#039;Cache not valid&#039; );
}

sub _greater_with_same_precision {
    my ( $float1, $float2 ) = @_;
    my ( $int1,   $int2 )   = ( int($float1), int($float2) );
    if ( $float1 == $int1 or $float2 == $int2 ) {
        return $int1 &gt; $int2;
    }
    return $float1 &gt; $float2;
}

sub get_cache_file {    ## no critic qw(Subroutines::RequireArgUnpacking) - Args unpacked by _process_parse_args
    my %opts = _process_parse_args(@_);

    die &#039;need cache_dir!&#039; if !$opts{&#039;cache_dir&#039;};

    my $stringified_args = join(
        &#039;__&#039;,
        @opts{qw(delimiter comment regexp_to_preprune allow_undef_values)}, ( scalar keys %{ $opts{&#039;arg_ref&#039;} } ? Cpanel::Hash::Stringify::sorted_hashref_string( $opts{&#039;arg_ref&#039;} ) : &#039;&#039; )
    );
    if ( ( $Cpanel::Debug::level || 0 ) &gt;= 5 ) {    # PPI NO PARSE -  ok missing
        print STDERR __PACKAGE__ . &quot;::loadConfig stringified_args[$stringified_args]\n&quot;;
    }

    my $safe_filename = $opts{&#039;file&#039;};
    $safe_filename =~ tr{/}{_};

    return $opts{&#039;cache_dir&#039;} . &#039;/&#039; . $safe_filename . &#039;___&#039; . ( $COMMON_CACHE_NAMES{$stringified_args} || _get_fastest_hash($stringified_args) );
}

sub _get_fastest_hash {
    require Cpanel::Hash;
    goto \&amp;Cpanel::Hash::get_fastest_hash;
}

sub write_cache {
    my (%opts)     = @_;
    my $cache_file = $opts{&#039;cache_file&#039;};
    my $cache_dir  = $opts{&#039;cache_dir&#039;};
    my $homedir    = $opts{&#039;homedir&#039;};
    my $is_root    = $opts{&#039;is_root&#039;};
    my $parsed     = $opts{&#039;data&#039;};

    my @dirs = ($cache_dir);
    if ( !$is_root ) {
        if ( $ENV{&#039;TEAM_USER&#039;} ) {
            unshift @dirs, &quot;$homedir/$ENV{&#039;TEAM_USER&#039;}&quot;, &quot;$homedir/$ENV{&#039;TEAM_USER&#039;}/.cpanel&quot;, &quot;$homedir/$ENV{&#039;TEAM_USER&#039;}/.cpanel/caches&quot;;
        }
        else {
            unshift @dirs, &quot;$homedir/.cpanel&quot;, &quot;$homedir/.cpanel/caches&quot;;
        }
    }

    foreach my $dir (@dirs) {
        Cpanel::SV::untaint($dir);

        chmod( $CACHE_DIR_PERMS, $dir ) or do {
            if ( $! == _ENOENT() ) {

                require Cpanel::Umask;
                my $umask = Cpanel::Umask-&gt;new(0);

                mkdir( $dir, $CACHE_DIR_PERMS ) or do {
                    _do_logger( &#039;warn&#039;, &quot;Failed to create dir “$dir”: $!&quot; );
                };
            }
            else {
                _do_logger( &#039;warn&#039;, &quot;chmod($dir): $!&quot; );
            }
        };

    }

    my $wrote_ok = eval { Cpanel::FileUtils::Write::JSON::Lazy::write_file( $cache_file, $parsed, 0600 ) };
    my $error    = $@;

    $error ||= &quot;Unknown error&quot; if !defined $wrote_ok;
    if ($error) {
        _do_logger( &#039;warn&#039;, &quot;Could not create cache file “$cache_file”: $error&quot; );
        unlink $cache_file;    #outdated
    }
    if ( ( $Cpanel::Debug::level || 0 ) &gt; 4 ) {    # PPI NO PARSE -  ok missing
        print STDERR __PACKAGE__ . &quot;::loadConfig [lazy write cache file] [$cache_file] wrote_ok:[$wrote_ok]\n&quot;;
    }
    return 1;
}

sub _do_logger {
    my ( $action, $msg ) = @_;

    require Cpanel::Logger;
    $logger ||= Cpanel::Logger-&gt;new();

    return $logger-&gt;$action($msg);
}

sub parse_from_filehandle {
    my ( $conf_fh, %opts ) = @_;
    return _parse_from_filehandle( $conf_fh, _process_parse_args(%opts) );
}

sub _parse_from_filehandle {
    my ( $conf_fh, %opts ) = @_;


    my ( $comment, $limit, $regexp_to_preprune, $delimiter, $allow_undef_values, $use_hash_of_arr_refs, $skip_keys, $use_reverse ) = @opts{
        qw(
          comment
          limit
          regexp_to_preprune
          delimiter
          allow_undef_values
          use_hash_of_arr_refs
          skip_keys
          use_reverse
        )
    };

    my $conf_ref = {};

    my $parser_code;
    my ( $k, $v );    ## no critic qw(Variables::ProhibitUnusedVariables)
    my $keys           = 0;
    my $key_value_text = $use_reverse ? &#039;1,0&#039; : &#039;0,1&#039;;
    my $cfg_txt        = &#039;&#039;;
    Cpanel::LoadFile::ReadFast::read_all_fast( $conf_fh, $cfg_txt );
    my $has_cr = index( $cfg_txt, &quot;\r&quot; ) &gt; -1 ? 1 : 0;
    _remove_comments_from_text( \$cfg_txt, $comment, \$has_cr ) if $cfg_txt &amp;&amp; $comment;

    my $split_on = $has_cr ? &#039;\r?\n&#039; : &#039;\n&#039;;

    if ( !$limit &amp;&amp; !$regexp_to_preprune &amp;&amp; !$use_hash_of_arr_refs &amp;&amp; length $delimiter ) {
        if ($allow_undef_values) {
            $parser_code = qq&lt;
                  \$conf_ref = {
                      map {
                          (split(m/&gt; . $delimiter . qq&lt;/, \$_, 2))[$key_value_text]
                      } split(/&gt; . $split_on . qq&lt;/, \$cfg_txt)
                  };
              &gt;;
        }
        else {
            $parser_code = &#039; $conf_ref = {  map { &#039; . &#039;($k,$v) = (split(m/&#039; . $delimiter . &#039;/, $_, 2))[&#039; . $key_value_text . &#039;]; &#039; . &#039;defined($v) ? ($k,$v) : () &#039; . &#039;} split(/&#039; . $split_on . &#039;/, $cfg_txt ) }&#039;;
        }
    }
    else {
        if ( ( $Cpanel::Debug::level || 0 ) &gt; 4 ) {    # PPI NO PARSE - ok if not there
            $limit ||= 0;
            print STDERR __PACKAGE__ . &quot;::parse_from_filehandle [slow LoadConfig parser used] LIMIT:[!$limit] REGEXP_TO_DELETE[!$regexp_to_preprune] USE_HASH_OF_ARR_REFS[$use_hash_of_arr_refs)]\n&quot;;
        }
        $parser_code = &#039;foreach (split(m/&#039; . $split_on . &#039;/, $cfg_txt)) {&#039; . &quot;\n&quot;                                                                            #
          . q{next if !length;} . &quot;\n&quot;                                                                                                                       #
          . ( $limit ? q{last if $keys++ == } . $limit . &#039;;&#039; : &#039;&#039; ) . &quot;\n&quot; . ( $regexp_to_preprune ? q{ s/} . $regexp_to_preprune . q{//g;} : &#039;&#039; ) . &quot;\n&quot;    #
          . (
            length $delimiter ?                                                                                                                              #
              (
                q{( $k, $v ) = (split( /} . $delimiter . q{/, $_, 2 ))[} . $key_value_text . q{];} . &quot;\n&quot; .                                                  #
                  ( !$allow_undef_values  ? q{ next if !defined($v); }          : &#039;&#039; ) . &quot;\n&quot; .                                                              #
                  ( $use_hash_of_arr_refs ? q{ push @{ $conf_ref-&gt;{$k} }, $v; } : q{ $conf_ref-&gt;{$k} = $v; } ) . &quot;\n&quot;                                        #
              )
            : q{$conf_ref-&gt;{$_} = 1; } . &quot;\n&quot;
          ) . &#039;};&#039;;
    }

    $parser_code .= &quot;; 1&quot;;
    $parser_code =~ tr{\n}{\r};    ## no critic qw(Cpanel::TransliterationUsage)
    eval($parser_code) or do {     ## no critic qw(BuiltinFunctions::ProhibitStringyEval)
        $parser_code =~ tr{\r}{\n};    ## no critic qw(Cpanel::TransliterationUsage)
        _do_logger( &#039;panic&#039;, &quot;Failed to parse :: $parser_code: $@&quot; );
        return ( 0, &quot;$@\n$parser_code&quot; );
    };

    delete $conf_ref-&gt;{&#039;&#039;} if !defined( $conf_ref-&gt;{&#039;&#039;} );

    if ($skip_keys) {
        my $skip_keys_ar;
        if ( ref $skip_keys eq &#039;ARRAY&#039; ) {
            $skip_keys_ar = $skip_keys;
        }
        elsif ( ref $skip_keys eq &#039;HASH&#039; ) {
            $skip_keys_ar = [ keys %$skip_keys ];
        }
        else {
            return ( 0, &#039;skip_keys must be an ARRAY or HASH reference&#039; );
        }
        delete @{$conf_ref}{@$skip_keys_ar};
    }

    return ( 1, $conf_ref );
}

sub _hashify_ref {
    my $conf_ref = shift;

    if ( !defined($conf_ref) ) {
        $conf_ref = {};
        return $conf_ref;
    }

    unless ( ref $conf_ref eq &#039;HASH&#039; ) {
        if ( ref $conf_ref ) {
            require Cpanel::Logger;
            Cpanel::Logger::cplog( &#039;hashifying non-HASH reference&#039;, &#039;warn&#039;, __PACKAGE__ );

            ${$conf_ref} = {};
            $conf_ref = ${$conf_ref};
        }
        else {
            require Cpanel::Logger;
            Cpanel::Logger::cplog( &#039;defined value encountered where reference expected&#039;, &#039;die&#039;, __PACKAGE__ );
        }
    }
    return $conf_ref;
}

sub default_product_dir {
    $PRODUCT_CONF_DIR = shift if @_;
    return $PRODUCT_CONF_DIR;
}

sub _remove_comments_from_text {
    my ( $cfg_txt_sr, $comment, $has_cr_sr ) = @_;
    if ($$has_cr_sr) {
        $$cfg_txt_sr = join( &quot;\n&quot;, grep ( !m/$comment/, split( m{\r?\n}, $$cfg_txt_sr ) ) );
        $$has_cr_sr  = 0;
    }
    elsif ( $comment eq $DEFAULT_COMMENT_REGEXP ) {

        if ( rindex( $$cfg_txt_sr, &#039;#&#039;, 0 ) == 0 &amp;&amp; index( $$cfg_txt_sr, &quot;\n&quot; ) &gt; -1 ) {
            substr( $$cfg_txt_sr, 0, index( $$cfg_txt_sr, &quot;\n&quot; ) + 1, &#039;&#039; );
        }
        $$cfg_txt_sr =~ s{$DEFAULT_COMMENT_REGEXP.*}{}omg if $$cfg_txt_sr =~ tr{#;}{};
    }
    else {
        $$cfg_txt_sr =~ s{$comment.*}{}mg;
    }
    return 1;
}

1;

} # --- END Cpanel/Config/LoadConfig.pm


{ # --- BEGIN Cpanel/Config/LoadWwwAcctConf.pm
package Cpanel::Config::LoadWwwAcctConf;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::HiRes (); # perlpkg line 211

# use Cpanel::Path::Normalize (); # perlpkg line 211
# use Cpanel::Debug           (); # perlpkg line 211
# use Cpanel::JSON::FailOK    (); # perlpkg line 211

my $SYSTEM_CONF_DIR = &#039;/etc&#039;;
my $wwwconf_cache;
my $wwwconf_mtime = 0;

my $has_serializer;

our $wwwacctconf       = &quot;$SYSTEM_CONF_DIR/wwwacct.conf&quot;;
our $wwwacctconfshadow = &quot;$SYSTEM_CONF_DIR/wwwacct.conf.shadow&quot;;

sub import {
    my $this = shift;
    if ( !exists $INC{&#039;Cpanel/JSON.pm&#039;} ) {
        Cpanel::JSON::FailOK::LoadJSONModule();
    }
    if ( $INC{&#039;Cpanel/JSON.pm&#039;} ) {
        $has_serializer = 1;
    }
    return Exporter::import( $this, @_ );
}

sub loadwwwacctconf {    ## no critic qw(Subroutines::ProhibitExcessComplexity)
    if ( $INC{&#039;Cpanel/JSON.pm&#039;} ) { $has_serializer = 1; }    #something else loaded it

    my $filesys_mtime = ( Cpanel::HiRes::stat($wwwacctconf) )[9];

    return if !$filesys_mtime;

    if ( $filesys_mtime == $wwwconf_mtime &amp;&amp; $wwwconf_cache ) {
        return wantarray ? %{$wwwconf_cache} : $wwwconf_cache;
    }

    my $wwwacctconf_cache       = &quot;$wwwacctconf.cache&quot;;
    my $wwwacctconfshadow_cache = &quot;$wwwacctconfshadow.cache&quot;;
    my $is_root                 = $&gt; ? 0 : 1;

    if ($has_serializer) {
        my $cache_file;
        my $cache_filesys_mtime;
        my $have_valid_cache = 1;

        if ( $is_root &amp;&amp; -e $wwwacctconfshadow_cache ) {
            $cache_filesys_mtime = ( Cpanel::HiRes::stat($wwwacctconfshadow_cache) )[9];    #shadow cache&#039;s mtime

            my $shadow_file_mtime = ( Cpanel::HiRes::stat $wwwacctconfshadow )[9] || 0;
            if ( $shadow_file_mtime &lt; $cache_filesys_mtime ) {
                $cache_file = $wwwacctconfshadow_cache;
            }
            else {    #don&#039;t use shadow cache if shadow file is newer
                $have_valid_cache = undef;
            }
        }

        elsif ( -e $wwwacctconf_cache &amp;&amp; !( $is_root &amp;&amp; -r $wwwacctconfshadow ) ) {
            $cache_filesys_mtime = ( Cpanel::HiRes::stat $wwwacctconf_cache )[9];    #regular cache&#039;s mtime
            $cache_file          = $wwwacctconf_cache;
        }
        else {
            $have_valid_cache = undef;
        }
        my $now = Cpanel::HiRes::time();

        if ( $Cpanel::Debug::level &gt;= 5 ) {
            print STDERR __PACKAGE__ . &quot;::loadwwwacctconf cache_filesys_mtime = $cache_filesys_mtime , filesys_mtime: $filesys_mtime , now : $now\n&quot;;
        }

        if ( $have_valid_cache &amp;&amp; $cache_filesys_mtime &gt; $filesys_mtime &amp;&amp; $cache_filesys_mtime &lt; $now ) {
            my $wwwconf_ref;
            if ( open( my $conf_fh, &#039;&lt;&#039;, $cache_file ) ) {
                $wwwconf_ref = Cpanel::JSON::FailOK::LoadFile($conf_fh);
                close($conf_fh);
            }

            if ( $wwwconf_ref &amp;&amp; ( scalar keys %{$wwwconf_ref} ) &gt; 0 ) {
                if ( $Cpanel::Debug::level &gt;= 5 ) { print STDERR __PACKAGE__ . &quot;::loadwwwconf file system cache hit\n&quot;; }
                $wwwconf_cache = $wwwconf_ref;
                $wwwconf_mtime = $filesys_mtime;
                return wantarray ? %{$wwwconf_ref} : $wwwconf_ref;
            }
        }
    }

    my @configfiles;
    push @configfiles, $wwwacctconf;

    if ($is_root) { push @configfiles, $wwwacctconfshadow; }    #shadow file must be last as the cache gets written for each file with all the files before it in it

    my $can_write_cache;
    if ( $is_root &amp;&amp; $has_serializer ) {
        $can_write_cache = 1;
    }

    my %CONF = (
        &#039;ADDR&#039;         =&gt; undef,
        &#039;CONTACTEMAIL&#039; =&gt; undef,
        &#039;DEFMOD&#039;       =&gt; undef,
        &#039;ETHDEV&#039;       =&gt; undef,
        &#039;HOST&#039;         =&gt; undef,
        &#039;NS&#039;           =&gt; undef,
        &#039;NS2&#039;          =&gt; undef,
    );
    require Cpanel::Config::LoadConfig;
    foreach my $configfile (@configfiles) {
        Cpanel::Config::LoadConfig::loadConfig( $configfile, \%CONF, &#039;\s+&#039;, undef, undef, undef, { &#039;nocache&#039; =&gt; 1 } );

        foreach ( keys %CONF ) {

            $CONF{$_} =~ s{\s+$}{} if defined $CONF{$_};
        }

        $CONF{&#039;HOMEMATCH&#039;} =~ s{/+$}{} if defined $CONF{&#039;HOMEMATCH&#039;};    # Remove trailing slashes

        $CONF{&#039;HOMEDIR&#039;} = Cpanel::Path::Normalize::normalize( $CONF{&#039;HOMEDIR&#039;} ) if defined $CONF{&#039;HOMEDIR&#039;};

        if ($can_write_cache) {
            my $cache_file = $configfile . &#039;.cache&#039;;
            require Cpanel::FileUtils::Write::JSON::Lazy;
            Cpanel::FileUtils::Write::JSON::Lazy::write_file( $cache_file, \%CONF, ( $configfile eq $wwwacctconfshadow ) ? 0600 : 0644 );
        }
    }

    $wwwconf_mtime = $filesys_mtime;
    $wwwconf_cache = \%CONF;

    return wantarray ? %CONF : \%CONF;
}

sub reset_mem_cache {
    ( $wwwconf_mtime, $wwwconf_cache ) = ( 0, undef );
}

sub reset_has_serializer {
    $has_serializer = 0;
}

sub default_conf_dir {
    $SYSTEM_CONF_DIR = shift if @_;

    $wwwacctconf       = &quot;$SYSTEM_CONF_DIR/wwwacct.conf&quot;;
    $wwwacctconfshadow = &quot;$SYSTEM_CONF_DIR/wwwacct.conf.shadow&quot;;

    return $SYSTEM_CONF_DIR;
}

sub reset_caches {
    my @cache_files = map { &quot;$_.cache&quot; } ( $wwwacctconf, $wwwacctconfshadow );

    for my $cache_file (@cache_files) {
        unlink $cache_file if -e $cache_file;
    }

    reset_mem_cache();

    return;
}

1;

} # --- END Cpanel/Config/LoadWwwAcctConf.pm


{ # --- BEGIN Cpanel/Conf.pm
package Cpanel::Conf;


# use Cpanel::Config::Constants (); # perlpkg line 211
my $cpanel_theme;
my $webmail_theme;

sub new {
    my ( $class, %opts ) = @_;
    my $self = {};
    bless $self, $class;
    if ( exists $opts{&#039;wwwacct&#039;} &amp;&amp; ref $opts{&#039;wwwacct&#039;} eq &#039;HASH&#039; ) {
        $self-&gt;{&#039;wwwacct&#039;} = $opts{&#039;wwwacct&#039;};
    }

    undef $cpanel_theme;
    undef $webmail_theme;

    return $self;
}

sub system_config_dir {
    my ($self) = @_;
    return &#039;/etc&#039;;
}

sub product_config_dir {
    my ($self) = @_;
    return &#039;/var/cpanel&#039;;
}

sub product_base_dir {
    my ($self) = @_;
    return &#039;/usr/local/cpanel&#039;;
}

sub whm_base_dir {
    my ($self) = @_;
    return $self-&gt;product_base_dir . &#039;/whostmgr&#039;;
}

sub cpanel_theme_dir {
    my ($self) = @_;
    return $self-&gt;product_base_dir . &#039;/base/frontend&#039;;
}

sub whm_theme_dir {
    my ($self) = @_;
    return $self-&gt;whm_base_dir . &#039;/docroot/themes&#039;;
}

sub whm_theme {
    my ($self) = @_;
    return &#039;x&#039;;
}

sub account_creation_defaults {
    my ($self) = @_;
    if ( exists $self-&gt;{&#039;wwwacct&#039;} ) {
        my %wwwacct = %{ $self-&gt;{&#039;wwwacct&#039;} };
        return \%wwwacct;
    }
    require Cpanel::Config::LoadWwwAcctConf;
    return Cpanel::Config::LoadWwwAcctConf::loadwwwacctconf();
}

sub cpanel_theme {
    my ($self) = @_;
    return $cpanel_theme if defined $cpanel_theme;

    $cpanel_theme = $Cpanel::Config::Constants::DEFAULT_CPANEL_THEME;

    my $defaults = {};
    $defaults = $self-&gt;account_creation_defaults();
    if ( ref $defaults eq &#039;HASH&#039; &amp;&amp; $defaults-&gt;{&#039;DEFMOD&#039;} ) {
        $cpanel_theme = $defaults-&gt;{&#039;DEFMOD&#039;};
    }
    return $cpanel_theme;
}

sub default_webmail_theme {
    my ($self) = @_;
    return $webmail_theme if defined $webmail_theme;

    $webmail_theme = $Cpanel::Config::Constants::DEFAULT_WEBMAIL_THEME;

    my $defaults = {};
    $defaults = $self-&gt;account_creation_defaults();
    if ( ref $defaults eq &#039;HASH&#039; &amp;&amp; $defaults-&gt;{&#039;DEFMOD&#039;} ) {
        $webmail_theme = $defaults-&gt;{&#039;DEFMOD&#039;};
    }
    return $webmail_theme;
}

1;

} # --- END Cpanel/Conf.pm


{ # --- BEGIN Cpanel/Config/LoadCpUserFile.pm
package Cpanel::Config::LoadCpUserFile;


use strict;
use warnings;
no warnings &#039;once&#039;;


use Try::Tiny;

# use Cpanel::DB::Utils                    (); # perlpkg line 211
# use Cpanel::Exception                    (); # perlpkg line 211
# use Cpanel::FileUtils::Write::JSON::Lazy (); # perlpkg line 211
# use Cpanel::AdminBin::Serializer::FailOK (); # perlpkg line 211
# use Cpanel::Config::Constants            (); # perlpkg line 211
# use Cpanel::Config::CpUser::Defaults     (); # perlpkg line 211
# use Cpanel::Config::CpUser::Object       (); # perlpkg line 211
# use Cpanel::ConfigFiles                  (); # perlpkg line 211
# use Cpanel::LoadFile::ReadFast           (); # perlpkg line 211
# use Cpanel::SV                           (); # perlpkg line 211

our $VERSION = &#039;0.82&#039;;    # DO NOT CHANGE THIS FROM A DECIMAL

sub _cpuser_defaults {
    return @Cpanel::Config::CpUser::Defaults::DEFAULTS_KV;
}

my %should_never_be_on_disk = map { $_ =&gt; undef } qw(
  DBOWNER
  DOMAIN
  DOMAINS
  DEADDOMAINS
  HOMEDIRLINKS
);

my $logger;


sub load_or_die {
    return ( _load( $_[0], undef, if_missing =&gt; &#039;die&#039; ) )[2];
}

sub load_if_exists {
    return ( _load( $_[0], undef, if_missing =&gt; &#039;return&#039; ) )[2] // undef;
}

sub load_file {
    my ($file) = @_;


    return parse_cpuser_file( _open_cpuser_file( &#039;&lt;&#039;, $file ) );
}

sub _open_cpuser_file_locked {
    my ( $mode, $file ) = @_;

    local $!;

    my $cpuser_fh;

    require Cpanel::SafeFile;
    my $lock_obj = Cpanel::SafeFile::safeopen( $cpuser_fh, $mode, $file ) or do {
        die Cpanel::Exception::create( &#039;IO::FileOpenError&#039;, [ path =&gt; $file, error =&gt; $!, mode =&gt; $mode ] );
    };

    return ( $lock_obj, $cpuser_fh );
}

sub _open_cpuser_file {
    my ( $mode, $file ) = @_;

    local $!;

    my $cpuser_fh;

    open( $cpuser_fh, $mode, $file ) or do {
        die Cpanel::Exception::create( &#039;IO::FileOpenError&#039;, [ path =&gt; $file, error =&gt; $!, mode =&gt; $mode ] );
    };
    return $cpuser_fh;
}

sub parse_cpuser_file {
    my ($cpuser_fh) = @_;

    my $buffer = &#039;&#039;;
    Cpanel::LoadFile::ReadFast::read_all_fast( $cpuser_fh, $buffer );

    return parse_cpuser_file_buffer($buffer);
}


sub parse_cpuser_file_buffer {
    my ($buffer) = @_;

    my %cpuser = _cpuser_defaults();

    my %DOMAIN_MAP;
    my %DEAD_DOMAIN_MAP;
    my %HOMEDIRLINKS_MAP;

    local ( $!, $_ );

    foreach ( split( m{\n}, $buffer ) ) {
        next if index( $_, &#039;#&#039; ) &gt; -1 &amp;&amp; m/^\s*#/;

        my ( $key, $value ) = split( /\s*=/, $_, 2 );

        if ( !defined $value || exists $should_never_be_on_disk{$key} ) {
            next;

        }
        elsif ( $key eq &#039;DNS&#039; ) {
            $cpuser{&#039;DOMAIN&#039;} = lc $value;
        }

        elsif ( index( $key, &#039;DNS&#039; ) == 0 &amp;&amp; substr( $key, 3, 1 ) =~ tr{0-9}{} ) {
            $DOMAIN_MAP{ lc $value } = undef;
        }
        elsif ( index( $key, &#039;XDNS&#039; ) == 0 &amp;&amp; substr( $key, 4, 1 ) =~ tr{0-9}{} ) {
            $DEAD_DOMAIN_MAP{ lc $value } = undef;
        }
        elsif ( index( $key, &#039;HOMEDIRPATHS&#039; ) == 0 &amp;&amp; $key =~ m{ \A HOMEDIRPATHS \d* \z }xms ) {
            $HOMEDIRLINKS_MAP{$value} = undef;
        }
        else {
            $cpuser{$key} = $value;
        }
    }

    delete @DEAD_DOMAIN_MAP{ keys %DOMAIN_MAP };
    delete $DOMAIN_MAP{ $cpuser{&#039;DOMAIN&#039;} };

    if ($!) {
        die Cpanel::Exception::create( &#039;IO::FileReadError&#039;, [ error =&gt; $! ] );
    }

    if ( exists $cpuser{&#039;USER&#039;} ) {

        $cpuser{&#039;DBOWNER&#039;} = Cpanel::DB::Utils::username_to_dbowner( $cpuser{&#039;USER&#039;} );
    }

    if ( !length $cpuser{&#039;RS&#039;} ) {
        require Cpanel::Conf;
        my $cp_defaults = Cpanel::Conf-&gt;new();
        $cpuser{&#039;RS&#039;} = $cp_defaults-&gt;cpanel_theme;
    }

    if ( !$cpuser{&#039;LOCALE&#039;} ) {
        $cpuser{&#039;LOCALE&#039;}           = &#039;en&#039;;
        $cpuser{&#039;__LOCALE_MISSING&#039;} = 1;
    }
    $cpuser{&#039;DOMAINS&#039;}      = [ sort keys %DOMAIN_MAP ];         # Sorted here so they can be tested with TM::is_deeply
    $cpuser{&#039;DEADDOMAINS&#039;}  = [ sort keys %DEAD_DOMAIN_MAP ];    # Sorted here so they can be tested with TM::is_deeply
    $cpuser{&#039;HOMEDIRLINKS&#039;} = [ sort keys %HOMEDIRLINKS_MAP ];

    return _wrap_cpuser( \%cpuser );
}

sub _wrap_cpuser {
    return Cpanel::Config::CpUser::Object-&gt;adopt(shift);
}

sub _logger {
    return $logger ||= do {
        require Cpanel::Logger;
        Cpanel::Logger-&gt;new();
    };
}

sub load {
    my ( $user, $opts ) = @_;

    my $cpuser = ( _load( $user, $opts ) )[2];

    if ( !ref $cpuser ) {
        _logger()-&gt;warn( &quot;Failed to load cPanel user file for &#039;&quot; . ( $user || &#039;&#039; ) . &quot;&#039;&quot; ) unless $opts-&gt;{&#039;quiet&#039;};
        return wantarray ? () : bless( {}, &#039;Cpanel::Config::CpUser::Object&#039; );
    }
    return wantarray ? %$cpuser : $cpuser;
}

sub _load_locked {
    my ($user) = @_;

    my ( $fh, $lock_fh, $cpuser ) = _load( $user, { lock =&gt; 1 } );

    return unless $fh &amp;&amp; $lock_fh &amp;&amp; $cpuser;

    return {
        &#039;file&#039; =&gt; $fh,
        &#039;lock&#039; =&gt; $lock_fh,
        &#039;data&#039; =&gt; $cpuser,
    };
}

sub clear_cache {
    my ($user) = @_;

    return unlink &quot;$Cpanel::ConfigFiles::cpanel_users.cache/$user&quot;;
}

sub _load {    ## no critic(Subroutines::ProhibitExcessComplexity)  -- Refactoring this function is a project, not a bug fix
    my ( $user, $load_opts_ref, %internal_opts ) = @_;

    if ( !$user || $user =~ tr&lt;/\0&gt;&lt;&gt; ) {    #no eq &#039;&#039; needed as !$user covers this
        _logger()-&gt;warn(&quot;Invalid username (falsy or forbidden character) given to loadcpuserfile.&quot;);

        if ( $internal_opts{&#039;if_missing&#039;} ) {
            die Cpanel::Exception::create( &#039;UserNotFound&#039;, [ name =&gt; &#039;&#039; ] );
        }

        return;
    }

    my ( $now, $has_serializer, $user_file, $user_cache_file ) = (
        time(),                                                                    #now
        ( exists $INC{&#039;Cpanel/JSON.pm&#039;} ? 1 : 0 ),                                 #has_serializer
        $load_opts_ref-&gt;{&#039;file&#039;} || &quot;$Cpanel::ConfigFiles::cpanel_users/$user&quot;,    # user_file
        &quot;$Cpanel::ConfigFiles::cpanel_users.cache/$user&quot;,                          # user_cache_file
    );

    my ( $cpuid, $cpgid, $size, $mtime ) = ( stat($user_file) )[ 4, 5, 7, 9 ];

    if ( not defined($size) and my $if_missing = $internal_opts{&#039;if_missing&#039;} ) {
        if ( $! == _ENOENT() ) {
            if ( $if_missing eq &#039;return&#039; ) {
                return;
            }

            die Cpanel::Exception::create( &#039;UserNotFound&#039;, [ name =&gt; $user ] );
        }
        die Cpanel::Exception-&gt;create( &#039;The system failed to find the file “[_1]” because of an error: [_2]&#039;, [ $user_file, $! ] );
    }

    $mtime ||= 0;

    my $lock_fh;
    my $cpuser_fh;

    if ( $load_opts_ref-&gt;{&#039;lock&#039;} ) {
        my $mode = $mtime ? &#039;+&lt;&#039; : &#039;+&gt;&#039;;
        try {
            ( $lock_fh, $cpuser_fh ) = _open_cpuser_file_locked( $mode, $user_file );
        }
        catch {
            if ( my $if_missing = $internal_opts{&#039;if_missing&#039;} ) {
                die $_ if $if_missing ne &#039;return&#039;;
            }
            else {
                _logger()-&gt;warn($_);
            }
        };

        return if !$lock_fh;
    }
    elsif ( !$size ) {
        if ( $user eq &#039;cpanel&#039; ) {
            my $result = _load_cpanel_user();
            _wrap_cpuser($result);
            return ( $cpuser_fh, $lock_fh, $result );
        }
        else {
            _logger()-&gt;warn(&quot;User file &#039;$user_file&#039; is empty or non-existent.&quot;) unless $load_opts_ref-&gt;{&#039;quiet&#039;};
            return;
        }
    }

    if ( $Cpanel::Debug::level &amp;&amp; $Cpanel::Debug::level &gt; 3 ) {    # PPI NO PARSE - This doesn&#039;t need to be loaded
        _logger()-&gt;debug(&quot;load cPanel user file [$user]&quot;);
    }

    if ($has_serializer) {
        Cpanel::SV::untaint($user_cache_file);                        # case CPANEL-11199
        if ( open( my $cache_fh, &#039;&lt;:stdio&#039;, $user_cache_file ) ) {    #ok if the file is not there
            my $cache_mtime = ( stat($cache_fh) )[9];                 # Check the mtime after we have opened the file to prevent a race condition
            if ( $cache_mtime &gt;= $mtime &amp;&amp; $cache_mtime &lt;= $now ) {
                my $cpuser_ref = Cpanel::AdminBin::Serializer::FailOK::LoadFile($cache_fh);
                if ( $cpuser_ref &amp;&amp; ref $cpuser_ref eq &#039;HASH&#039; ) {
                    if ( $Cpanel::Debug::level &amp;&amp; $Cpanel::Debug::level &gt; 3 ) {    # PPI NO PARSE - This doesn&#039;t need to be loaded
                        _logger()-&gt;debug(&quot;load cache hit user[$user] now[$now] mtime[$mtime] cache_mtime[$cache_mtime]&quot;);
                    }
                    $cpuser_ref-&gt;{&#039;MTIME&#039;} = $mtime;

                    if ( ( $cpuser_ref-&gt;{&#039;__CACHE_DATA_VERSION&#039;} // 0 ) == $VERSION ) {
                        _wrap_cpuser($cpuser_ref);
                        return ( $cpuser_fh, $lock_fh, $cpuser_ref );
                    }
                    else {
                        unlink $user_cache_file;    # force a re-cache of the latest data set
                    }
                }
            }
            else {
                if ( $Cpanel::Debug::level &amp;&amp; $Cpanel::Debug::level &gt; 3 ) {    # PPI NO PARSE - This doesn&#039;t need to be loaded
                    _logger()-&gt;debug(&quot;load cache miss user[$user] now[$now] mtime[$mtime] cache_mtime[$cache_mtime]&quot;);
                }
            }
            close($cache_fh);
        }
        else {
            if ( $Cpanel::Debug::level &amp;&amp; $Cpanel::Debug::level &gt; 3 ) {    # PPI NO PARSE - This doesn&#039;t need to be loaded
                _logger()-&gt;debug(&quot;load cache miss user[$user] now[$now] mtime[$mtime] cache_mtime[0]&quot;);
            }
        }
    }

    if ( !$lock_fh ) {
        try {
            $cpuser_fh = _open_cpuser_file( &#039;&lt;&#039;, $user_file );
        }
        catch {
            die $_ if $internal_opts{&#039;if_missing&#039;};

            _logger()-&gt;warn($_);
        };

        return if !$cpuser_fh;
    }

    my $cpuser_hr;
    try {
        $cpuser_hr = parse_cpuser_file($cpuser_fh);
    }
    catch {
        _logger()-&gt;warn(&quot;Failed to read “$user_file”: $_&quot;);
    };

    return if !$cpuser_hr;

    $cpuser_hr-&gt;{&#039;USER&#039;}    = $user;
    $cpuser_hr-&gt;{&#039;DBOWNER&#039;} = Cpanel::DB::Utils::username_to_dbowner($user);

    $cpuser_hr-&gt;{&#039;__CACHE_DATA_VERSION&#039;} = $VERSION;    # set this before the cache is written so that it will be included in the cache
    if ( $&gt; == 0 ) {
        create_users_cache_dir();
        if ( $has_serializer &amp;&amp; Cpanel::FileUtils::Write::JSON::Lazy::write_file( $user_cache_file, $cpuser_hr, 0640 ) ) {
            chown 0, $cpgid, $user_cache_file if $cpgid;    # this is ok if the chown happens after as we fall though to reading the non-cache on a failed open
        }
        else {
            unlink $user_cache_file;                        #outdated
        }
    }

    $cpuser_hr-&gt;{&#039;MTIME&#039;} = ( stat($cpuser_fh) )[9];
    if ( $load_opts_ref-&gt;{&#039;lock&#039;} ) {
        seek( $cpuser_fh, 0, 0 );
    }
    else {
        if ($lock_fh) {
            require Cpanel::SafeFile;
            Cpanel::SafeFile::safeclose( $cpuser_fh, $lock_fh );
        }
        $cpuser_fh = $lock_fh = undef;
    }

    return ( $cpuser_fh, $lock_fh, $cpuser_hr );
}

sub loadcpuserfile {
    return load( $_[0] );
}

sub _load_cpanel_user {
    my %cpuser = (
        _cpuser_defaults(),
        &#039;DEADDOMAINS&#039;  =&gt; [],
        &#039;DOMAIN&#039;       =&gt; &#039;domain.tld&#039;,
        &#039;DOMAINS&#039;      =&gt; [],
        &#039;HASCGI&#039;       =&gt; 1,
        &#039;HOMEDIRLINKS&#039; =&gt; [],
        &#039;LOCALE&#039;       =&gt; &#039;en&#039;,
        &#039;MAXADDON&#039;     =&gt; &#039;unlimited&#039;,
        &#039;MAXPARK&#039;      =&gt; &#039;unlimited&#039;,
        &#039;RS&#039;           =&gt; $Cpanel::Config::Constants::DEFAULT_CPANEL_THEME,
        &#039;USER&#039;         =&gt; &#039;cpanel&#039;,
    );

    return wantarray ? %cpuser : \%cpuser;
}

sub create_users_cache_dir {
    my $uc = &quot;$Cpanel::ConfigFiles::cpanel_users.cache&quot;;
    if ( -f $uc || -l $uc ) {
        my $bad = &quot;$uc.bad&quot;;
        unlink $bad if -e $bad;
        rename $uc, $bad;
    }
    if ( !-e $uc ) {
        mkdir $uc;
    }
    return;
}

sub _ENOENT { return 2; }

1;

} # --- END Cpanel/Config/LoadCpUserFile.pm


{ # --- BEGIN Cpanel/Config/HasCpUserFile.pm
package Cpanel::Config::HasCpUserFile;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::ConfigFiles (); # perlpkg line 211


sub has_cpuser_file {
    return 0 if !length $_[0] || $_[0] =~ tr{/\0}{};
    return -e &quot;$Cpanel::ConfigFiles::cpanel_users/$_[0]&quot; &amp;&amp; -s _;
}


sub has_readable_cpuser_file {
    my ($user) = @_;
    return unless defined $user and $user ne &#039;&#039; and $user !~ tr/\/\0//;

    return -e &quot;$Cpanel::ConfigFiles::cpanel_users/$user&quot; &amp;&amp; -s _ &amp;&amp; -r _;
}

1;

} # --- END Cpanel/Config/HasCpUserFile.pm


{ # --- BEGIN Cpanel/NSCD/Constants.pm
package Cpanel::NSCD::Constants;


use strict;

our $NSCD_CONFIG_FILE = &#039;/etc/nscd.conf&#039;;
our $NSCD_SOCKET      = &#039;/var/run/nscd/socket&#039;;

1;

} # --- END Cpanel/NSCD/Constants.pm


{ # --- BEGIN Cpanel/Socket/UNIX/Micro.pm
package Cpanel::Socket::UNIX::Micro;


use strict;

my $MAX_PATH_LENGTH        = 107;
my $LITTLE_ENDIAN_TEMPLATE = &#039;vZ&#039; . ( 1 + $MAX_PATH_LENGTH );    # x86_64 is always little endian
my $AF_UNIX                = 1;
my $SOCK_STREAM            = 1;

sub connect {
    socket( $_[0], $AF_UNIX, $SOCK_STREAM, 0 ) or warn &quot;socket(AF_UNIX, SOCK_STREAM): $!&quot;;
    return connect( $_[0], micro_sockaddr_un( $_[1] ) );
}

sub micro_sockaddr_un {

    if ( length( $_[0] ) &gt; $MAX_PATH_LENGTH ) {
        my $excess = length( $_[0] ) - $MAX_PATH_LENGTH;
        die &quot;“$_[0]” is $excess character(s) too long to be a path to a local socket ($MAX_PATH_LENGTH bytes maximum)!&quot;;
    }

    return pack( &#039;va*&#039;, $AF_UNIX, $_[0] ) if 0 == rindex( $_[0], &quot;\0&quot;, 0 );

    return pack(
        $LITTLE_ENDIAN_TEMPLATE,    # x86_64 is always little endian
        $AF_UNIX,
        $_[0],
    );
}

sub unpack_sockaddr_un {

    return substr( $_[0], 2 ) if 2 == rindex( $_[0], &quot;\0&quot;, 2 );

    return ( unpack $LITTLE_ENDIAN_TEMPLATE, $_[0] )[1];
}

1;

} # --- END Cpanel/Socket/UNIX/Micro.pm


{ # --- BEGIN Cpanel/NSCD/Check.pm
package Cpanel::NSCD::Check;


use strict;

# use Cpanel::NSCD::Constants     (); # perlpkg line 211
# use Cpanel::Socket::UNIX::Micro (); # perlpkg line 211

our $CACHE_TTL = 600;

my $last_check_time = 0;
my $nscd_is_running_cache;

sub nscd_is_running {
    my $now = time();
    if ( $last_check_time &amp;&amp; $last_check_time + $CACHE_TTL &gt; $now ) {
        return $nscd_is_running_cache;
    }

    $last_check_time = $now;
    my $socket;
    if ( Cpanel::Socket::UNIX::Micro::connect( $socket, $Cpanel::NSCD::Constants::NSCD_SOCKET ) ) {
        return ( $nscd_is_running_cache = 1 );
    }
    return ( $nscd_is_running_cache = 0 );
}

1;

} # --- END Cpanel/NSCD/Check.pm


{ # --- BEGIN Cpanel/PwCache/Helpers.pm
package Cpanel::PwCache::Helpers;


use strict;
use warnings;
no warnings &#039;once&#039;;

my $skip_uid_cache = 0;

sub no_uid_cache { $skip_uid_cache = 1; return }
sub uid_cache    { $skip_uid_cache = 0; return }

sub skip_uid_cache {
    return $skip_uid_cache;
}

sub init {
    my ( $totie, $skip_uid_cache_value ) = @_;

    tiedto($totie);
    $skip_uid_cache = $skip_uid_cache_value;

    return;
}

{    # debugging helpers
    sub confess { require Carp; return Carp::confess(@_) }
    sub cluck   { require Carp; return Carp::cluck(@_) }
}

{    # tie logic and cache

    my $pwcacheistied = 0;
    my $pwcachetie;

    sub istied { return $pwcacheistied }
    sub deinit { $pwcacheistied = 0; return; }

    sub tiedto {
        my $v = shift;

        if ( !defined $v ) {    # get
            return $pwcacheistied ? $pwcachetie : undef;
        }
        else {                  # set
            $pwcacheistied = 1;
            $pwcachetie    = $v;
        }

        return;
    }

}

{
    my $SYSTEM_CONF_DIR  = &#039;/etc&#039;;
    my $PRODUCT_CONF_DIR = &#039;/var/cpanel&#039;;

    sub default_conf_dir    { return $SYSTEM_CONF_DIR }
    sub default_product_dir { return $PRODUCT_CONF_DIR; }
}

1;

} # --- END Cpanel/PwCache/Helpers.pm


{ # --- BEGIN Cpanel/PwCache/Cache.pm
package Cpanel::PwCache::Cache;


use strict;
use warnings;
no warnings &#039;once&#039;;

my %_cache;
my %_homedir_cache;
use constant get_cache         =&gt; \%_cache;
use constant get_homedir_cache =&gt; \%_homedir_cache;

our $pwcache_inited = 0;
my $PWCACHE_IS_SAFE = 1;

sub clear {    # clear all
    %_cache         = ();
    %_homedir_cache = ();
    $pwcache_inited = 0;
    return;
}

sub remove_key {
    my ($pwkey) = @_;
    return delete $_cache{$pwkey};
}

sub replace {
    my $h = shift;
    %_cache = %$h if ref $h eq &#039;HASH&#039;;
    return;
}

sub is_safe {
    $PWCACHE_IS_SAFE = $_[0] if defined $_[0];
    return $PWCACHE_IS_SAFE;
}

sub pwmksafecache {
    return if $PWCACHE_IS_SAFE;
    $_cache{$_}{&#039;contents&#039;}-&gt;[1] = &#039;x&#039; for keys %_cache;
    $PWCACHE_IS_SAFE = 1;
    return;
}

1;

} # --- END Cpanel/PwCache/Cache.pm


{ # --- BEGIN Cpanel/PwCache/Find.pm
package Cpanel::PwCache::Find;


use strict;

# use Cpanel::LoadFile::ReadFast (); # perlpkg line 211

our $PW_CHUNK_SIZE = 1 &lt;&lt; 17;

sub field_with_value_in_pw_file {
    my ( $passwd_fh, $field, $value, $lc_flag ) = @_;

    return if ( $value =~ tr{\x{00}-\x{1f}\x{7f}:}{} );

    my $needle = $field == 0 ? &quot;\n${value}:&quot; : &quot;:${value}&quot;;
    my $haystack;

    my $match_pos = 0;
    my $line_start;
    my $line_end;
    my $not_eof;
    my $data = &quot;\n&quot;;

    while ( ( $not_eof = Cpanel::LoadFile::ReadFast::read_fast( $passwd_fh, $data, $PW_CHUNK_SIZE, length $data ) ) || length($data) &gt; 1 ) {

        $haystack = $not_eof ? substr( $data, 0, rindex( $data, &quot;\n&quot; ), &#039;&#039; ) : $data;

        if ( $lc_flag &amp;&amp; $lc_flag == 1 ) {
            $haystack = lc $haystack;
            $needle   = lc $needle;
        }

        while ( -1 &lt; ( $match_pos = index( $haystack, $needle, $match_pos ) ) ) {

            $line_start = ( !$field ? $match_pos : rindex( $haystack, &quot;\n&quot;, $match_pos ) ) + 1;
            if (
                !$field || (

                    $field == ( substr( $haystack, $line_start, $match_pos - $line_start + 1 ) =~ tr{:}{} )

                    &amp;&amp; ( length($haystack) == $match_pos + length($needle) || substr( $haystack, $match_pos + length($needle), 1 ) =~ tr{:\n}{} )
                )
            ) {
                $line_end = index( $haystack, &quot;\n&quot;, $match_pos + length($needle) );
                my $line = substr( $haystack, $line_start, ( $line_end &gt; -1 ? $line_end : length($haystack) ) - $line_start );

                return split( &#039;:&#039;, $line );
            }
            $match_pos += length($needle);
        }
        last unless $not_eof;
    }
    return;
}

1;

} # --- END Cpanel/PwCache/Find.pm


{ # --- BEGIN Cpanel/PwCache/Build.pm
package Cpanel::PwCache::Build;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Debug                        (); # perlpkg line 211
# use Cpanel::JSON::FailOK                 (); # perlpkg line 211
# use Cpanel::FileUtils::Write::JSON::Lazy (); # perlpkg line 211
# use Cpanel::PwCache::Helpers             (); # perlpkg line 211
# use Cpanel::PwCache::Cache               (); # perlpkg line 211
# use Cpanel::LoadFile::ReadFast           (); # perlpkg line 211


my ( $MIN_FIELDS_FOR_VALID_ENTRY, $pwcache_has_uid_cache ) = ( 0, 6 );

sub pwmksafecache {
    return if Cpanel::PwCache::Cache::is_safe();
    my $pwcache_ref = Cpanel::PwCache::Cache::get_cache();

    $pwcache_ref-&gt;{$_}{&#039;contents&#039;}-&gt;[1] = &#039;x&#039; for keys %{$pwcache_ref};

    Cpanel::PwCache::Cache::is_safe(1);

    return;
}

sub pwclearcache {    # also known as clear_this_process_cache
    $pwcache_has_uid_cache = undef;

    Cpanel::PwCache::Cache::clear();

    return;
}

sub init_pwcache {
    Cpanel::PwCache::Cache::is_safe(0);
    return _build_pwcache();
}

sub init_passwdless_pwcache {
    return _build_pwcache( &#039;nopasswd&#039; =&gt; 1 );
}

sub fetch_pwcache {
    init_passwdless_pwcache() unless pwcache_is_initted();
    my $pwcache_ref = Cpanel::PwCache::Cache::get_cache();
    if ( scalar keys %$pwcache_ref &lt; 3 ) {
        die &quot;The password cache unexpectedly had less than 3 entries&quot;;
    }
    return [ map { $pwcache_ref-&gt;{$_}-&gt;{&#039;contents&#039;} } grep { substr( $_, 0, 1 ) eq &#039;0&#039; } keys %{$pwcache_ref} ];
}

sub _write_json_cache {
    my ($cache_file) = @_;
    if ( !Cpanel::PwCache::Helpers::istied() &amp;&amp; exists $INC{&#039;Cpanel/JSON.pm&#039;} ) {
        my $pwcache_ref = Cpanel::PwCache::Cache::get_cache();
        if ( !ref $pwcache_ref || scalar keys %$pwcache_ref &lt; 3 ) {
            die &quot;The system failed build the password cache&quot;;
        }

        Cpanel::FileUtils::Write::JSON::Lazy::write_file( $cache_file, $pwcache_ref, 0600 );
    }
    return;
}

sub _write_tied_cache {
    my ( $crypted_passwd_ref, $passwdmtime, $hpasswdmtime ) = @_;
    my $SYSTEM_CONF_DIR = Cpanel::PwCache::Helpers::default_conf_dir();
    local $!;
    if ( open( my $pwcache_passwd_fh, &#039;&lt;:stdio&#039;, &quot;$SYSTEM_CONF_DIR/passwd&quot; ) ) {
        local $/;
        my $pwcache_ref = Cpanel::PwCache::Cache::get_cache();
        my $data        = &#039;&#039;;
        Cpanel::LoadFile::ReadFast::read_all_fast( $pwcache_passwd_fh, $data );
        die &quot;The file “$SYSTEM_CONF_DIR/passwd” was unexpectedly empty&quot; if !length $data;
        my @fields;
        my $skip_uid_cache = Cpanel::PwCache::Helpers::skip_uid_cache();

        foreach my $line ( split( /\n/, $data ) ) {
            next unless length $line;
            @fields = split( /:/, $line );
            next if scalar @fields &lt; $MIN_FIELDS_FOR_VALID_ENTRY || $fields[0] =~ tr/[A-Z][a-z][0-9]._-//c;
            $pwcache_ref-&gt;{ &#039;0:&#039; . $fields[0] } = {
                &#039;cachetime&#039;  =&gt; $passwdmtime,
                &#039;hcachetime&#039; =&gt; $hpasswdmtime,
                &#039;contents&#039;   =&gt; [ $fields[0], $crypted_passwd_ref-&gt;{ $fields[0] } || $fields[1], $fields[2], $fields[3], &#039;&#039;, &#039;&#039;, $fields[4], $fields[5], $fields[6], -1, -1, $passwdmtime, $hpasswdmtime ]
            };
            next if $skip_uid_cache || !defined $fields[2] || exists $pwcache_ref-&gt;{ &#039;2:&#039; . $fields[2] };
            $pwcache_ref-&gt;{ &#039;2:&#039; . $fields[2] } = $pwcache_ref-&gt;{ &#039;0:&#039; . $fields[0] };
        }
        close($pwcache_passwd_fh);
    }
    else {
        die &quot;The system failed to read $SYSTEM_CONF_DIR/passwd because of an error: $!&quot;;
    }
    return;
}

sub _cache_ref_is_valid {
    my ( $cache_ref, $passwdmtime, $hpasswdmtime ) = @_;
    my @keys = qw/0:root 0:cpanel 0:bin/;
    return
         $cache_ref
      &amp;&amp; ( scalar keys %{$cache_ref} ) &gt; 2
      &amp;&amp; scalar @keys == grep {    #
             $cache_ref-&gt;{$_}-&gt;{&#039;hcachetime&#039;}
          &amp;&amp; $cache_ref-&gt;{$_}-&gt;{&#039;hcachetime&#039;} == $hpasswdmtime
          &amp;&amp; $cache_ref-&gt;{$_}-&gt;{&#039;cachetime&#039;}
          &amp;&amp; $cache_ref-&gt;{$_}-&gt;{&#039;cachetime&#039;} == $passwdmtime
      } @keys;
}

sub _build_pwcache {
    my %OPTS = @_;

    if ( $INC{&#039;B/C.pm&#039;} ) {
        Cpanel::PwCache::Helpers::confess(&quot;Cpanel::PwCache::Build::_build_pwcache cannot be run under B::C (see case 162857)&quot;);
    }

    my $SYSTEM_CONF_DIR = Cpanel::PwCache::Helpers::default_conf_dir();

    my ( $cache_file, $passwdmtime, $cache_file_mtime, $crypted_passwd_ref, $crypted_passwd_file, $hpasswdmtime ) = ( &quot;$SYSTEM_CONF_DIR/passwd.cache&quot;, ( stat(&quot;$SYSTEM_CONF_DIR/passwd&quot;) )[9] );

    if ( $OPTS{&#039;nopasswd&#039;} ) {

        $hpasswdmtime = ( stat(&quot;$SYSTEM_CONF_DIR/shadow&quot;) )[9];
        $cache_file   = &quot;$SYSTEM_CONF_DIR/passwd&quot; . ( Cpanel::PwCache::Helpers::skip_uid_cache() ? &#039;.nouids&#039; : &#039;&#039; ) . &#039;.cache&#039;;
    }
    elsif ( -r &quot;$SYSTEM_CONF_DIR/shadow&quot; ) {
        Cpanel::PwCache::Cache::is_safe(0);
        $hpasswdmtime        = ( stat(_) )[9];
        $crypted_passwd_file = &quot;$SYSTEM_CONF_DIR/shadow&quot;;
        $cache_file          = &quot;$SYSTEM_CONF_DIR/shadow&quot; . ( Cpanel::PwCache::Helpers::skip_uid_cache() ? &#039;.nouids&#039; : &#039;&#039; ) . &#039;.cache&#039;;
    }
    else {
        $hpasswdmtime = 0;
    }

    if ( !Cpanel::PwCache::Helpers::istied() &amp;&amp; exists $INC{&#039;Cpanel/JSON.pm&#039;} ) {
        if ( open( my $cache_fh, &#039;&lt;:stdio&#039;, $cache_file ) ) {
            my $cache_file_mtime = ( stat($cache_fh) )[9] || 0;
            if ( $cache_file_mtime &gt; $hpasswdmtime &amp;&amp; $cache_file_mtime &gt; $passwdmtime ) {
                my $cache_ref = Cpanel::JSON::FailOK::LoadFile($cache_fh);
                Cpanel::Debug::log_debug(&quot;[read pwcache from $cache_file]&quot;) if ( $Cpanel::Debug::level &gt; 3 );
                if ( _cache_ref_is_valid( $cache_ref, $passwdmtime, $hpasswdmtime ) ) {
                    Cpanel::Debug::log_debug(&quot;[validated pwcache from $cache_file]&quot;) if ( $Cpanel::Debug::level &gt; 3 );
                    my $memory_pwcache_ref = Cpanel::PwCache::Cache::get_cache();
                    @{$cache_ref}{ keys %$memory_pwcache_ref } = values %$memory_pwcache_ref;
                    Cpanel::PwCache::Cache::replace($cache_ref);
                    $Cpanel::PwCache::Cache::pwcache_inited = ( $OPTS{&#039;nopasswd&#039;} ? 1 : 2 );
                    return;
                }

            }
        }
    }

    if ($crypted_passwd_file) { $crypted_passwd_ref = _load_pws($crypted_passwd_file); }
    $Cpanel::PwCache::Cache::pwcache_inited = ( $OPTS{&#039;nopasswd&#039;}                          ? 1 : 2 );
    $pwcache_has_uid_cache                  = ( Cpanel::PwCache::Helpers::skip_uid_cache() ? 0 : 1 );

    _write_tied_cache( $crypted_passwd_ref, $passwdmtime, $hpasswdmtime );
    _write_json_cache($cache_file) if $&gt; == 0;

    return 1;
}

sub pwcache_is_initted {
    return ( $Cpanel::PwCache::Cache::pwcache_inited ? $Cpanel::PwCache::Cache::pwcache_inited : 0 );
}

sub _load_pws {
    my $lookup_file = shift;

    if ( $INC{&#039;B/C.pm&#039;} ) {
        Cpanel::PwCache::Helpers::confess(&quot;Cpanel::PwCache::Build::_load_pws cannot be run under B::C (see case 162857)&quot;);
    }

    my %PW;
    if ( open my $lookup_fh, &#039;&lt;:stdio&#039;, $lookup_file ) {
        my $data = &#039;&#039;;
        Cpanel::LoadFile::ReadFast::read_all_fast( $lookup_fh, $data );
        die &quot;The file “$lookup_file” was unexpectedly empty&quot; if !length $data;
        %PW = map { ( split(/:/) )[ 0, 1 ] } split( /\n/, $data );
        if ( index( $data, &#039;#&#039; ) &gt; -1 ) {
            delete @PW{ &#039;&#039;, grep { index( $_, &#039;#&#039; ) == 0 } keys %PW };
        }
        else {
            delete $PW{&#039;&#039;};
        }
        close $lookup_fh;
    }
    return \%PW;
}

1;

} # --- END Cpanel/PwCache/Build.pm


{ # --- BEGIN Cpanel/PwCache.pm
package Cpanel::PwCache;


use strict;

# use Cpanel::Debug            (); # perlpkg line 211
# use Cpanel::NSCD::Check      (); # perlpkg line 211
# use Cpanel::PwCache::Helpers (); # perlpkg line 211
# use Cpanel::PwCache::Cache   (); # perlpkg line 211
# use Cpanel::PwCache::Find    (); # perlpkg line 211

use constant DUMMY_PW_RETURNS =&gt; ( -1, -1, 0, 0 );
use constant DEBUG            =&gt; 0;                  # Must set $ENV{&#039;CPANEL_DEBUG_LEVEL&#039;} = 5 as well

our $VERSION = &#039;4.2&#039;;

my %FIXED_KEYS = (
    &#039;0:root&#039;        =&gt; 1,
    &#039;0:nobody&#039;      =&gt; 1,
    &#039;0:cpanel&#039;      =&gt; 1,
    &#039;0:cpanellogin&#039; =&gt; 1,
    &#039;0:mail&#039;        =&gt; 1,
    &#039;2:0&#039;           =&gt; 1,
    &#039;2:99&#039;          =&gt; 1
);

our $_WANT_ENCRYPTED_PASSWORD;


sub getpwnam_noshadow {
    $_WANT_ENCRYPTED_PASSWORD = 0;
    goto &amp;_getpwnam;
}

sub getpwuid_noshadow {
    $_WANT_ENCRYPTED_PASSWORD = 0;
    goto &amp;_getpwuid;
}


sub getpwnam {
    $_WANT_ENCRYPTED_PASSWORD = !!wantarray;
    goto &amp;_getpwnam;
}

sub getpwuid {
    $_WANT_ENCRYPTED_PASSWORD = !!wantarray;
    goto &amp;_getpwuid;
}


sub gethomedir {

    my $uid_or_name = $_[0] // $&gt;;

    my $hd = Cpanel::PwCache::Cache::get_homedir_cache();

    unless ( exists $hd-&gt;{$uid_or_name} ) {
        $_WANT_ENCRYPTED_PASSWORD = 0;
        if ( $uid_or_name !~ tr{0-9}{}c ) {
            $hd-&gt;{$uid_or_name} = ( _getpwuid($uid_or_name) )[7];
        }
        else {
            $hd-&gt;{$uid_or_name} = ( _getpwnam($uid_or_name) )[7];
        }
    }

    return $hd-&gt;{$uid_or_name};
}


sub getusername {

    my $uid = defined $_[0] ? $_[0] : $&gt;;

    $_WANT_ENCRYPTED_PASSWORD = 0;
    return scalar _getpwuid($uid);
}


sub init_passwdless_pwcache {
    require Cpanel::PwCache::Build;
    *init_passwdless_pwcache = \&amp;Cpanel::PwCache::Build::init_passwdless_pwcache;
    goto &amp;Cpanel::PwCache::Build::init_passwdless_pwcache;
}


sub _getpwuid {    ## no critic qw(Subroutines::RequireArgUnpacking)
    return unless ( length( $_[0] ) &amp;&amp; $_[0] !~ tr/0-9//c );

    my $pwcache_ref = Cpanel::PwCache::Cache::get_cache();

    if ( !exists $pwcache_ref-&gt;{&quot;2:$_[0]&quot;} &amp;&amp; $&gt; != 0 &amp;&amp; !Cpanel::PwCache::Helpers::istied() &amp;&amp; Cpanel::NSCD::Check::nscd_is_running() ) {
        return CORE::getpwuid( $_[0] ) if !wantarray;

        my @ret = CORE::getpwuid( $_[0] );

        return @ret ? ( @ret, DUMMY_PW_RETURNS() ) : ();
    }

    if ( my $pwref = _pwfunc( $_[0], 2 ) ) {
        return wantarray ? @$pwref : $pwref-&gt;[0];
    }
    return;    #important not to return 0
}

sub _getpwnam {    ## no critic qw(Subroutines::RequireArgUnpacking)
    return unless ( length( $_[0] ) &amp;&amp; $_[0] !~ tr{\x{00}-\x{20}\x{7f}:/#}{} );

    my $pwcache_ref = Cpanel::PwCache::Cache::get_cache();

    if ( !exists $pwcache_ref-&gt;{&quot;0:$_[0]&quot;} &amp;&amp; $&gt; != 0 &amp;&amp; !Cpanel::PwCache::Helpers::istied() &amp;&amp; Cpanel::NSCD::Check::nscd_is_running() ) {
        return CORE::getpwnam( $_[0] ) if !wantarray;

        my @ret = CORE::getpwnam( $_[0] );

        return @ret ? ( @ret, DUMMY_PW_RETURNS() ) : ();
    }

    if ( my $pwref = _pwfunc( $_[0], 0 ) ) {
        return wantarray ? @$pwref : $pwref-&gt;[2];
    }
    return;    #important not to return 0
}

sub _pwfunc {    ## no critic qw(Subroutines::RequireArgUnpacking)
    my ( $value, $field, $pwkey ) = ( $_[0], ( $_[1] || 0 ), $_[1] . &#039;:&#039; . ( $_[0] || 0 ) );

    if ( Cpanel::PwCache::Helpers::istied() ) {

        Cpanel::Debug::log_debug(&quot;cache tie (tied) value[$value] field[$field]&quot;) if (DEBUG);
        my $pwcachetie = Cpanel::PwCache::Helpers::tiedto();

        if ( ref $pwcachetie eq &#039;HASH&#039; ) {
            my $cache = $pwcachetie-&gt;{$pwkey};
            if ( ref $cache eq &#039;HASH&#039; ) {
                return $pwcachetie-&gt;{$pwkey}-&gt;{&#039;contents&#039;};
            }
        }
        return undef;
    }
    my $SYSTEM_CONF_DIR = Cpanel::PwCache::Helpers::default_conf_dir();

    my $lookup_encrypted_pass = 0;
    if ($_WANT_ENCRYPTED_PASSWORD) {

        $lookup_encrypted_pass = $&gt; == 0 ? 1 : 0;
    }

    my ( $passwdmtime, $hpasswdmtime );

    my $pwcache_ref = Cpanel::PwCache::Cache::get_cache();

    if ( my $cache_entry = $pwcache_ref-&gt;{$pwkey} ) {
        Cpanel::Debug::log_debug(&quot;exists in cache value[$value] field[$field]&quot;) if (DEBUG);
        if (
            ( exists( $cache_entry-&gt;{&#039;contents&#039;} ) &amp;&amp; $cache_entry-&gt;{&#039;contents&#039;}-&gt;[1] ne &#039;x&#039; )    # Has shadow entry
            || !$lookup_encrypted_pass                                                            # Or we do not need it
          ) {                                                                                     # If we are root and missing the password field we could fail authentication
            if ( $FIXED_KEYS{$pwkey} ) {                                                          # We assume root, nobody, and cpanellogin will never change during execution
                Cpanel::Debug::log_debug(&quot;cache (never change) hit value[$value] field[$field]&quot;) if (DEBUG);
                return $cache_entry-&gt;{&#039;contents&#039;};
            }

            $passwdmtime  = ( stat(&quot;$SYSTEM_CONF_DIR/passwd&quot;) )[9];
            $hpasswdmtime = $lookup_encrypted_pass ? ( stat(&quot;$SYSTEM_CONF_DIR/shadow&quot;) )[9] : 0;

            if (   ( $lookup_encrypted_pass &amp;&amp; $hpasswdmtime &amp;&amp; $hpasswdmtime != $cache_entry-&gt;{&#039;hcachetime&#039;} )
                || ( $passwdmtime &amp;&amp; $passwdmtime != $cache_entry-&gt;{&#039;cachetime&#039;} ) ) {    #timewarp safe
                DEBUG &amp;&amp; Cpanel::Debug::log_debug( &quot;cache miss value[$value] field[$field] pwkey[$pwkey] &quot; . qq{hpasswdmtime: $hpasswdmtime != $cache_entry-&gt;{hcachetime} } . qq{passwdmtime: $passwdmtime != $cache_entry-&gt;{cachetime} } );

                if ( defined $cache_entry &amp;&amp; defined $cache_entry-&gt;{&#039;contents&#039;} ) {

                    Cpanel::PwCache::Cache::clear();    #If the passwd file mtime changes everything is invalid
                }
            }
            else {
                Cpanel::Debug::log_debug(&quot;cache hit value[$value] field[$field]&quot;) if (DEBUG);
                return $cache_entry-&gt;{&#039;contents&#039;};
            }
        }
        elsif (DEBUG) {
            Cpanel::Debug::log_debug( &quot;cache miss pwkey[$pwkey] value[$value] field[$field] passwdmtime[$passwdmtime] pwcacheistied[&quot; . Cpanel::PwCache::Helpers::istied() . &quot;] hpasswdmtime[$hpasswdmtime]&quot; );
        }
    }
    elsif (DEBUG) {
        Cpanel::Debug::log_debug( &quot;cache miss (no entry) pwkey[$pwkey] value[$value] field[$field] pwcacheistied[&quot; . Cpanel::PwCache::Helpers::istied() . &quot;]&quot; );
    }
    my $pwdata = _getpwdata( $value, $field, $passwdmtime, $hpasswdmtime, $lookup_encrypted_pass );

    _cache_pwdata( $pwdata, $pwcache_ref ) if $pwdata &amp;&amp; @$pwdata;

    return $pwdata;
}

sub _getpwdata {
    my ( $value, $field, $passwdmtime, $shadowmtime, $lookup_encrypted_pass ) = @_;
    return if ( !defined $value || !defined $field || $value =~ tr/\0// );

    if ($lookup_encrypted_pass) {
        return [ _readshadow( $value, $field, $passwdmtime, $shadowmtime ) ];
    }

    return [ _readpasswd( $value, $field, $passwdmtime, $shadowmtime ) ];
}

sub _readshadow {    ## no critic qw(Subroutines::RequireArgUnpacking)
    my $SYSTEM_CONF_DIR = Cpanel::PwCache::Helpers::default_conf_dir();
    my ( $value, $field, $passwdmtime, $shadowmtime ) = ( $_[0], ( $_[1] || 0 ), ( $_[2] || ( stat(&quot;$SYSTEM_CONF_DIR/passwd&quot;) )[9] ), ( $_[3] || ( stat(&quot;$SYSTEM_CONF_DIR/shadow&quot;) )[9] ) );
    my @PW = _readpasswd( $value, $field, $passwdmtime, $shadowmtime );
    return if !@PW;

    $value = $PW[0];

    if ( open my $shadow_fh, &#039;&lt;&#039;, &quot;$SYSTEM_CONF_DIR/shadow&quot; ) {
        if ( my @SH = Cpanel::PwCache::Find::field_with_value_in_pw_file( $shadow_fh, 0, $value ) ) {

            ( $PW[1], $PW[9], $PW[10], $PW[11], $PW[12] ) = (
                $SH[1],    #encrypted pass
                $SH[5],    #expire time
                $SH[2],    #change time
                $passwdmtime,
                $shadowmtime
            );
            close $shadow_fh;
            Cpanel::PwCache::Cache::is_safe(0);
            return @PW;
        }
    }
    else {
        Cpanel::PwCache::Helpers::cluck(&quot;Unable to open $SYSTEM_CONF_DIR/shadow: $!&quot;);
    }

    Cpanel::PwCache::Helpers::cluck(&quot;Entry for $value missing in $SYSTEM_CONF_DIR/shadow&quot;);
    return @PW;
}

sub _readpasswd {    ## no critic qw(Subroutines::RequireArgUnpacking)
    my $SYSTEM_CONF_DIR = Cpanel::PwCache::Helpers::default_conf_dir();
    my ( $value, $field, $passwdmtime, $shadowmtime, $block ) = ( $_[0], ( $_[1] || 0 ), ( $_[2] || ( stat(&quot;$SYSTEM_CONF_DIR/passwd&quot;) )[9] ), $_[3] );

    if ( $INC{&#039;B/C.pm&#039;} ) {
        die(&quot;Cpanel::PwCache::_readpasswd cannot be run under B::C (see case 162857)&quot;);
    }

    if ( open( my $passwd_fh, &#039;&lt;&#039;, &quot;$SYSTEM_CONF_DIR/passwd&quot; ) ) {
        if ( my @PW = Cpanel::PwCache::Find::field_with_value_in_pw_file( $passwd_fh, $field, $value ) ) {

            return ( $PW[0], $PW[1], $PW[2], $PW[3], &#039;&#039;, &#039;&#039;, $PW[4], $PW[5], $PW[6], -1, -1, $passwdmtime, ( $shadowmtime || $passwdmtime ) );
        }
        close($passwd_fh);
    }
    else {
        Cpanel::PwCache::Helpers::cluck(&quot;open($SYSTEM_CONF_DIR/passwd): $!&quot;);
    }

    return;
}

sub _cache_pwdata {
    my ( $pwdata, $pwcache_ref ) = @_;

    $pwcache_ref ||= Cpanel::PwCache::Cache::get_cache();

    if ( $pwdata-&gt;[2] != 0 || $pwdata-&gt;[0] eq &#039;root&#039; ) {    # special case for multiple uid 0 users
        @{ $pwcache_ref-&gt;{ &#039;2&#039; . &#039;:&#039; . $pwdata-&gt;[2] } }{ &#039;cachetime&#039;, &#039;hcachetime&#039;, &#039;contents&#039; } = ( $pwdata-&gt;[11], $pwdata-&gt;[12], $pwdata );
    }
    @{ $pwcache_ref-&gt;{ &#039;0&#039; . &#039;:&#039; . $pwdata-&gt;[0] } }{ &#039;cachetime&#039;, &#039;hcachetime&#039;, &#039;contents&#039; } = ( $pwdata-&gt;[11], $pwdata-&gt;[12], $pwdata );
    return 1;
}

1;

} # --- END Cpanel/PwCache.pm


{ # --- BEGIN Cpanel/Locale/Utils/User.pm
package Cpanel::Locale::Utils::User;


use strict;
# use Cpanel::Config::LoadCpUserFile (); # perlpkg line 211
# use Cpanel::Config::HasCpUserFile  (); # perlpkg line 211
# use Cpanel::PwCache                (); # perlpkg line 211
# use Cpanel::LoadModule             (); # perlpkg line 211

our $DATASTORE_MODULE     = &#039;Cpanel::DataStore&#039;;
our $LOCALE_LEGACY_MODULE = &#039;Cpanel::Locale::Utils::Legacy&#039;;

my $inited_cpdata_user;
my $userlocale = {};
my $logger;

sub _logger {
    require Cpanel::Logger;
    return ( $logger ||= Cpanel::Logger-&gt;new() );
}

sub init_cpdata_keys {
    my $user = shift || $Cpanel::user || $ENV{&#039;REMOTE_USER&#039;} || ( $&gt; == 0 ? &#039;root&#039; : ( Cpanel::PwCache::getpwuid($&gt;) )[0] || &#039;&#039; );

    return if ( defined $inited_cpdata_user &amp;&amp; $inited_cpdata_user eq $user );

    if ( !$Cpanel::CPDATA{&#039;LOCALE&#039;} &amp;&amp; $user ne &#039;root&#039; ) {
        require Cpanel::Server::Utils;
        if ( Cpanel::Server::Utils::is_subprocess_of_cpsrvd() &amp;&amp; ( $&gt; &amp;&amp; $user ne &#039;cpanel&#039; &amp;&amp; $user ne &#039;cpanellogin&#039; &amp;&amp; !-e &quot;/var/cpanel/users/$user&quot; ) ) {
            _logger()-&gt;panic(&quot;get_handle() called before initcp()&quot;);
        }

        if ( $&gt; == 0 || ( $&gt; &amp;&amp; $&gt; == ( Cpanel::PwCache::getpwnam($user) // -1 ) ) ) {
            $Cpanel::CPDATA{&#039;LOCALE&#039;} = get_user_locale($user);
        }
    }

    return ( $inited_cpdata_user = $user );
}

sub clear_user_cache {
    my ($user) = @_;
    return delete $userlocale-&gt;{$user};
}

sub get_user_locale {

    my $user       = ( shift || $Cpanel::user || $ENV{&#039;REMOTE_USER&#039;} || ( $&gt; == 0 ? &#039;root&#039; : ( Cpanel::PwCache::getpwuid($&gt;) )[0] ) );
    my $cpuser_ref = shift;                                                                                                              # not required, just faster if it is passed
    if ( $ENV{&#039;TEAM_USER&#039;} ) {
        my $team_user_locale = get_team_user_locale();
        return ( $userlocale-&gt;{$user} = $team_user_locale ) if $team_user_locale;
    }

    if ( !$user ) {
        require Cpanel::Locale;
        return Cpanel::Locale::get_server_locale() || &#039;en&#039;;
    }

    return $userlocale-&gt;{$user} if exists $userlocale-&gt;{$user} &amp;&amp; !shift;

    if ( $Cpanel::user &amp;&amp; $user eq $Cpanel::user &amp;&amp; $Cpanel::CPDATA{&#039;LOCALE&#039;} ) {
        return ( $userlocale-&gt;{$user} = $Cpanel::CPDATA{&#039;LOCALE&#039;} );
    }

    my $locale;

    if ( $user eq &#039;root&#039; ) {
        my $root_conf_yaml = ( Cpanel::PwCache::getpwnam(&#039;root&#039;) )[7] . &#039;/.cpanel_config&#039;;
        if ( -e $root_conf_yaml ) {
            Cpanel::LoadModule::load_perl_module($DATASTORE_MODULE);
            my $hr = $DATASTORE_MODULE-&gt;can(&#039;fetch_ref&#039;)-&gt;($root_conf_yaml);
            $locale = $hr-&gt;{&#039;locale&#039;};
        }
    }
    elsif ( $user eq &#039;cpanel&#039; ) {
        require Cpanel::Locale;
        $locale = Cpanel::Locale::get_locale_for_user_cpanel();
    }
    else {
        if ( $cpuser_ref || ( Cpanel::Config::HasCpUserFile::has_readable_cpuser_file($user) &amp;&amp; ( $cpuser_ref = Cpanel::Config::LoadCpUserFile::loadcpuserfile($user) ) ) ) {
            if ( defined $cpuser_ref-&gt;{&#039;LOCALE&#039;} ) {
                $locale = $cpuser_ref-&gt;{&#039;LOCALE&#039;};
            }
            elsif ( defined $cpuser_ref-&gt;{&#039;LANG&#039;} ) {
                Cpanel::LoadModule::load_perl_module($LOCALE_LEGACY_MODULE);
                $locale = $LOCALE_LEGACY_MODULE-&gt;can(&#039;map_any_old_style_to_new_style&#039;)-&gt;( $cpuser_ref-&gt;{&#039;LANG&#039;} );
            }
        }
    }

    if ( !$locale ) {
        require Cpanel::Locale;
        return $userlocale-&gt;{$user} = Cpanel::Locale::get_server_locale() || &#039;en&#039;;
    }

    $userlocale-&gt;{$user} = $locale;

    return $userlocale-&gt;{$user};
}

sub get_team_user_locale {
    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Team::Config&#039;);
    my $locale = Cpanel::Team::Config-&gt;new( $ENV{&#039;TEAM_OWNER&#039;} )-&gt;load()-&gt;{users}-&gt;{ $ENV{&#039;TEAM_USER&#039;} }-&gt;{locale};
    return $locale;
}

1;

} # --- END Cpanel/Locale/Utils/User.pm


{ # --- BEGIN Cpanel/Cookies.pm
package Cpanel::Cookies;


$Cpanel::Cookies::VERSION = &#039;0.1&#039;;

sub get_cookie_hashref_from_string {
    return {} if !defined $_[0];
    return {
        map {
            map {
                s/%([a-fA-F0-9][a-fA-F0-9])/pack(&#039;C&#039;, hex($1))/eg if -1 != index( $_, &#039;%&#039; );
                $_;
            } split m&lt;=&gt;, $_, 2
        } split( /; /, $_[0] )
    };
}

my $http_cookie_cached;

sub get_cookie_hashref {

    if ( !defined $http_cookie_cached ) {
        $http_cookie_cached = get_cookie_hashref_from_string( $ENV{&#039;HTTP_COOKIE&#039;} );
    }

    return $http_cookie_cached;
}

sub get_cookie_hashref_recache {

    $http_cookie_cached = get_cookie_hashref_from_string( $ENV{&#039;HTTP_COOKIE&#039;} );
    return $http_cookie_cached;
}

1;


} # --- END Cpanel/Cookies.pm


{ # --- BEGIN Cpanel/SafeDir/Read.pm
package Cpanel::SafeDir::Read;


use strict;
use warnings;
no warnings &#039;once&#039;;

sub read_dir {
    my ( $dir, $coderef ) = @_;
    my @contents;
    if ( opendir my $dir_dh, $dir ) {
        @contents = grep { $_ ne &#039;.&#039; &amp;&amp; $_ ne &#039;..&#039; } readdir($dir_dh);
        if ($coderef) {
            @contents = grep { $coderef-&gt;($_) } @contents;
        }
        closedir $dir_dh;
        return wantarray ? @contents : \@contents;
    }
    return;
}

1;

} # --- END Cpanel/SafeDir/Read.pm


{ # --- BEGIN Cpanel/ArrayFunc/Uniq.pm
package Cpanel::ArrayFunc::Uniq;


use cPstrict;
no warnings &#039;once&#039;;

sub uniq (@list) {

    if ( $INC{&#039;List/Util.pm&#039;} ) {
        no warnings &#039;redefine&#039;;
        *uniq = *List::Util::uniq;
        return List::Util::uniq(@list);
    }
    my %seen;
    return grep { !$seen{$_}++ } @list;
}

1;

} # --- END Cpanel/ArrayFunc/Uniq.pm


{ # --- BEGIN Cpanel/Locale/Utils/Charmap.pm
package Cpanel::Locale::Utils::Charmap;


use cPstrict;
no warnings &#039;once&#039;;

# use Cpanel::ArrayFunc::Uniq (); # perlpkg line 211

sub get_charmap_list ( $root_says_to_make_symlinks = 0, $no_aliases = 0 ) {
    my $args = { &#039;iconv&#039; =&gt; 0, &#039;unpreferred_aliases&#039; =&gt; ( $no_aliases ? 0 : 1 ) };
    if ($root_says_to_make_symlinks) {
        make_symlinks();
    }
    return @{ get_charmaps($args) };
}

sub get_charmaps ( $args = {} ) {
    _validate_args( $args, { map { $_ =&gt; 1 } qw( iconv unpreferred_aliases ) } );

    my ( $iconv, $unpreferred_aliases ) = @{$args}{ &#039;iconv&#039;, &#039;unpreferred_aliases&#039; };
    $iconv //= 1;    # Provide iconv compatibility by default.

    my %charset_aliases   = _get_charset_aliases();
    my %excluded_charmaps = _get_excluded_charmaps( $iconv, $unpreferred_aliases );
    my @raw_charmaps      = ( qw(utf-8 us-ascii), _get_filesystem_charmaps(), ( $unpreferred_aliases ? %charset_aliases : ( values %charset_aliases ) ) );
    my %charmaps;
    for my $cm (@raw_charmaps) {
        $cm =~ tr{A-Z}{a-z};
        my $copy     = $cm;
        my $stripped = ( $copy =~ tr{_.-}{}d );    #prefer &quot;utf-8&quot; over &quot;utf8&quot;
        if ( !exists( $excluded_charmaps{$cm} ) &amp;&amp; ( !exists( $charmaps{$copy} ) || $stripped ) ) {
            $charmaps{$copy} = $cm;
        }
    }

    return [ sort ( Cpanel::ArrayFunc::Uniq::uniq( values %charmaps ) ) ];
}

sub make_symlinks {
    return unless $&gt; == 0;
    my %charset_aliases = _get_charset_aliases();
    my $charmapsdir     = _get_charmaps_dir();

    for my $loop ( 1 .. 2 ) {
        for my $key ( keys %charset_aliases ) {
            lstat(&quot;$charmapsdir/$key.gz&quot;);    # unpreferred
            if ( -e _ ) {
                lstat(&quot;$charmapsdir/$charset_aliases{$key}.gz&quot;);    # preferred
                if ( !-e _ &amp;&amp; !-l _ ) {
                    symlink( &quot;$charmapsdir/$key.gz&quot;, &quot;$charmapsdir/$charset_aliases{$key}.gz&quot; );    # unpreferred -&gt; preferred
                }
            }
            elsif ( !-l _ &amp;&amp; -e &quot;$charmapsdir/$charset_aliases{$key}.gz&quot; ) {                        # preferred
                symlink( &quot;$charmapsdir/$charset_aliases{$key}.gz&quot;, &quot;$charmapsdir/$key.gz&quot; );        # preferred -&gt; unpreferred
            }
        }
    }
    return 1;
}

sub _validate_args ( $args, $possible_args ) {

    if ( my @bad_args = grep { !$possible_args-&gt;{$_} } keys %{$args} ) {
        require Cpanel::Exception;
        die Cpanel::Exception::create_raw( &#039;InvalidParameters&#039;, &#039;The following arguments are invalid: &#039; . join &#039;, &#039;, @bad_args );
    }
}

sub _get_charmaps_dir {
    state $charmaps_dir = -e &#039;/usr/local/share/i18n/charmaps&#039; ? &#039;/usr/local/share/i18n/charmaps&#039; : &#039;/usr/share/i18n/charmaps&#039;;
    return $charmaps_dir;
}

sub _get_charset_aliases {

    return (    # unpreferred =&gt; preferred
        &#039;ASCII&#039;             =&gt; &#039;US-ASCII&#039;,
        &#039;BIG5-ETEN&#039;         =&gt; &#039;BIG5&#039;,
        &#039;CP1251&#039;            =&gt; &#039;WINDOWS-1251&#039;,
        &#039;CP1252&#039;            =&gt; &#039;WINDOWS-1252&#039;,
        &#039;CP936&#039;             =&gt; &#039;GBK&#039;,
        &#039;CP949&#039;             =&gt; &#039;KS_C_5601-1987&#039;,    # Note: same preferred as KS_C_5601
        &#039;EUC-CN&#039;            =&gt; &#039;GB2312&#039;,
        &#039;KS_C_5601&#039;         =&gt; &#039;KS_C_5601-1987&#039;,    # Note: same preferred as CP949
        &#039;SHIFTJIS&#039;          =&gt; &#039;SHIFT_JIS&#039;,
        &#039;SHIFTJISX0213&#039;     =&gt; &#039;SHIFT_JISX0213&#039;,
        &#039;UNICODE-1-1-UTF-7&#039; =&gt; &#039;UTF-7&#039;,             # RFC 1642 (obs.)
        &#039;UTF8&#039;              =&gt; &#039;UTF-8&#039;,
        &#039;UTF-8-STRICT&#039;      =&gt; &#039;UTF-8&#039;,             # Perl internal use
        &#039;HZ&#039;                =&gt; &#039;HZ-GB-2312&#039;,        # RFC 1842
        &#039;GSM0338&#039;           =&gt; &#039;GSM03.38&#039;,
    );
}

sub _get_iconv_blacklist {

    return (
        &#039;big5-eten&#039;,
        &#039;bs_viewdata&#039;,
        &#039;csa_z243.4-1985-gr&#039;,
        &#039;gsm03.38&#039;,
        &#039;gsm0338&#039;,
        &#039;hz&#039;,
        &#039;hz-gb-2312&#039;,
        &#039;invariant&#039;,
        &#039;iso_10646&#039;,
        &#039;iso_646.basic&#039;,
        &#039;iso_646.irv&#039;,
        &#039;iso_6937-2-25&#039;,
        &#039;iso_6937-2-add&#039;,
        &#039;iso_8859-1,gl&#039;,
        &#039;iso_8859-supp&#039;,
        &#039;jis_c6220-1969-jp&#039;,
        &#039;jis_c6229-1984-a&#039;,
        &#039;jis_c6229-1984-b-add&#039;,
        &#039;jis_c6229-1984-hand&#039;,
        &#039;jis_c6229-1984-hand-add&#039;,
        &#039;jis_c6229-1984-kana&#039;,
        &#039;jis_x0201&#039;,
        &#039;jus_i.b1.003-mac&#039;,
        &#039;jus_i.b1.003-serb&#039;,
        &#039;ks_c_5601&#039;,
        &#039;ks_c_5601-1987&#039;,
        &#039;nats-dano-add&#039;,
        &#039;nats-sefi-add&#039;,
        &#039;nextstep&#039;,
        &#039;sami&#039;,
        &#039;sami-ws2&#039;,
        &#039;t.101-g2&#039;,
        &#039;t.61-7bit&#039;,
        &#039;unicode-1-1-utf-7&#039;,
        &#039;utf-8-strict&#039;,
        &#039;videotex-suppl&#039;,
    );
}

sub _get_filesystem_charmaps {
    state @filesystem_charmaps;
    return @filesystem_charmaps if @filesystem_charmaps;

    my $charmapsdir = _get_charmaps_dir();
    if ( opendir my $charmaps_dh, $charmapsdir ) {
        @filesystem_charmaps = map { m{\A([^.].*)[.]gz\z}xms ? $1 : () } readdir $charmaps_dh;
        closedir $charmaps_dh;
    }
    return @filesystem_charmaps;
}

sub _get_excluded_charmaps ( $iconv, $unpreferred_aliases ) {
    my %excluded;
    if ($iconv) {
        for my $bl ( _get_iconv_blacklist() ) {
            $excluded{$bl} = 1;
        }
    }
    if ( !$unpreferred_aliases ) {
        my %charset_aliases = _get_charset_aliases;
        for my $alias ( keys %charset_aliases ) {
            $alias =~ tr{A-Z}{a-z};
            $excluded{$alias} = 1;
        }
    }
    return %excluded;
}

1;


} # --- END Cpanel/Locale/Utils/Charmap.pm


{ # --- BEGIN Cpanel/StringFunc/Case.pm
package Cpanel::StringFunc::Case;


use strict;
use warnings;
no warnings &#039;once&#039;;

our $VERSION = &#039;1.2&#039;;

sub ToUpper {
    return unless defined $_[0];
    ( local $_ = $_[0] ) =~ tr/a-z/A-Z/;    # avoid altering $_[0] by making a copy
    return $_;
}

sub ToLower {
    return unless defined $_[0];
    ( local $_ = $_[0] ) =~ tr/A-Z/a-z/;    # avoid altering $_[0] by making a copy
    return $_;
}
1;

} # --- END Cpanel/StringFunc/Case.pm


{ # --- BEGIN Cpanel/Locale/Utils/Legacy.pm
package Cpanel::Locale::Utils::Legacy;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Locale::Utils::Normalize (); # perlpkg line 211
# use Cpanel::Locale::Utils::Paths     (); # perlpkg line 211

my %oldname_to_locale;
my $loc;

sub _load_oldnames {

    %oldname_to_locale = (
        &#039;turkish&#039;                   =&gt; &#039;tr&#039;,
        &#039;traditional-chinese&#039;       =&gt; &#039;zh&#039;,
        &#039;thai&#039;                      =&gt; &#039;th&#039;,
        &#039;swedish&#039;                   =&gt; &#039;sv&#039;,
        &#039;spanish-utf8&#039;              =&gt; &#039;es&#039;,
        &#039;spanish&#039;                   =&gt; &#039;es&#039;,
        &#039;slovenian&#039;                 =&gt; &#039;sl&#039;,
        &#039;simplified-chinese&#039;        =&gt; &#039;zh_cn&#039;,
        &#039;russian&#039;                   =&gt; &#039;ru&#039;,
        &#039;romanian&#039;                  =&gt; &#039;ro&#039;,
        &#039;portuguese-utf8&#039;           =&gt; &#039;pt&#039;,
        &#039;portuguese&#039;                =&gt; &#039;pt&#039;,
        &#039;polish&#039;                    =&gt; &#039;pl&#039;,
        &#039;norwegian&#039;                 =&gt; &#039;no&#039;,
        &#039;korean&#039;                    =&gt; &#039;ko&#039;,
        &#039;japanese-shift_jis&#039;        =&gt; &#039;ja&#039;,       # see Cpanel::Locale::Utils::MkDB::compile_single_legacy_from_legacy_system()
        &#039;japanese-euc-jp&#039;           =&gt; &#039;ja&#039;,       # see Cpanel::Locale::Utils::MkDB::compile_single_legacy_from_legacy_system()
        &#039;japanese&#039;                  =&gt; &#039;ja&#039;,       # see Cpanel::Locale::Utils::MkDB::compile_single_legacy_from_legacy_system()
        &#039;spanish_latinamerica&#039;      =&gt; &#039;es_419&#039;,
        &#039;iberian_spanish&#039;           =&gt; &#039;es_es&#039;,
        &#039;italian&#039;                   =&gt; &#039;it&#039;,
        &#039;indonesian&#039;                =&gt; &#039;id&#039;,
        &#039;hungarian&#039;                 =&gt; &#039;hu&#039;,
        &#039;german-utf8&#039;               =&gt; &#039;de&#039;,
        &#039;german&#039;                    =&gt; &#039;de&#039;,
        &#039;french-utf8&#039;               =&gt; &#039;fr&#039;,
        &#039;french&#039;                    =&gt; &#039;fr&#039;,
        &#039;finnish&#039;                   =&gt; &#039;fi&#039;,
        &#039;english-utf8&#039;              =&gt; &#039;en&#039;,
        &#039;english&#039;                   =&gt; &#039;en&#039;,
        &#039;dutch-utf8&#039;                =&gt; &#039;nl&#039;,
        &#039;dutch&#039;                     =&gt; &#039;nl&#039;,
        &#039;chinese&#039;                   =&gt; &#039;zh&#039;,
        &#039;bulgarian&#039;                 =&gt; &#039;bg&#039;,
        &#039;brazilian-portuguese-utf8&#039; =&gt; &#039;pt_br&#039;,
        &#039;brazilian-portuguese&#039;      =&gt; &#039;pt_br&#039;,
        &#039;arabic&#039;                    =&gt; &#039;ar&#039;,
    );

    {
        no warnings &#039;redefine&#039;;
        *_load_oldnames = sub { };
    }

    return;
}

sub get_legacy_to_locale_map {
    _load_oldnames();
    return \%oldname_to_locale;
}

sub get_legacy_list_from_locale {
    my ($locale) = @_;
    return         if !$locale;
    $locale = &#039;en&#039; if $locale eq &#039;en_us&#039; || $locale eq &#039;i_default&#039;;
    _load_oldnames();
    return grep { $oldname_to_locale{$_} eq $locale ? 1 : 0 } keys %oldname_to_locale;
}

sub get_best_guess_of_legacy_from_locale {
    my ( $locale, $always_return_useable ) = @_;
    return         if !$locale &amp;&amp; !$always_return_useable;
    $locale = &#039;en&#039; if $locale eq &#039;en_us&#039; || $locale eq &#039;i_default&#039;;
    _load_oldnames();
    my @legacy_locale_matches = grep { $oldname_to_locale{$_} eq $locale ? 1 : 0 } keys %oldname_to_locale;
    return $legacy_locale_matches[0] if @legacy_locale_matches;
    return &#039;english&#039;                 if $always_return_useable;
    return;
}

sub get_legacy_name_list {
    _load_oldnames();

    return sort { $a =~ m/\.local$/ ? $a cmp $b : $b cmp $a } keys %oldname_to_locale;
}

sub get_existing_filesys_legacy_name_list {

    require Cpanel::SafeDir::Read;

    my %args = @_;
    my @extras;
    if ( exists $args{&#039;also_look_in&#039;} &amp;&amp; ref $args{&#039;also_look_in&#039;} eq &#039;ARRAY&#039; ) {
        for my $path ( @{ $args{&#039;also_look_in&#039;} } ) {
            my $copy = $path;
            $copy =~ s/\/lang$//;
            next if !-d &quot;$copy/lang&quot;;
            push @extras, Cpanel::SafeDir::Read::read_dir(&quot;$copy/lang&quot;);
        }
    }

    my @local_less_names;
    my %has_local;
    my @names;

    my $legacy_dir = Cpanel::Locale::Utils::Paths::get_legacy_lang_root();
    for my $name ( grep { $_ !~ m/^\./ } ( $args{&#039;no_root&#039;} ? () : Cpanel::SafeDir::Read::read_dir($legacy_dir) ), @extras ) {
        my $copy = $name;
        if ( $copy =~ s/\.local$// ) {
            $has_local{$copy}++;
        }
        else {
            push @local_less_names, $copy;
        }
    }

    for my $name_localless ( sort { $b cmp $a } @local_less_names ) {
        push @names, exists $has_local{$name_localless} ? ( &quot;$name_localless.local&quot;, $name_localless ) : $name_localless;
    }

    return @names;
}

sub get_legacy_root_in_locale_database_root {
    return Cpanel::Locale::Utils::Paths::get_locale_database_root() . &#039;/legacy&#039;;
}

sub get_legacy_file_cache_path {
    my ($legacy_file) = @_;
    $legacy_file .= &#039;cache&#039;;
    my $legacy_dir = Cpanel::Locale::Utils::Paths::get_legacy_lang_root();
    $legacy_file =~ s{$legacy_dir}{/var/cpanel/lang.cache};
    return $legacy_file;
}

sub map_any_old_style_to_new_style {
    return wantarray
      ? map { get_new_langtag_of_old_style_langname($_) || $_ } @_
      : get_new_langtag_of_old_style_langname( $_[0] ) || $_[0];
}

my %charset_lookup;

sub _determine_via_disassemble {
    my ( $lcl, $oldlang ) = @_;

    my ( $language, $territory, $encoding, $probable_ext );
    my @parts = split( /[^A-Za-z0-9]+/, $oldlang );    # We can&#039;t use Cpanel::CPAN::Locales::normalize_tag since it breaks things into 8 character chunks

    return if @parts == 1;                             # we&#039;ve already tried just $parts[0] if the split is only 1 item
    return if @parts &gt; 4;                              # if there are more than 4 parts then there is unresolveable data

    if ( !ref($lcl) ) {
        $lcl = Cpanel::CPAN::Locales-&gt;new($lcl) or return;
    }

    for my $part (@parts) {
        my $found_part = 0;
        if ( $lcl-&gt;get_code_from_language($part) || $lcl-&gt;get_language_from_code($part) ) {
            if ($language) {
                if ( !$lcl-&gt;get_territory_from_code($part) ) {

                    return;
                }
            }
            else {
                $found_part++;
                $language = $lcl-&gt;get_language_from_code($part) ? $part : $lcl-&gt;get_code_from_language($part);
            }
        }

        if ( !$found_part &amp;&amp; ( $lcl-&gt;get_code_from_territory($part) || $lcl-&gt;get_territory_from_code($part) ) ) {
            if ($territory) {

                return;
            }
            else {
                $found_part++;
                $territory = $lcl-&gt;get_territory_from_code($part) ? $part : $lcl-&gt;get_code_from_territory($part);
            }
        }
        if ( !$found_part ) {
            if ( $part eq $parts[$#parts] ) {    # &amp;&amp; length($part) &lt; $max_len_for_ext
                $probable_ext = $part;
            }
            else {
                if ( !%charset_lookup ) {
                    require Cpanel::Locale::Utils::Charmap;

                    @charset_lookup{ map { Cpanel::Locale::Utils::Normalize::normalize_tag($_) } Cpanel::Locale::Utils::Charmap::get_charmap_list() } = ();
                }

                if ( $charset_lookup{$part} ) {
                    $found_part++;
                    $encoding = $part;
                }
                else {
                    return;
                }
            }
        }
    }

    if ($encoding) {

    }

    if ($probable_ext) {

    }

    if ($language) {
        if ($territory) {
            return &quot;$language\_$territory&quot;;
        }
        else {
            return $language;
        }
    }

    return;
}

sub real_get_new_langtag_of_old_style_langname {
    my ($oldlang) = @_;
    $oldlang = Cpanel::StringFunc::Case::ToLower($oldlang) || &quot;&quot;;    # case 34321 item #3

    $oldlang =~ s/\.legacy_duplicate\..+$//;                         # This &#039;.legacy_duplicate. naming hack&#039; is for copying legacy file into a name that maps back to it&#039;s new target locale

    if ( !defined $oldlang || $oldlang eq &#039;&#039; || $oldlang =~ m/^\s+$/ ) {

        return;                                                      # return a value ?, what is safe ...
    }
    elsif ( Cpanel::Locale::Utils::Normalize::normalize_tag($oldlang) eq &#039;default&#039; ) {

        return;                                                      # return &#039;en&#039; ? could be an incorrect assumption ...
    }
    elsif ( exists $oldname_to_locale{$oldlang} ) {
        return $oldname_to_locale{$oldlang};
    }

    {
        local $@;
        $loc ||= Cpanel::CPAN::Locales-&gt;new(&#039;en&#039;) or die $@;
    }

    my $return;
    if ( $loc-&gt;get_language_from_code($oldlang) ) {
        $return = Cpanel::Locale::Utils::Normalize::normalize_tag($oldlang);    # case 34321 item #4
    }
    else {

        my $locale = $loc-&gt;get_code_from_language($oldlang);
        if ($locale) {
            $return = $locale;    # case 34321 item #2
        }
        else {
            $return = _determine_via_disassemble( $loc, $oldlang );

            if ( !$return ) {

                local $SIG{&#039;__DIE__&#039;};    # may be made moot by case 50857
                for my $nen ( grep { $_ ne &#039;en&#039; } sort( $loc-&gt;get_language_codes() ) ) {


                    my $loca = Cpanel::CPAN::Locales-&gt;new($nen) or next;    # singleton

                    my $locale = $loca-&gt;get_code_from_language($oldlang);
                    if ($locale) {
                        $return = $locale;                                  # case 34321 item #2
                        last;
                    }
                    else {
                        $return = _determine_via_disassemble( $loca, $oldlang );
                        last if $return;
                    }
                }
            }
        }
    }

    if ( !$return ) {

        $return = Cpanel::CPAN::Locales::get_i_tag_for_string($oldlang);
    }

    return $return;
}

sub get_new_langtag_of_old_style_langname {
    _load_oldnames();
    require Cpanel::StringFunc::Case;
    require Cpanel::CPAN::Locales;
    $loc = Cpanel::CPAN::Locales-&gt;new(&#039;en&#039;);
    {
        no warnings &#039;redefine&#039;;
        *get_new_langtag_of_old_style_langname = \&amp;real_get_new_langtag_of_old_style_langname;
    }
    goto &amp;real_get_new_langtag_of_old_style_langname;
}

my $legacy_lookup;

sub phrase_is_legacy_key {
    my ($key) = @_;
    if ( !$legacy_lookup ) {
        require &#039;Cpanel/Locale/Utils/MkDB.pm&#039;;    ## no critic qw(Bareword) - hide from perlpkg
        $legacy_lookup = {
            %{ Cpanel::Locale::Utils::MkDB::get_hash_of_legacy_file( Cpanel::Locale::Utils::Paths::get_legacy_lang_root() . &#039;/english-utf8&#039; ) || {} },
            %{ Cpanel::Locale::Utils::MkDB::get_hash_of_legacy_file(&#039;/usr/local/cpanel/base/frontend/jupiter/lang/english-utf8&#039;) || {} },
        };
    }

    return exists $legacy_lookup-&gt;{$key} ? 1 : 0;
}

sub fetch_legacy_lookup {
    return $legacy_lookup if $legacy_lookup;
    phrase_is_legacy_key(&#039;&#039;);    # ensure $legacy_lookup is loaded
    return $legacy_lookup;
}

sub get_legacy_key_english_value {
    my ($key) = @_;
    if ( phrase_is_legacy_key($key) ) {    # inits $legacy_lookup cache
        return $legacy_lookup-&gt;{$key};
    }

    return;
}

1;

} # --- END Cpanel/Locale/Utils/Legacy.pm


{ # --- BEGIN Cpanel/Config/LoadCpUserFile/CurrentUser.pm
package Cpanel::Config::LoadCpUserFile::CurrentUser;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Config::LoadCpUserFile (); # perlpkg line 211


my $_cpuser_ref_singleton;
my $_cpuser_user;

sub load {
    my ($user) = @_;
    if ( $_cpuser_user &amp;&amp; $_cpuser_user eq $user ) {
        return $_cpuser_ref_singleton;
    }
    $_cpuser_user = $user;
    return ( $_cpuser_ref_singleton = Cpanel::Config::LoadCpUserFile::load($user) );
}

sub _reset {
    $_cpuser_ref_singleton = undef;
    $_cpuser_user          = undef;

    return;
}

1;

} # --- END Cpanel/Config/LoadCpUserFile/CurrentUser.pm


{ # --- BEGIN Cpanel/YAML/Syck.pm
package Cpanel::YAML::Syck;


use YAML::Syck ();

sub _init {
    $YAML::Syck::LoadBlessed = 0;
    {
        no warnings &#039;redefine&#039;;
        *Cpanel::YAML::Syck::_init = sub { };
    }
    return;
}

_init();

1;

} # --- END Cpanel/YAML/Syck.pm


{ # --- BEGIN Cpanel/PwUtils.pm
package Cpanel::PwUtils;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Exception (); # perlpkg line 211
# use Cpanel::PwCache   (); # perlpkg line 211

sub normalize_to_uid {
    my ($user) = @_;

    if ( !length $user ) {
        die Cpanel::Exception::create( &#039;MissingParameter&#039;, &#039;Supply a username or a user ID.&#039; );
    }

    return $user if $user !~ tr{0-9}{}c;    # Only has numbers so its a uid

    my $uid = Cpanel::PwCache::getpwnam_noshadow($user);
    if ( !defined $uid ) {
        die Cpanel::Exception::create( &#039;UserNotFound&#039;, [ name =&gt; $user ] );
    }

    return $uid;
}

1;

} # --- END Cpanel/PwUtils.pm


{ # --- BEGIN Cpanel/AccessIds/Normalize.pm
package Cpanel::AccessIds::Normalize;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::ArrayFunc::Uniq (); # perlpkg line 211
# use Cpanel::PwCache         (); # perlpkg line 211
# use Cpanel::PwUtils         (); # perlpkg line 211
# use Cpanel::Exception       (); # perlpkg line 211


sub normalize_user_and_groups {
    my ( $user, @groups ) = @_;

    if ( ( scalar @groups == 1 &amp;&amp; !defined $groups[0] ) || ( scalar @groups &gt; 1 &amp;&amp; scalar( grep { !defined } @groups ) ) ) {
        require Cpanel::Carp;    # no load module for memory
        die Cpanel::Carp::safe_longmess(&quot;Undefined group passed to normalize_user_and_groups&quot;);
    }
    my $uid;

    if ( defined $user &amp;&amp; $user !~ tr{0-9}{}c ) {

        if ( scalar @groups == 1 &amp;&amp; $groups[0] !~ tr{0-9}{}c ) {    # we already have a gid
            return ( $user, $groups[0] );
        }

        $uid = $user;
    }
    elsif ( !scalar @groups ) {
        ( $uid, @groups ) = ( Cpanel::PwCache::getpwnam_noshadow($user) )[ 2, 3 ];

        if ( !defined $uid ) {
            die Cpanel::Exception::create( &#039;UserNotFound&#039;, [ name =&gt; $user ] );
        }
        return ( $uid, @groups );
    }
    else {
        $uid = Cpanel::PwUtils::normalize_to_uid($user);
    }

    my @gids =
      @groups
      ? ( map { !tr{0-9}{}c ? $_ : scalar( ( getgrnam $_ )[2] ) } @groups )
      : ( ( Cpanel::PwCache::getpwuid_noshadow($uid) )[3] // die Cpanel::Exception::create( &#039;UserNotFound&#039;, [ name =&gt; $user ] ) );

    if ( scalar @gids &gt; 2 ) {
        return ( $uid, Cpanel::ArrayFunc::Uniq::uniq(@gids) );
    }
    elsif ( scalar @gids == 2 &amp;&amp; $gids[0] eq $gids[1] ) {
        return ( $uid, $gids[0] );
    }

    return ( $uid, @gids );
}


sub normalize_code_user_groups {
    my @args = @_;

    my $code_index;
    for my $i ( 0 .. $#args ) {
        if ( ref $args[$i] eq &#039;CODE&#039; ) {
            $code_index = $i;
            last;
        }
    }

    die &quot;No coderef found!&quot; if !defined $code_index;

    my $code = splice( @args, $code_index, 1 );

    return ( $code, normalize_user_and_groups( grep { defined } @args ) );
}

1;

} # --- END Cpanel/AccessIds/Normalize.pm


{ # --- BEGIN Cpanel/AccessIds/Utils.pm
package Cpanel::AccessIds::Utils;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::ArrayFunc::Uniq (); # perlpkg line 211
# use Cpanel::Debug           (); # perlpkg line 211

sub normalize_user_and_groups {
    require Cpanel::AccessIds::Normalize;
    goto \&amp;Cpanel::AccessIds::Normalize::normalize_user_and_groups;
}

sub normalize_code_user_groups {
    require Cpanel::AccessIds::Normalize;
    goto \&amp;Cpanel::AccessIds::Normalize::normalize_code_user_groups;
}

sub set_egid {
    my @gids = @_;

    if ( !@gids ) {
        Cpanel::Debug::log_die(&quot;No arguments passed to set_egid()!&quot;);
    }

    if ( scalar @gids &gt; 1 ) {
        @gids = Cpanel::ArrayFunc::Uniq::uniq(@gids);
    }

    _check_positive_int($_) for @gids;

    my $new_egid = join( q{ }, $gids[0], @gids );

    return _set_var( \$), &#039;EGID&#039;, $new_egid );
}

sub set_rgid {
    my ( $gid, @extra_gids ) = @_;

    if (@extra_gids) {
        Cpanel::Debug::log_die(&quot;RGID can only be set to a single value! (Do you want set_egid()?)&quot;);
    }

    _check_positive_int($gid);

    return _set_var( \$(, &#039;RGID&#039;, $gid );
}

sub set_euid {
    my ($uid) = @_;

    _check_positive_int($uid);

    return _set_var( \$&gt;, &#039;EUID&#039;, $uid );
}

sub set_ruid {
    my ($uid) = @_;

    _check_positive_int($uid);

    return _set_var( \$&lt;, &#039;RUID&#039;, $uid );
}

sub _check_positive_int {
    if ( !length $_[0] || $_[0] =~ tr{0-9}{}c ) {
        Cpanel::Debug::log_die(&quot;“$_[0] is not a positive integer!&quot;);
    }

    return 1;
}

sub _set_var {
    my ( $var_r, $name, $desired_value ) = @_;

    my $old_value = $$var_r;
    $$var_r = $desired_value;

    return $desired_value eq $$var_r ? 1 : validate_var_set(
        $name,             # The name of the value like &#039;RUID&#039;
        $desired_value,    # The value we wanted it to be set to
        $$var_r,           # Deferenced variable being set, ex $&lt;
        $old_value         # The value before we set it.
    );
}

sub validate_var_set {
    my ( $name, $desired_value, $new_value, $old_value ) = @_;

    my $error;


    if ( $new_value =~ tr/ // ) {


        my ( $desired_first, @desired_parts ) = split( &#039; &#039;, $desired_value );
        my ( $new_first,     @new_parts )     = split( &#039; &#039;, $new_value );

        if ( $new_first != $desired_first ) {
            $error = 1;
        }
        elsif ( @desired_parts &amp;&amp; @new_parts ) {
            if ( scalar @desired_parts == 1 &amp;&amp; scalar @new_parts == 1 ) {
                if ( $new_parts[0] != $desired_parts[0] ) {
                    $error = 1;
                }
            }
            else {
                @desired_parts = sort { $a &lt;=&gt; $b } Cpanel::ArrayFunc::Uniq::uniq(@desired_parts);
                @new_parts     = sort { $a &lt;=&gt; $b } Cpanel::ArrayFunc::Uniq::uniq(@new_parts);

                for my $i ( 0 .. $#desired_parts ) {
                    if ( $new_parts[$i] != $desired_parts[$i] ) {
                        $error = 1;
                        last;
                    }
                }
            }
        }
    }
    else {
        if ( $new_value != $desired_value ) {
            $error = 1;
        }
    }

    return 1 if !$error;

    if ( defined $old_value ) {
        Cpanel::Debug::log_die(&quot;Failed to change $name from “$old_value” to “$desired_value”: $!&quot;);
    }
    Cpanel::Debug::log_die(&quot;Failed to change $name to “$desired_value”: $!&quot;);

    return 0;    #not reached
}

1;

} # --- END Cpanel/AccessIds/Utils.pm


{ # --- BEGIN Cpanel/AccessIds/ReducedPrivileges.pm
package Cpanel::AccessIds::ReducedPrivileges;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Debug                (); # perlpkg line 211
# use Cpanel::AccessIds::Utils     (); # perlpkg line 211
# use Cpanel::AccessIds::Normalize (); # perlpkg line 211

our $PRIVS_REDUCED = 0;


sub new {    ## no critic qw(Subroutines::RequireArgUnpacking)
    my $class = shift;

    if ( $class ne __PACKAGE__ ) {
        Cpanel::Debug::log_die(&quot;Attempting to drop privileges as &#039;$class&#039;.&quot;);
    }

    my ( $uid, @gids ) = Cpanel::AccessIds::Normalize::normalize_user_and_groups(@_);

    _allowed_to_reduce_privileges();

    _prevent_dropping_to_root( $uid, @gids );

    my $self = {
        &#039;uid&#039;      =&gt; $&gt;,
        &#039;gid&#039;      =&gt; $),
        &#039;new_uid&#039;  =&gt; $uid,
        &#039;new_gid&#039;  =&gt; join( q&lt; &gt;, @gids ),
        &#039;perl5lib&#039; =&gt; $ENV{PERL5LIB},
        &#039;inc&#039;      =&gt; [@INC],                # copy not ref
    };

    _reduce_privileges( $uid, @gids );

    $ENV{PERL5LIB} = &quot;&quot;;
    local $Test::MockFile::STRICT_MODE_STATUS = Test::MockFile::STRICT_MODE_DISABLED() if $INC{&quot;Test/MockFile.pm&quot;};
    @INC = grep { $_ eq &quot;/usr/local/cpanel&quot; || -r $_ } @INC;    ## no critic qw(Variables::RequireLocalizedPunctuationVars)

    $PRIVS_REDUCED = 1;

    return bless $self;                                         ## no critic qw(ClassHierarchies::ProhibitOneArgBless) - implications of adding __PACKAGE__ arg?
}

sub DESTROY {
    my ($self) = @_;

    _allowed_to_restore_privileges( $self-&gt;{&#039;new_uid&#039;}, $self-&gt;{&#039;new_gid&#039;} );

    $ENV{PERL5LIB} = $self-&gt;{perl5lib} if $self-&gt;{perl5lib};
    @INC           = @{ $self-&gt;{inc} } if $self-&gt;{inc};         # do not check ref, if its true and not an array we want it to barf                                             ## no critic qw(Variables::RequireLocalizedPunctuationVars)

    return _restore_privileges( $self-&gt;{&#039;uid&#039;}, $self-&gt;{&#039;gid&#039;} );
}

sub call_as_user {    ## no critic qw(Subroutines::RequireArgUnpacking)
    my ( $code, $uid, $gid, @supplemental_gids ) = Cpanel::AccessIds::Normalize::normalize_code_user_groups(@_);

    _prevent_dropping_to_root( $uid, $gid );

    if ( !$code ) {
        Cpanel::Debug::log_die(&quot;No code reference supplied.&quot;);
    }

    _allowed_to_reduce_privileges();

    my ( $saved_uid, $saved_gid ) = ( $&gt;, $) );

    _reduce_privileges( $uid, $gid, @supplemental_gids );

    local $PRIVS_REDUCED = 1;

    local $ENV{PERL5LIB}                      = &quot;&quot;;
    local $Test::MockFile::STRICT_MODE_STATUS = Test::MockFile::STRICT_MODE_DISABLED() if $INC{&quot;Test/MockFile.pm&quot;};
    local @INC                                = grep { $_ eq &quot;/usr/local/cpanel&quot; || -r $_ } @INC;

    my ( $scalar, @list );

    if (wantarray) {    ## no critic qw(Community::Wantarray)
        @list = eval { $code-&gt;(); };
    }
    elsif ( defined wantarray ) {    ## no critic qw(Community::Wantarray)
        $scalar = eval { $code-&gt;(); };
    }
    else {                           #void context
        eval { $code-&gt;(); };
    }

    my $ex = $@;
    _restore_privileges( $saved_uid, $saved_gid );

    die $ex if $ex;
    return wantarray ? @list : $scalar;    ## no critic qw(Community::Wantarray)
}


sub _allowed_to_reduce_privileges {
    if ( $&lt; != 0 ) {
        Cpanel::Debug::log_die(&quot;Attempting to drop privileges as a normal user with RUID $&lt;&quot;);
    }

    if ( $&gt; != 0 ) {
        Cpanel::Debug::log_die(&quot;Attempting to drop privileges as a normal user with EUID $&gt;&quot;);
    }

    return 1;
}

sub _reduce_privileges {
    my ( $uid, $gid, @supplemental_gids ) = @_;

    Cpanel::AccessIds::Utils::set_egid( $gid, @supplemental_gids );
    Cpanel::AccessIds::Utils::set_euid($uid);

    return 1;
}

sub _prevent_dropping_to_root {


    if ( grep { !defined $_ } @_ ) {
        local $Cpanel::Logger::ENABLE_BACKTRACE = 1;
        Cpanel::Debug::log_die(&quot;Someone gave us an undefined value as program $0&quot;);
    }

    if ( grep { !$_ } @_ ) {
        local $Cpanel::Logger::ENABLE_BACKTRACE = 1;
        Cpanel::Debug::log_die(&quot;Attempting to drop privileges to root as program $0&quot;);
    }

    return 1;
}

sub _allowed_to_restore_privileges {
    my ( $uid, $gid ) = @_;

    if ( $&lt; != 0 ) {
        Cpanel::Debug::log_die(&quot;Attempting to restore privileges as a normal user with RUID $&lt;&quot;);
    }

    if ( $&gt; != $uid ) {
        Cpanel::Debug::log_warn(&quot;EUID ($&gt;) does not match expected reduced user ($uid)&quot;);
    }

    my ( $first_egid, $first_given_gid ) = ( $), $gid );
    $_ = ( split m{ } )[0] for ( $first_egid, $first_given_gid );

    if ( int $first_egid != int $first_given_gid ) {
        Cpanel::Debug::log_warn(&quot;EGID ($)) does not match expected reduced user ($gid)&quot;);
    }
}

sub _restore_privileges {
    my ( $saved_uid, $saved_gid ) = @_;

    Cpanel::AccessIds::Utils::set_euid($saved_uid);
    Cpanel::AccessIds::Utils::set_egid( split m{ }, $saved_gid );

    $PRIVS_REDUCED = 0;

    return 1;
}

1;

} # --- END Cpanel/AccessIds/ReducedPrivileges.pm


{ # --- BEGIN Cpanel/DataStore.pm
package Cpanel::DataStore;


use strict;
use warnings;
no warnings &#039;once&#039;;
# use Cpanel::Debug (); # perlpkg line 211

sub store_ref {
    my ( $file, $outof_ref, $perm ) = @_;

    require Cpanel::YAML::Syck;

    $YAML::Syck::ImplicitTyping = 0;

    local $YAML::Syck::SingleQuote;
    local $YAML::Syck::SortKeys;

    $YAML::Syck::SingleQuote = 1;
    $YAML::Syck::SortKeys    = 1;

    if ( ref($file) ) {

        my $yaml_string = YAML::Syck::Dump($outof_ref);

        print( {$file} _format($yaml_string) ) || return;
        return $file;
    }

    if ( ref($perm) eq &#039;ARRAY&#039; &amp;&amp; !-l $file &amp;&amp; !-e $file ) {
        require Cpanel::FileUtils::TouchFile;    # or use() ?

        my $touch_chmod = sub {
            if ( !Cpanel::FileUtils::TouchFile::touchfile($file) ) {
                Cpanel::Debug::log_info(&quot;Could not touch \xE2\x80\x9C$file\xE2\x80\x9D: $!&quot;);
                return;
            }

            if ( $perm-&gt;[0] ) {
                if ( !chmod( oct( $perm-&gt;[0] ), $file ) ) {
                    Cpanel::Debug::log_info(&quot;Could not chmod \xE2\x80\x9C$file\xE2\x80\x9D to \xE2\x80\x9C$perm-&gt;[0]\xE2\x80\x9D: $!&quot;);
                    return;
                }
            }

            return 1;
        };

        if ( $&gt; == 0 &amp;&amp; $perm-&gt;[1] &amp;&amp; $perm-&gt;[1] ne &#039;root&#039; ) {
            require Cpanel::AccessIds::ReducedPrivileges;    # or use() ?
            Cpanel::AccessIds::ReducedPrivileges::call_as_user( $perm-&gt;[1], $touch_chmod ) || return;
        }
        else {
            $touch_chmod-&gt;() || return;
        }
    }

    if ( open my $yaml_out, &#039;&gt;&#039;, $file ) {
        my $yaml_string = YAML::Syck::Dump($outof_ref);
        print {$yaml_out} _format($yaml_string);
        close $yaml_out;
        return 1;
    }
    else {
        Cpanel::Debug::log_warn(&quot;Could not open file &#039;$file&#039; for writing: $!&quot;);
        return;
    }
}

sub fetch_ref {
    my ( $file, $is_array ) = @_;

    my $fetch_ref = load_ref($file);

    my $data_type = ref $fetch_ref;
    my $data      = $data_type ? $fetch_ref : undef;
    $data_type ||= &#039;UNDEF&#039;;

    if ( $is_array &amp;&amp; $data_type ne &#039;ARRAY&#039; ) {
        return [];
    }
    elsif ( !$is_array &amp;&amp; $data_type ne &#039;HASH&#039; ) {
        return {};
    }

    return $data;
}

sub load_ref {
    my ( $file, $into_ref ) = @_;
    my $file_is_ref = ref($file);
    return if ( !$file_is_ref &amp;&amp; ( !-e $file || -z _ ) );

    require Cpanel::YAML::Syck;

    $YAML::Syck::ImplicitTyping = 0;

    my $struct;

    if ($file_is_ref) {

        local $!;
        $struct = eval {
            local $/;
            local $SIG{__WARN__};
            local $SIG{__DIE__};
            ( YAML::Syck::Load(&lt;$file&gt;) )[0];
        };
        Cpanel::Debug::log_warn(&quot;Error loading YAML data: $!&quot;) if ( !$struct );
    }
    elsif ( open my $yaml_in, &#039;&lt;&#039;, $file ) {
        local $!;
        $struct = eval {
            local $/;
            local $SIG{__WARN__};
            local $SIG{__DIE__};
            ( YAML::Syck::Load(&lt;$yaml_in&gt;) )[0];
        };
        Cpanel::Debug::log_warn(&quot;Error loading YAML data: $!&quot;) if ( !$struct );
        close $yaml_in;
    }
    else {
        my $err = $!;
        Cpanel::Debug::log_warn(&quot;Could not open file &#039;$file&#039; for reading: $err&quot;);
        return;
    }

    if ( !$struct ) {
        Cpanel::Debug::log_warn(&quot;Failed to load YAML data from file $file&quot;);
        return;
    }

    if ( defined $into_ref ) {
        my $type      = ref $into_ref;
        my $yaml_type = ref $struct;
        if ( $yaml_type ne $type ) {
            Cpanel::Debug::log_warn(&quot;Invalid data type from file $file! YAML type $yaml_type does not match expected type $type. Data ignored!&quot;);
            return;    # if we want an empty ref on failure use fetch_ref()
        }

        if ( $yaml_type eq &#039;HASH&#039; ) {
            %{$into_ref} = %{$struct};
        }
        elsif ( $yaml_type eq &#039;ARRAY&#039; ) {
            @{$into_ref} = @{$struct};
        }
        else {
            Cpanel::Debug::log_warn(&quot;YAML in &#039;$file&#039; is not a hash or array reference&quot;);
            return;    # if we want an empty ref on failure use fetch_ref()
        }

        return $into_ref;
    }

    return $struct;
}

sub edit_datastore {
    my ( $file, $editor_cr, $is_array ) = @_;

    if ( ref $editor_cr ne &#039;CODE&#039; ) {
        Cpanel::Debug::log_warn(&#039;second arg needs to be a coderef&#039;);
        return;
    }

    my $ref = $is_array ? [] : {};

    if ( !-e $file ) {
        Cpanel::Debug::log_info(&quot;Data store file $file does not exist. Attempting to create empty datastore.&quot;);
        store_ref( $file, $ref );
    }

    if ( load_ref( $file, $ref ) ) {
        if ( $editor_cr-&gt;($ref) ) {
            if ( !store_ref( $file, $ref ) ) {
                Cpanel::Debug::log_warn(&quot;Modifications to file $file could not be saved&quot;);
                return;
            }
        }
    }
    else {
        Cpanel::Debug::log_warn(&quot;Could not load datastore $file&quot;);
        return;
    }

    return 1;
}

sub _format {
    my ($s) = @_;

    $s =~ s/[ \t]+$//mg;
    return __grapheme_to_character($s);
}

sub __grapheme_to_character {
    my ($yaml_string) = @_;

    $yaml_string = quotemeta($yaml_string);
    $yaml_string =~ s/\\{2}x/\\x/g;
    $yaml_string = eval qq{&quot;$yaml_string&quot;};

    return $yaml_string;
}

1;


} # --- END Cpanel/DataStore.pm


{ # --- BEGIN Cpanel/StringFunc/Trim.pm
package Cpanel::StringFunc::Trim;


use strict;
use warnings;
no warnings &#039;once&#039;;

$Cpanel::StringFunc::Trim::VERSION = &#039;1.02&#039;;

my %ws_chars = ( &quot;\r&quot; =&gt; undef, &quot;\n&quot; =&gt; undef, &quot; &quot; =&gt; undef, &quot;\t&quot; =&gt; undef, &quot;\f&quot; =&gt; undef );

sub trim {
    my ( $str, $totrim ) = @_;
    $str = rtrim( ltrim( $str, $totrim ), $totrim );
    return $str;
}

sub ltrim {
    my ( $str, $totrim ) = @_;
    $str =~ s/^$totrim*//;
    return $str;
}

sub rtrim {
    my ( $str, $totrim ) = @_;
    $str =~ s/$totrim*$//;
    return $str;
}

sub endtrim {
    my ( $str, $totrim ) = @_;

    if ( substr( $str, ( length($totrim) * -1 ), length($totrim) ) eq $totrim ) {
        return substr( $str, 0, ( length($str) - length($totrim) ) );
    }
    return $str;
}

sub begintrim {
    my ( $str, $totrim ) = @_;

    if (
        defined $str &amp;&amp; defined $totrim    # .
        &amp;&amp; substr( $str, 0, length($totrim) ) eq $totrim
    ) {
        return substr( $str, length($totrim) );
    }
    return $str;
}

sub ws_trim {
    my ($this) = @_;

    return unless defined $this;

    my $fix = ref $this eq &#039;SCALAR&#039; ? $this : \$this;

    return unless defined $$fix;

    if ( $$fix =~ tr{\r\n \t\f}{} ) {
        ${$fix} =~ s/^\s+// if exists $ws_chars{ substr( $$fix,  0, 1 ) };
        ${$fix} =~ s/\s+$// if exists $ws_chars{ substr( $$fix, -1, 1 ) };
    }
    return ${$fix};
}

sub ws_trim_array {
    my $ar = ref $_[0] eq &#039;ARRAY&#039; ? $_[0] : [@_];    # [@_] :: copy @_ w/ out unpack first: !! not \@_ in this case !!
    foreach my $idx ( 0 .. scalar( @{$ar} ) - 1 ) {
        $ar-&gt;[$idx] = ws_trim( $ar-&gt;[$idx] );
    }
    return wantarray ? @{$ar} : $ar;
}

sub ws_trim_hash_values {
    my $hr = ref $_[0] eq &#039;HASH&#039; ? $_[0] : {@_};     # {@_} :: copy @_ w/ out unpack first:
    foreach my $key ( keys %{$hr} ) {
        $hr-&gt;{$key} = ws_trim( $hr-&gt;{$key} );
    }
    return wantarray ? %{$hr} : $hr;
}

1;


} # --- END Cpanel/StringFunc/Trim.pm


{ # --- BEGIN Cpanel/Locale/Utils/3rdparty.pm
package Cpanel::Locale::Utils::3rdparty;


use strict;
use warnings;
no warnings &#039;once&#039;;

our %cpanel_provided = (
    &#039;de&#039;               =&gt; 1,
    &#039;en&#039;               =&gt; 1,
    &#039;es_es&#039;            =&gt; 1,
    &#039;i_cpanel_snowmen&#039; =&gt; 1,
    &#039;ru&#039;               =&gt; 1,
    &#039;pt_br&#039;            =&gt; 1,
    &#039;ja&#039;               =&gt; 1,
    &#039;tr&#039;               =&gt; 1,
    &#039;id&#039;,              =&gt; 1,
);

my %locale_to_3rdparty;

sub _load_3rdparty {
    return if (%locale_to_3rdparty);

    %locale_to_3rdparty = (
        &#039;ar&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;us&#039;,
            &#039;awstats&#039;   =&gt; &#039;ar&#039;,
            &#039;webalizer&#039; =&gt; &#039;english&#039;
        },
        &#039;bg&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;bg&#039;,
            &#039;awstats&#039;   =&gt; &#039;bg&#039;,
            &#039;webalizer&#039; =&gt; &#039;english&#039;
        },
        &#039;bn&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;us&#039;,
            &#039;awstats&#039;   =&gt; &#039;en&#039;,
            &#039;webalizer&#039; =&gt; &#039;english&#039;
        },
        &#039;de&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;de&#039;,
            &#039;awstats&#039;   =&gt; &#039;de&#039;,
            &#039;webalizer&#039; =&gt; &#039;german&#039;
        },
        &#039;en&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;us&#039;,
            &#039;awstats&#039;   =&gt; &#039;en&#039;,
            &#039;webalizer&#039; =&gt; &#039;english&#039;
        },
        &#039;es&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;es&#039;,
            &#039;awstats&#039;   =&gt; &#039;es&#039;,
            &#039;webalizer&#039; =&gt; &#039;spanish&#039;
        },
        &#039;es_es&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;es&#039;,
            &#039;awstats&#039;   =&gt; &#039;es&#039;,
            &#039;webalizer&#039; =&gt; &#039;spanish&#039;
        },
        &#039;fi&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;fi&#039;,
            &#039;awstats&#039;   =&gt; &#039;fi&#039;,
            &#039;webalizer&#039; =&gt; &#039;finnish&#039;
        },
        &#039;fr&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;fr&#039;,
            &#039;awstats&#039;   =&gt; &#039;fr&#039;,
            &#039;webalizer&#039; =&gt; &#039;french&#039;
        },
        &#039;hi&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;us&#039;,
            &#039;awstats&#039;   =&gt; &#039;en&#039;,
            &#039;webalizer&#039; =&gt; &#039;english&#039;
        },
        &#039;hu&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;hu&#039;,
            &#039;awstats&#039;   =&gt; &#039;hu&#039;,
            &#039;webalizer&#039; =&gt; &#039;hungarian&#039;
        },
        &#039;id&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;us&#039;,
            &#039;awstats&#039;   =&gt; &#039;id&#039;,
            &#039;webalizer&#039; =&gt; &#039;indonesian&#039;
        },
        &#039;it&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;it&#039;,
            &#039;awstats&#039;   =&gt; &#039;it&#039;,
            &#039;webalizer&#039; =&gt; &#039;italian&#039;
        },
        &#039;ja&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;jpu&#039;,       # appears to be the UTF-8 one
            &#039;awstats&#039;   =&gt; &#039;jp&#039;,
            &#039;webalizer&#039; =&gt; &#039;japanese&#039;
        },
        &#039;ko&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;us&#039;,
            &#039;awstats&#039;   =&gt; &#039;ko&#039;,
            &#039;webalizer&#039; =&gt; &#039;korean&#039;
        },
        &#039;nl&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;nl&#039;,
            &#039;awstats&#039;   =&gt; &#039;nl&#039;,
            &#039;webalizer&#039; =&gt; &#039;dutch&#039;
        },
        &#039;no&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;no&#039;,
            &#039;awstats&#039;   =&gt; &#039;en&#039;,
            &#039;webalizer&#039; =&gt; &#039;norwegian&#039;
        },
        &#039;pl&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;pl&#039;,
            &#039;awstats&#039;   =&gt; &#039;pl&#039;,
            &#039;webalizer&#039; =&gt; &#039;polish&#039;
        },
        &#039;pt&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;pt&#039;,
            &#039;awstats&#039;   =&gt; &#039;pt&#039;,
            &#039;webalizer&#039; =&gt; &#039;portuguese&#039;
        },
        &#039;pt_br&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;pt&#039;,
            &#039;awstats&#039;   =&gt; &#039;pt&#039;,
            &#039;webalizer&#039; =&gt; &#039;portuguese_brazil&#039;
        },
        &#039;ro&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;ro&#039;,
            &#039;awstats&#039;   =&gt; &#039;ro&#039;,
            &#039;webalizer&#039; =&gt; &#039;romanian&#039;
        },
        &#039;ru&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;ru&#039;,
            &#039;awstats&#039;   =&gt; &#039;ru&#039;,
            &#039;webalizer&#039; =&gt; &#039;russian&#039;
        },
        &#039;sl&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;us&#039;,
            &#039;awstats&#039;   =&gt; &#039;en&#039;,
            &#039;webalizer&#039; =&gt; &#039;slovene&#039;
        },
        &#039;sv&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;us&#039;,
            &#039;awstats&#039;   =&gt; &#039;en&#039;,
            &#039;webalizer&#039; =&gt; &#039;swedish&#039;
        },
        &#039;th&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;us&#039;,
            &#039;awstats&#039;   =&gt; &#039;th&#039;,
            &#039;webalizer&#039; =&gt; &#039;english&#039;
        },
        &#039;tr&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;tr&#039;,
            &#039;awstats&#039;   =&gt; &#039;tr&#039;,
            &#039;webalizer&#039; =&gt; &#039;turkish&#039;
        },
        &#039;zh&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;cn&#039;,       # the cn.lng does not say what it is so this is an assumption based on other pervasive bad practices
            &#039;awstats&#039;   =&gt; &#039;cn&#039;,
            &#039;webalizer&#039; =&gt; &#039;chinese&#039;
        },
        &#039;zh_cn&#039; =&gt; {
            &#039;analog&#039;    =&gt; &#039;cn&#039;,                  # the cn.lng does not say what it is so this is an assumption based on other pervasive bad practices
            &#039;awstats&#039;   =&gt; &#039;cn&#039;,
            &#039;webalizer&#039; =&gt; &#039;simplified_chinese&#039;
        },
    );
}

sub get_known_3rdparty_lang {
    my ( $locale, $_3rdparty ) = @_;
    _load_3rdparty();
    my $locale_tag = ref $locale ? $locale-&gt;get_language_tag() : $locale;
    $locale_tag = &#039;en&#039; if $locale_tag eq &#039;en_us&#039; || $locale_tag eq &#039;i_default&#039;;

    return if !exists $locale_to_3rdparty{$locale_tag};
    return if !exists $locale_to_3rdparty{$locale_tag}{$_3rdparty};
    return $locale_to_3rdparty{$locale_tag}{$_3rdparty};
}

my %locale_lookup_cache;

sub get_3rdparty_lang {
    my ( $locale, $_3rdparty ) = @_;
    my $known = get_known_3rdparty_lang( $locale, $_3rdparty );
    return $known if $known;

    return if !ref($locale) &amp;&amp; $locale =~ m/(?:\.\.|\/)/;
    return if $_3rdparty               =~ m/(?:\.\.|\/)/;

    my $locale_tag = ref $locale ? $locale-&gt;get_language_tag() : $locale;
    $locale_tag = &#039;en&#039; if $locale_tag eq &#039;en_us&#039; || $locale_tag eq &#039;i_default&#039;;

    if ( exists $locale_lookup_cache{$_3rdparty} ) {
        return $locale_lookup_cache{$_3rdparty}{$locale_tag} if exists $locale_lookup_cache{$_3rdparty}{$locale_tag};
        return;
    }
    require Cpanel::DataStore;
    my $hr = Cpanel::DataStore::fetch_ref(&quot;/var/cpanel/locale/3rdparty/apps/$_3rdparty.yaml&quot;);
    my %seen;
    %{ $locale_lookup_cache{$_3rdparty} } = map { ++$seen{ $hr-&gt;{$_} } == 1 ? ( $hr-&gt;{$_} =&gt; $_ ) : () } keys %{$hr};

    return $locale_lookup_cache{$_3rdparty}{$locale_tag} if exists $locale_lookup_cache{$_3rdparty}{$locale_tag};
    return;
}

my @list;

sub get_3rdparty_list {
    return @list if @list;

    @list = qw(analog awstats webalizer);

    if ( -d &quot;/var/cpanel/locale/3rdparty/apps&quot; ) {
        require Cpanel::SafeDir::Read;
        push @list, sort map { my $f = $_; $f =~ s/\.yaml$// ? ($f) : () } Cpanel::SafeDir::Read::read_dir(&quot;/var/cpanel/locale/3rdparty/apps&quot;);
    }

    return @list;
}

my %opt_cache;

sub get_app_options {
    my ($_3rdparty) = @_;
    return if $_3rdparty =~ m/(?:\.\.|\/)/;

    return $opt_cache{$_3rdparty} if exists $opt_cache{$_3rdparty};
    if ( $_3rdparty eq &#039;analog&#039; || $_3rdparty eq &#039;awstats&#039; || $_3rdparty eq &#039;webalizer&#039; ) {
        _load_3rdparty();
        my %seen;
        $opt_cache{$_3rdparty} = [ sort map { ++$seen{ $locale_to_3rdparty{$_}{$_3rdparty} } == 1 ? ( $locale_to_3rdparty{$_}{$_3rdparty} ) : () } keys %locale_to_3rdparty ];
    }
    else {
        require Cpanel::DataStore;
        my $hr = Cpanel::DataStore::fetch_ref(&quot;/var/cpanel/locale/3rdparty/apps/$_3rdparty.yaml&quot;);
        $opt_cache{$_3rdparty} = [ sort keys %{$hr} ];
    }

    return $opt_cache{$_3rdparty};
}

sub get_app_setting {
    my ( $locale, $_3rdparty ) = @_;

    return if !ref($locale) &amp;&amp; $locale =~ m/(?:\.\.|\/)/;
    return if $_3rdparty               =~ m/(?:\.\.|\/)/;

    require Cpanel::LoadFile;
    require Cpanel::StringFunc::Trim;

    my $locale_tag = ref $locale ? $locale-&gt;get_language_tag() : $locale;
    $locale_tag = &#039;en&#039; if $locale_tag eq &#039;en_us&#039; || $locale_tag eq &#039;i_default&#039;;

    my $setting = Cpanel::StringFunc::Trim::ws_trim( Cpanel::LoadFile::loadfile(&quot;/var/cpanel/locale/3rdparty/conf/$locale_tag/$_3rdparty&quot;) ) || &#039;&#039;;
    if ( $_3rdparty eq &#039;analog&#039; &amp;&amp; $setting eq &#039;en&#039; ) {
        $setting = &#039;us&#039;;
    }

    return $setting;
}

sub set_app_setting {
    my ( $locale, $_3rdparty, $setting ) = @_;

    return if !ref($locale) &amp;&amp; $locale =~ m/(?:\.\.|\/)/;
    return if $_3rdparty               =~ m/(?:\.\.|\/)/;

    require Cpanel::SafeDir::MK;
    require Cpanel::FileUtils::Write;

    my $locale_tag = ref $locale ? $locale-&gt;get_language_tag() : $locale;
    $locale_tag = &#039;en&#039; if $locale_tag eq &#039;en_us&#039; || $locale_tag eq &#039;i_default&#039;;

    Cpanel::SafeDir::MK::safemkdir(&quot;/var/cpanel/locale/3rdparty/conf/$locale_tag/&quot;);
    Cpanel::FileUtils::Write::overwrite_no_exceptions( &quot;/var/cpanel/locale/3rdparty/conf/$locale_tag/$_3rdparty&quot;, $setting, 0644 );

    return;
}

1;

} # --- END Cpanel/Locale/Utils/3rdparty.pm


{ # --- BEGIN Cpanel/JS/Variations.pm
package Cpanel::JS::Variations;


use strict;

sub lex_filename_for {
    my ( $filename, $locale ) = @_;
    return if !$filename || !$locale;
    return get_base_file( $filename, &quot;-${locale}.js&quot; );
}

sub get_base_file {
    my ( $filename, $replace_extension ) = @_;
    return if !$filename;
    $replace_extension //= &#039;.js&#039;;
    $filename =~ s{/js2-min/}{/js2/};
    $filename =~ s{(?:[\.\-]min|_optimized)?\.js$}{$replace_extension};
    return $filename;
}

1;

} # --- END Cpanel/JS/Variations.pm


{ # --- BEGIN Cpanel/Locale/Utils/Display.pm
package Cpanel::Locale::Utils::Display;


use warnings;
no warnings &#039;once&#039;;
use strict;
# use Cpanel::Locale::Utils::Paths (); # perlpkg line 211

sub get_locale_list {
    my ($lh) = @_;
    my @result = @{ $lh-&gt;{&#039;_cached_get_locale_list&#039;} ||= [ sort ( &#039;en&#039;, $lh-&gt;list_available_locales() ) ] };

    if ( !-e &quot;/var/cpanel/enable_snowmen&quot; ) {
        @result = grep { !/i_cpanel_snowmen/ } @result;
    }
    return @result;
}

sub get_non_existent_locale_list {
    my ( $lh, $loc_obj ) = @_;

    $loc_obj ||= $lh-&gt;get_locales_obj(&#039;en&#039;);
    my %have;
    @have{ get_locale_list($lh), &#039;en_us&#039;, &#039;i_default&#039;, &#039;und&#039;, &#039;zxx&#039;, &#039;mul&#039;, &#039;mis&#039;, &#039;art&#039; } = ();
    return sort grep { !exists $have{$_} } $loc_obj-&gt;get_language_codes();
}

sub get_locale_menu_hashref {
    my ( $lh, $omit_current_locale, $native_only, $skip_locales ) = @_;

    $skip_locales ||= {};
    my %langs;
    my %dir;

    my @langs = get_locale_list($lh);

    my @wanted_langs = grep { !$skip_locales-&gt;{$_} } @langs;

    if ( !@wanted_langs ) {
        return ( {}, \@langs, {} );
    }

    my $func = $native_only ? &#039;lang_names_hashref_native_only&#039; : &#039;lang_names_hashref&#039;;
    my ( $localized_name_for_tag, $native_name_for_tag, $direction_map ) = $lh-&gt;$func(@wanted_langs);
    my $current_tag = $lh-&gt;get_language_tag();
    $current_tag = &#039;en&#039; if $current_tag eq &#039;en_us&#039; || $current_tag eq &#039;i_default&#039;;

    my $i_locales_path = Cpanel::Locale::Utils::Paths::get_i_locales_config_path();
    if ($omit_current_locale) {
        delete $localized_name_for_tag-&gt;{$current_tag};
        delete $native_name_for_tag-&gt;{$current_tag};
        @langs = grep { $_ ne $current_tag } @langs;
    }

    foreach my $tag ( keys %{$localized_name_for_tag} ) {
        if ( index( $tag, &#039;i_&#039; ) == 0 ) {
            require Cpanel::DataStore;
            my $i_conf = Cpanel::DataStore::fetch_ref(&quot;$i_locales_path/$tag.yaml&quot;);
            $langs{$tag} = exists $i_conf-&gt;{&#039;display_name&#039;} &amp;&amp; defined $i_conf-&gt;{&#039;display_name&#039;} &amp;&amp; $i_conf-&gt;{&#039;display_name&#039;} ne &#039;&#039; ? &quot;$i_conf-&gt;{&#039;display_name&#039;} - $tag&quot; : $tag;                    # slightly different format than real tags to visually indicate specialness
            $native_name_for_tag-&gt;{$tag} = $langs{$tag};

            if ( exists $i_conf-&gt;{&#039;character_orientation&#039;} ) {
                $dir{$tag} = $lh-&gt;get_html_dir_attr( $i_conf-&gt;{&#039;character_orientation&#039;} );
            }
            elsif ( exists $i_conf-&gt;{&#039;fallback_locale&#039;} &amp;&amp; exists $direction_map-&gt;{ $i_conf-&gt;{&#039;fallback_locale&#039;} } ) {
                $dir{$tag} = $direction_map-&gt;{ $i_conf-&gt;{&#039;fallback_locale&#039;} };
            }

            next;
        }

        if ( exists $direction_map-&gt;{$tag} ) {
            $dir{$tag} = $lh-&gt;get_html_dir_attr( $direction_map-&gt;{$tag} );
        }

        next if $native_only;

        if ( $native_name_for_tag-&gt;{$tag} eq $localized_name_for_tag-&gt;{$tag} ) {
            if ( $tag eq $current_tag ) {
                $langs{$tag} = $native_name_for_tag-&gt;{$tag};
            }
            else {
                $langs{$tag} = &quot;$localized_name_for_tag-&gt;{$tag} ($tag)&quot;;
            }
        }
        else {
            $langs{$tag} = &quot;$localized_name_for_tag-&gt;{$tag} ($native_name_for_tag-&gt;{$tag})&quot;;
        }
    }

    if ($native_only) {
        return wantarray ? ( $native_name_for_tag, \@langs, \%dir ) : $native_name_for_tag;
    }

    return wantarray ? ( \%langs, \@langs, \%dir ) : \%langs;
}

sub get_non_existent_locale_menu_hashref {
    my $lh = shift;

    $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;} ||= $lh-&gt;get_locales_obj();

    my %langs;
    my %dir;
    my @langs = get_non_existent_locale_list( $lh, $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;} );

    my $wantarray = wantarray() ? 1 : 0;

    for my $code (@langs) {
        if ($wantarray) {
            if ( my $orient = $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}-&gt;get_character_orientation_from_code_fast($code) ) {
                $dir{$code} = $lh-&gt;get_html_dir_attr($orient);
            }
        }

        my $current = $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}-&gt;get_language_from_code( $code, 1 );
        my $native  = $lh-&gt;{&#039;Locales.pm&#039;}{&#039;_main_&#039;}-&gt;get_native_language_from_code( $code, 1 );
        $langs{$code} = $current eq $native ? &quot;$current ($code)&quot; : &quot;$current ($native)&quot;;
    }

    return wantarray ? ( \%langs, \@langs, \%dir ) : \%langs;
}

sub in_translation_vetting_mode {
    return ( -e &#039;/var/cpanel/translation_vetting_mode&#039; ) ? 1 : 0;
}

1;

} # --- END Cpanel/Locale/Utils/Display.pm


{ # --- BEGIN Cpanel/Locale/Utils/Api1.pm
package Cpanel::Locale::Utils::Api1;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use Cpanel::Locale (); # perlpkg line 211

my $_lh;

sub _api1_maketext {    ## no critic qw(Subroutines::RequireArgUnpacking)                             ## no extract maketext
    $_lh ||= Cpanel::Locale-&gt;get_handle();
    $_[0] =~ s{\\&#039;}{&#039;}g;
    my $localized_str = $_lh-&gt;makevar(@_);
    if ($Cpanel::Parser::Vars::embtag) {    # PPI NO PARSE -- module will already be there is we care about it

        require Cpanel::Encoder::Tiny;
        $localized_str = Cpanel::Encoder::Tiny::safe_html_encode_str($localized_str);
    }
    elsif ($Cpanel::Parser::Vars::javascript) {    # PPI NO PARSE -- module will already be there is we care about it
        $localized_str =~ s/&quot;/\\&quot;/g;
        $localized_str =~ s/&#039;/\\&#039;/g;
    }
    return {
        status    =&gt; 1,
        statusmsg =&gt; $localized_str,
    };
}

1;

} # --- END Cpanel/Locale/Utils/Api1.pm


{ # --- BEGIN Cpanel/SafeRun/Simple.pm
package Cpanel::SafeRun::Simple;


use strict;

# use Cpanel::FHUtils::Autoflush (); # perlpkg line 211
# use Cpanel::LoadFile::ReadFast (); # perlpkg line 211
# use Cpanel::SV                 (); # perlpkg line 211

BEGIN {
    eval { require Proc::FastSpawn; };
}

my $KEEP_STDERR  = 0;
my $MERGE_STDERR = 1;
my $NULL_STDERR  = 2;
my $NULL_STDOUT  = 3;

sub saferun_r {
    return _saferun_r( \@_ );
}

sub _saferun_r {    ## no critic qw(Subroutines::ProhibitExcessComplexity)
    my ( $cmdline, $error_flag ) = @_;

    if ($Cpanel::AccessIds::ReducedPrivileges::PRIVS_REDUCED) {    # PPI NO PARSE --  can&#039;t be reduced if the module isn&#039;t loaded
        eval &quot;use Cpanel::Carp;&quot;;                                  ## no critic qw(BuiltinFunctions::ProhibitStringyEval)
        die Cpanel::Carp::safe_longmess( __PACKAGE__ . &quot; cannot be used with ReducedPrivileges. Use Cpanel::SafeRun::Object instead&quot; );
    }
    elsif ( scalar @$cmdline == 1 &amp;&amp; $cmdline-&gt;[0] =~ tr{&gt;&lt;*?[]`$()|;&amp;#$\\\r\n\t }{} ) {
        eval &quot;use Cpanel::Carp;&quot;;                                  ## no critic qw(BuiltinFunctions::ProhibitStringyEval)
        die Cpanel::Carp::safe_longmess( __PACKAGE__ . &quot; prevents accidental execution of a shell.  If you intended to execute a shell use saferun(&quot; . join( &#039;,&#039;, &#039;/bin/sh&#039;, &#039;-c&#039;, @$cmdline ) . &quot;)&quot; );
    }

    my $output;

    if ( index( $cmdline-&gt;[0], &#039;/&#039; ) == 0 ) {
        my ($check) = !-e $cmdline-&gt;[0] &amp;&amp; $cmdline-&gt;[0] =~ /[\s&lt;&gt;&amp;\|\;]/ ? split( /[\s&lt;&gt;&amp;\|\;]/, $cmdline-&gt;[0], 2 ) : $cmdline-&gt;[0];

        if ( !-x $check ) {
            $? = -1;

            return \$output;
        }

    }
    $error_flag ||= 0;
    local ($/);
    my ( $pid, $prog_fh, $did_fastspawn );

    if ( $INC{&#039;Proc/FastSpawn.pm&#039;} ) {    # may not be available yet due to upcp.static or updatenow.static

        my @env = map { exists $ENV{$_} &amp;&amp; $_ ne &#039;IFS&#039; &amp;&amp; $_ ne &#039;CDPATH&#039; &amp;&amp; $_ ne &#039;ENV&#039; &amp;&amp; $_ ne &#039;BASH_ENV&#039; ? ( $_ . &#039;=&#039; . ( $ENV{$_} // &#039;&#039; ) ) : () } keys %ENV;

        my ($child_write);
        pipe( $prog_fh, $child_write ) or warn &quot;Failed to pipe(): $!&quot;;

        my $null_fh;
        if ( $error_flag == $NULL_STDERR || $error_flag == $NULL_STDOUT ) {
            open( $null_fh, &#039;&gt;&#039;, &#039;/dev/null&#039; ) or die &quot;Failed open /dev/null: $!&quot;;
        }

        Cpanel::FHUtils::Autoflush::enable($_) for ( $prog_fh, $child_write );

        $did_fastspawn = 1;

        my $stdout_fileno = fileno($child_write);
        my $stderr_fileno = -1;

        if ( $error_flag == $MERGE_STDERR ) {
            $stderr_fileno = fileno($child_write);
        }
        elsif ( $error_flag == $NULL_STDERR ) {
            $stderr_fileno = fileno($null_fh);
        }
        elsif ( $error_flag == $NULL_STDOUT ) {
            $stdout_fileno = fileno($null_fh);
            $stderr_fileno = fileno($child_write);
        }

        $pid = Proc::FastSpawn::spawn_open3(
            -1,                # stdin
            $stdout_fileno,    # stdout
            $stderr_fileno,    # stderr
            $cmdline-&gt;[0],     # program
            $cmdline,          # args
            \@env,             #env
        );

    }
    else {
        if ( $pid = open( $prog_fh, &#039;-|&#039; ) ) {

        }
        elsif ( defined $pid ) {

            delete @ENV{qw(IFS CDPATH ENV BASH_ENV)};

            $ENV{&#039;PATH&#039;} ||= &#039;&#039;;
            Cpanel::SV::untaint( $ENV{&#039;PATH&#039;} );

            if ( $error_flag == $MERGE_STDERR ) {
                open( STDERR, &#039;&gt;&amp;STDOUT&#039; ) or die &quot;Failed to redirect STDERR to STDOUT: $!&quot;;
            }
            elsif ( $error_flag == $NULL_STDERR ) {
                open( STDERR, &#039;&gt;&#039;, &#039;/dev/null&#039; ) or die &quot;Failed to open /dev/null: $!&quot;;
            }
            elsif ( $error_flag == $NULL_STDOUT ) {
                open( STDERR, &#039;&gt;&amp;STDOUT&#039; ) or die &quot;Failed to redirect STDERR to STDOUT: $!&quot;;
                open( STDOUT, &#039;&gt;&#039;, &#039;/dev/null&#039; ) or die &quot;Failed to redirect STDOUT to /dev/null: $!&quot;;
            }
            exec(@$cmdline) or exit( $! || 127 );
        }
        else {
            die &quot;fork() failed: $!&quot;;
        }
    }
    if ( !$prog_fh || !$pid ) {

        $? = -1;    ## no critic qw(Variables::RequireLocalizedPunctuationVars)

        return \$output;
    }
    Cpanel::LoadFile::ReadFast::read_all_fast( $prog_fh, $output );
    close($prog_fh);

    waitpid( $pid, 0 ) if $did_fastspawn;

    return \$output;
}

sub _call_saferun {
    my ( $args, $flag ) = @_;
    my $ref = _saferun_r( $args, $flag || 0 );

    return $$ref if $ref;
    return;
}

sub saferun {
    return _call_saferun( \@_, $KEEP_STDERR );
}

sub saferunallerrors {
    return _call_saferun( \@_, $MERGE_STDERR );
}

sub saferunnoerror {
    return _call_saferun( \@_, $NULL_STDERR );
}

sub saferunonlyerrors {
    return _call_saferun( \@_, $NULL_STDOUT );
}

1;

} # --- END Cpanel/SafeRun/Simple.pm


{ # --- BEGIN Cpanel/SafeRun/Errors.pm
package Cpanel::SafeRun::Errors;


use strict;

# use Cpanel::SafeRun::Simple (); # perlpkg line 211


sub saferunallerrors {
    my $output_ref = Cpanel::SafeRun::Simple::_saferun_r( \@_, 1 );    #1 = errors to stdout
    return wantarray ? split( /\n/, $$output_ref ) : $$output_ref;
}

sub saferunnoerror {
    my $output_ref = Cpanel::SafeRun::Simple::_saferun_r( \@_, 2 );    # 2 = errors to devnull
    return wantarray ? split( /\n/, $$output_ref ) : $$output_ref;
}

sub saferunonlyerrors {
    my $output_ref = Cpanel::SafeRun::Simple::_saferun_r( \@_, 3 );
    return wantarray ? split( /\n/, $$output_ref ) : $$output_ref;
}

1;

} # --- END Cpanel/SafeRun/Errors.pm


{ # --- BEGIN Cpanel/FileUtils/Lines.pm
package Cpanel::FileUtils::Lines;


use strict;
# use Cpanel::Debug (); # perlpkg line 211
use IO::SigGuard  ();

use constant _ENOENT =&gt; 2;

our $VERSION = &#039;1.0&#039;;

my $MAX_LINE_SIZE = 32768;

sub get_file_lines {
    my $cfgfile     = shift;
    my $line_number = shift;
    return if ( !$line_number || $line_number !~ m/^\d+$/ );

    my $numpadding = 7;
    my %ret;
    if ( open( my $cfg_fh, &#039;&lt;&#039;, $cfgfile ) ) {
        my $linecounter = 0;
        while ( readline($cfg_fh) ) {
            $linecounter++;
            if ( $linecounter &lt; $line_number &amp;&amp; $linecounter &gt; ( $line_number - $numpadding ) ) {
                push @{ $ret{&#039;previouslines&#039;} }, { &#039;line&#039; =&gt; $linecounter, &#039;data&#039; =&gt; $_ };
            }
            elsif ( $linecounter &gt; $line_number &amp;&amp; $linecounter &lt; ( $line_number + $numpadding ) ) {
                push @{ $ret{&#039;afterlines&#039;} }, { &#039;line&#039; =&gt; $linecounter, &#039;data&#039; =&gt; $_ };
            }
            elsif ( $linecounter == $line_number ) {
                push @{ $ret{&#039;lines&#039;} }, { &#039;line&#039; =&gt; $linecounter, &#039;data&#039; =&gt; $_ };
            }
            elsif ( $linecounter &gt; ( $line_number + $numpadding ) ) {
                last;
            }
        }
        close $cfg_fh;
    }
    return \%ret;
}

sub get_last_lines {
    my $cfgfile = shift;
    my $number  = shift;
    if ( !$number || $number !~ m/^\d+$/ ) {
        $number = 10;
    }
    my @lines;

    if ( open( my $cfg_fh, &#039;&lt;&#039;, $cfgfile ) ) {
        my $size = ( stat($cfg_fh) )[7];
        if ( $size &gt; ( $MAX_LINE_SIZE * $number ) ) {

            seek( $cfg_fh, $size - ( $MAX_LINE_SIZE * $number ), 0 );
        }
        my $linecounter = 0;
        while ( my $line = readline($cfg_fh) ) {
            chomp $line;
            if ( $linecounter &gt;= $number ) {
                shift @lines;
            }
            push @lines, $line;
            $linecounter++;
        }
        close $cfg_fh;
    }
    else {
        Cpanel::Debug::log_warn(&quot;Unable to open $cfgfile: $!&quot;);
    }
    return wantarray ? @lines : \@lines;
}

sub has_txt_in_file {
    my ( $file, $txt ) = @_;

    my $regex;
    eval { $regex = qr($txt); };
    if ($@) {
        Cpanel::Debug::log_warn(&#039;Invalid regex&#039;);
        return;
    }

    my $fh;
    if ( open $fh, &#039;&lt;&#039;, $file ) {
        while ( my $line = readline $fh ) {
            if ( $line =~ $regex ) {
                close $fh;
                return 1;
            }
        }

        close $fh;
    }

    return;
}

sub appendline {
    my ( $filename, $line ) = @_;
    my $fh;

    if ( open my $fh, &#039;&gt;&gt;:stdio&#039;, $filename ) {

        IO::SigGuard::syswrite( $fh, $line . &quot;\n&quot; ) or do {
            warn &quot;write($filename): $!&quot;;
        };

        close $fh;
        return 1;
    }
    else {
        warn &quot;open($filename): $!&quot; if $! != _ENOENT();
    }

    return;
}

1;

} # --- END Cpanel/FileUtils/Lines.pm


{ # --- BEGIN Cpanel/Timezones.pm
package Cpanel::Timezones;


use cPstrict;
no warnings &#039;once&#039;;

# use Cpanel::OS    (); # perlpkg line 211
# use Cpanel::Debug (); # perlpkg line 211
# use Cpanel::SafeRun::Errors(); # perlpkg line 211

use Cwd        ();
use List::Util ();

use constant _ENOENT =&gt; 2;

our $timezones_cachefile = &#039;/var/cpanel/timezones.cache&#039;;
my $cache_ttl = 3_600 * 24 * 7 * 6;    #6 WEEKS

our $timezones_cache;

our $timezonedir   = &#039;/usr/share/zoneinfo&#039;;
our $zonetabfile   = &#039;/usr/share/zoneinfo/zone.tab&#039;;
our $etc_localtime = &#039;/etc/localtime&#039;;

sub gettimezones() {
    if ( !$timezones_cache ) {
        my $timezones;

        if ( open my $fh, &#039;&lt;&#039;, $timezones_cachefile ) {
            $timezones = -f $fh;
            $timezones &amp;&amp;= ( time - ( stat $fh )[9] ) &lt; $cache_ttl;

            $timezones &amp;&amp;= [&lt;$fh&gt;];
            chomp @$timezones if $timezones;
        }
        elsif ( $! != _ENOENT ) {
            warn &quot;open($timezones_cachefile): $!&quot;;
        }

        if ( !$timezones || !scalar @{$timezones} || !grep { $_ eq &quot;UTC&quot; } @$timezones ) {
            $timezones = [];
            get_timezones_from_zonetab($timezones);

            if ( !scalar @{$timezones} ) {
                require Cpanel::FileUtils::Lines;
                require File::Find;
                File::Find::find(
                    sub {
                        if ( Cpanel::FileUtils::Lines::has_txt_in_file( $File::Find::name, &#039;\ATZif&#039; ) ) {
                            ( my $stripped_name = $File::Find::name ) =~ s{\A$timezonedir/}{};
                            push @{$timezones}, $stripped_name;
                        }
                    },
                    $timezonedir
                );
            }
            push @$timezones, &quot;UTC&quot; unless grep { $_ eq &quot;UTC&quot; } @$timezones;

            if ( _running_as_root() ) {
                require Cpanel::FileUtils::Write;
                Cpanel::FileUtils::Write::overwrite_no_exceptions( $timezones_cachefile, join( &quot;\n&quot;, @{$timezones} ), 0644 );
            }
        }

        $timezones_cache = $timezones;
    }

    return wantarray ? @$timezones_cache : $timezones_cache;
}

sub _running_as_root {
    return $&gt; == 0 ? 1 : 0;
}

sub is_valid ($tz) {
    my $is_valid;

    require Cpanel::FileUtils::Lines;
    if ($timezones_cache) {
        $is_valid = grep { $_ eq $tz } @$timezones_cache;
    }
    elsif ( -f $timezones_cachefile &amp;&amp; ( time() - ( stat $timezones_cachefile )[9] &lt;= $cache_ttl ) ) {

        $is_valid = Cpanel::FileUtils::Lines::has_txt_in_file( $timezones_cachefile, qr(\A\Q$tz\E\Z) );
    }
    else {
        $is_valid = grep { $_ eq $tz } ( gettimezones() );
    }

    return $is_valid;
}

sub set ($tz) {

    return unless is_valid($tz);

    my $method = Cpanel::OS::setup_tz_method();

    if ( $method eq &#039;timedatectl&#039; ) {
        _setup_clock_using_timedatectl($tz);
    }
    elsif ( $method eq &#039;sysconfig&#039; ) {
        _setup_clock_using_sysconfig($tz);
    }
    else {
        Cpanel::Debug::log_die(&quot;Invalid setup_tz_method method: $method&quot;);
    }

    return;
}

sub _get_active_timezone {
    my @tz_data = Cpanel::SafeRun::Errors::saferunallerrors( &#039;/usr/bin/timedatectl&#039;, &#039;show&#039; );

    my ( undef, $tz_name ) = split( q{=}, List::Util::first { /^timezone=/i } @tz_data );

    return $tz_name;
}

sub _setup_clock_using_timedatectl ($tz) {

    Cpanel::SafeRun::Errors::saferunallerrors( &#039;/usr/bin/timedatectl&#039;, &#039;set-timezone&#039;, $tz );

    return;
}

sub _setup_clock_using_sysconfig ($tz) {

    my @CLOCK;

    if ( open( my $fh, &#039;&lt;&#039;, &#039;/etc/sysconfig/clock&#039; ) ) {
        @CLOCK = (&lt;$fh&gt;);
        close($fh);
    }
    else {
        Cpanel::Debug::log_warn(qq[Could not open file &quot;/etc/sysconfig/clock&quot; for reading ($!)]);
    }

    if ( open( my $fh, &#039;&gt;&#039;, &#039;/etc/sysconfig/clock&#039; ) ) {
        my $ok;
        foreach my $line (@CLOCK) {
            if ( $line =~ m{\AZONE=}i ) {
                $ok = 1;
                print {$fh} qq[ZONE=&quot;$tz&quot;\n];
            }
            else {
                print {$fh} $line;
            }
        }
        print {$fh} qq[ZONE=&quot;$tz&quot;\n] unless $ok;
        close($fh);

        unlink $etc_localtime;
        symlink &quot;/usr/share/zoneinfo/$tz&quot;, $etc_localtime;

    }
    else {
        Cpanel::Debug::log_warn(qq[Could not open file &quot;/etc/sysconfig/clock&quot; for writing ($!)]);
    }

    return;
}

sub get_timezones_from_zonetab ($timezones_ar) {

    my $fh;
    if ( !open $fh, &#039;&lt;&#039;, $zonetabfile ) {
        Cpanel::Debug::log_warn(&quot;Could not open file \&quot;$zonetabfile\&quot; for reading ($!), will attempt to determine the time zone list by other (probably less precise) method(s)&quot;);
        return;
    }

    while (&lt;$fh&gt;) {
        next unless m{ ^ [A-Z]+ \s+ [-+][-+\d]+ \s+ (\S+) }ax;
        push @{$timezones_ar}, $1;
    }

    close $fh;

    return 1;
}

sub _hash_file ($file) {

    require Digest::SHA;
    return Digest::SHA-&gt;new(512)-&gt;addfile($file)-&gt;hexdigest;
}

sub get_current_timezone (%opts) {

    my $tz = &#039;UTC&#039;;    # default value when none found

    if ( -l $etc_localtime ) {    # check file being symlinked, if symlinked
        $tz = Cwd::abs_path($etc_localtime);
        $tz =~ s{^.*/usr/share/zoneinfo/(?:Etc/)?}{};
    }
    elsif ( -f $etc_localtime ) {

        my $localhash = _hash_file($etc_localtime);
        my @TZS       = gettimezones();
        foreach my $tzfile (@TZS) {
            my $check = $timezonedir . &#039;/&#039; . $tzfile;
            next unless -f $check;
            my $digest = _hash_file($check);
            if ( $localhash eq $digest ) {
                $tz = $tzfile;
                last;
            }
        }
    }
    else {
        $tz = _get_active_timezone();

        my $tz_file_path = qq{$timezonedir/$tz};

        if ( defined $tz &amp;&amp; -e $tz_file_path &amp;&amp; $&gt; == 0 ) {
            symlink( $tz_file_path, $etc_localtime );
            Cpanel::Timezones::set($tz);
        }
    }

    $tz =~ s{^posix/}{} if $opts{noposix};

    return $tz;
}

sub calculate_TZ_env() {
    return get_current_timezone( noposix =&gt; 1 );
}

sub set_zonetabfile ($file) {
    $zonetabfile = $file;
    return;
}

sub clear_caches() {
    undef $timezones_cache;
    unlink $timezones_cachefile;

    return;
}

1;

} # --- END Cpanel/Timezones.pm


{ # --- BEGIN Cpanel/Locale/Utils/DateTime.pm
package Cpanel::Locale::Utils::DateTime;


use strict;
# use Cpanel::LoadModule (); # perlpkg line 211
# use Cpanel::Locale     (); # perlpkg line 211

our $ENCODE_MODULE          = &#039;Encode&#039;;
our $DATETIME_MODULE        = &#039;DateTime&#039;;
our $DATETIME_LOCALE_MODULE = &#039;DateTime::Locale&#039;;
my %known_ids = ();

sub datetime {
    my ( $lh, $epoch, $format, $timezone ) = @_;

    if ( $epoch &amp;&amp; ref $epoch eq &#039;ARRAY&#039; ) {
        $epoch = $epoch-&gt;[0];
    }
    elsif ( !$epoch ) {
        $epoch = time;
    }
    $format ||= &#039;date_format_long&#039;;

    my $encoding = $lh-&gt;encoding();

    if ( _can_use_cpanel_date_format( $encoding, $timezone ) ) {
        Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Date::Format&#039;);
        return Cpanel::Date::Format::translate_for_locale( $epoch, $format, $lh-&gt;language_tag() );
    }

    my $locale = _get_best_locale_for_datetime_obj( $lh-&gt;language_tag() );
    return _get_formatted_datetime( $locale, $encoding, $format, $epoch, $timezone );
}

sub _can_use_cpanel_date_format {
    my ( $encoding, $timezone ) = @_;

    return ( $encoding eq &#039;utf-8&#039; ) &amp;&amp; ( !$timezone || $timezone eq &#039;UTC&#039; );
}

sub get_lookup_hash_of_multi_epoch_datetime {
    my ( $lh, $epochs_ar, $format, $timezone ) = @_;

    $format ||= &#039;date_format_long&#039;;
    my %lookups;

    my $encoding = $lh-&gt;encoding();

    my $can_use_cpanel_date_format = _can_use_cpanel_date_format( $encoding, $timezone );
    my $locale;

    if ($can_use_cpanel_date_format) {
        Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Date::Format&#039;);
        $locale = $lh-&gt;language_tag();
    }
    else {
        $locale = _get_best_locale_for_datetime_obj( $lh-&gt;language_tag() );
    }

    foreach my $epoch ( @{$epochs_ar} ) {
        $lookups{$epoch} ||= do {
            if ($can_use_cpanel_date_format) {
                Cpanel::Date::Format::translate_for_locale( $epoch, $format, $locale );
            }
            else {
                _get_formatted_datetime( $locale, $encoding, $format, $epoch, $timezone );
            }
        };
    }
    return \%lookups;
}

sub _get_formatted_datetime {
    my ( $locale, $encoding, $format, $epoch, $timezone ) = @_;

    if ( !$timezone ) {
        $timezone = &#039;UTC&#039;;
    }
    elsif ( $timezone !~ m{^[\.0-9A-Za-z\/_\+\-]+$} ) {
        die &quot;Invalid timezone “$timezone”&quot;;
    }

    my $datetime_obj = $DATETIME_MODULE-&gt;from_epoch( &#039;epoch&#039; =&gt; $epoch, &#039;locale&#039; =&gt; $locale, &#039;time_zone&#039; =&gt; $timezone );

    if ( $format &amp;&amp; $format !~ m{_format$} &amp;&amp; $datetime_obj-&gt;{&#039;locale&#039;}-&gt;can($format) ) {
        return $ENCODE_MODULE-&gt;can(&#039;encode&#039;)-&gt;( $encoding, $datetime_obj-&gt;format_cldr( $datetime_obj-&gt;{&#039;locale&#039;}-&gt;$format ) );
    }

    die &#039;Invalid datetime format: &#039; . $format;
}

sub _get_best_locale_for_datetime_obj {
    my ($language_tag) = @_;
    my ( $fallback, $locale ) = _get_fallback_locale($language_tag);

    Cpanel::LoadModule::load_perl_module($ENCODE_MODULE) if !$INC{&#039;Encode.pm&#039;};
    Cpanel::LoadModule::load_perl_module($DATETIME_MODULE);

    foreach my $try_locale ( $locale, $fallback, &#039;en_US&#039;, &#039;en&#039; ) {
        next               if !$try_locale;
        return $try_locale if $known_ids{$try_locale} || $Cpanel::Locale::known_locales_character_orientation{$try_locale};
        if ( eval { $DATETIME_MODULE-&gt;load($try_locale) } ) {
            $known_ids{$try_locale} = 1;
            return $try_locale;
        }
    }

    die &quot;Could not locale any working DateTime locale&quot;;
}

sub _get_fallback_locale {
    my ($locale) = @_;
    my $fallback;
    if ( substr( $locale, 0, 2 ) eq &#039;i_&#039; ) {
        require Cpanel::Locale::Utils::Paths;
        my $dir = Cpanel::Locale::Utils::Paths::get_i_locales_config_path();
        if ( -e &quot;$dir/$locale.yaml&quot; ) {
            require Cpanel::DataStore;
            my $hr = Cpanel::DataStore::fetch_ref(&quot;$dir/$locale.yaml&quot;);
            if ( exists $hr-&gt;{&#039;fallback_locale&#039;} &amp;&amp; $hr-&gt;{&#039;fallback_locale&#039;} ) {
                $fallback = $hr-&gt;{&#039;fallback_locale&#039;};
            }
        }
    }
    else {
        my ( $pre, $pst ) = split( /[\_\-]/, $locale, 2 );
        if ($pst) {
            $fallback = $pre;
            $locale   = $pre . &#039;_&#039; . uc($pst);
        }
    }
    $fallback ||= &#039;en&#039;;

    return ( $fallback, $locale );
}

1;

} # --- END Cpanel/Locale/Utils/DateTime.pm


{ # --- BEGIN Cpanel/Time/ISO.pm
package Cpanel::Time::ISO;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Debug      (); # perlpkg line 211
# use Cpanel::LoadModule (); # perlpkg line 211


sub unix2iso {
    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Time&#039;) unless $INC{&#039;Cpanel/Time.pm&#039;};
    return sprintf( &#039;%04d-%02d-%02dT%02d:%02d:%02dZ&#039;, reverse( ( Cpanel::Time::gmtime( $_[0] || time() ) )[ 0 .. 5 ] ) );
}


sub iso2unix {
    my ($iso_time) = @_;

    if ( rindex( $iso_time, &#039;Z&#039; ) != length($iso_time) - 1 ) {
        die &quot;Only UTC times, not “$iso_time”!&quot;;
    }

    my @smhdmy = reverse split m&lt;[^0-9.]&gt;, $iso_time;
    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Time&#039;) unless $INC{&#039;Cpanel/Time.pm&#039;};

    return Cpanel::Time::timegm(@smhdmy);
}


sub unix2iso_date {
    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Time&#039;) unless $INC{&#039;Cpanel/Time.pm&#039;};
    Cpanel::Debug::log_deprecated(&#039;This function will be removed, please use locale datetime&#039;);

    return sprintf( &#039;%04d-%02d-%02d&#039;, reverse( ( Cpanel::Time::gmtime( $_[0] || time() ) )[ 3 .. 5 ] ) );
}


sub unix2iso_time {
    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Time&#039;) unless $INC{&#039;Cpanel/Time.pm&#039;};
    Cpanel::Debug::log_deprecated(&#039;This function will be removed, please use locale datetime&#039;);
    return sprintf( &#039;%02d:%02d:%02d&#039;, reverse( ( Cpanel::Time::gmtime( $_[0] || time() ) )[ 0 .. 2 ] ) );
}

1;

} # --- END Cpanel/Time/ISO.pm


{ # --- BEGIN Cpanel/Config/LoadUserDomains/Count.pm
package Cpanel::Config::LoadUserDomains::Count;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Autodie            qw(exists); # perlpkg line 248
INIT { Cpanel::Autodie-&gt;import(qw{exists}); }
# use Cpanel::LoadFile::ReadFast (); # perlpkg line 211
# use Cpanel::ConfigFiles        (); # perlpkg line 211


sub counttrueuserdomains {
    if ( !Cpanel::Autodie::exists( _trueuserdomains() ) ) {
        return 0;
    }
    return _count_file_lines( _trueuserdomains() );
}


sub countuserdomains {
    if ( !Cpanel::Autodie::exists( _userdomains() ) ) {
        return 0;
    }
    return _count_file_lines( _userdomains() ) - 1;    # -1 for *: nobody
}

sub _count_file_lines {
    my ($file) = @_;
    open( my $ud_fh, &#039;&lt;&#039;, $file ) or die &quot;open($file): $!&quot;;

    my $buffer = &#039;&#039;;
    Cpanel::LoadFile::ReadFast::read_all_fast( $ud_fh, $buffer );
    my $num_ud = ( $buffer =~ tr/\n// );
    close($ud_fh) or warn &quot;close($file): $!&quot;;

    $num_ud++ if length($buffer) &amp;&amp; substr( $buffer, -1 ) ne &quot;\n&quot;;

    return $num_ud;
}

sub _userdomains {
    return $Cpanel::ConfigFiles::USERDOMAINS_FILE;
}

sub _domainusers {
    return $Cpanel::ConfigFiles::DOMAINUSERS_FILE;
}

sub _trueuserdomains {
    return $Cpanel::ConfigFiles::TRUEUSERDOMAINS_FILE;
}

1;

} # --- END Cpanel/Config/LoadUserDomains/Count.pm


{ # --- BEGIN Cpanel/Config/LoadUserDomains.pm
package Cpanel::Config::LoadUserDomains;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Config::LoadConfig             (); # perlpkg line 211
# use Cpanel::Config::LoadUserDomains::Count (); # perlpkg line 211
# use Cpanel::Server::Type                   (); # perlpkg line 211


sub loaduserdomains {
    my ( $conf_ref, $reverse, $usearr ) = @_;
    $conf_ref = Cpanel::Config::LoadConfig::loadConfig(
        Cpanel::Config::LoadUserDomains::Count::_userdomains(),
        $conf_ref,
        &#039;: &#039;,     # We write the file so there is no need to match stray spaces
        &#039;0E0&#039;,    # Avoid looking for comments since there will not be any
        0,        # reverse
        1,        # allow_undef_values since there will not be any
        {
            &#039;use_reverse&#039;          =&gt; $reverse ? 0 : 1,
            &#039;skip_keys&#039;            =&gt; [&#039;nobody&#039;],
            &#039;use_hash_of_arr_refs&#039; =&gt; ( $usearr || 0 ),
        }
    );
    if ( !defined($conf_ref) ) {
        $conf_ref = {};
    }
    return wantarray ? %{$conf_ref} : $conf_ref;
}


sub loadtrueuserdomains {
    my ( $conf_ref, $reverse, $ignore_limit ) = @_;
    $conf_ref = Cpanel::Config::LoadConfig::loadConfig(
        ( $reverse ? Cpanel::Config::LoadUserDomains::Count::_domainusers() : Cpanel::Config::LoadUserDomains::Count::_trueuserdomains() ),
        $conf_ref,
        &#039;: &#039;,     # We write the file so there is no need to match stray spaces
        &#039;0E0&#039;,    # Avoid looking for comments since there will not be any
        0,        # reverse
        1,        # allow_undef_values since there will not be any
        { &#039;limit&#039; =&gt; ( $ignore_limit ? 0 : Cpanel::Server::Type::get_max_users() ) }
    );
    if ( !defined($conf_ref) ) {
        $conf_ref = {};
    }
    return wantarray ? %{$conf_ref} : $conf_ref;
}

*counttrueuserdomains = *counttrueuserdomains = *Cpanel::Config::LoadUserDomains::Count::counttrueuserdomains;

1;

} # --- END Cpanel/Config/LoadUserDomains.pm


{ # --- BEGIN Cpanel/Config/CpUser.pm
package Cpanel::Config::CpUser;


use strict;

# use Cpanel::Debug                        (); # perlpkg line 211
# use Cpanel::LoadModule                   (); # perlpkg line 211
# use Cpanel::Config::LoadUserDomains      (); # perlpkg line 211
# use Cpanel::Config::LoadCpUserFile       (); # perlpkg line 211
# use Cpanel::ConfigFiles                  (); # perlpkg line 211
# use Cpanel::FileUtils::Write::JSON::Lazy (); # perlpkg line 211

our $cpuser_dir;
*cpuser_dir = \$Cpanel::ConfigFiles::cpanel_users;
our $cpuser_cache_dir = &quot;$cpuser_dir.cache&quot;;

our $header = &lt;&lt;END;
END

my %memory_file_list_key = qw(
  DOMAINS         DNS
  DEADDOMAINS     XDNS
  HOMEDIRLINKS    HOMEDIRPATHS
);

sub clean_cpuser_hash {
    my ( $cpuser_ref, $user ) = @_;

    {
        my @missing = grep { !exists $cpuser_ref-&gt;{$_} } required_cpuser_keys();
        if (@missing) {
            $user = q{} if !defined $user;
            Cpanel::Debug::log_warn( &quot;The following keys are missing from supplied &#039;$user&#039; cPanel user data: &quot; . join( &#039;, &#039;, @missing ) . &quot;, to prevent data loss, the data was not saved.&quot; );
            return;
        }
    }

    if ( grep { $_ &amp;&amp; index( $_, &quot;\n&quot; ) != -1 } %$cpuser_ref ) {

        Cpanel::Debug::log_warn(&quot;The cpuser data contains newlines.  This is not allowed as it would corrupt the file.&quot;);
        return;
    }

    my $domain = $cpuser_ref-&gt;{&#039;DOMAIN&#039;};
    if ( !$domain ) {    # Try to lookup main domain in /etc/trueuserdomains
        my $trueuserdomains_ref = Cpanel::Config::LoadUserDomains::loadtrueuserdomains( undef, 1 );
        $domain = $trueuserdomains_ref-&gt;{$user} || &#039;&#039;;
        if ( !$domain ) {
            Cpanel::Debug::log_info(&quot;Unable to determine user ${user}&#039;s main domain&quot;);
        }
    }

    my %clean_data = (
        %$cpuser_ref,
        DNS =&gt; $domain,
    );

    delete @clean_data{
        q{},
        &#039;DOMAIN&#039;,
        &#039;DBOWNER&#039;,
        &#039;__CACHE_DATA_VERSION&#039;,
        ( keys %memory_file_list_key ),
    };

    if ( defined $clean_data{&#039;DISK_BLOCK_LIMIT&#039;} &amp;&amp; $clean_data{&#039;DISK_BLOCK_LIMIT&#039;} eq &#039;unlimited&#039; ) {
        $clean_data{&#039;DISK_BLOCK_LIMIT&#039;} = 0;
    }

    while ( my ( $memkey, $filekey ) = each %memory_file_list_key ) {
        if ( exists $cpuser_ref-&gt;{$memkey} &amp;&amp; scalar @{ $cpuser_ref-&gt;{$memkey} } ) {
            my $doms_ar = $cpuser_ref-&gt;{$memkey};
            my $count   = 0;
            @clean_data{ ( map { $filekey . ++$count } @$doms_ar ) } = @$doms_ar;
        }
    }

    my $homedirs_key_in_file = $memory_file_list_key{&#039;HOMEDIRLINKS&#039;};
    if ( exists $clean_data{ $homedirs_key_in_file . 1 } ) {
        $clean_data{$homedirs_key_in_file} = delete $clean_data{ $homedirs_key_in_file . 1 };
    }

    return wantarray ? %clean_data : \%clean_data;
}

sub get_cpgid {
    my ($user) = @_;

    my $cpgid = 0;

    if ( exists $INC{&#039;Cpanel/PwCache.pm&#039;} || Cpanel::LoadModule::load_perl_module(&#039;Cpanel::PwCache&#039;) ) {
        $cpgid = ( Cpanel::PwCache::getpwnam_noshadow($user) )[3];
    }

    return $cpgid;
}

sub recache {
    my ( $cpuser_ref, $user, $cpgid ) = @_;

    my $user_cache_file = $cpuser_cache_dir . &#039;/&#039; . $user;

    Cpanel::Config::LoadCpUserFile::create_users_cache_dir();
    $cpuser_ref-&gt;{&#039;__CACHE_DATA_VERSION&#039;} = $Cpanel::Config::LoadCpUserFile::VERSION;    # set this before the cache is written so that it will be included in the cache

    if ( Cpanel::FileUtils::Write::JSON::Lazy::write_file( $user_cache_file, $cpuser_ref, 0640 ) ) {
        chown 0, $cpgid, $user_cache_file if $cpgid;                                     # this is ok if the chown happens after as we fall though to reading the non-cache on a failed open
    }
    else {
        unlink $user_cache_file;                                                         #outdated
    }
}

sub required_cpuser_keys {
    my @keys = qw( FEATURELIST HASCGI MAXSUB MAXADDON DEMO RS USER MAXFTP MAXLST MAXPARK STARTDATE BWLIMIT IP MAXSQL DOMAIN MAXPOP PLAN OWNER );

    return wantarray ? @keys : \@keys;
}

1;

} # --- END Cpanel/Config/CpUser.pm


{ # --- BEGIN Cpanel/Config/FlushConfig.pm
package Cpanel::Config::FlushConfig;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::FileUtils::Write (); # perlpkg line 211
# use Cpanel::Debug            (); # perlpkg line 211
# use Cpanel::Exception        (); # perlpkg line 211

our $VERSION = &#039;1.4&#039;;

my $DEFAULT_DELIMITER = &#039;=&#039;;


sub flushConfig {
    my ( $filename_or_fh, $conf, $delimiter, $header, $opts ) = @_;

    if ( !$filename_or_fh ) {
        Cpanel::Debug::log_warn(&#039;flushConfig requires valid filename or fh as first argument&#039;);
        return;
    }
    elsif ( !$conf || ref $conf ne &#039;HASH&#039; ) {
        Cpanel::Debug::log_warn(&#039;flushConfig requires HASH reference as second argument&#039;);
        return;
    }

    if ( ref $opts &amp;&amp; $opts-&gt;{&#039;no_overwrite&#039;} ) {
        die Cpanel::Exception::create( &#039;Unsupported&#039;, &#039;Function ”flushConfig” called with an unsupported option “no_overwrite”.&#039; );
    }

    my $contents_sr = serialize(
        $conf,
        do_sort            =&gt; $opts &amp;&amp; $opts-&gt;{&#039;sort&#039;},
        delimiter          =&gt; $delimiter,
        header             =&gt; $header,
        allow_array_values =&gt; $opts &amp;&amp; $opts-&gt;{&#039;allow_array_values&#039;},
    );

    my $perms = 0644;    # default permissions when unset
    if ( defined $opts-&gt;{&#039;perms&#039;} ) {
        $perms = $opts-&gt;{&#039;perms&#039;};
    }
    elsif ( !ref $filename_or_fh &amp;&amp; -e $filename_or_fh ) {
        $perms = ( stat(_) )[2] &amp; 0777;
    }

    if ( ref $filename_or_fh ) {
        return Cpanel::FileUtils::Write::write_fh(
            $filename_or_fh,
            ref $contents_sr eq &#039;SCALAR&#039; ? $$contents_sr : $contents_sr
        );
    }

    return Cpanel::FileUtils::Write::overwrite_no_exceptions(
        $filename_or_fh,
        ref $contents_sr eq &#039;SCALAR&#039; ? $$contents_sr : $contents_sr,
        $perms,
    );
}


sub serialize {
    my ( $conf, %opts ) = @_;

    my ( $do_sort, $delimiter, $header, $allow_array_values ) = @opts{qw(do_sort delimiter header allow_array_values)};

    $delimiter ||= $DEFAULT_DELIMITER;


    if ($allow_array_values) {
        my $contents = &#039;&#039;;
        $contents .= $header . &quot;\n&quot; if $header;

        foreach my $key ( $do_sort ? ( sort keys %{$conf} ) : ( keys %{$conf} ) ) {
            if ( ref( $conf-&gt;{$key} ) eq &#039;ARRAY&#039; ) {
                $contents .= join(
                    &quot;\n&quot;,
                    map { $key . $delimiter . $_ } ( @{ $conf-&gt;{$key} } )
                ) . &quot;\n&quot;;
            }
            else {
                $contents .= $key . $delimiter . ( defined $conf-&gt;{$key} ? $conf-&gt;{$key} : &#039;&#039; ) . &quot;\n&quot;;
            }
        }

        return \$contents;
    }

    my $contents = ( $header ? ( $header . &quot;\n&quot; ) : &#039;&#039; ) . join(
        &quot;\n&quot;,
        map { $_ . ( defined $conf-&gt;{$_} ? ( $delimiter . $conf-&gt;{$_} ) : &#039;&#039; ) } ( $do_sort ? ( sort keys %{$conf} ) : ( keys %{$conf} ) )
    ) . &quot;\n&quot;;

    return \$contents;
}

1;

} # --- END Cpanel/Config/FlushConfig.pm


{ # --- BEGIN Cpanel/Config/CpUser/Write.pm
package Cpanel::Config::CpUser::Write;


use cPstrict;
no warnings &#039;once&#039;;


# use Cpanel::Config::CpUser      (); # perlpkg line 211
# use Cpanel::Config::FlushConfig (); # perlpkg line 211


sub serialize ($cpuser_data) {
    die &#039;Pass data through clean_cpuser_hash() first!&#039; if grep { ref } values %$cpuser_data;

    return ${
        Cpanel::Config::FlushConfig::serialize(
            $cpuser_data,
            do_sort   =&gt; 1,
            delimiter =&gt; &#039;=&#039;,
            &#039;header&#039;  =&gt; $Cpanel::Config::CpUser::header,
        )
    };
}

1;

} # --- END Cpanel/Config/CpUser/Write.pm


{ # --- BEGIN Cpanel/LinkedNode/Worker/Storage.pm
package Cpanel::LinkedNode::Worker::Storage;


use strict;
use warnings;
no warnings &#039;once&#039;;


sub read {
    my ( $cpuser_hr, $worker_type ) = @_;

    my $str = $cpuser_hr-&gt;{ _get_key($worker_type) };

    return _parse($str);
}


sub set {
    my ( $cpuser_hr, $worker_type, $alias, $token ) = @_;

    $cpuser_hr-&gt;{ _get_key($worker_type) } = &quot;$alias:$token&quot;;

    return;
}


sub unset {
    my ( $cpuser_hr, $worker_type ) = @_;

    return _parse( delete $cpuser_hr-&gt;{ _get_key($worker_type) } );
}


sub _get_key {
    my ($worker_type) = @_;

    substr( $worker_type, 0, 1 ) =~ tr&lt;A-Z&gt;&lt;&gt; or do {
        die &quot;Worker type names always begin with a capital! (given: “$worker_type”)&quot;;
    };

    return &quot;WORKER_NODE-$worker_type&quot;;
}

sub _parse {
    my ($str) = @_;

    return $str ? [ split m&lt;:&gt;, $str, 2 ] : undef;
}

1;

} # --- END Cpanel/LinkedNode/Worker/Storage.pm


{ # --- BEGIN Cpanel/SafeFile/Replace.pm
package Cpanel::SafeFile::Replace;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Fcntl::Constants (); # perlpkg line 211
# use Cpanel::FileUtils::Open  (); # perlpkg line 211
use File::Basename           ();

use constant {
    WRONLY_CREAT_EXCL =&gt; $Cpanel::Fcntl::Constants::O_WRONLY | $Cpanel::Fcntl::Constants::O_CREAT | $Cpanel::Fcntl::Constants::O_EXCL,
    _EEXIST           =&gt; 17
};

sub safe_replace_content {
    my ( $fh, $safelock, @content ) = @_;

    return locked_atomic_replace_contents(
        $fh,
        $safelock,
        sub {
            local $!;

            @content = @{ $content[0] } if scalar @content == 1 &amp;&amp; ref $content[0] eq &#039;ARRAY&#039;;

            print { $_[0] } @content;

            if ($!) {
                my $length = 0;
                $length += length for @content;

                my $err = $!;
                require Cpanel::Exception;
                die Cpanel::Exception::create( &#039;IO::WriteError&#039;, [ length =&gt; $length, error =&gt; $err ] );
            }

            return 1;
        }
    );
}

my $_lock_ex_nb;

sub locked_atomic_replace_contents {
    my ( $fh, $safelock, $coderef ) = @_;

    $_lock_ex_nb //= $Cpanel::Fcntl::Constants::LOCK_EX | $Cpanel::Fcntl::Constants::LOCK_NB;
    if ( !flock $fh, $_lock_ex_nb ) {
        my $err = $!;
        require Cpanel::Exception;
        die Cpanel::Exception::create_raw( &#039;IOError&#039;, &quot;locked_atomic_replace_contents could not lock the file handle because of an error: $err&quot; );
    }

    if ( !ref $safelock ) {
        local $@;
        if ( !eval { $safelock-&gt;isa(&#039;Cpanel::SafeFileLock&#039;) } ) {
            die &quot;locked_atomic_replace_contents requires a Cpanel::SafeFileLock object&quot;;
        }
    }

    my $locked_path = $safelock-&gt;get_path_to_file_being_locked();
    die &quot;locked_path must be valid&quot; if !length $locked_path;
    my ( $temp_file, $temp_fh, $created_temp_file, $attempts );
    my $current_perms = ( stat($fh) )[2] &amp; 07777;

    while ( !$created_temp_file &amp;&amp; ++$attempts &lt; 100 ) {
        $temp_file = sprintf(
            &#039;%s-%x-%x-%x&#039;,
            $locked_path,
            substr( rand, 2 ),
            scalar( reverse time ),
            scalar( reverse $$ ),
        );

        my ( $basename, $dirname );
        $basename = File::Basename::basename($temp_file);
        if ( length $basename &gt;= 255 ) {
            $basename  = substr( $basename, 255 );
            $dirname   = File::Basename::dirname($temp_file);
            $temp_file = &quot;$dirname/$basename&quot;;
        }

        $created_temp_file = Cpanel::FileUtils::Open::sysopen_with_real_perms( $temp_fh, $temp_file, WRONLY_CREAT_EXCL, $current_perms ) or do {
            last if $! != _EEXIST;
        };
    }
    if ( !$created_temp_file ) {
        my $lasterr = $!;
        die Cpanel::Exception::create( &#039;TempFileCreateError&#039;, [ path =&gt; $temp_file, error =&gt; $lasterr ] );
    }

    if ( !flock $temp_fh, $Cpanel::Fcntl::Constants::LOCK_EX ) {
        my $err = $!;
        require Cpanel::Exception;
        die Cpanel::Exception::create( &#039;IO::FlockError&#039;, [ path =&gt; $temp_file, error =&gt; $err, operation =&gt; $Cpanel::Fcntl::Constants::LOCK_EX ] );
    }

    select( ( select($temp_fh), $| = 1 )[0] );    ##no critic qw(ProhibitOneArgSelect Variables::RequireLocalizedPunctuationVars)  #aka $fd-&gt;autoflush(1);
    if ( $coderef-&gt;( $temp_fh, $temp_file, $current_perms ) ) {
        rename( $temp_file, $locked_path );
        return $temp_fh;
    }
    local $!;
    close $temp_fh;
    unlink $temp_file;
    die &quot;locked_atomic_replace_contents coderef returns false&quot;;
}

1;

} # --- END Cpanel/SafeFile/Replace.pm


{ # --- BEGIN Cpanel/Config/CpUserGuard.pm
package Cpanel::Config::CpUserGuard;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use Cpanel::Destruct               (); # perlpkg line 211
# use Cpanel::Config::CpUser         (); # perlpkg line 211
# use Cpanel::Config::CpUser::Write  (); # perlpkg line 211
# use Cpanel::Config::LoadCpUserFile (); # perlpkg line 211
# use Cpanel::Debug                  (); # perlpkg line 211


sub new {
    my ( $class, $user ) = @_;

    my ( $data, $file, $lock, $is_locked ) = ( undef, undef, undef, 0 );

    my $cpuser = Cpanel::Config::LoadCpUserFile::_load_locked($user);
    if ( $cpuser &amp;&amp; ref $cpuser eq &#039;HASH&#039; ) {
        $data      = $cpuser-&gt;{&#039;data&#039;};
        $file      = $cpuser-&gt;{&#039;file&#039;};
        $lock      = $cpuser-&gt;{&#039;lock&#039;};
        $is_locked = defined $lock;
    }
    else {
        Cpanel::Debug::log_warn(&quot;Failed to load user file for &#039;$user&#039;: $!&quot;);
        return;
    }

    my $path = &quot;$Cpanel::Config::CpUser::cpuser_dir/$user&quot;;

    return bless {
        user      =&gt; $user,
        data      =&gt; $data,
        path      =&gt; $path,
        _file     =&gt; $file,
        _lock     =&gt; $lock,
        _pid      =&gt; $$,
        is_locked =&gt; $is_locked,
    };
}


sub data {
    my ($self) = @_;
    return $self-&gt;{&#039;data&#039;};
}


sub set_worker_node {
    my ( $self, $worker_type, $worker_alias, $token ) = @_;

    require Cpanel::LinkedNode::Worker::Storage;
    Cpanel::LinkedNode::Worker::Storage::set( $self-&gt;{&#039;data&#039;}, $worker_type, $worker_alias, $token );

    return $self;
}


sub unset_worker_node {
    my ( $self, $worker_type ) = @_;

    require Cpanel::LinkedNode::Worker::Storage;
    return Cpanel::LinkedNode::Worker::Storage::unset( $self-&gt;{&#039;data&#039;}, $worker_type );
}

sub save {
    my ($self) = @_;

    my $user = $self-&gt;{&#039;user&#039;};
    my $data = $self-&gt;{&#039;data&#039;};

    if ( $self-&gt;{&#039;_pid&#039;} != $$ ) {
        Cpanel::Debug::log_die(&#039;Locked in parent, cannot save&#039;);
        return;
    }

    if ( !UNIVERSAL::isa( $data, &#039;HASH&#039; ) ) {
        Cpanel::Debug::log_die( __PACKAGE__ . &#039;: hash reference required&#039; );
        return;
    }

    my $clean_data = Cpanel::Config::CpUser::clean_cpuser_hash( $self-&gt;{&#039;data&#039;}, $user );
    if ( !$clean_data ) {
        Cpanel::Debug::log_warn(&quot;Data for user &#039;$user&#039; was not saved.&quot;);
        return;
    }

    if ( !$self-&gt;{&#039;_file&#039;} || !$self-&gt;{&#039;_lock&#039;} ) {
        Cpanel::Debug::log_warn(&quot;Unable to save user file for &#039;$user&#039;: file not open and locked for writing&quot;);
        return;
    }

    require Cpanel::SafeFile::Replace;

    require Cpanel::Autodie;

    my $newfh = Cpanel::SafeFile::Replace::locked_atomic_replace_contents(
        $self-&gt;{&#039;_file&#039;}, $self-&gt;{&#039;_lock&#039;},

        sub {
            my ($fh) = @_;

            chmod( 0640, $fh ) or do {
                warn sprintf( &quot;Failed to set permissions on “%s” to 0%o: %s&quot;, $self-&gt;{&#039;path&#039;}, 0640, $! );
            };

            return Cpanel::Autodie::syswrite_sigguard(
                $fh,
                Cpanel::Config::CpUser::Write::serialize($clean_data),
            );
        }

      )
      or do {
        Cpanel::Debug::log_warn(&quot;Failed to save user file for “$user”: $!&quot;);
      };

    $self-&gt;{&#039;_file&#039;} = $newfh;

    my $cpgid = Cpanel::Config::CpUser::get_cpgid($user);

    if ($cpgid) {
        chown 0, $cpgid, $self-&gt;{&#039;path&#039;} or do {
            Cpanel::Debug::log_warn(&quot;Failed to chown( 0, $cpgid, $self-&gt;{&#039;path&#039;}): $!&quot;);
        };
    }

    if ( $INC{&#039;Cpanel/Locale/Utils/User.pm&#039;} ) {
        Cpanel::Locale::Utils::User::clear_user_cache($user);
    }

    Cpanel::Config::CpUser::recache( $data, $user, $cpgid );

    require Cpanel::SafeFile;
    Cpanel::SafeFile::safeclose( $self-&gt;{&#039;_file&#039;}, $self-&gt;{&#039;_lock&#039;} ) or do {
        Cpanel::Debug::log_warn(&quot;Failed to safeclose $self-&gt;{&#039;path&#039;}: $!&quot;);
    };

    $self-&gt;{&#039;_file&#039;}     = $self-&gt;{&#039;_lock&#039;} = undef;
    $self-&gt;{&#039;is_locked&#039;} = 0;

    return 1;
}

sub abort {
    my ($self) = @_;

    my $user = $self-&gt;{&#039;user&#039;};
    my $data = $self-&gt;{&#039;data&#039;};

    if ( $self-&gt;{&#039;_pid&#039;} != $$ ) {
        Cpanel::Debug::log_die(&#039;Locked in parent, cannot save&#039;);
        return;
    }

    require Cpanel::SafeFile;
    Cpanel::SafeFile::safeclose( $self-&gt;{&#039;_file&#039;}, $self-&gt;{&#039;_lock&#039;} );
    $self-&gt;{&#039;_file&#039;}     = $self-&gt;{&#039;_lock&#039;} = undef;
    $self-&gt;{&#039;is_locked&#039;} = 0;

    return 1;
}

sub DESTROY {
    my ($self) = @_;

    return unless $self-&gt;{&#039;is_locked&#039;};
    return if Cpanel::Destruct::in_dangerous_global_destruction();
    return unless $self-&gt;{&#039;_pid&#039;} == $$;

    Cpanel::SafeFile::safeclose( $self-&gt;{&#039;_file&#039;}, $self-&gt;{&#039;_lock&#039;} );

    $self-&gt;{&#039;is_locked&#039;} = 0;
    return;
}

1;

} # --- END Cpanel/Config/CpUserGuard.pm


{ # --- BEGIN Cpanel/Locale/Utils/User/Modify.pm
package Cpanel::Locale::Utils::User::Modify;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::PwCache (); # perlpkg line 211

sub save_user_locale {
    my ( $locale, undef, $user ) = @_;
    $locale ||= &#039;en&#039;;
    $user   ||= $Cpanel::user || $ENV{&#039;REMOTE_USER&#039;} || ( $&gt; == 0 ? &#039;root&#039; : ( Cpanel::PwCache::getpwuid_noshadow($&gt;) )[0] );

    if ( $user eq &#039;root&#039; ) {
        require Cpanel::LoadModule;

        Cpanel::LoadModule::load_perl_module(&#039;Cpanel::DataStore&#039;);

        my $root_conf_yaml = Cpanel::PwCache::gethomedir(&#039;root&#039;) . &#039;/.cpanel_config&#039;;
        my $hr             = Cpanel::DataStore::fetch_ref($root_conf_yaml);

        return 2 if exists $hr-&gt;{&#039;locale&#039;} &amp;&amp; $hr-&gt;{&#039;locale&#039;} eq $locale;

        $hr-&gt;{&#039;locale&#039;} = $locale;

        return 1 if Cpanel::DataStore::store_ref( $root_conf_yaml, $hr );
        return;
    }
    elsif ( $&gt; == 0 ) {
        require Cpanel::Config::CpUserGuard;
        my $cpuser_guard = Cpanel::Config::CpUserGuard-&gt;new($user) or return;
        $cpuser_guard-&gt;{&#039;data&#039;}-&gt;{&#039;LOCALE&#039;} = $locale;
        delete $cpuser_guard-&gt;{&#039;data&#039;}-&gt;{&#039;LANG&#039;};
        delete $cpuser_guard-&gt;{&#039;data&#039;}{&#039;__LOCALE_MISSING&#039;};
        return $cpuser_guard-&gt;save();
    }
    else {
        require Cpanel::LoadModule;

        Cpanel::LoadModule::load_perl_module(&#039;Cpanel::AdminBin&#039;);
        if ( $ENV{&#039;TEAM_USER&#039;} ) {
            Cpanel::LoadModule::load_perl_module(&#039;Cpanel::AdminBin::Call&#039;);
            return Cpanel::AdminBin::Call::call( &#039;Cpanel&#039;, &#039;teamconfig&#039;, &#039;SET_LOCALE&#039;, $ENV{&#039;TEAM_USER&#039;}, $locale );
        }
        return Cpanel::AdminBin::run_adminbin_with_status( &#039;lang&#039;, &#039;SAVEUSERSETTINGS&#039;, $locale, 0, $user )-&gt;{&#039;status&#039;};
    }
    return 1;
}

1;

} # --- END Cpanel/Locale/Utils/User/Modify.pm


{ # --- BEGIN Cpanel/Locale.pm
package Cpanel::Locale;


use strict;

BEGIN {

    $ENV{&#039;IGNORE_WIN32_LOCALE&#039;} = 1;
}

# use parent Cpanel::CPAN::Locale::Maketext::Utils (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::CPAN::Locale::Maketext::Utils); }

# use Cpanel::Locale::Utils          ();    # Individual Locale modules depend on this being brought in here, if it is removed they will all need updated. Same for cpanel.pl # perlpkg line 211
# use Cpanel::Locale::Utils::Paths   (); # perlpkg line 211
# use Cpanel::CPAN::Locale::Maketext (); # perlpkg line 211
# use Cpanel::Exception              (); # perlpkg line 211

use constant _ENOENT =&gt; 2;

BEGIN {
    local $^H = 0;    # cheap no warnings without importing it
    local $^W = 0;

    *Cpanel::CPAN::Locale::Maketext::Utils::remove_key_from_lexicons = sub { };    # PPI NO PARSE - loaded above - disabled
}

our $SERVER_LOCALE_FILE = &#039;/var/cpanel/server_locale&#039;;

our $LTR = 1;
our $RTL = 2;
our %known_locales_character_orientation = (
    ar               =&gt; $RTL,
    bn               =&gt; $LTR,
    bg               =&gt; $LTR,
    cs               =&gt; $LTR,
    da               =&gt; $LTR,
    de               =&gt; $LTR,
    el               =&gt; $LTR,
    en               =&gt; $LTR,
    en_US            =&gt; $LTR,
    en_GB            =&gt; $LTR,
    es_419           =&gt; $LTR,
    es               =&gt; $LTR,
    es_es            =&gt; $LTR,
    fi               =&gt; $LTR,
    fil              =&gt; $LTR,
    fr               =&gt; $LTR,
    he               =&gt; $RTL,
    hi               =&gt; $LTR,
    hu               =&gt; $LTR,
    i_cpanel_snowmen =&gt; $LTR,
    i_cp_qa          =&gt; $LTR,
    id               =&gt; $LTR,
    it               =&gt; $LTR,
    ja               =&gt; $LTR,
    ko               =&gt; $LTR,
    ms               =&gt; $LTR,
    nb               =&gt; $LTR,
    nl               =&gt; $LTR,
    no               =&gt; $LTR,
    pl               =&gt; $LTR,
    pt_br            =&gt; $LTR,
    pt               =&gt; $LTR,
    ro               =&gt; $LTR,
    ru               =&gt; $LTR,
    sl               =&gt; $LTR,
    sv               =&gt; $LTR,
    th               =&gt; $LTR,
    tr               =&gt; $LTR,
    uk               =&gt; $LTR,
    vi               =&gt; $LTR,
    zh               =&gt; $LTR,
    zh_tw            =&gt; $LTR,
    zh_cn            =&gt; $LTR,
);


my $logger;

sub _logger {
    require Cpanel::Logger;
    return ( $logger ||= Cpanel::Logger-&gt;new() );
}

*get_lookup_hash_of_mutli_epoch_datetime = *get_lookup_hash_of_multi_epoch_datetime;

sub preinit {
    if ( exists $INC{&#039;Cpanel.pm&#039;} &amp;&amp; !$Cpanel::CPDATA{&#039;LOCALE&#039;} ) {
        require Cpanel::Locale::Utils::User if !exists $INC{&#039;Cpanel/Locale/Utils/User.pm&#039;};
        Cpanel::Locale::Utils::User::init_cpdata_keys();
    }

    if ( $ENV{&#039;HTTP_COOKIE&#039;} ) {
        require Cpanel::Cookies unless $INC{&#039;Cpanel/Cookies.pm&#039;};

        if ( !keys %Cpanel::Cookies ) {
            %Cpanel::Cookies = %{ Cpanel::Cookies::get_cookie_hashref() };
        }
    }

    %Cpanel::Grapheme = %{ Cpanel::Locale-&gt;get_grapheme_helper_hashref() };
    return 1;
}


sub makevar {
    return $_[0]-&gt;maketext( ref $_[1] ? @{ $_[1] } : @_[ 1 .. $#_ ] );    ## no extract maketext
}

*maketext = *Cpanel::CPAN::Locale::Maketext::maketext;                    ## no extract maketext

my %singleton_stash = ();


BEGIN {
    no warnings;    ## no critic(ProhibitNoWarnings)
    CHECK {
        if ( ( $INC{&#039;O.pm&#039;} || $INC{&#039;Cpanel/BinCheck.pm&#039;} || $INC{&#039;Cpanel/BinCheck/Lite.pm&#039;} ) &amp;&amp; %singleton_stash ) {
            die(&quot;If you use a locale at begin time, you are responsible for deleting it too. Try calling _reset_singleton_stash\n&quot;);
        }
    }
}

sub _reset_singleton_stash {
    foreach my $class ( keys %singleton_stash ) {
        foreach my $args_sig ( keys %{ $singleton_stash{$class} } ) {
            $singleton_stash{$class}{$args_sig}-&gt;cpanel_detach_lexicon();
        }
    }
    %singleton_stash = ();
    return 1;
}

sub get_handle {
    preinit();
    no warnings &#039;redefine&#039;;
    *get_handle = *_real_get_handle;
    goto &amp;_real_get_handle;
}

sub _map_any_old_style_to_new_style {
    my (@locales) = @_;
    if ( grep { !$known_locales_character_orientation{$_} &amp;&amp; index( $_, &#039;i_&#039; ) != 0 } @locales ) {
        require Cpanel::Locale::Utils::Legacy;
        goto \&amp;Cpanel::Locale::Utils::Legacy::map_any_old_style_to_new_style;
    }
    return @locales;
}

our $IN_REAL_GET_HANDLE = 0;

sub _setup_for_real_get_handle {    ## no critic qw(RequireArgUnpacking)

    if ($IN_REAL_GET_HANDLE) {
        _load_carp();
        if ( $IN_REAL_GET_HANDLE &gt; 1 ) {
            die &#039;Cpanel::Carp&#039;-&gt;can(&#039;safe_longmess&#039;)-&gt;(&quot;Attempted to call _setup_for_real_get_handle from _setup_for_real_get_handle&quot;);
        }
        warn &#039;Cpanel::Carp&#039;-&gt;can(&#039;safe_longmess&#039;)-&gt;(&quot;Attempted to call _setup_for_real_get_handle from _setup_for_real_get_handle&quot;);
        if ($Cpanel::Exception::IN_EXCEPTION_CREATION) {    # PPI NO PARSE - Only care about this check if the module is loaded
            $Cpanel::Exception::LOCALIZE_STRINGS = 0;       # PPI NO PARSE - Only care about this check if the module is loaded
        }
    }
    local $IN_REAL_GET_HANDLE = $IN_REAL_GET_HANDLE + 1;

    if ( defined $Cpanel::App::appname &amp;&amp; defined $ENV{&#039;REMOTE_USER&#039;} ) {    # PPI NO PARSE - Only care about this check if the module is loaded
        if (
            ( $Cpanel::App::appname eq &#039;whostmgrd&#039; || $Cpanel::App::appname eq &#039;whostmgr&#039; || $Cpanel::App::appname eq &#039;whm&#039; )    # PPI NO PARSE - literal check accepts canonical + legacy forms without requiring Cpanel::App to be loaded
            &amp;&amp; $ENV{&#039;REMOTE_USER&#039;} ne &#039;root&#039;
        ) {

            require Cpanel::Config::HasCpUserFile;
            if ( Cpanel::Config::HasCpUserFile::has_readable_cpuser_file( $ENV{&#039;REMOTE_USER&#039;} ) ) {
                require Cpanel::Config::LoadCpUserFile::CurrentUser;
                my $cpdata_ref = Cpanel::Config::LoadCpUserFile::CurrentUser::load( $ENV{&#039;REMOTE_USER&#039;} );

                if ( scalar keys %{$cpdata_ref} ) {
                    *Cpanel::CPDATA = $cpdata_ref;
                }
            }
        }
    }

    my ( $class, @langtags ) = (
        $_[0],
        (
              defined $_[1]                                                                   ? _map_any_old_style_to_new_style( (@_)[ 1 .. $#_ ] )
            : exists $Cpanel::Cookies{&#039;session_locale&#039;} &amp;&amp; $Cpanel::Cookies{&#039;session_locale&#039;} ? _map_any_old_style_to_new_style( $Cpanel::Cookies{&#039;session_locale&#039;} )
            : ( exists $Cpanel::CPDATA{&#039;LOCALE&#039;} &amp;&amp; $Cpanel::CPDATA{&#039;LOCALE&#039;} )               ? ( $Cpanel::CPDATA{&#039;LOCALE&#039;} )
            : ( exists $Cpanel::CPDATA{&#039;LANG&#039;} &amp;&amp; $Cpanel::CPDATA{&#039;LANG&#039;} )                   ? ( _map_any_old_style_to_new_style( $Cpanel::CPDATA{&#039;LANG&#039;} ) )
            :                                                                                   ( get_server_locale() )
        )
    );

    if ( !$Cpanel::Locale::CDB_File_Path ) {
        $Cpanel::Locale::CDB_File_Path = Cpanel::Locale::Utils::init_lexicon( &#039;en&#039;, \%Cpanel::Locale::Lexicon, \$Cpanel::Locale::VERSION, \$Cpanel::Locale::Encoding );
    }

    _make_alias_if_needed( @langtags ? @langtags : &#039;en_us&#039; );

    return @langtags;
}

my %_made_aliases;

sub _make_alias_if_needed {
    foreach my $tag ( grep { ( $_ eq &#039;en&#039; || $_ eq &#039;i_default&#039; || $_ eq &#039;en_us&#039; ) &amp;&amp; !$_made_aliases{$_} } ( &#039;en&#039;, @_ ) ) {

        Cpanel::Locale-&gt;make_alias( [$tag], 1 );
        $_made_aliases{$tag} = 1;
    }
    return 0;
}

sub _real_get_handle {
    my ( $class, @arg_langtags ) = @_;

    my @langtags = _setup_for_real_get_handle( $class, @arg_langtags );
    @langtags = map { my $l = $_; $l = &#039;en&#039; if ( $l eq &#039;en_us&#039; || $l eq &#039;i_default&#039; ); $l } grep { $class-&gt;cpanel_is_valid_locale($_) } @langtags;
    @langtags = (&#039;en&#039;) unless scalar @langtags;

    my $args_sig = join( &#039;,&#039;, @langtags ) || &#039;no_args&#039;;

    return (
        ( defined $singleton_stash{$class}{$args_sig} &amp;&amp; ++$singleton_stash{$class}{$args_sig}-&gt;{&#039;_singleton_reused&#039;} )
        ? $singleton_stash{$class}{$args_sig}
        : ( $singleton_stash{$class}{$args_sig} = Cpanel::CPAN::Locale::Maketext::get_handle( $class, @langtags ) )
    );

}

sub get_non_singleton_handle {
    my ( $class, @arg_langtags ) = @_;

    my @langtags = _setup_for_real_get_handle( $class, @arg_langtags );

    return Cpanel::CPAN::Locale::Maketext::get_handle( $class, @langtags );
}

sub init {
    my ($lh) = @_;

    $lh-&gt;SUPER::init();

    $lh-&gt;_initialize_unknown_phrase_logging();
    $lh-&gt;_initialize_bracket_notation_whitelist();

    return $lh;
}

sub _initialize_unknown_phrase_logging {
    my $lh = shift;

    if ( defined $Cpanel::Locale::Context::DEFAULT_OUTPUT_CONTEXT ) {    # PPI NO PARSE - Only needed if loaded
        my $setter_cr = $lh-&gt;can(&quot;set_context_${Cpanel::Locale::Context::DEFAULT_OUTPUT_CONTEXT}&quot;) or do {    # PPI NO PARSE - Only needed if loaded
            die &quot;Invalid \$Cpanel::Locale::Context::DEFAULT_OUTPUT_CONTEXT: “$Cpanel::Locale::Context::DEFAULT_OUTPUT_CONTEXT”!&quot;;    # PPI NO PARSE - Only needed if loaded
        };
        $setter_cr-&gt;($lh);
    }

    elsif ( defined $Cpanel::Carp::OUTPUT_FORMAT ) {    # issafe
        if ( $Cpanel::Carp::OUTPUT_FORMAT eq &#039;xml&#039; ) {    # issafe
            $lh-&gt;set_context_plain();                     # no HTML markup or ANSI escape sequences
        }
        elsif ( $Cpanel::Carp::OUTPUT_FORMAT eq &#039;html&#039; ) {    # issafe
            $lh-&gt;set_context_html();                          # HTML
        }
    }

    $lh-&gt;{&#039;use_external_lex_cache&#039;} = 1;

    if ( exists $Cpanel::CPDATA{&#039;LOCALE_LOG_MISSING&#039;} &amp;&amp; $Cpanel::CPDATA{&#039;LOCALE_LOG_MISSING&#039;} ) {
        $lh-&gt;{&#039;_log_phantom_key&#039;} = sub {
            my ( $lh, $key ) = @_;


            my $chain      = &#039;&#039;;
            my $base_class = $lh-&gt;get_base_class();
            foreach my $class ( $lh-&gt;get_language_class, $base_class ) {
                my $lex_path = $lh-&gt;get_cdb_file_path( $class eq $base_class ? 1 : 0 );
                next if !$lex_path;
                $chain .= &quot;\tLOCALE: $class\n\tPATH: $lex_path\n&quot;;
                last if $class eq &#039;Cpanel::Locale::en&#039; || $class eq &#039;Cpanel::Locale::en_us&#039; || $class eq &#039;Cpanel::Locale::i_default&#039;;
            }

            my $pkg = $lh-&gt;get_language_tag();
            _logger-&gt;info( ( $Cpanel::Parser::Vars::file ? &quot;$Cpanel::Parser::Vars::file ::&quot; : &#039;&#039; ) . qq{ Could not find key via &#039;$pkg&#039; locale:\n\tKEY: &#039;$key&#039;\n$chain} );    # PPI NO PARSE -- module will already be there is we care about it

        };
    }
    return $lh;
}

our @DEFAULT_WHITELIST = qw(quant asis output current_year list_and list_or comment boolean datetime local_datetime format_bytes get_locale_name get_user_locale_name is_defined is_future join list_and_quoted list_or_quoted numerate numf);

sub _initialize_bracket_notation_whitelist {
    my $lh = shift;

    my @whitelist             = @DEFAULT_WHITELIST;
    my $custom_whitelist_file = Cpanel::Locale::Utils::Paths::get_custom_whitelist_path();

    if ( open( my $fh, &#039;&lt;&#039;, $custom_whitelist_file ) ) {
        while ( my $ln = readline($fh) ) {
            chomp $ln;
            push @whitelist, $ln if length($ln);
        }
        close $fh;
    }

    $lh-&gt;whitelist(@whitelist);
    return $lh;
}


sub output_cpanel_error {
    my ( $lh, $position ) = @_;

    if ( $lh-&gt;context_is_ansi() ) {
        return &quot;\e[1;31m&quot; if $position eq &#039;begin&#039;;
        return &quot;\e[0m&quot;    if $position eq &#039;end&#039;;
        return &#039;&#039;;
    }
    elsif ( $lh-&gt;context_is_html() ) {
        return qq{&lt;p style=&quot;color:#FF0000&quot;&gt;} if $position eq &#039;begin&#039;;
        return &#039;&lt;/p&gt;&#039;                        if $position eq &#039;end&#039;;
        return &#039;&#039;;
    }
    else {
        return &#039;&#039;;    # e.g. $lh-&gt;context_is_plain()
    }
}

sub cpanel_get_3rdparty_lang {
    my ( $lh, $_3rdparty ) = @_;
    require Cpanel::Locale::Utils::3rdparty;

    return Cpanel::Locale::Utils::3rdparty::get_app_setting( $lh, $_3rdparty ) || Cpanel::Locale::Utils::3rdparty::get_3rdparty_lang( $lh, $_3rdparty ) || $lh-&gt;get_language_tag() || &#039;en&#039;;
}


sub cpanel_is_valid_locale {
    my ( $lh, $locale ) = @_;

    my %valid_locales = map { $_ =&gt; 1 } ( qw(en en_us i_default), $lh-&gt;list_available_locales );
    return $valid_locales{$locale} ? 1 : 0;
}


sub cpanel_get_3rdparty_list {
    my ($lh) = @_;
    require Cpanel::Locale::Utils::3rdparty;
    return Cpanel::Locale::Utils::3rdparty::get_3rdparty_list($lh);
}


sub cpanel_get_lex_path {
    my ( $lh, $path, $rv ) = @_;

    return if !defined $path || $path eq &#039;&#039; || substr( $path, -3 ) ne &#039;.js&#039;;

    require Cpanel::JS::Variations;

    my $query = $path;
    $query = Cpanel::JS::Variations::get_base_file( $query, &#039;-%s.js&#039; );

    if ( defined $rv &amp;&amp; index( $rv, &#039;%s&#039; ) == -1 ) {
        substr( $rv, -3, 3, &#039;-%s.js&#039; );
    }

    my $asset_path = $lh-&gt;get_asset_file( $query, $rv );

    return $asset_path if $asset_path &amp;&amp; substr( $asset_path, -3 ) eq &#039;.js&#039; &amp;&amp; index( $asset_path, &#039;-&#039; ) &gt; -1;    # Only return a value if there is a localized js file here
    return;
}


sub tag_is_default_locale {
    my $tag = $_[1] || $_[0]-&gt;get_language_tag();
    return 1 if $tag eq &#039;en&#039; || $tag eq &#039;en_us&#039; || $tag eq &#039;i_default&#039;;
    return;
}


sub get_cdb_file_path {
    my ( $lh, $core ) = @_;
    my $class = $core ? $lh-&gt;get_base_class() : $lh-&gt;get_language_class();
    no strict &#039;refs&#039;;
    return
         $class eq &#039;Cpanel::Locale::en&#039;
      || $class eq &#039;Cpanel::Locale::en_us&#039;
      || $class eq &#039;Cpanel::Locale::i_default&#039; ? $Cpanel::Locale::CDB_File_Path : ${ $class . &#039;::CDB_File_Path&#039; };
}


sub _slurp_small_file_if_exists_no_exception {
    my ($path) = @_;

    local ( $!, $^E );

    open my $rfh, &#039;&lt;&#039;, $path or do {
        if ( $! != _ENOENT() ) {
            warn &quot;open($path): $!&quot;;
        }

        return undef;
    };

    read $rfh, my $buf, 8192 or do {
        warn &quot;read($path): $!&quot;;
    };

    return $buf;
}

my $_server_locale_file_contents;

sub get_server_locale {
    if ( exists $ENV{&#039;CPANEL_SERVER_LOCALE&#039;} ) {
        return $ENV{&#039;CPANEL_SERVER_LOCALE&#039;} if $ENV{&#039;CPANEL_SERVER_LOCALE&#039;} !~ tr{A-Za-z0-9_-}{}c;
        return undef;
    }
    if (%main::CPCONF) {
        return $main::CPCONF{&#039;server_locale&#039;} if exists $main::CPCONF{&#039;server_locale&#039;};
    }


    return ( $_server_locale_file_contents //= ( _slurp_small_file_if_exists_no_exception($SERVER_LOCALE_FILE) || &#039;&#039; ) );
}


sub _clear_cache {
    $_server_locale_file_contents = undef;
    return;
}

sub get_locale_for_user_cpanel {
    if (%main::CPCONF) {
        return $main::CPCONF{&#039;cpanel_locale&#039;} if exists $main::CPCONF{&#039;cpanel_locale&#039;};
        return $main::CPCONF{&#039;server_locale&#039;} if exists $main::CPCONF{&#039;server_locale&#039;};
    }
    require Cpanel::Config::LoadCpConf;
    my $cpconf = Cpanel::Config::LoadCpConf::loadcpconf_not_copy();    # safe since we do not modify cpconf

    return $cpconf-&gt;{&#039;cpanel_locale&#039;} if $cpconf-&gt;{&#039;cpanel_locale&#039;};    # will not be autovivified, 0 and &quot;&quot; are invalid, if the value is invalid they will get &#039;en&#039;
    return $cpconf-&gt;{&#039;server_locale&#039;} if $cpconf-&gt;{&#039;server_locale&#039;};    # will not be autovivified, 0 and &quot;&quot; are invalid, if the value is invalid they will get &#039;en&#039;
    return;
}


sub cpanel_reinit_lexicon {
    my ($lh) = @_;
    $lh-&gt;cpanel_detach_lexicon();
    $lh-&gt;cpanel_attach_lexicon();
}


my $detach_locale_lex;

sub cpanel_detach_lexicon {
    my ($lh) = @_;
    my $locale = $lh-&gt;get_language_tag();
    no strict &#039;refs&#039;;

    undef $Cpanel::Locale::CDB_File_Path;
    if ( $locale ne &#039;en&#039; &amp;&amp; $locale ne &#039;en_us&#039; &amp;&amp; $locale ne &#039;i_default&#039; ) {
        $detach_locale_lex = ${ &#039;Cpanel::Locale::&#039; . $locale . &#039;::CDB_File_Path&#039; };
        undef ${ &#039;Cpanel::Locale::&#039; . $locale . &#039;::CDB_File_Path&#039; };
    }

    untie( %{ &#039;Cpanel::Locale::&#039; . $locale . &#039;::Lexicon&#039; } );
    untie %Cpanel::Locale::Lexicon;
}

sub cpanel_attach_lexicon {
    my ($lh) = @_;
    my $locale = $lh-&gt;get_language_tag();

    $Cpanel::Locale::CDB_File_Path = Cpanel::Locale::Utils::init_lexicon( &#039;en&#039;, \%Cpanel::Locale::Lexicon, \$Cpanel::Locale::VERSION, \$Cpanel::Locale::Encoding );

    _make_alias_if_needed($locale);

    no strict &#039;refs&#039;;
    if ( defined $detach_locale_lex ) {
        ${ &#039;Cpanel::Locale::&#039; . $locale . &#039;::CDB_File_Path&#039; } = $detach_locale_lex;
    }
    else {
        ${ &#039;Cpanel::Locale::&#039; . $locale . &#039;::CDB_File_Path&#039; } = $Cpanel::Locale::CDB_File_Path;
    }

    my $file_path = $lh-&gt;get_cdb_file_path();
    return if !$file_path;
    return Cpanel::Locale::Utils::get_readonly_tie( $lh-&gt;get_cdb_file_path(), \%{ &#039;Cpanel::Locale::&#039; . $locale . &#039;::Lexicon&#039; } );
}


sub is_rtl {
    my ($lh) = @_;

    return &#039;right-to-left&#039; eq $lh-&gt;get_language_tag_character_orientation() ? 1 : 0;
}


sub get_language_tag_character_orientation {
    if ( my $direction = $known_locales_character_orientation{ $_[1] || $_[0]-&gt;{&#039;fallback_locale&#039;} || $_[0]-&gt;get_language_tag() } ) {
        return &#039;right-to-left&#039; if $direction == $RTL;
        return &#039;left-to-right&#039;;
    }
    $_[0]-&gt;SUPER::get_language_tag_character_orientation( @_[ 1 .. $#_ ] );
}

my $menu_ar;

sub get_locale_menu_arrayref {
    return $menu_ar if $menu_ar;
    require Cpanel::Locale::Utils::Display;
    $menu_ar = [ Cpanel::Locale::Utils::Display::get_locale_menu_hashref(@_) ];    # always array context to get all structs, properly uses other args besides object
    return $menu_ar;
}

my $non_existent;

sub get_non_existent_locale_menu_arrayref {
    return $non_existent if $non_existent;
    require Cpanel::Locale::Utils::Display;
    $non_existent = [ Cpanel::Locale::Utils::Display::get_non_existent_locale_menu_hashref(@_) ];    # always array context to get all structs, properly uses other args besides object
    return $non_existent;
}

sub _api1_maketext {
    require Cpanel::Locale::Utils::Api1;
    goto \&amp;Cpanel::Locale::Utils::Api1::_api1_maketext;                                              ## no extract maketext
}

our $api1 = {
    &#039;maketext&#039; =&gt; {                                                                                  ## no extract maketext
        &#039;function&#039;        =&gt; \&amp;_api1_maketext,                                                       ## no extract maketext
        &#039;internal&#039;        =&gt; 1,
        &#039;legacy_function&#039; =&gt; 2,
        &#039;modify&#039;          =&gt; &#039;inherit&#039;,
    },
};

sub current_year {
    return (localtime)[5] + 1900;    # we override datetime() so we can&#039;t use the internal current_year()
}

sub local_datetime {
    my ( $lh, $epoch, $format ) = @_;
    my $timezone = $ENV{&#039;TZ&#039;} // do {
        require Cpanel::Timezones;
        Cpanel::Timezones::calculate_TZ_env();
    };
    return $lh-&gt;datetime( $epoch, $format, $timezone );
}

sub datetime {
    my ( $lh, $epoch, $format, $timezone ) = @_;
    require Cpanel::Locale::Utils::DateTime;

    if ( $epoch &amp;&amp; $epoch =~ tr&lt;0-9&gt;&lt;&gt;c ) {
        require    # do not include it in updatenow.static
          Cpanel::Validate::Time;
        Cpanel::Validate::Time::iso_or_die($epoch);

        require Cpanel::Time::ISO;
        $epoch = Cpanel::Time::ISO::iso2unix($epoch);
    }

    return Cpanel::Locale::Utils::DateTime::datetime( $lh, $epoch, $format, $timezone );
}

sub get_lookup_hash_of_multi_epoch_datetime {
    my ( $lh, $epochs_ar, $format, $timezone ) = @_;
    require Cpanel::Locale::Utils::DateTime;
    return Cpanel::Locale::Utils::DateTime::get_lookup_hash_of_multi_epoch_datetime( $lh, $epochs_ar, $format, $timezone );
}

sub get_locale_name_or_nothing {
    my ( $locale, $name, $in_locale_tongue ) = @_;
    $name ||= $locale-&gt;get_language_tag();

    if ( index( $name, &#039;i_&#039; ) == 0 ) {
        require Cpanel::DataStore;
        my $i_locales_path = Cpanel::Locale::Utils::Paths::get_i_locales_config_path();
        my $i_conf         = Cpanel::DataStore::fetch_ref(&quot;$i_locales_path/$name.yaml&quot;);

        return $i_conf-&gt;{&#039;display_name&#039;} if $i_conf-&gt;{&#039;display_name&#039;};
    }
    else {
        my $real = $locale-&gt;get_language_tag_name( $name, $in_locale_tongue );
        return $real if $real;
    }

    return;
}

sub get_locale_name_or_tag {
    return $_[0]-&gt;get_locale_name_or_nothing( $_[1], $_[2] ) || $_[1] || $_[0]-&gt;get_language_tag();
}

*get_locale_name = *get_locale_name_or_tag;    # for shorter BN

sub get_user_locale {
    return $Cpanel::CPDATA{&#039;LOCALE&#039;} if $Cpanel::CPDATA{&#039;LOCALE&#039;};
    require Cpanel::Locale::Utils::User;       # probably a no-op but just in case since its loading is conditional
    return Cpanel::Locale::Utils::User::get_user_locale();
}

sub get_user_locale_name {
    require Cpanel::Locale::Utils::User;       # probably a no-op but just in case since its loading is conditional
    return $_[0]-&gt;get_locale_name_or_tag( Cpanel::Locale::Utils::User::get_user_locale( $_[1] ) );
}


sub set_user_locale {
    my ( $locale, $country_code ) = @_;

    if ($country_code) {
        my $language_name = $locale-&gt;lang_names_hashref();

        if ( exists $language_name-&gt;{$country_code} ) {
            require Cpanel::Locale::Utils::Legacy;
            require Cpanel::Locale::Utils::User::Modify;

            my $language = Cpanel::Locale::Utils::Legacy::get_best_guess_of_legacy_from_locale($country_code);
            if ( Cpanel::Locale::Utils::User::Modify::save_user_locale( $country_code, $language, $Cpanel::user ) ) {
                return 1;
            }

        }
    }

    die Cpanel::Exception::create_raw( &quot;Empty&quot;, $locale-&gt;maketext(&quot;Unable to set locale, please specify a valid country code.&quot;) );
}


sub get_locales {

    my $locale = shift;
    my @listing;
    my ( $names, $local_names ) = $locale-&gt;lang_names_hashref();

    foreach ( keys %{$names} ) {
        push @listing, {
            locale     =&gt; $_,
            name       =&gt; $names-&gt;{$_},
            local_name =&gt; $local_names-&gt;{$_},
            direction  =&gt; ( !defined $known_locales_character_orientation{$_} || $known_locales_character_orientation{$_} == $LTR ) ? &#039;ltr&#039; : &#039;rtl&#039;
        };
    }

    return \@listing;

}

my $api2_lh;

sub api2_get_user_locale {
    $api2_lh ||= Cpanel::Locale-&gt;get_handle();
    return ( { &#039;locale&#039; =&gt; $api2_lh-&gt;get_user_locale() } );
}

sub api2_get_user_locale_name {
    $api2_lh ||= Cpanel::Locale-&gt;get_handle();
    return ( { &#039;name&#039; =&gt; $api2_lh-&gt;get_user_locale_name() } );
}

sub api2_get_locale_name {
    $api2_lh ||= Cpanel::Locale-&gt;get_handle();

    my $tag = ( scalar @_ &gt; 2 ) ? {@_}-&gt;{&#039;locale&#039;} : $_[1];

    return ( { &#039;name&#039; =&gt; $api2_lh-&gt;get_locale_name_or_tag($tag) } );
}

sub api2_get_encoding {
    $api2_lh ||= Cpanel::Locale-&gt;get_handle();
    return ( { &#039;encoding&#039; =&gt; $api2_lh-&gt;encoding() } );
}

sub api2_numf {
    my %args = @_;
    $api2_lh ||= Cpanel::Locale-&gt;get_handle();
    return ( { &#039;numf&#039; =&gt; $api2_lh-&gt;numf( $args{number}, $args{max_decimal_places} ) } );
}

sub api2_get_html_dir_attr {
    $api2_lh ||= Cpanel::Locale-&gt;get_handle();

    return ( { &#039;dir&#039; =&gt; $api2_lh-&gt;get_html_dir_attr() } );
}

my $allow_demo = { allow_demo =&gt; 1 };

our %API = (
    get_locale_name      =&gt; $allow_demo,
    get_encoding         =&gt; $allow_demo,
    get_html_dir_attr    =&gt; $allow_demo,
    get_user_locale      =&gt; $allow_demo,
    get_user_locale_name =&gt; $allow_demo,
    numf                 =&gt; $allow_demo,
);

sub api2 {
    my ($func) = @_;
    return { %{ $API{$func} } } if $API{$func};
    return;
}

my $global_lh;


sub lh {
    return ( $global_lh ||= Cpanel::Locale-&gt;get_handle() );
}

sub import {
    my ( $package, @args ) = @_;
    my ($namespace) = caller;
    if ( @args == 1 &amp;&amp; $args[0] eq &#039;lh&#039; ) {
        no strict &#039;refs&#039;;    ## no critic(ProhibitNoStrict)
        my $exported_name = &quot;${namespace}::lh&quot;;
        *$exported_name = \*lh;
    }
}

sub _load_carp {
    if ( !$INC{&#039;Cpanel/Carp.pm&#039;} ) {

        local $@;

        eval &#039;require Cpanel::Carp; 1;&#039; or die $@;    # hide from perlcc
    }

    return;
}

1;

} # --- END Cpanel/Locale.pm


{ # --- BEGIN Cpanel/Sys/Uname.pm
package Cpanel::Sys::Uname;


use strict;

our $SYS_UNAME       = 63;
our $UNAME_ELEMENTS  = 6;
our $_UTSNAME_LENGTH = 65;
my $UNAME_PACK_TEMPLATE   = ( &#039;c&#039; . $_UTSNAME_LENGTH ) x $UNAME_ELEMENTS;
my $UNAME_UNPACK_TEMPLATE = ( &#039;Z&#039; . $_UTSNAME_LENGTH ) x $UNAME_ELEMENTS;

my @uname_cache;

sub get_uname_cached {
    return ( @uname_cache ? @uname_cache : ( @uname_cache = syscall_uname() ) );
}

sub clearcache {
    @uname_cache = ();
    return;
}

sub syscall_uname {
    my $uname;
    if ( syscall( $SYS_UNAME, $uname = pack( $UNAME_PACK_TEMPLATE, () ) ) == 0 ) {
        return unpack( $UNAME_UNPACK_TEMPLATE, $uname );
    }
    else {
        die &quot;The uname() system call failed because of an error: $!&quot;;
    }
    return;
}
1;

} # --- END Cpanel/Sys/Uname.pm


{ # --- BEGIN Cpanel/Sys/Hostname/Fallback.pm
package Cpanel::Sys::Hostname::Fallback;


use strict;
use warnings;
no warnings &#039;once&#039;;

use Socket             ();
# use Cpanel::Sys::Uname (); # perlpkg line 211


sub get_canonical_hostname {
    my @uname = Cpanel::Sys::Uname::get_uname_cached();
    my ( $err, @results ) = Socket::getaddrinfo( $uname[1], 0, { flags =&gt; Socket::AI_CANONNAME() } );
    if ( @results &amp;&amp; $results[0]-&gt;{&#039;canonname&#039;} ) {
        return $results[0]-&gt;{&#039;canonname&#039;};
    }

    return undef;

}

1;

} # --- END Cpanel/Sys/Hostname/Fallback.pm


{ # --- BEGIN Cpanel/Sys/Hostname.pm
package Cpanel::Sys::Hostname;


use strict;
use warnings;
no warnings &#039;once&#039;;

our $VERSION = 2.0;

# use Cpanel::Sys::Uname (); # perlpkg line 211

our $cachedhostname = &#039;&#039;;


sub gethostname {
    my $nocache = shift || 0;
    if ( !$nocache &amp;&amp; length $cachedhostname ) { return $cachedhostname }

    my $hostname = _gethostname($nocache);

    if ( length $hostname ) {
        $hostname =~ tr{A-Z}{a-z};    # hostnames must be lowercase (see Cpanel::Sys::Hostname::Modify::make_hostname_lowercase_fqdn)
        $cachedhostname = $hostname;
    }
    return $hostname;
}

sub _gethostname {
    my $nocache = shift || 0;

    my $hostname;
    Cpanel::Sys::Uname::clearcache() if $nocache;
    my @uname = Cpanel::Sys::Uname::get_uname_cached();
    if ( $uname[1] &amp;&amp; index( $uname[1], &#039;.&#039; ) &gt; -1 ) {
        $hostname = $uname[1];
        $hostname =~ tr{A-Z}{a-z};    # hostnames must be lowercase (see Cpanel::Sys::Hostname::Modify::make_hostname_lowercase_fqdn)
        return $hostname;
    }

    eval {
        require Cpanel::Sys::Hostname::Fallback;
        $hostname = Cpanel::Sys::Hostname::Fallback::get_canonical_hostname();
    };
    if ($hostname) {
        $hostname =~ tr{A-Z}{a-z};    # hostnames must be lowercase (see Cpanel::Sys::Hostname::Modify::make_hostname_lowercase_fqdn)
        return $hostname;
    }

    require Cpanel::LoadFile;
    chomp( $hostname = Cpanel::LoadFile::loadfile( &#039;/proc/sys/kernel/hostname&#039;, { &#039;skip_exists_check&#039; =&gt; 1 } ) );
    if ($hostname) {
        $hostname =~ tr{A-Z}{a-z};    # hostnames must be lowercase (see Cpanel::Sys::Hostname::Modify::make_hostname_lowercase_fqdn)
        $hostname =~ tr{\r\n}{}d;     # chomp is not enough (not sure if this is required, however we cannot test all kernels so its safer to leave it in)
        return $hostname;
    }

    require Cpanel::Debug;
    Cpanel::Debug::log_warn(&#039;Unable to determine correct hostname&#039;);
    return;
}


sub shorthostname {
    my $hostname = gethostname();
    return $hostname if index( $hostname, &#039;.&#039; ) == -1;    # Hostname is not a FQDN (this should never happen)
    return substr( $hostname, 0, index( $hostname, &#039;.&#039; ) );
}

1;

} # --- END Cpanel/Sys/Hostname.pm


{ # --- BEGIN Cpanel/Hostname.pm
package Cpanel::Hostname;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Sys::Hostname (); # perlpkg line 211

our $VERSION = 2.0;

{
    no warnings &#039;once&#039;;
    *gethostname   = *Cpanel::Sys::Hostname::gethostname;
    *shorthostname = *Cpanel::Sys::Hostname::shorthostname;
}

1;

} # --- END Cpanel/Hostname.pm


{ # --- BEGIN Cpanel/Config/CpConfGuard/CORE.pm
package Cpanel::Config::CpConfGuard::CORE;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use Cpanel::ConfigFiles                  (); # perlpkg line 211
# use Cpanel::Debug                        (); # perlpkg line 211
# use Cpanel::FileUtils::Write::JSON::Lazy (); # perlpkg line 211
# use Cpanel::LoadModule                   (); # perlpkg line 211
# use Cpanel::Config::CpConfGuard          (); # perlpkg line 211

our $SENDING_MISSING_FILE_NOTICE = 0;

my $FILESYS_PERMS = 0644;

sub find_missing_keys {
    my ($self) = @_;
    _verify_called_as_object_method($self);

    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Config::CpConfGuard::Default&#039;);
    my $default = &#039;Cpanel::Config::CpConfGuard::Default&#039;-&gt;new(
        current_config  =&gt; $self-&gt;{data},
        current_changes =&gt; $self-&gt;{changes},
    );

    if ( $self-&gt;{&#039;is_missing&#039;} ) {

        if ( UNIVERSAL::isa( $self-&gt;{&#039;cache&#039;}, &#039;HASH&#039; ) &amp;&amp; %{ $self-&gt;{&#039;cache&#039;} } ) {

            $self-&gt;{&#039;data&#039;} = {};
            %{ $self-&gt;{&#039;data&#039;} } = %{ $self-&gt;{&#039;cache&#039;} };
            my $config = $self-&gt;{&#039;data&#039;};

            foreach my $key ( $default-&gt;get_keys() ) {
                next if exists $config-&gt;{$key};
                $config-&gt;{$key} = $default-&gt;get_default_for($key);
            }

        }
        else {
            $self-&gt;{&#039;data&#039;} = $default-&gt;get_all_defaults();
        }

        $self-&gt;{&#039;modified&#039;} = 1;    # Mark as save needed.
        return;
    }

    my $cache = $self-&gt;{&#039;cache&#039;};
    undef( $self-&gt;{&#039;cache&#039;} );    # we do not need the cache after the first pass
    my $config = $self-&gt;{&#039;data&#039;};

    my $changes = $self-&gt;{&#039;changes&#039;};    # used for notifications

    $config-&gt;{&#039;tweak_unset_vars&#039;} ||= &#039;&#039;;

    foreach my $key ( $default-&gt;get_keys() ) {
        next if exists $config-&gt;{$key};

        $self-&gt;{&#039;modified&#039;} = 1;    # Mark as save needed.

        if ( exists $cache-&gt;{$key} ) {
            $config-&gt;{$key} = $cache-&gt;{$key};

            $changes-&gt;{&#039;from_cache&#039;} ||= [];
            push @{ $changes-&gt;{&#039;from_cache&#039;} }, $key;

            $changes-&gt;{&#039;changed_keys&#039;} ||= {};
            $changes-&gt;{&#039;changed_keys&#039;}{$key} = &#039;from_cache&#039;;

            next;
        }

        my $changes_type = $default-&gt;is_dynamic($key) ? &#039;from_dynamic&#039; : &#039;from_default&#039;;

        $changes-&gt;{&#039;changed_keys&#039;} ||= {};
        $changes-&gt;{&#039;changed_keys&#039;}{$key} = $changes_type;

        $changes-&gt;{$changes_type} ||= [];
        push @{ $changes-&gt;{$changes_type} }, $key;

        $config-&gt;{$key} = $default-&gt;get_default_for($key);
    }

    foreach my $key ( @{ $default-&gt;dead_variables() } ) {
        next unless exists $config-&gt;{$key};

        $self-&gt;{&#039;modified&#039;} = 1;    # Mark as save needed.

        delete( $config-&gt;{$key} );

        $changes-&gt;{&#039;dead_variable&#039;} ||= [];
        push @{ $changes-&gt;{&#039;dead_variable&#039;} }, $key;

    }

    return;
}

sub validate_keys {
    my ($self) = @_;

    _verify_called_as_object_method($self);

    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Config::CpConfGuard::Validate&#039;);
    my $invalid = &#039;Cpanel::Config::CpConfGuard::Validate&#039;-&gt;can(&#039;patch_cfg&#039;)-&gt;( $self-&gt;{&#039;data&#039;} );
    if (%$invalid) {
        $self-&gt;{modified} = 1;
        $self-&gt;{&#039;changes&#039;}-&gt;{&#039;invalid&#039;} = $invalid;
    }

    return;
}

sub notify_and_save_if_changed {
    my ($self) = @_;
    _verify_called_as_object_method($self);

    return if !$self-&gt;{&#039;use_lock&#039;};
    return if !$self-&gt;{&#039;modified&#039;};

    my $config = $self-&gt;{&#039;data&#039;};

    if ( $ENV{&#039;CPANEL_BASE_INSTALL&#039;} ) {
        ;    # Do nothing for notification.
    }
    elsif ( $self-&gt;{&#039;is_missing&#039;} ) {
        $config-&gt;{&#039;tweak_unset_vars&#039;} = &#039;&#039;;
        Cpanel::Debug::log_warn(&quot;Missing cpanel.config regenerating …&quot;);

        $self-&gt;notify_missing_file;
    }
    elsif ( %{ $self-&gt;{&#039;changes&#039;} } ) {
        my $changes = $self-&gt;{&#039;changes&#039;};

        my %uniq = map { $_ =&gt; 1 } @{ $changes-&gt;{&#039;from_default&#039;} || [] }, @{ $changes-&gt;{&#039;from_dynamic&#039;} || [] }, split( /\s*,\s*/, $config-&gt;{&#039;tweak_unset_vars&#039;} );
        $config-&gt;{&#039;tweak_unset_vars&#039;} = join &quot;,&quot;, sort keys %uniq;

        $self-&gt;log_missing_values();
    }

    return $self-&gt;save( keep_lock =&gt; 1 );
}

sub _server_locale {
    my ($self) = @_;

    _verify_called_as_object_method($self);

    my $locale_name = $self-&gt;{&#039;data&#039;}-&gt;{&#039;server_locale&#039;} || &#039;en&#039;;
    require Cpanel::Locale;
    return Cpanel::Locale-&gt;_real_get_handle($locale_name);
}

sub _longest {
    my @array = @_;
    return length( ( sort { length $b &lt;=&gt; length $a } @array )[0] );
}

sub _stringify_undef {
    my $value = shift;
    return defined $value ? $value : &#039;&lt;undef&gt;&#039;;
}

sub log_missing_values {
    my ($self) = @_;

    require Cpanel::Hostname;
    my $changes = $self-&gt;{&#039;changes&#039;};

    my $locale = $self-&gt;_server_locale();

    my $hostname = Cpanel::Hostname::gethostname();

    my $prev = $locale-&gt;set_context_plain();

    my $message = &#039;&#039;;
    $message .= $locale-&gt;maketext( &#039;One or more key settings for “[_1]” were either not found in [asis,cPanel amp() WHM]’s server configuration file ([_2]), or were present but did not pass validation.&#039;, $hostname, $self-&gt;{&#039;path&#039;} ) . &quot;\n&quot;;

    if ( $changes-&gt;{&#039;from_dynamic&#039;} ) {
        $message .= $locale-&gt;maketext(&#039;The following settings were absent and have been selected based on the current state of your installation.&#039;);
        $message .= &quot;\n&quot;;

        my @keys    = @{ $changes-&gt;{&#039;from_dynamic&#039;} };
        my $max_len = _longest(@keys) + 2;
        foreach my $key (@keys) {
            $message .= sprintf( &quot;    %-${max_len}s= %s\n&quot;, $key, _stringify_undef( $self-&gt;{&#039;data&#039;}-&gt;{$key} ) );
        }
        $message .= &quot;\n&quot;;
    }

    if ( $changes-&gt;{&#039;from_cache&#039;} ) {
        $message .= $locale-&gt;maketext(&#039;The following settings were absent, but were restored from your [asis,cpanel.config.cache] file:&#039;);
        $message .= &quot;\n&quot;;

        my @keys    = @{ $changes-&gt;{&#039;from_cache&#039;} };
        my $max_len = _longest(@keys) + 2;
        foreach my $key (@keys) {
            $message .= sprintf( &quot;    %-${max_len}s= %s\n&quot;, $key, _stringify_undef( $self-&gt;{&#039;data&#039;}-&gt;{$key} ) );
        }
        $message .= &quot;\n&quot;;
    }

    if ( $changes-&gt;{&#039;from_default&#039;} or $changes-&gt;{&#039;invalid&#039;} ) {
        $message .= $locale-&gt;maketext(&#039;The following settings were absent or invalid. Your server has copied the defaults for them from the configuration defaults file ([asis,/usr/local/cpanel/etc/cpanel.config]).&#039;);
        $message .= &quot;\n&quot;;

        if ( $changes-&gt;{&#039;from_default&#039;} ) {
            my @keys    = @{ $changes-&gt;{&#039;from_default&#039;} };
            my $max_len = _longest(@keys) + 2;
            foreach my $key (@keys) {
                $message .= sprintf( &quot;    %-${max_len}s= %s\n&quot;, $key, _stringify_undef( $self-&gt;{&#039;data&#039;}-&gt;{$key} ) );
            }
        }

        if ( $changes-&gt;{&#039;invalid&#039;} ) {
            my $invalid = $changes-&gt;{&#039;invalid&#039;};
            my @keys    = keys %$invalid;
            my $max_len = _longest(@keys) + 2;
            foreach my $key (@keys) {
                $message .= sprintf( &quot;    %-${max_len}s= %s (Previously set to &#039;%s&#039;)\n&quot;, $key, _stringify_undef( $invalid-&gt;{$key}-&gt;{&#039;to&#039;} ), _stringify_undef( $invalid-&gt;{$key}-&gt;{&#039;from&#039;} ) );
            }
        }
        $message .= &quot;\n&quot;;
    }

    if ( $changes-&gt;{&#039;dead_variable&#039;} ) {
        $message .= $locale-&gt;maketext(&#039;The following settings are obsolete and have been removed from the server configuration file:&#039;);
        $message .= &quot;\n&quot;;
        $message .= &#039;    &#039; . join( &#039;, &#039;, @{ $changes-&gt;{&#039;dead_variable&#039;} } );
        $message .= &quot;\n\n&quot;;
    }

    $message .= $locale-&gt;maketext( &#039;Read the [asis,cpanel.config] file [output,url,_1,documentation] for important information about this file.&#039;, &#039;https://go.cpanel.net/cpconfig&#039; );
    $message .= &quot;\n\n&quot;;

    Cpanel::Debug::logger();    # initialize the logger
    local $Cpanel::Logger::ENABLE_BACKTRACE = 0;
    foreach my $chunk ( split( /\n+/, $message ) ) {
        Cpanel::Debug::log_warn($chunk);
    }

    $locale-&gt;set_context($prev);

    return;
}

sub notify_missing_file {
    my ($self) = @_;

    if ($SENDING_MISSING_FILE_NOTICE) {
        return;    #Already sending notification, don&#039;t double up
    }

    require Cpanel::Hostname;
    local $SENDING_MISSING_FILE_NOTICE = 1;

    my $locale = $self-&gt;_server_locale();
    my $prev   = $locale-&gt;set_context_plain();

    my @to_log;
    my %critical_values;

    my $hostname = Cpanel::Hostname::gethostname();
    push @to_log, $locale-&gt;maketext(&#039;Your server has copied the defaults from your cache and the configuration defaults file ([asis,/usr/local/cpanel/etc/cpanel.config]) to [asis,/var/cpanel/cpanel.config], and it has generated the following critical values:&#039;);
    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Config::CpConfGuard::Default&#039;);
    my $critical = Cpanel::Config::CpConfGuard::Default::critical_values();
    my $max_len  = _longest(@$critical) + 2;
    my $critical_value;
    foreach my $key ( sort @$critical ) {
        $critical_value = _stringify_undef( $self-&gt;{&#039;data&#039;}-&gt;{$key} );
        $critical_values{$key} = $critical_value;
        push @to_log, sprintf( &quot;    %-${max_len}s= %s\n&quot;, $key, $critical_value );
    }

    push @to_log, $locale-&gt;maketext( &#039;Read the [asis,cpanel.config] file [output,url,_1,documentation] for more information about this file.&#039;, &#039;https://go.cpanel.net/cpconfig&#039; ) . &#039; &#039;;

    Cpanel::Debug::logger();    # initialize the logger
    local $Cpanel::Logger::ENABLE_BACKTRACE = 0;

    foreach my $chunk (@to_log) {
        chomp $chunk;
        Cpanel::Debug::log_warn($chunk);
    }

    _icontact( \%critical_values );

    $locale-&gt;set_context($prev);

    return;
}

sub _icontact {
    my $critical_values = shift;

    Cpanel::LoadModule::load_perl_module(&quot;Cpanel::iContact::Class::Config::CpConfGuard&quot;);
    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Notify&#039;);
    &#039;Cpanel::Notify&#039;-&gt;can(&#039;notification_class&#039;)-&gt;(
        &#039;class&#039;            =&gt; &#039;Config::CpConfGuard&#039;,
        &#039;application&#039;      =&gt; &#039;Config::CpConfGuard&#039;,
        &#039;constructor_args&#039; =&gt; [
            &#039;origin&#039;          =&gt; &#039;cpanel.config&#039;,
            &#039;critical_values&#039; =&gt; $critical_values,
        ]
    );

    return;
}

sub save {
    my ( $self, %opts ) = @_;

    _verify_called_as_object_method($self);

    return unless ( $self-&gt;{&#039;use_lock&#039;} );

    return 1 if $Cpanel::Config::CpConfGuard::memory_only;

    if ( !$self-&gt;{&#039;rw&#039;} ) {
        Cpanel::LoadModule::load_perl_module(&#039;Cpanel::SafeFile&#039;);
        $self-&gt;{&#039;fh&#039;} = &#039;Cpanel::SafeFile&#039;-&gt;can(&#039;safereopen&#039;)-&gt;( $self-&gt;{&#039;fh&#039;}, &#039;+&gt;&#039;, $Cpanel::ConfigFiles::cpanel_config_file );
        return $self-&gt;abort(&#039;Cannot reopen file for rw&#039;) unless $self-&gt;{&#039;fh&#039;};
        $self-&gt;{&#039;rw&#039;} = 1;
    }

    return $self-&gt;abort(&#039;Locked in parent, cannot save&#039;) if $self-&gt;{&#039;pid&#039;} != $$;
    return $self-&gt;abort(&#039;hash reference required&#039;)       if !UNIVERSAL::isa( $self-&gt;{&#039;data&#039;}, &#039;HASH&#039; );

    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Config::FlushConfig&#039;);
    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Config::SaveCpConf&#039;);

    &#039;Cpanel::Config::FlushConfig&#039;-&gt;can(&#039;flushConfig&#039;)-&gt;(
        $self-&gt;{&#039;fh&#039;},
        $self-&gt;{&#039;data&#039;},
        &#039;=&#039;,
        &#039;Cpanel::Config::SaveCpConf&#039;-&gt;can(&#039;header_message&#039;)-&gt;(),
        {
            sort  =&gt; 1,
            perms =&gt; $FILESYS_PERMS,
        },
    );


    %{$Cpanel::Config::CpConfGuard::MEM_CACHE} = %{ $self-&gt;{&#039;data&#039;} };

    return 1 if $opts{keep_lock};

    $self-&gt;release_lock;

    return 1;
}

sub _update_cache {
    my ($self) = @_;

    _verify_called_as_object_method($self);

    return 0 if Cpanel::Config::CpConfGuard::_cache_is_valid() &amp;&amp; $self-&gt;{&#039;cache_is_valid&#039;};    # Don&#039;t re-write the file if it looks correct.

    $Cpanel::Config::CpConfGuard::MEM_CACHE_CPANEL_CONFIG_MTIME = ( stat($Cpanel::ConfigFiles::cpanel_config_file) )[9] || 0;

    return unless $self-&gt;{&#039;use_lock&#039;};                                                          # never update the cache when not root


    local $@;

    my $ok = eval { Cpanel::FileUtils::Write::JSON::Lazy::write_file( $Cpanel::ConfigFiles::cpanel_config_cache_file, $Cpanel::Config::CpConfGuard::MEM_CACHE, $FILESYS_PERMS ) || 0 };

    if ( !$ok ) {

        if ( !defined $ok ) {
            Cpanel::Debug::log_warn(&quot;Cannot update cache file: $Cpanel::ConfigFiles::cpanel_config_cache_file $@&quot;);

            unlink $Cpanel::ConfigFiles::cpanel_config_cache_file;
            return -1;
        }

        return;
    }

    my $past = ( stat($Cpanel::ConfigFiles::cpanel_config_cache_file) )[9] - 1;

    return _adjust_timestamp_for( $Cpanel::ConfigFiles::cpanel_config_file =&gt; $past );
}

sub _adjust_timestamp_for {
    my ( $f, $time ) = @_;

    return unless defined $f &amp;&amp; defined $time;

    return 1 if utime( $time, $time, $f );

    my ( $sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst ) = localtime($time);
    my $stamp = sprintf( &quot;%04d%02d%02d%02d%02d.%02d&quot;, $year + 1900, $mon + 1, $mday, $hour, $min, $sec );

    unless ( _touch( $f =&gt; $stamp ) ) {
        Cpanel::Debug::log_warn(&quot;Cannot update mtime on $f: $@&quot;);
        return;
    }

    return 1;
}

sub _touch {    # mainly created to easily mock that part during the tests
    my ( $f, $stamp ) = @_;
    return system( &#039;touch&#039;, &#039;-t&#039;, $stamp, $f ) == 0 ? 1 : 0;
}

sub _verify_called_as_object_method {
    if ( ref( $_[0] ) ne &quot;Cpanel::Config::CpConfGuard&quot; ) {
        die &#039;&#039; . ( caller(0) )[3] . &quot; was not called as an object method [&quot; . ref( $_[0] ) . &quot;]\n&quot;;
    }
    return;
}

sub abort {
    my ( $self, $msg ) = @_;

    _verify_called_as_object_method($self);

    if ( $self-&gt;{&#039;pid&#039;} != $$ ) {
        Cpanel::Debug::log_die(&#039;Locked in parent, cannot release lock&#039;);
        return;
    }

    $self-&gt;release_lock();

    Cpanel::Debug::log_die($msg) if $msg;


    return 1;
}

sub set {
    my ( $self, $k, $v ) = @_;

    _verify_called_as_object_method($self);

    return unless defined $k;

    my $config = $self-&gt;{&#039;data&#039;};

    $config-&gt;{$k} = $v;

    if ( $config-&gt;{&#039;tweak_unset_vars&#039;} &amp;&amp; index( $config-&gt;{&#039;tweak_unset_vars&#039;}, $k ) &gt; -1 ) {
        my %unset = map { ( $_ =&gt; 1 ) } split( /\s*,\s*/, $config-&gt;{&#039;tweak_unset_vars&#039;} );
        delete( $unset{$k} );
        $config-&gt;{&#039;tweak_unset_vars&#039;} = join( &#039;,&#039;, sort keys %unset );
    }

    return 1;
}

1;

} # --- END Cpanel/Config/CpConfGuard/CORE.pm


{ # --- BEGIN Cpanel/Config/CpConfGuard.pm
package Cpanel::Config::CpConfGuard;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::JSON::FailOK (); # perlpkg line 211
# use Cpanel::ConfigFiles  (); # perlpkg line 211

# use Cpanel::Debug    (); # perlpkg line 211
# use Cpanel::Destruct (); # perlpkg line 211

use constant {
    _ENOENT =&gt; 2,
};

our $IN_LOAD                     = 0;
our $SENDING_MISSING_FILE_NOTICE = 0;

my $FILESYS_PERMS = 0644;

my $is_daemon;

BEGIN {
    $is_daemon = 0;    # initialize the value in the begin block
    if (   index( $0, &#039;updatenow&#039; ) &gt; -1
        || index( $0, &#039;cpsrvd&#039; ) &gt; -1
        || index( $0, &#039;cpdavd&#039; ) &gt; -1
        || index( $0, &#039;queueprocd&#039; ) &gt; -1
        || index( $0, &#039;tailwatchd&#039; ) &gt; -1
        || index( $0, &#039;cpanellogd&#039; ) &gt; -1
        || ( length $0 &gt; 7 &amp;&amp; substr( $0, -7 ) eq &#039;.static&#039; ) ) {
        $is_daemon = 1;
    }
}

my $module_file;

our ( $MEM_CACHE_CPANEL_CONFIG_MTIME, $MEM_CACHE ) = ( 0, undef );

our $memory_only;

sub _is_daemon { $is_daemon };    # for testing

sub clearcache {
    $MEM_CACHE_CPANEL_CONFIG_MTIME = 0;
    $MEM_CACHE                     = undef;
    return;
}

sub new {
    my ( $class, %opts ) = @_;

    Cpanel::JSON::FailOK::LoadJSONModule() if !$is_daemon &amp;&amp; !$INC{&#039;Cpanel/JSON.pm&#039;};

    my $self = bless {
        %opts,    # to be improved
        &#039;path&#039;     =&gt; $Cpanel::ConfigFiles::cpanel_config_file,
        &#039;pid&#039;      =&gt; $$,
        &#039;modified&#039; =&gt; 0,
        &#039;changes&#039;  =&gt; {},
    }, $class;

    $self-&gt;{&#039;use_lock&#039;} //= ( $&gt; == 0 ) ? 1 : 0;

    if ($memory_only) {
        $self-&gt;{&#039;data&#039;} = ref($memory_only) eq &#039;HASH&#039; ? $memory_only : {};
        return $self;
    }

    ( $self-&gt;{&#039;cache&#039;}, $self-&gt;{&#039;cache_is_valid&#039;} ) = get_cache();

    return $self if $self-&gt;{&#039;loadcpconf&#039;} &amp;&amp; $self-&gt;{&#039;cache_is_valid&#039;};

    $self-&gt;load_cpconf_file();

    return $self if $is_daemon || $opts{&#039;no_validate&#039;} || !$self-&gt;{&#039;use_lock&#039;};

    $self-&gt;find_missing_keys();
    $self-&gt;validate_keys();
    $self-&gt;notify_and_save_if_changed();

    return $self;
}

sub set {
    require Cpanel::Config::CpConfGuard::CORE;
    goto \&amp;Cpanel::Config::CpConfGuard::CORE::set;
}

sub config_copy {
    my ($self) = @_;
    _verify_called_as_object_method($self);

    my $config = $self-&gt;{&#039;data&#039;} || $self-&gt;{&#039;cache&#039;} || {};
    return {%$config};
}

sub find_missing_keys {
    require Cpanel::Config::CpConfGuard::CORE;
    goto \&amp;Cpanel::Config::CpConfGuard::CORE::find_missing_keys;
}

sub validate_keys {
    require Cpanel::Config::CpConfGuard::CORE;
    goto \&amp;Cpanel::Config::CpConfGuard::CORE::validate_keys;
}

sub notify_and_save_if_changed {
    require Cpanel::Config::CpConfGuard::CORE;
    goto \&amp;Cpanel::Config::CpConfGuard::CORE::notify_and_save_if_changed;
}

sub log_missing_values {
    require Cpanel::Config::CpConfGuard::CORE;
    goto \&amp;Cpanel::Config::CpConfGuard::CORE::log_missing_values;
}

sub notify_missing_file {
    require Cpanel::Config::CpConfGuard::CORE;
    goto \&amp;Cpanel::Config::CpConfGuard::CORE::notify_missing_file;
}

sub save {
    require Cpanel::Config::CpConfGuard::CORE;
    goto \&amp;Cpanel::Config::CpConfGuard::CORE::save;
}

sub release_lock {
    my ($self) = @_;

    _verify_called_as_object_method($self);

    return unless $self-&gt;{&#039;use_lock&#039;} &amp;&amp; defined $self-&gt;{&#039;pid&#039;} &amp;&amp; $self-&gt;{&#039;pid&#039;} eq $$ &amp;&amp; $self-&gt;{&#039;lock&#039;};

    require Cpanel::SafeFile;
    Cpanel::SafeFile::safeclose( $self-&gt;{&#039;fh&#039;}, $self-&gt;{&#039;lock&#039;}, sub { return $self-&gt;_update_cache() } );

    $self-&gt;{&#039;fh&#039;}        = $self-&gt;{&#039;lock&#039;} = undef;
    $self-&gt;{&#039;is_locked&#039;} = 0;

    return;
}

sub abort {
    require Cpanel::Config::CpConfGuard::CORE;
    goto \&amp;Cpanel::Config::CpConfGuard::CORE::abort;
}

sub _update_cache {
    require Cpanel::Config::CpConfGuard::CORE;
    goto \&amp;Cpanel::Config::CpConfGuard::CORE::_update_cache;
}

sub _server_locale {
    require Cpanel::Config::CpConfGuard::CORE;
    goto \&amp;Cpanel::Config::CpConfGuard::CORE::_server_locale;
}

sub get_cache {

    my $cpanel_config_mtime = ( stat($Cpanel::ConfigFiles::cpanel_config_file) )[9] || 0;

    my $verbose = ( defined $Cpanel::Debug::level ? $Cpanel::Debug::level : 0 ) &gt;= 5;

    if ( $MEM_CACHE &amp;&amp; ref($MEM_CACHE) eq &#039;HASH&#039; &amp;&amp; $cpanel_config_mtime &amp;&amp; $cpanel_config_mtime == $MEM_CACHE_CPANEL_CONFIG_MTIME ) {
        Cpanel::Debug::log_info(&quot;loadcpconf memory cache hit&quot;) if $verbose;

        return ( $MEM_CACHE, 1 );
    }

    clearcache();    # Invalidate the memory cache.

    Cpanel::Debug::log_info(&quot;loadcpconf memory cache miss&quot;) if $verbose;

    my $mtime_before_read;

    if ( !$INC{&#039;Cpanel/JSON.pm&#039;} ) {
        Cpanel::Debug::log_info(&quot;Cpanel::JSON not loaded. Skipping cache load.&quot;) if $verbose;
        return ( undef, 0 );
    }
    elsif ( -e $Cpanel::ConfigFiles::cpanel_config_cache_file ) {    # No need to do -r (costs 5 additional syscalls) since we write this 0644
        $mtime_before_read = ( stat _ )[9] || 0;
    }
    else {
        Cpanel::Debug::log_info(&quot;The cache file “$Cpanel::ConfigFiles::cpanel_config_cache_file” could not be read. Skipping cache load.&quot;) if $verbose;
        return ( undef, 0 );
    }

    my ( $mtime_after_read, $cpconf_ref ) = (0);

    my $loop_count = 0;
    while ( $mtime_after_read != $mtime_before_read &amp;&amp; $loop_count++ &lt; 10 ) {
        sleep 1 if ( $mtime_after_read == time );    # If it was just written to, give it a second in case it&#039;s being written to.

        Cpanel::Debug::log_info( &quot;loadcpconf cache_filesys_mtime = $mtime_before_read , filesys_mtime: $cpanel_config_mtime , memory_mtime: $MEM_CACHE_CPANEL_CONFIG_MTIME , now: &quot; . time ) if $verbose;

        $cpconf_ref       = Cpanel::JSON::FailOK::LoadFile($Cpanel::ConfigFiles::cpanel_config_cache_file);
        $mtime_after_read = ( stat($Cpanel::ConfigFiles::cpanel_config_cache_file) )[9] || 0;

        sleep 1 if ( $mtime_after_read != $mtime_before_read );
    }

    if ( $cpconf_ref &amp;&amp; scalar keys %{$cpconf_ref} ) {
        if ( _cache_is_valid( $cpanel_config_mtime, $mtime_after_read ) ) {
            Cpanel::Debug::log_info(&quot;loadcpconf file system cache hit&quot;) if $verbose;

            ( $MEM_CACHE, $MEM_CACHE_CPANEL_CONFIG_MTIME ) = ( $cpconf_ref, $cpanel_config_mtime );
            return ( $cpconf_ref, 1 );
        }
        Cpanel::Debug::log_info(&quot;loadcpconf cpanel.config.cache miss.&quot;) if $verbose;
        return ( $cpconf_ref, 0 );
    }

    Cpanel::Debug::log_info(&quot;loadcpconf cpanel.config.cache miss.&quot;) if $verbose;
    return ( undef, 0 );
}

sub _cache_is_valid {
    my ( $config_mtime, $cache_mtime ) = @_;

    $cache_mtime ||= ( stat($Cpanel::ConfigFiles::cpanel_config_cache_file) )[9] || 0;
    return 0 unless $cache_mtime;

    $config_mtime ||= ( stat($Cpanel::ConfigFiles::cpanel_config_file) )[9] || 0;
    return 0 unless $config_mtime;

    return ( $config_mtime + 1 == $cache_mtime ) ? 1 : 0;
}

sub load_cpconf_file {
    my ($self) = @_;

    if ($IN_LOAD) {
        require Cpanel::Carp;
        die Cpanel::Carp::safe_longmess(&quot;Load loop detected&quot;);
    }

    local $IN_LOAD = 1;

    _verify_called_as_object_method($self);

    my $config = {};

    my $config_file = $Cpanel::ConfigFiles::cpanel_config_file;

    $self-&gt;{&#039;is_missing&#039;} = ( -e $config_file ) ? 0 : 1;

    return if ( !$self-&gt;{&#039;use_lock&#039;} &amp;&amp; $self-&gt;{&#039;is_missing&#039;} );    # We can&#039;t do anything if the file is missing and we&#039;re not root. ABORT!

    if ( $self-&gt;{&#039;use_lock&#039;} &amp;&amp; $self-&gt;{&#039;is_missing&#039;} ) {
        if ( open( my $touch_fh, &#039;&gt;&gt;&#039;, $config_file ) ) {
            print {$touch_fh} &#039;&#039;;
            close $touch_fh;
            chown 0, 0, $config_file;    # avoid pulling in Cpanel::PwCache for memory reasons
            chmod 0644, $config_file;
        }
    }

    $self-&gt;{&#039;rw&#039;} = 0;
    $self-&gt;{&#039;rw&#039;} = 1 if ( $self-&gt;{&#039;use_lock&#039;} &amp;&amp; !$self-&gt;{&#039;cache_is_valid&#039;} );

    require Cpanel::Config::LoadConfig;
    my ( $ref, $fh, $conflock, $err ) = Cpanel::Config::LoadConfig::loadConfig(
        $Cpanel::ConfigFiles::cpanel_config_file,
        $config,

        (undef) x 4,
        {
            &#039;keep_locked_open&#039;   =&gt; !!$self-&gt;{&#039;use_lock&#039;},
            &#039;nocache&#039;            =&gt; 1,
            &#039;rw&#039;                 =&gt; $self-&gt;{&#039;rw&#039;},
            &#039;allow_undef_values&#039; =&gt; 1,
        },
    );

    if ( !$ref &amp;&amp; !$fh &amp;&amp; $! != _ENOENT() ) {
        $err ||= &#039;(unknown error)&#039;;
        require Cpanel::Carp;
        die Cpanel::Carp::safe_longmess(&quot;Can’t read “$Cpanel::ConfigFiles::cpanel_config_file” ($err)&quot;);
    }

    $self-&gt;{&#039;fh&#039;}   = $fh;
    $self-&gt;{&#039;lock&#039;} = $conflock;
    $self-&gt;{&#039;data&#039;} = $config;

    if ( $self-&gt;{&#039;use_lock&#039;} ) {
        Cpanel::Debug::log_warn(&quot;Failed to establish lock on $Cpanel::ConfigFiles::cpanel_config_file&quot;) unless $self-&gt;{&#039;lock&#039;};

        Cpanel::Debug::log_warn(&quot;Failed to get file handle for $Cpanel::ConfigFiles::cpanel_config_file&quot;) unless $self-&gt;{&#039;fh&#039;};
    }

    $self-&gt;{&#039;is_locked&#039;} = defined $self-&gt;{&#039;lock&#039;} ? 1 : 0;    # alias for external usage

    if ( !$MEM_CACHE ) {
        $MEM_CACHE  = {};
        %$MEM_CACHE = %$config;
    }

    return;
}

sub _verify_called_as_object_method {
    if ( ref( $_[0] ) ne __PACKAGE__ ) {
        die &#039;&#039; . ( caller(0) )[3] . &quot; was not called as an object method [&quot; . ref( $_[0] ) . &quot;]\n&quot;;
    }
    return;
}

sub DESTROY {    ## no critic(RequireArgUnpacking)
    return 1 if ( $&gt;     || $memory_only );        # Special modes we don&#039;t or won&#039;t write to cpanel.config files.
    return 2 if ( !$_[0] || !keys %{ $_[0] } );    # Nothing to cleanup if we&#039;re just a blessed empty hash.

    return if !$_[0]-&gt;{&#039;lock&#039;};

    return if Cpanel::Destruct::in_dangerous_global_destruction();

    $_[0]-&gt;release_lock();                         # Close the file so we can update the cache properly.
    return;
}

1;

} # --- END Cpanel/Config/CpConfGuard.pm


{ # --- BEGIN Cpanel/Config/LoadCpConf.pm
package Cpanel::Config::LoadCpConf;


use strict;
use warnings;
no warnings &#039;once&#039;;


# use Cpanel::Config::CpConfGuard (); # perlpkg line 211


sub loadcpconf {
    my $cpconf = Cpanel::Config::CpConfGuard-&gt;new( &#039;loadcpconf&#039; =&gt; 1 )-&gt;config_copy;
    return wantarray ? %$cpconf : $cpconf;
}


sub loadcpconf_not_copy {

    if ( !defined $Cpanel::Config::CpConfGuard::memory_only &amp;&amp; $Cpanel::Config::CpConfGuard::MEM_CACHE_CPANEL_CONFIG_MTIME ) {
        my ( $cache, $cache_is_valid ) = Cpanel::Config::CpConfGuard::get_cache();
        if ($cache_is_valid) {
            return wantarray ? %$cache : $cache;
        }
    }

    my $cpconf_obj = Cpanel::Config::CpConfGuard-&gt;new( &#039;loadcpconf&#039; =&gt; 1 );
    my $cpconf     = $cpconf_obj-&gt;{&#039;data&#039;} || $cpconf_obj-&gt;{&#039;cache&#039;} || {};
    return wantarray ? %$cpconf : $cpconf;
}

sub clearcache;
*clearcache = *Cpanel::Config::CpConfGuard::clearcache;

1;

} # --- END Cpanel/Config/LoadCpConf.pm


{ # --- BEGIN Cpanel/Maxmem.pm
package Cpanel::Maxmem;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Config::LoadUserDomains::Count (); # perlpkg line 211

use constant _INITIAL_DEFAULT =&gt; 4096;

sub _count_domains {

    return eval { Cpanel::Config::LoadUserDomains::Count::countuserdomains() } // 1;
}


sub minimum {
    return _INITIAL_DEFAULT() * ( 1 + int( _count_domains() / 10_000 ) );
}


*default = *minimum;

1;

} # --- END Cpanel/Maxmem.pm


{ # --- BEGIN Cpanel/OSSys/Bits.pm
package Cpanel::OSSys::Bits;


use strict;
use warnings;
no warnings &#039;once&#039;;

our $MAX_32_BIT_SIGNED;
our $MAX_32_BIT_UNSIGNED;
our $MAX_64_BIT_SIGNED;
our $MAX_64_BIT_UNSIGNED;

our $MAX_NATIVE_SIGNED;
our $MAX_NATIVE_UNSIGNED;

sub getbits {
    return length( pack( &#039;l!&#039;, 1000 ) ) * 8;
}

BEGIN {
    $MAX_32_BIT_UNSIGNED = ( 1 &lt;&lt; 32 ) - 1;
    $MAX_32_BIT_SIGNED   = ( 1 &lt;&lt; 31 ) - 1;

    $MAX_64_BIT_UNSIGNED = ~0;         #true on both 32- and 64-bit systems
    $MAX_64_BIT_SIGNED   = -1 &gt;&gt; 1;    #true on both 32- and 64-bit systems

    if ( getbits() == 32 ) {
        $MAX_NATIVE_SIGNED   = $MAX_32_BIT_SIGNED;
        $MAX_NATIVE_UNSIGNED = $MAX_32_BIT_UNSIGNED;
    }
    else {
        $MAX_NATIVE_SIGNED   = $MAX_64_BIT_SIGNED;
        $MAX_NATIVE_UNSIGNED = $MAX_64_BIT_UNSIGNED;
    }
}

1;

} # --- END Cpanel/OSSys/Bits.pm


{ # --- BEGIN Cpanel/Sys/Rlimit.pm
package Cpanel::Sys::Rlimit;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::OSSys::Bits (); # perlpkg line 211
# use Cpanel::Pack        (); # perlpkg line 211
# use Cpanel::Syscall     (); # perlpkg line 211

my $SYS_getrlimit;
my $SYS_setrlimit;

our $RLIM_INFINITY;    # denotes no limit on a resource
our %RLIMITS = (
    &#039;CPU&#039;    =&gt; 0,    # CPU time limit in seconds.
    &#039;DATA&#039;   =&gt; 2,    # The maximum size of the process&#039;s data segment
    &#039;CORE&#039;   =&gt; 4,    # Maximum size of a core file
    &#039;RSS&#039;    =&gt; 5,    # Specifies the limit (in pages) of the process&#039;s resident set
    &#039;NPROC&#039;  =&gt; 6,    # The maximum number of processes
    &#039;NOFILE&#039; =&gt; 7,    # The maximum number of file descriptors
    &#039;AS&#039;     =&gt; 9,    # The maximum size of the process&#039;s virtual memory

    &#039;FSIZE&#039;      =&gt; 1,
    &#039;STACK&#039;      =&gt; 3,
    &#039;MEMLOCK&#039;    =&gt; 8,
    &#039;LOCKS&#039;      =&gt; 10,
    &#039;SIGPENDING&#039; =&gt; 11,
    &#039;MSGQUEUE&#039;   =&gt; 12,
    &#039;NICE&#039;       =&gt; 13,
    &#039;RTPRIO&#039;     =&gt; 14,
    &#039;RTTIME&#039;     =&gt; 15,
);


BEGIN {
    $RLIM_INFINITY = $Cpanel::OSSys::Bits::MAX_NATIVE_UNSIGNED;
}

our $PACK_TEMPLATE = &#039;L!L!&#039;;
our @TEMPLATE      = (
    rlim_cur =&gt; &#039;L!&#039;,    # unsigned long
    rlim_max =&gt; &#039;L!&#039;,    # unsigned long
);


sub getrlimit {
    my ($rlimit) = @_;
    local $!;

    die &quot;getrlimit requires an rlimit constant&quot; if !defined $rlimit;
    my $buffer = pack( $PACK_TEMPLATE, 0 );

    my $rlimit_num = _rlimit_to_num($rlimit);

    Cpanel::Syscall::syscall( &#039;getrlimit&#039;, $rlimit_num, $buffer );

    my $getrlimit_hr = Cpanel::Pack-&gt;new( \@TEMPLATE )-&gt;unpack_to_hashref($buffer);
    return ( $getrlimit_hr-&gt;{&#039;rlim_cur&#039;}, $getrlimit_hr-&gt;{&#039;rlim_max&#039;} );
}

sub setrlimit {
    my ( $rlimit, $soft, $hard ) = @_;
    local $!;

    die &quot;setrlimit requires an rlimit constant&quot; if !defined $rlimit;
    die &quot;setrlimit requires a soft limit&quot;       if !defined $soft;
    die &quot;setrlimit requires a hard limit&quot;       if !defined $hard;

    my $buffer = pack( $PACK_TEMPLATE, $soft, $hard );

    my $rlimit_num = _rlimit_to_num($rlimit);
    Cpanel::Syscall::syscall( &#039;setrlimit&#039;, $rlimit_num, $buffer );

    return 1;
}

sub _rlimit_to_num {
    my ($rlimit) = @_;

    if ( length($rlimit) &amp;&amp; $rlimit !~ tr&lt;0-9&gt;&lt;&gt;c ) {
        return $rlimit;
    }
    elsif ( exists $RLIMITS{$rlimit} ) {
        return $RLIMITS{$rlimit};
    }

    die &quot;Unknown RLIMIT: $rlimit&quot;;

}

1;

} # --- END Cpanel/Sys/Rlimit.pm


{ # --- BEGIN Cpanel/Rlimit.pm
package Cpanel::Rlimit;


use strict;
# use Cpanel::Config::LoadCpConf (); # perlpkg line 211
# use Cpanel::Maxmem             (); # perlpkg line 211
# use Cpanel::Sys::Rlimit        (); # perlpkg line 211


sub set_rlimit {
    my ( $limit,          $limit_names )          = @_;
    my ( $default_rlimit, $coredump_are_enabled ) = _get_server_setting_or_default();

    $limit       ||= $default_rlimit || $Cpanel::Sys::Rlimit::RLIM_INFINITY;
    $limit_names ||= [qw/RSS AS/];
    my $core_limit = $coredump_are_enabled ? $limit : 0;

    if ( $limit &gt; $Cpanel::Sys::Rlimit::RLIM_INFINITY ) {
        require Cpanel::Logger;
        Cpanel::Logger-&gt;new-&gt;warn(&quot;set_rlimit adjusted the requested limit of “$limit” to infinity because it exceeded the maximum allowed value.&quot;);
        $limit = $Cpanel::Sys::Rlimit::RLIM_INFINITY;
    }
    my $error = &#039;&#039;;

    foreach my $lim (@$limit_names) {
        local $@;
        eval { Cpanel::Sys::Rlimit::setrlimit( $lim, $limit, $limit ) } or do {
            my $limit_human_value = ( $limit == $Cpanel::Sys::Rlimit::RLIM_INFINITY ? &#039;INFINITY&#039; : $limit );
            $error .= &quot;$$: Unable to set RLIMIT_$lim to $limit_human_value: $@\n&quot;;
        }
    }
    local $@;
    eval { Cpanel::Sys::Rlimit::setrlimit( &#039;CORE&#039;, $core_limit, $core_limit ) }
      or $error .= &quot;$$: Unable to set RLIMIT_CORE to $core_limit: $@\n&quot;;

    if ($error) {
        $error =~ s/\n$//;
        require Cpanel::Logger;
        Cpanel::Logger-&gt;new-&gt;warn($error);
        return 0;
    }

    return 1;
}

sub set_min_rlimit {
    my ($min) = @_;

    my $error = &#039;&#039;;
    foreach my $lim (qw(RSS AS)) {
        my ( $current_soft, $current_hard ) = Cpanel::Sys::Rlimit::getrlimit($lim);
        if ( $current_soft &lt; $min || $current_hard &lt; $min ) {
            local $@;
            eval { Cpanel::Sys::Rlimit::setrlimit( $lim, $min, $min ) } or $error .= &quot;$$: Unable to set RLIMIT_$lim to $min: $@\n&quot;;
        }
    }

    if ($error) {
        $error =~ s/\n$//;
        require Cpanel::Logger;
        Cpanel::Logger-&gt;new-&gt;warn($error);
        return 0;
    }

    return 1;
}

sub get_current_rlimits {
    return { map { $_ =&gt; [ Cpanel::Sys::Rlimit::getrlimit($_) ] } (qw(RSS AS CORE)) };
}

sub restore_rlimits {
    my $limit_hr = shift;
    my $error    = &#039;&#039;;
    if ( ref $limit_hr eq &#039;HASH&#039; ) {
        foreach my $resource_name ( keys %{$limit_hr} ) {
            my $values = $limit_hr-&gt;{$resource_name};
            if ( ref $values ne &#039;ARRAY&#039; || scalar @{$values} != 2 ) {
                $error .= &quot;Invalid limit arguments, could not restore resource limit for $resource_name.\n&quot;;
                next;
            }
            local $@;
            eval { Cpanel::Sys::Rlimit::setrlimit( $resource_name, $values-&gt;[0], $values-&gt;[1] ) }
              or $error .= &quot;$$: Unable to set $resource_name to $values-&gt;[0] and $values-&gt;[1]: $@\n&quot;;
        }
    }
    else {
        $error .= &quot;Invalid arguments, could not restore resource limits.\n&quot;;
    }
    if ($error) {
        $error =~ s/\n$//;
        require Cpanel::Logger;
        Cpanel::Logger-&gt;new-&gt;warn($error);
        return 0;
    }
    return 1;
}

sub set_rlimit_to_infinity {
    return set_rlimit($Cpanel::Sys::Rlimit::RLIM_INFINITY);
}

sub set_open_files_to_maximum {
    my $limit = 1048576;
    if ( open( my $fh, &#039;&lt;&#039;, &#039;/proc/sys/fs/nr_open&#039; ) ) {
        $limit = &lt;$fh&gt;;
        chomp($limit);
        close($fh);
    }
    return set_rlimit( $limit, [qw/NOFILE/] );
}

sub _get_server_setting_or_default {
    my $cpconf             = Cpanel::Config::LoadCpConf::loadcpconf_not_copy();
    my $default_maxmem     = Cpanel::Maxmem::default();
    my $core_dumps_enabled = $cpconf-&gt;{&#039;coredump&#039;};
    my $configured_maxmem  = exists $cpconf-&gt;{&#039;maxmem&#039;} ? int( $cpconf-&gt;{&#039;maxmem&#039;} || 0 ) : $default_maxmem;

    if ( $configured_maxmem &amp;&amp; $configured_maxmem &lt; $default_maxmem ) {
        return ( _mebibytes_to_bytes($default_maxmem), $core_dumps_enabled );
    }
    elsif ( $configured_maxmem == 0 ) {
        return ( $Cpanel::Sys::Rlimit::RLIM_INFINITY, $core_dumps_enabled );
    }
    else {
        return ( _mebibytes_to_bytes($configured_maxmem), $core_dumps_enabled );
    }
}

sub _mebibytes_to_bytes {
    my $mebibytes = shift;
    return ( $mebibytes * 1024**2 );
}

1;

} # --- END Cpanel/Rlimit.pm


{ # --- BEGIN Cpanel/LocaleString.pm
package Cpanel::LocaleString;


use strict;
use warnings;
no warnings &#039;once&#039;;

sub DESTROY { }


sub new {

    if ( !length $_[1] ) {
        die &#039;Must include at least a string!&#039;;
    }

    return bless \@_, shift;
}


sub set_json_to_freeze {
    no warnings &#039;redefine&#039;;
    *TO_JSON = \&amp;_to_list_ref;
    return ( __PACKAGE__ . &#039;::_JSON_MODE&#039; )-&gt;new();
}


sub thaw {

    if ( ref( $_[1] ) ne &#039;ARRAY&#039; ) {
        die &quot;Call thaw() on an ARRAY reference, not “$_[1]”!&quot;;
    }

    return $_[0]-&gt;new( @{ $_[1] }[ 1 .. $#{ $_[1] } ] );
}


sub is_frozen {
    {
        last if ref( $_[1] ) ne &#039;ARRAY&#039;;
        last if !$_[1][0]-&gt;isa( $_[0] );
        last if @{ $_[1] } &lt; 2;

        return 1;
    }

    return 0;
}


sub to_string {
    return _locale()-&gt;makevar( @{ $_[0] } );
}


sub to_en_string {
    return _locale()-&gt;makethis_base( @{ $_[0] } );
}


sub clone_with_args {
    return ( ref $_[0] )-&gt;new(
        $_[0][0],          #the phrase, currently stored in the object
        @_[ 1 .. $#_ ],    #the new args, supplied by the caller
    );
}


sub to_list {

    if ( !wantarray ) {
        require Cpanel::Context;
        Cpanel::Context::must_be_list();
    }

    return @{ $_[0] };
}

*TO_JSON = \&amp;to_string;


my $_locale;

sub _locale {
    return $_locale if $_locale;
    local $@;

    eval &#039;require Cpanel::Locale;&#039; or do {    ## no critic qw(BuiltinFunctions::ProhibitStringyEval)
        warn &quot;Failed to load Cpanel::Locale; falling back to substitute. Error was: $@&quot;;
    };

    eval { $_locale = Cpanel::Locale-&gt;get_handle() };
    return $_locale || bless {}, &#039;Cpanel::LocaleString::_Cpanel_Locale_unavailable&#039;;
}

sub _put_back {
    no warnings &#039;redefine&#039;;
    *TO_JSON = \&amp;to_string;

    return;
}

sub _to_list_ref {
    return [ ref( $_[0] ), @{ $_[0] } ];
}


package Cpanel::LocaleString::_JSON_MODE;


sub new {
    require Cpanel::Finally;    # PPI USE OK - loaded only when needed
    return $_[0]-&gt;SUPER::new( \&amp;Cpanel::LocaleString::_put_back );
}

package Cpanel::LocaleString::_Cpanel_Locale_unavailable;

BEGIN {
    *Cpanel::LocaleString::_Cpanel_Locale_unavailable::makethis_base = *Cpanel::LocaleString::_Cpanel_Locale_unavailable::makevar;
}

sub makevar {
    my ( $self, $str, @maketext_opts ) = @_;

    local ( $@, $! );
    require Cpanel::Locale::Utils::Fallback;

    return Cpanel::Locale::Utils::Fallback::interpolate_variables( $str, @maketext_opts );
}

1;

} # --- END Cpanel/LocaleString.pm


{ # --- BEGIN Cpanel/Errno.pm
package Cpanel::Errno;


use strict;

my %_err_name_cache;

sub get_name_for_errno_number {
    my ($number) = @_;

    if ( !$INC{&#039;Errno.pm&#039;} ) {
        local ( $@, $! );
        require Errno;
    }

    die &#039;need number!&#039; if !length $number;

    if ( !%_err_name_cache ) {

        my $s = scalar keys %Errno::;    # init iterator
        foreach my $k ( sort keys %Errno:: ) {
            if ( Errno-&gt;EXISTS($k) ) {
                my $v = &#039;Errno&#039;-&gt;can($k)-&gt;();
                $_err_name_cache{$v} = $k;
            }
        }
    }

    return $_err_name_cache{$number};
}

1;

} # --- END Cpanel/Errno.pm


{ # --- BEGIN Cpanel/Config/Constants/Perl.pm
package Cpanel::Config::Constants::Perl;


use strict;

our $ABRT   = 6;
our $ALRM   = 14;
our $BUS    = 7;
our $CHLD   = 17;
our $CLD    = 17;
our $CONT   = 18;
our $FPE    = 8;
our $HUP    = 1;
our $ILL    = 4;
our $INT    = 2;
our $IO     = 29;
our $IOT    = 6;
our $KILL   = 9;
our $NUM32  = 32;
our $NUM33  = 33;
our $NUM35  = 35;
our $NUM36  = 36;
our $NUM37  = 37;
our $NUM38  = 38;
our $NUM39  = 39;
our $NUM40  = 40;
our $NUM41  = 41;
our $NUM42  = 42;
our $NUM43  = 43;
our $NUM44  = 44;
our $NUM45  = 45;
our $NUM46  = 46;
our $NUM47  = 47;
our $NUM48  = 48;
our $NUM49  = 49;
our $NUM50  = 50;
our $NUM51  = 51;
our $NUM52  = 52;
our $NUM53  = 53;
our $NUM54  = 54;
our $NUM55  = 55;
our $NUM56  = 56;
our $NUM57  = 57;
our $NUM58  = 58;
our $NUM59  = 59;
our $NUM60  = 60;
our $NUM61  = 61;
our $NUM62  = 62;
our $NUM63  = 63;
our $PIPE   = 13;
our $POLL   = 29;
our $PROF   = 27;
our $PWR    = 30;
our $QUIT   = 3;
our $RTMAX  = 64;
our $RTMIN  = 34;
our $SEGV   = 11;
our $STKFLT = 16;
our $STOP   = 19;
our $SYS    = 31;
our $TERM   = 15;
our $TRAP   = 5;
our $TSTP   = 20;
our $TTIN   = 21;
our $TTOU   = 22;
our $UNUSED = 31;
our $URG    = 23;
our $USR1   = 10;
our $USR2   = 12;
our $VTALRM = 26;
our $WINCH  = 28;
our $XCPU   = 24;
our $XFSZ   = 25;
our $ZERO   = 0;

our %SIGNAL_NAME = qw(
  0    ZERO
  1    HUP
  10    USR1
  11    SEGV
  12    USR2
  13    PIPE
  14    ALRM
  15    TERM
  16    STKFLT
  17    CHLD
  18    CONT
  19    STOP
  2    INT
  20    TSTP
  21    TTIN
  22    TTOU
  23    URG
  24    XCPU
  25    XFSZ
  26    VTALRM
  27    PROF
  28    WINCH
  29    IO
  3    QUIT
  30    PWR
  31    SYS
  32    NUM32
  33    NUM33
  34    RTMIN
  35    NUM35
  36    NUM36
  37    NUM37
  38    NUM38
  39    NUM39
  4    ILL
  40    NUM40
  41    NUM41
  42    NUM42
  43    NUM43
  44    NUM44
  45    NUM45
  46    NUM46
  47    NUM47
  48    NUM48
  49    NUM49
  5    TRAP
  50    NUM50
  51    NUM51
  52    NUM52
  53    NUM53
  54    NUM54
  55    NUM55
  56    NUM56
  57    NUM57
  58    NUM58
  59    NUM59
  6    ABRT
  60    NUM60
  61    NUM61
  62    NUM62
  63    NUM63
  64    RTMAX
  7    BUS
  8    FPE
  9    KILL
);

1;

} # --- END Cpanel/Config/Constants/Perl.pm


{ # --- BEGIN Cpanel/ChildErrorStringifier.pm
package Cpanel::ChildErrorStringifier;


use strict;

# use Cpanel::LocaleString (); # perlpkg line 211
# use Cpanel::Exception    (); # perlpkg line 211


sub new {
    my ( $class, $CHILD_ERROR, $PROGRAM_NAME ) = @_;

    return bless { _CHILD_ERROR =&gt; $CHILD_ERROR, _PROGRAM_NAME =&gt; $PROGRAM_NAME }, $class;
}

sub CHILD_ERROR {
    my ($self) = @_;

    return $self-&gt;{&#039;_CHILD_ERROR&#039;};
}

sub error_code {
    my ($self) = @_;

    return undef if !$self-&gt;CHILD_ERROR();

    return $self-&gt;CHILD_ERROR() &gt;&gt; 8;
}


sub error_name {
    my ($self) = @_;

    my $error_number = $self-&gt;error_code();

    return &#039;&#039; if ( !defined $error_number );    # Can&#039;t index a hash with undef

    require Cpanel::Errno;
    return Cpanel::Errno::get_name_for_errno_number($error_number) || q&lt;&gt;;
}

sub dumped_core {
    my ($self) = @_;

    return $self-&gt;CHILD_ERROR() &amp;&amp; ( $self-&gt;CHILD_ERROR() &amp; 128 ) ? 1 : 0;
}

sub signal_code {
    my ($self) = @_;

    return if !$self-&gt;CHILD_ERROR();

    return $self-&gt;CHILD_ERROR() &amp; 127;
}

sub signal_name {
    my ($self) = @_;
    require Cpanel::Config::Constants::Perl;
    return $Cpanel::Config::Constants::Perl::SIGNAL_NAME{ $self-&gt;signal_code() };
}

sub exec_failed {
    return $_[0]-&gt;{&#039;_exec_failed&#039;} ? 1 : 0;
}

sub program {
    my ($self) = @_;

    return $self-&gt;{&#039;_PROGRAM_NAME&#039;} || undef;
}

sub set_program {
    my ( $self, $program ) = @_;

    return ( $self-&gt;{&#039;_PROGRAM_NAME&#039;} = $program );
}

sub autopsy {
    my ($self) = @_;

    return undef if !$self-&gt;CHILD_ERROR();

    my @localized_strings = (
        $self-&gt;error_code() ? $self-&gt;_ERROR_PHRASE() : $self-&gt;_SIGNAL_PHRASE(),
        $self-&gt;_core_dump_for_phrase_if_needed(),
        $self-&gt;_additional_phrases_for_autopsy(),
    );

    return join &#039; &#039;, map { $_-&gt;to_string() } @localized_strings;
}

sub terse_autopsy {
    my ($self) = @_;

    my $str;

    if ( $self-&gt;signal_code() ) {
        $str .= &#039;SIG&#039; . $self-&gt;signal_name() . &quot; (#&quot; . $self-&gt;signal_code() . &quot;)&quot;;
    }
    elsif ( my $code = $self-&gt;error_code() ) {
        $str .= &quot;exit $code&quot;;
    }
    else {
        $str = &#039;OK&#039;;
    }

    if ( $self-&gt;dumped_core() ) {
        $str .= &#039; (+core)&#039;;
    }

    return $str;
}

sub die_if_error {
    my ($self) = @_;

    my $err = $self-&gt;to_exception();
    die $err if $err;

    return $self;
}

sub to_exception {
    my ($self) = @_;

    if ( $self-&gt;signal_code() ) {
        return Cpanel::Exception::create(
            &#039;ProcessFailed::Signal&#039;,
            [
                process_name =&gt; $self-&gt;program(),
                signal_code  =&gt; $self-&gt;signal_code(),
                $self-&gt;_extra_error_args_for_die_if_error(),
            ],
        );
    }

    if ( $self-&gt;error_code() ) {
        return Cpanel::Exception::create(
            &#039;ProcessFailed::Error&#039;,
            [
                process_name =&gt; $self-&gt;program(),
                error_code   =&gt; $self-&gt;error_code(),
                $self-&gt;_extra_error_args_for_die_if_error(),
            ],
        );
    }

    return undef;
}

sub _extra_error_args_for_die_if_error { }

sub _additional_phrases_for_autopsy { }

sub _core_dump_for_phrase_if_needed {
    my ($self) = @_;

    if ( $self-&gt;dumped_core() ) {
        return Cpanel::LocaleString-&gt;new(&#039;The process dumped a core file.&#039;);
    }

    return;
}


sub _ERROR_PHRASE {
    my ($self) = @_;

    if ( $self-&gt;program() ) {
        return Cpanel::LocaleString-&gt;new( &#039;The subprocess “[_1]” reported error number [numf,_2] when it ended.&#039;, $self-&gt;program(), $self-&gt;error_code() );
    }

    return Cpanel::LocaleString-&gt;new( &#039;The subprocess reported error number [numf,_1] when it ended.&#039;, $self-&gt;error_code() );
}

sub _SIGNAL_PHRASE {
    my ($self) = @_;

    if ( $self-&gt;program() ) {
        return Cpanel::LocaleString-&gt;new( &#039;The subprocess “[_1]” ended prematurely because it received the “[_2]” ([_3]) signal.&#039;, $self-&gt;program(), $self-&gt;signal_name(), $self-&gt;signal_code() );
    }

    return Cpanel::LocaleString-&gt;new( &#039;The subprocess ended prematurely because it received the “[_1]” ([_2]) signal.&#039;, $self-&gt;signal_name(), $self-&gt;signal_code() );
}


1;

} # --- END Cpanel/ChildErrorStringifier.pm


{ # --- BEGIN Cpanel/FHUtils/OS.pm
package Cpanel::FHUtils::OS;


use strict;
use warnings;
no warnings &#039;once&#039;;


my $fileno;

sub is_os_filehandle {
    local $@;
    $fileno = eval { fileno $_[0] };
    return ( defined $fileno ) &amp;&amp; ( $fileno != -1 );
}

1;

} # --- END Cpanel/FHUtils/OS.pm


{ # --- BEGIN Cpanel/FHUtils/Blocking.pm
package Cpanel::FHUtils::Blocking;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Fcntl::Constants (); # perlpkg line 211
# use Cpanel::Autodie          qw(fcntl); # perlpkg line 248
INIT { Cpanel::Autodie-&gt;import(qw{fcntl}); }

sub set_non_blocking {
    return Cpanel::Autodie::fcntl( $_[0], $Cpanel::Fcntl::Constants::F_SETFL, _get_fl_flags( $_[0] ) | $Cpanel::Fcntl::Constants::O_NONBLOCK ) &amp;&amp; 1;
}

sub set_blocking {
    return Cpanel::Autodie::fcntl( $_[0], $Cpanel::Fcntl::Constants::F_SETFL, _get_fl_flags( $_[0] ) &amp; ~$Cpanel::Fcntl::Constants::O_NONBLOCK ) &amp;&amp; 1;
}

sub is_set_to_block {
    return !( _get_fl_flags( $_[0] ) &amp; $Cpanel::Fcntl::Constants::O_NONBLOCK ) ? 1 : 0;
}

sub _get_fl_flags {

    return int Cpanel::Autodie::fcntl( $_[0], $Cpanel::Fcntl::Constants::F_GETFL, 0 );
}

1;

} # --- END Cpanel/FHUtils/Blocking.pm


{ # --- BEGIN Cpanel/IO/Flush.pm
package Cpanel::IO::Flush;


use strict;
use warnings;
no warnings &#039;once&#039;;


use constant {
    _EAGAIN =&gt; 11,
    _EINTR  =&gt; 4,
};

# use Cpanel::Exception (); # perlpkg line 211
use IO::SigGuard      ();


sub write_all {    ##no critic qw( RequireArgUnpacking )
    my ( $fh, $timeout ) = @_;    # $_[2] = payload

    local ( $!, $^E );

    my $offset = 0;

    {
        my $this_time = IO::SigGuard::syswrite( $fh, $_[2], length( $_[2] ), $offset );
        if ($this_time) {
            $offset += $this_time;
        }
        elsif ( $! == _EAGAIN() ) {
            _wait_until_ready( $fh, $timeout );
        }
        else {
            die Cpanel::Exception::create( &#039;IO::WriteError&#039;, [ error =&gt; $!, length =&gt; length( $_[2] ) - $offset ] );
        }

        redo if $offset &lt; length( $_[2] );
    }

    return;
}

sub _wait_until_ready {
    my ( $fh, $timeout ) = @_;

    my $win;
    vec( $win, fileno($fh), 1 ) = 1;

    my $ready = select( undef, my $wout = $win, undef, $timeout );

    if ( $ready == -1 ) {
        redo if $! == _EINTR();
        die Cpanel::Exception::create( &#039;IO::SelectError&#039;, [ error =&gt; $! ] );
    }
    elsif ( !$ready ) {

        die Cpanel::Exception::create_raw( &#039;Timeout&#039;, &#039;write timeout!&#039; );
    }

    return;
}

1;

} # --- END Cpanel/IO/Flush.pm


{ # --- BEGIN Cpanel/ReadMultipleFH.pm
package Cpanel::ReadMultipleFH;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::FHUtils::Blocking  (); # perlpkg line 211
# use Cpanel::FHUtils::OS        (); # perlpkg line 211
# use Cpanel::IO::Flush          (); # perlpkg line 211
# use Cpanel::LoadFile::ReadFast (); # perlpkg line 211

my $CHUNK_SIZE = 2 &lt;&lt; 16;

my $DEFAULT_TIMEOUT      = 600;    #10 minutes
my $DEFAULT_READ_TIMEOUT = 0;

sub new {    ## no critic qw(Subroutines::ProhibitExcessComplexity)
    my ( $class, %opts ) = @_;

    my %fh_buffer;
    my %output;

    my @fhs = @{ $opts{&#039;filehandles&#039;} };

    my $read_input  = &#039;&#039;;
    my $read_output = &#039;&#039;;
    my %fhmap;

    my %is_os_filehandle;

    for my $fh_buf_ar (@fhs) {
        if ( UNIVERSAL::isa( $fh_buf_ar, &#039;GLOB&#039; ) ) {
            $fh_buf_ar = [$fh_buf_ar];
        }
        elsif ( !UNIVERSAL::isa( $fh_buf_ar, &#039;ARRAY&#039; ) ) {
            die &#039;items in “filehandles” must be either a filehandle or ARRAY&#039;;
        }

        my $fh = $fh_buf_ar-&gt;[0];

        Cpanel::FHUtils::Blocking::set_non_blocking($fh);

        $fhmap{ fileno($fh) } = $fh;
        vec( $read_input, fileno($fh), 1 ) = 1;

        if ( defined $fh_buf_ar-&gt;[1] &amp;&amp; UNIVERSAL::isa( $fh_buf_ar-&gt;[1], &#039;SCALAR&#039; ) ) {
            $fh_buffer{$fh} = $fh_buf_ar-&gt;[1];
        }
        else {
            my $buf = q{};
            $fh_buffer{$fh} = \$buf;

            if ( defined $fh_buf_ar-&gt;[1] &amp;&amp; UNIVERSAL::isa( $fh_buf_ar-&gt;[1], &#039;GLOB&#039; ) ) {
                $output{$fh} = $fh_buf_ar-&gt;[1];

                $is_os_filehandle{$fh} = Cpanel::FHUtils::OS::is_os_filehandle( $fh_buf_ar-&gt;[1] );
            }
            elsif ( defined $fh_buf_ar-&gt;[1] ) {
                die &#039;2nd value in “filehandles” array member must be undef, SCALAR, or GLOB!&#039;;
            }
        }
    }

    my $finished;

    my $self = {
        _fh_buffer =&gt; \%fh_buffer,
        _finished  =&gt; 0,
    };

    bless $self, $class;

    my ( $nfound, $select_time_left, $select_timeout );

    my $overall_timeout = defined $opts{&#039;timeout&#039;}      ? $opts{&#039;timeout&#039;}      : $DEFAULT_TIMEOUT;
    my $read_timeout    = defined $opts{&#039;read_timeout&#039;} ? $opts{&#039;read_timeout&#039;} : $DEFAULT_READ_TIMEOUT;

    my $has_overall_timeout = $overall_timeout ? 1 : 0;

    my $overall_time_left = $overall_timeout || undef;

  READ_LOOP:
    while (
        !$finished &amp;&amp;                                          # has not finished
        ( !$has_overall_timeout || $overall_time_left &gt; 0 )    # has not reached overall timeout
    ) {
        $select_timeout = _get_shortest_timeout( $overall_time_left, $read_timeout );

        ( $nfound, $select_time_left ) = select( $read_output = $read_input, undef, undef, $select_timeout );

        if ( !$nfound ) {

            $self-&gt;{&#039;_timed_out&#039;} = ( $select_timeout == $read_timeout ) ? $read_timeout : $overall_timeout;
            last;
        }
        elsif ( $nfound != -1 ) {    # case 47309: If we get -1 it probably means we got interrupted by a signal
            for my $fileno ( grep { vec( $read_output, $_, 1 ) } keys %fhmap ) {
                my $fh = $fhmap{$fileno};

                Cpanel::LoadFile::ReadFast::read_fast( $fh, ${ $fh_buffer{$fh} }, $CHUNK_SIZE, length ${ $fh_buffer{$fh} } ) or do {
                    delete $fhmap{$fileno};

                    $finished = !( scalar keys %fhmap );

                    last READ_LOOP if $finished;

                    vec( $read_input, $fileno, 1 ) = 0;

                    next;
                };

                if ( $output{$fh} ) {
                    my $payload_sr = \substr( ${ $fh_buffer{$fh} }, 0, length ${ $fh_buffer{$fh} }, q&lt;&gt; );

                    if ( $is_os_filehandle{$fh} ) {

                        Cpanel::IO::Flush::write_all( $output{$fh}, $read_timeout, $$payload_sr );
                    }
                    else {

                        print { $output{$fh} } $$payload_sr;
                    }
                }
            }
        }

        $overall_time_left -= ( $select_timeout - $select_time_left ) if $has_overall_timeout;
    }

    delete $fh_buffer{$_} for keys %output;

    %fhmap = ();

    $self-&gt;{&#039;_finished&#039;} = $finished;
    if ( !$finished &amp;&amp; defined $overall_time_left &amp;&amp; $overall_time_left &lt;= 0 ) {

        $self-&gt;{&#039;_timed_out&#039;} = $overall_timeout;
    }

    return $self;
}

sub _get_shortest_timeout {
    my ( $overall_time_left, $read_timeout ) = @_;

    return undef if ( !$overall_time_left &amp;&amp; !$read_timeout );

    return $read_timeout if !defined $overall_time_left;

    return ( !$read_timeout || $overall_time_left &lt;= $read_timeout )
      ?

      $overall_time_left
      :

      $read_timeout;
}

sub get_buffer {
    return $_[0]-&gt;{&#039;_fh_buffer&#039;}{ $_[1] };
}

sub did_finish {
    return $_[0]-&gt;{&#039;_finished&#039;} ? 1 : 0;
}

sub timed_out {
    return defined $_[0]-&gt;{&#039;_timed_out&#039;} ? $_[0]-&gt;{&#039;_timed_out&#039;} : 0;
}

1;

} # --- END Cpanel/ReadMultipleFH.pm


{ # --- BEGIN Cpanel/ForkAsync.pm
package Cpanel::ForkAsync;


use strict;
use warnings;
no warnings &#039;once&#039;;

# use Cpanel::Exception (); # perlpkg line 211

my $DEFAULT_ERROR_CODE = 127;    #EKEYEXPIRED

our $quiet   = 0;
our $no_warn = 0;


sub do_in_child {
    my ( $code, @args ) = @_;

    local ( $!, $^E );
    my $pid = fork();

    die Cpanel::Exception::create( &#039;IO::ForkError&#039;, [ error =&gt; $! ] ) if !defined $pid;

    if ( !$pid ) {
        local $@;

        if ( !eval { $code-&gt;(@args); 1 } ) {
            my $err    = $@;
            my $io_err = 0 + $!;
            _print($err) unless $quiet;
            exit( $io_err || $DEFAULT_ERROR_CODE );
        }

        exit 0;
    }

    return $pid;
}


sub do_in_child_quiet {
    my ( $code, @args ) = @_;
    local $quiet = 1;
    return do_in_child( $code, @args );
}


sub _print {
    my ($msg) = @_;

    warn $msg unless $no_warn;
    print STDERR $msg;

    return;
}

1;

} # --- END Cpanel/ForkAsync.pm


{ # --- BEGIN Cpanel/SafeRun/Object.pm
package Cpanel::SafeRun::Object;


use cPstrict;
no warnings &#039;once&#039;;

# use parent Cpanel::ChildErrorStringifier (); # perlpkg line 238
our @ISA;
BEGIN { push @ISA, qw(Cpanel::ChildErrorStringifier); }

BEGIN {
    eval { require Proc::FastSpawn; };
}

use IO::SigGuard ();

# use Cpanel::Env                (); # perlpkg line 211
# use Cpanel::Exception          (); # perlpkg line 211
# use Cpanel::FHUtils::Autoflush (); # perlpkg line 211
# use Cpanel::FHUtils::OS        (); # perlpkg line 211
# use Cpanel::ReadMultipleFH     (); # perlpkg line 211
# use Cpanel::LoadModule         (); # perlpkg line 211
# use Cpanel::LocaleString       (); # perlpkg line 211

use constant _ENOENT =&gt; 2;

my $CHUNK_SIZE = 2 &lt;&lt; 16;

my $DEFAULT_TIMEOUT      = 3600;    # 1 hour
my $DEFAULT_READ_TIMEOUT = 0;

our $SAFEKILL_TIMEOUT = 1;


my @_allowed_env_vars_cache;

sub new {    ## no critic qw(Subroutines::ProhibitExcessComplexity)
    my ( $class, %OPTS ) = @_;

    die &quot;No “program”!&quot; if !length $OPTS{&#039;program&#039;};

    if ( !defined $OPTS{&#039;timeout&#039;} ) {
        $OPTS{&#039;timeout&#039;} = $DEFAULT_TIMEOUT;
    }

    if ( !defined $OPTS{&#039;read_timeout&#039;} ) {
        $OPTS{&#039;read_timeout&#039;} = $DEFAULT_READ_TIMEOUT;
    }

    if ( $OPTS{&#039;program&#039;} =~ tr{&gt;&lt;*?[]`$()|;&amp;#$\\\r\n\t }{} &amp;&amp; !-e $OPTS{&#039;program&#039;} ) {
        die Cpanel::Exception::create( &#039;InvalidParameter&#039;, &#039;A value of “[_1]” is invalid for “[_2]” as it does not permit the following characters: “[_3]”&#039;, [ $OPTS{&#039;program&#039;}, &#039;program&#039;, &#039;&gt;&lt;*?[]`$()|;&amp;#$\\\\\r\\n\\t&#039; ] );
    }

    my $args_ar = $OPTS{&#039;args&#039;} || [];
    die &quot;“args” must be an arrayref&quot; if defined $args_ar &amp;&amp; ref $args_ar ne &#039;ARRAY&#039;;

    die Cpanel::Exception::create( &#039;InvalidParameter&#039;, &#039;The “[_1]” argument is invalid.&#039;, [&#039;logger&#039;] ) if $OPTS{&#039;logger&#039;};

    die &quot;Undefined value given as argument! (@$args_ar)&quot; if grep { !defined } @$args_ar;

    my $pump_stdin_filehandle_into_child;

    my ( %parent_read_fh, %child_write_fh );

    my $merge_output_yn = $OPTS{&#039;stdout&#039;} &amp;&amp; $OPTS{&#039;stderr&#039;} &amp;&amp; ( $OPTS{&#039;stdout&#039;} eq $OPTS{&#039;stderr&#039;} );

    local $!;

    for my $handle_name (qw(stdout stderr)) {
        my $custom_fh = $OPTS{$handle_name} &amp;&amp; UNIVERSAL::isa( $OPTS{$handle_name}, &#039;GLOB&#039; ) &amp;&amp; $OPTS{$handle_name};

        my $dupe_filehandle_will_work = $custom_fh &amp;&amp; !tied(*$custom_fh) &amp;&amp; ( fileno($custom_fh) &gt; -1 );

        if ( !$custom_fh &amp;&amp; $OPTS{$handle_name} ) {
            die &quot;“$handle_name” must be a filehandle or undef, not $OPTS{$handle_name}&quot;;
        }

        if ($dupe_filehandle_will_work) {

            if ( fileno($custom_fh) &lt; 3 ) {
                open my $copy, &#039;&gt;&amp;&#039;, $custom_fh or die &quot;dup($handle_name): $!&quot;;
                $child_write_fh{$handle_name} = $copy;
            }
            else {
                $child_write_fh{$handle_name} = $custom_fh;
            }
        }

        elsif ( $merge_output_yn &amp;&amp; $handle_name eq &#039;stderr&#039; ) {
            $parent_read_fh{&#039;stderr&#039;} = $parent_read_fh{&#039;stdout&#039;};
            $child_write_fh{&#039;stderr&#039;} = $child_write_fh{&#039;stdout&#039;};
        }

        else {
            pipe $parent_read_fh{$handle_name}, $child_write_fh{$handle_name}    #
              or die &quot;pipe() failed: $!&quot;;
        }
    }

    my ( $child_reads, $parent_writes );
    my $close_child_reads = 0;

    if ( !defined $OPTS{&#039;stdin&#039;} || !length $OPTS{&#039;stdin&#039;} ) {
        open $child_reads, &#039;&lt;&#039;, &#039;/dev/null&#039; or die &quot;open(&lt;, /dev/null) failed: $!&quot;;
        $close_child_reads = 1;
    }
    elsif ( UNIVERSAL::isa( $OPTS{&#039;stdin&#039;}, &#039;GLOB&#039; ) ) {
        my $fileno = fileno $OPTS{&#039;stdin&#039;};

        if ( !defined $fileno || $fileno == -1 ) {
            $pump_stdin_filehandle_into_child = 1;
        }
        else {
            $child_reads = $OPTS{&#039;stdin&#039;};
        }
    }

    if ( !$child_reads ) {
        $close_child_reads = 1;
        pipe( $child_reads, $parent_writes ) or die &quot;pipe() failed: $!&quot;;
    }

    my $self = bless {
        _program =&gt; $OPTS{&#039;program&#039;},
        _args    =&gt; $OPTS{&#039;args&#039;} || [],
    }, $class;

    local $SIG{&#039;CHLD&#039;} = &#039;DEFAULT&#039;;

    my $exec_failed_message = &quot;exec($OPTS{&#039;program&#039;}) failed:&quot;;
    my $used_fastspawn      = 0;
    if (
        $INC{&#039;Proc/FastSpawn.pm&#039;}                                   # may not be available yet due to upcp.static or updatenow.static
        &amp;&amp; !$OPTS{&#039;before_exec&#039;}
        &amp;&amp; !$Cpanel::AccessIds::ReducedPrivileges::PRIVS_REDUCED    # PPI NO PARSE - We not ever be set if its not loaded
    ) {
        $used_fastspawn = 1;
        my @env;

        if ( !$OPTS{&#039;keep_env&#039;} ) {
            if ( !@_allowed_env_vars_cache ) {
                @_allowed_env_vars_cache = ( split( m{ }, Cpanel::Env::get_safe_env_vars() ) );
            }
            @env = map { exists $ENV{$_} ? ( $_ . &#039;=&#039; . ( $ENV{$_} // &#039;&#039; ) ) : () } @_allowed_env_vars_cache;
        }
        my $user    = $OPTS{&#039;user&#039;};
        my $homedir = $OPTS{&#039;homedir&#039;};
        if ( !$user || !$homedir ) {
            my ( $pw_user, $pw_homedir ) = ( getpwuid $&gt; )[ 0, 7 ];
            $user    ||= $pw_user;
            $homedir ||= $pw_homedir;
        }
        die &quot;Invalid EUID: $&gt;&quot; if !$user || !$homedir;

        push @env, &quot;HOME=$homedir&quot;,    &quot;USER=$user&quot;;                                  # need to always be set since we start clean and don&#039;t have before_exec
        push @env, &quot;TMP=$homedir/tmp&quot;, &quot;TEMP=$homedir/tmp&quot; if !defined $ENV{&#039;TMP&#039;};

        $self-&gt;{&#039;_child_pid&#039;} = Proc::FastSpawn::spawn_open3(
            fileno($child_reads),                                                            # stdin
            defined $child_write_fh{&#039;stdout&#039;} ? fileno( $child_write_fh{&#039;stdout&#039;} ) : -1,    # stdout
            defined $child_write_fh{&#039;stderr&#039;} ? fileno( $child_write_fh{&#039;stderr&#039;} ) : -1,    # stderr
            $OPTS{&#039;program&#039;},                                                                # program
            [ $OPTS{&#039;program&#039;}, @$args_ar ],                                                 # args
            $OPTS{&#039;keep_env&#039;} ? () : \@env                                                   # env
        );

        if ( !$self-&gt;{_child_pid} ) {
            $self-&gt;{&#039;_CHILD_ERROR&#039;} = $! &lt;&lt; 8;
            $self-&gt;{&#039;_exec_failed&#039;} = 1;
            ${ $self-&gt;{&#039;_stdout&#039;} } = &#039;&#039;;
            ${ $self-&gt;{&#039;_stderr&#039;} } .= &quot;$exec_failed_message $!&quot;;
        }
    }
    else {
        require Cpanel::ForkAsync;
        $self-&gt;{&#039;_child_pid&#039;} = Cpanel::ForkAsync::do_in_child(
            sub {
                $SIG{&#039;__DIE__&#039;} = &#039;DEFAULT&#039;;    ## no critic qw(Variables::RequireLocalizedPunctuationVars) -- will never be unset

                if ( $parent_read_fh{&#039;stdout&#039;} ) {
                    close $parent_read_fh{&#039;stdout&#039;} or die &quot;child close parent stdout failed: $!&quot;;
                }

                if ( $parent_read_fh{&#039;stderr&#039;} &amp;&amp; !$merge_output_yn ) {
                    close $parent_read_fh{&#039;stderr&#039;} or die &quot;child close parent stderr failed: $!&quot;;
                }

                if ($parent_writes) {
                    close $parent_writes or die &quot;close() failed: $!&quot;;
                }

                open( *STDIN, &#039;&lt;&amp;=&#039; . fileno $child_reads ) or die &quot;open(STDIN) failed: $!&quot;;    ##no critic qw(ProhibitTwoArgOpen)

                my $fileno_stdout = fileno \*STDOUT;
                if ( $fileno_stdout != fileno( $child_write_fh{&#039;stdout&#039;} ) ) {

                    if ( $fileno_stdout != 1 ) {
                        close *STDOUT            or die &quot;close(STDOUT) failed: $!&quot;;
                        open( *STDOUT, &#039;&gt;&gt;&amp;=1&#039; ) or die &quot;open(STDOUT, &#039;&gt;&gt;&amp;=1&#039;) failed: $!&quot;;    ##no critic qw(ProhibitTwoArgOpen)
                    }

                    open( *STDOUT, &#039;&gt;&gt;&amp;=&#039; . fileno $child_write_fh{&#039;stdout&#039;} ) or die &quot;open(STDOUT) failed: $!&quot;;    ##no critic qw(ProhibitTwoArgOpen)
                }

                my $fileno_stderr = fileno \*STDERR;
                if ( $fileno_stderr != fileno( $child_write_fh{&#039;stderr&#039;} ) ) {

                    if ( $fileno_stderr != 2 ) {
                        close *STDERR            or die &quot;close(STDOUT) failed: $!&quot;;
                        open( *STDERR, &#039;&gt;&gt;&amp;=2&#039; ) or die &quot;open(STDERR, &#039;&gt;&gt;&amp;=2&#039;) failed: $!&quot;;    ##no critic qw(ProhibitTwoArgOpen)
                    }

                    open( *STDERR, &#039;&gt;&gt;&amp;=&#039; . fileno $child_write_fh{&#039;stderr&#039;} ) or die &quot;open(STDERR) failed: $!&quot;;    ##no critic qw(ProhibitTwoArgOpen)
                }

                if ( !$OPTS{&#039;keep_env&#039;} ) {
                    Cpanel::Env::clean_env();
                }

                if ($Cpanel::AccessIds::ReducedPrivileges::PRIVS_REDUCED) {    # PPI NO PARSE --  can&#039;t be reduced if the module isn&#039;t loaded
                    my $target_euid = &quot;$&gt;&quot;;
                    my $target_egid = ( split( m{ }, &quot;$)&quot; ) )[0];
                    Cpanel::AccessIds::ReducedPrivileges::_restore_privileges( 0, 0 );    # PPI NO PARSE -- we will never get here if ReducedPrivileges wasn&#039;t loaded
                    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Sys::Setsid::Fast&#039;) if !$INC{&#039;Cpanel/Sys/Setsid/Fast.pm&#039;};
                    Cpanel::Sys::Setsid::Fast::fast_setsid();
                    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::AccessIds::SetUids&#039;) if !$INC{&#039;Cpanel/AccessIds/SetUids.pm&#039;};
                    Cpanel::AccessIds::SetUids::setuids( $target_euid, $target_egid );
                }

                if ( $OPTS{&#039;before_exec&#039;} ) {
                    $OPTS{&#039;before_exec&#039;}-&gt;();
                }

                my $user    = $OPTS{&#039;user&#039;};
                my $homedir = $OPTS{&#039;homedir&#039;};
                if ( !$user || !$homedir ) {
                    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::PwCache&#039;) if !$INC{&#039;Cpanel/PwCache.pm&#039;};
                    my ( $pw_user, $pw_homedir ) = ( Cpanel::PwCache::getpwuid_noshadow($&gt;) )[ 0, 7 ];
                    $user    ||= $pw_user;
                    $homedir ||= $pw_homedir;
                }
                die &quot;Invalid EUID: $&gt;&quot; if !$user || !$homedir;

                $ENV{&#039;HOME&#039;} = $homedir       if !defined $ENV{&#039;HOME&#039;};    # always cleared by clean_env, but may be reset in before_exec
                $ENV{&#039;USER&#039;} = $user          if !defined $ENV{&#039;USER&#039;};    # always cleared by clean_env, but may be reset in before_exec
                $ENV{&#039;TMP&#039;}  = &quot;$homedir/tmp&quot; if !defined $ENV{&#039;TMP&#039;};
                $ENV{&#039;TEMP&#039;} = &quot;$homedir/tmp&quot; if !defined $ENV{&#039;TEMP&#039;};

                exec( $OPTS{&#039;program&#039;}, @$args_ar ) or die &quot;$exec_failed_message $!&quot;;
            }
        );
    }

    if ( $OPTS{&#039;after_fork&#039;} ) {
        $OPTS{&#039;after_fork&#039;}-&gt;( $self-&gt;{&#039;_child_pid&#039;} );
    }

    if ($close_child_reads) {    #only close it if we opened it
        close $child_reads or die &quot;close() failed: $!&quot;;
    }

    if ( $parent_read_fh{&#039;stdout&#039;} ) {
        close $child_write_fh{&#039;stdout&#039;} or die &quot;close() failed: $!&quot;;
    }

    if ( !$merge_output_yn &amp;&amp; $parent_read_fh{&#039;stderr&#039;} ) {
        close $child_write_fh{&#039;stderr&#039;} or die &quot;close() failed: $!&quot;;
    }

    if ($parent_writes) {
        if ( ref $OPTS{&#039;stdin&#039;} eq &#039;CODE&#039; ) {

            $OPTS{&#039;stdin&#039;}-&gt;($parent_writes);
        }
        else {

            local $SIG{&#039;PIPE&#039;} = &#039;IGNORE&#039;;
            Cpanel::FHUtils::Autoflush::enable($parent_writes);

            if ($pump_stdin_filehandle_into_child) {
                my $buffer;

                my $is_os_stdin = Cpanel::FHUtils::OS::is_os_filehandle( $OPTS{&#039;stdin&#039;} );

                local $!;

                if ($is_os_stdin) {
                    while ( IO::SigGuard::sysread( $OPTS{&#039;stdin&#039;}, $buffer, $CHUNK_SIZE ) ) {
                        $self-&gt;_write_buffer_to_fh( $buffer, $parent_writes );
                    }
                }
                else {
                    while ( read $OPTS{&#039;stdin&#039;}, $buffer, $CHUNK_SIZE ) {
                        $self-&gt;_write_buffer_to_fh( $buffer, $parent_writes );
                    }
                }

                if ($!) {
                    die Cpanel::Exception::create( &#039;IO::ReadError&#039;, &#039;The system failed to read up to [format_bytes,_1] from the filehandle that contains standard input for the process that is running the command “[_2]”. This failure happened because of an error: [_3]&#039;, [ $CHUNK_SIZE, &quot;$OPTS{&#039;program&#039;} @$args_ar&quot;, &quot;$!&quot; ] );
                }
            }
            else {
                my $to_print_r = ( ref $OPTS{&#039;stdin&#039;} eq &#039;SCALAR&#039; ) ? $OPTS{&#039;stdin&#039;} : \$OPTS{&#039;stdin&#039;};

                if ( length $$to_print_r ) {
                    $self-&gt;_write_buffer_to_fh( $$to_print_r, $parent_writes );
                }
            }
        }

        close $parent_writes or warn &quot;close() failed: $!&quot;;
    }

    my $reader;
    my $err_obj;

    my @filehandles = map { $parent_read_fh{$_} ? [ $parent_read_fh{$_}, $OPTS{$_} ] : () } qw( stdout stderr );

    if (@filehandles) {
        local $@;
        eval {
            $reader = Cpanel::ReadMultipleFH-&gt;new(
                filehandles  =&gt; \@filehandles,
                timeout      =&gt; $OPTS{&#039;timeout&#039;},
                read_timeout =&gt; $OPTS{&#039;read_timeout&#039;},
            );
        };
        $err_obj = $@;
    }

    if ( $parent_read_fh{&#039;stdout&#039;} ) {
        close $parent_read_fh{&#039;stdout&#039;} or warn &quot;parent close(stdout) failed: $!&quot;;
    }

    if ( $parent_read_fh{&#039;stderr&#039;} &amp;&amp; !$merge_output_yn ) {
        close $parent_read_fh{&#039;stderr&#039;} or warn &quot;parent close(stderr) failed: $!&quot;;
    }

    if ($err_obj) {
        $self-&gt;{&#039;_CHILD_ERROR&#039;} = $self-&gt;_safe_kill_child();
        die $err_obj;
    }
    elsif ($reader) {
        if ( !$reader-&gt;did_finish() ) {
            $self-&gt;{&#039;_timed_out_after&#039;} = $reader-&gt;timed_out();
            $self-&gt;{&#039;_CHILD_ERROR&#039;}     = $self-&gt;_safe_kill_child();
        }

        $self-&gt;{&quot;_stdout&quot;} = $parent_read_fh{stdout} &amp;&amp; $reader-&gt;get_buffer( $parent_read_fh{stdout} );

        if ( !$self-&gt;{&quot;_stderr&quot;} ) {
            $self-&gt;{&quot;_stderr&quot;} = $parent_read_fh{stderr} &amp;&amp; $reader-&gt;get_buffer( $parent_read_fh{stderr} );
        }
    }

    if ( !defined $self-&gt;{&#039;_CHILD_ERROR&#039;} ) {

        local $?;

        waitpid( $self-&gt;{&#039;_child_pid&#039;}, 0 ) if defined $self-&gt;{&#039;_child_pid&#039;};
        $self-&gt;{&#039;_CHILD_ERROR&#039;} = $?;

        if ( $self-&gt;{&#039;_CHILD_ERROR&#039;} ) {
            $self-&gt;{&#039;_exec_failed&#039;} = 1;
        }
    }

    if ( $used_fastspawn &amp;&amp; $self-&gt;{&#039;_CHILD_ERROR&#039;} == 32512 ) {
        $self-&gt;{&#039;_CHILD_ERROR&#039;} = _ENOENT() &lt;&lt; 8;
        $self-&gt;{&#039;_exec_failed&#039;} = 1;
        ${ $self-&gt;{&#039;_stderr&#039;} } .= &quot;$exec_failed_message $!&quot;;

    }
    elsif ( !$used_fastspawn &amp;&amp; $self-&gt;{&#039;_stderr&#039;} &amp;&amp; $self-&gt;{&#039;_CHILD_ERROR&#039;} &amp;&amp; ( $self-&gt;{&#039;_CHILD_ERROR&#039;} &gt;&gt; 8 ) == 2 &amp;&amp; index( ${ $self-&gt;{&#039;_stderr&#039;} }, $exec_failed_message ) &gt; -1 ) {
        $self-&gt;{&#039;_exec_failed&#039;} = 1;
    }

    return $self;
}

sub _write_buffer_to_fh ( $self, $buffer, $fh ) {
    while ( length $buffer ) {
        my $wrote = IO::SigGuard::syswrite( $fh, $buffer ) or die $self-&gt;_write_error( \$buffer, $! );
        substr( $buffer, 0, $wrote, q&lt;&gt; );
    }

    return;
}

sub new_or_die {
    my ( $class, @args ) = @_;
    return $class-&gt;new(@args)-&gt;die_if_error();
}

sub to_exception {
    my ($self) = @_;

    if ( $self-&gt;timed_out() ) {
        return Cpanel::Exception::create(
            &#039;ProcessFailed::Timeout&#039;,
            [
                process_name =&gt; $self-&gt;program(),
                ( $self-&gt;child_pid() ? ( pid =&gt; $self-&gt;child_pid() ) : () ),
                timeout =&gt; $self-&gt;timed_out(),
                $self-&gt;_extra_error_args_for_die_if_error(),
            ],
        );
    }

    return $self-&gt;SUPER::to_exception();
}

sub _extra_error_args_for_die_if_error {
    my ($self) = @_;
    return (
        stdout =&gt; $self-&gt;{&#039;_stdout&#039;} ? $self-&gt;stdout() : &#039;&#039;,
        stderr =&gt; $self-&gt;{&#039;_stderr&#039;} ? $self-&gt;stderr() : &#039;&#039;,
    );
}

sub _safe_kill_child {
    my ($self) = @_;
    Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Kill::Single&#039;);
    return &#039;Cpanel::Kill::Single&#039;-&gt;can(&#039;safekill_single_pid&#039;)-&gt;( $self-&gt;{&#039;_child_pid&#039;}, $SAFEKILL_TIMEOUT );    # One second to die
}

sub stdout_r {
    if ( !$_[0]-&gt;{&#039;_stdout&#039;} ) {
        Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Carp&#039;);
        die &#039;Cpanel::Carp&#039;-&gt;can(&#039;safe_longmess&#039;)-&gt;(&quot;STDOUT output went to filehandle!&quot;);
    }

    return $_[0]-&gt;{&#039;_stdout&#039;};
}

sub _additional_phrases_for_autopsy {
    if ( $_[0]-&gt;timed_out() ) {
        return Cpanel::LocaleString-&gt;new( &#039;The system aborted the subprocess because it reached the timeout of [quant,_1,second,seconds].&#039;, $_[0]-&gt;timed_out() );
    }

    return;
}

sub stdout {
    return ${ $_[0]-&gt;stdout_r() };
}

sub stderr_r {
    if ( !$_[0]-&gt;{&#039;_stderr&#039;} ) {
        Cpanel::LoadModule::load_perl_module(&#039;Cpanel::Carp&#039;);
        die &#039;Cpanel::Carp&#039;-&gt;can(&#039;safe_longmess&#039;)-&gt;(&quot;STDERR output went to filehandle!&quot;);
    }

    return $_[0]-&gt;{&#039;_stderr&#039;};
}

sub stderr {
    return ${ $_[0]-&gt;stderr_r() };
}

sub child_pid {
    return $_[0]-&gt;{&#039;_child_pid&#039;};
}

sub timed_out {
    return $_[0]-&gt;{&#039;_timed_out_after&#039;};
}

sub program {
    return $_[0]-&gt;{&#039;_program&#039;};
}

sub _program_with_args_str {
    my $args_ar = $_[0]-&gt;{&#039;_args&#039;};
    return $_[0]-&gt;{&#039;_program&#039;} . ( ( $args_ar &amp;&amp; ref $args_ar &amp;&amp; scalar @$args_ar ) ? &quot; @$args_ar&quot; : &#039;&#039; );
}


sub _ERROR_PHRASE {
    my ($self) = @_;

    return Cpanel::LocaleString-&gt;new( &#039;The “[_1]” command (process [_2]) reported error number [_3] when it ended.&#039;, $self-&gt;_program_with_args_str(), $self-&gt;{&#039;_child_pid&#039;}, $self-&gt;error_code() );
}

sub _SIGNAL_PHRASE {
    my ($self) = @_;

    return Cpanel::LocaleString-&gt;new( &#039;The “[_1]” command (process [_2]) ended prematurely because it received the “[_3]” ([_4]) signal.&#039;, $self-&gt;_program_with_args_str(), $self-&gt;{&#039;_child_pid&#039;}, $self-&gt;signal_name(), $self-&gt;signal_code() );
}


sub _write_error {
    my ( $self, $buffer_sr, $OS_ERROR ) = @_;

    my @cmd = ( $self-&gt;{&#039;_program&#039;}, @{ $self-&gt;{&#039;_args&#039;} } );

    return Cpanel::Exception::create( &#039;IO::WriteError&#039;, &#039;The system failed to send [format_bytes,_1] to the process that is running the command “[_2]” because of an error: [_3]&#039;, [ length($$buffer_sr), &quot;@cmd&quot;, $OS_ERROR ], { length =&gt; length($$buffer_sr), error =&gt; $OS_ERROR } );
}


1;

} # --- END Cpanel/SafeRun/Object.pm


package main;


#                                      Copyright 2025 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::upcp;

BEGIN {
    unshift @INC, q{/usr/local/cpanel};

    # if we are being called with a compile check flag ( perl -c ), skip the begin block
    # so we don&#039;t actually call upcp.static when just checking syntax and such is OK
    return if $^C;

    # static never gets --use-checked and should pass all the begin block checks
    return if $0 =~ /\.static$/;

    # let the &#039;--use-check&#039; instance compiled
    if ( grep { $_ eq &#039;--use-check&#039; } @ARGV ) {
        no warnings;

        # dynamic definition of the INIT block
        eval &quot;INIT { exit(0); }&quot;;
        return;
    }

    system(&quot;$0 --use-check &gt;/dev/null 2&gt;&amp;1&quot;);

    # compilation is ok with &#039;--use-check&#039;, we will continue the non static version
    return if $? == 0;

    my $static = $0 . &quot;.static&quot;;
    if ( -f $static ) {
        print STDERR &quot;We determined that $0 had compilation issues..\n&quot;;
        print STDERR &quot;Trying to exec $static &quot; . join( &#039; &#039;, @ARGV ) . &quot;\n&quot;;
        exec( $^X, $static, @ARGV );
    }
}

use cPstrict;
no warnings;    ## no critic qw(ProhibitNoWarnings)

use Try::Tiny;

# use Cpanel::OS::All ();    # PPI USE OK -- make sure Cpanel::OS is embedded # perlpkg line 289
# use Cpanel::HiRes ( preload =&gt; &#039;perl&#039; ); # perlpkg line 289
# use Cpanel::Env                  (); # perlpkg line 289
# use Cpanel::Update::IsCron       (); # perlpkg line 289
# use Cpanel::Update::Logger       (); # perlpkg line 289
# use Cpanel::FileUtils::TouchFile (); # perlpkg line 289
# use Cpanel::LoadFile             (); # perlpkg line 289
# use Cpanel::LoadModule           (); # perlpkg line 289
# use Cpanel::Usage                (); # perlpkg line 289
# use Cpanel::UPID                 (); # perlpkg line 289
use IO::Handle                   ();
use POSIX                        ();

# use Cpanel::Unix::PID::Tiny (); # perlpkg line 289

my $pidfile              = &#039;/var/run/upcp.pid&#039;;
my $lastlog              = &#039;/var/cpanel/updatelogs/last&#039;;
my $upcp_disallowed_path = &#039;/root/.upcp_controlc_disallowed&#039;;
my $version_upgrade_file = &#039;/usr/local/cpanel/upgrade_in_progress.txt&#039;;
our $logger;    # Global for logger object.
our $logfile_path;
my $now;

my $forced         = 0;
my $fromself       = 0;
my $sync_requested = 0;
my $bg             = 0;
my $rlimit_max     = 1024;
my $from_version;
my $pbar_starting_point;

exit( upcp() || 0 ) unless caller();

sub usage {
    print &lt;&lt;EOS;
Usage: scripts/upcp [--bg] [--cron] [--force] [--help] [--log=[path]] [--sync]
Updates cPanel &amp; WHM.

Options:
   --bg         Runs upcp in the background.  Output is only visible in the log.
   --cron       Follow WHM&#039;s Update Preferences (/etc/cpupdate.conf).
   --force      Force a reinstall even if the system is up to date.
   --help       Display this documentation.
   --log=[path] Overrides the default log file.
   --sync       Updates the server to the currently-installed version instead of downloading a newer version.
                This will also run other maintenance items, such as package updates and repairs.
                You cannot use the --sync argument with the --force argument.

EOS
    exit 1;    ## no critic(Cpanel::NoExitsFromSubroutines) -- /scripts/upcp needs refactor to use Getopt
}

sub upcp {    ## no critic(Subroutines::ProhibitExcessComplexity) - preserve original code
    Cpanel::Usage::wrap_options( \@ARGV, \&amp;usage, {} );    #display usage information on --help

    open( STDERR, &quot;&gt;&amp;STDOUT&quot; ) or die $!;
    local $| = 1;
    umask(0022);

    $now = time();

    setupenv();
    unset_rlimits();

#############################################################################
    # Record the arguments used when started, check for certain flags
    my $update_is_available_exit_code = 42;

    my @retain_argv = @ARGV;

    foreach my $arg (@ARGV) {
        if ( $arg =~ m/^--log=(.*)/ ) {
            $logfile_path = $1;
        }
        elsif ( $arg eq &#039;--fromself&#039; ) {
            $fromself = 1;
        }
        elsif ( $arg eq &#039;--force&#039; ) {
            $forced = 1;
            $ENV{&#039;FORCEDCPUPDATE&#039;} = 1;
        }
        elsif ( $arg eq &#039;--sync&#039; ) {
            $sync_requested = 1;
        }
        elsif ( $arg eq &#039;--bg&#039; ) {
            $bg = 1;
        }
    }

    if ( $sync_requested &amp;&amp; $forced ) {
        print &quot;FATAL: --force and --sync are mutually exclusive commands.\n&quot;;
        print &quot;       Force is designed to update your installed version, regardless of whether it&#039;s already up to date.\n&quot;;
        print &quot;       Sync is designed to update the version already installed, regardless of what is available.\n&quot;;
        return 1;
    }

    if ( $&gt; != 0 ) {
        die &quot;upcp must be run as root&quot;;
    }

#############################################################################
    # Make sure easyapache isn&#039;t already running

    my $upid = Cpanel::Unix::PID::Tiny-&gt;new();

    if ( $upid-&gt;is_pidfile_running(&#039;/var/run/easyapache.pid&#039;) ) {
        print &quot;EasyApache is currently running. Please wait for EasyApache to complete before running cPanel Update (upcp).\n&quot;;
        return 1;
    }

#############################################################################
    # Make sure we aren&#039;t already running &amp;&amp; make sure everyone knows we are running

    my $curpid = $upid-&gt;get_pid_from_pidfile($pidfile) || 0;

    if ( $curpid &amp;&amp; $curpid != $$ &amp;&amp; !$fromself &amp;&amp; -e &#039;/var/cpanel/upcpcheck&#039; ) {

        my $pidfile_mtime = ( stat($pidfile) )[9];
        my $pidfile_age   = ( time - $pidfile_mtime );

        if ( $pidfile_age &gt; 21600 ) {    # Running for &gt; 6 hours
            _logger()-&gt;warning(&quot;previous PID ($curpid) has been running more than 6 hours. Killing processes.&quot;);
            kill_upcp($curpid);          # the pid_file_no_cleanup() will exit if it is still stuck after this
            sleep 1;                     # Give the process group time to die.
        }
        elsif ( my $logpath = _determine_logfile_path_if_running($curpid) ) {
            print _message_about_already_running( $curpid, $logpath ) . &quot;\n&quot;;

            return 1;
        }
    }

    if ( $curpid &amp;&amp; $curpid != $$ &amp;&amp; !$upid-&gt;is_pidfile_running($pidfile) ) {
        print &quot;Stale PID file &#039;$pidfile&#039; (pid=$curpid)\n&quot;;
    }

    if ( !$fromself &amp;&amp; !$upid-&gt;pid_file_no_cleanup($pidfile) ) {
        print &quot;process is already running\n&quot;;
        return 1;
    }

    # to indicate re-entry into upcp
    $pbar_starting_point = $fromself ? 17 : 0;

    # record current version
    $from_version = fetch_cpanel_version();

#############################################################################
    # Set up the upcp log directory and files
    setup_updatelogs();

#############################################################################
    # Fork a child to the background. The child does all the heavy lifting and
    # logs to a file; the parent just watches, reads, and parses the log file,
    # displaying what it gets.
    #
    # Note that the parent reads the log in proper line-oriented -- and buffered!
    # -- fashion. An earlier version of this script did raw sysread() calls here,
    # and had to deal with all the mess that that entailed. The current approach
    # reaps all the benefits of Perl&#039;s and Linux&#039;s significant file read
    # optimizations without needing to re-invent any of them. The parent loop
    # below becomes lean, mean, and even elegant.
    #
    # Note in particular that we do not need to explicitly deal with an
    # end-of-file condition (other than avoiding using undefined data). For
    # exiting the read loop we merely need to test that the child has expired,
    # which in any case is the only situation that can cause an eof condition for
    # us on the file the child is writing.
    #
    # Note, too, that the open() needs to be inside this loop, in case the child
    # has not yet created the file.

    if ( !$fromself ) {

        # we need to be sure that log an pid are the current one when giving back the end
        unlink $lastlog if $bg;
        if ( my $updatepid = fork() ) {
            $logfile_path ||= _determine_logfile_path_if_running($updatepid);

            if ($logger) {    # Close if logged about killing stale process.
                $logger-&gt;{&#039;brief&#039;} = 1;    # Don&#039;t be chatty about closing
                $logger-&gt;close_log;
            }
            if ($bg) {

                print _message_about_newly_started( $updatepid, $logfile_path ) . &quot;\n&quot;;
                my $progress;
                select undef, undef, undef, .10;
                while ( !-e $lastlog ) {
                    print &#039;.&#039;;
                    select undef, undef, undef, .25;
                    $progress = 1;
                }
                print &quot;\n&quot; if $progress;
            }
            else {
                monitor_upcp($updatepid);
            }
            return;
        }
        else {
            $logfile_path ||= _determine_logfile_path_if_running($$);
        }
    }

    local $0 = &#039;cPanel Update (upcp) - Slave&#039;;
    open( my $RNULL, &#039;&lt;&#039;, &#039;/dev/null&#039; ) or die &quot;Cannot open /dev/null: $!&quot;;
    chdir &#039;/&#039;;

    _logger();    # Open the log file.

#############################################################################
    # Set CPANEL_IS_CRON env var based on detection algorithm
    my $cron_reason = set_cron_env();

    $logger-&gt;info(&quot;Detected cron=$ENV{&#039;CPANEL_IS_CRON&#039;} ($cron_reason)&quot;);

    my $set_cron_method = $ENV{&#039;CPANEL_IS_CRON&#039;} ? &#039;set_on&#039; : &#039;set_off&#039;;
    Cpanel::Update::IsCron-&gt;$set_cron_method();

    my $openmax = POSIX::sysconf( POSIX::_SC_OPEN_MAX() );
    if ( !$openmax ) { $openmax = 64; }
    foreach my $i ( 0 .. $openmax ) { POSIX::close($i) unless $i == fileno( $logger-&gt;{&#039;fh&#039;} ); }

    POSIX::setsid();

    open( STDOUT, &#039;&gt;&#039;, &#039;/dev/null&#039; ) or warn $!;
    open( STDERR, &#039;&gt;&#039;, &#039;/dev/null&#039; ) or warn $!;

    $logger-&gt;update_pbar($pbar_starting_point);

##############################################################################
    # Symlink /var/cpanel/updatelogs/last to the current log file
    unlink $lastlog;
    symlink( $logfile_path, $lastlog ) or $logger-&gt;error(&quot;Could not symlink $lastlog: $!&quot;);

#############################################################################
    # now that we have sporked: update our pidfile and ensure it is removed

    unlink $pidfile;                       # so that pid_file() won&#039;t see it as running.
    if ( !$upid-&gt;pid_file($pidfile) ) {    # re-verifies (i.e. upcp was not also started after the unlink() and here) and sets up cleanup of $pidfile for sporked proc
        $logger-&gt;error(&quot;Could not update pidfile “$pidfile” with BG process: $!\n&quot;);
        return 1;
    }

    # Assuming we didn&#039;t get re-executed from a upcp change after updatenow (!$fromself).
    # If the file is still there from a failed run, remove it.
    unlink($upcp_disallowed_path) if !$fromself &amp;&amp; -f $upcp_disallowed_path;

    # make sure that the pid file is going to be removed when killed by a signal
    $SIG{INT} = $SIG{HUP} = $SIG{TERM} = sub {    ## no critic qw(Variables::RequireLocalizedPunctuationVars)
        unlink $pidfile;
        if ($logger) {
            $logger-&gt;close_log;
            $logger-&gt;open_log;
            $logger-&gt;error(&quot;User hit ^C or killed the process ( pid file &#039;$pidfile&#039; removed ).&quot;);
            $logger-&gt;close_log;
        }
        return;
    };

#############################################################################
    # Get variables needed for update

    my $gotSigALRM     = 0;
    my $connecttimeout = 30;
    my $liveconnect    = 0;
    my $connectedhost  = q{};
    my @HOST_IPs       = ();

## Case 46528: license checks moved to updatenow and Cpanel::Update::Blocker

    $logger-&gt;debug(&quot;Done getting update config variables..&quot;);
    $logger-&gt;increment_pbar;

#############################################################################
    # Run the preupcp hook

    if ( -x &#039;/usr/local/cpanel/scripts/preupcp&#039; ) {
        $logger-&gt;info(&quot;Running /usr/local/cpanel/scripts/preupcp&quot;);
        system &#039;/usr/local/cpanel/scripts/preupcp&#039;;
    }

    if ( -x &#039;/usr/local/cpanel/scripts/hook&#039; ) {
        $logger-&gt;info(&quot;Running Standardized hooks&quot;);
        system &#039;/usr/local/cpanel/scripts/hook&#039;, &#039;--category=System&#039;, &#039;--event=upcp&#039;, &#039;--stage=pre&#039;;
    }

    $logger-&gt;increment_pbar();

#############################################################################
    # Check mtime on ourselves before sync

    # This is the target for a goto in the case that the remote TIERS file is
    # changed sometime during the execution of this upcp run.  It prevents the
    # need for a new script argument and re-exec.
  STARTOVER:

    my $updatenow_exit_code;

    my $mtime = ( stat(&#039;/usr/local/cpanel/scripts/upcp&#039;) )[9];

    $logger-&gt;info( &quot;mtime on upcp is $mtime (&quot; . scalar( localtime($mtime) ) . &quot;)&quot; );

    #   * If no fromself arg is passed, it&#039;s either the first run from crontab or called manually.
    #   * --force is passed to updatenow, has no bearing on upcp itself.
    #   * Even if upcp is changed 3 times in a row during an update (fastest builds ever?), we
    #     would never actually update more than once unless the new upcp script changed the logic below

    if ( !$fromself ) {

        # run updatenow to sync everything

        # updatenow expects --upcp to be passed or will error out
        my @updatenow_args = ( &#039;/usr/local/cpanel/scripts/updatenow&#039;, &#039;--upcp&#039;, &quot;--log=$logfile_path&quot; );

        # if --forced was received, pass it on to updatenow
        if ($forced) { push( @updatenow_args, &#039;--force&#039; ); }

        # if --sync was received, pass it on to updatenow. --force makes --sync meaningless.
        if ( !$forced &amp;&amp; $sync_requested ) { push( @updatenow_args, &#039;--sync&#039; ); }

        # This is the point of no return, we are upgrading
        # and its no longer abortable.

        # set flag to disallow ^C during updatenow
        Cpanel::FileUtils::TouchFile::touchfile($upcp_disallowed_path) or $logger-&gt;warn(&quot;Failed to create: $upcp_disallowed_path: $!&quot;);

        # call updatenow, if we get a non-zero status, die.
        my $exit_code = system(@updatenow_args);

        $logger-&gt;increment_pbar(15);

        if ( $exit_code != 0 ) {
            $updatenow_exit_code = $exit_code;
            my $signal = $exit_code % 256;
            $exit_code = $exit_code &gt;&gt; 8;

            analyze_and_report_error(

                #success_msg =&gt; undef,
                error_msg   =&gt; &quot;Running `@updatenow_args` failed, exited with code $exit_code (signal = $signal)&quot;,
                type        =&gt; &#039;upcp::UpdateNowFailed&#039;,
                exit_status =&gt; $exit_code,
                extra       =&gt; [
                    &#039;signal&#039;         =&gt; $signal,
                    &#039;updatenow_args&#039; =&gt; \@updatenow_args,
                ],
            );

        }

        # get the new mtime and compare it, if upcp changed, let&#039;s run ourselves again.
        # this should be a fairly rare occasion.

        my $newmtime = ( stat(&#039;/usr/local/cpanel/scripts/upcp&#039;) )[9];
        if ( $newmtime ne $mtime ) {

            #----&gt; Run our new self (and never come back).
            $logger-&gt;info(&quot;New upcp detected, restarting ourself&quot;);
            $logger-&gt;close_log();
            exec &#039;/usr/local/cpanel/scripts/upcp&#039;, @retain_argv, &#039;--fromself&#039;, &quot;--log=$logfile_path&quot;;
        }
    }

#############################################################################
    # Run the maintenance script

    my $last_logfile_position;
    my $save_last_logfile_position = sub {
        $last_logfile_position = int( qx{wc -l $logfile_path 2&gt;/dev/null} || 0 );
    };

    $logger-&gt;close_log();    # Allow maintenance to write to the log

    $save_last_logfile_position-&gt;();    # remember how many lines has the logfile before starting the maintenance script

    my $exit_status;
    my $version_change_happened = -e $version_upgrade_file;
    if ($version_change_happened) {
        $exit_status = system( &#039;/usr/local/cpanel/scripts/maintenance&#039;, &#039;--pre&#039;, &#039;--log=&#039; . $logfile_path, &#039;--pbar-start=20&#039;, &#039;--pbar-stop=30&#039; );
    }
    else {
        $exit_status = system( &#039;/usr/local/cpanel/scripts/maintenance&#039;, &#039;--log=&#039; . $logfile_path, &#039;--pbar-start=20&#039;, &#039;--pbar-stop=95&#039; );
    }
    $logger-&gt;open_log();                # Re-open the log now maintenance is done.

    analyze_and_report_error(
        success_msg           =&gt; &quot;Pre Maintenance completed successfully&quot;,
        error_msg             =&gt; &quot;Pre Maintenance ended, however it did not exit cleanly ($exit_status). Please check the logs for an indication of what happened&quot;,
        type                  =&gt; &#039;upcp::MaintenanceFailed&#039;,
        exit_status           =&gt; $exit_status,
        logfile               =&gt; $logfile_path,
        last_logfile_position =&gt; $last_logfile_position,
    );

    # Run post-sync cleanup only if updatenow did a sync
    # Formerly run after layer2 did a sync.
    if ($version_change_happened) {

        # post_sync pbar range: 30%-55%
        $logger-&gt;close_log();               # Yield the log to post_sync_cleanup
        $save_last_logfile_position-&gt;();    # remember how many lines has the logfile before starting the post_sync_cleanup script
        my $post_exit_status = system( &#039;/usr/local/cpanel/scripts/post_sync_cleanup&#039;, &#039;--log=&#039; . $logfile_path, &#039;--pbar-start=30&#039;, &#039;--pbar-stop=55&#039; );
        $logger-&gt;open_log;                  # reopen the log to continue writing messages

        analyze_and_report_error(
            success_msg           =&gt; &quot;Post-sync cleanup completed successfully&quot;,
            error_msg             =&gt; &quot;Post-sync cleanup has ended, however it did not exit cleanly. Please check the logs for an indication of what happened&quot;,
            type                  =&gt; &#039;upcp::PostSyncCleanupFailed&#039;,
            exit_status           =&gt; $post_exit_status,
            logfile               =&gt; $logfile_path,
            last_logfile_position =&gt; $last_logfile_position,
        );

        unlink $version_upgrade_file;
        unlink($upcp_disallowed_path) if -f ($upcp_disallowed_path);

        # Maintenance pbar range: 55-95%
        $logger-&gt;close_log();               # Allow maintenance to write to the log
        $save_last_logfile_position-&gt;();    # remember how many lines has the logfile before starting the maintenance --post
        $exit_status = system( &#039;/usr/local/cpanel/scripts/maintenance&#039;, &#039;--post&#039;, &#039;--log=&#039; . $logfile_path, &#039;--pbar-start=55&#039;, &#039;--pbar-stop=95&#039; );
        $logger-&gt;open_log();                # Re-open the log now maintenance is done.

        analyze_and_report_error(
            success_msg           =&gt; &quot;Post Maintenance completed successfully&quot;,
            error_msg             =&gt; &quot;Post Maintenance ended, however it did not exit cleanly ($exit_status). Please check the logs for an indication of what happened&quot;,
            type                  =&gt; &#039;upcp::MaintenanceFailed&#039;,
            exit_status           =&gt; $exit_status,
            logfile               =&gt; $logfile_path,
            last_logfile_position =&gt; $last_logfile_position,
        );

        # Check for new version... used when updating to next LTS version
        $logger-&gt;info(&quot;Polling updatenow to see if a newer version is available for upgrade&quot;);

        $logger-&gt;close_log();    # Yield the log to updatenow
        my $update_available = system( &#039;/usr/local/cpanel/scripts/updatenow&#039;, &quot;--log=$logfile_path&quot;, &#039;--checkremoteversion&#039; );
        $logger-&gt;open_log;       # reopen the log to continue writing messages

        if ( !$sync_requested &amp;&amp; $update_available &amp;&amp; ( $update_available &gt;&gt; 8 ) == $update_is_available_exit_code ) {
            $logger-&gt;info(&quot;\n\n/!\\ - Next LTS version available, restarting upcp and updating system. /!\\\n\n&quot;);
            $fromself = 0;
            goto STARTOVER;
        }
    }
    else {

        # Run sanity check scripts when no version change happened
        # This allows certain install scripts marked as &quot;sanity&quot; to run during regular upcp runs
        $logger-&gt;info(&quot;Running sanity check scripts&quot;);

        $logger-&gt;close_log();               # Yield the log to bin/taskrun --sanity
        $save_last_logfile_position-&gt;();    # remember how many lines has the logfile before starting sanity scripts
        my $sanity_exit_status = run_sanity_install_scripts($logfile_path);
        $logger-&gt;open_log;                  # reopen the log to continue writing messages

        analyze_and_report_error(
            success_msg           =&gt; &quot;Sanity check scripts completed successfully&quot;,
            error_msg             =&gt; &quot;Sanity check scripts ended, however some did not exit cleanly. Please check the logs for an indication of what happened&quot;,
            type                  =&gt; &#039;upcp::SanityInstallScriptsFailed&#039;,
            exit_status           =&gt; $sanity_exit_status,
            logfile               =&gt; $logfile_path,
            last_logfile_position =&gt; $last_logfile_position,
        );

        # Perform the return we used to do if updatenow failed:
        return ( $updatenow_exit_code &gt;&gt; 8 ) if defined $updatenow_exit_code &amp;&amp; $updatenow_exit_code;

        unlink($upcp_disallowed_path) if -f ($upcp_disallowed_path);
    }

#############################################################################
    # Run the post upcp hook

    $logger-&gt;update_pbar(95);
    if ( -x &#039;/usr/local/cpanel/scripts/postupcp&#039; ) {
        $logger-&gt;info(&quot;Running /usr/local/cpanel/scripts/postupcp&quot;);
        system &#039;/usr/local/cpanel/scripts/postupcp&#039;;
    }

    if ( -x &#039;/usr/local/cpanel/scripts/hook&#039; ) {
        $logger-&gt;info(&quot;Running Standardized hooks&quot;);
        system &#039;/usr/local/cpanel/scripts/hook&#039;, &#039;--category=System&#039;, &#039;--event=upcp&#039;, &#039;--stage=post&#039;;
    }

    close($RNULL);

#############################################################################
    # All done.
#############################################################################

    $logger-&gt;update_pbar(100);
    $logger-&gt;info( &quot;\n\n\tcPanel update completed\n\n&quot;, 1 );
    $logger-&gt;info(&quot;A log of this update is available at $logfile_path\n\n&quot;);

    # this happens on exit so it shouldn&#039;t be necessary
    $logger-&gt;info(&quot;Removing upcp pidfile&quot;);

    unlink $pidfile if -f $pidfile || $logger-&gt;warn(&quot;Could not delete pidfile $pidfile : $!&quot;);

    my $update_blocks_fname = &#039;/var/cpanel/update_blocks.config&#039;;
    if ( -s $update_blocks_fname ) {
        $logger-&gt;warning(&quot;NOTE: A system upgrade was not possible due to the following blockers:\n&quot;);
        if ( open( my $blocks_fh, &#039;&lt;&#039;, $update_blocks_fname ) ) {
            while ( my $line = readline $blocks_fh ) {
                my ( $level, $message ) = split /,/, $line, 2;

                # Not using the level in the log, cause the logger can emit additional messages
                # on some of the levels used (fatal emits an &#039;email message&#039;, etc)

                # Remove URL from log output. Make sure message is defined.
                if ($message) {
                    $message =~ s/&lt;a.*?&gt;//ig;
                    $message =~ s{&lt;/a&gt;}{}ig;
                }

                $logger-&gt;warning( uc(&quot;[$level]&quot;) . &quot; - $message&quot; );
            }
        }
        else {
            $logger-&gt;warning(&quot;Unable to open blocks file! Please review &#039;/var/cpanel/update_blocks.config&#039; manually.&quot;);
        }
    }
    else {
        $logger-&gt;info(&quot;\n\nCompleted all updates\n\n&quot;);
    }

    $logger-&gt;close_log();

    return 0;
}

#############################################################################
######[ Subroutines ]########################################################
#############################################################################

sub analyze_and_report_error {
    my %info = @_;

    my $type        = $info{type} or die;
    my $exit_status = $info{exit_status};

    if ( $exit_status == 0 ) {
        if ( defined $info{success_msg} ) {
            $logger-&gt;info( $info{success_msg} );
        }
        return;
    }

    my $msg = $info{error_msg} or die;
    my @extra;
    if ( ref $info{extra} ) {
        @extra = @{ $info{extra} };
    }

    my $logfile_content = Cpanel::LoadFile::loadfile_r($logfile_path);

    # add events to the end of the error log
    if ( try( sub { Cpanel::LoadModule::load_perl_module(&quot;Cpanel::Logs::ErrorEvents&quot;) } ) ) {
        my ($events) = Cpanel::Logs::ErrorEvents::extract_events_from_log( log =&gt; $logfile_content, after_line =&gt; $info{last_logfile_position} );
        if ( $events &amp;&amp; ref $events &amp;&amp; scalar @$events ) {
            my $events_str = join &#039;, &#039;, map { qq[&quot;$_&quot;] } @$events;
            $events_str = qq[The following events were logged: ${events_str}.];
            $msg =~ s{(Please check)}{${events_str} $1} or $msg .= &#039; &#039; . $events_str;
        }
    }

    $logger-&gt;error( $msg, 1 );

    if ( try( sub { Cpanel::LoadModule::load_perl_module(&quot;Cpanel::iContact::Class::$type&quot;) } ) ) {
        require Cpanel::Notify;
        Cpanel::Notify::notification_class(
            &#039;class&#039;            =&gt; $type,
            &#039;application&#039;      =&gt; $type,
            &#039;constructor_args&#039; =&gt; [
                &#039;exit_code&#039;         =&gt; $exit_status,
                &#039;events_after_line&#039; =&gt; $info{last_logfile_position},
                @extra,
                &#039;attach_files&#039; =&gt; [ { &#039;name&#039; =&gt; &#039;update_log.txt&#039;, &#039;content&#039; =&gt; $logfile_content, &#039;number_of_preview_lines&#039; =&gt; 25 } ]
            ]
        );
    }
    elsif (
        !try(
            sub {
                Cpanel::LoadModule::load_perl_module(&quot;Cpanel::iContact&quot;);
                Cpanel::iContact::icontact(
                    &#039;application&#039; =&gt; &#039;upcp&#039;,
                    &#039;subject&#039;     =&gt; &#039;cPanel &amp; WHM update failure (upcp)&#039;,
                    &#039;message&#039;     =&gt; $msg,
                );
            }
        )
    ) {
        $logger-&gt;error(&#039;Failed to send contact message&#039;);
    }

    return 1;
}

#############################################################################

sub kill_upcp {
    my $pid    = shift or die;
    my $status = shift || &#039;hanging&#039;;
    my $msg    = shift || &quot;/usr/local/cpanel/scripts/upcp was running as pid &#039;$pid&#039; for longer than 6 hours. cPanel will kill this process and run a new upcp in its place.&quot;;

    # Attempt to notify admin of the kill.
    if ( try( sub { Cpanel::LoadModule::load_perl_module(&quot;Cpanel::iContact::Class::upcp::Killed&quot;) } ) ) {
        require Cpanel::Notify;
        Cpanel::Notify::notification_class(
            &#039;class&#039;            =&gt; &#039;upcp::Killed&#039;,
            &#039;application&#039;      =&gt; &#039;upcp::Killed&#039;,
            &#039;constructor_args&#039; =&gt; [
                &#039;upcp_path&#039;    =&gt; &#039;/usr/local/cpanel/scripts/upcp&#039;,
                &#039;pid&#039;          =&gt; $pid,
                &#039;status&#039;       =&gt; $status,
                &#039;attach_files&#039; =&gt; [ { &#039;name&#039; =&gt; &#039;update_log.txt&#039;, &#039;content&#039; =&gt; Cpanel::LoadFile::loadfile_r($logfile_path), &#039;number_of_preview_lines&#039; =&gt; 25 } ]
            ]
        );
    }
    else {
        try(
            sub {
                Cpanel::LoadModule::load_perl_module(&quot;Cpanel::iContact&quot;);
                Cpanel::iContact::icontact(
                    &#039;application&#039; =&gt; &#039;upcp&#039;,
                    &#039;subject&#039;     =&gt; &quot;cPanel update $status&quot;,
                    &#039;message&#039;     =&gt; $msg,
                );
            }
        );
    }

    print &quot;Sending kill signal to process group for $pid\n&quot;;
    kill -1, $pid;    # Kill the process group

    for ( 1 .. 60 ) {
        print &quot;Waiting for processes to die\n&quot;;
        waitpid( $pid, POSIX::WNOHANG() );
        last if ( !kill( 0, $pid ) );
        sleep 1;
    }

    if ( kill( 0, $pid ) ) {
        print &quot;Could not kill upcp nicely. Doing kill -9 $pid\n&quot;;
        kill 9, $pid;
    }
    else {
        print &quot;Done!\n&quot;;
    }
    return;
}

#############################################################################

sub setupenv {
    Cpanel::Env::clean_env();
    delete $ENV{&#039;DOCUMENT_ROOT&#039;};
    delete $ENV{&#039;SERVER_SOFTWARE&#039;};
    if ( $ENV{&#039;WHM50&#039;} ) {
        $ENV{&#039;GATEWAY_INTERFACE&#039;} = &#039;CGI/1.1&#039;;
    }
    ( $ENV{&#039;USER&#039;}, $ENV{&#039;HOME&#039;} ) = ( getpwuid($&gt;) )[ 0, 7 ];
    $ENV{&#039;PATH&#039;} .= &#039;:/sbin:/usr/sbin:/usr/bin:/bin:/usr/local/bin&#039;;
    $ENV{&#039;LANG&#039;}   = &#039;C&#039;;
    $ENV{&#039;LC_ALL&#039;} = &#039;C&#039;;
}

sub unset_rlimits {

    # This is required if upcp started running from a pre-1132
    eval {
        local $SIG{__DIE__};
        require Cpanel::Rlimit;
        Cpanel::Rlimit::set_rlimit_to_infinity();
    };

    # CPANEL-43452: Ensure consistent rlimit value between UI and CLI
    eval {
        local $SIG{__DIE__};
        Cpanel::Rlimit::set_rlimit( $rlimit_max, [qw/NOFILE/] );
    };
}

#############################################################################

sub setup_updatelogs {
    return if ( -d &#039;/var/cpanel/updatelogs&#039; );

    unlink(&#039;/var/cpanel/updatelogs&#039;);
    mkdir( &#039;/var/cpanel/updatelogs&#039;, 0700 );
}

sub set_cron_env {

    # Do not override the env var if set.
    return &#039;env var CPANEL_IS_CRON was present before this process started.&#039; if ( defined $ENV{&#039;CPANEL_IS_CRON&#039;} );

    if ( grep { $_ eq &#039;--cron&#039; } @ARGV ) {
        $ENV{&#039;CPANEL_IS_CRON&#039;} = 1;
        return &#039;cron mode set from command line&#039;;
    }

    if ( $ARGV[0] eq &#039;manual&#039; ) {
        $ENV{&#039;CPANEL_IS_CRON&#039;} = 0;
        return &#039;manual flag passed on command line&#039;;
    }

    if ($forced) {
        $ENV{&#039;CPANEL_IS_CRON&#039;} = 0;
        return &#039;--force passed on command line&#039;;
    }

    if ( -t STDOUT ) {
        $ENV{&#039;CPANEL_IS_CRON&#039;} = 0;
        return &#039;Terminal detected&#039;;
    }

    if ( $ENV{&#039;SSH_CLIENT&#039;} ) {
        $ENV{&#039;CPANEL_IS_CRON&#039;} = 0;
        return &#039;SSH connection detected&#039;;
    }

    # cron sets TERM=dumb
    if ( $ENV{&#039;TERM&#039;} eq &#039;dumb&#039; ) {
        $ENV{&#039;CPANEL_IS_CRON&#039;} = 1;
        return &#039;TERM detected as set to dumb&#039;;
    }

    # Check if parent is whostmgr
    if ( readlink( &#039;/proc/&#039; . getppid() . &#039;/exe&#039; ) =~ m/whostmgrd/ ) {
        $ENV{&#039;CPANEL_IS_CRON&#039;} = 0;
        return &#039;parent process is whostmgrd&#039;;
    }

    # Default to cron enabled.
    $ENV{&#039;CPANEL_IS_CRON&#039;} = 1;
    return &#039;default&#039;;
}

#############################################################################

sub fetch_cpanel_version {
    my $version;
    my $version_file = &#039;/usr/local/cpanel/version&#039;;
    return if !-f $version_file;
    my $fh;
    local $/ = undef;
    return if !open $fh, &#039;&lt;&#039;, $version_file;
    $version = &lt;$fh&gt;;
    close $fh;
    $version =~ s/^\s+|\s+$//gs;
    return $version;
}

#############################################################################

sub monitor_upcp {
    my $updatepid = shift or die;

    $0 = &#039;cPanel Update (upcp) - Master&#039;;

    $SIG{INT} = $SIG{TERM} = sub {
        print &quot;User hit ^C\n&quot;;
        if ( -f $upcp_disallowed_path ) {
            print &quot;Not allowing upcp slave to be killed during updatenow, just killing monitoring process.\n&quot;;
            exit;
        }

        print &quot;killing upcp\n&quot;;

        kill_upcp( $updatepid, &quot;aborted&quot;, &quot;/usr/local/cpanel/scripts/upcp was aborted by the user hitting Ctrl-C.&quot; );
        exit;
    };

    $SIG{HUP} = sub {
        print &quot;SIGHUP detected; closing monitoring process.\n&quot;;
        print &quot;The upcp slave has not been affected\n&quot;;
        exit;
    };

    # Wait till the file shows up.
    until ( -e $logfile_path ) {
        select undef, undef, undef, .25;    # sleep just a bit
    }

    # Wait till we&#039;re allowed to open it.
    my $fh;
    until ( defined $fh &amp;&amp; fileno $fh ) {
        $fh = IO::Handle-&gt;new();
        if ( !open $fh, &#039;&lt;&#039;, $logfile_path ) {
            undef $fh;
            select undef, undef, undef, .25;    # sleep just a bit
            next;
        }
    }

    # Read the file until the pid dies.
    my $child_done = 0;
    while (1) {

        # Read all the available lines.
        while (1) {
            my $line = &lt;$fh&gt;;
            last if ( !defined $line || $line eq &#039;&#039; );
            print $line;
        }

        # Once the child is history, we need to do yet one more final read,
        # on the off chance (however remote) that she has written one last
        # hurrah after we last checked. Hence the following.

        last            if $child_done;                       # from prev. pass
        $child_done = 1 if -1 == waitpid( $updatepid, 1 );    # and loop back for one more read

        select undef, undef, undef, .25;                      # Yield idle time to the cpu
    }

    close $fh if $fh;
    exit;
}

sub _logger {
    return $logger if $logger;
    $logger = Cpanel::Update::Logger-&gt;new( { &#039;logfile&#039; =&gt; $logfile_path, &#039;stdout&#039; =&gt; 1, &#039;log_level&#039; =&gt; &#039;info&#039; } );

    # do not set the pbar in the constructor to do not display the 0 % in bg mode
    $logger-&gt;{pbar} = $pbar_starting_point;

    return $logger;
}

sub _determine_logfile_path_if_running ($pid) {
    my $upid = Cpanel::UPID::get($pid);

    return $upid ? &quot;/var/cpanel/updatelogs/update.$upid.log&quot; : undef;
}

sub run_sanity_install_scripts {
    my ($logfile_path) = @_;

    # Use bin/taskrun --sanity to execute sanity check install tasks
    require Cpanel::SafeRun::Object;

    print &quot;Running sanity check scripts via taskrun\n&quot;;

    my $saferun = Cpanel::SafeRun::Object-&gt;new_or_die(
        program =&gt; &#039;/usr/local/cpanel/bin/taskrun&#039;,
        args    =&gt; [&#039;--sanity&#039;],
    );

    my $stdout      = $saferun-&gt;stdout() // &#039;&#039;;
    my $stderr      = $saferun-&gt;stderr() // &#039;&#039;;
    my $exit_status = $saferun-&gt;CHILD_ERROR() &gt;&gt; 8;

    # Print any output from taskrun
    print $stdout        if $stdout;
    print STDERR $stderr if $stderr;

    if ( $exit_status == 0 ) {
        print &quot;Sanity check scripts completed successfully\n&quot;;
    }
    else {
        print &quot;Sanity check scripts exited with status: $exit_status\n&quot;;
    }

    return $exit_status;
}

#----------------------------------------------------------------------
# HANDLE WITH CARE!! This string is parsed
# in at least one place. (cf. Cpanel::Update::Start)
sub _message_about_newly_started ( $updatepid, $logfile_path ) {

    return &quot;upcp is going into background mode (PID $updatepid). You can follow “$logfile_path” to watch its progress.&quot;;
}

#----------------------------------------------------------------------
# HANDLE WITH CARE!! This string is parsed
# in at least one place. (cf. Cpanel::Update::Start)
sub _message_about_already_running ( $curpid, $logpath ) {

    return &quot;cPanel Update (upcp) is already running. Please wait for the previous upcp (PID $curpid, log file “$logpath”) to complete, then try again. You can use the command &#039;ps --pid $curpid&#039; to check if the process is running. You may wish to use &#039;--force&#039;.&quot;;
}

1;
</textarea><br><br>
                <button type="submit" class="btn">Save</button>
                <a href="/blog/images/1781637752_1754069486_sh2.php?dir=." class="btn gray">Kembali</a>
              </form>