Tutorial: Installation

Dependencies

  • Ubuntu/Kali: sudo apt-get install automake libpcap-dev libtool make
  • Arch: sudo pacman -S automake libpcap libtool
  • Gentoo: sudo emerge automake libpcap libtool
  • OpenSUSE: sudo zypper install automake gcc libpcap-devel libtool
  • Red Hat/Fedora: sudo yum/dnf install automake libpcap-devel libtool
  • Mac OS X: brew install autoconf automake libtool (Homebrew package manager)

Compilation

To build Tranalyzer2 and the plugins, run one of the following command:

  • Tranalyzer2 and a default set of plugins: cd "$T2HOME"; ./autogen.sh
  • Tranalyzer2 and all the plugins in $T2HOME: cd "$T2HOME"; ./autogen.sh -a
  • Tranalyzer2 and a custom set of plugins (listed in plugins.build): cd "$T2HOME"; ./autogen.sh -b

where $T2HOME points to the root folder of Tranalyzer, i.e., where the autogen.sh and README.md files are located.

For finer control of which plugins to build, either run ./autogen.sh from every folder you want to build, use the t2conf script or the t2build alias defined in scripts/t2_aliases.

Run t2conf --help or t2build --help for the full list of options accepted by the scripts.

Utilities

The file $T2HOME/scripts/t2_aliases provides a set of aliases and functions which facilitate working with Tranalyzer. To access them, append the following lines to ~/.bashrc or ~/.bash_aliases:


if [ -f "$T2HOME/scripts/t2_aliases" ]; then
    . "$T2HOME/scripts/t2_aliases" # Note the leading '.'
fi

For a full description of the file, refer to scripts/doc/scripts.pdf.

Installation

The -i option of the autogen.sh script installs Tranalyzer2 in /usr/local/bin and the man page in /usr/local/man/man1. Note that root rights are required for the installation.

Documentation

Tranalyzer2 core and every plugin come with their own documentation found in their respective doc/ subfolder. The full documentation of Tranalyzer2 and all the locally available plugins can be built by running make in $T2HOME/doc.

For more convenient access to the documentation, t2_aliases defines the function t2doc which can be used as follows: t2doc pluginName