|
|
|
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36.
|
|
|
|
|
.TH FAIL2BAN-CLIENT "1" "November 2006" "fail2ban-client v0.7.4-SVN" "User Commands"
|
|
|
|
|
.SH NAME
|
|
|
|
|
fail2ban-client \- configure and control the server
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B fail2ban-client
|
|
|
|
|
[\fIOPTIONS\fR]... \fI<COMMAND>\fR
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
Fail2Ban v0.7.4\-SVN reads log file that contains password failure report
|
|
|
|
|
and bans the corresponding IP addresses using firewall rules.
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-c\fR <DIR>
|
|
|
|
|
configuration directory
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-s\fR <FILE>
|
|
|
|
|
socket path
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-d\fR
|
|
|
|
|
dump configuration. For debugging
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-i\fR
|
|
|
|
|
interactive mode
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-v\fR
|
|
|
|
|
increase verbosity
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-q\fR
|
|
|
|
|
decrease verbosity
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-x\fR
|
|
|
|
|
force execution of the server
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
|
|
|
display this help message
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
|
|
|
print the version
|
|
|
|
|
.SH COMMAND
|
|
|
|
|
.TP
|
|
|
|
|
start
|
|
|
|
|
starts the server and the jails
|
|
|
|
|
.TP
|
|
|
|
|
reload
|
|
|
|
|
reloads the configuration
|
|
|
|
|
.TP
|
|
|
|
|
stop
|
|
|
|
|
stops all jails and terminate the
|
|
|
|
|
server
|
|
|
|
|
.TP
|
|
|
|
|
status
|
|
|
|
|
gets the current status of the
|
|
|
|
|
server
|
|
|
|
|
.TP
|
|
|
|
|
ping
|
|
|
|
|
tests if the server is alive
|
|
|
|
|
.TP
|
|
|
|
|
set loglevel <LEVEL>
|
|
|
|
|
sets logging level to <LEVEL>. 0
|
|
|
|
|
is minimal, 4 is debug
|
|
|
|
|
.TP
|
|
|
|
|
get loglevel
|
|
|
|
|
gets the logging level
|
|
|
|
|
.TP
|
|
|
|
|
set logtarget <TARGET>
|
|
|
|
|
sets logging target to <TARGET>.
|
|
|
|
|
Can be STDOUT, STDERR, SYSLOG or a
|
|
|
|
|
file
|
|
|
|
|
.TP
|
|
|
|
|
get logtarget
|
|
|
|
|
gets logging target
|
|
|
|
|
.TP
|
|
|
|
|
add <JAIL> <BACKEND>
|
|
|
|
|
creates <JAIL> using <BACKEND>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> idle on|off
|
|
|
|
|
sets the idle state of <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> addignoreip <IP>
|
|
|
|
|
adds <IP> to the ignore list of
|
|
|
|
|
<JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> delignoreip <IP>
|
|
|
|
|
removes <IP> from the ignore list
|
|
|
|
|
of <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> addlogpath <FILE>
|
|
|
|
|
adds <FILE> to the monitoring list
|
|
|
|
|
of <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> dellogpath <FILE>
|
|
|
|
|
removes <FILE> to the monitoring
|
|
|
|
|
list of <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> timeregex <REGEX>
|
|
|
|
|
sets the regular expression
|
|
|
|
|
<REGEX> to match the date format
|
|
|
|
|
for <JAIL>. This will disable the
|
|
|
|
|
autodetection feature.
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> timepattern <PATTERN>
|
|
|
|
|
sets the pattern <PATTERN> to
|
|
|
|
|
match the date format for <JAIL>.
|
|
|
|
|
This will disable the
|
|
|
|
|
autodetection feature.
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> failregex <REGEX>
|
|
|
|
|
sets the regular expression
|
|
|
|
|
<REGEX> which must match failures
|
|
|
|
|
for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> ignoreregex <REGEX>
|
|
|
|
|
sets the regular expression
|
|
|
|
|
<REGEX> which should match pattern
|
|
|
|
|
to exclude for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> maxtime <TIME>
|
|
|
|
|
sets the number of seconds <TIME>
|
|
|
|
|
a failure stay in the list for
|
|
|
|
|
<JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> findtime <TIME>
|
|
|
|
|
sets the number of seconds <TIME>
|
|
|
|
|
for which the filter will look
|
|
|
|
|
back for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> bantime <TIME>
|
|
|
|
|
sets the number of seconds <TIME>
|
|
|
|
|
a host will be banned for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> maxretry <RETRY>
|
|
|
|
|
sets the number of failures
|
|
|
|
|
<RETRY> before banning the host
|
|
|
|
|
for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> addaction <ACT>
|
|
|
|
|
adds a new action named <NAME> for
|
|
|
|
|
<JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> delaction <ACT>
|
|
|
|
|
removes the action <NAME> from
|
|
|
|
|
<JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> setcinfo <ACT> <KEY> <VALUE>
|
|
|
|
|
sets <VALUE> for <KEY> of the
|
|
|
|
|
action <NAME> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> delcinfo <ACT> <KEY>
|
|
|
|
|
removes <KEY> for the action
|
|
|
|
|
<NAME> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> actionstart <ACT> <CMD>
|
|
|
|
|
sets the start command <CMD> of
|
|
|
|
|
the action <ACT> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> actionstop <ACT> <CMD>
|
|
|
|
|
sets the stop command <CMD> of the
|
|
|
|
|
action <ACT> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> actioncheck <ACT> <CMD>
|
|
|
|
|
sets the check command <CMD> of
|
|
|
|
|
the action <ACT> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> actionban <ACT> <CMD>
|
|
|
|
|
sets the ban command <CMD> of the
|
|
|
|
|
action <ACT> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
set <JAIL> actionunban <ACT> <CMD>
|
|
|
|
|
sets the unban command <CMD> of
|
|
|
|
|
the action <ACT> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> <CMD>
|
|
|
|
|
gets the <CMD> value for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> logpath
|
|
|
|
|
gets the list of the monitored
|
|
|
|
|
files for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> ignoreip
|
|
|
|
|
gets the list of ignored IP
|
|
|
|
|
addresses for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> timeregex
|
|
|
|
|
gets the regular expression used
|
|
|
|
|
for the time detection for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> timepattern
|
|
|
|
|
gets the pattern used for the time
|
|
|
|
|
detection for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> failregex
|
|
|
|
|
gets the regular expression which
|
|
|
|
|
matches the failures for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> ignoreregex
|
|
|
|
|
gets the regular expression which
|
|
|
|
|
matches patterns to ignore for
|
|
|
|
|
<JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> maxtime
|
|
|
|
|
gets the time a failure stays in
|
|
|
|
|
the list for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> findtime
|
|
|
|
|
gets the time for which the filter
|
|
|
|
|
will look back for failures for
|
|
|
|
|
<JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> bantime
|
|
|
|
|
gets the time a host is banned for
|
|
|
|
|
<JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> maxretry
|
|
|
|
|
gets the number of failures
|
|
|
|
|
allowed for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> addaction
|
|
|
|
|
gets the last action which has
|
|
|
|
|
been added for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> actionstart <ACT>
|
|
|
|
|
gets the start command for the
|
|
|
|
|
action <ACT> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> actionstop <ACT>
|
|
|
|
|
gets the stop command for the
|
|
|
|
|
action <ACT> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> actioncheck <ACT>
|
|
|
|
|
gets the check command for the
|
|
|
|
|
action <ACT> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> actionban <ACT>
|
|
|
|
|
gets the ban command for the
|
|
|
|
|
action <ACT> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
get <JAIL> actionunban <ACT>
|
|
|
|
|
gets the unban command for the
|
|
|
|
|
action <ACT> for <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
start <JAIL>
|
|
|
|
|
starts the jail <JAIL>
|
|
|
|
|
.TP
|
|
|
|
|
stop <JAIL>
|
|
|
|
|
stops the jail <JAIL>. The jail is
|
|
|
|
|
removed
|
|
|
|
|
.TP
|
|
|
|
|
status <JAIL>
|
|
|
|
|
gets the current status of <JAIL>
|
|
|
|
|
.SH FILES
|
|
|
|
|
\fI/etc/fail2ban/*\fR
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
Written by Cyril Jaquier <lostcontrol@users.sourceforge.net>.
|
|
|
|
|
Many contributions by Yaroslav O. Halchenko <debian@onerussian.com>.
|
|
|
|
|
.SH "REPORTING BUGS"
|
|
|
|
|
Report bugs to <lostcontrol@users.sourceforge.net>
|
|
|
|
|
.SH COPYRIGHT
|
|
|
|
|
Copyright \(co 2004-2006 Cyril Jaquier
|
|
|
|
|
.br
|
|
|
|
|
Copyright of modifications held by their respective authors.
|
|
|
|
|
Licensed under the GNU General Public License v2 (GPL).
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.br
|
|
|
|
|
fail2ban-server(1)
|
