generic-library/curl
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

curl_getdate.3: edited, removed references to pre 7.12.2 functionality

Browse Source
This commit is contained in:
Daniel Stenberg
2014-01-20 00:02:33 +01:00
parent 4f334ba017
commit b0fa530c98
1 changed files with 6 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
docs/libcurl/curl_getdate.3
View File

@@ -5,7 +5,7 @@
.\" * | (__| |_| | _ <| |___ .\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____| .\" * \___|\___/|_| \_\_____|
.\" * .\" *
.\" * Copyright (C) 1998 - 2011, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
.\" * .\" *
.\" * This software is licensed as described in the file COPYING, which .\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms .\" * you should have received as part of this distribution. The terms
@@ -21,22 +21,17 @@
.\" ************************************************************************** .\" **************************************************************************
.TH curl_getdate 3 "12 Aug 2005" "libcurl 7.0" "libcurl Manual" .TH curl_getdate 3 "12 Aug 2005" "libcurl 7.0" "libcurl Manual"
.SH NAME .SH NAME
curl_getdate - Convert a date string to number of seconds since January 1, curl_getdate - Convert a date string to number of seconds
1970
.SH SYNOPSIS .SH SYNOPSIS
.B #include <curl/curl.h> .B #include <curl/curl.h>
.sp .sp
.BI "time_t curl_getdate(char *" datestring ", time_t *"now " );" .BI "time_t curl_getdate(char *" datestring ", time_t *"now " );"
.ad .ad
.SH DESCRIPTION .SH DESCRIPTION
This function returns the number of seconds since January 1st 1970 in the UTC \fIcurl_getdate(3)\fP returns the number of seconds since the Epoch, January
time zone, for the date and time that the \fIdatestring\fP parameter 1st 1970 00:00:00 in the UTC time zone, for the date and time that the
specifies. The \fInow\fP parameter is not used, pass a NULL there. \fIdatestring\fP parameter specifies. The \fInow\fP parameter is not used,
pass a NULL there.
\fBNOTE:\fP This function was rewritten for the 7.12.2 release and this
documentation covers the functionality of the new one. The new one is not
feature-complete with the old one, but most of the formats supported by the
new one was supported by the old too.
.SH PARSING DATES AND TIMES .SH PARSING DATES AND TIMES
A "date" is a string containing several items separated by whitespace. The A "date" is a string containing several items separated by whitespace. The
order of the items is immaterial. A date string may contain many flavors of order of the items is immaterial. A date string may contain many flavors of
@@ -108,10 +103,3 @@ number).
Having a 64 bit time_t is not a guarantee that dates beyond 03:14:07 UTC, Having a 64 bit time_t is not a guarantee that dates beyond 03:14:07 UTC,
January 19, 2038 will work fine. On systems with a 64 bit time_t but with a January 19, 2038 will work fine. On systems with a 64 bit time_t but with a
crippled mktime(), \fIcurl_getdate\fP will return -1 in this case. crippled mktime(), \fIcurl_getdate\fP will return -1 in this case.
.SH REWRITE
The former version of this function was built with yacc and was not only very
large, it was also never quite understood and it wasn't possible to build with
non-GNU tools since only GNU Bison could make it thread-safe!
The rewrite was done for 7.12.2. The new one is much smaller and uses simpler
code.