/usr/include/wvstreams/wvsystem.h is in libwvstreams-dev 4.6.1-7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 | /* -*- Mode: C++ -*-
* Worldvisions Weaver Software:
* Copyright (C) 1997-2002 Net Integration Technologies, Inc.
*/
#ifndef __WVSYSTEM_H
#define __WVSYSTEM_H
#include "wvsubproc.h"
/**
* WvSystem is a mostly-replacement for the libc system() function call,
* which people usually use because of its notational convenience, not
* because it calls the Unix shell. In fact, some people don't even realize
* it calls the shell, leading to security holes when people forget to
* quote user-provided parameters correctly.
*
* WvSystem() uses WvSubProc but makes sure it can be called in a single
* line of C++ code with a minimum of fluff. For example:
*
* WvSystem("rm", "-rf", filename, NULL);
* is like
* system(WvString("rm -rf %s", filename));
* except that you don't have weird security bugs if "filename" contains
* special characters like newline, space, quotation mark, etc.
*
* See WvSubProc and WvSubProcQueue for less concise, but more flexible ways
* to run subprograms.
*/
class WvSystem : private WvSubProc
{
public:
/**
* Construct a WvSystem from a simple list of strings.
*
* For example:
* WvSystem("rm", "-rf", dirname);
*
* Note: this is unlike WvSubProc::prepare(cmd, ...) because you
* don't need to provide argv[0] yourself. "cmd" is automatically
* inserted as argv[0]. It also lets you pass WvString objects in
* without manually calling cstr(), because it doesn't use varargs.
* Unfortunately, that means it's limited to 20 arguments.
*/
WvSystem(const char cmd[],
const char *a0 = NULL,
const char *a1 = NULL,
const char *a2 = NULL,
const char *a3 = NULL,
const char *a4 = NULL,
const char *a5 = NULL,
const char *a6 = NULL,
const char *a7 = NULL,
const char *a8 = NULL,
const char *a9 = NULL,
const char *a10 = NULL,
const char *a11 = NULL,
const char *a12 = NULL,
const char *a13 = NULL,
const char *a14 = NULL,
const char *a15 = NULL,
const char *a16 = NULL,
const char *a17 = NULL,
const char *a18 = NULL,
const char *a19 = NULL
)
{
// this function is inline so it can be a little bit less wasteful...
const char * const argv[] = {
cmd,
a0, a1, a2, a3, a4, a5, a6, a7, a8, a9,
a10, a11, a12, a13, a14, a15, a16, a17, a18, a19,
NULL
};
init(argv);
}
/**
* Construct a WvSystem from an argv array. This is exactly the same
* as WvSubProc's argv[] constructor, but the command name is always
* taken from argv[0] rather than provided separately.
*
* For example:
* const char *argv[] = { "rm", "-rf", dirname, NULL };
* WvSystem(argv);
*/
WvSystem(const char * const *argv)
{ init(argv); }
/**
* Destroy the WvSystem object. If you haven't yet called go(), the
* command is run before destruction.
*/
virtual ~WvSystem();
/**
* Explicitly start the command running and wait for it to finish.
* This will happen automatically at object destruction time, but if you
* want to check the return code, you'll need to call go().
*/
int go();
/** Redirect stdin from the given input file. */
WvSystem &infile(WvStringParm filename);
/** Redirect stdout to the given output file, which is overwritten. */
WvSystem &outfile(WvStringParm filename);
/** Redirect stderr to the given output file, which is overwritten. */
WvSystem &errfile(WvStringParm filename);
private:
bool started;
WvString fdfiles[3]; // stdin, stdout, stderr
void init(const char * const *argv);
virtual int fork(int *waitfd);
};
#endif // __WVSYSTEM_H
|