Documentation

Plugins

Client libraries

Publishing

FAQs


karma-publish groks the following formats.

The Simple Formats

Only one field per line is allowed. Lines that are blank, or that begin with # are considered comments, and ignored.

Example: simple.iplist

192.0.2.1
192.0.2.2
192.0.3.0/24
192.0.4.0-192.0.4.255

CIDR and range notation are permitted.

Example: simple.domainlist

foo.example.com
*.bar.example.com
.quux.example.com

*.bar.example.com does not include bar.example.com. .quux.example.com does include quux.example.com.

Example: simple.urllist

http://foo.com/baz/

The /baz/ hierarchy of http://foo.com/ will match, but not the subdomains under foo.com; you may want to use domainlist to match domains.

Example: simple.emaillist

foo@quux.com

foo@quux.com will match. So will foo+bar@quux.com and foo-bar@quux.com. And foo@subdomain.quux.com.

The RBL Formats

These formats are provided for backward compatibility with rbldnsd. Anything that RBLDNSd can read, we can read. We also respect the defaults set by the : prefix.

Example: rbl.simpleip

192.0.2.0/24:127.0.0.2:all your base are belong to us

192.0.2.1 will match. It will return the value -1000 and the comment "all your base are belong to us."

The Score Formats

These are comma-separate values consistent with Perl's Text::CSV. Lines that are blank, or that begin with # are considered comments, and ignored.

identity[,value[,comment]]

We recognize score values in the range of -1000 to +1000. 0 is considered neutral; any rules that say "if-match" will not match a 0 value.

Example: score.ip4

192.0.2.1,-1000,disliked
192.0.2.2,0,neutral
192.0.2.3,1000,liked
"192.0.2.4",1000,"here is an actual "" quote "" character, and an actual comma."
192.0.2.5,1000
192.0.2.6

192.0.2.6 will default to a +1000 value. The same IP CIDR range and *.subdomain.com conventions apply as above.