OLD | NEW |
| (Empty) |
1 // Copyright 2014 The Crashpad Authors. All rights reserved. | |
2 // | |
3 // Licensed under the Apache License, Version 2.0 (the "License"); | |
4 // you may not use this file except in compliance with the License. | |
5 // You may obtain a copy of the License at | |
6 // | |
7 // http://www.apache.org/licenses/LICENSE-2.0 | |
8 // | |
9 // Unless required by applicable law or agreed to in writing, software | |
10 // distributed under the License is distributed on an "AS IS" BASIS, | |
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
12 // See the License for the specific language governing permissions and | |
13 // limitations under the License. | |
14 | |
15 #ifndef CRASHPAD_UTIL_TEST_MULTIPROCESS_EXEC_H_ | |
16 #define CRASHPAD_UTIL_TEST_MULTIPROCESS_EXEC_H_ | |
17 | |
18 #include <string> | |
19 #include <vector> | |
20 | |
21 #include "base/basictypes.h" | |
22 #include "build/build_config.h" | |
23 #include "util/test/multiprocess.h" | |
24 | |
25 namespace crashpad { | |
26 namespace test { | |
27 | |
28 //! \brief Manages an `exec()`-based multiprocess test. | |
29 //! | |
30 //! These tests are based on `fork()` and `exec()`. The parent process is able | |
31 //! to communicate with the child in the same manner as a base-class | |
32 //! Multiprocess parent. The read and write pipes appear in the child process on | |
33 //! stdin and stdout, respectively. | |
34 //! | |
35 //! Subclasses are expected to implement the parent in the same was as a | |
36 //! base-class Multiprocess parent. The child must be implemented in an | |
37 //! executable to be set by SetChildCommand(). | |
38 class MultiprocessExec : public Multiprocess { | |
39 public: | |
40 MultiprocessExec(); | |
41 | |
42 //! \brief Sets the command to `exec()` in the child. | |
43 //! | |
44 //! This method must be called before the test can be Run(). | |
45 //! | |
46 //! \param[in] command The executable’s pathname. | |
47 //! \param[in] arguments The command-line arguments to pass to the child | |
48 //! process in its `argv[]` vector. This vector must begin at `argv[1]`, | |
49 //! as \a command is implicitly used as `argv[0]`. This argument may be | |
50 //! `nullptr` if no command-line arguments are to be passed. | |
51 void SetChildCommand(const std::string& command, | |
52 const std::vector<std::string>* arguments); | |
53 | |
54 protected: | |
55 ~MultiprocessExec(); | |
56 | |
57 // Multiprocess: | |
58 void PreFork() override; | |
59 | |
60 private: | |
61 // Multiprocess: | |
62 void MultiprocessChild() override; | |
63 | |
64 std::string command_; | |
65 std::vector<std::string> arguments_; | |
66 #if defined(OS_POSIX) | |
67 std::vector<const char*> argv_; | |
68 #elif defined(OS_WIN) | |
69 std::wstring command_line_; | |
70 #endif // OS_POSIX | |
71 | |
72 DISALLOW_COPY_AND_ASSIGN(MultiprocessExec); | |
73 }; | |
74 | |
75 } // namespace test | |
76 } // namespace crashpad | |
77 | |
78 #endif // CRASHPAD_UTIL_TEST_MULTIPROCESS_EXEC_H_ | |
OLD | NEW |