X-Git-Url: http://www.dolda2000.com/gitweb/?a=blobdiff_plain;f=doc%2Fpatplex.doc;h=65e2d11bfd79751b8a00ca597e04815d4868ef9a;hb=ee4d8132ccace56ec94e1d615bb3fb44e246d73c;hp=dbe8e964c733a5b2af44fb9c6ce092b731fa17ea;hpb=249cd06f0813656bcc4131ffa0f27819d3f2bc0b;p=ashd.git diff --git a/doc/patplex.doc b/doc/patplex.doc index dbe8e96..65e2d11 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 @@ -93,7 +93,7 @@ rules are recognized: rule has matched. In addition to the rules, a *match* stanza must contain exactly one -follow-up line specifying the action to take if it mathces. Currently, +follow-up line specifying the action to take if it matches. Currently, only the *handler* action is recognized: *handler* 'HANDLER':: @@ -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 that + '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*::