Updated Home (markdown)

Home.md

@@ -54,9 +54,50 @@ blacklisted_todomains   whitelisted_hostnames
 sqlite> insert into whitelisted_domains values ('example.com');
 sqlite> select domain from whitelisted_domains;
 example.com
-
 </pre>
 
+### Sqlitedb tables explained (taken from the Hermes mailinglist)
+
+All the **whitelisted*** and **blacklisted*** tables have only one field that
+is the value that you want to blacklist or whitelist. The tables hold
+values for the following:
+
+* **whitelisted_ips**: Lists IPs that can send you email without going
+through greylisting.
+
+* **whitelisted_hostnames**: Lists hostnames that can send you email without
+greylisting. This hostname is retrieved by hermes from the reverse
+resolution of the ip. It basically allows you to whitelist big chunks
+of machines that you want to whitelist and that have a common domain.
+It will allow partial matches, so for example adding an entry for
+".google.com" will whitelist all machines that send email for google.
+notice the dot before the domain, without it you would be allowing all
+domains ending in google.com to send you mail, so, for example, I could
+register spamgoogle.com and send you spam without going through
+greylisting.
+
+* **whitelisted_tos**: lists email accounts that you don't want greylisting
+for. I use it for whitelisting specific accounts that need to receive
+email. For example alerts at domain.com
+
+* **whitelisted_domains**: the same but for whole domains. I use it
+regularly for customers that complain about the email delay, usually
+because they receive email from many non-repeating different sources.
+
+* **blacklisted_ips**: ips of hosts you want to blacklist. Keep in mind
+that we will ALWAYS return a temporary error, so if you later change
+your mind about the blacklist you will receive all the email that was
+previously rejected (if they are not very old, of course).
+
+* **blacklisted_froms**: email accounts you don't want to receive mail
+from. The same caveat as on blacklisted_ips applies.
+
+There is no way to whitelist a specific "from" address, as that would
+mean that any spammer guessing it (not that difficult) could easily
+send you spam. Still, almost the same functionality can be achieved
+with whitelisted_hostnames and whitelisted_ips.
+
+
 ### Greylist options explained:
 
 <pre>