Xbase++

Check the SSH Connection (IsConnected)

Demonstrates how to check whether the connection to the SSH server still exists. The IsConnected property is checked first, and SendIgnore is then used to confirm the link for certain.

Background: These checks differ in strength. IsConnected simply reports the state the object already knows and involves no network activity, so it can stay true after a silent network failure the operating system has not yet noticed. SendIgnore sends an SSH IGNORE message — discarded by the peer by design — which exercises the real write path and is therefore much stronger evidence the link is usable. CheckConnection sits between the two, peeking at the socket without sending anything.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oSsh
LOCAL nPort
LOCAL nConnected

nSuccess := 0

//  Demonstrates how to check whether the connection to the SSH server still exists.

oSsh := CreateObject("Chilkat.Ssh")

nPort := 22
nSuccess := oSsh:Connect("ssh.example.com", nPort)
IF (nSuccess == 0)
    ? oSsh:LastErrorText
    oSsh:destroy()
    RETURN
ENDIF

//  IsConnected reports the state already known to the Ssh object.  It does not perform a
//  network round trip.
nConnected := oSsh:IsConnected
IF (nConnected)
    //  Verify for certain by sending an SSH IGNORE message, which exercises the actual write
    //  path.  The server sends no reply, but a successful send proves the link is writable.
    nConnected := oSsh:SendIgnore()
ENDIF

? "connected = " + Str(nConnected)

oSsh:Disconnect()

//  After disconnecting, the object reports that it is no longer connected.
nConnected := oSsh:IsConnected
? "connected = " + Str(nConnected)

oSsh:destroy()