Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Octocat-spinner-32-eaf2f5

Cannot retrieve contributors at this time

file 122 lines (83 sloc) 4.183 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121
[******************************************************************************]
[**********] [***********]
[**********] Netzob: inferring communication protocols [***********]
[**********] [***********]
[******************************************************************************]


[******************************************************************************]
[***********************] 1. Presentation [*************************]
[******************************************************************************]

Netzob simplifies the work for security auditors by providing a
complete framework for the reverse engineering of communication
protocols.

It handles different types of protocols: text protocols (like HTTP and
IRC), fixed fields protocols (like IP and TCP) and variable fields
protocols (like ASN.1 based formats). Netzob is therefore suitable
for reversing network protocols, structured files and system and
process flows (IPC and communication with drivers). Netzob is provided
with modules dedicated to capture data in multiple contexts (network,
file, process and kernel data acquisition).


[******************************************************************************]
[***********************] 2. Installation [*************************]
[******************************************************************************]

Netzob currently supports Linux x86 and x64 platforms. A Windows
version is expected soon.

Dependencies:

* python
* python-ptrace
* python-matplotlib
* python-pcapy
* python-bitarray
* python-lxml
* python-dev
* libjs-sphinxdoc
* python-sphinx
* python-setuptools
* graphviz

Recommends:

* python-babel (used for translation)

Linux-specific dependencies:

* strace
* lsof

Or, on Debian-like operating systems:

$ sudo apt-get install python python-ptrace python-matplotlib strace lsof \
  python-pcapy python-bitarray python-dev python-lxml libjs-sphinxdoc \
  python-sphinx python-setuptools graphviz python-babel

And then,

$ python setup.py build


[******************************************************************************]
[***********************] 3. Usage [*************************]
[******************************************************************************]

Just run the following command to launch the graphical interface

$ ./netzob


[******************************************************************************]
[***********************] 4. Documentation [*************************]
[******************************************************************************]

Documentation generation:

The folder "doc/documentation" contains the documentation of Netzob in sphynx
format (.rst). Therefore, if you want to have updated HTMLs in the
"/doc/documentation/build/" directory based on the sources of the documentation
which is located in "/doc/documentation/source/" you'll have to execute the
following command:

$ sphinx-build -b html doc/documentation/source/ doc/documentation/build/


[******************************************************************************]
[***********************] 5. Miscellaneous [*************************]
[******************************************************************************]

** Requirements for Network and PCAP input **

Configuration:

$ sudo setcap cap_net_raw=ep /usr/bin/python2.XX

** Requirements for IPC input on Ubuntu **

$ sudo bash -c "echo 0 > /proc/sys/kernel/yama/ptrace_scope"


[******************************************************************************]
[***********************] 6. Contact [*************************]
[******************************************************************************]

* Website: http://www.netzob.org
* Email: contact@netzob.org
* Mailing lists: https://lists.netzob.org/wws/
* Developer's room: https://dev.netzob.org
* IRC: #netzob on Freenode

Authors:
* Georges Bossert
* Frédéric Guihéry

Sponsors:
* AMOSSYS: http://www.amossys.fr
* Supélec: http://www.rennes.supelec.fr/ren/rd/cidre/
Something went wrong with that request. Please try again.