From 28f38da5063d88fd8fc503cb56a8b6bafa1d953d Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Fri, 3 May 2019 13:43:13 +0200 Subject: CURLOPT_CHUNK_BGN_FUNCTION.3: document the struct and time value The time field in the curl_fileinfo struct will always be zero. No code was ever implemented to actually convert the date string to a time_t. Fixes #3829 Closes #3835 --- docs/libcurl/opts/CURLOPT_CHUNK_BGN_FUNCTION.3 | 29 +++++++++++++++++++++++++- include/curl/curl.h | 2 +- 2 files changed, 29 insertions(+), 2 deletions(-) diff --git a/docs/libcurl/opts/CURLOPT_CHUNK_BGN_FUNCTION.3 b/docs/libcurl/opts/CURLOPT_CHUNK_BGN_FUNCTION.3 index 8a7afb620..8ddd35ea7 100644 --- a/docs/libcurl/opts/CURLOPT_CHUNK_BGN_FUNCTION.3 +++ b/docs/libcurl/opts/CURLOPT_CHUNK_BGN_FUNCTION.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2017, Daniel Stenberg, , et al. +.\" * Copyright (C) 1998 - 2019, Daniel Stenberg, , et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -27,6 +27,33 @@ CURLOPT_CHUNK_BGN_FUNCTION \- callback before a transfer with FTP wildcardmatch .nf #include +struct curl_fileinfo { + char *filename; + curlfiletype filetype; + time_t time; /* always zero! */ + unsigned int perm; + int uid; + int gid; + curl_off_t size; + long int hardlinks; + + struct { + /* If some of these fields is not NULL, it is a pointer to b_data. */ + char *time; + char *perm; + char *user; + char *group; + char *target; /* pointer to the target filename of a symlink */ + } strings; + + unsigned int flags; + + /* used internally */ + char *b_data; + size_t b_size; + size_t b_used; +}; + long chunk_bgn_callback(const void *transfer_info, void *ptr, int remains); diff --git a/include/curl/curl.h b/include/curl/curl.h index 75f780cd7..d83b21798 100644 --- a/include/curl/curl.h +++ b/include/curl/curl.h @@ -290,7 +290,7 @@ typedef enum { struct curl_fileinfo { char *filename; curlfiletype filetype; - time_t time; + time_t time; /* always zero! */ unsigned int perm; int uid; int gid; -- cgit v1.2.3