ngtcp2_tstamp.h 2.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. /*
  2. * ngtcp2
  3. *
  4. * Copyright (c) 2023 ngtcp2 contributors
  5. *
  6. * Permission is hereby granted, free of charge, to any person obtaining
  7. * a copy of this software and associated documentation files (the
  8. * "Software"), to deal in the Software without restriction, including
  9. * without limitation the rights to use, copy, modify, merge, publish,
  10. * distribute, sublicense, and/or sell copies of the Software, and to
  11. * permit persons to whom the Software is furnished to do so, subject to
  12. * the following conditions:
  13. *
  14. * The above copyright notice and this permission notice shall be
  15. * included in all copies or substantial portions of the Software.
  16. *
  17. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  18. * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  19. * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  20. * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  21. * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  22. * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  23. * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  24. */
  25. #ifndef NGTCP2_TSTAMP_H
  26. #define NGTCP2_TSTAMP_H
  27. #ifdef HAVE_CONFIG_H
  28. # include <config.h>
  29. #endif /* defined(HAVE_CONFIG_H) */
  30. #include <ngtcp2/ngtcp2.h>
  31. /*
  32. * ngtcp2_tstamp_elapsed returns nonzero if at least |d| has passed
  33. * since |base|. |ts| expresses a current time, and must not be
  34. * UINT64_MAX.
  35. *
  36. * If |base| is UINT64_MAX, this function returns 0 because UINT64_MAX
  37. * is an invalid timestamp. Otherwise, if |base| + |d| >= UINT64_MAX,
  38. * this function returns 0.
  39. *
  40. * !ngtcp2_tstamp_elapsed() == ngtcp2_tstamp_not_elapsed() does not
  41. * hold when |base| is UINT64_MAX. If you need nonzero if |base| is
  42. * UINT64_MAX, use !ngtcp2_tstamp_elapsed. Otherwise, use
  43. * ngtcp2_tstamp_not_elapsed.
  44. */
  45. static inline int ngtcp2_tstamp_elapsed(ngtcp2_tstamp base, ngtcp2_duration d,
  46. ngtcp2_tstamp ts) {
  47. return base != UINT64_MAX && base < UINT64_MAX - d && base + d <= ts;
  48. }
  49. /*
  50. * ngtcp2_tstamp_not_elapsed returns nonzero if |d| has not passed
  51. * since |base|. |ts| expresses a current time, and must not be
  52. * UINT64_MAX.
  53. *
  54. * If |base| is UINT64_MAX, this function returns 0 because UINT64_MAX
  55. * is an invalid timestamp. Otherwise, if |base| + |d| >= UINT64_MAX,
  56. * this function returns nonzero.
  57. */
  58. static inline int ngtcp2_tstamp_not_elapsed(ngtcp2_tstamp base,
  59. ngtcp2_duration d,
  60. ngtcp2_tstamp ts) {
  61. return base != UINT64_MAX && (base >= UINT64_MAX - d || base + d > ts);
  62. }
  63. #endif /* !defined(NGTCP2_TSTAMP_H) */