quisp: config file

quick server pages
| Manual page for config(file)

## Config file

QUISP uses the same config file as shsql.`` See the shsql config file manual page for additional info.`` A basic config file is set up when you create a new project using `newproject.sh`
A config file is simply a set of attribute: value pairs. Here's an example:

    defaultrtn: docs/home
    debugtag:   zizzer

The following additional config file attributes are supported:

shellmetachars:

  A list of shell metacharacters to screen out when building shell commands.`` See the #shell manual page.`` Also can be set dynamically using the #mode directive.``
  Example: `shellmetachars: '"``

defaultrtn:

  Default page to display if none is specified. Name is relative to `./pages` in the project directory.``
  Example: `defaultrtn: docs/homepage`

doctag:

  Set a symbol to use in place of `rtn` for specifying return pages in URLs.``
  Example: `doctag: doc`

debugtag:

  Any user can add `_DEBUG=1` to an invoking URL which causes QUISP to display diagnostic information.`` If `_DEBUG` shows information that you don't wish for the world to see, use this setting to change the variable name to something obscure.``
  Example: `fibizy`
  then for debug mode use `fibizy=1` in the URL..``

allownonprint:

  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 `allownonprint: 1`.``

cgipath:

  Allows a specific command PATH to be set for the cgi environment (only).`` Value should be a legitimate PATH specification.``
  Example: `cgipath: /bin:/usr/bin:/home/steve/mybin`
  An alternative way to set the PATH would be to use something like this in your config file:
  `putenv: PATH=/bin:/usr/bin:/home/steve/mybin`
  but this would be in affect for command line uses as well as CGI.``

cpulimit:

  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.``
  Example: `cpulimit: 10`

## DATE-RELATED

There are a number of date-related config file attributes.. these are documented here.``
quick server pages
Copyright Steve Grubb

Markup created by unroff 1.0, `` `` March 19, 2004.