From 54bce5c707feb91b2de90abe64e75952972816f0 Mon Sep 17 00:00:00 2001
From: Daniel-Constantin Mierla <miconda@gmail.com>
Date: Sat, 28 Mar 2020 10:11:28 +0100
Subject: [PATCH] usrloc: docs for ka_loglevel and ka_logmsg params

---
 src/modules/usrloc/doc/usrloc_admin.xml | 44 +++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/src/modules/usrloc/doc/usrloc_admin.xml b/src/modules/usrloc/doc/usrloc_admin.xml
index 7b945a76bbe..a6d9654d513 100644
--- a/src/modules/usrloc/doc/usrloc_admin.xml
+++ b/src/modules/usrloc/doc/usrloc_admin.xml
@@ -1424,6 +1424,50 @@ modparam("usrloc", "ka_filter", 1)
 		</example>
 	</section>
 
+	<section id="usrloc.p.ka_loglevel">
+		<title><varname>ka_loglevel</varname> (int)</title>
+		<para>
+		The level to print the log message when the keepalive response is
+		received. It should be a value between LOG_ALERT
+		</para>
+		<para>
+		Default value is <quote>kamailio.org</quote>.
+		</para>
+		<example>
+		<title><varname>ka_loglevel</varname> parameter usage</title>
+		<programlisting format="linespecific">
+...
+modparam("usrloc", "ka_loglevel", 1)
+...
+		</programlisting>
+		</example>
+	</section>
+
+	<section id="usrloc.p.ka_logmsg">
+		<title><varname>ka_logmsg</varname> (str)</title>
+		<para>
+		The formatted log specification to be added to the message printed when
+		the keepalive is received and roundtrip time is computed. The log
+		message starts with "keepalive roundtrip: %u.%06u sec - ruid [%.*s]",
+		then concatenates the value of this parameter and the end of line.
+		</para>
+		<para>
+		The value of this parameter can contain script variables that are
+		evaluated with the SIP response.
+		</para>
+		<para>
+		Default value is <quote> to-uri: [$tu] src-uri: [$su]</quote>.
+		</para>
+		<example>
+		<title><varname>ka_logmsg</varname> parameter usage</title>
+		<programlisting format="linespecific">
+...
+modparam("usrloc", "ka_logmsg", " to-uri: [$tu] src-uri: [$su]")
+...
+		</programlisting>
+		</example>
+	</section>
+
 	</section>
 
 	<section>