.\" Created Fri April 20 12:15:07 CEST 2007 by sloter <contact me at sourceforge.net> .\" .\" This documentation is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" .\" This documentation is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License with .\" the Debian GNU/Linux distribution in file /usr/share/common-licenses/GPL; .\" if not, write to the Free Software Foundation, Inc., 59 Temple Place, .\" Suite 330, Boston, MA 02111-1307 USA .\" .\" On Debian systems, the complete text of the GNU General Public .\" License, version 2, can be found in /usr/share/common-licenses/GPL-2. .\" .TH MOBLOCK 1 "20 April 2007" "Version 0.8\-15\-beta" "MoBlock Manual" .SH NAME moblock \- a linux console IP blocker to protect your privacy. .SH SYNOPSIS .B moblock [ .B "\-dnp" .I blocklist file ] [ .B "\-q" .I value ] .I log file .SH DESCRIPTION .B Moblock is an open source IP filter designed to block the IP addresses of certain organizations and corporations that may wish to harm a users privacy while using the Internet and peer-to-peer networks. .B Moblock blocks IP addresses defined in .I blocklist file and based upon a list of IP addresses collected by many methods. .B Moblock supports and uses the new kernel interface NFQUEUE added since linux kernel 2.6.14. .SH OPTIONS .TP .BI "\-d" " blocklist file" Specify the list of blocked IP when it is in an ipfilter.dat type. .TP .BI "\-n" " blocklist file" Specify the list of blocked IP when it is in a peerguardian 2.x '.p2b' type. .TP .BI "\-p" " blocklist file" Specify the list of blocked IP when it is in a peerguardian '.p2p' type. .TP .BI "\-q" " value" Specify the QUEUE number to use. Valud queue numbers are 0 to 65535. The default is 0. As defined with --queue-num in .BR iptables (8). .LP .SH SIGNALS .B Moblock reacts to a set of signals. You may easily send a signal to it using the following: .IP .nf kill -SIGNAL `cat /var/run/moblock.pid` .fi .PP .TP .B SIGHUP This lets .B moblock perform a re-initialization. Dumps and resets stats then reloads .IR "blocklist file" . .TP .B SIGTERM The .B moblogd will die. .TP .B SIGUSR1 This lets .B moblock dump the stats. .TP .B SIGUSR2 This lets .B moblock dump the stats to .IR /var/log/MoBlock.stats . .LP .SH NOTES This is a preliminary manpage. Expect some glitches... There are two versions of moblock, each in their own package. They are called moblock-ipq and moblock-nfq, indicating the library they were compiled against. .LP .SH FILES .PD 0 .TP .IR "/etc/init.d/moblock-nfq" " {MAY BECOME moblockd instead of moblock-nfq}" The .B moblock daemon script. .TP .IR "/etc/cron.daily/moblock-nfq" " {MAY BECOME moblockd instead of moblock-nfq}" The script that updates the .IR "blocklist file" . The script also include the configuration informations to updtes the list. .TP .I /etc/moblock/guarding.p2p The default master blocklist. Based on the merge of the downloaded single blocklists defined in .IR "/etc/cron.daily/moblock-nfq" "{MAY BECOME moblockd instead of moblock-nfq}" .TP .I /etc/moblock/MoBloq-nfq.sh Start script loads the iptables rules. .TP .I /var/run/moblock.pid The file containing the process id of .BR moblock . .TP .I /var/log/moblock.log The default log file of the daemon .BR moblock . This file contains the blocked IPs, the errors messages and other things about starting/stopping and updating .BR moblock . .PD .SH REPORTING BUGS Report bugs and patches to clessing@users.sourceforge.net .LP .SH SEE ALSO .BR iptables (8).