1 /* 2 * Copyright (C) 2008 The Android Open Source Project 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * * Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * * Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in 12 * the documentation and/or other materials provided with the 13 * distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 18 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 19 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 21 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 22 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 23 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 24 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 25 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26 * SUCH DAMAGE. 27 */ 28 29 #ifndef _SYS_TIME_H_ 30 #define _SYS_TIME_H_ 31 32 #include <sys/cdefs.h> 33 #include <sys/types.h> 34 #include <linux/time.h> 35 36 /* POSIX says <sys/time.h> gets you most of <sys/select.h> and may get you all of it. */ 37 #include <sys/select.h> 38 39 __BEGIN_DECLS 40 41 int gettimeofday(struct timeval* _Nullable __tv, struct timezone* _Nullable __tz); 42 int settimeofday(const struct timeval* _Nullable __tv, const struct timezone* _Nullable __tz); 43 44 int getitimer(int __which, struct itimerval* _Nonnull __current_value); 45 int setitimer(int __which, const struct itimerval* _Nonnull __new_value, struct itimerval* _Nullable __old_value); 46 47 int utimes(const char* _Nonnull __path, const struct timeval __times[_Nullable 2]); 48 49 #if defined(__USE_BSD) 50 int futimes(int __fd, const struct timeval __times[_Nullable 2]) __INTRODUCED_IN(26); 51 int lutimes(const char* _Nonnull __path, const struct timeval __times[_Nullable 2]) __INTRODUCED_IN(26); 52 #endif 53 54 #if defined(__USE_GNU) 55 /** 56 * [futimesat(2)](https://man7.org/linux/man-pages/man2/futimesat.2.html) sets 57 * file timestamps. 58 * 59 * Note: Linux supports `__path` being NULL (in which case `__dir_fd` need not 60 * be a directory), allowing futimensat() to be implemented with utimensat(). 61 * Most callers should just use utimensat() directly, especially on Android 62 * where utimensat() has been available for longer than futimesat(). 63 * 64 * Returns 0 on success and -1 and sets `errno` on failure. 65 * 66 * Available since API level 26. 67 */ 68 int futimesat(int __dir_fd, const char* __BIONIC_COMPLICATED_NULLNESS __path, const struct timeval __times[_Nullable 2]) __INTRODUCED_IN(26); 69 #endif 70 71 #define timerclear(a) \ 72 ((a)->tv_sec = (a)->tv_usec = 0) 73 74 #define timerisset(a) \ 75 ((a)->tv_sec != 0 || (a)->tv_usec != 0) 76 77 #define timercmp(a, b, op) \ 78 ((a)->tv_sec == (b)->tv_sec \ 79 ? (a)->tv_usec op (b)->tv_usec \ 80 : (a)->tv_sec op (b)->tv_sec) 81 82 #define timeradd(a, b, res) \ 83 do { \ 84 (res)->tv_sec = (a)->tv_sec + (b)->tv_sec; \ 85 (res)->tv_usec = (a)->tv_usec + (b)->tv_usec; \ 86 if ((res)->tv_usec >= 1000000) { \ 87 (res)->tv_usec -= 1000000; \ 88 (res)->tv_sec += 1; \ 89 } \ 90 } while (0) 91 92 #define timersub(a, b, res) \ 93 do { \ 94 (res)->tv_sec = (a)->tv_sec - (b)->tv_sec; \ 95 (res)->tv_usec = (a)->tv_usec - (b)->tv_usec; \ 96 if ((res)->tv_usec < 0) { \ 97 (res)->tv_usec += 1000000; \ 98 (res)->tv_sec -= 1; \ 99 } \ 100 } while (0) 101 102 #define TIMEVAL_TO_TIMESPEC(tv, ts) { \ 103 (ts)->tv_sec = (tv)->tv_sec; \ 104 (ts)->tv_nsec = (tv)->tv_usec * 1000; \ 105 } 106 #define TIMESPEC_TO_TIMEVAL(tv, ts) { \ 107 (tv)->tv_sec = (ts)->tv_sec; \ 108 (tv)->tv_usec = (ts)->tv_nsec / 1000; \ 109 } 110 111 __END_DECLS 112 113 #endif 114