On 5/14/2018 1:46 PM, jack wrote:
>
> On 14/05/2018 18:58, Viktor Dukhovni wrote:
>>
>>
>> Look for "HOST NAME/ADDRESS PATTERNS" in
>> http://www.postfix.org/access.5.html
>>
>> The http://www.postfix.org/postconf.5.html#check_client_access
>> docs point
>> you at access(5), so this is not exactly hiding...
>
> Thank you Viktor, I am familiar with those pages.
>
> The fact which I think may be undocumented is that postfix (but not
> postmap) performs iterative prefix queries, when (and only when?) the
> table-type is indexed.
You're looking at this backwards. Postfix ACCESS TABLES
(check_*_access) do iterative lookups in indexed files. This is a
feature of access tables, not general postfix indexed file behavior.
This behavior is documented in access(5), which is where it belongs.
Each postfix feature that does anything other that a single verbatim
lookup is documented within that feature's man page lookup pattern
section. Features do not document things they DON'T do, since an
exhaustive list isn't possible.
That said, it's not unreasonable to include a note on the postmap
page since this seems to trip up many novice users, and part of the
mission is to make postfix usable for novice users.
... Of course, the hard part is crafting a note that's brief and
doesn't add to the confusion.
My first iteration, probably needs improvement.
-q key Search the specified ...
...
Note: This performs a single search of the key as supplied.
Iterative search of sub-keys is not supported.
-- Noel Jones
