more comments.

plugins.cfg

@@ -1,8 +1,12 @@
 # Lists all the plugins, or jobs, and whether they are enabled or not. Each
 # section name must correspond to a plugin name in the plugins dir.
+
+# This is just a sample plugin, comment out or remove in production.
 [sample_log]
 enabled = True
 
+# Runs an iptables command to add a rule, commonly used for captive portal
+# firewalls.
 [iptables]
 enabled = True
 
@@ -10,6 +14,10 @@ enabled = True
 only_ip = True
 
 # Command templates for arping and iptables.
-arping_cmd = arping -f -c 1 -w 30 -I wlp3s0 {ip_address}
-iptables_mac = iptables -t mangle -D internet -m mac --mac-source "{mac_address}" -j RETURN
-iptables_ip = iptables -t mangle -D internet -m tcp --source "{ip_address}" -j RETURN
+
+# Arping might block so make sure you use a timeout and limit the number of
+# packets it sends.
+arping = -f -c 1 -w 30 -I wlp3s0 {ip_address}
+
+iptables_mac = -t mangle -D internet -m mac --mac-source "{mac_address}" -j RETURN
+iptables_ip = -t mangle -D internet -m tcp --source "{ip_address}" -j RETURN