X-Git-Url: http://www.dolda2000.com/gitweb/?a=blobdiff_plain;f=doc%2Fpatplex.doc;h=f567d56f715c9f112e20af6eefa88967faf8068c;hb=9e70ef793ddcf51edc0f6489eb6f70762380afc0;hp=dbe8e964c733a5b2af44fb9c6ce092b731fa17ea;hpb=249cd06f0813656bcc4131ffa0f27819d3f2bc0b;p=ashd.git diff --git a/doc/patplex.doc b/doc/patplex.doc index dbe8e96..f567d56 100644 --- a/doc/patplex.doc +++ b/doc/patplex.doc @@ -46,9 +46,9 @@ Should the global and the given configuration files conflict, the directives from the given file take precedence. The configuration files follow the same general format as for -*dirplex*(1), though the recognized stanzas differ. The *child* and -*fchild* stanzas are also shared with *dirplex*(1), so see its manpage -for a description thereof. +*dirplex*(1), though the recognized stanzas differ. The *child*, +*fchild* and *include* stanzas are also shared with *dirplex*(1), so +see its manpage for a description thereof. *patplex* recognizes the *match* stanza, which takes no arguments, but must contain at least one follow-up line to specify match rules. All @@ -101,14 +101,30 @@ only the *handler* action is recognized: 'HANDLER' must be a named handler as declared by a *child* or *fchild* stanza, to which the request is passed. -Additionally, a *match* stanza may contain a *restpat* line: +Additionally, a *match* stanza may contain any of the following, +optional lines: + +*set* 'HEADER' 'VALUE':: + + If the *match* stanza as a whole matches, the named HTTP + 'HEADER' in the request is set to 'VALUE' before passing the + request on to the specified handler. A *match* stanza may + contain any number of *set* lines. + +*xset* 'HEADER' 'VALUE':: + + *xset* does exactly the same thing as *set*, except the + 'HEADER' is automatically prepended with the `X-Ash-` + prefix. The intention is only to make configuration files + look nicer in this very common case. *restpat* 'TEMPLATE':: If the *match* stanza as a whole matches, 'TEMPLATE' is expanded and installed as the rest string of the request before it is passed to the specified handler. In 'TEMPLATE', - the following parameters are recognized and expanded. + the following parameters are recognized and expanded. At most + one *restpat* line may be given per *match* stanza. *$0* ... *$9*::