Lua

SFTP Upload - Synchronize Directory Tree

See more SFTP Examples

Demonstrates how to upload files to synchronize a local directory tree with a remote directory tree. The SyncTreeUpload method recursively descends a local directory tree and uploads files based on existence, last-mod date/time and/or size differences. Lua

local chilkat = require("chilkat")

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

local sftp = chilkat.SFtp.new()

local success = sftp:connect("my-ssh-server.com", 22)
if success then
    success = sftp:authenticate_pw("mySshLogin", "mySshPassword")
end

if success then
    success = sftp:initialize_sftp()
end

if not success then
    print(sftp.last_error_text)
    return
end

-- Synchronize (by uploading) the local directory tree rooted at "qa_data/sftpUploadTree"
-- with the remote directory tree rooted at "syncUploadTest"
-- Both directories are relative paths.  The remote directory
-- is relative to the HOME directory of the SSH user account.
-- The local directory is relative to the current working directory of the process.
-- It is also possible to use absolute paths.

local remoteDir = "syncUploadTest"
local localDir = "qa_data/sftpUploadTree"

-- Possible modes that can be passed to the SyncTreeUpload method are:
-- mode=0: Upload all files
-- mode=1: Upload all files that do not exist on the server.
-- mode=2: Upload newer or non-existant files.
-- mode=3: Upload only newer files. If a file does not already exist on the server, it is not uploaded.
-- mode=4: transfer missing files or files with size differences.
-- mode=5: same as mode 4, but also newer files.

-- This example will use mode 5 to upload missing, newer, or files with size differences.
local mode = 5
-- This example turns on recursion to synchronize the entire tree.
-- Recursion can be turned off to synchronize the files of a single directory.
local recursive = true
success = sftp:sync_tree_upload(localDir, remoteDir, mode, recursive)
if not success then
    print(sftp.last_error_text)
    return
end

print("Success.")