source: INSTALL @ b296c02

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

poink

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