B4X

Send a Signal to a Remote SSH Process

Demonstrates the Chilkat Ssh.SendReqSignal method, which requests delivery of a signal to the remote process running on a channel. The first argument is the channel number and the second is the signal name. Send it after the process has started.

Background: This is the SSH equivalent of pressing Ctrl+C or running kill — it lets a client interrupt or terminate a long-running remote command without tearing down the connection. Signal names are given without the SIG prefix (INT, TERM, KILL, and so on). Note that some servers, including common OpenSSH builds, do not implement signal delivery.

Chilkat B4X Downloads

Download Chilkat for B4X

B4X

Dim success As Boolean = False

'  Demonstrates the Ssh.SendReqSignal method, which requests delivery of a signal to the remote
'  process running on a channel.  The 1st argument is the channel number and the 2nd is the
'  signal name.  Send it after the process has started.

Dim ssh As ChilkatSsh
ssh.Initialize("ssh")

Dim sshPort As Int = 22
success = ssh.Connect("ssh.example.com", sshPort)
If success = False Then
    Log(ssh.LastErrorText)
    Return
End If


'  Normally you would not hard-code the password in source.  You should instead obtain it
'  from an interactive prompt, environment variable, or a secrets vault.
Dim password As String = "mySshPassword"

success = ssh.AuthenticatePw("mySshLogin", password)
If success = False Then
    Log(ssh.LastErrorText)
    Return
End If


'  Open a session channel.  A negative return value indicates failure.
Dim channelNum As Int = ssh.OpenSessionChannel
If channelNum < 0 Then
    Log(ssh.LastErrorText)
    Return
End If


'  Start a long-running command.
success = ssh.SendReqExec(channelNum, "sleep 60")
If success = False Then
    Log(ssh.LastErrorText)
    Return
End If


'  Send an interrupt signal to the remote process.  The name omits the "SIG" prefix.
success = ssh.SendReqSignal(channelNum, "INT")
If success = False Then
    Log(ssh.LastErrorText)
    Return
End If

Log("Signal sent.")

ssh.Disconnect