west-chamber for Debian
-----------------------

= Install =

There are 2 ways to install west-chamber. By DKMS or by module-assistant.

== DKMS ==
 # execute the following command:
 sudo apt-get install west-chamber-dkms west-chamber-common

== module-assistant ==
 # execute the following commands:
 sudo apt-get install west-chamber-source west-chamber-common
 sudo m-a auto-install xtables-addons
 sudo m-a auto-install west-chamber


= Quick Usage =
 # execute the following commands:
 sudo ipset -R < /usr/share/doc/west-chamber-common/examples/ipsets/YOUTUBE
 sudo ipset -R < /usr/share/doc/west-chamber-common/examples/ipsets/GOOGLE
 sudo ipset -R < /usr/share/doc/west-chamber-common/examples/ipsets/NOCLIP
 sudo iptables -A INPUT -p tcp --sport 80 --tcp-flags \
   FIN,SYN,RST,ACK SYN,ACK -m state --state ESTABLISHED \
   -m set --match-set NOCLIP src -j ZHANG
 sudo iptables -A INPUT -p tcp --sport 80 -m state --state \
   ESTABLISHED -m gfw -j LOG --log-level info --log-prefix "gfw: "
 sudo iptables -A INPUT -p udp --sport 53 -m state --state \
   ESTABLISHED -m gfw -j DROP
 # enjoy

= About module-assistant package =

Please see ./README for a description of the west-chamber software.

The Debian west-chamber source package provides two packages,

 1) west-chamber-common, which the provides the userspace addons for xtables
 2) west-chamber-source, which provides the source for the kernel modules

The west-chamber-source package can be used in several ways,

 - Using the module-assistant command provided by module-assistant package in
   Debian. This will produce a corresponding west-chamber-modules package for
   the Debian kernel-image package that you are using very quickly.

 - Using the make-kpkg(1) command provided by the kernel-package Debian
   package. This will produce a corresponding west-chamber-modules package for
   the Debian kernel-image package that you are using. This is "the Debian
   way". See the "modules_image" section of the make-kpkg(1) man page.

 - Changing to the /usr/src/modules/west-chamber/ directory and building as
   the README file instructs using "make; make install". This will build
   and install a module specific to the system you are building on and is
   not under control of the packaging system.

= More Info =

 * http://code.google.com/p/scholarzhang/wiki/USAGE

 -- Ying-Chun Liu (PaulLiu) <paulliu@debian.org>, Fri, 16 Dec 2011 02:37:20 +0800
