source: INSTALL @ d9faaa5

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

note about gcc version

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