1*5f4c09ddSEd Maste.\" $NetBSD: blacklistctl.8,v 1.9 2016/06/08 12:48:37 wiz Exp $ 2*5f4c09ddSEd Maste.\" 3*5f4c09ddSEd Maste.\" Copyright (c) 2015 The NetBSD Foundation, Inc. 4*5f4c09ddSEd Maste.\" All rights reserved. 5*5f4c09ddSEd Maste.\" 6*5f4c09ddSEd Maste.\" This code is derived from software contributed to The NetBSD Foundation 7*5f4c09ddSEd Maste.\" by Christos Zoulas. 8*5f4c09ddSEd Maste.\" 9*5f4c09ddSEd Maste.\" Redistribution and use in source and binary forms, with or without 10*5f4c09ddSEd Maste.\" modification, are permitted provided that the following conditions 11*5f4c09ddSEd Maste.\" are met: 12*5f4c09ddSEd Maste.\" 1. Redistributions of source code must retain the above copyright 13*5f4c09ddSEd Maste.\" notice, this list of conditions and the following disclaimer. 14*5f4c09ddSEd Maste.\" 2. Redistributions in binary form must reproduce the above copyright 15*5f4c09ddSEd Maste.\" notice, this list of conditions and the following disclaimer in the 16*5f4c09ddSEd Maste.\" documentation and/or other materials provided with the distribution. 17*5f4c09ddSEd Maste.\" 18*5f4c09ddSEd Maste.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19*5f4c09ddSEd Maste.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20*5f4c09ddSEd Maste.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21*5f4c09ddSEd Maste.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22*5f4c09ddSEd Maste.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23*5f4c09ddSEd Maste.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24*5f4c09ddSEd Maste.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25*5f4c09ddSEd Maste.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26*5f4c09ddSEd Maste.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27*5f4c09ddSEd Maste.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28*5f4c09ddSEd Maste.\" POSSIBILITY OF SUCH DAMAGE. 29*5f4c09ddSEd Maste.\" 30*5f4c09ddSEd Maste.Dd June 7, 2016 31*5f4c09ddSEd Maste.Dt BLACKLISTCTL 8 32*5f4c09ddSEd Maste.Os 33*5f4c09ddSEd Maste.Sh NAME 34*5f4c09ddSEd Maste.Nm blacklistctl 35*5f4c09ddSEd Maste.Nd display and change the state of blacklistd 36*5f4c09ddSEd Maste.Sh SYNOPSIS 37*5f4c09ddSEd Maste.Nm 38*5f4c09ddSEd Maste.Cm dump 39*5f4c09ddSEd Maste.Op Fl abdnrw 40*5f4c09ddSEd Maste.Sh DESCRIPTION 41*5f4c09ddSEd Maste.Nm 42*5f4c09ddSEd Masteis a program used to display the state of 43*5f4c09ddSEd Maste.Xr blacklistd 8 44*5f4c09ddSEd Maste.Pp 45*5f4c09ddSEd MasteThe following options are available: 46*5f4c09ddSEd Maste.Bl -tag -width indent 47*5f4c09ddSEd Maste.It Fl a 48*5f4c09ddSEd MasteShow all database entries, by default it shows only the embryonic ones. 49*5f4c09ddSEd Maste.It Fl b 50*5f4c09ddSEd MasteShow only the blocked entries. 51*5f4c09ddSEd Maste.It Fl d 52*5f4c09ddSEd MasteIncrease debugging level. 53*5f4c09ddSEd Maste.It Fl n 54*5f4c09ddSEd MasteDon't display a header. 55*5f4c09ddSEd Maste.It Fl r 56*5f4c09ddSEd MasteShow the remaining blocked time instead of the last activity time. 57*5f4c09ddSEd Maste.It Fl w 58*5f4c09ddSEd MasteNormally the width of addresses is good for IPv4, the 59*5f4c09ddSEd Maste.Fl w 60*5f4c09ddSEd Masteflag, makes the display wide enough for IPv6 addresses. 61*5f4c09ddSEd Maste.El 62*5f4c09ddSEd Maste.Sh SEE ALSO 63*5f4c09ddSEd Maste.Xr blacklistd 8 64*5f4c09ddSEd Maste.Sh NOTES 65*5f4c09ddSEd MasteSometimes the reported number of failed attempts can exceed the number 66*5f4c09ddSEd Masteof attempts that 67*5f4c09ddSEd Maste.Xr blacklistd 8 68*5f4c09ddSEd Masteis configured to block. 69*5f4c09ddSEd MasteThis can happen either because the rule has been removed manually, or 70*5f4c09ddSEd Mastebecause there were more attempts in flight while the rule block was being 71*5f4c09ddSEd Masteadded. 72*5f4c09ddSEd MasteThis condition is normal; in that case 73*5f4c09ddSEd Maste.Xr blacklistd 8 74*5f4c09ddSEd Mastewill first attempt to remove the existing rule, and then it will re-add 75*5f4c09ddSEd Masteit to make sure that there is only one rule active. 76*5f4c09ddSEd Maste.Sh HISTORY 77*5f4c09ddSEd Maste.Nm 78*5f4c09ddSEd Mastefirst appeared in 79*5f4c09ddSEd Maste.Nx 7 . 80*5f4c09ddSEd Maste.Fx 81*5f4c09ddSEd Mastesupport for 82*5f4c09ddSEd Maste.Nm 83*5f4c09ddSEd Mastewas implemented in 84*5f4c09ddSEd Maste.Fx 11 . 85*5f4c09ddSEd Maste.Sh AUTHORS 86*5f4c09ddSEd Maste.An Christos Zoulas 87