/usr/share/doc/libbobcat4-dev/man/exec.3.html is in libbobcat-dev 4.08.02-2build1.
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 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | <!DOCTYPE html><html><head>
<meta charset="UTF-8">
<title>FBB::Exec(3bobcat)</title>
<style type="text/css">
figure {text-align: center;}
img {vertical-align: center;}
.XXfc {margin-left:auto;margin-right:auto;}
.XXtc {text-align: center;}
.XXtl {text-align: left;}
.XXtr {text-align: right;}
.XXvt {vertical-align: top;}
.XXvb {vertical-align: bottom;}
</style>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr/>
<h1 id="title">FBB::Exec(3bobcat)</h1>
<h2 id="author">Executing Child Processes<br/>(libbobcat-dev_4.08.02-x.tar.gz)</h2>
<h2 id="date">2005-2017</h2>
<p>
<h2 >NAME</h2>FBB::Exec - Runs external programs
<p>
<h2 >SYNOPSIS</h2>
<strong >#include <bobcat/exec></strong><br/>
Linking option: <em >-lbobcat</em>
<p>
<h2 >DESCRIPTION</h2>
The <strong >FBB::Exec</strong> class offers a basic interface for calling external
programs (so-called <em >child processes</em>). The standard streams of the child
processes are not handled by ttExec) objects. The <em >PATH</em> environment
variable is not used when calling child processes: child process programs must
be specified using paths.
<p>
<em >Exec</em> objects may repeatedly be used to execute the same or different
child processes. Before starting the next child process, the current child
process must have finished.
<p>
Arguments passed to child processes may be surrounded by double or single
quotes. Arguments surrounded by double quotes have their double quotes
removed, while interpreting any escape-sequences that may have been used
within. Arguments surrounded by single quotes have their single quotes
removed, while accepting their contents as-is. In addition unquoted
escape-sequences may be specified: those escape sequences are evaluated and
replaced by their intended characters (e.g., <em >\100</em> is converted to <em >@</em>).
<p>
<h2 >NAMESPACE</h2>
<strong >FBB</strong><br/>
All constructors, members, operators and manipulators, mentioned in this
man-page, are defined in the namespace <strong >FBB</strong>.
<p>
<h2 >INHERITS FROM</h2>
<strong >FBB::Fork</strong>
<p>
<h2 >CONSTRUCTOR</h2>
<p>
Only the default constructor is supported.
<p>
<h2 >MEMBERS</h2>
<p>
<ul>
<li> <strong >bool execute(std::string const &cmd)</strong>:<br/>
The argument specifies the command to execute: the command itself must
be specified as a path (the <em >PATH</em> environment variable isn't used). The
member returns <em >true</em> if the child process's exit value equals 0. Otherwise
<em >false</em> is returned. Once <em >execute</em> has returned it can be called again,
either using the same or another command. The class <em >Exec</em> does not offer
facilities to forcefully terminate child processes: parent processes are
suspended until the child processes have completed. Arguments passed to the
program to be executed as child process may optionall be specified using
single or double quotes, as described in this man-page's DESCRIPTION section.
<p>
<li> <strong >int ret() const</strong>:<br/>
Once <em >execute</em> has returned this member provides the actual exit
code of the child process. Its value equals -1 before the first <em >exectue</em>
call.
</ul>
<p>
<h2 >EXAMPLE</h2>
<p>
<pre >
#include <iostream>
#include <bobcat/execfork>
using namespace std;
using namespace FBB;
int main()
{
ExecFork ef;
if (ef.execute("/bin/cp driver.cc /tmp"))
cout << "driver.cc now copied to /tmp\n";
else
cout << "could not copy driver.cc to /tmp\n";
cout << "Again:\n";
if (ef.execute("/bin/cp driver.cc /tmp"))
cout << "driver.cc now copied to /tmp\n";
else
cout << "could not copy driver.cc to /tmp\n";
}
</pre>
<p>
<h2 >FILES</h2>
<em >bobcat/exec</em> - provides the class interface
<p>
<h2 >SEE ALSO</h2>
<strong >bobcat</strong>(7), <strong >cerrextractor</strong>(3bobcat), <strong >cininserter</strong>(3bobcat),
<strong >coutextractor</strong>(3bobcat), <strong >execl</strong>(3), <strong >fork</strong>(3bobcat),
<strong >process</strong>(3bobcat), <strong >stdextractor</strong>(3bobcat).
<p>
<h2 >BUGS</h2>
None reported.
<p>
<h2 >DISTRIBUTION FILES</h2>
<ul>
<li> <em >bobcat_4.08.02-x.dsc</em>: detached signature;
<li> <em >bobcat_4.08.02-x.tar.gz</em>: source archive;
<li> <em >bobcat_4.08.02-x_i386.changes</em>: change log;
<li> <em >libbobcat1_4.08.02-x_*.deb</em>: debian package holding the
libraries;
<li> <em >libbobcat1-dev_4.08.02-x_*.deb</em>: debian package holding the
libraries, headers and manual pages;
<li> <em >http://sourceforge.net/projects/bobcat</em>: public archive location;
</ul>
<p>
<h2 >BOBCAT</h2>
Bobcat is an acronym of `Brokken's Own Base Classes And Templates'.
<p>
<h2 >COPYRIGHT</h2>
This is free software, distributed under the terms of the
GNU General Public License (GPL).
<p>
<h2 >AUTHOR</h2>
Frank B. Brokken (<strong >f.b.brokken@rug.nl</strong>).
<p>
</body>
</html>
|