# FAIL2BAN-REGEX(1) - man - phpman

[FAIL2BAN-REGEX(1)](https://www.chedong.com/phpMan.php/man/FAIL2BAN-REGEX/1/markdown)                           User Commands                          [FAIL2BAN-REGEX(1)](https://www.chedong.com/phpMan.php/man/FAIL2BAN-REGEX/1/markdown)



## NAME
       fail2ban-regex - test Fail2ban "failregex" option

## SYNOPSIS
       **fail2ban-regex** [_OPTIONS_] _<LOG>_ _<REGEX>_ [_IGNOREREGEX_]

## DESCRIPTION
       Fail2Ban   reads log file that contains password failure report and bans the corresponding IP
       addresses using firewall rules.

       This tools can test regular expressions for "fail2ban".

### LOG:
       string a string representing a log line

       filename
              path to a log file (_/var/log/auth.log_)

       systemd-journal
              search systemd journal (systemd-python required), optionally with backend  parameters,
              see `man jail.conf` for usage and examples (systemd-journal[journalflags=1]).

### REGEX:
       string a string representing a 'failregex'

       filter name of filter, optionally with options (sshd[mode=aggressive])

       filename
              path to a filter file (filter.d/sshd.conf)

### IGNOREREGEX:
       string a string representing an 'ignoreregex'

       filename
              path to a filter file (filter.d/sshd.conf)

## OPTIONS
### --version
              show program's version number and exit

### -h --help
              show this help message and exit

### -c --config
              set alternate config directory

### -d --datepattern
              set custom pattern used to match date/times

       **--timezone**=_TIMEZONE_, **--TZ**=_TIMEZONE_
              set time-zone used by convert time format

### -e --encoding
              File encoding. Default: system locale

### -r --raw
              Raw hosts, don't resolve dns

       **--usedns**=_USEDNS_
              DNS specified replacement of tags <HOST> in regexp ('yes' - matches all form of hosts,
              'no' - IP addresses only)

### -L --maxlines
              maxlines for multi-line regex.

### -m --journalmatch
              journalctl style matches overriding filter file.  "systemd-journal" only

### -l --log-level
              Log level for the Fail2Ban logger to use

### -V

### -v --verbose
              Increase verbosity

       **--verbosity**=_VERBOSE_
              Set numerical level of verbosity (0..4)

       **--verbose-date**, **--VD**
              Verbose date patterns/regex in output

### -D --debuggex
              Produce debuggex.com urls for debugging there

### --no-check-all
              Disable check for all regex's

### -o --out
              Set token to print failure information only (row, id, ip, msg, host,  ip4,  ip6,  dns,
              matches, ...)

### --print-no-missed
              Do not print any missed lines

### --print-no-ignored
              Do not print any ignored lines

### --print-all-matched
              Print all matched lines

### --print-all-missed
              Print all missed lines, no matter how many

### --print-all-ignored
              Print all ignored lines, no matter how many

### -t --log-traceback
              Enrich log-messages with compressed tracebacks

### --full-traceback
              Either to make the tracebacks full, not compressed (as by default)

## AUTHOR
       Written  by  Cyril  Jaquier  <<cyril.jaquier@fail2ban.org>>.  Many contributions by Yaroslav O.
       Halchenko, Steven Hiscocks, Sergey G. Brester (sebres).

## REPORTING BUGS
       Report bugs to <https://github.com/fail2ban/fail2ban/issues>

## COPYRIGHT
       Copyright © 2004-2008 Cyril Jaquier, 2008- Fail2Ban Contributors
       Copyright of modifications held by their respective authors.  Licensed under the GNU  General
       Public License v2 (GPL).

## SEE ALSO
       [fail2ban-client(1)](https://www.chedong.com/phpMan.php/man/fail2ban-client/1/markdown) [fail2ban-server(1)](https://www.chedong.com/phpMan.php/man/fail2ban-server/1/markdown) [jail.conf(5)](https://www.chedong.com/phpMan.php/man/jail.conf/5/markdown)



fail2ban-regex 0.11.2                       November 2020                          [FAIL2BAN-REGEX(1)](https://www.chedong.com/phpMan.php/man/FAIL2BAN-REGEX/1/markdown)