common/iobuf.c: Improve iobuf_peek.
[gnupg.git] / common / gettime.h
1 /* gettime.h - Wrapper for time functions
2  * Copyright (C) 2010, 2012 Free Software Foundation, Inc.
3  *
4  * This file is part of GnuPG.
5  *
6  * GnuPG is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 3 of the License, or
9  * (at your option) any later version.
10  *
11  * GnuPG is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, see <http://www.gnu.org/licenses/>.
18  */
19
20 #ifndef GNUPG_COMMON_GETTIME_H
21 #define GNUPG_COMMON_GETTIME_H
22
23 #include <time.h>      /* We need time_t. */
24 #include <gpg-error.h> /* We need gpg_error_t. */
25
26
27 /* A type to hold the ISO time.  Note that this is the same as
28    the KSBA type ksba_isotime_t. */
29 typedef char gnupg_isotime_t[16];
30
31 time_t gnupg_get_time (void);
32 struct tm *gnupg_gmtime (const time_t *timep, struct tm *result);
33 void   gnupg_get_isotime (gnupg_isotime_t timebuf);
34 void   gnupg_set_time (time_t newtime, int freeze);
35 int    gnupg_faked_time_p (void);
36 u32    make_timestamp (void);
37 char *elapsed_time_string (time_t since, time_t now);
38
39 u32    scan_isodatestr (const char *string);
40 int    isotime_p (const char *string);
41 int    isotime_human_p (const char *string, int date_only);
42 size_t string2isotime (gnupg_isotime_t atime, const char *string);
43 time_t isotime2epoch (const char *string);
44 void   epoch2isotime (gnupg_isotime_t timebuf, time_t atime);
45 int    isodate_human_to_tm (const char *string, struct tm *t);
46 time_t parse_timestamp (const char *timestamp, char **endp);
47 u32    add_days_to_timestamp (u32 stamp, u16 days);
48 const char *strtimevalue (u32 stamp);
49 const char *strtimestamp (u32 stamp); /* GMT */
50 const char *isotimestamp (u32 stamp); /* GMT */
51 const char *asctimestamp (u32 stamp); /* localized */
52 gpg_error_t add_seconds_to_isotime (gnupg_isotime_t atime, int nseconds);
53 gpg_error_t add_days_to_isotime (gnupg_isotime_t atime, int ndays);
54 gpg_error_t check_isotime (const gnupg_isotime_t atime);
55 void dump_isotime (const gnupg_isotime_t atime);
56 void gnupg_copy_time (gnupg_isotime_t d, const gnupg_isotime_t s);
57
58
59 #endif /*GNUPG_COMMON_GETTIME_H*/