Tcl

Set a Remote File's Last-Modified Time

Demonstrates the Chilkat SFtp.SetLastModifiedTimeStr method, which sets a remote file's last-modified date and time. The arguments are the remote path (or handle), whether the first argument is a handle, and an RFC 822 formatted date/time string.

Background: Of the three timestamps, the modified time is the one you most often want to set, because sync and build tools compare it to decide what is current. Stamping an uploaded file with its source's modified time keeps a mirror consistent and prevents an incremental sync from needlessly re-copying it. This is the most widely supported timestamp to set across servers.

Chilkat Tcl Downloads

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

set success 0

#  Demonstrates the SFtp.SetLastModifiedTimeStr method, which sets a remote file's last-modified
#  date and time.  The 1st argument is the remote path (or handle), the 2nd (bIsHandle) indicates
#  which, and the 3rd is an RFC 822 formatted date/time string.

set sftp [new_CkSFtp]

#  Connect, authenticate, and initialize the SFTP subsystem.
set port 22
set success [CkSFtp_Connect $sftp "sftp.example.com" $port]
if {$success == 0} then {
    puts [CkSFtp_lastErrorText $sftp]
    delete_CkSFtp $sftp
    exit
}

#  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.
set password "mySshPassword"

set success [CkSFtp_AuthenticatePw $sftp "mySshLogin" $password]
if {$success == 0} then {
    puts [CkSFtp_lastErrorText $sftp]
    delete_CkSFtp $sftp
    exit
}

set success [CkSFtp_InitializeSftp $sftp]
if {$success == 0} then {
    puts [CkSFtp_lastErrorText $sftp]
    delete_CkSFtp $sftp
    exit
}

#  The 1st argument is a path, so bIsHandle is 0.
set bIsHandle 0
set dateTimeStr "Fri, 10 Jul 2026 20:15:30 -0600"
set success [CkSFtp_SetLastModifiedTimeStr $sftp "subdir/report.pdf" $bIsHandle $dateTimeStr]
if {$success == 0} then {
    puts [CkSFtp_lastErrorText $sftp]
    delete_CkSFtp $sftp
    exit
}

puts "Last-modified time set."

CkSFtp_Disconnect $sftp

delete_CkSFtp $sftp