{ "info": { "author": "Walter Doekes, OSSO B.V.", "author_email": "wjdoekes+sipzamine@osso.nl", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: System Administrators", "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 2.7", "Topic :: Communications :: Telephony", "Topic :: System :: Networking :: Monitoring" ], "description": "sipzamine (previously sipcaparseye)\n===================================\n\nCommand line SIP dialog matching and searching through offline PCAPs.\n\n|pypi_version|\n\n\n\nInstalling\n----------\n\n.. code-block:: console\n\n $ sudo apt-get install python-libpcap # or yum install..\n $ sudo pip install sipzamine\n\n\n\nExample\n-------\n\nA basic example, finding all dialogs that last shorter than 1.5 seconds:\n\n.. code-block:: console\n\n $ sipzamine -m ^BYE -H ^BYE --maxdur 1.5 --pcap 'host 22.22.22.22' stored.pcap\n [ 179978155f707e3622c0886752336210@22.22.22.22 ]\n 2011-11-23 22:27:20.746782 22.22.22.22:5060 > 123.123.123.123:5060 102 INVITE\n 2011-11-23 22:27:20.747508 123.123.123.123:5060 > 22.22.22.22:5060 102 INVITE(100)\n 2011-11-23 22:27:20.783424 123.123.123.123:5060 > 22.22.22.22:5060 102 INVITE(200)\n 2011-11-23 22:27:20.783956 22.22.22.22:5060 > 123.123.123.123:5060 102 ACK\n 2011-11-23 22:27:21.665581 22.22.22.22:5060 > 123.123.123.123:5060 103 BYE <--\n 2011-11-23 22:27:21.665721 123.123.123.123:5060 > 22.22.22.22:5060 103 BYE(200)\n\n\n\nCommand options\n---------------\n\nNormally you use ``-m`` to match a dialog by regular expression. And ``-p``\nto filter by IP.\n\nTo highlight a particular text string in the concise output, use ``-H``.\n\nBasic matching options:\n\n.. code-block::\n\n --pcap filter, -p filter\n pcap filter expression\n --pmatch regex, -m regex\n any packet in dialog must match regex (can be used\n multiple times), e.g. ^INVITE to match calls\n --amatch regex, -M regex\n all packets in dialog must match regex (can be used\n multiple times), e.g. ^(SIP/2.0|INVITE|BYE) to match\n calls without an ACK\n\nOutput options:\n\n.. code-block::\n\n --contents\n show complete packet contents\n --dateskew seconds\n offset added to all dates, can be negative (use when\n pcap clock was off)\n --highlight regex, -H regex\n highlight first matchgroup in packets (multiple\n highlights are identified by letters a..z)\n\nSpecial dialog/packet matching options:\n\n.. code-block::\n\n --mindate date\n packets must be younger than specified date\n --maxdate date\n packets must be older than specified date\n --mindur seconds\n dialogs/transactions must be shorter than duration\n --maxdur seconds\n dialogs/transactions must be longer than duration\n --retransmits count\n at least count retransmits must be involved\n\n\n\nTODO\n----\n\n- Add tests: begin with a smallish pcap.\n- Add the ability to write pcaps from the filter. Combine capability\n with sipscrub?\n- Compare this to sipgrep (and other tools?). And homer?\n\n\n\nQ & A\n-----\n\nHow do I get ``pcap`` files?\n\n You're encouraged to always write SIP pcaps on your VoIP machine.\n tcpdump_ allows you easy rotation of pcaps so you won't run out of disk space.\n You can use the tcpdump247_ init script if you like.\n\n\n.. _tcpdump: http://www.tcpdump.org/\n.. _tcpdump247: https://github.com/ossobv/vcutil/blob/master/tcpdump247\n\n.. |pypi_version| image:: https://img.shields.io/pypi/v/sipzamine.svg\n :target: https://pypi.python.org/pypi/sipzamine", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ossobv/sipzamine", "keywords": "", "license": "GPLv3+", "maintainer": "", "maintainer_email": "", "name": "sipzamine", "package_url": "https://pypi.org/project/sipzamine/", "platform": "linux", "project_url": "https://pypi.org/project/sipzamine/", "project_urls": { "Homepage": "https://github.com/ossobv/sipzamine" }, "release_url": "https://pypi.org/project/sipzamine/0.4/", "requires_dist": null, "requires_python": "", "summary": "SIP dialog examine utility (formerly sipcaparseye)", "version": "0.4" }, "last_serial": 4712355, "releases": { "0.1.2": [ { "comment_text": "", "digests": { "md5": "f0cba38fe56eab563303ddecb2b28212", "sha256": "de784d880653818b4169dfeb5c0fbb7b843f525cc786088933be128c31c9c772" }, "downloads": -1, "filename": "sipzamine-0.1.2.tar.gz", "has_sig": false, "md5_digest": "f0cba38fe56eab563303ddecb2b28212", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 42277, "upload_time": "2015-04-22T12:39:54", "url": "https://files.pythonhosted.org/packages/98/4a/ae670f563050520552511da839ff2fc8d1a78de86a77780b513613299564/sipzamine-0.1.2.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "7a453e280366231b855fd58310f0e876", "sha256": "43b842cda51bf8f23d995717916c1e497fa6e73853a5c942e0b51f4aefe18bc6" }, "downloads": -1, "filename": "sipzamine-0.3.tar.gz", "has_sig": false, "md5_digest": "7a453e280366231b855fd58310f0e876", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 44222, "upload_time": "2018-10-02T23:07:30", "url": "https://files.pythonhosted.org/packages/f4/9d/969f56ee3138d16f958521e67ed1b64c67a24e234471cebe3b40504ebc20/sipzamine-0.3.tar.gz" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "bf2bcd32654378df7ac14dffb5e997fb", "sha256": "309350fa5534a6dcd0327cba169e85e3591d603f28a67daadf73ebf9f314ed6f" }, "downloads": -1, "filename": "sipzamine-0.4.tar.gz", "has_sig": false, "md5_digest": "bf2bcd32654378df7ac14dffb5e997fb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45435, "upload_time": "2019-01-18T14:01:56", "url": "https://files.pythonhosted.org/packages/66/0a/bb7a2e3d543044cb8a15237912c8c708ca39facfa44ad3710b48ac6a1be4/sipzamine-0.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "bf2bcd32654378df7ac14dffb5e997fb", "sha256": "309350fa5534a6dcd0327cba169e85e3591d603f28a67daadf73ebf9f314ed6f" }, "downloads": -1, "filename": "sipzamine-0.4.tar.gz", "has_sig": false, "md5_digest": "bf2bcd32654378df7ac14dffb5e997fb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 45435, "upload_time": "2019-01-18T14:01:56", "url": "https://files.pythonhosted.org/packages/66/0a/bb7a2e3d543044cb8a15237912c8c708ca39facfa44ad3710b48ac6a1be4/sipzamine-0.4.tar.gz" } ] }