lib/util/time.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    time utility functions
   4
   5    This program is free software; you can redistribute it and/or modify
   6    it under the terms of the GNU General Public License as published by
   7    the Free Software Foundation; either version 3 of the License, or
   8    (at your option) any later version.
   9
  10    This program is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13    GNU General Public License for more details.
  14
  15    You should have received a copy of the GNU General Public License
  16    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17 */
  18
  19 #ifndef _SAMBA_TIME_H_
  20 #define _SAMBA_TIME_H_
  21
  22 #ifndef _PUBLIC_
  23 #define _PUBLIC_
  24 #endif
  25
  26 #ifndef TIME_T_MIN
  27 /* we use 0 here, because (time_t)-1 means error */
  28 #define TIME_T_MIN 0
  29 #endif
  30
  31 /*
  32  * we use the INT32_MAX here as on 64 bit systems,
  33  * gmtime() fails with INT64_MAX
  34  */
  35 #ifndef TIME_T_MAX
  36 #define TIME_T_MAX MIN(INT32_MAX,_TYPE_MAXIMUM(time_t))
  37 #endif
  38
  39
  40 /* 64 bit time (100 nanosec) 1601 - cifs6.txt, section 3.5, page 30, 4 byte aligned */
  41 typedef uint64_t NTTIME;
  42
  43 /**
  44  External access to time_t_min and time_t_max.
  45 **/
  46 _PUBLIC_ time_t get_time_t_max(void);
  47
  48 /**
  49 a gettimeofday wrapper
  50 **/
  51 _PUBLIC_ void GetTimeOfDay(struct timeval *tval);
  52
  53 /**
  54 a wrapper to preferably get the monotonic time
  55 **/
  56 _PUBLIC_ void clock_gettime_mono(struct timespec *tp);
  57
  58 /**
  59 a wrapper to preferably get the monotonic time in s
  60 **/
  61 _PUBLIC_ time_t time_mono(time_t *t);
  62
  63 /**
  64 interpret an 8 byte "filetime" structure to a time_t
  65 It's originally in "100ns units since jan 1st 1601"
  66 **/
  67 _PUBLIC_ time_t nt_time_to_unix(NTTIME nt);
  68
  69 /**
  70 put a 8 byte filetime from a time_t
  71 This takes GMT as input
  72 **/
  73 _PUBLIC_ void unix_to_nt_time(NTTIME *nt, time_t t);
  74
  75 /**
  76 check if it's a null unix time
  77 **/
  78 _PUBLIC_ bool null_time(time_t t);
  79
  80 /**
  81 check if it's a null NTTIME
  82 **/
  83 _PUBLIC_ bool null_nttime(NTTIME t);
  84
  85 /**
  86 put a dos date into a buffer (time/date format)
  87 This takes GMT time and puts local time in the buffer
  88 **/
  89 _PUBLIC_ void push_dos_date(uint8_t *buf, int offset, time_t unixdate, int zone_offset);
  90
  91 /**
  92 put a dos date into a buffer (date/time format)
  93 This takes GMT time and puts local time in the buffer
  94 **/
  95 _PUBLIC_ void push_dos_date2(uint8_t *buf,int offset,time_t unixdate, int zone_offset);
  96
  97 /**
  98 put a dos 32 bit "unix like" date into a buffer. This routine takes
  99 GMT and converts it to LOCAL time before putting it (most SMBs assume
 100 localtime for this sort of date)
 101 **/
 102 _PUBLIC_ void push_dos_date3(uint8_t *buf,int offset,time_t unixdate, int zone_offset);
 103
 104 /**
 105   create a unix date (int GMT) from a dos date (which is actually in
 106   localtime)
 107 **/
 108 _PUBLIC_ time_t pull_dos_date(const uint8_t *date_ptr, int zone_offset);
 109
 110 /**
 111 like make_unix_date() but the words are reversed
 112 **/
 113 _PUBLIC_ time_t pull_dos_date2(const uint8_t *date_ptr, int zone_offset);
 114
 115 /**
 116   create a unix GMT date from a dos date in 32 bit "unix like" format
 117   these generally arrive as localtimes, with corresponding DST
 118 **/
 119 _PUBLIC_ time_t pull_dos_date3(const uint8_t *date_ptr, int zone_offset);
 120
 121 /**
 122 return a HTTP/1.0 time string
 123 **/
 124 _PUBLIC_ char *http_timestring(TALLOC_CTX *mem_ctx, time_t t);
 125
 126 /**
 127  Return the date and time as a string
 128 **/
 129 _PUBLIC_ char *timestring(TALLOC_CTX *mem_ctx, time_t t);
 130
 131 /**
 132   return a talloced string representing a NTTIME for human consumption
 133 */
 134 _PUBLIC_ const char *nt_time_string(TALLOC_CTX *mem_ctx, NTTIME nt);
 135
 136 /**
 137   put a NTTIME into a packet
 138 */
 139 _PUBLIC_ void push_nttime(uint8_t *base, uint16_t offset, NTTIME t);
 140
 141 /**
 142   pull a NTTIME from a packet
 143 */
 144 _PUBLIC_ NTTIME pull_nttime(uint8_t *base, uint16_t offset);
 145
 146 /**
 147   parse a nttime as a large integer in a string and return a NTTIME
 148 */
 149 _PUBLIC_ NTTIME nttime_from_string(const char *s);
 150
 151 /**
 152   return (tv1 - tv2) in microseconds
 153 */
 154 _PUBLIC_ int64_t usec_time_diff(const struct timeval *tv1, const struct timeval *tv2);
 155
 156 /**
 157   return (tp1 - tp2) in nanoseconds
 158 */
 159 _PUBLIC_ int64_t nsec_time_diff(const struct timespec *tp1, const struct timespec *tp2);
 160
 161 /**
 162   return a zero timeval
 163 */
 164 _PUBLIC_ struct timeval timeval_zero(void);
 165
 166 /**
 167   return true if a timeval is zero
 168 */
 169 _PUBLIC_ bool timeval_is_zero(const struct timeval *tv);
 170
 171 /**
 172   return a timeval for the current time
 173 */
 174 _PUBLIC_ struct timeval timeval_current(void);
 175
 176 /**
 177   return a timeval struct with the given elements
 178 */
 179 _PUBLIC_ struct timeval timeval_set(uint32_t secs, uint32_t usecs);
 180
 181 /**
 182   return a timeval ofs microseconds after tv
 183 */
 184 _PUBLIC_ struct timeval timeval_add(const struct timeval *tv,
 185                            uint32_t secs, uint32_t usecs);
 186
 187 /**
 188   return the sum of two timeval structures
 189 */
 190 struct timeval timeval_sum(const struct timeval *tv1,
 191                            const struct timeval *tv2);
 192
 193 /**
 194   return a timeval secs/usecs into the future
 195 */
 196 _PUBLIC_ struct timeval timeval_current_ofs(uint32_t secs, uint32_t usecs);
 197
 198 /**
 199   compare two timeval structures.
 200   Return -1 if tv1 < tv2
 201   Return 0 if tv1 == tv2
 202   Return 1 if tv1 > tv2
 203 */
 204 _PUBLIC_ int timeval_compare(const struct timeval *tv1, const struct timeval *tv2);
 205
 206 /**
 207   return true if a timer is in the past
 208 */
 209 _PUBLIC_ bool timeval_expired(const struct timeval *tv);
 210
 211 /**
 212   return the number of seconds elapsed between two times
 213 */
 214 _PUBLIC_ double timeval_elapsed2(const struct timeval *tv1, const struct timeval *tv2);
 215
 216 /**
 217   return the number of seconds elapsed since a given time
 218 */
 219 _PUBLIC_ double timeval_elapsed(const struct timeval *tv);
 220
 221 /**
 222   return the lesser of two timevals
 223 */
 224 _PUBLIC_ struct timeval timeval_min(const struct timeval *tv1,
 225                            const struct timeval *tv2);
 226
 227 /**
 228   return the greater of two timevals
 229 */
 230 _PUBLIC_ struct timeval timeval_max(const struct timeval *tv1,
 231                            const struct timeval *tv2);
 232
 233 /**
 234   return the difference between two timevals as a timeval
 235   if tv1 comes after tv2, then return a zero timeval
 236   (this is *tv2 - *tv1)
 237 */
 238 _PUBLIC_ struct timeval timeval_until(const struct timeval *tv1,
 239                              const struct timeval *tv2);
 240
 241 /**
 242   convert a timeval to a NTTIME
 243 */
 244 _PUBLIC_ NTTIME timeval_to_nttime(const struct timeval *tv);
 245
 246 /**
 247   convert a NTTIME to a timeval
 248 */
 249 _PUBLIC_ void nttime_to_timeval(struct timeval *tv, NTTIME t);
 250
 251 /**
 252   return the UTC offset in seconds west of UTC, or 0 if it cannot be determined
 253  */
 254 _PUBLIC_ int get_time_zone(time_t t);
 255
 256 /**
 257   check if 2 NTTIMEs are equal.
 258 */
 259 bool nt_time_equal(NTTIME *t1, NTTIME *t2);
 260
 261 void interpret_dos_date(uint32_t date,int *year,int *month,int *day,int *hour,int *minute,int *second);
 262
 263 struct timespec nt_time_to_unix_timespec(NTTIME *nt);
 264
 265 time_t convert_timespec_to_time_t(struct timespec ts);
 266
 267 struct timespec convert_time_t_to_timespec(time_t t);
 268
 269 bool null_timespec(struct timespec ts);
 270
 271 /** Extra minutes to add to the normal GMT to local time conversion. */
 272 extern int extra_time_offset;
 273
 274 #endif /* _SAMBA_TIME_H_ */