source: INSTALL @ 6378b14

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

more notes on INSTALL proceess

  • 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
8./configure
9make
10(as root)
11make install
12
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
86DAG (native dag)
87dag:/dev/dag0
88
Note: See TracBrowser for help on using the repository browser.