mirror of
https://github.com/fail2ban/fail2ban.git
synced 2026-03-11 08:55:31 +00:00
ebd89ec077
ignorecommand update man and fix protocol help ENH: run ignore command only after internal list has been examined. Change interface on ignorecommand to take IP as environment variable and return true if it is to be banned ENH: ignore IP command to take tagged command DOC: man pages for ingorecommand TST: add test cases for ignorecommand
283 lines
5.9 KiB
Groff
283 lines
5.9 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.40.4.
|
|
.TH FAIL2BAN-CLIENT "1" "November 2013" "fail2ban-client v0.8.11" "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.8.11 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\-p\fR <FILE>
|
|
pidfile 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 (remove socket file)
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
display this help message
|
|
.TP
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
print the version
|
|
.SH COMMAND
|
|
.IP
|
|
BASIC
|
|
.TP
|
|
\fBstart\fR
|
|
starts the server and the jails
|
|
.TP
|
|
\fBreload\fR
|
|
reloads the configuration
|
|
.TP
|
|
\fBreload <JAIL>\fR
|
|
reloads the jail <JAIL>
|
|
.TP
|
|
\fBstop\fR
|
|
stops all jails and terminate the
|
|
server
|
|
.TP
|
|
\fBstatus\fR
|
|
gets the current status of the
|
|
server
|
|
.TP
|
|
\fBping\fR
|
|
tests if the server is alive
|
|
.TP
|
|
\fBhelp\fR
|
|
return this output
|
|
.IP
|
|
LOGGING
|
|
.TP
|
|
\fBset loglevel <LEVEL>\fR
|
|
sets logging level to <LEVEL>. 0
|
|
is minimal, 4 is debug
|
|
.TP
|
|
\fBget loglevel\fR
|
|
gets the logging level
|
|
.TP
|
|
\fBset logtarget <TARGET>\fR
|
|
sets logging target to <TARGET>.
|
|
Can be STDOUT, STDERR, SYSLOG or a
|
|
file
|
|
.TP
|
|
\fBget logtarget\fR
|
|
gets logging target
|
|
.IP
|
|
JAIL CONTROL
|
|
.TP
|
|
\fBadd <JAIL> <BACKEND>\fR
|
|
creates <JAIL> using <BACKEND>
|
|
.TP
|
|
\fBstart <JAIL>\fR
|
|
starts the jail <JAIL>
|
|
.TP
|
|
\fBstop <JAIL>\fR
|
|
stops the jail <JAIL>. The jail is
|
|
removed
|
|
.TP
|
|
\fBstatus <JAIL>\fR
|
|
gets the current status of <JAIL>
|
|
.IP
|
|
JAIL CONFIGURATION
|
|
.TP
|
|
\fBset <JAIL> idle on|off\fR
|
|
sets the idle state of <JAIL>
|
|
.TP
|
|
\fBset <JAIL> addignoreip <IP>\fR
|
|
adds <IP> to the ignore list of
|
|
<JAIL>
|
|
.TP
|
|
\fBset <JAIL> delignoreip <IP>\fR
|
|
removes <IP> from the ignore list
|
|
of <JAIL>
|
|
.TP
|
|
\fBset <JAIL> addlogpath <FILE>\fR
|
|
adds <FILE> to the monitoring list
|
|
of <JAIL>
|
|
.TP
|
|
\fBset <JAIL> dellogpath <FILE>\fR
|
|
removes <FILE> from the monitoring
|
|
list of <JAIL>
|
|
.TP
|
|
\fBset <JAIL> addfailregex <REGEX>\fR
|
|
adds the regular expression
|
|
<REGEX> which must match failures
|
|
for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> delfailregex <INDEX>\fR
|
|
removes the regular expression at
|
|
<INDEX> for failregex
|
|
.TP
|
|
\fBset <JAIL> ignorecommand <VALUE>\fR
|
|
sets ignorecommand of <JAIL>
|
|
.TP
|
|
\fBset <JAIL> addignoreregex <REGEX>\fR
|
|
adds the regular expression
|
|
<REGEX> which should match pattern
|
|
to exclude for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> delignoreregex <INDEX>\fR
|
|
removes the regular expression at
|
|
<INDEX> for ignoreregex
|
|
.TP
|
|
\fBset <JAIL> findtime <TIME>\fR
|
|
sets the number of seconds <TIME>
|
|
for which the filter will look
|
|
back for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> bantime <TIME>\fR
|
|
sets the number of seconds <TIME>
|
|
a host will be banned for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> usedns <VALUE>\fR
|
|
sets the usedns mode for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> banip <IP>\fR
|
|
manually Ban <IP> for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> unbanip <IP>\fR
|
|
manually Unban <IP> in <JAIL>
|
|
.TP
|
|
\fBset <JAIL> maxretry <RETRY>\fR
|
|
sets the number of failures
|
|
<RETRY> before banning the host
|
|
for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> addaction <ACT>\fR
|
|
adds a new action named <NAME> for
|
|
<JAIL>
|
|
.TP
|
|
\fBset <JAIL> delaction <ACT>\fR
|
|
removes the action <NAME> from
|
|
<JAIL>
|
|
.TP
|
|
\fBset <JAIL> setcinfo <ACT> <KEY> <VALUE>\fR
|
|
sets <VALUE> for <KEY> of the
|
|
action <NAME> for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> delcinfo <ACT> <KEY>\fR
|
|
removes <KEY> for the action
|
|
<NAME> for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> actionstart <ACT> <CMD>\fR
|
|
sets the start command <CMD> of
|
|
the action <ACT> for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> actionstop <ACT> <CMD>\fR
|
|
sets the stop command <CMD> of the
|
|
action <ACT> for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> actioncheck <ACT> <CMD>\fR
|
|
sets the check command <CMD> of
|
|
the action <ACT> for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> actionban <ACT> <CMD>\fR
|
|
sets the ban command <CMD> of the
|
|
action <ACT> for <JAIL>
|
|
.TP
|
|
\fBset <JAIL> actionunban <ACT> <CMD>\fR
|
|
sets the unban command <CMD> of
|
|
the action <ACT> for <JAIL>
|
|
.IP
|
|
JAIL INFORMATION
|
|
.TP
|
|
\fBget <JAIL> logpath\fR
|
|
gets the list of the monitored
|
|
files for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> ignoreip\fR
|
|
gets the list of ignored IP
|
|
addresses for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> ignorecommand\fR
|
|
gets ignorecommand of <JAIL>
|
|
.TP
|
|
\fBget <JAIL> failregex\fR
|
|
gets the list of regular
|
|
expressions which matches the
|
|
failures for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> ignoreregex\fR
|
|
gets the list of regular
|
|
expressions which matches patterns
|
|
to ignore for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> findtime\fR
|
|
gets the time for which the filter
|
|
will look back for failures for
|
|
<JAIL>
|
|
.TP
|
|
\fBget <JAIL> bantime\fR
|
|
gets the time a host is banned for
|
|
<JAIL>
|
|
.TP
|
|
\fBget <JAIL> usedns\fR
|
|
gets the usedns setting for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> maxretry\fR
|
|
gets the number of failures
|
|
allowed for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> addaction\fR
|
|
gets the last action which has
|
|
been added for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> actionstart <ACT>\fR
|
|
gets the start command for the
|
|
action <ACT> for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> actionstop <ACT>\fR
|
|
gets the stop command for the
|
|
action <ACT> for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> actioncheck <ACT>\fR
|
|
gets the check command for the
|
|
action <ACT> for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> actionban <ACT>\fR
|
|
gets the ban command for the
|
|
action <ACT> for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> actionunban <ACT>\fR
|
|
gets the unban command for the
|
|
action <ACT> for <JAIL>
|
|
.TP
|
|
\fBget <JAIL> cinfo <ACT> <KEY>\fR
|
|
gets the value for <KEY> for the
|
|
action <ACT> for <JAIL>
|
|
.SH FILES
|
|
\fI/etc/fail2ban/*\fR
|
|
.SH AUTHOR
|
|
Written by Cyril Jaquier <cyril.jaquier@fail2ban.org>.
|
|
Many contributions by Yaroslav O. Halchenko <debian@onerussian.com>.
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to https://github.com/fail2ban/fail2ban/issues
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2004\-2008 Cyril Jaquier, 2008\- Fail2Ban Contributors
|
|
.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)
|
|
jail.conf(5)
|