From 367be19990da016f21a4b74215480adb09bfc907 Mon Sep 17 00:00:00 2001 From: Jakub Jelen Date: Thu, 22 Sep 2022 12:06:18 +0200 Subject: [PATCH] sftp: Add comment about limitation of sftp_setstat Fixes: #138 Signed-off-by: Jakub Jelen Reviewed-by: Anderson Toshiyuki Sasaki --- include/libssh/sftp.h | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/include/libssh/sftp.h b/include/libssh/sftp.h index c855df8a..a2b4745c 100644 --- a/include/libssh/sftp.h +++ b/include/libssh/sftp.h @@ -681,6 +681,11 @@ LIBSSH_API int sftp_rename(sftp_session sftp, const char *original, const char /** * @brief Set file attributes on a file, directory or symbolic link. * + * Note, that this function can only set time values using 32 bit values due to + * the restrictions in the SFTP protocol version 3 implemented by libssh. + * The support for 64 bit time values was introduced in SFTP version 5, which is + * not implemented by libssh nor any major SFTP servers. + * * @param sftp The sftp session handle. * * @param file The file which attributes should be changed.