-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathINSTALL.txt
71 lines (51 loc) · 2.36 KB
/
INSTALL.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
pypy-libtrace INSTALL instructions
------------------------------------
Requirements:
* libtrace 3.0.21 or later
* ldns, which requires an up-to-date version of openssl
* pypy-5.6or pypy3.3-5.5-alpha-20161014
* python setuptools (e.g. using get-pip.py, see
https://pip.pypa.io/en/latest/installing/#installing-with-get-pip-py
For pypy3, see http://c.wensheng.org/2016/07/28/install-pypy3/ )
Installing pypy-libtrace
------------------------
Check that you have the right version of libtrace, pypy, openssl
and ldns (as listed above). For openssl on Ubuntu, you may need
to create a sumbolic link in /user/include, something like this:
openssl -> /home/nevil/openssl-1.0.1j/include/openssl
You should have obtained pypy-libtrace from github
git clone https://github.com/nevil-brownlee/pypy-libtrace
Now
cd pypy-libtrace
make install-pypy2 # or install-pypy3
The above two of commands will build pypy-libtrace and
install it into the place where pypy expects to find extension
modules on your system.
You'll probably need to use sudo for the make install step.
The library comes with a set of test cases. You can run them to
make sure the installation is complete. They are also useful, if
you want to make changes to the library. In that case, they can
be used to make sure your changes did not break anything in the
library.
To run the tests, go to the 'test' subdirectory and run the sript
'run_test' as follows:
export TZ=Pacific/Auckland # Get times right for trace file packets
<pypy-lt-folder>/test$ pypy run_test.py -d pypy-test-cases/ -t
This command runs all 31 test programs and reports the results.
All tests should pass to make sure the library works properly.
Using pypy-libtrace
-------------------
The best source of information on how to use libtrace and the
tools that come with it is the libtrace wiki located at
http://www.wand.net.nz/trac/libtrace/wiki
pypy-libtrace is documented in a set of html pages in the
doc subdirctory of the distribution.
A set of example programs is included in the doc/examples
subdirectory.
You should install these documentation files on a suitable
webserver at your site (or you can see them at
http://www.cs.auckland.ac.nz/~nevil/pypy-libtrace/ )
Nevil Brownlee
U Auckland, Wed, 27 Jan 2017 (NZDT)
Email for queries or comments: [email protected]
--------------------------------------------------------------