PHREL v2.1.0 (07/05/26) - http://www.digitalgenesis.com

  Copyright (C) 2004-2026 Digital Genesis, LLC. All rights reserved.

  This program 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 program 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 <http://www.gnu.org/copyleft/gpl.html>
  for more details.

  You should have received a copy of the GNU General Public License along
  with this program; if not, write to the Free Software Foundation, Inc.,
  51 Franklin Street, Fifth Floor, Boston, MA 021.0.2301 USA.

Maintainer:

  Digital Genesis <sella@digitalgenesis.com>
  http://www.digitalgenesis.com

Software Requirements: 

  Building:

     GNU make          (Tested with 3.79.1, 4.x)
     GNU gcc           (Tested with 4.x through 14.x)
     autoconf          (2.69 or newer)
     automake          (1.16 or newer)
     libpcap           (Tested with 1.10)

  Building (additional):

     libnftables       (Tested with 1.0.x; requires a nf_tables-backed kernel)
     hiredis           (Tested with 1.2.x; linked automatically when installed)

  Using:

     nftables          (RHEL 8+, Ubuntu 22.04+ or any distro with nf_tables as
                        the default firewall backend)

Description:

  PHREL is a Per Host RatE Limiter. It will track the rate of incoming traffic
  to a server and insert rules into a dedicated nftables table when a
  configured threshold is crossed. The inserted rules may either rate limit
  or block the offending host for a period of time.

Breaking Changes in v2.0.0:

  The configuration file format has changed completely.
  Cross instance syncing now requires Redis rather than MySQL.
  Requires nftables 1.0 support.
  SNMPTrap support has been dropped.

  See phreld.conf(5) and the installed example at /etc/phrel/phreld.conf
  for the full schema.

Performance in v2.1.0:

  Striped hash locks, batched packet reads, incremental rolling PPS sums,
  and compact per-host data structures improve throughput on busy servers.
  The jump configuration/CLI option was renamed to action.

Documentation:

  HTML documentation is installed under $(datadir)/docs/phrel/, including
  phrel-dns-article.html and phrel-architecture.html.

Installation:

  See the INSTALL file for installation instructions.

Packaging:

  Release .deb and .rpm packages can be built with Docker via make
  <distro>-pkg or make all-pkg. Artifacts are written under
  packages/<distro>/ in the source tree.

Credits:

  James M. Sella/Digital Genesis - Code and documentation.

Fini
