Tcl

Upload Bytes to an SFTP Server (BinData)

Demonstrates the Chilkat SFtp.UploadBd method, which uploads all bytes in a BinData to a remote file. The first argument is the BinData and the second is the remote file path.

Note: This example uses relative local paths, which are resolved against the application's current working directory. Absolute local paths may also be used. Supply the paths appropriate to your own environment.

Background: When the content you want to upload is already in memory — generated on the fly, decompressed, decrypted, or pulled from a database blob — UploadBd sends it directly without first writing a temporary local file. If the destination already exists it is truncated before the new bytes are written, so the result is exactly the BinData contents.

Chilkat Tcl Downloads

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

set success 0

#  Demonstrates the SFtp.UploadBd method, which uploads all bytes in a BinData to a remote file.
#  The 1st argument is the BinData and the 2nd is the remote file path.

set sftp [new_CkSFtp]

#  Connect, authenticate, and initialize the SFTP subsystem.
set port 22
set success [CkSFtp_Connect $sftp "sftp.example.com" $port]
if {$success == 0} then {
    puts [CkSFtp_lastErrorText $sftp]
    delete_CkSFtp $sftp
    exit
}

#  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.
set password "mySshPassword"

set success [CkSFtp_AuthenticatePw $sftp "mySshLogin" $password]
if {$success == 0} then {
    puts [CkSFtp_lastErrorText $sftp]
    delete_CkSFtp $sftp
    exit
}

set success [CkSFtp_InitializeSftp $sftp]
if {$success == 0} then {
    puts [CkSFtp_lastErrorText $sftp]
    delete_CkSFtp $sftp
    exit
}

#  Put the bytes to upload into a BinData.  (Here they are loaded from a local file, but the
#  bytes could come from anywhere.)
set bd [new_CkBinData]

set success [CkBinData_LoadFile $bd "qa_data/image.png"]
if {$success == 0} then {
    puts [CkBinData_lastErrorText $bd]
    delete_CkSFtp $sftp
    delete_CkBinData $bd
    exit
}

#  Upload the bytes.  If the remote file exists, it is truncated first.
set success [CkSFtp_UploadBd $sftp $bd "subdir/image.png"]
if {$success == 0} then {
    puts [CkSFtp_lastErrorText $sftp]
    delete_CkSFtp $sftp
    delete_CkBinData $bd
    exit
}

puts "Uploaded [CkBinData_get_NumBytes $bd] bytes."

CkSFtp_Disconnect $sftp

delete_CkSFtp $sftp
delete_CkBinData $bd