[152] | 1 | /* Copyright (C) 1991-1999,2000,2001,2002,2003,2006 |
---|
| 2 | Free Software Foundation, Inc. |
---|
| 3 | This file is part of the GNU C Library. |
---|
| 4 | |
---|
| 5 | The GNU C Library is free software; you can redistribute it and/or |
---|
| 6 | modify it under the terms of the GNU Lesser General Public |
---|
| 7 | License as published by the Free Software Foundation; either |
---|
| 8 | version 2.1 of the License, or (at your option) any later version. |
---|
| 9 | |
---|
| 10 | The GNU C Library 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 GNU |
---|
| 13 | Lesser General Public License for more details. |
---|
| 14 | |
---|
| 15 | You should have received a copy of the GNU Lesser General Public |
---|
| 16 | License along with the GNU C Library; if not, write to the Free |
---|
| 17 | Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA |
---|
| 18 | 02111-1307 USA. */ |
---|
| 19 | |
---|
| 20 | /* |
---|
| 21 | * ISO C99 Standard: 7.23 Date and time <time.h> |
---|
| 22 | */ |
---|
| 23 | |
---|
| 24 | #ifndef _TIME_H |
---|
| 25 | |
---|
| 26 | #if (! defined __need_time_t && !defined __need_clock_t && \ |
---|
| 27 | ! defined __need_timespec) |
---|
| 28 | # define _TIME_H 1 |
---|
| 29 | # include <features.h> |
---|
| 30 | |
---|
| 31 | __BEGIN_DECLS |
---|
| 32 | |
---|
| 33 | #endif |
---|
| 34 | |
---|
| 35 | #ifdef _TIME_H |
---|
| 36 | /* Get size_t and NULL from <stddef.h>. */ |
---|
| 37 | # define __need_size_t |
---|
| 38 | # define __need_NULL |
---|
| 39 | # include <stddef.h> |
---|
| 40 | |
---|
| 41 | /* This defines CLOCKS_PER_SEC, which is the number of processor clock |
---|
| 42 | ticks per second. */ |
---|
| 43 | # include <bits/time.h> |
---|
| 44 | |
---|
| 45 | /* This is the obsolete POSIX.1-1988 name for the same constant. */ |
---|
| 46 | # if !defined __STRICT_ANSI__ && !defined __USE_XOPEN2K |
---|
| 47 | # ifndef CLK_TCK |
---|
| 48 | # define CLK_TCK CLOCKS_PER_SEC |
---|
| 49 | # endif |
---|
| 50 | # endif |
---|
| 51 | |
---|
| 52 | #endif /* <time.h> included. */ |
---|
| 53 | |
---|
| 54 | #if !defined __clock_t_defined && (defined _TIME_H || defined __need_clock_t) |
---|
| 55 | # define __clock_t_defined 1 |
---|
| 56 | |
---|
| 57 | # include <bits/types.h> |
---|
| 58 | |
---|
| 59 | __BEGIN_NAMESPACE_STD |
---|
| 60 | /* Returned by `clock'. */ |
---|
| 61 | typedef __clock_t clock_t; |
---|
| 62 | __END_NAMESPACE_STD |
---|
| 63 | #if defined __USE_XOPEN || defined __USE_POSIX || defined __USE_MISC |
---|
| 64 | __USING_NAMESPACE_STD(clock_t) |
---|
| 65 | #endif |
---|
| 66 | |
---|
| 67 | #endif /* clock_t not defined and <time.h> or need clock_t. */ |
---|
| 68 | #undef __need_clock_t |
---|
| 69 | |
---|
| 70 | #if !defined __time_t_defined && (defined _TIME_H || defined __need_time_t) |
---|
| 71 | # define __time_t_defined 1 |
---|
| 72 | |
---|
| 73 | # include <bits/types.h> |
---|
| 74 | |
---|
| 75 | __BEGIN_NAMESPACE_STD |
---|
| 76 | /* Returned by `time'. */ |
---|
| 77 | typedef __time_t time_t; |
---|
| 78 | __END_NAMESPACE_STD |
---|
| 79 | #if defined __USE_POSIX || defined __USE_MISC || defined __USE_SVID |
---|
| 80 | __USING_NAMESPACE_STD(time_t) |
---|
| 81 | #endif |
---|
| 82 | |
---|
| 83 | #endif /* time_t not defined and <time.h> or need time_t. */ |
---|
| 84 | #undef __need_time_t |
---|
| 85 | |
---|
| 86 | #if !defined __clockid_t_defined && \ |
---|
| 87 | ((defined _TIME_H && defined __USE_POSIX199309) || defined __need_clockid_t) |
---|
| 88 | # define __clockid_t_defined 1 |
---|
| 89 | |
---|
| 90 | # include <bits/types.h> |
---|
| 91 | |
---|
| 92 | /* Clock ID used in clock and timer functions. */ |
---|
| 93 | typedef __clockid_t clockid_t; |
---|
| 94 | |
---|
| 95 | #endif /* clockid_t not defined and <time.h> or need clockid_t. */ |
---|
| 96 | #undef __clockid_time_t |
---|
| 97 | |
---|
| 98 | #if !defined __timer_t_defined && \ |
---|
| 99 | ((defined _TIME_H && defined __USE_POSIX199309) || defined __need_timer_t) |
---|
| 100 | # define __timer_t_defined 1 |
---|
| 101 | |
---|
| 102 | # include <bits/types.h> |
---|
| 103 | |
---|
| 104 | /* Timer ID returned by `timer_create'. */ |
---|
| 105 | typedef __timer_t timer_t; |
---|
| 106 | |
---|
| 107 | #endif /* timer_t not defined and <time.h> or need timer_t. */ |
---|
| 108 | #undef __need_timer_t |
---|
| 109 | |
---|
| 110 | |
---|
| 111 | #if !defined __timespec_defined && \ |
---|
| 112 | ((defined _TIME_H && \ |
---|
| 113 | (defined __USE_POSIX199309 || defined __USE_MISC)) || \ |
---|
| 114 | defined __need_timespec) |
---|
| 115 | # define __timespec_defined 1 |
---|
| 116 | |
---|
| 117 | # include <bits/types.h> /* This defines __time_t for us. */ |
---|
| 118 | |
---|
| 119 | /* POSIX.1b structure for a time value. This is like a `struct timeval' but |
---|
| 120 | has nanoseconds instead of microseconds. */ |
---|
| 121 | struct timespec |
---|
| 122 | { |
---|
| 123 | __time_t tv_sec; /* Seconds. */ |
---|
| 124 | long int tv_nsec; /* Nanoseconds. */ |
---|
| 125 | }; |
---|
| 126 | |
---|
| 127 | #endif /* timespec not defined and <time.h> or need timespec. */ |
---|
| 128 | #undef __need_timespec |
---|
| 129 | |
---|
| 130 | |
---|
| 131 | #ifdef _TIME_H |
---|
| 132 | __BEGIN_NAMESPACE_STD |
---|
| 133 | /* Used by other time functions. */ |
---|
| 134 | struct tm |
---|
| 135 | { |
---|
| 136 | int tm_sec; /* Seconds. [0-60] (1 leap second) */ |
---|
| 137 | int tm_min; /* Minutes. [0-59] */ |
---|
| 138 | int tm_hour; /* Hours. [0-23] */ |
---|
| 139 | int tm_mday; /* Day. [1-31] */ |
---|
| 140 | int tm_mon; /* Month. [0-11] */ |
---|
| 141 | int tm_year; /* Year - 1900. */ |
---|
| 142 | int tm_wday; /* Day of week. [0-6] */ |
---|
| 143 | int tm_yday; /* Days in year.[0-365] */ |
---|
| 144 | int tm_isdst; /* DST. [-1/0/1]*/ |
---|
| 145 | |
---|
| 146 | #ifdef __USE_BSD |
---|
| 147 | long int tm_gmtoff; /* Seconds east of UTC. */ |
---|
| 148 | __const char *tm_zone; /* Timezone abbreviation. */ |
---|
| 149 | #else |
---|
| 150 | long int __tm_gmtoff; /* Seconds east of UTC. */ |
---|
| 151 | __const char *__tm_zone; /* Timezone abbreviation. */ |
---|
| 152 | #endif |
---|
| 153 | }; |
---|
| 154 | __END_NAMESPACE_STD |
---|
| 155 | #if defined __USE_XOPEN || defined __USE_POSIX || defined __USE_MISC |
---|
| 156 | __USING_NAMESPACE_STD(tm) |
---|
| 157 | #endif |
---|
| 158 | |
---|
| 159 | |
---|
| 160 | #ifdef __USE_POSIX199309 |
---|
| 161 | /* POSIX.1b structure for timer start values and intervals. */ |
---|
| 162 | struct itimerspec |
---|
| 163 | { |
---|
| 164 | struct timespec it_interval; |
---|
| 165 | struct timespec it_value; |
---|
| 166 | }; |
---|
| 167 | |
---|
| 168 | /* We can use a simple forward declaration. */ |
---|
| 169 | struct sigevent; |
---|
| 170 | |
---|
| 171 | #endif /* POSIX.1b */ |
---|
| 172 | |
---|
| 173 | #ifdef __USE_XOPEN2K |
---|
| 174 | # ifndef __pid_t_defined |
---|
| 175 | typedef __pid_t pid_t; |
---|
| 176 | # define __pid_t_defined |
---|
| 177 | # endif |
---|
| 178 | #endif |
---|
| 179 | |
---|
| 180 | |
---|
| 181 | __BEGIN_NAMESPACE_STD |
---|
| 182 | /* Time used by the program so far (user time + system time). |
---|
| 183 | The result / CLOCKS_PER_SECOND is program time in seconds. */ |
---|
| 184 | extern clock_t clock (void) __THROW; |
---|
| 185 | |
---|
| 186 | /* Return the current time and put it in *TIMER if TIMER is not NULL. */ |
---|
| 187 | extern time_t time (time_t *__timer) __THROW; |
---|
| 188 | |
---|
| 189 | /* Return the difference between TIME1 and TIME0. */ |
---|
| 190 | extern double difftime (time_t __time1, time_t __time0) |
---|
| 191 | __THROW __attribute__ ((__const__)); |
---|
| 192 | |
---|
| 193 | /* Return the `time_t' representation of TP and normalize TP. */ |
---|
| 194 | extern time_t mktime (struct tm *__tp) __THROW; |
---|
| 195 | |
---|
| 196 | |
---|
| 197 | /* Format TP into S according to FORMAT. |
---|
| 198 | Write no more than MAXSIZE characters and return the number |
---|
| 199 | of characters written, or 0 if it would exceed MAXSIZE. */ |
---|
| 200 | extern size_t strftime (char *__restrict __s, size_t __maxsize, |
---|
| 201 | __const char *__restrict __format, |
---|
| 202 | __const struct tm *__restrict __tp) __THROW; |
---|
| 203 | __END_NAMESPACE_STD |
---|
| 204 | |
---|
| 205 | # ifdef __USE_XOPEN |
---|
| 206 | /* Parse S according to FORMAT and store binary time information in TP. |
---|
| 207 | The return value is a pointer to the first unparsed character in S. */ |
---|
| 208 | extern char *strptime (__const char *__restrict __s, |
---|
| 209 | __const char *__restrict __fmt, struct tm *__tp) |
---|
| 210 | __THROW; |
---|
| 211 | # endif |
---|
| 212 | |
---|
| 213 | # ifdef __USE_GNU |
---|
| 214 | /* Similar to the two functions above but take the information from |
---|
| 215 | the provided locale and not the global locale. */ |
---|
| 216 | # include <xlocale.h> |
---|
| 217 | |
---|
| 218 | extern size_t strftime_l (char *__restrict __s, size_t __maxsize, |
---|
| 219 | __const char *__restrict __format, |
---|
| 220 | __const struct tm *__restrict __tp, |
---|
| 221 | __locale_t __loc) __THROW; |
---|
| 222 | |
---|
| 223 | extern char *strptime_l (__const char *__restrict __s, |
---|
| 224 | __const char *__restrict __fmt, struct tm *__tp, |
---|
| 225 | __locale_t __loc) __THROW; |
---|
| 226 | # endif |
---|
| 227 | |
---|
| 228 | |
---|
| 229 | __BEGIN_NAMESPACE_STD |
---|
| 230 | /* Return the `struct tm' representation of *TIMER |
---|
| 231 | in Universal Coordinated Time (aka Greenwich Mean Time). */ |
---|
| 232 | extern struct tm *gmtime (__const time_t *__timer) __THROW; |
---|
| 233 | |
---|
| 234 | /* Return the `struct tm' representation |
---|
| 235 | of *TIMER in the local timezone. */ |
---|
| 236 | extern struct tm *localtime (__const time_t *__timer) __THROW; |
---|
| 237 | __END_NAMESPACE_STD |
---|
| 238 | |
---|
| 239 | # if defined __USE_POSIX || defined __USE_MISC |
---|
| 240 | /* Return the `struct tm' representation of *TIMER in UTC, |
---|
| 241 | using *TP to store the result. */ |
---|
| 242 | extern struct tm *gmtime_r (__const time_t *__restrict __timer, |
---|
| 243 | struct tm *__restrict __tp) __THROW; |
---|
| 244 | |
---|
| 245 | /* Return the `struct tm' representation of *TIMER in local time, |
---|
| 246 | using *TP to store the result. */ |
---|
| 247 | extern struct tm *localtime_r (__const time_t *__restrict __timer, |
---|
| 248 | struct tm *__restrict __tp) __THROW; |
---|
| 249 | # endif /* POSIX or misc */ |
---|
| 250 | |
---|
| 251 | __BEGIN_NAMESPACE_STD |
---|
| 252 | /* Return a string of the form "Day Mon dd hh:mm:ss yyyy\n" |
---|
| 253 | that is the representation of TP in this format. */ |
---|
| 254 | extern char *asctime (__const struct tm *__tp) __THROW; |
---|
| 255 | |
---|
| 256 | /* Equivalent to `asctime (localtime (timer))'. */ |
---|
| 257 | extern char *ctime (__const time_t *__timer) __THROW; |
---|
| 258 | __END_NAMESPACE_STD |
---|
| 259 | |
---|
| 260 | # if defined __USE_POSIX || defined __USE_MISC |
---|
| 261 | /* Reentrant versions of the above functions. */ |
---|
| 262 | |
---|
| 263 | /* Return in BUF a string of the form "Day Mon dd hh:mm:ss yyyy\n" |
---|
| 264 | that is the representation of TP in this format. */ |
---|
| 265 | extern char *asctime_r (__const struct tm *__restrict __tp, |
---|
| 266 | char *__restrict __buf) __THROW; |
---|
| 267 | |
---|
| 268 | /* Equivalent to `asctime_r (localtime_r (timer, *TMP*), buf)'. */ |
---|
| 269 | extern char *ctime_r (__const time_t *__restrict __timer, |
---|
| 270 | char *__restrict __buf) __THROW; |
---|
| 271 | # endif /* POSIX or misc */ |
---|
| 272 | |
---|
| 273 | |
---|
| 274 | /* Defined in localtime.c. */ |
---|
| 275 | extern char *__tzname[2]; /* Current timezone names. */ |
---|
| 276 | extern int __daylight; /* If daylight-saving time is ever in use. */ |
---|
| 277 | extern long int __timezone; /* Seconds west of UTC. */ |
---|
| 278 | |
---|
| 279 | |
---|
| 280 | # ifdef __USE_POSIX |
---|
| 281 | /* Same as above. */ |
---|
| 282 | extern char *tzname[2]; |
---|
| 283 | |
---|
| 284 | /* Set time conversion information from the TZ environment variable. |
---|
| 285 | If TZ is not defined, a locale-dependent default is used. */ |
---|
| 286 | extern void tzset (void) __THROW; |
---|
| 287 | # endif |
---|
| 288 | |
---|
| 289 | # if defined __USE_SVID || defined __USE_XOPEN |
---|
| 290 | extern int daylight; |
---|
| 291 | extern long int timezone; |
---|
| 292 | # endif |
---|
| 293 | |
---|
| 294 | # ifdef __USE_SVID |
---|
| 295 | /* Set the system time to *WHEN. |
---|
| 296 | This call is restricted to the superuser. */ |
---|
| 297 | extern int stime (__const time_t *__when) __THROW; |
---|
| 298 | # endif |
---|
| 299 | |
---|
| 300 | |
---|
| 301 | /* Nonzero if YEAR is a leap year (every 4 years, |
---|
| 302 | except every 100th isn't, and every 400th is). */ |
---|
| 303 | # define __isleap(year) \ |
---|
| 304 | ((year) % 4 == 0 && ((year) % 100 != 0 || (year) % 400 == 0)) |
---|
| 305 | |
---|
| 306 | |
---|
| 307 | # ifdef __USE_MISC |
---|
| 308 | /* Miscellaneous functions many Unices inherited from the public domain |
---|
| 309 | localtime package. These are included only for compatibility. */ |
---|
| 310 | |
---|
| 311 | /* Like `mktime', but for TP represents Universal Time, not local time. */ |
---|
| 312 | extern time_t timegm (struct tm *__tp) __THROW; |
---|
| 313 | |
---|
| 314 | /* Another name for `mktime'. */ |
---|
| 315 | extern time_t timelocal (struct tm *__tp) __THROW; |
---|
| 316 | |
---|
| 317 | /* Return the number of days in YEAR. */ |
---|
| 318 | extern int dysize (int __year) __THROW __attribute__ ((__const__)); |
---|
| 319 | # endif |
---|
| 320 | |
---|
| 321 | |
---|
| 322 | # ifdef __USE_POSIX199309 |
---|
| 323 | /* Pause execution for a number of nanoseconds. |
---|
| 324 | |
---|
| 325 | This function is a cancellation point and therefore not marked with |
---|
| 326 | __THROW. */ |
---|
| 327 | extern int nanosleep (__const struct timespec *__requested_time, |
---|
| 328 | struct timespec *__remaining); |
---|
| 329 | |
---|
| 330 | |
---|
| 331 | /* Get resolution of clock CLOCK_ID. */ |
---|
| 332 | extern int clock_getres (clockid_t __clock_id, struct timespec *__res) __THROW; |
---|
| 333 | |
---|
| 334 | /* Get current value of clock CLOCK_ID and store it in TP. */ |
---|
| 335 | extern int clock_gettime (clockid_t __clock_id, struct timespec *__tp) __THROW; |
---|
| 336 | |
---|
| 337 | /* Set clock CLOCK_ID to value TP. */ |
---|
| 338 | extern int clock_settime (clockid_t __clock_id, __const struct timespec *__tp) |
---|
| 339 | __THROW; |
---|
| 340 | |
---|
| 341 | # ifdef __USE_XOPEN2K |
---|
| 342 | /* High-resolution sleep with the specified clock. |
---|
| 343 | |
---|
| 344 | This function is a cancellation point and therefore not marked with |
---|
| 345 | __THROW. */ |
---|
| 346 | extern int clock_nanosleep (clockid_t __clock_id, int __flags, |
---|
| 347 | __const struct timespec *__req, |
---|
| 348 | struct timespec *__rem); |
---|
| 349 | |
---|
| 350 | /* Return clock ID for CPU-time clock. */ |
---|
| 351 | extern int clock_getcpuclockid (pid_t __pid, clockid_t *__clock_id) __THROW; |
---|
| 352 | # endif |
---|
| 353 | |
---|
| 354 | |
---|
| 355 | /* Create new per-process timer using CLOCK_ID. */ |
---|
| 356 | extern int timer_create (clockid_t __clock_id, |
---|
| 357 | struct sigevent *__restrict __evp, |
---|
| 358 | timer_t *__restrict __timerid) __THROW; |
---|
| 359 | |
---|
| 360 | /* Delete timer TIMERID. */ |
---|
| 361 | extern int timer_delete (timer_t __timerid) __THROW; |
---|
| 362 | |
---|
| 363 | /* Set timer TIMERID to VALUE, returning old value in OVLAUE. */ |
---|
| 364 | extern int timer_settime (timer_t __timerid, int __flags, |
---|
| 365 | __const struct itimerspec *__restrict __value, |
---|
| 366 | struct itimerspec *__restrict __ovalue) __THROW; |
---|
| 367 | |
---|
| 368 | /* Get current value of timer TIMERID and store it in VLAUE. */ |
---|
| 369 | extern int timer_gettime (timer_t __timerid, struct itimerspec *__value) |
---|
| 370 | __THROW; |
---|
| 371 | |
---|
| 372 | /* Get expiration overrun for timer TIMERID. */ |
---|
| 373 | extern int timer_getoverrun (timer_t __timerid) __THROW; |
---|
| 374 | # endif |
---|
| 375 | |
---|
| 376 | |
---|
| 377 | # ifdef __USE_XOPEN_EXTENDED |
---|
| 378 | /* Set to one of the following values to indicate an error. |
---|
| 379 | 1 the DATEMSK environment variable is null or undefined, |
---|
| 380 | 2 the template file cannot be opened for reading, |
---|
| 381 | 3 failed to get file status information, |
---|
| 382 | 4 the template file is not a regular file, |
---|
| 383 | 5 an error is encountered while reading the template file, |
---|
| 384 | 6 memory allication failed (not enough memory available), |
---|
| 385 | 7 there is no line in the template that matches the input, |
---|
| 386 | 8 invalid input specification Example: February 31 or a time is |
---|
| 387 | specified that can not be represented in a time_t (representing |
---|
| 388 | the time in seconds since 00:00:00 UTC, January 1, 1970) */ |
---|
| 389 | extern int getdate_err; |
---|
| 390 | |
---|
| 391 | /* Parse the given string as a date specification and return a value |
---|
| 392 | representing the value. The templates from the file identified by |
---|
| 393 | the environment variable DATEMSK are used. In case of an error |
---|
| 394 | `getdate_err' is set. |
---|
| 395 | |
---|
| 396 | This function is a possible cancellation points and therefore not |
---|
| 397 | marked with __THROW. */ |
---|
| 398 | extern struct tm *getdate (__const char *__string); |
---|
| 399 | # endif |
---|
| 400 | |
---|
| 401 | # ifdef __USE_GNU |
---|
| 402 | /* Since `getdate' is not reentrant because of the use of `getdate_err' |
---|
| 403 | and the static buffer to return the result in, we provide a thread-safe |
---|
| 404 | variant. The functionality is the same. The result is returned in |
---|
| 405 | the buffer pointed to by RESBUFP and in case of an error the return |
---|
| 406 | value is != 0 with the same values as given above for `getdate_err'. |
---|
| 407 | |
---|
| 408 | This function is not part of POSIX and therefore no official |
---|
| 409 | cancellation point. But due to similarity with an POSIX interface |
---|
| 410 | or due to the implementation it is a cancellation point and |
---|
| 411 | therefore not marked with __THROW. */ |
---|
| 412 | extern int getdate_r (__const char *__restrict __string, |
---|
| 413 | struct tm *__restrict __resbufp); |
---|
| 414 | # endif |
---|
| 415 | |
---|
| 416 | __END_DECLS |
---|
| 417 | |
---|
| 418 | #endif /* <time.h> included. */ |
---|
| 419 | |
---|
| 420 | #endif /* <time.h> not already included. */ |
---|