Lianja

SSH Remote Shell

Demonstrates starting a shell on a remote SSH server, running a command, and retrieving the output. The example sends the command, signals EOF so the server knows no more input is coming, and then receives the remaining output until the channel closes.

Background: A shell channel differs from an exec channel in that it stays open for a stream of commands rather than running just one. No PTY is requested here, which is the recommended approach for automation: the shell detects a raw pipe and runs non-interactively, so no prompt is printed and typed commands are not echoed. Sending EOF is the SSH equivalent of Ctrl+D — it closes only the client-to-server direction, so output can still be received afterward, and it prompts the server to finish up and close the channel.

Chilkat Lianja Downloads

Download Chilkat for Lianja

Lianja

llSuccess = .F.

//  This example requires the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

//  Demonstrates starting a shell on a remote SSH server, running a command, and retrieving the
//  output.  No PTY is requested, which is the recommended approach for automation.

loSsh = createobject("CkSsh")

lcHostname = "ssh.example.com"
lnPort = 22
llSuccess = loSsh.Connect(lcHostname,lnPort)
if (llSuccess = .F.) then
    ? loSsh.LastErrorText
    release loSsh
    return
endif

//  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.
lcPassword = "mySshPassword"

llSuccess = loSsh.AuthenticatePw("mySshLogin",lcPassword)
if (llSuccess = .F.) then
    ? loSsh.LastErrorText
    release loSsh
    return
endif

lnChannelNum = loSsh.OpenSessionChannel()
if (lnChannelNum < 0) then
    ? loSsh.LastErrorText
    release loSsh
    return
endif

//  Start a shell WITHOUT requesting a PTY.  Without a PTY the shell sees it is connected to a
//  raw data pipe and enters non-interactive mode: it suppresses the command prompt, does not
//  echo typed commands back, and skips interactive login scripts.  The output is therefore
//  clean and easily parseable -- but because no prompt is ever sent, code must not wait for
//  one.  Instead, have each command print a predictable marker, or wait for EOF / channel close.
llSuccess = loSsh.SendReqShell(lnChannelNum)
if (llSuccess = .F.) then
    ? loSsh.LastErrorText
    release loSsh
    return
endif

//  Send the command.  The trailing newline is required -- the shell acts on a line at a time.
llSuccess = loSsh.ChannelSendString(lnChannelNum,"ls -l /tmp" + Chr(10),"utf-8")
if (llSuccess = .F.) then
    ? loSsh.LastErrorText
    release loSsh
    return
endif

//  Send EOF to tell the server no more input is coming.  The channel stays open and output can
//  still be received.
llSuccess = loSsh.ChannelSendEof(lnChannelNum)
if (llSuccess = .F.) then
    ? loSsh.LastErrorText
    release loSsh
    return
endif

//  IMPORTANT: Set a read timeout.  ReadTimeoutMs defaults to 0, which means no limit -- without
//  it, this call waits forever if the server never sends channel close.
loSsh.ReadTimeoutMs = 15000

//  Receive the remaining output until the server closes the channel.
llSuccess = loSsh.ChannelReceiveToClose(lnChannelNum)
if (llSuccess = .F.) then
    ? loSsh.LastErrorText
    release loSsh
    return
endif

lcCmdOutput = loSsh.GetReceivedText(lnChannelNum,"utf-8")
if (loSsh.LastMethodSuccess = .F.) then
    ? loSsh.LastErrorText
    release loSsh
    return
endif

? lcCmdOutput

loSsh.Disconnect()


release loSsh