lists.conf - Describes the available predefined named lists.
The lists.conf file contains zero or more named
For more information, enter 'perldoc PureMessage::List'.
sourceis prefixed by a URI-style scheme that selects the source type. The
sourcecan be one of the following:
If the source field does not begin with a scheme part, it is treated as if it was prefixed with 'file:'.
match, but list entries starting with '!' are treated as a negative rule. During matching each string to be matched is considered separately. If it matches at least one of the positive rules, but none of the negative rules, then it is a match.
As an example, if the nmatches-list contains the following two entries:
Then it matches all strings that do not start with the string 'foo'.
If the list entry starts with a decimal number followed by '.' or '/', then it is taken to be an IP4 address with an optional mask. The format for an entry of this type is:
<inet4> = <ip> [ "/" <mask> ] <ip> = <digits> "." <digits> "." <digits> "." <digits> <mask> = <ip> | <bits> <digits> = integer in the range 0 .. 255 <bits> = integer in the range 0 .. 32
If the list entry does not start with a number, it is taken as a glob style string that will be matched against a domain name. The supported wildcards are:
? match a single char, but not '.' * match a sequence of chars, but not '.'. ** match a sequence of chars, including '.'
Matches are automatically anchored to the end of the string. A leading
'@' can be used to force anchor to the beginning as well. If the list
item starts with '!', then it is negated as for
Matches against the exact IP address.
Matches any hostname in the example.com domain as well as 'example.com' itself. It does not match 'notexample.com' or 'example.com.org'.
Matches the same hostnames as above, but not 'example.com' itself.
Matches the same hostnames as above.
Matches hosts like 'foo.example.com', but not multilevel names like 'foo.bar.example.com'.
Only matches the host 'example.com' and not any subdomains.
domain, but '@' is prevented from matching on '*' and '?'. Also, if the list entry ends with '@' then the match is no longer anchored at the end.
Matches all addresses with 'example.com' as the exact domain part.
Matches all addresses starting with the string 'dev-'.
Configuring LDAP Lists
LDAP-based lists can be created either by appending them to lists.conf
or by placing additional files in the lists.d sub-directory. Like other
lists specified in lists.conf, each list is contained within its own
section. For example:
<list foo> name = "The Foo List" description = "Just an example" match_type = is source = ldap://localhost <args> port = 389 dn = "CN=pmxuser,DC=activestate,DC=com" password = testpass base = "DC=activestate,DC=com" match = "(mail=%s)" version = 3 async = 0 debug = 0 scope = sub </args> </list>
The list id in this case is 'foo', the name is 'The Foo List'. In addition to
the standard lists.conf attributes described earlier in this section (e.g.
source) LDAP sections contain an
args sub-section that
defines specific arguments required to help define the connection and search to
be performed against the LDAP server.
The source is prefixed by a URI-style scheme that indicates the source type. In the case of an LDAP list, the value provided must include the hostname for the LDAP server with which to connect.
Copyright (C) 2000-2008 Sophos Group. All rights reserved. Sophos and PureMessage are trademarks of Sophos Plc and Sophos Group.