(C) SCP Download from a Specific Directory

Demonstrates how to download a file using the SCP protocol (Secure Copy Protocol over SSH), from a specific remote directory located on the SSH server. The remote directory can be a path relative to the HOME directory of the SSH user account, or an absolute path on the remote filesystem. Obviously, in both cases the SSH user account must have permission to open and read the file in the specified directory.

Chilkat C/C++ Library Downloads
MS Visual C/C++ Linux/CentOS C/C++ Alpine Linux C/C++ MAC OS X C/C++	armhf/aarch64 C/C++ C++ Builder iOS C/C++ Android C/C++	Solaris C/C++ MinGW C/C++

#include <C_CkSsh.h>
#include <C_CkScp.h>

void ChilkatSample(void)
    {
    HCkSsh ssh;
    const char *hostname;
    int port;
    BOOL success;
    HCkScp scp;
    const char *remotePath;
    const char *localPath;

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

    ssh = CkSsh_Create();

    // Hostname may be an IP address or hostname:
    hostname = "www.some-ssh-server.com";
    port = 22;

    // Connect to an SSH server:
    success = CkSsh_Connect(ssh,hostname,port);
    if (success != TRUE) {
        printf("%s\n",CkSsh_lastErrorText(ssh));
        CkSsh_Dispose(ssh);
        return;
    }

    // Wait a max of 5 seconds when reading responses..
    CkSsh_putIdleTimeoutMs(ssh,5000);

    // Authenticate using login/password:
    success = CkSsh_AuthenticatePw(ssh,"myLogin","myPassword");
    if (success != TRUE) {
        printf("%s\n",CkSsh_lastErrorText(ssh));
        CkSsh_Dispose(ssh);
        return;
    }

    // Once the SSH object is connected and authenticated, we use it
    // in our SCP object.
    scp = CkScp_Create();

    success = CkScp_UseSsh(scp,ssh);
    if (success != TRUE) {
        printf("%s\n",CkScp_lastErrorText(scp));
        CkSsh_Dispose(ssh);
        CkScp_Dispose(scp);
        return;
    }

    // This downloads a file from the "testApp/logs/" subdirectory (relative to the SSH user account's HOME directory).  
    // For example, if the HOME directory is /Users/chilkat, then the following downloads
    // /Users/chilkat/testApp/logs/test1.log
    remotePath = "testApp/logs/test1.log";
    localPath = "c:/testApp/logs/test1.log";
    success = CkScp_DownloadFile(scp,remotePath,localPath);
    if (success != TRUE) {
        printf("%s\n",CkScp_lastErrorText(scp));
        CkSsh_Dispose(ssh);
        CkScp_Dispose(scp);
        return;
    }

    // The following call to DownloadFile specifies an absolute file path on the SSH server:
    remotePath = "/Users/chilkat/Documents/gecko.jpg";
    localPath = "c:/temp/images/gecko.jpg";
    success = CkScp_DownloadFile(scp,remotePath,localPath);
    if (success != TRUE) {
        printf("%s\n",CkScp_lastErrorText(scp));
        CkSsh_Dispose(ssh);
        CkScp_Dispose(scp);
        return;
    }

    printf("SCP download file success.\n");

    // Disconnect
    CkSsh_Disconnect(ssh);


    CkSsh_Dispose(ssh);
    CkScp_Dispose(scp);

    }