Module: kamailio
Branch: master
Commit: fa7241c18590c23b8dc6ef4b250cc360f1563f61
URL: https://github.com/kamailio/kamailio/commit/fa7241c18590c23b8dc6ef4b250cc36…
Author: Kamailio Dev <kamailio.dev(a)kamailio.org>
Committer: Kamailio Dev <kamailio.dev(a)kamailio.org>
Date: 2020-07-15T11:46:17+02:00
modules: readme files regenerated - sipdump ... [skip ci]
---
Modified: src/modules/sipdump/README
---
Diff: https://github.com/kamailio/kamailio/commit/fa7241c18590c23b8dc6ef4b250cc36…
Patch: https://github.com/kamailio/kamailio/commit/fa7241c18590c23b8dc6ef4b250cc36…
---
diff --git a/src/modules/sipdump/README b/src/modules/sipdump/README
index e1841bf545..a8c0b30327 100644
--- a/src/modules/sipdump/README
+++ b/src/modules/sipdump/README
@@ -154,9 +154,13 @@ modparam("sipdump", "enable", 1)
3.2. mode (int)
Set the type of activity done by the module, the value can be set based
- on flags: 1 - write to files; 2 - execute event route
+ on flags: 1 (value 1) - write to text files; 2 (value 2) - execute
+ event route; 3 (value 4) - write to pcap files.
- Default value is 1 (write to files).
+ To enable several activity modes, set the parameter to the sum of
+ correspinding values.
+
+ Default value is 1 (write to text files).
Example 1.2. Set mode parameter
...
@@ -199,7 +203,8 @@ modparam("sipdump", "folder", "/run/kamailio")
3.6. fprefix (str)
File name prefix. The date is appended to this prefix in the format
- yyyy-mm-dd--hh-mm-ss. The extension of the file is ".data".
+ yyyy-mm-dd--hh-mm-ss. The extension of the text file is ".data", of the
+ meta file is ".meta" and of the pcap file is ".pcap".
Default value is "kamailio-sipdump-".
@@ -299,3 +304,9 @@ route[TCLEAN] {
exec_cmd("find /tmp -type f -name kamailio-sipdump-* -mtime +1 -delete &");
}
...
+
+ If operational mode is set to write the pcap files, note that packets
+ in the pcap file are generated always with transport UDP, no matter the
+ SIP traffic was over another transport layer like TCP, TLS, SCTP or
+ WSS. The headers of the SIP message (e.g., Via, Route) should provide
+ hints about what the SIP transport layer.
Module: kamailio
Branch: master
Commit: 77756cdf1b18e30d729de1055a56faa516808eee
URL: https://github.com/kamailio/kamailio/commit/77756cdf1b18e30d729de1055a56faa…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2020-07-15T11:36:11+02:00
sipdump: docs - note about enabling many activity modes
---
Modified: src/modules/sipdump/doc/sipdump_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/77756cdf1b18e30d729de1055a56faa…
Patch: https://github.com/kamailio/kamailio/commit/77756cdf1b18e30d729de1055a56faa…
---
diff --git a/src/modules/sipdump/doc/sipdump_admin.xml b/src/modules/sipdump/doc/sipdump_admin.xml
index a02366528f..ab2db75069 100644
--- a/src/modules/sipdump/doc/sipdump_admin.xml
+++ b/src/modules/sipdump/doc/sipdump_admin.xml
@@ -96,8 +96,13 @@ modparam("sipdump", "enable", 1)
<title><varname>mode</varname> (int)</title>
<para>
Set the type of activity done by the module, the value can be set
- based on flags: 1 - write to text files; 2 - execute event route;
- 3 - write to pcap files
+ based on flags: 1 (value 1) - write to text files;
+ 2 (value 2) - execute event route;
+ 3 (value 4) - write to pcap files.
+ </para>
+ <para>
+ To enable several activity modes, set the parameter to the sum of
+ correspinding values.
</para>
<para>
<emphasis>
Module: kamailio
Branch: master
Commit: 7fd849033ea6ad0485486bd5aec8130e03c13672
URL: https://github.com/kamailio/kamailio/commit/7fd849033ea6ad0485486bd5aec8130…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2020-07-15T11:30:58+02:00
sipdump: docs about mode flag 3 (write pcap) and notes about it
---
Modified: src/modules/sipdump/doc/sipdump_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/7fd849033ea6ad0485486bd5aec8130…
Patch: https://github.com/kamailio/kamailio/commit/7fd849033ea6ad0485486bd5aec8130…
---
diff --git a/src/modules/sipdump/doc/sipdump_admin.xml b/src/modules/sipdump/doc/sipdump_admin.xml
index 0a603c2803..a02366528f 100644
--- a/src/modules/sipdump/doc/sipdump_admin.xml
+++ b/src/modules/sipdump/doc/sipdump_admin.xml
@@ -96,11 +96,12 @@ modparam("sipdump", "enable", 1)
<title><varname>mode</varname> (int)</title>
<para>
Set the type of activity done by the module, the value can be set
- based on flags: 1 - write to files; 2 - execute event route
+ based on flags: 1 - write to text files; 2 - execute event route;
+ 3 - write to pcap files
</para>
<para>
<emphasis>
- Default value is 1 (write to files).
+ Default value is 1 (write to text files).
</emphasis>
</para>
<example>
@@ -173,7 +174,8 @@ modparam("sipdump", "folder", "/run/kamailio")
<title><varname>fprefix</varname> (str)</title>
<para>
File name prefix. The date is appended to this prefix in the format
- yyyy-mm-dd--hh-mm-ss. The extension of the file is ".data".
+ yyyy-mm-dd--hh-mm-ss. The extension of the text file is ".data",
+ of the meta file is ".meta" and of the pcap file is ".pcap".
</para>
<para>
<emphasis>
@@ -320,6 +322,13 @@ route[TCLEAN] {
}
...
</programlisting>
+ <para>
+ If operational mode is set to write the pcap files, note that packets
+ in the pcap file are generated always with transport UDP, no matter
+ the SIP traffic was over another transport layer like TCP, TLS, SCTP
+ or WSS. The headers of the SIP message (e.g., Via, Route) should provide
+ hints about what the SIP transport layer.
+ </para>
</section>
</chapter>