source: INSTALL @ 670d3de

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

modified README, Changlog, added a brief INSTALL file

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