From 55e586e73cb3e06764988233a7576482c622445c Mon Sep 17 00:00:00 2001 From: =?utf8?q?Felix=20D=C3=B6rre?= Date: Mon, 21 Aug 2017 01:15:18 +0200 Subject: [PATCH] pre: document intendet ping behaviour --- src/club/wpia/gigi/ping/PingerDaemon.java | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/src/club/wpia/gigi/ping/PingerDaemon.java b/src/club/wpia/gigi/ping/PingerDaemon.java index 51cc9858..9b3a8650 100644 --- a/src/club/wpia/gigi/ping/PingerDaemon.java +++ b/src/club/wpia/gigi/ping/PingerDaemon.java @@ -9,11 +9,30 @@ import club.wpia.gigi.database.DatabaseConnection; import club.wpia.gigi.database.DatabaseConnection.Link; import club.wpia.gigi.database.GigiPreparedStatement; import club.wpia.gigi.database.GigiResultSet; +import club.wpia.gigi.dbObjects.Certificate.RevocationType; import club.wpia.gigi.dbObjects.Domain; import club.wpia.gigi.dbObjects.DomainPingConfiguration; import club.wpia.gigi.dbObjects.DomainPingType; import club.wpia.gigi.util.RandomToken; +/** + *

+ * This thread is executing pings for domains, if the last ping is older than a + * specific amount of time. + *

+ *

+ * When a ping fails the corresponding domain becomes unverified. If the ping + * succeeds the domains becomes verified and all other domain with the same name + * become unverified. + *

+ *

+ * When a domain becomes unverified and has still certificated attached to it + * the certificates will become "pending for revocation". This state is removed + * when the domain is successfully verified again. When this state prolongs for + * more than 2 weeks, such certificates are revoked with type + * {@link RevocationType#PING_TIMEOUT}. + *

+ */ public class PingerDaemon extends Thread { HashMap pingers = new HashMap<>(); -- 2.39.2