- NetBSD Manual Pages
BLACKLISTD(8) NetBSD System Manager's Manual BLACKLISTD(8)
Powered by man-cgi (2021-06-01).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.
blacklistd -- block and release ports on demand to avoid DoS abuse
blacklistd [-dfrv] [-C controlprog] [-c configfile] [-D dbfile]
[-P sockpathsfile] [-R rulename] [-s sockpath] [-t timeout]
blacklistd is a daemon similar to syslogd(8) that listens to sockets at
paths specified in the sockpathsfile for notifications from other daemons
about successful or failed connection attempts. If no such file is spec-
ified, then it only listens to the socket path specified by sockspath or
if that is not specified to /var/run/blacklistd.sock. Each notification
contains an (action, port, protocol, address, owner) tuple that identi-
fies the remote connection and the action. This tuple is consulted
against entries in configfile with syntax specified in
blacklistd.conf(5). If an entry is matched, a state entry is created for
that tuple. Each entry contains a number of tries limit and a duration.
If the action is ``add'' and the number of tries limit is reached, then a
control script controlprog is invoked with arguments:
control add <rulename> <proto> <address> <mask> <port>
and should invoke a packet filter command to block the connection speci-
fied by the arguments. The rulename argument can be set from the command
line (default blacklistd). The script could print a numerical id to std-
out as a handle for the rule that can be used later to remove that con-
nection, but that is not required as all information to remove the rule
If the action is ``remove'' Then the same control script is invoked as:
control remove <rulename> <proto> <address> <mask> <port> <id>
where id is the number returned from the ``add'' action.
blacklistd maintains a database of known connections in dbfile. On
startup it reads entries from that file, and updates its internal state.
blacklistd checks the list of active entries every timeout seconds
(default 15) and removes entries and block rules using the control pro-
gram as necessary.
The following options are available:
Use controlprog to communicate with the packet filter, usually
/libexec/blacklistd-helper. The following arguments are passed
to the control program:
action The action to perform: add, rem, or flush to add,
remove or flush a firewall rule.
name The rule name.
protocol The optional protocol name (can be empty): tcp, tcp6,
address The IPv4 or IPv6 numeric address to be blocked or
mask The numeric mask to be applied to the blocked or
port The optional numeric port to be blocked (can be empty).
id For packet filters that support removal of rules by
rule identifier, the identifier of the rule to be
removed. The add command is expected to return the
rule identifier string to stdout.
The name of the configuration file to read, usually
The Berkeley DB file where blacklistd stores its state, usually
-d Normally, blacklistd disassociates itself from the terminal
unless the -d flag is specified, in which case it stays in the
-f Truncate the state database and flush all the rules named
rulename are deleted by invoking the control script as:
control flush <rulename>
A file containing a list of pathnames, one per line that
blacklistd will create sockets to listen to. This is useful for
Specify the default rule name for the packet filter rules, usu-
-r Re-read the firewall rules from the internal database, then
remove and re-add them. This helps for packet filters that don't
retain state across reboots.
Add sockpath to the list of Unix sockets blacklistd listens to.
The interval in seconds blacklistd polls the state file to update
-v Cause blacklistd to print diagnostic messages to stdout instead
/libexec/blacklistd-helper Shell script invoked to interface with the
/etc/blacklistd.conf Configuration file.
/var/db/blacklistd.db Database of current connection entries.
/var/run/blacklistd.sock Socket to receive connection notifications.
blacklistd.conf(5), blacklistctl(8), npfctl(8), syslogd(8)
blacklistd first appeared in NetBSD 7. FreeBSD support for blacklistd
was implemented in FreeBSD 11.
NetBSD 9.2 June 7, 2016 NetBSD 9.2