| 1 | Requirements: |
|---|
| 2 | * >=automake-1.9 |
|---|
| 3 | * >=libpcap-0.8 |
|---|
| 4 | * flex and bison |
|---|
| 5 | * libwandio 4.0.0 (http://research.wand.net.nz/software/libwandio.php) |
|---|
| 6 | |
|---|
| 7 | Optional: |
|---|
| 8 | * DAG libraries (both 2.4 and 2.5 versions are supported) |
|---|
| 9 | * libcrypto (required for CryptoPAN anonymisation in traceanon) |
|---|
| 10 | * libncurses (required for tracetop) |
|---|
| 11 | * libwandder (required for ETSI LI decoding -- |
|---|
| 12 | https://github.com/wanduow/libwandder) |
|---|
| 13 | |
|---|
| 14 | ---------------------------------- |
|---|
| 15 | |
|---|
| 16 | Installing libtrace: |
|---|
| 17 | |
|---|
| 18 | ./bootstrap.sh (only if you've cloned the source from GitHub) |
|---|
| 19 | ./configure |
|---|
| 20 | make |
|---|
| 21 | make install |
|---|
| 22 | |
|---|
| 23 | The above series of commands will install libtrace into /usr/local/lib. If |
|---|
| 24 | you wish to install to a non-standard location, append the |
|---|
| 25 | --prefix=DIR option to the ./configure command. ./configure also takes |
|---|
| 26 | a number of other options - run ./configure --help to view a comprehensive |
|---|
| 27 | list. |
|---|
| 28 | |
|---|
| 29 | You may need to add the library location (e.g. /usr/local/lib) to your |
|---|
| 30 | /etc/ld.so.conf and run 'ldconfig' as root. |
|---|
| 31 | |
|---|
| 32 | ---------------------------------- |
|---|
| 33 | |
|---|
| 34 | Installation FAQ: |
|---|
| 35 | |
|---|
| 36 | Q. I've installed libpcap but I'm still getting the following error: |
|---|
| 37 | "libpcap0.8 or greater is required to compile libtrace. If you have installed |
|---|
| 38 | it in a non-standard location please use LDFLAGS to specify the location of |
|---|
| 39 | the library"? |
|---|
| 40 | |
|---|
| 41 | A. You need to install the development version of the pcap library. |
|---|
| 42 | For example, Ubuntu/Debian users will need to install the libpcap0.8-dev |
|---|
| 43 | package in addition to the libpcap0.8 package. |
|---|
| 44 | |
|---|
| 45 | |
|---|
| 46 | Q. What operating systems do you support? |
|---|
| 47 | |
|---|
| 48 | A. Linux, FreeBSD, Mac OS X and OpenBSD. Windows is not supported. |
|---|
| 49 | |
|---|
| 50 | ---------------------------------- |
|---|
| 51 | Using libtrace: |
|---|
| 52 | |
|---|
| 53 | The best source of information on how to use libtrace and the tools that come |
|---|
| 54 | with it is the libtrace wiki: https://github.com/wanduow/libtrace/wiki |
|---|
| 55 | |
|---|
| 56 | |
|---|
