Lua

Clear the FTP Session Log

Demonstrates the Chilkat Ftp2.ClearSessionLog method, which clears the in-memory FTP protocol log collected while KeepSessionLog is enabled. It takes no arguments.

Background: With session logging on, the SessionLog accumulates the full FTP command/reply conversation, which is invaluable for diagnosing a failed transfer. Over a long-lived session it grows unbounded, so clearing it frees memory — and, more usefully, lets you capture the log for one specific operation in isolation by clearing just before and reading just after.

Chilkat Lua Downloads

Download Chilkat for Lua

Lua

local chilkat = require("chilkat")

-- Demonstrates the Ftp2.ClearSessionLog method, which clears the in-memory FTP protocol log.  It
-- takes no arguments and is a void method.

local ftp = chilkat.Ftp2.new()

ftp.hostname = "ftp.example.com"
ftp.username = "myFtpLogin"

-- 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.
ftp.password = "myPassword"

local success = ftp:connect()
if not success then
    print(ftp.last_error_text)
    return
end

-- The SessionLog accumulates the FTP protocol conversation when KeepSessionLog is enabled, which
-- is useful for debugging.
ftp.keep_session_log = true

-- ... perform some operations ...

-- Clear the log, for example before starting a new logical operation whose log you want to
-- capture in isolation.
ftp:clear_session_log()
print("Session log cleared.")

success = ftp:disconnect()
if not success then
    print(ftp.last_error_text)
    return
end