protected val GET_CURRENT_HOST_STATS: String = "echo -e "$(top -bn1 | grep 'Cpu(s)' | awk '{print 100 - $8}'), $(if ls /sys/devices/system/cpu/cpu*/cpufreq/scaling_cur_freq &>/dev/null; then freq=$(awk '{s+=$1} END {print s/NR/1000000}' /sys/devices/system/cpu/cpu*/cpufreq/scaling_cur_freq); printf "%.2f" $freq; else freq=$(lscpu | grep 'CPU MHz' | awk '{print $3/1000}'); printf "%.2f" $freq; fi), $(free -b | awk '/Mem:/ {printf "%.2f/%.2f\n", $3/1073741824, $2/1073741824}'), $(df --block-size=1G --total | awk '/total/ {printf "%d/%d\n", $3, $2}'), $(if lsblk -d -o NAME | grep -q mmcblk; then echo "SD_CARD"; elif lsblk -d -o NAME | grep -q nvme; then echo "SSD_NVMe"; elif lsblk -d -o NAME | grep -q vda; then echo "VIRTUAL_DISK"; elif lsblk -d -o ROTA | awk 'NR>1' | grep -q 0; then echo "SSD"; else echo "HARD_DISK"; fi)" "

GET_CURRENT_HOST_STATS the bash command used to retrieve the current stats of the physical machine of the host

GREP_RUNNING_SERVICES_COMMAND

protected val GREP_RUNNING_SERVICES_COMMAND: String = " ps -ef | grep -E %s | grep -v grep | awk '{print $2}' | paste -sd ',' "

GREP_RUNNING_SERVICES_COMMAND the bash command used to retrieve all the running services on a host and format their pids as list comma separated

KILL_SERVICE

protected val KILL_SERVICE: String = "kill %s"

KILL_SERVICE the bash command used to kill a service currently running on the host

NOHUP_OUT_FILE

protected val NOHUP_OUT_FILE: String = "nohup.out"

NOHUP_OUT_FILE the pathname of the generated nohup.

PIPE_CHARACTER

protected val PIPE_CHARACTER: String = "|"

PIPE_CHARACTER constant value for the pipe character

REMOVE_FILE_COMMAND

protected val REMOVE_FILE_COMMAND: String = "rm %s"

REMOVE_FILE_COMMAND the bash command used to remove a file from the filesystem of the host

REMOVE_NOHUP_OUT_FILE_COMMAND

protected val REMOVE_NOHUP_OUT_FILE_COMMAND: String = "rm -f %s"

REMOVE_NOHUP_OUT_FILE_COMMAND the bash command used to remove the NOHUP_OUT_FILE from the host

SERVICE_STARTER_SCRIPT

private val SERVICE_STARTER_SCRIPT: String = "service-starter.sh"

SERVICE_STARTER_SCRIPT the pathname of the script used to start the services

SUDO_REBOOT

protected val SUDO_REBOOT: String = "sudo reboot"

SUDO_REBOOT the bash command used to reboot the physical machine of the host

SUDO_SHUTDOWN_NOW

protected val SUDO_SHUTDOWN_NOW: String = "sudo shutdown now"

SUDO_SHUTDOWN_NOW the bash command used to shut down the physical machine of the host

Functions

appendExitStatus

protected open fun appendExitStatus(errorMessage: String, exitStatus: Int): String

Method used to append the exit status of the command to the error result of the same command

detectStoppedServices

open fun detectStoppedServices(host: BrownieHost): Collection<Long>

Method used to detect the stopped services

execBashCommand

protected open fun execBashCommand(command: String, onCommandExecuted: ShellCommandsExecutor.OnCommandExecuted, closeSession: Boolean): String

protected open fun execBashCommand(command: String): String

protected open fun execBashCommand(command: String, closeSession: Boolean): String

protected open fun execBashCommand(command: String, onCommandExecuted: ShellCommandsExecutor.OnCommandExecuted): String

Method used to execute a bash command

execServiceStarter

protected open fun execServiceStarter(service: BrownieHostService, out: OutputStream)

Method used to execute the SERVICE_STARTER_SCRIPT script

extractServicePid

protected open fun extractServicePid(commandResult: String): Long

Method used to extract from the shell result the pid of the started process

findServicePath

open fun findServicePath(name: String): String

Method to find the path of the service using the FIND_SERVICE_PATH command

formatCommandResult

private open fun formatCommandResult(rawResult: InputStream): String

Method used to format a raw result of command execution

getCurrentHostStats

open fun getCurrentHostStats(): Array<String>

Method used to get the current stats of the host with the GET_CURRENT_HOST_STATS command

getInstance

open fun getInstance(host: BrownieHost): ShellCommandsExecutor

Method used to obtain a specific instance to correctly execute bash commands on hosts shells

purgeNohupOutIfRequired

protected open fun purgeNohupOutIfRequired(service: BrownieHostService)

Method used to purge the NOHUP_OUT_FILE when required

rebootHost

open fun rebootHost(service: HostsService, host: BrownieHost)

Method used to reboot the host using the SUDO_REBOOT command

rebootService

open fun rebootService(service: BrownieHostService, onCommandExecuted: ShellCommandsExecutor.OnCommandExecuted)

Method used to reboot a service

removeService

open fun removeService(serviceName: String, closeSession: Boolean): String

Method to simply remove a service from a host

startService

open fun startService(service: BrownieHostService): Long

Method used to start a service

stopHost

open fun stopHost(service: HostsService, host: BrownieHost)

Method used to stop the host using the SUDO_SHUTDOWN_NOW command

stopService

open fun stopService(service: BrownieHostService): String

open fun stopService(service: BrownieHostService, closeSession: Boolean): String

Method used to stop a service

Local Shell Commands Executor

Author

See also

Constructors

Properties

Functions