| commit | 29d04c1f6d91ab8336f419bd854e5badcccbc706 | [log] [tgz] |
|---|---|---|
| author | Ian Rogers <irogers@google.com> | Tue Jun 24 19:42:37 2014 +0000 |
| committer | Android Git Automerger <android-git-automerger@android.com> | Tue Jun 24 19:42:37 2014 +0000 |
| tree | 5357bdd347f8159b5ed4b72f2cd193ae73862614 | |
| parent | 1be2788a4f629f1b15ff762a6e86ee8d58bfee0c [diff] | |
| parent | 5557d304346026d9678877f3202fe826c8a14fec [diff] |
am 5557d304: Enable host multilib for ART testing. * commit '5557d304346026d9678877f3202fe826c8a14fec': Enable host multilib for ART testing.
Contents:
To build VIXL the following software is required:
A 64-bit host machine is required, implementing an LP64 data model. VIXL has only been tested using GCC on Ubuntu systems.
To run the linter stage of the tests, the following software is also required:
Refer to the ‘Usage’ section for details.
VIXL is made of three components.
The VIXL git repository can be found on GitHub. Changes from previous versions of VIXL can be found in the Changelog.
VIXL was developed to target JavaScript engines so a number of features from A64 were deemed unnecessary:
The VIXL simulator supports only those instructions that the VIXL assembler can generate. The doc directory contains a list of supported instructions.
The VIXL simulator was developed to run on 64-bit amd64 platforms. Whilst it builds and mostly works for 32-bit x86 platforms, there are a number of floating-point operations which do not work correctly, and a number of tests fail as a result.
The helper script tools/presubmit.py will build and run every test that is provided with VIXL, in both release and debug mode. It is a useful script for verifying that all of VIXL's dependencies are in place and that VIXL is working as it should.
By default, the tools/presubmit.py script runs a linter to check that the source code conforms with the code style guide, and to detect several common errors that the compiler may not warn about. This is most useful for VIXL developers. The linter has the following dependencies:
git clone.cpplint.py, as provided by Google, must be available (and executable) on the PATH. Only revision 104 has been tested with VIXL.It is possible to tell tools/presubmit.py to skip the linter stage by passing --nolint. This removes the dependency on cpplint.py and Git. The --nolint option is implied if the VIXL project is a snapshot (with no .git directory).
There are two very basic benchmarks provided with VIXL:
To build one benchmark: scons target=bench_xxx, then run it as ./bench_xxx_sim <number of iterations>. The benchmarks do not report a figure; they should be timed using the time command.
A short introduction to using VIXL can be found here. Example source code is provided in the examples directory. Build this using scons target=examples from the root directory.