forked from brnorris03/Orio
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
79 lines (55 loc) · 2.76 KB
/
README
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
71
72
73
74
75
76
77
Date: 2/13/13
Version: 0.2.2
===================================================================================
ORIO -- An Annotation-Based Performance Tuning Tool
Albert Hartono <[email protected]>, <[email protected]>
Boyana Norris <[email protected]>
===================================================================================
INSTALLATION
The Orio installation follows the standard Python Module Distribution
Utilities, or Disutils for short.
For users who want to quickly install Orio to the standard locations
of third-party Python modules (requiring superuser privileges in a
Unix system), the installation is straightforward as shown below.
% tar -xvzf orio.tar.gz
% cd orio
% python setup.py install
On a Unix platform, the above install command will normally put an
orcc script in the /usr/bin location, and also create an orio module
directory in the /usr/lib/python2.X/site-packages location.
To test whether Orio has been properly installed in your system, try
to execute orcc command as given below as an example.
% orcc --help
description: compile shell for Orio
usage: orcc [options] <ifile>
<ifile> input file containing the annotated code
options:
-h, --help display this message
-o <file>, --output=<file> place the output to <file>
-v, --verbose verbosely show details of the results of the running program
In order to install Orio to an alternate location, users need to
supply a base directory for the installation. For instance, the
following command will install an orcc script under
/home/username/bin, and also put an orio module under
/home/username/lib/python/site-packages.
% tar -xvzf orio.tar.gz
% cd orio
% python setup.py install --prefix=/home/username
It is also important to ensure that the installed Orio module location
is included in the PYTHONPATH environment variable. Similarly, users
can optionally include the installed orcc script location in the PATH
shell variable. To do this for the above example, the following two
lines can be added in the .bashrc configuration file (assuming the
user uses Bash shell, of course).
export PYTHONPATH=$PYTHONPATH:/home/username/lib/python/site-packages
export PATH=$PATH:/home/username/bin
After making sure that the orcc executable is in your path, you can
try some of the examples included in the testsuite subdirectory, e.g.:
> cd testsuite/sandbox/axpy/simple
> orcc -v axpy5.c
If Orio reports problems building the code, adjust the compiler settings in
the tuning spec included in the axpy5.c.
==================================================================================
CONTACT INFO
Please send all questions, bugs reports, and comments to:
Boyana Norris <[email protected]>