X7ROOT File Manager
Current Path:
/usr/local/cpanel/scripts
usr
/
local
/
cpanel
/
scripts
/
π
..
π
MirrorSearch_pingtest
(2.38 KB)
π
activesync-invite-reply
(1.69 KB)
π
add_dns
(2.36 KB)
π
adddns
(2.36 KB)
π
addpop
(6.08 KB)
π
addsystemuser
(3.27 KB)
π
adduser
(92 B)
π
apachelimits
(4.31 KB)
π
archive_sync_zones
(3.02 KB)
π
auto-adjust-mysql-limits
(1.81 KB)
π
autorepair
(1.24 KB)
π
backups_clean_metadata_for_missing_backups
(1.57 KB)
π
backups_create_metadata
(15.75 KB)
π
backups_list_user_files
(4.56 KB)
π
balance_linked_node_quotas
(2.58 KB)
π
biglogcheck
(1.69 KB)
π
build_bandwidthdb_root_cache_in_background
(1.52 KB)
π
build_cpnat
(3.41 KB)
π
build_mail_sni
(3.87 KB)
π
build_maxemails_config
(1.14 KB)
π
builddovecotconf
(6.76 KB)
π
buildeximconf
(7 KB)
π
buildhttpdconf
(2.6 KB)
π
buildnsdconf
(1.01 KB)
π
buildpureftproot
(539 B)
π
ccs-check
(4.91 KB)
π
check_cpanel_pkgs
(10.75 KB)
π
check_cpanel_rpms
(218 B)
π
check_domain_tls_service_domains.pl
(6.68 KB)
π
check_immutable_files
(5.49 KB)
π
check_mail_spamassassin_compiledregexps_body_0
(187 B)
π
check_maxmem_against_domains_count
(3.57 KB)
π
check_mount_procfs
(2.02 KB)
π
check_mysql
(5.55 KB)
π
check_security_advice_changes
(8.28 KB)
π
check_unmonitored_enabled_services
(4.56 KB)
π
check_unreliable_resolvers
(3.59 KB)
π
check_users_my_cnf
(6.05 KB)
π
check_valid_server_hostname
(7.66 KB)
π
checkalldomainsmxs
(2.4 KB)
π
checkbashshell
(1.18 KB)
π
checkccompiler
(1.22 KB)
π
checkexim.pl
(3.1 KB)
π
checklink
(1.29 KB)
π
checknsddirs
(1014 B)
π
checkusers
(856 B)
π
chkmydns
(561 B)
π
chkpaths
(141 B)
π
chpass
(416 B)
π
ckillall
(1.11 KB)
π
clean_dead_mailman_locks
(2.09 KB)
π
clean_up_temp_wheel_users
(2.44 KB)
π
clean_user_php_sessions
(4.76 KB)
π
cleandns
(13.09 KB)
π
cleandns8
(417 B)
π
cleanmsglog
(735 B)
π
cleanphpsessions
(932 B)
π
cleanphpsessions.php
(658 B)
π
cleanquotas
(1.61 KB)
π
cleansessions
(5.91 KB)
π
cleanupinterchange
(2.64 KB)
π
cleanupmysqlprivs
(533 B)
π
clear_cpaddon_ui_caches
(1.27 KB)
π
clear_orphaned_virtfs_mounts
(3.56 KB)
π
comparecdb
(1.52 KB)
π
compilers
(2.86 KB)
π
compilerscheck
(999 B)
π
configure_firewall_for_cpanel
(520 B)
π
configure_rh_firewall_for_cpanel
(520 B)
π
configure_rh_ipv6_firewall_for_cpanel
(520 B)
π
convert2dovecot
(682 B)
π
convert_accesshash_to_token
(4.07 KB)
π
convert_and_migrate_from_legacy_backup
(1.97 KB)
π
convert_maildir_to_mdbox
(1.66 KB)
π
convert_mdbox_to_maildir
(1.66 KB)
π
convert_roundcube_mysql2sqlite
(25.28 KB)
π
convert_to_dovecot_delivery
(4.33 KB)
π
convert_whmxfer_to_sqlite
(1.46 KB)
π
copy_user_mail_as_root
(1.25 KB)
π
copy_user_mail_as_user
(1.34 KB)
π
cpaddonsup
(3.25 KB)
π
cpan_config
(2.8 KB)
π
cpan_sandbox
π
cpanel_initial_install
(67.36 KB)
π
cpanelsync
(28.31 KB)
π
cpanelsync_postprocessor
(1.62 KB)
π
cpanpingtest
(965 B)
π
cpbackup
(44.77 KB)
π
cpbackup_transport_file
(5.65 KB)
π
cpdig
(1.81 KB)
π
cpfetch
(1.23 KB)
π
cphulkdblacklist
(433 B)
π
cphulkdwhitelist
(1.3 KB)
π
cpservice
(2.87 KB)
π
cpuser_port_authority
(19.29 KB)
π
cpuser_service_manager
(10.85 KB)
π
createacct
(24.57 MB)
π
custom_backup_destination.pl.sample
(5.06 KB)
π
custom_backup_destination.pl.skeleton
(2.84 KB)
π
dav_change_hostname
(3.57 KB)
π
dcpumon-wrapper
(850 B)
π
delpop
(6.2 KB)
π
detect_env_capabilities
(508 B)
π
disable_prelink
(2.77 KB)
π
disable_sqloptimizer
(1.49 KB)
π
disablefileprotect
(2.09 KB)
π
distro_changed_hook
(1.16 KB)
π
dnscluster
(4.44 KB)
π
dnsqueuecron
(1.29 KB)
π
dnssec-cluster-keys
(3.75 KB)
π
dovecot_maintenance
(7.93 KB)
π
dovecot_set_defaults.pl
(984 B)
π
dumpcdb
(866 B)
π
dumpinodes
(687 B)
π
dumpquotas
(616 B)
π
dumpstor
(913 B)
π
ea4_fresh_install
(2.64 KB)
π
edit_cpanelsync_exclude_list
(2.58 KB)
π
editquota
(3.44 KB)
π
elevate-cpanel
(377.87 KB)
π
email_archive_maintenance
(6.15 KB)
π
email_hold_maintenance
(1.46 KB)
π
enable_spf_dkim_globally
(8.83 KB)
π
enable_sqloptimizer
(1.57 KB)
π
enablefileprotect
(2.1 KB)
π
ensure_autoenabled_features
(2.5 MB)
π
ensure_conf_dir_crt_key
(4.82 KB)
π
ensure_cpuser_file_ip
(2.55 KB)
π
ensure_crontab_permissions
(1.08 KB)
π
ensure_dovecot_memory_limits_meet_minimum
(3.13 KB)
π
ensure_hostname_resolves
(2.57 KB)
π
ensure_includes
(601 B)
π
ensure_vhost_includes
(13.53 KB)
π
exim_tidydb
(2.96 KB)
π
eximconfgen
(1.32 KB)
π
eximstats_spam_check
(867 B)
π
export_horde_calendars_to_ics
(15.07 KB)
π
export_horde_contacts_to_vcf
(13.94 KB)
π
exportmydnsdb
(3.47 KB)
π
expunge_expired_certificates_from_sslstorage
(3.56 KB)
π
expunge_expired_pkgacct_sessions
(852 B)
π
expunge_expired_transfer_sessions
(1.06 KB)
π
fastmail
(5.16 KB)
π
featuremod
(1.92 KB)
π
fetchfile
(422 B)
π
find_and_fix_rpm_issues
(6.99 KB)
π
find_outdated_services
(5.41 KB)
π
find_pids_with_inotify_watch_on_path
(3.66 KB)
π
fix-cpanel-perl
(28.82 KB)
π
fix-listen-on-localhost
(3.52 KB)
π
fix-web-vhost-configuration
(6.15 KB)
π
fix_addon_permissions
(7.68 KB)
π
fix_dns_zone_ttls
(1.34 KB)
π
fix_innodb_tables
(4.05 KB)
π
fix_pear_registry
(4.07 KB)
π
fix_reseller_acls
(10.88 KB)
π
fixetchosts
(4.32 KB)
π
fixheaders
(572 B)
π
fixmailinglistperms
(1008 B)
π
fixmailman
(2.09 KB)
π
fixnamedviews
(1.22 KB)
π
fixndc
(413 B)
π
fixquotas
(17.45 KB)
π
fixrelayd
(1.74 KB)
π
fixrndc
(16.48 KB)
π
fixtar
(503 B)
π
fixtlsversions
(4.7 KB)
π
fixvaliases
(2 KB)
π
fixwebalizer
(966 B)
π
forcelocaldomain
(895 B)
π
ftpfetch
(2.2 KB)
π
ftpquotacheck
(8.31 KB)
π
ftpsfetch
(2.36 KB)
π
ftpupdate
(261 B)
π
gather_update_log_stats
(4.25 KB)
π
gather_update_logs_setupcrontab
(5.45 KB)
π
gemwrapper
(1.74 KB)
π
gencrt
(6.26 KB)
π
generate_account_suspension_include
(5.7 KB)
π
generate_google_drive_credentials
(1.11 KB)
π
generate_google_drive_oauth_uri
(984 B)
π
generate_maildirsize
(13.94 KB)
π
gensysinfo
(1.16 KB)
π
get_locale_from_legacy_name_info
(1.99 KB)
π
getremotecpmove
(12.67 KB)
π
grpck
(1.19 KB)
π
hackcheck
(3.02 KB)
π
hook
(1.45 KB)
π
httpspamdetect
(2.66 KB)
π
hulk-unban-ip
(3.93 MB)
π
import_exim_data
(8.39 KB)
π
importmydnsdb
(11.34 KB)
π
increase_filesystem_limits
(891 B)
π
initacls
(4.99 KB)
π
initfpsuexec
(444 B)
π
initquotas
(19.47 KB)
π
initsuexec
(4.03 KB)
π
install_cpanel_analytics
(1.93 KB)
π
install_dovecot_fts
(1.57 KB)
π
install_plugin
(2.8 KB)
π
installpkg
(575 B)
π
installpostgres
(6.56 KB)
π
installsqlite3
(1.82 KB)
π
ipcheck
(3.93 KB)
π
ipusage
(7.45 KB)
π
isdedicatedip
(602 B)
π
jetbackup-check
(3.69 KB)
π
killdns
(422 B)
π
killdns-dnsadmin
(1.15 KB)
π
killmysqluserprivs
(433 B)
π
killmysqlwildcard
(1.15 KB)
π
killpvhost
(853 B)
π
killspamkeys
(937 B)
π
link_3rdparty_binaries
(1.24 KB)
π
linksubemailtomainacct
(3.17 KB)
π
listcheck
(538 B)
π
listsubdomains
(1.05 KB)
π
litespeed-check
(3.86 KB)
π
locale_export
(4.82 KB)
π
locale_import
(4.35 KB)
π
locale_info
(3.99 KB)
π
logo.dat
(205 B)
π
magicloader
(1.94 KB)
π
maildir_converter
(6.08 KB)
π
mailperm
(16.58 KB)
π
mailscannerupdate
(2.42 KB)
π
mainipcheck
(10 KB)
π
maintenance
(46.62 KB)
π
make_config
(407 B)
π
make_hostname_unowned
(1.16 KB)
π
manage_extra_marketing
(12.41 KB)
π
manage_greylisting
(16.19 KB)
π
manage_mysql_profiles
(20.02 KB)
π
migrate-pdns-conf
(9.83 KB)
π
migrate_local_ini_to_php_ini
(7.41 KB)
π
migrate_whmtheme_file_to_userdata
(2.95 KB)
π
mkwwwacctconf
(2.33 KB)
π
modify_accounts
(4.09 KB)
π
modify_featurelist
(9.2 KB)
π
modify_packages
(3.65 KB)
π
modsec_vendor
(15.63 KB)
π
mysqlconnectioncheck
(6.55 KB)
π
mysqlpasswd
(4.09 KB)
π
named.ca
(1.57 KB)
π
named.rfc1912.zones
(774 B)
π
nixstatsagent.sh
(58.67 KB)
π
notify_expiring_certificates
(9.37 KB)
π
notify_expiring_certificates_on_linked_nodes
(1.33 KB)
π
oopscheck
(1.12 KB)
π
optimize_eximstats
(3.88 KB)
π
patch_mail_spamassassin_compiledregexps_body_0
(2.39 KB)
π
patchfdsetsize
(2.72 KB)
π
pedquota
(2.26 KB)
π
perform_sqlite_auto_rebuild_db_maintenance
(2.2 KB)
π
perlinstaller
(528 B)
π
perlmods
(1.18 KB)
π
php_fpm_config
(9.73 KB)
π
php_sandbox
π
phpini_tidy
(687 B)
π
pkgacct
(87.82 KB)
π
post_snapshot
(3.16 KB)
π
post_sync_cleanup
(6.09 KB)
π
primary_virtual_host_migration
(2.44 KB)
π
process_pending_cpanel_php_pear_registration
(3.49 KB)
π
process_site_templates
(7.27 KB)
π
proxydomains
(9.34 KB)
π
ptycheck
(724 B)
π
purge_modsec_log
(1.53 KB)
π
purge_old_config_caches
(2.08 KB)
π
pwck
(708 B)
π
quickdnslookup
(1.13 KB)
π
quickwhoisips
(2.29 KB)
π
quota_auto_fix
(1.41 KB)
π
quotacheck
(22.36 KB)
π
rawchpass
(460 B)
π
rdate
(4.8 KB)
π
realadduser
(5.61 KB)
π
realchpass
(3.26 KB)
π
realperlinstaller
(5.67 KB)
π
realrawchpass
(425 B)
π
rebuild_available_addons_packages_cache
(1.27 KB)
π
rebuild_available_rpm_addons_cache
(1.27 KB)
π
rebuild_bandwidthdb_root_cache
(1.45 KB)
π
rebuild_dbmap
(5.8 KB)
π
rebuild_provider_openid_connect_links_db
(1.01 KB)
π
rebuild_whm_chrome
(2.22 KB)
π
rebuilddnsconfig
(26.21 KB)
π
rebuildhttpdconf
(2.6 KB)
π
rebuildinstalledssldb
(2.85 KB)
π
rebuildippool
(509 B)
π
rebuildnsdzones
(1.14 KB)
π
rebuilduserssldb
(948 B)
π
refresh-dkim-validity-cache
(5.97 KB)
π
regenerate_tokens
(2.18 KB)
π
reloadnsd
(821 B)
π
remote_log_transfer
(11.6 KB)
π
remove_dovecot_index_files
(5.89 KB)
π
removeacct
(20.91 MB)
π
rescan_user_dovecot_fts
(2.98 KB)
π
reset_mail_quotas_to_sane_values
(6.82 KB)
π
resetmailmanurls
(2.03 KB)
π
resetquotas
(4.68 KB)
π
restartsrv
(3.23 KB)
π
restartsrv_apache
(422 B)
π
restartsrv_apache_php_fpm
(9.9 MB)
π
restartsrv_base
(9.9 MB)
π
restartsrv_bind
(9.9 MB)
π
restartsrv_chkservd
(427 B)
π
restartsrv_clamd
(9.9 MB)
π
restartsrv_cpanalyticsd
(9.9 MB)
π
restartsrv_cpanel_php_fpm
(9.9 MB)
π
restartsrv_cpanellogd
(9.9 MB)
π
restartsrv_cpdavd
(9.9 MB)
π
restartsrv_cpgreylistd
(9.9 MB)
π
restartsrv_cphulkd
(9.9 MB)
π
restartsrv_cpipv6
(9.9 MB)
π
restartsrv_cpsrvd
(9.9 MB)
π
restartsrv_crond
(9.9 MB)
π
restartsrv_dnsadmin
(9.9 MB)
π
restartsrv_dovecot
(9.9 MB)
π
restartsrv_exim
(9.9 MB)
π
restartsrv_eximstats
(504 B)
π
restartsrv_ftpd
(426 B)
π
restartsrv_ftpserver
(911 B)
π
restartsrv_httpd
(9.9 MB)
π
restartsrv_imap
(437 B)
π
restartsrv_inetd
(2.47 KB)
π
restartsrv_ipaliases
(9.9 MB)
π
restartsrv_lmtp
(437 B)
π
restartsrv_mailman
(9.9 MB)
π
restartsrv_mydns
(9.9 MB)
π
restartsrv_mysql
(9.9 MB)
π
restartsrv_named
(777 B)
π
restartsrv_nscd
(9.9 MB)
π
restartsrv_nsd
(9.9 MB)
π
restartsrv_p0f
(9.9 MB)
π
restartsrv_pdns
(9.9 MB)
π
restartsrv_pop3
(437 B)
π
restartsrv_postgres
(427 B)
π
restartsrv_postgresql
(9.9 MB)
π
restartsrv_powerdns
(442 B)
π
restartsrv_proftpd
(9.9 MB)
π
restartsrv_pureftpd
(9.9 MB)
π
restartsrv_queueprocd
(9.9 MB)
π
restartsrv_rsyslog
(9.9 MB)
π
restartsrv_rsyslogd
(437 B)
π
restartsrv_spamd
(9.9 MB)
π
restartsrv_sshd
(9.9 MB)
π
restartsrv_syslogd
(2.4 KB)
π
restartsrv_tailwatchd
(9.9 MB)
π
restartsrv_unknown
(9.9 MB)
π
restartsrv_xinetd
(422 B)
π
restorecpuserfromcache
(1.96 KB)
π
restorepkg
(36.49 MB)
π
rfc1912_zones.tar
(10 KB)
π
rpmup
(4.77 KB)
π
rsync-user-homedir.pl
(5.76 KB)
π
run_if_exists
(512 B)
π
run_plugin_lifecycle
(3.53 KB)
π
runstatsonce
(440 B)
π
runweblogs
(1.02 KB)
π
sa-update_wrapper
(3.34 KB)
π
safetybits.pl
(844 B)
π
secureit
(4.72 KB)
π
securemysql
(4.54 KB)
π
securerailsapps
(3.58 KB)
π
securetmp
(15.99 KB)
π
sendicq
(474 B)
π
servicedomains
(9.34 KB)
π
set_mailman_archive_perms
(1.75 KB)
π
set_php_memory_limits
(3.67 KB)
π
setpostgresconfig
(6.04 KB)
π
setup_greylist_db
(16.19 KB)
π
setup_modsec_db
(1.3 KB)
π
setup_systemd_timer_for_plugins
(3.92 KB)
π
setupftpserver
(10.47 KB)
π
setupmailserver
(9.55 KB)
π
setupnameserver
(13.75 KB)
π
shrink_modsec_ip_database
(12.97 KB)
π
simpleps
(3.05 KB)
π
slurp_exim_mainlog
(5.78 KB)
π
smartcheck
(15.13 KB)
π
smtpmailgidonly
(8.15 KB)
π
snapshot_prep
(5.88 KB)
π
spamassassin_dbm_cleaner
(5.85 KB)
π
spamassassindisable
(3.74 KB)
π
spamboxdisable
(2.27 KB)
π
sshcontrol
(14.38 KB)
π
ssl_crt_status
(3.84 KB)
π
suspendacct
(18.01 KB)
π
suspendmysqlusers
(4.42 KB)
π
swapip
(3.82 KB)
π
sync-mysql-users-from-grants
(1.2 KB)
π
sync_child_accounts
(1.77 KB)
π
sync_contact_emails_to_cpanel_users_files
(1.14 KB)
π
synccpaddonswithsqlhost
(6.59 KB)
π
synctransfers
(1.92 KB)
π
syslog_check
(1.36 KB)
π
sysup
(645 B)
π
test_sa_compiled
(1.07 KB)
π
transfer_account_as_user
(2.34 KB)
π
transfer_accounts_as_root
(4.76 KB)
π
transfer_in_progress
(3.08 KB)
π
transfer_in_progress.pod
(312 B)
π
transfermysqlusers
(9.53 MB)
π
try-later
(7.95 KB)
π
unblockip
(667 B)
π
uninstall_cpanel_analytics
(1.2 KB)
π
uninstall_dovecot_fts
(562 B)
π
uninstall_plugin
(2.84 KB)
π
unlink_service_account
(2.62 KB)
π
unpkgacct
(4.6 KB)
π
unslavenamedconf
(863 B)
π
unsuspendacct
(17.8 KB)
π
unsuspendmysqlusers
(6.71 KB)
π
upcp
(31.56 KB)
π
upcp-running
(2.7 KB)
π
upcp.static
(708.6 KB)
π
update-packages
(4.77 KB)
π
update_apachectl
(480 B)
π
update_db_cache
(430 B)
π
update_dkim_keys
(1.45 KB)
π
update_exim_rejects
(1.21 KB)
π
update_existing_mail_quotas_for_account
(4.78 KB)
π
update_known_proxy_ips
(1002 B)
π
update_local_rpm_versions
(4.56 KB)
π
update_mailman_cache
(8.34 KB)
π
update_mysql_systemd_config
(1.25 KB)
π
update_neighbor_netblocks
(487 B)
π
update_sa_config
(2.14 KB)
π
update_spamassassin_config
(10.73 KB)
π
update_users_jail
(691 B)
π
update_users_vhosts
(801 B)
π
updatedomainips
(605 B)
π
updatenameserverips
(1.66 KB)
π
updatenow
(5.18 KB)
π
updatenow.static
(1.91 MB)
π
updatesigningkey
(1.95 KB)
π
updatessldomains
(1.81 KB)
π
updatesupportauthorizations
(2.49 KB)
π
updateuserdatacache
(2.47 KB)
π
updateuserdomains
(774 B)
π
upgrade_bandwidth_dbs
(2.22 KB)
π
upgrade_subaccount_databases
(2.73 KB)
π
userdata_wildcard_cleanup
(5.74 KB)
π
userdirctl
(5.01 KB)
π
validate_sshkey_passphrase
(1.21 KB)
π
verify_api_spec_files
(757 B)
π
verify_pidfile
(1.96 KB)
π
verify_vhost_includes
(7.34 KB)
π
vps_optimizer
(7.82 KB)
π
vzzo-fixer
(725 B)
π
whmlogin
(2.33 KB)
π
whoowns
(1.13 KB)
π
wpt_license
(6.27 MB)
π
wwwacct
(24.57 MB)
π
wwwacct2
(88 B)
π
xfer_rcube_schema_migrate.pl
(2.4 KB)
π
xfer_rcube_uid_resolver.pl
(1.8 KB)
π
xferpoint
(3.13 KB)
π
xfertool
(16.14 KB)
π
zoneexists
(800 B)
Editing: sshcontrol
#!/usr/local/cpanel/3rdparty/bin/perl # cpanel - scripts/sshcontrol Copyright 2022 cPanel, L.L.C. # All rights reserved. # copyright@cpanel.net http://cpanel.net # This code is subject to the cPanel license. Unauthorized copying is prohibited #---------------------------------------------------------------------- # This script controls a Net::OpenSSH session. # #It can authenticate a connection via password or SSH private key. # #It can connect via: # 1) root login # 2) user login, then su to root # 3) user login, then sudo to root # #Additionally, existing connections may persist and be reused. # #Once connected, it can: # 1) copy a file from/to local/remote # 2) AS ROOT: execute an arbitrary command on the remote server # #Inputs: # key/value are read from STDIN as a hash, # serialized with Cpanel::AdminBin::Serializer::Dump() # # # Required arguments: # authuser The user as which to identify during the SSH login. # # host The remote host. # # ctl "ssh" or (usually "scp", but anything defined will do) # # # Additional, optional arguments: # external_master ctl_pass parameter for Net::OpenSSH # Required if die_on_pid is not given. # # die_on_pid ID of a specific process for the SSH control process # to watch and self-destruct upon the end of that # process. Defaults to the script's process ID. # # port passed to Net::OpenSSH # # root_pass If authuser is "root", used to login; # otherwise, used to escalate privileges via su. # (Donβt submit if you mean to do sudo.) # # ssh_private_key_password passphrase for sshkey # # sshkey filename under $HOME/.ssh/ # # stay_alive boolean; whether to keep the SSH control # process around and pass back its PID and # path in the response # # wheel_pass Used to login as a non-root user. # If there is no root_pass, also used to escalate # privileges via sudo. # # # Additional arguments when ctl is "ssh": # cmd if ctl is "ssh", executed AS ROOT on the remote server # # # Additional arguments when ctl is "scp": # destfile if ctl ne "ssh", passed to Cpanel::SSHControl::scp # NOTE: If ".", value is read from the last node in the # path from srcfile # # direction if ctl ne "ssh", passed to Cpanel::SSHControl::scp # # srcfile if ctl ne "ssh", passed to Cpanel::SSHControl::scp # # #Output: # This speaks the "protocol" that Whostmgr/Remote/Parser.pm understands. # Note that this prints even error statuses to STDOUT. # #---------------------------------------------------------------------- package Script::SSHControl; use strict; use warnings; use IO::Pipe (); use Cpanel::AdminBin::Serializer (); use Cpanel::ForkAsync (); use Cpanel::SSHControl (); use Cpanel::Locale::Lazy 'lh'; use Cpanel::TimeHiRes (); use Cpanel::Exception (); use Cpanel::Sys::Setsid::Fast (); use Cpanel::BinCheck::Lite (); my $ONEDAY = (86400); my @REQUIRED_ARGS = qw( authuser host ctl ); Cpanel::BinCheck::Lite::check_argv(); my $debug = 0; __PACKAGE__->script() unless caller(); sub script { ## no critic qw(Subroutines::ProhibitExcessComplexity) my ($class) = @_; local $| = 1; local $ENV{'TERM'} = 'dumb'; my $self = {}; bless $self, $class; my $parsed_args = Cpanel::AdminBin::Serializer::SafeLoadFile( \*STDIN ); my @missing = grep { !length $parsed_args->{$_} } @REQUIRED_ARGS; if (@missing) { _leave( lh()->maketext( 'Specify the [list_and_quoted,_1] [numerate,_2,parameter,parameters].', \@missing, ( scalar @missing ) ) ); } my $escalation_method; if ( $parsed_args->{'root_escalation_method'} && $parsed_args->{'root_escalation_method'} eq 'none' ) { $escalation_method = 'none'; } else { # NB: Avoid length() here because we want to interpret # root_pass==0 as no root password. my $gave_root_pass = !!$parsed_args->{'root_pass'}; if ( length $parsed_args->{'wheel_pass'} ) { if ( $parsed_args->{'authuser'} eq 'root' ) { _leave( lh()->maketext( 'If β[_1]β is β[_2]β, you cannot specify β[_3]β.', qw(authuser root wheel_pass) ) ); } # Just a wheel/sudo password? Gotta be sudo. if ( !$gave_root_pass ) { $escalation_method = 'sudo'; } } # Root password + non-root = su if ($gave_root_pass) { if ( $parsed_args->{'authuser'} ne 'root' ) { $escalation_method = 'su'; } } } my $cmd = $parsed_args->{'cmd'}; my $ssh_key = $parsed_args->{'sshkey'} ? ( ( getpwuid($>) )[7] . "/.ssh/" . $parsed_args->{sshkey} ) : undef; my $ssh_username = $parsed_args->{'authuser'}; $parsed_args->{'die_on_pid'} ||= $$; my $auth_info = { 'ssh_username' => $ssh_username, 'ssh_ip' => $parsed_args->{'host'}, 'ssh_port' => $parsed_args->{'port'}, 'root_pass' => $parsed_args->{'root_pass'} || ( $ssh_username eq 'root' ? $parsed_args->{'wheel_pass'} : undef ), 'wheel_pass' => $parsed_args->{'wheel_pass'}, 'ssh_private_key_password' => $parsed_args->{'ssh_private_key_password'}, 'root_escalation_method' => $escalation_method, 'ssh_private_key' => $ssh_key, 'key_or_pass' => ( $ssh_key ? 1 : 0 ), }; my ( $status, $master_pid, $data ); my $ssh_obj; if ( $parsed_args->{'external_master'} ) { $0 = "sshcontrol parent: $auth_info->{'ssh_ip'} - external master"; $ssh_obj = Net::OpenSSH->new( 'child', external_master => 1, ctl_path => $parsed_args->{'external_master'} ); } else { $0 = "sshcontrol parent: $auth_info->{'ssh_ip'} - create connection"; } my $keep_ssh_master = $parsed_args->{'stay_alive'} ? 1 : 0; if ( $ssh_obj && $ssh_obj->check_master() ) { print "Reused existing connection.\n"; $0 = "sshcontrol parent: $auth_info->{'ssh_ip'} - reused external master"; } else { $0 = "sshcontrol parent: $auth_info->{'ssh_ip'} - creating connection"; if ( $parsed_args->{'external_master'} ) { $keep_ssh_master = 1; } ( $status, $master_pid, $data ) = $self->_create_ssh_master_connection( $auth_info, $parsed_args->{'die_on_pid'} ); if ( !$status ) { _ssh_error_to_whm_remote_error_and_leave($data); } $ssh_obj = Net::OpenSSH->new( 'child', external_master => 1, ctl_path => $data ); } if ( $ssh_obj->error() ) { my $ssh_error = $ssh_obj->error(); _ssh_error_to_whm_remote_error_and_leave($ssh_error); } $0 = "sshcontrol parent: $auth_info->{'ssh_ip'} - attaching to external"; my $ssh_control = Cpanel::SSHControl->new_from_external( 'debug' => 0, 'quiet' => 0, 'verbose' => 0, 'auth_info' => $auth_info, 'ssh' => $ssh_obj ); $0 = "sshcontrol parent: $auth_info->{'ssh_ip'} - attached to external"; $SIG{'TERM'} = sub { $ssh_control->disconnect(); }; if ( $parsed_args->{ctl} eq 'ssh' ) { $0 = "sshcontrol parent: $auth_info->{'ssh_ip'} - ssh"; my ( $status, $msg ) = $ssh_control->exec_as_root($cmd); if ( !$status ) { _ssh_error_to_whm_remote_error_and_leave($msg); } } elsif ( $parsed_args->{'ctl'} eq 'scp' ) { $0 = "sshcontrol parent: $auth_info->{'ssh_ip'} - scp"; my $destfile = $parsed_args->{'destfile'} eq '.' ? ( split( m{/+}, $parsed_args->{'srcfile'} ) )[-1] : $parsed_args->{'destfile'}; my ( $status, $msg ) = $ssh_control->scp( 'direction' => $parsed_args->{'direction'}, 'srcfile' => $parsed_args->{'srcfile'}, 'destfile' => $destfile, ); if ( !$status ) { _ssh_error_to_whm_remote_error_and_leave($msg); } elsif ( $parsed_args->{'direction'} eq 'download' && !-e $destfile ) { _ssh_error_to_whm_remote_error_and_leave("The destination file: β$destfileβ failed to download."); } } else { die "Invalid βctlβ: [$parsed_args->{'ctl'}]"; } $self->_write_sshcontrol_info( $master_pid, $ssh_obj ); if ( !$keep_ssh_master || !$master_pid ) { $ssh_control->disconnect_master(); } undef $ssh_obj; return $self; } sub _write_sshcontrol_info { my ( $self, $master_pid, $ssh_obj ) = @_; if ($master_pid) { print "\n==sshcontrolpid=$master_pid==\n"; } print "\n==sshcontrolpath=" . $ssh_obj->get_ctl_path() . "==\n"; return; } sub _leave { my @args = @_; print @args; die "\n"; } sub _create_ssh_master_connection { my ( $self, $auth_info, $die_on_pid ) = @_; my $ssh_pipe = IO::Pipe->new(); my $child_result; my $sshcontrol_pid = Cpanel::ForkAsync::do_in_child( sub { $ssh_pipe->writer(); open( STDOUT, '>&=' . fileno($ssh_pipe) ); ## no critic qw(RequireCheckedOpen) if ($die_on_pid) { $0 = "sshcontrol child: $auth_info->{'ssh_ip'} - waiting on pid $die_on_pid"; } else { $0 = "sshcontrol child: $auth_info->{'ssh_ip'}"; } my $ssh_control = Cpanel::SSHControl->new( 'debug' => 0, 'quiet' => 0, 'verbose' => 0, 'auth_info' => $auth_info ); { local $@; eval { $ssh_control->connect() }; if ($@) { my $error_as_string = Cpanel::Exception::get_string_no_id($@); $error_as_string =~ s/\n/ /g; # This is going to the parent print "\nsshcontrol:0:" . $error_as_string . "\n"; exit(1); } } my $master_pid = $ssh_control->{'ssh'}->get_master_pid(); if ( !$master_pid ) { print "\nsshcontrol:0:failed to create sshcontrol master\n"; exit(1); } $SIG{'HUP'} = 'IGNORE'; $SIG{'ALRM'} = $SIG{'TERM'} = sub { $ssh_control->disconnect_master(); exit(0); }; # This is going to the parent print "\nsshcontrol:1:" . $ssh_control->{'ssh'}->get_ctl_path() . "\n"; Cpanel::Sys::Setsid::Fast::fast_setsid(); open( STDIN, '<', '/dev/null' ); ## no critic qw(RequireCheckedOpen) open( STDOUT, '>', '/dev/null' ); ## no critic qw(RequireCheckedOpen) open( STDERR, '>', '/dev/null' ); ## no critic qw(RequireCheckedOpen) alarm($ONEDAY); # If something gets killed off expire in one day while ( waitpid( $master_pid, 1 ) != -1 && kill( 0, $die_on_pid ) ) { Cpanel::TimeHiRes::sleep(0.1); } $ssh_control->disconnect_master(); waitpid( $master_pid, 0 ); exit(0); } ); $ssh_pipe->reader(); while ( readline($ssh_pipe) ) { if (m{^sshcontrol:}) { $child_result = $_; last; } print; } chomp($child_result); my ( $sshcontrol_tag, $status, $data ) = split( m{:}, $child_result, 3 ); return ( $status, $sshcontrol_pid, $data ); } my @SSH_ERRORS; sub _ssh_error_to_whm_remote_error_and_leave { my ($ssh_error) = @_; if ( !@SSH_ERRORS ) { @SSH_ERRORS = ( [ qr{master process exited unexpectedly:\s+([^:]+).*?No such file or directory} => 'RemoteSSHMissing' ], [ qr{No such file or directory} => 'RemoteSSHMissing' ], [ qr{normalize shell} => 'RemoteSSHMissing' ], [ qr{Name or service not known} => 'RemoteSSHHostNotFound' ], [ qr{Connection timed out} => 'RemoteSSHTimeout' ], [ qr{(scp failed)} => 'RemoteSCPError' ], [ qr{(^scp:.*)} => 'RemoteSCPError' ], [ qr{(Connection (?:to [^ ]+? )?closed)} => 'RemoteSSHConnectionFailed' ], [ qr{(No route to host)} => 'RemoteSSHConnectionFailed' ], [ qr{(Connection refused)} => 'RemoteSSHConnectionFailed' ], [ qr{(lost connection)} => 'RemoteSSHConnectionFailed' ], [ qr{(Failed to escalate to root)}i => 'RemoteSSHRootEscalationFailed' ], [ qr{(timeout)}i => 'RemoteSSHTimeout' ], [ qr{master process exited unexpectedly:\s+(.*)} => 'RemoteSSHAccessDenied' ], #A catch-all, must be last. [ qr<> => 'RemoteSSHAccessDenied' ], ); } for my $re_code (@SSH_ERRORS) { if ( $ssh_error =~ $re_code->[0] ) { my $raw_error = $1 || $ssh_error; $raw_error =~ s/=//g; $raw_error =~ s/\r*\n/ /g; _leave("\n==sshcontrol_error=$re_code->[1]=$raw_error==\n"); } } # If we did not parse the error, we need to show it # but only if we haven't already to avoid showing it twice print $ssh_error . "\n"; #This error is meant to look a bit more "professional" than #"Oops! We should never get here!". :) die "Misdirected execution flow!"; } 1;
Upload File
Create Folder