nhoad
diff --git a/‎README.rst
Lines changed: 52 additions & 4 deletions b/‎README.rst
Lines changed: 52 additions & 4 deletions
@@ -10,7 +10,22 @@ Libnetfilter_queue (the netfilter library, not this module) is part of the `Netf
 Example
 =======
 
-Coming soon...
+The following script prints a short description of each packet before accepting it::
+
+    from netfilterqueue import NetfilterQueue
+    
+    class PacketPrinter(NetfilterQueue):
+        def handle(self, packet):
+            print packet
+            packet.accept()
+    
+    p = PacketPrinter()
+    p.bind(1)
+    p.run()
+
+To send packets destined for your LAN to the script, type something like::
+
+    iptables -I INPUT -d 192.168.0.0/24 -j NFQUEUE --queue-num 1
 
 Installation
 ============
@@ -46,20 +61,53 @@ To install from source::
 
 Setup will use Cython if it is installed, regenerating the .c source from the .pyx before compiling the .so.
 
+API
+===
+
+Coming soon...
+
 Usage
 =====
 
-Coming soon...
+To route packets to the queue::
 
-Now route packets to the queue::
+    iptables -I <table or chain> <match specification> -j NFQUEUE --queue-num <queue number>
+    
+For example::
 
-    # iptables -I INPUT -p tcp --dport 80 -j NFQUEUE --queue-num 1
+    iptables -I INPUT -d 192.168.0.0/24 -j NFQUEUE --queue-num 1
     
 The only special part of the rule is the target. Rules can have any match and 
 can be added to any table or chain.
 
 Valid queue numbers are integers from 0 to 65,536 inclusive.
 
+To view libnetfilter_queue stats, refer to /proc/net/netfilter/nfnetlink_queue::
+
+    cat /proc/net/netfilter/nfnetlink_queue
+    1  31621     0 2  4016     0     0        2  1
+
+The fields are:
+
+1. Queue ID
+
+2. Bound process ID
+
+3. Number of currently queued packets
+
+4. Copy mode
+
+5. Copy size
+
+6. Number of packets dropped due to reaching max queue size
+
+7. Number of packets dropped due to netlink socket failure
+
+8. Total number of packets sent to queue
+
+9. Libnetfilter_queue internal use
+
+
 Limitations
 ===========