/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ /* * This file is part of the LibreOffice project. * * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. * * This file incorporates work covered by the following license notice: * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed * with this work for additional information regarding copyright * ownership. The ASF licenses this file to you under the Apache * License, Version 2.0 (the "License"); you may not use this file * except in compliance with the License. You may obtain a copy of * the License at http://www.apache.org/licenses/LICENSE-2.0 . */ #ifdef _WIN32 #if !defined WIN32_LEAN_AND_MEAN # define WIN32_LEAN_AND_MEAN #endif #include #endif #if defined(_WIN32) && defined(_DEBUG) #include "dbghelp.h" #endif #ifdef UNX #include #include #endif #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace { void usageFailure() { std::cerr << ("Usage: cppunittester (--protector " " )* ") << std::endl; std::exit(EXIT_FAILURE); } OUString getArgument(sal_Int32 index) { OUString arg; osl_getCommandArg(index, &arg.pData); return arg; } std::string convertLazy(std::u16string_view s16) { OString s8(OUStringToOString(s16, osl_getThreadTextEncoding())); static_assert(sizeof (sal_Int32) <= sizeof (std::string::size_type), "must be at least the same size"); // ensure following cast is legitimate return std::string( s8.getStr(), static_cast< std::string::size_type >(s8.getLength())); } //Output how long each test took class TimingListener : public CppUnit::TestListener { public: TimingListener() : m_nStartTime(0) { } TimingListener(const TimingListener&) = delete; TimingListener& operator=(const TimingListener&) = delete; void startTest( CppUnit::Test *test) override { std::cout << "[_RUN_____] " << test->getName() << std::endl; m_nStartTime = osl_getGlobalTimer(); } void endTest( CppUnit::Test *test ) override { sal_uInt32 nEndTime = osl_getGlobalTimer(); std::cout << test->getName() << " finished in: " << nEndTime-m_nStartTime << "ms" << std::endl; } private: sal_uInt32 m_nStartTime; }; #ifdef UNX #include // Setup an env variable so that temp file (or other) can // have a useful value to identify the source class EyecatcherListener : public CppUnit::TestListener { public: EyecatcherListener() = default; EyecatcherListener(const EyecatcherListener&) = delete; EyecatcherListener& operator=(const EyecatcherListener&) = delete; void startTest( CppUnit::Test* test) override { std::unique_ptr tn(new char [ test->getName().length() + 2 ]); strcpy(tn.get(), test->getName().c_str()); int len = strlen(tn.get()); for(int i = 0; i < len; i++) { if(!rtl::isAsciiAlphanumeric(static_cast(tn[i]))) { tn[i] = '_'; } } tn[len] = '_'; tn[len + 1] = 0; setenv("LO_TESTNAME", tn.get(), true); } void endTest( CppUnit::Test* /* test */ ) override { } }; #endif class LogFailuresAsTheyHappen : public CppUnit::TestListener { public: virtual void addFailure( const CppUnit::TestFailure &failure ) override { printFailureLocation( failure.sourceLine() ); printFailedTestName( failure ); printFailureMessage( failure ); } private: static void printFailureLocation( const CppUnit::SourceLine &sourceLine ) { if ( !sourceLine.isValid() ) std::cerr << "unknown:0:"; else std::cerr << sourceLine.fileName() << ":" << sourceLine.lineNumber() << ":"; } static void printFailedTestName( const CppUnit::TestFailure &failure ) { std::cerr << failure.failedTestName() << std::endl; } static void printFailureMessage( const CppUnit::TestFailure &failure ) { std::cerr << failure.thrownException()->message().shortDescription() << std::endl; std::cerr << failure.thrownException()->message().details() << std::endl; } }; struct test_name_compare { explicit test_name_compare(const std::string& rName): maName(rName) { } bool operator()(const std::string& rCmp) { size_t nPos = maName.find(rCmp); if (nPos == std::string::npos) return false; size_t nEndPos = nPos + rCmp.size(); return nEndPos == maName.size(); } std::string maName; }; bool addRecursiveTests(const std::vector& test_names, CppUnit::Test* pTest, CppUnit::TestRunner& rRunner) { bool ret(false); for (int i = 0; i < pTest->getChildTestCount(); ++i) { CppUnit::Test* pNewTest = pTest->getChildTestAt(i); ret |= addRecursiveTests(test_names, pNewTest, rRunner); if (std::any_of(test_names.begin(), test_names.end(), test_name_compare(pNewTest->getName()))) { rRunner.addTest(pNewTest); ret = true; } } return ret; } //Allow the whole uniting testing framework to be run inside a "Protector" //which knows about uno exceptions, so it can print the content of the //exception before falling over and dying class CPPUNIT_API ProtectedFixtureFunctor : public CppUnit::Functor { private: const std::string &testlib; const std::string &args; std::vector &protectors; CppUnit::TestResult &result; public: ProtectedFixtureFunctor(const std::string& testlib_, const std::string &args_, std::vector &protectors_, CppUnit::TestResult &result_) : testlib(testlib_) , args(args_) , protectors(protectors_) , result(result_) { } ProtectedFixtureFunctor(const ProtectedFixtureFunctor&) = delete; ProtectedFixtureFunctor& operator=(const ProtectedFixtureFunctor&) = delete; bool run() const { #ifdef DISABLE_DYNLOADING // NOTE: Running cppunit unit tests on iOS was something I did // only very early (several years ago) when starting porting // this stuff to iOS. The complicated mechanisms to do build // such unit test single executables have surely largely // bit-rotted or been semi-intentionally broken since. This // stuff here left for information only. --tml 2014. // For iOS cppunit plugins aren't really "plugins" (shared // libraries), but just static archives. In the real main // program of a cppunit app, which calls the lo_main() that // the SAL_IMPLEMENT_MAIN() below expands to, we specifically // call the initialize methods of the CppUnitTestPlugIns that // we statically link to the app executable. #else // The PlugInManager instance is deliberately leaked, so that the dynamic libraries it loads // are never unloaded (which could make e.g. pointers from other libraries' static data // structures to const data in those libraries, like some static OUString cache pointing at // a const OUStringLiteral, become dangling by the time those static data structures are // destroyed during exit): auto manager = new CppUnit::PlugInManager; try { manager->load(testlib, args); } catch (const CppUnit::DynamicLibraryManagerException &e) { std::cerr << "DynamicLibraryManagerException: \"" << e.what() << "\"\n"; #ifdef _WIN32 const char *pPath = getenv ("PATH"); if (pPath && strlen (pPath) > 256) { std::cerr << "Windows has significant build problems with long PATH variables "; std::cerr << "please check your PATH variable and re-autogen.\n"; } #endif std::cerr << "Path is '" << getenv("PATH") << "'\n"; return false; } #endif for (size_t i = 0; i < protectors.size(); ++i) result.pushProtector(protectors[i]); bool success; { CppUnit::TestResultCollector collector; result.addListener(&collector); LogFailuresAsTheyHappen logger; result.addListener(&logger); TimingListener timer; result.addListener(&timer); #ifdef UNX EyecatcherListener eye; result.addListener(&eye); // set this to track down files created before first test method std::string lib(testlib.substr(testlib.rfind('/')+1)); setenv("LO_TESTNAME", lib.c_str(), true); #endif const char* pVal = getenv("CPPUNIT_TEST_NAME"); CppUnit::TestRunner runner; if (pVal) { std::vector test_names; boost::split(test_names, pVal, boost::is_any_of("\t ")); CppUnit::Test* pTest = CppUnit::TestFactoryRegistry::getRegistry().makeTest(); bool const added(addRecursiveTests(test_names, pTest, runner)); if (!added) { std::cerr << "\nFatal error: CPPUNIT_TEST_NAME contains no valid tests\n"; // coverity[leaked_storage] - `manager` leaked on purpose return false; } } else { runner.addTest(CppUnit::TestFactoryRegistry::getRegistry().makeTest()); } runner.run(result); CppUnit::CompilerOutputter outputter(&collector, CppUnit::stdCErr()); outputter.setNoWrap(); outputter.write(); success = collector.wasSuccessful(); } for (size_t i = 0; i < protectors.size(); ++i) result.popProtector(); return success; } virtual bool operator()() const override { return run(); } }; #ifdef UNX double get_time(timeval* time) { double nTime = static_cast(time->tv_sec); nTime += static_cast(time->tv_usec)/1000000.0; return nTime; } OString generateTestName(const OUString& rPath) { sal_Int32 nPathSep = rPath.lastIndexOf("/"); OUString aTestName = rPath.copy(nPathSep+1); return OUStringToOString(aTestName, RTL_TEXTENCODING_UTF8); } void reportResourceUsage(const OUString& rPath) { OUString aFullPath = rPath + ".resource.log"; rusage resource_usage; getrusage(RUSAGE_SELF, &resource_usage); OString aPath = OUStringToOString(aFullPath, RTL_TEXTENCODING_UTF8); std::ofstream resource_file(aPath.getStr()); resource_file << "Name = " << generateTestName(rPath) << std::endl; double nUserSpace = get_time(&resource_usage.ru_utime); double nKernelSpace = get_time(&resource_usage.ru_stime); resource_file << "UserSpace = " << nUserSpace << std::endl; resource_file << "KernelSpace = " << nKernelSpace << std::endl; } #else void reportResourceUsage([[maybe_unused]] const OUString& /*rPath*/) { } #endif } static bool main2() { bool ok = false; OUString path; #ifdef _WIN32 //Disable Dr-Watson in order to crash simply without popup dialogs under //windows DWORD dwMode = SetErrorMode(SEM_NOGPFAULTERRORBOX); SetErrorMode(SEM_NOGPFAULTERRORBOX|dwMode); #ifdef _DEBUG // These functions are present only in the debugging runtime _CrtSetReportMode(_CRT_WARN, _CRTDBG_MODE_DEBUG|_CRTDBG_MODE_FILE); _CrtSetReportFile(_CRT_WARN, _CRTDBG_FILE_STDERR); _CrtSetReportMode(_CRT_ERROR, _CRTDBG_MODE_DEBUG|_CRTDBG_MODE_FILE); _CrtSetReportFile(_CRT_ERROR, _CRTDBG_FILE_STDERR); _CrtSetReportMode(_CRT_ASSERT, _CRTDBG_MODE_DEBUG|_CRTDBG_MODE_FILE); _CrtSetReportFile(_CRT_ASSERT, _CRTDBG_FILE_STDERR); #endif #endif std::vector protectors; CppUnit::TestResult result; std::string args; std::string testlib; sal_uInt32 index = 0; while (index < osl_getCommandArgCount()) { OUString arg = getArgument(index); if (arg.startsWith("-env:CPPUNITTESTTARGET=", &path)) { ++index; continue; } if (arg.startsWith("-env:")) { ++index; continue; // ignore it here - will be read later } if ( arg != "--protector" ) { if (testlib.empty()) { testlib = OUStringToOString(arg, osl_getThreadTextEncoding()).getStr(); args += testlib; } else { args += ' '; args += OUStringToOString(arg, osl_getThreadTextEncoding()).getStr(); } ++index; continue; } if (osl_getCommandArgCount() - index < 3) { usageFailure(); } OUString lib(getArgument(index + 1)); OUString sym(getArgument(index + 2)); #ifndef DISABLE_DYNLOADING osl::Module mod(lib, SAL_LOADMODULE_GLOBAL); oslGenericFunction fn = mod.getFunctionSymbol(sym); mod.release(); #else oslGenericFunction fn = 0; if (sym == "unoexceptionprotector") fn = (oslGenericFunction) unoexceptionprotector; else if (sym == "unobootstrapprotector") fn = (oslGenericFunction) unobootstrapprotector; else if (sym == "vclbootstrapprotector") fn = (oslGenericFunction) vclbootstrapprotector; else { std::cerr << "Only unoexceptionprotector or unobootstrapprotector protectors allowed" << std::endl; std::exit(EXIT_FAILURE); } #endif CppUnit::Protector *protector = fn == nullptr ? nullptr : (*reinterpret_cast< cppunittester::ProtectorFactory * >(fn))(); if (protector == nullptr) { std::cerr << "Failure instantiating protector \"" << convertLazy(lib) << "\", \"" << convertLazy(sym) << '"' << std::endl; std::exit(EXIT_FAILURE); } protectors.push_back(protector); index+=3; } ProtectedFixtureFunctor tests(testlib, args, protectors, result); ok = tests.run(); reportResourceUsage(path); return ok; } #if defined(_WIN32) && defined(_DEBUG) //Prints stack trace based on exception context record void printStack( CONTEXT* ctx ) { constexpr int MaxNameLen = 256; BOOL result; HANDLE process; HANDLE thread; HMODULE hModule; STACKFRAME64 stack; ULONG frame; DWORD64 displacement; DWORD disp; char buffer[sizeof(SYMBOL_INFO) + MAX_SYM_NAME * sizeof(TCHAR)]; char module[MaxNameLen]; PSYMBOL_INFO pSymbol = (PSYMBOL_INFO)buffer; memset( &stack, 0, sizeof( STACKFRAME64 ) ); process = GetCurrentProcess(); thread = GetCurrentThread(); displacement = 0; #if !defined(_M_AMD64) stack.AddrPC.Offset = (*ctx).Eip; stack.AddrPC.Mode = AddrModeFlat; stack.AddrStack.Offset = (*ctx).Esp; stack.AddrStack.Mode = AddrModeFlat; stack.AddrFrame.Offset = (*ctx).Ebp; stack.AddrFrame.Mode = AddrModeFlat; #endif SymInitialize( process, NULL, TRUE ); //load symbols std::unique_ptr line(new IMAGEHLP_LINE64); line->SizeOfStruct = sizeof(IMAGEHLP_LINE64); for( frame = 0; ; frame++ ) { //get next call from stack result = StackWalk64 ( #if defined(_M_AMD64) IMAGE_FILE_MACHINE_AMD64, #else IMAGE_FILE_MACHINE_I386, #endif process, thread, &stack, ctx, NULL, SymFunctionTableAccess64, SymGetModuleBase64, NULL ); if( !result ) break; //get symbol name for address pSymbol->SizeOfStruct = sizeof(SYMBOL_INFO); pSymbol->MaxNameLen = MAX_SYM_NAME; SymFromAddr(process, ( ULONG64 )stack.AddrPC.Offset, &displacement, pSymbol); //try to get line if (SymGetLineFromAddr64(process, stack.AddrPC.Offset, &disp, line.get())) { printf("\tat %s in %s: line: %lu: address: 0x%0X\n", pSymbol->Name, line->FileName, line->LineNumber, pSymbol->Address); } else { //failed to get line printf("\tat %s, address 0x%0X.\n", pSymbol->Name, pSymbol->Address); hModule = NULL; lstrcpyA(module,""); GetModuleHandleEx(GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS | GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT, (LPCTSTR)(stack.AddrPC.Offset), &hModule); //at least print module name if(hModule != NULL)GetModuleFileNameA(hModule,module,MaxNameLen); printf ("in %s\n",module); } } } // The exception filter function: LONG WINAPI ExpFilter(EXCEPTION_POINTERS* ex) { // we only want this active on the Jenkins tinderboxes printf("*** Exception 0x%x occurred ***\n\n",ex->ExceptionRecord->ExceptionCode); printStack(ex->ContextRecord); return EXCEPTION_EXECUTE_HANDLER; } SAL_IMPLEMENT_MAIN() { bool ok = false; // This magic kind of Windows-specific exception handling has to be in its own function // because it cannot be in a function that has objects with destructors. __try { ok = main2(); } __except (ExpFilter(GetExceptionInformation())) { } return ok ? EXIT_SUCCESS : EXIT_FAILURE; } #else SAL_IMPLEMENT_MAIN() { bool ok = false; try { ok = main2(); } catch (const std::exception& e) { SAL_WARN("vcl.app", "Fatal exception: " << e.what()); } return ok ? EXIT_SUCCESS : EXIT_FAILURE; } #endif /* vim:set shiftwidth=4 softtabstop=4 expandtab: */