Sample code for 30+ languages & platforms
Unicode C

SFTP Upload from Local Filesystem

See more SFTP Examples

Demonstrates how to upload a file to an SSH server. There are no limitations on file size, and the file is streamed directly from the local filesystem.

Chilkat Unicode C Downloads

Unicode C
#include <C_CkSFtpW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkSFtpW sftp;
    const wchar_t *hostname;
    int port;
    const wchar_t *handle;

    success = FALSE;

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

    sftp = CkSFtpW_Create();

    // Set some timeouts, in milliseconds:
    CkSFtpW_putConnectTimeoutMs(sftp,5000);
    CkSFtpW_putIdleTimeoutMs(sftp,10000);

    // Connect to the SSH server.  
    // The standard SSH port = 22
    // The hostname may be a hostname or IP address.
    hostname = L"sftp.example.com";
    port = 22;
    success = CkSFtpW_Connect(sftp,hostname,port);
    if (success != TRUE) {
        wprintf(L"%s\n",CkSFtpW_lastErrorText(sftp));
        CkSFtpW_Dispose(sftp);
        return;
    }

    // Authenticate with the SSH server.  Chilkat SFTP supports
    // both password-based authenication as well as public-key
    // authentication.  This example uses password authenication.
    success = CkSFtpW_AuthenticatePw(sftp,L"myLogin",L"myPassword");
    if (success != TRUE) {
        wprintf(L"%s\n",CkSFtpW_lastErrorText(sftp));
        CkSFtpW_Dispose(sftp);
        return;
    }

    // After authenticating, the SFTP subsystem must be initialized:
    success = CkSFtpW_InitializeSftp(sftp);
    if (success != TRUE) {
        wprintf(L"%s\n",CkSFtpW_lastErrorText(sftp));
        CkSFtpW_Dispose(sftp);
        return;
    }

    // Open a file for writing on the SSH server.
    // If the file already exists, it is overwritten.
    // (Specify "createNew" instead of "createTruncate" to
    // prevent overwriting existing files.)
    handle = CkSFtpW_openFile(sftp,L"hamlet.xml",L"writeOnly",L"createTruncate");
    if (CkSFtpW_getLastMethodSuccess(sftp) != TRUE) {
        wprintf(L"%s\n",CkSFtpW_lastErrorText(sftp));
        CkSFtpW_Dispose(sftp);
        return;
    }

    // Upload from the local file to the SSH server.
    success = CkSFtpW_UploadFile(sftp,handle,L"c:/temp/hamlet.xml");
    if (success != TRUE) {
        wprintf(L"%s\n",CkSFtpW_lastErrorText(sftp));
        CkSFtpW_Dispose(sftp);
        return;
    }

    // -----------------------------------------------------------------------------
    // This is important.  You must close the handle on the server.
    // Otherwise open handles will accumulate on the server until eventually a limit
    // is reached and the server will fail on a call to OpenFile.
    // -----------------------------------------------------------------------------

    // Close the file.
    success = CkSFtpW_CloseHandle(sftp,handle);
    if (success != TRUE) {
        wprintf(L"%s\n",CkSFtpW_lastErrorText(sftp));
        CkSFtpW_Dispose(sftp);
        return;
    }

    wprintf(L"Success.\n");


    CkSFtpW_Dispose(sftp);

    }