.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
        OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }

        H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
        H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
        H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
        H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>quisp: config file</title>
<body bgcolor=99cc99 vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td align=right><a href="quisp_home.html">
<img src="img/quisp2.gif" border=0><br><small>quick server pages</a> &nbsp; &nbsp; </td></tr>
<td>
.>>

.TH config file TDH "19-MAR-2004   TDH scg@jax.org" 

.SH Config file
QUISP uses the same config file as 
.ig >>
<a href="../../sqlman/html/shsql_handbook.html">
.>>
\0shsql.
.ig >>
</a>
.>>
See the 
.ig >>
<a href="http://quisp.sourceforge.net/sqlman/html/config.html">
.>>
\0shsql config file manual page
.ig >>
</a>
.>>
for additional info.
A basic config file is set up when you create a new project using \fCnewproject.sh\fR

.ig >>
<br><br><br>
.>>
A config file is simply a set of attribute: value pairs.  Here's an example:
.nf
defaultrtn: docs/home
debugtag:   zizzer
.fi

.ig >>
<br><br><br>
.>>

The following additional config file attributes are supported:

.LP
\fBshellmetachars:\fR
.IP \0
A list of shell metacharacters to screen out when building shell commands.
See the
.ig >>
<a href="shell.html">
.>>
\0#shell manual page.
.ig >>
</a>
.>>
Also can be set dynamically using the
.ig >>
<a href="mode.html">
.>>
\0#mode
.ig >>
</a>
.>>
directive.
.br
Example: \fCshellmetachars: '"`\fR

.ig >>
<br><br><br>
.>>
.ig >>
<a name=defaultrtn></a>
.>>
.LP
\fBdefaultrtn:\fR
.IP \0
Default page to display if none is specified.  Name is relative to \fC./pages\fR
in the project directory.
.br
Example: \fCdefaultrtn: docs/homepage\fR

.ig >>
<br><br><br>
.>>
.ig >>
<a name=doctag></a>
.>>
.LP
\fBdoctag:\fR
.IP \0
Set a symbol to use in place of \fCrtn\fR for specifying return pages in URLs.
.br
Example: \fCdoctag: doc\fR

.ig >>
<br><br><br>
.>>
.ig >>
<a name=debugtag></a>
.>>
.LP
\fBdebugtag:\fR
.IP \0
Any user can add \fC_DEBUG=1\fR to an invoking URL which causes QUISP to
display diagnostic information.
If \fC_DEBUG\fR shows information that you don't wish for the world to see, use this
setting to change the variable name to something obscure.
.br
Example: \fCfibizy\fR
.br
then for debug mode use \fCfibizy=1\fR in the URL..

.ig >>
<br><br><br>
.>>
.ig >>
<a name=allownonprint></a>
.>>
.LP
\fBallownonprint:\fR
.IP \0
Normally, QUISP scans the first several lines of a requested page
file and if any characters outside normal lower ascii range are found a "not displayable"
error will result.  If you want to disenable this feature, use \fCallownonprint: 1\fR.

.ig >>
<br><br><br>
.>>
.ig >>
<a name=cgipath></a>
.>>
.LP
\fBcgipath:\fR
.IP \0
Allows a specific command PATH to be set for the cgi environment (only).
Value should be a legitimate PATH specification.
.br
Example: \fCcgipath: /bin:/usr/bin:/home/steve/mybin\fR
.br
An alternative way to set the PATH would be to use something like this in your config file:
.br
\fCputenv: PATH=/bin:/usr/bin:/home/steve/mybin\fR
.br
but this would be in affect for command line uses as well as CGI.


.ig >>
<br><br><br>
.>>
.ig >>
<a name=cpulimit></a>
.>>
.LP
\fBcpulimit:\fR
.IP \0
Normally, QUISP sets a resource limit of 20 seconds of cpu time.  Any request
that runs over this terminates with a SIGLIMIT error.  This limit may be raised or lowered
using this attribute.
.br
Example: \fCcpulimit: 10\fR



.ig >>
<br><br><br>
.>>

.SH DATE-RELATED
.LP
There are a number of date-related config file attributes.. these are documented
.ig >>
<a href="http://ploticus.sourceforge.net/doc/config.html#dates">
.>>
\0here.
.ig >>
</a>
.>>


.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="quisp_home.html">
<img src="img/quisp2.gif" border=0></a><br>
<small>quick server pages &nbsp; &nbsp;<br>
<a href="Copyright.html">Copyright Steve Grubb</a> &nbsp; &nbsp;
</td></tr>
</table>
.>>
