| // Copyright 2018 The Fuchsia Authors. All rights reserved. | |
| // Use of this source code is governed by a BSD-style license that can be | |
| // found in the LICENSE file. | |
| #ifndef SRC_PERFORMANCE_TRACE_TESTS_RUN_TEST_H_ | |
| #define SRC_PERFORMANCE_TRACE_TESTS_RUN_TEST_H_ | |
| #include <lib/syslog/cpp/log_settings.h> | |
| #include <lib/zx/job.h> | |
| #include <lib/zx/process.h> | |
| #include <lib/zx/time.h> | |
| #include <string> | |
| #include <vector> | |
| namespace tracing::test { | |
| // Our component's tmp directory. | |
| constexpr char kTestTmpPath[] = "/tmp"; | |
| // Path to use for package-relative paths. | |
| constexpr char kTestPackagePath[] = "/pkg"; | |
| // Path to our package for use in spawned processes. | |
| // Our component's /pkg directory is bound to this path in the spawned process. | |
| // This is useful when wanting the trace program to be able to read our tspec files. | |
| constexpr char kSpawnedTestPackagePath[] = "/test-pkg"; | |
| // Path to our tmp directory for use in spawned processes. | |
| // Our component's /tmp directory is bound to this path in the spawned process. | |
| // This is useful when wanting the trace program to write output to our /tmp directory. | |
| constexpr char kSpawnedTestTmpPath[] = "/test-tmp"; | |
| // Run the trace program, but do not wait for it to exit. | |
| // |args| is the list of arguments to pass. It is not called |argv| as it does not include argv[0]. | |
| // Wait for trace to exit with |WaitAndGetReturnCode()|. | |
| // The only current reason to use this instead of |RunTraceAndWait()| is when one is expecting a | |
| // non-zero return code from trace. | |
| bool RunTrace(const zx::job& job, const std::vector<std::string>& args, zx::process* out_child); | |
| // Run the trace program and wait for it to exit. | |
| // Returns true if trace ran successfully and exited with a zero return code. | |
| // |args| is the list of arguments to pass. It is not called |argv| as it does not include argv[0]. | |
| bool RunTraceAndWait(const zx::job& job, const std::vector<std::string>& args); | |
| // Runs and traces integration test system app with run command and given parameters. This looks up | |
| // the test by name and produces a trace file that can be verified using VerifyIntegrationTest. | |
| // additional_arguments are passed to trace, not to the test app. | |
| bool RunIntegrationTest(const std::string& app_path, const std::string& test_name, | |
| const std::string& categories, size_t buffer_size_in_mb, | |
| const std::string& buffering_mode, | |
| std::initializer_list<std::string> additional_arguments, | |
| const std::string& relative_output_file_path); | |
| // Runs integration test system app with verify command and given parameters. This verifies the | |
| // trace file resulting from a call to RunIntegrationTest using the test's verification method. | |
| bool VerifyIntegrationTest(const std::string& app_path, const std::string& test_name, | |
| size_t buffer_size_in_mb, const std::string& buffering_mode, | |
| const std::string& relative_output_file_path); | |
| } // namespace tracing::test | |
| #endif // SRC_PERFORMANCE_TRACE_TESTS_RUN_TEST_H_ |