python:gkdi: Add notes on GKDI time periods

Signed-off-by: Jo Sutton <josutton@catalyst.net.nz>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>

diff --git a/python/samba/gkdi.py b/python/samba/gkdi.py
index 4179263b769e66931a46e1e6784bf3eedaaf23ac..61134e1bf942b6ea19953f4c2f1cd36c46fb02ff 100644 (file)
--- a/python/samba/gkdi.py
+++ b/python/samba/gkdi.py
@@ -105,6 +105,10 @@ class UndefinedStartTime(Exception):
 
 @total_ordering
 class Gkid:
+    # L2 increments every 10 hours. It rolls over after 320 hours (13 days and 8 hours).
+    # L1 increments every 320 hours. It rolls over after 10240 hours (426 days and 16 hours).
+    # L0 increments every 10240 hours. It rolls over after 43980465111040 hours (five billion years).
+
     __slots__ = ["_l0_idx", "_l1_idx", "_l2_idx"]
 
     max_l0_idx = 0x7FFF_FFFF