Upload Bytes to an SFTP Server (BinData)

See more SFTP Examples

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 C Downloads

Download Chilkat for C

#include <C_CkSFtp.h>
#include <C_CkBinData.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkSFtp sftp;
    int port;
    const char *password;
    HCkBinData bd;

    success = FALSE;

    //  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.

    sftp = CkSFtp_Create();

    //  Connect, authenticate, and initialize the SFTP subsystem.
    port = 22;
    success = CkSFtp_Connect(sftp,"sftp.example.com",port);
    if (success == FALSE) {
        printf("%s\n",CkSFtp_lastErrorText(sftp));
        CkSFtp_Dispose(sftp);
        return;
    }

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

    success = CkSFtp_AuthenticatePw(sftp,"mySshLogin",password);
    if (success == FALSE) {
        printf("%s\n",CkSFtp_lastErrorText(sftp));
        CkSFtp_Dispose(sftp);
        return;
    }

    success = CkSFtp_InitializeSftp(sftp);
    if (success == FALSE) {
        printf("%s\n",CkSFtp_lastErrorText(sftp));
        CkSFtp_Dispose(sftp);
        return;
    }

    //  Put the bytes to upload into a BinData.  (Here they are loaded from a local file, but the
    //  bytes could come from anywhere.)
    bd = CkBinData_Create();
    success = CkBinData_LoadFile(bd,"qa_data/image.png");
    if (success == FALSE) {
        printf("%s\n",CkBinData_lastErrorText(bd));
        CkSFtp_Dispose(sftp);
        CkBinData_Dispose(bd);
        return;
    }

    //  Upload the bytes.  If the remote file exists, it is truncated first.
    success = CkSFtp_UploadBd(sftp,bd,"subdir/image.png");
    if (success == FALSE) {
        printf("%s\n",CkSFtp_lastErrorText(sftp));
        CkSFtp_Dispose(sftp);
        CkBinData_Dispose(bd);
        return;
    }

    printf("Uploaded %d bytes.\n",CkBinData_getNumBytes(bd));

    CkSFtp_Disconnect(sftp);


    CkSFtp_Dispose(sftp);
    CkBinData_Dispose(bd);

    }