TYPE3
[iec.git] / src / type3_AndroidCloud / anbox-master / external / process-cpp-minimal / include / core / posix / exec.h
1 /*
2  * Copyright © 2013 Canonical Ltd.
3  *
4  * This program is free software: you can redistribute it and/or modify it
5  * under the terms of the GNU Lesser General Public License version 3,
6  * as published by the Free Software Foundation.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11  * GNU Lesser General Public License for more details.
12  *
13  * You should have received a copy of the GNU Lesser General Public License
14  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
15  *
16  * Authored by: Thomas Voß <thomas.voss@canonical.com>
17  */
18
19 #ifndef CORE_POSIX_EXEC_H_
20 #define CORE_POSIX_EXEC_H_
21
22 #include <core/posix/child_process.h>
23 #include <core/posix/visibility.h>
24
25 #include <functional>
26 #include <map>
27 #include <string>
28 #include <vector>
29
30 namespace core
31 {
32 namespace posix
33 {
34 enum class RedirectFlags;
35
36 /**
37  * @brief exec execve's the executable with the provided arguments and environment.
38  * @throws std::system_error in case of errors.
39  * @param fn The executable to run.
40  * @param argv Vector of command line arguments
41  * @param env Environment that the new process should run under
42  * @param flags Specifies which standard streams should be redirected.
43  * @return An instance of ChildProcess corresponding to the newly exec'd process.
44  */
45 CORE_POSIX_DLL_PUBLIC ChildProcess exec(const std::string& fn,
46                   const std::vector<std::string>& argv,
47                   const std::map<std::string, std::string>& env,
48                   const StandardStream& flags);
49
50 /**
51  * @brief exec execve's the executable with the provided arguments and environment.
52  * @throws std::system_error in case of errors.
53  * @param fn The executable to run.
54  * @param argv Vector of command line arguments
55  * @param env Environment that the new process should run under
56  * @param flags Specifies which standard streams should be redirected.
57  * @param child_setup Function to run in the child just before exec().
58  * @return An instance of ChildProcess corresponding to the newly exec'd process.
59  */
60 CORE_POSIX_DLL_PUBLIC ChildProcess exec(const std::string& fn,
61                   const std::vector<std::string>& argv,
62                   const std::map<std::string, std::string>& env,
63                   const StandardStream& flags,
64                   const std::function<void()>& child_setup);
65 }
66 }
67
68 #endif // CORE_POSIX_EXEC_H_