[src/trunk]: src/external/bsd/blacklist/bin explain why nfail > maxfail in th...

[christos <christos%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/0fbdd182aab1
branches:  trunk
changeset: 806028:0fbdd182aab1
user:      christos <christos%NetBSD.org@localhost>
date:      Wed Jan 28 16:47:00 2015 +0000

description:
explain why nfail > maxfail in the report.

diffstat:

 external/bsd/blacklist/bin/blacklistctl.8 |  16 ++++++++++++++--
 1 files changed, 14 insertions(+), 2 deletions(-)

diffs (37 lines):

diff -r b8a0efa63def -r 0fbdd182aab1 external/bsd/blacklist/bin/blacklistctl.8
--- a/external/bsd/blacklist/bin/blacklistctl.8 Wed Jan 28 16:27:43 2015 +0000
+++ b/external/bsd/blacklist/bin/blacklistctl.8 Wed Jan 28 16:47:00 2015 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: blacklistctl.8,v 1.5 2015/01/26 04:12:46 christos Exp $
+.\" $NetBSD: blacklistctl.8,v 1.6 2015/01/28 16:47:00 christos Exp $
 .\"
 .\" Copyright (c) 2015 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd January 25, 2015
+.Dd January 28, 2015
 .Dt BLACKLISTCTL 8
 .Os
 .Sh NAME
@@ -61,6 +61,18 @@
 .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