Telnet-Keepalive: Delay konfigurierbar
Das Delay fuer das Telnet Keepalive ist ueber die Prop
P_TELNET_KEEPALIVE_DELAY konfigurierbar.
Momentan koennen das nur Magier. Fuer Spieler sollte
ein sinnvoller Default gewaehlt werden und bei Bedarf
durch einen Magier geaendert werden.
Change-Id: I556f298bde3b4ee8ece6df01051010316c2436b3
diff --git a/doc/pcmd/telnet b/doc/pcmd/telnet
index 029317f..489708f 100644
--- a/doc/pcmd/telnet
+++ b/doc/pcmd/telnet
@@ -32,6 +32,7 @@
SIEHE AUCH:
telnegs, telnet keepalive, telnet gmcp
+ P_TELNET_KEEPALIVE_DELAY
LETZTE AeNDERUNG:
- 15.01.2018, Zesstra
+ 26.07.2019, Zesstra
diff --git a/doc/pcmd/telnet_keepalive b/doc/pcmd/telnet_keepalive
index eecbfd7..770ceba 100644
--- a/doc/pcmd/telnet_keepalive
+++ b/doc/pcmd/telnet_keepalive
@@ -19,11 +19,11 @@
Verbindung terminiert wird. Daher besitzen die Spielershells ein
einschaltbares 'Telnet-Keep-Alive'.
- Diese Funktion schickt alle 4 min Daten an eure Clients, die diese
- nicht anzeigen, aber ihrerseits beantworten/bestaetigen (sofern der Client
- dies unterstuetzt). So gibt es in der Verbindung zum Mud min. alle 4 min
- Datenverkehr. Das sollte Verbindungsabbruechen durch Inaktivitaet
- vorbeugen.
+ Diese Funktion schickt regelmaessig (Standardeinstellung: alle 4 min)
+ Daten an eure Clients, die diese nicht anzeigen, aber ihrerseits
+ beantworten/bestaetigen (sofern der Client dies unterstuetzt). So gibt
+ es in der Verbindung zum Mud regelmaessig Datenverkehr. Das sollte
+ Verbindungsabbruechen durch Inaktivitaet vorbeugen.
Bitte schaltet diese Funktion aber nur ein, wenn ihr sie braucht, d.h.
ohne sie Probleme mit Verbindungsabbruechen beim Ideln habt.
@@ -32,11 +32,9 @@
Ohne Argumente wird der aktuelle Zustand angezeigt.
- Hinweis fuer Magier: Magier im Magiermodus (mschau ein) kommen leider
- nicht in den Genuss dieses Features, weil sie keinen Heartbeat haben.
-
SIEHE AUCH:
- telnegs, telnet gmcp
+ telnegs, telnet gmcp,
+ P_TELNET_KEEPALIVE_DELAY
LETZTE AeNDERUNG:
- 08.12.2015, Zesstra
+ 26.07.2019, Zesstra
diff --git a/doc/sphinx/props/P_TELNET_KEEPALIVE_DELAY.rst b/doc/sphinx/props/P_TELNET_KEEPALIVE_DELAY.rst
new file mode 100644
index 0000000..d50b4cb
--- /dev/null
+++ b/doc/sphinx/props/P_TELNET_KEEPALIVE_DELAY.rst
@@ -0,0 +1,39 @@
+P_TELNET_KEEPALIVE_DELAY
+========================
+
+NAME
+----
+
+ P_TELNET_KEEPALIVE_DELAY "p_lib_telnet_alive_delay"
+
+DEFINIERT IN
+------------
+
+ <player/telnetneg.h>
+
+BESCHREIBUNG
+------------
+
+ In dieser Property kann der zeitliche Abstand zwischen zwei Aussendungen
+ der "Telnet Timing Mark", welche fuer das Telnet keep-alive benutzt wird,
+ bestimmt werden. Die Angabe ist in Heartbeats.
+ Eine 0 fuehrt zu einer Standardverzoegerung (zur Zeit 240 s).
+
+ Wenn diese Property in einem Magier (oder Spieler) gesetzt wird, sollte
+ experimentell ermittelt werden, welcher Wert sinnvoll ist. Dies kann z.B.
+ dadurch erfolgen, dass von 120 (Heartbeats) eine stufenweise Reduktion
+ erfolgt, bis kein Disconnect mehr erfolgt. Helfen sehr niedrige Werte
+ nicht, sollte die Verzoegerung wieder erhoeht werden bzw. das Keepalive
+ ganz abgeschaltet werden.
+
+BEMERKUNGEN
+-----------
+
+ Die Property sollte nicht auf weniger als 30 gesetzt werden.
+
+SIEHE AUCH
+----------
+
+ :doc:`../pcmd/telnet`
+
+25.07.2019, Zesstra