source: INSTALL @ ae63c90

4.0.1-hotfixescachetimestampsdevelopdpdk-ndagetsilivegetfragoffhelplibtrace4ndag_formatpfringrc-4.0.1rc-4.0.2rc-4.0.3rc-4.0.4ringdecrementfixringperformanceringtimestampfixes
Last change on this file since ae63c90 was ae63c90, checked in by Brendon Jones <brendonj@…>, 16 years ago

Added notes on needing libpcap and libz dev libraries.

Added mention of editing /etc/ld.so.conf if needed.

  • Property mode set to 100644
File size: 1.9 KB
Line 
1Installing libtrace:
2
3
4----------------------------------
5To make and install libtrace:
6
7libtrace requires the dev versions of libpcap and libz to compile
8(on Debian Woody these are libpcap-dev and zlib1g-dev)
9
10tar zxvf libtrace-x.y.z.tar.gz
11cd libtrace-x.y.z
12./configure
13make
14(as root)
15make install
16
17
18
19You may need to add the line '/usr/local/lib' to your /etc/ld.so.conf and
20run 'ldconfig' as root.
21
22----------------------------------
23To build the docs:
24
25cd libtrace-x.y.z
26doxygen
27
28
29This will build the docs into libtrace-x.y.z/docs/{html,man}
30There is currently no install candidate for these - sorry about that.
31
32
33----------------------------------
34Using libtrace:
35
36There are a number of example programs which should cover the basics of what you need within libtrace-x.y.z/examples/.
37
38
39
40----------------------------------
41Large trace files:
42
43Note that if you wish to use libtrace to read in large ( > 2/4 GB) files, and
44you wish to use gz-compressed traces or pcap traces, you will need to link
45against a version of libz or libpcap that supports large files.
46
47The versions of libz and libpcap that ship with Debian Woody don't support
48large file offsets.
49
50
51To get around this, you have a number of options:
52
53* Don't use compressed files.
54* Use stdin as the target of the input uri, and use cat or zcat to pipe the
55  file into stdin, eg:
56  zcat largetrace.erf.gz | program -i erf:-
57* Use process substitution in place of a filename, eg:
58  program -i erf:<(zcat largetrace.erf.gz)
59
60
61----------------------------------
62Currently support input URIs:
63
64ERF (dag card tracefile):
65erf:/path/to/file
66erf:/path/to/file.gz
67erf:/path/to/socket
68erf:-
69
70PCAP (from libpcap)
71pcap:/path/to/file
72pcap:-
73
74PCAP Interface (from libpcap)
75pcapint:eth0
76pcapint:ppp0
77
78WAG tracefile
79wag:/path/to/file
80wag:/path/to/file.gz
81wag:/path/to/socket
82wag:-
83
84WAG card
85wagint:/dev/wag0
86
87Real Time Client interface at Waikato University
88rtclient:hostname
89rtclient:hostname:port
90
91DAG (native dag)
92dag:/dev/dag0
93
Note: See TracBrowser for help on using the repository browser.