FTP Push Delivery

Config Type Default Description
c.chnl[#].dst.ftpc.address string '' The name, or address, of the FTP server to push to
c.chnl[#].dst.ftpc.intf string 'L' Which interface, and order to push. See: #Push Interface Options
c.chnl[#].dst.ftpc.port integer 21 The TCP/IP port
c.chnl[#].dst.ftpc.ssl string '' Whether to use TLS/SSL. See: #FTP Client Crypto
c.chnl[#].dst.ftpc.user string 'channel1' The username
c.chnl[#].dst.ftpc.pass string 'password' The password
c.chnl[#].dst.ftpc.dir string '' The directory. ''=home, e.g. '/mysite/' (not backslash!!)
c.chnl[#].dst.ftpc.filename string 'channel1.dat' The filename to send
c.chnl[#].dst.ftpc.compress integer 0 Set to 1 to zlib compress, with .zlib extension.
c.chnl[#].dst.ftpc.limit integer 0 The data limit, in kilobytes, for each transfer
c.chnl[#].dst.ftpc.mode integer 'rename' The transfer mode.

Push Interface Options

The .intf string value specifies which interface order to try:

Value Description
L LAN only
M Modem/PPP only
LM LAN first, then Modem/PPP on fail
ML Modem/PPP, then LAN on fail

FTP Client Crypto

The c.chnl[#].dst.ftpc.ssl can be one of these settings:

Value Description
'' plaintext, no encryption
'e' explicit TLS/SSL. Sstart plain + negotiate up
'i' implicit TLS/SSL. Server should be set to TLS/SSL only
'sftp' SFTP/SSH push (usually port 22)

FTP Push Transfer Modes

Value Description
'rename' TMP File & Rename
'create' Overwrite
'append' Append
Note

FTP does not have a mechanism to handle failures.
The 'rename' mode ensures that the data is fully transferred, before it is renamed, and only then is the data removed from the ip.buffer.

TMP File & Rename process:

  • Sends filename.tmp
  • Renames filename.tmp to filename
  • Deletes the data that was sent.
Caution

The FTP server should ignore any files that end with .tmp and not process them.
These are either transfers-in-progress, or failed-transfers that are not complete.

See also: c.globals - Global Configuration -> c.globals.sftpauthmethods for SFTP push authentication methods.