Lua

Check Whether an SSH Exit Status Was Received

Demonstrates the Chilkat Ssh.ChannelReceivedExitStatus method, which reports whether the server supplied an exit-status value for a channel. The only argument is the channel number. When it returns true, call GetChannelExitStatus to read the value.

Background: Always test this before reading the exit status, because the server is not required to send one for every channel type or command — treating a missing status as "0" would silently turn a failure into a success. Exit status is independent of EOF and CLOSE: it can arrive after EOF and either before or together with CLOSE.

Chilkat Lua Downloads

Download Chilkat for Lua

Lua

local chilkat = require("chilkat")

-- Demonstrates the Ssh.ChannelReceivedExitStatus method, which reports whether the server
-- supplied an exit-status value for a channel.  The only argument is the channel number.  When
-- it returns true, call GetChannelExitStatus to read the value.

local ssh = chilkat.Ssh.new()

local sshPort = 22
local success = ssh:connect("ssh.example.com", sshPort)
if not success then
    print(ssh.last_error_text)
    return
end

-- 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.
local password = "mySshPassword"

success = ssh:authenticate_pw("mySshLogin", password)
if not success then
    print(ssh.last_error_text)
    return
end

local channelNum = ssh:open_session_channel()
if channelNum < 0 then
    print(ssh.last_error_text)
    return
end

success = ssh:send_req_exec(channelNum, "test -f /etc/hosts")
if not success then
    print(ssh.last_error_text)
    return
end

-- 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.
ssh.read_timeout_ms = 15000

success = ssh:channel_receive_to_close(channelNum)
if not success then
    print(ssh.last_error_text)
    return
end

-- The server is not required to send an exit status for every channel type or command.
if ssh:channel_received_exit_status(channelNum) then
    local exitStatus = ssh:get_channel_exit_status(channelNum)
    print("Exit status: " .. exitStatus)
else
    print("The server did not provide an exit status.")
end

ssh:disconnect()