Xbase++

Throttle FTP Transfer Bandwidth

Demonstrates the bandwidth properties BandwidthThrottleUp and BandwidthThrottleDown, and the read-only UploadTransferRate and DownloadTransferRate.

Note: The local paths are relative to the application's current working directory. Absolute paths may also be used. Supply the paths appropriate to your own environment.

Background: Throttling caps the approximate transfer rate in bytes per second (0 means unlimited), which is how a background sync avoids starving interactive traffic on a shared or metered link. The rate properties report the current measured throughput, updated during transfers, so you can display progress or confirm the throttle is taking effect. Treat the limits as approximate targets rather than hard ceilings.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oFtp

nSuccess := 0

oFtp := CreateObject("Chilkat.Ftp2")

oFtp:Hostname := "ftp.example.com"
oFtp:Username := "myFtpLogin"

//  Limit the approximate transfer rate in bytes per second.  0 (the default) means no limit.
//  Throttling is useful to avoid saturating a shared link.
oFtp:BandwidthThrottleDown := 1048576
oFtp:BandwidthThrottleUp := 524288

//  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.
oFtp:Password := "myPassword"

nSuccess := oFtp:Connect()
IF (nSuccess == 0)
    ? oFtp:LastErrorText
    oFtp:destroy()
    RETURN
ENDIF

nSuccess := oFtp:GetFile("public_html/bigfile.zip", "qa_output/bigfile.zip")
IF (nSuccess == 0)
    ? oFtp:LastErrorText
    oFtp:destroy()
    RETURN
ENDIF

//  The current average rates are updated during transfers.
? "Download rate: " + Str(oFtp:DownloadTransferRate) + " bytes/sec"
? "Upload rate: " + Str(oFtp:UploadTransferRate) + " bytes/sec"

nSuccess := oFtp:Disconnect()
IF (nSuccess == 0)
    ? oFtp:LastErrorText
    oFtp:destroy()
    RETURN
ENDIF

oFtp:destroy()