// Copyright 2015 The Crashpad Authors
//
// Licensed 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
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
#ifndef CRASHPAD_TEST_WIN_CHILD_LAUNCHER_H_
#define CRASHPAD_TEST_WIN_CHILD_LAUNCHER_H_
#include <windows.h>
#include <string>
#include "base/files/file_path.h"
#include "util/win/scoped_handle.h"
namespace crashpad {
namespace test {
//! \brief Creates a child process for testing. Uses Google Test `ASSERT_*` to
//! indicate failure. The child's output is passed through a pipe and is
//! available via stdout_read_handle(), and the child's input is attached to
//! a second pipe available via stdin_write_handle().
class ChildLauncher {
public:
//! \brief Creates the object. \a executable will be escaped and prepended to
//! \a command_line to build the command line of the child.
ChildLauncher(const base::FilePath& executable,
const std::wstring& command_line);
~ChildLauncher();
//! \brief Starts the child process, after which the handle functions below
//! will be valid.
//!
//! Errors are signaled via Google Test assertions. This method may be invoked
//! via `ASSERT_NO_FATAL_FAILURE()` to assert that it succeeds.
void Start();
//! \brief Waits for the child process to exit.
//!
//! \return The process exit code.
DWORD WaitForExit();
//! \brief The child process's `HANDLE`.
HANDLE process_handle() const { return process_handle_.get(); }
//! \brief The child process's main thread's `HANDLE`.
HANDLE main_thread_handle() const { return main_thread_handle_.get(); }
//! \brief The read end of a pipe attached to the child's stdout.
HANDLE stdout_read_handle() const { return stdout_read_handle_.get(); }
//! \brief The write end of a pipe attached to the child's stdin.
HANDLE stdin_write_handle() const { return stdin_write_handle_.get(); }
private:
base::FilePath executable_;
std::wstring command_line_;
ScopedKernelHANDLE process_handle_;
ScopedKernelHANDLE main_thread_handle_;
ScopedFileHANDLE stdout_read_handle_;
ScopedFileHANDLE stdin_write_handle_;
};
} // namespace test
} // namespace crashpad
#endif // CRASHPAD_TEST_WIN_CHILD_LAUNCHER_H_