libzypp 17.37.10

ExternalProgram.h
Go to the documentation of this file.
1/*---------------------------------------------------------------------\
2| ____ _ __ __ ___ |
3| |__ / \ / / . \ . \ |
4| / / \ V /| _/ _/ |
5| / /__ | | | | | | |
6| /_____||_| |_| |_| |
7| |
8\---------------------------------------------------------------------*/
11
12
13#ifndef ZYPP_EXTERNALPROGRAM_H
14#define ZYPP_EXTERNALPROGRAM_H
15
16#include <unistd.h>
17
18#include <map>
19#include <string>
20#include <vector>
21#include <optional>
22
23#include <zypp-core/Globals.h>
24#include <zypp-core/base/ExternalDataSource.h>
25#include <zypp-core/Pathname.h>
26
27 namespace zyppng {
28 class AbstractSpawnEngine;
29}
30
31 namespace zypp {
32
63 */
64 class ZYPP_API ExternalProgram : public zypp::externalprogram::ExternalDataSource
65 {
66
67 public:
68
69 using Arguments = std::vector<std::string>;
70
74 */
75 enum Stderr_Disposition {
76 Normal_Stderr,
77 Discard_Stderr,
78 Stderr_To_Stdout,
79 Stderr_To_FileDesc
80 };
81
85 using Environment = std::map<std::string, std::string>;
86
95 ExternalProgram (const std::string& commandline,
96 Stderr_Disposition stderr_disp = Normal_Stderr,
97 bool use_pty = false, int stderr_fd = -1, bool default_locale = false,
98 const Pathname& root = "");
99
121
122 ExternalProgram();
123
124 ExternalProgram (const Arguments &argv,
125 Stderr_Disposition stderr_disp = Normal_Stderr,
126 bool use_pty = false, int stderr_fd = -1, bool default_locale = false,
127 const Pathname& root = "");
128
129 ExternalProgram (const Arguments &argv, const Environment & environment,
130 Stderr_Disposition stderr_disp = Normal_Stderr,
131 bool use_pty = false, int stderr_fd = -1, bool default_locale = false,
132 const Pathname& root = "");
133
134 ExternalProgram (const char *const *argv,
135 Stderr_Disposition stderr_disp = Normal_Stderr,
136 bool use_pty = false, int stderr_fd = -1, bool default_locale = false,
137 const Pathname& root = "");
138
139 ExternalProgram (const char *const *argv, const Environment & environment,
140 Stderr_Disposition stderr_disp = Normal_Stderr,
141 bool use_pty = false, int stderr_fd = -1, bool default_locale = false,
142 const Pathname& root = "");
143
144 ExternalProgram (const char *binpath, const char *const *argv_1,
145 bool use_pty = false);
146
147
148 ExternalProgram (const char *binpath, const char *const *argv_1, const Environment & environment,
149 bool use_pty = false);
150
151
152 ~ExternalProgram() override;
153
154#ifdef __cpp_lib_optional // YAST/PK explicitly use c++11 until 15-SP3
163 bool waitForExit ( std::optional<uint64_t> timeout = {} );
164#endif
165
167 int close() override;
168
172 bool kill();
173
177 bool kill( int sig );
178
182 bool running();
183
187 pid_t getpid();
188
190 const std::string & command() const;
191
201 const std::string & execError() const;
202
206 static void renumber_fd (int origfd, int newfd);
207
208 public:
209
228 std::ostream & operator>>( std::ostream & out_r );
229
230 private:
231 std::unique_ptr<zyppng::AbstractSpawnEngine> _backend;
232
233 protected:
234
235 void start_program (const char *const *argv, const Environment & environment,
236 Stderr_Disposition stderr_disp = Normal_Stderr,
237 int stderr_fd = -1, bool default_locale = false,
238 const char* root = NULL, bool switch_pgid = false, bool die_with_parent = false, bool usePty = false );
239
240 };
241
242
243 namespace externalprogram
244 {
249 */
250 struct EarlyPipe
251 {
252 enum { R=0, W=1 };
253 EarlyPipe();
254 ~EarlyPipe();
255 void closeW() { if ( _fds[W] != -1 ) { ::close( _fds[W] ); _fds[W] = -1; } }
256 FILE * fStdErr() { return _stderr; }
257 protected:
258 FILE * _stderr;
259 int _fds[2];
260 };
261 } // namespace externalprogram
262
265 */
266 class ExternalProgramWithStderr : private externalprogram::EarlyPipe, public ExternalProgram
267 {
268 public:
269 ExternalProgramWithStderr( const Arguments & argv_r, bool defaultLocale_r = false, const Pathname & root_r = "" )
270 : ExternalProgram( argv_r, Stderr_To_FileDesc, /*use_pty*/false, _fds[W], defaultLocale_r, root_r )
271 { _initStdErr(); }
272 /** \overlocad Convenience taking just the \a root_r. */
273 ExternalProgramWithStderr( const Arguments & argv_r, const Pathname & root_r )
274 : ExternalProgramWithStderr( argv_r, false, root_r )
275 {}
276
277 ExternalProgramWithStderr( const Arguments & argv_r, const Environment & environment_r, bool defaultLocale_r = false, const Pathname & root_r = "" )
278 : ExternalProgram( argv_r, environment_r, Stderr_To_FileDesc, /*use_pty*/false, _fds[W], defaultLocale_r, root_r )
279 { _initStdErr(); }
280 /** \overlocad Convenience taking just the \a root_r. */
281 ExternalProgramWithStderr( const Arguments & argv_r, const Environment & environment_r, const Pathname & root_r )
282 : ExternalProgramWithStderr( argv_r, environment_r, false, root_r )
283 {}
284 public:
286 using externalprogram::EarlyPipe::fStdErr;
287
292 bool stderrGetUpTo( std::string & retval_r, const char delim_r, bool returnDelim_r = false );
293
296 */
297 bool stderrGetline( std::string & retval_r, bool returnDelim_r = false )
298 { return stderrGetUpTo( retval_r, '\n', returnDelim_r ); }
299
300 private:
301 /** Close write end of the pipe (childs end). */
302 void _initStdErr()
303 { closeW(); }
304
305 private:
306 std::string _buffer;
307 };
308
311 */
312 class ZYPP_LOCAL ExternalProgramWithSeperatePgid : public ExternalProgram
313 {
314 public:
315 ExternalProgramWithSeperatePgid (const char *const *argv,
316 Stderr_Disposition stderr_disp = Normal_Stderr,
317 int stderr_fd = -1, bool default_locale = false,
318 const Pathname& root = "") : ExternalProgram()
319 {
320 start_program( argv, Environment(), stderr_disp, stderr_fd, default_locale, root.c_str(), true );
321 }
322
323 };
324
325} // namespace zypp
326
327#endif // ZYPP_EXTERNALPROGRAM_H
zypp::ExternalProgramWithSeperatePgid::ExternalProgramWithSeperatePgid
ExternalProgramWithSeperatePgid(const char *const *argv, Stderr_Disposition stderr_disp=Normal_Stderr, int stderr_fd=-1, bool default_locale=false, const Pathname &root="")
Definition ExternalProgram.h:314
zypp::ExternalProgramWithStderr::stderrGetUpTo
bool stderrGetUpTo(std::string &retval_r, const char delim_r, bool returnDelim_r=false)
Read data up to delim_r from stderr (nonblocking).
Definition ExternalProgram.cc:525
zypp::ExternalProgramWithStderr::_buffer
std::string _buffer
Definition ExternalProgram.h:305
zypp::ExternalProgramWithStderr::ExternalProgramWithStderr
ExternalProgramWithStderr(const Arguments &argv_r, bool defaultLocale_r=false, const Pathname &root_r="")
Definition ExternalProgram.h:268
zypp::ExternalProgramWithStderr::_initStdErr
void _initStdErr()
Close write end of the pipe (childs end).
Definition ExternalProgram.h:301
zypp::ExternalProgramWithStderr::stderrGetline
bool stderrGetline(std::string &retval_r, bool returnDelim_r=false)
Read next complete line from stderr (nonblocking).
Definition ExternalProgram.h:296
zypp::ExternalProgram::start_program
void start_program(const char *const *argv, const Environment &environment, Stderr_Disposition stderr_disp=Normal_Stderr, int stderr_fd=-1, bool default_locale=false, const char *root=NULL, bool switch_pgid=false, bool die_with_parent=false, bool usePty=false)
Definition ExternalProgram.cc:157
zypp::ExternalProgram::Arguments
std::vector< std::string > Arguments
Definition ExternalProgram.h:68
zypp::ExternalProgram::Environment
std::map< std::string, std::string > Environment
For passing additional environment variables to set.
Definition ExternalProgram.h:84
zypp::ExternalProgram::ExternalProgram
ExternalProgram(const std::string &commandline, Stderr_Disposition stderr_disp=Normal_Stderr, bool use_pty=false, int stderr_fd=-1, bool default_locale=false, const Pathname &root="")
Start the external program by using the shell /bin/sh with the option -c.
Definition ExternalProgram.cc:48
zypp::ExternalProgram::Stderr_Disposition
Stderr_Disposition
Define symbols for different policies on the handling of stderr.
Definition ExternalProgram.h:74
zypp::ExternalProgram::Stderr_To_FileDesc
@ Stderr_To_FileDesc
Definition ExternalProgram.h:78
zypp::ExternalProgram::Discard_Stderr
@ Discard_Stderr
Definition ExternalProgram.h:76
zypp::ExternalProgram::Stderr_To_Stdout
@ Stderr_To_Stdout
Definition ExternalProgram.h:77
zypp::ExternalProgram::Normal_Stderr
@ Normal_Stderr
Definition ExternalProgram.h:75
zypp::ExternalProgram::_backend
std::unique_ptr< zyppng::AbstractSpawnEngine > _backend
Definition ExternalProgram.h:230
zypp::PluginFrame::operator>>
std::istream & operator>>(std::istream &str, PluginFrame &obj)
Construct from stream.
Definition PluginFrame.h:284
zypp::externalprogram::ExternalDataSource
Bidirectional stream to external data.
Definition ExternalDataSource.h:28
zypp::filesystem::Pathname
Pathname.
Definition Pathname.h:47
zyppng::AbstractSpawnEngine
Definition abstractspawnengine_p.h:22
zypp::externalprogram
Definition ExternalDataSource.cc:33
zypp
Easy-to use interface to the ZYPP dependency resolver.
Definition Application.cc:20
zypp::ZYPP_API
const Arch Arch_armv7hnl Arch_armv7nhl ZYPP_API
Definition Arch.h:247
zyppng
Definition MediaNetworkRequestExecutor.h:16
zypp::externalprogram::EarlyPipe
Helper providing pipe FDs for ExternalProgramWithStderr.
Definition ExternalProgram.h:250
zypp::externalprogram::EarlyPipe::~EarlyPipe
~EarlyPipe()
Definition ExternalProgram.cc:517
zypp::externalprogram::EarlyPipe::closeW
void closeW()
Definition ExternalProgram.h:254
zypp::externalprogram::EarlyPipe::_fds
int _fds[2]
Definition ExternalProgram.h:258
zypp::externalprogram::EarlyPipe::EarlyPipe
EarlyPipe()
Definition ExternalProgram.cc:504
zypp::externalprogram::EarlyPipe::_stderr
FILE * _stderr
Definition ExternalProgram.h:257
zypp::externalprogram::EarlyPipe::R
@ R
Definition ExternalProgram.h:251
zypp::externalprogram::EarlyPipe::W
@ W
Definition ExternalProgram.h:251
zypp::externalprogram::EarlyPipe::fStdErr
FILE * fStdErr()
Definition ExternalProgram.h:255
Globals.h
Provides API related macros.
ZYPP_LOCAL
#define ZYPP_LOCAL
Definition Globals.h:71
Pathname.h
ExternalDataSource.h