From 270e3b786acdc1ba89d33324cbd0914181099939 Mon Sep 17 00:00:00 2001 From: Kaian Date: Mon, 2 Mar 2015 18:26:30 +0100 Subject: [PATCH] Prepare doc files for 0.3.0 --- ChangeLog | 25 +++++++++++++++++++++++++ configure.ac | 2 +- doc/sngrep.8 | 48 +++++++++++++++++++++++++++++++++++++----------- 3 files changed, 63 insertions(+), 12 deletions(-) diff --git a/ChangeLog b/ChangeLog index 38c0a92..be894df 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,28 @@ +2015-03-02 Ivan Alonso + * sngrep 0.3.0 released + + * Added command line option -c to only display calls + * Added command line option -l to change capture limit + * Added command line match expression for packet payload + * Converted all filters to regular expressions (POSIX or PCRE) + * Added optional PCRE support (Perl Compatible Regular Expressions) + * Added optional UTF-8 / Unicode compatible terminals support + * Added current displayed and total dialogs counters in Call list + * Added an option to save displayed dialogs (after filtering) + * Added an option to save current columns layout + * Added new attributes: + - sipfromuser: User in From: Header + - siptouser: User in To: header + - convdur: Total conversation duration (from 200 to BYE) + - totaldur: Total call duration (from first to last message) + * Interface will now be displayed while pcaps are loading + * Reworked Interface refresh process + * Reworked Filtering process + * Fixed general performance issues + * Disable OpenSSL support by default + * Removed command line option to read pcap without flags + * Added long versions of command line flags + 2015-02-09 Ivan Alonso * sngrep 0.2.2 released diff --git a/configure.ac b/configure.ac index ee96299..855dc53 100644 --- a/configure.ac +++ b/configure.ac @@ -1,5 +1,5 @@ AC_PREREQ([2.59]) -AC_INIT([sngrep], [0.2.2], [kaian@irontec.com], [sngrep], [http://www.irontec.com/]) +AC_INIT([sngrep], [0.3.0], [kaian@irontec.com], [sngrep], [http://www.irontec.com/]) AM_INIT_AUTOMAKE([1.9]) m4_ifdef([AM_SILENT_RULES], [AM_SILENT_RULES([yes])]) AC_CONFIG_HEADERS([src/config.h]) diff --git a/doc/sngrep.8 b/doc/sngrep.8 index 2840408..df03330 100644 --- a/doc/sngrep.8 +++ b/doc/sngrep.8 @@ -3,7 +3,7 @@ .\" Copyright (c) 2013-2015 Ivan Alonso .\" Copyright (c) 2013-2015 Irontec S.L. -.TH SNGREP 8 "January 2015" "sngrep 0.2.0" +.TH SNGREP 8 "March 2015" "sngrep 0.3.0" .SH NAME @@ -11,16 +11,18 @@ sngrep \- SIP Messages flow viewer .SH SYNOPSIS -.B sngrep [ -IO +.B sngrep [-hVciv] [ -IO .I pcap_dump .B ] [ -d .I dev -.B ] [ -k +.B ] [ -l +.I limit +.B ] [ -k .I keyfile .B ] [ +.I +.B ] [ .I -| -.I .B ] .SH DESCRIPTION @@ -40,9 +42,21 @@ does. Display help and usage information. .TP -.I \-v +.I \-V Display version information. +.TP +.I \-c +Only capture dialogs starting with an INVITE request. + +.TP +.I \-i +Make match expression case insensitive. + +.TP +.I \-i +Invert match expression. + .TP .I \-I pcap_dump Read packets from pcap file instead of network devices. This option can be used @@ -62,9 +76,14 @@ Use this capture device instead of default (\fIany\fP). Use private keyfile to decrypt TLS packets. .TP -.I pcap_dump -If sngrep only argument is a pcap file, read packets from it. This is a -shortcut for \-I. +.I -l limit +Change default capture limit (10000 dialogs) + +.TP +.I match expression +Match given expression in Messages' payload. If one request message matches the +given expression, the following messages within the same dialog will be also +captured. .TP .I bpf filter @@ -97,7 +116,14 @@ multiple messages will display the Message Diff Window. .SH " Call Raw Window" .PP This window will display the selected dialog messages in plain text. It was -designed to allow copying the messages payload easily. +designed to allow copying the messages payload easily. You can also save the +displayed information to a text file from this screen. + +.SH " Column selection Window" +.PP +Columns displayed in Call List can be updated in this window. You can add or +remove columns or change their order in the list. Additionaly, you can save +column state to be use in next sngrep execution. .SH " Message Diff Window" .PP @@ -132,6 +158,6 @@ author directly by email. .SH AUTHOR -Written by Ivan Alonso . +Written by Ivan Alonso [a.k.a. Kaian] .