[GNUnet-SVN] [gnurl] 125/219: CURLOPT_CHUNK_BGN_FUNCTION.3: document the struct and time value

[gnunet]

This is an automated email from the git hooks/post-receive script.

ng0 pushed a commit to branch master
in repository gnurl.

commit 28f38da5063d88fd8fc503cb56a8b6bafa1d953d
Author: Daniel Stenberg <address@hidden>
AuthorDate: Fri May 3 13:43:13 2019 +0200

    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, <address@hidden>, et al.
+.\" * Copyright (C) 1998 - 2019, Daniel Stenberg, <address@hidden>, 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 <curl/curl.h>
 
+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;

-- 
To stop receiving notification emails like this one, please contact
address@hidden