Index: head/contrib/blacklist/bin/blacklistctl.8
===================================================================
--- head/contrib/blacklist/bin/blacklistctl.8	(revision 301551)
+++ head/contrib/blacklist/bin/blacklistctl.8	(revision 301552)
@@ -1,81 +1,85 @@
 .\" $NetBSD: blacklistctl.8,v 1.7 2015/04/30 06:20:43 riz Exp $
 .\"
 .\" Copyright (c) 2015 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" This code is derived from software contributed to The NetBSD Foundation
 .\" by Christos Zoulas.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
 .Dd April 29, 2015
 .Dt BLACKLISTCTL 8
 .Os
 .Sh NAME
 .Nm blacklistctl
 .Nd display and change the state of blacklistd
 .Sh SYNOPSIS
 .Nm
 .Cm dump
 .Op Fl abdnrw
 .Sh DESCRIPTION
 .Nm
 is a program used to display the state of
 .Xr blacklistd 8
 .Pp
 The following options are available:
 .Bl -tag -width indent
 .It Fl a
 Show all database entries, by default it shows only the embryonic ones.
 .It Fl b
 Show only the blocked entries.
 .It Fl d
 Increase debugging level.
 .It Fl n
 Don't display a header.
 .It Fl r
 Show the remaining blocked time instead of the last activity time.
 .It Fl w
 Normally the width of addresses is good for IPv4, the
 .Fl w
 flag, makes the display wide enough for IPv6 addresses.
 .El
 .Sh SEE ALSO
 .Xr blacklistd 8
 .Sh NOTES
 Sometimes the reported number of failed attempts can exceed the number
 of attempts that
 .Xr blacklistd 8
 is configured to block.
 This can happen either because the rule has been removed manually, or
 because there were more attempts in flight while the rule block was being
 added.
 This condition is normal; in that case
 .Xr blacklistd 8
 will first attempt to remove the existing rule, and then it will re-add
 it to make sure that there is only one rule active.
 .Sh HISTORY
 .Nm
-appeared in
+first appeared in
 .Nx 7 .
+.Fx support for
+.Nm
+was implemented in
+.Fx 11 .
 .Sh AUTHORS
 .An Christos Zoulas
Index: head/contrib/blacklist/bin/blacklistd.8
===================================================================
--- head/contrib/blacklist/bin/blacklistd.8	(revision 301551)
+++ head/contrib/blacklist/bin/blacklistd.8	(revision 301552)
@@ -1,222 +1,226 @@
 .\" $NetBSD: blacklistd.8,v 1.15 2016/03/11 17:16:40 christos Exp $
 .\"
 .\" Copyright (c) 2015 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" This code is derived from software contributed to The NetBSD Foundation
 .\" by Christos Zoulas.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
 .Dd June 4, 2015
 .Dt BLACKLISTD 8
 .Os
 .Sh NAME
 .Nm blacklistd
 .Nd block and release ports on demand to avoid DoS abuse
 .Sh SYNOPSIS
 .Nm
 .Op Fl dfrv
 .Op Fl C Ar controlprog
 .Op Fl c Ar configfile
 .Op Fl D Ar dbfile
 .Op Fl P Ar sockpathsfile
 .Op Fl R Ar rulename
 .Op Fl s Ar sockpath
 .Op Fl t Ar timeout
 .Sh DESCRIPTION
 .Nm
 is a daemon similar to
 .Xr syslogd 8
 that listens to a sockets at paths specified in the
 .Ar sockpathsfile
 for notifications from other daemons about successful or failed connection
 attempts.
 If no such file is specified, then it only listens to the socket path
 specified by
 .Ar sockspath
 or if that is not specified to
 .Pa /var/run/blacklistd.sock .
 Each notification contains an (action, port, protocol, address, owner) tuple
 that identifies the remote connection and the action.
 This tuple is consulted against entries in
 .Ar configfile
 with syntax specified in
 .Xr 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.
 .Pp
 If the action is
 .Dq add
 and the number of tries limit is reached, then a
 control script
 .Ar controlprog
 is invoked with arguments:
 .Bd -literal -offset indent
 control add <rulename> <proto> <address> <mask> <port>
 .Ed
 .Pp
 and should invoke a packet filter command to block the connection
 specified by the arguments.
 The
 .Ar rulename
 argument can be set from the command line (default
 .Dv blacklistd ) .
 The script could print a numerical id to stdout as a handle for
 the rule that can be used later to remove that connection, but
 that is not required as all information to remove the rule is
 kept.
 .Pp
 If the action is
 .Dq remove
 Then the same control script is invoked as:
 .Bd -literal -offset indent
 control remove <rulename> <proto> <address> <mask> <port> <id>
 .Ed
 .Pp
 where
 .Ar id
 is the number returned from the
 .Dq add
 action.
 .Pp
 .Nm
 maintains a database of known connections in
 .Ar dbfile .
 On startup it reads entries from that file, and updates its internal state.
 .Pp
 .Nm
 checks the list of active entries every
 .Ar timeout
 seconds (default
 .Dv 15 )
 and removes entries and block rules using the control program as necessary.
 .Pp
 The following options are available:
 .Bl -tag -width indent
 .It Fl C Ar controlprog
 Use
 .Ar controlprog
 to communicate with the packet filter, usually
 .Pa /usr/libexec/blacklistd-helper .
 The following arguments are passed to the control program:
 .Bl -tag -width protocol
 .It action
 The action to perform:
 .Dv add ,
 .Dv rem ,
 or
 .Dv flush
 to add, remove or flush a firewall rule.
 .It name
 The rule name.
 .It protocol
 The optional protocol name (can be empty):
 .Dv tcp ,
 .Dv tcp6 ,
 .Dv udp ,
 .Dv udp6 .
 .It address
 The IPv4 or IPv6 numeric address to be blocked or released.
 .It mask
 The numeric mask to be applied to the blocked or released address
 .It port
 The optional numeric port to be blocked (can be empty).
 .It 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.
 .El
 .It Fl c Ar configuration
 The name of the configuration file to read, usually
 .Pa /etc/blacklistd.conf .
 .It Fl D Ar dbfile
 The Berkeley DB file where
 .Nm
 stores its state, usually
 .Pa /var/run/blacklistd.db .
 .It Fl d
 Normally,
 .Nm
 disassociates itself from the terminal unless the
 .Fl d
 flag is specified, in which case it stays in the foreground.
 .It Fl f
 Truncate the state database and flush all the rules named
 .Ar rulename
 are deleted by invoking the control script as:
 .Bd -literal -offset indent
 control flush <rulename>
 .Ed
 .It Fl P Ar sockspathsfile
 A file containing a list of pathnames, one per line that
 .Nm
 will create sockets to listen to.
 This is useful for chrooted environments.
 .It Fl R Ar rulename
 Specify the default rule name for the packet filter rules, usually
 .Dv blacklistd .
 .It Fl 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.
 .It Fl s Ar sockpath
 Add
 .Ar sockpath
 to the list of Unix sockets
 .Nm
 listens to.
 .It Fl t Ar timeout
 The interval in seconds
 .Nm
 polls the state file to update the rules.
 .It Fl v
 Cause
 .Nm
 to print
 diagnostic messages to
 .Dv stdout
 instead of
 .Xr syslogd 8 .
 .El
 .Sh FILES
 .Bl -tag -width /usr/libexec/blacklistd-helper -compact
 .It Pa /usr/libexec/blacklistd-helper
 Shell script invoked to interface with the packet filter.
 .It Pa /etc/blacklistd.conf
 Configuration file.
 .It Pa /var/db/blacklistd.db
 Database of current connection entries.
 .It Pa /var/run/blacklistd.sock
 Socket to receive connection notifications.
 .El
 .Sh SEE ALSO
 .Xr blacklistd.conf 5 ,
 .Xr blacklistctl 8 ,
 .Xr npfctl 8 ,
 .Xr syslogd 8
 .Sh HISTORY
 .Nm
-appeared in
+first appeared in
 .Nx 7 .
+.Fx support for
+.Nm
+was implemented in
+.Fx 11 .
 .Sh AUTHORS
 .An Christos Zoulas
Index: head/contrib/blacklist/bin/blacklistd.conf.5
===================================================================
--- head/contrib/blacklist/bin/blacklistd.conf.5	(revision 301551)
+++ head/contrib/blacklist/bin/blacklistd.conf.5	(revision 301552)
@@ -1,222 +1,226 @@
 .\" $NetBSD: blacklistd.conf.5,v 1.3 2015/04/30 06:20:43 riz Exp $
 .\"
 .\" Copyright (c) 2015 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" This code is derived from software contributed to The NetBSD Foundation
 .\" by Christos Zoulas.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
 .Dd April 29, 2015
 .Dt BLACKLISTD.CONF 5
 .Os
 .Sh NAME
 .Nm blacklistd.conf
 .Nd configuration file format for blacklistd
 .Sh DESCRIPTION
 The
 .Nm
 files contains configuration lines for
 .Xr blacklistd 8 .
 It contains one entry per line, and is similar to
 .Xr inetd.conf 5 .
 There must be an entry for each field of the configuration file, with
 entries for each field separated by a tab or a space.
 Comments are denoted by a
 .Dq #
 at the beginning of a line.
 .Pp
 There are two kinds of configuration lines,
 .Va local
 and
 .Va remote .
 By default, configuration lines are
 .Va local ,
 i.e. the address specified refers to the addresses on the local machine.
 To switch to between
 .Va local
 and
 .Va remote
 configuration lines you can specify the stanzas:
 .Dq [local]
 and
 .Dq [remote] .
 .Pp
 On
 .Va local
 and
 .Va remote
 lines
 .Dq *
 means use the default, or wildcard match.
 In addition, for
 .Va remote
 lines
 .Dq =
 means use the values from the matched
 .Va local
 configuration line.
 .Pp
 The first four fields,
 .Va location ,
 .Va type ,
 .Va proto ,
 and
 .Va owner
 are used to match the
 .Va local
 or
 .Va remote
 addresses, whereas the last 3 fields
 .Va name ,
 .Va nfail ,
 and
 .Va disable
 are used to modify the filtering action.
 .Pp
 The first field denotes the
 .Va location
 as an address, mask, and port.
 The syntax for the
 .Va location
 is:
 .Bd -literal -offset indent
 	[<address>|<interface>][/<mask>][:<port>]
 .Ed
 .Pp
 The
 .Dv address
 can be an IPv4 address in numeric format, an IPv6 address
 in numeric format and enclosed by square brackets, or an interface name.
 Mask modifiers are not allowed on interfaces because interfaces
 have multiple address in different protocols where the mask has a different
 size.
 .Pp
 The
 .Dv mask
 is always numeric, but the
 .Dv port
 can be either numeric or symbolic.
 .Pp
 The second field is the socket
 .Va type :
 .Dv stream ,
 .Dv dgram ,
 or numeric.
 The third field is the
 .Va prococol :
 .Dv tcp ,
 .Dv udp ,
 .Dv tcp6 ,
 .Dv udp6 ,
 or numeric.
 The fourth file is the effective user
 .Va ( owner )
 of the daemon process reporting the event,
 either as a username or a userid.
 .Pp
 The rest of the fields are controlling the behavior of the filter.
 .Pp
 The
 .Va name
 field, is the name of the packet filter rule to be used.
 If the
 .Va name
 starts with a
 .Dq - ,
 then the default rulename is prepended to the given name.
 If the
 .Dv name
 contains a
 .Dq / ,
 the remaining portion of the name is interpreted as the mask to be
 applied to the address specified in the rule, so one can block whole
 subnets for a single rule violation.
 .Pp
 The
 .Va nfail
 field contains the number of failed attempts before access is blocked,
 defaulting to
 .Dq *
 meaning never, and the last field
 .Va disable
 specifies the amount of time since the last access that the blocking
 rule should be active, defaulting to
 .Dq *
 meaning forever.
 The default unit for
 .Va disable
 is seconds, but one can specify suffixes for different units, such as
 .Dq m
 for minutes
 .Dq h
 for hours and
 .Dq d
 for days.
 .Pp
 Matching is done first by checking the
 .Va local
 rules one by one, from the most specific to the least specific.
 If a match is found, then the
 .Va remote
 rules are applied, and if a match is found the
 .Va name ,
 .Va nfail ,
 and
 .Va disable
 fields can be altered by the
 .Va remote
 rule that matched.
 .Pp
 The
 .Va remote
 rules can be used for whitelisting specific addresses, changing the mask
 size, or the rule that the packet filter uses, the number of failed attempts,
 or the blocked duration.
 .Sh FILES
 .Bl -tag -width /etc/blacklistd.conf -compact
 .It Pa /etc/blacklistd.conf
 Configuration file.
 .El
 .Sh EXAMPLES
 .Bd -literal -offset
 # Block ssh, after 3 attempts for 6 hours on the bnx0 interface
 [local]
 # location	type	proto	owner	name	nfail	duration
 bnx0:ssh	*	*	*	*	3	6h
 [remote]
 # Never block 1.2.3.4
 1.2.3.4:ssh	*	*	*	*	*	*
 # For addresses coming from 8.8.0.0/16 block class C networks instead
 # individual hosts, but keep the rest of the blocking parameters the same.
 8.8.0.0/16:ssh	*	*	*	/24	=	=
 .Ed
 .Sh SEE ALSO
 .Xr blacklistctl 8 ,
 .Xr blacklistd 8
 .Sh HISTORY
 .Nm
-appeared in
+first appeared in
 .Nx 7 .
+.Fx support for
+.Nm
+was implemented in
+.Fx 11 .
 .Sh AUTHORS
 .An Christos Zoulas