X-Git-Url: https://git.netwichtig.de/gitweb/?a=blobdiff_plain;f=src%2Fsrc%2Flookups%2FREADME;h=2e87edadd5bf61605311972f9147f2271264195f;hb=7f83b348ccf4cd815e9758ab9ca1012e66324e9d;hp=31fea64489398d6428da741b5220413cd4f7810f;hpb=14b3c5bc64a16df07583fe4b5ef2e0129d063893;p=user%2Fhenk%2Fcode%2Fexim.git diff --git a/src/src/lookups/README b/src/src/lookups/README index 31fea6448..2e87edadd 100644 --- a/src/src/lookups/README +++ b/src/src/lookups/README @@ -34,9 +34,13 @@ example, the sqlite lookup is of this type. When a single-key or absfilequery lookup file is opened, the handle returned by the xxx_open() function is saved, along with the file name and lookup type, in -a tree. The xxx_close() function is not called when the first lookup is -completed. If there are subsequent lookups of the same type that quote the same -file name, xxx_open() isn't called; instead the cached handle is re-used. +a tree. Traditionally, lookup_querystyle does not use this (just returning a +dummy value, and doing the "open" work in the xxx_find() routine); but this is +not enforced by the framework. + +The xxx_close() function is not called when the first lookup is completed. If +there are subsequent lookups of the same type that quote the same file name, +xxx_open() isn't called; instead the cached handle is re-used. Exim calls the function search_tidyup() at strategic points in its processing (e.g. after all routing and directing has been done) and this function walks @@ -131,6 +135,8 @@ DEFER. The arguments are: If set to a nonzero number of seconds, the cached value becomes unusable after this time. Currently the dnsdb lookup uses this to support the TTL value. + uschar *opts options, a comma-separated list of tagged values for + modifying the search operation Even though the key is zero-terminated, the length is passed because in the common case it has been computed already and is often needed. @@ -162,7 +168,7 @@ needed, it can return its single argument, which is a uschar *. This function does NOT use the POOL_SEARCH store, because it's usually never called from any lookup code. -xxx_report_version() +xxx_version_report() -------------------- This is called to report diagnostic information to a file stream.