aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org>2019-05-31 08:45:23 +0300
committerSergey Poznyakoff <gray@gnu.org>2019-05-31 08:58:54 +0300
commit058f256a6f41fc9c36404b2e22580546e4f55b33 (patch)
treeb6afde4271da1d92e5c10e1c50213c2fda7b2831 /doc
parentca38eef07ac3f9a4825f0046c1d373ed7b2f074b (diff)
downloadpies-058f256a6f41fc9c36404b2e22580546e4f55b33.tar.gz
pies-058f256a6f41fc9c36404b2e22580546e4f55b33.tar.bz2
Provide an option to run commands via sh -c
The new flag "shell" instructs pies to run the command marked with it as '/bin/sh -c $command'. Alternative shell can be supplied ising the 'program' statement. This is useful if the command line uses shell-specific features (command or variable expansion, redirection, pipes, etc.) This commit also fixes a bug in the 'env' statement handling: a single argument with embedded whitespaces was undergoing word splitting and thus incorrectly handled as multiple arguments. * NEWS: Document changes. * doc/pies.texi: Likewise. * src/comp.c (component_free): Free command. (component_finish): Split command into argv/argc as directed by the CF_SHELL flag. * src/pies.c (_cb_command): Remove. Functionality moved to component_finish(). (_cb_env): Bugfix. Don't split arguments. * src/pies.h (CF_SHELL): New flag. (component) <command>: New member. * tests/Makefile.am: Add new tests. * tests/testsuite.at: Add new tests. * tests/aux/respawn: Change default timeout to 1 second. * tests/respawn.at: Minor change. * tests/shell.at: New test.
Diffstat (limited to 'doc')
-rw-r--r--doc/pies.texi21
1 files changed, 20 insertions, 1 deletions
diff --git a/doc/pies.texi b/doc/pies.texi
index 012ac88..1a798e1 100644
--- a/doc/pies.texi
+++ b/doc/pies.texi
@@ -176,7 +176,11 @@ foreground.
Upon startup, @command{pies} reads the list of components
from its configuration file, starts them, and remains in the
-background, controlling their execution.
+background, controlling their execution. Each component is
+defined by the name of the external program to be run and its
+arguments (command line). The program is normally run directly
+(via @code{exec}), but you can instruct @command{pies} to run
+it via @code{sh -c} as well.
The standard output and standard error streams of a component can be
redirected to a file or to an arbitrary @command{syslog} channel.
@@ -870,6 +874,21 @@ their standard input to be open (e.g.@: @command{pppd nodetach}).
Mark this component as @dfn{precious}. Precious components are never
disabled by @command{pies}, even if they respawn too fast.
+@kwindex shell
+@item shell
+Run command as @code{/bin/sh -c "$command"}. Use this flag if command
+contains shell-specific features, such as I/O redirections, pipes,
+variables or the like. You can change the shell program using the
+@code{program} statement. For example, to use Korn shell:
+
+@example
+component X @{
+ flags shell;
+ program "/bin/ksh";
+ command "myprog $HOME";
+@}
+@end example
+
@kwindex wait
@item wait
This flag is valid only for @samp{inetd} components. It has the same

Return to:

Send suggestions and report system problems to the System administrator.