source: INSTALL @ 22d466c

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

modified install

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