Module: kamailio
Branch: master
Commit: 2f35d794cf9f77d75462e32201b6db8bc51c66f1
URL: 
https://github.com/kamailio/kamailio/commit/2f35d794cf9f77d75462e32201b6db8bc51c66f1

Author: Daniel-Constantin Mierla <mico...@gmail.com>
Committer: Daniel-Constantin Mierla <mico...@gmail.com>
Date: 2025-07-24T12:42:17+02:00

tls: docs for keylog_mode and keylog_file parameters

---

Modified: src/modules/tls/doc/params.xml

---

Diff:  
https://github.com/kamailio/kamailio/commit/2f35d794cf9f77d75462e32201b6db8bc51c66f1.diff
Patch: 
https://github.com/kamailio/kamailio/commit/2f35d794cf9f77d75462e32201b6db8bc51c66f1.patch

---

diff --git a/src/modules/tls/doc/params.xml b/src/modules/tls/doc/params.xml
index 0ed54a2208a..c29c29d073c 100644
--- a/src/modules/tls/doc/params.xml
+++ b/src/modules/tls/doc/params.xml
@@ -1506,4 +1506,56 @@ verify_client = optional_no_ca
                 </listitem>
             </itemizedlist>
         </section>
+       <section id="tls.p.keylog_mode">
+       <title><varname>keylog_mode</varname> (int)</title>
+       <para>
+               Control the TLS key logging functionality, available for libssl 
version
+               greater than 1.1.0. Its value is composed from bitwise values 
(can be
+               made as sum of them):
+       </para>
+       <itemizedlist>
+               <listitem>
+                       <para><emphasis>0</emphasis> - keys logging 
inactive</para>
+               </listitem>
+               <listitem>
+                       <para><emphasis>1 (bit 1)</emphasis> - keys logging 
active</para>
+               </listitem>
+               <listitem>
+                       <para><emphasis>2 (bit 2)</emphasis> - write keys to 
NOTICE log</para>
+               </listitem>
+               <listitem>
+                       <para><emphasis>4 (bit 3)</emphasis> - write keys to 
file</para>
+               </listitem>
+       </itemizedlist>
+       <para>
+               The default value: 0.
+       </para>
+       <example>
+               <title>Set <varname>keylog_mode</varname> parameter</title>
+               <programlisting>
+...
+modparam("tls", "keylog_mode", 7)
+...
+       </programlisting>
+       </example>
+       </section>
+       <section id="tls.p.keylog_file">
+       <title><varname>keylog_file</varname> (str)</title>
+       <para>
+               Path to the file where to write the TLS keys. The values are 
appended
+               to the content of the file. The value 4 (bit 3) has to be set to
+               keylog_mode parameter.
+       </para>
+       <para>
+               The default value: NULL.
+       </para>
+       <example>
+               <title>Set <varname>keylog_file</varname> parameter</title>
+               <programlisting>
+...
+modparam("tls", "keylog_file", "/tmp/kamailio-tls-keylog.txt")
+...
+       </programlisting>
+       </example>
+       </section>
  </section>

_______________________________________________
Kamailio - Development Mailing List -- sr-dev@lists.kamailio.org
To unsubscribe send an email to sr-dev-le...@lists.kamailio.org
Important: keep the mailing list in the recipients, do not reply only to the 
sender!

Reply via email to