xref: /aosp_15_r20/external/grpc-grpc/src/core/lib/gpr/subprocess.h (revision cc02d7e222339f7a4f6ba5f422e6413f4bd931f2)
1 //
2 //
3 // Copyright 2015 gRPC authors.
4 //
5 // Licensed under the Apache License, Version 2.0 (the "License");
6 // you may not use this file except in compliance with the License.
7 // You may obtain a copy of the License at
8 //
9 //     http://www.apache.org/licenses/LICENSE-2.0
10 //
11 // Unless required by applicable law or agreed to in writing, software
12 // distributed under the License is distributed on an "AS IS" BASIS,
13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 // See the License for the specific language governing permissions and
15 // limitations under the License.
16 //
17 //
18 
19 #ifndef GRPC_SRC_CORE_LIB_GPR_SUBPROCESS_H
20 #define GRPC_SRC_CORE_LIB_GPR_SUBPROCESS_H
21 
22 #include <grpc/support/port_platform.h>
23 
24 #include <string>
25 
26 typedef struct gpr_subprocess gpr_subprocess;
27 
28 /// .exe on windows, empty on unices
29 const char* gpr_subprocess_binary_extension();
30 
31 gpr_subprocess* gpr_subprocess_create(int argc, const char** argv);
32 
33 gpr_subprocess* gpr_subprocess_create_with_envp(int argc, const char** argv,
34                                                 int envc, const char** envp);
35 
36 // communicate to the subprocess via stdin, stdout and stderr
37 bool gpr_subprocess_communicate(gpr_subprocess* p, std::string& input_data,
38                                 std::string* output_data, std::string* error);
39 /// if subprocess has not been joined, kill it
40 void gpr_subprocess_destroy(gpr_subprocess* p);
41 /// returns exit status; can be called at most once
42 int gpr_subprocess_join(gpr_subprocess* p);
43 void gpr_subprocess_interrupt(gpr_subprocess* p);
44 int gpr_subprocess_get_process_id(gpr_subprocess* p);
45 
46 #endif  // GRPC_SRC_CORE_LIB_GPR_SUBPROCESS_H
47