// Copyright 2014, VIXL authors // All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // // * Redistributions of source code must retain the above copyright notice, // this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright notice, // this list of conditions and the following disclaimer in the documentation // and/or other materials provided with the distribution. // * Neither the name of ARM Limited nor the names of its contributors may be // used to endorse or promote products derived from this software without // specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS CONTRIBUTORS "AS IS" AND // ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED // WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE // DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE // FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL // DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR // SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER // CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, // OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #include <cstdlib> #include <cstring> #include <cstdio> #include "test-runner.h" // Initialize the list as empty. vixl::Test* vixl::Test::first_ = NULL; vixl::Test* vixl::Test::last_ = NULL; // No debugger to start with. bool vixl::Test::debug_ = false; // No tracing to start with. bool vixl::Test::trace_sim_ = false; bool vixl::Test::trace_reg_ = false; bool vixl::Test::trace_write_ = false; bool vixl::Test::trace_branch_ = false; // Do not disassemble by default. bool vixl::Test::disassemble_ = false; // No colour highlight by default. bool vixl::Test::coloured_trace_ = false; // No instruction statistics by default. bool vixl::Test::instruction_stats_ = false; // Don't generate traces by default. bool vixl::Test::generate_test_trace_ = false; // Instantiate a Test and append it to the linked list. vixl::Test::Test(const char* name, TestFunction* callback) : name_(name), callback_(callback), next_(NULL) { // Append this test to the linked list. if (first_ == NULL) { VIXL_ASSERT(last_ == NULL); first_ = this; } else { last_->next_ = this; } last_ = this; } // Look for 'search' in the arguments. static bool IsInArgs(const char* search, int argc, char* argv[]) { for (int i = 1; i < argc; i++) { if (strcmp(search, argv[i]) == 0) { return true; } } return false; } static bool IsOption(const char* arg) { // Any argument like "--option" is an option. return ((arg[0] == '-') && (arg[1] == '-')); } static void NormalizeOption(char* arg) { // Squash all '_' characters in options. This allows --trace_sim and // --trace-sim to be handled in the same way, for example. VIXL_ASSERT(IsOption(arg)); for (char* c = arg; *c != '\0'; c++) { if (*c == '_') { *c = '-'; } } } static void PrintHelpMessage() { printf( "Usage: ./test [options] [test names]\n" "Run all tests specified on the command line.\n" "--help Print this help message.\n" "--list List all available tests.\n" "--run_all Run all available tests.\n" "--debugger Run in the debugger.\n" "--trace_all " "Enable all trace options, plus --coloured_trace.\n" "--trace_sim Generate a trace of simulated instructions, as\n" " well as disassembly from the DISASM tests.\n" "--trace_reg Generate a trace of simulated registers.\n" "--trace_write Generate a trace of memory writes.\n" "--trace_branch Generate a trace of branches taken.\n" "--disassemble Disassemble and print generated instructions.\n" "--coloured_trace Generate coloured trace.\n" "--instruction_stats Log instruction statistics to vixl_stats.csv.\n" "--generate_test_trace " "Print result traces for SIM_* and TRACE_* tests.\n"); } int main(int argc, char* argv[]) { // Parse the arguments. Option flags must appear first, followed by an // optional list of tests to run. int test_specifiers = 0; for (int i = 1; i < argc; i++) { if (IsOption(argv[i])) { NormalizeOption(argv[i]); } else { // Anything that isn't an option is a test specifier. test_specifiers++; } } // Options controlling test conditions and debug output. if (IsInArgs("--trace-all", argc, argv)) { vixl::Test::set_trace_reg(true); vixl::Test::set_trace_write(true); vixl::Test::set_trace_branch(true); vixl::Test::set_trace_sim(true); vixl::Test::set_coloured_trace(true); } if (IsInArgs("--coloured-trace", argc, argv)) { vixl::Test::set_coloured_trace(true); } if (IsInArgs("--debugger", argc, argv)) { vixl::Test::set_debug(true); } if (IsInArgs("--trace-write", argc, argv)) { vixl::Test::set_trace_write(true); } if (IsInArgs("--trace-branch", argc, argv)) { vixl::Test::set_trace_branch(true); } if (IsInArgs("--trace-reg", argc, argv)) { vixl::Test::set_trace_reg(true); } if (IsInArgs("--trace-sim", argc, argv)) { vixl::Test::set_trace_sim(true); } if (IsInArgs("--disassemble", argc, argv)) { vixl::Test::set_disassemble(true); } if (IsInArgs("--instruction-stats", argc, argv)) { vixl::Test::set_instruction_stats(true); } if (IsInArgs("--generate-test-trace", argc, argv)) { vixl::Test::set_generate_test_trace(true); } // Basic (mutually-exclusive) operations. if (IsInArgs("--help", argc, argv)) { PrintHelpMessage(); } else if (IsInArgs("--list", argc, argv)) { // List all registered tests, then exit. for (vixl::Test* c = vixl::Test::first(); c != NULL; c = c->next()) { printf("%s\n", c->name()); } } else if (IsInArgs("--run-all", argc, argv)) { // Run all registered tests. for (vixl::Test* c = vixl::Test::first(); c != NULL; c = c->next()) { printf("Running %s\n", c->name()); c->callback()(); } } else { // Run the specified tests. if (test_specifiers == 0) { printf("No tests specified.\n"); PrintHelpMessage(); return EXIT_FAILURE; } for (int i = 1; i < argc; i++) { if (!IsOption(argv[i])) { vixl::Test* c; for (c = vixl::Test::first(); c != NULL; c = c->next()) { if (strcmp(c->name(), argv[i]) == 0) { c->callback()(); break; } } // Fail if we have not found a matching test to run. if (c == NULL) { printf("Test '%s' does not exist. Aborting...\n", argv[i]); abort(); } } } } return EXIT_SUCCESS; }