|
 |
963210 |
From 6437685130b68670888db1d0551f5464d56c4cec Mon Sep 17 00:00:00 2001
|
|
|
963210 |
From: Greg Hudson <ghudson@mit.edu>
|
|
|
963210 |
Date: Sat, 22 Apr 2017 09:49:12 -0400
|
|
|
963210 |
Subject: [PATCH] Add timestamp helper functions
|
|
|
963210 |
|
|
|
963210 |
Add k5-int.h helper functions to manipulate krb5_timestamp values,
|
|
|
963210 |
avoiding undefined behavior and treating negative timestamp values as
|
|
|
963210 |
times between 2038 and 2106. Add a doxygen comment for krb5_timestamp
|
|
|
963210 |
indicating how third-party code should use it safely.
|
|
|
963210 |
|
|
|
963210 |
ticket: 8352
|
|
|
963210 |
(cherry picked from commit 58e9155060cd93b1a7557e37fbc9b077b76465c2)
|
|
|
963210 |
---
|
|
|
963210 |
src/include/k5-int.h | 31 +++++++++++++++++++++++++++++++
|
|
|
963210 |
src/include/krb5/krb5.hin | 9 +++++++++
|
|
|
963210 |
2 files changed, 40 insertions(+)
|
|
|
963210 |
|
|
|
963210 |
diff --git a/src/include/k5-int.h b/src/include/k5-int.h
|
|
|
963210 |
index 06ca2b66d..82ee20760 100644
|
|
|
963210 |
--- a/src/include/k5-int.h
|
|
|
963210 |
+++ b/src/include/k5-int.h
|
|
|
963210 |
@@ -2353,6 +2353,37 @@ k5memdup0(const void *in, size_t len, krb5_error_code *code)
|
|
|
963210 |
return ptr;
|
|
|
963210 |
}
|
|
|
963210 |
|
|
|
963210 |
+/* Convert a krb5_timestamp to a time_t value, treating the negative range of
|
|
|
963210 |
+ * krb5_timestamp as times between 2038 and 2106 (if time_t is 64-bit). */
|
|
|
963210 |
+static inline time_t
|
|
|
963210 |
+ts2tt(krb5_timestamp timestamp)
|
|
|
963210 |
+{
|
|
|
963210 |
+ return (time_t)(uint32_t)timestamp;
|
|
|
963210 |
+}
|
|
|
963210 |
+
|
|
|
963210 |
+/* Return the delta between two timestamps (a - b) as a signed 32-bit value,
|
|
|
963210 |
+ * without relying on undefined behavior. */
|
|
|
963210 |
+static inline krb5_deltat
|
|
|
963210 |
+ts_delta(krb5_timestamp a, krb5_timestamp b)
|
|
|
963210 |
+{
|
|
|
963210 |
+ return (krb5_deltat)((uint32_t)a - (uint32_t)b);
|
|
|
963210 |
+}
|
|
|
963210 |
+
|
|
|
963210 |
+/* Increment a timestamp by a signed 32-bit interval, without relying on
|
|
|
963210 |
+ * undefined behavior. */
|
|
|
963210 |
+static inline krb5_timestamp
|
|
|
963210 |
+ts_incr(krb5_timestamp ts, krb5_deltat delta)
|
|
|
963210 |
+{
|
|
|
963210 |
+ return (krb5_timestamp)((uint32_t)ts + (uint32_t)delta);
|
|
|
963210 |
+}
|
|
|
963210 |
+
|
|
|
963210 |
+/* Return true if a comes after b. */
|
|
|
963210 |
+static inline krb5_boolean
|
|
|
963210 |
+ts_after(krb5_timestamp a, krb5_timestamp b)
|
|
|
963210 |
+{
|
|
|
963210 |
+ return (uint32_t)a > (uint32_t)b;
|
|
|
963210 |
+}
|
|
|
963210 |
+
|
|
|
963210 |
krb5_error_code KRB5_CALLCONV
|
|
|
963210 |
krb5_get_credentials_for_user(krb5_context context, krb5_flags options,
|
|
|
963210 |
krb5_ccache ccache,
|
|
|
963210 |
diff --git a/src/include/krb5/krb5.hin b/src/include/krb5/krb5.hin
|
|
|
963210 |
index cf60d6c41..53ad85384 100644
|
|
|
963210 |
--- a/src/include/krb5/krb5.hin
|
|
|
963210 |
+++ b/src/include/krb5/krb5.hin
|
|
|
963210 |
@@ -187,7 +187,16 @@ typedef krb5_int32 krb5_cryptotype;
|
|
|
963210 |
|
|
|
963210 |
typedef krb5_int32 krb5_preauthtype; /* This may change, later on */
|
|
|
963210 |
typedef krb5_int32 krb5_flags;
|
|
|
963210 |
+
|
|
|
963210 |
+/**
|
|
|
963210 |
+ * Represents a timestamp in seconds since the POSIX epoch. This legacy type
|
|
|
963210 |
+ * is used frequently in the ABI, but cannot represent timestamps after 2038 as
|
|
|
963210 |
+ * a positive number. Code which uses this type should cast values of it to
|
|
|
963210 |
+ * uint32_t so that negative values are treated as timestamps between 2038 and
|
|
|
963210 |
+ * 2106 on platforms with 64-bit time_t.
|
|
|
963210 |
+ */
|
|
|
963210 |
typedef krb5_int32 krb5_timestamp;
|
|
|
963210 |
+
|
|
|
963210 |
typedef krb5_int32 krb5_deltat;
|
|
|
963210 |
|
|
|
963210 |
/**
|