ShellCmdTempl directive

Controls the composition of the command line given to WinExec() to start up the script execution environment.

Purpose

The ShellCmdTempl directive specifies a special formatting string that controls the composition of the command line used in the server's call to WinExec() to start up a script execution.

You can use this to tailor the command line issued by httpd to suit your needs. Note the special character sequences listed below, which are used as substitution signals (analogous to printf() formats).


Syntax

ShellCmdTempl format-string

format-string is a template for the WinExec() command line. It can consist of anything that is legal in a Windows command line, plus the following special sequences for which substitutions are made as described:

~s
The executable that is to be run, as specified by ShellExec.
~x
The shell exec option(s) as specified by ShellExecOption or ShellExecOptionDeb (when script tracing is active).
~p
The tempfile containing the shell startup jacket procedure that defines the environment variables then invokes the actual script.
~i
The tempfile containing the POST content, if any, that was supplied by the client.
~o
The tempfile in which the httpd server expects to find the output from the script.
Only one ShellCmdTempl directive is allowed in the configuration file.


Default

If you do not specify a ShellCmdTempl, httpd assumes:

ShellCmdTempl ~s ~x ~p < ~i > ~o

Example

ShellCmdTempl ~s ~x ~p -i ~i -o ~o

For a hypothetical shell that uses -i and -o for input and output files instead of command line redirection..

Return to Wizard Scripting Overview


Robert B. Denny <rdenny@netcom.com>