source: INSTALL @ d18312c

4.0.1-hotfixescachetimestampsdevelopdpdk-ndagetsilivegetfragoffhelplibtrace4ndag_formatpfringrc-4.0.1rc-4.0.2rc-4.0.3rc-4.0.4ringdecrementfixringperformanceringtimestampfixes
Last change on this file since d18312c was d18312c, checked in by Daniel Lawson <dlawson@…>, 15 years ago

fixes in libpacketdump's Makefile

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