X-Git-Url: http://www.dolda2000.com/gitweb/?p=ashd.git;a=blobdiff_plain;f=doc%2Fpatplex.doc;h=a9ebe69dd4c949584c715640ba4c19740925803a;hp=86d6aced27425336b32fd2b5d747595f51d43332;hb=597edd91dd69eece8ef716e8113d3e2cc4d03d37;hpb=4dc7f716a7b4be064ecf86f6e1444b7b39dfdfe7 diff --git a/doc/patplex.doc b/doc/patplex.doc index 86d6ace..a9ebe69 100644 --- a/doc/patplex.doc +++ b/doc/patplex.doc @@ -92,23 +92,49 @@ rules are recognized: 'HEADER', the rule never matches. If 'FLAGS' contain the character `i`, 'REGEX' is matched case-independently. +*all*:: + + The rule always matches. + *default*:: - Matches if and only if no *match* stanza without a *default* - rule has matched. + Convenient shorthand for an *all* line followed by *priority + -10* (see below). In addition to the rules, a *match* stanza must contain exactly one -follow-up line specifying the action to take if it matches. Currently, -only the *handler* action is recognized: +follow-up line specifying the action to take if it matches. The +following actions are supported: *handler* 'HANDLER':: 'HANDLER' must be a named handler as declared by a *child* or *fchild* stanza, to which the request is passed. +*reparse*:: + + Apply any side-effects as required by the match stanza (such + as rest-string or header modifications), and then retry the + matching of the request. During the rematching, the stanza + containing the *reparse* action will be disabled. Multiple + *reparse* stanzas may be used recursively. + Additionally, a *match* stanza may contain any of the following, optional lines: +*priority* 'INTEGER':: + + Specifies the priority for the match stanza. In case more than + one stanza match a request, the one with the highest priority + is used. In case more than one stanza with the same highest + priority match a request, it is unspecified which will be + used. Match stanzas without a priority specification will + default to priority 0. Either positive or negative priorities + may be specified. + +*order* 'INTEGER':: + + A synonym for *priority*. Use whichever you like the best. + *set* 'HEADER' 'VALUE':: If the *match* stanza as a whole matches, the named HTTP