(Visual FoxPro) 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 ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loSsh
LOCAL lcHostname
LOCAL lnPort
LOCAL lnSuccess
LOCAL loScp
LOCAL lcRemotePath
LOCAL lcLocalPath

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

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Ssh')
loSsh = CreateObject('Chilkat.Ssh')

* Hostname may be an IP address or hostname:
lcHostname = "www.some-ssh-server.com"
lnPort = 22

* Connect to an SSH server:
lnSuccess = loSsh.Connect(lcHostname,lnPort)
IF (lnSuccess <> 1) THEN
    ? loSsh.LastErrorText
    RELEASE loSsh
    CANCEL
ENDIF

* Wait a max of 5 seconds when reading responses..
loSsh.IdleTimeoutMs = 5000

* Authenticate using login/password:
lnSuccess = loSsh.AuthenticatePw("myLogin","myPassword")
IF (lnSuccess <> 1) THEN
    ? loSsh.LastErrorText
    RELEASE loSsh
    CANCEL
ENDIF

* Once the SSH object is connected and authenticated, we use it
* in our SCP object.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Scp')
loScp = CreateObject('Chilkat.Scp')

lnSuccess = loScp.UseSsh(loSsh)
IF (lnSuccess <> 1) THEN
    ? loScp.LastErrorText
    RELEASE loSsh
    RELEASE loScp
    CANCEL
ENDIF

* 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
lcRemotePath = "testApp/logs/test1.log"
lcLocalPath = "c:/testApp/logs/test1.log"
lnSuccess = loScp.DownloadFile(lcRemotePath,lcLocalPath)
IF (lnSuccess <> 1) THEN
    ? loScp.LastErrorText
    RELEASE loSsh
    RELEASE loScp
    CANCEL
ENDIF

* The following call to DownloadFile specifies an absolute file path on the SSH server:
lcRemotePath = "/Users/chilkat/Documents/gecko.jpg"
lcLocalPath = "c:/temp/images/gecko.jpg"
lnSuccess = loScp.DownloadFile(lcRemotePath,lcLocalPath)
IF (lnSuccess <> 1) THEN
    ? loScp.LastErrorText
    RELEASE loSsh
    RELEASE loScp
    CANCEL
ENDIF

? "SCP download file success."

* Disconnect
loSsh.Disconnect()

RELEASE loSsh
RELEASE loScp