Unverified Commit 28f38da5 authored by Daniel Stenberg's avatar Daniel Stenberg
Browse files

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
parent 0c56faf4

docs/libcurl/opts/CURLOPT_CHUNK_BGN_FUNCTION.3

+28 −1
Original line number Diff line number Diff line
@@ -5,7 +5,7 @@ 
.\" *                            | (__| |_| |  _ <| |___

.\" *                             \___|\___/|_| \_\_____|

.\" *

.\" * Copyright (C) 1998 - 2017, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" * Copyright (C) 1998 - 2019, Daniel Stenberg, <daniel@haxx.se>, 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);

include/curl/curl.h

+1 −1
Original line number Diff line number Diff line
@@ -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;